@earendil-works/pi-durable 0.87.1 → 0.99.1

package/dist/harness/types.d.ts

@@ -0,0 +1,358 @@
+import type { Context, JsonValue } from "@earendil-works/chord";
+import type { CacheRetention, Message, Models, ModelThinkingLevel, Tool, ToolResultMessage, Transport, UserMessage } from "@earendil-works/pi-ai";
+import type { ConversationId, ConversationOwnership, ConversationRecord, Cursor, DocumentObserver, DocumentReader, EntryDraft, EntryId, EntryQuery, EntryRecord, JsonObject, Page, Session, SubmissionId, SubmissionRecord, Task, TaskId, TaskOptions, TaskRecord, TaskState, Tx } from "../types.ts";
+/** Provider and model ID resolved through pi-ai `Models`. */
+export type ModelRef = {
+    readonly provider: string;
+    readonly modelId: string;
+};
+export type UserInput = UserMessage["content"];
+/** Host submission: user input that may start a run, or a passive entry write. */
+export type SubmissionDraft = {
+    readonly requestId?: string;
+} & ({
+    readonly type: "input";
+    readonly content: UserInput;
+    readonly whenBusy?: "steer" | "followUp" | "reject";
+    readonly entry?: never;
+} | {
+    readonly type: "write";
+    readonly entry: EntryDraft;
+    readonly content?: never;
+    readonly whenBusy?: never;
+});
+export type InputSubmissionDraft = Extract<SubmissionDraft, {
+    readonly type: "input";
+}>;
+export type SettledSubmissionRecord = SubmissionRecord & {
+    readonly status: "done" | "unanswered";
+};
+/** Awaitable host object for one durably admitted submission. */
+export interface Submission {
+    readonly id: SubmissionId;
+    status(context: Context): Promise<SubmissionRecord>;
+    wait(context: Context): Promise<SettledSubmissionRecord>;
+    abort(context: Context): Promise<"aborted" | "already_placed" | "settled">;
+}
+export type SettledTask<R> = TaskRecord<JsonValue, JsonValue, R> & {
+    readonly state: Extract<TaskState<JsonValue, R>, {
+        readonly status: "terminal";
+    }>;
+};
+/** Erased executable task definition stored in the registry. */
+export type AnyTask = {
+    readonly definition: {
+        readonly name: string;
+        readonly version: number;
+        readonly initial: unknown;
+        readonly phases: Readonly<Record<string, unknown>>;
+        readonly abort: unknown;
+        readonly migrate?: unknown;
+        readonly hooks?: object;
+    };
+};
+/** Hook handler map declared by a task definition. */
+export type HooksOf<K> = K extends Task<infer _I, infer _S, infer _R, infer H> ? H : never;
+/** Invocation-bound conversation operations available to tools. */
+export interface ConversationHandle {
+    readonly id: ConversationId;
+    submit(submission: InputSubmissionDraft, context: Context): Promise<Submission>;
+    abort(context: Context): Promise<void>;
+    waitForIdle(context: Context): Promise<void>;
+}
+/** Post-tools controls requested by a tool result. */
+export type ToolControl = {
+    readonly addTools?: readonly string[];
+    readonly terminate?: true;
+    readonly handoff?: string;
+};
+export type ToolExecutionResult = {
+    readonly content?: ToolResultMessage["content"];
+    readonly isError?: boolean;
+    readonly details?: JsonValue;
+    readonly control?: ToolControl;
+};
+/** Operations available to one tool invocation. */
+export interface ToolExecutionApi extends DocumentObserver, DocumentReader {
+    readonly taskId: TaskId;
+    readonly conversationId: ConversationId;
+    readonly callId: string;
+    /** Append running output; it becomes the result content when the result omits `content`. */
+    output(chunk: string | Uint8Array): void;
+    /** Replace running details; the last value becomes the result details when the result omits `details`. */
+    details(value: JsonValue, context: Context): Promise<void>;
+    commit<T>(change: (tx: Tx) => T | Promise<T>, context: Context): Promise<T>;
+    memo<T extends JsonValue>(name: string, context: Context): Promise<T | undefined>;
+    memo<T extends JsonValue>(name: string, candidate: T, context: Context): Promise<T>;
+    createTask<I, S extends {
+        phase: string;
+    }, R, H extends object>(task: Task<I, S, R, H>, input: I, options: Omit<TaskOptions, "conversationId">, context: Context): Promise<TaskId<R>>;
+    getTask<R>(id: TaskId<R>, context: Context): Promise<TaskRecord<JsonValue, JsonValue, R> | undefined>;
+    waitForTask<R>(id: TaskId<R>, context: Context): Promise<SettledTask<R>>;
+    conversation(id: ConversationId, context: Context): Promise<ConversationHandle | undefined>;
+}
+/** Executable tool registered in a registry. Only pi-ai `Tool` fields enter the transcript. */
+export type ToolRegistration = Tool & {
+    /** Whether an interrupted execution may rerun on recovery. Default `unsafe`. */
+    readonly replay?: "safe" | "unsafe";
+    readonly outputLimits?: {
+        readonly maxBytes?: number;
+        readonly maxLines?: number;
+        readonly retain?: "head" | "tail";
+    };
+    execute(args: JsonValue, api: ToolExecutionApi, context: Context): Promise<ToolExecutionResult>;
+};
+/** Token for removing registrations. Work already running keeps using what it started with. */
+export interface Registration {
+    /** Idempotent; removes exactly the registrations this token covers. */
+    dispose(): void;
+}
+/** Pure decorator; returns a new tool with the same name and never mutates its input. */
+export type ToolWrapper<Tool extends ToolRegistration> = (tool: Tool) => Tool;
+/** Conversation selection for a scoped hook registration. */
+export type HookScope = {
+    readonly conversationId: ConversationId;
+    /** Also match conversations owned, transitively, by tasks of this conversation. */
+    readonly subtree?: boolean;
+};
+/** Input to system prompt section rendering for one request preparation. */
+export type PromptInput<Tool extends ToolRegistration> = {
+    readonly conversationId: ConversationId;
+    /** Active and registered tools in configured order, as offered in this request. */
+    readonly tools: readonly Tool[];
+    /** Sections already in effect after replaying the active transcript. */
+    readonly shown: Readonly<Record<string, string>>;
+    readonly model?: ModelRef;
+    readonly thinkingLevel: ModelThinkingLevel;
+    /** Committed document reads. */
+    readonly read: DocumentReader;
+};
+/** One registered system prompt section; sections render in registry order before each request. */
+export type PromptSection<Tool extends ToolRegistration> = {
+    readonly key: string;
+    render(input: PromptInput<Tool>, context: Context): string | undefined | Promise<string | undefined>;
+    /** Default true: wrap the text as `<key>\n...\n</key>`. */
+    readonly tag?: boolean;
+};
+/** Pure decorator; returns a new section with the same key and never mutates its input. */
+export type PromptSectionWrapper<Tool extends ToolRegistration> = (section: PromptSection<Tool>) => PromptSection<Tool>;
+/** One registered hook handler map for task `K`. */
+export type HookRegistration<K extends AnyTask> = {
+    readonly handlers: Partial<HooksOf<K>>;
+    readonly scope?: HookScope;
+};
+/** Wrapper composition failure found while building a snapshot. */
+export type RegistryFailure = {
+    readonly kind: "tool" | "section";
+    /** Tool name or section key. */
+    readonly name: string;
+    readonly error: unknown;
+};
+/** Immutable view of one published registry state. */
+export interface RegistrySnapshot<Tool extends ToolRegistration = ToolRegistration> {
+    /** Composed tools in registry order; a tool whose wrapper failed is absent. */
+    tools(): readonly Tool[];
+    tool(name: string): Tool | undefined;
+    /** Base tool names in registry order, including tools whose wrappers fail. */
+    toolNames(): readonly string[];
+    task(name: string): AnyTask | undefined;
+    /** Hooks registered for tasks with `task`'s name, in registry order. */
+    hooks<K extends AnyTask>(task: K): readonly HookRegistration<K>[];
+    /** Composed sections in registry order; a section whose wrapper failed is absent. */
+    sections(): readonly PromptSection<Tool>[];
+    /** Wrapper failures of this state. */
+    failures(): readonly RegistryFailure[];
+    /** Conversation setups in registry order, the built-in `pi` setup first. */
+    conversationSetups(): readonly {
+        readonly key: string;
+        readonly setup: ConversationSetup;
+    }[];
+}
+/** Read side of a registry consumed by a Harness. */
+export interface RegistryReader<Tool extends ToolRegistration = ToolRegistration> {
+    /** Immutable view of the whole current registry. */
+    snapshot(): RegistrySnapshot<Tool>;
+    /** Called synchronously after every publication; wakes the scheduler to reconsider blocked tasks. */
+    subscribe(listener: () => void): () => void;
+}
+/** Application-owned registry of tools, hooks, tasks, and the system prompt. */
+export interface Registry<Tool extends ToolRegistration = ToolRegistration> extends RegistryReader<Tool> {
+    readonly tools: {
+        add(tool: Tool): Registration;
+        /** `key` identifies the wrapper: it orders wrappers of one tool and keeps its position on re-registration. */
+        wrap(name: string, key: string, wrapper: ToolWrapper<Tool>): Registration;
+        /** Composed tools of the current state. */
+        list(): readonly Tool[];
+    };
+    readonly hooks: {
+        add<K extends AnyTask>(task: K, handlers: Partial<HooksOf<K>>, options?: {
+            readonly scope?: HookScope;
+            readonly key?: string;
+        }): Registration;
+    };
+    readonly tasks: {
+        add(task: AnyTask): Registration;
+        list(): readonly AnyTask[];
+    };
+    readonly conversations: {
+        /** `key` orders setups and keeps its position on re-registration. */
+        setup(key: string, setup: ConversationSetup): Registration;
+    };
+    readonly systemPrompt: {
+        section(key: string, render: PromptSection<Tool>["render"], options?: {
+            readonly tag?: boolean;
+        }): Registration;
+        wrap(key: string, wrapperKey: string, wrapper: PromptSectionWrapper<Tool>): Registration;
+        /** Composed sections of the current state. */
+        sections(): readonly PromptSection<Tool>[];
+    };
+    /** Stage registrations and disposals made synchronously by `register`, then publish them at once. Cannot nest. */
+    batch(register: () => void): Registration;
+}
+/**
+ * Stages the documents every new conversation gets. Runs inside every Harness commit that creates or forks a
+ * conversation, including raw `Tx` creation, after fork copies and before host `init`. Table reads throw, since the
+ * conversation write came first; a fork (`conversation.parent`) already holds its copied documents. A throw fails the
+ * creating commit.
+ */
+export type ConversationSetup = (tx: Tx, conversation: ConversationRecord, registry: RegistrySnapshot) => void | Promise<void>;
+/**
+ * Runs inside the creating commit, after the conversation and its configuration exist. The conversation creation is
+ * already a table write, so table reads here throw `ReadAfterWrite`; document access remains available.
+ */
+export type ConversationInit = (tx: Tx, conversationId: ConversationId) => void | Promise<void>;
+export type ConversationCreateOptions = {
+    readonly ownership: ConversationOwnership;
+    readonly init?: ConversationInit;
+};
+/** Curated pi-ai request options; absent fields use pi-ai defaults. */
+export type ConversationStreamOptions = {
+    transport?: Transport;
+    timeoutMs?: number;
+    /** Provider/SDK retries inside one request attempt. */
+    maxRetries?: number;
+    maxRetryDelayMs?: number;
+    headers?: Record<string, string>;
+    metadata?: JsonObject;
+    cacheRetention?: CacheRetention;
+    deferred?: boolean | {
+        window?: "15m" | "1h" | "24h";
+    };
+};
+/** Durable generation attempt retries; the JSON shape of pi-ai `RetryPolicy`. */
+export type ConversationRetryPolicy = {
+    enabled: boolean;
+    maxRetries: number;
+    baseDelayMs: number;
+    maxAgentDelayMs?: number;
+};
+export type HarnessOptions<Tool extends ToolRegistration = ToolRegistration> = {
+    /** pi-ai model access used by generation. */
+    readonly models: Models;
+    readonly registry: RegistryReader<Tool>;
+    readonly now?: () => number;
+    /** Receives extension failures that do not fail the calling operation. Must not throw. */
+    readonly onReport?: (error: unknown) => void;
+};
+/** Live task and what the scheduler would do with it under the current registry. */
+export type TaskInspection = {
+    readonly record: TaskRecord<JsonValue, JsonValue, JsonValue>;
+    readonly state: {
+        readonly kind: "running";
+    }
+    /** The next scheduling pass reserves it; `migrates` when its definition is newer and has `migrate`. */
+     | {
+        readonly kind: "ready";
+        readonly migrates: boolean;
+    }
+    /** Pending until these tasks are terminal. */
+     | {
+        readonly kind: "waiting";
+        readonly on: readonly TaskId[];
+    }
+    /** No registered definition can take it; aborting it settles it as `orphaned`. */
+     | {
+        readonly kind: "blocked";
+        readonly reason: "missing_task" | "task_too_old" | "migration_failed";
+        readonly error?: unknown;
+    };
+};
+/** Point-in-time view of live work: unfinished tasks and submissions, read on the Session line. */
+export type HarnessInspection = {
+    readonly scheduling: "paused" | "running" | "closing";
+    readonly tasks: readonly TaskInspection[];
+    /** Queued and placed submissions, in ID order. */
+    readonly submissions: readonly SubmissionRecord[];
+    /** Wrapper failures of the current registry snapshot. */
+    readonly registry: readonly RegistryFailure[];
+};
+/** Raw active transcript and derived model context. */
+export type ContextView = {
+    /** Newest applicable head marker, if any. */
+    readonly head: EntryRecord | undefined;
+    /** Raw active entries: the head marker followed by non-head entries from its head through the tail. */
+    readonly entries: readonly EntryRecord[];
+    /** Model context for the next provider request. */
+    readonly messages: readonly Message[];
+};
+/** Stateless handle for one conversation, bound to the Harness that returned it. Compare handles by `id`. */
+export interface Conversation {
+    readonly id: ConversationId;
+    getModel(context: Context): Promise<ModelRef | undefined>;
+    setModel(model: ModelRef | undefined, context: Context): Promise<void>;
+    getThinkingLevel(context: Context): Promise<ModelThinkingLevel>;
+    setThinkingLevel(level: ModelThinkingLevel, context: Context): Promise<void>;
+    getActiveTools(context: Context): Promise<readonly string[]>;
+    setActiveTools(names: readonly string[], context: Context): Promise<void>;
+    /** `{}` when unset. */
+    getStreamOptions(context: Context): Promise<ConversationStreamOptions>;
+    setStreamOptions(options: ConversationStreamOptions, context: Context): Promise<void>;
+    /** The default policy when unset. */
+    getRetryPolicy(context: Context): Promise<ConversationRetryPolicy>;
+    /** `undefined` removes the configured policy. */
+    setRetryPolicy(policy: ConversationRetryPolicy | undefined, context: Context): Promise<void>;
+    /**
+     * Durably admit user input or a passive entry write. Until the inbox exists, a busy conversation rejects every
+     * submission with `ConversationBusy`.
+     */
+    submit(submission: SubmissionDraft, context: Context): Promise<Submission>;
+    /** Session commit whose `tx.createTask()` defaults to this conversation. */
+    commit<T>(change: (tx: Tx) => T | Promise<T>, context: Context): Promise<T>;
+    context(context: Context): Promise<ContextView>;
+    /** Newest-first fork-aware history of this conversation. */
+    entries(query: Omit<EntryQuery, "conversationId">, limit: number, cursor: Cursor | undefined, context: Context): Promise<Page<EntryRecord, Cursor>>;
+    fork(at: EntryId, options: ConversationCreateOptions, context: Context): Promise<Conversation>;
+    /** Resolve when no live non-background task belongs to this conversation. */
+    waitForIdle(context: Context): Promise<void>;
+}
+/** Durable agent harness over one Session. */
+export interface Harness extends Session {
+    /**
+     * Enable task scheduling. Idempotent; throws after close. Calls that wait for progress (`Conversation.submit()`,
+     * `Submission.wait()`, `waitForTask()`, `waitForIdle()`) enable it too.
+     */
+    resume(): void;
+    /** Return the reserved root conversation, creating it with `init` in one commit when absent. */
+    root(context: Context, options?: {
+        readonly init?: ConversationInit;
+    }): Promise<Conversation>;
+    conversation(id: ConversationId, context: Context): Promise<Conversation | undefined>;
+    createConversation(options: ConversationCreateOptions, context: Context): Promise<Conversation>;
+    getTask<R>(id: TaskId<R>, context: Context): Promise<TaskRecord<JsonValue, JsonValue, R> | undefined>;
+    /** Live tasks, unsettled submissions, and registry failures. Writes nothing and runs no task code. */
+    inspect(context: Context): Promise<HarnessInspection>;
+    /** Reacquire a submission, for example after reopen. */
+    submission(id: SubmissionId, context: Context): Promise<Submission | undefined>;
+    /** `not_found` for an unknown submission or one of another conversation than `conversationId`. */
+    abortSubmission(id: SubmissionId, context: Context, conversationId?: ConversationId): Promise<"aborted" | "already_placed" | "settled" | "not_found">;
+    /**
+     * Commit the abort mark, signal and join an active run invocation, and schedule the abort invocation. A task whose
+     * definition cannot take it settles as `orphaned` instead.
+     */
+    abortTask(id: TaskId, context: Context): Promise<"marked" | "terminal">;
+    /** Resolve with the terminal receipt; cancelling `context` cancels only this wait. */
+    waitForTask<R>(id: TaskId<R>, context: Context): Promise<SettledTask<R>>;
+    /** Resolve when no live non-background task exists. */
+    waitForIdle(context: Context): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/harness/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"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"}

