@vxnus/siduri 0.0.1 → 0.0.3

package/README.md

@@ -2,12 +2,45 @@
 
 Experimental CLI for creating and configuring Siduri companions.
 
+Requires Node.js 20 or newer.
+
 ```bash
-npx @vxnus/siduri@0.0.1 create
+npx @vxnus/siduri@0.0.3 create
 ```
 
+The companion name becomes the project directory. For example, answering
+`Ganyu` creates `./ganyu/siduri.config.json` from the current directory.
+
 The wizard configures the required Brain and Memory organs, then lets you
 enable or disable Voice, Knowledge, Behavior, Body, and Vision. Knowledge can
 come from an installed E pack, an E Hub distribution, or a hosted provider.
 
+Brain providers:
+
+- **OpenRouter** — managed model routing using `OPENROUTER_API_KEY`.
+- **OpenAI-compatible API** — a custom `baseUrl`, model ID, and API-key
+  environment variable.
+
+Memory currently uses PostgreSQL. The wizard lets you choose Local PostgreSQL,
+Neon, Supabase, or another PostgreSQL provider; all use `DATABASE_URL`. SQLite
+is shown as a future option but is not selectable in this release.
+
+The wizard creates a project directory from the companion name, writes
+`siduri.config.json`, copies the Siduri runtime, and installs the runtime
+dependencies. API keys are never written to the configuration file. Optional
+organs can be configured as `{ "provider": "none" }`; Brain and Memory remain
+required.
+
+After setup, start the generated instance with:
+
+```bash
+cd ganyu
+npm run start
+```
+
+For local development, build the CLI from the repository root with
+`pnpm --filter @vxnus/siduri build`. For the full architecture, see the
+[CLI documentation](../docs/cli.md) and
+[configuration reference](../docs/configuration.md).
+
 This release is experimental and is not intended for production use.

package/dist/index.js

@@ -14,7 +14,16 @@ const inquirer_1 = __importDefault(require("inquirer"));
 const e_knowledge_1 = require("@vxnus/e-knowledge");
 const execFile = (0, node_util_1.promisify)(node_child_process_1.execFile);
 const DEFAULT_REGISTRY_URL = 'https://e.vxnus.xyz/api/packs';
