daemora 1.0.0-alpha.0

package/dist/config/schema.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Daemora-TS configuration schema. The single source of truth for what
+ * is configurable, what's a secret vs setting, and what's editable.
+ *
+ * Add a field here ONCE — UI, validation, and config endpoints all
+ * derive from this schema. No more "edit four files to add a setting".
+ */
+import { z } from "zod";
+/**
+ * Where a value comes from.
+ *  - "vault"   : encrypted SQLite store; only for secrets
+ *  - "settings": plain SQLite KV; user-editable non-secret preferences
+ *  - "env"     : process.env / .env file; deployment-time only
+ *  - "default" : the schema default; nothing is set
+ */
+export type ConfigSource = "vault" | "settings" | "env" | "default";
+/**
+ * Setting field — non-secret, user-editable, hot-reloadable.
+ * Appears in /api/settings UI.
+ */
+export interface SettingFieldDef<T> {
+    readonly kind: "setting";
+    readonly key: string;
+    readonly label: string;
+    readonly description: string;
+    readonly group: SettingGroup;
+    readonly schema: z.ZodType<T>;
+    readonly defaultValue: T;
+    /** Read-only fields (deployment env). UI shows but doesn't allow edit. */
+    readonly editable: boolean;
+}
+/**
+ * Secret field — encrypted-at-rest, only writable via dedicated vault
+ * endpoints. Never echoed back through /api/settings. Lives in vault.
+ */
+export interface SecretFieldDef {
+    readonly kind: "secret";
+    readonly key: string;
+    readonly label: string;
+    readonly description: string;
+    readonly group: SecretGroup;
+    /** Optional regex the value must match (e.g. "^sk-"). */
+    readonly pattern?: RegExp;
+    /**
+     * If true, this secret is part of an OAuth integration and the
+     * usual API-key-form UI is replaced with a Connect button.
+     */
+    readonly oauth?: {
+        integration: string;
+        tokenType: "access" | "refresh" | "client_id" | "client_secret";
+    };
+}
+export type FieldDef<T = unknown> = SettingFieldDef<T> | SecretFieldDef;
+export type SettingGroup = "general" | "models" | "voice" | "behaviour" | "developer";
+export type SecretGroup = "ai_providers" | "voice_providers" | "search_providers" | "channels" | "integrations" | "system";
+export declare const settings: {
+    DEFAULT_MODEL: SettingFieldDef<string | null>;
+    IMAGE_GEN_MODEL: SettingFieldDef<string | null>;
+    VIDEO_GEN_MODEL: SettingFieldDef<string | null>;
+    OLLAMA_BASE_URL: SettingFieldDef<string>;
+    WAKE_WORD_ENABLED: SettingFieldDef<boolean>;
+    WAKE_WORD: SettingFieldDef<string>;
+    MAX_COST_PER_TASK: SettingFieldDef<number>;
+    TASK_TIMEOUT_MS: SettingFieldDef<number>;
+    HEARTBEAT_ENABLED: SettingFieldDef<boolean>;
+    HEARTBEAT_INTERVAL_MINUTES: SettingFieldDef<number>;
+    LIVEKIT_URL: SettingFieldDef<string>;
+    AUTH_ENABLED: SettingFieldDef<boolean>;
+    PUBLIC_URL: SettingFieldDef<string>;
+    MAX_DAILY_COST: SettingFieldDef<number>;
+};
+export declare const secrets: {
+    ANTHROPIC_API_KEY: SecretFieldDef;
+    OPENAI_API_KEY: SecretFieldDef;
+    GOOGLE_AI_API_KEY: SecretFieldDef;
+    GOOGLE_VERTEX_API_KEY: SecretFieldDef;
+    GROQ_API_KEY: SecretFieldDef;
+    NVIDIA_API_KEY: SecretFieldDef;
+    DEEPGRAM_API_KEY: SecretFieldDef;
+    ASSEMBLYAI_API_KEY: SecretFieldDef;
+    ELEVENLABS_API_KEY: SecretFieldDef;
+    CARTESIA_API_KEY: SecretFieldDef;
+    BRAVE_SEARCH_API_KEY: SecretFieldDef;
+    OPENROUTER_API_KEY: SecretFieldDef;
+    DEEPSEEK_API_KEY: SecretFieldDef;
+    MISTRAL_API_KEY: SecretFieldDef;
+    XAI_API_KEY: SecretFieldDef;
+    TOGETHER_API_KEY: SecretFieldDef;
+    FIREWORKS_API_KEY: SecretFieldDef;
+    CEREBRAS_API_KEY: SecretFieldDef;
+    PERPLEXITY_API_KEY: SecretFieldDef;
+    LIVEKIT_API_KEY: SecretFieldDef;
+    LIVEKIT_API_SECRET: SecretFieldDef;
+    RESEND_API_KEY: SecretFieldDef;
+    FIRECRAWL_API_KEY: SecretFieldDef;
+    TAVILY_API_KEY: SecretFieldDef;
+    BRAVE_API_KEY: SecretFieldDef;
+    SUNO_API_KEY: SecretFieldDef;
+    DISCORD_BOT_TOKEN: SecretFieldDef;
+};
+export declare const envOnly: {
+    readonly PORT: {
+        readonly key: "PORT";
+        readonly schema: z.ZodDefault<z.ZodNumber>;
+    };
+    readonly DAEMORA_DATA_DIR: {
+        readonly key: "DAEMORA_DATA_DIR";
+        readonly schema: z.ZodOptional<z.ZodString>;
+    };
+    readonly DAEMON_MODE: {
+        readonly key: "DAEMON_MODE";
+        readonly schema: z.ZodDefault<z.ZodBoolean>;
+    };
+    readonly LOG_LEVEL: {
+        readonly key: "LOG_LEVEL";
+        readonly schema: z.ZodDefault<z.ZodEnum<["trace", "debug", "info", "warn", "error", "fatal"]>>;
+    };
+};
+export type SettingKey = keyof typeof settings;
+export type SecretKey = keyof typeof secrets;
+export type EnvKey = keyof typeof envOnly;
+export type SettingValue<K extends SettingKey> = z.infer<(typeof settings)[K]["schema"]>;
+/** All known setting/secret/env field definitions, indexed for lookup. */
+export declare const allFields: ReadonlyMap<string, FieldDef>;
+export declare function isSecret(key: string): boolean;
+export declare function isSetting(key: string): boolean;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;IACzB,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,eAAe,CAAA;KAAE,CAAC;CAC3G;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,OAAO,IAAI,eAAe,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC;AAExE,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,QAAQ,GACR,OAAO,GACP,WAAW,GACX,WAAW,CAAC;AAEhB,MAAM,MAAM,WAAW,GACnB,cAAc,GACd,iBAAiB,GACjB,kBAAkB,GAClB,UAAU,GACV,cAAc,GACd,QAAQ,CAAC;AA8Bb,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;CAmH+B,CAAC;AAMrD,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0KsB,CAAC;AAI3C,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;CAKV,CAAC;AAIX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,QAAQ,CAAC;AAC/C,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,OAAO,CAAC;AAC7C,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,OAAO,CAAC;AAE1C,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEzF,0EAA0E;AAC1E,eAAO,MAAM,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAGlD,CAAC;AAEH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG7C;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG9C"}

