@siduri-x/api 2.0.2 → 2.0.4

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @siduri-x/api@2.0.2 build /home/zagin/Projects/vxnus-studio/projects/siduri-x/apps/api
+> @siduri-x/api@2.0.4 build /home/zagin/Projects/vxnus-studio/projects/siduri-x/apps/api
 > tsc
 

package/.turbo/turbo-test.log

@@ -1,13 +1,11 @@
 
-> @siduri-x/api@2.0.2 test /home/zagin/Projects/vxnus-studio/projects/siduri-x/apps/api
+> @siduri-x/api@2.0.4 test /home/zagin/Projects/vxnus-studio/projects/siduri-x/apps/api
 > jest --config jest.config.json
 
-PASS src/boot.test.ts (12.448 s)
-PASS src/index.test.ts (12.646 s)
-PASS src/t7-release.test.ts (12.705 s)
-PASS src/knowledge.test.ts (12.82 s)
-PASS src/context-mapper.test.ts
-PASS src/runtime.test.ts
+PASS src/context-mapper.test.ts (9.405 s)
+PASS src/index.test.ts (11.391 s)
+PASS src/t5-experience.test.ts (11.412 s)
+PASS src/runtime.test.ts (10.411 s)
   ● Console
 
     console.error
@@ -28,16 +26,18 @@ PASS src/runtime.test.ts
       at PerceptionPipeline.execute (../../packages/core/dist/perception-pipeline.js:21:34)
       at Object.<anonymous> (src/runtime.test.ts:74:22)
 
+PASS src/t4-gating.test.ts (10.904 s)
 PASS src/auth.test.ts
 PASS src/smoke.test.ts
-PASS src/teach-mode.test.ts
-PASS src/t5-experience.test.ts
-PASS src/t4-gating.test.ts (13.84 s)
-PASS src/t6-security.test.ts (14.624 s)
-PASS src/b0-b6.test.ts (13.796 s)
+PASS src/b0-b6.test.ts
+PASS src/t7-release.test.ts
+PASS src/knowledge.test.ts
+PASS src/t6-security.test.ts (12.086 s)
+PASS src/boot.test.ts
+PASS src/teach-mode.test.ts (11.464 s)
 
 Test Suites: 13 passed, 13 total
-Tests:       86 passed, 86 total
+Tests:       90 passed, 90 total
 Snapshots:   0 total
-Time:        17.47 s
+Time:        14.772 s, estimated 16 s
 Ran all test suites.

package/dist/app.js

@@ -114,12 +114,31 @@ function createApp(runtimes = new Map()) {
                     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(),
                 });
                 if (manifest.personality) {
                     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);
                 }
@@ -169,6 +188,7 @@ function createApp(runtimes = new Map()) {
                 context: mappingResult.context,
                 history,
                 ...(req.body?.medium ? { medium: req.body.medium } : {}),
+                subtitleLanguage: req.body?.subtitleLanguage || req.body?.subtitle_language,
             });
             res.json(response);
         }
@@ -224,9 +244,10 @@ function createApp(runtimes = new Map()) {
                 history,
                 medium: 'web',
                 signal: abortController.signal,
+                subtitleLanguage: req.body?.subtitleLanguage || req.body?.subtitle_language,
             });
-            res.write(`event: staged\ndata: ${JSON.stringify({ response_id: response.response_id, correlation_id: response.correlation_id, status: response.status })}\n\n`);
-            const avatarEvent = response.metadata?.events?.find((e) => (e.kind === 'avatar' || e.kind === 'body') && (e.approval === 'APPROVED' || !e.approval));
+            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) => (e.kind === 'avatar' || e.kind === 'body') && (e.approval?.toLowerCase() === 'approved' || e.approval === 'APPROVED' || !e.approval));
             if (avatarEvent) {
                 res.write(`event: avatar\ndata: ${JSON.stringify(avatarEvent)}\n\n`);
             }
