@usecontextlayer/pi-durable-assistant-ui 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 the pi-durable-assistant-ui authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,83 @@
-# Temporary Holding Version
+<div align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# Pi Durable for Assistant UI
+
+Render [Pi Durable](https://github.com/earendil-works/pi/tree/v1.5.0/packages/durable) conversations with [Assistant UI](https://www.assistant-ui.com) while Pi owns history and execution.
+
+</div>
+
+```tsx
+import type { ReactNode } from "react";
+import { AssistantRuntimeProvider } from "@assistant-ui/react";
+import { createHttpPiClient, usePiRuntime } from "@usecontextlayer/pi-durable-assistant-ui";
+const client = createHttpPiClient({ baseUrl: "/api" });
+```
+
+```tsx
+export function PiChat({ children }: { children: ReactNode }) {
+  const { runtime } = usePiRuntime({ client });
+  return <AssistantRuntimeProvider runtime={runtime}>{children}</AssistantRuntimeProvider>;
+}
+```
+
+- **Use Assistant UI components.** The hook supplies an `ExternalStoreRuntime` for your thread, composer, and conversation list.
+- **Keep Pi as the source of truth.** One thread maps to one native conversation. The browser stores no second durable transcript and runs no model.
+- **Reconnect to ongoing work.** Streaming, earlier history, and reconnect gaps use native Pi views and `ConversationTranscript`. Closing a subscription does not cancel execution.
+- **Choose your host.** Implement `PiClient` or use the included HTTP/SSE client with the demo's protocol. The adapter has no dependency on the demo's Node/SQLite host.
+
+## Install
+
+```sh
+pnpm add @usecontextlayer/pi-durable-assistant-ui @assistant-ui/react@0.15.32 react@19 react-dom@19
+```
+
+The package builds as ESM with TypeScript declarations. It requires React 19 and `@assistant-ui/react` 0.15.32; Pi Durable, Pi AI, and Chord are pinned to 1.5.0. Keep the client instance stable, as in the example above, and render your Assistant UI components inside `PiChat`. This package supplies the runtime integration, not the demo's components or server.
+
+## Build from source
+
+From the workspace root, build and pack it:
+
+```sh
+pnpm exec turbo run build --filter=@usecontextlayer/pi-durable-assistant-ui
+pnpm --dir packages/adapter pack
+```
+
+Install the resulting tarball in your application and supply the React and Assistant UI peers.
+
+## Runtime and actions
+
+`usePiRuntime` returns `{ runtime, state, actions }`. `state` exposes the native conversation directory, selected ID, merged transcript view, rendered messages, running/connection/loading state, errors, and metadata. `actions` exposes conversation selection and creation, earlier-history loading, submissions, continuation, steering, withdrawal, configuration, cancellation, forks, reset, and compaction where the client supports them.
+
+Pass `initialConversationId` to reopen a native conversation, for example an ID saved in your URL. It applies when the store is constructed; later navigation uses `actions.selectConversation(id)`. `whenBusy` selects Pi's `followUp`, `steer`, or `reject` submission behavior.
+
+For use outside React, `PiRuntimeStore` exposes the same actions with `start`, `stop`, `subscribe`, and `getSnapshot`. `projectConversation` supplies the pure message projection.
+
+## Host contract
+
+`PiClient` is a structural interface whose optional methods describe host capabilities. Assistant UI callbacks are enabled only when the corresponding capability exists. The included `createHttpPiClient` returns `Required<PiClient>` and expects the demo's native-operation routes: an ordinary Pi host does not acquire those routes simply by installing this package.
+
+The HTTP watch carries an initial `ConversationView` and subsequent Chord operations over SSE. Pi's `ConversationTranscript` merges the bounded live view with earlier history and supplies reconnect windows. The host owns execution independently of each browser's watch.
+
+Conversation and entry IDs remain Pi's IDs; their string representations are UI keys. Live generation uses a native task-derived key until its immutable entry arrives. Projection matches tool results by native call ID, retains partial output, separates foreground generation from after-run activity, and leaves internal instruction entries out of chat. Raw history remains available through `state.view`.
+
+`SerializedAgentChange` carries JSON configuration with registered tool, extension, and model-tool names. The host resolves those names before native configuration; omitted fields are unchanged and `null` clears a field.
+
+## Edits and forks
+
+Editing forks at the original input, records a native context replacement, and continues the new conversation. Regeneration forks at the selected answer, omits it from the fork's model context through a native context edit, and continues. The original immutable history stays available.
+
+Each native fork is a separate thread. No hidden in-thread branch store or `setMessages` callback overwrites Pi history.
+
+## Attachments and extensions
+
+Pass `createPiAttachmentAdapter(client.uploadFile)` as the hook's `attachments` option when the host supports uploads. Uploads happen on send. `PiUploadResult` requires only `name` and `content`, an array of native Pi input blocks: images can remain image blocks; other files can be paths readable by native tools. The adapter returns Assistant UI's standard `CompleteAttachment`. The host owns storage; paths, download URLs, sizes and content types are not required by the adapter. Removing a draft attachment does not delete an uploaded workspace file.
+
+The hook accepts Assistant UI's `speech`, `dictation`, and `feedback` adapters. For browser voice controls, use `WebSpeechSynthesisAdapter` and support-gated `WebSpeechDictationAdapter` from Assistant UI. No speech provider is built into this package; browser support and permissions remain the consumer's responsibility.
+
+The optional `respondToHumanInput` client operation sends a response to a host's durable human-interaction extension. It answers the native task rather than fabricating a browser-side tool result.
+
+## Titles, archive, and feedback
+
+Optional metadata methods support titles, archive state, feedback keyed by native entry ID, and suggestions. The demo persists these in a native Pi conversation document. Such custom metadata is not included in `ConversationView.docs`, so the adapter reads it explicitly. Archiving preserves history; no permanent-delete operation is invented.
+
+The directory follows native pagination and loads metadata in bulk. Starting observation and completing observed work refresh the directory; connecting or reconnecting the selected conversation refreshes its metadata. Mutations publish the host's returned metadata. There is no cross-browser subscription for the directory or metadata: changes made elsewhere appear on the next applicable read or explicit refresh. Messages and execution remain live through the conversation watch. `state.metadata` uses stringified native conversation IDs as keys.

package/dist/attachments.d.ts

@@ -0,0 +1,5 @@
+import type { AttachmentAdapter } from "@assistant-ui/react";
+import type { PiUploadResult } from "./client.js";
+/** Uploads at send time; the host decides which native Pi input represents the file. */
+export declare function createPiAttachmentAdapter(upload: (file: File, signal?: AbortSignal) => Promise<PiUploadResult>): AttachmentAdapter;
+//# sourceMappingURL=attachments.d.ts.map

package/dist/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../src/attachments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAsB,MAAM,qBAAqB,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,wFAAwF;AACxF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,cAAc,CAAC,GAAG,iBAAiB,CAoBlI"}

package/dist/attachments.js

@@ -0,0 +1,22 @@
+/** Uploads at send time; the host decides which native Pi input represents the file. */
+export function createPiAttachmentAdapter(upload) {
+    return {
+        accept: "*",
+        async add({ file }) {
+            return { id: crypto.randomUUID(), type: file.type.startsWith("image/") ? "image" : "file", name: file.name, contentType: file.type, file, status: { type: "requires-action", reason: "composer-send" } };
+        },
+        async send(attachment, options) {
+            const uploadResult = await upload(attachment.file, options?.signal);
+            return {
+                ...attachment,
+                status: { type: "complete" },
+                content: uploadResult.content.map((part) => part.type === "text"
+                    ? { type: "text", text: part.text }
+                    : { type: "image", image: `data:${part.mimeType};base64,${part.data}`, filename: uploadResult.name }),
+            };
+        },
+        async remove() {
+            // Removing a draft attachment does not delete an ordinary file from the host's workspace.
+        },
+    };
+}

package/dist/client.d.ts

@@ -0,0 +1,59 @@
+import { type Op } from "@earendil-works/chord/delta";
+import type { ConversationCreateOptions, ConversationId, ConversationQuery, ConversationRecord, ConversationView, ConversationWindow, ConversationAbortOptions, ContextView, AgentState, CompactionResult, Cursor, EntryQuery, EntryRecord, EntryId, Page, SubmissionDraft, SubmissionId, SubmissionRecord, TaskId, UserInput, Harness, HarnessInspection } from "@earendil-works/pi-durable";
+import type { ConversationMetadata, ConversationMetadataPatch } from "./metadata.js";
+/** JSON form of Pi's stored configuration; the host resolves registry names. */
+export type SerializedAgentChange = {
+    [K in keyof AgentState]?: AgentState[K] | null;
+};
+export type SerializedConversationCreateOptions = Omit<ConversationCreateOptions, "agent" | "init"> & {
+    agent?: SerializedAgentChange;
+};
+export type HttpPiWatchFrame = {
+    type: "view";
+    view: ConversationView;
+} | {
+    type: "ops";
+    ops: readonly Op[];
+};
+export type PiConnectionState = "idle" | "connecting" | "connected" | "reconnecting";
+export interface PiWatchOptions {
+    window?: () => ConversationWindow | undefined;
+    onConnection?: (state: PiConnectionState) => void;
+    onError?: (error: Error) => void;
+}
+export interface PiUploadResult {
+    name: string;
+    content: Exclude<UserInput, string>;
+}
+/** The native operations a browser needs, with server execution context already bound. */
+export interface PiClient {
+    listConversations(query?: ConversationQuery, limit?: number, cursor?: Cursor): Promise<Page<ConversationRecord, Cursor>>;
+    createConversation(options?: SerializedConversationCreateOptions): Promise<ConversationRecord>;
+    getConversationView(id: ConversationId): Promise<ConversationView>;
+    entries(id: ConversationId, query: Omit<EntryQuery, "conversationId">, limit: number, cursor?: Cursor, signal?: AbortSignal): Promise<Page<EntryRecord, Cursor>>;
+    submit(id: ConversationId, submission: SubmissionDraft): Promise<SubmissionRecord>;
+    getSubmission(id: SubmissionId): Promise<SubmissionRecord>;
+    watch(id: ConversationId, onView: (view: ConversationView) => void, options?: PiWatchOptions): () => void;
+    configure?(id: ConversationId, change: SerializedAgentChange): Promise<void>;
+    abort?(id: ConversationId, options?: ConversationAbortOptions): Promise<void>;
+    abortSubmission?(id: SubmissionId): ReturnType<Harness["abortSubmission"]>;
+    reset?(id: ConversationId, handoff?: string): Promise<void>;
+    compact?(id: ConversationId, instructions?: string): Promise<TaskId<CompactionResult>>;
+    fork?(id: ConversationId, at: EntryId, options?: SerializedConversationCreateOptions): Promise<ConversationRecord>;
+    context?(id: ConversationId, at?: EntryId): Promise<ContextView>;
+    uploadFile?(file: File, signal?: AbortSignal): Promise<PiUploadResult>;
+    respondToHumanInput?(taskId: TaskId, response: string): Promise<void>;
+    inspect?(): Promise<HarnessInspection>;
+    listMetadata?(): Promise<Record<string, ConversationMetadata>>;
+    getMetadata?(id: ConversationId): Promise<ConversationMetadata>;
+    updateMetadata?(id: ConversationId, patch: ConversationMetadataPatch): Promise<ConversationMetadata>;
+    setFeedback?(id: ConversationId, entryId: EntryId, rating: "positive" | "negative" | null): Promise<ConversationMetadata>;
+}
+export interface HttpPiClientOptions {
+    baseUrl?: string;
+    fetch?: typeof globalThis.fetch;
+    eventSource?: (url: string) => EventSource;
+    reconnectDelayMs?: number;
+}
+export declare function createHttpPiClient(options?: HttpPiClientOptions): Required<PiClient>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,94 @@
+import { applyImmutable } from "@earendil-works/chord/delta";
+export function createHttpPiClient(options = {}) {
+    const baseUrl = (options.baseUrl ?? "/api").replace(/\/$/, "");
+    const fetcher = options.fetch ?? globalThis.fetch.bind(globalThis);
+    const openEvents = options.eventSource ?? ((url) => new EventSource(url));
+    function url(path, query = {}) {
+        const params = new URLSearchParams();
+        for (const [key, value] of Object.entries(query)) {
+            if (value !== undefined)
+                params.set(key, typeof value === "object" ? JSON.stringify(value) : String(value));
+        }
+        const search = params.toString();
+        return `${baseUrl}${path}${search ? `?${search}` : ""}`;
+    }
+    async function request(path, init, query) {
+        const response = await fetcher(url(path, query), init);
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(body || `Pi request failed: ${response.status} ${response.statusText}`);
+        }
+        return response.json();
+    }
+    function post(path, value) {
+        return request(path, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(value) });
+    }
+    return {
+        listConversations: (query = {}, limit = 100, cursor) => request("/conversations", undefined, { query, limit, cursor }),
+        createConversation: (creation = { ownership: { kind: "ownerless" } }) => post("/conversations", creation),
+        getConversationView: (id) => request(`/conversations/${id}`),
+        entries: (id, query, limit, cursor, signal) => request(`/conversations/${id}/entries`, { signal }, { ...query, limit, cursor }),
+        submit: (id, submission) => post(`/conversations/${id}/submit`, submission),
+        getSubmission: (id) => request(`/submissions/${id}`),
+        configure: async (id, change) => { await post(`/conversations/${id}/configure`, change); },
+        abort: async (id, abortOptions = {}) => { await post(`/conversations/${id}/abort`, abortOptions); },
+        abortSubmission: (id) => post(`/submissions/${id}/abort`, {}),
+        reset: async (id, handoff) => { await post(`/conversations/${id}/reset`, { handoff }); },
+        compact: async (id, instructions) => (await post(`/conversations/${id}/compact`, { instructions })).taskId,
+        fork: (id, at, forkOptions = { ownership: { kind: "ownerless" } }) => post(`/conversations/${id}/fork`, { at, ...forkOptions }),
+        context: (id, at) => request(`/conversations/${id}/context`, undefined, { at }),
+        uploadFile: (file, signal) => request("/files", { method: "POST", headers: { "content-type": file.type || "application/octet-stream" }, body: file, signal }, { name: file.name }),
+        respondToHumanInput: async (taskId, response) => { await post(`/interactions/${taskId}`, { response }); },
+        inspect: () => request("/inspect"),
+        listMetadata: () => request("/conversations/metadata"),
+        getMetadata: (id) => request(`/conversations/${id}/metadata`),
+        updateMetadata: (id, patch) => request(`/conversations/${id}/metadata`, { method: "PATCH", headers: { "content-type": "application/json" }, body: JSON.stringify(patch) }),
+        setFeedback: (id, entryId, rating) => post(`/conversations/${id}/feedback`, { entryId, rating }),
+        watch(id, onView, watchOptions = {}) {
+            let source;
+            let retry;
+            let stopped = false;
+            let connectedBefore = false;
+            function connect() {
+                if (stopped)
+                    return;
+                watchOptions.onConnection?.(connectedBefore ? "reconnecting" : "connecting");
+                const connection = openEvents(url(`/conversations/${id}/watch`, { window: watchOptions.window?.() }));
+                source = connection;
+                let view;
+                connection.onmessage = (event) => {
+                    try {
+                        const frame = JSON.parse(event.data);
+                        if (frame.type === "view")
+                            view = frame.view;
+                        else {
+                            if (!view)
+                                throw new Error("Pi watch sent changes before its initial view");
+                            view = applyImmutable(view, frame.ops);
+                        }
+                        connectedBefore = true;
+                        watchOptions.onConnection?.("connected");
+                        onView(view);
+                    }
+                    catch (cause) {
+                        watchOptions.onError?.(cause instanceof Error ? cause : new Error(String(cause)));
+                        connection.close();
+                    }
+                };
+                connection.onerror = () => {
+                    connection.close();
+                    if (stopped)
+                        return;
+                    watchOptions.onConnection?.("reconnecting");
+                    retry = setTimeout(connect, options.reconnectDelayMs ?? 500);
+                };
+            }
+            connect();
+            return () => {
+                stopped = true;
+                clearTimeout(retry);
+                source?.close();
+            };
+        },
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { createHttpPiClient } from "./client.js";
+export type { PiClient, HttpPiWatchFrame, PiWatchOptions, PiConnectionState, PiUploadResult, HttpPiClientOptions, SerializedAgentChange, SerializedConversationCreateOptions } from "./client.js";
+export { createPiAttachmentAdapter } 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 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

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { createHttpPiClient } from "./client.js";
+export { createPiAttachmentAdapter } 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";

package/dist/metadata.d.ts

@@ -0,0 +1,11 @@
+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 declare const EMPTY_CONVERSATION_METADATA: ConversationMetadata;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +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"}

package/dist/metadata.js

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

package/dist/projection.d.ts

@@ -0,0 +1,13 @@
+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";
+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[];
+/** Convert only the user's new input; never send the rendered transcript back to Pi. */
+export declare function toPiUserInput(message: AppendMessage): UserInput;
+//# sourceMappingURL=projection.d.ts.map

package/dist/projection.d.ts.map

@@ -0,0 +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"}

package/dist/projection.js

@@ -0,0 +1,150 @@
+export function conversationLiveState(view) {
+    return (view.docs["pi.live"] ?? {});
+}
+export function conversationInbox(view) {
+    return (view.docs["pi.inbox"] ?? { items: [] });
+}
+export function entryIdFromMessageId(id) {
+    const match = /^entry:(\d+):(?:\d+|notice)$/.exec(id);
+    if (!match || !Number.isSafeInteger(Number(match[1])))
+        throw new Error(`Message ${id} is not a committed Pi entry`);
+    return Number(match[1]);
+}
+/** Foreground generation is distinct from a run's after-run/background work. */
+export function isForegroundRunning(view) {
+    const live = conversationLiveState(view);
+    return live.run !== undefined && live.run.afterRun === undefined;
+}
+function userContent(content) {
+    if (typeof content === "string")
+        return [{ type: "text", text: content }];
+    return content.map((part) => part.type === "text"
+        ? { type: "text", text: part.text }
+        : { type: "image", image: `data:${part.mimeType};base64,${part.data}` });
+}
+function assistantContent(message, calls) {
+    return message.content.map((part) => {
+        if (part.type === "text")
+            return { type: "text", text: part.text };
+        if (part.type === "thinking")
+            return { type: "reasoning", text: part.thinking };
+        const tool = { type: "tool-call", toolCallId: part.id, toolName: part.name, args: part.arguments };
+        calls.set(part.id, tool);
+        return tool;
+    });
+}
+function applyToolResult(tool, message) {
+    Object.assign(tool, {
+        result: message.details ?? message.content.filter((part) => part.type === "text").map((part) => part.text).join("\n"),
+        isError: message.isError,
+        isPreliminary: false,
+        modelContent: message.content.map((part) => part.type === "text"
+            ? { type: "text", text: part.text }
+            : { type: "file", mediaType: part.mimeType, data: part.data }),
+    });
+}
+function messageStatus(message) {
+    if (message.stopReason === "error")
+        return { type: "incomplete", reason: "error", error: message.errorMessage ?? "Model request failed" };
+    if (message.stopReason === "aborted")
+        return { type: "incomplete", reason: "cancelled" };
+    if (message.stopReason === "length")
+        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) {
+    const messages = [];
+    const calls = new Map();
+    const edits = new Map();
+    for (const item of view.items) {
+        if (item.kind === "entry") {
+            for (const change of item.entry.edits ?? [])
+                edits.set(change.target, { change, by: item.entry.id });
+        }
+    }
+    function append(entry, message, index) {
+        const metadata = { custom: { conversationId: entry.conversationId, entryId: entry.id, entryKind: entry.kind, editEntryId: edits.get(entry.id)?.by } };
+        const id = `entry:${entry.id}:${index}`;
+        if (message.role === "user") {
+            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];
+            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") {
+            let tool = calls.get(message.toolCallId);
+            if (!tool) {
+                tool = { type: "tool-call", toolCallId: message.toolCallId, toolName: message.toolName, args: {} };
+                calls.set(message.toolCallId, tool);
+                messages.push({ id, role: "assistant", content: [tool], metadata });
+            }
+            applyToolResult(tool, message);
+        }
+    }
+    for (const item of view.items) {
+        if (item.kind !== "entry")
+            continue;
+        const entry = item.entry;
+        if (entry.kind === "pi.system")
+            continue;
+        if (entry.kind === "pi.compaction" || entry.kind === "pi.reset") {
+            messages.push({
+                id: `entry:${entry.id}:notice`,
+                role: "assistant",
+                content: [{ type: "text", text: entry.kind === "pi.reset" ? "Conversation context reset" : "Conversation context compacted" }],
+                metadata: { custom: { conversationId: entry.conversationId, entryId: entry.id, entryKind: entry.kind, entryData: entry.data } },
+            });
+        }
+        const edit = edits.get(entry.id)?.change;
+        const model = edit ? (edit.action === "replace" ? edit.messages : []) : (entry.model ?? []);
+        for (const [index, message] of model.entries())
+            append(entry, message, index);
+    }
+    const live = conversationLiveState(view);
+    if (live.generation?.message) {
+        const message = live.generation.message;
+        messages.push({
+            id: `generation:${live.run?.taskId ?? view.conversation.id}`,
+            role: "assistant",
+            content: assistantContent(message, calls),
+            status: { type: "running" },
+            createdAt: new Date(message.timestamp),
+            metadata: { custom: { conversationId: view.conversation.id, taskId: live.run?.taskId } },
+        });
+    }
+    for (const slot of live.tools ?? []) {
+        let tool = calls.get(slot.callId);
+        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" } });
+        }
+        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" };
+        }
+    }
+    return messages;
+}
+/** Convert only the user's new input; never send the rendered transcript back to Pi. */
+export function toPiUserInput(message) {
+    const content = [];
+    const parts = [...message.content, ...(message.attachments ?? []).flatMap((attachment) => attachment.content)];
+    for (const part of parts) {
+        if (part.type === "text")
+            content.push({ type: "text", text: part.text });
+        else if (part.type === "image") {
+            const match = /^data:([^;,]+);base64,(.*)$/s.exec(part.image);
+            if (!match)
+                throw new Error("Image input must be a base64 data URL");
+            content.push({ type: "image", mimeType: match[1], data: match[2] });
+        }
+        else
+            throw new Error(`Unsupported Pi input part: ${part.type}`);
+    }
+    return content;
+}

