@astrosheep/keiyaku 4.5.1 → 4.5.2

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

@@ -42,11 +42,17 @@ export declare class Akuma {
     listArchetypes(): Promise<readonly string[]>;
     call(input: AkumaCallLaunchInput): Promise<AkumaHandle>;
     beginCall(input: AkumaCallLaunchInput, context: AkumaCallContext): Promise<AkumaBornCall>;
-    finishCall(born: AkumaBornCall): Promise<AkumaHandle>;
+    finishCall(born: AkumaBornCall, completion?: Readonly<{
+        participantName?: string;
+        contractId?: string;
+    }>): Promise<AkumaHandle>;
     [CALL_WITH_CONTEXT](input: AkumaCallLaunchInput, context: AkumaCallContext): Promise<AkumaHandle>;
     list(input?: AkumaListInput): Promise<AkumaList>;
 }
 export declare function callAkumaWithContext(akuma: Akuma, input: AkumaCallLaunchInput, context: AkumaCallContext): Promise<AkumaHandle>;
 export declare function beginAkumaCall(akuma: Akuma, input: AkumaCallLaunchInput, context: AkumaCallContext): Promise<AkumaBornCall>;
-export declare function finishAkumaCall(akuma: Akuma, born: AkumaBornCall): Promise<AkumaHandle>;
+export declare function finishAkumaCall(akuma: Akuma, born: AkumaBornCall, completion?: Readonly<{
+    participantName?: string;
+    contractId?: string;
+}>): Promise<AkumaHandle>;
 export {};

package/build/src/akuma/akuma-product.js

@@ -112,13 +112,18 @@ export class Akuma {
             },
         };
     }