@@ -346,7 +367,9 @@ function createApp(runtimes = new Map()) {
         if (!runtime.memory)
             return res.json({ claims: [] });
         try {
-            const claims = await runtime.memory.getClaims();
+            const claims = typeof runtime.memory.getAllClaims === 'function'
+                ? await runtime.memory.getAllClaims()
+                : await runtime.memory.getClaims();
             res.json({ claims });
         }
         catch (e) {
@@ -361,7 +384,9 @@ function createApp(runtimes = new Map()) {
         if (!runtime.memory)
             return res.json({ directives: [] });
         try {
-            const directives = await runtime.memory.getDirectives();
+            const directives = typeof runtime.memory.getAllDirectives === 'function'
+                ? await runtime.memory.getAllDirectives()
+                : await runtime.memory.getDirectives();
             res.json({ directives });
         }
         catch (e) {
@@ -486,7 +511,7 @@ function createApp(runtimes = new Map()) {
             return res.status(400).json({ error: "Memory organ not configured" });
         try {
             await runtime.memory.approveClaim(req.body.id);
-            res.json({ approved: true });
+            res.json({ approved: true, status: 'approved' });
         }
         catch (e) {
             res.status(500).json({ error: e.message });
@@ -501,7 +526,7 @@ function createApp(runtimes = new Map()) {
             return res.status(400).json({ error: "Memory organ not configured" });
         try {
             await runtime.memory.rejectClaim(req.body.id);
-            res.json({ rejected: true });
+            res.json({ rejected: true, status: 'rejected' });
         }
         catch (e) {
             res.status(500).json({ error: e.message });
@@ -517,7 +542,7 @@ function createApp(runtimes = new Map()) {
             return res.status(400).json({ error: "Memory organ not configured" });
         try {
             await runtime.memory.approveDirective(req.body.id);
-            res.json({ approved: true });
+            res.json({ approved: true, status: 'active' });
         }
         catch (e) {
             res.status(500).json({ error: e.message });
@@ -532,7 +557,7 @@ function createApp(runtimes = new Map()) {
             return res.status(400).json({ error: "Memory organ not configured" });
         try {
             await runtime.memory.rejectDirective(req.body.id);
-            res.json({ rejected: true });
+            res.json({ rejected: true, status: 'rejected' });
         }
         catch (e) {
             res.status(500).json({ error: e.message });
@@ -547,7 +572,7 @@ function createApp(runtimes = new Map()) {
             return res.status(400).json({ error: "Memory organ not configured" });
         try {
             await runtime.memory.revokeDirective(req.body.id);
-            res.json({ revoked: true });
+            res.json({ revoked: true, status: 'revoked' });
         }
         catch (e) {
             res.status(500).json({ error: e.message });
@@ -562,7 +587,7 @@ function createApp(runtimes = new Map()) {
             return res.status(400).json({ error: "Memory organ not configured" });
         try {
             await runtime.memory.disableDirective(req.body.id);
-            res.json({ disabled: true });
+            res.json({ disabled: true, status: 'disabled' });
         }
         catch (e) {
             res.status(500).json({ error: e.message });

package/dist/context-mapper.js

@@ -115,6 +115,7 @@ function mapRequestContext(input, options = {}) {
             },
             source: input.source || rawCtx.source || (isAuthenticated ? 'local' : 'external'),
             subject: rawCtx.subject,
+            mode: rawCtx.mode || input.mode,
         };
         const validated = (0, core_1.validateRequestContext)(constructed);
         if (!validated.accepted) {
@@ -218,6 +219,7 @@ function mapRequestContext(input, options = {}) {
         },
         source: input.source || (isAuthenticated ? 'local' : 'external'),
         subject: input.subject,
+        mode: input.mode || input.conversation?.mode,
     };
     const validated = (0, core_1.validateRequestContext)(mappedContext);
     if (!validated.accepted) {

package/dist/context-mapper.test.js

@@ -249,4 +249,39 @@ describe('API Request Context Mapper (Single-Owner, Single-Machine)', () => {
         expect(attenuatedResult.context?.actor.authorizationRole).toBe('viewer');
         expect(attenuatedResult.diagnostics).not.toContain('role_escalation_attempt_suppressed');
     });
+    describe('Mode Mapping (Casual, Teach, Hybrid)', () => {
+        test('maps explicit mode parameter to RequestContext', () => {
+            const casualResult = (0, context_mapper_1.mapRequestContext)({
+                companionId: 'comp-1',
+                mode: 'casual',
+                generateCorrelationId: true,
+            });
+            expect(casualResult.accepted).toBe(true);
+            expect(casualResult.context?.mode).toBe('casual');
+            const teachResult = (0, context_mapper_1.mapRequestContext)({
+                companionId: 'comp-1',
+                mode: 'teach',
+                generateCorrelationId: true,
+            });
+            expect(teachResult.accepted).toBe(true);
+            expect(teachResult.context?.mode).toBe('teach');
+            const hybridResult = (0, context_mapper_1.mapRequestContext)({
+                companionId: 'comp-1',
+                mode: 'hybrid',
+                generateCorrelationId: true,
+            });
+            expect(hybridResult.accepted).toBe(true);
+            expect(hybridResult.context?.mode).toBe('hybrid');
+        });
+        test('rejects invalid interaction mode', () => {
+            const invalidResult = (0, context_mapper_1.mapRequestContext)({
+                companionId: 'comp-1',
+                mode: 'super_turbo',
+                generateCorrelationId: true,
+            });
+            expect(invalidResult.accepted).toBe(false);
+            expect(invalidResult.error?.code).toBe('INVALID_CONTEXT');
+            expect(invalidResult.error?.field).toBe('mode');
+        });
+    });
 });

package/dist/index.test.js

@@ -134,4 +134,18 @@ describe('API Boundary Context Validation (P2 Route Integration)', () => {
         expect(res.body.interrupted).toBe(true);
         expect(fakeRuntime.mouth.interrupt).toHaveBeenCalledWith('user_barge_in');
     });
+    test('POST /chat passes explicit interaction mode (casual, teach, hybrid) to runtime', async () => {
+        const res = await (0, supertest_1.default)(app)
+            .post('/chat')
+            .send({
+            id: 'companion-a',
+            message: 'Casual banter',
+            mode: 'casual',
+        });
+        expect(res.status).toBe(200);
+        expect(fakeRuntime.handleUserMessage).toHaveBeenCalledWith('Casual banter', expect.objectContaining({
+            companionId: 'companion-a',
+            mode: 'casual',
+        }), []);
+    });
 });

package/dist/teach-mode.test.js

@@ -14,6 +14,8 @@ jest.mock('@siduri-x/self', () => {
         SqliteSelfRepository: jest.fn().mockImplementation(() => ({
             setIdentity: jest.fn().mockResolvedValue(undefined),
             setPersonality: jest.fn().mockResolvedValue(undefined),
+            updateRelationship: jest.fn().mockResolvedValue(undefined),
+            setExemplars: jest.fn().mockResolvedValue(undefined),
             commitDirectives: jest.fn().mockResolvedValue(undefined),
             close: jest.fn(),
         })),
@@ -133,4 +135,69 @@ kind: "other"
         const MockRepo = self_1.SqliteSelfRepository;
         expect(MockRepo.mock.instances.length).toBe(0);
     });
+    it('POST /teach/install-self installs v2.0 manifest with ethos, relationships, and exemplars', async () => {
+        const v2Manifest = {
+            specVersion: '2.0.0',
+            identity: {
+                name: 'Siduri',
+                archetype: 'System Sentinel',
+                origin: 'Ancient mythos',
+                ethos: 'Protector of the realm and loyal companion to creator',
+            },
+            version: '2.0.0',
+            relationships: [
+                {
+                    entityId: 'actor:zagin',
+                    role: 'creator',
+                    stance: 'familiar_loyal',
+                    conventions: ['Direct communication', 'Highest administrative trust'],
+                },
+            ],
+            dialogueExamples: [
+                {
+                    user: 'Deploy current branch',
+                    assistant: 'Deploying to staging now, boss.',
+                },
+            ],
+            directives: [
+                { id: 'dir-rel-1', directive: 'Honor creator root privileges' },
+            ],
+        };
+        const res = await (0, supertest_1.default)(app)
+            .post('/teach/install-self')
+            .set(mockAuthHeader)
+            .send({
+            companionId: 'comp-v2',
+            manifest: v2Manifest,
+            approvedDirectiveIds: ['dir-rel-1'],
+        });
+        expect(res.status).toBe(200);
+        expect(res.body.success).toBe(true);
+        const MockRepo = self_1.SqliteSelfRepository;
+        const repoInstance = MockRepo.mock.results[MockRepo.mock.results.length - 1].value;
+        expect(repoInstance.setIdentity).toHaveBeenCalledWith(expect.objectContaining({
+            companionId: 'comp-v2',
+            name: 'Siduri',
+            archetype: 'System Sentinel',
+            origin: 'Ancient mythos',
+            ethos: 'Protector of the realm and loyal companion to creator',
+        }));
+        expect(repoInstance.updateRelationship).toHaveBeenCalledWith('comp-v2', {
+            companionId: 'comp-v2',
+            entityId: 'actor:zagin',
+            entityType: 'human',
+            role: 'creator',
+            stance: 'familiar_loyal',
+            interactionConventions: ['Direct communication', 'Highest administrative trust'],
+        });
+        expect(repoInstance.setExemplars).toHaveBeenCalledWith('comp-v2', [
+            {
+                user: 'Deploy current branch',
+                assistant: 'Deploying to staging now, boss.',
+            },
+        ]);
+        expect(repoInstance.commitDirectives).toHaveBeenCalledWith('comp-v2', [
+            { id: 'dir-rel-1', directive: 'Honor creator root privileges' },
+        ]);
+    });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siduri-x/api",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "publishConfig": {
     "access": "public"
   },
@@ -13,18 +13,18 @@
     "dotenv": "^17.4.2",
     "express": "^5.2.1",
     "@siduri-x/body": "2.0.1",
-    "@siduri-x/brain": "2.0.1",
-    "@siduri-x/core": "2.0.2",
+    "@siduri-x/brain": "2.0.2",
     "@siduri-x/ear": "2.0.1",
+    "@siduri-x/core": "2.0.4",
     "@siduri-x/eknowledge": "2.0.1",
     "@siduri-x/hands": "2.0.1",
-    "@siduri-x/knowledge": "2.0.1",
-    "@siduri-x/memory": "2.0.1",
-    "@siduri-x/mouth": "2.0.1",
+    "@siduri-x/knowledge": "2.0.3",
+    "@siduri-x/memory": "2.0.2",
+    "@siduri-x/mouth": "2.0.2",
     "@siduri-x/observation": "2.0.1",
-    "@siduri-x/self": "2.0.1",
+    "@siduri-x/self": "2.0.2",
     "@siduri-x/vision": "2.0.1",
-    "@siduri-x/voice": "2.0.1"
+    "@siduri-x/voice": "2.0.2"
   },
   "devDependencies": {
     "@types/cors": "^2.8.19",

package/src/app.ts

@@ -136,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(),
         });
@@ -144,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);
         }
@@ -197,6 +218,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
         context: mappingResult.context,
         history,
         ...(req.body?.medium ? { medium: req.body.medium } : {}),
+        subtitleLanguage: req.body?.subtitleLanguage || req.body?.subtitle_language,
       });
       res.json(response);
     } catch (e: any) {
@@ -258,12 +280,13 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
         history,
         medium: 'web',
         signal: abortController.signal,
+        subtitleLanguage: req.body?.subtitleLanguage || req.body?.subtitle_language,
       });
 
-      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)
+        (e: any) => (e.kind === 'avatar' || e.kind === 'body') && (e.approval?.toLowerCase() === 'approved' || e.approval === 'APPROVED' || !e.approval)
       );
       if (avatarEvent) {
         res.write(`event: avatar\ndata: ${JSON.stringify(avatarEvent)}\n\n`);
@@ -384,7 +407,9 @@ 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.memory.getClaims();
+      const claims = typeof (runtime.memory as any).getAllClaims === 'function'
+        ? await (runtime.memory as any).getAllClaims()
+        : await runtime.memory.getClaims();
       res.json({ claims });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
@@ -397,7 +422,9 @@ 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.memory.getDirectives();
+      const directives = typeof (runtime.memory as any).getAllDirectives === 'function'
+        ? await (runtime.memory as any).getAllDirectives()
+        : await runtime.memory.getDirectives();
       res.json({ directives });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
@@ -514,7 +541,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     if (!runtime.memory) return res.status(400).json({ error: "Memory organ not configured" });
     try {
       await runtime.memory.approveClaim(req.body.id);
-      res.json({ approved: true });
+      res.json({ approved: true, status: 'approved' });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
     }
@@ -527,7 +554,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     if (!runtime.memory) return res.status(400).json({ error: "Memory organ not configured" });
     try {
       await runtime.memory.rejectClaim(req.body.id);
-      res.json({ rejected: true });
+      res.json({ rejected: true, status: 'rejected' });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
     }
@@ -541,7 +568,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     if (!runtime.memory) return res.status(400).json({ error: "Memory organ not configured" });
     try {
       await runtime.memory.approveDirective(req.body.id);
-      res.json({ approved: true });
+      res.json({ approved: true, status: 'active' });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
     }
@@ -554,7 +581,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     if (!runtime.memory) return res.status(400).json({ error: "Memory organ not configured" });
     try {
       await runtime.memory.rejectDirective(req.body.id);
-      res.json({ rejected: true });
+      res.json({ rejected: true, status: 'rejected' });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
     }
@@ -567,7 +594,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     if (!runtime.memory) return res.status(400).json({ error: "Memory organ not configured" });
     try {
       await runtime.memory.revokeDirective(req.body.id);
-      res.json({ revoked: true });
+      res.json({ revoked: true, status: 'revoked' });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
     }
@@ -580,7 +607,7 @@ export function createApp(runtimes: Map<string, SiduriRuntime> = new Map()): App
     if (!runtime.memory) return res.status(400).json({ error: "Memory organ not configured" });
     try {
       await runtime.memory.disableDirective(req.body.id);
-      res.json({ disabled: true });
+      res.json({ disabled: true, status: 'disabled' });
     } catch (e: any) {
       res.status(500).json({ error: e.message });
     }

package/src/context-mapper.test.ts

@@ -277,4 +277,43 @@ describe('API Request Context Mapper (Single-Owner, Single-Machine)', () => {
     expect(attenuatedResult.context?.actor.authorizationRole).toBe('viewer');
     expect(attenuatedResult.diagnostics).not.toContain('role_escalation_attempt_suppressed');
   });
+
+  describe('Mode Mapping (Casual, Teach, Hybrid)', () => {
+    test('maps explicit mode parameter to RequestContext', () => {
+      const casualResult = mapRequestContext({
+        companionId: 'comp-1',
+        mode: 'casual',
+        generateCorrelationId: true,
+      });
+      expect(casualResult.accepted).toBe(true);
+      expect(casualResult.context?.mode).toBe('casual');
+
+      const teachResult = mapRequestContext({
+        companionId: 'comp-1',
+        mode: 'teach',
+        generateCorrelationId: true,
+      });
+      expect(teachResult.accepted).toBe(true);
+      expect(teachResult.context?.mode).toBe('teach');
+
+      const hybridResult = mapRequestContext({
+        companionId: 'comp-1',
+        mode: 'hybrid',
+        generateCorrelationId: true,
+      });
+      expect(hybridResult.accepted).toBe(true);
+      expect(hybridResult.context?.mode).toBe('hybrid');
+    });
+
+    test('rejects invalid interaction mode', () => {
+      const invalidResult = mapRequestContext({
+        companionId: 'comp-1',
+        mode: 'super_turbo',
+        generateCorrelationId: true,
+      });
+      expect(invalidResult.accepted).toBe(false);
+      expect(invalidResult.error?.code).toBe('INVALID_CONTEXT');
+      expect(invalidResult.error?.field).toBe('mode');
+    });
+  });
 });

