@vxnus/siduri 0.0.7 → 0.0.9

package/README.md

@@ -8,9 +8,18 @@ Requires Node.js 20 or newer.
 npx @vxnus/siduri create my-companion
 ```
 
+## Prerequisites
+
+- **Node.js**: `v20.0.0` or newer
+- **LLM API Key**: e.g. `OPENROUTER_API_KEY` for Brain organ
+- **Optional Local Services**:
+  - **Docker**: For running local PostgreSQL database (`docker compose up -d` / `npm run services:up`) and/or VOICEVOX engine.
+  - *Non-Docker Alternatives*: Cloud databases (Supabase, Neon) or standalone [VOICEVOX Desktop App](https://voicevox.hiroshiba.jp/).
+
 ## Features
 
 - **Manifest-Driven Organ Discovery**: Dynamically discovers installed `@siduri-x/*` 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, external service checks, database health probes, and organ-specific assertions.
 - **Database Migrations (`siduri db push`)**: Inspects database-owning organs (such as `@siduri-x/memory`) and executes SQL migrations with SHA-256 integrity checksums.
@@ -23,7 +32,7 @@ npx @vxnus/siduri create my-companion
 npx @vxnus/siduri create [directory]
 ```
 
-The interactive wizard allows you to name your companion and select any combination of available `@siduri-x/*` organs. It generates:
+The interactive wizard allows you to name your companion, configure organ providers and models, and inspect Knowledge manifests. It generates:
 
 ```text
 my-companion/
@@ -32,6 +41,7 @@ my-companion/
 ├── siduri.schema.json    # Composed JSON Schema from organ manifests
 ├── .env.example          # Only environment variables required by selected organs
 ├── README.md             # Instance-specific guide
+├── docker-compose.yml    # Scaffolds PostgreSQL / VOICEVOX when selected
 └── src/
     └── index.js          # Direct runtime bootstrapping with explicit organ factories
 ```

package/dist/builtin-manifests.js

@@ -5,7 +5,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/behavior',
         organType: 'behavior',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Behavior (Active Self Directives)',
         description: 'Atomic directive state machine and personality projection compiler',
         entrypoint: './dist/index.js',
@@ -32,7 +32,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/body',
         organType: 'body',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Body (Live2D & Avatar State)',
         description: 'Renderer-agnostic avatar expression and embodiment event adapter',
         entrypoint: './dist/index.js',
@@ -60,7 +60,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/brain',
         organType: 'brain',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Brain (Cognition & Planning)',
         description: 'Provider-neutral LLM reasoning, response planning, and proposal generation',
         entrypoint: './dist/index.js',
@@ -116,7 +116,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/ear',
         organType: 'ear',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Ear (Perception Ingress)',
         description: 'Multi-modal sensory input ingestion, transcription bounds, and mime validation',
         entrypoint: './dist/index.js',
@@ -147,7 +147,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/hands',
         organType: 'hands',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Hands (MCP Tool Execution)',
         description: 'Model Context Protocol tool management and cryptographically authorized action execution',
         entrypoint: './dist/index.js',
@@ -201,7 +201,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/knowledge',
         organType: 'knowledge',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Knowledge (E-Compatible Cited Facts)',
         description: 'Factual context retrieval from local or hosted E Knowledge packs',
         entrypoint: './dist/index.js',
@@ -266,7 +266,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/memory',
         organType: 'memory',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Memory (PostgreSQL FTS Claims)',
         description: 'Relational semantic claims with Full-Text Search and companion isolation',
         entrypoint: './dist/index.js',
@@ -318,9 +318,9 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/observation',
         organType: 'observation',
-        version: '1.0.0',
-        displayName: 'Observation (Grounded Observation Ingestion)',
-        description: 'Cryptographically hashed video/image observation ingest and duplicate detection',
+        version: '1.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',
@@ -336,7 +336,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/vision',
         organType: 'vision',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Vision (Visual Perception & OCR)',
         description: 'Image inspection, cropping, and multi-pass OCR perception adapter',
         entrypoint: './dist/index.js',
@@ -383,7 +383,7 @@ exports.BUILTIN_ORGAN_MANIFESTS = [
     {
         name: '@siduri-x/voice',
         organType: 'voice',
-        version: '1.0.0',
+        version: '1.0.1',
         displayName: 'Voice (VOICEVOX Speech Synthesis)',
         description: 'Queued speech synthesis and audio rendering lifecycle adapter',
         entrypoint: './dist/index.js',

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

@@ -13,18 +13,18 @@ describe('Phase 5: Clean-Machine Distribution & E2E Integration Suite', () => {
     const tempPackDir = node_path_1.default.resolve(__dirname, '../temp-packs-e2e');
     const cleanMachineRoot = node_path_1.default.resolve(__dirname, '../temp-clean-machine-e2e');
     const ALL_CANONICAL_PACKAGES = [
-        { filter: '@siduri-x/core', tarName: 'siduri-x-core-1.0.0.tgz', isOrgan: false },
-        { filter: '@siduri-x/brain', tarName: 'siduri-x-brain-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/memory', tarName: 'siduri-x-memory-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/knowledge', tarName: 'siduri-x-knowledge-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/behavior', tarName: 'siduri-x-behavior-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/ear', tarName: 'siduri-x-ear-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/vision', tarName: 'siduri-x-vision-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/hands', tarName: 'siduri-x-hands-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/body', tarName: 'siduri-x-body-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/voice', tarName: 'siduri-x-voice-1.0.0.tgz', isOrgan: true },
-        { filter: '@siduri-x/observation', tarName: 'siduri-x-observation-1.0.0.tgz', isOrgan: true },
-        { filter: '@vxnus/siduri', tarName: 'vxnus-siduri-0.0.7.tgz', isOrgan: false },
+        { filter: '@siduri-x/core', tarName: 'siduri-x-core-1.0.1.tgz', isOrgan: false },
+        { filter: '@siduri-x/brain', tarName: 'siduri-x-brain-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/memory', tarName: 'siduri-x-memory-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/knowledge', tarName: 'siduri-x-knowledge-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/behavior', tarName: 'siduri-x-behavior-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/ear', tarName: 'siduri-x-ear-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/vision', tarName: 'siduri-x-vision-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/hands', tarName: 'siduri-x-hands-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/body', tarName: 'siduri-x-body-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/voice', tarName: 'siduri-x-voice-1.0.1.tgz', isOrgan: true },
+        { filter: '@siduri-x/observation', tarName: 'siduri-x-observation-1.0.1.tgz', isOrgan: true },
+        { filter: '@vxnus/siduri', tarName: 'vxnus-siduri-0.0.9.tgz', isOrgan: false },
     ];
     beforeAll(() => {
         // 1. Prepare clean directories

package/dist/configurators/behavior.d.ts

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

package/dist/configurators/behavior.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureBehavior = configureBehavior;
+const inquirer_1 = __importDefault(require("inquirer"));
+async function configureBehavior(_context) {
+    const { preset } = await inquirer_1.default.prompt({
+        type: 'list',
+        name: 'preset',
+        message: 'Personality projection preset:',
+        choices: [
+            { name: 'Calm & Precise (Default)', value: 'calm_precise' },
+            { name: 'Cheerful & Enthusiastic', value: 'cheerful' },
+            { name: 'Analytical & Methodical', value: 'analytical' },
+            { name: 'Custom Directive State Machine', value: 'custom' },
+        ],
+    });
+    const presetLabels = {
+        calm_precise: 'Calm & Precise',
+        cheerful: 'Cheerful & Enthusiastic',
+        analytical: 'Analytical & Methodical',
+        custom: 'Custom Directives',
+    };
+    return {
+        config: {
+            provider: 'active_self',
+            preset,
+        },
+        summary: {
+            Provider: 'Active Self Directives',
+            Preset: presetLabels[preset] || preset,
+        },
+    };
+}

package/dist/configurators/body.d.ts

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

package/dist/configurators/body.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureBody = configureBody;
+const inquirer_1 = __importDefault(require("inquirer"));
+async function configureBody(_context) {
+    const { provider } = await inquirer_1.default.prompt({
+        type: 'list',
+        name: 'provider',
+        message: 'Body avatar provider?',
+        choices: [
+            { name: 'Live2D Cubism (Interactive avatar motion & expression state)', value: 'live2d' },
+            { name: 'None (Headless / No visual body)', value: 'none' },
+        ],
+    });
+    if (provider === 'none') {
+        return {
+            config: { provider: 'none' },
+            summary: { Provider: 'None (Headless)' },
+        };
+    }
+    const { initialExpression } = await inquirer_1.default.prompt({
+        type: 'list',
+        name: 'initialExpression',
+        message: 'Initial avatar expression:',
+        choices: [
+            { name: 'Neutral', value: 'neutral' },
+            { name: 'Happy / Cheerful', value: 'happy' },
+            { name: 'Calm', value: 'calm' },
+        ],
+    });
+    return {
+        config: {
+            provider: 'live2d',
+            initialExpression,
+        },
+        summary: {
+            Provider: 'Live2D',
+            Expression: initialExpression,
+        },
+    };
+}

package/dist/configurators/brain.d.ts

@@ -0,0 +1,6 @@
+import { OrganConfiguratorContext, OrganConfigurationResult } from './types';
+import { ModelProvider } from '../providers/openrouter';
+export interface BrainConfiguratorOptions {
+    modelProvider?: ModelProvider;
+}
+export declare function configureBrain(_context: OrganConfiguratorContext, options?: BrainConfiguratorOptions): Promise<OrganConfigurationResult>;

package/dist/configurators/brain.js

@@ -0,0 +1,80 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureBrain = configureBrain;
+const inquirer_1 = __importDefault(require("inquirer"));
+const openrouter_1 = require("../providers/openrouter");
+async function configureBrain(_context, options = {}) {
+    const modelProvider = options.modelProvider || new openrouter_1.OpenRouterModelProvider();
+    while (true) {
+        const { provider } = await inquirer_1.default.prompt({
+            type: 'list',
+            name: 'provider',
+            message: 'Brain provider?',
+            choices: [
+                { name: 'OpenRouter (Managed Routing & Broad Model Access)', value: 'openrouter' },
+                { name: 'OpenAI-compatible / Custom endpoint (Ollama, vLLM, Azure, OpenAI)', value: 'openai-compatible' },
+            ],
+        });
+        if (provider === 'openrouter') {
+            const selection = await (0, openrouter_1.promptOpenRouterModelSelection)(modelProvider);
+            if (selection.type === 'switch_provider') {
+                continue;
+            }
+            if (selection.type === 'cancel') {
+                throw new Error('Brain configuration cancelled.');
+            }
+            const modelId = selection.modelId;
+            return {
+                config: {
+                    provider: 'openrouter',
+                    model: modelId,
+                    apiKeyEnv: 'OPENROUTER_API_KEY',
+                },
+                summary: {
+                    Provider: 'OpenRouter',
+                    Model: modelId,
+                },
+            };
+        }
+        if (provider === 'openai-compatible') {
+            const answers = await inquirer_1.default.prompt([
+                {
+                    type: 'input',
+                    name: 'baseUrl',
+                    message: 'Endpoint Base URL:',
+                    default: 'https://api.openai.com/v1',
+                    validate: (v) => v.trim().length > 0 || 'Base URL is required.',
+                },
+                {
+                    type: 'input',
+                    name: 'model',
+                    message: 'Model ID (e.g. gpt-4o, llama3, mistral):',
+                    default: 'gpt-4o',
+                    validate: (v) => v.trim().length > 0 || 'Model ID is required.',
+                },
+                {
+                    type: 'input',
+                    name: 'apiKeyEnv',
+                    message: 'API Key environment variable name:',
+                    default: 'OPENAI_COMPATIBLE_API_KEY',
+                },
+            ]);
+            return {
+                config: {
+                    provider: 'openai-compatible',
+                    model: answers.model.trim(),
+                    baseUrl: answers.baseUrl.trim(),
+                    apiKeyEnv: answers.apiKeyEnv.trim() || 'OPENAI_COMPATIBLE_API_KEY',
+                },
+                summary: {
+                    Provider: 'OpenAI-compatible',
+                    Model: answers.model.trim(),
+                    'Base URL': answers.baseUrl.trim(),
+                },
+            };
+        }
+    }
+}

package/dist/configurators/ear.d.ts

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

package/dist/configurators/ear.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureEar = configureEar;
+const inquirer_1 = __importDefault(require("inquirer"));
+async function configureEar(_context) {
+    const { defaultSource } = await inquirer_1.default.prompt({
+        type: 'list',
+        name: 'defaultSource',
+        message: 'Perception ingress channel:',
+        choices: [
+            { name: 'Text Chat (Standard multimodal chat ingress)', value: 'text_chat' },
+            { name: 'Audio Streaming Ingress', value: 'audio_stream' },
+        ],
+    });
+    return {
+        config: {
+            defaultSource,
+            maxTextLength: 4000,
+            maxAudioBytes: 10485760,
+        },
+        summary: {
+            'Default Ingress': defaultSource === 'text_chat' ? 'Text Chat' : 'Audio Stream',
+        },
+    };
+}

package/dist/configurators/hands.d.ts

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

package/dist/configurators/hands.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureHands = configureHands;
+const inquirer_1 = __importDefault(require("inquirer"));
+async function configureHands(_context) {
+    const { timeoutSeconds } = await inquirer_1.default.prompt({
+        type: 'input',
+        name: 'timeoutSeconds',
+        message: 'MCP Tool execution timeout (seconds):',
+        default: '10',
+        validate: (v) => (!isNaN(Number(v)) && Number(v) > 0) || 'Timeout must be a positive number.',
+    });
+    const timeoutMs = Math.round(Number(timeoutSeconds) * 1000);
+    return {
+        config: {
+            defaultTimeoutMs: timeoutMs,
+            providers: [],
+        },
+        summary: {
+            'Default Timeout': `${timeoutSeconds}s`,
+            'MCP Execution': 'Active Policy HMAC Protected',
+        },
+    };
+}

package/dist/configurators/index.d.ts

@@ -0,0 +1,23 @@
+import { OrganManifest } from '../manifest';
+import { OrganConfigurationResult } from './types';
+import { BrainConfiguratorOptions } from './brain';
+import { KnowledgeConfiguratorOptions } from './knowledge';
+export * from './types';
+export * from './brain';
+export * from './knowledge';
+export * from './memory';
+export * from './voice';
+export * from './body';
+export * from './hands';
+export * from './behavior';
+export * from './vision';
+export * from './ear';
+export * from './observation';
+export interface ConfigureOrganOptions {
+    brainOptions?: BrainConfiguratorOptions;
+    knowledgeOptions?: KnowledgeConfiguratorOptions;
+}
+export declare function configureOrgan(manifest: OrganManifest, context: {
+    companionName: string;
+    existingConfig?: Record<string, unknown>;
+}, options?: ConfigureOrganOptions): Promise<OrganConfigurationResult>;

package/dist/configurators/index.js

@@ -0,0 +1,74 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureOrgan = configureOrgan;
+const brain_1 = require("./brain");
+const knowledge_1 = require("./knowledge");
+const memory_1 = require("./memory");
+const voice_1 = require("./voice");
+const body_1 = require("./body");
+const hands_1 = require("./hands");
+const behavior_1 = require("./behavior");
+const vision_1 = require("./vision");
+const ear_1 = require("./ear");
+const observation_1 = require("./observation");
+__exportStar(require("./types"), exports);
+__exportStar(require("./brain"), exports);
+__exportStar(require("./knowledge"), exports);
+__exportStar(require("./memory"), exports);
+__exportStar(require("./voice"), exports);
+__exportStar(require("./body"), exports);
+__exportStar(require("./hands"), exports);
+__exportStar(require("./behavior"), exports);
+__exportStar(require("./vision"), exports);
+__exportStar(require("./ear"), exports);
+__exportStar(require("./observation"), exports);
+async function configureOrgan(manifest, context, options = {}) {
+    const ctx = {
+        companionName: context.companionName,
+        manifest,
+        existingConfig: context.existingConfig,
+    };
+    switch (manifest.organType) {
+        case 'brain':
+            return (0, brain_1.configureBrain)(ctx, options.brainOptions);
+        case 'knowledge':
+            return (0, knowledge_1.configureKnowledge)(ctx, options.knowledgeOptions);
+        case 'memory':
+            return (0, memory_1.configureMemory)(ctx);
+        case 'voice':
+            return (0, voice_1.configureVoice)(ctx);
+        case 'body':
+            return (0, body_1.configureBody)(ctx);
+        case 'hands':
+            return (0, hands_1.configureHands)(ctx);
+        case 'behavior':
+            return (0, behavior_1.configureBehavior)(ctx);
+        case 'vision':
+            return (0, vision_1.configureVision)(ctx);
+        case 'ear':
+            return (0, ear_1.configureEar)(ctx);
+        case 'observation':
+            return (0, observation_1.configureObservation)(ctx);
+        default:
+            return {
+                config: ctx.existingConfig || {},
+                summary: {
+                    Provider: manifest.displayName,
+                },
+            };
+    }
+}

package/dist/configurators/knowledge.d.ts

@@ -0,0 +1,6 @@
+import { OrganConfiguratorContext, OrganConfigurationResult } from './types';
+import { KnowledgeHubClient } from '../providers/knowledge-hub';
+export interface KnowledgeConfiguratorOptions {
+    client?: KnowledgeHubClient;
+}
+export declare function configureKnowledge(_context: OrganConfiguratorContext, options?: KnowledgeConfiguratorOptions): Promise<OrganConfigurationResult>;

package/dist/configurators/knowledge.js

@@ -0,0 +1,100 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureKnowledge = configureKnowledge;
+const inquirer_1 = __importDefault(require("inquirer"));
+const knowledge_hub_1 = require("../providers/knowledge-hub");
+async function configureKnowledge(_context, options = {}) {
+    const client = options.client || new knowledge_hub_1.KnowledgeHubClient();
+    const { source } = await inquirer_1.default.prompt({
+        type: 'list',
+        name: 'source',
+        message: 'Knowledge source?',
+        choices: [
+            { name: 'E Knowledge Hub (Search and attach remote factual pack)', value: 'e-hub' },
+            { name: 'Do not use knowledge', value: 'none' },
+        ],
+    });
+    if (source === 'none') {
+        return {
+            config: {
+                provider: 'none',
+            },
+            summary: {
+                Source: 'Do not use knowledge',
+            },
+        };
+    }
+    // E Knowledge Hub flow
+    while (true) {
+        const { packId } = await inquirer_1.default.prompt({
+            type: 'input',
+            name: 'packId',
+            message: 'Search E Knowledge Hub or enter package ID:',
+            default: '@vxnus/e-teyvat',
+            validate: (val) => val.trim().length > 0 || 'Please enter a package ID.',
+        });
+        const trimmedPackId = packId.trim();
+        let manifest;
+        try {
+            process.stdout.write('\u001b[2mSearching E Knowledge Hub...\u001b[0m');
+            manifest = await client.resolveProvider(trimmedPackId);
+            process.stdout.write('\r\u001b[32m✓\u001b[0m Checking provider manifest\n');
+        }
+        catch (err) {
+            process.stdout.write('\r\u001b[33m!\u001b[0m Provider resolution failed\n');
+            console.log(`\u001b[33mReason:\u001b[0m ${err.message}\n`);
+            const { failureAction } = await inquirer_1.default.prompt({
+                type: 'list',
+                name: 'failureAction',
+                message: 'What would you like to do?',
+                choices: [
+                    { name: 'Try again / Search another provider', value: 'retry' },
+                    { name: 'Do not use knowledge', value: 'skip' },
+                    { name: 'Cancel', value: 'cancel' },
+                ],
+            });
+            if (failureAction === 'retry') {
+                continue;
+            }
+            if (failureAction === 'skip') {
+                return {
+                    config: { provider: 'none' },
+                    summary: { Source: 'Do not use knowledge' },
+                };
+            }
+            throw new Error('Knowledge configuration cancelled.');
+        }
+        // Display provider summary
+        (0, knowledge_hub_1.displayKnowledgeProviderSummary)(manifest, trimmedPackId);
+        const { confirmProvider } = await inquirer_1.default.prompt({
+            type: 'list',
+            name: 'confirmProvider',
+            message: 'Use this knowledge provider?',
+            choices: [
+                { name: 'Yes, use this provider', value: 'yes' },
+                { name: 'Choose another provider', value: 'retry' },
+            ],
+        });
+        if (confirmProvider === 'yes') {
+            return {
+                config: {
+                    provider: 'e-hub',
+                    registryUrl: 'https://e.vxnus.xyz/api/v1/knowledge',
+                    packId: trimmedPackId,
+                },
+                summary: {
+                    Source: 'E Knowledge Hub',
+                    Provider: manifest.displayName || manifest.name,
+                    Package: trimmedPackId,
+                    Version: manifest.version,
+                },
+                metadata: {
+                    manifest,
+                },
+            };
+        }
+    }
+}

package/dist/configurators/memory.d.ts

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