@whity/ui 0.5.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (208) hide show
  1. package/README.md +107 -107
  2. package/package.json +223 -192
  3. package/src/access-denied.stories.tsx +179 -179
  4. package/src/access-denied.tsx +305 -305
  5. package/src/action-proposal.tsx +338 -302
  6. package/src/actor-chip.tsx +71 -71
  7. package/src/agent-activity.tsx +163 -163
  8. package/src/agent-collaboration.stories.tsx +156 -156
  9. package/src/agent-run-status.tsx +196 -196
  10. package/src/alert-dialog.stories.tsx +45 -45
  11. package/src/alert-dialog.tsx +147 -147
  12. package/src/alert.stories.tsx +91 -91
  13. package/src/alert.tsx +89 -89
  14. package/src/app-sidebar.stories.tsx +195 -195
  15. package/src/app-sidebar.tsx +604 -500
  16. package/src/approval-queue.tsx +109 -108
  17. package/src/audience-group-picker.stories.tsx +198 -198
  18. package/src/audience-group-picker.tsx +362 -362
  19. package/src/audience-people-picker.stories.tsx +102 -102
  20. package/src/audience-people-picker.tsx +279 -279
  21. package/src/avatar-pattern.ts +138 -0
  22. package/src/avatar.tsx +125 -83
  23. package/src/badge.stories.tsx +105 -105
  24. package/src/badge.tsx +68 -68
  25. package/src/beta-warning.stories.tsx +79 -79
  26. package/src/beta-warning.tsx +189 -189
  27. package/src/bilingual-input.stories.tsx +82 -82
  28. package/src/bilingual-input.tsx +188 -183
  29. package/src/board.tsx +216 -0
  30. package/src/breadcrumb.stories.tsx +51 -51
  31. package/src/breadcrumb.tsx +90 -90
  32. package/src/built-on-whity.tsx +52 -0
  33. package/src/button.stories.tsx +87 -87
  34. package/src/button.tsx +125 -118
  35. package/src/card.stories.tsx +423 -423
  36. package/src/card.tsx +180 -180
  37. package/src/chart.stories.tsx +66 -66
  38. package/src/chart.tsx +228 -228
  39. package/src/checkbox.stories.tsx +62 -62
  40. package/src/checkbox.tsx +54 -54
  41. package/src/collapsible.stories.tsx +48 -48
  42. package/src/collapsible.tsx +34 -34
  43. package/src/color-card.stories.tsx +61 -61
  44. package/src/color-card.tsx +270 -270
  45. package/src/color-picker.stories.tsx +65 -65
  46. package/src/color-picker.tsx +425 -425
  47. package/src/column-matcher.tsx +84 -0
  48. package/src/command-palette.tsx +399 -306
  49. package/src/confirm-action.tsx +98 -0
  50. package/src/copy-block.stories.tsx +38 -38
  51. package/src/copy-block.tsx +85 -85
  52. package/src/data-table.stories.tsx +200 -200
  53. package/src/data-table.tsx +1687 -1106
  54. package/src/date-picker.stories.tsx +61 -61
  55. package/src/date-picker.tsx +457 -422
  56. package/src/design-cards.stories.tsx +551 -458
  57. package/src/dialog.stories.tsx +48 -48
  58. package/src/dialog.tsx +179 -166
  59. package/src/display-preferences.tsx +59 -0
  60. package/src/documents/barcode-svg.stories.tsx +72 -72
  61. package/src/documents/barcode-svg.tsx +79 -79
  62. package/src/dropdown-menu.stories.tsx +77 -77
  63. package/src/dropdown-menu.tsx +271 -271
  64. package/src/editor/agent-panel.tsx +222 -0
  65. package/src/editor/agents.stories.tsx +81 -0
  66. package/src/editor/agents.ts +55 -0
  67. package/src/editor/behaviour.ts +279 -279
  68. package/src/editor/block-ids.ts +44 -44
  69. package/src/editor/block-list.tsx +104 -101
  70. package/src/editor/block-toolbar.tsx +490 -477
  71. package/src/editor/bubble.tsx +119 -93
  72. package/src/editor/catalogue.ts +169 -103
  73. package/src/editor/collab-rail.tsx +746 -746
  74. package/src/editor/collab.stories.tsx +207 -207
  75. package/src/editor/collab.ts +87 -87
  76. package/src/editor/contract.ts +476 -408
  77. package/src/editor/convert.ts +414 -362
  78. package/src/editor/doc-editor.stories.tsx +98 -98
  79. package/src/editor/doc-editor.tsx +1492 -1287
  80. package/src/editor/editor.css +636 -536
  81. package/src/editor/extensions.ts +86 -86
  82. package/src/editor/field-bar.tsx +154 -0
  83. package/src/editor/field-picker.tsx +109 -107
  84. package/src/editor/fields.ts +100 -100
  85. package/src/editor/gutter.tsx +443 -367
  86. package/src/editor/index.ts +23 -22
  87. package/src/editor/label-sheet.tsx +289 -289
  88. package/src/editor/labels.ts +394 -310
  89. package/src/editor/link-tools.tsx +141 -141
  90. package/src/editor/node-views.tsx +461 -450
  91. package/src/editor/page-view.tsx +372 -353
  92. package/src/editor/phone.tsx +310 -0
  93. package/src/editor/plugin-block-view.tsx +230 -0
  94. package/src/editor/plugin-blocks.stories.tsx +96 -0
  95. package/src/editor/plugin-blocks.ts +52 -0
  96. package/src/editor/publish-check.tsx +201 -182
  97. package/src/editor/rich-blocks.stories.tsx +146 -146
  98. package/src/editor/sample.ts +40 -40
  99. package/src/editor/save-block-dialog.tsx +141 -0
  100. package/src/editor/saved-block-view.tsx +205 -0
  101. package/src/editor/saved-blocks.stories.tsx +105 -0
  102. package/src/editor/saved-parts.ts +192 -0
  103. package/src/editor/schema-rich.ts +156 -150
  104. package/src/editor/schema.ts +368 -315
  105. package/src/editor/services.tsx +205 -127
  106. package/src/editor/slash.ts +64 -64
  107. package/src/editor/suggesting.ts +372 -372
  108. package/src/editor/suggestions.ts +763 -763
  109. package/src/editor/table-keys.ts +66 -66
  110. package/src/editor/templates.stories.tsx +324 -324
  111. package/src/editor/toolbar.tsx +364 -358
  112. package/src/empty-state.stories.tsx +51 -51
  113. package/src/empty-state.tsx +126 -100
  114. package/src/empty-state.usage-notes.md +30 -30
  115. package/src/form.stories.tsx +112 -112
  116. package/src/form.tsx +176 -176
  117. package/src/globals.css +20 -20
  118. package/src/icon-button.tsx +85 -85
  119. package/src/icon-map.ts +335 -244
  120. package/src/icon.tsx +41 -41
  121. package/src/index.ts +92 -67
  122. package/src/input.stories.tsx +157 -157
  123. package/src/input.tsx +768 -759
  124. package/src/kpi-strip.tsx +47 -0
  125. package/src/localized-text.ts +76 -0
  126. package/src/locked-screen.stories.tsx +29 -29
  127. package/src/locked-screen.tsx +75 -61
  128. package/src/lockup.tsx +42 -0
  129. package/src/lottie.tsx +441 -0
  130. package/src/mark.tsx +62 -62
  131. package/src/math-text.stories.tsx +33 -33
  132. package/src/math-text.tsx +43 -43
  133. package/src/menu-bar.stories.tsx +198 -198
  134. package/src/menu-bar.tsx +373 -373
  135. package/src/message-thread.tsx +181 -0
  136. package/src/money/currency.ts +244 -230
  137. package/src/money/money-input.tsx +131 -0
  138. package/src/money/money.tsx +33 -0
  139. package/src/open-on-computer.tsx +150 -0
  140. package/src/otp-input.tsx +161 -0
  141. package/src/page-header.stories.tsx +95 -95
  142. package/src/page-header.tsx +122 -122
  143. package/src/page-shell.stories.tsx +42 -42
  144. package/src/page-shell.tsx +32 -32
  145. package/src/page-states.tsx +277 -0
  146. package/src/pagination.stories.tsx +45 -45
  147. package/src/pagination.tsx +98 -98
  148. package/src/paper-sheet.stories.tsx +88 -0
  149. package/src/paper-sheet.tsx +85 -0
  150. package/src/phone-input.tsx +252 -0
  151. package/src/phone-tab-bar.tsx +152 -0
  152. package/src/plugin-card.stories.tsx +208 -180
  153. package/src/plugin-card.tsx +931 -848
  154. package/src/popover.stories.tsx +48 -48
  155. package/src/popover.tsx +55 -55
  156. package/src/radio-group.stories.tsx +26 -26
  157. package/src/radio-group.tsx +44 -44
  158. package/src/role-summary.stories.tsx +143 -0
  159. package/src/role-summary.tsx +120 -0
  160. package/src/route-flow/editor.tsx +1087 -1014
  161. package/src/route-flow/model.ts +771 -716
  162. package/src/save-bar.tsx +94 -0
  163. package/src/scope-grant.tsx +139 -139
  164. package/src/screen-too-small.stories.tsx +61 -61
  165. package/src/screen-too-small.tsx +104 -104
  166. package/src/search-field.tsx +65 -0
  167. package/src/select.stories.tsx +44 -44
  168. package/src/select.tsx +197 -197
  169. package/src/separator.stories.tsx +34 -34
  170. package/src/separator.tsx +34 -34
  171. package/src/sheet.stories.tsx +49 -49
  172. package/src/sheet.tsx +168 -168
  173. package/src/skeleton.stories.tsx +28 -28
  174. package/src/skeleton.tsx +19 -19
  175. package/src/slider.stories.tsx +78 -78
  176. package/src/slider.tsx +300 -300
  177. package/src/spinner.stories.tsx +33 -33
  178. package/src/spinner.tsx +55 -55
  179. package/src/stepper.tsx +85 -0
  180. package/src/switch.stories.tsx +42 -42
  181. package/src/switch.tsx +41 -41
  182. package/src/switcher.stories.tsx +111 -111
  183. package/src/switcher.tsx +131 -131
  184. package/src/system-state.tsx +55 -0
  185. package/src/table.stories.tsx +48 -48
  186. package/src/table.tsx +121 -121
  187. package/src/tabs.stories.tsx +74 -74
  188. package/src/tabs.tsx +90 -90
  189. package/src/tag-input.stories.tsx +67 -67
  190. package/src/tag-input.tsx +117 -117
  191. package/src/tenant-logo.tsx +63 -63
  192. package/src/tenant-switcher.stories.tsx +38 -38
  193. package/src/tenant-switcher.tsx +185 -164
  194. package/src/textarea.stories.tsx +27 -27
  195. package/src/textarea.tsx +18 -18
  196. package/src/theme-mode.ts +74 -52
  197. package/src/time-grid.tsx +163 -0
  198. package/src/time-picker.stories.tsx +62 -62
  199. package/src/time-picker.tsx +616 -615
  200. package/src/toggle-group.tsx +139 -138
  201. package/src/tooltip.stories.tsx +43 -43
  202. package/src/tooltip.tsx +73 -73
  203. package/src/top-nav.stories.tsx +58 -58
  204. package/src/top-nav.tsx +324 -324
  205. package/src/undo-bar.tsx +107 -107
  206. package/src/utils.ts +45 -45
  207. package/src/view-toggle.stories.tsx +84 -84
  208. package/src/view-toggle.tsx +111 -110
