@astrosheep/keiyaku 4.5.8 → 4.5.10

package/README.md

@@ -142,7 +142,7 @@ Node ≥ 22.19. Product law lives in [`docs/`](docs/README.md).
 
 ## Source builds
 
-Building from source also builds the Windows launcher with Zig 0.14.1. Install
+Building from source also builds the Windows launcher with Zig 0.14.1 or later. Install
 that system tool separately and make `zig` available on `PATH`, or set
 `KEIYAKU_ZIG` to the selected executable. `npm ci` alone is not sufficient for
 the Windows launcher: use `npm ci --ignore-scripts --prefer-offline` followed by

package/build/integrations/marketplace/plugins/keiyaku/skills/keiyaku/SKILL.md

@@ -41,7 +41,7 @@ keiyaku -C <repo> tell <aku/...|@alias> (<prompt> | -)
 `-C` is the invocation and Akuma execution cwd. Add `--repo <path>` only when
 a Contract or Dispatch reader must use a different Git repository.
 
-Repeated `--allowed` values add actions to the Archetype defaults. Restriction
-comes from the Archetype base and, for nested calls, the direct parent Soul.
+Repeated `--allowed` values add actions to the selected Akuma's defaults. A
+nested call can use only actions permitted by its direct parent Soul.
 
 Use text by default; add `--json` when a script needs structured output.

package/build/integrations/marketplace/plugins/keiyaku/skills/keiyaku-akuma/SKILL.md

@@ -6,7 +6,7 @@ description: Use when delegating work to, supervising, steering, inspecting, for
 # Keiyaku Akuma
 
 An Akuma is a durable callable worker. Its complete identity is
-`aku/<archetype>/<hex8>` — keep it; it is how you address the same worker
+`aku/<akuma>/<hex8>` — keep it; it is how you address the same worker
 later. An Alias is a movable world-local selector usable wherever a direct id
 is accepted; the identity underneath never changes.
 
@@ -29,25 +29,25 @@ exclusive. Decide up front whether you will stay:
 Alias already points elsewhere, it moves to the born Akuma. The worker's
 execution cwd is exactly `-C <path>`, or your own cwd when `-C` is omitted.
 
-Repeated `--allowed` values add actions to the Archetype defaults. Restriction
-comes from the Archetype base and, for nested calls, the direct parent Soul.
+Repeated `--allowed` values add actions to the selected Akuma's defaults. A
+nested call can use only actions permitted by its direct parent Soul.
 
-## Archetypes
+## Akuma Names
 
-An Archetype is a Markdown file at `~/.keiyaku/akuma/<name>.md`. Its
-frontmatter selects the provider and may declare `model`, `effort`,
-`readonly`, `network`, and `description`; the body is an optional system
-prompt, and an empty body keeps the harness default. Write a new one when no
-existing file grants the permissions and stance the work needs; a worker never
-outgrows its Archetype mid-life.
+An Akuma name selects a Markdown file at `~/.keiyaku/akuma/<name>.md`; pass
+the filename without `.md` as `<akuma-name>`. Its frontmatter selects the
+provider and may declare `model`, `effort`, `readonly`, `network`, and
+`description`; the body is an optional system prompt, and an empty body keeps
+the harness default. If none grants the permissions and stance the work needs,
+add a new Akuma name. A born Akuma keeps its selected defaults for its lifetime.
 
 ## Commission And Steer
 
-A call assembles a commission from independent inputs: the Archetype fixes
+A call assembles a commission from independent inputs: the selected Akuma fixes
 capability stance for the identity's whole life; the `--contract` Dispatch
-associates standing terms; allowed actions set what the callee may do, always
-under the Archetype base and the parent Soul's ceiling; the prompt carries the
-question. None of these implies another — association is not a seat, forwarded
+associates standing terms; allowed actions set what the callee may do, subject
+to that Akuma's restrictions and the parent Soul's ceiling; the prompt carries
+the question. None of these implies another — association is not a seat, forwarded
 actions are not a seat, and no combination mints a role.
 
 The prompt and every later tell genuinely direct the callee's work: they choose
