@siduri-x/api 2.0.1 → 2.0.3

package/src/app.ts

@@ -2,49 +2,25 @@ import express, { Express } from 'express';
 import cors from 'cors';
 import { createCorsOptions } from './cors';
 import { SiduriRuntime, dispatchCompanionChat } from './runtime';
-import { OpenAICompatibleBrain, OpenRouterBrain } from '@siduri-x/brain';
-import { SqliteMemoryStore } from '@siduri-x/memory';
-import { VoiceAdapter, VoiceConfig } from '@siduri-x/voice';
-import { EKnowledgeAdapter, EKnowledgeConfig } from '@siduri-x/eknowledge';
-import { OpenRouterVisionAdapter, OpenRouterVisionConfig } from '@siduri-x/vision';
-import { ActiveSelfCompiler, SelfPackageParser, SqliteSelfRepository, scanDirective } from '@siduri-x/self';
-import { Live2DAdapter, Live2DAdapterConfig } from '@siduri-x/body';
+import { SelfPackageParser, SqliteSelfRepository, scanDirective } from '@siduri-x/self';
 import { FixtureObservationOrgan } from '@siduri-x/observation';
-import { DefaultHandsOrgan, DefaultHandsOrganConfig } from '@siduri-x/hands';
-import { DefaultEarOrgan, EarOrganConfig } from '@siduri-x/ear';
-import { DefaultMouthOrgan, DefaultMouthOrganConfig } from '@siduri-x/mouth';
-import { attachIdentity, requireAuth, Identity } from './auth';
+import { attachIdentity, requireAuth, Identity, isLocalRequest } from './auth';
 import { mapRequestContext } from './context-mapper';
