@astrosheep/keiyaku 4.1.0 → 4.1.2

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

@@ -1,9 +1,15 @@
-import { type AkumaLife, type KillEvidence, type ResumeCoordinate, type Soul } from "./heart/index.js";
-import { type AkuId } from "./identity.js";
-import { type ActivityHistory, type ActivitySnapshot } from "./projection.js";
-import { type Settings } from "../settings.js";
+import { type TellResult, type TellWakeRuntime } from "./body.js";
+import { HeldAkumaLeash, type AkumaLife, type KillEvidence, type ResumeCoordinate, type Soul } from "./heart/index.js";
+import { type AkuId, type AkumaPaths } from "./identity.js";
+import type { ActivitySnapshot } from "./projection.js";
+import type { Settings } from "../settings.js";
 import type { WorldRoot } from "../world.js";
-import { type AllowedAction } from "./allowed.js";
+import type { AllowedAction } from "./allowed.js";
+export declare const POLL_MS = 100;
+export declare function canonicalBirthCwd(input: string): Promise<string>;
+export declare function callReadonly(value: unknown): Readonly<{
+    readonly?: true;
+}>;
 export type AkumaListRow = Readonly<{
     id: AkuId;
     archetype: string;
@@ -20,6 +26,8 @@ export type AkumaStatus = Readonly<{
     timeline: ActivitySnapshot;
     strandedReason?: "resume-unsupported";
 }>;
+/** The default completion judgment over one complete status snapshot. */
+export declare function defaultWaitComplete(status: AkumaStatus): boolean;
 export type { ReadonlyRestraint } from "./provider-recipe.js";
 export type * from "./projection.js";
 export type UnbornAkumaListRow = Readonly<{
@@ -41,8 +49,7 @@ export type AkumaCallExecution = Readonly<{
     cwd: string;
     source: "input" | "caller" | "process" | "world";
 }>;
-declare const CALL_EXECUTION: unique symbol;
-declare const CALL_WITH_CONTEXT: unique symbol;
+export { CALL_WITH_CONTEXT } from "./akuma-product-symbols.js";
 export type AkumaCallInput = Readonly<{
     archetype: string;
     body: string;
@@ -50,20 +57,11 @@ export type AkumaCallInput = Readonly<{
     readonly?: true;
     allowed?: readonly AllowedAction[];
 }>;
-type AkumaCallContext = Readonly<{
+export type AkumaCallContext = Readonly<{
     initiatorCwd?: string;
     cwdCanonical?: true;
 }>;
-export type TellResult = Readonly<{
-    admission: Readonly<{
-        tellId: string;
-        fact: "recorded";
-    }>;
-    wake: "spawned" | Readonly<{
-        kind: "failed";
-        diagnostic: string;
-    }>;
-}>;
+export type { TellResult, TellWake } from "./body.js";
 export type InterruptReceipt = Readonly<{
     kind: "unavailable";
     evidence: "hung" | "untidy" | "unavailable";
@@ -89,69 +87,27 @@ export type ForkReceipt = Readonly<{
     childSession: ResumeCoordinate;
     diagnostic: string;
 }>;
-export declare class AkumaNotBornError extends Error {
-    readonly id: AkuId;
-    readonly kind = "akuma-not-born";
-    constructor(id: AkuId);
-}
-export declare function tellAkumaWithId(worldPath: WorldRoot, id: AkuId, body: string, tellId: string, recordedAt?: string): Promise<TellResult>;
-export type BudgetedStatusObservation = Readonly<{
-    status: AkumaStatus;
-    ordinarySelected: number;
-}>;
-/** Package-internal budgeted observation; Fleet allocates, Akuma still selects. */
-export declare function readBudgetedStatus(worldPath: WorldRoot, id: AkuId, input: Readonly<{
-    ordinaryBudget: number;
-}>): Promise<BudgetedStatusObservation>;
-/** Package-internal birth projection used by the composed Library call result. */
-export declare function readAkumaBirthCwd(worldPath: WorldRoot, id: AkuId): Promise<string>;
-export declare class AkumaHandle {
-    readonly id: AkuId;
-    private readonly worldPath;
-    readonly [CALL_EXECUTION]?: AkumaCallExecution;
-    constructor(id: AkuId, worldPath: WorldRoot, execution?: AkumaCallExecution);
-    private get paths();
-    status(): Promise<AkumaStatus>;
-    history(input?: Readonly<{
-        before?: number;
-        since?: number;
-        limit?: number;
-    }>): Promise<ActivityHistory>;
-    wait(predicate?: (status: AkumaStatus) => boolean, options?: Readonly<{
-        timeoutMs?: number;
-    }>): Promise<AkumaStatus>;
-    tell(body: string): Promise<TellResult>;
-    interrupt(body: string): Promise<InterruptReceipt>;
-    fork(input: Readonly<{
-        at: string;
-    }>): Promise<ForkReceipt>;
-    kill(): Promise<KillEvidence>;
-    lastAnswer(): Promise<LastAnswer>;
-}
-/** Package-internal provenance retained only by the handle returned from call. */
-export declare function akumaCallExecution(handle: AkumaHandle): AkumaCallExecution | undefined;
-export type LastAnswer = Readonly<{
-    kind: "answer";
-    answer: string;
-}> | Readonly<{
-    kind: "no-answer";
-}>;
-type AkumaConfiguration = Readonly<{
+export { AkumaNotBornError } from "./akuma-errors.js";
+export declare function wait(milliseconds: number): Promise<void>;
+export declare function takeLeashUntil(paths: AkumaPaths, deadline: number): Promise<HeldAkumaLeash | null>;
+export declare function recordTellBody(paths: AkumaPaths, akuma: AkuId, body: string, id?: string, recordedAt?: string): Promise<Readonly<{
+    kind: "recorded";
+    tellId: string;
+}>>;
+export declare function tellAkumaWithId(input: Readonly<{
+    worldPath: WorldRoot;
+    id: AkuId;
+    body: string;
+    tellId: string;
+    recordedAt?: string;
+    runtime?: TellWakeRuntime;
+}>): Promise<TellResult>;
+export declare function diagnostic(error: unknown): string;
+export declare function killAkumaWithRecovery(paths: AkumaPaths, recover?: (paths: AkumaPaths) => Promise<void>): Promise<KillEvidence>;
+export { bornStatus, fleetListRow, readAkumaBirthCwd, readBudgetedStatus, type BudgetedStatusObservation, } from "./akuma-observe.js";
+export type AkumaConfiguration = Readonly<{
     home?: string;
     settings?: Settings;
 }>;
-export declare class Akuma {
-    private readonly path;
-    private readonly configuration;
-    private constructor();
-    static of(root: WorldRoot, input?: AkumaConfiguration): Akuma;
-    of(input: Readonly<{
-        id: string;
-    }>): AkumaHandle;
-    listArchetypes(): Promise<readonly string[]>;
-    call(input: AkumaCallInput): Promise<AkumaHandle>;
-    [CALL_WITH_CONTEXT](input: AkumaCallInput, context: AkumaCallContext): Promise<AkumaHandle>;
-    list(input?: AkumaListInput): Promise<AkumaList>;
-}
-/** Package-internal call path for a composition owner that already canonicalized cwd. */
-export declare function callAkumaWithContext(akuma: Akuma, input: AkumaCallInput, context: AkumaCallContext): Promise<AkumaHandle>;
+export { AkumaHandle, akumaCallExecution, type LastAnswer } from "./akuma-handle.js";
+export { Akuma, callAkumaWithContext } from "./akuma-product.js";