@kognai/orchestrator-core 0.2.1 → 0.2.2

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

@@ -1,4 +1,4 @@
-import { type CitizenOwner } from './citizenship';
+import { type CitizenOwner, type CitizenRecord } from './citizenship';
 import type { AgentTask, ReviewResult, CTOProposal, CTOReport } from './orchestrate-engine';
 export declare class SupervisorAgent {
     private systemPrompt;
@@ -69,6 +69,13 @@ export interface SpawnGateResult {
      *  Voxight swarm's a Voxight citizen, etc. The running company is carried by
      *  the template-injected gate's requester_did, not hardcoded in the engine. */
     owner?: CitizenOwner;
+    /** TICKET-334b: the citizen the gate already minted through the template's
+     *  canonical issuer (Kognai → SAF.spawnCitizen — governance + owner-lineage +
+     *  ACP-at-birth). When present the engine adopts it verbatim and SKIPS its own
+     *  bare mintCitizen, so the engine path no longer loses the ACP seeding. When
+     *  absent (gate-less templates, or a gate that only governs) the engine falls
+     *  back to minting itself with the resolved owner. */
+    citizen?: CitizenRecord;
 }
 export type SpawnGate = (spec: AgentSpawnSpec) => SpawnGateResult;
 export declare class AgentCreator {

package/dist/lib/engine-agents.js

@@ -736,6 +736,7 @@ class AgentCreator {
         // anything on disk. Approval/rejection only; the citizenship logic below is
         // unchanged (its extraction is tracked separately as TICKET-226).
         let spawnOwner;
+        let gateCitizen;
         if (this.spawnGate) {
             const decision = this.spawnGate(spec);
             if (!decision.approved) {
@@ -753,6 +754,10 @@ class AgentCreator {
             // The gate (SAF) resolves the lineage from its requester_did — this is the
             // running company's context, plumbed in rather than hardcoded here.
             spawnOwner = decision.owner;
+            // TICKET-334b: when the gate minted through the canonical issuer
+            // (SAF.spawnCitizen — owner-lineage + ACP-at-birth), adopt that citizen
+            // and skip the bare mint below (which would skip ACP seeding).
+            gateCitizen = decision.citizen;
         }
         const agentDir = `./agents/${spec.name}`;
         (0, fs_1.mkdirSync)(agentDir, { recursive: true });
@@ -760,9 +765,11 @@ class AgentCreator {
         // citizen — not a bare agent. Mint citizenship (citizen_id + roll
         // number + Kōpus avatar + ACP baseline) BEFORE writing the agent
         // files so the citizen record can be referenced in the prompt.
-        // Owner-scoped when the gate supplied a lineage (e.g. invoica/voxight);
-        // legacy kognai-internal path otherwise (back-compat for gate-less templates).
-        const citizen = (0, citizenship_1.mintCitizen)(spec.name, {
+        // Prefer the citizen the gate already minted through the canonical issuer
+        // (carries ACP-at-birth); else mint here owner-scoped when the gate supplied
+        // a lineage (e.g. invoica/voxight), or via the legacy kognai-internal path
+        // for gate-less templates.
+        const citizen = gateCitizen ?? (0, citizenship_1.mintCitizen)(spec.name, {
             founding_agent: 'ceo',
             proposing_agent: 'cto',
             citizen_type: 'spawned',

package/dist/lib/sovereign-agent-factory.d.ts

@@ -119,12 +119,19 @@ export declare function deriveOwner(requester_did: string): CitizenOwner;
  *
  * Returns the governance decision plus the minted citizen (when approved). The
  * caller still writes citizen.yaml via renderCitizenYaml(citizen). The initial
- * ACP (`decision.initial_acp_score`) should be persisted to the score registry
- * by the caller/wiring step (see TICKET-335).
+ * ACP is seeded here at birth (writeInitialAcp) so the citizen has a routing
+ * profile from the moment it exists — this is the property the engine seam lost
+ * when it minted via bare mintCitizen (TICKET-334b).
+ *
+ * `founding_agent` / `proposing_agent` let a caller preserve its own attribution
+ * (e.g. the engine's CEO-founds / CTO-proposes lineage). When omitted, the
+ * proposing agent defaults to the requester DID.
  */
 export declare function spawnCitizen(req: SpawnRequest, opts?: {
     agent_name?: string;
     now?: Date;
+    founding_agent?: string;
+    proposing_agent?: string;
 }): {
     decision: SpawnDecision;
     citizen?: CitizenRecord;

package/dist/lib/sovereign-agent-factory.js

@@ -328,8 +328,13 @@ function deriveOwner(requester_did) {
  *
  * Returns the governance decision plus the minted citizen (when approved). The
  * caller still writes citizen.yaml via renderCitizenYaml(citizen). The initial
- * ACP (`decision.initial_acp_score`) should be persisted to the score registry
- * by the caller/wiring step (see TICKET-335).
+ * ACP is seeded here at birth (writeInitialAcp) so the citizen has a routing
+ * profile from the moment it exists — this is the property the engine seam lost
+ * when it minted via bare mintCitizen (TICKET-334b).
+ *
+ * `founding_agent` / `proposing_agent` let a caller preserve its own attribution
+ * (e.g. the engine's CEO-founds / CTO-proposes lineage). When omitted, the
+ * proposing agent defaults to the requester DID.
  */
 function spawnCitizen(req, opts = {}) {
     const decision = sovereignSpawn(req);
@@ -339,7 +344,8 @@ function spawnCitizen(req, opts = {}) {
     const citizen = (0, citizenship_1.mintCitizen)(opts.agent_name ?? req.requested_role, {
         owner,
         citizen_type: 'spawned',
-        proposing_agent: req.requester_did,
+        founding_agent: opts.founding_agent,
+        proposing_agent: opts.proposing_agent ?? req.requester_did,
         now: opts.now,
     });
     decision.citizen_did = citizen.agent_did;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kognai/orchestrator-core",
-  "version": "0.2.1",
+  "version": "0.2.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",