@toist/in 0.8.0 → 0.8.1

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to `@toist/in` are recorded here.
 
+## 0.8.1 — 2026-05-08
+
+Patch: normalize toist run --remote JSON shape to match local RunSpecResult (.output/.runId, projected suspendedAt, results map). HTTP API and @toist/core unchanged.
+
+Scaffold template pins `@toist/aja` and `@toist/spec` to `^0.8.1`.
+
 ## 0.8.0 — 2026-05-08
 
 `@toist/in` is now the user-facing package: ships the `toist` CLI binary

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toist/in",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "type": "module",
   "description": "Adopt Toist into a repo: scaffold a Toist home or embedded .toist layout",
   "main": "./src/index.ts",
@@ -16,8 +16,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@toist/aja": "0.8.0",
-    "@toist/core": "0.8.0",
-    "@toist/spec": "0.8.0"
+    "@toist/aja": "0.8.1",
+    "@toist/core": "0.8.1",
+    "@toist/spec": "0.8.1"
   }
 }

package/src/cli.ts

@@ -62,6 +62,52 @@ interface CliTaskRef {
   responseToken: string
 }
 
+type NormalizedStepList = Array<Record<string, unknown>>
+
+type NormalizedRunResult =
+  | {
+    status: "done"
+    runId: number
+    output: unknown
+    steps: NormalizedStepList
+    results: Record<string, unknown>
+  }
+  | {
+    status: "suspended"
+    runId: number
+    suspendedAt: {
+      taskId: number
+      nodeId: string
+      cause: {
+        kind: "human.input" | "error_review"
+        spec: {
+          prompt: string
+          schema?: unknown
+          assignee?: string | null
+        }
+      }
+    }
+    task: {
+      id: number
+      kind: string
+      prompt: string
+      schema: unknown
+      assignee: string | null
+      responseToken: string
+    } | null
+    steps: NormalizedStepList
+    results: Record<string, unknown>
+  }
+  | {
+    status: "error"
+    runId: number
+    error: string
+    steps?: NormalizedStepList
+  }
+
+type PrintableRunResult = RunSpecResult | NormalizedRunResult
+type PrintableSuspendedRunResult = Extract<RunSpecResult, { status: "suspended" }> | Extract<NormalizedRunResult, { status: "suspended" }>
+
 function help() {
   console.log("toist <command> [options]\n")
   console.log("  init                        run setup wizard")
@@ -159,6 +205,70 @@ function parseJsonValue(value: string | null | undefined): unknown {
   try { return JSON.parse(value) } catch { return value }
 }
 
+function asCliTaskKind(kind: string): "human.input" | "error_review" {
+  if (kind !== "human.input" && kind !== "error_review") {
+    throw new Error(`unsupported task kind: ${kind}`)
+  }
+  return kind
+}
+
+async function fetchResultsMap(client: RunnerClient, runId: number): Promise<Record<string, unknown>> {
+  const nodes = await client.runs.nodes(runId)
+  const results: Record<string, unknown> = {}
+  for (const node of nodes) results[node.nodeId] = node.output
+  return results
+}
+
+async function normalizeRemoteRunResult(
+  client: RunnerClient,
+  response: PipelineRunResponse,
+): Promise<NormalizedRunResult> {
+  const base = {
+    runId: response.id,
+    status: response.status,
+    steps: ("steps" in response ? response.steps : []) as unknown as NormalizedStepList,
+  }
+
+  if (response.status === "done") {
+    return {
+      ...base,
+      status: "done",
+      output: response.result,
+      results: await fetchResultsMap(client, response.id),
+    }
+  }
+
+  if (response.status === "suspended") {
+    const task = response.task
+    if (!task) throw new Error(`remote run ${response.id} suspended without task payload`)
+
+    return {
+      ...base,
+      status: "suspended",
+      suspendedAt: {
+        taskId: task.id,
+        nodeId: response.suspendedAt,
+        cause: {
+          kind: asCliTaskKind(task.kind),
+          spec: {
+            prompt: task.prompt,
+            schema: task.schema,
+            assignee: task.assignee,
+          },
+        },
+      },
+      task,
+      results: await fetchResultsMap(client, response.id),
+    }
+  }
+
+  return {
+    ...base,
+    status: "error",
+    error: response.error,
+  }
+}
+
 async function waitForRemoteRun(client: RunnerClient, runId: number): Promise<PipelineRunResponse> {
   for (;;) {
     const run = await client.runs.get(runId)
@@ -320,12 +430,16 @@ async function promptTaskResponse(task: CliTaskRef): Promise<unknown> {
   }
 }
 
-function printFinalResult(result: RunSpecResult) {
-  const { events: _events, ...printable } = result
-  console.log(JSON.stringify(printable, null, 2))
+function printFinalResult(result: PrintableRunResult) {
+  if ("events" in result) {
+    const { events: _events, ...printable } = result
+    console.log(JSON.stringify(printable, null, 2))
+    return
+  }
+  console.log(JSON.stringify(result, null, 2))
 }
 
-function printSuspendAsJson(result: Extract<RunSpecResult, { status: "suspended" }>) {
+function printSuspendAsJson(result: PrintableSuspendedRunResult) {
   console.log(JSON.stringify({ runId: result.runId, suspendedAt: result.suspendedAt }, null, 2))
 }
 
@@ -414,20 +528,22 @@ async function runRemoteCommand(opts: RunCliOptions) {
 
   if (opts.suspendAsJson) {
     const final = await waitForRemoteRun(client, started.id)
-    if (final.status === "suspended") {
-      console.log(JSON.stringify({ runId: final.id, suspendedAt: final.suspendedAt }, null, 2))
+    const normalized = await normalizeRemoteRunResult(client, final)
+    if (normalized.status === "suspended") {
+      printSuspendAsJson(normalized)
       return
     }
-    console.log(JSON.stringify(final, null, 2))
-    if (final.status === "error") process.exit(1)
+    printFinalResult(normalized)
+    if (normalized.status === "error") process.exit(1)
     return
   }
 
   const eventsPromise = printRemoteRunEvents(client, started.id)
   const final = await waitForRemoteRun(client, started.id)
+  const normalized = await normalizeRemoteRunResult(client, final)
   await eventsPromise
-  console.log(JSON.stringify(final, null, 2))
-  if (final.status === "error") process.exit(1)
+  printFinalResult(normalized)
+  if (normalized.status === "error") process.exit(1)
 }
 
 async function runCommand(opts: RunCliOptions) {
@@ -577,7 +693,9 @@ async function answerTaskCommand(taskId: number, responseArg?: string, remote?:
       response,
       respondedBy: "cli",
     })
-    console.log(JSON.stringify(result, null, 2))
+    const normalized = await normalizeRemoteRunResult(client, result)
+    printFinalResult(normalized)
+    if (normalized.status === "error") process.exit(1)
     return
   }
 

package/templates/default/_package.json

@@ -7,7 +7,7 @@
     "dev": "bun --watch start.ts"
   },
   "dependencies": {
-    "@toist/aja": "^0.8.0",
-    "@toist/spec": "^0.8.0"
+    "@toist/aja": "^0.8.1",
+    "@toist/spec": "^0.8.1"
   }
 }