package/dist/harness/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/harness/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Context, JsonValue } from \"@earendil-works/chord\";\nimport type {\n\tCacheRetention,\n\tMessage,\n\tModels,\n\tModelThinkingLevel,\n\tTool,\n\tToolResultMessage,\n\tTransport,\n\tUserMessage,\n} from \"@earendil-works/pi-ai\";\nimport type {\n\tConversationId,\n\tConversationOwnership,\n\tConversationRecord,\n\tCursor,\n\tDocumentObserver,\n\tDocumentReader,\n\tEntryDraft,\n\tEntryId,\n\tEntryQuery,\n\tEntryRecord,\n\tJsonObject,\n\tPage,\n\tSession,\n\tSubmissionId,\n\tSubmissionRecord,\n\tTask,\n\tTaskId,\n\tTaskOptions,\n\tTaskRecord,\n\tTaskState,\n\tTx,\n} from \"../types.ts\";\n\n/** Provider and model ID resolved through pi-ai `Models`. */\nexport type ModelRef = {\n\treadonly provider: string;\n\treadonly modelId: string;\n};\n\nexport type UserInput = UserMessage[\"content\"];\n\n/** Host submission: user input that may start a run, or a passive entry write. */\nexport type SubmissionDraft = {\n\treadonly requestId?: string;\n} & (\n\t| {\n\t\t\treadonly type: \"input\";\n\t\t\treadonly content: UserInput;\n\t\t\treadonly whenBusy?: \"steer\" | \"followUp\" | \"reject\";\n\t\t\treadonly entry?: never;\n\t  }\n\t| {\n\t\t\treadonly type: \"write\";\n\t\t\treadonly entry: EntryDraft;\n\t\t\treadonly content?: never;\n\t\t\treadonly whenBusy?: never;\n\t  }\n);\n\nexport type InputSubmissionDraft = Extract<SubmissionDraft, { readonly type: \"input\" }>;\n\nexport type SettledSubmissionRecord = SubmissionRecord & {\n\treadonly status: \"done\" | \"unanswered\";\n};\n\n/** Awaitable host object for one durably admitted submission. */\nexport interface Submission {\n\treadonly id: SubmissionId;\n\tstatus(context: Context): Promise<SubmissionRecord>;\n\twait(context: Context): Promise<SettledSubmissionRecord>;\n\tabort(context: Context): Promise<\"aborted\" | \"already_placed\" | \"settled\">;\n}\n\nexport type SettledTask<R> = TaskRecord<JsonValue, JsonValue, R> & {\n\treadonly state: Extract<TaskState<JsonValue, R>, { readonly status: \"terminal\" }>;\n};\n\n/** Erased executable task definition stored in the registry. */\nexport type AnyTask = {\n\treadonly definition: {\n\t\treadonly name: string;\n\t\treadonly version: number;\n\t\treadonly initial: unknown;\n\t\treadonly phases: Readonly<Record<string, unknown>>;\n\t\treadonly abort: unknown;\n\t\treadonly migrate?: unknown;\n\t\treadonly hooks?: object;\n\t};\n};\n\n/** Hook handler map declared by a task definition. */\nexport type HooksOf<K> = K extends Task<infer _I, infer _S, infer _R, infer H> ? H : never;\n\n/** Invocation-bound conversation operations available to tools. */\nexport interface ConversationHandle {\n\treadonly id: ConversationId;\n\tsubmit(submission: InputSubmissionDraft, context: Context): Promise<Submission>;\n\tabort(context: Context): Promise<void>;\n\twaitForIdle(context: Context): Promise<void>;\n}\n\n/** Post-tools controls requested by a tool result. */\nexport type ToolControl = {\n\treadonly addTools?: readonly string[];\n\treadonly terminate?: true;\n\treadonly handoff?: string;\n};\n\nexport type ToolExecutionResult = {\n\treadonly content?: ToolResultMessage[\"content\"];\n\treadonly isError?: boolean;\n\treadonly details?: JsonValue;\n\treadonly control?: ToolControl;\n};\n\n/** Operations available to one tool invocation. */\nexport interface ToolExecutionApi extends DocumentObserver, DocumentReader {\n\treadonly taskId: TaskId;\n\treadonly conversationId: ConversationId;\n\treadonly callId: string;\n\t/** Append running output; it becomes the result content when the result omits `content`. */\n\toutput(chunk: string | Uint8Array): void;\n\t/** Replace running details; the last value becomes the result details when the result omits `details`. */\n\tdetails(value: JsonValue, context: Context): Promise<void>;\n\tcommit<T>(change: (tx: Tx) => T | Promise<T>, context: Context): Promise<T>;\n\tmemo<T extends JsonValue>(name: string, context: Context): Promise<T | undefined>;\n\tmemo<T extends JsonValue>(name: string, candidate: T, context: Context): Promise<T>;\n\tcreateTask<I, S extends { phase: string }, R, H extends object>(\n\t\ttask: Task<I, S, R, H>,\n\t\tinput: I,\n\t\toptions: Omit<TaskOptions, \"conversationId\">,\n\t\tcontext: Context,\n\t): Promise<TaskId<R>>;\n\tgetTask<R>(id: TaskId<R>, context: Context): Promise<TaskRecord<JsonValue, JsonValue, R> | undefined>;\n\twaitForTask<R>(id: TaskId<R>, context: Context): Promise<SettledTask<R>>;\n\tconversation(id: ConversationId, context: Context): Promise<ConversationHandle | undefined>;\n}\n\n/** Executable tool registered in a registry. Only pi-ai `Tool` fields enter the transcript. */\nexport type ToolRegistration = Tool & {\n\t/** Whether an interrupted execution may rerun on recovery. Default `unsafe`. */\n\treadonly replay?: \"safe\" | \"unsafe\";\n\treadonly outputLimits?: {\n\t\treadonly maxBytes?: number;\n\t\treadonly maxLines?: number;\n\t\treadonly retain?: \"head\" | \"tail\";\n\t};\n\texecute(args: JsonValue, api: ToolExecutionApi, context: Context): Promise<ToolExecutionResult>;\n};\n\n/** Token for removing registrations. Work already running keeps using what it started with. */\nexport interface Registration {\n\t/** Idempotent; removes exactly the registrations this token covers. */\n\tdispose(): void;\n}\n\n/** Pure decorator; returns a new tool with the same name and never mutates its input. */\nexport type ToolWrapper<Tool extends ToolRegistration> = (tool: Tool) => Tool;\n\n/** Conversation selection for a scoped hook registration. */\nexport type HookScope = {\n\treadonly conversationId: ConversationId;\n\t/** Also match conversations owned, transitively, by tasks of this conversation. */\n\treadonly subtree?: boolean;\n};\n\n/** Input to system prompt section rendering for one request preparation. */\nexport type PromptInput<Tool extends ToolRegistration> = {\n\treadonly conversationId: ConversationId;\n\t/** Active and registered tools in configured order, as offered in this request. */\n\treadonly tools: readonly Tool[];\n\t/** Sections already in effect after replaying the active transcript. */\n\treadonly shown: Readonly<Record<string, string>>;\n\treadonly model?: ModelRef;\n\treadonly thinkingLevel: ModelThinkingLevel;\n\t/** Committed document reads. */\n\treadonly read: DocumentReader;\n};\n\n/** One registered system prompt section; sections render in registry order before each request. */\nexport type PromptSection<Tool extends ToolRegistration> = {\n\treadonly key: string;\n\trender(input: PromptInput<Tool>, context: Context): string | undefined | Promise<string | undefined>;\n\t/** Default true: wrap the text as `<key>\\n...\\n</key>`. */\n\treadonly tag?: boolean;\n};\n\n/** Pure decorator; returns a new section with the same key and never mutates its input. */\nexport type PromptSectionWrapper<Tool extends ToolRegistration> = (section: PromptSection<Tool>) => PromptSection<Tool>;\n\n/** One registered hook handler map for task `K`. */\nexport type HookRegistration<K extends AnyTask> = {\n\treadonly handlers: Partial<HooksOf<K>>;\n\treadonly scope?: HookScope;\n};\n\n/** Wrapper composition failure found while building a snapshot. */\nexport type RegistryFailure = {\n\treadonly kind: \"tool\" | \"section\";\n\t/** Tool name or section key. */\n\treadonly name: string;\n\treadonly error: unknown;\n};\n\n/** Immutable view of one published registry state. */\nexport interface RegistrySnapshot<Tool extends ToolRegistration = ToolRegistration> {\n\t/** Composed tools in registry order; a tool whose wrapper failed is absent. */\n\ttools(): readonly Tool[];\n\ttool(name: string): Tool | undefined;\n\t/** Base tool names in registry order, including tools whose wrappers fail. */\n\ttoolNames(): readonly string[];\n\ttask(name: string): AnyTask | undefined;\n\t/** Hooks registered for tasks with `task`'s name, in registry order. */\n\thooks<K extends AnyTask>(task: K): readonly HookRegistration<K>[];\n\t/** Composed sections in registry order; a section whose wrapper failed is absent. */\n\tsections(): readonly PromptSection<Tool>[];\n\t/** Wrapper failures of this state. */\n\tfailures(): readonly RegistryFailure[];\n\t/** Conversation setups in registry order, the built-in `pi` setup first. */\n\tconversationSetups(): readonly { readonly key: string; readonly setup: ConversationSetup }[];\n}\n\n/** Read side of a registry consumed by a Harness. */\nexport interface RegistryReader<Tool extends ToolRegistration = ToolRegistration> {\n\t/** Immutable view of the whole current registry. */\n\tsnapshot(): RegistrySnapshot<Tool>;\n\t/** Called synchronously after every publication; wakes the scheduler to reconsider blocked tasks. */\n\tsubscribe(listener: () => void): () => void;\n}\n\n/** Application-owned registry of tools, hooks, tasks, and the system prompt. */\nexport interface Registry<Tool extends ToolRegistration = ToolRegistration> extends RegistryReader<Tool> {\n\treadonly tools: {\n\t\tadd(tool: Tool): Registration;\n\t\t/** `key` identifies the wrapper: it orders wrappers of one tool and keeps its position on re-registration. */\n\t\twrap(name: string, key: string, wrapper: ToolWrapper<Tool>): Registration;\n\t\t/** Composed tools of the current state. */\n\t\tlist(): readonly Tool[];\n\t};\n\treadonly hooks: {\n\t\tadd<K extends AnyTask>(\n\t\t\ttask: K,\n\t\t\thandlers: Partial<HooksOf<K>>,\n\t\t\toptions?: { readonly scope?: HookScope; readonly key?: string },\n\t\t): Registration;\n\t};\n\treadonly tasks: {\n\t\tadd(task: AnyTask): Registration;\n\t\tlist(): readonly AnyTask[];\n\t};\n\treadonly conversations: {\n\t\t/** `key` orders setups and keeps its position on re-registration. */\n\t\tsetup(key: string, setup: ConversationSetup): Registration;\n\t};\n\treadonly systemPrompt: {\n\t\tsection(key: string, render: PromptSection<Tool>[\"render\"], options?: { readonly tag?: boolean }): Registration;\n\t\twrap(key: string, wrapperKey: string, wrapper: PromptSectionWrapper<Tool>): Registration;\n\t\t/** Composed sections of the current state. */\n\t\tsections(): readonly PromptSection<Tool>[];\n\t};\n\t/** Stage registrations and disposals made synchronously by `register`, then publish them at once. Cannot nest. */\n\tbatch(register: () => void): Registration;\n}\n\n/**\n * Stages the documents every new conversation gets. Runs inside every Harness commit that creates or forks a\n * conversation, including raw `Tx` creation, after fork copies and before host `init`. Table reads throw, since the\n * conversation write came first; a fork (`conversation.parent`) already holds its copied documents. A throw fails the\n * creating commit.\n */\nexport type ConversationSetup = (\n\ttx: Tx,\n\tconversation: ConversationRecord,\n\tregistry: RegistrySnapshot,\n) => void | Promise<void>;\n\n/**\n * Runs inside the creating commit, after the conversation and its configuration exist. The conversation creation is\n * already a table write, so table reads here throw `ReadAfterWrite`; document access remains available.\n */\nexport type ConversationInit = (tx: Tx, conversationId: ConversationId) => void | Promise<void>;\n\nexport type ConversationCreateOptions = {\n\treadonly ownership: ConversationOwnership;\n\treadonly init?: ConversationInit;\n};\n\n/** Curated pi-ai request options; absent fields use pi-ai defaults. */\nexport type ConversationStreamOptions = {\n\ttransport?: Transport;\n\ttimeoutMs?: number;\n\t/** Provider/SDK retries inside one request attempt. */\n\tmaxRetries?: number;\n\tmaxRetryDelayMs?: number;\n\theaders?: Record<string, string>;\n\tmetadata?: JsonObject;\n\tcacheRetention?: CacheRetention;\n\tdeferred?: boolean | { window?: \"15m\" | \"1h\" | \"24h\" };\n};\n\n/** Durable generation attempt retries; the JSON shape of pi-ai `RetryPolicy`. */\nexport type ConversationRetryPolicy = {\n\tenabled: boolean;\n\tmaxRetries: number;\n\tbaseDelayMs: number;\n\tmaxAgentDelayMs?: number;\n};\n\nexport type HarnessOptions<Tool extends ToolRegistration = ToolRegistration> = {\n\t/** pi-ai model access used by generation. */\n\treadonly models: Models;\n\treadonly registry: RegistryReader<Tool>;\n\treadonly now?: () => number;\n\t/** Receives extension failures that do not fail the calling operation. Must not throw. */\n\treadonly onReport?: (error: unknown) => void;\n};\n\n/** Live task and what the scheduler would do with it under the current registry. */\nexport type TaskInspection = {\n\treadonly record: TaskRecord<JsonValue, JsonValue, JsonValue>;\n\treadonly state: /** An invocation is active. */\n\t\t| { readonly kind: \"running\" }\n\t\t/** The next scheduling pass reserves it; `migrates` when its definition is newer and has `migrate`. */\n\t\t| { readonly kind: \"ready\"; readonly migrates: boolean }\n\t\t/** Pending until these tasks are terminal. */\n\t\t| { readonly kind: \"waiting\"; readonly on: readonly TaskId[] }\n\t\t/** No registered definition can take it; aborting it settles it as `orphaned`. */\n\t\t| {\n\t\t\t\treadonly kind: \"blocked\";\n\t\t\t\treadonly reason: \"missing_task\" | \"task_too_old\" | \"migration_failed\";\n\t\t\t\treadonly error?: unknown;\n\t\t  };\n};\n\n/** Point-in-time view of live work: unfinished tasks and submissions, read on the Session line. */\nexport type HarnessInspection = {\n\treadonly scheduling: \"paused\" | \"running\" | \"closing\";\n\treadonly tasks: readonly TaskInspection[];\n\t/** Queued and placed submissions, in ID order. */\n\treadonly submissions: readonly SubmissionRecord[];\n\t/** Wrapper failures of the current registry snapshot. */\n\treadonly registry: readonly RegistryFailure[];\n};\n\n/** Raw active transcript and derived model context. */\nexport type ContextView = {\n\t/** Newest applicable head marker, if any. */\n\treadonly head: EntryRecord | undefined;\n\t/** Raw active entries: the head marker followed by non-head entries from its head through the tail. */\n\treadonly entries: readonly EntryRecord[];\n\t/** Model context for the next provider request. */\n\treadonly messages: readonly Message[];\n};\n\n/** Stateless handle for one conversation, bound to the Harness that returned it. Compare handles by `id`. */\nexport interface Conversation {\n\treadonly id: ConversationId;\n\n\tgetModel(context: Context): Promise<ModelRef | undefined>;\n\tsetModel(model: ModelRef | undefined, context: Context): Promise<void>;\n\tgetThinkingLevel(context: Context): Promise<ModelThinkingLevel>;\n\tsetThinkingLevel(level: ModelThinkingLevel, context: Context): Promise<void>;\n\tgetActiveTools(context: Context): Promise<readonly string[]>;\n\tsetActiveTools(names: readonly string[], context: Context): Promise<void>;\n\t/** `{}` when unset. */\n\tgetStreamOptions(context: Context): Promise<ConversationStreamOptions>;\n\tsetStreamOptions(options: ConversationStreamOptions, context: Context): Promise<void>;\n\t/** The default policy when unset. */\n\tgetRetryPolicy(context: Context): Promise<ConversationRetryPolicy>;\n\t/** `undefined` removes the configured policy. */\n\tsetRetryPolicy(policy: ConversationRetryPolicy | undefined, context: Context): Promise<void>;\n\n\t/**\n\t * Durably admit user input or a passive entry write. Until the inbox exists, a busy conversation rejects every\n\t * submission with `ConversationBusy`.\n\t */\n\tsubmit(submission: SubmissionDraft, context: Context): Promise<Submission>;\n\n\t/** Session commit whose `tx.createTask()` defaults to this conversation. */\n\tcommit<T>(change: (tx: Tx) => T | Promise<T>, context: Context): Promise<T>;\n\tcontext(context: Context): Promise<ContextView>;\n\t/** Newest-first fork-aware history of this conversation. */\n\tentries(\n\t\tquery: Omit<EntryQuery, \"conversationId\">,\n\t\tlimit: number,\n\t\tcursor: Cursor | undefined,\n\t\tcontext: Context,\n\t): Promise<Page<EntryRecord, Cursor>>;\n\tfork(at: EntryId, options: ConversationCreateOptions, context: Context): Promise<Conversation>;\n\t/** Resolve when no live non-background task belongs to this conversation. */\n\twaitForIdle(context: Context): Promise<void>;\n}\n\n// TODO: decide how Harness exposes subscribeCommits() and subscribeClose(). Their listeners run on the Session line\n// and must not throw or call Session APIs, and Harness close will also join task invocations.\n/** Durable agent harness over one Session. */\nexport interface Harness extends Session {\n\t/**\n\t * Enable task scheduling. Idempotent; throws after close. Calls that wait for progress (`Conversation.submit()`,\n\t * `Submission.wait()`, `waitForTask()`, `waitForIdle()`) enable it too.\n\t */\n\tresume(): void;\n\n\t/** Return the reserved root conversation, creating it with `init` in one commit when absent. */\n\troot(context: Context, options?: { readonly init?: ConversationInit }): Promise<Conversation>;\n\t// Conversation activity (active/idle notifications) is specified with run control in Package 17.\n\tconversation(id: ConversationId, context: Context): Promise<Conversation | undefined>;\n\tcreateConversation(options: ConversationCreateOptions, context: Context): Promise<Conversation>;\n\n\tgetTask<R>(id: TaskId<R>, context: Context): Promise<TaskRecord<JsonValue, JsonValue, R> | undefined>;\n\t/** Live tasks, unsettled submissions, and registry failures. Writes nothing and runs no task code. */\n\tinspect(context: Context): Promise<HarnessInspection>;\n\t/** Reacquire a submission, for example after reopen. */\n\tsubmission(id: SubmissionId, context: Context): Promise<Submission | undefined>;\n\t/** `not_found` for an unknown submission or one of another conversation than `conversationId`. */\n\tabortSubmission(\n\t\tid: SubmissionId,\n\t\tcontext: Context,\n\t\tconversationId?: ConversationId,\n\t): Promise<\"aborted\" | \"already_placed\" | \"settled\" | \"not_found\">;\n\t/**\n\t * Commit the abort mark, signal and join an active run invocation, and schedule the abort invocation. A task whose\n\t * definition cannot take it settles as `orphaned` instead.\n\t */\n\tabortTask(id: TaskId, context: Context): Promise<\"marked\" | \"terminal\">;\n\t/** Resolve with the terminal receipt; cancelling `context` cancels only this wait. */\n\twaitForTask<R>(id: TaskId<R>, context: Context): Promise<SettledTask<R>>;\n\t/** Resolve when no live non-background task exists. */\n\twaitForIdle(context: Context): Promise<void>;\n}\n"]}

