@mccaskie-labs/workbench-ai 0.3.0 → 0.4.0

package/dist/styles.d.ts

@@ -0,0 +1,33 @@
+/** One CSS custom property the rules read, with its default. */
+export interface StyleVariable {
+    /** `--wb-<tool>-<what>`. */
+    name: string;
+    value: string;
+    about: string;
+}
+/** A rule for a class in another state, or for an element inside it. */
+export interface StyleState {
+    selector: string;
+    about: string;
+    css: string;
+}
+/** One class the tool puts on an element, with its default rule. */
+export interface StyleClass {
+    name: string;
+    element: string;
+    about: string;
+    css: string;
+    states?: readonly StyleState[];
+}
+/** Every class and variable the tool draws with (the same shape as workbench-ui's ToolStyles). */
+export interface ToolStyles {
+    format: 1;
+    tool: string;
+    package: string;
+    title: string;
+    prefix: string;
+    variables: readonly StyleVariable[];
+    classes: readonly StyleClass[];
+}
+/** The style hooks of the reply box (renderReplyBox, from '@mccaskie-labs/workbench-ai/reply-ui'). */
+export declare const REPLY_STYLES: ToolStyles;

package/dist/styles.js

@@ -0,0 +1,86 @@
+// The look the reply box starts with (docs/capabilities-manifest.md §10).
+// Every element renderReplyBox and REPLY_SCRIPT draw carries one of these
+// classes, and every class has a default rule here, so the box looks finished
+// out of the box and a project restyles it from its own CSS by the same names.
+// `npx workbench-ui styles` writes these into the project's
+// public/styles/workbench.css inside `@layer workbench`. The names are public:
+// renaming one is a breaking change.
+const v = (name) => `var(--wb-reply-${name})`;
+const focus = { selector: ":focus-visible", about: "Has focus", css: `outline:none;box-shadow:0 0 0 3px ${v("focus")}` };
+/** The style hooks of the reply box (renderReplyBox, from '@mccaskie-labs/workbench-ai/reply-ui'). */
+export const REPLY_STYLES = {
+    format: 1,
+    tool: "reply",
+    package: "@mccaskie-labs/workbench-ai",
+    title: "Reply box",
+    prefix: "wb-reply-",
+    variables: [
+        { name: "--wb-reply-text", value: "#e8e8ec", about: "Text of the draft, the buttons and the notes" },
+        { name: "--wb-reply-muted", value: "#9a9aa6", about: "Quieter text: the note box's hint, \"Copied\"" },
+        { name: "--wb-reply-surface", value: "#1b1b1f", about: "Background of the box and the draft" },
+        { name: "--wb-reply-line", value: "#33333b", about: "Borders of the box, the draft and the buttons" },
+        { name: "--wb-reply-accent", value: "#4c8dff", about: "The Copy button" },
+        { name: "--wb-reply-on-accent", value: "#ffffff", about: "Text on the Copy button" },
+        { name: "--wb-reply-warn", value: "#d9a441", about: "The edge of the \"check this one\" note" },
+        { name: "--wb-reply-focus", value: "rgba(76,141,255,.4)", about: "The ring round the field or button that has focus" },
+        { name: "--wb-reply-radius", value: "8px", about: "Corner rounding of the box, the draft and the buttons" },
+        { name: "--wb-reply-target", value: "2.75rem", about: "Least height of a button (a 44 px touch target)" },
+    ],
+    classes: [
+        {
+            name: "wb-reply",
+            element: "section",
+            about: "The whole box: the draft, Copy and Write it again",
+            css: `display:flex;flex-direction:column;gap:.6rem;max-width:36rem;padding:.75rem;color:${v("text")};background:${v("surface")};border:1px solid ${v("line")};border-radius:${v("radius")}`,
+        },
+        {
+            name: "wb-reply-check",
+            element: "p",
+            about: "\"Check this one before you send it\", and why, when the draft needs a person's eye",
+            css: `margin:0;padding:.4rem .6rem;border-left:3px solid ${v("warn")};font-size:.9rem`,
+        },
+        {
+            name: "wb-reply-text",
+            element: "textarea",
+            about: "The draft, ready to paste (it can be changed before copying)",
+            css: `box-sizing:border-box;width:100%;min-height:8rem;margin:0;padding:.6rem;font:inherit;line-height:1.5;color:${v("text")};background:${v("surface")};border:1px solid ${v("line")};border-radius:${v("radius")};resize:vertical`,
+            states: [focus],
+        },
+        { name: "wb-reply-actions", element: "div", about: "The Copy button and its status", css: "display:flex;flex-wrap:wrap;align-items:center;gap:.6rem" },
+        {
+            name: "wb-reply-copy",
+            element: "button",
+            about: "Copy reply",
+            css: `min-height:${v("target")};margin:0;padding:0 1.1rem;font:inherit;font-weight:600;color:${v("on-accent")};background:${v("accent")};border:0;border-radius:${v("radius")};cursor:pointer`,
+            states: [focus],
+        },
+        {
+            name: "wb-reply-copied",
+            element: "button",
+            about: "The Copy button just after it copied (a state class, taken off after a few seconds)",
+            css: `background:transparent;color:${v("accent")};box-shadow:inset 0 0 0 2px ${v("accent")}`,
+        },
+        { name: "wb-reply-status", element: "span", about: "\"Copied\", or \"Selected: press copy\" when the browser won't copy for the page", css: `color:${v("muted")};font-size:.9rem` },
+        {
+            name: "wb-reply-again",
+            element: "form",
+            about: "Write it again: a note and its button",
+            css: "display:flex;flex-wrap:wrap;gap:.5rem;margin:0",
+        },
+        {
+            name: "wb-reply-note",
+            element: "input",
+            about: "The note for the next draft (\"make it shorter\")",
+            css: `flex:1 1 12rem;min-height:${v("target")};box-sizing:border-box;margin:0;padding:0 .6rem;font:inherit;color:${v("text")};background:${v("surface")};border:1px solid ${v("line")};border-radius:${v("radius")}`,
+            states: [focus, { selector: "::placeholder", about: "The hint", css: `color:${v("muted")}` }],
+        },
+        {
+            name: "wb-reply-again-button",
+            element: "button",
+            about: "Write it again",
+            css: `min-height:${v("target")};margin:0;padding:0 1rem;font:inherit;color:${v("text")};background:transparent;border:1px solid ${v("line")};border-radius:${v("radius")};cursor:pointer`,
+            states: [focus],
+        },
+        { name: "wb-reply-error", element: "p", about: "Why there is no draft: \"We can't draft this one\"", css: "margin:0" },
+    ],
+};