@@ -67,7 +67,7 @@ not around it.
 ```bash
 keiyaku status                            # deep fleet observation
 keiyaku status <aku/...|@alias>           # one worker's snapshot
-keiyaku ls aku/                           # shallow catalog; also aku/<archetype>/ and "aku/*/*"
+keiyaku ls aku/                           # shallow catalog; also aku/<akuma>/ and "aku/*/*"
 keiyaku wait <selector>... [--any | --all] [--timeout <duration>]
 ```
 

package/build/integrations/marketplace/plugins/keiyaku/skills/keiyaku-workflow/SKILL.md

@@ -266,25 +266,29 @@ Deliver when the worktree content is the candidate you intend to land:
 keiyaku deliver <contract> --include-dirty
 ```
 
-Use `--include-dirty` only when the complete current workspace is the intended
-candidate; otherwise commit the intended bytes first. Read the receipt for the
-candidate, gate/placement stop, and any physical-effect lag. A not-complete
-delivery is still a recorded `tendered` candidate.
-
-`deliver` freshly tenders the candidate and requests placement. A current audit
-attestation is reused only when its integration snapshot and Verification
-segment still match; changes to the worktree, target, policy, document,
-Verification, or snapshot-producing options make it stale.
+Deliver when the work is ready to be judged, not when Git looks tidy. `git
+commit` only shapes the candidate; skipping it is fine — `deliver
+--include-dirty` captures the complete non-ignored worktree. Deliver and review
+answer different questions: deliver records the candidate and places and claims
+by itself only when every placement obligation is current; a review gate is
+satisfied only by review testimony over the current candidate, and a satisfied
+review may itself be the invocation that places and claims. Reviewing before any
+delivery is legal but records testimony only — it creates no candidate and
+authorizes nothing. A Contract without a review gate needs no review.
+
+A current audit attestation is reused only when its integration snapshot and
+Verification segment still match; changes to the worktree, target, policy,
+document, Verification, or snapshot-producing options make it stale.
 
 ## Review Gates
 
 The Reviewer owns the answer. A gate review compares the full current candidate
 against every journaled Criterion — the floor that cannot be reduced — and
 testifies satisfied or unsatisfied over the current document identity and
-worktree; satisfied requests placement. A current defect, missing, failed, or
-stale required evidence, or terms too ambiguous or contradictory to judge all
-yield unsatisfied, with the summary naming what blocks. Advice beyond the terms
-belongs in the summary and never changes the verdict by itself.
+worktree. A current defect, missing, failed, or stale required evidence, or
+terms too ambiguous or contradictory to judge all yield unsatisfied, with the
+summary naming what blocks. Advice beyond the terms belongs in the summary and
+never changes the verdict by itself.
 
 ```bash
 keiyaku review <contract> --satisfied --summary "<conclusion>"

package/build/src/akuma/akuma.d.ts

@@ -124,7 +124,7 @@ export declare const akumaStatusSchema: z.ZodObject<{
                     pending: "pending";
                     told: "told";
                 }>;