package/dist/config/schema.js

@@ -0,0 +1,346 @@
+/**
+ * Daemora-TS configuration schema. The single source of truth for what
+ * is configurable, what's a secret vs setting, and what's editable.
+ *
+ * Add a field here ONCE — UI, validation, and config endpoints all
+ * derive from this schema. No more "edit four files to add a setting".
+ */
+import { z } from "zod";
+// ── Settings (non-secret, hot-reloadable) ────────────────────────────────────
+const setting = (d) => ({
+    kind: "setting",
+    editable: d.editable ?? true,
+    ...d,
+});
+/**
+ * Boolean coercion that handles the way the Settings form serializes
+ * toggles — usually as the strings `"true"` / `"false"` — while still
+ * accepting native booleans from API callers.
+ *
+ * Why not `z.coerce.boolean()`: that follows JS `Boolean()` semantics,
+ * so the string `"false"` becomes `true` (any non-empty string is
+ * truthy). That bug silently flipped toggles whenever a user turned
+ * one OFF from the UI.
+ */
+const stringBoolean = z.preprocess((v) => {
+    if (typeof v === "boolean")
+        return v;
+    if (typeof v === "string") {
+        const norm = v.trim().toLowerCase();
+        if (norm === "true" || norm === "1")
+            return true;
+        if (norm === "false" || norm === "0" || norm === "")
+            return false;
+    }
+    return v;
+}, z.boolean());
+export const settings = {
+    DEFAULT_MODEL: setting({
+        key: "DEFAULT_MODEL",
+        label: "Default Model",
+        description: "The model used when a task doesn't specify one. Format: provider:model",
+        group: "models",
+        schema: z.string().regex(/^[a-z][a-z0-9-]*:.+/, "Format: provider:model").nullable(),
+        defaultValue: null,
+    }),
+    IMAGE_GEN_MODEL: setting({
+        key: "IMAGE_GEN_MODEL",
+        label: "Image Generation Model",
+        description: "Model used by the generate_image tool. Format: provider:model.",
+        group: "models",
+        schema: z.string().regex(/^[a-z][a-z0-9-]*:.+/, "Format: provider:model").nullable(),
+        defaultValue: null,
+    }),
+    VIDEO_GEN_MODEL: setting({
+        key: "VIDEO_GEN_MODEL",
+        label: "Video Generation Model",
+        description: "Model used by the generate_video tool. Format: provider:model.",
+        group: "models",
+        schema: z.string().regex(/^[a-z][a-z0-9-]*:.+/, "Format: provider:model").nullable(),
+        defaultValue: null,
+    }),
+    OLLAMA_BASE_URL: setting({
+        key: "OLLAMA_BASE_URL",
+        label: "Ollama Base URL",
+        description: "Where Ollama is running. Default: http://localhost:11434",
+        group: "models",
+        schema: z.string().url(),
+        defaultValue: "http://localhost:11434",
+    }),
+    WAKE_WORD_ENABLED: setting({
+        key: "WAKE_WORD_ENABLED",
+        label: "Wake Word",
+        description: "Listen for a wake phrase to activate voice mode.",
+        group: "voice",
+        schema: stringBoolean,
+        defaultValue: false,
+    }),
+    WAKE_WORD: setting({
+        key: "WAKE_WORD",
+        label: "Wake Phrase",
+        description: "The phrase that activates voice mode.",
+        group: "voice",
+        schema: z.enum(["hey_jarvis", "alexa", "hey_mycroft", "hey_rhasspy"]),
+        defaultValue: "hey_jarvis",
+    }),
+    MAX_COST_PER_TASK: setting({
+        key: "MAX_COST_PER_TASK",
+        label: "Max cost per task (USD)",
+        description: "Hard ceiling for any single task. 0 = no limit.",
+        group: "behaviour",
+        // Coerce — the Settings form serialises numeric inputs as strings.
+        schema: z.coerce.number().nonnegative(),
+        defaultValue: 0.5,
+    }),
+    TASK_TIMEOUT_MS: setting({
+        key: "TASK_TIMEOUT_MS",
+        label: "Task timeout (ms)",
+        description: "Per-task safety timeout. Long-running autonomous tasks (campaigns, daily-rhythm loops) need a high value or 0. Default 0 = no timeout.",
+        group: "behaviour",
+        schema: z.coerce.number().int().nonnegative(),
+        defaultValue: 0,
+    }),
+    HEARTBEAT_ENABLED: setting({
+        key: "HEARTBEAT_ENABLED",
+        label: "Heartbeat (proactive check)",
+        description: "Periodic self-scan that reviews failed tasks, stuck cron, and unfired watchers, then drives an agent turn to fix them. Off if you want a quiet system.",
+        group: "behaviour",
+        schema: stringBoolean,
+        defaultValue: true,
+    }),
+    HEARTBEAT_INTERVAL_MINUTES: setting({
+        key: "HEARTBEAT_INTERVAL_MINUTES",
+        label: "Heartbeat interval (minutes)",
+        description: "How often the proactive check fires when enabled. Default 240 (4h). 0 also disables.",
+        group: "behaviour",
+        schema: z.coerce.number().int().nonnegative(),
+        defaultValue: 240,
+    }),
+    LIVEKIT_URL: setting({
+        key: "LIVEKIT_URL",
+        label: "LiveKit Server URL",
+        description: "WebSocket URL for LiveKit. Default ws://127.0.0.1:7880 for local.",
+        group: "voice",
+        schema: z.string().url(),
+        defaultValue: "ws://127.0.0.1:7880",
+    }),
+    AUTH_ENABLED: setting({
+        key: "AUTH_ENABLED",
+        label: "Require sign-in",
+        description: "When on, /api/* endpoints require a signed-in session (passphrase login). Loopback scripts still work via the local auth-token file. Off until the user turns it on from the setup wizard or settings.",
+        group: "general",
+        schema: stringBoolean,
+        defaultValue: false,
+    }),
+    PUBLIC_URL: setting({
+        key: "PUBLIC_URL",
+        label: "Public URL",
+        description: "Externally reachable URL for this instance. Used to build webhook registration URLs and tunnel fallback. Leave blank to auto-detect or use a tunnel.",
+        group: "general",
+        schema: z.string(),
+        defaultValue: "",
+    }),
+    MAX_DAILY_COST: setting({
+        key: "MAX_DAILY_COST",
+        label: "Max daily cost (USD)",
+        description: "Total spend ceiling per day across all tasks. 0 = no limit.",
+        group: "behaviour",
+        // Coerce — the Settings form serialises numeric inputs as strings.
+        schema: z.coerce.number().nonnegative(),
+        defaultValue: 10,
+    }),
+};
+// ── Secrets (encrypted vault, never in env at runtime) ──────────────────────
+const secret = (d) => ({ kind: "secret", ...d });
+export const secrets = {
+    ANTHROPIC_API_KEY: secret({
+        key: "ANTHROPIC_API_KEY",
+        label: "Anthropic",
+        description: "API key for Claude models.",
+        group: "ai_providers",
+        pattern: /^sk-ant-/,
+    }),
+    OPENAI_API_KEY: secret({
+        key: "OPENAI_API_KEY",
+        label: "OpenAI",
+        description: "API key for GPT models.",
+        group: "ai_providers",
+        pattern: /^sk-/,
+    }),
+    GOOGLE_AI_API_KEY: secret({
+        key: "GOOGLE_AI_API_KEY",
+        label: "Google AI",
+        description: "API key for Gemini models.",
+        group: "ai_providers",
+    }),
+    GOOGLE_VERTEX_API_KEY: secret({
+        key: "GOOGLE_VERTEX_API_KEY",
+        label: "Vertex AI (Express)",
+        description: "Vertex AI Express API key — Gemini on GCP, no project/SA needed.",
+        group: "ai_providers",
+    }),
+    GROQ_API_KEY: secret({
+        key: "GROQ_API_KEY",
+        label: "Groq",
+        description: "API key for fast Llama / Whisper / Orpheus inference.",
+        group: "ai_providers",
+        pattern: /^gsk_/,
+    }),
+    NVIDIA_API_KEY: secret({
+        key: "NVIDIA_API_KEY",
+        label: "NVIDIA",
+        description: "API key for NVIDIA NIM — DeepSeek, Llama, Mistral, Qwen, and other open models.",
+        group: "ai_providers",
+        pattern: /^nvapi-/,
+    }),
+    DEEPGRAM_API_KEY: secret({
+        key: "DEEPGRAM_API_KEY",
+        label: "Deepgram",
+        description: "Streaming STT via Nova-2.",
+        group: "voice_providers",
+    }),
+    ASSEMBLYAI_API_KEY: secret({
+        key: "ASSEMBLYAI_API_KEY",
+        label: "AssemblyAI",
+        description: "High-accuracy STT via Universal-2.",
+        group: "voice_providers",
+    }),
+    ELEVENLABS_API_KEY: secret({
+        key: "ELEVENLABS_API_KEY",
+        label: "ElevenLabs",
+        description: "Premium TTS voices.",
+        group: "voice_providers",
+    }),
+    CARTESIA_API_KEY: secret({
+        key: "CARTESIA_API_KEY",
+        label: "Cartesia",
+        description: "Low-latency TTS via Sonic.",
+        group: "voice_providers",
+    }),
+    BRAVE_SEARCH_API_KEY: secret({
+        key: "BRAVE_SEARCH_API_KEY",
+        label: "Brave Search",
+        description: "Web search tool. Free tier: 2k queries/month.",
+        group: "integrations",
+    }),
+    OPENROUTER_API_KEY: secret({
+        key: "OPENROUTER_API_KEY",
+        label: "OpenRouter",
+        description: "Multi-provider gateway — access 200+ models with one key.",
+        group: "ai_providers",
+    }),
+    DEEPSEEK_API_KEY: secret({
+        key: "DEEPSEEK_API_KEY",
+        label: "DeepSeek",
+        description: "DeepSeek V3 and R1 models.",
+        group: "ai_providers",
+    }),
+    MISTRAL_API_KEY: secret({
+        key: "MISTRAL_API_KEY",
+        label: "Mistral AI",
+        description: "Mistral Large, Small, and Codestral.",
+        group: "ai_providers",
+    }),
+    XAI_API_KEY: secret({
+        key: "XAI_API_KEY",
+        label: "xAI",
+        description: "Grok models.",
+        group: "ai_providers",
+    }),
+    TOGETHER_API_KEY: secret({
+        key: "TOGETHER_API_KEY",
+        label: "Together AI",
+        description: "Open-source models at scale.",
+        group: "ai_providers",
+    }),
+    FIREWORKS_API_KEY: secret({
+        key: "FIREWORKS_API_KEY",
+        label: "Fireworks AI",
+        description: "Fast open-source model inference.",
+        group: "ai_providers",
+    }),
+    CEREBRAS_API_KEY: secret({
+        key: "CEREBRAS_API_KEY",
+        label: "Cerebras",
+        description: "Ultra-fast inference on Cerebras hardware.",
+        group: "ai_providers",
+    }),
+    PERPLEXITY_API_KEY: secret({
+        key: "PERPLEXITY_API_KEY",
+        label: "Perplexity",
+        description: "Search-augmented AI models (Sonar).",
+        group: "ai_providers",
+    }),
+    LIVEKIT_API_KEY: secret({
+        key: "LIVEKIT_API_KEY",
+        label: "LiveKit API Key",
+        description: "LiveKit server API key. Default 'devkey' for local --dev mode.",
+        group: "system",
+    }),
+    LIVEKIT_API_SECRET: secret({
+        key: "LIVEKIT_API_SECRET",
+        label: "LiveKit API Secret",
+        description: "LiveKit server secret. Default 'secret' for local --dev mode.",
+        group: "system",
+    }),
+    RESEND_API_KEY: secret({
+        key: "RESEND_API_KEY",
+        label: "Resend",
+        description: "Email sending via Resend API.",
+        group: "integrations",
+    }),
+    // Web search providers — referenced by tools/core/webSearch.ts. Without
+    // these declared as secrets, the bulk PUT /api/settings would route
+    // them to the plaintext settings_entries table instead of the vault.
+    FIRECRAWL_API_KEY: secret({
+        key: "FIRECRAWL_API_KEY",
+        label: "Firecrawl",
+        description: "Web search + JS-rendered page scraping. Used by web_search and web_fetch fallback.",
+        group: "search_providers",
+    }),
+    TAVILY_API_KEY: secret({
+        key: "TAVILY_API_KEY",
+        label: "Tavily",
+        description: "AI-augmented web search with synthesized answers.",
+        group: "search_providers",
+    }),
+    BRAVE_API_KEY: secret({
+        key: "BRAVE_API_KEY",
+        label: "Brave Search (alias)",
+        description: "Alternate slot for Brave Search key. Same as BRAVE_SEARCH_API_KEY — either works.",
+        group: "search_providers",
+    }),
+    SUNO_API_KEY: secret({
+        key: "SUNO_API_KEY",
+        label: "Suno",
+        description: "Music generation via Suno API.",
+        group: "integrations",
+    }),
+    DISCORD_BOT_TOKEN: secret({
+        key: "DISCORD_BOT_TOKEN",
+        label: "Discord Bot Token",
+        description: "Bot token for Discord channel integration.",
+        group: "channels",
+    }),
+};
+// ── Env-only (boot-time, read-only at runtime) ───────────────────────────────
+export const envOnly = {
+    PORT: { key: "PORT", schema: z.coerce.number().int().positive().default(8081) },
+    DAEMORA_DATA_DIR: { key: "DAEMORA_DATA_DIR", schema: z.string().optional() },
+    DAEMON_MODE: { key: "DAEMON_MODE", schema: z.coerce.boolean().default(false) },
+    LOG_LEVEL: { key: "LOG_LEVEL", schema: z.enum(["trace", "debug", "info", "warn", "error", "fatal"]).default("info") },
+};
+/** All known setting/secret/env field definitions, indexed for lookup. */
+export const allFields = new Map([
+    ...Object.values(settings).map((d) => [d.key, d]),
+    ...Object.values(secrets).map((d) => [d.key, d]),
+]);
+export function isSecret(key) {
+    const f = allFields.get(key);
+    return f?.kind === "secret";
+}
+export function isSetting(key) {
+    const f = allFields.get(key);
+    return f?.kind === "setting";
+}
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA+DxB,gFAAgF;AAEhF,MAAM,OAAO,GAAG,CAAI,CAAyE,EAAsB,EAAE,CAAC,CAAC;IACrH,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI;IAC5B,GAAG,CAAC;CACL,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,aAAa,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE;IACvC,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACrC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpC,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,EAAE;YAAE,OAAO,KAAK,CAAC;IACpE,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAkC,CAAC;AAEjD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,aAAa,EAAE,OAAO,CAAgB;QACpC,GAAG,EAAE,eAAe;QACpB,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,wEAAwE;QACrF,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,EAAE,wBAAwB,CAAC,CAAC,QAAQ,EAAE;QACpF,YAAY,EAAE,IAAI;KACnB,CAAC;IACF,eAAe,EAAE,OAAO,CAAgB;QACtC,GAAG,EAAE,iBAAiB;QACtB,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,gEAAgE;QAC7E,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,EAAE,wBAAwB,CAAC,CAAC,QAAQ,EAAE;QACpF,YAAY,EAAE,IAAI;KACnB,CAAC;IACF,eAAe,EAAE,OAAO,CAAgB;QACtC,GAAG,EAAE,iBAAiB;QACtB,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,gEAAgE;QAC7E,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,EAAE,wBAAwB,CAAC,CAAC,QAAQ,EAAE;QACpF,YAAY,EAAE,IAAI;KACnB,CAAC;IACF,eAAe,EAAE,OAAO,CAAS;QAC/B,GAAG,EAAE,iBAAiB;QACtB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,0DAA0D;QACvE,KAAK,EAAE,QAAQ;QACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;QACxB,YAAY,EAAE,wBAAwB;KACvC,CAAC;IACF,iBAAiB,EAAE,OAAO,CAAU;QAClC,GAAG,EAAE,mBAAmB;QACxB,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,kDAAkD;QAC/D,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,aAAa;QACrB,YAAY,EAAE,KAAK;KACpB,CAAC;IACF,SAAS,EAAE,OAAO,CAAS;QACzB,GAAG,EAAE,WAAW;QAChB,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,uCAAuC;QACpD,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;QACrE,YAAY,EAAE,YAAY;KAC3B,CAAC;IACF,iBAAiB,EAAE,OAAO,CAAS;QACjC,GAAG,EAAE,mBAAmB;QACxB,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,iDAAiD;QAC9D,KAAK,EAAE,WAAW;QAClB,mEAAmE;QACnE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;QACvC,YAAY,EAAE,GAAG;KAClB,CAAC;IACF,eAAe,EAAE,OAAO,CAAS;QAC/B,GAAG,EAAE,iBAAiB;QACtB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,wIAAwI;QACrJ,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC7C,YAAY,EAAE,CAAC;KAChB,CAAC;IACF,iBAAiB,EAAE,OAAO,CAAU;QAClC,GAAG,EAAE,mBAAmB;QACxB,KAAK,EAAE,6BAA6B;QACpC,WAAW,EAAE,wJAAwJ;QACrK,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,aAAa;QACrB,YAAY,EAAE,IAAI;KACnB,CAAC;IACF,0BAA0B,EAAE,OAAO,CAAS;QAC1C,GAAG,EAAE,4BAA4B;QACjC,KAAK,EAAE,8BAA8B;QACrC,WAAW,EAAE,sFAAsF;QACnG,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC7C,YAAY,EAAE,GAAG;KAClB,CAAC;IACF,WAAW,EAAE,OAAO,CAAS;QAC3B,GAAG,EAAE,aAAa;QAClB,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,mEAAmE;QAChF,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;QACxB,YAAY,EAAE,qBAAqB;KACpC,CAAC;IACF,YAAY,EAAE,OAAO,CAAU;QAC7B,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,wMAAwM;QACrN,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,aAAa;QACrB,YAAY,EAAE,KAAK;KACpB,CAAC;IACF,UAAU,EAAE,OAAO,CAAS;QAC1B,GAAG,EAAE,YAAY;QACjB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,sJAAsJ;QACnK,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,YAAY,EAAE,EAAE;KACjB,CAAC;IACF,cAAc,EAAE,OAAO,CAAS;QAC9B,GAAG,EAAE,gBAAgB;QACrB,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,6DAA6D;QAC1E,KAAK,EAAE,WAAW;QAClB,mEAAmE;QACnE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;QACvC,YAAY,EAAE,EAAE;KACjB,CAAC;CACgD,CAAC;AAErD,+EAA+E;AAE/E,MAAM,MAAM,GAAG,CAAC,CAA+B,EAAkB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAE/F,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,iBAAiB,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,mBAAmB;QACxB,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,4BAA4B;QACzC,KAAK,EAAE,cAAc;QACrB,OAAO,EAAE,UAAU;KACpB,CAAC;IACF,cAAc,EAAE,MAAM,CAAC;QACrB,GAAG,EAAE,gBAAgB;QACrB,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,yBAAyB;QACtC,KAAK,EAAE,cAAc;QACrB,OAAO,EAAE,MAAM;KAChB,CAAC;IACF,iBAAiB,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,mBAAmB;QACxB,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,4BAA4B;QACzC,KAAK,EAAE,cAAc;KACtB,CAAC;IACF,qBAAqB,EAAE,MAAM,CAAC;QAC5B,GAAG,EAAE,uBAAuB;QAC5B,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,kEAAkE;QAC/E,KAAK,EAAE,cAAc;KACtB,CAAC;IACF,YAAY,EAAE,MAAM,CAAC;QACnB,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,uDAAuD;QACpE,KAAK,EAAE,cAAc;QACrB,OAAO,EAAE,OAAO;KACjB,CAAC;IACF,cAAc,EAAE,MAAM,CAAC;QACrB,GAAG,EAAE,gBAAgB;QACrB,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,iFAAiF;QAC9F,KAAK,EAAE,cAAc;QACrB,OAAO,EAAE,SAAS;KACnB,CAAC;IACF,gBAAgB,EAAE,MAAM,CAAC;QACvB,GAAG,EAAE,kBAAkB;QACvB,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,2BAA2B;QACxC,KAAK,EAAE,iBAAiB;KACzB,CAAC;IACF,kBAAkB,EAAE,MAAM,CAAC;QACzB,GAAG,EAAE,oBAAoB;QACzB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,oCAAoC;QACjD,KAAK,EAAE,iBAAiB;KACzB,CAAC;IACF,kBAAkB,EAAE,MAAM,CAAC;QACzB,GAAG,EAAE,oBAAoB;QACzB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,qBAAqB;QAClC,KAAK,EAAE,iBAAiB;KACzB,CAAC;IACF,gBAAgB,EAAE,MAAM,CAAC;QACvB,GAAG,EAAE,kBAAkB;QACvB,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,4BAA4B;QACzC,KAAK,EAAE,iBAAiB;KACzB,CAAC;IACF,oBAAoB,EAAE,MAAM,CAAC;QAC3B,GAAG,EAAE,sBAAsB;QAC3B,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,+CAA+C;QAC5D,KAAK,EAAE,cAAc;KACtB,CAAC;IACF,kBAAkB,EAAE,MAAM,CAAC;QACzB,GAAG,EAAE,oBAAoB;QACzB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,2DAA2D;QACxE,KAAK,EAAE,cAAc;KACtB,CAAC;IACF,gBAAgB,EAAE,MAAM,CAAC;QACvB,GAAG,EAAE,kBAAkB;QACvB,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,4BAA4B;QACzC,KAAK,EAAE,cAAc;KACtB,CAAC;IACF,eAAe,EAAE,MAAM,CAAC;QACtB,GAAG,EAAE,iBAAiB;QACtB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,sCAAsC;QACnD,KAAK,EAAE,cAAc;KACtB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,aAAa;QAClB,KAAK,EAAE,KAAK;QACZ,WAAW,EAAE,cAAc;QAC3B,KAAK,EAAE,cAAc;KACtB,CAAC;IACF,gBAAgB,EAAE,MAAM,CAAC;QACvB,GAAG,EAAE,kBAAkB;QACvB,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,8BAA8B;QAC3C,KAAK,EAAE,cAAc;KACtB,CAAC;IACF,iBAAiB,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,mBAAmB;QACxB,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,mCAAmC;QAChD,KAAK,EAAE,cAAc;KACtB,CAAC;IACF,gBAAgB,EAAE,MAAM,CAAC;QACvB,GAAG,EAAE,kBAAkB;QACvB,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,4CAA4C;QACzD,KAAK,EAAE,cAAc;KACtB,CAAC;IACF,kBAAkB,EAAE,MAAM,CAAC;QACzB,GAAG,EAAE,oBAAoB;QACzB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,qCAAqC;QAClD,KAAK,EAAE,cAAc;KACtB,CAAC;IACF,eAAe,EAAE,MAAM,CAAC;QACtB,GAAG,EAAE,iBAAiB;QACtB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,gEAAgE;QAC7E,KAAK,EAAE,QAAQ;KAChB,CAAC;IACF,kBAAkB,EAAE,MAAM,CAAC;QACzB,GAAG,EAAE,oBAAoB;QACzB,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,+DAA+D;QAC5E,KAAK,EAAE,QAAQ;KAChB,CAAC;IACF,cAAc,EAAE,MAAM,CAAC;QACrB,GAAG,EAAE,gBAAgB;QACrB,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,+BAA+B;QAC5C,KAAK,EAAE,cAAc;KACtB,CAAC;IACF,wEAAwE;IACxE,oEAAoE;IACpE,qEAAqE;IACrE,iBAAiB,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,mBAAmB;QACxB,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,oFAAoF;QACjG,KAAK,EAAE,kBAAkB;KAC1B,CAAC;IACF,cAAc,EAAE,MAAM,CAAC;QACrB,GAAG,EAAE,gBAAgB;QACrB,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,mDAAmD;QAChE,KAAK,EAAE,kBAAkB;KAC1B,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;QACpB,GAAG,EAAE,eAAe;QACpB,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,mFAAmF;QAChG,KAAK,EAAE,kBAAkB;KAC1B,CAAC;IACF,YAAY,EAAE,MAAM,CAAC;QACnB,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,gCAAgC;QAC7C,KAAK,EAAE,cAAc;KACtB,CAAC;IACF,iBAAiB,EAAE,MAAM,CAAC;QACxB,GAAG,EAAE,mBAAmB;QACxB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,4CAA4C;QACzD,KAAK,EAAE,UAAU;KAClB,CAAC;CACsC,CAAC;AAE3C,gFAAgF;AAEhF,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;IAC/E,gBAAgB,EAAE,EAAE,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;IAC5E,WAAW,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;IAC9E,SAAS,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;CAC7G,CAAC;AAUX,0EAA0E;AAC1E,MAAM,CAAC,MAAM,SAAS,GAAkC,IAAI,GAAG,CAAC;IAC9D,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAa,CAAU,CAAC;IACtE,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAa,CAAU,CAAC;CACtE,CAAC,CAAC;AAEH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,IAAI,KAAK,QAAQ,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,IAAI,KAAK,SAAS,CAAC;AAC/B,CAAC"}

