@backendkit-labs/orchestrator-agent 0.1.1

package/dist/executor.js

@@ -0,0 +1,274 @@
+import { AgentEngine, AgentRegistry, ToolRegistry, ProviderRegistry, CallbackTransport, defineTool, } from '@backendkit-labs/agent-core';
+import { z } from 'zod';
+import { OpenAICompatibleProvider, callLLM } from './provider.js';
+// ── Executor ──────────────────────────────────────────────────────────────────
+export class PlanExecutor {
+    config;
+    ragSearchFn;
+    onProgress;
+    reflection;
+    constructor(opts) {
+        this.config = opts.config;
+        this.ragSearchFn = opts.ragSearchFn;
+        this.onProgress = opts.onProgress ?? (() => { });
+        this.reflection = opts.reflection;
+    }
+    /**
+     * Execute a plan from scratch or resume after a gate approval.
+     *
+     * @param plan           Full task plan.
+     * @param priorResults   Steps already completed in a previous execution segment
+     *                       (used when resuming after a gate). Those steps are treated
+     *                       as done and skipped.
+     */
+    async execute(plan, priorResults = []) {
+        const results = [...priorResults];
+        const completed = new Set(priorResults.map(r => r.subtask_id));
+        const remaining = plan.subtasks.filter(st => !completed.has(st.id));
+        while (remaining.length > 0) {
+            const ready = remaining.filter(st => st.depends_on.every(dep => completed.has(dep)));
+            if (ready.length === 0) {
+                throw new Error('Circular dependency detected in task plan');
+            }
+            for (const subtask of ready) {
+                // Resolve explicit gate from subtask or agent config
+                const agentCfg = this.config.agents.find(a => a.id === subtask.agent_id);
+                const needsGate = subtask.gate ?? agentCfg?.gate ?? false;
+                const explicitCriteria = subtask.gate_criteria ?? agentCfg?.gate_criteria ?? [];
+                // ── Cable 2: check active policyRules before running ───────────
+                // Rules that match this step add criteria to the gate, turning
+                // un-gated steps into gated ones — deterministically, without LLM.
+                const { matchedRuleIds, ruleCriteria } = await this.checkActiveRules(subtask.task, agentCfg?.domain);
+                const forceGate = matchedRuleIds.length > 0;
+                const allCriteria = [...explicitCriteria, ...ruleCriteria];
+                if (forceGate) {
+                    this.onProgress(`  ⚠ [${subtask.id}] ${matchedRuleIds.length} policy rule(s) applied — gate enforced`);
+                }
+                // ─────────────────────────────────────────────────────────────────
+                const result = await this.runSubTask(subtask, results);
+                results.push(result);
+                completed.add(subtask.id);
+                remaining.splice(remaining.indexOf(subtask), 1);
+                if ((needsGate || forceGate) && result.success) {
+                    return {
+                        gateRequired: true,
+                        stepId: subtask.id,
+                        agentId: subtask.agent_id,
+                        output: result.result,
+                        criteria: allCriteria,
+                        completedSoFar: results,
+                        appliedRuleIds: matchedRuleIds,
+                    };
+                }
+            }
+        }
+        const summary = this.consolidate(plan, results);
+        return { plan, results, summary, complete: true };
+    }
+    async runSubTask(subtask, priorResults) {
+        const agentCfg = this.config.agents.find(a => a.id === subtask.agent_id);
+        this.onProgress(`  → [${subtask.id}] ${agentCfg?.name ?? subtask.agent_id}: ${subtask.task.slice(0, 80)}…`);
+        const start = Date.now();
+        try {
+            const result = agentCfg
+                ? await this.runSpecialist(agentCfg, subtask, priorResults)
+                : `No agent configured for id: ${subtask.agent_id}`;
+            return {
+                subtask_id: subtask.id,
+                agent_id: subtask.agent_id,
+                task: subtask.task,
+                result,
+                success: true,
+                duration_ms: Date.now() - start,
+            };
+        }
+        catch (err) {
+            return {
+                subtask_id: subtask.id,
+                agent_id: subtask.agent_id,
+                task: subtask.task,
+                result: `Error: ${err instanceof Error ? err.message : String(err)}`,
+                success: false,
+                duration_ms: Date.now() - start,
+            };
+        }
+    }
+    async runSpecialist(agentCfg, subtask, priorResults) {
+        const providerCfg = this.config.providers[agentCfg.provider];
+        if (!providerCfg) {
+            throw new Error(`Provider "${agentCfg.provider}" not configured for agent "${agentCfg.id}"`);
+        }
+        const provider = new OpenAICompatibleProvider(providerCfg);
+        // Build vault context for this specialist
+        let vaultContext = '';
+        if (this.ragSearchFn) {
+            try {
+                vaultContext = await this.ragSearchFn(subtask.task);
+            }
+            catch { /* vault optional */ }
+        }
+        // Include relevant prior results as context
+        const priorContext = priorResults.length > 0
+            ? '\n\nContext from previous steps:\n' +
+                priorResults.map(r => `[${r.agent_id}] ${r.task}\n→ ${r.result.slice(0, 300)}`).join('\n\n')
+            : '';
+        const systemPrompt = agentCfg.system_prompt ?? buildSpecialistPrompt(agentCfg);
+        const userPrompt = [
+            subtask.task,
+            vaultContext ? `\nRelevant knowledge:\n${vaultContext}` : '',
+            priorContext,
+        ].filter(Boolean).join('\n');
+        return callLLM(provider, systemPrompt, userPrompt);
+    }
+    /**
+     * Cable 2: query active policyRules and match against this subtask.
+     * Returns matched rule IDs and the criteria text to show the human approver.
+     * No-op when reflection is not configured.
+     */
+    async checkActiveRules(taskText, agentDomain) {
+        if (!this.reflection)
+            return { matchedRuleIds: [], ruleCriteria: [] };
+        let rules;
+        try {
+            rules = await this.reflection.activeRules({ domain: agentDomain });
+        }
+        catch {
+            return { matchedRuleIds: [], ruleCriteria: [] };
+        }
+        const matchedRuleIds = [];
+        const ruleCriteria = [];
+        for (const rule of rules) {
+            if (matchesSubtask(rule, taskText, agentDomain)) {
+                matchedRuleIds.push(rule.id);
+                ruleCriteria.push(...ruleToGateCriteria(rule));
+            }
+        }
+        return { matchedRuleIds, ruleCriteria };
+    }
+    consolidate(plan, results) {
+        const successCount = results.filter(r => r.success).length;
+        const lines = [
+            `## ${plan.summary}`,
+            `Completed ${successCount}/${results.length} sub-tasks.`,
+            '',
+        ];
+        for (const r of results) {
+            const icon = r.success ? '✓' : '✗';
+            lines.push(`**${icon} [${r.agent_id}]** ${r.task.slice(0, 80)}`);
+            lines.push(r.result.slice(0, 500));
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+}
+/**
+ * Returns true when a policyRule applies to a subtask.
+ * Match requires at least one of:
+ *   - domain match + keyword hit
+ *   - domain match + no keywords (catch-all for that domain)
+ *   - no domain specified + keyword hit
+ * A rule with neither domain nor keywords is skipped (too broad).
+ */
+function matchesSubtask(rule, taskText, agentDomain) {
+    const cond = rule.if;
+    if (cond.domain) {
+        if (!agentDomain)
+            return false;
+        const domains = Array.isArray(cond.domain) ? cond.domain : [cond.domain];
+        if (!domains.includes(agentDomain))
+            return false;
+        // Domain matched — keywords narrow it further; if none, it's a domain catch-all
+        if (!cond.keywords?.length)
+            return true;
+    }
+    if (cond.keywords?.length) {
+        const lower = taskText.toLowerCase();
+        return cond.keywords.some((kw) => lower.includes(kw.toLowerCase()));
+    }
+    return false; // no domain, no keywords → too broad
+}
+/**
+ * Converts a policyRule's `then` action into human-readable gate criteria.
+ * These criteria are shown to the approver alongside the agent's output.
+ */
+function ruleToGateCriteria(rule) {
+    const a = rule.then;
+    const criteria = [];
+    if (a.mustInclude?.length)
+        criteria.push(`Debe incluir: ${a.mustInclude.join(', ')}`);
+    if (a.mustPass?.length)
+        criteria.push(`Debe cumplir: ${a.mustPass.join(', ')}`);
+    if (a.mustExecute?.length)
+        criteria.push(`Debe ejecutar: ${a.mustExecute.join(', ')}`);
+    if (a.requireArchitectureReview)
+        criteria.push('Requiere revisión de arquitectura');
+    if (a.requireSecurityReview)
+        criteria.push('Requiere revisión de seguridad');
+    if (a.requireQaApproval)
+        criteria.push('Requiere aprobación de QA');
+    return criteria.length > 0
+        ? criteria
+        : [`Política "${rule.name}" aplicada — revisión requerida`];
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function buildSpecialistPrompt(agent) {
+    return [
+        `You are ${agent.name}, a specialist agent.`,
+        '',
+        `Domain: ${agent.description}`,
+        `Capabilities: ${agent.capabilities.join(', ')}`,
+        '',
+        'Execute the assigned task thoroughly and return a structured, actionable result.',
+        'Stay within your domain. If a request is outside your capabilities, say so clearly.',
+    ].join('\n');
+}
+// ── Orchestrator engine (for interactive mode) ────────────────────────────────
+// Builds a full AgentEngine with ask_agent tool for direct LLM-driven orchestration.
+export function buildOrchestratorEngine(opts) {
+    const { config, orchestratorProfile, ragTool, ragSearchFn, onProgress } = opts;
+    const executor = new PlanExecutor({ config, ragSearchFn, onProgress });
+    const askAgentTool = defineTool({
+        name: 'ask_agent',
+        description: 'Delegate a task to a configured specialist agent',
+        input: z.object({
+            agent_id: z.string().describe('ID of the specialist agent from orchestrator.yaml'),
+            task: z.string().describe('Specific task for the specialist to execute'),
+        }),
+        execute: async ({ agent_id, task }) => {
+            const agentCfg = config.agents.find(a => a.id === agent_id);
+            if (!agentCfg) {
+                return `No agent with id "${agent_id}". Available: ${config.agents.map(a => a.id).join(', ')}`;
+            }
+            onProgress?.(`  → delegating to ${agentCfg.name}…`);
+            return executor['runSpecialist'](agentCfg, { id: 'x', agent_id, task, depends_on: [] }, []);
+        },
+    });
+    const tools = new ToolRegistry();
+    if (ragTool)
+        tools.register(ragTool);
+    tools.register(askAgentTool);
+    const orchestratorProviderCfg = config.providers[config.orchestrator.provider];
+    if (!orchestratorProviderCfg) {
+        throw new Error(`Orchestrator provider "${config.orchestrator.provider}" not found in providers config`);
+    }
+    const providers = new ProviderRegistry();
+    providers.register(config.orchestrator.provider, new OpenAICompatibleProvider(orchestratorProviderCfg));
+    const agents = new AgentRegistry();
+    agents.register(orchestratorProfile);
+    const transport = new CallbackTransport((evt) => {
+        if (evt.type === 'tool_call')
+            onProgress?.(`  ● ${evt.name}`);
+    });
+    return new AgentEngine({
+        model: { provider: config.orchestrator.provider, id: orchestratorProviderCfg.model },
+        agents,
+        tools,
+        providers,
+        defaultProvider: config.orchestrator.provider,
+        defaultAgentId: 'orchestrator',
+        transport,
+        maxIterations: 20,
+        iterationMode: 'auto',
+    });
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

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

package/dist/planner.d.ts

@@ -0,0 +1,21 @@
+import type { AgentConfig } from './config.js';
+export interface SubTask {
+    id: string;
+    agent_id: string;
+    task: string;
+    depends_on: string[];
+    gate?: boolean;
+    gate_criteria?: string[];
+}
+export interface TaskPlan {
+    summary: string;
+    subtasks: SubTask[];
+}
+export declare class TaskPlanner {
+    private readonly callLLM;
+    constructor(callLLM: (system: string, user: string) => Promise<string>);
+    plan(task: string, agents: AgentConfig[], vaultContext?: string): Promise<TaskPlan>;
+    private parse;
+    private validate;
+}
+//# sourceMappingURL=planner.d.ts.map

package/dist/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../src/planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,MAAM,WAAW,OAAO;IACpB,EAAE,EAAc,MAAM,CAAC;IACvB,QAAQ,EAAQ,MAAM,CAAC;IACvB,IAAI,EAAY,MAAM,CAAC;IACvB,UAAU,EAAM,MAAM,EAAE,CAAC;IACzB,IAAI,CAAC,EAAW,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,QAAQ;IACrB,OAAO,EAAI,MAAM,CAAC;IAClB,QAAQ,EAAG,OAAO,EAAE,CAAC;CACxB;AA6BD,qBAAa,WAAW;IAEhB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC;IAGzE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAsBzF,OAAO,CAAC,KAAK;IAcb,OAAO,CAAC,QAAQ;CAgBnB"}

package/dist/planner.js

@@ -0,0 +1,78 @@
+// ── Prompt ────────────────────────────────────────────────────────────────────
+const PLANNER_SYSTEM = `You are a task decomposition expert.
+Given a task and a list of available specialist agents, produce a JSON execution plan.
+
+Output ONLY valid JSON — no markdown, no explanation:
+{
+  "summary": "one-line description of the overall plan",
+  "subtasks": [
+    {
+      "id": "t1",
+      "agent_id": "agent-id-from-list",
+      "task": "specific, actionable instruction for this specialist",
+      "depends_on": []
+    }
+  ]
+}
+
+Rules:
+- Use only agent IDs from the provided list.
+- depends_on: [] means the sub-task can start immediately.
+- depends_on: ["t1"] means this sub-task waits for t1 to finish.
+- If no agent matches a needed capability, use agent_id="unresolved" and note the gap in the task field.
+- Keep each task description focused and self-contained.`;
+// ── TaskPlanner ───────────────────────────────────────────────────────────────
+export class TaskPlanner {
+    callLLM;
+    constructor(callLLM) {
+        this.callLLM = callLLM;
+    }
+    async plan(task, agents, vaultContext) {
+        const agentList = agents
+            .map(a => `- id: ${a.id}\n  name: ${a.name}\n  capabilities: [${a.capabilities.join(', ')}]`)
+            .join('\n');
+        const contextBlock = vaultContext
+            ? `\nKnowledge base context (use to inform the plan):\n${vaultContext}\n`
+            : '';
+        const user = [
+            `Task: ${task}`,
+            contextBlock,
+            'Available agents:',
+            agentList,
+            '',
+            'Produce the execution plan as JSON.',
+        ].join('\n');
+        const raw = await this.callLLM(PLANNER_SYSTEM, user);
+        return this.parse(raw);
+    }
+    parse(raw) {
+        const jsonMatch = raw.match(/```(?:json)?\s*([\s\S]*?)```/) ?? raw.match(/(\{[\s\S]*\})/);
+        const jsonStr = jsonMatch ? jsonMatch[1].trim() : raw.trim();
+        try {
+            const plan = JSON.parse(jsonStr);
+            this.validate(plan);
+            return plan;
+        }
+        catch (err) {
+            throw new Error(`TaskPlanner: could not parse plan.\nRaw output: ${raw.slice(0, 500)}\nError: ${String(err)}`);
+        }
+    }
+    validate(plan) {
+        if (!plan.summary || !Array.isArray(plan.subtasks)) {
+            throw new Error('Plan missing required fields: summary, subtasks');
+        }
+        for (const st of plan.subtasks) {
+            if (!st.id || !st.agent_id || !st.task || !Array.isArray(st.depends_on)) {
+                throw new Error(`Sub-task malformed: ${JSON.stringify(st)}`);
+            }
+        }
+        const ids = new Set(plan.subtasks.map(s => s.id));
+        for (const st of plan.subtasks) {
+            for (const dep of st.depends_on) {
+                if (!ids.has(dep))
+                    throw new Error(`Sub-task ${st.id} depends on unknown id: ${dep}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=planner.js.map

package/dist/planner.js.map

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

package/dist/profile.d.ts

@@ -0,0 +1,4 @@
+import type { AgentProfile } from '@backendkit-labs/agent-core';
+import type { OrchestratorConfig } from './config.js';
+export declare function buildOrchestratorProfile(config: OrchestratorConfig): AgentProfile;
+//# sourceMappingURL=profile.d.ts.map

package/dist/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAKtD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAkCjF"}

package/dist/profile.js

@@ -0,0 +1,36 @@
+// Builds the orchestrator's AgentProfile dynamically from orchestrator.yaml.
+// The system prompt is generated from configured agents — not hardcoded.
+export function buildOrchestratorProfile(config) {
+    const agentList = config.agents
+        .map(a => `  - ${a.id} (${a.name}): ${a.description}\n    capabilities: [${a.capabilities.join(', ')}]`)
+        .join('\n');
+    const systemPrompt = [
+        `You are ${config.orchestrator.name}, an intelligent task orchestrator.`,
+        '',
+        'Your responsibilities:',
+        '1. Understand the user\'s request and identify which specialists are needed.',
+        '2. Search the shared knowledge vault with search_knowledge for relevant context.',
+        '3. Delegate each part of the task to the appropriate specialist via ask_agent.',
+        '4. For independent tasks, you can call ask_agent multiple times.',
+        '5. Consolidate all results into a coherent, actionable final answer.',
+        '',
+        'Available specialists:',
+        agentList,
+        '',
+        'Rules:',
+        '- Always search the vault before delegating — existing decisions should guide the plan.',
+        '- Never execute domain work yourself — delegate everything to specialists.',
+        '- If a task requires capabilities no agent has, say so explicitly.',
+        '- Cite specialist results in your final answer.',
+    ].join('\n');
+    return {
+        id: 'orchestrator',
+        name: config.orchestrator.name,
+        icon: '◆',
+        description: 'Dynamic task orchestrator — routes and coordinates configured specialist agents.',
+        systemPrompt,
+        allowedTools: ['search_knowledge', 'ask_agent'],
+        delegatesTo: config.agents.map(a => a.id),
+    };
+}
+//# sourceMappingURL=profile.js.map

package/dist/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAGA,6EAA6E;AAC7E,yEAAyE;AAEzE,MAAM,UAAU,wBAAwB,CAAC,MAA0B;IAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM;SAC1B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,WAAW,wBAAwB,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;SACvG,IAAI,CAAC,IAAI,CAAC,CAAC;IAEhB,MAAM,YAAY,GAAG;QACjB,WAAW,MAAM,CAAC,YAAY,CAAC,IAAI,qCAAqC;QACxE,EAAE;QACF,wBAAwB;QACxB,8EAA8E;QAC9E,kFAAkF;QAClF,gFAAgF;QAChF,kEAAkE;QAClE,sEAAsE;QACtE,EAAE;QACF,wBAAwB;QACxB,SAAS;QACT,EAAE;QACF,QAAQ;QACR,yFAAyF;QACzF,4EAA4E;QAC5E,oEAAoE;QACpE,iDAAiD;KACpD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO;QACH,EAAE,EAAY,cAAc;QAC5B,IAAI,EAAU,MAAM,CAAC,YAAY,CAAC,IAAI;QACtC,IAAI,EAAU,GAAG;QACjB,WAAW,EAAG,kFAAkF;QAChG,YAAY;QACZ,YAAY,EAAE,CAAC,kBAAkB,EAAE,WAAW,CAAC;QAC/C,WAAW,EAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC;AACN,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,13 @@
+import type { LLMProvider, LLMMessage, LLMStreamCallbacks, ToolDefinition } from '@backendkit-labs/agent-core';
+import type { ProviderConfig } from './config.js';
+export declare class OpenAICompatibleProvider implements LLMProvider {
+    private readonly client;
+    private readonly model;
+    private readonly maxRetries;
+    private readonly temperature;
+    constructor(cfg: ProviderConfig, maxRetries?: number);
+    chat(messages: LLMMessage[], tools: ToolDefinition[], callbacks: LLMStreamCallbacks): Promise<void>;
+    private stream;
+}
+export declare function callLLM(provider: OpenAICompatibleProvider, system: string, user: string): Promise<string>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC/G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAiBlD,qBAAa,wBAAyB,YAAW,WAAW;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,GAAG,EAAE,cAAc,EAAE,UAAU,SAAI;IAWzC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;YA2B3F,MAAM;CA8CvB;AAID,wBAAsB,OAAO,CACzB,QAAQ,EAAE,wBAAwB,EAClC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAgBjB"}

package/dist/provider.js

@@ -0,0 +1,116 @@
+import OpenAI from 'openai';
+// OpenAI-compatible provider — covers DeepSeek, Ollama, and OpenAI.
+// DeepSeek: base_url=https://api.deepseek.com
+// Ollama:   base_url=http://localhost:11434/v1, api_key=ollama
+// OpenAI:   base_url omitted (default)
+const sleep = (ms) => new Promise(r => setTimeout(r, ms));
+function isRetryable(err) {
+    if (err && typeof err === 'object' && 'status' in err) {
+        const s = err.status;
+        return s === 429 || s >= 500;
+    }
+    return false;
+}
+export class OpenAICompatibleProvider {
+    client;
+    model;
+    maxRetries;
+    temperature;
+    constructor(cfg, maxRetries = 3) {
+        this.client = new OpenAI({
+            apiKey: cfg.api_key ?? 'no-key',
+            baseURL: cfg.base_url,
+            maxRetries: 0,
+        });
+        this.model = cfg.model;
+        this.maxRetries = maxRetries;
+        this.temperature = cfg.model.includes('reasoner') ? 1 : 0;
+    }
+    async chat(messages, tools, callbacks) {
+        const oaiTools = tools.map(t => ({
+            type: 'function',
+            function: { name: t.name, description: t.description, parameters: t.parameters },
+        }));
+        let attempt = 0;
+        let emitted = false;
+        while (attempt < this.maxRetries) {
+            attempt++;
+            try {
+                await this.stream(messages, oaiTools, {
+                    ...callbacks,
+                    onChunk: (d) => { emitted = true; callbacks.onChunk?.(d); },
+                });
+                return;
+            }
+            catch (err) {
+                if (emitted || !isRetryable(err) || attempt >= this.maxRetries) {
+                    callbacks.onError(err instanceof Error ? err : new Error(String(err)));
+                    return;
+                }
+                await sleep(Math.min(1000 * 2 ** attempt, 16_000));
+            }
+        }
+    }
+    async stream(messages, oaiTools, callbacks) {
+        const stream = await this.client.chat.completions.create({
+            model: this.model,
+            messages: messages,
+            tools: oaiTools.length ? oaiTools : undefined,
+            tool_choice: oaiTools.length ? 'auto' : undefined,
+            temperature: this.temperature,
+            stream: true,
+            stream_options: { include_usage: true },
+        });
+        let content = '';
+        const toolBuffers = new Map();
+        for await (const chunk of stream) {
+            if (chunk.usage)
+                callbacks.onMetrics?.(chunk.usage.prompt_tokens, chunk.usage.completion_tokens);
+            const delta = chunk.choices[0]?.delta;
+            if (!delta)
+                continue;
+            if (delta.content) {
+                content += delta.content;
+                callbacks.onChunk?.(delta.content);
+            }
+            if (delta.tool_calls) {
+                for (const tc of delta.tool_calls) {
+                    if (!toolBuffers.has(tc.index))
+                        toolBuffers.set(tc.index, { id: '', name: '', args: '' });
+                    const buf = toolBuffers.get(tc.index);
+                    if (tc.id)
+                        buf.id = tc.id;
+                    if (tc.function?.name)
+                        buf.name += tc.function.name;
+                    if (tc.function?.arguments)
+                        buf.args += tc.function.arguments;
+                }
+            }
+        }
+        const toolCalls = [...toolBuffers.entries()]
+            .sort(([a], [b]) => a - b)
+            .map(([, b]) => ({ id: b.id, type: 'function', function: { name: b.name, arguments: b.args } }));
+        for (const tc of toolCalls)
+            callbacks.onToolCall?.(tc.function.name, tc.function.arguments, tc.id);
+        callbacks.onDone({
+            role: 'assistant',
+            content: content || null,
+            tool_calls: toolCalls.length ? toolCalls : undefined,
+        });
+    }
+}
+// ── Simple one-shot LLM call (no tools, no streaming, returns full text) ─────
+export async function callLLM(provider, system, user) {
+    return new Promise((resolve, reject) => {
+        let result = '';
+        provider.chat([
+            { role: 'system', content: system },
+            { role: 'user', content: user },
+        ], [], {
+            onChunk: (d) => { result += d; },
+            onDone: () => { resolve(result); },
+            onError: (err) => { reject(err); },
+        });
+    });
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/run-store.d.ts

@@ -0,0 +1,47 @@
+export type RunStatus = 'running' | 'waiting_gate' | 'complete' | 'failed';
+export interface StepResult {
+    stepId: string;
+    agentId: string;
+    task: string;
+    output: string;
+    success: boolean;
+    durationMs: number;
+}
+export interface GatePending {
+    gateId: string;
+    stepId: string;
+    agentId: string;
+    output: string;
+    criteria: string[];
+    requestedAt: string;
+    /** IDs of policyRules that triggered this gate automatically (Cable 2). */
+    appliedRuleIds?: string[];
+}
+export interface RunState {
+    runId: string;
+    task: string;
+    configPath: string;
+    status: RunStatus;
+    startedAt: string;
+    updatedAt: string;
+    completedAt?: string;
+    plan?: unknown;
+    completedSteps: StepResult[];
+    currentStep?: {
+        stepId: string;
+        agentId: string;
+        startedAt: string;
+    };
+    waitingGate?: GatePending;
+    vaultNotePath?: string;
+    finalReport?: string;
+    error?: string;
+}
+export declare class RunStore {
+    private readonly dir;
+    constructor(dir?: string);
+    newRunId(): string;
+    save(state: RunState): void;
+    load(runId: string): RunState | null;
+}
+//# sourceMappingURL=run-store.d.ts.map

package/dist/run-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-store.d.ts","sourceRoot":"","sources":["../src/run-store.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,cAAc,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE3E,MAAM,WAAW,UAAU;IACvB,MAAM,EAAM,MAAM,CAAC;IACnB,OAAO,EAAK,MAAM,CAAC;IACnB,IAAI,EAAQ,MAAM,CAAC;IACnB,MAAM,EAAM,MAAM,CAAC;IACnB,OAAO,EAAK,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IACxB,MAAM,EAAW,MAAM,CAAC;IACxB,MAAM,EAAW,MAAM,CAAC;IACxB,OAAO,EAAU,MAAM,CAAC;IACxB,MAAM,EAAW,MAAM,CAAC;IACxB,QAAQ,EAAS,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAM,MAAM,CAAC;IACxB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAY,MAAM,CAAC;IACxB,IAAI,EAAa,MAAM,CAAC;IACxB,UAAU,EAAO,MAAM,CAAC;IACxB,MAAM,EAAW,SAAS,CAAC;IAC3B,SAAS,EAAQ,MAAM,CAAC;IACxB,SAAS,EAAQ,MAAM,CAAC;IACxB,WAAW,CAAC,EAAK,MAAM,CAAC;IACxB,IAAI,CAAC,EAAY,OAAO,CAAC;IACzB,cAAc,EAAG,UAAU,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAK;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,WAAW,CAAC,EAAK,WAAW,CAAC;IAC7B,aAAa,CAAC,EAAG,MAAM,CAAC;IACxB,WAAW,CAAC,EAAK,MAAM,CAAC;IACxB,KAAK,CAAC,EAAW,MAAM,CAAC;CAC3B;AAMD,qBAAa,QAAQ;IACjB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,GAAG,SAAc;IAK7B,QAAQ,IAAI,MAAM;IAIlB,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAS3B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;CASvC"}