-
-export interface AppBrainConfig {
-  provider?: 'openrouter' | 'openai-compatible' | string;
-  model?: string;
-  apiKey?: string;
-  apiKeyEnv?: string;
-  baseUrl?: string;
-  timeoutMs?: number;
-  [key: string]: unknown;
-}
-
-export interface AppBehaviorConfig {
-  provider?: 'active_self' | 'none' | string;
-  preset?: string;
-  [key: string]: unknown;
-}
-
-export interface AppBootCompanionConfig {
-  name: string;
-  brain?: AppBrainConfig;
-  voice?: VoiceConfig;
-  knowledge?: EKnowledgeConfig;
-  vision?: OpenRouterVisionConfig;
-  behavior?: AppBehaviorConfig;
-  body?: Live2DAdapterConfig;
-  hands?: DefaultHandsOrganConfig;
-  ear?: EarOrganConfig;
-  mouth?: DefaultMouthOrganConfig;
-  [key: string]: unknown;
-}
+import {
+  bootCompanion,
+  AppBrainConfig,
+  AppBehaviorConfig,
+  AppBootCompanionConfig,
+  BootCompanionOptions,
+} from './boot';
+
+export {
+  AppBrainConfig,
+  AppBehaviorConfig,
+  AppBootCompanionConfig,
+  BootCompanionOptions,
+  bootCompanion,
+};
 
 export interface AppInstance {
   app: Express;
@@ -59,77 +35,6 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
 
   let observationOrgan: FixtureObservationOrgan | undefined;
 
-  function createBrain(config?: AppBrainConfig) {
-    const provider = config?.provider || 'openrouter';
-    const defaultKeyEnv = provider === 'openai-compatible' ? 'OPENAI_COMPATIBLE_API_KEY' : 'OPENROUTER_API_KEY';
-    const apiKey = config?.apiKey || process.env[config?.apiKeyEnv || defaultKeyEnv] || '';
-    if (provider === 'openai-compatible') {
-      return new OpenAICompatibleBrain({
-        apiKey,
-        model: config?.model || 'local-model',
-        baseUrl: config?.baseUrl || 'http://127.0.0.1:1234/v1',
-      });
-    }
-    return new OpenRouterBrain({ apiKey, model: config?.model || 'gpt-4o-mini' });
-  }
-
-  function isDisabled(config?: { provider?: string }): boolean {
-    return !config || config.provider === 'none';
-  }
-
-  function createVoice(config?: VoiceConfig) {
-    return isDisabled(config)
-      ? undefined
-      : new VoiceAdapter({
-          provider: (config?.provider as any) || 'voicevox',
-          baseUrl: config?.baseUrl || process.env.VOICEVOX_URL || 'http://localhost:50021',
-          speakerId: config?.speakerId || 1,
-          ...config,
-        });
-  }
-
-  function createKnowledge(config?: EKnowledgeConfig) {
-    return isDisabled(config) ? undefined : new EKnowledgeAdapter(config || {});
-  }
-
-  function createVision(config?: OpenRouterVisionConfig & { provider?: string }) {
-    return isDisabled(config)
-      ? undefined
-      : new OpenRouterVisionAdapter({
-          apiKey: config?.apiKey || process.env.OPENROUTER_API_KEY || '',
-          model: config?.model || 'gpt-4-vision',
-          ...config,
-        });
-  }
-
-  function createBehavior(config?: AppBehaviorConfig) {
-    return isDisabled(config) ? undefined : new ActiveSelfCompiler();
-  }
-
-  function createBody(config?: Live2DAdapterConfig & { provider?: string }) {
-    return isDisabled(config)
-      ? undefined
-      : new Live2DAdapter(config);
-  }
-
-  function createHands(config?: DefaultHandsOrganConfig & { provider?: string }) {
-    return isDisabled(config)
-      ? new DefaultHandsOrgan()
-      : new DefaultHandsOrgan(config);
-  }
-
-  function createEar(config?: EarOrganConfig & { provider?: string }) {
-    return isDisabled(config)
-      ? new DefaultEarOrgan()
-      : new DefaultEarOrgan(config);
-  }
-
-  function createMouth(config?: DefaultMouthOrganConfig & { provider?: string }, voice?: any) {
-    return isDisabled(config)
-      ? new DefaultMouthOrgan({ voice })
-      : new DefaultMouthOrgan({ ...config, voice });
-  }
-
   app.post('/boot', requireAuth, async (req, res) => {
     try {
       const { id, config } = req.body;
@@ -137,36 +42,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
         return res.status(400).json({ error: "Already booted" });
       }
 
-      const organs = config?.organs || {};
-      const brain = createBrain(organs.brain || config?.brain);
-      const memory = new SqliteMemoryStore({ dbPath: process.env.STORAGE_PATH || process.env.SQLITE_DB_PATH || 'siduri.sqlite' });
-      const selfRepo = new SqliteSelfRepository({ dbPath: process.env.STORAGE_PATH || process.env.SQLITE_DB_PATH || 'siduri.sqlite' });
-      const voice = createVoice(organs.voice || config?.voice);
-      const knowledge = createKnowledge(organs.knowledge || config?.knowledge);
-      const vision = createVision(organs.vision || config?.vision);
-      const behavior = createBehavior(organs.behavior || config?.behavior);
-      const body = createBody(organs.body || config?.body);
-      const hands = createHands(organs.hands || config?.hands);
-      const ear = createEar(organs.ear || config?.ear);
-      const mouth = createMouth(organs.mouth || config?.mouth, voice);
-
-      const runtime = new SiduriRuntime(id, config, {
-        brain,
-        memory,
-        voice,
-        knowledge,
-        vision,
-        behavior,
-        body,
-        hands,
-        ear,
-        mouth,
-        observation: observationOrgan,
-        self: selfRepo,
-        externalKnowledge: knowledge,
-      });
-      await runtime.initialize();
-
+      const runtime = await bootCompanion(id, config, { observationOrgan });
       runtimes.set(id, runtime);
 
       res.json({ success: true, id });
@@ -260,6 +136,8 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
           companionId,
           name: manifest.identity.name,
           archetype: manifest.identity.archetype,
+          origin: manifest.identity.origin,
+          ethos: manifest.identity.ethos,
           version: manifest.version || '1.0.0',
           updatedAt: new Date().toISOString(),
         });
@@ -268,6 +146,25 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
           await repo.setPersonality(companionId, manifest.personality);
         }
 