package/dist/harness/util.d.ts

@@ -0,0 +1,14 @@
+import type { Context } from "@earendil-works/chord";
+import type { Cursor, Page } from "../types.ts";
+/** Pending waits by key. Each settles once: through `resolve`, `rejectAll`, or cancellation of its context. */
+export declare class Waiters<K, T> {
+    #private;
+    add(key: K, context: Context): Promise<T>;
+    keys(): K[];
+    resolve(key: K, value: T): void;
+    rejectAll(error: unknown): void;
+}
+/** Every item of a paginated scan, in page order. */
+export declare function scanAll<T>(scan: (cursor: Cursor | undefined) => Promise<Page<T, Cursor>>): Promise<T[]>;
+export declare function closedError(): Error;
+//# sourceMappingURL=util.d.ts.map

package/dist/harness/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/harness/util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEhD,+GAA+G;AAC/G,qBAAa,OAAO,CAAC,CAAC,EAAE,CAAC;;IAGxB,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAiBxC;IAED,IAAI,IAAI,CAAC,EAAE,CAEV;IAED,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAI9B;IAED,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAI9B;CACD;AAED,qDAAqD;AACrD,wBAAsB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAS7G;AAED,wBAAgB,WAAW,IAAI,KAAK,CAEnC"}

package/dist/harness/util.js