-    async finishCall(born) {
+    async finishCall(born, completion = {}) {
         if (born.kind === "requested") {
             return new AkumaHandle(born.id, this.path, { cwd: born.cwd, source: born.execution.source });
         }
         const published = await launchAkuma({
             allocated: born.allocated,
-            launch: async (allocated) => await spawnAkumaBody({ paths: allocated.paths, seed: born.seed, initialBody: born.initialBody }),
+            launch: async (allocated) => await spawnAkumaBody({
+                paths: allocated.paths,
+                seed: born.seed,
+                initialBody: born.initialBody,
+                ...(Object.keys(completion).length === 0 ? {} : { completion }),
+            }),
         });
         return new AkumaHandle(published.id, this.path, {
             cwd: born.execution.cwd,
@@ -174,6 +179,6 @@ export async function callAkumaWithContext(akuma, input, context) {
 export async function beginAkumaCall(akuma, input, context) {
     return await akuma.beginCall(input, context);
 }
-export async function finishAkumaCall(akuma, born) {
-    return await akuma.finishCall(born);
+export async function finishAkumaCall(akuma, born, completion = {}) {
+    return await akuma.finishCall(born, completion);
 }

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

@@ -11,6 +11,10 @@ export type BodyLaunch = Readonly<{
     birthSession?: Omit<SessionFact, "sequence">;
     initialBody?: string;
     refuseIfHeld?: boolean;
+    completion?: Readonly<{
+        participantName?: string;
+        contractId?: string;
+    }>;
 }>;
 export type TellWake = Readonly<{
     kind: "told";

package/build/src/akuma/body.js

@@ -78,18 +78,19 @@ async function persistTurn(paths, turnSequence, result, completedAt) {
     await endTurn(paths, { turnSequence, outcome: { kind: "failed", diagnostic }, completedAt });
     return { outcome: "failed", diagnostic };
 }
-const OUTCOME_PREVIEW_LIMIT = 1_000;
-function outcomePreview(identity, outcome) {
-    const text = outcome.outcome === "answered" ? outcome.answer : outcome.diagnostic;
-    if (text.length <= OUTCOME_PREVIEW_LIMIT)
-        return text;
-    return `${text.slice(0, OUTCOME_PREVIEW_LIMIT)}\n\nkeiyaku history ${identity} --last`;
+function completionMessage(identity, completion) {
+    const participant = completion?.participantName;
+    const contract = completion?.contractId;
+    const header = [identity, participant === undefined ? undefined : `(@${participant})`, contract]
+        .filter((value) => value !== undefined)
+        .join(" ");
+    return `${header}\n✓ came back`;
 }
 function boundedDiagnostic(error) {
     const text = diagnostic(error);
     return text.length <= 500 ? text : `${text.slice(0, 500)}...`;
 }
-async function expressInitialOutcome(launch, outcome) {
+async function expressInitialOutcome(launch) {
     try {
         const { Square } = await import("@astrosheep/square");
         const identity = launch.seed?.id ?? (await readHeart(launch.paths)).soul?.id;
@@ -100,7 +101,7 @@ async function expressInitialOutcome(launch, outcome) {
             const joined = await square.implicitJoin(identity);
             if (joined.state === "done" || joined.participant === undefined)
                 return;
-            await joined.participant.express(outcomePreview(identity, outcome));
+            await joined.participant.express(completionMessage(identity, launch.completion));
         }
         finally {
             await square.close();
@@ -217,7 +218,7 @@ async function runBodyTurns(input) {
         }
         const outcome = await persistTurn(launch.paths, result.turnSequence, result, runtime.now());
         if (initial !== undefined)
-            await expressInitialOutcome(launch, outcome);
+            await expressInitialOutcome(launch);
         if (outcome.outcome === "failed") {
             await breakBody(launch.paths, { sequence: bodySequence, end: "broke-off", at: runtime.now() });
             return;

package/build/src/cli/commands/akuma-invoke.js

@@ -124,7 +124,7 @@ export async function invokeAkuma(command, input) {
                 : undefined;
             let result;
             try {
-                result = await (input.finishCall ?? finishCall)(born);
+                result = await (input.finishCall ?? finishCall)(born, listener?.participantName);
             }
             catch (error) {
                 if (listener?.committed === true) {

package/build/src/cli/square-edge.d.ts

@@ -2,5 +2,6 @@ import type { AllocatedAkuma } from "../akuma/identity.js";
 import { type WorldRoot } from "../world.js";
 export declare function recognizeAndListen(worldRoot: WorldRoot, environment: NodeJS.ProcessEnv, allocated: AllocatedAkuma): Promise<{
     committed: boolean;
+    participantName: string;
     rollback(): Promise<void>;
 } | void>;

package/build/src/cli/square-edge.js

@@ -56,6 +56,7 @@ export async function recognizeAndListen(worldRoot, environment, allocated) {
         listening = change.activity !== null;
         return {
             committed: true,
+            participantName: name,
             rollback,
         };
     }

package/build/src/library/akuma-creation.d.ts

@@ -99,6 +99,6 @@ export type ForkResult = Readonly<{
     parent: AkuId;
 }>);
 export declare function beginCall(input: CallInput): Promise<BornCall>;
-export declare function finishCall(born: BornCall): Promise<CallResult>;
+export declare function finishCall(born: BornCall, participantName?: string): Promise<CallResult>;
 export declare function callKeiyaku(input: CallInput): Promise<CallResult>;
 export declare function forkKeiyaku(input: ForkInput): Promise<ForkResult>;

package/build/src/library/akuma-creation.js

@@ -236,9 +236,13 @@ export async function beginCall(input) {
         alias: aliasStage,
     };
 }
-export async function finishCall(born) {
+export async function finishCall(born, participantName) {
     const world = akumaWorld(born.path);
-    const handle = await finishAkumaCall(world, born.born);
+    const contractId = born.dispatch.kind === "dispatched" ? born.dispatch.dispatch.contractId : undefined;
+    const handle = await finishAkumaCall(world, born.born, {
+        ...(participantName === undefined ? {} : { participantName }),
+        ...(contractId === undefined ? {} : { contractId }),
+    });
     const readonly = (await handle.status()).readonly;
     const observation = await observeCall(handle, born.mode, born.timeoutMs);
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrosheep/keiyaku",
-  "version": "4.5.1",
+  "version": "4.5.2",
   "files": [
     "build"
   ],
@@ -64,7 +64,7 @@
   "dependencies": {
     "@agentclientprotocol/sdk": "^1.3.0",
     "@anthropic-ai/claude-agent-sdk": "^0.3.226",
-    "@astrosheep/square": "0.3.23",
+    "@astrosheep/square": "0.3.24",
     "@earendil-works/pi-coding-agent": "0.80.10",
     "@opencode-ai/sdk": "1.18.3",
     "cross-spawn": "^7.0.6",