@fungi.computer/parakeet-testing 0.1.4 → 0.2.1

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import type { SessionActivity, SessionExtensionSlots } from "@fungi.computer/shiitake/client";
 import { type Json } from "@fungi.computer/shiitake/extensions";
+import type { WhistlePrompt } from "@fungi.computer/whistle";
 import type { WhistleCatalogV1 } from "@fungi.computer/whistle/catalog";
 /** Activity facts for a Session with nothing queued or running. */
 export declare const idleActivity: SessionActivity;
@@ -40,3 +41,31 @@ export declare const slashParityFlow: {
     readonly choose: "Fern bed";
     readonly notice: "Watered the fern bed.";
 };
+/** The state of one decision a fixture holds, shaped like the Parakeet reducer's. */
+export type AwaitingFixtureState = Readonly<{
+    highlight: number;
+    toggled: ReadonlySet<string>;
+    other: string;
+    phase: "choose" | "other" | "confirm" | "sending" | "refused";
+    refusal?: string;
+    details: boolean;
+}>;
+/** One decision shown at one moment, held identically by every renderer's test. */
+export type AwaitingFixture = Readonly<{
+    /** What the fixture shows, for test names. */
+    name: string;
+    kind: "question" | "approval";
+    prompt: Extract<WhistlePrompt, {
+        type: "decision";
+    }>;
+    state: AwaitingFixtureState;
+    /** One-based place among all waiting decisions. */
+    position: number;
+    /** Every waiting decision. */
+    total: number;
+}>;
+/**
+ * The decisions every renderer must draw the same way. Each Parakeet renderer
+ * renders every fixture and holds its output to `decisionView`.
+ */
+export declare const awaitingFixtures: readonly AwaitingFixture[];

package/dist/index.js

@@ -1,4 +1,5 @@
 import { parseExtensionJson, } from "@fungi.computer/shiitake/extensions";