+        if (Array.isArray(manifest.relationships)) {
+          for (const rel of manifest.relationships) {
+            if (rel && rel.entityId) {
+              await repo.updateRelationship(companionId, {
+                companionId,
+                entityId: rel.entityId,
+                entityType: 'human',
+                role: rel.role || 'user',
+                stance: rel.stance || 'neutral',
+                interactionConventions: rel.conventions || [],
+              });
+            }
+          }
+        }
+
+        if (Array.isArray(manifest.dialogueExamples) && repo.setExemplars) {
+          await repo.setExemplars(companionId, manifest.dialogueExamples);
+        }
+
         if (directivesToCommit.length > 0) {
           await repo.commitDirectives(companionId, directivesToCommit);
         }
@@ -285,13 +182,20 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
   app.post('/chat', attachIdentity, async (req, res) => {
     const { id, message, history } = req.body;
     const identity = (req as any).identity as Identity;
+    const local = isLocalRequest(req);
+    const hasConfiguredToken = Boolean(process.env.AUTH_TOKEN || process.env.OPERATOR_TOKEN || process.env.OWNER_TOKEN);
+    const isLocalDirectOwner = local && !hasConfiguredToken;
+
+    const authenticated = identity?.authenticated || isLocalDirectOwner;
+    const serverRole = identity?.authenticated ? identity.role : (isLocalDirectOwner ? 'OWNER' : 'VIEWER');
 
-    // Single-owner companion model: map request context directly
+    // Single-owner companion model: map request context directly with server identity enforcement
     const mappingResult = mapRequestContext({
       ...req.body,
       id: id || req.body.companionId,
-      authenticated: identity?.authenticated ?? true,
-      source: identity?.source ?? 'local',
+      authenticated,
+      serverRole,
+      source: identity?.source ?? (local ? 'local' : 'external'),
       generateCorrelationId: true,
     });
 
@@ -325,12 +229,19 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
   app.post('/chat/stream', attachIdentity, async (req, res) => {
     const { id, message, history } = req.body;
     const identity = (req as any).identity as Identity;
+    const local = isLocalRequest(req);
+    const hasConfiguredToken = Boolean(process.env.AUTH_TOKEN || process.env.OPERATOR_TOKEN || process.env.OWNER_TOKEN);
+    const isLocalDirectOwner = local && !hasConfiguredToken;
+
+    const authenticated = identity?.authenticated || isLocalDirectOwner;
+    const serverRole = identity?.authenticated ? identity.role : (isLocalDirectOwner ? 'OWNER' : 'VIEWER');
 
     const mappingResult = mapRequestContext({
       ...req.body,
       id: id || req.body.companionId,
-      authenticated: identity?.authenticated ?? true,
-      source: identity?.source ?? 'local',
+      authenticated,
+      serverRole,
+      source: identity?.source ?? (local ? 'local' : 'external'),
       generateCorrelationId: true,
     });
 
@@ -353,8 +264,8 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     const abortController = new AbortController();
     const onClose = () => {
       abortController.abort('client_disconnect');
-      if (typeof runtime.interruptMouth === 'function') {
-        runtime.interruptMouth('client_disconnect');
+      if (runtime.mouth && typeof runtime.mouth.interrupt === 'function') {
+        runtime.mouth.interrupt('client_disconnect');
       }
     };
     req.on('close', onClose);
@@ -370,7 +281,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
         signal: abortController.signal,
       });
 
-      res.write(`event: staged\ndata: ${JSON.stringify({ response_id: response.response_id, correlation_id: response.correlation_id, status: response.status })}\n\n`);
+      res.write(`event: staged\ndata: ${JSON.stringify({ response_id: response.response_id, correlation_id: response.correlation_id, status: response.status, mode: response.metadata?.mode })}\n\n`);
 
       const avatarEvent = response.metadata?.events?.find(
         (e: any) => (e.kind === 'avatar' || e.kind === 'body') && (e.approval === 'APPROVED' || !e.approval)
@@ -427,12 +338,16 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     const reason = req.body?.reason || 'user_barge_in';
 
     if (runtime) {
-      runtime.interruptMouth(reason);
+      if (runtime.mouth && typeof runtime.mouth.interrupt === 'function') {
+        runtime.mouth.interrupt(reason);
+      }
       return res.json({ success: true, interrupted: true, companionId, reason });
     }
 
     for (const r of runtimes.values()) {
-      r.interruptMouth(reason);
+      if (r.mouth && typeof r.mouth.interrupt === 'function') {
+        r.mouth.interrupt(reason);
+      }
     }
     return res.json({ success: true, interrupted: true, reason });
   });
@@ -443,12 +358,16 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     const reason = req.body?.reason || 'user_barge_in';
 
     if (runtime) {
-      runtime.interruptMouth(reason);
+      if (runtime.mouth && typeof runtime.mouth.interrupt === 'function') {
+        runtime.mouth.interrupt(reason);
+      }
       return res.json({ success: true, interrupted: true, companionId, reason });
     }
 
     for (const r of runtimes.values()) {
-      r.interruptMouth(reason);
+      if (r.mouth && typeof r.mouth.interrupt === 'function') {
+        r.mouth.interrupt(reason);
+      }
     }
     return res.json({ success: true, interrupted: true, reason });
   });
