zora-agent 0.9.3 → 0.9.5

package/dist/skills/subagent-loader.d.ts

@@ -0,0 +1,66 @@
+/**
+ * SubagentLoader — Discovers and loads subagent definitions from filesystem.
+ *
+ * TYPE-10: Subagents are defined in SUBAGENT.md files within directory hierarchies:
+ *   1. Project — `.zora/subagents/<name>/SUBAGENT.md`
+ *   2. Global  — `~/.zora/subagents/<name>/SUBAGENT.md`
+ *
+ * Each subagent definition specifies:
+ *   - name: unique identifier
+ *   - description: what the subagent does
+ *   - allowedTools: subset of tools the subagent can use
+ *   - systemPrompt: optional system prompt override
+ *
+ * Subagent isolation rules (from ia-agents pattern):
+ *   - Each subagent gets its own execution context
+ *   - Declared tool subset (not the full tool set)
+ *   - No access to parent conversation history
+ *   - Cannot spawn nested subagents (delegate_to_subagent is excluded)
+ */
+import type { SkillLayer } from './skill-loader.js';
+export interface SubagentInfo {
+    name: string;
+    description: string;
+    allowedTools: string[];
+    systemPrompt: string;
+    path: string;
+    layer: SkillLayer;
+}
+/**
+ * Parses YAML frontmatter from a SUBAGENT.md file.
+ * Extracts: description, allowed_tools (comma-separated), system_prompt.
+ * The body of the markdown (after frontmatter) becomes the system prompt
+ * if no explicit system_prompt frontmatter field is present.
+ */
+export declare function parseSubagentFrontmatter(content: string): {
+    description: string;
+    allowedTools: string[];
+    systemPrompt: string;
+};
+/**
+ * Returns subagent layer directories in precedence order.
+ * Only project and global layers — no built-in subagents.
+ */
+export declare function getSubagentLayers(cwd?: string): Array<{
+    dir: string;
+    layer: SkillLayer;
+}>;
+/**
+ * Loads subagent definitions from project and global layers.
+ * First-match-wins deduplication (project overrides global).
+ *
+ * Subagent isolation is enforced:
+ * - Tools like 'delegate_to_subagent' are always stripped from allowedTools
+ * - Each subagent should be spawned with its own execution context
+ *
+ * @param options.cwd Override for project directory
+ * @param options.layers Override layer directories (useful for testing)
+ */
+export declare function loadSubagents(options?: {
+    cwd?: string;
+    layers?: Array<{
+        dir: string;
+        layer: SkillLayer;
+    }>;
+}): Promise<SubagentInfo[]>;
+//# sourceMappingURL=subagent-loader.d.ts.map

package/dist/skills/subagent-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-loader.d.ts","sourceRoot":"","sources":["../../src/skills/subagent-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;CACnB;AAID;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB,CAsCA;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC,CAQzF;AAkDD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;CACpD,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAgB1B"}

package/dist/skills/subagent-loader.js