package/dist/store.d.ts

@@ -0,0 +1,57 @@
+import type { ConversationId, ConversationRecord, EntryId, SubmissionDraft, SubmissionRecord, TranscriptView } from "@earendil-works/pi-durable";
+import type { AppendMessage, ThreadMessageLike } from "@assistant-ui/react";
+import type { PiClient, PiConnectionState, SerializedConversationCreateOptions, SerializedAgentChange } from "./client.js";
+import type { ConversationMetadata, ConversationMetadataPatch } from "./metadata.js";
+export interface PiRuntimeState {
+    readonly conversations: readonly ConversationRecord[];
+    readonly selectedId: ConversationId | undefined;
+    readonly view: TranscriptView | undefined;
+    readonly messages: readonly ThreadMessageLike[];
+    readonly isLoading: boolean;
+    readonly isRunning: boolean;
+    readonly connection: PiConnectionState;
+    readonly error: Error | undefined;
+    readonly hasEarlier: boolean;
+    readonly metadata: Readonly<Record<string, ConversationMetadata>>;
+}
+export interface PiRuntimeStoreOptions {
+    initialConversationId?: ConversationId;
+    pageSize?: number;
+}
+/** A disposable client view of Pi, not a second durable conversation store. */
+export declare class PiRuntimeStore {
+    #private;
+    readonly client: PiClient;
+    constructor(client: PiClient, options?: PiRuntimeStoreOptions);
+    getSnapshot: () => PiRuntimeState;
+    subscribe: (listener: () => void) => (() => void);
+    start: () => void;
+    stop: () => void;
+    refreshConversations: () => Promise<void>;
+    selectConversation: (id: ConversationId) => void;
+    createConversation: (options?: SerializedConversationCreateOptions) => Promise<ConversationRecord>;
+    refreshMetadata: (id?: ConversationId | undefined) => Promise<void>;
+    updateMetadata: (id: ConversationId, patch: ConversationMetadataPatch) => Promise<void>;
+    renameConversation: (id: ConversationId, title: string) => Promise<void>;
+    archiveConversation: (id: ConversationId) => Promise<void>;
+    unarchiveConversation: (id: ConversationId) => Promise<void>;
+    setFeedback: (entryId: EntryId, rating: "positive" | "negative" | null) => Promise<void>;
+    submitFeedback: (messageId: string, rating: "positive" | "negative") => void;
+    submit: (submission: SubmissionDraft) => Promise<SubmissionRecord>;
+    continue: () => Promise<SubmissionRecord>;
+    steer: (content: Extract<SubmissionDraft, {
+        type: "input";
+    }>["content"]) => Promise<SubmissionRecord>;
+    abortSubmission: (id: SubmissionRecord["id"]) => Promise<"aborted" | "already_placed" | "not_found" | "settled">;
+    /** Retrying an edit creates a native fork and records an immutable context replacement there. */
+    edit: (message: AppendMessage) => Promise<void>;
+    /** Keep the answer in original history; the fork omits it from its next model context. */
+    regenerate: (parentId: string | null) => Promise<void>;
+    cancel: () => Promise<void>;
+    configure: (change: SerializedAgentChange) => Promise<void>;
+    reset: (handoff?: string) => Promise<void>;
+    compact: (instructions?: string) => Promise<import("@earendil-works/pi-durable").TaskId<import("@earendil-works/pi-durable").CompactionResult>>;
+    forkAt: (at: EntryId) => Promise<ConversationRecord>;
+    loadEarlier: () => Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

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

package/dist/store.js

@@ -0,0 +1,261 @@
+import { BACKGROUND_CONTEXT, withAbortSignal } from "@earendil-works/chord/context";
+import { ConversationTranscript } from "@earendil-works/pi-durable";
+import { conversationLiveState, entryIdFromMessageId, isForegroundRunning, projectConversation, toPiUserInput } from "./projection.js";
+function runtimeSnapshot(source) {
+    const { view } = source;
+    return {
+        ...source,
+        messages: view ? projectConversation(view, source.metadata[String(view.conversation.id)]) : [],
+        isRunning: view ? isForegroundRunning(view) : false,
+        hasEarlier: view?.items[0]?.kind === "earlier",
+    };
+}
+/** A disposable client view of Pi, not a second durable conversation store. */
+export class PiRuntimeStore {
+    client;
+    #options;
+    #listeners = new Set();
+    #transcripts = new Map();
+    #views = new Map();
+    #filling = new Map();
+    #disconnect;
+    #selection = new AbortController();
+    #started = false;
+    #state;
+    constructor(client, options = {}) {
+        this.client = client;
+        this.#options = options;
+        this.#state = runtimeSnapshot({ conversations: [], selectedId: options.initialConversationId, view: undefined, isLoading: false, connection: "idle", error: undefined, metadata: {} });
+    }
+    getSnapshot = () => this.#state;
+    subscribe = (listener) => {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    };
+    #set(patch) {
+        const next = { ...this.#state, ...patch };
+        this.#state = next.view === this.#state.view && next.metadata === this.#state.metadata ? next : runtimeSnapshot(next);
+        for (const listener of this.#listeners)
+            listener();
+    }
+    #report(cause) {
+        this.#set({ error: cause instanceof Error ? cause : new Error(String(cause)), isLoading: false });
+    }
+    #transcript(id) {
+        let transcript = this.#transcripts.get(id);
+        if (!transcript) {
+            transcript = new ConversationTranscript((query, limit, context) => this.client.entries(id, query, limit, undefined, context.abortSignal), { pageSize: this.#options.pageSize });
+            this.#transcripts.set(id, transcript);
+        }
+        return transcript;
+    }
+    #show(id, view) {
+        this.#views.set(id, view);
+        if (this.#state.selectedId !== id)
+            return;
+        this.#set({ view, isLoading: false, error: undefined });
+    }
+    start = () => {
+        if (this.#started)
+            return;
+        this.#started = true;
+        if (this.#state.selectedId !== undefined)
+            this.selectConversation(this.#state.selectedId);
+        void this.refreshConversations().catch((error) => this.#report(error));
+    };
+    stop = () => {
+        this.#started = false;
+        this.#disconnect?.();
+        this.#disconnect = undefined;
+        this.#selection.abort();
+    };
+    refreshConversations = async () => {
+        const load = async () => {
+            const conversations = [];
+            let cursor;
+            do {
+                const page = await this.client.listConversations({}, 100, cursor);
+                conversations.push(...page.items);
+                cursor = page.next;
+            } while (cursor);
+            return conversations;
+        };
+        const [conversations, loaded] = await Promise.all([load(), this.client.listMetadata?.()]);
+        this.#set({ conversations, ...(loaded ? { metadata: loaded } : {}) });
+        if (this.#started && this.#state.selectedId === undefined && conversations[0])
+            this.selectConversation(conversations[0].id);
+    };
+    selectConversation = (id) => {
+        this.#disconnect?.();
+        this.#selection.abort();
+        this.#selection = new AbortController();
+        const cached = this.#views.get(id);
+        this.#set({ selectedId: id, view: cached, isLoading: !cached, error: undefined, connection: "connecting" });
+        if (!this.#started)
+            return;
+        const transcript = this.#transcript(id);
+        this.#disconnect = this.client.watch(id, (view) => {
+            const previous = this.#views.get(id);
+            this.#show(id, transcript.merge(view));
+            if (previous && conversationLiveState(previous).run && !conversationLiveState(view).run)
+                void this.refreshConversations().catch((cause) => this.#report(cause));
+            const signal = this.#selection.signal;
+            void this.#fillGaps(id).catch((cause) => { if (!signal.aborted && this.#state.selectedId === id)
+                this.#report(cause); });
+        }, {
+            window: () => transcript.resume,
+            onConnection: (connection) => {
+                if (this.#state.selectedId !== id)
+                    return;
+                const becameConnected = connection === "connected" && this.#state.connection !== "connected";
+                this.#set({ connection });
+                if (becameConnected)
+                    void this.refreshMetadata(id).catch((cause) => this.#report(cause));
+            },
+            onError: (error) => { if (this.#state.selectedId === id)
+                this.#report(error); },
+        });
+    };
+    createConversation = async (options) => {
+        this.#set({ isLoading: true, error: undefined });
+        try {
+            const conversation = await this.client.createConversation(options);
+            this.#set({ conversations: [conversation, ...this.#state.conversations.filter((item) => item.id !== conversation.id)] });
+            this.selectConversation(conversation.id);
+            return conversation;
+        }
+        catch (cause) {
+            this.#report(cause);
+            throw cause;
+        }
+    };
+    #setMetadata(id, metadata) {
+        this.#set({ metadata: { ...this.#state.metadata, [String(id)]: metadata } });
+    }
+    refreshMetadata = async (id = this.#state.selectedId) => {
+        if (id === undefined || !this.client.getMetadata)
+            return;
+        this.#setMetadata(id, await this.client.getMetadata(id));
+    };
+    updateMetadata = async (id, patch) => {
+        if (!this.client.updateMetadata)
+            throw new Error("This Pi host does not expose conversation metadata");
+        this.#setMetadata(id, await this.client.updateMetadata(id, patch));
+    };
+    renameConversation = (id, title) => this.updateMetadata(id, { title });
+    archiveConversation = (id) => this.updateMetadata(id, { archived: true });
+    unarchiveConversation = (id) => this.updateMetadata(id, { archived: false });
+    setFeedback = async (entryId, rating) => {
+        const id = this.#state.selectedId;
+        if (id === undefined)
+            throw new Error("Select a conversation before leaving feedback");
+        if (!this.client.setFeedback)
+            throw new Error("This Pi host does not expose feedback");
+        this.#setMetadata(id, await this.client.setFeedback(id, entryId, rating));
+    };
+    submitFeedback = (messageId, rating) => {
+        void this.setFeedback(entryIdFromMessageId(messageId), rating).catch((cause) => this.#report(cause));
+    };
+    submit = async (submission) => {
+        const id = this.#state.selectedId ?? (await this.createConversation()).id;
+        return this.client.submit(id, submission);
+    };
+    continue = () => this.submit({ type: "continue" });
+    steer = (content) => this.submit({ type: "input", content, whenBusy: "steer" });
+    abortSubmission = async (id) => {
+        if (!this.client.abortSubmission)
+            throw new Error("This Pi host does not expose submission withdrawal");
+        return this.client.abortSubmission(id);
+    };
+    /** Retrying an edit creates a native fork and records an immutable context replacement there. */
+    edit = async (message) => {
+        if (!message.sourceId)
+            throw new Error("An edit must identify its original message");
+        const target = entryIdFromMessageId(message.sourceId);
+        const content = toPiUserInput(message);
+        await this.forkAt(target);
+        await this.submit({ type: "write", entry: { kind: "assistant-ui.context-edit", edits: [{ target, action: "replace", messages: [{ role: "user", content, timestamp: Date.now() }] }] } });
+        await this.continue();
+    };
+    /** Keep the answer in original history; the fork omits it from its next model context. */
+    regenerate = async (parentId) => {
+        const index = parentId === null ? -1 : this.#state.messages.findIndex((message) => message.id === parentId);
+        if (parentId !== null && index === -1)
+            throw new Error(`Parent message ${parentId} is not loaded`);
+        const answer = this.#state.messages[index + 1];
+        if (!answer?.id || answer.role !== "assistant")
+            throw new Error("No committed assistant response follows this message");
+        const target = entryIdFromMessageId(answer.id);
+        await this.forkAt(target);
+        await this.submit({ type: "write", entry: { kind: "assistant-ui.context-edit", edits: [{ target, action: "omit" }] } });
+        await this.continue();
+    };
+    cancel = async () => {
+        const id = this.#state.selectedId;
+        if (id === undefined)
+            return;
+        if (!this.client.abort)
+            throw new Error("This Pi host does not expose conversation cancellation");
+        await this.client.abort(id);
+    };
+    configure = async (change) => {
+        const id = this.#state.selectedId;
+        if (id === undefined)
+            throw new Error("Select a conversation before configuring it");
+        if (!this.client.configure)
+            throw new Error("This Pi host does not expose configuration");
+        await this.client.configure(id, change);
+    };
+    reset = async (handoff) => {
+        const id = this.#state.selectedId;
+        if (id === undefined)
+            return;
+        if (!this.client.reset)
+            throw new Error("This Pi host does not expose reset");
+        await this.client.reset(id, handoff);
+    };
+    compact = async (instructions) => {
+        const id = this.#state.selectedId;
+        if (id === undefined)
+            throw new Error("Select a conversation before compacting it");
+        if (!this.client.compact)
+            throw new Error("This Pi host does not expose compaction");
+        return this.client.compact(id, instructions);
+    };
+    forkAt = async (at) => {
+        const id = this.#state.selectedId;
+        if (id === undefined)
+            throw new Error("Select a conversation before forking it");
+        if (!this.client.fork)
+            throw new Error("This Pi host does not expose forks");
+        const conversation = await this.client.fork(id, at);
+        this.#set({ conversations: [conversation, ...this.#state.conversations] });
+        this.selectConversation(conversation.id);
+        return conversation;
+    };
+    loadEarlier = async () => {
+        const id = this.#state.selectedId;
+        if (id === undefined)
+            return;
+        const view = await this.#transcript(id).loadEarlier(withAbortSignal(this.#selection.signal, BACKGROUND_CONTEXT));
+        this.#show(id, view);
+    };
+    #fillGaps(id) {
+        const previous = this.#filling.get(id);
+        if (previous)
+            return previous;
+        const signal = this.#selection.signal;
+        const run = async () => {
+            while (!signal.aborted) {
+                const gap = this.#views.get(id)?.items.find((item) => item.kind === "gap");
+                if (!gap || gap.kind !== "gap")
+                    return;
+                const view = await this.#transcript(id).fillGap(gap, withAbortSignal(signal, BACKGROUND_CONTEXT));
+                this.#show(id, view);
+            }
+        };
+        const pending = run().finally(() => this.#filling.delete(id));
+        this.#filling.set(id, pending);
+        return pending;
+    }
+}

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

@@ -0,0 +1,17 @@
+import { type AttachmentAdapter, type DictationAdapter, type FeedbackAdapter, type SpeechSynthesisAdapter } from "@assistant-ui/react";
+import type { PiClient } from "./client.js";
+import { PiRuntimeStore, type PiRuntimeStoreOptions } from "./store.js";
+export interface UsePiRuntimeOptions extends PiRuntimeStoreOptions {
+    client: PiClient;
+    whenBusy?: "followUp" | "steer" | "reject";
+    attachments?: AttachmentAdapter;
+    speech?: SpeechSynthesisAdapter;
+    dictation?: DictationAdapter;
+    feedback?: FeedbackAdapter;
+}
+export declare function usePiRuntime({ client, initialConversationId, pageSize, whenBusy, attachments, speech, dictation, feedback }: UsePiRuntimeOptions): {
+    runtime: import("@assistant-ui/react").AssistantRuntime;
+    state: import("./store.js").PiRuntimeState;
+    actions: PiRuntimeStore;
+};
+//# sourceMappingURL=use-pi-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-pi-runtime.d.ts","sourceRoot":"","sources":["../src/use-pi-runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEhK,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAIxE,MAAM,WAAW,mBAAoB,SAAQ,qBAAqB;IAChE,MAAM,EAAE,QAAQ,CAAC;IACjB,QAAQ,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC3C,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,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,mBAAmB;;;;EA2ChJ"}

package/dist/use-pi-runtime.js

@@ -0,0 +1,49 @@
+import { useEffect, useMemo, useSyncExternalStore } from "react";
+import { useExternalStoreRuntime } from "@assistant-ui/react";
+import { PiRuntimeStore } from "./store.js";
+import { toPiUserInput } from "./projection.js";
+import { EMPTY_CONVERSATION_METADATA } from "./metadata.js";
+export function usePiRuntime({ client, initialConversationId, pageSize, whenBusy, attachments, speech, dictation, feedback }) {
+    const store = useMemo(() => new PiRuntimeStore(client, { initialConversationId, pageSize }), [client, pageSize]);
+    useEffect(() => { store.start(); return store.stop; }, [store]);
+    const state = useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+    const metadata = state.metadata[String(state.selectedId)] ?? EMPTY_CONVERSATION_METADATA;
+    const nativeFeedback = useMemo(() => client.setFeedback ? {
+        submit: ({ message, type }) => store.submitFeedback(message.id, type),
+    } : undefined, [client, store]);
+    const threads = state.conversations.map((conversation) => {
+        const details = state.metadata[String(conversation.id)] ?? EMPTY_CONVERSATION_METADATA;
+        const item = { id: String(conversation.id), title: details.title ?? `Conversation ${conversation.id}` };
+        return details.archived ? { ...item, status: "archived" } : { ...item, status: "regular" };
+    });
+    const runtime = useExternalStoreRuntime({
+        messages: state.messages,
+        convertMessage: (message) => message,
+        isRunning: state.isRunning,
+        isLoading: state.isLoading,
+        hasEarlier: state.hasEarlier,
+        onLoadEarlier: store.loadEarlier,
+        onNew: async (message) => { await store.submit({ type: "input", content: toPiUserInput(message), whenBusy }); },
+        onCancel: client.abort ? store.cancel : undefined,
+        onEdit: client.fork ? store.edit : undefined,
+        onReload: client.fork ? store.regenerate : undefined,
+        suggestions: metadata.suggestions.map((prompt) => ({ prompt })),
+        adapters: {
+            attachments,
+            speech,
+            dictation,
+            feedback: feedback ?? nativeFeedback,
+            threadList: {
+                threadId: state.selectedId === undefined ? undefined : String(state.selectedId),
+                threads: threads.filter((thread) => thread.status === "regular"),
+                archivedThreads: threads.filter((thread) => thread.status === "archived"),
+                onSwitchToThread: (id) => store.selectConversation(Number(id)),
+                onSwitchToNewThread: async () => { await store.createConversation(); },
+                onRename: client.updateMetadata ? (id, title) => store.renameConversation(Number(id), title) : undefined,
+                onArchive: client.updateMetadata ? (id) => store.archiveConversation(Number(id)) : undefined,
+                onUnarchive: client.updateMetadata ? (id) => store.unarchiveConversation(Number(id)) : undefined,
+            },
+        },
+    });
+    return { runtime, state, actions: store };
+}

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@usecontextlayer/pi-durable-assistant-ui",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "license": "MIT",
+  "description": "Assistant UI runtime adapter for Pi Durable conversations",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/usecontextlayer/pi-durable-assistant-ui.git",
+    "directory": "packages/adapter"
+  },
+  "homepage": "https://github.com/usecontextlayer/pi-durable-assistant-ui#readme",
+  "bugs": {
+    "url": "https://github.com/usecontextlayer/pi-durable-assistant-ui/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "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"
+  },
+  "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"
+  }
+}