@fungi.computer/parakeet 0.1.0 → 0.2.0

package/dist/conversation.d.ts

@@ -1,13 +1,15 @@
 import { type ParakeetAuthorOf } from "./core/author-labels.js";
-import { type PromptDelivery, type SessionContext, type SessionExtensionSlots, type SessionPendingPrompts } from "@fungi.computer/shiitake/client";
+import { type PromptDelivery, type PromptCommand, type SessionContext, type SessionExtensionSlots, type SessionPendingPrompts } from "@fungi.computer/shiitake/client";
 import type { ClientEntryV1 } from "@fungi.computer/shiitake/client-entry";
 import { type ClientContribution } from "./core/client-contributions.js";
-import { type ParakeetInteractions } from "./commands/interactions.js";
+import { type ParakeetInteractions, type ParakeetToast } from "./commands/interactions.js";
 import type { WhistleExecutionOutcome } from "@fungi.computer/whistle";
 import { type ReactNode } from "react";
 import { type SessionViewState } from "./core/session-view-state.js";
 import type { ParakeetSession } from "./session.js";
 import type { TimelineItem } from "./store/types.js";
+import { type QueuedRecallState, type QueuedRecallOutcome } from "./core/queued-recall.js";
+import { type ParakeetDraftIdentity, type ParakeetDraftStorage } from "./core/draft-storage.js";
 /** Stable model identity presented by the current Session. */
 export type ParakeetModel = Readonly<{
     /** Provider model identifier. */
@@ -49,10 +51,16 @@ export type ParakeetObservation = Readonly<{
 }>;
 /** Stable history and replaceable work rendered by a conversation client. */
 export type TimelineController = Readonly<{
+    /** Remove one owner-admitted queued prompt, never the running turn or draft. */
+    cancelQueued: (commandId: string) => Promise<void>;
+    /** A queued-input gesture is waiting for its owner. */
+    cancellingQueued: boolean;
     /** Durable-backed rows whose identity is stable across progress revisions. */
     settled: readonly TimelineItem[];
     /** Replaceable progress, queued, and optimistic rows. */
     tail: readonly TimelineItem[];
+    /** Fixed committed Session positions resolved within the loaded history. */
+    positionAnchors: ReadonlyMap<number, string | null>;
     /** Last actually rendered durable row for each loaded command. */
     commandAnchors: ReadonlyMap<string, string>;
     /** Current owner-admitted prompts, independent of the visible history page. */
@@ -78,12 +86,35 @@ export type TimelineController = Readonly<{
     /** Accumulated durable usage. */
     usage?: ParakeetUsage | undefined;
 }>;
+/** A host may proceed with restart only after the current journal committed. */
+export type ParakeetDraftCheckpoint = Readonly<{
+    /** The latest draft is committed and restart may proceed. */
+    status: "saved";
+}> | Readonly<{
+    /** Draft persistence failed; the host must not proceed with restart. */
+    status: "failed";
+    /** Storage failure explanation for the host. */
+    reason: string;
+}>;
 /** Draft and prompt operations for the current conversation. */
 export type ComposerController = Readonly<{
     /** Stop the current turn. Queued prompts keep draining; the draft is unchanged. */
     cancel: () => Promise<void>;
     /** Current local input. */
     draft: string;
+    /** Image cargo restored with a queued prompt, carried through the same journal. */
+    images: PromptCommand["images"];
+    /** Shared composer reservation and recall outcome. */
+    recallState: QueuedRecallState;
+    /** Recall only when the host accepted a plain Up on empty, focused input. */
+    recall: () => Promise<QueuedRecallOutcome>;
+    /**
+     * Commit the latest draft and pending admissions synchronously, even through
+     * a callback captured before newer typing. Does not consume, send or withdraw.
+     * A resumed provider reads the same Session journal; never replay a copied
+     * draft over its newer state. A failed commit leaves the live draft untouched.
+     */
+    checkpointDraft: () => ParakeetDraftCheckpoint;
     /** Typed reason the latest prompt did not complete. */
     failure: "admission" | "failed" | "cancelled" | "interrupted" | undefined;
     /** Current send could not enter the bounded local admission queue. */
@@ -136,11 +167,24 @@ export type ParakeetReconnectOutcome = Readonly<{
     cause: string;
 }>;
 /** Own one renderer-neutral conversation scope over the existing query cache. */
-export declare function ParakeetProvider({ children, session, clients, interactionStore, authorOf, }: Readonly<{
+export declare function ParakeetProvider({ children, session, clients, interactionStore, authorOf, onToast, draftStorage, draftIdentity, }: Readonly<{
     children: ReactNode;
     session: ParakeetSession;
     clients?: readonly ClientEntryV1[] | undefined;
     interactionStore?: ParakeetInteractions | undefined;
+    /** Show a transient message; the host owns the toast surface. */
+    onToast?: ((toast: ParakeetToast) => void) | undefined;
+    /**
+     * Browser localStorage when accessible, otherwise session-only drafts.
+     * Native hosts supply an atomic file adapter.
+     */
+    draftStorage?: ParakeetDraftStorage | undefined;
+    /**
+     * Hosts replacing transport endpoints must supply the durable owner pair.
+     * Otherwise the Session's logical address names its journal.
+     * Exactly one key is used; no previous-address lookup or migration occurs.
+     */
+    draftIdentity?: ParakeetDraftIdentity | undefined;
     /**
      * Read the author to show from a message's opaque host metadata. Absent,
      * lines show no author.