-                deliveries: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                deliveries: z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodObject<{
                     deliveredAt: z.ZodString;
                     route: z.ZodEnum<{
                         live: "live";
@@ -135,7 +135,17 @@ export declare const akumaStatusSchema: z.ZodObject<{
                         required: "required";
                         unavailable: "unavailable";
                     }>>;
-                }, z.core.$strict>>>;
+                }, z.core.$strict>, z.ZodTransform<Readonly<{
+                    turnSequence: number;
+                    route: "launch" | "live";
+                    receipt?: "unavailable" | "required";
+                    deliveredAt: string;
+                }>, {
+                    deliveredAt: string;
+                    route: "live" | "launch";
+                    turnSequence: number;
+                    receipt?: "required" | "unavailable" | undefined;
+                }>>>>;
             }, z.core.$strict>]>, z.ZodObject<{
                 kind: z.ZodLiteral<"tool">;
                 sequence: z.ZodNumber;
@@ -313,7 +323,7 @@ export declare const akumaStatusSchema: z.ZodObject<{
                     pending: "pending";
                     told: "told";
                 }>;
-                deliveries: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                deliveries: z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodObject<{
                     deliveredAt: z.ZodString;
                     route: z.ZodEnum<{
                         live: "live";
@@ -324,7 +334,17 @@ export declare const akumaStatusSchema: z.ZodObject<{
                         required: "required";
                         unavailable: "unavailable";
                     }>>;
-                }, z.core.$strict>>>;
+                }, z.core.$strict>, z.ZodTransform<Readonly<{
+                    turnSequence: number;
+                    route: "launch" | "live";
+                    receipt?: "unavailable" | "required";
+                    deliveredAt: string;
+                }>, {
+                    deliveredAt: string;
+                    route: "live" | "launch";
+                    turnSequence: number;
+                    receipt?: "required" | "unavailable" | undefined;
+                }>>>>;
             }, z.core.$strict>]>, z.ZodObject<{
                 kind: z.ZodLiteral<"tool">;
                 sequence: z.ZodNumber;

package/build/src/akuma/archetype.js

@@ -75,7 +75,7 @@ function archetypeReadonly(values) {
 function decodeArchetype(name, path, markdown) {
     const lines = markdown.split(/\r?\n/u);
     if (lines[0]?.trim() !== "---")
-        throw new TypeError("Akuma configuration must begin with YAML frontmatter");
+        throw new TypeError("Akuma file must begin with YAML frontmatter");
     const closing = lines.findIndex((line, index) => index > 0 && line.trim() === "---");
     if (closing < 0)
         throw new TypeError("Akuma frontmatter is not closed");

package/build/src/akuma/body.d.ts

@@ -1,5 +1,5 @@
 import type { AkumaCallRequestChildLaunch } from "./call-request.js";
-import { type SessionFact, type Soul } from "./heart/index.js";
+import { type SessionFact, type Soul, type TellRow } from "./heart/index.js";
 import { type AkumaPaths } from "./identity.js";
 import type { ProviderAdapter } from "./provider.js";
 import type { ErasedRequestCommand } from "./request-wire.js";
@@ -38,6 +38,7 @@ export type TellResult = Readonly<{
         tellId: string;
         fact: "recorded";
     }>;
+    row: TellRow;
     wake: TellWake;
 }>;
 export type TellWakeRuntime = Readonly<{

package/build/src/akuma/body.js

@@ -3,7 +3,7 @@ import { fileURLToPath } from "node:url";
 import { abortableDelay } from "./abort.js";
 import { BodySupervisor } from "./body-supervisor.js";
 import { driveTurn, turnRecipe } from "./turn-drive.js";
-import { HeldAkumaLeash, breakBody, endTurn, finishBodyIfIdle, heartExists, isHeartAbsent, readHeart, readNonterminalRequests, } from "./heart/index.js";
+import { HeldAkumaLeash, breakBody, endTurn, finishBodyIfIdle, heartExists, isHeartAbsent, projectTell, readHeart, readTell, readNonterminalRequests, } from "./heart/index.js";
 import { worldRootForAkumaPaths } from "./identity.js";
 import { keiyakuSquarePath } from "../world.js";
 import { resolveProviderExecution } from "./providers/index.js";
@@ -367,8 +367,13 @@ async function wakePendingTells(paths, tellId, runtime) {
     }
 }
 export async function wakeRecordedTell(paths, tellId, runtime = DIRECT_TELL_WAKE) {
+    const wake = (await wakePendingTells(paths, tellId, runtime));
+    const tell = await readTell(paths, tellId);
+    if (tell === null)
+        throw new Error(`recorded Tell ${tellId} is missing from Heart`);
     return {
         admission: { tellId, fact: "recorded" },
-        wake: (await wakePendingTells(paths, tellId, runtime)),
+        row: projectTell(tell),
+        wake,
     };
 }

package/build/src/akuma/call-request.js

@@ -40,7 +40,7 @@ const archetypeSchema = z.string().transform((value, context) => {
         return archetypeName(value);
     }
     catch {
-        context.addIssue({ code: "custom", message: "expected archetype" });
+        context.addIssue({ code: "custom", message: "expected Akuma name" });
         return z.NEVER;
     }
 });

package/build/src/akuma/heart/facts.d.ts

@@ -100,6 +100,16 @@ export type TellFact = Readonly<{
     state: "pending" | "told";
     deliveries: readonly TellDelivery[];
 }>;
+export type TellRow = Readonly<{
+    kind: "tell";
+    sequence: number;
+    at: string;
+    tellId: string;
+    text: string;
+    state: "pending" | "told";
+    deliveries: readonly TellDelivery[];
+}>;
+export declare function projectTell(fact: TellFact): TellRow;
 export type TellDeliveryInput = Readonly<{
     tellId: string;
     turnSequence: number;

package/build/src/akuma/heart/facts.js

@@ -1,3 +1,14 @@
+export function projectTell(fact) {
+    return {
+        kind: "tell",
+        sequence: fact.sequence,
+        at: fact.recordedAt,
+        tellId: fact.id,
+        text: fact.body,
+        state: fact.state,
+        deliveries: fact.deliveries,
+    };
+}
 export function life(input) {
     if (input.body?.hung !== undefined)
         return "hung";

package/build/src/akuma/heart/index.d.ts

@@ -5,8 +5,8 @@ import type { ActivityFact } from "./rows.js";
 import { type ActivityFactSlice } from "./timeline.js";
 export { HeartAbsentError, HeldAkumaLeash, classifyHeartSchema, initializeHeart, isHeartAbsent, probeLeash, } from "./storage.js";
 export { admitRequest, isRequestInputConflict, readNonterminalRequests, readRequest, refuseRequest, reserveRequest, serveRequest, serveUpstreamRequest, voidRequest, } from "./request-authority.js";
-export { life, lifeAt } from "./facts.js";
-export type { AkumaLife, AkumaOrigin, BodyEnd, BodyFact, HeartSnapshot, ForkPoint, KillEvidence, KillFact, LeashProbe, PauseFact, RequestFact, RequestInput, RequestRecipe, SealFact, SessionFact, Soul, StopFact, TellFact, TellDelivery, TellDeliveryInput, TellReceiptInput, TurnEndFact, TurnFact, TurnOutcome, TurnStartFact, } from "./facts.js";
+export { life, lifeAt, projectTell } from "./facts.js";
+export type { AkumaLife, AkumaOrigin, BodyEnd, BodyFact, HeartSnapshot, ForkPoint, KillEvidence, KillFact, LeashProbe, PauseFact, RequestFact, RequestInput, RequestRecipe, SealFact, SessionFact, Soul, StopFact, TellFact, TellRow, TellDelivery, TellDeliveryInput, TellReceiptInput, TurnEndFact, TurnFact, TurnOutcome, TurnStartFact, } from "./facts.js";
 export type { ResumeCoordinate } from "../coordinate.js";
 export declare function readSoul(paths: AkumaPaths): Promise<Soul | null>;
 export declare function heartExists(paths: AkumaPaths): Promise<boolean>;
@@ -27,6 +27,7 @@ export declare function recordTell(paths: AkumaPaths, tell: Omit<TellFact, "sequ
     kind: "recorded";
     tell: TellFact;
 }>>;
+export declare function readTell(paths: AkumaPaths, id: string): Promise<TellFact | null>;
 export declare function recordTellDeliveries(paths: AkumaPaths, inputs: readonly TellDeliveryInput[]): Promise<void>;
 export declare function recordTellReceipt(paths: AkumaPaths, input: TellReceiptInput): Promise<void>;
 export declare function readKill(paths: AkumaPaths, bodySequence: number): Promise<KillFact | null>;

package/build/src/akuma/heart/index.js

@@ -6,7 +6,7 @@ import { isHeartAbsent, readSealFromLeash, readTransaction, transaction, withHea
 import { soulFact } from "./soul.js";
 export { HeartAbsentError, HeldAkumaLeash, classifyHeartSchema, initializeHeart, isHeartAbsent, probeLeash, } from "./storage.js";
 export { admitRequest, isRequestInputConflict, readNonterminalRequests, readRequest, refuseRequest, reserveRequest, serveRequest, serveUpstreamRequest, voidRequest, } from "./request-authority.js";
-export { life, lifeAt } from "./facts.js";
+export { life, lifeAt, projectTell } from "./facts.js";
 const ACTIVITY_LIMIT = 5_000;
 export async function readSoul(paths) {
     try {
@@ -67,6 +67,9 @@ export async function recordTell(paths, tell) {
         return { kind: "recorded", tell: { sequence, ...tell, state: "pending", deliveries: [] } };
     }));
 }
+export async function readTell(paths, id) {
+    return await withHeart(paths, (heart) => readTransaction(heart, () => tellFact(heart, id)));
+}
 export async function recordTellDeliveries(paths, inputs) {
     await withHeart(paths, (heart) => transaction(heart, () => {
         for (const input of inputs) {

package/build/src/akuma/projection.d.ts

@@ -1,4 +1,5 @@
 import type { TimelineFact } from "./heart/index.js";
+import { type TellRow } from "./heart/facts.js";
 import { z } from "zod";
 declare const turnRowSchema: z.ZodObject<{
     kind: z.ZodLiteral<"turn">;
@@ -22,7 +23,7 @@ declare const textRowSchema: (kind: "said" | "thought" | "note") => z.ZodObject<
     text: z.ZodString;
     truncated: z.ZodOptional<z.ZodLiteral<true>>;
 }, z.core.$strict>;
-declare const tellRowSchema: z.ZodObject<{
+export declare const tellRowSchema: z.ZodObject<{
     kind: z.ZodLiteral<"tell">;
     sequence: z.ZodNumber;
     at: z.ZodString;
@@ -32,7 +33,7 @@ declare const tellRowSchema: z.ZodObject<{
         pending: "pending";
         told: "told";
     }>;
-    deliveries: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+    deliveries: z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodObject<{
         deliveredAt: z.ZodString;
         route: z.ZodEnum<{
             live: "live";
@@ -43,7 +44,17 @@ declare const tellRowSchema: z.ZodObject<{
             required: "required";
             unavailable: "unavailable";
         }>>;
-    }, z.core.$strict>>>;
+    }, z.core.$strict>, z.ZodTransform<Readonly<{
+        turnSequence: number;
+        route: "launch" | "live";
+        receipt?: "unavailable" | "required";
+        deliveredAt: string;
+    }>, {
+        deliveredAt: string;
+        route: "live" | "launch";
+        turnSequence: number;
+        receipt?: "required" | "unavailable" | undefined;
+    }>>>>;
 }, z.core.$strict>;
 declare const outcomeSchema: z.ZodUnion<readonly [z.ZodObject<{
     kind: z.ZodLiteral<"answered">;
@@ -253,7 +264,7 @@ declare const openSnapshotRowSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z
         pending: "pending";
         told: "told";
     }>;
-    deliveries: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+    deliveries: z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodObject<{
         deliveredAt: z.ZodString;
         route: z.ZodEnum<{
             live: "live";
@@ -264,7 +275,17 @@ declare const openSnapshotRowSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z
             required: "required";
             unavailable: "unavailable";
         }>>;
-    }, z.core.$strict>>>;
+    }, z.core.$strict>, z.ZodTransform<Readonly<{
+        turnSequence: number;
+        route: "launch" | "live";
+        receipt?: "unavailable" | "required";
+        deliveredAt: string;
+    }>, {
+        deliveredAt: string;
+        route: "live" | "launch";
+        turnSequence: number;
+        receipt?: "required" | "unavailable" | undefined;
+    }>>>>;
 }, z.core.$strict>]>, z.ZodObject<{
     kind: z.ZodLiteral<"tool">;
     sequence: z.ZodNumber;
@@ -402,7 +423,7 @@ declare const idleSnapshotRowSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z
         pending: "pending";
         told: "told";
     }>;
-    deliveries: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+    deliveries: z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodObject<{
         deliveredAt: z.ZodString;
         route: z.ZodEnum<{
             live: "live";
@@ -413,7 +434,17 @@ declare const idleSnapshotRowSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z
             required: "required";
             unavailable: "unavailable";
         }>>;
-    }, z.core.$strict>>>;
+    }, z.core.$strict>, z.ZodTransform<Readonly<{
+        turnSequence: number;
+        route: "launch" | "live";
+        receipt?: "unavailable" | "required";
+        deliveredAt: string;
+    }>, {
+        deliveredAt: string;
+        route: "live" | "launch";
+        turnSequence: number;
+        receipt?: "required" | "unavailable" | undefined;
+    }>>>>;
 }, z.core.$strict>]>, z.ZodObject<{
     kind: z.ZodLiteral<"tool">;
     sequence: z.ZodNumber;
@@ -578,7 +609,7 @@ export declare const activitySnapshotSchema: z.ZodUnion<readonly [z.ZodObject<{
                 pending: "pending";
                 told: "told";
             }>;
-            deliveries: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            deliveries: z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodObject<{
                 deliveredAt: z.ZodString;
                 route: z.ZodEnum<{
                     live: "live";
@@ -589,7 +620,17 @@ export declare const activitySnapshotSchema: z.ZodUnion<readonly [z.ZodObject<{
                     required: "required";
                     unavailable: "unavailable";
                 }>>;
-            }, z.core.$strict>>>;
+            }, z.core.$strict>, z.ZodTransform<Readonly<{
+                turnSequence: number;
+                route: "launch" | "live";
+                receipt?: "unavailable" | "required";
+                deliveredAt: string;
+            }>, {
+                deliveredAt: string;
+                route: "live" | "launch";
+                turnSequence: number;
+                receipt?: "required" | "unavailable" | undefined;
+            }>>>>;
         }, z.core.$strict>]>, z.ZodObject<{
             kind: z.ZodLiteral<"tool">;
             sequence: z.ZodNumber;
@@ -767,7 +808,7 @@ export declare const activitySnapshotSchema: z.ZodUnion<readonly [z.ZodObject<{
                 pending: "pending";
                 told: "told";
             }>;
-            deliveries: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            deliveries: z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodObject<{
                 deliveredAt: z.ZodString;
                 route: z.ZodEnum<{
                     live: "live";
@@ -778,7 +819,17 @@ export declare const activitySnapshotSchema: z.ZodUnion<readonly [z.ZodObject<{
                     required: "required";
                     unavailable: "unavailable";
                 }>>;
-            }, z.core.$strict>>>;
+            }, z.core.$strict>, z.ZodTransform<Readonly<{
+                turnSequence: number;
+                route: "launch" | "live";
+                receipt?: "unavailable" | "required";
+                deliveredAt: string;
+            }>, {
+                deliveredAt: string;
+                route: "live" | "launch";
+                turnSequence: number;
+                receipt?: "required" | "unavailable" | undefined;
+            }>>>>;
         }, z.core.$strict>]>, z.ZodObject<{
             kind: z.ZodLiteral<"tool">;
             sequence: z.ZodNumber;
@@ -844,7 +895,7 @@ type SaidRow = z.infer<ReturnType<typeof textRowSchema>>;
 type ThoughtRow = z.infer<ReturnType<typeof textRowSchema>>;
 type NoteRow = z.infer<ReturnType<typeof textRowSchema>>;
 type TurnNarrationRow = CallRow | SaidRow | ThoughtRow | NoteRow;
-export type TellRow = z.infer<typeof tellRowSchema>;
+export type { TellRow } from "./heart/facts.js";
 export type OutcomeRow = z.infer<typeof outcomeRowSchema>;
 export type ActiveToolRow = z.infer<typeof activeToolRowSchema>;
 export type CompletedToolRow = z.infer<typeof completedToolRowSchema>;

package/build/src/akuma/projection.js

@@ -1,5 +1,6 @@
 /* eslint-disable max-lines -- Akuma owns one coherent activity projection and strict boundary schema. */
 import { decodeAgentEvent } from "./provider.js";
+import { projectTell } from "./heart/facts.js";
 import { z } from "zod";
 const nonblankTextSchema = z.string().refine((value) => value.trim() !== "");
 const countSchema = z.number().int().nonnegative();
@@ -44,7 +45,8 @@ const tellDeliverySchema = z
     turnSequence: countSchema,
     receipt: z.enum(["unavailable", "required"]).optional(),
 })
-    .strict();
+    .strict()
+    .transform(({ receipt, ...delivery }) => (receipt === undefined ? delivery : { ...delivery, receipt }));
 const turnRowSchema = z
     .object({
     kind: z.literal("turn"),
@@ -73,7 +75,7 @@ const textRowSchema = (kind) => z
     truncated: z.literal(true).optional(),
 })
     .strict();
-const tellRowSchema = z
+export const tellRowSchema = z
     .object({
     kind: z.literal("tell"),
     sequence: countSchema,
@@ -397,15 +399,7 @@ export function projectTurns(facts, retained = {
                 turn.rows.push(row);
         }
         else if (fact.kind === "tell") {
-            state.tells.push({
-                kind: "tell",
-                sequence: fact.sequence,
-                at: fact.recordedAt,
-                tellId: fact.id,
-                text: fact.body,
-                state: fact.state,
-                deliveries: fact.deliveries,
-            });
+            state.tells.push(projectTell(fact));
         }
         else {
             projectActivityEvent(state, fact);

package/build/src/akuma/provider.js

@@ -360,6 +360,7 @@ export function createProviderAttempt(parentSignal, establish) {
     const setupSettled = new Promise((resolve) => {
         setupComplete = resolve;
     });
+    let establishmentSettled = false;
     let retiring;
     const remember = (operation, reportFailure) => {
         const observed = operation.catch((error) => {
@@ -394,6 +395,8 @@ export function createProviderAttempt(parentSignal, establish) {
         return Promise.all(pending).then(() => undefined);
     };
     const own = (resource) => {
+        if (establishmentSettled)
+            throw new Error("cannot own a resource after provider establishment settles");
         if (ownedResources.has(resource))
             return;
         const owned = { resource };
@@ -422,7 +425,10 @@ export function createProviderAttempt(parentSignal, establish) {
             observeBackgroundRetirement(retire("forceDispose"));
         throw error;
     })
-        .finally(() => parent.removeEventListener("abort", cancelFromParent));
+        .finally(() => {
+        establishmentSettled = true;
+        parent.removeEventListener("abort", cancelFromParent);
+    });
     void result.then(() => setupComplete(), () => setupComplete());
     const closed = (async () => {
         await setupSettled;
@@ -436,6 +442,7 @@ export function createProviderAttempt(parentSignal, establish) {
         if (cleanupFailures.length > 0)
             throw cleanupFailures[0];
     })();
+    void closed.catch(() => undefined);
     const control = async (operation) => {
         if (!controller.signal.aborted)
             controller.abort(new Error("provider attempt retired"));

package/build/src/akuma/providers/claude/events.d.ts

@@ -28,8 +28,8 @@ export declare const CLAUDE_SYSTEM_DISPOSITIONS: {
     readonly elicitation_complete: "drop";
     readonly files_persisted: "note";
     readonly hook_progress: "drop";
-    readonly hook_response: "drop";
-    readonly hook_started: "note";
+    readonly hook_response: "hook-response";
+    readonly hook_started: "drop";
     readonly informational: "note";
     readonly init: "drop";
     readonly local_command_output: "drop";

package/build/src/akuma/providers/claude/events.js

@@ -21,8 +21,8 @@ export const CLAUDE_SYSTEM_DISPOSITIONS = {
     elicitation_complete: "drop",
     files_persisted: "note",
     hook_progress: "drop",
-    hook_response: "drop",
-    hook_started: "note",
+    hook_response: "hook-response",
+    hook_started: "drop",
     informational: "note",
     init: "drop",
     local_command_output: "drop",
@@ -89,7 +89,6 @@ const CLAUDE_SYSTEM_NOTES = {
         const failed = Array.isArray(message.failed) ? message.failed.length : 0;
         return failed === 0 ? `Persisted ${files} files` : `Persisted ${files} files; ${failed} failed`;
     },
-    hook_started: (message) => `Hook ${nonblank(message.hook_name) ?? "unknown"} started`,
     informational: (message) => nonblank(message.content) ?? "Informational notice",
     mirror_error: (message) => `Transcript mirror warning: ${nonblank(message.error) ?? nonblank(message.message) ?? "unknown error"}`,
     model_refusal_fallback: () => "Model refusal; using fallback",
@@ -253,6 +252,14 @@ function toolResultEvents(message, events, state) {
         });
     }
 }
+function hookResponseNote(value) {
+    const outcome = nonblank(value.outcome);
+    if (outcome !== "error" && outcome !== "cancelled")
+        return undefined;
+    const hook = nonblank(value.hook_name) ?? "unknown";
+    const exitCode = number(value.exit_code);
+    return `Hook ${hook} ${outcome}${exitCode === undefined ? "" : ` (exit ${exitCode})`}`;
+}
 function emitSystemMessage(value, events) {
     const subtype = nonblank(value?.subtype) ?? "unknown";
     if (!Object.hasOwn(CLAUDE_SYSTEM_DISPOSITIONS, subtype)) {
@@ -262,6 +269,12 @@ function emitSystemMessage(value, events) {
     const systemDisposition = CLAUDE_SYSTEM_DISPOSITIONS[subtype];
     if (systemDisposition === "drop")
         return;
+    if (systemDisposition === "hook-response") {
+        const note = hookResponseNote(value);
+        if (note !== undefined)
+            events.emit(noteEvent(note));
+        return;
+    }
     if (systemDisposition === "control-progress" && value?.status !== "api_retry")
         return;
     const note = CLAUDE_SYSTEM_NOTES[subtype];

package/build/src/akuma/providers/codex-app-server/events.d.ts

@@ -26,8 +26,8 @@ export declare const CODEX_NOTIFICATION_DISPOSITIONS: {
     readonly "fuzzyFileSearch/sessionCompleted": "drop";
     readonly "fuzzyFileSearch/sessionUpdated": "drop";
     readonly guardianWarning: "note";
-    readonly "hook/completed": "drop";
-    readonly "hook/started": "note";
+    readonly "hook/completed": "hook-completed";
+    readonly "hook/started": "drop";
     readonly "item/agentMessage/delta": "drop";
     readonly "item/autoApprovalReview/completed": "note";
     readonly "item/autoApprovalReview/started": "note";