siduri 1.0.0

package/LICENSE

@@ -0,0 +1,6 @@
+Copyright (c) 2026 VXNUS Creative Technology Studio. All rights reserved.
+
+This is an experimental prerelease of Siduri. It is provided for evaluation
+and development only. No production use, redistribution, or sublicensing is
+permitted without written authorization from VXNUS Creative Technology
+Studio.

package/README.md

@@ -0,0 +1,84 @@
+# Siduri CLI (`@vxnus/siduri`)
+
+Experimental CLI for creating, diagnosing, and managing standalone Siduri companions powered by the `@sidurijs/*` organ ecosystem.
+
+Requires Node.js >=22.16.0.
+
+```bash
+npx @vxnus/siduri create my-companion
+```
+
+## Prerequisites
+
+- **Node.js**: `v22.16.0` or newer
+- **LLM API Key**: e.g. `OPENROUTER_API_KEY` for Brain organ
+- **Optional Local Services**:
+  - **VOICEVOX**: For voice synthesis (auto-downloaded at runtime by default, or connect to standalone app).
+  - Storage is powered by embedded SQLite with WAL mode and built-in FTS5 (`siduri.sqlite`). No external database servers or Docker containers are required.
+
+## Features
+
+- **Manifest-Driven Organ Discovery**: Dynamically discovers installed `@sidurijs/*` organs and generates custom, standalone ESM instance code.
+- **Interactive Configuration Wizard**: Model catalog discovery for OpenRouter, manifest inspection for E Knowledge Hub, and guided organ parameters.
+- **Zero Monolithic Bundling**: Scaffolds standard Node.js ESM projects with explicit dependency trees.
+- **Diagnostics (`siduri doctor`)**: Runs environment variable validation, schema conformance checks, storage writeability verification, external service endpoint probing, and organ health probes.
+- **Zero-Config Database**: Powered by embedded SQLite (`siduri.sqlite`). Memory and persistent state are initialized automatically at startup without manual SQL migrations.
+
+## CLI Usage
+
+### 1. Create a Standalone Companion
+
+```bash
+npx @vxnus/siduri create [directory]
+```
+
+The interactive wizard allows you to name your companion, configure organ providers and models, and inspect Knowledge manifests. It generates:
+
+```text
+my-companion/
+├── package.json          # ESM package referencing only selected @sidurijs/* organs
+├── siduri.config.json    # Selected organ configurations
+├── siduri.schema.json    # Composed JSON Schema from organ manifests
+├── .env.example          # Only environment variables required by selected organs
+├── README.md             # Instance-specific guide
+└── src/
+    └── index.js          # Direct runtime bootstrapping with explicit organ factories
+```
+
+### 2. Run Diagnostics
+
+```bash
+npx siduri doctor [directory]
+```
+
+Inspects active configuration, checks required/optional environment variables, and executes health probes.
+
+### 3. Database Management
+
+```bash
+npx siduri db push [directory]
+npx siduri db reset [directory]
+```
+
+SQLite manages migrations and schemas automatically in-process.
+
+### 4. Instance Reset
+
+```bash
+npx siduri reset [directory]
+```
+
+Clears SQLite databases and cached state to return the companion to Blank Slate.
+
+## Local Development
+
+From the repository root:
+
+```bash
+pnpm --filter @vxnus/siduri build
+pnpm --filter @vxnus/siduri test
+```
+
+## License
+
+Licensed under the [Apache License, Version 2.0](./LICENSE).

package/dist/builtin-manifests.d.ts

@@ -0,0 +1,2 @@
+import { OrganManifest } from './manifest';
+export declare const BUILTIN_ORGAN_MANIFESTS: OrganManifest[];

package/dist/builtin-manifests.js

