@clawnch/clawtomaton 0.2.0 → 0.2.2

package/dist/skills/conway.js

@@ -1,23 +1,30 @@
 /**
- * Skill: conway — Conway Terminal integration for sandboxes, domains, and compute.
+ * Skill: conway — Full Conway Terminal integration.
  *
- * Conway Terminal provides:
- *   - Cloud sandboxes (Linux VMs via Firecracker microVMs)
- *   - Domain registration and DNS management
- *   - x402 payment protocol for domain purchases
+ * Covers all Conway Terminal v2.0.9 MCP tools:
+ *   - Sandbox lifecycle (create, list, get, delete)
+ *   - Sandbox execution (exec, write_file, read_file)
+ *   - Sandbox networking (expose_port, list_ports, remove_port, get_url)
+ *   - Sandbox custom domains (add_domain, list_domains, remove_domain)
+ *   - Sandbox monitoring (terminal_session, metrics, activity, commands)
+ *   - PTY sessions (create, write, read, close, resize, list)
+ *   - Wallet & x402 payments (wallet_info, wallet_networks, x402_discover, x402_check, x402_fetch)
+ *   - Domain registration & DNS (search, list, info, register, renew, dns_*, pricing, check, privacy, nameservers)
+ *   - Credits & billing (balance, history, pricing, topup)
+ *   - Inference (chat_completions)
  *
  * Authentication:
- *   - Sandbox/Cloud API: CONWAY_API_KEY (from ~/.conway/config.json or env)
- *   - Domain API: SIWE via conway-terminal wallet (~/. conway/wallet.json)
+ *   - Sandbox/Cloud/Credits/Inference API: CONWAY_API_KEY (from ~/.conway/config.json or env)
+ *   - Domain API: SIWE via conway-terminal wallet (~/.conway/wallet.json)
+ *   - x402 payments: via conway-terminal wallet + x402 protocol
  *
  * This is optional infrastructure — agents don't need it to function,
- * but it lets them build real web presence and run compute.
- */
-const CONWAY_API_URL = 'https://api.conway.tech';
-const CONWAY_DOMAIN_API_URL = 'https://api.conway.domains';
-/**
- * Make an authenticated request to the Conway Cloud/Sandbox API.
+ * but it lets them build real web presence, run compute, and pay for services.
  */
