@vincemakes/kiso-runtime 0.51.0 → 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/lock-adapter.js

@@ -183,6 +183,16 @@ function unavailable(err) {
     return new LockUnavailableError(`${e.code ?? "?"}: ${e.message}`);
 }
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * The tokens of the lock handles THIS process holds, or is in the middle of
+ * publishing. A lock naming our pid is a same-process writer's residue only
+ * when its token is in here; any other token was left by a PREVIOUS process
+ * that had the same pid — in a container node is pid 1, so a SIGKILLed
+ * container's lock names the next container's pid too. Kept on globalThis so
+ * a second copy of this module in the same process shares one answer.
+ */
+const HELD_KEY = Symbol.for("kiso.lock-adapter.held-tokens");
+const held = (globalThis[HELD_KEY] ??= new Set());
 class NativeLockHandle {
     pid;
     token;
@@ -205,6 +215,7 @@ class NativeLockHandle {
         if (this.#released)
             return;
         this.#released = true;
+        held.delete(this.token);
         try {
             renameSync(this.#lockPath, this.#tombstone);
         }
@@ -258,8 +269,20 @@ class NativeLockHandle {
 class NativeLock {
     name = "link-lock";
     async acquire(lockPath, sessionId, cancelled) {
-        const pid = process.pid;
+        // Our token is registered before any file can name it; a handle's
+        // release drops it, and a failed acquire drops it here.
         const token = randomUUID();
+        held.add(token);
+        try {
+            return await this.#take(lockPath, sessionId, cancelled, token);
+        }
+        catch (err) {
+            held.delete(token);
+            throw err;
+        }
+    }
+    async #take(lockPath, sessionId, cancelled, token) {
+        const pid = process.pid;
         // The staging name is PER-ATTEMPT: a later rename-away in the same
         // acquire must never atomically overwrite an earlier attempt's
         // abandoned staging (that would clobber the displacement residue,
@@ -276,7 +299,11 @@ class NativeLock {
             cancelled();
             const staging = `${lockPath}.staging-${pid}-${token}-${attempt}`;
             const seen = readLockIdentity(lockPath);
-            if (seen === null || seen.pid === undefined || !isAlive(seen.pid)) {
+            // A lock naming OUR pid with a token this process never issued is a
+            // previous process's (a killed container's node was pid 1 too): a
+            // dead holder, however alive the pid looks.
+            const stalePid = seen !== null && seen.pid === pid && seen.token !== undefined && !held.has(seen.token);
+            if (seen === null || seen.pid === undefined || stalePid || !isAlive(seen.pid)) {
                 // Fresh path, dead holder, or stale residue — take it over
                 // by identity confirmation: rename-away → verify → link.
                 if (readyDir !== undefined)
@@ -366,8 +393,8 @@ class NativeLock {
                 return new NativeLockHandle(lockPath, tombstone, { pid, token });
             }
             if (seen.pid === pid && seen.token !== undefined) {
-                // Same-process writer's residue (round 5): another store in
-                // THIS process holds the lock — it will release; retry until
+                // Same-process writer (round 5): another store in THIS process
+                // holds the lock (its token is in `held`) — it will release; retry until
                 // it does (never a spurious self-conflict). A legacy
                 // bare-pid lock naming our own process is refused like any
                 // live foreign owner.

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.0",
+	"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.0"
+		"@vincemakes/kiso-core": "0.52.0"
 	},
 	"peerDependencies": {
-		"@vincemakes/kiso-provider-anthropic": "0.51.0",
-		"@vincemakes/kiso-provider-openai": "0.51.0",
-		"@vincemakes/kiso-provider-openai-responses": "0.51.0"
+		"@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.0",
+		"@vincemakes/kiso-evals": "0.52.0",
 		"@types/node": "^26.1.2",
 		"typescript": "^5.7.2",
 		"vitest": "^3.0.0"