Home /Modules/impl/sleela_ai.h

sleela_ai.h

impl/core/sleela_ai.h · 144 line(s) · c

#ifndef SLEELA_AI_H
#define SLEELA_AI_H

#include <stddef.h>
#include <stdint.h>
#include "sleela_media.h"

#ifdef __cplusplus
extern "C" {
#endif

#define SL_AI_MAX_LABEL 96
#define SL_AI_MAX_PATH 1024
#define SL_AI_MAX_TEXT 4096
#define SL_AI_MAX_MODEL_ID 128
#define SL_AI_MAX_FORMAT 64
#define SL_AI_MAX_SOURCE 128
#define SL_AI_MAX_FIELDS 32
#define SL_AI_MAX_FIELD_NAME 64
#define SL_AI_MAX_FIELD_TYPE 64
#define SL_AI_MAX_URL 2048
#define SL_AI_MAX_ARGS 2048

typedef enum {
    SL_AI_KIND_DATA = 1,
    SL_AI_KIND_FILE = 2,
    SL_AI_KIND_AUDIO = 3,
    SL_AI_KIND_VIDEO = 4
} SLAIInputKind;

typedef enum {
    SL_AI_OP_INSPECT = 1,
    SL_AI_OP_CLASSIFY = 2,
    SL_AI_OP_EXTRACT = 3,
    SL_AI_OP_SUMMARIZE = 4,
    SL_AI_OP_TRANSFORM = 5
} SLAIOperation;

typedef enum {
    SL_AI_BACKEND_NATIVE = 1,
    SL_AI_BACKEND_CONNECTOR = 2
} SLAIBackend;

typedef struct {
    SLAIInputKind kind;
    const char *name;
    const char *path;
    const void *data;
    size_t size;
    const SLMediaFrame *media;
} SLAIInput;

typedef struct {
    char label[SL_AI_MAX_LABEL];
    double confidence;
    int64_t offset_ns;
    int64_t duration_ns;
} SLAIObservation;

typedef struct {
    SLAIOperation operation;
    SLAIBackend backend;
    const char *model_id;
    const char *instruction;
    size_t max_observations;
    SLAIObservation *observations;
    size_t observation_count;
} SLAIRequest;

typedef struct {
    int accepted;
    int completed;
    uint64_t request_id;
    size_t observation_count;
    char summary[SL_AI_MAX_TEXT];
} SLAIResult;

typedef struct {
    char model_id[SL_AI_MAX_MODEL_ID];
    char format[SL_AI_MAX_FORMAT];
    char source[SL_AI_MAX_SOURCE];
    uint32_t revision;
    int trusted;
} SLAIModelDescriptor;

typedef struct {
    char name[SL_AI_MAX_FIELD_NAME];
    char type[SL_AI_MAX_FIELD_TYPE];
    int required;
} SLAIDataModelField;

typedef struct {
    char id[SL_AI_MAX_MODEL_ID];
    uint32_t revision;
    size_t field_count;
    SLAIDataModelField fields[SL_AI_MAX_FIELDS];
} SLAIDataModel;

typedef enum {
    SL_AI_SOURCE_DATA = 1,
    SL_AI_SOURCE_FILE = 2,
    SL_AI_SOURCE_AUDIO = 3,
    SL_AI_SOURCE_VIDEO = 4,
    SL_AI_SOURCE_AI_FLOW = 5,
    SL_AI_SOURCE_DATA_FLOW = 6
} SLAIXMLSourceKind;

typedef struct {
    SLAIXMLSourceKind kind;
    char url[SL_AI_MAX_URL];
    char args[SL_AI_MAX_ARGS];
} SLAIXMLSource;

typedef int (*SLAIVMInvokeFn)(const SLAIRequest *request,
                             const SLAIInput *input,
                             SLAIResult *result,
                             void *context);

typedef struct {
    SLAIBackend backend;
    SLAIVMInvokeFn invoke;
    void *context;
} SLAIEngine;

int slai_engine_init(SLAIEngine *engine, SLAIBackend backend);
int slai_engine_bind_vm(SLAIEngine *engine, SLAIVMInvokeFn invoke, void *context);
int slai_engine_bind_native(SLAIEngine *engine, SLAIVMInvokeFn invoke, void *context);
int slai_validate_input(const SLAIInput *input);
int slai_validate_request(const SLAIRequest *request);
int slai_invoke(SLAIEngine *engine, const SLAIRequest *request,
                const SLAIInput *input, SLAIResult *result);
int slai_model_from_xml(const char *xml, size_t length, SLAIModelDescriptor *model);
int slai_data_model_from_xml(const char *xml, size_t length, SLAIDataModel *model);
int slai_source_from_xml(const char *xml, size_t length, SLAIXMLSource *source);
const char *slai_input_kind_name(SLAIInputKind kind);
const char *slai_operation_name(SLAIOperation operation);
const char *slai_backend_name(SLAIBackend backend);
const char *slai_source_kind_name(SLAIXMLSourceKind kind);

#ifdef __cplusplus
}
#endif
#endif