@usecontextlayer/pi-durable-assistant-ui 1.0.0 → 2.0.0

package/dist/conversation.js

@@ -0,0 +1,149 @@
+import { BACKGROUND_CONTEXT, withAbortSignal } from "@earendil-works/chord/context";
+import { ConversationTranscript } from "@earendil-works/pi-durable";
+import { EMPTY_CONVERSATION_METADATA } from "./metadata.js";
+import { entryIdFromMessageId, projectConversation, toPiUserInput } from "./projection.js";
+/** Disposable observation and actions permanently bound to one native conversation. */
+export class PiDurableConversation {
+    client;
+    id;
+    transcript;
+    #listeners = new Set();
+    #controller;
+    #state = { view: undefined, metadata: EMPTY_CONVERSATION_METADATA, connection: "idle", isLoading: true, error: undefined };
+    constructor(client, id, pageSize) {
+        this.client = client;
+        this.id = id;
+        this.transcript = new ConversationTranscript((query, limit, context) => client.entries(id, query, limit, undefined, context.abortSignal), { pageSize });
+    }
+    getSnapshot = () => this.#state;
+    subscribe = (listener) => {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    };
+    #set(patch) {
+        this.#state = { ...this.#state, ...patch };
+        for (const listener of this.#listeners)
+            listener();
+    }
+    reportError = (error) => {
+        this.#set({ error: error instanceof Error ? error : new Error(String(error)), isLoading: false });
+    };
+    start = () => {
+        if (this.#controller)
+            return;
+        const controller = new AbortController();
+        this.#controller = controller;
+        this.#set({ isLoading: !this.#state.view, error: undefined });
+        const observe = async (acquire, accept) => {
+            const watch = await acquire();
+            await accept(watch.value);
+            watch.start(async (change) => {
+                if (change.kind === "value")
+                    await accept(change.value);
+                else
+                    this.reportError(change.error);
+            });
+            const end = await watch.closed;
+            if (!controller.signal.aborted)
+                this.#ended(end);
+        };
+        void observe(() => this.client.watch(this.id, {
+            signal: controller.signal,
+            window: () => this.transcript.resume,
+            onConnection: (connection) => { if (!controller.signal.aborted)
+                this.#set({ connection }); },
+        }), async (view) => {
+            if (controller.signal.aborted)
+                return;
+            this.#set({ view: this.transcript.merge(view), isLoading: false, error: undefined });
+            const context = withAbortSignal(controller.signal, BACKGROUND_CONTEXT);
+            let gap = this.#state.view?.items.find((item) => item.kind === "gap");
+            while (gap?.kind === "gap" && !controller.signal.aborted) {
+                this.#set({ view: await this.transcript.fillGap(gap, context) });
+                gap = this.#state.view?.items.find((item) => item.kind === "gap");
+            }
+        }).catch((error) => { if (!controller.signal.aborted)
+            this.reportError(error); });
+        if (this.client.watchMetadata) {
+            void observe(() => this.client.watchMetadata(this.id, controller.signal), (metadata) => {
+                if (!controller.signal.aborted)
+                    this.#set({ metadata });
+            }).catch((error) => { if (!controller.signal.aborted)
+                this.reportError(error); });
+        }
+    };
+    #ended(end) {
+        this.#set({ connection: "closed", isLoading: false });
+        if ("error" in end)
+            this.reportError(end.error);
+    }
+    stop = () => {
+        this.#controller?.abort();
+        this.#controller = undefined;
+    };
+    reload = () => { this.stop(); this.start(); };
+    submit = (draft) => this.client.submit(this.id, draft);
+    continue = () => this.submit({ type: "continue" });
+    steer = (content) => this.submit({ type: "input", content, whenBusy: "steer" });
+    followUp = (content) => this.submit({ type: "input", content, whenBusy: "followUp" });
+    cancel = () => {
+        if (!this.client.abort)
+            throw new Error("This Pi host does not expose cancellation");
+        return this.client.abort(this.id);
+    };
+    abortSubmission = (id) => {
+        if (!this.client.abortSubmission)
+            throw new Error("This Pi host does not expose submission withdrawal");
+        return this.client.abortSubmission(id);
+    };
+    configure = (change) => {
+        if (!this.client.configure)
+            throw new Error("This Pi host does not expose configuration");
+        return this.client.configure(this.id, change);
+    };
+    reset = (handoff) => {
+        if (!this.client.reset)
+            throw new Error("This Pi host does not expose reset");
+        return this.client.reset(this.id, handoff);
+    };
+    compact = (instructions) => {
+        if (!this.client.compact)
+            throw new Error("This Pi host does not expose compaction");
+        return this.client.compact(this.id, instructions);
+    };
+    forkAt = (at) => {
+        if (!this.client.fork)
+            throw new Error("This Pi host does not expose forks");
+        return this.client.fork(this.id, at);
+    };
+    edit = async (message) => {
+        if (!message.sourceId)
+            throw new Error("An edit must identify its original message");
+        const target = entryIdFromMessageId(message.sourceId);
+        const fork = await this.forkAt(target);
+        await this.client.submit(fork.id, { type: "write", entry: { kind: "assistant-ui.context-edit", edits: [{ target, action: "replace", messages: [{ role: "user", content: toPiUserInput(message), timestamp: Date.now() }] }] } });
+        await this.client.submit(fork.id, { type: "continue" });
+        return fork;
+    };
+    regenerate = async (parentId) => {
+        const messages = this.#state.view ? projectConversation(this.#state.view, this.#state.metadata) : [];
+        const index = parentId === null ? -1 : messages.findIndex((message) => message.id === parentId);
+        const answer = messages[index + 1];
+        if (!answer?.id || answer.role !== "assistant")
+            throw new Error("No committed assistant response follows this message");
+        const target = entryIdFromMessageId(answer.id);
+        const fork = await this.forkAt(target);
+        await this.client.submit(fork.id, { type: "write", entry: { kind: "assistant-ui.context-edit", edits: [{ target, action: "omit" }] } });
+        await this.client.submit(fork.id, { type: "continue" });
+        return fork;
+    };
+    loadEarlier = async () => {
+        const context = this.#controller ? withAbortSignal(this.#controller.signal, BACKGROUND_CONTEXT) : BACKGROUND_CONTEXT;
+        this.#set({ view: await this.transcript.loadEarlier(context) });
+    };
+    setFeedback = async (messageId, rating) => {
+        if (!this.client.setFeedback)
+            throw new Error("This Pi host does not expose feedback");
+        this.#set({ metadata: await this.client.setFeedback(this.id, entryIdFromMessageId(messageId), rating) });
+    };
+}

package/dist/index.d.ts

@@ -1,11 +1,12 @@
-export { createHttpPiClient } from "./client.js";
-export type { PiClient, HttpPiWatchFrame, PiWatchOptions, PiConnectionState, PiUploadResult, HttpPiClientOptions, SerializedAgentChange, SerializedConversationCreateOptions } from "./client.js";
-export { createPiAttachmentAdapter } from "./attachments.js";
+export { createHttpPiDurableClient } from "./client.js";
+export type { PiDurableClient, HttpPiDurableWatchFrame, HttpPiDurableWatchEnvelope, HttpPiDurableWatchSubscription, PiDurableWatchOptions, PiDurableConnectionState, PiDurableUploadResult, PiDurableHumanInputDetails, HttpPiDurableClientOptions, SerializedAgentChange, SerializedConversationCreateOptions } from "./client.js";
+export { createPiDurableAttachmentAdapter } from "./attachments.js";
 export type { ConversationMetadata, ConversationMetadataPatch } from "./metadata.js";
 export { conversationInbox, conversationLiveState, entryIdFromMessageId, isForegroundRunning, projectConversation, toPiUserInput } from "./projection.js";
-export { PiRuntimeStore } from "./store.js";
-export type { PiRuntimeState, PiRuntimeStoreOptions } from "./store.js";
-export { usePiRuntime } from "./use-pi-runtime.js";
-export type { UsePiRuntimeOptions } from "./use-pi-runtime.js";
+export { PiDurableConversation } from "./conversation.js";
+export type { PiDurableConversationState } from "./conversation.js";
+export { createPiDurableThreadListAdapter } from "./thread-list.js";
+export { usePiDurableRuntime, usePiDurable } from "./use-pi-durable-runtime.js";
+export type { UsePiDurableRuntimeOptions, PiDurableRuntimeExtras } from "./use-pi-durable-runtime.js";
 export type { ConversationId, ConversationRecord, ConversationView, TranscriptView, SubmissionDraft, SubmissionId, SubmissionRecord, EntryId, AgentChange, AgentState, InboxState, HarnessInspection } from "@earendil-works/pi-durable";
 //# 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,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,mCAAmC,EAAE,MAAM,aAAa,CAAC;AAClM,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC1J,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,8BAA8B,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,mCAAmC,EAAE,MAAM,aAAa,CAAC;AACpU,OAAO,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AACpE,YAAY,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC1J,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,YAAY,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChF,YAAY,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACtG,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
-export { createHttpPiClient } from "./client.js";
-export { createPiAttachmentAdapter } from "./attachments.js";
+export { createHttpPiDurableClient } from "./client.js";
+export { createPiDurableAttachmentAdapter } from "./attachments.js";
 export { conversationInbox, conversationLiveState, entryIdFromMessageId, isForegroundRunning, projectConversation, toPiUserInput } from "./projection.js";
-export { PiRuntimeStore } from "./store.js";
-export { usePiRuntime } from "./use-pi-runtime.js";
+export { PiDurableConversation } from "./conversation.js";
+export { createPiDurableThreadListAdapter } from "./thread-list.js";
+export { usePiDurableRuntime, usePiDurable } from "./use-pi-durable-runtime.js";

package/dist/metadata.d.ts

@@ -2,10 +2,9 @@ import type { EntryId } from "@earendil-works/pi-durable";
 /** Presentation data persisted by the host in a native conversation document. */
 export type ConversationMetadata = {
     title: string | null;
-    archived: boolean;
     feedback: Record<EntryId, "positive" | "negative">;
     suggestions: string[];
 };
-export type ConversationMetadataPatch = Partial<Pick<ConversationMetadata, "title" | "archived" | "suggestions">>;
+export type ConversationMetadataPatch = Partial<Pick<ConversationMetadata, "title" | "suggestions">>;
 export declare const EMPTY_CONVERSATION_METADATA: ConversationMetadata;
 //# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE1D,iFAAiF;AACjF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,CAAC,CAAC;IACnD,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC,CAAC,CAAC;AAElH,eAAO,MAAM,2BAA2B,EAAE,oBAKzC,CAAC"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE1D,iFAAiF;AACjF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,CAAC,CAAC;IACnD,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC;AAErG,eAAO,MAAM,2BAA2B,EAAE,oBAIzC,CAAC"}

package/dist/metadata.js

@@ -1,6 +1,5 @@
 export const EMPTY_CONVERSATION_METADATA = {
     title: null,
-    archived: false,
     feedback: {},
     suggestions: [],
 };

package/dist/projection.d.ts

@@ -1,13 +1,27 @@
 import type { AppendMessage, ThreadMessageLike } from "@assistant-ui/react";
 import type { EntryId, InboxState, LiveState, TranscriptView, UserInput } from "@earendil-works/pi-durable";
 import type { ConversationMetadata } from "./metadata.js";
+type ContentPart = Exclude<ThreadMessageLike["content"], string>[number];
+type ToolPart = Extract<ContentPart, {
+    type: "tool-call";
+}>;
+type MutableMessage = Omit<ThreadMessageLike, "content" | "status"> & {
+    content: ContentPart[];
+    status?: ThreadMessageLike["status"];
+};
 export declare function conversationLiveState(view: Pick<TranscriptView, "docs">): LiveState;
 export declare function conversationInbox(view: Pick<TranscriptView, "docs">): InboxState;
 export declare function entryIdFromMessageId(id: string): EntryId;
 /** Foreground generation is distinct from a run's after-run/background work. */
 export declare function isForegroundRunning(view: Pick<TranscriptView, "docs">): boolean;
-/** Pure projection: native entries keep their IDs; tool results join their calls by call ID. */
-export declare function projectConversation(view: TranscriptView, presentation?: ConversationMetadata): readonly ThreadMessageLike[];
+export declare function projectConversationHistory(items: TranscriptView["items"], conversationMetadata?: ConversationMetadata): {
+    messages: MutableMessage[];
+    calls: Map<string, ToolPart>;
+};
+export declare function projectConversationLive(history: ReturnType<typeof projectConversationHistory>, live: LiveState, conversationId: TranscriptView["conversation"]["id"]): readonly ThreadMessageLike[];
+/** Pure projection of Pi history and current execution; Pi retains the durable originals. */
+export declare function projectConversation(view: TranscriptView, metadata?: ConversationMetadata): readonly ThreadMessageLike[];
 /** Convert only the user's new input; never send the rendered transcript back to Pi. */
 export declare function toPiUserInput(message: AppendMessage): UserInput;
+export {};
 //# sourceMappingURL=projection.d.ts.map

package/dist/projection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE5E,OAAO,KAAK,EAAe,OAAO,EAAe,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACtI,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAM1D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,SAAS,CAEnF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,UAAU,CAEhF;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAIxD;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,OAAO,CAG/E;AAqCD,gGAAgG;AAChG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,oBAAoB,GAAG,SAAS,iBAAiB,EAAE,CAwE3H;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CAY/D"}
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG5E,OAAO,KAAK,EAAe,OAAO,EAAe,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACtI,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,KAAK,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AACzE,KAAK,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC;AAC5D,KAAK,cAAc,GAAG,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,QAAQ,CAAC,GAAG;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAA;CAAE,CAAC;AAEvI,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,SAAS,CAEnF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,UAAU,CAEhF;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAIxD;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,OAAO,CAG/E;AAuCD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC,EAAE,oBAAoB;;;EA+CrH;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,GAAG,SAAS,iBAAiB,EAAE,CAmCnM;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,SAAS,iBAAiB,EAAE,CAEvH;AASD,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CAY/D"}

package/dist/projection.js

@@ -1,3 +1,4 @@
+import { CompactionEntry, ResetEntry, SystemEntry } from "@earendil-works/pi-durable";
 export function conversationLiveState(view) {
     return (view.docs["pi.live"] ?? {});
 }
@@ -35,9 +36,11 @@ function assistantContent(message, calls) {
 }
 function applyToolResult(tool, message) {
     Object.assign(tool, {
-        result: message.details ?? message.content.filter((part) => part.type === "text").map((part) => part.text).join("\n"),
+        artifact: message.details,
+        result: message.content.filter((part) => part.type === "text").map((part) => part.text).join("\n"),
         isError: message.isError,
         isPreliminary: false,
+        approval: humanInputApproval(message.details),
         modelContent: message.content.map((part) => part.type === "text"
             ? { type: "text", text: part.text }
             : { type: "file", mediaType: part.mimeType, data: part.data }),
@@ -52,12 +55,11 @@ function messageStatus(message) {
         return { type: "incomplete", reason: "length" };
     return { type: "complete", reason: "stop" };
 }
-/** Pure projection: native entries keep their IDs; tool results join their calls by call ID. */
-export function projectConversation(view, presentation) {
+export function projectConversationHistory(items, conversationMetadata) {
     const messages = [];
     const calls = new Map();
     const edits = new Map();
-    for (const item of view.items) {
+    for (const item of items) {
         if (item.kind === "entry") {
             for (const change of item.entry.edits ?? [])
                 edits.set(change.target, { change, by: item.entry.id });
@@ -70,7 +72,7 @@ export function projectConversation(view, presentation) {
             messages.push({ id, role: "user", content: userContent(message.content), createdAt: new Date(message.timestamp), metadata });
         }
         else if (message.role === "assistant") {
-            const feedback = presentation?.feedback[entry.id];
+            const feedback = conversationMetadata?.feedback[entry.id];
             messages.push({ id, role: "assistant", content: assistantContent(message, calls), status: messageStatus(message), createdAt: new Date(message.timestamp), metadata: { ...metadata, ...(feedback ? { submittedFeedback: { type: feedback } } : {}) } });
         }
         else if (message.role === "toolResult") {
@@ -83,17 +85,17 @@ export function projectConversation(view, presentation) {
             applyToolResult(tool, message);
         }
     }
-    for (const item of view.items) {
+    for (const item of items) {
         if (item.kind !== "entry")
             continue;
         const entry = item.entry;
-        if (entry.kind === "pi.system")
+        if (SystemEntry.is(entry))
             continue;
-        if (entry.kind === "pi.compaction" || entry.kind === "pi.reset") {
+        if (CompactionEntry.is(entry) || ResetEntry.is(entry)) {
             messages.push({
                 id: `entry:${entry.id}:notice`,
                 role: "assistant",
-                content: [{ type: "text", text: entry.kind === "pi.reset" ? "Conversation context reset" : "Conversation context compacted" }],
+                content: [{ type: "data", name: "pi-context", data: { kind: entry.kind, data: entry.data } }],
                 metadata: { custom: { conversationId: entry.conversationId, entryId: entry.id, entryKind: entry.kind, entryData: entry.data } },
             });
         }
@@ -102,16 +104,20 @@ export function projectConversation(view, presentation) {
         for (const [index, message] of model.entries())
             append(entry, message, index);
     }
-    const live = conversationLiveState(view);
+    return { messages, calls };
+}
+export function projectConversationLive(history, live, conversationId) {
+    const messages = [...history.messages];
+    const calls = new Map(history.calls);
     if (live.generation?.message) {
         const message = live.generation.message;
         messages.push({
-            id: `generation:${live.run?.taskId ?? view.conversation.id}`,
+            id: `generation:${live.run?.taskId ?? conversationId}`,
             role: "assistant",
             content: assistantContent(message, calls),
             status: { type: "running" },
             createdAt: new Date(message.timestamp),
-            metadata: { custom: { conversationId: view.conversation.id, taskId: live.run?.taskId } },
+            metadata: { isOptimistic: true, custom: { conversationId, taskId: live.run?.taskId } },
         });
     }
     for (const slot of live.tools ?? []) {
@@ -119,17 +125,35 @@ export function projectConversation(view, presentation) {
         if (!tool) {
             tool = { type: "tool-call", toolCallId: slot.callId, toolName: slot.name, args: {} };
             calls.set(slot.callId, tool);
-            messages.push({ id: `tool:${slot.callId}`, role: "assistant", content: [tool], status: { type: "running" } });
+            messages.push({ id: `tool:${slot.callId}`, role: "assistant", content: [tool], status: { type: "running" }, metadata: { isOptimistic: true } });
         }
         if (slot.status !== "done") {
-            Object.assign(tool, { result: slot.details ?? slot.output, isPreliminary: true });
-            const owner = messages.find((message) => message.content.includes(tool));
-            if (owner)
-                owner.status = { type: "running" };
+            const ownerIndex = messages.findIndex((message) => message.content.includes(tool));
+            const owner = messages[ownerIndex];
+            const updated = { ...tool, result: slot.output, artifact: slot.details, isPreliminary: true, approval: humanInputApproval(slot.details) };
+            calls.set(slot.callId, updated);
+            messages[ownerIndex] = { ...owner, content: owner.content.map((part) => part === tool ? updated : part), status: { type: "running" } };
         }
     }
+    const failure = live.runFailure;
+    const lastStatus = messages.at(-1)?.status;
+    if (failure && failure.reason !== "aborted" && failure.reason !== "reset" && failure.reason !== "nothing_to_answer" && !(lastStatus?.type === "incomplete" && lastStatus.reason === "error")) {
+        messages.push({ id: `failure:${failure.taskId}`, role: "assistant", content: [], status: { type: "incomplete", reason: "error", error: failure.detail ?? failure.reason }, metadata: { isOptimistic: true, custom: { conversationId, taskId: failure.taskId } } });
+    }
     return messages;
 }
+/** Pure projection of Pi history and current execution; Pi retains the durable originals. */
+export function projectConversation(view, metadata) {
+    return projectConversationLive(projectConversationHistory(view.items, metadata), conversationLiveState(view), view.conversation.id);
+}
+function humanInputApproval(value) {
+    if (value === null || typeof value !== "object")
+        return undefined;
+    const details = value;
+    if (details.type !== "human-input" || typeof details.taskId !== "number" || typeof details.prompt !== "string" || (details.status !== "pending" && details.status !== "answered"))
+        return undefined;
+    return { id: String(details.taskId), prompt: details.prompt, display: "text", ...(details.status === "answered" ? { approved: true, text: details.response } : {}) };
+}
 /** Convert only the user's new input; never send the rendered transcript back to Pi. */
 export function toPiUserInput(message) {
     const content = [];

package/dist/thread-list.d.ts

@@ -0,0 +1,6 @@
+import type { RemoteThreadListAdapter } from "@assistant-ui/react";
+import type { ConversationId } from "@earendil-works/pi-durable";
+import type { PiDurableClient } from "./client.js";
+export declare function nativeConversationId(value: string): ConversationId;
+export declare function createPiDurableThreadListAdapter(client: PiDurableClient, pageSize?: number): RemoteThreadListAdapter;
+//# sourceMappingURL=thread-list.d.ts.map

package/dist/thread-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-list.d.ts","sourceRoot":"","sources":["../src/thread-list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAU,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAKnD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAIlE;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,SAAK,GAAG,uBAAuB,CA8BhH"}

package/dist/thread-list.js

@@ -0,0 +1,39 @@
+export function nativeConversationId(value) {
+    const id = Number(value);
+    if (!Number.isSafeInteger(id) || id <= 0)
+        throw new Error(`Invalid Pi conversation ID: ${value}`);
+    return id;
+}
+export function createPiDurableThreadListAdapter(client, pageSize = 50) {
+    const metadata = (id, details) => ({
+        remoteId: String(id), status: "regular", title: details?.title ?? `Conversation ${id}`,
+    });
+    return {
+        async list({ after } = {}) {
+            const page = await client.listConversations({}, pageSize, after ? JSON.parse(after) : undefined);
+            const details = client.listMetadata ? await client.listMetadata(page.items.map((item) => item.id)) : undefined;
+            const threads = await Promise.all(page.items.map(async ({ id }) => metadata(id, details?.[String(id)] ?? await client.getMetadata?.(id))));
+            return { threads, ...(page.next ? { nextCursor: JSON.stringify(page.next) } : {}) };
+        },
+        async initialize() {
+            return { remoteId: String((await client.createConversation()).id) };
+        },
+        async fetch(remoteId) {
+            const id = nativeConversationId(remoteId);
+            if (client.getMetadata)
+                return metadata(id, await client.getMetadata(id));
+            await client.getConversationView(id);
+            return metadata(id);
+        },
+        async rename(remoteId, title) {
+            if (!client.updateMetadata)
+                throw new Error("This Pi host does not expose conversation titles");
+            await client.updateMetadata(nativeConversationId(remoteId), { title });
+        },
+        async archive() { throw new Error("Pi Durable does not support archiving conversations."); },
+        async delete() { throw new Error("Pi Durable does not support deleting conversations."); },
+        async generateTitle() {
+            return new ReadableStream({ start(controller) { controller.close(); } });
+        },
+    };
+}

package/dist/use-pi-durable-runtime.d.ts

@@ -0,0 +1,22 @@
+import { type AssistantRuntime, type AttachmentAdapter, type DictationAdapter, type FeedbackAdapter, type SpeechSynthesisAdapter } from "@assistant-ui/react";
+import type { ConversationId } from "@earendil-works/pi-durable";
+import type { PiDurableClient } from "./client.js";
+import { PiDurableConversation, type PiDurableConversationState } from "./conversation.js";
+export interface UsePiDurableRuntimeOptions {
+    client: PiDurableClient;
+    threadId?: ConversationId;
+    onThreadIdChange?: (id: ConversationId | undefined) => void;
+    pageSize?: number;
+    attachments?: AttachmentAdapter;
+    speech?: SpeechSynthesisAdapter;
+    dictation?: DictationAdapter;
+    feedback?: FeedbackAdapter;
+}
+export interface PiDurableRuntimeExtras {
+    readonly conversation: PiDurableConversation | undefined;
+    readonly state: PiDurableConversationState;
+}
+/** Read Pi-specific state/actions from the current Assistant UI thread scope. */
+export declare function usePiDurable(): PiDurableRuntimeExtras;
+export declare function usePiDurableRuntime(options: UsePiDurableRuntimeOptions): AssistantRuntime;
+//# sourceMappingURL=use-pi-durable-runtime.d.ts.map

package/dist/use-pi-durable-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-pi-durable-runtime.d.ts","sourceRoot":"","sources":["../src/use-pi-durable-runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAgG,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAmC,KAAK,eAAe,EAAuB,KAAK,sBAAsB,EAA0B,MAAM,qBAAqB,CAAC;AAC1U,OAAO,KAAK,EAAE,cAAc,EAAU,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,KAAK,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAK3F,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,cAAc,GAAG,SAAS,KAAK,IAAI,CAAC;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,YAAY,EAAE,qBAAqB,GAAG,SAAS,CAAC;IACzD,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;CAC5C;AASD,iFAAiF;AACjF,wBAAgB,YAAY,IAAI,sBAAsB,CAErD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,gBAAgB,CASzF"}

package/dist/use-pi-durable-runtime.js

@@ -0,0 +1,95 @@
+import { useEffect, useMemo, useState, useSyncExternalStore } from "react";
+import { useAui, useAuiState, useExternalStoreRuntime, useRemoteThreadListRuntime } from "@assistant-ui/react";
+import { PiDurableConversation } from "./conversation.js";
+import { EMPTY_CONVERSATION_METADATA } from "./metadata.js";
+import { conversationInbox, conversationLiveState, isForegroundRunning, projectConversationHistory, projectConversationLive, toPiUserInput } from "./projection.js";
+import { createPiDurableThreadListAdapter, nativeConversationId } from "./thread-list.js";
+const DRAFT_STATE = { view: undefined, metadata: EMPTY_CONVERSATION_METADATA, connection: "idle", isLoading: false, error: undefined };
+const EMPTY_SUBSCRIPTION = () => () => { };
+const DRAFT_SNAPSHOT = () => DRAFT_STATE;
+const DRAFT_EXTRAS = { conversation: undefined, state: DRAFT_STATE };
+const identity = (message) => message;
+const EMPTY_HISTORY = projectConversationHistory([]);
+/** Read Pi-specific state/actions from the current Assistant UI thread scope. */
+export function usePiDurable() {
+    return useAuiState((state) => state.thread.extras ?? DRAFT_EXTRAS);
+}
+export function usePiDurableRuntime(options) {
+    const { client, pageSize, threadId, onThreadIdChange } = options;
+    const adapter = useMemo(() => createPiDurableThreadListAdapter(client, pageSize), [client, pageSize]);
+    return useRemoteThreadListRuntime({
+        adapter,
+        threadId: threadId === undefined ? undefined : String(threadId),
+        onThreadIdChange: (id) => onThreadIdChange?.(id === undefined ? undefined : nativeConversationId(id)),
+        runtimeHook: () => usePiDurableThreadRuntime(options),
+    });
+}
+function usePiDurableThreadRuntime({ client, pageSize, attachments, speech, dictation, feedback }) {
+    const aui = useAui();
+    const remoteId = useAuiState((state) => state.threadListItem.remoteId);
+    const conversation = useMemo(() => remoteId === undefined ? undefined : new PiDurableConversation(client, nativeConversationId(remoteId), pageSize), [client, remoteId, pageSize]);
+    const state = useSyncExternalStore(conversation?.subscribe ?? EMPTY_SUBSCRIPTION, conversation?.getSnapshot ?? DRAFT_SNAPSHOT, conversation?.getSnapshot ?? DRAFT_SNAPSHOT);
+    const [sendError, setSendError] = useState();
+    useEffect(() => { conversation?.start(); return () => conversation?.stop(); }, [conversation]);
+    const history = useMemo(() => state.view ? projectConversationHistory(state.view.items, state.metadata) : EMPTY_HISTORY, [state.view?.items, state.metadata.feedback]);
+    const live = state.view ? conversationLiveState(state.view) : undefined;
+    const messages = useMemo(() => state.view && live ? projectConversationLive(history, live, state.view.conversation.id) : [], [history, live, state.view?.conversation.id]);
+    const isRunning = state.view ? isForegroundRunning(state.view) : false;
+    useEffect(() => {
+        if (!remoteId || state.metadata.title === null)
+            return;
+        if (aui.threadListItem().getState().title !== state.metadata.title) {
+            void aui.threads().reload().catch((error) => setSendError(error instanceof Error ? error : new Error(String(error))));
+        }
+    }, [aui, remoteId, state.metadata.title]);
+    const send = async (message, whenBusy) => {
+        setSendError(undefined);
+        const { remoteId: id } = await aui.threadListItem().initialize();
+        await client.submit(nativeConversationId(id), { type: "input", content: toPiUserInput(message), whenBusy });
+    };
+    const reportSendError = (error) => setSendError(error instanceof Error ? error : new Error(String(error)));
+    const queue = useMemo(() => {
+        if (!client.abortSubmission)
+            return undefined;
+        const items = state.view ? conversationInbox(state.view).items : [];
+        const convert = (mode) => items.flatMap((item) => {
+            if (item.mode !== mode || !("content" in item))
+                return [];
+            const content = typeof item.content === "string" ? [{ type: "text", text: item.content }] : item.content;
+            const parts = content.map((part) => part.type === "text" ? part : { type: "file", mimeType: part.mimeType, data: part.data });
+            return [{ id: String(item.id), prompt: content.filter((part) => part.type === "text").map((part) => part.text).join("\n"), parts }];
+        });
+        return {
+            items: convert("followUp"), steerItems: convert("steer"),
+            enqueue: (message) => { void send(message, "followUp").catch(reportSendError); },
+            steer: (message) => { void send(message, "steer").catch(reportSendError); },
+            remove: (id) => { void client.abortSubmission(Number(id)).catch(reportSendError); },
+            move: () => { throw new Error("Pi Durable does not support moving queued submissions."); },
+            edit: () => { throw new Error("Pi Durable does not support editing queued submissions."); },
+        };
+    }, [client, remoteId, state.view?.docs["pi.inbox"]]);
+    const nativeFeedback = useMemo(() => conversation && client.setFeedback ? { submit: ({ message, type }) => conversation.setFeedback(message.id, type) } : undefined, [conversation, client]);
+    const extras = useMemo(() => ({ conversation, state: sendError ? { ...state, error: sendError } : state }), [conversation, state, sendError]);
+    return useExternalStoreRuntime({
+        messages,
+        convertMessage: identity,
+        isRunning,
+        isLoading: state.isLoading,
+        hasEarlier: state.view?.items[0]?.kind === "earlier",
+        onLoadEarlier: conversation?.loadEarlier,
+        onRefetchThread: conversation ? async () => { conversation.reload(); } : undefined,
+        onNew: send,
+        onCancel: conversation && client.abort ? conversation.cancel : undefined,
+        onEdit: conversation && client.fork ? async (message) => { const fork = await conversation.edit(message); await aui.threads().switchToThread(String(fork.id)); } : undefined,
+        onReload: conversation && client.fork ? async (parentId) => { const fork = await conversation.regenerate(parentId); await aui.threads().switchToThread(String(fork.id)); } : undefined,
+        onRespondToToolApproval: client.respondToHumanInput ? async ({ approvalId, text }) => {
+            if (text === undefined)
+                throw new Error("This human-input request requires a text response");
+            await client.respondToHumanInput(Number(approvalId), text);
+        } : undefined,
+        suggestions: state.metadata.suggestions.map((prompt) => ({ prompt })),
+        queue,
+        extras,
+        adapters: { attachments, speech, dictation, feedback: feedback ?? nativeFeedback },
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usecontextlayer/pi-durable-assistant-ui",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "license": "MIT",
   "description": "Assistant UI runtime adapter for Pi Durable conversations",
   "repository": {
@@ -26,21 +26,22 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "node --input-type=module -e \"import { rmSync } from 'node:fs'; rmSync('dist', { recursive: true, force: true });\" && tsc -p tsconfig.json",
     "check": "tsc -p tsconfig.json --noEmit",
     "dev": "tsc -p tsconfig.json --watch --preserveWatchOutput"
   },
   "peerDependencies": {
-    "@assistant-ui/react": "0.15.32",
-    "react": "^19.0.0"
+    "@assistant-ui/react": "^0.15.32",
+    "react": "^19.0.0",
+    "@earendil-works/pi-durable": "^1.5.0"
   },
   "dependencies": {
-    "@earendil-works/pi-durable": "1.5.0",
     "@earendil-works/chord": "1.5.0",
     "@earendil-works/pi-ai": "1.5.0"
   },
   "devDependencies": {
     "@assistant-ui/react": "0.15.32",
-    "react": "19.3.1"
+    "react": "19.3.1",
+    "@earendil-works/pi-durable": "1.5.0"
   }
 }