@deepstrike/wasm 0.2.77 → 0.2.79

package/dist/runtime/session-event-registry.generated.d.ts

@@ -0,0 +1,212 @@
+export declare const SESSION_EVENT_REGISTRY: {
+    readonly run_started: {
+        readonly required: readonly ["criteria", "goal", "run_id"];
+        readonly optional: readonly ["agent_id", "attachments", "metadata", "route", "system_prompt"];
+    };
+    readonly llm_completed: {
+        readonly required: readonly ["content", "tool_calls", "turn"];
+        readonly optional: readonly ["effect_id", "invocation_id", "token_count", "wire_evidence"];
+    };
+    readonly prompt_measured: {
+        readonly required: readonly ["measurement", "turn"];
+        readonly optional: readonly ["effect_id"];
+    };
+    readonly provider_attempt: {
+        readonly required: readonly ["attempt_seq", "effect_id", "finished_at_ms", "request_fingerprint", "route", "started_at_ms", "status", "transport_rungs"];
+        readonly optional: readonly ["accounting_policy_id", "last_error_class", "usage", "wire_evidence"];
+    };
+    readonly tool_requested: {
+        readonly required: readonly ["calls", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly tool_completed: {
+        readonly required: readonly ["results", "turn"];
+        readonly optional: readonly ["effect_id"];
+    };
+    readonly tool_argument_repaired: {
+        readonly required: readonly ["original_arguments", "repaired_arguments", "tool", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly tool_denied: {
+        readonly required: readonly ["call_id", "reason", "tool_name", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly permission_requested: {
+        readonly required: readonly ["arguments", "tool", "turn"];
+        readonly optional: readonly ["reason"];
+    };
+    readonly permission_resolved: {
+        readonly required: readonly ["approved", "responder", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly compressed: {
+        readonly required: readonly ["archived_seq_range", "turn"];
+        readonly optional: readonly ["action", "preserved_refs", "summary", "summary_tokens"];
+    };
+    readonly page_out: {
+        readonly required: readonly ["turn"];
+        readonly optional: readonly ["action", "archive_ref", "message_count", "summary", "tier_hint"];
+    };
+    readonly semantic_archive_pending: {
+        readonly required: readonly ["effect_id"];
+        readonly optional: readonly ["action"];
+    };
+    readonly semantic_archive_completed: {
+        readonly required: readonly ["effect_id", "record_id"];
+        readonly optional: readonly [];
+    };
+    readonly semantic_archive_failed: {
+        readonly required: readonly ["effect_id", "error"];
+        readonly optional: readonly [];
+    };
+    readonly page_in: {
+        readonly required: readonly ["entry_count", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly rollbacked: {
+        readonly required: readonly ["checkpoint_history_len", "turn"];
+        readonly optional: readonly ["reason"];
+    };
+    readonly capability_changed: {
+        readonly required: readonly ["added", "removed", "turn"];
+        readonly optional: readonly ["capability_id", "change_kind", "mount_reason", "mounted_by", "version"];
+    };
+    readonly context_renewed: {
+        readonly required: readonly ["handoff_ref", "sprint", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly context_lifecycle_reported: {
+        readonly required: readonly ["cache_loss_tokens", "knowledge_entries", "knowledge_referenced", "recall_expanded", "recalled", "regret", "turn", "waste_tokens"];
+        readonly optional: readonly ["history", "history_items", "history_items_omitted", "items"];
+    };
+    readonly suspended: {
+        readonly required: readonly ["reason", "turn"];
+        readonly optional: readonly ["pending_calls"];
+    };
+    readonly resumed: {
+        readonly required: readonly ["turn"];
+        readonly optional: readonly ["approved", "denied"];
+    };
+    readonly tool_gated: {
+        readonly required: readonly ["call_id", "reason", "tool", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly signal_delivery_disposed: {
+        readonly required: readonly ["attempt", "delivery_id", "disposition", "operation_id", "queue_depth", "signal_id", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly budget_exceeded: {
+        readonly required: readonly ["budget", "operation_id", "turn"];
+        readonly optional: readonly ["reservation_id"];
+    };
+    readonly budget_usage_reported: {
+        readonly required: readonly ["operation_id", "reservation_id", "rounds", "subagents", "tokens", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly operation_cancelled: {
+        readonly required: readonly ["operation_id", "pending_call_ids", "reason", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly milestone_advanced: {
+        readonly required: readonly ["capabilities_unlocked", "phase_id", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly milestone_blocked: {
+        readonly required: readonly ["phase_id", "reason", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly checkpoint_taken: {
+        readonly required: readonly ["history_len", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly entropy_sample: {
+        readonly required: readonly ["failure_rate", "repeat_pressure", "rho", "rollbacks_in_window", "score", "turn", "window_turns"];
+        readonly optional: readonly [];
+    };
+    readonly entropy_alert: {
+        readonly required: readonly ["score", "threshold", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly agent_process_changed: {
+        readonly required: readonly ["agent_id", "context_inheritance", "isolation", "permitted_capability_ids", "role", "turn"];
+        readonly optional: readonly ["parent_session_id", "parent_task_id", "result_termination", "state"];
+    };
+    readonly memory_written: {
+        readonly required: readonly ["memory_kind", "name", "record_id", "scope", "size_bytes", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly memory_queried: {
+        readonly required: readonly ["query", "requested_k", "requires_async_response", "scope", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly memory_validation_failed: {
+        readonly required: readonly ["error", "record_id", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly memory_write_failed: {
+        readonly required: readonly ["error", "record_id", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly memory_candidate_pending: {
+        readonly required: readonly ["candidate_id", "name", "source", "turn"];
+        readonly optional: readonly ["receipt_id"];
+    };
+    readonly memory_candidate_rejected: {
+        readonly required: readonly ["candidate_id", "name", "reason_code", "receipt_id", "source", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly memory_query_failed: {
+        readonly required: readonly ["error", "query", "scope", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly memory_retrieval_result: {
+        readonly required: readonly ["hits"];
+        readonly optional: readonly [];
+    };
+    readonly workflow_node_completed: {
+        readonly required: readonly ["agent_id", "status", "termination", "turn"];
+        readonly optional: readonly ["output"];
+    };
+    readonly workflow_nodes_submitted: {
+        readonly required: readonly ["nodes", "turn"];
+        readonly optional: readonly ["base_index", "submitter_agent_id"];
+    };
+    readonly workflow_batch_spawned: {
+        readonly required: readonly ["node_count", "node_ids", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly workflow_completed: {
+        readonly required: readonly ["node_outcomes", "total_nodes", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly kernel_observation: {
+        readonly required: readonly ["observation_kind", "raw", "turn"];
+        readonly optional: readonly [];
+    };
+    readonly run_terminal: {
+        readonly required: readonly ["reason", "total_tokens", "turns_used"];
+        readonly optional: readonly [];
+    };
+    readonly summary_upgraded: {
+        readonly required: readonly ["compressed_seq", "summary"];
+        readonly optional: readonly [];
+    };
+    readonly group_member_joined: {
+        readonly required: readonly ["session_id"];
+        readonly optional: readonly ["member_kind", "role"];
+    };
+    readonly group_budget_charged: {
+        readonly required: readonly ["subagents", "tokens"];
+        readonly optional: readonly ["rounds"];
+    };
+    readonly round_started: {
+        readonly required: readonly ["goal", "round"];
+        readonly optional: readonly [];
+    };
+    readonly round_paced: {
+        readonly required: readonly ["action", "reason", "round"];
+        readonly optional: readonly ["coerced_from", "delay_ms", "wake_at_ms"];
+    };
+};
+/** Registered kinds in registry order. */
+export declare const SESSION_EVENT_KINDS: readonly ["run_started", "llm_completed", "prompt_measured", "provider_attempt", "tool_requested", "tool_completed", "tool_argument_repaired", "tool_denied", "permission_requested", "permission_resolved", "compressed", "page_out", "semantic_archive_pending", "semantic_archive_completed", "semantic_archive_failed", "page_in", "rollbacked", "capability_changed", "context_renewed", "context_lifecycle_reported", "suspended", "resumed", "tool_gated", "signal_delivery_disposed", "budget_exceeded", "budget_usage_reported", "operation_cancelled", "milestone_advanced", "milestone_blocked", "checkpoint_taken", "entropy_sample", "entropy_alert", "agent_process_changed", "memory_written", "memory_queried", "memory_validation_failed", "memory_write_failed", "memory_candidate_pending", "memory_candidate_rejected", "memory_query_failed", "memory_retrieval_result", "workflow_node_completed", "workflow_nodes_submitted", "workflow_batch_spawned", "workflow_completed", "kernel_observation", "run_terminal", "summary_upgraded", "group_member_joined", "group_budget_charged", "round_started", "round_paced"];

package/dist/runtime/session-event-registry.generated.js

@@ -0,0 +1,112 @@
+// GENERATED by scripts/gen-session-event-registry.mjs from contracts/session-events.json.
+// Do not edit: change the registry and regenerate. `session-log.ts` asserts at compile time
+// that the SessionEvent union matches these kinds and fields exactly.
+export const SESSION_EVENT_REGISTRY = {
+    run_started: { required: ["criteria", "goal", "run_id"], optional: ["agent_id", "attachments", "metadata", "route", "system_prompt"] },
+    llm_completed: { required: ["content", "tool_calls", "turn"], optional: ["effect_id", "invocation_id", "token_count", "wire_evidence"] },
+    prompt_measured: { required: ["measurement", "turn"], optional: ["effect_id"] },
+    provider_attempt: { required: ["attempt_seq", "effect_id", "finished_at_ms", "request_fingerprint", "route", "started_at_ms", "status", "transport_rungs"], optional: ["accounting_policy_id", "last_error_class", "usage", "wire_evidence"] },
+    tool_requested: { required: ["calls", "turn"], optional: [] },
+    tool_completed: { required: ["results", "turn"], optional: ["effect_id"] },
+    tool_argument_repaired: { required: ["original_arguments", "repaired_arguments", "tool", "turn"], optional: [] },
+    tool_denied: { required: ["call_id", "reason", "tool_name", "turn"], optional: [] },
+    permission_requested: { required: ["arguments", "tool", "turn"], optional: ["reason"] },
+    permission_resolved: { required: ["approved", "responder", "turn"], optional: [] },
+    compressed: { required: ["archived_seq_range", "turn"], optional: ["action", "preserved_refs", "summary", "summary_tokens"] },
+    page_out: { required: ["turn"], optional: ["action", "archive_ref", "message_count", "summary", "tier_hint"] },
+    semantic_archive_pending: { required: ["effect_id"], optional: ["action"] },
+    semantic_archive_completed: { required: ["effect_id", "record_id"], optional: [] },
+    semantic_archive_failed: { required: ["effect_id", "error"], optional: [] },
+    page_in: { required: ["entry_count", "turn"], optional: [] },
+    rollbacked: { required: ["checkpoint_history_len", "turn"], optional: ["reason"] },
+    capability_changed: { required: ["added", "removed", "turn"], optional: ["capability_id", "change_kind", "mount_reason", "mounted_by", "version"] },
+    context_renewed: { required: ["handoff_ref", "sprint", "turn"], optional: [] },
+    context_lifecycle_reported: { required: ["cache_loss_tokens", "knowledge_entries", "knowledge_referenced", "recall_expanded", "recalled", "regret", "turn", "waste_tokens"], optional: ["history", "history_items", "history_items_omitted", "items"] },
+    suspended: { required: ["reason", "turn"], optional: ["pending_calls"] },
+    resumed: { required: ["turn"], optional: ["approved", "denied"] },
+    tool_gated: { required: ["call_id", "reason", "tool", "turn"], optional: [] },
+    signal_delivery_disposed: { required: ["attempt", "delivery_id", "disposition", "operation_id", "queue_depth", "signal_id", "turn"], optional: [] },
+    budget_exceeded: { required: ["budget", "operation_id", "turn"], optional: ["reservation_id"] },
+    budget_usage_reported: { required: ["operation_id", "reservation_id", "rounds", "subagents", "tokens", "turn"], optional: [] },
+    operation_cancelled: { required: ["operation_id", "pending_call_ids", "reason", "turn"], optional: [] },
+    milestone_advanced: { required: ["capabilities_unlocked", "phase_id", "turn"], optional: [] },
+    milestone_blocked: { required: ["phase_id", "reason", "turn"], optional: [] },
+    checkpoint_taken: { required: ["history_len", "turn"], optional: [] },
+    entropy_sample: { required: ["failure_rate", "repeat_pressure", "rho", "rollbacks_in_window", "score", "turn", "window_turns"], optional: [] },
+    entropy_alert: { required: ["score", "threshold", "turn"], optional: [] },
+    agent_process_changed: { required: ["agent_id", "context_inheritance", "isolation", "permitted_capability_ids", "role", "turn"], optional: ["parent_session_id", "parent_task_id", "result_termination", "state"] },
+    memory_written: { required: ["memory_kind", "name", "record_id", "scope", "size_bytes", "turn"], optional: [] },
+    memory_queried: { required: ["query", "requested_k", "requires_async_response", "scope", "turn"], optional: [] },
+    memory_validation_failed: { required: ["error", "record_id", "turn"], optional: [] },
+    memory_write_failed: { required: ["error", "record_id", "turn"], optional: [] },
+    memory_candidate_pending: { required: ["candidate_id", "name", "source", "turn"], optional: ["receipt_id"] },
+    memory_candidate_rejected: { required: ["candidate_id", "name", "reason_code", "receipt_id", "source", "turn"], optional: [] },
+    memory_query_failed: { required: ["error", "query", "scope", "turn"], optional: [] },
+    memory_retrieval_result: { required: ["hits"], optional: [] },
+    workflow_node_completed: { required: ["agent_id", "status", "termination", "turn"], optional: ["output"] },
+    workflow_nodes_submitted: { required: ["nodes", "turn"], optional: ["base_index", "submitter_agent_id"] },
+    workflow_batch_spawned: { required: ["node_count", "node_ids", "turn"], optional: [] },
+    workflow_completed: { required: ["node_outcomes", "total_nodes", "turn"], optional: [] },
+    kernel_observation: { required: ["observation_kind", "raw", "turn"], optional: [] },
+    run_terminal: { required: ["reason", "total_tokens", "turns_used"], optional: [] },
+    summary_upgraded: { required: ["compressed_seq", "summary"], optional: [] },
+    group_member_joined: { required: ["session_id"], optional: ["member_kind", "role"] },
+    group_budget_charged: { required: ["subagents", "tokens"], optional: ["rounds"] },
+    round_started: { required: ["goal", "round"], optional: [] },
+    round_paced: { required: ["action", "reason", "round"], optional: ["coerced_from", "delay_ms", "wake_at_ms"] },
+};
+/** Registered kinds in registry order. */
+export const SESSION_EVENT_KINDS = [
+    "run_started",
+    "llm_completed",
+    "prompt_measured",
+    "provider_attempt",
+    "tool_requested",
+    "tool_completed",
+    "tool_argument_repaired",
+    "tool_denied",
+    "permission_requested",
+    "permission_resolved",
+    "compressed",
+    "page_out",
+    "semantic_archive_pending",
+    "semantic_archive_completed",
+    "semantic_archive_failed",
+    "page_in",
+    "rollbacked",
+    "capability_changed",
+    "context_renewed",
+    "context_lifecycle_reported",
+    "suspended",
+    "resumed",
+    "tool_gated",
+    "signal_delivery_disposed",
+    "budget_exceeded",
+    "budget_usage_reported",
+    "operation_cancelled",
+    "milestone_advanced",
+    "milestone_blocked",
+    "checkpoint_taken",
+    "entropy_sample",
+    "entropy_alert",
+    "agent_process_changed",
+    "memory_written",
+    "memory_queried",
+    "memory_validation_failed",
+    "memory_write_failed",
+    "memory_candidate_pending",
+    "memory_candidate_rejected",
+    "memory_query_failed",
+    "memory_retrieval_result",
+    "workflow_node_completed",
+    "workflow_nodes_submitted",
+    "workflow_batch_spawned",
+    "workflow_completed",
+    "kernel_observation",
+    "run_terminal",
+    "summary_upgraded",
+    "group_member_joined",
+    "group_budget_charged",
+    "round_started",
+    "round_paced",
+];

package/dist/runtime/session-log.d.ts

@@ -1,4 +1,4 @@
-import type { ContextPrepared } from "./context.js";
+import { SESSION_EVENT_REGISTRY } from "./session-event-registry.generated.js";
 import type { ProviderWireEvidence, ToolCall, ToolErrorKind } from "../types.js";
 import type { MemoryRecall, MemoryScope } from "../memory/index.js";
 import type { KernelPrimitive } from "./kernel-event-log.js";
@@ -42,6 +42,42 @@ export interface ProviderAttemptRecord {
     wire_evidence?: ProviderWireEvidence;
     accounting_policy_id?: string;
 }
+/** History items of one origin in a `context_lifecycle_reported` event (plan task 4.1). */
+export interface ContextOriginTally {
+    origin: ContextItemRecord["origin"];
+    items: number;
+    tokens: number;
+    resident_items?: number;
+    resident_tokens?: number;
+    read_back?: number;
+}
+/** One knowledge item's lifecycle in a `context_lifecycle_reported` event (plan task 4.1). */
+export interface ContextItemRecord {
+    key?: string;
+    origin: "system" | "skill" | "memory_recall" | "reference" | "tool_result" | "dependency_output" | "user" | "assistant" | "task_state" | "signal" | "provider_summary";
+    tokens: number;
+    value: {
+        injected_turn: number;
+        ref_count: number;
+        last_referenced_step?: number;
+        last_referenced_turn?: number;
+        expanded?: boolean;
+        paged_in_after_evict?: boolean;
+    };
+    /** Why it left; absent while resident. */
+    end?: "evicted" | "expired" | "removed" | "compacted" | "renewed";
+}
+/** One history item's lifecycle in a `context_lifecycle_reported` event (plan task 4.1). */
+export interface ContextHistoryItemRecord {
+    id: number;
+    origin: ContextItemRecord["origin"];
+    tokens: number;
+    injected_turn: number;
+    /** What it rendered when it left, or renders now; absent = full. */
+    fidelity?: "structured" | "excerpt" | "handle";
+    /** Why it left; absent while still in history. */
+    end?: "removed" | "compacted" | "renewed";
+}
 export type SessionEvent = {
     kind: "run_started";
     run_id: string;
@@ -51,6 +87,7 @@ export type SessionEvent = {
     system_prompt?: string;
     attachments?: import("../types.js").ContentPart[];
     route?: ResolvedProviderRoute;
+    metadata?: Record<string, unknown>;
 } | {
     kind: "llm_completed";
     turn: number;
@@ -60,11 +97,6 @@ export type SessionEvent = {
     effect_id?: string;
     invocation_id?: string;
     wire_evidence?: ProviderWireEvidence;
-} | {
-    kind: "context_prepared";
-    turn: number;
-    effect_id: string;
-    preparation: ContextPrepared;
 } | {
     kind: "prompt_measured";
     turn: number;
@@ -166,6 +198,24 @@ export type SessionEvent = {
     turn: number;
     sprint: number;
     handoff_ref: string;
+} | {
+    kind: "context_lifecycle_reported";
+    turn: number;
+    knowledge_entries: number;
+    knowledge_referenced: number;
+    regret: number;
+    waste_tokens: number;
+    cache_loss_tokens: number;
+    /** Memory records the kernel recalled, and how many the model read with `memory(record_id)`. */
+    recalled: number;
+    recall_expanded: number;
+    /** Every knowledge item of the run. Absent when the run had none. */
+    items?: ContextItemRecord[];
+    /** History items by origin: admitted, still in history at the end, read back with `read_result`. */
+    history?: ContextOriginTally[];
+    /** The latest history items one by one (at most 128); older ones are only counted. */
+    history_items?: ContextHistoryItemRecord[];
+    history_items_omitted?: number;
 } | {
     kind: "suspended";
     turn: number;
@@ -277,6 +327,26 @@ export type SessionEvent = {
     turn: number;
     record_id: string;
     error: string;
+}
+/** M2 · a write handed to the candidate sink and held for review: nothing is remembered yet.
+ *  `receipt_id` is absent when the fact comes from the kernel's own observation. */
+ | {
+    kind: "memory_candidate_pending";
+    turn: number;
+    candidate_id: string;
+    source: string;
+    name: string;
+    receipt_id?: string;
+}
+/** M2 · the candidate sink refused the write. */
+ | {
+    kind: "memory_candidate_rejected";
+    turn: number;
+    candidate_id: string;
+    source: string;
+    name: string;
+    receipt_id: string;
+    reason_code: string;
 } | {
     kind: "memory_query_failed";
     turn: number;
@@ -292,11 +362,6 @@ export type SessionEvent = {
     agent_id: string;
     status: import("./types/agent.js").WorkflowNodeStatus;
     termination: string;
-    /** W-1: result-borne control signals, persisted so resume replays control flow faithfully —
-     *  a classifier re-prunes its rejected branches, a recorded loop stop is honored. */
-    classify_branch?: string;
-    tournament_winner?: string;
-    loop_continue?: boolean;
     output?: import("../types.js").ModelMessage;
 } | {
     kind: "workflow_nodes_submitted";
@@ -360,12 +425,14 @@ export type SessionEvent = {
 };
 export type SessionEventKind = SessionEvent["kind"];
 /**
- * The registered session-event vocabulary (F9 / S3, P7-S4). This list must equal the Node SDK's
- * `SESSION_EVENT_KINDS` — the cross-SDK manifest fixture
- * `tests/fixtures/sdk-conformance/canonical/session-event-vocabulary.json` pins both, and any
- * same-commit desync turns conformance red. Declared in `SessionEvent` union order.
+ * The registered session-event vocabulary (F9 / S3, P7-S4). The authority is
+ * `contracts/session-events.json`; `session-event-registry.generated.ts` is generated from it
+ * (`node scripts/gen-session-event-registry.mjs`). The assertions below fail compilation when the
+ * `SessionEvent` union and the registry disagree on a kind or on any kind's required/optional
+ * top-level fields, so a new event cannot ship without its registry entry.
  */
-export declare const SESSION_EVENT_KINDS: readonly ["run_started", "llm_completed", "prompt_measured", "context_prepared", "provider_attempt", "tool_requested", "tool_completed", "tool_argument_repaired", "tool_denied", "permission_requested", "permission_resolved", "compressed", "page_out", "semantic_archive_pending", "semantic_archive_completed", "semantic_archive_failed", "page_in", "rollbacked", "capability_changed", "context_renewed", "suspended", "resumed", "tool_gated", "signal_delivery_disposed", "budget_exceeded", "budget_usage_reported", "operation_cancelled", "milestone_advanced", "milestone_blocked", "checkpoint_taken", "entropy_sample", "entropy_alert", "agent_process_changed", "memory_written", "memory_queried", "memory_validation_failed", "memory_write_failed", "memory_query_failed", "memory_retrieval_result", "workflow_node_completed", "workflow_nodes_submitted", "workflow_batch_spawned", "workflow_completed", "kernel_observation", "run_terminal", "summary_upgraded", "group_member_joined", "group_budget_charged", "round_started", "round_paced"];
+export declare const SESSION_EVENT_KINDS: readonly ["run_started", "llm_completed", "prompt_measured", "provider_attempt", "tool_requested", "tool_completed", "tool_argument_repaired", "tool_denied", "permission_requested", "permission_resolved", "compressed", "page_out", "semantic_archive_pending", "semantic_archive_completed", "semantic_archive_failed", "page_in", "rollbacked", "capability_changed", "context_renewed", "context_lifecycle_reported", "suspended", "resumed", "tool_gated", "signal_delivery_disposed", "budget_exceeded", "budget_usage_reported", "operation_cancelled", "milestone_advanced", "milestone_blocked", "checkpoint_taken", "entropy_sample", "entropy_alert", "agent_process_changed", "memory_written", "memory_queried", "memory_validation_failed", "memory_write_failed", "memory_candidate_pending", "memory_candidate_rejected", "memory_query_failed", "memory_retrieval_result", "workflow_node_completed", "workflow_nodes_submitted", "workflow_batch_spawned", "workflow_completed", "kernel_observation", "run_terminal", "summary_upgraded", "group_member_joined", "group_budget_charged", "round_started", "round_paced"];
+export { SESSION_EVENT_REGISTRY };
 /**
  * The business-projection log (spec §9.2): run started/terminal, stream events, observations,
  * provider/tool presentation, and audit metadata. Canonical durable records live exclusively in

package/dist/runtime/session-log.js

@@ -1,65 +1,17 @@
+import { SESSION_EVENT_KINDS as REGISTERED_SESSION_EVENT_KINDS, SESSION_EVENT_REGISTRY } from "./session-event-registry.generated.js";
 import { primitiveForKind } from "./kernel-event-log.js";
 import { InMemoryKernelJournal } from "./kernel-journal.js";
 /**
- * The registered session-event vocabulary (F9 / S3, P7-S4). This list must equal the Node SDK's
- * `SESSION_EVENT_KINDS` — the cross-SDK manifest fixture
- * `tests/fixtures/sdk-conformance/canonical/session-event-vocabulary.json` pins both, and any
- * same-commit desync turns conformance red. Declared in `SessionEvent` union order.
+ * The registered session-event vocabulary (F9 / S3, P7-S4). The authority is
+ * `contracts/session-events.json`; `session-event-registry.generated.ts` is generated from it
+ * (`node scripts/gen-session-event-registry.mjs`). The assertions below fail compilation when the
+ * `SessionEvent` union and the registry disagree on a kind or on any kind's required/optional
+ * top-level fields, so a new event cannot ship without its registry entry.
  */
-export const SESSION_EVENT_KINDS = [
-    "run_started",
-    "llm_completed",
-    "prompt_measured",
-    "context_prepared",
-    "provider_attempt",
-    "tool_requested",
-    "tool_completed",
-    "tool_argument_repaired",
-    "tool_denied",
-    "permission_requested",
-    "permission_resolved",
-    "compressed",
-    "page_out",
-    "semantic_archive_pending",
-    "semantic_archive_completed",
-    "semantic_archive_failed",
-    "page_in",
-    "rollbacked",
-    "capability_changed",
-    "context_renewed",
-    "suspended",
-    "resumed",
-    "tool_gated",
-    "signal_delivery_disposed",
-    "budget_exceeded",
-    "budget_usage_reported",
-    "operation_cancelled",
-    "milestone_advanced",
-    "milestone_blocked",
-    "checkpoint_taken",
-    "entropy_sample",
-    "entropy_alert",
-    "agent_process_changed",
-    "memory_written",
-    "memory_queried",
-    "memory_validation_failed",
-    "memory_write_failed",
-    "memory_query_failed",
-    "memory_retrieval_result",
-    "workflow_node_completed",
-    "workflow_nodes_submitted",
-    "workflow_batch_spawned",
-    "workflow_completed",
-    "kernel_observation",
-    "run_terminal",
-    "summary_upgraded",
-    "group_member_joined",
-    "group_budget_charged",
-    "round_started",
-    "round_paced",
-];
-const _vocabularyCoversUnion = true;
-void _vocabularyCoversUnion;
+export const SESSION_EVENT_KINDS = REGISTERED_SESSION_EVENT_KINDS;
+export { SESSION_EVENT_REGISTRY };
+const _sessionEventRegistryInLockstep = true;
+void _sessionEventRegistryInLockstep;
 /**
  * **Single-isolate dev/test implementation** of both capabilities (spec §9.4: one class may
  * implement several capabilities; the *interfaces* stay separate). Its `KernelJournal` half is

package/dist/runtime/session-repair.d.ts

@@ -45,9 +45,6 @@ export declare function buildWorkflowNodeCompletedEvent(input: {
     agentId: string;
     status: WorkflowNodeStatus;
     termination: string;
-    classifyBranch?: string;
-    tournamentWinner?: string;
-    loopContinue?: boolean;
     output?: ModelMessage;
 }): Extract<SessionEvent, {
     kind: "workflow_node_completed";

package/dist/runtime/session-repair.js

@@ -58,9 +58,6 @@ export function buildWorkflowNodeCompletedEvent(input) {
         agent_id: input.agentId,
         status: input.status,
         termination: input.termination,
-        ...(input.classifyBranch !== undefined ? { classify_branch: input.classifyBranch } : {}),
-        ...(input.tournamentWinner !== undefined ? { tournament_winner: input.tournamentWinner } : {}),
-        ...(input.loopContinue !== undefined ? { loop_continue: input.loopContinue } : {}),
         ...(input.output ? { output: input.output } : {}),
     };
 }

package/dist/runtime/sub-agent-orchestrator.d.ts

@@ -1,4 +1,4 @@
-import type { AgentRunSpec, AgentProcessChangedObservation, SubAgentResult } from "./types/agent.js";
+import type { AgentRunSpec, AgentProcessChangedObservation, SubAgentResult, InheritedKnowledge } from "./types/agent.js";
 import type { RuntimeOptions } from "./runner.js";
 import type { SessionLog } from "./session-log.js";
 export interface SubAgentRunContext {
@@ -20,6 +20,10 @@ export interface SubAgentRunContext {
     /** #2-B-ii: parent-controlled abort — when the kernel preempts this node (`AgentPreempted`), the
      *  orchestrator interrupts the child runner, cancelling its in-flight LLM call. */
     abortSignal?: AbortSignal;
+    /** Plan task 3.1 · the outputs of the workflow nodes this child depends on, by agent id. */
+    dependencyOutputs?: Record<string, string>;
+    /** Plan task 1.1 · the parent knowledge the kernel lets this child inherit. */
+    inheritedKnowledge?: InheritedKnowledge[];
 }
 /** M1/G3 intelligence routing: resolve the provider for a sub-agent from its spec's `modelHint`.
  *  Falls back to the parent provider when there is no hint or no `providerFor` hook resolves it. */

package/dist/runtime/sub-agent-orchestrator.js

@@ -126,6 +126,10 @@ export class SubAgentOrchestrator {
             runSpec: ctx.spec.loopRound
                 ? { identity: ctx.spec.identity, role: ctx.spec.role, goal: ctx.spec.goal, loopRound: ctx.spec.loopRound }
                 : undefined,
+            // A child reads only its own dependencies, never ones inherited from the parent's options.
+            dependencyOutputs: ctx.dependencyOutputs,
+            // Likewise only the knowledge the kernel chose for this child, never the parent's own.
+            inheritedKnowledge: ctx.inheritedKnowledge,
         });
         // #2-B-ii: parent preempt → interrupt the child (cancels its in-flight LLM call).
         linkAbort(ctx.abortSignal, childRunner);