@@ -0,0 +1,55 @@
+/** Pending waits by key. Each settles once: through `resolve`, `rejectAll`, or cancellation of its context. */
+export class Waiters {
+    #sets = new Map();
+    add(key, context) {
+        const signal = context.abortSignal;
+        if (signal?.aborted)
+            return Promise.reject(signal.reason);
+        const waiter = Promise.withResolvers();
+        const set = this.#sets.get(key) ?? new Set();
+        this.#sets.set(key, set.add(waiter));
+        if (signal !== undefined) {
+            const onAbort = () => {
+                set.delete(waiter);
+                if (set.size === 0 && this.#sets.get(key) === set)
+                    this.#sets.delete(key);
+                waiter.reject(signal.reason);
+            };
+            signal.addEventListener("abort", onAbort, { once: true });
+            const detach = () => signal.removeEventListener("abort", onAbort);
+            waiter.promise.then(detach, detach);
+        }
+        return waiter.promise;
+    }
+    keys() {
+        return [...this.#sets.keys()];
+    }
+    resolve(key, value) {
+        const set = this.#sets.get(key);
+        this.#sets.delete(key);
+        for (const waiter of set ?? [])
+            waiter.resolve(value);
+    }
+    rejectAll(error) {
+        const sets = [...this.#sets.values()];
+        this.#sets.clear();
+        for (const set of sets)
+            for (const waiter of set)
+                waiter.reject(error);
+    }
+}
+/** Every item of a paginated scan, in page order. */
+export async function scanAll(scan) {
+    const items = [];
+    let cursor;
+    do {
+        const page = await scan(cursor);
+        items.push(...page.items);
+        cursor = page.next;
+    } while (cursor !== undefined);
+    return items;
+}
+export function closedError() {
+    return new Error("Harness is closed");
+}
+//# sourceMappingURL=util.js.map

package/dist/harness/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/harness/util.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Context } from \"@earendil-works/chord\";\nimport type { Cursor, Page } from \"../types.ts\";\n\n/** Pending waits by key. Each settles once: through `resolve`, `rejectAll`, or cancellation of its context. */\nexport class Waiters<K, T> {\n\treadonly #sets = new Map<K, Set<PromiseWithResolvers<T>>>();\n\n\tadd(key: K, context: Context): Promise<T> {\n\t\tconst signal = context.abortSignal;\n\t\tif (signal?.aborted) return Promise.reject(signal.reason);\n\t\tconst waiter = Promise.withResolvers<T>();\n\t\tconst set = this.#sets.get(key) ?? new Set();\n\t\tthis.#sets.set(key, set.add(waiter));\n\t\tif (signal !== undefined) {\n\t\t\tconst onAbort = (): void => {\n\t\t\t\tset.delete(waiter);\n\t\t\t\tif (set.size === 0 && this.#sets.get(key) === set) this.#sets.delete(key);\n\t\t\t\twaiter.reject(signal.reason);\n\t\t\t};\n\t\t\tsignal.addEventListener(\"abort\", onAbort, { once: true });\n\t\t\tconst detach = (): void => signal.removeEventListener(\"abort\", onAbort);\n\t\t\twaiter.promise.then(detach, detach);\n\t\t}\n\t\treturn waiter.promise;\n\t}\n\n\tkeys(): K[] {\n\t\treturn [...this.#sets.keys()];\n\t}\n\n\tresolve(key: K, value: T): void {\n\t\tconst set = this.#sets.get(key);\n\t\tthis.#sets.delete(key);\n\t\tfor (const waiter of set ?? []) waiter.resolve(value);\n\t}\n\n\trejectAll(error: unknown): void {\n\t\tconst sets = [...this.#sets.values()];\n\t\tthis.#sets.clear();\n\t\tfor (const set of sets) for (const waiter of set) waiter.reject(error);\n\t}\n}\n\n/** Every item of a paginated scan, in page order. */\nexport async function scanAll<T>(scan: (cursor: Cursor | undefined) => Promise<Page<T, Cursor>>): Promise<T[]> {\n\tconst items: T[] = [];\n\tlet cursor: Cursor | undefined;\n\tdo {\n\t\tconst page = await scan(cursor);\n\t\titems.push(...page.items);\n\t\tcursor = page.next;\n\t} while (cursor !== undefined);\n\treturn items;\n}\n\nexport function closedError(): Error {\n\treturn new Error(\"Harness is closed\");\n}\n"]}

