@kognai/orchestrator-core 0.1.1 → 0.1.2

package/dist/index.d.ts

@@ -61,4 +61,5 @@ export * from './lib/citizen-score-contract';
 export * from './lib/citizen-score-registry';
 export * from './lib/sovereign-agent-factory';
 export { runOrchestrator } from './lib/orchestrate-engine';
+export type { OrchestratorConfig, SpawnGate, SpawnGateResult, AgentSpawnSpec, } from './lib/orchestrate-engine';
 export { runSprintCycle, SprintRunnerOpts } from './lib/sprint-runner-engine';

package/dist/lib/orchestrate-engine.d.ts

@@ -21,5 +21,27 @@
  * Flow: CEO plans → MiniMax codes → Dual Supervisor review (DeepSeek + Haiku)
  *       → CEO resolves conflicts → CTO analyzes → CMO reports → CEO daily report
  */
-declare function main(): Promise<void>;
+export interface AgentSpawnSpec {
+    name: string;
+    role: string;
+    llm: 'minimax' | 'anthropic';
+    trigger: string;
+    prompt_summary: string;
+}
+export interface SpawnGateResult {
+    approved: boolean;
+    /** Human-readable reason when not approved (rejected or pending). */
+    rejection_reason?: string;
+    /** True when the spawn is suspended awaiting an out-of-band (e.g. human) approval. */
+    pending_approval?: boolean;
+    /** Optional one-line audit string logged on an approved decision. */
+    audit?: string;
+}
+export type SpawnGate = (spec: AgentSpawnSpec) => SpawnGateResult;
+/** TICKET-225: engine config supplied by the consuming template. */
+export interface OrchestratorConfig {
+    /** Optional template-carried spawn governance gate (Kognai → SAF). */
+    spawnGate?: SpawnGate;
+}
+declare function main(config?: OrchestratorConfig): Promise<void>;
 export { main as runOrchestrator };

package/dist/lib/orchestrate-engine.js

@@ -1518,9 +1518,31 @@ Rules: Be specific — reference task IDs, rejection counts, concrete patterns.
         }
     }
 }
-// ===== Agent Creator (creates new agents from CEO-approved CTO proposals) =====
 class AgentCreator {
+    spawnGate;
+    constructor(spawnGate) {
+        this.spawnGate = spawnGate;
+    }
     createAgent(spec) {
+        // TICKET-225 — template-carried spawn governance. If the consuming template
+        // supplied a SpawnGate (Kognai wires SAF here), consult it BEFORE creating
+        // anything on disk. Approval/rejection only; the citizenship logic below is
+        // unchanged (its extraction is tracked separately as TICKET-226).
+        if (this.spawnGate) {
+            const decision = this.spawnGate(spec);
+            if (!decision.approved) {
+                const why = decision.rejection_reason ? `: ${decision.rejection_reason}` : '';
+                if (decision.pending_approval) {
+                    log(c.yellow, `  ⏸ Spawn of ${spec.name} pending approval${why}`);
+                }
+                else {
+                    log(c.red, `  ✗ Spawn of ${spec.name} blocked${why}`);
+                }
+                return '';
+            }
+            if (decision.audit)
+                log(c.gray, `  ✓ ${decision.audit}`);
+        }
         const agentDir = `./agents/${spec.name}`;
         (0, fs_1.mkdirSync)(agentDir, { recursive: true });
         // Founder rule 2026-05-27: every spawned agent is born as a Kognai
@@ -2939,6 +2961,7 @@ ${originalContent}
 }
 // ===== Orchestrator (Dynamic Agent Pipeline) =====
 class Orchestrator {
+    spawnGate;
     ceo;
     cto;
     supervisor;
@@ -3046,7 +3069,10 @@ class Orchestrator {
             (0, fs_1.writeFileSync)(sprintFile, JSON.stringify(sprintRaw, null, 2));
         log(c.green, `    [inject] Added ${injected} split sub-tasks to ${sprintFile} (in-memory + on-disk)`);
     }
-    constructor() {
+    // TICKET-225: optional template-supplied spawn governance gate, threaded
+    // from runOrchestrator(config) down to AgentCreator. Undefined = no gate.
+    constructor(spawnGate) {
+        this.spawnGate = spawnGate;
         log(c.bold, '\n╔══════════════════════════════════════════════════════════╗');
         log(c.bold, '║   Kognai Swarm Orchestrator v2.17 — V17 Architecture     ║');
         log(c.bold, '║   Local-first · ClawRouter cloud · DeepSeek reviews      ║');
@@ -4163,7 +4189,7 @@ ONLY output the JSON array. No markdown, no explanation.`;
                 // Persist CEO decisions for CTO feedback loop + approved proposals tracking
                 persistCEODecisions(ctoDecisions, ctoReport);
                 // Handle approved new_agent proposals
-                const agentCreator = new AgentCreator();
+                const agentCreator = new AgentCreator(this.spawnGate);
                 for (const proposal of ctoReport.proposals) {
                     if (proposal.category === 'new_agent' && proposal.agent_spec) {
                         // Check if CEO approved this specific proposal
@@ -4414,8 +4440,7 @@ async function postSprintSmokeTest() {
     // Disabled — Invoica-specific endpoints (health/invoices/settlements) not applicable to Kognai
     // Removed Sprint 205: was always returning HTTP 404 + flooding Telegram with false alerts
 }
-// ===== Main Entry =====
-async function main() {
+async function main(config = {}) {
     // S67-005: Startup env check (OMEL AMD-13: via CredentialVault — hasSecret never logs value)
     if (!credential_vault_1.credentialVault.hasSecret('ANTHROPIC_API_KEY', 'orchestrator')) {
         log(c.yellow, '⚠  ANTHROPIC_API_KEY not set — Anthropic CEO + Sup2 Haiku will be unavailable.');
@@ -4425,7 +4450,7 @@ async function main() {
         log(c.yellow, '⚠  MINIMAX_API_KEY not set — cloud-code tasks will fail.');
     }
     try {
-        const orchestrator = new Orchestrator();
+        const orchestrator = new Orchestrator(config.spawnGate);
         await orchestrator.run();
     }
     catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kognai/orchestrator-core",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Kognai sovereign orchestrator — core engine (template-agnostic). Shared by all products (Kognai/coding, Voxight/market-intel, Invoica/fin-compliance); each supplies only its template. Replaces per-repo forks of orchestrate-agents-v2 / sprint-runner / lib.",
   "license": "MIT",
   "author": "SkinGem",