@@ -0,0 +1,143 @@
+/**
+ * SubagentLoader — Discovers and loads subagent definitions from filesystem.
+ *
+ * TYPE-10: Subagents are defined in SUBAGENT.md files within directory hierarchies:
+ *   1. Project — `.zora/subagents/<name>/SUBAGENT.md`
+ *   2. Global  — `~/.zora/subagents/<name>/SUBAGENT.md`
+ *
+ * Each subagent definition specifies:
+ *   - name: unique identifier
+ *   - description: what the subagent does
+ *   - allowedTools: subset of tools the subagent can use
+ *   - systemPrompt: optional system prompt override
+ *
+ * Subagent isolation rules (from ia-agents pattern):
+ *   - Each subagent gets its own execution context
+ *   - Declared tool subset (not the full tool set)
+ *   - No access to parent conversation history
+ *   - Cannot spawn nested subagents (delegate_to_subagent is excluded)
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+// ─── Frontmatter Parser ─────────────────────────────────────────────
+/**
+ * Parses YAML frontmatter from a SUBAGENT.md file.
+ * Extracts: description, allowed_tools (comma-separated), system_prompt.
+ * The body of the markdown (after frontmatter) becomes the system prompt
+ * if no explicit system_prompt frontmatter field is present.
+ */
+export function parseSubagentFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)/);
+    if (!match) {
+        return { description: '', allowedTools: [], systemPrompt: content.trim() };
+    }
+    const frontmatter = match[1];
+    const body = match[2]?.trim() ?? '';
+    let description = '';
+    let allowedTools = [];
+    let systemPrompt = '';
+    for (const line of frontmatter.split('\n')) {
+        const colonIdx = line.indexOf(':');
+        if (colonIdx <= 0)
+            continue;
+        const key = line.slice(0, colonIdx).trim();
+        const value = line.slice(colonIdx + 1).trim();
+        switch (key) {
+            case 'description':
+                description = value;
+                break;
+            case 'allowed_tools':
+                allowedTools = value.split(',').map(t => t.trim()).filter(Boolean);
+                break;
+            case 'system_prompt':
+                systemPrompt = value;
+                break;
+        }
+    }
+    // Body becomes system prompt if no explicit system_prompt in frontmatter
+    if (!systemPrompt && body) {
+        systemPrompt = body;
+    }
+    return { description, allowedTools, systemPrompt };
+}
+// ─── Layer Directories ──────────────────────────────────────────────
+/**
+ * Returns subagent layer directories in precedence order.
+ * Only project and global layers — no built-in subagents.
+ */
+export function getSubagentLayers(cwd) {
+    const projectDir = path.join(cwd ?? process.cwd(), '.zora', 'subagents');
+    const globalDir = path.join(os.homedir(), '.zora', 'subagents');
+    return [
+        { dir: projectDir, layer: 'project' },
+        { dir: globalDir, layer: 'global' },
+    ];
+}
+// ─── Subagent Scanner ───────────────────────────────────────────────
+/** Blocked tools that subagents can never use (nesting prevention). */
+const BLOCKED_SUBAGENT_TOOLS = ['delegate_to_subagent', 'spawn_subagent'];
+/**
+ * Scans a single directory for SUBAGENT.md files.
+ */
+async function scanSubagentLayer(dir, layer) {
+    const subagents = [];
+    let entries;
+    try {
+        entries = await fs.readdir(dir);
+    }
+    catch {
+        return subagents;
+    }
+    for (const entry of entries) {
+        const subagentPath = path.join(dir, entry, 'SUBAGENT.md');
+        try {
+            const stat = await fs.stat(path.join(dir, entry));
+            if (!stat.isDirectory())
+                continue;
+            const content = await fs.readFile(subagentPath, 'utf-8');
+            const parsed = parseSubagentFrontmatter(content);
+            // Filter out blocked tools (nesting prevention)
+            const allowedTools = parsed.allowedTools.filter(t => !BLOCKED_SUBAGENT_TOOLS.includes(t));
+            subagents.push({
+                name: entry,
+                description: parsed.description || `Subagent: ${entry}`,
+                allowedTools,
+                systemPrompt: parsed.systemPrompt,
+                path: subagentPath,
+                layer,
+            });
+        }
+        catch {
+            // Skip directories without SUBAGENT.md
+        }
+    }
+    return subagents;
+}
+/**
+ * Loads subagent definitions from project and global layers.
+ * First-match-wins deduplication (project overrides global).
+ *
+ * Subagent isolation is enforced:
+ * - Tools like 'delegate_to_subagent' are always stripped from allowedTools
+ * - Each subagent should be spawned with its own execution context
+ *
+ * @param options.cwd Override for project directory
+ * @param options.layers Override layer directories (useful for testing)
+ */
+export async function loadSubagents(options) {
+    const layers = options?.layers ?? getSubagentLayers(options?.cwd);
+    const seen = new Set();
+    const result = [];
+    for (const { dir, layer } of layers) {
+        const subagents = await scanSubagentLayer(dir, layer);
+        for (const subagent of subagents) {
+            if (!seen.has(subagent.name)) {
+                seen.add(subagent.name);
+                result.push(subagent);
+            }
+        }
+    }
+    return result.sort((a, b) => a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=subagent-loader.js.map

package/dist/skills/subagent-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-loader.js","sourceRoot":"","sources":["../../src/skills/subagent-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAczB,uEAAuE;AAEvE;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAe;IAKtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACjE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;IAC7E,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACpC,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,YAAY,GAAa,EAAE,CAAC;IAChC,IAAI,YAAY,GAAG,EAAE,CAAC;IAEtB,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,QAAQ,IAAI,CAAC;YAAE,SAAS;QAE5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAE9C,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,aAAa;gBAChB,WAAW,GAAG,KAAK,CAAC;gBACpB,MAAM;YACR,KAAK,eAAe;gBAClB,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACnE,MAAM;YACR,KAAK,eAAe;gBAClB,YAAY,GAAG,KAAK,CAAC;gBACrB,MAAM;QACV,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,IAAI,CAAC,YAAY,IAAI,IAAI,EAAE,CAAC;QAC1B,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AACrD,CAAC;AAED,uEAAuE;AAEvE;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAEhE,OAAO;QACL,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,SAAuB,EAAE;QACnD,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,QAAsB,EAAE;KAClD,CAAC;AACJ,CAAC;AAED,uEAAuE;AAEvE,uEAAuE;AACvE,MAAM,sBAAsB,GAAG,CAAC,sBAAsB,EAAE,gBAAgB,CAAC,CAAC;AAE1E;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAAC,GAAW,EAAE,KAAiB;IAC7D,MAAM,SAAS,GAAmB,EAAE,CAAC;IAErC,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;QAC1D,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;YAClD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;gBAAE,SAAS;YAElC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACzD,MAAM,MAAM,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;YAEjD,gDAAgD;YAChD,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAC7C,CAAC,CAAC,EAAE,CAAC,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC,CACzC,CAAC;YAEF,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,KAAK;gBACX,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,aAAa,KAAK,EAAE;gBACvD,YAAY;gBACZ,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,IAAI,EAAE,YAAY;gBAClB,KAAK;aACN,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAGnC;IACC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,iBAAiB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAmB,EAAE,CAAC;IAElC,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,MAAM,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACtD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/steering/flag-manager.d.ts

@@ -16,6 +16,19 @@ export interface FlagEntry {
     timestamp: string;
     resolvedAt?: string;
 }
+export interface FlagFileDiagnostic {
+    file: string;
+    status: 'loaded' | 'failed';
+    errorType?: 'not_found' | 'permission' | 'parse_error' | 'read_error';
+    reason?: string;
+    timestamp: number;
+}
+export interface FlagConfigStatus {
+    filesLoaded: number;
+    filesFailed: number;
+    failedFiles: FlagFileDiagnostic[];
+    timestamp: number;
+}
 export interface FlagManagerOptions {
     timeoutMs: number;
     notifyFn?: (msg: string) => void;
@@ -25,7 +38,14 @@ export declare class FlagManager {
     private readonly _timeoutMs;
     private readonly _notifyFn?;
     private readonly _timers;
+    private readonly _diagnostics;
+    private _filesLoaded;
+    private _filesFailed;
     constructor(flagsDir: string, options: FlagManagerOptions);
+    /**
+     * Returns diagnostic status of flag file loading operations.
+     */
+    getConfigStatus(): FlagConfigStatus;
     /**
      * Creates a new flag for a decision. Starts the timeout clock.
      */

package/dist/steering/flag-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flag-manager.d.ts","sourceRoot":"","sources":["../../src/steering/flag-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,gBAAgB,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAwB;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyD;gBAErE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB;IAMzD;;OAEG;IACG,IAAI,CACR,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC;IA+BlB;;OAEG;IACG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA6BpD;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;YAerE,QAAQ;YAmCR,YAAY;CAqB3B"}
+{"version":3,"file":"flag-manager.d.ts","sourceRoot":"","sources":["../../src/steering/flag-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,gBAAgB,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,SAAS,CAAC,EAAE,WAAW,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,CAAC;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAwB;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyD;IACjF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IACzD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;gBAEb,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB;IAMzD;;OAEG;IACH,eAAe,IAAI,gBAAgB;IASnC;;OAEG;IACG,IAAI,CACR,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC;IAgClB;;OAEG;IACG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAmEpD;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;YAgCrE,QAAQ;YA2CR,YAAY;CAgC3B"}

package/dist/steering/flag-manager.js

@@ -9,20 +9,37 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { writeAtomic } from '../utils/fs.js';
+import { getLogger } from '../utils/logger.js';
+import { validateJobId } from '../utils/validate-job-id.js';
 export class FlagManager {
     _flagsDir;
     _timeoutMs;
     _notifyFn;
     _timers = new Map();
+    _diagnostics = [];
+    _filesLoaded = 0;
+    _filesFailed = 0;
     constructor(flagsDir, options) {
         this._flagsDir = flagsDir;
         this._timeoutMs = options.timeoutMs;
         this._notifyFn = options.notifyFn;
     }
+    /**
+     * Returns diagnostic status of flag file loading operations.
+     */
+    getConfigStatus() {
+        return {
+            filesLoaded: this._filesLoaded,
+            filesFailed: this._filesFailed,
+            failedFiles: this._diagnostics.filter(d => d.status === 'failed'),
+            timestamp: Date.now(),
+        };
+    }
     /**
      * Creates a new flag for a decision. Starts the timeout clock.
      */
     async flag(jobId, question, defaultAction) {
+        validateJobId(jobId);
         await fs.mkdir(this._flagsDir, { recursive: true });
         const flagId = `flag_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
         const entry = {
@@ -50,30 +67,64 @@ export class FlagManager {
      * Lists all flags, optionally filtered by job ID.
      */
     async getFlags(jobId) {
+        const logger = getLogger();
         try {
             const files = await fs.readdir(this._flagsDir);
             const flags = [];
             for (const file of files) {
                 if (!file.endsWith('.json'))
                     continue;
+                const filePath = path.join(this._flagsDir, file);
                 try {
-                    const content = await fs.readFile(path.join(this._flagsDir, file), 'utf8');
+                    const content = await fs.readFile(filePath, 'utf8');
                     const entry = JSON.parse(content);
                     if (!jobId || entry.jobId === jobId) {
                         flags.push(entry);
                     }
+                    this._filesLoaded++;
+                    this._diagnostics.push({ file, status: 'loaded', timestamp: Date.now() });
                 }
                 catch (err) {
-                    // R30: Log malformed flag files instead of silently skipping
-                    console.warn(`[FlagManager] Failed to read flag file ${file}:`, err instanceof Error ? err.message : String(err));
+                    const errMsg = err instanceof Error ? err.message : String(err);
+                    const code = err.code;
+                    const errorType = err instanceof SyntaxError
+                        ? 'parse_error'
+                        : code === 'ENOENT'
+                            ? 'not_found'
+                            : code === 'EACCES'
+                                ? 'permission'
+                                : 'read_error';
+                    logger.warn({ path: filePath, errorType, error: errMsg }, 'Failed to load flag file');
+                    this._filesFailed++;
+                    this._diagnostics.push({
+                        file,
+                        status: 'failed',
+                        errorType,
+                        reason: errMsg,
+                        timestamp: Date.now(),
+                    });
                 }
             }
             return flags;
         }
         catch (err) {
-            // R30: Log directory read errors instead of silently returning empty
-            if (err.code !== 'ENOENT') {
-                console.warn(`[FlagManager] Failed to read flags directory:`, err instanceof Error ? err.message : String(err));
+            const code = err.code;
+            if (code !== 'ENOENT') {
+                const errMsg = err instanceof Error ? err.message : String(err);
+                const errorType = code === 'ENOENT'
+                    ? 'not_found'
+                    : code === 'EACCES'
+                        ? 'permission'
+                        : 'read_error';
+                logger.warn({ path: this._flagsDir, errorType, error: errMsg }, 'Failed to read flags directory');
+                this._filesFailed++;
+                this._diagnostics.push({
+                    file: this._flagsDir,
+                    status: 'failed',
+                    errorType,
+                    reason: errMsg,
+                    timestamp: Date.now(),
+                });
             }
             return [];
         }
@@ -94,6 +145,7 @@ export class FlagManager {
      * Returns the current decision status for a flag.
      */
     async getFlagDecision(flagId) {
+        const logger = getLogger();
         const flagPath = path.join(this._flagsDir, `${flagId}.json`);
         try {
             const content = await fs.readFile(flagPath, 'utf8');
@@ -105,8 +157,21 @@ export class FlagManager {
             return 'rejected';
         }
         catch (err) {
-            // R30: Log flag read errors instead of silently defaulting
-            console.warn(`[FlagManager] Failed to read flag ${flagId}:`, err instanceof Error ? err.message : String(err));
+            const errMsg = err instanceof Error ? err.message : String(err);
+            const code = err.code;
+            const errorType = err instanceof SyntaxError
+                ? 'parse_error'
+                : code === 'ENOENT'
+                    ? 'not_found'
+                    : 'read_error';
+            logger.warn({ flagId, path: flagPath, errorType, error: errMsg }, 'Failed to read flag decision');
+            this._diagnostics.push({
+                file: `${flagId}.json`,
+                status: 'failed',
+                errorType,
+                reason: errMsg,
+                timestamp: Date.now(),
+            });
             return 'pending';
         }
     }
@@ -117,6 +182,7 @@ export class FlagManager {
             clearTimeout(timer);
             this._timers.delete(flagId);
         }
+        const logger = getLogger();
         const flagPath = path.join(this._flagsDir, `${flagId}.json`);
         let content;
         try {
@@ -125,7 +191,15 @@ export class FlagManager {
         catch {
             throw new Error(`Flag not found: ${flagId}`);
         }
-        const entry = JSON.parse(content);
+        let entry;
+        try {
+            entry = JSON.parse(content);
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            logger.warn({ flagId, path: flagPath, errorType: 'parse_error', error: errMsg }, 'Corrupted flag file during resolve');
+            throw new Error(`Corrupted flag file: ${flagId}`);
+        }
         // Only resolve if still pending to avoid TOCTOU race
         if (entry.status !== 'pending_review') {
             return; // Already resolved
@@ -138,6 +212,7 @@ export class FlagManager {
         await writeAtomic(flagPath, JSON.stringify(entry, null, 2));
     }
     async _autoResolve(flagId, defaultAction) {
+        const logger = getLogger();
         this._timers.delete(flagId);
         const flagPath = path.join(this._flagsDir, `${flagId}.json`);
         try {
@@ -152,8 +227,16 @@ export class FlagManager {
             await writeAtomic(flagPath, JSON.stringify(entry, null, 2));
         }
         catch (err) {
-            // R30: Log auto-resolve errors instead of silently swallowing
-            console.warn(`[FlagManager] Failed to auto-resolve flag ${flagId}:`, err instanceof Error ? err.message : String(err));
+            const errMsg = err instanceof Error ? err.message : String(err);
+            const errorType = err instanceof SyntaxError ? 'parse_error' : 'read_error';
+            logger.warn({ flagId, path: flagPath, errorType, error: errMsg }, 'Failed to auto-resolve flag');
+            this._diagnostics.push({
+                file: `${flagId}.json`,
+                status: 'failed',
+                errorType,
+                reason: errMsg,
+                timestamp: Date.now(),
+            });
         }
     }
 }

package/dist/steering/flag-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"flag-manager.js","sourceRoot":"","sources":["../../src/steering/flag-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"flag-manager.js","sourceRoot":"","sources":["../../src/steering/flag-manager.ts"],"names":[],"mappings":"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"}

package/dist/steering/steering-manager.d.ts

@@ -9,6 +9,8 @@
 import type { SteeringMessage } from './types.js';
 export declare class SteeringManager {
     private readonly _steeringDir;
+    /** Debounce cache for getPendingMessages — avoids per-event readdir calls. */
+    private _pendingCache;
     constructor(baseDir?: string);
     /**
      * Initializes the steering directory.
@@ -24,6 +26,15 @@ export declare class SteeringManager {
     getPendingMessages(jobId: string): Promise<(SteeringMessage & {
         id: string;
     })[]>;
+    /**
+     * Returns cached pending messages if the last poll was within maxAgeMs.
+     * Avoids per-event readdir + file read during streaming.
+     */
+    cachedGetPendingMessages(jobId: string, maxAgeMs?: number): Promise<(SteeringMessage & {
+        id: string;
+    })[]>;
+    /** Invalidate the pending messages cache for a job (call after archiving). */
+    invalidatePendingCache(jobId: string): void;
     /**
      * Acknowledges or archives a steering message.
      */

package/dist/steering/steering-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"steering-manager.d.ts","sourceRoot":"","sources":["../../src/steering/steering-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EACV,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,OAAO,GAAE,MAAyC;IAI9D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAc9D;;OAEG;IACG,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,eAAe,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAmBtF;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAavD,OAAO;CAQtB"}
+{"version":3,"file":"steering-manager.d.ts","sourceRoot":"","sources":["../../src/steering/steering-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EACV,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,8EAA8E;IAC9E,OAAO,CAAC,aAAa,CAAiG;gBAE1G,OAAO,GAAE,MAAyC;IAI9D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IAe9D;;OAEG;IACG,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,eAAe,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAoBtF;;;OAGG;IACG,wBAAwB,CAC5B,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAa,GACtB,OAAO,CAAC,CAAC,eAAe,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IAWhD,8EAA8E;IAC9E,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI3C;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAcvD,OAAO;CAQtB"}

package/dist/steering/steering-manager.js

@@ -10,8 +10,11 @@ import path from 'node:path';
 import os from 'node:os';
 import fs from 'node:fs/promises';
 import { writeAtomic } from '../utils/fs.js';
+import { validateJobId } from '../utils/validate-job-id.js';
 export class SteeringManager {
     _steeringDir;
+    /** Debounce cache for getPendingMessages — avoids per-event readdir calls. */
+    _pendingCache = new Map();
     constructor(baseDir = path.join(os.homedir(), '.zora')) {
         this._steeringDir = path.join(baseDir, 'steering');
     }
@@ -27,6 +30,7 @@ export class SteeringManager {
      * Injects a steering message for a specific job.
      */
     async injectMessage(message) {
+        validateJobId(message.jobId);
         const messageId = `steer_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
         const jobDir = path.join(this._steeringDir, message.jobId);
         if (!(await this._exists(jobDir))) {
@@ -40,6 +44,7 @@ export class SteeringManager {
      * Retrieves all unread/pending steering messages for a job.
      */
     async getPendingMessages(jobId) {
+        validateJobId(jobId);
         const jobDir = path.join(this._steeringDir, jobId);
         if (!(await this._exists(jobDir)))
             return [];
@@ -53,10 +58,28 @@ export class SteeringManager {
         }
         return messages.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
     }
+    /**
+     * Returns cached pending messages if the last poll was within maxAgeMs.
+     * Avoids per-event readdir + file read during streaming.
+     */
+    async cachedGetPendingMessages(jobId, maxAgeMs = 2000) {
+        const cached = this._pendingCache.get(jobId);
+        if (cached && (Date.now() - cached.timestamp) < maxAgeMs) {
+            return cached.messages;
+        }
+        const messages = await this.getPendingMessages(jobId);
+        this._pendingCache.set(jobId, { messages, timestamp: Date.now() });
+        return messages;
+    }
+    /** Invalidate the pending messages cache for a job (call after archiving). */
+    invalidatePendingCache(jobId) {
+        this._pendingCache.delete(jobId);
+    }
     /**
      * Acknowledges or archives a steering message.
      */
     async archiveMessage(jobId, messageId) {
+        validateJobId(jobId);
         const messagePath = path.join(this._steeringDir, jobId, `${messageId}.json`);
         const archiveDir = path.join(this._steeringDir, jobId, 'archive');
         if (!(await this._exists(archiveDir))) {

package/dist/steering/steering-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"steering-manager.js","sourceRoot":"","sources":["../../src/steering/steering-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"steering-manager.js","sourceRoot":"","sources":["../../src/steering/steering-manager.ts"],"names":[],"mappings":"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"}

package/dist/steering/telegram-gateway.d.ts

@@ -7,22 +7,25 @@
  *   - Injects steer messages into SteeringManager.
  */
 import type { SteeringManager } from './steering-manager.js';
+import type { SessionManager } from '../orchestrator/session-manager.js';
 import type { SteeringConfig } from '../types.js';
 export interface TelegramConfig extends SteeringConfig {
     bot_token?: string;
     allowed_users: string[];
     enabled: boolean;
+    mode?: 'polling' | 'webhook';
 }
 export declare class TelegramGateway {
     private readonly _bot;
     private readonly _steeringManager;
+    private readonly _sessionManager?;
     private readonly _allowedUsers;
     private constructor();
     /**
      * Factory method — loads node-telegram-bot-api dynamically.
      * Throws a clear error if the optional dep isn't installed.
      */
-    static create(config: TelegramConfig, steeringManager: SteeringManager): Promise<TelegramGateway>;
+    static create(config: TelegramConfig, steeringManager: SteeringManager, sessionManager?: SessionManager): Promise<TelegramGateway>;
     private _setupHandlers;
     /**
      * Stops the bot.

package/dist/steering/telegram-gateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telegram-gateway.d.ts","sourceRoot":"","sources":["../../src/steering/telegram-gateway.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAc;IAE5C,OAAO;IAQP;;;OAGG;WACU,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAqBvG,OAAO,CAAC,cAAc;IA+DtB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}
+{"version":3,"file":"telegram-gateway.d.ts","sourceRoot":"","sources":["../../src/steering/telegram-gateway.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQlD,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAC9B;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IACnD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAiB;IAClD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAc;IAE5C,OAAO;IASP;;;OAGG;WACU,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAgCxI,OAAO,CAAC,cAAc;IAyFtB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}