@@ -460,7 +379,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     if (!runtime) return res.status(404).json({ error: "Companion not found" });
     if (!runtime.memory) return res.json({ proposals: [] });
     try {
-      const proposals = await runtime.getPendingClaims();
+      const proposals = await runtime.memory.getPendingClaims();
       res.json({ proposals });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
@@ -473,7 +392,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     if (!runtime) return res.status(404).json({ error: "Companion not found" });
     if (!runtime.memory) return res.json({ items: [] });
     try {
-      const items = await runtime.getClaims();
+      const items = await runtime.memory.getClaims();
       res.json({ items });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
@@ -486,7 +405,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     if (!runtime) return res.status(404).json({ error: "Companion not found" });
     if (!runtime.memory) return res.json({ claims: [] });
     try {
-      const claims = await runtime.getClaims();
+      const claims = await runtime.memory.getClaims();
       res.json({ claims });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
@@ -499,13 +418,96 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     if (!runtime) return res.status(404).json({ error: "Companion not found" });
     if (!runtime.memory) return res.json({ directives: [] });
     try {
-      const directives = await runtime.getDirectives();
+      const directives = await runtime.memory.getDirectives();
       res.json({ directives });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
     }
   });
 
+  // KNOWLEDGE / LIFE DB GETTERS
+  app.get('/knowledge/life', requireAuth, async (req, res) => {
+    const id = req.query.id as string || Array.from(runtimes.keys())[0];
+    const runtime = runtimes.get(id);
+    if (!runtime) return res.status(404).json({ error: "Companion not found" });
+    const query = (req.query.q as string) || '';
+    if (!runtime.knowledge || typeof (runtime.knowledge as any).queryLifeContext !== 'function') {
+      return res.json({ matchedInventory: [], recentFinances: [], upcomingSchedule: [], preferences: [], formattedContext: '' });
+    }
+    try {
+      const result = await (runtime.knowledge as any).queryLifeContext(id, query);
+      res.json(result);
+    } catch (e: any) {
+      res.status(500).json({ error: e.message });
+    }
+  });
+
+  app.get('/knowledge/inventory', requireAuth, async (req, res) => {
+    const id = req.query.id as string || Array.from(runtimes.keys())[0];
+    const runtime = runtimes.get(id);
+    if (!runtime) return res.status(404).json({ error: "Companion not found" });
+    const domain = req.query.domain as string | undefined;
+    if (!runtime.knowledge || !(runtime.knowledge as any).inventory) {
+      return res.json({ items: [] });
+    }
+    try {
+      const items = await (runtime.knowledge as any).inventory.getItems(id, domain);
+      res.json({ items });
+    } catch (e: any) {
+      res.status(500).json({ error: e.message });
+    }
+  });
+
+  app.get('/knowledge/finance', requireAuth, async (req, res) => {
+    const id = req.query.id as string || Array.from(runtimes.keys())[0];
+    const runtime = runtimes.get(id);
+    if (!runtime) return res.status(404).json({ error: "Companion not found" });
+    if (!runtime.knowledge || !(runtime.knowledge as any).finance) {
+      return res.json({ summary: null, entries: [] });
+    }
+    try {
+      const limit = Number(req.query.limit || 20);
+      const [summary, entries] = await Promise.all([
+        (runtime.knowledge as any).finance.getSummary(id),
+        (runtime.knowledge as any).finance.getEntries(id, limit),
+      ]);
+      res.json({ summary, entries });
+    } catch (e: any) {
+      res.status(500).json({ error: e.message });
+    }
+  });
+
+  app.get('/knowledge/schedule', requireAuth, async (req, res) => {
+    const id = req.query.id as string || Array.from(runtimes.keys())[0];
+    const runtime = runtimes.get(id);
+    if (!runtime) return res.status(404).json({ error: "Companion not found" });
+    if (!runtime.knowledge || !(runtime.knowledge as any).schedule) {
+      return res.json({ items: [] });
+    }
+    try {
+      const items = await (runtime.knowledge as any).schedule.getUpcoming(id);
+      res.json({ items });
+    } catch (e: any) {
+      res.status(500).json({ error: e.message });
+    }
+  });
+
+  app.get('/knowledge/preferences', requireAuth, async (req, res) => {
+    const id = req.query.id as string || Array.from(runtimes.keys())[0];
+    const runtime = runtimes.get(id);
+    if (!runtime) return res.status(404).json({ error: "Companion not found" });
+    const category = req.query.category as string | undefined;
+    if (!runtime.knowledge || !(runtime.knowledge as any).preferences) {
+      return res.json({ preferences: [] });
+    }
+    try {
+      const preferences = await (runtime.knowledge as any).preferences.getPreferences(id, category);
+      res.json({ preferences });
+    } catch (e: any) {
+      res.status(500).json({ error: e.message });
+    }
+  });
+
   // MEMORY MUTATIONS - PROPOSALS
   app.post('/memory/proposals/update', requireAuth, async (req, res) => {
     const id = req.body.companionId as string || Array.from(runtimes.keys())[0];
@@ -519,7 +521,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
       if (!claimId) {
         return res.status(400).json({ error: "Missing required claim id" });
       }
-      const updated = await runtime.updateClaim(claimId, req.body.updates || req.body);
+      const updated = await runtime.memory.updateClaim(claimId, req.body.updates || req.body);
       res.json({ success: true, claim: updated });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
@@ -532,7 +534,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     if (!runtime) return res.status(404).json({ error: "Companion not found" });
     if (!runtime.memory) return res.status(400).json({ error: "Memory organ not configured" });
     try {
-      await runtime.approveClaim(req.body.id);
+      await runtime.memory.approveClaim(req.body.id);
       res.json({ approved: true });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
@@ -545,7 +547,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     if (!runtime) return res.status(404).json({ error: "Companion not found" });
     if (!runtime.memory) return res.status(400).json({ error: "Memory organ not configured" });
     try {
-      await runtime.rejectClaim(req.body.id);
+      await runtime.memory.rejectClaim(req.body.id);
       res.json({ rejected: true });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
@@ -559,7 +561,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     if (!runtime) return res.status(404).json({ error: "Companion not found" });
     if (!runtime.memory) return res.status(400).json({ error: "Memory organ not configured" });
     try {
-      await runtime.approveDirective(req.body.id);
+      await runtime.memory.approveDirective(req.body.id);
       res.json({ approved: true });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
@@ -572,7 +574,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     if (!runtime) return res.status(404).json({ error: "Companion not found" });
     if (!runtime.memory) return res.status(400).json({ error: "Memory organ not configured" });
     try {
-      await runtime.rejectDirective(req.body.id);
+      await runtime.memory.rejectDirective(req.body.id);
       res.json({ rejected: true });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
@@ -585,7 +587,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     if (!runtime) return res.status(404).json({ error: "Companion not found" });
     if (!runtime.memory) return res.status(400).json({ error: "Memory organ not configured" });
     try {
-      await runtime.revokeDirective(req.body.id);
+      await runtime.memory.revokeDirective(req.body.id);
       res.json({ revoked: true });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
@@ -598,7 +600,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     if (!runtime) return res.status(404).json({ error: "Companion not found" });
     if (!runtime.memory) return res.status(400).json({ error: "Memory organ not configured" });
     try {
-      await runtime.disableDirective(req.body.id);
+      await runtime.memory.disableDirective(req.body.id);
       res.json({ disabled: true });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
@@ -615,7 +617,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
         return res.status(400).json({ error: "Memory organ does not support reset" });
       }
       try {
-        await runtime.resetMemory();
+        await runtime.memory.resetMemory();
         res.json({ reset: true });
       } catch (e: any) {
         res.status(500).json({ error: e.message });
@@ -626,7 +628,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
       const companionId = req.body?.companionId || Array.from(runtimes.keys())[0] || 'default';
       const runtime = runtimes.get(companionId);
       if (!runtime) return res.status(404).json({ accepted: false, error: 'Companion not found' });
-      const staged = runtime.stageResponse({
+      const staged = runtime.gating.stageResponse({
         requestContext: {
           companionId,
           actor: {
@@ -662,12 +664,12 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
       let correlationId = req.body?.correlation_id;
 
       if (!responseId && correlationId) {
-        const found = runtime.findStagedPlanByCorrelation(companionId, correlationId);
+        const found = runtime.gating.findStagedPlanByCorrelation(companionId, correlationId);
         if (found) {
           responseId = found.responseId;
         }
       } else if (responseId && !correlationId) {
-        const found = runtime.getStagedPlan(responseId);
+        const found = runtime.gating.getStagedPlan(responseId);
         if (found) {
           correlationId = found.correlationId;
         }
@@ -677,7 +679,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
         return res.status(400).json({ approved: false, error: 'UNKNOWN_APPROVAL_ID' });
       }
 
-      const result = runtime.approveResponse({
+      const result = runtime.gating.approveResponse({
         responseId,
         companionId,
         correlationId: correlationId || '',
@@ -688,7 +690,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
       }
 
       // Now evaluated as approved
-      const evaluation = runtime.evaluateGate(result.plan!);
+      const evaluation = runtime.gating.evaluateGate(result.plan!);
       res.json({
         approved: true,
         status: evaluation.disposition,
@@ -707,12 +709,12 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
       let correlationId = req.body?.correlation_id;
 
       if (!responseId && correlationId) {
-        const found = runtime.findStagedPlanByCorrelation(companionId, correlationId);
+        const found = runtime.gating.findStagedPlanByCorrelation(companionId, correlationId);
         if (found) {
           responseId = found.responseId;
         }
       } else if (responseId && !correlationId) {
-        const found = runtime.getStagedPlan(responseId);
+        const found = runtime.gating.getStagedPlan(responseId);
         if (found) {
           correlationId = found.correlationId;
         }
@@ -722,7 +724,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
         return res.status(400).json({ rejected: false, error: 'UNKNOWN_APPROVAL_ID' });
       }
 
-      const result = runtime.rejectResponse({
+      const result = runtime.gating.rejectResponse({
         responseId,
         companionId,
         correlationId: correlationId || '',

package/src/boot.test.ts

@@ -0,0 +1,103 @@
+import { bootCompanion, isDisabled, createBrain, createMemory, createVoice, createKnowledge, createVision, createBehavior, createBody, createHands, createEar, createMouth, createSelf, createObservation } from './boot';
+import { FixtureObservationOrgan } from '@siduri-x/observation';
+
+describe('Canonical bootCompanion & Organ Factory Suite', () => {
+  const originalEnv = process.env;
+
+  beforeEach(() => {
+    process.env = { ...originalEnv };
+  });
+
+  afterAll(() => {
+    process.env = originalEnv;
+  });
+
+  test('isDisabled correctly identifies undefined or none provider', () => {
+    expect(isDisabled(undefined)).toBe(true);
+    expect(isDisabled({ provider: 'none' })).toBe(true);
+    expect(isDisabled({ provider: 'openrouter' })).toBe(false);
+    expect(isDisabled({ provider: 'sqlite' })).toBe(false);
+  });
+
+  test('creates all standard organs with fallback configurations', () => {
+    const brain = createBrain({ provider: 'openai-compatible', baseUrl: 'http://localhost:11434/v1', apiKey: 'test' });
+    expect(brain).toBeDefined();
+
+    const voice = createVoice({ provider: 'none' });
+    expect(voice).toBeUndefined();
+
+    const memory = createMemory({ provider: 'sqlite', dbPath: ':memory:' });
+    expect(memory).toBeDefined();
+
+    const selfRepo = createSelf({ dbPath: ':memory:' });
+    expect(selfRepo).toBeDefined();
+
+    const vision = createVision({ provider: 'none' });
+    expect(vision).toBeUndefined();
+
+    const behavior = createBehavior({ provider: 'active_self' });
+    expect(behavior).toBeDefined();
+
+    const body = createBody({ provider: 'none' });
+    expect(body).toBeUndefined();
+
+    const hands = createHands();
+    expect(hands).toBeDefined();
+
+    const ear = createEar();
+    expect(ear).toBeDefined();
+
+    const mouth = createMouth(undefined, voice);
+    expect(mouth).toBeDefined();
+
+    const observation = createObservation();
+    expect(observation).toBeInstanceOf(FixtureObservationOrgan);
+  });
+
+  test('bootCompanion wires all organs and runs migrations', async () => {
+    let migrationsRun = false;
+    const testConfig = {
+      name: 'Test Companion',
+      brain: { provider: 'openrouter', apiKey: 'mock-key', model: 'mock-model' },
+      memory: { provider: 'none' }, // will use custom mock
+      voice: { provider: 'none' },
+      vision: { provider: 'none' },
+      behavior: { provider: 'none' },
+      body: { provider: 'none' },
+      hands: { provider: 'none' },
+      ear: { provider: 'none' },
+      mouth: { provider: 'none' },
+      knowledge: { provider: 'none' },
+    };
+
+    const mockObservation = new FixtureObservationOrgan({ analyze: async () => JSON.stringify({ readings: [] }) });
+
+    const runtime = await bootCompanion('test-comp-1', testConfig as any, {
+      observationOrgan: mockObservation,
+    });
+
+    expect(runtime).toBeDefined();
+    expect(runtime.id).toBe('test-comp-1');
+    expect(runtime.observation).toBe(mockObservation);
+    expect(runtime.hands).toBeDefined();
+    expect(runtime.ear).toBeDefined();
+    expect(runtime.mouth).toBeDefined();
+  });
+
+  test('bootCompanion handles nested organs configuration structure', async () => {
+    const nestedConfig = {
+      name: 'Nested Companion',
+      organs: {
+        brain: { provider: 'openrouter', apiKey: 'mock' },
+        memory: { provider: 'none' },
+        knowledge: { provider: 'none' },
+        voice: { provider: 'none' },
+      },
+    };
+
+    const runtime = await bootCompanion('nested-comp', nestedConfig as any);
+    expect(runtime).toBeDefined();
+    expect(runtime.id).toBe('nested-comp');
+    expect(runtime.brain).toBeDefined();
+  });
+});