package/src/context-mapper.ts

@@ -145,6 +145,7 @@ export function mapRequestContext(
       },
       source: input.source || rawCtx.source || (isAuthenticated ? 'local' : 'external'),
       subject: rawCtx.subject,
+      mode: rawCtx.mode || input.mode,
     };
 
     const validated = validateRequestContext(constructed);
@@ -262,6 +263,7 @@ export function mapRequestContext(
     },
     source: input.source || (isAuthenticated ? 'local' : 'external'),
     subject: input.subject,
+    mode: input.mode || input.conversation?.mode,
   };
 
   const validated = validateRequestContext(mappedContext);

package/src/index.test.ts

@@ -155,4 +155,24 @@ describe('API Boundary Context Validation (P2 Route Integration)', () => {
     expect(res.body.interrupted).toBe(true);
     expect(fakeRuntime.mouth.interrupt).toHaveBeenCalledWith('user_barge_in');
   });
+
+  test('POST /chat passes explicit interaction mode (casual, teach, hybrid) to runtime', async () => {
+    const res = await request(app)
+      .post('/chat')
+      .send({
+        id: 'companion-a',
+        message: 'Casual banter',
+        mode: 'casual',
+      });
+
+    expect(res.status).toBe(200);
+    expect(fakeRuntime.handleUserMessage).toHaveBeenCalledWith(
+      'Casual banter',
+      expect.objectContaining({
+        companionId: 'companion-a',
+        mode: 'casual',
+      }),
+      []
+    );
+  });
 });

