@fungi.computer/parakeet 0.0.1 → 0.2.0

package/docs/api/index.md

@@ -26,11 +26,10 @@ What the head is doing: at rest, working something out, or talking.
 type InteractionPanelProps = Readonly<{
   host: WhistleInteractionHost;
   onClose?: () => void;
-  onRetry?: () => void;
 }>;
 ```
 
-The interaction to draw and the page's close and retry callbacks.
+The interaction to draw and the page's close callback.
 
 ---
 
@@ -42,7 +41,7 @@ type AvatarState = Readonly<
 >;
 ```
 
-The current activity and expression supplied to a composer avatar.
+The current activity and expression supplied to a live avatar.
 
 ---
 
@@ -96,8 +95,11 @@ Conversation activity presented by Parakeet.
 
 ```ts
 type TimelineController = Readonly<{
+  cancelQueued: (commandId) => Promise<void>;
+  cancellingQueued: boolean;
   settled: readonly ParakeetTimelineItem[];
   tail: readonly ParakeetTimelineItem[];
+  positionAnchors: ReadonlyMap<number, string | null>;
   commandAnchors: ReadonlyMap<string, string>;
   queued: SessionPendingPrompts;
   pendingHasMore: boolean;
@@ -117,12 +119,33 @@ Stable history and replaceable work rendered by a conversation client.
 
 ---
 
+### ParakeetDraftCheckpoint
+
+```ts
+type ParakeetDraftCheckpoint =
+  | Readonly<{
+      status: "saved";
+    }>
+  | Readonly<{
+      status: "failed";
+      reason: string;
+    }>;
+```
+
+A host may proceed with restart only after the current journal committed.
+
+---
+
 ### ComposerController
 
 ```ts
 type ComposerController = Readonly<{
   cancel: () => Promise<void>;
   draft: string;
+  images: PromptCommand["images"];
+  recallState: QueuedRecallState;
+  recall: () => Promise<QueuedRecallOutcome>;
+  checkpointDraft: () => ParakeetDraftCheckpoint;
   failure: "admission" | "failed" | "cancelled" | "interrupted" | undefined;
   admissionError: "queue_full" | undefined;
   retry: () => void;
@@ -160,6 +183,7 @@ Session activity, observation, and Agent-lifetime controls.
 type ParakeetAuthor = Readonly<{
   id: string;
   name: string;
+  kind?: "agent";
 }>;
 ```
 
@@ -188,6 +212,60 @@ Parakeet never interprets metadata itself.
 
 ---
 
+### ParakeetDraftIdentity
+
+```ts
+type ParakeetDraftIdentity = Readonly<{
+  agentId: string;
+  sessionId: string;
+}>;
+```
+
+Durable owner identity, independent of the current service endpoint.
+
+---
+
+### ParakeetDraftStorage
+
+```ts
+type ParakeetDraftStorage = Readonly<{
+  getItem: (key) => string | null;
+  setItem: (key, value) => void;
+}>;
+```
+
+Hosts must commit a replacement before returning, or throw without changing it.
+
+---
+
+### QueuedRecallState
+
+```ts
+type QueuedRecallState =
+  | Readonly<{
+      kind: "idle" | "recalling" | "restored";
+    }>
+  | Readonly<{
+      kind: "too_late" | "uncertain";
+      message: string;
+    }>;
+```
+
+Ephemeral composer reservation, never an admission journal or queue.
+
+---
+
+### QueuedRecallOutcome
+
+```ts
+type QueuedRecallOutcome =
+  "ignored" | "empty" | "restored" | "too_late" | "uncertain";
+```
+
+Result of one recall gesture; an empty queue permits local input history.
+
+---
+
 ### ParakeetToolArguments
 
 ```ts
@@ -481,15 +559,18 @@ type ParakeetSessionCommand = {
         status: "accepted";
         commandId: string;
       }>
+    | Readonly<{
+        status: "recorded";
+      }>
     | Readonly<{
         status: "too_late";
         commandId: string;
       }>
     | Readonly<{
-        sessionId: string;
+        status: "unknown";
       }>
     | Readonly<{
-        status: "recorded";
+        sessionId: string;
       }>
     | undefined
   >;
@@ -508,9 +589,9 @@ Admit Agent work or record a prompt held for a human reply.
 
 ##### Parameters
 
-| Parameter | Type                                                                                                                                                                                                                         |
-| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `input`   | \| \{ `delivery`: `"followUp"` \| `"steer"`; `requestId`: `string`; `type`: `"prompt"`; `text`: `string`; `images?`: readonly `object`[]; \} \| \{ `type`: `"compact"`; `requestId`: `string`; `instructions?`: `string`; \} |
+| Parameter | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `input`   | \| \{ `delivery`: `Schema.Literals`\<readonly \[`"steer"`, `"followUp"`\]\>; `requestId`: `Schema.String`; `type`: `Schema.Literal`\<`"prompt"`\>; `text`: `Schema.String`; `images?`: `Schema.optionalKey`\<`Schema.$Array`\<`Schema.Struct`\<\{ `type`: `Schema.Literal`\<`"image"`\>; `data`: `Schema.String`; `mimeType`: `Schema.String`; \}\>\>\>; \} \| \{ `type`: `Schema.Literal`\<`"compact"`\>; `requestId`: `Schema.String`; `instructions?`: `Schema.optionalKey`\<`Schema.String`\>; \} |
 
 ##### Returns
 
@@ -526,12 +607,12 @@ Cancel the named queued or running command.
 
 ##### Parameters
 
-| Parameter              | Type                                                                          |
-| ---------------------- | ----------------------------------------------------------------------------- |
-| `input`                | \{ `commandId`: `string`; `onlyIfPending?`: `boolean`; `type`: `"cancel"`; \} |
-| `input.commandId`      | `string`                                                                      |
-| `input.onlyIfPending?` | `boolean`                                                                     |
-| `input.type`           | `"cancel"`                                                                    |
+| Parameter              | Type                                                                                                                                 |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
+| `input`                | \{ `commandId`: `Schema.String`; `onlyIfPending?`: `Schema.optional`\<`Schema.Boolean`\>; `type`: `Schema.Literal`\<`"cancel"`\>; \} |
+| `input.commandId`      | `Schema.String`                                                                                                                      |
+| `input.onlyIfPending?` | `Schema.optional`\<`Schema.Boolean`\>                                                                                                |
+| `input.type`           | `Schema.Literal`\<`"cancel"`\>                                                                                                       |
 
 ##### Returns
 
@@ -547,9 +628,9 @@ Forward an owner-supported Session control command.
 
 ##### Parameters
 
-| Parameter | Type                                                                                                                                                                                                                                                |
-| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `input`   | \| \{ `type`: `"abort"`; \} \| \{ `type`: `"branch"`; `entryId`: `string`; \} \| \{ `type`: `"operator"`; `requestId`: `string`; `author`: `"operator"` \| `"party"`; `text`: `string`; \} \| \{ `type`: `"title"`; `title`: `string` \| `null`; \} |
+| Parameter | Type                                                                                                                                                                                                                                                                                                                                                                                                     |
+| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `input`   | \| \{ `type`: `Schema.Literal`\<`"branch"`\>; `entryId`: `Schema.String`; \} \| \{ `type`: `Schema.Literal`\<`"operator"`\>; `requestId`: `Schema.String`; `author`: `Schema.Literals`\<readonly \[`"operator"`, `"party"`\]\>; `text`: `Schema.String`; \} \| \{ `type`: `Schema.Literal`\<`"title"`\>; `title`: `Schema.NullOr`\<`Schema.String`\>; \} \| \{ `type`: `Schema.Literal`\<`"abort"`\>; \} |
 
 ##### Returns
 
@@ -567,11 +648,11 @@ Return the owner-issued address of a forked Session.
 
 ##### Parameters
 
-| Parameter       | Type                                         |
-| --------------- | -------------------------------------------- |
-| `input`         | \{ `type`: `"fork"`; `entryId`: `string`; \} |
-| `input.type`    | `"fork"`                                     |
-| `input.entryId` | `string`                                     |
+| Parameter       | Type                                                                    |
+| --------------- | ----------------------------------------------------------------------- |
+| `input`         | \{ `type`: `Schema.Literal`\<`"fork"`\>; `entryId`: `Schema.String`; \} |
+| `input.type`    | `Schema.Literal`\<`"fork"`\>                                            |
+| `input.entryId` | `Schema.String`                                                         |
 
 ##### Returns
 
@@ -584,16 +665,19 @@ Return the owner-issued address of a forked Session.
   | Readonly<{
   status: "accepted";
   commandId: string;
+}>
+  | Readonly<{
+  status: "recorded";
 }>
   | Readonly<{
   status: "too_late";
   commandId: string;
 }>
   | Readonly<{
-  sessionId: string;
+  status: "unknown";
 }>
   | Readonly<{
-  status: "recorded";
+  sessionId: string;
 }>
 | undefined>;
 ```
@@ -602,16 +686,16 @@ Dispatch a typed command without inventing an admission result.
 
 ##### Parameters
 
-| Parameter | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `input`   | \| \{ `delivery`: `"followUp"` \| `"steer"`; `requestId`: `string`; `type`: `"prompt"`; `text`: `string`; `images?`: readonly `object`[]; \} \| \{ `type`: `"abort"`; \} \| \{ `commandId`: `string`; `onlyIfPending?`: `boolean`; `type`: `"cancel"`; \} \| \{ `type`: `"branch"`; `entryId`: `string`; \} \| \{ `type`: `"fork"`; `entryId`: `string`; \} \| \{ `type`: `"operator"`; `requestId`: `string`; `author`: `"operator"` \| `"party"`; `text`: `string`; \} \| \{ `type`: `"compact"`; `requestId`: `string`; `instructions?`: `string`; \} \| \{ `type`: `"title"`; `title`: `string` \| `null`; \} |
+| Parameter | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `input`   | \| \{ `delivery`: `Schema.Literals`\<readonly \[`"steer"`, `"followUp"`\]\>; `requestId`: `Schema.String`; `type`: `Schema.Literal`\<`"prompt"`\>; `text`: `Schema.String`; `images?`: `Schema.optionalKey`\<`Schema.$Array`\<`Schema.Struct`\<\{ `type`: `Schema.Literal`\<`"image"`\>; `data`: `Schema.String`; `mimeType`: `Schema.String`; \}\>\>\>; \} \| \{ `type`: `Schema.Literal`\<`"abort"`\>; \} \| \{ `commandId`: `Schema.String`; `onlyIfPending?`: `Schema.optional`\<`Schema.Boolean`\>; `type`: `Schema.Literal`\<`"cancel"`\>; \} \| \{ `type`: `Schema.Literal`\<`"branch"`\>; `entryId`: `Schema.String`; \} \| \{ `type`: `Schema.Literal`\<`"fork"`\>; `entryId`: `Schema.String`; \} \| \{ `type`: `Schema.Literal`\<`"operator"`\>; `requestId`: `Schema.String`; `author`: `Schema.Literals`\<readonly \[`"operator"`, `"party"`\]\>; `text`: `Schema.String`; \} \| \{ `type`: `Schema.Literal`\<`"compact"`\>; `requestId`: `Schema.String`; `instructions?`: `Schema.optionalKey`\<`Schema.String`\>; \} \| \{ `type`: `Schema.Literal`\<`"title"`\>; `title`: `Schema.NullOr`\<`Schema.String`\>; \} |
 
 ##### Returns
 
 `Promise`\< \| `Readonly`\<\{ `status`: `"accepted"`; `commandId`: `string`;
-\}\> \| `Readonly`\<\{ `status`: `"too_late"`; `commandId`: `string`; \}\> \|
-`Readonly`\<\{ `sessionId`: `string`; \}\> \| `Readonly`\<\{ `status`:
-`"recorded"`; \}\> \| `undefined`\>
+\}\> \| `Readonly`\<\{ `status`: `"recorded"`; \}\> \| `Readonly`\<\{ `status`:
+`"too_late"`; `commandId`: `string`; \}\> \| `Readonly`\<\{ `status`:
+`"unknown"`; \}\> \| `Readonly`\<\{ `sessionId`: `string`; \}\> \| `undefined`\>
 
 ---
 
@@ -619,7 +703,11 @@ Dispatch a typed command without inventing an admission result.
 
 ```ts
 type ParakeetSession = Readonly<
-  Pick<ShiitakeSession, "address" | "extension" | "read" | "watch"> & object
+  Pick<
+    ShiitakeSession,
+    "address" | "extension" | "read" | "watch" | "withdraw" | "latestPending"
+  > &
+    object
 >;
 ```
 
@@ -681,6 +769,7 @@ type ParakeetToolItem = Readonly<{
   kind: "tool";
   name: string;
   result?: ToolResultMessage;
+  data?: SessionMessage["data"];
   startedAt?: number;
   status: "completed" | "error" | "running" | "unknown";
 }>;
@@ -728,7 +817,7 @@ type ParakeetTimelineItem =
       kind: "compaction_notice";
       at: number;
       trigger: SessionCompactionTrigger;
-      result: "failed" | "nothing_to_compact";
+      result: "failed" | "nothing_to_compact" | "stale" | "insufficient";
       diagnostic: string | null;
     }
   | ParakeetToolGroupItem
@@ -773,19 +862,19 @@ Stable row grammar rendered by Parakeet's timeline.
   kind: "compaction_notice";
   at: number;
   trigger: SessionCompactionTrigger;
-  result: "failed" | "nothing_to_compact";
+  result: "failed" | "nothing_to_compact" | "stale" | "insufficient";
   diagnostic: string | null;
 }
 ```
 
-| Name         | Type                                 | Description                                                       |
-| ------------ | ------------------------------------ | ----------------------------------------------------------------- |
-| `id`         | `string`                             | Stable rendered-item identity, from the durable notice entry.     |
-| `kind`       | `"compaction_notice"`                | Compaction-notice timeline discriminator.                         |
-| `at`         | `number`                             | When it was recorded, in milliseconds since the epoch.            |
-| `trigger`    | `SessionCompactionTrigger`           | What started it: the user, the context threshold, or an overflow. |
-| `result`     | `"failed"` \| `"nothing_to_compact"` | What the compaction did: nothing to summarize, or a failure.      |
-| `diagnostic` | `string` \| `null`                   | A failure's bounded reason; null for "nothing to compact".        |
+| Name         | Type                                                                  | Description                                                                                                                                                                                                        |
+| ------------ | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `id`         | `string`                                                              | Stable rendered-item identity, from the durable notice entry.                                                                                                                                                      |
+| `kind`       | `"compaction_notice"`                                                 | Compaction-notice timeline discriminator.                                                                                                                                                                          |
+| `at`         | `number`                                                              | When it was recorded, in milliseconds since the epoch.                                                                                                                                                             |
+| `trigger`    | `SessionCompactionTrigger`                                            | What started it: the user, the context threshold, or an overflow.                                                                                                                                                  |
+| `result`     | `"failed"` \| `"nothing_to_compact"` \| `"stale"` \| `"insufficient"` | What the compaction did: nothing to summarize, a failure, or a summary dropped because its head no longer fit the context (stale) or because placing it would have left the context over the limit (insufficient). |
+| `diagnostic` | `string` \| `null`                                                    | A failure's bounded reason; null otherwise.                                                                                                                                                                        |
 
 ---
 
@@ -801,8 +890,9 @@ Stable row grammar rendered by Parakeet's timeline.
 
 ```ts
 const AgentHead: NamedExoticComponent<{
+  timeMs?: number;
   activity?: AgentHeadActivity;
-  avatar?: {
+  avatar: {
     v: 1;
     character: "mushroom" | "cat" | "burger";
     appearance: z.ZodRecord<
@@ -819,22 +909,17 @@ const AgentHead: NamedExoticComponent<{
       | "blueprint"
       | "crt"
       | "watercolor";
-  } | null;
+  };
   className?: string;
   name: string;
-  seed: string;
   size?: number;
 }>;
 ```
 
-An Agent's head at avatar size. Renders the Agent's own avatar when given one;
-otherwise the pre-avatar seeded mushroom cap, byte-identical to before avatars
-existed. The letter shows until a frame is ready. It holds still unless
-`thinking` or `speaking`: an idle head whose render style is "plain" and already
-has a cached still frame for its look never mounts a live canvas, so a long rail
-is not a wall of animation. A render style other than "plain" is a CSS filter
-over the live canvas, not part of the captured pixels, so a styled head always
-stays live.
+An Agent's head at avatar size, drawn from the Agent's own avatar (a property of
+the Agent record, never of a conversation). The letter shows until a frame is
+ready. The live canvas stays mounted and is paused unless `thinking` or
+`speaking`, so an idle head shows its real look without animating.
 
 ---
 
@@ -866,9 +951,10 @@ const ShiitakeAvatar: NamedExoticComponent<{
 }>;
 ```
 
-Shiitake's sprite head, drawn in the activity and expression it is given. With
-no `avatar`, this is the product mascot, exactly as before avatars existed: no
-seeded colour, the character's own defaults.
+A sprite head drawn in the live activity and expression it is given. With an
+`avatar` it draws that look (a member's own, in their settings); with none it is
+Shiitake, the product mascot, in the character's own defaults. Conversations
+have no avatar: an Agent's head is `AgentHead`, drawn from the Agent record.
 
 ---
 
@@ -913,9 +999,9 @@ Own one renderer-neutral conversation scope over the existing query cache.
 
 #### Parameters
 
-| Parameter           | Type                                                                                                                                                                                                                                                                          |
-| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `__namedParameters` | `Readonly`\<\{ `children`: `ReactNode`; `session`: [`ParakeetSession`](#parakeetsession); `clients?`: readonly `ClientEntryV1`[]; `interactionStore?`: [`ParakeetInteractions`](headless.md#parakeetinteractions); `authorOf?`: [`ParakeetAuthorOf`](#parakeetauthorof); \}\> |
+| Parameter           | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `__namedParameters` | `Readonly`\<\{ `children`: `ReactNode`; `session`: [`ParakeetSession`](#parakeetsession); `clients?`: readonly `ClientEntryV1`[]; `interactionStore?`: [`ParakeetInteractions`](headless.md#parakeetinteractions); `onToast?`: (`toast`) => `void`; `draftStorage?`: [`ParakeetDraftStorage`](#parakeetdraftstorage); `draftIdentity?`: [`ParakeetDraftIdentity`](#parakeetdraftidentity); `authorOf?`: [`ParakeetAuthorOf`](#parakeetauthorof); \}\> |
 
 #### Returns
 
@@ -1027,6 +1113,28 @@ The durable assistant's provider/model ids, shared by browser and terminal.
 
 ---
 
+### formatModelWithLevel()
+
+```ts
+function formatModelWithLevel(model, level): string;
+```
+
+The model identity with its thinking level, "provider/model (level)"; no level,
+no suffix.
+
+#### Parameters
+
+| Parameter | Type                              |
+| --------- | --------------------------------- |
+| `model`   | [`ParakeetModel`](#parakeetmodel) |
+| `level`   | `string` \| `undefined`           |
+
+#### Returns
+
+`string`
+
+---
+
 ### toolGroupDefaultOpen()
 
 ```ts
@@ -1061,7 +1169,7 @@ function visibleToolCalls(
   activeVerb: string;
   label: string;
   paths: readonly string[];
-  status: "error" | "unknown" | "completed" | "running";
+  status: "error" | "unknown" | "running" | "completed";
   durationMs?: number;
   exitCode?: number;
   error?: string;
@@ -1083,7 +1191,7 @@ Even a folded group shows recent calls, rather than hiding all tool work.
 readonly `Readonly`\<\{ `id`: `string`; `kind`:
 [`ParakeetToolKind`](#parakeettoolkind); `name`: `string`; `verb`: `string`;
 `activeVerb`: `string`; `label`: `string`; `paths`: readonly `string`[];
-`status`: `"error"` \| `"unknown"` \| `"completed"` \| `"running"`;
+`status`: `"error"` \| `"unknown"` \| `"running"` \| `"completed"`;
 `durationMs?`: `number`; `exitCode?`: `number`; `error?`: `string`; `sections`:
 readonly [`ParakeetToolCallSection`](#parakeettoolcallsection)[]; \}\>[]
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fungi.computer/parakeet",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "author": "Levi <levi@technomancy.dev>",
   "private": false,
   "description": "Standalone React composer for a typed Shiitake Session",
@@ -19,6 +19,10 @@
       "types": "./dist/headless.d.ts",
       "import": "./dist/headless.js"
     },
+    "./conversation-opening": {
+      "types": "./dist/conversation-opening.d.ts",
+      "import": "./dist/conversation-opening.js"
+    },
     "./agent-head": {
       "types": "./dist/agent-head.d.ts",
       "import": "./dist/agent-head.js"
@@ -43,23 +47,25 @@
     "react-dom": "^18.2.0 || ^19.2.0"
   },
   "dependencies": {
-    "@fungi.computer/cairn": "0.0.1",
-    "@fungi.computer/caps": "0.0.2",
-    "@fungi.computer/knapsack": "0.0.2",
-    "@fungi.computer/shiitake": "0.1.0",
-    "@fungi.computer/sigils": "0.0.1",
-    "@fungi.computer/sprite": "0.0.1",
-    "@fungi.computer/sprite-zdog": "0.0.1",
-    "@fungi.computer/whistle": "0.0.1",
+    "@fungi.computer/agar": "0.3.0",
+    "@fungi.computer/cairn": "0.1.0",
+    "@fungi.computer/caps": "0.2.0",
+    "@fungi.computer/knapsack": "0.2.0",
+    "@fungi.computer/shiitake": "0.3.0",
+    "@fungi.computer/sigils": "0.2.0",
+    "@fungi.computer/sprite": "0.2.0",
+    "@fungi.computer/sprite-zdog": "0.2.0",
+    "@fungi.computer/whistle": "0.1.0",
     "@tanstack/markdown": "0.0.12",
     "@tanstack/react-virtual": "3.14.10",
     "diff": "8.0.4",
+    "eventsource": "5.1.1",
     "jotai": "2.20.3",
     "jotai-tanstack-query": "0.11.0",
     "lucide-react": "0.460.0",
     "strip-ansi": "7.2.0",
     "zod": "4.4.3",
-    "@fungi.computer/gills": "0.0.1"
+    "@fungi.computer/gills": "0.2.0"
   },
   "dependenciesMeta": {
     "@fungi.computer/caps": {

package/src/styles.css

@@ -5,7 +5,11 @@
  */
 @import "@fungi.computer/caps/tailwind.css";
 
+/* In the workspace Tailwind scans the component source; published, this
+ * entry ships without it, and the compiled components in dist carry the same
+ * class names. */
 @source "./";
+@source "../dist/**/*.js";
 
 @plugin "@tailwindcss/typography";
 
@@ -109,15 +113,6 @@
   color: var(--color-success);
 }
 
-.chat-composer .parakeet-key-hints {
-  margin: 0;
-  padding: 0 0.75rem 0.25rem;
-  background: var(--color-base-200);
-  font-family: var(--font-sans);
-  font-size: 0.6rem;
-  color: var(--stipe-fg-muted);
-}
-
 .chat-composer .footer-divider {
   width: 3px;
   height: 3px;

package/dist/components/still-frame-cache.d.ts

@@ -1,16 +0,0 @@
-import type { AvatarSpriteProps } from "./avatar-presentation.js";
-/** The still-frame cache key for one presentation at one pixel size. */
-export declare function stillFrameKey(presentation: AvatarSpriteProps, size: number, devicePixelRatio: number): string;
-/** The cached still frame for `key`, refreshing its recency, or `undefined`. */
-export declare function getStillFrame(key: string): string | undefined;
-/** Cache `value` (a data URL) for `key`, evicting the oldest entry past 128. */
-export declare function setStillFrame(key: string, value: string): void;
-/**
- * Capture the idle frame of a just-rendered Sprite host as a still image, or
- * `undefined` when the host has no live canvas yet (not ready) or the
- * canvas export is denied because the canvas is tainted. Other export failures
- * propagate with their cause.
- */
-export declare function captureStillFrame(host: HTMLElement | null): string | undefined;
-/** Test-only: clears every cached still frame so tests do not leak between runs. */
-export declare function clearStillFrameCache(): void;

package/dist/components/still-frame-cache.js

@@ -1,63 +0,0 @@
-const MAX_ENTRIES = 128;
-/**
- * Idle heads shown over and over (an Agent rail) do not need their own live
- * canvas: once one instance of a descriptor has rendered, every other idle
- * instance can show the same still frame. Keyed by the resolved presentation
- * plus the pixel size it was drawn at, so a resize or a different size
- * elsewhere never serves the wrong frame. An LRU of about 128 entries; the
- * oldest is evicted once that is exceeded.
- */
-const cache = new Map();
-/** The still-frame cache key for one presentation at one pixel size. */
-export function stillFrameKey(presentation, size, devicePixelRatio) {
-    return JSON.stringify([
-        presentation.src,
-        presentation.appearance,
-        presentation.expression,
-        presentation.renderStyle,
-        size,
-        devicePixelRatio,
-    ]);
-}
-/** The cached still frame for `key`, refreshing its recency, or `undefined`. */
-export function getStillFrame(key) {
-    const value = cache.get(key);
-    if (value === undefined)
-        return undefined;
-    cache.delete(key);
-    cache.set(key, value);
-    return value;
-}
-/** Cache `value` (a data URL) for `key`, evicting the oldest entry past 128. */
-export function setStillFrame(key, value) {
-    cache.delete(key);
-    cache.set(key, value);
-    if (cache.size <= MAX_ENTRIES)
-        return;
-    const oldestKey = cache.keys().next().value;
-    if (oldestKey !== undefined)
-        cache.delete(oldestKey);
-}
-/**
- * Capture the idle frame of a just-rendered Sprite host as a still image, or
- * `undefined` when the host has no live canvas yet (not ready) or the
- * canvas export is denied because the canvas is tainted. Other export failures
- * propagate with their cause.
- */
-export function captureStillFrame(host) {
-    const canvas = host?.querySelector("canvas");
-    if (!canvas)
-        return undefined;
-    try {
-        return canvas.toDataURL("image/png");
-    }
-    catch (cause) {
-        if (cause instanceof DOMException && cause.name === "SecurityError")
-            return undefined;
-        throw new Error("Could not capture an avatar still frame", { cause });
-    }
-}
-/** Test-only: clears every cached still frame so tests do not leak between runs. */
-export function clearStillFrameCache() {
-    cache.clear();
-}