package/dist/ids.d.ts

@@ -0,0 +1,6 @@
+import type { Id, Seq } from "./types.ts";
+/** Apply an erased ID brand at a trusted numeric allocation or decoding boundary. */
+export declare function idFromNumber<I extends Id<string>>(value: number): I;
+/** Apply the erased commit-sequence brand at a trusted storage boundary. */
+export declare function seqFromNumber(value: number): Seq;
+//# sourceMappingURL=ids.d.ts.map

package/dist/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAE1C,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAEnE;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAEhD"}

package/dist/ids.js

@@ -0,0 +1,9 @@
+/** Apply an erased ID brand at a trusted numeric allocation or decoding boundary. */
+export function idFromNumber(value) {
+    return value;
+}
+/** Apply the erased commit-sequence brand at a trusted storage boundary. */
+export function seqFromNumber(value) {
+    return value;
+}
+//# sourceMappingURL=ids.js.map

package/dist/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAAuB,KAAa;IAC/D,OAAO,KAAU,CAAC;AACnB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,KAAa;IAC1C,OAAO,KAAY,CAAC;AACrB,CAAC","sourcesContent":["import type { Id, Seq } from \"./types.ts\";\n\n/** Apply an erased ID brand at a trusted numeric allocation or decoding boundary. */\nexport function idFromNumber<I extends Id<string>>(value: number): I {\n\treturn value as I;\n}\n\n/** Apply the erased commit-sequence brand at a trusted storage boundary. */\nexport function seqFromNumber(value: number): Seq {\n\treturn value as Seq;\n}\n"]}

