@vincemakes/kiso-core 0.45.3 → 0.46.0

package/dist/kernel/loop.d.ts

@@ -33,7 +33,7 @@
  * re-stream that duplicates output or tool calls.
  */
 import { type Adapter, type AbortSignalLike } from "../protocol/adapter.js";
-import type { ContinuationScope, Event, StructuredError, UserInputVia } from "../protocol/events.js";
+import { type ContinuationScope, type Event, type StructuredError, type UserInputVia } from "../protocol/events.js";
 import type { ApprovalChain } from "../protocol/extension.js";
 import { EventLog } from "./event-log.js";
 import type { EventInput } from "./event-log.js";

package/dist/kernel/loop.js

@@ -33,6 +33,7 @@
  * re-stream that duplicates output or tool calls.
  */
 import { isAdapterEvent } from "../protocol/adapter.js";
+import { isRuntimeInput } from "../protocol/events.js";
 import { ERROR_CODES } from "../protocol/error-codes.js";
 import { EventLog } from "./event-log.js";
 import { ToolRegistry } from "../tools/registry.js";
@@ -161,8 +162,9 @@ export async function* loop(config) {
     }
     if (hooks.onUserMessage && messages.length > 0) {
         const last = messages.at(-1);
-        if (last?.role === "user") {
-            const inputEvent = [...log.all].reverse().find((e) => e.type === "user_input");
+        const inputEvent = [...log.all].reverse().find((e) => e.type === "user_input");
+        // ADR-0058 (3c): a wake run's first input is the runtime's — as at an admission site, no hook
+        if (last?.role === "user" && !isRuntimeInput(inputEvent)) {
             // round 6: the hook runs AT MOST ONCE per input. A replacement that
             // ALREADY exists (persisted before a crash, or before a resume)
             // means the hook already spoke for this input — it must never

package/dist/protocol/events.d.ts

@@ -151,17 +151,31 @@ export interface UserInputEvent {
     readonly content: string | readonly import("./messages.js").ContentBlock[];
     /** Provenance of the prompt (Area 6) — preserved losslessly. */
     readonly source?: import("./messages.js").MessageSource;
-    /** 0.40.0 (ADR-0051 §5 rule 1): how a PERSON's turn was composed — a
-     *  skill they invoked, and the line they typed. Display provenance only:
-     *  `content` is what the model receives and the projection never reads
-     *  this, so no byte of it reaches a request. */
+    /** How the input entered the trajectory — a PERSON's skill invocation
+     *  (0.40.0, ADR-0051 Amendment 7), or a runtime delivery of task
+     *  transitions (ADR-0051 Amendment 8, the delivery's durable receipt).
+     *  Display and receipt provenance only: `content` is what the model
+     *  receives and the projection never reads this, so no byte of it
+     *  reaches a request. */
     readonly via?: UserInputVia;
 }
-export interface UserInputVia {
+export type UserInputVia = {
     readonly kind: "skill";
     readonly name: string;
     readonly line: string;
+} | {
+    readonly kind: "tasks";
+    readonly items: readonly TaskDeliveryItem[];
+};
+export interface TaskDeliveryItem {
+    readonly taskId: string;
+    readonly transition: "ready" | "exited" | "failed" | "stopped" | "unknown";
 }
+/** An input the runtime owes the model (a task notice) — never a person's,
+ *  so it never passes onUserMessage (ADR-0057 §4, a wake run included). */
+export declare const isRuntimeInput: (e: {
+    readonly via?: UserInputVia;
+} | undefined) => boolean;
 /**
  * Compaction happened at this point in the trajectory. The EXACT
  * replacements are persisted; the projection applies them verbatim — it

package/dist/protocol/events.js

@@ -30,6 +30,9 @@
  * is a compile error in the adapters' exhaustive switches.
  */
 import { ERROR_CODES } from "./error-codes.js";
+/** An input the runtime owes the model (a task notice) — never a person's,
+ *  so it never passes onUserMessage (ADR-0057 §4, a wake run included). */
+export const isRuntimeInput = (e) => e?.via?.kind === "tasks";
 // ── deep-shape helpers (round 5): every variant is validated field by field —
 // legal enums, Terminal union members, Usage known/token combos, content
 // blocks, plain-object inputs, optional fields when present. A record that
@@ -90,11 +93,17 @@ function isContent(v) {
 function isSource(v) {
     return v.source === undefined || MESSAGE_SOURCES.has(v.source);
 }
+const TASK_TRANSITIONS = new Set(["ready", "exited", "failed", "stopped", "unknown"]);
 function isVia(v) {
     if (v.via === undefined)
         return true;
     const via = v.via;
-    return isPlainObject(via) && via.kind === "skill" && typeof via.name === "string" && via.name !== "" && typeof via.line === "string" && via.line !== "";
+    if (!isPlainObject(via))
+        return false;
+    if (via.kind === "skill")
+        return typeof via.name === "string" && via.name !== "" && typeof via.line === "string" && via.line !== "";
+    const items = via.items;
+    return via.kind === "tasks" && Array.isArray(items) && items.length > 0 && items.every((i) => isPlainObject(i) && typeof i.taskId === "string" && i.taskId !== "" && TASK_TRANSITIONS.has(i.transition));
 }
 function isTags(v) {
     return v.tags === undefined || (Array.isArray(v.tags) && v.tags.every((t) => typeof t === "string"));

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-core",
-	"version": "0.45.3",
+	"version": "0.46.0",
 	"description": "kiso core \u2014 protocol, event log, loop, hooks, modes, permissions, compaction, delivery truth. The 2,000-line kernel at the bottom of the kiso framework.",
 	"type": "module",
 	"license": "MIT",
@@ -33,7 +33,7 @@
 		"openai"
 	],
 	"devDependencies": {
-		"@vincemakes/kiso-evals": "0.45.3",
+		"@vincemakes/kiso-evals": "0.46.0",
 		"@types/node": "^26.1.2",
 		"typescript": "^5.7.2",
 		"vitest": "^3.0.0"