Home /Modules/artificial-intelligence/large_language_models_code.h

large_language_models_code.h

artificial-intelligence/large-language-models/large_language_models_code.h · 102 line(s) · c

#ifndef SLEELA_AI_LLM_CODE_H
#define SLEELA_AI_LLM_CODE_H
/*
 * SLeeLa Code LLM profile and verifier contract.
 *
 * A "Code LLM" (a.k.a. coding assistant / program-aided language model) is a
 * language model specialized for source code: because code is structured plain
 * text, the model handles programming syntax much like natural language, and is
 * effective at tracking the sequential logic, state changes, loops, and blocks
 * of PROCEDURAL languages (C, Fortran, Pascal, procedural Python).
 *
 * This is the SLeeLa project's supported "code-language-model" type (it matches
 * the architecture-catalog entry of that id). As with every other model here,
 * NO weights and NO model are bundled: this declares a USER-OWNED code model and
 * the contract by which its step proposals are verified. The neural half (the
 * Code LLM) proposes summaries, dry-run state, and refactorings; the symbolic
 * half (a compiler / test runner / tracer, supplied by the caller) decides
 * soundness. It composes with the capacity profile (2..16 GB) and the reasoning
 * layer's SLLMR_SUBJECT_CODE.
 */
#include <stddef.h>
#include <stdint.h>
#ifdef __cplusplus
extern "C" {
#endif
#if defined(_WIN32) && defined(SLEELA_AI_SHARED)
# if defined(SLEELA_AI_BUILD)
#  define SLLMCX_API __declspec(dllexport)
# else
#  define SLLMCX_API __declspec(dllimport)
# endif
#elif defined(__GNUC__) && defined(SLEELA_AI_SHARED)
# define SLLMCX_API __attribute__((visibility("default")))
#else
# define SLLMCX_API
#endif

#define SLLMCX_ABI_VERSION 1u

/* Procedural languages this profile is tuned for. OTHER covers any language the
   caller supplies by name; the list names the common procedural ones. */
typedef enum sllmcx_language {
 SLLMCX_LANG_C=0, SLLMCX_LANG_FORTRAN=1, SLLMCX_LANG_PASCAL=2,
 SLLMCX_LANG_PYTHON=3, SLLMCX_LANG_SHELL=4, SLLMCX_LANG_SLEELA=5,
 SLLMCX_LANG_OTHER=6, SLLMCX_LANG_COUNT=7
} sllmcx_language;

/* Code-reasoning tasks (bit flags), matching the established Code LLM uses. */
typedef enum sllmcx_task {
 SLLMCX_TASK_SUMMARIZE  = 1u<<0,  /* explain code in plain language, line by line */
 SLLMCX_TASK_DRY_RUN    = 1u<<1,  /* mentally execute; predict variable/state changes */
 SLLMCX_TASK_REFACTOR   = 1u<<2,  /* restructure into clean, reusable procedures */
 SLLMCX_TASK_TRANSLATE  = 1u<<3,  /* port to another language/paradigm, behavior-preserving */
 SLLMCX_TASK_DEBUG      = 1u<<4,  /* locate and explain a fault */
 SLLMCX_TASK_COMPLETE   = 1u<<5   /* complete/continue code */
} sllmcx_task;

typedef enum sllmcx_status {
 SLLMCX_OK=0, SLLMCX_INVALID_ARGUMENT=1, SLLMCX_UNSUPPORTED=2
} sllmcx_status;

/* How a code step was (or could be) checked. A Code LLM's claim about behavior
   is only as sound as the check behind it. */
typedef enum sllmcx_check_mode {
 SLLMCX_CHECK_NONE=0,     /* no checker available -> step stays UNKNOWN */
 SLLMCX_CHECK_COMPILE=1,  /* syntactic/type check via a compiler */
 SLLMCX_CHECK_TEST=2,     /* run against tests / expected output */
 SLLMCX_CHECK_TRACE=3     /* execute and compare the traced state (dry-run truth) */
} sllmcx_check_mode;

/* A user-owned Code LLM profile. Strings are borrowed (may be NULL). */
typedef struct sllmcx_profile {
 uint32_t abi_version;
 const char *model_id;        /* the caller's code model, e.g. "user/code-llm-7b" */
 const char *base_family;     /* informational, e.g. "code-llama", "deepseek-coder" */
 sllmcx_language primary_language;
 const char *other_language;  /* used when primary_language==OTHER (name, borrowed) */
 uint32_t tasks;              /* OR of sllmcx_task flags the caller enables */
 sllmcx_check_mode check_mode;/* strongest verification the caller can provide */
 int   fill_in_middle;        /* nonzero if the model supports FIM infilling */
} sllmcx_profile;

SLLMCX_API const char *sllmcx_status_string(sllmcx_status status);
SLLMCX_API const char *sllmcx_language_name(sllmcx_language language);
SLLMCX_API const char *sllmcx_task_name(sllmcx_task task);
SLLMCX_API const char *sllmcx_check_mode_name(sllmcx_check_mode mode);

/* Defaults: C, summarize+dry-run+refactor+translate, trace checking, FIM off. */
SLLMCX_API sllmcx_status sllmcx_profile_init(sllmcx_profile *profile);

/* True if the profile enables a given task. */
SLLMCX_API int sllmcx_profile_has_task(const sllmcx_profile *profile, sllmcx_task task);

/* A stable, human-readable label for the language (profile->other_language when
   OTHER). Never NULL. */
SLLMCX_API const char *sllmcx_profile_language_label(const sllmcx_profile *profile);

#ifdef __cplusplus
}
#endif
#endif