@vxnus/siduri 0.1.7 → 0.1.10

package/dist/builtin-manifests.js

@@ -5,7 +5,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/behavior',
         organType: 'behavior',
-        version: '1.0.5',
+        version: '1.0.6',
         displayName: 'Behavior (Active Self Directives)',
         description: 'Atomic directive state machine and personality projection compiler',
         entrypoint: './dist/index.js',
@@ -66,7 +66,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/brain',
         organType: 'brain',
-        version: '1.0.3',
+        version: '1.0.5',
         displayName: 'Brain (Cognition & Planning)',
         description: 'Provider-neutral LLM reasoning, response planning, and proposal generation',
         entrypoint: './dist/index.js',
@@ -272,7 +272,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/memory',
         organType: 'memory',
-        version: '1.0.3',
+        version: '1.0.6',
         displayName: 'Memory (PostgreSQL FTS Claims)',
         description: 'Relational semantic claims with Full-Text Search and companion isolation',
         entrypoint: './dist/index.js',
@@ -324,7 +324,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/observation',
         organType: 'observation',
-        version: '1.0.2',
+        version: '1.0.3',
         displayName: 'Observation (Screen Perception & Frame Ingest)',
         description: 'Screen capture frame ingest, SHA-256 deduplication, and visual grounding for Eyes/Vision',
         entrypoint: './dist/index.js',
@@ -460,5 +460,33 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
         ],
         database: null,
         healthCheck: null
+    },
+    {
+        name: '@siduri-x/mouth',
+        organType: 'mouth',
+        version: '1.0.0',
+        displayName: 'Mouth (Communication & UI Delivery)',
+        description: 'Decoupled output delivery organ formatting cognitive decisions for web interfaces',
+        entrypoint: './dist/index.js',
+        factory: 'DefaultMouthOrgan',
+        configKey: 'mouth',
+        configSchema: {
+            type: 'object',
+            properties: {
+                defaultMedium: {
+                    type: 'string',
+                    enum: ['web'],
+                    default: 'web'
+                },
+                maxTextLength: {
+                    type: 'number',
+                    default: 8000
+                }
+            }
+        },
+        environment: [],
+        services: [],
+        database: null,
+        healthCheck: null
     }
 ];

package/dist/clean-machine-e2e.test.js

