@fungi.computer/parakeet 0.4.0 → 0.6.0

package/docs/api/index.md

@@ -20,6 +20,64 @@ What the head is doing: at rest, working something out, or talking.
 
 ---
 
+### ComposerModelKeyProps
+
+```ts
+type ComposerModelKeyProps = Omit<
+  KeycapButtonProps,
+  "icon" | "readout" | "label"
+> &
+  object;
+```
+
+A model label on the shared native key; callers own selection and menus.
+
+#### Type Declaration
+
+| Name    | Type     | Description                                                              |
+| ------- | -------- | ------------------------------------------------------------------------ |
+| `label` | `string` | Friendly catalog name, or the real model identity when no name is known. |
+
+---
+
+### ComposerShellRow
+
+```ts
+type ComposerShellRow = Readonly<{
+  controls: ReactNode;
+  action: ReactNode;
+  status?: ReactNode;
+  readout?: ReactNode;
+  items: readonly StatusTrayItem[];
+  openId: string | null;
+  onOpenChange: (id) => void;
+}>;
+```
+
+App-owned controls and tray contents; Parakeet owns their single row.
+
+---
+
+### ComposerShellProps
+
+```ts
+type ComposerShellProps = HTMLAttributes<HTMLDivElement> & object;
+```
+
+Content slots for the shared chat and generation composer surface.
+
+#### Type Declaration
+
+| Name           | Type                                    | Description                                                       |
+| -------------- | --------------------------------------- | ----------------------------------------------------------------- |
+| `input`        | `ReactNode`                             | Draft field or decision surface, using the shared input geometry. |
+| `attachments?` | `ReactNode`                             | Optional draft attachments rendered by the Composer primitive.    |
+| `action?`      | `ReactNode`                             | Retained field-and-Send mode without an internal control row.     |
+| `menu?`        | `ReactNode`                             | Optional completion menu anchored to this shell.                  |
+| `row?`         | [`ComposerShellRow`](#composershellrow) | Omit while a decision owns the input and its own actions.         |
+
+---
+
 ### InteractionPanelProps
 
 ```ts
@@ -147,12 +205,13 @@ type ComposerController = Readonly<{
   recall: () => Promise<QueuedRecallOutcome>;
   checkpointDraft: () => ParakeetDraftCheckpoint;
   failure: "admission" | "failed" | "cancelled" | "interrupted" | undefined;
-  admissionError: "queue_full" | undefined;
+  admissionError: "offline_queue_full" | "queue_full" | undefined;
   retry: () => void;
   dismissFailed: (requestId) => void;
   send: (delivery?) => void;
   submitCommand: (run) => Promise<WhistleExecutionOutcome | undefined>;
   setDraft: (value) => void;
+  setImages: (images) => void;
 }>;
 ```
 
@@ -231,6 +290,7 @@ Durable owner identity, independent of the current service endpoint.
 type ParakeetDraftStorage = Readonly<{
   getItem: (key) => string | null;
   setItem: (key, value) => void;
+  removeItem: (key) => void;
 }>;
 ```
 
@@ -463,6 +523,7 @@ type ParakeetToolCallView = Readonly<{
   exitCode?: number;
   error?: string;
   sections: readonly ParakeetToolCallSection[];
+  live?: ParakeetToolItem["live"];
 }>;
 ```
 
@@ -494,6 +555,7 @@ type ParakeetProps = Readonly<{
   clients?: readonly ClientEntryV1[];
   composerActionVariant?: "primary" | "outline";
   renderToolActions?: (item) => ReactNode;
+  claimsToolMedia?: (item) => boolean;
   renderAssistantAttachment?: (text) => ReactNode;
   formatAssistantText?: (text) => string;
   onLink?: (href) => boolean;
@@ -515,6 +577,7 @@ type ParakeetViewProps = Readonly<{
   visitor?: ParakeetVisitor;
   composerActionVariant?: "primary" | "outline";
   renderToolActions?: (item) => ReactNode;
+  claimsToolMedia?: (item) => boolean;
   renderAssistantAttachment?: (text) => ReactNode;
   formatAssistantText?: (text) => string;
   onLink?: (href) => boolean;
@@ -558,6 +621,7 @@ type ParakeetSessionCommand = {
     | Readonly<{
         status: "accepted";
         commandId: string;
+        sessionId?: string;
       }>
     | Readonly<{
         status: "recorded";
@@ -665,6 +729,7 @@ Return the owner-issued address of a forked Session.
   | Readonly<{
   status: "accepted";
   commandId: string;
+  sessionId?: string;
 }>
   | Readonly<{
   status: "recorded";
@@ -693,9 +758,10 @@ Dispatch a typed command without inventing an admission result.
 ##### Returns
 
 `Promise`\< \| `Readonly`\<\{ `status`: `"accepted"`; `commandId`: `string`;
-\}\> \| `Readonly`\<\{ `status`: `"recorded"`; \}\> \| `Readonly`\<\{ `status`:
-`"too_late"`; `commandId`: `string`; \}\> \| `Readonly`\<\{ `status`:
-`"unknown"`; \}\> \| `Readonly`\<\{ `sessionId`: `string`; \}\> \| `undefined`\>
+`sessionId?`: `string`; \}\> \| `Readonly`\<\{ `status`: `"recorded"`; \}\> \|
+`Readonly`\<\{ `status`: `"too_late"`; `commandId`: `string`; \}\> \|
+`Readonly`\<\{ `status`: `"unknown"`; \}\> \| `Readonly`\<\{ `sessionId`:
+`string`; \}\> \| `undefined`\>
 
 ---
 
@@ -748,6 +814,9 @@ type ParakeetAssistantMessageItem = Readonly<{
   pending: boolean;
   at?: number;
   text: string;
+  providerError?: string;
+  errorDetail?: string;
+  repeatCount?: number;
   thinking?: string;
   usage?: Readonly<{
     cost: number;
@@ -772,6 +841,11 @@ type ParakeetToolItem = Readonly<{
   data?: SessionMessage["data"];
   startedAt?: number;
   status: "completed" | "error" | "running" | "unknown";
+  live?: Readonly<{
+    lines: readonly string[];
+    droppedBytes: number;
+    revision: number;
+  }>;
 }>;
 ```
 
@@ -923,6 +997,20 @@ ready. The live canvas stays mounted and is paused unless `thinking` or
 
 ---
 
+### ComposerModelKey
+
+```ts
+const ComposerModelKey: ForwardRefExoticComponent<
+  Omit<KeycapButtonProps, "label" | "icon" | "readout"> &
+    object &
+    RefAttributes<HTMLButtonElement>
+>;
+```
+
+The same model face and chevron in chat and generation composers.
+
+---
+
 ### ShiitakeAvatar
 
 ```ts
@@ -968,6 +1056,72 @@ Defaults only, with no reader choices.
 
 ## Functions
 
+### composerSendState()
+
+```ts
+function composerSendState(__namedParameters): SendActionState;
+```
+
+One input-to-action rule for both Apps; Caps owns the resulting key's look.
+
+#### Parameters
+
+| Parameter                           | Type                                                                                                                           | Description                                                             |
+| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |
+| `__namedParameters`                 | \{ `draft`: `string`; `hasAttachments?`: `boolean`; `busy`: `boolean`; `queueWhileBusy?`: `boolean`; `blocked?`: `boolean`; \} | -                                                                       |
+| `__namedParameters.draft`           | `string`                                                                                                                       | -                                                                       |
+| `__namedParameters.hasAttachments?` | `boolean`                                                                                                                      | -                                                                       |
+| `__namedParameters.busy`            | `boolean`                                                                                                                      | -                                                                       |
+| `__namedParameters.queueWhileBusy?` | `boolean`                                                                                                                      | Chat can queue a follow-up; generation stays busy until it settles.     |
+| `__namedParameters.blocked?`        | `boolean`                                                                                                                      | An input owner can temporarily block submission, such as during recall. |
+
+#### Returns
+
+`SendActionState`
+
+---
+
+### ComposerShell()
+
+```ts
+function ComposerShell(__namedParameters): Element;
+```
+
+One field surface and one non-wrapping control row, with Send at its end.
+
+#### Parameters
+
+| Parameter           | Type                                        |
+| ------------------- | ------------------------------------------- |
+| `__namedParameters` | [`ComposerShellProps`](#composershellprops) |
+
+#### Returns
+
+`Element`
+
+---
+
+### useComposerTextareaSize()
+
+```ts
+function useComposerTextareaSize(ref, value): void;
+```
+
+Grow either App's field with its draft; shell CSS owns the height limits.
+
+#### Parameters
+
+| Parameter | Type                                 |
+| --------- | ------------------------------------ |
+| `ref`     | `RefObject`\<`HTMLTextAreaElement`\> |
+| `value`   | `string`                             |
+
+#### Returns
+
+`void`
+
+---
+
 ### InteractionPanel()
 
 ```ts
@@ -1174,6 +1328,11 @@ function visibleToolCalls(
   exitCode?: number;
   error?: string;
   sections: readonly ParakeetToolCallSection[];
+  live?: Readonly<{
+    lines: readonly string[];
+    droppedBytes: number;
+    revision: number;
+  }>;
 }>[];
 ```
 
@@ -1193,7 +1352,9 @@ readonly `Readonly`\<\{ `id`: `string`; `kind`:
 `activeVerb`: `string`; `label`: `string`; `paths`: readonly `string`[];
 `status`: `"error"` \| `"unknown"` \| `"running"` \| `"completed"`;
 `durationMs?`: `number`; `exitCode?`: `number`; `error?`: `string`; `sections`:
-readonly [`ParakeetToolCallSection`](#parakeettoolcallsection)[]; \}\>[]
+readonly [`ParakeetToolCallSection`](#parakeettoolcallsection)[]; `live?`:
+`Readonly`\<\{ `lines`: readonly `string`[]; `droppedBytes`: `number`;
+`revision`: `number`; \}\>; \}\>[]
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fungi.computer/parakeet",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "author": "Levi <levi@technomancy.dev>",
   "private": false,
   "description": "Standalone React composer for a typed Shiitake Session",
@@ -31,6 +31,12 @@
       "types": "./dist/commands/slash.d.ts",
       "import": "./dist/commands/slash.js"
     },
+    "./completion-menu": {
+      "types": "./dist/components/CompletionMenu.d.ts",
+      "import": "./dist/components/CompletionMenu.js"
+    },
+    "./completion-menu.css": "./src/completion-menu.css",
+    "./composer-shell.css": "./src/composer-shell.css",
     "./styles.css": "./dist/styles.css",
     "./tailwind.css": "./src/styles.css"
   },
@@ -39,6 +45,8 @@
     "README.md",
     "LICENSE",
     "src/styles.css",
+    "src/completion-menu.css",
+    "src/composer-shell.css",
     "docs/api"
   ],
   "peerDependencies": {
@@ -47,17 +55,18 @@
     "react-dom": "^18.2.0 || ^19.2.0"
   },
   "dependencies": {
-    "@fungi.computer/agar": "0.4.0",
-    "@fungi.computer/bird-dog": "0.2.1",
+    "@earendil-works/pi-ai": "1.3.0",
+    "@fungi.computer/agar": "0.6.0",
+    "@fungi.computer/bird-dog": "0.3.1",
     "@fungi.computer/cairn": "0.1.0",
-    "@fungi.computer/caps": "0.3.1",
+    "@fungi.computer/caps": "0.5.0",
     "@fungi.computer/gills": "0.2.0",
-    "@fungi.computer/knapsack": "0.3.1",
-    "@fungi.computer/shiitake": "0.5.0",
+    "@fungi.computer/knapsack": "0.4.1",
+    "@fungi.computer/shiitake": "0.7.0",
     "@fungi.computer/sigils": "0.2.0",
     "@fungi.computer/sprite": "0.2.0",
-    "@fungi.computer/sprite-zdog": "0.2.0",
-    "@fungi.computer/whistle": "0.2.0",
+    "@fungi.computer/sprite-zdog": "0.3.0",
+    "@fungi.computer/whistle": "0.3.0",
     "@tanstack/markdown": "0.0.12",
     "@tanstack/react-virtual": "3.14.10",
     "diff": "8.0.4",

package/src/completion-menu.css

@@ -0,0 +1,72 @@
+/* The shared completion menu's look: Grove's slash commands and Prints' slash and @character menus. */
+
+/*
+ * The menu joins the composer surface instead of floating as a second box:
+ * same width and inset, flush on its top edge, and the surface's own top
+ * border is the one line between them. --parakeet-completion-inset is the
+ * distance from the menu's containing block to the surface's outer edge: an
+ * anchor's padding or a field's own containing box. ComposerShell supplies
+ * zero inset; there is no Prints-specific negative card-border offset.
+ * --parakeet-completion-face and --parakeet-completion-edge carry the
+ * surface's own background and border colour, so the two read as one.
+ */
+.caps-popover[data-parakeet-slash][data-side="top"] {
+  inset-inline: var(--parakeet-completion-inset, 0);
+  bottom: calc(100% - var(--parakeet-completion-inset, 0px));
+  border-color: var(
+    --parakeet-completion-edge,
+    color-mix(in oklab, var(--color-base-content) 16%, transparent)
+  );
+  border-bottom-width: 0;
+  background: var(--parakeet-completion-face, var(--color-base-200));
+  border-end-start-radius: 0;
+  border-end-end-radius: 0;
+  box-shadow: none;
+}
+.parakeet-slash-menu .parakeet-slash-label {
+  min-width: 7rem;
+  font-family: var(--font-mono);
+  font-weight: 600;
+}
+
+.parakeet-slash-match {
+  background: none;
+  color: var(--color-primary);
+}
+
+.parakeet-slash-detail {
+  flex: 1;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  color: var(--stipe-fg-muted);
+}
+
+.parakeet-slash-keys {
+  font-family: var(--font-mono);
+  font-size: 0.65rem;
+  color: var(--stipe-fg-muted);
+}
+
+.parakeet-slash-hint {
+  margin: 0;
+  padding: 0.25rem 0.5rem;
+  font-family: var(--font-mono);
+  font-size: 0.75rem;
+  color: var(--stipe-fg-muted);
+}
+
+.parakeet-slash-menu [data-disabled="true"] {
+  opacity: 0.5;
+}
+
+/* A row with a thumbnail centres its text on the thumbnail rather than its top. */
+.parakeet-slash-menu [role="option"]:has(> .parakeet-slash-media) {
+  align-items: center;
+}
+
+.parakeet-slash-media {
+  display: flex;
+  flex: none;
+}

package/src/composer-shell.css

@@ -0,0 +1,125 @@
+/* Chat and generation share one surface, field inset and control-row grid.
+   Apps supply controls and content, never a second composer layout. */
+.parakeet-composer-anchor {
+  --parakeet-completion-inset: 0px;
+  --parakeet-completion-face: var(--color-base-200);
+  --parakeet-completion-edge: var(--stipe-hairline);
+  display: block;
+  min-width: 0;
+}
+
+.parakeet-composer-anchor:has([data-parakeet-slash])
+  > .parakeet-composer-shell {
+  border-start-start-radius: 0;
+  border-start-end-radius: 0;
+}
+
+.parakeet-composer-shell {
+  padding: var(--spacing-sm);
+  container-type: inline-size;
+}
+
+.parakeet-composer-shell .caps-composer-input {
+  padding: var(--spacing-xs) var(--spacing-sm) 0;
+}
+
+.parakeet-composer-shell .caps-composer-input textarea {
+  min-height: 3rem;
+  max-height: 160px;
+  padding: var(--spacing-xs) 0;
+  resize: none;
+  overflow-x: hidden;
+  overflow-y: auto;
+  white-space: pre-wrap;
+  overflow-wrap: break-word;
+  font-family: var(--font-sans);
+  font-size: var(--text-base);
+  line-height: 1.6;
+}
+
+.parakeet-composer-shell .parakeet-composer-row {
+  --caps-status-tray-row-wrap: nowrap;
+  padding: var(--spacing-xs);
+}
+
+.parakeet-composer-row .caps-status-tray-row {
+  white-space: nowrap;
+}
+
+/* A menu trigger can carry Button's touch minimum as well as its Keycap face.
+   The shared row, not either App or the generic Button, owns key geometry. */
+.parakeet-composer-row .caps-keycap-button {
+  height: var(--caps-status-tray-key-height);
+  min-height: var(--caps-status-tray-key-height);
+}
+
+/* Composer keys already disclose through their face and chevron. Keep native
+   expanded/pressed semantics without redundant decorative corner lamps. */
+.parakeet-composer-row .caps-keycap-led {
+  display: none;
+}
+
+.parakeet-composer-row [data-status-tray-chip] {
+  min-width: 0;
+}
+
+.parakeet-composer-row .caps-status-tray-label,
+.parakeet-composer-row .caps-keycap-button-label {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.parakeet-composer-row .parakeet-composer-model-key {
+  --caps-keycap-justify: space-between;
+  flex: 0 1 auto;
+  min-width: 4.5rem;
+  max-width: 220px;
+  font-size: var(--text-xs);
+}
+
+.parakeet-composer-trailing {
+  display: flex;
+  align-items: center;
+  flex: none;
+  gap: var(--spacing-xs);
+  margin-inline-start: auto;
+}
+
+.parakeet-composer-action {
+  display: flex;
+  flex: none;
+}
+
+.parakeet-composer-readout {
+  color: var(--stipe-fg-muted);
+  font-size: var(--text-xs);
+  line-height: 1;
+  font-variant-numeric: tabular-nums;
+  white-space: nowrap;
+}
+
+.parakeet-composer-row .composer-attention-label {
+  @apply sr-only;
+}
+
+.parakeet-composer-row .parakeet-composer-status {
+  gap: 0;
+}
+
+/* The status dot stays beside Send when usage yields to Settings; the model
+   label then yields to ellipsis.
+   Edge keys never shrink or change rows. The budget is the shell's width:
+   Grove's split pane can be narrower at 900px than at 640px. */
+@container (max-width: 34rem) {
+  .parakeet-composer-readout {
+    display: none;
+  }
+}
+
+@container (max-width: 26rem) {
+  .parakeet-composer-row .parakeet-composer-model-key {
+    max-width: 7rem;
+  }
+}