package/dist/types.d.ts

@@ -1,5 +1,6 @@
 import type Anthropic from "@anthropic-ai/sdk";
 import type { WorkbenchEnv } from "@mccaskie-labs/workbench-config";
+import type { DraftWithTemplate, ReplyDraft, ReplyGuide, ReplyGuideName, ReplyRequest } from "./replies.ts";
 import type { OwnVoice, SpellingName, VoiceName } from "./writing.ts";
 export type SystemBlock = Anthropic.TextBlockParam;
 export type ContentBlockParam = Anthropic.ContentBlockParam;
@@ -13,6 +14,8 @@ export interface AiOptions {
     /** This install's Gateway address (`WORKBENCH_GATEWAY_URL`). There is no built-in one. */
     url: string;
     fetch?: typeof fetch;
+    /** The project's reply guides, `REPLY_GUIDES` from its generated `src/replies.generated.ts`, for `reply`. */
+    replyGuides?: Readonly<Record<string, ReplyGuide>>;
 }
 export interface TextRequest {
     /** A Workbench alias (`claude-default`, `claude-best`, `claude-fast`) or an allowlisted model id. */
@@ -131,6 +134,14 @@ export interface Ai {
     budget(): Promise<BudgetStatus>;
     /** Image generation and image search (step 4.8). The key needs the images or search scope. */
     readonly images: AiImages;
+    /**
+     * A ready-to-paste reply from facts and a reply guide (docs/capabilities/04-reply-drafter.md).
+     * The model places each fact as a token; the package fills and checks them, so a price or
+     * date the model typed fails the draft (retried once, then `needs_human_check`).
+     */
+    reply<G extends ReplyGuideName>(req: ReplyRequest<G>): Promise<ReplyDraft>;
+    /** As `reply`, with the token text the draft was filled from (what `replies pick` keeps). */
+    replyWithTemplate<G extends ReplyGuideName>(req: ReplyRequest<G>): Promise<DraftWithTemplate>;
 }
 export type AspectRatio = "1:1" | "3:2" | "2:3" | "4:3" | "3:4" | "16:9" | "9:16";
 export interface ImageGenerateRequest {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mccaskie-labs/workbench-ai",
-  "version": "0.3.0",
-  "description": "Claude through the Workbench Gateway: text, structured output, streaming and budget status, with no Anthropic key in the app. Refusals and truncations throw; createFakeAi for tests.",
+  "version": "0.4.0",
+  "description": "Claude through the Workbench Gateway: text, structured output, streaming, budget status and reply drafts whose facts are checked by code, with no Anthropic key in the app. Refusals and truncations throw; createFakeAi for tests.",
   "license": "UNLICENSED",
   "type": "module",
   "repository": {
@@ -18,6 +18,14 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./reply-ui": {
+      "types": "./dist/reply-ui.d.ts",
+      "default": "./dist/reply-ui.js"
+    },
+    "./styles": {
+      "types": "./dist/styles.d.ts",
+      "default": "./dist/styles.js"
+    },
     "./package.json": "./package.json"
   },
   "bin": {
@@ -39,7 +47,8 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^1.5.0",
-    "@mccaskie-labs/workbench-config": "^0.2.4"
+    "@mccaskie-labs/workbench-config": "^0.3.0",
+    "@mccaskie-labs/workbench-country": "^0.2.1"
   },
   "peerDependencies": {
     "zod": "^4.1.0"