@@ -0,0 +1,222 @@
1
+ "use client"
2
+
3
+ import * as React from "react"
4
+
5
+ import { AgentRunStatus, type AgentRunState } from "../agent-run-status"
6
+ import { Button } from "../button"
7
+ import { Icon } from "../icon"
8
+ import { IconButton } from "../icon-button"
9
+ import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "../select"
10
+ import { cn } from "../utils"
11
+ import { isActive, type EditorAgentRequest, type EditorAgents } from "./agents"
12
+ import { fill, type EditorLabels } from "./labels"
13
+
14
+ /** What the sheet opens with: the selection (Rewrite) or nothing (Ask an agent). */
15
+ export interface AgentAskStart {
16
+ request?: string
17
+ quote?: string | null
18
+ anchorBlockId?: string | null
19
+ }
20
+
21
+ const ANY = "any"
22
+
23
+ /** A request's state as AgentRunStatus draws it: a queued one is running ("Waiting for …"), stopped reads as done. */
24
+ function runState(r: EditorAgentRequest): AgentRunState {
25
+ if (r.status === "failed") return "failed"
26
+ if (r.status === "done" || r.status === "stopped") return "done"
27
+ return "running"
28
+ }
29
+
30
+ /**
31
+ * Ask an agent (EditorAgents card, M6). A dashed sheet, because nothing has
32
+ * happened yet: the agent picker (the agents this person uses), context chips
33
+ * (this document, the selection), the request, the line that says it writes
34
+ * only suggestions and for whom, and Ask. Below it the person's requests on
35
+ * this document, each as an AgentRunStatus with Stop while it waits or runs.
36
+ *
37
+ * With no agent connected the sheet says how to connect one instead of
38
+ * failing (owner's answer Q3).
39
+ */
40
+ function AgentPanel({
41
+ agents,
42
+ labels,
43
+ me,
44
+ start,
45
+ onClose,
46
+ className,
47
+ }: {
48
+ agents: EditorAgents
49
+ labels: EditorLabels
50
+ /** The person at the keyboard, for "for {name}". */
51
+ me?: string
52
+ start?: AgentAskStart
53
+ onClose: () => void
54
+ className?: string
55
+ }) {
56
+ const [agent, setAgent] = React.useState<string>(() => {
57
+ const first = agents.choices.find((c) => c.id !== null)
58
+ return first ? String(first.id) : ANY
59
+ })
60
+ const [text, setText] = React.useState(start?.request ?? "")
61
+ const [busy, setBusy] = React.useState(false)
62
+ const [failed, setFailed] = React.useState(false)
63
+ const fieldId = React.useId()
64
+ const area = React.useRef<HTMLTextAreaElement>(null)
65
+
66
+ React.useEffect(() => {
67
+ setText(start?.request ?? "")
68
+ area.current?.focus()
69
+ }, [start])
70
+
71
+ const connected = agents.choices.length > 0
72
+ const ask = async () => {
73
+ const request = text.trim()
74
+ if (!request || busy) return
75
+ setBusy(true)
76
+ setFailed(false)
77
+ try {
78
+ await agents.onAsk({
79
+ agentId: agent === ANY ? null : Number(agent),
80
+ request,
81
+ anchorBlockId: start?.anchorBlockId ?? null,
82
+ quote: start?.quote ?? null,
83
+ })
84
+ setText("")
85
+ } catch {
86
+ setFailed(true)
87
+ } finally {
88
+ setBusy(false)
89
+ }
90
+ }
91
+
92
+ return (
93
+ <section
94
+ aria-label={labels.agentAsk}
95
+ data-slot="agent-panel"
96
+ className={cn("grid gap-3 border-b border-border bg-card px-4 py-3", className)}
97
+ >
98
+ <div className="flex items-center justify-between gap-2">
99
+ <h2 className="flex items-center gap-1.5 text-sm font-semibold">
100
+ <Icon name="robot" />
101
+ {labels.agentAsk}
102
+ </h2>
103
+ <IconButton icon="close" label={labels.agentClose} size="sm" onClick={onClose} />
104
+ </div>
105
+
106
+ {!connected ? (
107
+ <div className="grid gap-2 rounded-card border border-dashed border-input p-3 text-sm">
108
+ <p>{labels.agentNoneConnected}</p>
109
+ {agents.connectHref && (
110
+ <a className="w-fit text-sm font-medium text-primary underline-offset-2 hover:underline" href={agents.connectHref}>
111
+ {labels.agentConnect}
112
+ </a>
113
+ )}
114
+ </div>
115
+ ) : (
116
+ <form
117
+ className="grid gap-2.5 rounded-card border border-dashed border-input p-3"
118
+ onSubmit={(e) => {
119
+ e.preventDefault()
120
+ void ask()
121
+ }}
122
+ >
123
+ <div className="flex flex-wrap items-center gap-1.5">
124
+ <Select value={agent} onValueChange={setAgent}>
125
+ <SelectTrigger size="sm" aria-label={labels.agentPicker}>
126
+ <Icon name="robot" />
127
+ <SelectValue />
128
+ </SelectTrigger>
129
+ <SelectContent>
130
+ {agents.choices.map((c) => (
131
+ <SelectItem key={c.id ?? ANY} value={c.id === null ? ANY : String(c.id)}>
132
+ {c.name}
133
+ </SelectItem>
134
+ ))}
135
+ </SelectContent>
136
+ </Select>
137
+ <span className="inline-flex h-7 items-center gap-1 rounded-full bg-muted px-2.5 text-xs text-muted-foreground">
138
+ <Icon name="document" size={14} />
139
+ {labels.agentThisDocument}
140
+ </span>
141
+ {start?.quote && (
142
+ <span className="inline-flex h-7 max-w-[16rem] items-center gap-1 truncate rounded-full bg-muted px-2.5 text-xs text-muted-foreground">
143
+ “{start.quote}”
144
+ </span>
145
+ )}
146
+ </div>
147
+ <label htmlFor={fieldId} className="sr-only">
148
+ {labels.agentRequest}
149
+ </label>
150
+ <textarea
151
+ id={fieldId}
152
+ ref={area}
153
+ value={text}
154
+ onChange={(e) => setText(e.target.value)}
155
+ onKeyDown={(e) => {
156
+ if (e.key === "Enter" && (e.metaKey || e.ctrlKey)) {
157
+ e.preventDefault()
158
+ void ask()
159
+ }
160
+ if (e.key === "Escape") onClose()
161
+ }}
162
+ placeholder={labels.agentRequestPlaceholder}
163
+ rows={3}
164
+ maxLength={4000}
165
+ className="min-h-[72px] w-full resize-y rounded-control border-0 bg-transparent text-sm outline-none placeholder:text-muted-foreground focus-visible:ring-2 focus-visible:ring-ring/30"
166
+ />
167
+ <div className="flex flex-wrap items-center justify-between gap-2">
168
+ <span className="flex items-center gap-1.5 text-xs text-muted-foreground">
169
+ <Icon name="robot" size={14} />
170
+ {me ? fill(labels.agentWritesFor, { name: me }) : labels.agentWrites}
171
+ </span>
172
+ <Button type="submit" variant="outline" size="sm" icon="send" disabled={!text.trim() || busy}>
173
+ {labels.agentAskButton}
174
+ </Button>
175
+ </div>
176
+ {failed && (
177
+ <p role="alert" className="text-xs text-error-text">
178
+ {labels.collabFailed}
179
+ </p>
180
+ )}
181
+ </form>
182
+ )}
183
+
184
+ {agents.requests.length > 0 && (
185
+ <ul className="grid gap-2" aria-label={labels.agentRequests}>
186
+ {agents.requests.slice(0, 3).map((r) => (
187
+ <li key={r.id}>
188
+ <AgentRunStatus
189
+ status={runState(r)}
190
+ agent={r.agent?.name ?? labels.agentAny}
191
+ onBehalfOf={me}
192
+ title={
193
+ r.status === "queued"
194
+ ? labels.agentWaiting
195
+ : r.status === "stopped"
196
+ ? labels.agentStopped
197
+ : (r.title ?? (r.status === "running" ? labels.agentWorking : r.request))
198
+ }
199
+ progress={r.status === "running" ? (r.progress ?? undefined) : undefined}
200
+ detail={r.status === "running" ? r.request : (r.detail ?? undefined)}
201
+ next={r.status === "failed" ? labels.agentFailedNext : undefined}
202
+ onStop={isActive(r.status) && !r.stopping ? () => void agents.onStop(r.id) : undefined}
203
+ onRetry={r.status === "failed" ? () => setText(r.request) : undefined}
204
+ labels={{
205
+ running: r.status === "queued" ? labels.agentQueued : labels.agentRunning,
206
+ done: r.status === "stopped" ? labels.agentStoppedBadge : labels.agentDone,
207
+ failed: labels.agentFailed,
208
+ for: labels.actorFor,
209
+ stop: labels.agentStop,
210
+ retry: labels.agentRetry,
211
+ }}
212
+ className="p-3"
213
+ />
214
+ </li>
215
+ ))}
216
+ </ul>
217
+ )}
218
+ </section>
219
+ )
220
+ }
221
+
222
+ export { AgentPanel }
@@ -0,0 +1,81 @@
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+
3
+ import { AgentPanel } from "./agent-panel"
4
+ import type { EditorAgentRequest, EditorAgents } from "./agents"
5
+ import { EDITOR_LABELS } from "./labels"
6
+
7
+ /**
8
+ * Editor M6, the EditorAgents card: Ask an agent (dashed, nothing has happened
9
+ * yet), a request while it runs with Stop, one that's done, and the sheet with
10
+ * no agent connected. Example data follows the card (the Billing assistant,
11
+ * for Amro).
12
+ */
13
+ const meta = {
14
+ title: "Editor/Agents",
15
+ parameters: { designCard: { width: 600, height: 520 } },
16
+ } satisfies Meta
17
+
18
+ export default meta
19
+ type Story = StoryObj<typeof meta>
20
+
21
+ const noop = async () => undefined
22
+
23
+ const CHOICES = [
24
+ { id: 7, name: "Billing assistant" },
25
+ { id: null, name: EDITOR_LABELS.agentAny },
26
+ ]
27
+
28
+ const RUNNING: EditorAgentRequest = {
29
+ id: "41",
30
+ request: "Write a short, polite paragraph for customers whose invoices are more than 30 days overdue",
31
+ status: "running",
32
+ agent: { id: "agent:3", name: "Billing assistant" },
33
+ title: "Reading 3 overdue invoices",
34
+ progress: { done: 1, total: 3 },
35
+ at: "2026-11-12T14:06:00Z",
36
+ }
37
+
38
+ const DONE: EditorAgentRequest = {
39
+ ...RUNNING,
40
+ id: "40",
41
+ status: "done",
42
+ title: "Suggested 2 blocks",
43
+ progress: null,
44
+ detail: "Accept or reject them on the rail.",
45
+ }
46
+
47
+ function agents(over: Partial<EditorAgents>): EditorAgents {
48
+ return { choices: CHOICES, requests: [], connectHref: "#", onAsk: noop, onStop: noop, ...over }
49
+ }
50
+
51
+ export const Asking: Story = {
52
+ render: () => (
53
+ <AgentPanel
54
+ agents={agents({})}
55
+ labels={EDITOR_LABELS}
56
+ me="Amro"
57
+ start={{ request: "Write a short, polite paragraph for customers whose invoices are more than 30 days overdue" }}
58
+ onClose={() => undefined}
59
+ />
60
+ ),
61
+ }
62
+
63
+ export const Rewrite: Story = {
64
+ render: () => (
65
+ <AgentPanel
66
+ agents={agents({})}
67
+ labels={EDITOR_LABELS}
68
+ me="Amro"
69
+ start={{ request: EDITOR_LABELS.agentRewriteRequest, quote: "Failure to pay will result in legal action", anchorBlockId: "p1" }}
70
+ onClose={() => undefined}
71
+ />
72
+ ),
73
+ }
74
+
75
+ export const Running: Story = {
76
+ render: () => <AgentPanel agents={agents({ requests: [RUNNING, DONE] })} labels={EDITOR_LABELS} me="Amro" onClose={() => undefined} />,
77
+ }
78
+
79
+ export const NoAgentConnected: Story = {
80
+ render: () => <AgentPanel agents={agents({ choices: [] })} labels={EDITOR_LABELS} me="Amro" onClose={() => undefined} />,
81
+ }
@@ -0,0 +1,55 @@
1
+ /**
2
+ * Agents in the editor (M6, EditorAgents card; E.4, E.30, E.31). Whity hosts
3
+ * no model: the person asks, their own agent picks the request up over MCP,
4
+ * and everything it writes comes back as suggestions and comments on the
5
+ * rail. The editor shows the request as it runs, with Stop.
6
+ */
7
+
8
+ export type AgentRequestStatus = "queued" | "running" | "done" | "failed" | "stopped"
9
+
10
+ /** An agent this person may ask; `id` null is "any agent I have connected". */
11
+ export interface EditorAgentChoice {
12
+ id: number | null
13
+ name: string
14
+ }
15
+
16
+ export interface EditorAgentRequest {
17
+ id: string
18
+ request: string
19
+ quote?: string | null
20
+ status: AgentRequestStatus
21
+ /** The agent asked or working on it; null while any of the person's agents may take it. */
22
+ agent: { id: string; name: string } | null
23
+ /** What it is doing now, in plain words. */
24
+ title?: string | null
25
+ progress?: { done: number; total: number } | null
26
+ /** What it did, or what went wrong. */
27
+ detail?: string | null
28
+ /** Stop was pressed; the agent hasn't stopped yet. */
29
+ stopping?: boolean
30
+ /** ISO 8601. */
31
+ at: string
32
+ }
33
+
34
+ export interface NewAgentRequest {
35
+ agentId: number | null
36
+ request: string
37
+ anchorBlockId?: string | null
38
+ quote?: string | null
39
+ }
40
+
41
+ export interface EditorAgents {
42
+ /** The agents this person uses. Empty: the sheet says how to connect one. */
43
+ choices: EditorAgentChoice[]
44
+ /** This person's requests on this document, newest first. */
45
+ requests: EditorAgentRequest[]
46
+ /** Where to connect an agent (Account › Agents). */
47
+ connectHref?: string
48
+ onAsk: (request: NewAgentRequest) => Promise<void>
49
+ onStop: (requestId: string) => Promise<void>
50
+ }
51
+
52
+ /** Waiting or running: the editor keeps polling while one of these is on the sheet. */
53
+ export function isActive(status: AgentRequestStatus): boolean {
54
+ return status === "queued" || status === "running"
55
+ }