-const CLI_VERSION = '0.0.1';
+const CLI_VERSION = '0.0.3';
+const RUNTIME_DEPENDENCIES = {
+    '@vxnus/e': '^0.1.3',
+    '@vxnus/e-knowledge': '^0.1.2',
+    cors: '^2.8.5',
+    express: '^4.18.2',
+    pg: '^8.23.0',
+    ws: '^8.21.3',
+    zod: '^4.4.3',
+};
 const colors = {
     cyan: '\u001b[36m',
     dim: '\u001b[2m',
@@ -24,7 +33,7 @@ const colors = {
 };
 function printHeader() {
     console.log(`\n${colors.cyan}◈ SIDURI${colors.reset} ${colors.dim}companion setup${colors.reset}`);
-    console.log(`${colors.yellow}Experimental release 0.0.1${colors.reset} · configuration may change\n`);
+    console.log(`${colors.yellow}Experimental release 0.0.3${colors.reset} · configuration may change\n`);
 }
 function printSection(title) {
     console.log(`\n${colors.cyan}── ${title} ${'─'.repeat(Math.max(2, 42 - title.length))}${colors.reset}`);
@@ -32,6 +41,36 @@ function printSection(title) {
 function printSuccess(message) {
     console.log(`${colors.green}✓${colors.reset} ${message}`);
 }
+function runtimePath() {
+    const projectRuntime = node_path_1.default.join(process.cwd(), 'siduri-runtime.js');
+    return node_path_1.default.resolve(pathExists(projectRuntime) ? projectRuntime : node_path_1.default.join(__dirname, 'runtime.js'));
+}
+function pathExists(filePath) {
+    try {
+        require('node:fs').accessSync(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function startRuntime() {
+    const filePath = runtimePath();
+    if (!pathExists(filePath)) {
+        throw new Error('Siduri runtime bundle is missing. Reinstall the CLI or rebuild the package.');
+    }
+    await new Promise((resolve, reject) => {
+        const child = (0, node_child_process_1.spawn)(process.execPath, [filePath], { stdio: 'inherit', env: process.env });
+        child.once('error', reject);
+        child.once('exit', (code, signal) => {
+            if (signal)
+                process.exitCode = 1;
+            else if (code !== null)
+                process.exitCode = code;
+            resolve();
+        });
+    });
+}
 async function withTask(label, task) {
     process.stdout.write(`${colors.dim}${label}${colors.reset}`);
     const frames = ['·', '•', '●', '•'];
@@ -66,6 +105,14 @@ function urlValue(value) {
 function safePart(value) {
     return value.replace(/[^a-zA-Z0-9._-]/g, '_');
 }
+function projectDirectoryName(value) {
+    const slug = value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return slug || 'siduri';
+}
 async function getJson(url) {
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), 15000);
@@ -232,9 +279,14 @@ async function main() {
         console.log(CLI_VERSION);
         return;
     }
+    if (command === 'start') {
+        await startRuntime();
+        return;
+    }
     if (command !== 'create') {
         printHeader();
         console.log('Usage: npx @vxnus/siduri create');
+        console.log('       npx @vxnus/siduri start');
         console.log('       npx @vxnus/siduri --version');
         return;
     }
@@ -242,9 +294,30 @@ async function main() {
     printSection('Companion');
     const answers = await inquirer_1.default.prompt([
         { type: 'input', name: 'name', message: 'Companion name:', default: 'Siduri', validate: nonEmpty },
-        { type: 'list', name: 'memory', message: 'Memory provider?', choices: [{ name: 'PostgreSQL', value: 'postgres' }] },
+        {
+            type: 'list',
+            name: 'memoryEngine',
+            message: 'Memory database?',
+            choices: [
+                { name: 'PostgreSQL', value: 'postgres' },
+                { name: 'SQLite (future)', value: 'sqlite', disabled: 'Coming soon' },
+            ],
+        },
     ]);
-    printSuccess(`${answers.name} · PostgreSQL memory`);
+    const { memoryDeployment } = await inquirer_1.default.prompt({
+        type: 'list',
+        name: 'memoryDeployment',
+        message: 'PostgreSQL deployment?',
+        choices: [
+            { name: 'Local PostgreSQL', value: 'local' },
+            { name: 'Neon', value: 'neon' },
+            { name: 'Supabase', value: 'supabase' },
+            { name: 'Other PostgreSQL provider', value: 'other' },
+        ],
+    });
+    const projectPath = node_path_1.default.resolve(process.cwd(), projectDirectoryName(answers.name));
+    await (0, promises_1.mkdir)(projectPath, { recursive: true });
+    printSuccess(`${answers.name} · PostgreSQL / ${memoryDeployment} · ${projectPath}`);
     printSection('Brain · required');
     const { brainProvider } = await inquirer_1.default.prompt({
         type: 'list',
@@ -291,13 +364,13 @@ async function main() {
         name: answers.name,
         brain,
         voice: { provider: voice, speakerId: 1 },
-        memory: { provider: answers.memory },
+        memory: { provider: answers.memoryEngine, deployment: memoryDeployment },
         knowledge,
         behavior: { provider: remaining.behavior === 'none' ? 'none' : 'active_self', preset: remaining.behavior },
         body: { provider: remaining.body, vtsUrl: process.env.VTS_URL || 'ws://127.0.0.1:8001' },
         vision: { provider: remaining.vision, model: 'gpt-4-vision' },
     };
-    const configPath = node_path_1.default.join(process.cwd(), 'siduri.config.json');
+    const configPath = node_path_1.default.join(projectPath, 'siduri.config.json');
     try {
         await (0, promises_1.readFile)(configPath, 'utf8');
         const { overwrite } = await inquirer_1.default.prompt({
@@ -335,7 +408,25 @@ async function main() {
     }
     await (0, promises_1.writeFile)(configPath, JSON.stringify(config, null, 2) + '\n', { mode: 0o600 });
     printSuccess(`Configuration written · ${configPath}`);
-    console.log(`${colors.dim}Next: start Siduri with pnpm --filter @siduri-y/api dev${colors.reset}\n`);
+    await (0, promises_1.cp)(node_path_1.default.join(__dirname, 'runtime.js'), node_path_1.default.join(projectPath, 'siduri-runtime.js'));
+    await (0, promises_1.writeFile)(node_path_1.default.join(projectPath, 'package.json'), JSON.stringify({
+        name: projectDirectoryName(answers.name),
+        private: true,
+        version: '0.0.0',
+        scripts: { start: 'node siduri-runtime.js', dev: 'node siduri-runtime.js' },
+        dependencies: RUNTIME_DEPENDENCIES,
+    }, null, 2) + '\n', { mode: 0o600 });
+    const keyEnv = config.brain.apiKeyEnv || 'OPENROUTER_API_KEY';
+    await (0, promises_1.writeFile)(node_path_1.default.join(projectPath, '.env.example'), [
+        `${keyEnv}=`,
+        'DATABASE_URL=postgresql://postgres:postgres@localhost:5432/siduri',
+        'VTS_URL=ws://127.0.0.1:8001',
+        'VTS_AUTH_TOKEN=',
+        '',
+    ].join('\n'), { mode: 0o600 });
+    await withTask('Installing Siduri runtime dependencies', () => execFile('npm', ['install', '--no-audit', '--no-fund'], { cwd: projectPath }).then(() => undefined));
+    printSuccess(`Siduri instance ready · ${projectPath}`);
+    console.log(`${colors.dim}Next: cd ${projectDirectoryName(answers.name)} && npm run start${colors.reset}\n`);
 }
 main().catch((error) => {
     if (error && typeof error === 'object' && 'name' in error && error.name === 'ExitPromptError') {