@kuralle-agents/cli 0.15.0 → 0.16.0

package/dist/cli.js

@@ -4,11 +4,13 @@
  *
  *   kuralle chat [--trace] [--store <file>] [--session <id>] [--auto "msg1|msg2"] [--agent <path.ts>]
  *   kuralle send --session <id> [--store <file>] [--state|--reset] "<message>"
+ *   kuralle resume <session> [--store <file>] [--summary <text>]
  *   kuralle sim --goal "<goal>" [--turns N] [--profile "<who>"] [--agent <path.ts>]
  *   kuralle trace <session> [--last] [--json] [--web] [--port N]
  */
 import { resolveBuildRuntime } from './agentLoader.js';
 import { runChat } from './chat.js';
+import { runResume } from './resume.js';
 import { runSend } from './send.js';
 import { runSim } from './sim.js';
 import { runTrace } from './trace.js';
@@ -17,6 +19,7 @@ const HELP = `kuralle — Kuralle agent CLI
 Usage:
   kuralle chat [--trace] [--store <file>] [--session <id>] [--auto "msg1|msg2"] [--agent <path.ts>]
   kuralle send --session <id> [--store <file>] [--state|--reset] "<message>"
+  kuralle resume <session> [--store <file>] [--summary <text>]
   kuralle sim --goal "<goal>" [--turns N] [--profile "<who>"] [--agent <path.ts>]
   kuralle trace <session> [--last] [--json] [--web] [--port N]
 
@@ -27,6 +30,7 @@ Options:
   --trace             Live trace side panel — the built-in AgentTrace of each turn (chat only)
   --store <file>      Persist the session + traces to JSON files so chat survives across launches (chat only)
   --session <id>      Session id to resume with --store (default: "default")
+  --summary <text>    Resolution note appended on resume (seen by the agent post-resume)
 `;
 function flag(argv, name) {
     const i = argv.indexOf(name);
@@ -65,6 +69,9 @@ async function main() {
         case 'send':
             await runSend(subArgv, buildRuntime);
             break;
+        case 'resume':
+            await runResume(subArgv, buildRuntime);
+            break;
         case 'sim':
             await runSim(subArgv, buildRuntime);
             break;

package/dist/resume.d.ts

@@ -0,0 +1,2 @@
+import type { BuildRuntime } from './agentRuntime.js';
+export declare function runResume(argv: string[], buildRuntime: BuildRuntime): Promise<void>;

package/dist/resume.js

@@ -0,0 +1,35 @@
+/**
+ * resume — hand a held-over session back to the bot after a human resolved an escalation.
+ *
+ * Usage: kuralle resume <session> [--store <path>] [--summary <text>]
+ *
+ * A terminal-handoff escalation parks the run (`status = 'paused'`, no `waitingFor`); every
+ * later turn is held with "a colleague is handling this" until this command runs.
+ * `runtime.resumeFromEscalation` appends the resolution note, clears the parked flow /
+ * escalation state, and marks the run runnable — the next `run()` continues with context.
+ */
+import { join } from 'node:path';
+import { fileSessionStore } from './fileStore.js';
+import { fileTraceStore } from './fileTraceStore.js';
+function flag(argv, name) {
+    const i = argv.indexOf(name);
+    return i >= 0 ? argv[i + 1] : undefined;
+}
+export async function runResume(argv, buildRuntime) {
+    const storePath = flag(argv, '--store') ?? join(process.cwd(), 'runs/tui-sessions.json');
+    const summary = flag(argv, '--summary');
+    // Every flag whose VALUE must not be mistaken for the session id positional. Missing one
+    // here would let the value survive the filter and become the session id (see send.ts).
+    const consumesValue = new Set(['--store', '--summary']);
+    const positional = argv.filter((a, i) => !a.startsWith('--') && !(i > 0 && consumesValue.has(argv[i - 1])));
+    const sessionId = positional[0];
+    if (!sessionId) {
+        console.error('usage: kuralle resume <session> [--store <path>] [--summary <text>]');
+        process.exit(2);
+    }
+    const store = fileSessionStore(storePath);
+    const traces = fileTraceStore(storePath.replace(/\.json$/, '') + '.traces.json');
+    const demo = buildRuntime(sessionId, store, traces);
+    await demo.runtime.resumeFromEscalation(sessionId, summary !== undefined ? { resolutionSummary: summary } : undefined);
+    console.log(`resumed session "${sessionId}"${summary ? ` (${summary})` : ''}`);
+}

package/package.json

@@ -6,7 +6,7 @@
     "url": "git+https://github.com/kuralle/kuralle-agents.git",
     "directory": "packages/cli"
   },
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Kuralle CLI — interactive TUI chat, adaptive send, and conversation simulation",
   "type": "module",
   "bin": {
@@ -20,8 +20,8 @@
     "ink-text-input": "^6.0.0",
     "react": "^19.2.7",
     "zod": "^4.0.0",
-    "@kuralle-agents/trace-ui": "0.14.1",
-    "@kuralle-agents/core": "0.15.0"
+    "@kuralle-agents/trace-ui": "0.14.2",
+    "@kuralle-agents/core": "0.16.0"
   },
   "peerDependencies": {
     "@kuralle-agents/core": "0.x",
@@ -32,7 +32,7 @@
     "@types/node": "^20.11.0",
     "@types/react": "^19.2.17",
     "typescript": "^5.3.0",
-    "@kuralle-agents/fs": "0.14.1"
+    "@kuralle-agents/fs": "0.14.2"
   },
   "publishConfig": {
     "access": "public"