twinclaw 1.1.8 → 1.2.0

package/dist/core/cli.js

@@ -164,15 +164,34 @@ export const handleVersionCli = async (argv) => {
 };
 /**
  * Handle the `start` command.
- * Starts the gateway.
+ * Starts the gateway in a new terminal window.
  */
 export const handleStartCli = async (argv, isChatMode = false) => {
-    // We return 0 to tell main() to continue with the startup flow
-    // If we wanted to start JUST the gateway and exit, we'd do something else
-    // But here, 'start' means 'run the app'.
     if (isChatMode) {
         global.TWINCLAW_CHAT_MODE = true;
     }
+    if (process.platform === 'win32') {
+        const { spawn } = await import('node:child_process');
+        console.log('[TwinClaw] Starting gateway in new window...');
+        const entryScript = process.execPath;
+        const appPath = process.argv[1] || process.argv[0];
+        const args = [
+            '/c',
+            'start',
+            '""',
+            'cmd.exe',
+            '/k',
+            `"${entryScript}" chat`
+        ];
+        spawn('cmd.exe', args, {
+            detached: true,
+            stdio: 'ignore',
+            windowsHide: false,
+        });
+        console.log('[TwinClaw] Gateway started in new terminal window.');
+        console.log('[TwinClaw] You can now use this terminal for other commands.');
+        return 0;
+    }
     return 0;
 };
 /**

package/dist/core/onboarding.js

@@ -45,7 +45,12 @@ const WIZARD_SECTIONS = [
     {
         id: 'models',
         label: 'STEP 3: AI Models',
-        fields: ['OPENROUTER_API_KEY', 'MODAL_API_KEY', 'GEMINI_API_KEY', 'GROQ_API_KEY'],
+        fields: ['OPENROUTER_API_KEY', 'MODAL_API_KEY', 'GEMINI_API_KEY', 'GROQ_API_KEY', 'GITHUB_TOKEN'],
+    },
+    {
+        id: 'model_selection',
+        label: 'STEP 4: Select Models',
+        fields: ['SELECT_MODELS'],
     },
 ];
 const EMBEDDING_PROVIDERS = new Set(['openai', 'ollama']);
@@ -767,6 +772,17 @@ async function collectInteractiveUpdates(existing, logger, prompter) {
                 candidate = applyUpdates(candidate, { [field.key]: nextValue });
             }
         }
+        if (section.id === 'model_selection') {
+            // Special logic to ensure model selection was actually handled if skipped in loop
+            if (!updates['SELECT_MODELS']) {
+                const field = ONBOARD_FIELDS.find(f => f.key === 'SELECT_MODELS');
+                const nextValue = await promptFieldValue(field, '', prompter, logger);
+                if (nextValue) {
+                    updates['SELECT_MODELS'] = nextValue;
+                    candidate = applyUpdates(candidate, { 'SELECT_MODELS': nextValue });
+                }
+            }
+        }
         if (section.id === 'models' && !hasAnyModelKey(candidate)) {
             logger.warn('\nAt least one model API key is required (OpenRouter, Modal, Gemini).');
             // Force retry this section
@@ -871,9 +887,9 @@ function printWarnings(warnings, logger) {
 }
 function printNextActions(logger) {
     logger.log('\nNext actions:');
-    logger.log('  1. node src/index.ts doctor');
-    logger.log('  2. node src/index.ts channels login whatsapp');
-    logger.log('  3. node src/index.ts pairing approve <channel> <CODE>');
+    logger.log('  1. twinclaw doctor');
+    logger.log('  2. twinclaw channels login whatsapp');
+    logger.log('  3. twinclaw pairing approve <channel> <CODE>');
 }
 export function parseOnboardArgs(args) {
     const parsed = {

package/dist/core/persona-cli.js

@@ -0,0 +1,78 @@
+import { getPersonaStateService } from '../services/persona-state.js';
+import { formatHelp } from './help-formatter.js';
+/**
+ * Handle 'persona' command.
+ * Allows viewing and updating the agent's soul, identity, and user context.
+ */
+export const handlePersonaCli = async (argv) => {
+    const service = getPersonaStateService();
+    const subcommand = argv[1];
+    if (!subcommand || subcommand === 'show' || subcommand === 'view') {
+        const state = await service.getState();
+        console.log(', TwinClaw, Persona, State, ');, console.log('──────────────────────────────────────────────────'));
+        console.log(`Revision: ${state.revision}`);
+        console.log(`Updated:  ${state.updatedAt}`);
+        console.log(', -- - SOUL-- - ');, console.log(state.soul || '(empty)'));
+        console.log(', -- - IDENTITY-- - ');, console.log(state.identity || '(empty)'));
+        console.log(', -- - USER, CONTEXT-- - ');, console.log(state.user || '(empty)'));
+        return 0;
+    }
+    if (subcommand === 'edit' || subcommand === 'update') {
+        const key = argv[2];
+        if (!['soul', 'identity', 'user'].includes(key)) {
+            console.error('Invalid document key. Use: soul, identity, or user.');
+            return 1;
+        }
+        const newContent = argv.slice(3).join(' ');
+        if (!newContent) {
+            console.error(`Please provide the new content for ${key}.`);
+            console.log(`Usage: twinclaw persona edit ${key} "your content here"`);
+            return 1;
+        }
+        try {
+            const currentState = await service.getState();
+            const result = await service.updateState({
+                expectedRevision: currentState.revision,
+                [key]: newContent,
+                // Keep other fields as is
+                soul: key === 'soul' ? newContent : currentState.soul,
+                identity: key === 'identity' ? newContent : currentState.identity,
+                user: key === 'user' ? newContent : currentState.user,
+            });
+            console.log(`✅ Successfully updated ${key}.`);
+            console.log(`New revision: ${result.state.revision}`);
+            return 0;
+        }
+        catch (err) {
+            console.error(`❌ Failed to update persona: ${err instanceof Error ? err.message : String(err)}`);
+            return 1;
+        }
+    }
+    if (subcommand === 'help' || argv.includes('--help') || argv.includes('-h')) {
+        console.log(formatHelp({
+            command: 'persona',
+            description: "View or modify the agent's core persona (soul, identity, user context).",
+            usage: 'twinclaw persona [subcommand] [args]',
+            sections: [
+                {
+                    title: 'Subcommands',
+                    content: {
+                        'show, view': 'Display current persona state (default)',
+                        'edit, update': 'Update a specific part of the persona'
+                    }
+                },
+                {
+                    title: 'Update Usage',
+                    content: {
+                        'twinclaw persona edit soul "text"': 'Update the agent soul',
+                        'twinclaw persona edit identity "text"': 'Update agent identity',
+                        'twinclaw persona edit user "text"': 'Update user context'
+                    }
+                }
+            ]
+        }));
+        return 0;
+    }
+    console.error(`Unknown persona subcommand: ${subcommand}`);
+    return 1;
+};

