forked from WHC/Hermit
WHCandCursor
1f1fcba7ad
Vendored sashidown, OpenAI-compatible env (OPENAI_*), and bootstrap scripts. Co-authored-by: Cursor <cursoragent@cursor.com>
99 lines
2.1 KiB
C
99 lines
2.1 KiB
C
#ifndef CTL_H
|
|
#define CTL_H
|
|
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#ifndef CTL_MAX_LINE
|
|
#define CTL_MAX_LINE 4096
|
|
#endif
|
|
|
|
#ifndef CTL_MAX_ARGS
|
|
#define CTL_MAX_ARGS 16
|
|
#endif
|
|
|
|
#ifndef CTL_MAX_ARG_BYTES
|
|
#define CTL_MAX_ARG_BYTES (1024 * 1024)
|
|
#endif
|
|
|
|
#ifndef CTL_MAX_ID
|
|
#define CTL_MAX_ID 64
|
|
#endif
|
|
|
|
#ifndef CTL_MAX_NAME
|
|
#define CTL_MAX_NAME 64
|
|
#endif
|
|
|
|
#ifndef CTL_MAX_KEY
|
|
#define CTL_MAX_KEY 64
|
|
#endif
|
|
|
|
typedef enum {
|
|
CTL_OK = 0,
|
|
CTL_ERR_CONTRACT = 1, /* left L0_tool */
|
|
CTL_ERR_NOMEM = 2,
|
|
CTL_ERR_LIMIT = 3
|
|
} ctl_status_t;
|
|
|
|
typedef enum {
|
|
CTL_EV_NONE = 0,
|
|
CTL_EV_CALL_OPEN, /* id+name confirmed */
|
|
CTL_EV_ARG, /* one arg fully confirmed */
|
|
CTL_EV_CALL_READY, /* end confirmed — safe to execute */
|
|
CTL_EV_TEXT, /* non-CTL confirmed text (outside call) */
|
|
CTL_EV_ERROR
|
|
} ctl_event_type_t;
|
|
|
|
typedef struct {
|
|
char key[CTL_MAX_KEY];
|
|
char *value;
|
|
size_t value_len;
|
|
} ctl_arg_t;
|
|
|
|
typedef struct {
|
|
char id[CTL_MAX_ID];
|
|
char name[CTL_MAX_NAME];
|
|
ctl_arg_t args[CTL_MAX_ARGS];
|
|
int nargs;
|
|
} ctl_tool_call_t;
|
|
|
|
typedef struct {
|
|
ctl_event_type_t type;
|
|
const ctl_tool_call_t *call; /* valid for CALL_* / ARG */
|
|
const char *text; /* for TEXT */
|
|
size_t text_len;
|
|
const char *error; /* for ERROR */
|
|
} ctl_event_t;
|
|
|
|
typedef void (*ctl_on_event_fn)(const ctl_event_t *ev, void *userdata);
|
|
|
|
typedef struct ctl_parser ctl_parser_t;
|
|
|
|
ctl_parser_t *ctl_parser_create(ctl_on_event_fn on_event, void *userdata);
|
|
void ctl_parser_destroy(ctl_parser_t *p);
|
|
|
|
/* Feed UTF-8 bytes. Emits only confirmed events. */
|
|
ctl_status_t ctl_parser_feed(ctl_parser_t *p, const char *data, size_t len);
|
|
|
|
/* EOF: flush; incomplete call => ERROR (no execute). */
|
|
ctl_status_t ctl_parser_finish(ctl_parser_t *p);
|
|
|
|
/* Bytes currently pending (unconfirmed). */
|
|
size_t ctl_parser_pending(const ctl_parser_t *p);
|
|
|
|
/* Peak pending observed (for experiments). */
|
|
size_t ctl_parser_pending_peak(const ctl_parser_t *p);
|
|
|
|
/* Reset for a new assistant turn. */
|
|
void ctl_parser_reset(ctl_parser_t *p);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* CTL_H */
|