package/dist/index.d.ts

@@ -1,4 +1,15 @@
+export { defineDoc, defineDocFamily } from "./documents.ts";
+export { AssistantEntry, defineEntry, SystemEntry, ToolResultEntry, UserEntry } from "./entries.ts";
+export { ConversationBusy, ReadAfterWrite, StorageRejected } from "./errors.ts";
+export { ConversationConfig, type ConversationConfigState } from "./harness/config.ts";
+export { type GenerationCheckpoint, type GenerationInput, type GenerationResult, GenerationTask, } from "./harness/generation.ts";
+export { Harness } from "./harness/harness.ts";
+export { LiveDoc, type LiveState } from "./harness/live.ts";
+export { createRegistry } from "./harness/registry.ts";
+export type { AnyTask, ContextView, Conversation, ConversationCreateOptions, ConversationHandle, ConversationInit, ConversationRetryPolicy, ConversationSetup, ConversationStreamOptions, HarnessInspection, HarnessOptions, HookRegistration, HookScope, HooksOf, InputSubmissionDraft, ModelRef, PromptInput, PromptSection, PromptSectionWrapper, Registration, Registry, RegistryFailure, RegistryReader, RegistrySnapshot, SettledSubmissionRecord, SettledTask, Submission, SubmissionDraft, TaskInspection, ToolControl, ToolExecutionApi, ToolExecutionResult, ToolRegistration, ToolWrapper, UserInput, } from "./harness/types.ts";
+export { createSession } from "./session/session.ts";
 export { MemoryStorage } from "./storage/memory.ts";
