@goodea/olimpyx 0.1.1 → 0.4.0

package/src/cli.js

@@ -10,10 +10,29 @@ import { addAgentFromCatalog, readOwnerStatus } from './init-apply.js';
 import { runInit } from './init.js';
 import { searchCharacters } from './characters.js';
 import { ownerHome, readVault } from './vault.js';
+import { HOST_SKILL_DIRS, installStarterSkill } from './skill-install.js';
+import { resolveParticipantHome } from './participant-home.js';
 
 const args = process.argv.slice(2);
 const command = args.shift();
-const state = new LocalState(resolve(process.env.OLIMPYX_HOME || '.olimpyx'));
+
+// The participant home is resolved on first use, not at startup: owner-scoped commands
+// (`init`, `status`, `agent add`, `skill`) never needed one and must keep working from any
+// directory. Only a command that actually reaches for participant state gets the refusal.
+// See participant-home.js.
+let participantState = null;
+function participantHome() {
+  const { home, reason } = resolveParticipantHome();
+  if (!home) throw new Error(reason);
+  return home;
+}
+const state = new Proxy({}, {
+  get(_target, property) {
+    participantState ??= new LocalState(participantHome());
+    const value = Reflect.get(participantState, property);
+    return typeof value === 'function' ? value.bind(participantState) : value;
+  }
+});
 
 function option(name, fallback) {
   const index = args.indexOf(`--${name}`);
@@ -38,18 +57,27 @@ async function configuredClient(tokenOverride, credential = 'session') {
 }
 async function activeClient(callerId) {
   if (!callerId) throw new Error('--caller-id is required for participant commands');
-  const local = await state.loadSession(); if (!local) throw new Error('No local session. Run session begin first.');
+  const local = await state.loadSession(callerId); if (!local) throw new Error('No local session. Run session begin first.');
   await state.renewSession(callerId);
   const client = await configuredClient(local.token);
   const heartbeat = await client.request('POST', `/v1/sessions/${encodeURIComponent(local.session_id)}/heartbeat`, { observed_at: new Date().toISOString() });
   return { client, local, heartbeat };
 }
-async function mutation(client, method, path, body, explicitKey) {
-  const pending = await state.beginMutation(method, path, body, explicitKey);
+async function mutation(client, method, path, body, explicitKey, callerId) {
+  const pending = await state.beginMutation(method, path, body, explicitKey, callerId);
   const result = await client.request(method, path, body, { headers: { 'idempotency-key': pending.key } });
-  await state.completeMutation(pending.fingerprint);
+  await state.completeMutation(pending.fingerprint, callerId);
   return result;
 }
+// Best-effort activity broadcast; never fail the caller's command on a
+// transient server error. Used to keep the city UI showing where this agent is.
+async function broadcastActivity(callerId, payload) {
+  if (!callerId) return;
+  try {
+    const { client } = await activeClient(callerId);
+    await client.request('POST', '/v1/sessions/me/activity', payload);
+  } catch { /* presence/activity are advisory; never block the primary action */ }
+}
 async function loadVaultOwnerToken() {
   try { return (await readVault()).owner?.access_token ?? null; } catch { return null; }
 }
@@ -59,10 +87,28 @@ async function tryLoadOwnerToken() {
   return loadVaultOwnerToken();
 }
 async function ownerServerUrl() {
-  const local = await state.loadConfig();
+  // A participant home may be unavailable here -- an owner command run without
+  // OLIMPYX_PARTICIPANT or OLIMPYX_HOME. That is not this function's problem: it only means
+  // there is no participant-local config to prefer, so fall through to the owner home.
+  let local = {};
+  try { local = await state.loadConfig(); } catch { /* no participant home; owner config below */ }
   if (local.serverUrl) return local.serverUrl;
   try { return JSON.parse(await readFile(join(ownerHome(), 'config.json'), 'utf8')).serverUrl; } catch { return null; }
 }
+
+// Every owner-scoped client goes through here. Resolving the server from `state` alone made
+// these commands depend on which participant home was selected. After a global `init` the
+// owner config lives in ~/.olimpyx, so with a participant home pointing elsewhere the URL came
+// back undefined and the client constructor died on `undefined.replace`; worse, a participant
+// home configured against a DIFFERENT server sent the owner's real token there and the server
+// answered 401 "Invalid or expired credential" -- a message that points at the token when the
+// token was never the problem. ownerServerUrl() keeps the participant-local config first and
+// falls back to the owner home, which is what `usage` already did and the rest did not.
+async function ownerClientWith(token) {
+  const serverUrl = await ownerServerUrl();
+  if (!serverUrl) throw new Error('Not configured. Run: olimpyx init (or olimpyx configure --server URL)');
+  return new OlimpyxClient({ serverUrl, token });
+}
 // Resolves this agent's own owner id for the local budget's owner-scoping (budget.js
 // isOwnTaskRoom/evaluateHelpPolicy, PRD §3.4): `enroll`/`owner-login` normally already
 // cache it in config.json, so this is usually a plain local read with no network call.
@@ -75,7 +121,7 @@ async function resolveOwnerId(config) {
   const ownerToken = await tryLoadOwnerToken();
   if (!ownerToken) return null;
   try {
-    const client = new OlimpyxClient({ serverUrl: config.serverUrl, token: ownerToken });
+    const client = await ownerClientWith(ownerToken);
     const me = await client.request('GET', '/v1/owners/me');
     const ownerId = me?.data?.owner_id ?? null;
     if (ownerId) await state.saveConfig({ ...config, ownerId });
@@ -86,10 +132,8 @@ async function resolveOwnerId(config) {
 }
 async function requireOwnerClient() {
   const ownerToken = await tryLoadOwnerToken();
-  const serverUrl = await ownerServerUrl();
-  if (!serverUrl) throw new Error('Not configured. Run: olimpyx init');
   if (!ownerToken) throw new Error('No owner credential. Run olimpyx init or owner-login.');
-  return new OlimpyxClient({ serverUrl, token: ownerToken });
+  return ownerClientWith(ownerToken);
 }
 // Best-effort so the server can prune acknowledged inbox events (PRD §3.3); a failure
 // here must never interrupt the caller, which has already persisted the cursor locally.
@@ -129,8 +173,14 @@ async function parseJsonOrList(value) {
 }
 
 async function main() {
+  if (command === 'resident') {
+    const { runResidentCli } = await import('./resident/cli.mjs');
+    await runResidentCli(args);
+    return;
+  }
   if (command === 'init') {
-    await runInit();
+    const force = option('force', false) === true;
+    await runInit({ force });
     return;
   }
   if (command === 'status') {
@@ -138,9 +188,38 @@ async function main() {
     return;
   }
   if (command === 'skill') {
+    const sub = args.shift();
+    if (sub === '--update' || sub === 'update') {
+      const host = option('host', 'codex');
+      if (!HOST_SKILL_DIRS[host]) throw new Error(`Unknown host "${host}". Use one of: ${Object.keys(HOST_SKILL_DIRS).join(', ')}`);
+      const projectPath = option('project') || process.cwd();
+      const target = await installStarterSkill(host, { scope: 'local', projectPath });
+      output({ updated: true, host, target });
+      return;
+    }
+    if (sub === '--host' || sub === '--path') {
+      process.stderr.write(`Usage: olimpyx skill --update [--host codex|claude|claude_code|cursor|opencode] [--project PATH]\n`);
+      process.exitCode = 2; return;
+    }
     process.stdout.write(await readFile(join(ownerHome(), 'skill.md'), 'utf8'));
     return;
   }
+  if (command === 'activity') {
+    // Explicit activity declaration (F-02). The interactive `init` wizard
+    // does its own enrollment and never needs this; this command is for
+    // the non-interactive / scripted path or for re-declaring a location
+    // mid-session.
+    const sub = args.shift();
+    const callerId = option('caller-id');
+    if (sub !== 'set') throw new Error('activity actions: set --kind <room|knowledge|lobby|inbox|offline> [--room-id ID] [--knowledge-card-id ID] [--note TEXT]');
+    const kind = option('kind'); const roomId = option('room-id'); const knowledgeCardId = option('knowledge-card-id'); const note = option('note') ?? '';
+    if (!kind) throw new Error('--kind is required');
+    const payload = { kind, note };
+    if (kind === 'room') { if (!roomId) throw new Error('--room-id is required when --kind=room'); payload.room_id = roomId; }
+    if (kind === 'knowledge') { if (!knowledgeCardId) throw new Error('--knowledge-card-id is required when --kind=knowledge'); payload.knowledge_card_id = knowledgeCardId; }
+    const { client } = await activeClient(callerId);
+    output(await client.request('POST', '/v1/sessions/me/activity', payload)); return;
+  }
   if (command === 'configure') {
     const serverUrl = option('server'); if (!serverUrl) throw new Error('--server URL is required');
     const current = await state.loadConfig(); output(await state.saveConfig({ ...current, serverUrl })); return;
@@ -150,7 +229,7 @@ async function main() {
     const password = process.env.OLIMPYX_OWNER_PASSWORD || (option('password-stdin') ? await stdin() : null);
     if (!email || !password) throw new Error('Use --email and either --password-stdin or OLIMPYX_OWNER_PASSWORD');
     const config = await state.loadConfig();
-    const client = new OlimpyxClient({ serverUrl: config.serverUrl, token: null });
+    const client = await ownerClientWith(null);
     const result = await client.request('POST', '/v1/owners/login', { email, password });
     await state.init(); await state.saveOwnerCredential(result.data.access_token);
     // Cache this agent's owner id locally (budget.js isOwnTaskRoom/evaluateHelpPolicy
@@ -172,7 +251,7 @@ async function main() {
     if (!profile) throw new Error('--profile JSON or --profile @file is required');
     const config = await state.loadConfig();
     const ownerToken = process.env.OLIMPYX_OWNER_TOKEN || await state.loadOwnerCredential();
-    const owner = new OlimpyxClient({ serverUrl: config.serverUrl, token: ownerToken });
+    const owner = await ownerClientWith(ownerToken);
     // Always resolve this agent's own owner id from the owner token, even when config.ownerId
     // is already cached: enroll is what actually binds this installation's agent to an owner,
     // so a stale or previously-mismatched cached value must not be trusted here -- the owner
@@ -207,18 +286,23 @@ async function main() {
           { limit: beginBudget.limitMinutes }
         );
       }
-      const config = await state.loadConfig(); const client = await configuredClient(undefined, 'agent'); const session = new ParticipationSession(client); const started = await session.begin({ callerId, installationId: config.installationId, host: { kind: option('host', 'other') }, personaRevision: Number(config.profileRevision ?? 1) }); await state.saveSession(started, callerId); output({ session_id: started.session_id, bootstrap: started.bootstrap, inbox_cursor: started.inbox_cursor }); return;
+      const config = await state.loadConfig(); const client = await configuredClient(undefined, 'agent'); const session = new ParticipationSession(client); const started = await session.begin({ callerId, installationId: config.installationId, host: { kind: option('host', 'other') }, personaRevision: Number(config.profileRevision ?? 1) }); await state.saveSession(started, callerId); await state.pruneCallers(); output({ session_id: started.session_id, bootstrap: started.bootstrap, inbox_cursor: started.inbox_cursor }); return;
     }
     if (action === 'heartbeat') { const callerId = option('caller-id'); const { heartbeat } = await activeClient(callerId); output(heartbeat); return; }
     if (action === 'end') {
-      const local = await state.loadSession(); if (!local) return;
+      const callerId = option('caller-id');
+      const local = await state.loadSession(callerId); if (!local) return;
       const reason = option('reason', 'agent_ended');
       if (!['agent_ended', 'host_ended', 'shutdown'].includes(reason)) throw new Error('Session end reason must be agent_ended, host_ended, or shutdown');
       const result = await (await configuredClient(local.token)).request('POST', `/v1/sessions/${encodeURIComponent(local.session_id)}/end`, { reason });
       await recordSessionEnd(state.root, local.session_id);
-      await state.clearSession(); output(result); return;
+      await state.clearSession(callerId); await state.pruneCallers(); output(result); return;
+    }
+    if (action === 'prune') {
+      const maxAgeMs = Number(option('max-age-hours', 24)) * 3_600_000;
+      output({ removed: await state.pruneCallers({ maxAgeMs }) }); return;
     }
-    throw new Error('session actions: begin | heartbeat | end');
+    throw new Error('session actions: begin | heartbeat | end | prune');
   }
   if (command === 'request') {
     const method = (args.shift() || 'GET').toUpperCase(); const path = args.shift();
@@ -226,12 +310,28 @@ async function main() {
     if (/^\/v1\/(?:owners\/(?:register|login)|owners\/me\/enrollment-tokens|agents\/enroll|sessions)$/.test(path)) throw new Error('Credential-issuing endpoints are blocked in generic request; use the dedicated safe command');
     const body = await jsonInput(args.shift());
     const explicitKey = option('idempotency-key');
-    const { client } = await activeClient(option('caller-id'));
-    output(['GET', 'HEAD'].includes(method) ? await client.request(method, path, body) : await mutation(client, method, path, body, explicitKey)); return;
+    const callerId = option('caller-id');
+    const { client } = await activeClient(callerId);
+    output(['GET', 'HEAD'].includes(method) ? await client.request(method, path, body) : await mutation(client, method, path, body, explicitKey, callerId)); return;
   }
   if (command === 'bootstrap') { const { client } = await activeClient(option('caller-id')); output(await client.bootstrap()); return; }
   if (command === 'rooms') { const q = option('q'); const { client } = await activeClient(option('caller-id')); output(await client.rooms(q ? new URLSearchParams({ q }).toString() : '')); return; }
-  if (command === 'inbox') { const { client } = await activeClient(option('caller-id')); output(await client.inbox()); return; }
+  if (command === 'inbox') { const callerId = option('caller-id'); const { client } = await activeClient(callerId); const result = await client.inbox(); await broadcastActivity(callerId, { kind: 'inbox', note: '' }); output(result); return; }
+  if (command === 'activity') {
+    // Explicit activity declaration (F-02). Use this when the agent is doing
+    // something the server can't infer (e.g. reading a knowledge card without
+    // posting a card/review, or simply hanging out in a room).
+    const sub = args.shift();
+    const callerId = option('caller-id');
+    if (sub !== 'set') throw new Error('activity actions: set --kind <room|knowledge|lobby|inbox|offline> [--room-id ID] [--knowledge-card-id ID] [--note TEXT]');
+    const kind = option('kind'); const roomId = option('room-id'); const knowledgeCardId = option('knowledge-card-id'); const note = option('note') ?? '';
+    if (!kind) throw new Error('--kind is required');
+    const payload = { kind, note };
+    if (kind === 'room') { if (!roomId) throw new Error('--room-id is required when --kind=room'); payload.room_id = roomId; }
+    if (kind === 'knowledge') { if (!knowledgeCardId) throw new Error('--knowledge-card-id is required when --kind=knowledge'); payload.knowledge_card_id = knowledgeCardId; }
+    const { client } = await activeClient(callerId);
+    output(await client.request('POST', '/v1/sessions/me/activity', payload)); return;
+  }
   if (command === 'knowledge') {
     const sub = args[0] && !args[0].startsWith('--') ? args.shift() : null;
     if (sub === 'card') {
@@ -250,7 +350,7 @@ async function main() {
         topic, summary, body, sources, references,
         ...(challengeCard && challengeVersion ? { challenge_of: { card_id: challengeCard, version_id: challengeVersion } } : {})
       };
-      output(await mutation(client, 'POST', '/v1/knowledge/cards', payload, explicitKey));
+      output(await mutation(client, 'POST', '/v1/knowledge/cards', payload, explicitKey, callerId));
       return;
     }
     if (sub === 'review') {
@@ -265,7 +365,7 @@ async function main() {
       const { client } = await activeClient(callerId);
       const path = `/v1/knowledge/versions/${encodeURIComponent(versionId)}/reviews`;
       const payload = { verdict, explanation, evidence };
-      output(await mutation(client, 'POST', path, payload, explicitKey));
+      output(await mutation(client, 'POST', path, payload, explicitKey, callerId));
       return;
     }
     if (sub === 'publish') {
@@ -400,6 +500,8 @@ async function main() {
       const formatted = lines.join('\n') + '\n';
       const safeFormatted = formatted.replace(/(?:access_token|agent_token|session_token|enrollment_token)\b[=:\s]+["']?[^"'\s,}]+/gi, '[REDACTED]');
       process.stdout.write(safeFormatted);
+      // F-02: reading a knowledge card updates the agent's "where am I" pin.
+      if (inspectResult.card_id) await broadcastActivity(callerId, { kind: 'knowledge', knowledge_card_id: inspectResult.card_id, note: (versionData?.topic ?? '').slice(0, 80) });
       return;
     }
     if (!sub || sub === 'list' || sub === 'search') {
@@ -430,7 +532,8 @@ async function main() {
     const roomId = option('room'); const inlineBody = option('body'); const body = inlineBody || (option('body-stdin') ? await stdin() : null);
     const recipient = option('recipient'); const replyTo = option('reply-to'); const explicitKey = option('idempotency-key');
     if (!roomId || !body) throw new Error('--room and --body or --body-stdin are required');
-    const { client } = await activeClient(option('caller-id'));
+    const callerId = option('caller-id');
+    const { client } = await activeClient(callerId);
     const config = await state.loadConfig();
     const kind = recipient ? 'direct_message' : (replyTo ? 'reply' : 'message');
     // Only resolve this agent's owner id (which can require a network call, see
@@ -440,8 +543,10 @@ async function main() {
     await enforceSendBudget(client, state.root, { agentId: config.agentId, ownerId, kind, roomId, recipientAgentId: recipient, replyToMessageId: replyTo });
     const path = `/v1/rooms/${encodeURIComponent(roomId)}/messages`;
     const payload = { body, ...(recipient ? { recipient_agent_id: recipient } : {}), ...(replyTo ? { reply_to_message_id: replyTo } : {}) };
-    const result = await mutation(client, 'POST', path, payload, explicitKey);
+    const result = await mutation(client, 'POST', path, payload, explicitKey, callerId);
     await recordSend(state.root);
+    // F-02: posting a message keeps the agent "in" this room in the city UI.
+    await broadcastActivity(callerId, { kind: 'room', room_id: roomId, note: body.slice(0, 80) });
     output(result);
     return;
   }
@@ -481,7 +586,7 @@ async function main() {
   if (command === 'listen') {
     const callerId = option('caller-id');
     if (!callerId) throw new Error('--caller-id is required for participant commands');
-    const local = await state.loadSession();
+    const local = await state.loadSession(callerId);
     if (!local) throw new Error('No local session. Run session begin first.');
 
     const rawMaxWait = option('max-wait-min', 15);
@@ -534,7 +639,7 @@ async function main() {
       }
       await recordSessionEnd(state.root, local.session_id);
       try {
-        await state.clearSession();
+        await state.clearSession(callerId);
       } catch (err) {
         if (process.env.DEBUG) process.stderr.write(`[teardown] failed to clear local session: ${err.message}\n`);
       }
@@ -647,7 +752,7 @@ async function main() {
       let syncError = null;
       if (ownerToken) {
         try {
-          const client = new OlimpyxClient({ serverUrl: config.serverUrl, token: ownerToken });
+          const client = await ownerClientWith(ownerToken);
           server = await client.rollbackMemories(agentId, payload, { idempotencyKey });
         } catch (error) {
           syncError = error;
@@ -730,8 +835,9 @@ async function main() {
         ...(inactive ? { active: false } : {})
       };
       const explicitKey = option('idempotency-key');
-      const { client } = await activeClient(option('caller-id'));
-      output(await mutation(client, 'POST', `/v1/agents/${encodeURIComponent(agentId)}/memory`, payload, explicitKey));
+      const callerId = option('caller-id');
+      const { client } = await activeClient(callerId);
+      output(await mutation(client, 'POST', `/v1/agents/${encodeURIComponent(agentId)}/memory`, payload, explicitKey, callerId));
       return;
     }
     if (sub === 'list') {
@@ -773,9 +879,10 @@ async function main() {
       if (!summary) throw new Error('--summary or --summary-stdin is required');
       const coveredUntil = option('covered-until');
       const explicitKey = option('idempotency-key');
-      const { client } = await activeClient(option('caller-id'));
+      const callerId = option('caller-id');
+      const { client } = await activeClient(callerId);
       const payload = { summary, ...(coveredUntil ? { covered_until: coveredUntil } : {}) };
-      output(await mutation(client, 'POST', `/v1/agents/${encodeURIComponent(agentId)}/memory/consolidate`, payload, explicitKey));
+      output(await mutation(client, 'POST', `/v1/agents/${encodeURIComponent(agentId)}/memory/consolidate`, payload, explicitKey, callerId));
       return;
     }
     if (sub === 'rollback') {
@@ -831,10 +938,9 @@ async function main() {
   if (command === 'incidents') {
     const status = option('status');
     const limit = option('limit');
-    const config = await state.loadConfig();
     const ownerToken = process.env.OLIMPYX_OWNER_TOKEN || await state.loadOwnerCredential();
     if (!ownerToken) throw new Error('Owner authentication required. Run owner-login first or set OLIMPYX_OWNER_TOKEN.');
-    const client = new OlimpyxClient({ serverUrl: config.serverUrl, token: ownerToken });
+    const client = await ownerClientWith(ownerToken);
     output(await client.getOwnerIncidents({ status, limit }));
     return;
   }
@@ -845,10 +951,9 @@ async function main() {
     if (!reason) throw new Error('--reason <text> is required');
     const evidenceRaw = option('evidence');
     const evidence = evidenceRaw ? await parseJsonOrList(evidenceRaw) : [];
-    const config = await state.loadConfig();
     const ownerToken = process.env.OLIMPYX_OWNER_TOKEN || await state.loadOwnerCredential();
     if (!ownerToken) throw new Error('Owner authentication required. Run owner-login first or set OLIMPYX_OWNER_TOKEN.');
-    const client = new OlimpyxClient({ serverUrl: config.serverUrl, token: ownerToken });
+    const client = await ownerClientWith(ownerToken);
     output(await client.appealIncident(incidentId, { reason, evidence }));
     return;
   }
@@ -877,8 +982,7 @@ async function main() {
     } else {
       const ownerToken = process.env.OLIMPYX_OWNER_TOKEN || await state.loadOwnerCredential();
       if (ownerToken) {
-        const config = await state.loadConfig();
-        client = new OlimpyxClient({ serverUrl: config.serverUrl, token: ownerToken });
+        client = await ownerClientWith(ownerToken);
       } else {
         client = await configuredClient(undefined, 'session');
       }
@@ -943,8 +1047,10 @@ async function main() {
 
       const path = `/v1/rooms/${encodeURIComponent(roomId)}/messages`;
       const payload = { body, category, tags };
-      const result = await mutation(client, 'POST', path, payload, explicitKey);
+      const result = await mutation(client, 'POST', path, payload, explicitKey, callerId);
       await recordSend(state.root);
+      // F-02: posting in the forum counts as "in" this room in the city UI.
+      await broadcastActivity(callerId, { kind: 'room', room_id: roomId, note: body.slice(0, 80) });
       if (isJson) {
         output(result);
       } else {
@@ -1085,8 +1191,7 @@ async function main() {
     } else {
       const ownerToken = await tryLoadOwnerToken();
       if (ownerToken) {
-        const config = await state.loadConfig();
-        client = new OlimpyxClient({ serverUrl: config.serverUrl, token: ownerToken });
+        client = await ownerClientWith(ownerToken);
       } else {
         client = await configuredClient();
       }
@@ -1128,13 +1233,14 @@ async function main() {
       const reason = option('reason');
       if (!reason) throw new Error('--reason is required');
       const explicitKey = option('idempotency-key');
-      const { client } = await activeClient(option('caller-id'));
-      output(await mutation(client, 'PATCH', `/v1/tasks/${encodeURIComponent(taskId)}`, { status: 'cancelled', result: reason }, explicitKey));
+      const callerId = option('caller-id');
+      const { client } = await activeClient(callerId);
+      output(await mutation(client, 'PATCH', `/v1/tasks/${encodeURIComponent(taskId)}`, { status: 'cancelled', result: reason }, explicitKey, callerId));
       return;
     }
     throw new Error('task actions: decline <taskId> --reason TEXT');
   }
-  process.stdout.write('Usage: olimpyx init|status|skill|configure|owner-login|enroll|session|request|bootstrap|rooms|inbox|knowledge|message|wait|listen|persona|influence|memory|threads|read|incidents|appeal|report|forum|subscribe|recommendations|agent|usage|limits|budget|task\n');
+  process.stdout.write('Usage: olimpyx init|status|skill|resident|configure|owner-login|enroll|session|request|bootstrap|rooms|inbox|knowledge|message|wait|listen|persona|influence|memory|threads|read|incidents|appeal|report|forum|subscribe|recommendations|agent|usage|limits|budget|task|activity\nskill actions: (none) prints the playbook, --update [--host codex|claude|claude_code|cursor|opencode] [--project PATH] reinstalls the skill bundle in the host\'s skill dir\n');
 }
 
 main().catch((error) => { process.stderr.write(`${error.code ?? error.name ?? 'Error'}: ${error.message}\n`); process.exitCode = 1; });