+import { parsePrompt } from "@fungi.computer/whistle/wire";
 import { z } from "zod";
 /** Activity facts for a Session with nothing queued or running. */
 export const idleActivity = {
@@ -125,3 +126,166 @@ export const slashParityFlow = {
     choose: "Fern bed",
     notice: "Watered the fern bed.",
 };
+function decision(input) {
+    const prompt = parsePrompt({ type: "decision", ...input });
+    if (prompt.type !== "decision")
+        throw new Error("Expected a decision prompt");
+    return prompt;
+}
+const storage = decision({
+    message: "Which store should hold the notes?",
+    options: [
+        {
+            value: "SQLite",
+            label: "SQLite",
+            description: "Keep notes on this computer.",
+        },
+        {
+            value: "PostgreSQL",
+            label: "PostgreSQL",
+            description: "Use the shared database.",
+        },
+    ],
+    other: {
+        label: "Other…",
+        placeholder: "Write your own answer",
+        maxLength: 4_000,
+    },
+});
+const deliverables = decision({
+    message: "Which deliverables should ship?",
+    summary: "Question 1 of 2",
+    options: [
+        { value: "Docs", label: "Docs", description: "Explain usage." },
+        { value: "Tests", label: "Tests", description: "Verify behavior." },
+        { value: "Examples", label: "Examples", description: "Show it working." },
+    ],
+    multiple: true,
+    other: {
+        label: "Other…",
+        placeholder: "Write your own answer",
+        maxLength: 4_000,
+    },
+});
+const approval = decision({
+    message: "Allow `git add hello.js`?",
+    summary: "Research Agent wants to run this outside the sandbox, as you.",
+    facts: [
+        { label: "Folder", value: "~/src/garden" },
+        { label: "Why", value: "“Git metadata is read-only”" },
+    ],
+    options: [
+        { value: "approve", label: "Approve once" },
+        { value: "always", label: "Always allow “git add” in this project…" },
+        { value: "deny", label: "Deny" },
+    ],
+    other: {
+        label: "Deny and say why…",
+        placeholder: "A short reason for the Agent (optional)",
+        maxLength: 512,
+        blank: "deny",
+    },
+});
+const confirmation = decision({
+    message: "Always allow “git add” in this project?",
+    summary: "Git hooks in this project can run code as you, and this Agent can add hooks.",
+    body: "Any Workspace Agent here can then run `git add …` without asking.",
+    options: [
+        { value: "back", label: "Back" },
+        { value: "always-allow", label: "Always allow “git add” and run it now" },
+    ],
+    escape: "back",
+});
+const start = {
+    highlight: 0,
+    toggled: new Set(),
+    other: "",
+    phase: "choose",
+    details: false,
+};
+/**
+ * The decisions every renderer must draw the same way. Each Parakeet renderer
+ * renders every fixture and holds its output to `decisionView`.
+ */
+export const awaitingFixtures = [
+    {
+        name: "single",
+        kind: "question",
+        prompt: storage,
+        state: start,
+        position: 1,
+        total: 1,
+    },
+    {
+        name: "multiple toggled",
+        kind: "question",
+        prompt: deliverables,
+        state: { ...start, highlight: 2, toggled: new Set(["Docs", "Examples"]) },
+        position: 1,
+        total: 1,
+    },
+    {
+        name: "other typing",
+        kind: "question",
+        prompt: storage,
+        state: { ...start, highlight: 2, other: "MySQL", phase: "other" },
+        position: 1,
+        total: 1,
+    },
+    {
+        name: "2 of 3",
+        kind: "question",
+        prompt: storage,
+        state: { ...start, highlight: 1 },
+        position: 2,
+        total: 3,
+    },
+    {
+        name: "sending",
+        kind: "question",
+        prompt: storage,
+        state: { ...start, phase: "sending" },
+        position: 1,
+        total: 1,
+    },
+    {
+        name: "refused",
+        kind: "question",
+        prompt: storage,
+        state: {
+            ...start,
+            phase: "refused",
+            refusal: "That question is already closed.",
+        },
+        position: 1,
+        total: 1,
+    },
+    {
+        name: "approval",
+        kind: "approval",
+        prompt: approval,
+        state: start,
+        position: 1,
+        total: 1,
+    },
+    {
+        name: "approval confirm",
+        kind: "approval",
+        prompt: confirmation,
+        state: start,
+        position: 1,
+        total: 2,
+    },
+    {
+        name: "approval refused",
+        kind: "approval",
+        prompt: approval,
+        state: {
+            ...start,
+            phase: "refused",
+            refusal: "This request changed. Look again before answering.",
+        },
+        position: 1,
+        total: 1,
+    },
+];

package/docs/api/README.md

@@ -19,6 +19,45 @@ type SlashParityCase = Readonly<{
 
 One input every renderer must complete identically.
 
+---
+
+### AwaitingFixtureState
+
+```ts
+type AwaitingFixtureState = Readonly<{
+  highlight: number;
+  toggled: ReadonlySet<string>;
+  other: string;
+  phase: "choose" | "other" | "confirm" | "sending" | "refused";
+  refusal?: string;
+  details: boolean;
+}>;
+```
+
+The state of one decision a fixture holds, shaped like the Parakeet reducer's.
+
+---
+
+### AwaitingFixture
+
+```ts
+type AwaitingFixture = Readonly<{
+  name: string;
+  kind: "question" | "approval";
+  prompt: Extract<
+    WhistlePrompt,
+    {
+      type: "decision";
+    }
+  >;
+  state: AwaitingFixtureState;
+  position: number;
+  total: number;
+}>;
+```
+
+One decision shown at one moment, held identically by every renderer's test.
+
 ## Variables
 
 ### idleActivity
@@ -81,6 +120,17 @@ The flow every renderer runs: `/water`, choose the fern bed, see the result.
 | <a id="property-choose"></a> `choose` | `"Fern bed"`              | `"Fern bed"`              |
 | <a id="property-notice"></a> `notice` | `"Watered the fern bed."` | `"Watered the fern bed."` |
 
+---
+
+### awaitingFixtures
+
+```ts
+const awaitingFixtures: readonly AwaitingFixture[];
+```
+
+The decisions every renderer must draw the same way. Each Parakeet renderer
+renders every fixture and holds its output to `decisionView`.
+
 ## Functions
 
 ### queuedActivity()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fungi.computer/parakeet-testing",
-  "version": "0.1.4",
+  "version": "0.2.1",
   "author": "Levi <levi@technomancy.dev>",
   "description": "Test-only garden extension and slash-parity fixtures for a typed Shiitake Session, shared by every Parakeet-protocol renderer's tests",
   "type": "module",
@@ -19,8 +19,8 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@fungi.computer/shiitake": "0.5.0",
-    "@fungi.computer/whistle": "0.2.0",
+    "@fungi.computer/shiitake": "0.7.0",
+    "@fungi.computer/whistle": "0.3.0",
     "zod": "4.4.3"
   },
   "devDependencies": {