-export type { ContextEdit, ConversationRecord, Cursor, DocumentAddress, DocumentContent, DocumentCreate, DocumentPoint, DocumentQuery, DocumentRecord, EntryDraft, EntryQuery, EntryRecord, Id, JsonObject, Page, Seq, Storage, StorageWrite, StoredDocument, SubmissionCreate, SubmissionRecord, TaskOutcome, TaskOutcomeError, TaskQuery, TaskRecord, TaskState, } from "./types.ts";
+export { defineTask } from "./tasks.ts";
+export type { CheckpointInfo, CommitChange, CommitPublication, CommonDocDefinition, ContextEdit, ConversationDocFamilyToken, ConversationDocToken, ConversationId, ConversationOwnership, ConversationQuery, ConversationRecord, Cursor, DocDefinition, DocFamilyDefinition, DocFamilyToken, DocToken, DocumentAddress, DocumentCommitChange, DocumentContent, DocumentCopySource, DocumentCreate, DocumentId, DocumentObserver, DocumentPoint, DocumentQuery, DocumentReader, DocumentRecord, DocumentSemantics, DocumentState, DocumentWatch, Entry, EntryDraft, EntryId, EntryQuery, EntryRecord, Id, JsonObject, LatestConversationSemantics, NextTaskState, Page, PhaseHandler, RewindableConversationDocFamilyToken, RewindableConversationDocToken, RewindableConversationSemantics, RunningTask, Seq, Session, SessionDocFamilyToken, SessionDocToken, Storage, StorageWrite, StoredDocument, SubmissionCreate, SubmissionId, SubmissionQuery, SubmissionRecord, SubmissionSettlement, TableCommitChange, Task, TaskDefinition, TaskDocFamilyToken, TaskDocToken, TaskId, TaskOptions, TaskOutcome, TaskOutcomeError, TaskQuery, TaskRecord, TaskRuntime, TaskState, Tx, TypedEntry, TypedEntryDraft, WatchEnd, WatchHandle, } from "./types.ts";
 export { ROOT_CONVERSATION_ID } from "./types.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACX,WAAW,EACX,kBAAkB,EAClB,MAAM,EACN,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,UAAU,EACV,UAAU,EACV,WAAW,EACX,EAAE,EACF,UAAU,EACV,IAAI,EACJ,GAAG,EACH,OAAO,EACP,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,SAAS,GACT,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { MemoryStorage } from \"./storage/memory.ts\";\nexport type {\n\tContextEdit,\n\tConversationRecord,\n\tCursor,\n\tDocumentAddress,\n\tDocumentContent,\n\tDocumentCreate,\n\tDocumentPoint,\n\tDocumentQuery,\n\tDocumentRecord,\n\tEntryDraft,\n\tEntryQuery,\n\tEntryRecord,\n\tId,\n\tJsonObject,\n\tPage,\n\tSeq,\n\tStorage,\n\tStorageWrite,\n\tStoredDocument,\n\tSubmissionCreate,\n\tSubmissionRecord,\n\tTaskOutcome,\n\tTaskOutcomeError,\n\tTaskQuery,\n\tTaskRecord,\n\tTaskState,\n} from \"./types.ts\";\nexport { ROOT_CONVERSATION_ID } from \"./types.ts\";\n"]}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EACN,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,cAAc,GACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EACX,OAAO,EACP,WAAW,EACX,YAAY,EACZ,yBAAyB,EACzB,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,OAAO,EACP,oBAAoB,EACpB,QAAQ,EACR,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,UAAU,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,SAAS,GACT,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EACX,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,0BAA0B,EAC1B,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,MAAM,EACN,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,QAAQ,EACR,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,KAAK,EACL,UAAU,EACV,OAAO,EACP,UAAU,EACV,WAAW,EACX,EAAE,EACF,UAAU,EACV,2BAA2B,EAC3B,aAAa,EACb,IAAI,EACJ,YAAY,EACZ,oCAAoC,EACpC,8BAA8B,EAC9B,+BAA+B,EAC/B,WAAW,EACX,GAAG,EACH,OAAO,EACP,qBAAqB,EACrB,eAAe,EACf,OAAO,EACP,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,IAAI,EACJ,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,MAAM,EACN,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,WAAW,EACX,SAAS,EACT,EAAE,EACF,UAAU,EACV,eAAe,EACf,QAAQ,EACR,WAAW,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,3 +1,13 @@