@@ -0,0 +1,524 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILTIN_ORGAN_MANIFESTS = void 0;
+exports.BUILTIN_ORGAN_MANIFESTS = [
+    {
+        name: '@sidurijs/self',
+        organType: 'behavior',
+        version: '2.0.12',
+        displayName: 'Self & Persona (Identity & Directives)',
+        description: 'Autonomous persona compiler, relational stances, and .self asset loader',
+        entrypoint: './dist/index.js',
+        factory: 'ActiveSelfCompiler',
+        configKey: 'behavior',
+        configSchema: {
+            type: 'object',
+            required: ['provider'],
+            properties: {
+                provider: {
+                    type: 'string',
+                    enum: ['active_self', 'none']
+                },
+                mode: {
+                    type: 'string',
+                    enum: ['blank_slate', 'custom']
+                },
+                archetype: {
+                    type: 'string'
+                },
+                ethos: {
+                    type: 'string'
+                },
+                directive: {
+                    type: 'string'
+                },
+                selfPath: {
+                    type: 'string'
+                }
+            }
+        },
+        environment: [],
+        services: [],
+        database: null,
+        healthCheck: null
+    },
+    {
+        name: '@sidurijs/body',
+        organType: 'body',
+        version: '2.1.0',
+        displayName: 'Body (Live2D & VRM Avatar State)',
+        description: 'Renderer-agnostic avatar expression and embodiment event adapter supporting Live2D (.model3.json) and VRM (.vrm)',
+        entrypoint: './dist/index.js',
+        factory: 'NeutralBodyOrgan',
+        configKey: 'body',
+        configSchema: {
+            type: 'object',
+            required: ['provider'],
+            properties: {
+                provider: {
+                    type: 'string',
+                    enum: ['live2d', 'vrm', 'none']
+                },
+                format: {
+                    type: 'string',
+                    enum: ['live2d', 'vrm', 'auto'],
+                    default: 'auto'
+                },
+                initialExpression: {
+                    type: 'string',
+                    default: 'neutral'
+                },
+                modelPath: {
+                    type: 'string',
+                    description: 'Path to local Live2D Cubism (.model3.json) or VRM (.vrm) model file'
+                },
+                modelUrl: {
+                    type: 'string',
+                    description: 'Relative web or remote HTTP URL to Live2D Cubism (.model3.json) or VRM (.vrm) model file'
+                },
+                vrm: {
+                    type: 'object',
+                    properties: {
+                        specVersion: {
+                            type: 'string',
+                            enum: ['0.x', '1.0', 'auto'],
+                            default: 'auto'
+                        },
+                        lookAtMode: {
+                            type: 'string',
+                            enum: ['camera', 'cursor', 'head', 'none'],
+                            default: 'camera'
+                        },
+                        defaultPose: {
+                            type: 'string'
+                        },
+                        expressionMapping: {
+                            type: 'object'
+                        }
+                    }
+                }
+            }
+        },
+        environment: [],
+        services: [],
+        database: null,
+        healthCheck: null
+    },
+    {
+        name: '@sidurijs/brain',
+        organType: 'brain',
+        version: '2.0.13',
+        displayName: 'Brain (Cognition & Planning)',
+        description: 'Provider-neutral LLM reasoning, response planning, and proposal generation',
+        entrypoint: './dist/index.js',
+        factory: 'OpenRouterBrain',
+        configKey: 'brain',
+        configSchema: {
+            type: 'object',
+            required: ['provider', 'model'],
+            properties: {
+                provider: {
+                    type: 'string',
+                    enum: ['openrouter', 'openai-compatible']
+                },
+                model: {
+                    type: 'string'
+                },
+                apiKey: {
+                    type: 'string'
+                },
+                apiKeyEnv: {
+                    type: 'string',
+                    default: 'OPENROUTER_API_KEY'
+                },
+                baseUrl: {
+                    type: 'string'
+                }
+            }
+        },
+        environment: [
+            {
+                name: 'OPENROUTER_API_KEY',
+                required: false,
+                secret: true,
+                description: 'API key for OpenRouter managed routing'
+            },
+            {
+                name: 'OPENAI_COMPATIBLE_API_KEY',
+                required: false,
+                secret: true,
+                description: 'API key for OpenAI-compatible endpoint'
+            }
+        ],
+        services: [
+            {
+                name: 'LLM Inference API',
+                kind: 'http_service',
+                optional: false
+            }
+        ],
+        database: null,
+        healthCheck: 'probeBrainHealth'
+    },
+    {
+        name: '@sidurijs/ear',
+        organType: 'ear',
+        version: '2.0.3',
+        displayName: 'Ear (Perception Ingress)',
+        description: 'Multi-modal sensory input ingestion, transcription bounds, and mime validation',
+        entrypoint: './dist/index.js',
+        factory: 'DefaultEarOrgan',
+        configKey: 'ear',
+        configSchema: {
+            type: 'object',
+            properties: {
+                defaultSource: {
+                    type: 'string',
+                    default: 'text_chat'
+                },
+                maxTextLength: {
+                    type: 'number',
+                    default: 4000
+                },
+                maxAudioBytes: {
+                    type: 'number',
+                    default: 10485760
+                }
+            }
+        },
+        environment: [],
+        services: [],
+        database: null,
+        healthCheck: null
+    },
+    {
+        name: '@sidurijs/hands',
+        organType: 'hands',
+        version: '2.0.2',
+        displayName: 'Hands (MCP Tool Execution)',
+        description: 'Model Context Protocol tool management and cryptographically authorized action execution',
+        entrypoint: './dist/index.js',
+        factory: 'DefaultHandsOrgan',
+        configKey: 'hands',
+        configSchema: {
+            type: 'object',
+            properties: {
+                defaultTimeoutMs: {
+                    type: 'number',
+                    default: 10000
+                },
+                providers: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        required: ['serverName'],
+                        properties: {
+                            serverName: {
+                                type: 'string'
+                            },
+                            baseUrl: {
+                                type: 'string'
+                            },
+                            command: {
+                                type: 'string'
+                            },
+                            args: {
+                                type: 'array',
+                                items: {
+                                    type: 'string'
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        environment: [
+            {
+                name: 'ACTION_POLICY_SECRET',
+                required: false,
+                secret: true,
+                description: 'HMAC secret key for signing and verifying action execution capabilities (required in production)'
+            }
+        ],
+        services: [],
+        database: null,
+        healthCheck: 'probeHandsHealth'
+    },
+    {
+        name: '@sidurijs/knowledge',
+        organType: 'knowledge',
+        version: '2.0.6',
+        displayName: 'Knowledge (Sovereign Life DB & Knowledge Packs)',
+        description: 'Sovereign Life Database (finances, inventory, schedule, preferences) and portable E knowledge packs',
+        entrypoint: './dist/index.js',
+        factory: 'UnifiedKnowledgeOrgan',
+        configKey: 'knowledge',
+        configSchema: {
+            type: 'object',
+            properties: {
+                lifeDatabase: {
+                    type: 'boolean',
+                    default: true
+                },
+                dbPath: {
+                    type: 'string',
+                    default: 'siduri.sqlite'
+                },
+                provider: {
+                    type: 'string',
+                    enum: ['unified', 'e-knowledge', 'e-remote', 'e-hub', 'none'],
+                    default: 'unified'
+                },
+                pack: {
+                    type: 'object'
+                },
+                packPath: {
+                    type: 'string'
+                },
+                baseUrl: {
+                    type: 'string'
+                },
+                registryUrl: {
+                    type: 'string'
+                },
+                packId: {
+                    type: 'string'
+                },
+                timeoutMs: {
+                    type: 'number',
+                    default: 5000
+                },
+                preferredMode: {
+                    type: 'string',
+                    enum: ['lexical', 'semantic', 'hybrid'],
+                    default: 'lexical'
+                }
+            }
+        },
+        environment: [
+            {
+                name: 'SIDURI_KNOWLEDGE_PACK',
+                required: false,
+                secret: false,
+                description: 'Path to local E knowledge pack'
+            },
+            {
+                name: 'SIDURI_KNOWLEDGE_REGISTRY_URL',
+                required: false,
+                secret: false,
+                default: 'https://e.vxnus.xyz/api/v1/knowledge',
+                description: 'URL of the E Knowledge Hub registry'
+            }
+        ],
+        services: [
+            {
+                name: 'E Knowledge Hub',
+                kind: 'http_service',
+                optional: true
+            }
+        ],
+        database: {
+            engine: 'sqlite'
+        },
+        healthCheck: null
+    },
+    {
+        name: '@sidurijs/archive',
+        organType: 'archive',
+        version: '1.0.0',
+        displayName: 'Archive (Interaction Audit Ledger)',
+        description: 'Cold append-only interaction audit trail and FTS5 full-text search (RFC VX-26-13)',
+        entrypoint: './dist/index.js',
+        factory: 'SqliteArchiveLedger',
+        configKey: 'archive',
+        configSchema: {
+            type: 'object',
+            required: ['provider'],
+            properties: {
+                provider: {
+                    type: 'string',
+                    enum: ['sqlite']
+                },
+                databasePath: {
+                    type: 'string',
+                    default: 'siduri.sqlite'
+                }
+            }
+        },
+        environment: [],
+        services: [],
+        database: {
+            engine: 'sqlite'
+        },
+        healthCheck: null
+    },
+    {
+        name: '@sidurijs/observation',
+        organType: 'observation',
+        version: '2.0.1',
+        displayName: 'Observation (Screen Perception & Frame Ingest)',
+        description: 'Screen capture frame ingest, SHA-256 deduplication, and visual grounding for Eyes/Vision',
+        entrypoint: './dist/index.js',
+        factory: 'FixtureObservationOrgan',
+        configKey: 'observation',
+        configSchema: {
+            type: 'object',
+            properties: {}
+        },
+        environment: [],
+        services: [],
+        database: null,
+        healthCheck: null
+    },
+    {
+        name: '@sidurijs/vision',
+        organType: 'vision',
+        version: '2.0.1',
+        displayName: 'Vision (Visual Perception & OCR)',
+        description: 'Image inspection, cropping, and multi-pass OCR perception adapter',
+        entrypoint: './dist/index.js',
+        factory: 'OpenRouterVisionAdapter',
+        configKey: 'vision',
+        configSchema: {
+            type: 'object',
+            required: ['provider'],
+            properties: {
+                provider: {
+                    type: 'string',
+                    enum: ['openrouter', 'none']
+                },
+                model: {
+                    type: 'string',
+                    default: 'gpt-4-vision'
+                },
+                apiKey: {
+                    type: 'string'
+                },
+                baseUrl: {
+                    type: 'string'
+                }
+            }
+        },
+        environment: [
+            {
+                name: 'OPENROUTER_API_KEY',
+                required: false,
+                secret: true,
+                description: 'API key for vision model inference'
+            }
+        ],
+        services: [
+            {
+                name: 'Vision Inference API',
+                kind: 'http_service',
+                optional: false
+            }
+        ],
+        database: null,
+        healthCheck: 'probeVisionHealth'
+    },
+    {
+        name: '@sidurijs/voice',
+        organType: 'voice',
+        version: '2.0.2',
+        displayName: 'Voice (Speech Synthesis & Voice Conversion)',
+        description: 'Queued speech synthesis and audio rendering lifecycle adapter (VOICEVOX, RVC)',
+        entrypoint: './dist/index.js',
+        factory: 'VoicevoxAdapter',
+        configKey: 'voice',
+        configSchema: {
+            type: 'object',
+            required: ['provider'],
+            properties: {
+                provider: {
+                    type: 'string',
+                    enum: ['voicevox', 'edge-tts', 'kokoro', 'piper', 'none']
+                },
+                speakerId: {
+                    type: 'number',
+                    default: 1
+                },
+                baseUrl: {
+                    type: 'string',
+                    default: 'http://localhost:50021'
+                },
+                maxQueueDepth: {
+                    type: 'number',
+                    default: 50
+                },
+                rvc: {
+                    type: 'object',
+                    properties: {
+                        enabled: { type: 'boolean', default: false },
+                        serviceUrl: { type: 'string', default: 'http://localhost:50055' },
+                        modelName: { type: 'string' },
+                        modelPath: { type: 'string' },
+                        indexPath: { type: 'string' },
+                        pitchShift: { type: 'number', default: 0 },
+                        f0Method: { type: 'string', enum: ['rmvpe', 'pm', 'harvest', 'crepe'], default: 'rmvpe' },
+                        indexRate: { type: 'number', default: 0.75 }
+                    }
+                }
+            }
+        },
+        environment: [
+            {
+                name: 'VOICEVOX_URL',
+                required: false,
+                secret: false,
+                default: 'http://localhost:50021',
+                description: 'Base URL of the running VOICEVOX engine'
+            },
+            {
+                name: 'RVC_SERVICE_URL',
+                required: false,
+                secret: false,
+                default: 'http://localhost:50055',
+                description: 'Base URL of headless RVC voice conversion microservice'
+            }
+        ],
+        services: [
+            {
+                name: 'VOICEVOX Engine',
+                kind: 'http_service',
+                optional: false
+            },
+            {
+                name: 'RVC Headless Service',
+                kind: 'http_service',
+                optional: true
+            }
+        ],
+        database: null,
+        healthCheck: null
+    },
+    {
+        name: '@sidurijs/mouth',
+        organType: 'mouth',
+        version: '2.0.2',
+        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.d.ts

@@ -0,0 +1 @@
+export {};