makersclaw 0.3.2 → 0.4.0

package/r/search-dialog.json

@@ -5,7 +5,7 @@
   "title": "SearchDialog",
   "description": "One ⌘K search over every kind of record — chats, documents, images, projects, people. Before typing it shows your sections (Last opened, Recent); while typing, ranked matches with the typed text marked, a date, image thumbnails, and kind chips (All, Chats, Images…) to narrow them. Searches your list in the browser, or your server through an async onSearch. Built on the kit's Command; SearchPanel is the same box inline.",
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/makersclaw@0.3.2/r/core.json"
+    "https://cdn.jsdelivr.net/npm/makersclaw@0.4.0/r/core.json"
   ],
   "dependencies": [],
   "files": [
@@ -44,7 +44,7 @@
   "docs": "Installed to components/makersclaw/blocks/search-dialog. Import: import { SearchDialog, SearchPanel } from \"@/components/makersclaw/blocks/search-dialog\". Props and an example: components/makersclaw/blocks/search-dialog/README.md. Makersclaw builds whole apps from these blocks: https://makersclaw.com",
   "meta": {
     "makersclaw": {
-      "version": "0.3.2",
+      "version": "0.4.0",
       "useWhen": "An app has more than one kind of record and wants one global search box or ⌘K palette to find any of them, or a search page with type filters."
     }
   }

package/r/settings-list.json

@@ -5,7 +5,7 @@
   "title": "SettingsList",
   "description": "A card of settings, one row each — icon, label, description, meta lines, a badge, and its control: a Switch, a Select, a Button, a remove button or a menu of actions, with optional details that open under the row. Every change saves on its own through an async callback; the row shows the new value at once, a spinner while it saves, and on failure the old value back with the reason and Try again. variant=\"matrix\" is the notification grid: events by group down the side, channels (email, push, SMS) across, a switch per cell, stacked on a phone.",
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/makersclaw@0.3.2/r/core.json"
+    "https://cdn.jsdelivr.net/npm/makersclaw@0.4.0/r/core.json"
   ],
   "dependencies": [],
   "files": [
@@ -59,7 +59,7 @@
   "docs": "Installed to components/makersclaw/blocks/settings-list. Import: import { SettingsList } from \"@/components/makersclaw/blocks/settings-list\". Props and an example: components/makersclaw/blocks/settings-list/README.md. Makersclaw builds whole apps from these blocks: https://makersclaw.com",
   "meta": {
     "makersclaw": {
-      "version": "0.3.2",
+      "version": "0.4.0",
       "useWhen": "An account or workspace settings screen where each setting applies the moment it is changed: preferences, two-step sign-in methods, signed-in devices, connected integrations, billing profiles, notification preferences per channel. Not for a form of fields saved together with one button (record-form)."
     }
   }

package/r/setup-checklist.json

@@ -5,7 +5,7 @@
   "title": "SetupChecklist",
   "description": "The steps to get set up: which are done, how far along the whole is (a ring, a bar, or \"Step 2 of 4\"), and the button for the next one, sent out through an async onAction that can fail on the step. Four shapes: folding rows in a card with a dismiss menu, numbered step cards, a plain step list with a help panel, and bordered accordion rows that can be locked until the step before is done.",
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/makersclaw@0.3.2/r/core.json"
+    "https://cdn.jsdelivr.net/npm/makersclaw@0.4.0/r/core.json"
   ],
   "dependencies": [],
   "files": [
@@ -44,7 +44,7 @@
   "docs": "Installed to components/makersclaw/blocks/setup-checklist. Import: import { SetupChecklist } from \"@/components/makersclaw/blocks/setup-checklist\". Props and an example: components/makersclaw/blocks/setup-checklist/README.md. Makersclaw builds whole apps from these blocks: https://makersclaw.com",
   "meta": {
     "makersclaw": {
-      "version": "0.3.2",
+      "version": "0.4.0",
       "useWhen": "A new account, workspace or shop has a few things to do before it is useful (complete the profile, invite the team, connect a tool, launch) and the founder should see what is left. Not for a running job's stages (kit Steps or job-panel), and not for a multi-page form wizard."
     }
   }

package/r/share-dialog.json

@@ -5,7 +5,7 @@
   "title": "ShareDialog",
   "description": "Who can see a record and how to let more people in: invite by email (comma separated, with an access level), each person with their access in a menu (can view, can edit, remove), sharing switches, and a link with a copy button that turns to a check. A dialog, or the same body inline (SharePanel). Every change is an async callback; a failure shows and the old value comes back.",
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/makersclaw@0.3.2/r/core.json"
+    "https://cdn.jsdelivr.net/npm/makersclaw@0.4.0/r/core.json"
   ],
   "dependencies": [],
   "files": [
@@ -45,7 +45,7 @@
   "docs": "Installed to components/makersclaw/blocks/share-dialog. Import: import { ShareDialog, SharePanel } from \"@/components/makersclaw/blocks/share-dialog\". Props and an example: components/makersclaw/blocks/share-dialog/README.md. Makersclaw builds whole apps from these blocks: https://makersclaw.com",
   "meta": {
     "makersclaw": {
-      "version": "0.3.2",
+      "version": "0.4.0",
       "useWhen": "A record, project, document or workspace can be shared: an \"Invite\" or \"Share\" button, a members list with roles, a public link to copy."
     }
   }

package/r/sidebar.json

@@ -5,7 +5,7 @@
   "title": "Sidebar",
   "description": "An app's navigation down the left edge: app name or workspace switcher, groups of items with icons, counts and nested items, the signed-in person with their menu; collapses to icons (remembered) and becomes a Sheet behind a trigger on a phone. Optional: inset or floating look, a ⌘K search over every item, folding groups with colour dots, a second column (a mail list, or a parent's children to drill into), a \"New\" button and a \"…\" menu per item (a chat history).",
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/makersclaw@0.3.2/r/core.json"
+    "https://cdn.jsdelivr.net/npm/makersclaw@0.4.0/r/core.json"
   ],
   "dependencies": [],
   "files": [
@@ -62,7 +62,7 @@
   "docs": "Installed to components/makersclaw/blocks/sidebar. Import: import { Sidebar, SidebarLayout, SidebarTrigger, useSidebar } from \"@/components/makersclaw/blocks/sidebar\". Props and an example: components/makersclaw/blocks/sidebar/README.md. Makersclaw builds whole apps from these blocks: https://makersclaw.com",
   "meta": {
     "makersclaw": {
-      "version": "0.3.2",
+      "version": "0.4.0",
       "useWhen": "An app with more than a handful of places to go (inbox, deals, contacts, reports, settings, projects) that wants a real app shell: compose it in app/shell.jsx around the surfaces. Not for in-page tabs (Tabs) or a short strip of links."
     }
   }

package/r/signature-pad.json

@@ -5,7 +5,7 @@
   "title": "SignaturePad",
   "description": "A signature field (signature_pad) in the workspace theme: a full-name field, then draw on a paper box (smooth pen strokes, undo the last stroke, clear with Undo) or type the name set as a signature. Sign returns a record: a cropped transparent PNG in dark ink, the typed name, the mode and the time; the signed view shows it with Sign again. Works as a form field too, through a handle (toPNG, getSignature).",
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/makersclaw@0.3.2/r/core.json"
+    "https://cdn.jsdelivr.net/npm/makersclaw@0.4.0/r/core.json"
   ],
   "dependencies": [
     "signature_pad@5.1.4"
@@ -65,7 +65,7 @@
   "docs": "Installed to components/makersclaw/blocks/signature-pad. Import: import { SignaturePad, useSignaturePad, signatureRecord, formatSignedAt } from \"@/components/makersclaw/blocks/signature-pad\". Props and an example: components/makersclaw/blocks/signature-pad/README.md. Makersclaw builds whole apps from these blocks: https://makersclaw.com",
   "meta": {
     "makersclaw": {
-      "version": "0.3.2",
+      "version": "0.4.0",
       "useWhen": "A screen needs someone to sign: accepting a proposal or a quote, a delivery or work-done sign-off, a waiver, a consent form, an approval on a record. The proposal-accept block is built on it. It records an acceptance with a picture of the signature — it is not a certified legal e-signature (no identity check, no audit trail beyond what you store)."
     }
   }

package/r/sketch-canvas.json

@@ -5,7 +5,7 @@
   "title": "SketchCanvas",
   "description": "A freeform drawing canvas (Excalidraw) in the workspace theme: a Miro-style tool rail (select, pan, draw, shapes, arrows, text, image, eraser, frames), a floating toolbar over the selection with colours from the theme's tokens, zoom and undo controls, a friendly empty state, and stamp tools that place ready-made drawings (UI wireframe pieces built in). Optional locked background image for annotating a screenshot. The sketch is plain JSON; helpers read its words for an agent, and the handle exports a PNG.",
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/makersclaw@0.3.2/r/core.json"
+    "https://cdn.jsdelivr.net/npm/makersclaw@0.4.0/r/core.json"
   ],
   "dependencies": [
     "@excalidraw/excalidraw@0.18.1"
@@ -92,7 +92,7 @@
   "docs": "Installed to components/makersclaw/blocks/sketch-canvas. Import: import { SketchCanvas, useSketchCanvas, SKETCH_TOOLS, WIREFRAME_STAMPS, STROKES, FILLS, emptySketch, isSketchEmpty, sketchToText, sketchItems, toSketch } from \"@/components/makersclaw/blocks/sketch-canvas\". Props and an example: components/makersclaw/blocks/sketch-canvas/README.md. Makersclaw builds whole apps from these blocks: https://makersclaw.com",
   "meta": {
     "makersclaw": {
-      "version": "0.3.2",
+      "version": "0.4.0",
       "useWhen": "A screen needs freehand drawing: a whiteboard, marking up a screenshot, sketching a UI wireframe, a diagram drawn by hand. The whiteboard, annotate and sketch-to-app blocks are built on it. Not for structured boards of cards and connectors (flow-canvas), charts (chart) or a kanban (board)."
     }
   }

package/r/spreadsheet.json

@@ -5,7 +5,7 @@
   "title": "Spreadsheet",
   "description": "A table you edit like Google Sheets or Airtable, virtualised for 10,000+ rows: typed columns (text, number, currency, date, single and multiple select, person, checkbox, link, rating) each with its own in-cell editor, a cell cursor and range selection with the mouse and arrow keys, typing to edit, copy and paste ranges as TSV (to and from Sheets and Excel), drag-to-fill and ⌘D fill down, undo/redo, column resize, drag to reorder, hide, freeze, rename, change type and add fields, row insert and delete with Undo, sort and filter panels, search, a sum/average of the selection, validation marks, and a phone layout. Edits go out as async callbacks answering { ok }, applied at once and rolled back on failure. A column-type registry and an imperative handle for blocks built on it.",
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/makersclaw@0.3.2/r/core.json"
+    "https://cdn.jsdelivr.net/npm/makersclaw@0.4.0/r/core.json"
   ],
   "dependencies": [
     "@tanstack/react-virtual@3.14.13"
@@ -83,7 +83,7 @@
   "docs": "Installed to components/makersclaw/blocks/spreadsheet. Import: import { Spreadsheet, CellValue, CellPanel, OptionBadge, editorFor, TYPE_ORDER, sortWords, COLUMN_TYPES, typeOf, parseCell, convertValue, guessType, parseNumberText, parseDateText, optionValue, isBlank, emptyView, normalizeView, orderedColumns, visibleColumns, processRows, passesFilters, parseTSV, toTSV, pasteChanges, fillChanges, clearChanges, applyChanges, invertChanges } from \"@/components/makersclaw/blocks/spreadsheet\". Props and an example: components/makersclaw/blocks/spreadsheet/README.md. Makersclaw builds whole apps from these blocks: https://makersclaw.com",
   "meta": {
     "makersclaw": {
-      "version": "0.3.2",
+      "version": "0.4.0",
       "useWhen": "People need to enter or clean up many records in a grid, fast, with the keyboard: a lead list, an inventory, a budget, a content calendar, a table view over any collection, the grid under an Airtable-like base. Not for a read-mostly list to scan and act on row by row (data-table), records moving through stages (board), or a single record (record-form)."
     }
   }

package/r/stat-cards.json

@@ -5,8 +5,8 @@
   "title": "Stat cards",
   "description": "A row of key numbers, each with its name and its change: one bordered strip, or a card each with a change in the corner or after the value, a \"from\" value, a status dot and a goal meter, a sparkline, a \"View more\" footer; or a usage tile per amount against its limit (a bar or a ring, a split by kind with what is free, a warning line near the cap, an action and a limit the founder can change); or a plain list of values with their change. Loading, empty and error states.",
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/makersclaw@0.3.2/r/core.json",
-    "https://cdn.jsdelivr.net/npm/makersclaw@0.3.2/r/chart.json"
+    "https://cdn.jsdelivr.net/npm/makersclaw@0.4.0/r/core.json",
+    "https://cdn.jsdelivr.net/npm/makersclaw@0.4.0/r/chart.json"
   ],
   "dependencies": [],
   "files": [
@@ -59,7 +59,7 @@
   "docs": "Installed to components/makersclaw/blocks/stat-cards. Import: import { StatCards } from \"@/components/makersclaw/blocks/stat-cards\". Props and an example: components/makersclaw/blocks/stat-cards/README.md. Makersclaw builds whole apps from these blocks: https://makersclaw.com",
   "meta": {
     "makersclaw": {
-      "version": "0.3.2",
+      "version": "0.4.0",
       "useWhen": "The few numbers at the top of a dashboard or a report: revenue, users, conversion, spend against budget, seats and storage against a plan. Not for a trend worth reading on its own (a chart), many rows of records (a table), or one subject scored against thresholds (a scorecard)."
     }
   }

package/r/task-list.json

@@ -5,8 +5,8 @@
   "title": "Task list",
   "description": "The List view of work, like ClickUp's or Linear's: tasks under headings that fold (group by status, assignee, priority, project, due date or any field), a round check to complete each, the title edited in place, subtasks indented under their parent with their own fold, the fields you choose (assignees, due date, priority, tags, project, estimate) as inline pickers, a quick-add row at the end of every group, drag to reorder and to move between groups (saving the new status, assignee or due date), multi-select with a bulk bar (status, assign, due, priority, delete with undo), a toolbar with search, filter chips, group by, sort and fields, and friendly empty states with starter templates. One async onChange saves every change; failures roll back with a notice.",
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/makersclaw@0.3.2/r/core.json",
-    "https://cdn.jsdelivr.net/npm/makersclaw@0.3.2/r/task-model.json"
+    "https://cdn.jsdelivr.net/npm/makersclaw@0.4.0/r/core.json",
+    "https://cdn.jsdelivr.net/npm/makersclaw@0.4.0/r/task-model.json"
   ],
   "dependencies": [],
   "files": [
@@ -56,7 +56,7 @@
   "docs": "Installed to components/makersclaw/blocks/task-list. Import: import { TaskList } from \"@/components/makersclaw/blocks/task-list\". Props and an example: components/makersclaw/blocks/task-list/README.md. Makersclaw builds whole apps from these blocks: https://makersclaw.com",
   "meta": {
     "makersclaw": {
-      "version": "0.3.2",
+      "version": "0.4.0",
       "useWhen": "A screen that lists work to get done and moves it along: a team's tasks, a launch checklist, a sprint, a personal to-do list, onboarding steps, content to publish. Not for records that are not work (data-table), for stage columns side by side (board), or for dates on a grid (calendar)."
     }
   }

package/r/task-model.json

@@ -5,7 +5,7 @@
   "title": "Task model",
   "description": "The shared work-item model every task view reads: one task shape (status, assignees, start/due, estimate, progress, priority, parent, dependencies, location, tags, project, extra fields) with statuses, people and projects; pure helpers to search, filter, group by any field, sort, nest subtasks, do date math (week and month grids, working days, overlaps, time scales), sum capacity per person, follow dependencies and the critical path, and apply, undo and persist changes; the shared parts (StatusPill, AssigneeStack, DueLabel, PriorityFlag, TaskChip, CompleteToggle), the ViewToolbar (search, filter chips, group by, sort, show fields), drag primitives on @dnd-kit, a hook for optimistic saves with rollback and undo, and adapters that drive the Board and DataTable blocks from tasks.",
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/makersclaw@0.3.2/r/core.json"
+    "https://cdn.jsdelivr.net/npm/makersclaw@0.4.0/r/core.json"
   ],
   "dependencies": [
     "@dnd-kit/core@6.3.1",
@@ -91,7 +91,7 @@
   "docs": "Installed to components/makersclaw/blocks/task-model. Import: import { NONE, PRIORITIES, DEFAULT_STATUSES, TASK_FIELDS, DEFAULT_VIEW, normalizeTask, normalizeTasks, createTaskContext, fieldOf, isDone, doneStatusId, openStatusId, toggleDoneChange, newTaskId, draftTask, valuesOf, optionsOf, labelOf, searchText, searchTasks, filterTasks, orderOf, sortTasks, sortOptions, groupTasks, groupOptions, movePatch, applyView, activeFilterCount, rankBetween, placeChange, childrenMap, buildTree, flattenTree, descendantIds, ancestorIds, subtaskCounts, rollup, progressOf, dependencyEdges, blockersOf, wouldCycle, dateConflicts, criticalPath, hoursPerDay, workload, sumOf, applyChange, invertChange, changeWrites, changedIds, deleteChange, toBoard, toTableRows, taskFacets, StatusPill, CompleteToggle, AssigneeStack, PersonLabel, DueLabel, PriorityFlag, TagList, SubtaskCount, ProgressLine, TaskChip, GroupLabel, taskColumns, TONE_TEXT, HUE_EDGE, HUE_BG, TaskDragProvider, SortableGroup, useSortableTask, useDraggableTask, useDropTarget, DragHandle, DropLine, LIFTED, useReducedMotion, arrayMove, isDay, dayNumber, fromDayNumber, dayOf, minutesOf, withTime, todayDay, addDays, diffDays, weekdayOf, startOfWeek, endOfWeek, weekDays, startOfMonth, endOfMonth, addMonths, daysBetween, monthGrid, WEEKEND, isWeekend, isWorkingDay, workingDaysBetween, addWorkingDays, spanOf, spansOverlap, tasksInRange, tasksOnDay, shiftDates, spanPatch, dueBucket, DUE_BUCKETS, dayForBucket, formatDay, formatTime, formatDate, timeScale, rangeOfTasks, isNewId } from \"@/components/makersclaw/blocks/task-model\". Props and an example: components/makersclaw/blocks/task-model/README.md. Makersclaw builds whole apps from these blocks: https://makersclaw.com",
   "meta": {
     "makersclaw": {
-      "version": "0.3.2",
+      "version": "0.4.0",
       "useWhen": "You are building a view of work items — a list, calendar, gantt, workload, roadmap or a switcher between them — or driving Board / DataTable from tasks. Views import it; a surface rarely renders it alone. Not for records that are not work (use data-table or board directly)."
     }
   }

package/r/testimonials.json

@@ -5,7 +5,7 @@
   "title": "Testimonials",
   "description": "A marketing section of customer quotes: name, role, company, face or logo, the quote, an optional star rating, a verified mark and a \"view on X\" source, and optional headline numbers (stats). Layouts: a grid of cards (plain, card or raised; hover can light one and dim the rest; a \"write a review\" tile), one large quote, a switcher of faces, and a carousel, optionally over a picture.",
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/makersclaw@0.3.2/r/core.json"
+    "https://cdn.jsdelivr.net/npm/makersclaw@0.4.0/r/core.json"
   ],
   "dependencies": [],
   "files": [
@@ -45,7 +45,7 @@
   "docs": "Installed to components/makersclaw/blocks/testimonials. Import: import { Testimonials } from \"@/components/makersclaw/blocks/testimonials\". Props and an example: components/makersclaw/blocks/testimonials/README.md. Makersclaw builds whole apps from these blocks: https://makersclaw.com",
   "meta": {
     "makersclaw": {
-      "version": "0.3.2",
+      "version": "0.4.0",
       "useWhen": "Social proof on a public page: a landing page, a pricing page, a product page, a case-study teaser. Not for reviews a signed-in user writes and manages (a record list or form), or an app's own activity feed."
     }
   }

package/r/transaction-list.json

@@ -5,7 +5,7 @@
   "title": "TransactionList",
   "description": "Money records as a plain list, in two variants: history (payments in and out, grouped by month, a received / paid / pending / failed mark and a signed amount) and invoices (number, date, a Paid / Due in N days / N days overdue badge, amount, download). Optional date-range filter, Export and per-row download. Empty, loading and error states built in.",
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/makersclaw@0.3.2/r/core.json"
+    "https://cdn.jsdelivr.net/npm/makersclaw@0.4.0/r/core.json"
   ],
   "dependencies": [],
   "files": [
@@ -46,7 +46,7 @@
   "docs": "Installed to components/makersclaw/blocks/transaction-list. Import: import { TransactionList } from \"@/components/makersclaw/blocks/transaction-list\". Props and an example: components/makersclaw/blocks/transaction-list/README.md. Makersclaw builds whole apps from these blocks: https://makersclaw.com",
   "meta": {
     "makersclaw": {
-      "version": "0.3.2",
+      "version": "0.4.0",
       "useWhen": "A billing page's invoices, an account's payment history, a wallet's recent activity: records read top to bottom, newest first. Not for records the founder sorts, filters by column or totals (data-table), or for one order (order-detail)."
     }
   }

package/r/whiteboard.json

@@ -5,8 +5,8 @@
   "title": "Whiteboard",
   "description": "A full-page freeform whiteboard on sketch-canvas: a top bar with the board's title (click to rename), the save state (Saving…, Saved, or the error with Retry), a Board / Text view switch, Export PNG and an optional Share button; under it the Miro-style canvas (tool rail, floating toolbar, zoom, undo). An empty board offers starter templates — blank, a grid of titled areas, a 2×2 matrix — and the Text view lists every word on the board for a screen reader or an agent. With onCreateTask, a selected note or text becomes a task from the top bar (\"Create task\", editable title; several notes make one task each), and a small badge marks it on the board from then on. The sketch is plain JSON; saves are async callbacks answering { ok }.",
   "registryDependencies": [
-    "https://cdn.jsdelivr.net/npm/makersclaw@0.3.2/r/core.json",
-    "https://cdn.jsdelivr.net/npm/makersclaw@0.3.2/r/sketch-canvas.json"
+    "https://cdn.jsdelivr.net/npm/makersclaw@0.4.0/r/core.json",
+    "https://cdn.jsdelivr.net/npm/makersclaw@0.4.0/r/sketch-canvas.json"
   ],
   "dependencies": [],
   "files": [
@@ -59,7 +59,7 @@
   "docs": "Installed to components/makersclaw/blocks/whiteboard. Import: import { Whiteboard, WHITEBOARD_TEMPLATES, gridSketch, matrixSketch } from \"@/components/makersclaw/blocks/whiteboard\". Props and an example: components/makersclaw/blocks/whiteboard/README.md. Makersclaw builds whole apps from these blocks: https://makersclaw.com",
   "meta": {
     "makersclaw": {
-      "version": "0.3.2",
+      "version": "0.4.0",
       "useWhen": "A screen is one board to think on: a team whiteboard, a planning or prioritisation board, a place to sketch an idea and keep it with a record. Not for marking up a screenshot (annotate), sketching a UI to build (sketch-to-app), a structured board of cards and connectors (flow-canvas), or a kanban (board)."
     }
   }

package/registry/blocks/job-panel/README.md

@@ -6,6 +6,13 @@ then "done" (closing itself a few seconds later) or the reason it
 stopped. When no job runs it renders nothing — a panel that is always
 there is a monitoring console, and apps do not have one.
 
+The conversation is not here. Since 0.4.0 a job is a request, and its
+conversation lives in the desk's agent column: the agent's questions,
+the founder's answers and the yes before it acts are all there. The
+panel says where the work is and points there — "Needs your answer"
+with an Answer button when the agent waits on the founder, "Queued ·
+after …" when it waits its turn.
+
 ```jsx
 import { JobPanel } from "../components/blocks/job-panel";   // a Makersclaw app ("./blocks/job-panel" from components/)
 import { JobPanel } from "@/components/makersclaw/blocks/job-panel";   // a shadcn project
@@ -26,11 +33,16 @@ pass those rows back in as `results`.
 - `job` — what `useJob()` returns. Required. Outside Makersclaw, any
   object of the same shape: `running`, `steps` (`[{ name, label, status:
   "running" | "done" | "failed" }]`), `text`, `error`, `finishedAt`, and
-  `cancel()` / `reset()`.
+  `cancel()` / `reset()`. Optional, read when present (useJob sets them
+  since 0.4.0): `needsYou`, `queued`, `queuedAfter` (`{ after_title }`)
+  and `open()` — see "Needs you and queued" below. An object without
+  them (the 0.3.x shape) draws exactly as before.
 - `title` — while it runs, what the agent is doing, in the founder's
   words: `"Drafting the launch plan"`. Default `"Working on it"`.
 - `doneTitle` — after a clean finish: `"Launch plan drafted"`.
 - `failedTitle` — when it stopped with an error; the error follows it.
+- `needsTitle` — while the agent waits on the founder's answer. Default
+  `"Needs your answer"`.
 - `onRetry` — shows "Try again" beside Close when the job failed: start
   the same job again.
 - `autoClose` — milliseconds after a clean finish before the panel
@@ -40,12 +52,15 @@ pass those rows back in as `results`.
   "N earlier steps" line.
 - `showText` — the agent's own account under the steps, default true. It
   is what the agent says it did, never the result: the result is rows.
+  It hides itself when `job.text` is empty, as it is on a request: the
+  account is in the desk's agent column.
 - `className` — layout around it. Never colour.
 
 ### The generator (`variant="generator"`)
 
-Everything above (`job`, `title`, `doneTitle`, `failedTitle`, `onRetry`,
-`autoClose`, `maxSteps`, `showText`) goes to the panel inside it. Then:
+Everything above (`job`, `title`, `doneTitle`, `failedTitle`,
+`needsTitle`, `onRetry`, `autoClose`, `maxSteps`, `showText`) goes to the
+panel inside it. Then:
 
 - `onGenerate(prompt)` — start the job. Build the ask from the prompt and
   your options and call `job.start(ask)`; return what it returns, or
@@ -72,6 +87,28 @@ Everything above (`job`, `title`, `doneTitle`, `failedTitle`, `onRetry`,
 - `layout` — `"stacked"` (default: the form, then the shelf) or
   `"split"` (side by side from lg up; stacked on a phone).
 
+## Needs you and queued
+
+A request can be live and still not moving. The panel draws two such
+states from the job, and both count as running: no Close, Generate
+stays off, and the panel stays until the job moves on.
+
+- **Needs you** (`job.needsYou`) — the agent stopped to ask the founder
+  something, or for a yes before it acts. The heading is `needsTitle`
+  ("Needs your answer"), the panel takes the warning tone, a line says
+  the question is in the agent column, and **Answer** takes Stop's
+  place: it calls `job.open()`, which opens the request's conversation
+  in the desk's agent column. The founder answers there (or stops it
+  there), never in the app; the job then runs on and the panel follows
+  it. A job with no `open()` has nowhere to point, so Stop stays.
+- **Queued** (`job.queued`) — one job per list runs at a time, so this
+  one waits behind another. The heading names the job it waits for:
+  "Queued · after Find 20 leads" (`job.queuedAfter.after_title`, else
+  "the job before it"). Stop stays: it takes the job out of the queue.
+
+When it runs again the heading is back to `title`, and the one step
+under it is the request's line ("Drafting · 12 of 50").
+
 ## Example
 
 ```jsx

package/registry/blocks/job-panel/block.json

@@ -1,9 +1,9 @@
 {
   "name": "job-panel",
   "title": "JobPanel",
-  "description": "The panel that follows work the founder asked the app's agent for (useJob): each step's label as it runs, Stop, then done or the reason it stopped — and nothing on screen when no job runs. variant=\"generator\" wraps it in a prompt, the surface's options, Generate and a results shelf, with no model, provider or API key of its own.",
+  "description": "The panel that follows work the founder asked the app's agent for (useJob): each step's label as it runs, Stop, \"Needs your answer\" with Answer while the agent waits on the founder, \"Queued · after …\" while it waits its turn, then done or the reason it stopped — and nothing on screen when no job runs. variant=\"generator\" wraps it in a prompt, the surface's options, Generate and a results shelf, with no model, provider or API key of its own.",
   "useWhen": "A surface has a verb that asks the agent to make or find something (\"Generate a launch plan\", \"Find 20 leads\", \"Plan next sprint\") and the founder should watch it happen where the result will land. variant=\"generator\" when the screen IS the place to ask: a prompt and a few options, the results under them (product photos, ad copy, names).",
-  "tags": ["job", "agent", "generate", "progress", "steps", "running", "working", "commission", "ai", "stop", "status", "generator", "prompt", "results", "image", "studio"],
+  "tags": ["job", "agent", "generate", "progress", "steps", "running", "working", "commission", "ai", "stop", "status", "queued", "needs-you", "answer", "generator", "prompt", "results", "image", "studio"],
   "exports": ["JobPanel"],
   "files": ["index.js", "job-panel.jsx"],
   "requires": []

package/registry/blocks/job-panel/demo.jsx

@@ -2,7 +2,10 @@
 
 // JobPanel driven by a pretend job — the gallery's and the smoke test's
 // surface. Not installed into apps. Three variants behind the switcher:
-//   Panel    the panel under a verb; one run succeeds, one fails
+//   Panel    the panel under a verb; one run succeeds, one fails (both
+//            the 0.3.x shape), one waits its turn (queued), one stops
+//            to ask the founder (needsYou) — the last two a request's
+//            shape, the way useJob follows one since 0.4.0
 //   Photos   variant="generator", stacked: a prompt, size and style, a
 //            grid of results
 //   Copy     variant="generator", split: ad headlines as text results,
@@ -14,6 +17,24 @@ import { JobPanel } from "../components/blocks/job-panel";
 const STEPS = ["Reading the product list", "Searching the web", "Drafting the plan", "Saving 6 tasks"];
 const IDLE = { running: false, steps: [], text: "", error: null, finishedAt: null, progress: 0 };
 
+const CLOSED = new Set(["done", "stopped", "didnt_finish"]);
+
+// A request as useJob draws it since 0.4.0: one step, the request's line,
+// and no text — the agent's account is in the desk's agent column.
+function request(status, line, more = {}) {
+  return {
+    running: !CLOSED.has(status),
+    status,
+    queued: status === "queued",
+    queuedAfter: null,
+    needsYou: status === "needs_you",
+    liveLine: line,
+    steps: [{ name: "request", label: line, status: CLOSED.has(status) ? "done" : "running" }],
+    text: "",
+    ...more,
+  };
+}
+
 function usePretendJob() {
   const [state, setState] = useState(IDLE);
   const timers = useRef([]);
@@ -23,8 +44,34 @@ function usePretendJob() {
   };
   useEffect(() => clear, []);
   const later = (ms, fn) => timers.current.push(setTimeout(fn, ms));
-  function start(fail) {
+  const moved = (next) => setState((s) => ({ ...s, ...next, progress: s.progress + 1 }));
+
+  // The work after the wait: counted progress, then a result.
+  function draft(from) {
+    for (let n = 0; n <= 6; n += 1) later(from + 450 * n, () => moved(request("working", `Drafting the plan · ${n} of 6`, { count: n, target: 6 })));
+    later(from + 450 * 6 + 500, () => moved({ ...request("done", "6 tasks saved to Launches"), finishedAt: new Date().toISOString() }));
+  }
+
+  // kind: "ok" | "fails" (the 0.3.x shape: steps and text) · "queued" |
+  // "asks" (a request's shape).
+  function start(kind = "ok") {
     clear();
+    if (kind === "queued") {
+      setState({
+        ...IDLE,
+        ...request("queued", "Queued · after Find 20 leads", {
+          queuedAfter: { reason: "job", after_id: "req_leads", after_title: "Find 20 leads" },
+        }),
+      });
+      draft(2800);
+      return;
+    }
+    if (kind === "asks") {
+      setState({ ...IDLE, ...request("working", "Reading the product list") });
+      later(1200, () => moved(request("needs_you", "Needs you · Which launch should the plan cover?")));
+      return;
+    }
+    const fail = kind === "fails";
     setState({ ...IDLE, running: true });
     STEPS.forEach((label, i) =>
       later(700 * i + 200, () =>
@@ -53,12 +100,28 @@ function usePretendJob() {
     start,
     cancel: () => {
       clear();
-      setState((s) => ({ ...s, running: false, finishedAt: new Date().toISOString() }));
+      setState((s) => ({
+        ...s,
+        running: false,
+        queued: false,
+        needsYou: false,
+        status: s.status ? "stopped" : s.status,
+        finishedAt: new Date().toISOString(),
+      }));
     },
     reset: () => {
       clear();
       setState(IDLE);
     },
+    // In an app this opens the question in the desk's agent column. The
+    // gallery has no desk, so the answer is pretended and the work goes on.
+    open: () => {
+      if (!state.needsYou) return false;
+      clear();
+      moved(request("working", "Drafting the plan"));
+      draft(900);
+      return true;
+    },
   };
 }
 
@@ -67,14 +130,20 @@ function PanelDemo() {
   return (
     <div className="grid max-w-xl gap-4">
       <div className="flex flex-wrap gap-2">
-        <Button variant="secondary" onClick={() => job.start(false)} disabled={job.running}>
+        <Button variant="secondary" onClick={() => job.start("ok")} disabled={job.running}>
           Generate a launch plan
         </Button>
-        <Button variant="quiet" onClick={() => job.start(true)} disabled={job.running}>
+        <Button variant="quiet" onClick={() => job.start("fails")} disabled={job.running}>
           Run one that fails
         </Button>
+        <Button variant="quiet" onClick={() => job.start("queued")} disabled={job.running}>
+          Queue one behind another
+        </Button>
+        <Button variant="quiet" onClick={() => job.start("asks")} disabled={job.running}>
+          Run one that asks
+        </Button>
       </div>
-      <JobPanel job={job} title="Drafting the launch plan" doneTitle="Launch plan drafted" onRetry={() => job.start(false)} />
+      <JobPanel job={job} title="Drafting the launch plan" doneTitle="Launch plan drafted" onRetry={() => job.start("ok")} />
     </div>
   );
 }