+export { defineDoc, defineDocFamily } from "./documents.js";
+export { AssistantEntry, defineEntry, SystemEntry, ToolResultEntry, UserEntry } from "./entries.js";
+export { ConversationBusy, ReadAfterWrite, StorageRejected } from "./errors.js";
+export { ConversationConfig } from "./harness/config.js";
+export { GenerationTask, } from "./harness/generation.js";
+export { Harness } from "./harness/harness.js";
+export { LiveDoc } from "./harness/live.js";
+export { createRegistry } from "./harness/registry.js";
+export { createSession } from "./session/session.js";
 export { MemoryStorage } from "./storage/memory.js";
+export { defineTask } from "./tasks.js";
 export { ROOT_CONVERSATION_ID } from "./types.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AA6BpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { MemoryStorage } from \"./storage/memory.ts\";\nexport type {\n\tContextEdit,\n\tConversationRecord,\n\tCursor,\n\tDocumentAddress,\n\tDocumentContent,\n\tDocumentCreate,\n\tDocumentPoint,\n\tDocumentQuery,\n\tDocumentRecord,\n\tEntryDraft,\n\tEntryQuery,\n\tEntryRecord,\n\tId,\n\tJsonObject,\n\tPage,\n\tSeq,\n\tStorage,\n\tStorageWrite,\n\tStoredDocument,\n\tSubmissionCreate,\n\tSubmissionRecord,\n\tTaskOutcome,\n\tTaskOutcomeError,\n\tTaskQuery,\n\tTaskRecord,\n\tTaskState,\n} from \"./types.ts\";\nexport { ROOT_CONVERSATION_ID } from \"./types.ts\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAgC,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAIN,cAAc,GACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAkB,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAsCvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA8ExC,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { defineDoc, defineDocFamily } from \"./documents.ts\";\nexport { AssistantEntry, defineEntry, SystemEntry, ToolResultEntry, UserEntry } from \"./entries.ts\";\nexport { ConversationBusy, ReadAfterWrite, StorageRejected } from \"./errors.ts\";\nexport { ConversationConfig, type ConversationConfigState } from \"./harness/config.ts\";\nexport {\n\ttype GenerationCheckpoint,\n\ttype GenerationInput,\n\ttype GenerationResult,\n\tGenerationTask,\n} from \"./harness/generation.ts\";\nexport { Harness } from \"./harness/harness.ts\";\nexport { LiveDoc, type LiveState } from \"./harness/live.ts\";\nexport { createRegistry } from \"./harness/registry.ts\";\nexport type {\n\tAnyTask,\n\tContextView,\n\tConversation,\n\tConversationCreateOptions,\n\tConversationHandle,\n\tConversationInit,\n\tConversationRetryPolicy,\n\tConversationSetup,\n\tConversationStreamOptions,\n\tHarnessInspection,\n\tHarnessOptions,\n\tHookRegistration,\n\tHookScope,\n\tHooksOf,\n\tInputSubmissionDraft,\n\tModelRef,\n\tPromptInput,\n\tPromptSection,\n\tPromptSectionWrapper,\n\tRegistration,\n\tRegistry,\n\tRegistryFailure,\n\tRegistryReader,\n\tRegistrySnapshot,\n\tSettledSubmissionRecord,\n\tSettledTask,\n\tSubmission,\n\tSubmissionDraft,\n\tTaskInspection,\n\tToolControl,\n\tToolExecutionApi,\n\tToolExecutionResult,\n\tToolRegistration,\n\tToolWrapper,\n\tUserInput,\n} from \"./harness/types.ts\";\nexport { createSession } from \"./session/session.ts\";\nexport { MemoryStorage } from \"./storage/memory.ts\";\nexport { defineTask } from \"./tasks.ts\";\nexport type {\n\tCheckpointInfo,\n\tCommitChange,\n\tCommitPublication,\n\tCommonDocDefinition,\n\tContextEdit,\n\tConversationDocFamilyToken,\n\tConversationDocToken,\n\tConversationId,\n\tConversationOwnership,\n\tConversationQuery,\n\tConversationRecord,\n\tCursor,\n\tDocDefinition,\n\tDocFamilyDefinition,\n\tDocFamilyToken,\n\tDocToken,\n\tDocumentAddress,\n\tDocumentCommitChange,\n\tDocumentContent,\n\tDocumentCopySource,\n\tDocumentCreate,\n\tDocumentId,\n\tDocumentObserver,\n\tDocumentPoint,\n\tDocumentQuery,\n\tDocumentReader,\n\tDocumentRecord,\n\tDocumentSemantics,\n\tDocumentState,\n\tDocumentWatch,\n\tEntry,\n\tEntryDraft,\n\tEntryId,\n\tEntryQuery,\n\tEntryRecord,\n\tId,\n\tJsonObject,\n\tLatestConversationSemantics,\n\tNextTaskState,\n\tPage,\n\tPhaseHandler,\n\tRewindableConversationDocFamilyToken,\n\tRewindableConversationDocToken,\n\tRewindableConversationSemantics,\n\tRunningTask,\n\tSeq,\n\tSession,\n\tSessionDocFamilyToken,\n\tSessionDocToken,\n\tStorage,\n\tStorageWrite,\n\tStoredDocument,\n\tSubmissionCreate,\n\tSubmissionId,\n\tSubmissionQuery,\n\tSubmissionRecord,\n\tSubmissionSettlement,\n\tTableCommitChange,\n\tTask,\n\tTaskDefinition,\n\tTaskDocFamilyToken,\n\tTaskDocToken,\n\tTaskId,\n\tTaskOptions,\n\tTaskOutcome,\n\tTaskOutcomeError,\n\tTaskQuery,\n\tTaskRecord,\n\tTaskRuntime,\n\tTaskState,\n\tTx,\n\tTypedEntry,\n\tTypedEntryDraft,\n\tWatchEnd,\n\tWatchHandle,\n} from \"./types.ts\";\nexport { ROOT_CONVERSATION_ID } from \"./types.ts\";\n"]}

package/dist/session/forks.d.ts

@@ -0,0 +1,10 @@
+import type { Context } from "@earendil-works/chord";
+import type { ConversationId, DocumentCopySource, DocumentCreate, EntryId, Storage } from "../types.ts";
+/** One definition-free document copy to create with a forked conversation. */
+export type ForkDocumentCopy = {
+    readonly record: DocumentCreate;
+    readonly source: DocumentCopySource;
+};
+/** Select every persisted conversation document copied by one fork. */
+export declare function prepareForkDocumentCopies(storage: Storage, parentConversationId: ConversationId, at: EntryId, childConversationId: ConversationId, context: Context): Promise<readonly ForkDocumentCopy[]>;
+//# sourceMappingURL=forks.d.ts.map

package/dist/session/forks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forks.d.ts","sourceRoot":"","sources":["../../src/session/forks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EACX,cAAc,EAEd,kBAAkB,EAClB,cAAc,EAId,OAAO,EACP,OAAO,EACP,MAAM,aAAa,CAAC;AAMrB,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACpC,CAAC;AAEF,uEAAuE;AACvE,wBAAsB,yBAAyB,CAC9C,OAAO,EAAE,OAAO,EAChB,oBAAoB,EAAE,cAAc,EACpC,EAAE,EAAE,OAAO,EACX,mBAAmB,EAAE,cAAc,EACnC,OAAO,EAAE,OAAO,GACd,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CA2BtC"}