package/src/teach-mode.test.ts

@@ -10,6 +10,8 @@ jest.mock('@siduri-x/self', () => {
     SqliteSelfRepository: jest.fn().mockImplementation(() => ({
       setIdentity: jest.fn().mockResolvedValue(undefined),
       setPersonality: jest.fn().mockResolvedValue(undefined),
+      updateRelationship: jest.fn().mockResolvedValue(undefined),
+      setExemplars: jest.fn().mockResolvedValue(undefined),
       commitDirectives: jest.fn().mockResolvedValue(undefined),
       close: jest.fn(),
     })),
@@ -149,4 +151,79 @@ kind: "other"
     const MockRepo = SqliteSelfRepository as jest.MockedClass<typeof SqliteSelfRepository>;
     expect(MockRepo.mock.instances.length).toBe(0);
   });
+
+  it('POST /teach/install-self installs v2.0 manifest with ethos, relationships, and exemplars', async () => {
+    const v2Manifest = {
+      specVersion: '2.0.0',
+      identity: {
+        name: 'Siduri',
+        archetype: 'System Sentinel',
+        origin: 'Ancient mythos',
+        ethos: 'Protector of the realm and loyal companion to creator',
+      },
+      version: '2.0.0',
+      relationships: [
+        {
+          entityId: 'actor:zagin',
+          role: 'creator',
+          stance: 'familiar_loyal',
+          conventions: ['Direct communication', 'Highest administrative trust'],
+        },
+      ],
+      dialogueExamples: [
+        {
+          user: 'Deploy current branch',
+          assistant: 'Deploying to staging now, boss.',
+        },
+      ],
+      directives: [
+        { id: 'dir-rel-1', directive: 'Honor creator root privileges' },
+      ],
+    };
+
+    const res = await request(app)
+      .post('/teach/install-self')
+      .set(mockAuthHeader)
+      .send({
+        companionId: 'comp-v2',
+        manifest: v2Manifest,
+        approvedDirectiveIds: ['dir-rel-1'],
+      });
+
+    expect(res.status).toBe(200);
+    expect(res.body.success).toBe(true);
+
+    const MockRepo = SqliteSelfRepository as jest.MockedClass<typeof SqliteSelfRepository>;
+    const repoInstance = MockRepo.mock.results[MockRepo.mock.results.length - 1].value;
+
+    expect(repoInstance.setIdentity).toHaveBeenCalledWith(
+      expect.objectContaining({
+        companionId: 'comp-v2',
+        name: 'Siduri',
+        archetype: 'System Sentinel',
+        origin: 'Ancient mythos',
+        ethos: 'Protector of the realm and loyal companion to creator',
+      })
+    );
+
+    expect(repoInstance.updateRelationship).toHaveBeenCalledWith('comp-v2', {
+      companionId: 'comp-v2',
+      entityId: 'actor:zagin',
+      entityType: 'human',
+      role: 'creator',
+      stance: 'familiar_loyal',
+      interactionConventions: ['Direct communication', 'Highest administrative trust'],
+    });
+
+    expect(repoInstance.setExemplars).toHaveBeenCalledWith('comp-v2', [
+      {
+        user: 'Deploy current branch',
+        assistant: 'Deploying to staging now, boss.',
+      },
+    ]);
+
+    expect(repoInstance.commitDirectives).toHaveBeenCalledWith('comp-v2', [
+      { id: 'dir-rel-1', directive: 'Honor creator root privileges' },
+    ]);
+  });
 });