@vincemakes/kiso-runtime 0.51.1 → 0.52.0

package/dist/index.d.ts

@@ -31,9 +31,13 @@ export { SessionStore, StaleWriterError, StoreCorruptionError } from "./store.js
 export type { Event, SessionMeta, StoreRecord } from "./store.js";
 export { disposeExtensions, loadExtensions, loadProjectExtensions } from "./extensions.js";
 export type { KisoExtension } from "./extensions.js";
+export { TaskManager } from "./tasks/manager.js";
+export type { TaskInfo, TaskListener, TaskTransition } from "./tasks/manager.js";
+export type { TaskState } from "./tasks/journal.js";
 export { executionForCallId, executionLedger } from "./ledger.js";
 export type { ExecutionRecord, ExecutionStatus } from "./ledger.js";
 export { kisoHome, projectArtifacts, recordTrust, trustFor } from "./trust.js";
 export type { ProjectArtifact, ProjectArtifacts, TrustDecision, TrustRecord } from "./trust.js";
+export { runsACheck } from "./compaction-policy.js";
 export { canonicalizeUsage } from "./usage/canonical.js";
 export { estimateTokens } from "./estimate-tokens.js";

package/dist/index.js

@@ -31,10 +31,16 @@ export { Run, RunClosedError } from "./run.js";
 export { SessionStore, StaleWriterError, StoreCorruptionError } from "./store.js";
 // extensions
 export { disposeExtensions, loadExtensions, loadProjectExtensions } from "./extensions.js";
+// tasks (ADR-0058): a host that wires background tasks needs the manager
+export { TaskManager } from "./tasks/manager.js";
 // ledger
 export { executionForCallId, executionLedger } from "./ledger.js";
 // trust
 export { kisoHome, projectArtifacts, recordTrust, trustFor } from "./trust.js";
+// compaction — the phase rule's test-runner check, for a host that sets its
+// own `contextPolicy.tiers.isCheck` (the terminal puts the person's configured
+// `checks` in front of the built-in runner table).
+export { runsACheck } from "./compaction-policy.js";
 // usage — the canonical accounting schema (E2/1.3.0, R4b-1 ruling:
 // additive minor, one function; the signature is frozen the moment this
 // line lands — changing it is a MAJOR ritual). R5b-④a set the final

package/dist/tasks/journal.d.ts

@@ -78,6 +78,15 @@ export type TaskRecord = {
     readonly ts: number;
     readonly pids: readonly number[];
 }
+/** An adopted command whose hand-over to the task failed after the task
+ *  was recorded (its output could not be prepared). The command is
+ *  running — it was never "not run" — and nothing here owns its end: the
+ *  verdict is `unknown`, and no terminal is written for it. */
+ | {
+    readonly type: "handover_failed";
+    readonly ts: number;
+    readonly reason: string;
+}
 /** `error`: the command never started (no shell, a missing cwd) — then
  *  there is no exit code and none is invented. */
  | {

package/dist/tasks/journal.js

@@ -111,6 +111,11 @@ export function verdictOf(records, runnerAlive, now = Date.now()) {
     const planned = records.find((r) => r.type === "planned");
     if (planned === undefined)
         return { kind: "not_run" };
+    // a stop that left survivors, or a hand-over that failed, after the command
+    // ran: its end is not known, whether or not whoever recorded that is still
+    // alive (an adopted task's owner is the kiso itself)
+    if (has("command_started") && (has("stop_unconfirmed") || has("handover_failed")))
+        return { kind: "unknown" };
     if (has("command_started"))
         return runnerAlive ? { kind: "running", ready: has("ready") } : { kind: "unknown" };
     if (has("runner_started"))

package/dist/tasks/manager.d.ts

@@ -132,8 +132,13 @@ export interface AdoptedTask {
     readonly outputPath: string;
     ready(match: string): void;
     ended(exitCode: number | null, signal: string | null): void;
-    /** A stop left these pids alive: no terminal — the task stays `unknown`. */
+    /** A stop left these pids alive: no terminal — the task is `unknown`. An
+     *  empty list means survivors that could not be named. */
     unconfirmed(pids: readonly number[]): void;
+    /** The hand-over failed after the task was recorded: the command still
+     *  runs, under the caller. No terminal — the task is `unknown`, with the
+     *  reason on record. */
+    handoverFailed(reason: string): void;
 }
 /** Who moved a running foreground command to the background (3e). */
 export type DetachBy = "person" | "steer";

package/dist/tasks/manager.js

@@ -199,6 +199,11 @@ export class TaskManager {
                     return;
                 appendRecord(journal, { type: "stop_unconfirmed", ts: Date.now(), pids });
             },
+            handoverFailed: (reason) => {
+                if (!this.#local.delete(id))
+                    return;
+                appendRecord(journal, { type: "handover_failed", ts: Date.now(), reason });
+            },
         };
     }
     /** Every task of the session, oldest first. */
@@ -367,9 +372,12 @@ export class TaskManager {
         const asked = live.filter((id) => this.stop(id, by));
         const deadline = Date.now() + graceMs;
         let left = asked;
-        while (left.length > 0 && Date.now() < deadline) {
+        // a stop answered "unknown" will not change: not waited for any more, still reported
+        let waiting = asked;
+        while (waiting.length > 0 && Date.now() < deadline) {
             await new Promise((r) => setTimeout(r, 100));
             left = left.filter((id) => kindOf(id) !== "ended");
+            waiting = waiting.filter((id) => kindOf(id) !== "ended" && kindOf(id) !== "unknown");
         }
         return left;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-runtime",
-	"version": "0.51.1",
+	"version": "0.52.0",
 	"description": "kiso runtime \u2014 durable multi-turn agent sessions: AgentDefinition, AgentRuntime, AgentSession, Run, append-only JSONL store.",
 	"type": "module",
 	"license": "MIT",
@@ -25,12 +25,12 @@
 		"test": "vitest run"
 	},
 	"dependencies": {
-		"@vincemakes/kiso-core": "0.51.1"
+		"@vincemakes/kiso-core": "0.52.0"
 	},
 	"peerDependencies": {
-		"@vincemakes/kiso-provider-anthropic": "0.51.1",
-		"@vincemakes/kiso-provider-openai": "0.51.1",
-		"@vincemakes/kiso-provider-openai-responses": "0.51.1"
+		"@vincemakes/kiso-provider-anthropic": "0.52.0",
+		"@vincemakes/kiso-provider-openai": "0.52.0",
+		"@vincemakes/kiso-provider-openai-responses": "0.52.0"
 	},
 	"peerDependenciesMeta": {
 		"@vincemakes/kiso-provider-anthropic": {
@@ -44,7 +44,7 @@
 		}
 	},
 	"devDependencies": {
-		"@vincemakes/kiso-evals": "0.51.1",
+		"@vincemakes/kiso-evals": "0.52.0",
 		"@types/node": "^26.1.2",
 		"typescript": "^5.7.2",
 		"vitest": "^3.0.0"