package/dist/core/AgentLoop.d.ts

@@ -0,0 +1,180 @@
+/**
+ * AgentLoop — runs one agent turn end to end. Owns:
+ *   - The per-request ToolRegistry (core tools at construction; crew
+ *     tools via installCrews() once the crew runner exists).
+ *   - Calling the model with streaming + tool execution.
+ *   - Surfacing every event (text, tool call, tool result, error) as a
+ *     typed discriminated union the caller can translate to SSE / a UI.
+ */
+import { type ModelMessage } from "ai";
+import type { ConfigManager } from "../config/ConfigManager.js";
+import type { CrewAgentRunner } from "../crew/CrewAgentRunner.js";
+import type { CrewRegistry } from "../crew/CrewRegistry.js";
+import type { EventBus } from "../events/eventBus.js";
+import type { HookRunner } from "../hooks/HookRunner.js";
+import type { LoopDetector } from "./LoopDetector.js";
+import type { MCPManager } from "../mcp/MCPManager.js";
+import type { DeclarativeMemoryStore } from "../memory/DeclarativeMemoryStore.js";
+import type { MemoryStore } from "../memory/MemoryStore.js";
+import type { SessionStore } from "../memory/SessionStore.js";
+import type { ModelRouter } from "../models/ModelRouter.js";
+import type { FilesystemGuard } from "../safety/FilesystemGuard.js";
+import type { SkillLoader } from "../skills/SkillLoader.js";
+import type { SkillRegistry } from "../skills/SkillRegistry.js";
+import { ToolRegistry } from "../tools/registry.js";
+export interface AgentLoopDeps {
+    readonly cfg: ConfigManager;
+    readonly models: ModelRouter;
+    readonly skills: SkillRegistry;
+    readonly guard: FilesystemGuard;
+    readonly memory: MemoryStore;
+    readonly mcp?: MCPManager;
+    /** Optional user hooks (pre/post tool-call, task start/end). */
+    readonly hooks?: HookRunner;
+    /** Required to enable skill_manage — the agent writing new skills. */
+    readonly skillLoader?: SkillLoader;
+    /** Absolute path to the skills root directory. */
+    readonly skillsRoot?: string;
+    /** Declarative memory (MEMORY.md + USER.md). Injected into the system prompt. */
+    readonly declarativeMemory?: DeclarativeMemoryStore;
+    /** Session store — enables session_search tool. */
+    readonly sessions?: SessionStore;
+    /** Event bus for audit events. */
+    readonly bus?: EventBus;
+    /** Loop detector — intercepts repetitive tool calls before execution. */
+    readonly loopDetector?: LoopDetector;
+    /**
+     * Returns the set of integration ids (twitter, youtube, facebook,
+     * instagram) that currently have at least one connected account.
+     * Tools with `source.kind === "integration"` are hidden from the
+     * model unless their id is in this set — which means integration
+     * crews stay invisible until the user connects the service.
+     */
+    readonly getEnabledIntegrations?: () => Set<string>;
+}
+export type AgentEvent = {
+    type: "text-delta";
+    delta: string;
+} | {
+    type: "reasoning-delta";
+    delta: string;
+} | {
+    type: "tool-call";
+    id: string;
+    name: string;
+    args: unknown;
+} | {
+    type: "tool-result";
+    id: string;
+    name: string;
+    result: unknown;
+    truncated: boolean;
+} | {
+    type: "tool-error";
+    id: string;
+    name: string;
+    message: string;
+} | {
+    type: "step-finish";
+    finishReason: string;
+} | {
+    type: "finish";
+    inputTokens: number;
+    outputTokens: number;
+} | {
+    type: "error";
+    message: string;
+};
+export interface AgentTurnInput {
+    readonly taskId: string;
+    /** Session id — enables per-session system-prompt caching. */
+    readonly sessionId?: string;
+    readonly userMessage: string;
+    /**
+     * Image parts to merge into the user turn alongside text. Populated
+     * when the user attached screenshots / photos (from a channel or the
+     * UI composer). Dropped automatically for non-multimodal models in
+     * the provider layer.
+     */
+    readonly userImages?: ReadonlyArray<{
+        readonly image: Buffer;
+        readonly mimeType: string;
+    }>;
+    /**
+     * File parts (PDFs and any other provider-supported docs) to merge
+     * into the user turn. The AI SDK maps `file` parts to each provider's
+     * native document input — Anthropic `document`, Gemini `inline_data`,
+     * OpenAI Responses file input — so the model reads the PDF with its
+     * text, tables, and figures intact. No local extraction.
+     */
+    readonly userFiles?: ReadonlyArray<{
+        readonly data: Buffer;
+        readonly mimeType: string;
+        readonly filename?: string;
+    }>;
+    readonly history?: readonly ModelMessage[];
+    readonly model?: string;
+    readonly maxSteps?: number;
+    readonly abortSignal?: AbortSignal;
+    /**
+     * When true, the system prompt gains a short "voice mode" section
+     * telling the model to reply in spoken, markdown-free style — no
+     * tables, no code fences, no bullet walls. TTS would read those
+     * literally ("pipe, pipe, newline, pipe...").
+     */
+    readonly voiceMode?: boolean;
+    /**
+     * Narrow the tools visible to the model for this turn only. Names
+     * not in the allow-list are dropped before skill-matching or tool
+     * selection run. Used by SubAgentManager to enforce per-spawn tool
+     * permissions without mutating the shared registry.
+     */
+    readonly allowedTools?: readonly string[];
+}
+export interface AgentTurnResult {
+    readonly modelId: string;
+    readonly eventStream: AsyncIterable<AgentEvent>;
+    readonly responseMessages: () => Promise<readonly ModelMessage[]>;
+}
+export declare class AgentLoop {
+    readonly tools: ToolRegistry;
+    readonly models: ModelRouter;
+    private readonly cfg;
+    private readonly skills;
+    private readonly mcp;
+    private readonly hooks;
+    private readonly declarativeMemory;
+    private readonly loopDetector;
+    private crews;
+    /** Set at the start of every run() before tools can fire. */
+    private _currentResolvedModelId;
+    /**
+     * Per-session system-prompt cache. Hermes pattern: build once at
+     * session start, reuse across every turn. Invalidated by
+     * `invalidateSystemPromptCache(sessionId)` on compaction, memory
+     * reload, or skill-set change.
+     */
+    private readonly systemPromptCache;
+    private readonly getEnabledIntegrations?;
+    constructor(deps: AgentLoopDeps);
+    /**
+     * Install crew delegation tools AFTER the CrewAgentRunner exists.
+     * Split from the constructor because the runner needs a reference
+     * back to THIS AgentLoop's ToolRegistry, closing the init cycle.
+     */
+    installCrews(registry: CrewRegistry, runner: CrewAgentRunner): void;
+    /** Model id the live turn is resolved to. Throws if called outside a turn. */
+    currentResolvedModel(): string;
+    /**
+     * Invalidate cached system prompt for a session. Call when:
+     *   - Compaction rolled the session to a child id (the child gets a
+     *     fresh system prompt matching the compacted head).
+     *   - Declarative memory was reloaded.
+     *   - Skill registry was mutated.
+     */
+    invalidateSystemPromptCache(sessionId?: string): void;
+    run(input: AgentTurnInput): Promise<AgentTurnResult>;
+    private buildSystemPrompt;
+    private static _soulPrompt;
+}
+//# sourceMappingURL=AgentLoop.d.ts.map