package/dist/services/model-router.js

@@ -980,8 +980,23 @@ export class ModelRouter {
         this.metrics.lastError = scrubSensitiveText(message);
         this.metrics.lastFailureAt = new Date(this.nowFn()).toISOString();
     }
+    getApiKeyEnvName(provider) {
+        const providerKeyMap = {
+            'openai': 'OPENAI_API_KEY',
+            'anthropic': 'ANTHROPIC_API_KEY',
+            'google': 'GEMINI_API_KEY',
+            'openrouter': 'OPENROUTER_API_KEY',
+            'groq': 'GROQ_API_KEY',
+            'modal': 'MODAL_API_KEY',
+            'copilot': 'GITHUB_TOKEN',
+            'github': 'GITHUB_TOKEN',
+            'ollama': 'OLLAMA_API_KEY',
+        };
+        return providerKeyMap[provider.toLowerCase()] || 'MODAL_API_KEY';
+    }
     loadModelsFromConfig() {
         const configModels = [];
+        // Check if PRIMARY_MODEL is set - use config.models.primaryModel if available
         const primaryModelId = getConfigValue('PRIMARY_MODEL');
         const modalApiKey = getConfigValue('MODAL_API_KEY');
         const openRouterApiKey = getConfigValue('OPENROUTER_API_KEY');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twinclaw",
-  "version": "1.1.8",
+  "version": "1.2.0",
   "description": "Eagle-eyed agentic AI gateway with multi-modal hooks and proactive memory.",
   "main": "dist/index.js",
   "bin": {