+const CONWAY_API_URL = process.env.CONWAY_API_URL || 'https://api.conway.tech';
+const CONWAY_DOMAIN_API_URL = process.env.CONWAY_DOMAIN_API_URL || 'https://api.conway.domains';
+const CONWAY_PREVIEW_DOMAIN = process.env.CONWAY_PREVIEW_DOMAIN || 'life.conway.tech';
+// ─── Conway Cloud/Sandbox API ────────────────────────────────────────────────
 async function conwayApiRequest(apiKey, method, path, body) {
     const response = await fetch(`${CONWAY_API_URL}${path}`, {
         method,
@@ -33,12 +40,17 @@ async function conwayApiRequest(apiKey, method, path, body) {
     }
     return response.json();
 }
+// ─── Conway Domain API (SIWE auth) ──────────────────────────────────────────
+let domainJwt = null;
+let domainJwtExpiry = 0;
 /**
- * Authenticate with the Conway Domain API via SIWE and make a request.
- * Requires conway-terminal's wallet functions for SIWE signing.
+ * Get a JWT for the Conway Domain API via SIWE auth.
+ * Caches the token for 50 minutes (tokens expire at 60).
  */
-async function conwayDomainRequest(method, path, body) {
-    // Domain API requires SIWE auth via conway-terminal wallet
+async function getDomainJwt() {
+    if (domainJwt && Date.now() < domainJwtExpiry) {
+        return domainJwt;
+    }
     let conway;
     try {
         // @ts-ignore — conway-terminal is an optional dependency
@@ -48,14 +60,13 @@ async function conwayDomainRequest(method, path, body) {
         throw new Error('conway-terminal package not installed. Run: npm install conway-terminal\n' +
             'Then run: npx conway-terminal --init   to create wallet + API key');
     }
-    // Get or create Conway wallet
     const { account } = await conway.getWallet();
-    // SIWE auth flow: nonce → sign → verify → JWT
+    // 1. Get nonce
     const nonceResp = await fetch(`${CONWAY_DOMAIN_API_URL}/auth/nonce`, { method: 'POST' });
     if (!nonceResp.ok)
         throw new Error(`Domain auth: failed to get nonce (${nonceResp.status})`);
     const { nonce } = (await nonceResp.json());
-    // Dynamic import siwe (conway-terminal bundles it)
+    // 2. Sign SIWE message
     // @ts-expect-error — siwe is a transitive dependency of conway-terminal
     const { SiweMessage } = await import('siwe');
     const url = new URL(CONWAY_DOMAIN_API_URL);
@@ -71,6 +82,7 @@ async function conwayDomainRequest(method, path, body) {
     });
     const messageString = siweMessage.prepareMessage();
     const signature = await account.signMessage({ message: messageString });
+    // 3. Verify → get JWT
     const verifyResp = await fetch(`${CONWAY_DOMAIN_API_URL}/auth/verify`, {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
@@ -81,11 +93,16 @@ async function conwayDomainRequest(method, path, body) {
     const { access_token } = (await verifyResp.json());
     if (!access_token)
         throw new Error('Domain auth: no access token returned');
-    // Make the actual domain API request
+    domainJwt = access_token;
+    domainJwtExpiry = Date.now() + 50 * 60 * 1000;
+    return access_token;
+}
+async function conwayDomainRequest(method, path, body) {
+    const jwt = await getDomainJwt();
     const response = await fetch(`${CONWAY_DOMAIN_API_URL}${path}`, {
         method,
         headers: {
-            Authorization: `Bearer ${access_token}`,
+            Authorization: `Bearer ${jwt}`,
             'Content-Type': 'application/json',
         },
         body: body ? JSON.stringify(body) : undefined,
@@ -96,35 +113,154 @@ async function conwayDomainRequest(method, path, body) {
     }
     return response.json();
 }
+// ─── x402 helpers ────────────────────────────────────────────────────────────
+async function getConwayModule() {
+    try {
+        // @ts-ignore — conway-terminal is an optional dependency
+        return await import('conway-terminal');
+    }
+    catch {
+        throw new Error('conway-terminal package not installed. Run: npm install conway-terminal\n' +
+            'Then run: npx conway-terminal --init   to create wallet + API key');
+    }
+}
+async function x402DomainFetch(path, method, body) {
+    const conway = await getConwayModule();
+    const { account } = await conway.getWallet();
+    const jwt = await getDomainJwt();
+    const url = `${CONWAY_DOMAIN_API_URL}${path}`;
+    const response = await conway.x402Fetch(account, url, {
+        method,
+        headers: {
+            Authorization: `Bearer ${jwt}`,
+            'Content-Type': 'application/json',
+        },
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    const data = await response.json();
+    return data;
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function json(data) {
+    return JSON.stringify(data, null, 2);
+}
+function ok(data) {
+    return { callId: '', success: true, result: json(data) };
+}
+function fail(error) {
+    return { callId: '', success: false, result: null, error };
+}
+function requireApiKey() {
+    const apiKey = process.env.CONWAY_API_KEY;
+    if (!apiKey) {
+        throw new Error('CONWAY_API_KEY not set. Get one at https://app.conway.tech or run: npx conway-terminal --provision');
+    }
+    return apiKey;
+}
+function requireParam(params, name) {
+    const val = params[name];
+    if (!val && val !== 0)
+        throw new Error(`Required parameter "${name}" is missing`);
+    return String(val);
+}
+// ─── All actions by category ─────────────────────────────────────────────────
+const ALL_ACTIONS = [
+    // Sandbox lifecycle
+    'sandbox_create', 'sandbox_list', 'sandbox_get', 'sandbox_delete',
+    // Sandbox execution
+    'sandbox_exec', 'sandbox_write_file', 'sandbox_read_file',
+    // Sandbox networking
+    'sandbox_expose_port', 'sandbox_list_ports', 'sandbox_remove_port', 'sandbox_get_url',
+    // Sandbox custom domains
+    'sandbox_add_domain', 'sandbox_list_domains', 'sandbox_remove_domain',
+    // Sandbox monitoring
+    'sandbox_terminal_session', 'sandbox_metrics', 'sandbox_activity', 'sandbox_commands',
+    // PTY sessions
+    'sandbox_pty_create', 'sandbox_pty_write', 'sandbox_pty_read',
+    'sandbox_pty_close', 'sandbox_pty_resize', 'sandbox_pty_list',
+    // Wallet & x402
+    'wallet_info', 'wallet_networks', 'x402_discover', 'x402_check', 'x402_fetch',
+    // Domains
+    'domain_search', 'domain_list', 'domain_info', 'domain_register', 'domain_renew',
+    'domain_dns_list', 'domain_dns_add', 'domain_dns_update', 'domain_dns_delete',
+    'domain_pricing', 'domain_check', 'domain_privacy', 'domain_nameservers',
+    // Credits
+    'credits_balance', 'credits_history', 'credits_pricing', 'credits_topup',
+    // Inference
+    'chat_completions',
+];
+// ─── Skill definition ────────────────────────────────────────────────────────
 export const conwaySkill = {
     name: 'conway',
-    description: 'Conway Terminal: manage cloud sandboxes (Linux VMs), search/register domains, manage DNS. ' +
-        'Sandbox actions need CONWAY_API_KEY. Domain actions need conway-terminal package installed.',
+    description: 'Conway Terminal: full cloud infrastructure, compute, wallet, payments, domains, and deployment. ' +
+        'Sandbox actions (sandbox_*) need CONWAY_API_KEY. Domain actions (domain_*) need conway-terminal installed. ' +
+        'Wallet/x402 actions need conway-terminal installed. Credits actions need CONWAY_API_KEY. ' +
+        `Actions: ${ALL_ACTIONS.join(', ')}.`,
     parameters: [
         {
             name: 'action',
             type: 'string',
-            description: 'Action: "sandbox_create", "sandbox_list", "sandbox_exec", "sandbox_delete", ' +
-                '"domain_search", "domain_register", "domain_list", "domain_info", ' +
-                '"domain_dns_list", "domain_dns_add", "domain_check", "credits_balance".',
+            description: `Action to perform. One of: ${ALL_ACTIONS.join(', ')}.`,
             required: true,
         },
         {
             name: 'sandbox_id',
             type: 'string',
-            description: 'Sandbox ID (32-char hex). Required for sandbox_exec, sandbox_delete.',
+            description: 'Sandbox ID (32-char hex). Required for most sandbox_* and sandbox_pty_* actions.',
+            required: false,
+        },
+        {
+            name: 'session_id',
+            type: 'string',
+            description: 'PTY session ID. Required for sandbox_pty_write, sandbox_pty_read, sandbox_pty_close, sandbox_pty_resize.',
             required: false,
         },
         {
             name: 'command',
             type: 'string',
-            description: 'Shell command (for sandbox_exec).',
+            description: 'Shell command (for sandbox_exec) or PTY command (for sandbox_pty_create, e.g. "bash", "python3").',
+            required: false,
+        },
+        {
+            name: 'path',
+            type: 'string',
+            description: 'Absolute file path in sandbox (for sandbox_write_file, sandbox_read_file).',
+            required: false,
+        },
+        {
+            name: 'content',
+            type: 'string',
+            description: 'File content (for sandbox_write_file). Text or base64-encoded binary.',
+            required: false,
+        },
+        {
+            name: 'encoding',
+            type: 'string',
+            description: 'Content encoding for sandbox_write_file: omit for text, "base64" for binary.',
+            required: false,
+        },
+        {
+            name: 'port',
+            type: 'string',
+            description: 'Port number (for sandbox_expose_port, sandbox_remove_port, sandbox_get_url).',
+            required: false,
+        },
+        {
+            name: 'visibility',
+            type: 'string',
+            description: 'Port visibility for sandbox_expose_port: "public" or "private" (default: "public").',
+            required: false,
+        },
+        {
+            name: 'subdomain',
+            type: 'string',
+            description: 'Custom subdomain for sandbox_expose_port (e.g. "my-app" -> my-app.life.conway.tech).',
             required: false,
         },
         {
             name: 'domain',
             type: 'string',
-            description: 'Domain name (for domain actions).',
+            description: 'Domain name (for domain_* actions and sandbox_add_domain/sandbox_remove_domain).',
             required: false,
         },
         {
@@ -133,140 +269,551 @@ export const conwaySkill = {
             description: 'Search keyword (for domain_search).',
             required: false,
         },
+        {
+            name: 'tlds',
+            type: 'string',
+            description: 'Comma-separated TLDs for domain_search or domain_pricing (e.g. "com,io,ai").',
+            required: false,
+        },
+        {
+            name: 'domains',
+            type: 'string',
+            description: 'Comma-separated domain names for domain_check (e.g. "example.com,test.io").',
+            required: false,
+        },
+        {
+            name: 'years',
+            type: 'string',
+            description: 'Registration/renewal period in years (1-10) for domain_register, domain_renew.',
+            required: false,
+        },
+        {
+            name: 'privacy',
+            type: 'string',
+            description: 'WHOIS privacy: "true" or "false" (for domain_register, domain_privacy).',
+            required: false,
+        },
+        {
+            name: 'nameservers',
+            type: 'string',
+            description: 'Comma-separated nameservers for domain_nameservers (e.g. "ns1.example.com,ns2.example.com").',
+            required: false,
+        },
+        {
+            name: 'record_id',
+            type: 'string',
+            description: 'DNS record ID (for domain_dns_update, domain_dns_delete).',
+            required: false,
+        },
         {
             name: 'spec',
             type: 'string',
-            description: 'JSON config for sandbox_create: {"name":"my-vm","vcpu":1,"memory_mb":512,"disk_gb":5,"region":"us-east"}. Or DNS record JSON for domain_dns_add: {"type":"A","name":"@","value":"1.2.3.4","ttl":3600}.',
+            description: 'JSON config. For sandbox_create: {"name":"my-vm","vcpu":1,"memory_mb":512,"disk_gb":5,"region":"us-east"}. ' +
+                'For domain_dns_add: {"type":"A","host":"@","value":"1.2.3.4","ttl":3600}. ' +
+                'For domain_dns_update: {"host":"www","value":"1.2.3.4","ttl":3600}. ' +
+                'For chat_completions: {"model":"gpt-4o","messages":[{"role":"user","content":"Hello"}],"temperature":1,"max_tokens":1000}.',
+            required: false,
+        },
+        {
+            name: 'url',
+            type: 'string',
+            description: 'URL (for x402_discover, x402_check, x402_fetch).',
+            required: false,
+        },
+        {
+            name: 'method',
+            type: 'string',
+            description: 'HTTP method for x402_fetch (default: "GET").',
+            required: false,
+        },
+        {
+            name: 'headers',
+            type: 'string',
+            description: 'JSON headers for x402_fetch (e.g. {"X-Custom":"value"}).',
+            required: false,
+        },
+        {
+            name: 'body',
+            type: 'string',
+            description: 'Request body for x402_fetch (POST/PUT/PATCH).',
+            required: false,
+        },
+        {
+            name: 'network',
+            type: 'string',
+            description: 'Network ID for wallet_info: "eip155:8453" (Base) or "eip155:84532" (Base Sepolia). Default: "eip155:8453".',
+            required: false,
+        },
+        {
+            name: 'amount_usd',
+            type: 'string',
+            description: 'Credit top-up amount in USD tier units for credits_topup. Valid tiers: 5, 25, 100, 500, 1000, 2500.',
+            required: false,
+        },
+        {
+            name: 'address',
+            type: 'string',
+            description: 'Wallet address to credit for credits_topup. Defaults to local wallet.',
+            required: false,
+        },
+        {
+            name: 'limit',
+            type: 'string',
+            description: 'Max entries to return (for credits_history, sandbox_activity, sandbox_commands).',
+            required: false,
+        },
+        {
+            name: 'offset',
+            type: 'string',
+            description: 'Pagination offset (for credits_history).',
+            required: false,
+        },
+        {
+            name: 'timeout',
+            type: 'string',
+            description: 'Timeout in seconds for sandbox_exec (default: 30).',
+            required: false,
+        },
+        {
+            name: 'cols',
+            type: 'string',
+            description: 'Terminal columns for sandbox_pty_create or sandbox_pty_resize (default: 80).',
+            required: false,
+        },
+        {
+            name: 'rows',
+            type: 'string',
+            description: 'Terminal rows for sandbox_pty_create or sandbox_pty_resize (default: 24).',
+            required: false,
+        },
+        {
+            name: 'input',
+            type: 'string',
+            description: 'Input to send to PTY session (for sandbox_pty_write). Use "\\n" for Enter.',
+            required: false,
+        },
+        {
+            name: 'full',
+            type: 'string',
+            description: 'If "true", return full scrollback buffer for sandbox_pty_read.',
             required: false,
         },
     ],
-    execute: async (params, _ctx) => {
+    execute: async (params) => {
         try {
             const action = params.action;
-            // --- Sandbox actions (use CONWAY_API_KEY) ---
-            if (action.startsWith('sandbox_') || action === 'credits_balance') {
-                const apiKey = process.env.CONWAY_API_KEY;
-                if (!apiKey) {
-                    return {
-                        callId: '',
-                        success: false,
-                        result: null,
-                        error: 'CONWAY_API_KEY not set. Get one at https://app.conway.tech or run: npx conway-terminal --init',
-                    };
+            // ─── Sandbox lifecycle ──────────────────────────────────────────
+            if (action === 'sandbox_create') {
+                const apiKey = requireApiKey();
+                const spec = params.spec ? JSON.parse(params.spec) : {};
+                const result = await conwayApiRequest(apiKey, 'POST', '/v1/sandboxes', {
+                    name: spec.name || `sandbox-${Date.now()}`,
+                    vcpu: spec.vcpu ?? 1,
+                    memory_mb: spec.memory_mb ?? 512,
+                    disk_gb: spec.disk_gb ?? 5,
+                    region: spec.region ?? 'eu-north',
+                });
+                return ok(result);
+            }
+            if (action === 'sandbox_list') {
+                const apiKey = requireApiKey();
+                const result = await conwayApiRequest(apiKey, 'GET', '/v1/sandboxes');
+                return ok(result);
+            }
+            if (action === 'sandbox_get') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const result = await conwayApiRequest(apiKey, 'GET', `/v1/sandboxes/${sandboxId}`);
+                return ok(result);
+            }
+            if (action === 'sandbox_delete') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                await conwayApiRequest(apiKey, 'DELETE', `/v1/sandboxes/${sandboxId}`);
+                return ok({ success: true, message: `Sandbox ${sandboxId} deleted` });
+            }
+            // ─── Sandbox execution ──────────────────────────────────────────
+            if (action === 'sandbox_exec') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const command = requireParam(params, 'command');
+                const timeout = params.timeout ? parseInt(params.timeout) : 30;
+                const result = await conwayApiRequest(apiKey, 'POST', `/v1/sandboxes/${sandboxId}/exec`, {
+                    command,
+                    timeout,
+                });
+                return ok(result);
+            }
+            if (action === 'sandbox_write_file') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const filePath = requireParam(params, 'path');
+                const content = requireParam(params, 'content');
+                const encoding = params.encoding;
+                const MAX_UPLOAD = 10 * 1024 * 1024; // 10MB
+                const contentBytes = encoding === 'base64'
+                    ? Math.ceil(content.length * 3 / 4)
+                    : new TextEncoder().encode(content).length;
+                if (contentBytes > MAX_UPLOAD) {
+                    return fail(`Content too large: ${contentBytes} bytes exceeds ${MAX_UPLOAD} byte limit`);
+                }
+                const body = { path: filePath, content };
+                if (encoding)
+                    body.encoding = encoding;
+                const result = await conwayApiRequest(apiKey, 'POST', `/v1/sandboxes/${sandboxId}/files/upload/json`, body);
+                return ok(result);
+            }
+            if (action === 'sandbox_read_file') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const filePath = requireParam(params, 'path');
+                const result = (await conwayApiRequest(apiKey, 'POST', `/v1/sandboxes/${sandboxId}/exec`, {
+                    command: `cat ${filePath}`,
+                    timeout: 10,
+                }));
+                if (result.exit_code !== 0) {
+                    return fail(`Failed to read file: ${result.stderr}`);
+                }
+                return ok({ content: result.stdout, path: filePath });
+            }
+            // ─── Sandbox networking ─────────────────────────────────────────
+            if (action === 'sandbox_expose_port') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const port = parseInt(requireParam(params, 'port'));
+                const body = {
+                    port,
+                    visibility: params.visibility || 'public',
+                };
+                if (params.subdomain)
+                    body.subdomain = params.subdomain;
+                const result = await conwayApiRequest(apiKey, 'POST', `/v1/sandboxes/${sandboxId}/ports/expose`, body);
+                return ok(result);
+            }
+            if (action === 'sandbox_list_ports') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const result = await conwayApiRequest(apiKey, 'GET', `/v1/sandboxes/${sandboxId}/ports`);
+                return ok(result);
+            }
+            if (action === 'sandbox_remove_port') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const port = requireParam(params, 'port');
+                const result = await conwayApiRequest(apiKey, 'DELETE', `/v1/sandboxes/${sandboxId}/ports/${port}`);
+                return ok(result);
+            }
+            if (action === 'sandbox_get_url') {
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const port = requireParam(params, 'port');
+                const url = `https://${port}-${sandboxId}.${CONWAY_PREVIEW_DOMAIN}`;
+                return ok({ url });
+            }
+            // ─── Sandbox custom domains ─────────────────────────────────────
+            if (action === 'sandbox_add_domain') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const domain = requireParam(params, 'domain');
+                const result = await conwayApiRequest(apiKey, 'POST', `/v1/sandboxes/${sandboxId}/domains`, { domain });
+                return ok(result);
+            }
+            if (action === 'sandbox_list_domains') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const result = await conwayApiRequest(apiKey, 'GET', `/v1/sandboxes/${sandboxId}/domains`);
+                return ok(result);
+            }
+            if (action === 'sandbox_remove_domain') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const domain = requireParam(params, 'domain');
+                const result = await conwayApiRequest(apiKey, 'DELETE', `/v1/sandboxes/${sandboxId}/domains/${encodeURIComponent(domain)}`);
+                return ok(result);
+            }
+            // ─── Sandbox monitoring ─────────────────────────────────────────
+            if (action === 'sandbox_terminal_session') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const result = await conwayApiRequest(apiKey, 'POST', `/v1/sandboxes/${sandboxId}/terminal-session`);
+                return ok(result);
+            }
+            if (action === 'sandbox_metrics') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const result = await conwayApiRequest(apiKey, 'GET', `/v1/sandboxes/${sandboxId}/metrics`);
+                return ok(result);
+            }
+            if (action === 'sandbox_activity') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const limit = params.limit ? parseInt(params.limit) : 50;
+                const result = await conwayApiRequest(apiKey, 'GET', `/v1/sandboxes/${sandboxId}/activity?limit=${limit}`);
+                return ok(result);
+            }
+            if (action === 'sandbox_commands') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const limit = params.limit ? parseInt(params.limit) : 50;
+                const result = await conwayApiRequest(apiKey, 'GET', `/v1/sandboxes/${sandboxId}/commands?limit=${limit}`);
+                return ok(result);
+            }
+            // ─── PTY sessions ──────────────────────────────────────────────
+            if (action === 'sandbox_pty_create') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const command = requireParam(params, 'command');
+                const cols = params.cols ? parseInt(params.cols) : 80;
+                const rows = params.rows ? parseInt(params.rows) : 24;
+                const result = await conwayApiRequest(apiKey, 'POST', `/v1/sandboxes/${sandboxId}/pty`, {
+                    command,
+                    cols,
+                    rows,
+                });
+                return ok(result);
+            }
+            if (action === 'sandbox_pty_write') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const sessionId = requireParam(params, 'session_id');
+                const input = requireParam(params, 'input');
+                const result = await conwayApiRequest(apiKey, 'POST', `/v1/sandboxes/${sandboxId}/pty/${sessionId}/write`, { input });
+                return ok(result);
+            }
+            if (action === 'sandbox_pty_read') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const sessionId = requireParam(params, 'session_id');
+                const full = params.full === 'true' ? '?full=true' : '';
+                const result = await conwayApiRequest(apiKey, 'GET', `/v1/sandboxes/${sandboxId}/pty/${sessionId}/read${full}`);
+                return ok(result);
+            }
+            if (action === 'sandbox_pty_close') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const sessionId = requireParam(params, 'session_id');
+                const result = await conwayApiRequest(apiKey, 'DELETE', `/v1/sandboxes/${sandboxId}/pty/${sessionId}`);
+                return ok(result);
+            }
+            if (action === 'sandbox_pty_resize') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const sessionId = requireParam(params, 'session_id');
+                const cols = parseInt(requireParam(params, 'cols'));
+                const rows = parseInt(requireParam(params, 'rows'));
+                const result = await conwayApiRequest(apiKey, 'POST', `/v1/sandboxes/${sandboxId}/pty/${sessionId}/resize`, { cols, rows });
+                return ok(result);
+            }
+            if (action === 'sandbox_pty_list') {
+                const apiKey = requireApiKey();
+                const sandboxId = requireParam(params, 'sandbox_id');
+                const result = await conwayApiRequest(apiKey, 'GET', `/v1/sandboxes/${sandboxId}/pty`);
+                return ok(result);
+            }
+            // ─── Wallet & x402 ─────────────────────────────────────────────
+            if (action === 'wallet_info') {
+                const conway = await getConwayModule();
+                const { account, isNew } = await conway.getWallet();
+                const network = params.network || 'eip155:8453';
+                try {
+                    const balance = await conway.getUsdcBalance(account.address, network);
+                    return ok({
+                        address: account.address,
+                        isNew,
+                        network,
+                        balance: { usdc: balance, formatted: `$${balance.toFixed(2)} USDC` },
+                        configDir: conway.getConfigDir(),
+                    });
+                }
+                catch (error) {
+                    return ok({
+                        address: account.address,
+                        isNew,
+                        network,
+                        error: error.message || String(error),
+                        configDir: conway.getConfigDir(),
+                    });
+                }
+            }
+            if (action === 'wallet_networks') {
+                const conway = await getConwayModule();
+                const networks = Object.entries(conway.SUPPORTED_NETWORKS).map(([id, config]) => ({
+                    id,
+                    name: config.name,
+                    chainId: config.chain.id,
+                    usdcAddress: config.usdcAddress,
+                }));
+                return ok({ networks });
+            }
+            if (action === 'x402_discover') {
+                const conway = await getConwayModule();
+                const url = requireParam(params, 'url');
+                const result = await conway.discoverX402Endpoints(url);
+                return ok(result);
+            }
+            if (action === 'x402_check') {
+                const conway = await getConwayModule();
+                const url = requireParam(params, 'url');
+                const method = params.method || undefined;
+                const result = await conway.checkX402Endpoint(url, method);
+                return ok(result);
+            }
+            if (action === 'x402_fetch') {
+                const conway = await getConwayModule();
+                const { account } = await conway.getWallet();
+                const url = requireParam(params, 'url');
+                const fetchOptions = {};
+                if (params.method)
+                    fetchOptions.method = params.method;
+                if (params.headers)
+                    fetchOptions.headers = JSON.parse(params.headers);
+                if (params.body)
+                    fetchOptions.body = params.body;
+                const response = await conway.x402Fetch(account, url, fetchOptions);
+                const responseBody = await response.text();
+                return ok({
+                    status: response.status,
+                    statusText: response.statusText,
+                    body: responseBody,
+                });
+            }
+            // ─── Domains ────────────────────────────────────────────────────
+            if (action === 'domain_search') {
+                const query = requireParam(params, 'query');
+                const tlds = params.tlds || 'com,io,ai,xyz,net,org,dev';
+                const result = await conwayDomainRequest('GET', `/domains/search?q=${encodeURIComponent(query)}&tlds=${encodeURIComponent(tlds)}`);
+                return ok(result);
+            }
+            if (action === 'domain_list') {
+                const result = await conwayDomainRequest('GET', '/domains');
+                return ok(result);
+            }
+            if (action === 'domain_info') {
+                const domain = requireParam(params, 'domain');
+                const result = await conwayDomainRequest('GET', `/domains/${encodeURIComponent(domain)}`);
+                return ok(result);
+            }
+            if (action === 'domain_register') {
+                const domain = requireParam(params, 'domain');
+                const years = params.years ? parseInt(params.years) : 1;
+                const privacy = params.privacy !== 'false';
+                const result = await x402DomainFetch('/domains/register', 'POST', { domain, years, privacy });
+                return ok(result);
+            }
+            if (action === 'domain_renew') {
+                const domain = requireParam(params, 'domain');
+                const years = params.years ? parseInt(params.years) : 1;
+                const result = await x402DomainFetch(`/domains/${encodeURIComponent(domain)}/renew`, 'POST', { years });
+                return ok(result);
+            }
+            if (action === 'domain_dns_list') {
+                const domain = requireParam(params, 'domain');
+                const result = await conwayDomainRequest('GET', `/domains/${encodeURIComponent(domain)}/dns`);
+                return ok(result);
+            }
+            if (action === 'domain_dns_add') {
+                const domain = requireParam(params, 'domain');
+                const spec = params.spec ? JSON.parse(params.spec) : {};
+                const result = await conwayDomainRequest('POST', `/domains/${encodeURIComponent(domain)}/dns`, spec);
+                return ok(result);
+            }
+            if (action === 'domain_dns_update') {
+                const domain = requireParam(params, 'domain');
+                const recordId = requireParam(params, 'record_id');
+                const spec = params.spec ? JSON.parse(params.spec) : {};
+                const result = await conwayDomainRequest('PUT', `/domains/${encodeURIComponent(domain)}/dns/${encodeURIComponent(recordId)}`, spec);
+                return ok(result);
+            }
+            if (action === 'domain_dns_delete') {
+                const domain = requireParam(params, 'domain');
+                const recordId = requireParam(params, 'record_id');
+                const result = await conwayDomainRequest('DELETE', `/domains/${encodeURIComponent(domain)}/dns/${encodeURIComponent(recordId)}`);
+                return ok(result);
+            }
+            if (action === 'domain_pricing') {
+                const tlds = params.tlds ? `?tlds=${encodeURIComponent(params.tlds)}` : '';
+                const result = await conwayDomainRequest('GET', `/domains/pricing${tlds}`);
+                return ok(result);
+            }
+            if (action === 'domain_check') {
+                const domains = requireParam(params, 'domains');
+                const result = await conwayDomainRequest('GET', `/domains/check?domains=${encodeURIComponent(domains)}`);
+                return ok(result);
+            }
+            if (action === 'domain_privacy') {
+                const domain = requireParam(params, 'domain');
+                const enabled = params.privacy === 'true';
+                const result = await conwayDomainRequest('PUT', `/domains/${encodeURIComponent(domain)}/privacy`, { enabled });
+                return ok(result);
+            }
+            if (action === 'domain_nameservers') {
+                const domain = requireParam(params, 'domain');
+                const nsString = requireParam(params, 'nameservers');
+                const nameservers = nsString.split(',').map((s) => s.trim());
+                const result = await conwayDomainRequest('PUT', `/domains/${encodeURIComponent(domain)}/nameservers`, { nameservers });
+                return ok(result);
+            }
+            // ─── Credits ────────────────────────────────────────────────────
+            if (action === 'credits_balance') {
+                const apiKey = requireApiKey();
+                const result = await conwayApiRequest(apiKey, 'GET', '/v1/credits/balance');
+                return ok(result);
+            }
+            if (action === 'credits_history') {
+                const apiKey = requireApiKey();
+                const limit = params.limit ? parseInt(params.limit) : 20;
+                const offset = params.offset ? parseInt(params.offset) : 0;
+                const result = await conwayApiRequest(apiKey, 'GET', `/v1/credits/history?limit=${limit}&offset=${offset}`);
+                return ok(result);
+            }
+            if (action === 'credits_pricing') {
+                const apiKey = requireApiKey();
+                const result = await conwayApiRequest(apiKey, 'GET', '/v1/credits/pricing');
+                return ok(result);
+            }
+            if (action === 'credits_topup') {
+                const conway = await getConwayModule();
+                const { account } = await conway.getWallet();
+                const amountUsd = parseInt(requireParam(params, 'amount_usd'));
+                const validTiers = [5, 25, 100, 500, 1000, 2500];
+                if (!validTiers.includes(amountUsd)) {
+                    return fail(`amount_usd must be one of: ${validTiers.join(', ')}`);
+                }
+                const recipientAddress = params.address || account.address;
+                const url = `${CONWAY_API_URL}/pay/${amountUsd}/${recipientAddress}`;
+                const response = await conway.x402Fetch(account, url, { method: 'GET' });
+                const raw = await response.text();
+                if (!response.ok) {
+                    return fail(`Credits top-up failed (${response.status}): ${raw}`);
+                }
+                let parsed;
+                try {
+                    parsed = JSON.parse(raw);
                 }
-                switch (action) {
-                    case 'sandbox_create': {
-                        const spec = params.spec ? JSON.parse(params.spec) : {};
-                        const result = await conwayApiRequest(apiKey, 'POST', '/v1/sandboxes', {
-                            name: spec.name,
-                            vcpu: spec.vcpu ?? 1,
-                            memory_mb: spec.memory_mb ?? 512,
-                            disk_gb: spec.disk_gb ?? 5,
-                            region: spec.region ?? 'us-east',
-                        });
-                        return { callId: '', success: true, result: JSON.stringify(result, null, 2) };
-                    }
-                    case 'sandbox_list': {
-                        const result = await conwayApiRequest(apiKey, 'GET', '/v1/sandboxes');
-                        return { callId: '', success: true, result: JSON.stringify(result, null, 2) };
-                    }
-                    case 'sandbox_exec': {
-                        const sandboxId = params.sandbox_id;
-                        const command = params.command;
-                        if (!sandboxId || !command) {
-                            return { callId: '', success: false, result: null, error: 'sandbox_id and command are required for sandbox_exec' };
-                        }
-                        const result = await conwayApiRequest(apiKey, 'POST', `/v1/sandboxes/${sandboxId}/exec`, {
-                            command,
-                            timeout: 30,
-                        });
-                        return { callId: '', success: true, result: JSON.stringify(result, null, 2) };
-                    }
-                    case 'sandbox_delete': {
-                        const sandboxId = params.sandbox_id;
-                        if (!sandboxId) {
-                            return { callId: '', success: false, result: null, error: 'sandbox_id is required for sandbox_delete' };
-                        }
-                        const result = await conwayApiRequest(apiKey, 'DELETE', `/v1/sandboxes/${sandboxId}`);
-                        return { callId: '', success: true, result: JSON.stringify(result, null, 2) };
-                    }
-                    case 'credits_balance': {
-                        const result = await conwayApiRequest(apiKey, 'GET', '/v1/credits/balance');
-                        return { callId: '', success: true, result: JSON.stringify(result, null, 2) };
-                    }
-                    default:
-                        return { callId: '', success: false, result: null, error: `Unknown sandbox action: "${action}"` };
+                catch {
+                    parsed = { raw_response: raw };
                 }
+                return ok({ ...parsed, amount_usd: amountUsd, recipient_address: recipientAddress });
             }
-            // --- Domain actions (use SIWE via conway-terminal wallet) ---
-            if (action.startsWith('domain_')) {
-                switch (action) {
-                    case 'domain_search': {
-                        const query = params.query;
-                        if (!query) {
-                            return { callId: '', success: false, result: null, error: 'query is required for domain_search' };
-                        }
-                        const result = await conwayDomainRequest('GET', `/domains/search?q=${encodeURIComponent(query)}`);
-                        return { callId: '', success: true, result: JSON.stringify(result, null, 2) };
-                    }
-                    case 'domain_list': {
-                        const result = await conwayDomainRequest('GET', '/domains');
-                        return { callId: '', success: true, result: JSON.stringify(result, null, 2) };
-                    }
-                    case 'domain_info': {
-                        const domain = params.domain;
-                        if (!domain) {
-                            return { callId: '', success: false, result: null, error: 'domain is required for domain_info' };
-                        }
-                        const result = await conwayDomainRequest('GET', `/domains/${encodeURIComponent(domain)}`);
-                        return { callId: '', success: true, result: JSON.stringify(result, null, 2) };
-                    }
-                    case 'domain_check': {
-                        const domain = params.domain;
-                        if (!domain) {
-                            return { callId: '', success: false, result: null, error: 'domain is required for domain_check (comma-separated for multiple)' };
-                        }
-                        const result = await conwayDomainRequest('GET', `/domains/check?domains=${encodeURIComponent(domain)}`);
-                        return { callId: '', success: true, result: JSON.stringify(result, null, 2) };
-                    }
-                    case 'domain_register': {
-                        const domain = params.domain;
-                        if (!domain) {
-                            return { callId: '', success: false, result: null, error: 'domain is required for domain_register' };
-                        }
-                        // Domain registration uses x402 payment — requires USDC in Conway wallet
-                        // For now use the JWT-authenticated endpoint; the x402 payment is handled server-side
-                        const result = await conwayDomainRequest('POST', '/domains/register', { domain });
-                        return { callId: '', success: true, result: JSON.stringify(result, null, 2) };
-                    }
-                    case 'domain_dns_list': {
-                        const domain = params.domain;
-                        if (!domain) {
-                            return { callId: '', success: false, result: null, error: 'domain is required for domain_dns_list' };
-                        }
-                        const result = await conwayDomainRequest('GET', `/domains/${encodeURIComponent(domain)}/dns`);
-                        return { callId: '', success: true, result: JSON.stringify(result, null, 2) };
-                    }
-                    case 'domain_dns_add': {
-                        const domain = params.domain;
-                        const spec = params.spec;
-                        if (!domain || !spec) {
-                            return { callId: '', success: false, result: null, error: 'domain and spec (DNS record JSON) are required for domain_dns_add' };
-                        }
-                        const record = JSON.parse(spec);
-                        const result = await conwayDomainRequest('POST', `/domains/${encodeURIComponent(domain)}/dns`, record);
-                        return { callId: '', success: true, result: JSON.stringify(result, null, 2) };
-                    }
-                    default:
-                        return { callId: '', success: false, result: null, error: `Unknown domain action: "${action}". Valid domain actions: domain_search, domain_list, domain_info, domain_check, domain_register, domain_dns_list, domain_dns_add.` };
+            // ─── Inference ──────────────────────────────────────────────────
+            if (action === 'chat_completions') {
+                const apiKey = requireApiKey();
+                const spec = params.spec ? JSON.parse(params.spec) : {};
+                if (!spec.model || !spec.messages) {
+                    return fail('chat_completions requires spec with "model" and "messages" fields');
                 }
+                const body = {
+                    model: spec.model,
+                    messages: spec.messages,
+                };
+                if (spec.temperature !== undefined)
+                    body.temperature = spec.temperature;
+                if (spec.max_tokens !== undefined)
+                    body.max_tokens = spec.max_tokens;
+                const result = await conwayApiRequest(apiKey, 'POST', '/v1/chat/completions', body);
+                return ok(result);
             }
-            return {
-                callId: '',
-                success: false,
-                result: null,
-                error: `Unknown Conway action: "${action}". Use sandbox_* or domain_* actions.`,
-            };
+            // ─── Unknown action ─────────────────────────────────────────────
+            return fail(`Unknown Conway action: "${action}". Valid actions: ${ALL_ACTIONS.join(', ')}.`);
         }
         catch (err) {
             return { callId: '', success: false, result: null, error: err instanceof Error ? err.message : String(err) };