Initial CST-Agent: portable Linux/Termux/Windows coding agent.

Vendored sashidown, OpenAI-compatible env (OPENAI_*), and bootstrap scripts. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-07 22:42:32 +08:00
commit 1f1fcba7ad
75 changed files with 14940 additions and 0 deletions
@@ -0,0 +1,98 @@
+#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 */