@@ -12,20 +12,26 @@ describe('Phase 5: Clean-Machine Distribution & E2E Integration Suite', () => {
     const repoRoot = node_path_1.default.resolve(__dirname, '../..');
     const tempPackDir = node_path_1.default.resolve(__dirname, '../temp-packs-e2e');
     const cleanMachineRoot = node_path_1.default.resolve(__dirname, '../temp-clean-machine-e2e');
+    const getPkgVer = (dir) => JSON.parse(node_fs_1.default.readFileSync(node_path_1.default.resolve(repoRoot, dir, 'package.json'), 'utf8')).version;
     const ALL_CANONICAL_PACKAGES = [
-        { filter: '@siduri-x/core', tarName: 'siduri-x-core-1.0.4.tgz', isOrgan: false },
-        { filter: '@siduri-x/brain', tarName: 'siduri-x-brain-1.0.3.tgz', isOrgan: true },
-        { filter: '@siduri-x/memory', tarName: 'siduri-x-memory-1.0.3.tgz', isOrgan: true },
-        { filter: '@siduri-x/knowledge', tarName: 'siduri-x-knowledge-1.0.2.tgz', isOrgan: true },
-        { filter: '@siduri-x/behavior', tarName: 'siduri-x-behavior-1.0.5.tgz', isOrgan: true },
-        { filter: '@siduri-x/ear', tarName: 'siduri-x-ear-1.0.2.tgz', isOrgan: true },
-        { filter: '@siduri-x/vision', tarName: 'siduri-x-vision-1.0.2.tgz', isOrgan: true },
-        { filter: '@siduri-x/hands', tarName: 'siduri-x-hands-1.0.2.tgz', isOrgan: true },
-        { filter: '@siduri-x/body', tarName: 'siduri-x-body-1.0.4.tgz', isOrgan: true },
-        { filter: '@siduri-x/voice', tarName: 'siduri-x-voice-1.0.5.tgz', isOrgan: true },
-        { filter: '@siduri-x/observation', tarName: 'siduri-x-observation-1.0.2.tgz', isOrgan: true },
-        { filter: '@vxnus/siduri', tarName: 'vxnus-siduri-0.1.7.tgz', isOrgan: false },
+        { filter: '@siduri-x/core', tarName: `siduri-x-core-${getPkgVer('packages/core')}.tgz`, isOrgan: false },
+        { filter: '@siduri-x/brain', tarName: `siduri-x-brain-${getPkgVer('packages/organs/brain')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/memory', tarName: `siduri-x-memory-${getPkgVer('packages/organs/memory')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/knowledge', tarName: `siduri-x-knowledge-${getPkgVer('packages/organs/knowledge')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/behavior', tarName: `siduri-x-behavior-${getPkgVer('packages/organs/behavior')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/ear', tarName: `siduri-x-ear-${getPkgVer('packages/organs/ear')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/vision', tarName: `siduri-x-vision-${getPkgVer('packages/organs/vision')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/hands', tarName: `siduri-x-hands-${getPkgVer('packages/organs/hands')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/body', tarName: `siduri-x-body-${getPkgVer('packages/organs/body')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/voice', tarName: `siduri-x-voice-${getPkgVer('packages/organs/voice')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/observation', tarName: `siduri-x-observation-${getPkgVer('packages/organs/observation')}.tgz`, isOrgan: true },
+        { filter: '@siduri-x/mouth', tarName: `siduri-x-mouth-${getPkgVer('packages/organs/mouth')}.tgz`, isOrgan: true },
+        { filter: '@vxnus/siduri', tarName: `vxnus-siduri-${getPkgVer('cli')}.tgz`, isOrgan: false },
     ];
+    const getTarPath = (pkgName) => {
+        const pkg = ALL_CANONICAL_PACKAGES.find(p => p.filter === pkgName);
+        return node_path_1.default.join(tempPackDir, pkg.tarName);
+    };
     beforeAll(() => {
         // 1. Prepare clean directories
         if (node_fs_1.default.existsSync(tempPackDir))
@@ -35,7 +41,7 @@ describe('Phase 5: Clean-Machine Distribution & E2E Integration Suite', () => {
         node_fs_1.default.mkdirSync(tempPackDir, { recursive: true });
         node_fs_1.default.mkdirSync(cleanMachineRoot, { recursive: true });
         // 2. Build all packages in repo
-        (0, node_child_process_1.execSync)('pnpm build', { cwd: repoRoot, stdio: 'pipe' });
+        (0, node_child_process_1.execSync)("pnpm turbo run build --filter='!web'", { cwd: repoRoot, stdio: 'pipe' });
         // 3. Pack each canonical package into tempPackDir
         for (const pkg of ALL_CANONICAL_PACKAGES) {
             (0, node_child_process_1.execSync)(`pnpm --filter ${pkg.filter} pack --pack-destination ${tempPackDir}`, {
@@ -51,7 +57,7 @@ describe('Phase 5: Clean-Machine Distribution & E2E Integration Suite', () => {
             node_fs_1.default.rmSync(cleanMachineRoot, { recursive: true, force: true });
     });
     describe('Phase 5A: Package Artifact Verification', () => {
-        test('all 12 packages produce valid tarballs', () => {
+        test('all 13 packages produce valid tarballs', () => {
             for (const pkg of ALL_CANONICAL_PACKAGES) {
                 const tarPath = node_path_1.default.join(tempPackDir, pkg.tarName);
                 expect(node_fs_1.default.existsSync(tarPath)).toBe(true);
@@ -86,7 +92,7 @@ describe('Phase 5: Clean-Machine Distribution & E2E Integration Suite', () => {
             }
         });
         test('memory organ tarball packages migrations/001_initial_schema.sql', () => {
-            const memoryTarPath = node_path_1.default.join(tempPackDir, 'siduri-x-memory-1.0.3.tgz');
+            const memoryTarPath = node_path_1.default.join(tempPackDir, 'siduri-x-memory-1.0.4.tgz');
             const listing = (0, node_child_process_1.execSync)(`tar -tzf ${memoryTarPath}`, { encoding: 'utf8' });
             expect(listing).toContain('package/migrations/001_initial_schema.sql');
         });
@@ -106,8 +112,8 @@ describe('Phase 5: Clean-Machine Distribution & E2E Integration Suite', () => {
             // Write instance files referencing packed tarballs directly for true clean machine install
             const pkgObj = JSON.parse(files['package.json']);
             pkgObj.dependencies = {
-                '@siduri-x/core': `file:${node_path_1.default.join(tempPackDir, 'siduri-x-core-1.0.4.tgz')}`,
-                '@siduri-x/brain': `file:${node_path_1.default.join(tempPackDir, 'siduri-x-brain-1.0.3.tgz')}`,
+                '@siduri-x/core': `file:${getTarPath('@siduri-x/core')}`,
+                '@siduri-x/brain': `file:${getTarPath('@siduri-x/brain')}`,
             };
             node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, 'package.json'), JSON.stringify(pkgObj, null, 2) + '\n');
             node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, 'siduri.config.json'), files['siduri.config.json']);
@@ -154,9 +160,9 @@ describe('Phase 5: Clean-Machine Distribution & E2E Integration Suite', () => {
             });
             const pkgObj = JSON.parse(files['package.json']);
             pkgObj.dependencies = {
-                '@siduri-x/core': `file:${node_path_1.default.join(tempPackDir, 'siduri-x-core-1.0.4.tgz')}`,
-                '@siduri-x/brain': `file:${node_path_1.default.join(tempPackDir, 'siduri-x-brain-1.0.3.tgz')}`,
-                '@siduri-x/hands': `file:${node_path_1.default.join(tempPackDir, 'siduri-x-hands-1.0.2.tgz')}`,
+                '@siduri-x/core': `file:${getTarPath('@siduri-x/core')}`,
+                '@siduri-x/brain': `file:${getTarPath('@siduri-x/brain')}`,
+                '@siduri-x/hands': `file:${getTarPath('@siduri-x/hands')}`,
             };
             node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, 'package.json'), JSON.stringify(pkgObj, null, 2) + '\n');
             node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, 'siduri.config.json'), files['siduri.config.json']);
@@ -193,9 +199,9 @@ describe('Phase 5: Clean-Machine Distribution & E2E Integration Suite', () => {
             });
             const pkgObj = JSON.parse(files['package.json']);
             pkgObj.dependencies = {
-                '@siduri-x/core': `file:${node_path_1.default.join(tempPackDir, 'siduri-x-core-1.0.4.tgz')}`,
-                '@siduri-x/brain': `file:${node_path_1.default.join(tempPackDir, 'siduri-x-brain-1.0.3.tgz')}`,
-                '@siduri-x/memory': `file:${node_path_1.default.join(tempPackDir, 'siduri-x-memory-1.0.3.tgz')}`,
+                '@siduri-x/core': `file:${getTarPath('@siduri-x/core')}`,
+                '@siduri-x/brain': `file:${getTarPath('@siduri-x/brain')}`,
+                '@siduri-x/memory': `file:${getTarPath('@siduri-x/memory')}`,
             };
             node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, 'package.json'), JSON.stringify(pkgObj, null, 2) + '\n');
             node_fs_1.default.writeFileSync(node_path_1.default.join(instanceDir, 'siduri.config.json'), files['siduri.config.json']);

package/dist/configurators/index.d.ts

@@ -13,6 +13,7 @@ export * from './behavior';
 export * from './vision';
 export * from './ear';
 export * from './observation';
+export * from './mouth';
 export interface ConfigureOrganOptions {
     brainOptions?: BrainConfiguratorOptions;
     knowledgeOptions?: KnowledgeConfiguratorOptions;

package/dist/configurators/index.js

@@ -25,6 +25,7 @@ const behavior_1 = require("./behavior");
 const vision_1 = require("./vision");
 const ear_1 = require("./ear");
 const observation_1 = require("./observation");
+const mouth_1 = require("./mouth");
 __exportStar(require("./types"), exports);
 __exportStar(require("./brain"), exports);
 __exportStar(require("./knowledge"), exports);
@@ -36,6 +37,7 @@ __exportStar(require("./behavior"), exports);
 __exportStar(require("./vision"), exports);
 __exportStar(require("./ear"), exports);
 __exportStar(require("./observation"), exports);
+__exportStar(require("./mouth"), exports);
 async function configureOrgan(manifest, context, options = {}) {
     const ctx = {
         companionName: context.companionName,
@@ -63,6 +65,8 @@ async function configureOrgan(manifest, context, options = {}) {
             return (0, ear_1.configureEar)(ctx);
         case 'observation':
             return (0, observation_1.configureObservation)(ctx);
+        case 'mouth':
+            return (0, mouth_1.configureMouth)(ctx);
         default:
             return {
                 config: ctx.existingConfig || {},

package/dist/configurators/mouth.d.ts

@@ -0,0 +1,2 @@
+import { OrganConfiguratorContext, OrganConfigurationResult } from './types';
+export declare function configureMouth(_context: OrganConfiguratorContext): Promise<OrganConfigurationResult>;

package/dist/configurators/mouth.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureMouth = configureMouth;
+async function configureMouth(_context) {
+    return {
+        config: {
+            defaultMedium: 'web',
+            maxTextLength: 8000,
+        },
+        summary: {
+            'Default Medium': 'Web',
+            'Max Text Length': '8000 chars',
+        },
+    };
+}

package/dist/configurators/voice.js

@@ -13,13 +13,25 @@ async function configureVoice(_context) {
         message: 'Voice provider?',
         choices: [
             {
-                name: 'RVC (Custom user-owned voice model via .pth / .index weights)',
-                value: 'rvc',
+                name: 'Edge-TTS (Zero-setup cloud TTS, no downloads/no Python required)',
+                value: 'edge-tts',
             },
             {
                 name: 'VOICEVOX (Standard VOICEVOX stock character voice banks)',
                 value: 'voicevox',
             },
+            {
+                name: 'Kokoro TTS (Fast lightweight neural TTS via HTTP/CLI)',
+                value: 'kokoro',
+            },
+            {
+                name: 'Piper TTS (Fast local neural TTS via HTTP/CLI)',
+                value: 'piper',
+            },
+            {
+                name: 'RVC (Custom user-owned voice model via .pth / .index weights)',
+                value: 'rvc',
+            },
             {
                 name: 'None (Disable voice synthesis)',
                 value: 'none',
@@ -32,6 +44,108 @@ async function configureVoice(_context) {
             summary: { Provider: 'None (Voice disabled)' },
         };
     }
+    if (provider === 'edge-tts') {
+        const edgeAnswers = await inquirer_1.default.prompt([
+            {
+                type: 'input',
+                name: 'voice',
+                message: 'Edge-TTS Voice Identifier (e.g. ja-JP-NanamiNeural, en-US-AriaNeural):',
+                default: 'ja-JP-NanamiNeural',
+            },
+        ]);
+        const voice = edgeAnswers.voice.trim() || 'ja-JP-NanamiNeural';
+        return {
+            config: {
+                provider: 'edge-tts',
+                voice,
+                maxQueueDepth: 50,
+            },
+            summary: {
+                Provider: 'Edge-TTS (Cloud Neural)',
+                Voice: voice,
+            },
+        };
+    }
+    if (provider === 'kokoro') {
+        const kokoroAnswers = await inquirer_1.default.prompt([
+            {
+                type: 'input',
+                name: 'baseUrl',
+                message: 'Kokoro HTTP Base URL (leave empty if using local kokoro-tts CLI):',
+                default: 'http://localhost:8880',
+            },
+            {
+                type: 'input',
+                name: 'voice',
+                message: 'Kokoro Voice Name (e.g. af_bella, af_heart):',
+                default: 'af_bella',
+            },
+            {
+                type: 'input',
+                name: 'speed',
+                message: 'Speech Speed multiplier (e.g. 1.0):',
+                default: '1.0',
+            },
+        ]);
+        const baseUrl = kokoroAnswers.baseUrl.trim() || undefined;
+        const voice = kokoroAnswers.voice.trim() || 'af_bella';
+        const speed = parseFloat(kokoroAnswers.speed) || 1.0;
+        return {
+            config: {
+                provider: 'kokoro',
+                baseUrl,
+                voice,
+                speed,
+                maxQueueDepth: 50,
+            },
+            summary: {
+                Provider: 'Kokoro TTS (Local / Server)',
+                Mode: baseUrl ? `HTTP (${baseUrl})` : 'CLI (kokoro-tts)',
+                Voice: voice,
+                Speed: speed,
+            },
+        };
+    }
+    if (provider === 'piper') {
+        const piperAnswers = await inquirer_1.default.prompt([
+            {
+                type: 'input',
+                name: 'baseUrl',
+                message: 'Piper HTTP Base URL (leave empty if using local piper CLI):',
+                default: 'http://localhost:5000',
+            },
+            {
+                type: 'input',
+                name: 'model',
+                message: 'Piper Model Path or Name (.onnx, optional):',
+                default: '',
+            },
+            {
+                type: 'input',
+                name: 'speakerId',
+                message: 'Piper Speaker ID (optional):',
+                default: '',
+            },
+        ]);
+        const baseUrl = piperAnswers.baseUrl.trim() || undefined;
+        const model = piperAnswers.model.trim() || undefined;
+        const speakerId = piperAnswers.speakerId.trim() ? parseInt(piperAnswers.speakerId.trim(), 10) : undefined;
+        return {
+            config: {
+                provider: 'piper',
+                baseUrl,
+                model,
+                speakerId,
+                maxQueueDepth: 50,
+            },
+            summary: {
+                Provider: 'Piper TTS (Local / Server)',
+                Mode: baseUrl ? `HTTP (${baseUrl})` : 'CLI (piper)',
+                Model: model || 'default',
+                'Speaker ID': speakerId !== undefined ? speakerId : 'default',
+            },
+        };
+    }
     if (provider === 'rvc') {
         const rvcAnswers = await inquirer_1.default.prompt([
             {

package/dist/configurators.test.js

@@ -215,6 +215,38 @@ describe('Guided Manifest-Driven Configuration UX Specification Tests', () => {
             expect(result.config.rvc.pitchShift).toBe(12);
             expect(result.summary?.['Base TTS']).toBe('edge-tts');
         });
+        test('Voice configurator configures standalone Edge-TTS', async () => {
+            inquirer_1.default.prompt
+                .mockResolvedValueOnce({ provider: 'edge-tts' })
+                .mockResolvedValueOnce({ voice: 'en-US-AriaNeural' });
+            const result = await (0, voice_1.configureVoice)({ companionName: 'Sparkle', manifest: voiceManifest });
+            expect(result.config.provider).toBe('edge-tts');
+            expect(result.config.voice).toBe('en-US-AriaNeural');
+            expect(result.summary?.Provider).toBe('Edge-TTS (Cloud Neural)');
+            expect(result.summary?.Voice).toBe('en-US-AriaNeural');
+        });
+        test('Voice configurator configures standalone Kokoro TTS', async () => {
+            inquirer_1.default.prompt
+                .mockResolvedValueOnce({ provider: 'kokoro' })
+                .mockResolvedValueOnce({ baseUrl: 'http://localhost:8880', voice: 'af_heart', speed: '1.2' });
+            const result = await (0, voice_1.configureVoice)({ companionName: 'Sparkle', manifest: voiceManifest });
+            expect(result.config.provider).toBe('kokoro');
+            expect(result.config.baseUrl).toBe('http://localhost:8880');
+            expect(result.config.voice).toBe('af_heart');
+            expect(result.config.speed).toBe(1.2);
+            expect(result.summary?.Provider).toBe('Kokoro TTS (Local / Server)');
+        });
+        test('Voice configurator configures standalone Piper TTS', async () => {
+            inquirer_1.default.prompt
+                .mockResolvedValueOnce({ provider: 'piper' })
+                .mockResolvedValueOnce({ baseUrl: 'http://localhost:5000', model: 'en_US-lessac', speakerId: '2' });
+            const result = await (0, voice_1.configureVoice)({ companionName: 'Sparkle', manifest: voiceManifest });
+            expect(result.config.provider).toBe('piper');
+            expect(result.config.baseUrl).toBe('http://localhost:5000');
+            expect(result.config.model).toBe('en_US-lessac');
+            expect(result.config.speakerId).toBe(2);
+            expect(result.summary?.Provider).toBe('Piper TTS (Local / Server)');
+        });
         test('Body configurator configures Live2D, custom model path, and expression', async () => {
             inquirer_1.default.prompt
                 .mockResolvedValueOnce({ provider: 'live2d' })

package/dist/discovery.test.js

@@ -8,10 +8,10 @@ const discovery_1 = require("./discovery");
 const generator_1 = require("./generator");
 describe('Discovery & Dynamic Composition System Tests (Phase 3)', () => {
     const rootOrgansDir = node_path_1.default.resolve(__dirname, '../../packages/organs');
-    test('Registry successfully discovers all 10 organ packages from workspace', () => {
+    test('Registry successfully discovers all 11 organ packages from workspace', () => {
         const registry = discovery_1.OrganRegistry.discover([rootOrgansDir]);
         const manifests = registry.getAll();
-        expect(manifests.length).toBe(10);
+        expect(manifests.length).toBe(11);
         const organTypes = registry.getAvailableOrganTypes().sort();
         expect(organTypes).toEqual([
             'behavior',
@@ -21,6 +21,7 @@ describe('Discovery & Dynamic Composition System Tests (Phase 3)', () => {
             'hands',
             'knowledge',
             'memory',
+            'mouth',
             'observation',
             'vision',
             'voice',
@@ -60,8 +61,9 @@ describe('Discovery & Dynamic Composition System Tests (Phase 3)', () => {
     test('Fallback to builtin organ manifests when scanning non-existent search roots', () => {
         const registry = discovery_1.OrganRegistry.discover(['/non-existent-directory/empty']);
         const manifests = registry.getAll();
-        expect(manifests.length).toBe(10);
+        expect(manifests.length).toBe(11);
         expect(registry.get('brain')).toBeDefined();
         expect(registry.get('memory')).toBeDefined();
+        expect(registry.get('mouth')).toBeDefined();
     });
 });

package/dist/generator.js

@@ -63,16 +63,21 @@ function getDefaultConfigForManifest(manifest) {
         config.provider = config.provider || 'openrouter';
         config.model = config.model || 'gpt-4-vision';
     }
+    else if (manifest.organType === 'mouth') {
+        config.defaultMedium = 'web';
+        config.maxTextLength = config.maxTextLength || 8000;
+    }
     return config;
 }
 function generateInstanceFiles(options) {
     const instanceName = options.name || 'my-siduri';
     const instanceId = options.id || 'default';
-    const coreVersion = options.coreVersion || '^1.0.4';
+    const coreVersion = options.coreVersion || '^1.0.8';
     const manifests = options.selectedManifests;
     const hasMemory = manifests.some((m) => m.organType === 'memory');
     const hasVoice = manifests.some((m) => m.organType === 'voice');
     const hasBody = manifests.some((m) => m.organType === 'body');
+    const hasMouth = manifests.some((m) => m.organType === 'mouth');
     const voiceConfig = options.organConfigs?.voice || options.organConfigs?.['@siduri-x/voice'];
     const isVoicevox = hasVoice && (!voiceConfig || voiceConfig.provider === 'voicevox');
     const memoryConfig = options.organConfigs?.memory || options.organConfigs?.['@siduri-x/memory'];
@@ -222,6 +227,9 @@ function generateInstanceFiles(options) {
         instantiationLines.push(`const ${varName} = new ${m.factory}(config.organs.${m.configKey});`);
         organMapEntries.push(`  ${varName},`);
     }
+    if (hasMouth && hasVoice) {
+        instantiationLines.push(`if (typeof mouth?.setVoiceOrgan === 'function') mouth.setVoiceOrgan(voice);`);
+    }
     const selectedDisplayNames = manifests.map((m) => m.displayName.split(' ')[0] || m.organType).join(', ');
     const srcIndexJs = [
         ...importLines,
@@ -363,7 +371,7 @@ function generateInstanceFiles(options) {
         `          id: config.id,`,
         `          companionId: config.id,`,
         `          message: payload.message || payload.text || '',`,
-        `          role: payload.role || 'OWNER',`,
+        `          context: payload.context,`,
         `          history: Array.isArray(payload.history) ? payload.history : [],`,
         `        });`,
         '',
@@ -377,6 +385,122 @@ function generateInstanceFiles(options) {
         `    return;`,
         `  }`,
         '',
+        `  // API: Real-time SSE streaming (Mouth transport)`,
+        `  if ((pathname === '/chat/stream' || pathname === '/api/chat/stream') && req.method === 'POST') {`,
+        `    let body = '';`,
+        `    req.on('data', (chunk) => { body += chunk; });`,
+        `    req.on('end', async () => {`,
+        `      res.writeHead(200, {`,
+        `        'Content-Type': 'text/event-stream',`,
+        `        'Cache-Control': 'no-cache, no-transform',`,
+        `        'Connection': 'keep-alive',`,
+        `      });`,
+        `      const abortController = new AbortController();`,
+        `      const onClose = () => {`,
+        `        abortController.abort('client_disconnect');`,
+        `        if (typeof runtime.interruptMouth === 'function') {`,
+        `          runtime.interruptMouth('client_disconnect');`,
+        `        }`,
+        `      };`,
+        `      req.on('close', onClose);`,
+        '',
+        `      try {`,
+        `        const payload = JSON.parse(body || '{}');`,
+        `        const response = await dispatchCompanionChat(runtime, {`,
+        `          id: config.id,`,
+        `          companionId: config.id,`,
+        `          message: payload.message || payload.text || '',`,
+        `          context: payload.context,`,
+        `          history: Array.isArray(payload.history) ? payload.history : [],`,
+        `          medium: 'web',`,
+        `          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\`);`,
+        '',
+        `        const avatarEvent = response.metadata?.events?.find(`,
+        `          (e) => (e.kind === 'avatar' || e.kind === 'body') && (e.approval === 'APPROVED' || !e.approval)`,
+        `        );`,
+        `        if (avatarEvent) {`,
+        `          res.write(\`event: avatar\\ndata: \${JSON.stringify(avatarEvent)}\\n\\n\`);`,
+        `        }`,
+        '',
+        `        const speechText = response.delivery?.text || response.response?.subtitle_en || response.response?.spoken_ja || '';`,
+        `        const utterance = {`,
+        `          utteranceId: response.response_id || 'utt-stream',`,
+        `          companionId: config.id,`,
+        `          responseId: response.response_id,`,
+        `          correlationId: response.correlation_id,`,
+        `          text: speechText,`,
+        `          medium: 'web',`,
+        `          expression: avatarEvent?.expression,`,
+        `          action: avatarEvent?.action,`,
+        `          signal: abortController.signal,`,
+        `        };`,
+        '',
+        `        if (runtime.mouth && typeof runtime.mouth.stream === 'function') {`,
+        `          for await (const chunk of runtime.mouth.stream(utterance)) {`,
+        `            if (abortController.signal.aborted) {`,
+        `              res.write(\`event: chunk\\ndata: \${JSON.stringify({ ...chunk, interrupted: true })}\\n\\n\`);`,
+        `              break;`,
+        `            }`,
+        `            res.write(\`event: chunk\\ndata: \${JSON.stringify(chunk)}\\n\\n\`);`,
+        `          }`,
+        `        } else {`,
+        `          res.write(\`event: chunk\\ndata: \${JSON.stringify({ utteranceId: utterance.utteranceId, index: 1, deltaText: speechText, isComplete: true, medium: 'web' })}\\n\\n\`);`,
+        `        }`,
+        '',
+        `        res.write(\`event: done\\ndata: \${JSON.stringify(response)}\\n\\n\`);`,
+        `        res.end();`,
+        `      } catch (err) {`,
+        `        if (abortController.signal.aborted) {`,
+        `          res.write(\`event: interrupted\\ndata: \${JSON.stringify({ reason: abortController.signal.reason })}\\n\\n\`);`,
+        `        } else {`,
+        `          res.write(\`event: error\\ndata: \${JSON.stringify({ error: err.message })}\\n\\n\`);`,
+        `        }`,
+        `        res.end();`,
+        `      } finally {`,
+        `        req.removeListener('close', onClose);`,
+        `      }`,
+        `    });`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Barge-in interruption`,
+        `  if ((pathname === '/chat/interrupt' || pathname === '/mouth/interrupt' || pathname === '/api/chat/interrupt') && req.method === 'POST') {`,
+        `    let body = '';`,
+        `    req.on('data', (chunk) => { body += chunk; });`,
+        `    req.on('end', () => {`,
+        `      try {`,
+        `        const payload = JSON.parse(body || '{}');`,
+        `        const reason = payload.reason || 'user_barge_in';`,
+        `        if (typeof runtime.interruptMouth === 'function') {`,
+        `          runtime.interruptMouth(reason);`,
+        `        }`,
+        `        res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `        res.end(JSON.stringify({ success: true, interrupted: true, reason }));`,
+        `      } catch (e) {`,
+        `        res.writeHead(500, { 'Content-Type': 'application/json' });`,
+        `        res.end(JSON.stringify({ error: e.message }));`,
+        `      }`,
+        `    });`,
+        `    return;`,
+        `  }`,
+        '',
+        `  // API: Mouth channels & health`,
+        `  if ((pathname === '/mouth/health' || pathname === '/api/mouth/health') && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    res.end(JSON.stringify({ provider: 'siduri-mouth', configured: Boolean(runtime.mouth) }));`,
+        `    return;`,
+        `  }`,
+        '',
+        `  if ((pathname === '/mouth/channels' || pathname === '/api/mouth/channels') && req.method === 'GET') {`,
+        `    res.writeHead(200, { 'Content-Type': 'application/json' });`,
+        `    const channels = typeof runtime.mouth?.getRegisteredChannels === 'function' ? runtime.mouth.getRegisteredChannels() : [];`,
+        `    res.end(JSON.stringify({ channels }));`,
+        `    return;`,
+        `  }`,
+        '',
         `  // API: Model Catalog Discovery (Body & Voice)`,
         `  if (pathname === '/api/models/body' && req.method === 'GET') {`,
         `    res.writeHead(200, { 'Content-Type': 'application/json' });`,

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { OrganManifest } from './manifest';
-export declare const CLI_VERSION = "0.1.7";
+export declare const CLI_VERSION = "0.1.10";
 export declare const colors: {
     cyan: string;
     dim: string;

package/dist/index.js

@@ -26,7 +26,7 @@ const doctor_1 = require("./doctor");
 const db_1 = require("./db");
 const configurators_1 = require("./configurators");
 const execFile = (0, node_util_1.promisify)(node_child_process_1.execFile);
-exports.CLI_VERSION = '0.1.7';
+exports.CLI_VERSION = '0.1.10';
 exports.colors = {
     cyan: '\u001b[36m',
     dim: '\u001b[2m',