@tangle-network/agent-app 0.45.22 → 0.45.24

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 (66) hide show
  1. package/dist/{DesignCanvas-ZG7DJS7C.js → DesignCanvas-3RRPVPCP.js} +2 -2
  2. package/dist/{DesignCanvasEditor-SLFMHOII.js → DesignCanvasEditor-KAMMEX7E.js} +4 -4
  3. package/dist/{TimelineEditor-6PV42FLG.js → TimelineEditor-IIBVCAZV.js} +2 -2
  4. package/dist/VaultPane-MUWGYVJ7.js +7 -0
  5. package/dist/assistant/index.d.ts +11 -0
  6. package/dist/assistant/index.js +89 -56
  7. package/dist/assistant/index.js.map +1 -1
  8. package/dist/chat-react/index.js +4 -1
  9. package/dist/chat-react/index.js.map +1 -1
  10. package/dist/{chunk-MLACJ6DB.js → chunk-7O4FZAFP.js} +10 -10
  11. package/dist/chunk-7O4FZAFP.js.map +1 -0
  12. package/dist/{chunk-OASVAPRL.js → chunk-AWPK7ZDS.js} +3 -3
  13. package/dist/{chunk-YTMKRL3L.js → chunk-HZ4WCA37.js} +3 -2
  14. package/dist/chunk-HZ4WCA37.js.map +1 -0
  15. package/dist/{chunk-FVJP2RTC.js → chunk-JJJEO4ND.js} +91 -36
  16. package/dist/chunk-JJJEO4ND.js.map +1 -0
  17. package/dist/{chunk-NZVBJM73.js → chunk-KOMP6NDW.js} +1114 -494
  18. package/dist/chunk-KOMP6NDW.js.map +1 -0
  19. package/dist/{chunk-TZO3SOUL.js → chunk-LSQR6HM6.js} +49 -33
  20. package/dist/chunk-LSQR6HM6.js.map +1 -0
  21. package/dist/{chunk-3IHYJIDJ.js → chunk-NC2V63EL.js} +15 -15
  22. package/dist/chunk-NC2V63EL.js.map +1 -0
  23. package/dist/{chunk-73CQJOIU.js → chunk-OYGM5WLD.js} +5 -5
  24. package/dist/chunk-OYGM5WLD.js.map +1 -0
  25. package/dist/chunk-XEA5EG6P.js +1478 -0
  26. package/dist/chunk-XEA5EG6P.js.map +1 -0
  27. package/dist/chunk-YIQHOAHN.js +340 -0
  28. package/dist/chunk-YIQHOAHN.js.map +1 -0
  29. package/dist/design-canvas-react/index.d.ts +2 -2
  30. package/dist/design-canvas-react/index.js +9 -9
  31. package/dist/design-canvas-react/index.js.map +1 -1
  32. package/dist/design-canvas-react/lazy.js +1 -1
  33. package/dist/legibility/cli.d.ts +1 -0
  34. package/dist/legibility/cli.js +143 -0
  35. package/dist/legibility/cli.js.map +1 -0
  36. package/dist/legibility/index.d.ts +572 -0
  37. package/dist/legibility/index.js +33 -0
  38. package/dist/legibility/index.js.map +1 -0
  39. package/dist/sequences-react/index.js +2 -2
  40. package/dist/theme/index.d.ts +27 -1
  41. package/dist/theme/index.js +1 -1
  42. package/dist/theme/tailwind-preset.d.ts +25 -0
  43. package/dist/theme/tailwind-preset.js +55 -1
  44. package/dist/theme/tailwind-preset.js.map +1 -1
  45. package/dist/theme/tokens.css +298 -40
  46. package/dist/vault/index.js +1 -1
  47. package/dist/vault/lazy.js +1 -1
  48. package/dist/web-react/async/index.js +19 -307
  49. package/dist/web-react/async/index.js.map +1 -1
  50. package/dist/web-react/index.d.ts +321 -6
  51. package/dist/web-react/index.js +34 -2
  52. package/dist/work-product-react/index.js +1 -1
  53. package/package.json +7 -1
  54. package/dist/VaultPane-HFH734K6.js +0 -7
  55. package/dist/chunk-3IHYJIDJ.js.map +0 -1
  56. package/dist/chunk-73CQJOIU.js.map +0 -1
  57. package/dist/chunk-FVJP2RTC.js.map +0 -1
  58. package/dist/chunk-MLACJ6DB.js.map +0 -1
  59. package/dist/chunk-NZVBJM73.js.map +0 -1
  60. package/dist/chunk-TZO3SOUL.js.map +0 -1
  61. package/dist/chunk-YTMKRL3L.js.map +0 -1
  62. /package/dist/{DesignCanvas-ZG7DJS7C.js.map → DesignCanvas-3RRPVPCP.js.map} +0 -0
  63. /package/dist/{DesignCanvasEditor-SLFMHOII.js.map → DesignCanvasEditor-KAMMEX7E.js.map} +0 -0
  64. /package/dist/{TimelineEditor-6PV42FLG.js.map → TimelineEditor-IIBVCAZV.js.map} +0 -0
  65. /package/dist/{VaultPane-HFH734K6.js.map → VaultPane-MUWGYVJ7.js.map} +0 -0
  66. /package/dist/{chunk-OASVAPRL.js.map → chunk-AWPK7ZDS.js.map} +0 -0
@@ -372,15 +372,82 @@ interface ComposerFile {
372
372
  * `status: 'ready'` files with a part travel on a parts-aware send. */
373
373
  part?: ComposerFilePart;
374
374
  }
375
+ /** A send the host refused. `error` is shown verbatim in the composer's notice;
376
+ * omit it for the generic copy. */
377
+ interface ComposerSendRejected {
378
+ ok: false;
379
+ error?: string;
380
+ }
381
+ /**
382
+ * What a send handler reports back. `void` — what every handler returned before
383
+ * this existed — reads as accepted, so wiring stays unchanged; a thrown error, a
384
+ * rejected promise, or `{ ok: false }` is the rejection that restores the draft.
385
+ * A handler that resolves only when the whole turn finishes still reports
386
+ * correctly: the input already cleared on dispatch, so the answer only decides
387
+ * whether the draft comes back.
388
+ */
389
+ type ComposerSendOutcome = void | {
390
+ ok: true;
391
+ } | ComposerSendRejected;
392
+ type ComposerSendResult = ComposerSendOutcome | Promise<ComposerSendOutcome>;
393
+ /**
394
+ * A send handler, typed as a UNION with the legacy `=> void` signature rather
395
+ * than as `(…) => ComposerSendResult` alone.
396
+ *
397
+ * TypeScript's return-type-`void` rule accepts a function returning ANYTHING
398
+ * where a `=> void` is expected, and that rule fires only when the target's
399
+ * return type is exactly `void` — not when it is a union that contains `void`.
400
+ * So narrowing this prop to `ComposerSendResult` would reject handler shapes
401
+ * that compiled against the shipped `onSend?: (message: string) => void`:
402
+ * `onSend={(m) => rows.push(m)}` (returns `number`) and
403
+ * `onSend={(m) => append({ role: 'user', content: m })}` (an ai-sdk append
404
+ * returns `Promise<string | null | undefined>`) both stop compiling, on a
405
+ * package whose pinned consumers must never need a source edit to take a minor.
406
+ *
407
+ * The union keeps both: a legacy handler lands on the first member, and a
408
+ * handler that reports an outcome lands on the second. A call through it
409
+ * resolves to `void | ComposerSendResult`, which IS `ComposerSendResult`, so
410
+ * the composer reads the outcome exactly as before.
411
+ */
412
+ type ComposerSendHandler = ((message: string) => void) | ((message: string) => ComposerSendResult);
413
+ /** @see ComposerSendHandler — the parts-aware arity, same union for the same reason. */
414
+ type ComposerSendPartsHandler = ((message: string, parts: ComposerFilePart[]) => void) | ((message: string, parts: ComposerFilePart[]) => ComposerSendResult);
415
+ /** The rejected send, handed to `onSendFailed` so the host can undo whatever it
416
+ * cleared optimistically — most importantly the staged attachments, which the
417
+ * composer does not own (`pendingFiles` is a prop). */
418
+ interface ComposerSendFailure {
419
+ /** The reason as the composer renders it. */
420
+ message: string;
421
+ /** The user's exact draft, untrimmed. */
422
+ text: string;
423
+ /** The parts the rejected send carried. */
424
+ parts: ComposerFilePart[];
425
+ /** Whatever the handler threw / rejected with, or the `{ ok: false }` value. */
426
+ error: unknown;
427
+ /** True when the draft was put back in the textarea (the box was empty).
428
+ * False means the user had typed a replacement, so the unsent text is held in
429
+ * the notice instead. */
430
+ restored: boolean;
431
+ }
375
432
  interface ChatComposerProps {
376
433
  /** Send the trimmed, non-empty message. Attached files travel separately via
377
434
  * `onAttach` + `pendingFiles` (the host consumes and clears them on send).
378
- * Optional when `onSendParts` is wired. */
379
- onSend?: (message: string) => void;
435
+ * Optional when `onSendParts` is wired.
436
+ *
437
+ * Report a refused send by throwing, rejecting, or returning `{ ok: false }`
438
+ * — the composer restores the draft rather than losing it. */
439
+ onSend?: ComposerSendHandler;
380
440
  /** Parts-aware send: receives the trimmed message plus the `part`
381
441
  * descriptors of every `ready` pending file. Takes precedence over
382
- * `onSend`; enables file-only sends (empty text, ≥1 ready part). */
383
- onSendParts?: (message: string, parts: ComposerFilePart[]) => void;
442
+ * `onSend`; enables file-only sends (empty text, ≥1 ready part).
443
+ *
444
+ * Same rejection contract as `onSend`. */
445
+ onSendParts?: ComposerSendPartsHandler;
446
+ /** Notified when a send is rejected, after the composer has restored what it
447
+ * owns. The host uses it to put back the `pendingFiles` it consumed. */
448
+ onSendFailed?: (failure: ComposerSendFailure) => void;
449
+ /** Notice copy when the handler names no reason of its own. */
450
+ sendFailureMessage?: string;
384
451
  /** Stop the in-flight turn; shown in place of Send while `isStreaming`. */
385
452
  onCancel?: () => void;
386
453
  isStreaming?: boolean;
@@ -425,7 +492,7 @@ interface ChatComposerProps {
425
492
  sendLabel?: string;
426
493
  className?: string;
427
494
  }
428
- declare function ChatComposer({ onSend, onSendParts, onCancel, isStreaming, disabled, placeholder, value, onValueChange, initialValue, seed, onSeedApplied, controls, controlsPlacement, onAttach, onAttachFolder, pendingFiles, onRemoveFile, accept, dropTitle, dropDescription, focusShortcut, sendLabel, className, }: ChatComposerProps): react.JSX.Element;
495
+ declare function ChatComposer({ onSend, onSendParts, onSendFailed, sendFailureMessage, onCancel, isStreaming, disabled, placeholder, value, onValueChange, initialValue, seed, onSeedApplied, controls, controlsPlacement, onAttach, onAttachFolder, pendingFiles, onRemoveFile, accept, dropTitle, dropDescription, focusShortcut, sendLabel, className, }: ChatComposerProps): react.JSX.Element;
429
496
 
430
497
  type InteractionBadgeVariant = 'outline' | 'default' | 'destructive';
431
498
  declare function InteractionBadge({ variant, children }: {
@@ -1053,6 +1120,254 @@ interface ProvenanceStampProps {
1053
1120
  * backtest. */
1054
1121
  declare function ProvenanceStamp({ provenance, backtest, className }: ProvenanceStampProps): react.JSX.Element;
1055
1122
 
1123
+ /**
1124
+ * The pure half of the provenance affordance: what kind of claim a value is,
1125
+ * what a reader should DO about it, and what has to be SAID when its origin
1126
+ * cannot be shown.
1127
+ *
1128
+ * Zero React, zero DOM — a loader or a worker can decide a value's standing
1129
+ * before it reaches a screen, and `./provenance`'s `ProvenanceValue` renders
1130
+ * exactly what these functions decide.
1131
+ *
1132
+ * The distinction the module exists to hold: a person typing a number, a
1133
+ * document carrying it, a formula producing it, and a model claiming it are
1134
+ * four different kinds of evidence. Rendered as one grey caption they are
1135
+ * indistinguishable, which is how an unverified model assertion reads to a
1136
+ * reviewer as a transcribed fact.
1137
+ *
1138
+ * Every domain word is a caller parameter: no field names, no document kinds,
1139
+ * and no confidence policy beyond a default the product overrides.
1140
+ */
1141
+ /**
1142
+ * How a value came to exist. Four kinds, never interchangeable:
1143
+ *
1144
+ * - `extracted` — read out of a document or message the product can open.
1145
+ * - `entered` — a person typed or confirmed it.
1146
+ * - `computed` — produced from other values, each carrying its own provenance.
1147
+ * - `asserted` — the agent stated it, with nothing outside the model behind it.
1148
+ */
1149
+ type ProvenanceBasis = 'extracted' | 'entered' | 'computed' | 'asserted';
1150
+ /** Every basis, in the order a legend should list them. */
1151
+ declare const PROVENANCE_BASES: readonly ProvenanceBasis[];
1152
+ /** The words one basis is rendered and announced with. */
1153
+ interface ProvenanceBasisMeta {
1154
+ /** Marker text next to the value — short, and never only a colour. */
1155
+ label: string;
1156
+ /** One plain sentence naming what kind of claim this is. */
1157
+ meaning: string;
1158
+ /** What a reader can hold the value against, or `null` when nothing outside
1159
+ * the model can. `null` is what makes an `asserted` value uncertifiable at
1160
+ * any confidence. */
1161
+ checkableAgainst: string | null;
1162
+ }
1163
+ /** Words for one basis. */
1164
+ declare function provenanceBasisMeta(basis: ProvenanceBasis): ProvenanceBasisMeta;
1165
+ /** Whether a source could be resolved. `ready` is the default for a source that
1166
+ * says nothing. */
1167
+ type ProvenanceSourceStatus = 'ready' | 'loading' | 'unavailable';
1168
+ /** One thing a value came from. A `label` is mandatory because an unnamed
1169
+ * source is the same as no source. */
1170
+ interface ProvenanceSource {
1171
+ /** What the source IS, in the reader's words: "Form W-2 (Acme Corp)",
1172
+ * "Dana Whitfield", "Engagement letter". */
1173
+ label: string;
1174
+ /** The text in the source that carries the value. */
1175
+ quote?: string;
1176
+ /** Position inside the source — a page, a line, a span, a timestamp. The
1177
+ * caller's words; nothing here parses it. */
1178
+ locator?: string;
1179
+ /** Click-through target. Absent → the source is named but not openable. */
1180
+ href?: string;
1181
+ /** Defaults to `ready`. */
1182
+ status?: ProvenanceSourceStatus;
1183
+ /** Why an `unavailable` source cannot be opened, in one sentence. */
1184
+ unavailableReason?: string;
1185
+ }
1186
+ /**
1187
+ * What the reader should DO about a value — the only form confidence takes on
1188
+ * screen. "89% confidence" names no next move; these three do.
1189
+ *
1190
+ * - `settled` — nothing to do.
1191
+ * - `check` — open the source and confirm before relying on it.
1192
+ * - `confirm` — a person has to confirm the value before it is used.
1193
+ */
1194
+ type ProvenanceStanding = 'settled' | 'check' | 'confirm';
1195
+ /** The words one standing is rendered and announced with. */
1196
+ interface ProvenanceStandingMeta {
1197
+ /** Short state label. */
1198
+ label: string;
1199
+ /** The next move, as a sentence a person can follow. */
1200
+ action: string;
1201
+ }
1202
+ /** Words for one standing. */
1203
+ declare function provenanceStandingMeta(standing: ProvenanceStanding): ProvenanceStandingMeta;
1204
+ /** The weaker of two standings — `confirm` beats `check` beats `settled`. */
1205
+ declare function weakerProvenanceStanding(a: ProvenanceStanding, b: ProvenanceStanding): ProvenanceStanding;
1206
+ /**
1207
+ * Where a product draws its confidence lines. These are a POLICY, not a truth:
1208
+ * a number a model reports about itself means different things per surface, so
1209
+ * the thresholds are a parameter and the number itself never reaches the screen.
1210
+ */
1211
+ interface ProvenanceConfidencePolicy {
1212
+ /** At or above this, a value is `settled`. */
1213
+ settledAtOrAbove: number;
1214
+ /** At or above this (and below `settledAtOrAbove`), a value is `check`.
1215
+ * Below it, `confirm`. */
1216
+ checkAtOrAbove: number;
1217
+ }
1218
+ /** The starting policy. Products with a different tolerance pass their own. */
1219
+ declare const DEFAULT_PROVENANCE_CONFIDENCE_POLICY: ProvenanceConfidencePolicy;
1220
+ /** A value, where it came from, and — when it was computed — the provenanced
1221
+ * values it came from. The `inputs` field is what makes the shape compose:
1222
+ * a computed value's provenance IS its inputs. */
1223
+ interface ProvenanceRecord {
1224
+ /** The value as the reader should see it, already formatted. An empty string
1225
+ * is a missing value and renders as one, never as blank space. */
1226
+ display: string;
1227
+ /** What the value IS ("Wages", "Filing deadline"). Optional at the top level,
1228
+ * where the surface around it usually says; rendered for every composed
1229
+ * input, where nothing else names them. */
1230
+ label?: string;
1231
+ basis: ProvenanceBasis;
1232
+ /** Where it came from. An `extracted` value without one is a gap, not a
1233
+ * detail. */
1234
+ sources?: readonly ProvenanceSource[];
1235
+ /** The provenanced values a `computed` value was produced from. */
1236
+ inputs?: readonly ProvenanceRecord[];
1237
+ /** How the inputs combine, in the caller's words ("wages + interest"). */
1238
+ derivation?: string;
1239
+ /** 0–1. Never rendered as a number — it selects a standing. */
1240
+ confidence?: number;
1241
+ /** Overrides the standing confidence and basis would produce — a reviewer
1242
+ * approved it, a gate failed. It can only make a value WEAKER: the
1243
+ * structural floors below still apply, so a product cannot mark a value
1244
+ * settled that has no origin on file. */
1245
+ standing?: ProvenanceStanding;
1246
+ }
1247
+ /** The standing a bare confidence maps to under a policy. */
1248
+ declare function standingFromConfidence(confidence: number, policy?: ProvenanceConfidencePolicy): ProvenanceStanding;
1249
+ /** Something missing that the reader has to be TOLD about, because the value
1250
+ * renders either way and a bare number reads as a fact. */
1251
+ type ProvenanceGapKind = 'no-source' | 'no-inputs' | 'unavailable-source';
1252
+ /** One stated gap. `message` is rendered verbatim. */
1253
+ interface ProvenanceGap {
1254
+ kind: ProvenanceGapKind;
1255
+ message: string;
1256
+ /** The source that could not be resolved (`unavailable-source` only). */
1257
+ source?: ProvenanceSource;
1258
+ }
1259
+ /** The sentence for a source that is not `ready`, or `null` when it is. One
1260
+ * source of this copy, so the row and the gap list never disagree. */
1261
+ declare function describeProvenanceSourceStatus(source: ProvenanceSource): string | null;
1262
+ /**
1263
+ * What this record cannot show, at its own level. Inputs are not walked: every
1264
+ * composed input renders its own gaps next to its own value, where a reader can
1265
+ * act on them.
1266
+ */
1267
+ declare function provenanceGaps(record: ProvenanceRecord): ProvenanceGap[];
1268
+ /** The sources still resolving — rendered as their own state, never as an
1269
+ * absence. A load in flight is not a missing source. */
1270
+ declare function loadingProvenanceSources(record: ProvenanceRecord): ProvenanceSource[];
1271
+ /**
1272
+ * This record's own standing, ignoring its inputs.
1273
+ *
1274
+ * The order is: start from the explicit standing, else from confidence, else
1275
+ * from the basis — then apply every structural floor, taking the WEAKEST. The
1276
+ * floors are what a caller cannot talk its way out of:
1277
+ *
1278
+ * - an `asserted` value never reaches `settled` (a model's own confidence
1279
+ * cannot certify the model's claim — there is nothing to check it against),
1280
+ * - a `no-source` / `no-inputs` gap forces `confirm` (a value dressed as
1281
+ * evidence with no evidence behind it is worse than an open guess),
1282
+ * - an unopenable source forces `check` (the value may be right; the reader
1283
+ * just cannot confirm it).
1284
+ */
1285
+ declare function resolveProvenanceStanding(record: ProvenanceRecord, policy?: ProvenanceConfidencePolicy): ProvenanceStanding;
1286
+ /**
1287
+ * The standing a reader should see: this record's own, weakened by every value
1288
+ * it was computed from, however deep.
1289
+ *
1290
+ * A total is only as trustworthy as the weakest number in it. Rendering the
1291
+ * parent's own standing instead is how an exact sum of one document figure and
1292
+ * one model guess presents as traced.
1293
+ *
1294
+ * Cycle-safe: a record reachable from itself is counted once.
1295
+ */
1296
+ declare function rollUpProvenanceStanding(record: ProvenanceRecord, policy?: ProvenanceConfidencePolicy, seen?: Set<ProvenanceRecord>): ProvenanceStanding;
1297
+ /**
1298
+ * One plain sentence naming where the value came from — the panel's first line
1299
+ * and part of what a screen reader announces. It states the absence when there
1300
+ * is one, so no code path produces silence.
1301
+ */
1302
+ declare function describeProvenance(record: ProvenanceRecord): string;
1303
+ /**
1304
+ * The move THIS value's reader can actually make.
1305
+ *
1306
+ * `provenanceStandingMeta().action` is the generic sentence for a standing;
1307
+ * this is the one that accounts for what is on file. "Open the source and
1308
+ * confirm it" is a dead instruction on a value that has no source — an action
1309
+ * a reader cannot perform is the same defect as no action at all.
1310
+ */
1311
+ declare function provenanceNextMove(record: ProvenanceRecord, standing: ProvenanceStanding, policy?: ProvenanceConfidencePolicy): string;
1312
+ /**
1313
+ * The accessible name of the disclosure control: the value, how it came to
1314
+ * exist, and — unless there is nothing to do — the next move. This is the
1315
+ * whole affordance for someone who never sees the colour.
1316
+ */
1317
+ declare function provenanceTriggerLabel(record: ProvenanceRecord, standing: ProvenanceStanding): string;
1318
+
1319
+ /** Properties for one provenanced value and its disclosure. */
1320
+ interface ProvenanceValueProps {
1321
+ /** The value and where it came from. */
1322
+ record: ProvenanceRecord;
1323
+ /**
1324
+ * Open one source in the product's own way (a document pane at the right
1325
+ * page, a drawer, a route). Takes precedence over `href` when both are
1326
+ * present, because a product that routes wants its router — a source with
1327
+ * neither is named but not openable, which is a legitimate state and is
1328
+ * rendered as such.
1329
+ */
1330
+ onOpenSource?: (source: ProvenanceSource, record: ProvenanceRecord) => void;
1331
+ /** Retry resolving an `unavailable` source. Absent → the failure is stated
1332
+ * without a retry control, never swallowed. */
1333
+ onRetrySource?: (source: ProvenanceSource, record: ProvenanceRecord) => void;
1334
+ /** Where this product draws its confidence lines. */
1335
+ confidencePolicy?: ProvenanceConfidencePolicy;
1336
+ /**
1337
+ * How many levels of composed inputs stay expandable. Past it an input still
1338
+ * renders its value, its basis and its origin sentence — it just stops
1339
+ * carrying its own disclosure, so a deep tree cannot run away and a record
1340
+ * that reaches itself cannot recurse forever. Default 2.
1341
+ */
1342
+ maxDepth?: number;
1343
+ /** Open the disclosure on first render — for a review surface where the
1344
+ * trail is the point. Several of these coexist: only a reader opening a
1345
+ * trail closes another one. */
1346
+ defaultOpen?: boolean;
1347
+ /** What an empty `display` renders as. A blank cell is the defect this
1348
+ * component exists to remove. */
1349
+ missingValueLabel?: string;
1350
+ className?: string;
1351
+ }
1352
+ /**
1353
+ * A value, its origin marker, and the disclosure that shows where it came
1354
+ * from. The marker states the basis in words and, whenever there is something
1355
+ * to do about the value, the next move — so the standing is legible at rest
1356
+ * and does not depend on anyone opening the panel.
1357
+ */
1358
+ declare function ProvenanceValue({ record, onOpenSource, onRetrySource, confidencePolicy, maxDepth, defaultOpen, missingValueLabel, className, }: ProvenanceValueProps): react.JSX.Element;
1359
+ /** Properties for the basis legend. */
1360
+ interface ProvenanceLegendProps {
1361
+ /** Only the bases present on screen. Passing all four when only two appear
1362
+ * teaches distinctions the reader cannot use. */
1363
+ bases: readonly ProvenanceBasis[];
1364
+ className?: string;
1365
+ }
1366
+ /** The marker key for a surface that renders several bases at once — a review
1367
+ * pane, a grid, a return. Each row is the same glyph, tone and words the
1368
+ * markers use, plus what the basis MEANS. */
1369
+ declare function ProvenanceLegend({ bases, className }: ProvenanceLegendProps): react.JSX.Element | null;
1370
+
1056
1371
  /**
1057
1372
  * `SeatPaywall` — the shared "unlock this product" screen every agent app
1058
1373
  * shows when a user has no active seat and has spent past the free tier.
@@ -1908,4 +2223,4 @@ declare function useThinkingSeconds(active: boolean): number;
1908
2223
  */
1909
2224
  declare function ChatMessages({ messages, messageSize, models, renderMarkdown, renderExtras, durableCards, userLabel, agentLabel, loading, approval, onToolCallClick, toolRenderers, error, onRetry, renderEmpty, emptyState, header, resolveAttachmentUrl, workProductCards, }: ChatMessagesProps): react.JSX.Element;
1910
2225
 
1911
- export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, AgentSessionControls, type AgentSessionControlsProps, type AttachmentFileResult, CatalogModel, ChatAttachmentInput, ChatAttachmentKind, ChatAttachmentPart, ChatComposer, type ChatComposerProps, type ChatEmptyDoor, ChatEmptyState, type ChatEmptyStateProps, ChatInteraction, ChatInteractionField, type ChatInteractionRestoreMode, ChatInteractionStatus, ChatMentionPart, type ChatMessageMetrics, type ChatMessageSegment, ChatMessages, type ChatMessagesProps, ChatSelectField, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ComposerFile, type ComposerFilePart, type ConsumeChatStreamResult, DEFAULT_EFFORT_LEVELS, type DurableChatCard, DurableChatCards, type DurableChatCardsProps, type DurableInteractionAnswerSubmitterOptions, DurablePlanCard, type DurablePlanCardProps, DurablePlanClientError, type DurablePlanCurrentInput, type DurablePlanDecision, type DurablePlanDecisionClient, type DurablePlanDecisionClientOptions, type DurablePlanDecisionInput, type DurablePlanDecisionResult, type DurablePlanFollowUpReceipt, EMPTY_RECORD_GRID_OVERLAY, type EffortLevel, EffortPicker, type EffortPickerProps, EvidenceLineageTable, type EvidenceLineageTableProps, ExceptionList, type ExceptionListProps, type FetchSessionPage, type FieldValues, FlowWaterfall, type FlowWaterfallProps, INTERACTION_SUBMIT_TIMEOUT_MESSAGE, INTERACTION_SUBMIT_TIMEOUT_MS, InteractionActionButton, type InteractionAnswerSubmission, type InteractionAnswerSubmitterOptions, InteractionAnswers, type InteractionAttemptStore, InteractionBadge, type InteractionBadgeVariant, InteractionCancelData, InteractionPlanCard, type InteractionPlanCardProps, InteractionQuestionCard, type InteractionQuestionCardProps, InteractionRequestWire, type InteractionSubmitResult, type LinkLikeComponent, type LinkLikeProps, type MentionTextSegment, MessageAttachments, type MessageAttachmentsProps, MissionActivityLane, type MissionActivityLaneProps, ModelPicker, type ModelPickerProps, type ProposalApprovalHandlers, ProvenanceStamp, type ProvenanceStampProps, ProviderLogo, type ProviderLogoProps, QualityCheckList, type QualityCheckListProps, QuestionOptionList, type QuestionOptionListProps, RecordGrid, type RecordGridBooleanColumn, type RecordGridCellChange, type RecordGridCellOutcome, type RecordGridCellSource, type RecordGridColumn, type RecordGridColumnBase, type RecordGridCreateOutcome, type RecordGridCurrencyColumn, type RecordGridDateColumn, type RecordGridDependency, type RecordGridEmptyState, type RecordGridNumberColumn, type RecordGridOverlay, type RecordGridProps, type RecordGridRow, type RecordGridRowOutcome, type RecordGridSelectColumn, type RecordGridSelectOption, type RecordGridSourceBasis, type RecordGridState, type RecordGridTextColumn, type RecordGridValue, type RecordGridWriteOutcome, type RestoreChatInteractionsOptions, ReviewQueueItem, type ReviewQueuePage, ReviewQueuePanel, type ReviewQueuePanelProps, ReviewQueueState, RunDrillIn, type RunDrillInProps, SeatPaywall, type SeatPaywallProps, type SessionActionLabels, type SessionActions, type SessionActionsOptions, type SessionBulkAction, SessionHistoryPanel, type SessionHistoryPanelProps, type SessionHistoryState, type SessionPageQuery, type SmoothRevealOptions, type StreamChatOptions, type SubmitInteractionAnswer, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type UseChatInteractionsOptions, type UseChatInteractionsResult, type UseComposerAttachmentsOptions, type UseComposerAttachmentsResult, type UseDurablePlanFlowOptions, type UseDurablePlanFlowResult, type UseInfiniteScrollOptions, type UseSessionHistoryOptions, type WaterfallRow, WorkProductCard, type WorkProductCardProps, __resetAttachmentFileCacheForTests, activityTone, buildAnswerData, cancelChatInteraction, consumeChatStream, createDurableInteractionAnswerSubmitter, createDurablePlanDecisionClient, createInteractionAnswerSubmitter, createMemoryInteractionAttemptStore, createSessionInteractionAttemptStore, dispatchChatStreamLine, durableChatCardsFromParts, fieldAnswer, fieldValuesFromAnswers, formatActivityCost, formatActivityDuration, formatModelCost, formatRecordGridValue, formatSessionTimestamp, formatTokensPerSecond, hasSecretField, hydrateChatInteractions, interactionStatusLabels, interactionSubmissionSignature, interactionTerminalNotes, isLateAnswerableStatus, isRecordGridCellApplicable, lateAnswerMessage, loadAttachmentFile, mergeActivityPages, mergeReviewQueuePages, nextRevealCount, parseRecordGridInput, pendingApprovalOf, projectRecordGridRows, pruneRecordGridOverlay, readRecordGridCell, recordGridEditorText, recordGridFail, recordGridOk, recordGridRowLabel, resolveChatInteraction, responseErrorMessage, restoreChatInteractions, reviewQueueStateLabel, sameRecordGridValue, segmentMentionContent, settleInteractionSubmit, streamChatTurn, sumRecordGridColumn, terminalizePendingChatInteractions, triggerAttachmentDownload, upsertChatInteraction, useChatInteractions, useComposerAttachments, useDurablePlanFlow, useInfiniteScroll, usePending, usePopover, useSessionActions, useSessionHistory, useSmoothText, useThinkingSeconds, validateRecordGridCell, validateRecordGridRow, waterfallLayout, withRecordGridCreated, withRecordGridRemoved, withRecordGridServerRow, withRecordGridUpdate, withoutRecordGridCreated, withoutRecordGridRemoved, withoutRecordGridUpdate, workProductPartsFromMessageParts, workProductStatusLabel };
2226
+ export { type ActivityTone, type AgentActivityPage, AgentActivityPanel, type AgentActivityPanelProps, type AgentActivityRecord, AgentSessionControls, type AgentSessionControlsProps, type AttachmentFileResult, CatalogModel, ChatAttachmentInput, ChatAttachmentKind, ChatAttachmentPart, ChatComposer, type ChatComposerProps, type ChatEmptyDoor, ChatEmptyState, type ChatEmptyStateProps, ChatInteraction, ChatInteractionField, type ChatInteractionRestoreMode, ChatInteractionStatus, ChatMentionPart, type ChatMessageMetrics, type ChatMessageSegment, ChatMessages, type ChatMessagesProps, ChatSelectField, type ChatStreamCallbacks, type ChatStreamToolCall, type ChatStreamToolResult, type ChatToolCallInfo, type ChatUiMessage, type ComposerFile, type ComposerFilePart, type ComposerSendFailure, type ComposerSendHandler, type ComposerSendOutcome, type ComposerSendPartsHandler, type ComposerSendRejected, type ComposerSendResult, type ConsumeChatStreamResult, DEFAULT_EFFORT_LEVELS, DEFAULT_PROVENANCE_CONFIDENCE_POLICY, type DurableChatCard, DurableChatCards, type DurableChatCardsProps, type DurableInteractionAnswerSubmitterOptions, DurablePlanCard, type DurablePlanCardProps, DurablePlanClientError, type DurablePlanCurrentInput, type DurablePlanDecision, type DurablePlanDecisionClient, type DurablePlanDecisionClientOptions, type DurablePlanDecisionInput, type DurablePlanDecisionResult, type DurablePlanFollowUpReceipt, EMPTY_RECORD_GRID_OVERLAY, type EffortLevel, EffortPicker, type EffortPickerProps, EvidenceLineageTable, type EvidenceLineageTableProps, ExceptionList, type ExceptionListProps, type FetchSessionPage, type FieldValues, FlowWaterfall, type FlowWaterfallProps, INTERACTION_SUBMIT_TIMEOUT_MESSAGE, INTERACTION_SUBMIT_TIMEOUT_MS, InteractionActionButton, type InteractionAnswerSubmission, type InteractionAnswerSubmitterOptions, InteractionAnswers, type InteractionAttemptStore, InteractionBadge, type InteractionBadgeVariant, InteractionCancelData, InteractionPlanCard, type InteractionPlanCardProps, InteractionQuestionCard, type InteractionQuestionCardProps, InteractionRequestWire, type InteractionSubmitResult, type LinkLikeComponent, type LinkLikeProps, type MentionTextSegment, MessageAttachments, type MessageAttachmentsProps, MissionActivityLane, type MissionActivityLaneProps, ModelPicker, type ModelPickerProps, PROVENANCE_BASES, type ProposalApprovalHandlers, type ProvenanceBasis, type ProvenanceBasisMeta, type ProvenanceConfidencePolicy, type ProvenanceGap, type ProvenanceGapKind, ProvenanceLegend, type ProvenanceLegendProps, type ProvenanceRecord, type ProvenanceSource, type ProvenanceSourceStatus, ProvenanceStamp, type ProvenanceStampProps, type ProvenanceStanding, type ProvenanceStandingMeta, ProvenanceValue, type ProvenanceValueProps, ProviderLogo, type ProviderLogoProps, QualityCheckList, type QualityCheckListProps, QuestionOptionList, type QuestionOptionListProps, RecordGrid, type RecordGridBooleanColumn, type RecordGridCellChange, type RecordGridCellOutcome, type RecordGridCellSource, type RecordGridColumn, type RecordGridColumnBase, type RecordGridCreateOutcome, type RecordGridCurrencyColumn, type RecordGridDateColumn, type RecordGridDependency, type RecordGridEmptyState, type RecordGridNumberColumn, type RecordGridOverlay, type RecordGridProps, type RecordGridRow, type RecordGridRowOutcome, type RecordGridSelectColumn, type RecordGridSelectOption, type RecordGridSourceBasis, type RecordGridState, type RecordGridTextColumn, type RecordGridValue, type RecordGridWriteOutcome, type RestoreChatInteractionsOptions, ReviewQueueItem, type ReviewQueuePage, ReviewQueuePanel, type ReviewQueuePanelProps, ReviewQueueState, RunDrillIn, type RunDrillInProps, SeatPaywall, type SeatPaywallProps, type SessionActionLabels, type SessionActions, type SessionActionsOptions, type SessionBulkAction, SessionHistoryPanel, type SessionHistoryPanelProps, type SessionHistoryState, type SessionPageQuery, type SmoothRevealOptions, type StreamChatOptions, type SubmitInteractionAnswer, type ToolDetailRenderers, type ToolRunRecord, type ToolRunStep, type UseChatInteractionsOptions, type UseChatInteractionsResult, type UseComposerAttachmentsOptions, type UseComposerAttachmentsResult, type UseDurablePlanFlowOptions, type UseDurablePlanFlowResult, type UseInfiniteScrollOptions, type UseSessionHistoryOptions, type WaterfallRow, WorkProductCard, type WorkProductCardProps, __resetAttachmentFileCacheForTests, activityTone, buildAnswerData, cancelChatInteraction, consumeChatStream, createDurableInteractionAnswerSubmitter, createDurablePlanDecisionClient, createInteractionAnswerSubmitter, createMemoryInteractionAttemptStore, createSessionInteractionAttemptStore, describeProvenance, describeProvenanceSourceStatus, dispatchChatStreamLine, durableChatCardsFromParts, fieldAnswer, fieldValuesFromAnswers, formatActivityCost, formatActivityDuration, formatModelCost, formatRecordGridValue, formatSessionTimestamp, formatTokensPerSecond, hasSecretField, hydrateChatInteractions, interactionStatusLabels, interactionSubmissionSignature, interactionTerminalNotes, isLateAnswerableStatus, isRecordGridCellApplicable, lateAnswerMessage, loadAttachmentFile, loadingProvenanceSources, mergeActivityPages, mergeReviewQueuePages, nextRevealCount, parseRecordGridInput, pendingApprovalOf, projectRecordGridRows, provenanceBasisMeta, provenanceGaps, provenanceNextMove, provenanceStandingMeta, provenanceTriggerLabel, pruneRecordGridOverlay, readRecordGridCell, recordGridEditorText, recordGridFail, recordGridOk, recordGridRowLabel, resolveChatInteraction, resolveProvenanceStanding, responseErrorMessage, restoreChatInteractions, reviewQueueStateLabel, rollUpProvenanceStanding, sameRecordGridValue, segmentMentionContent, settleInteractionSubmit, standingFromConfidence, streamChatTurn, sumRecordGridColumn, terminalizePendingChatInteractions, triggerAttachmentDownload, upsertChatInteraction, useChatInteractions, useComposerAttachments, useDurablePlanFlow, useInfiniteScroll, usePending, usePopover, useSessionActions, useSessionHistory, useSmoothText, useThinkingSeconds, validateRecordGridCell, validateRecordGridRow, waterfallLayout, weakerProvenanceStanding, withRecordGridCreated, withRecordGridRemoved, withRecordGridServerRow, withRecordGridUpdate, withoutRecordGridCreated, withoutRecordGridRemoved, withoutRecordGridUpdate, workProductPartsFromMessageParts, workProductStatusLabel };
@@ -7,6 +7,7 @@ import {
7
7
  DEFAULT_EFFORT_LEVELS,
8
8
  DEFAULT_MENTION_EMPTY_TEXT,
9
9
  DEFAULT_MENTION_LIMIT,
10
+ DEFAULT_PROVENANCE_CONFIDENCE_POLICY,
10
11
  DurableChatCards,
11
12
  DurablePlanCard,
12
13
  DurablePlanClientError,
@@ -23,6 +24,9 @@ import {
23
24
  MessageAttachments,
24
25
  MissionActivityLane,
25
26
  ModelPicker,
27
+ PROVENANCE_BASES,
28
+ ProvenanceLegend,
29
+ ProvenanceValue,
26
30
  ProviderLogo,
27
31
  QuestionOptionList,
28
32
  RecordGrid,
@@ -39,6 +43,8 @@ import {
39
43
  createInteractionAnswerSubmitter,
40
44
  createMemoryInteractionAttemptStore,
41
45
  createSessionInteractionAttemptStore,
46
+ describeProvenance,
47
+ describeProvenanceSourceStatus,
42
48
  dispatchChatStreamLine,
43
49
  durableChatCardsFromParts,
44
50
  fieldAnswer,
@@ -58,11 +64,17 @@ import {
58
64
  isRecordGridCellApplicable,
59
65
  lateAnswerMessage,
60
66
  loadAttachmentFile,
67
+ loadingProvenanceSources,
61
68
  mergeActivityPages,
62
69
  nextRevealCount,
63
70
  parseRecordGridInput,
64
71
  pendingApprovalOf,
65
72
  projectRecordGridRows,
73
+ provenanceBasisMeta,
74
+ provenanceGaps,
75
+ provenanceNextMove,
76
+ provenanceStandingMeta,
77
+ provenanceTriggerLabel,
66
78
  pruneRecordGridOverlay,
67
79
  rankFileMentions,
68
80
  readRecordGridCell,
@@ -71,11 +83,14 @@ import {
71
83
  recordGridOk,
72
84
  recordGridRowLabel,
73
85
  resolveChatInteraction,
86
+ resolveProvenanceStanding,
74
87
  responseErrorMessage,
75
88
  restoreChatInteractions,
89
+ rollUpProvenanceStanding,
76
90
  sameRecordGridValue,
77
91
  segmentMentionContent,
78
92
  settleInteractionSubmit,
93
+ standingFromConfidence,
79
94
  streamChatTurn,
80
95
  sumRecordGridColumn,
81
96
  terminalizePendingChatInteractions,
@@ -94,6 +109,7 @@ import {
94
109
  validateRecordGridCell,
95
110
  validateRecordGridRow,
96
111
  waterfallLayout,
112
+ weakerProvenanceStanding,
97
113
  withRecordGridCreated,
98
114
  withRecordGridRemoved,
99
115
  withRecordGridServerRow,
@@ -101,7 +117,7 @@ import {
101
117
  withoutRecordGridCreated,
102
118
  withoutRecordGridRemoved,
103
119
  withoutRecordGridUpdate
104
- } from "../chunk-NZVBJM73.js";
120
+ } from "../chunk-KOMP6NDW.js";
105
121
  import "../chunk-FBVLEGEG.js";
106
122
  import {
107
123
  useComposerAttachments
@@ -122,7 +138,7 @@ import {
122
138
  reviewQueueStateLabel,
123
139
  workProductPartsFromMessageParts,
124
140
  workProductStatusLabel
125
- } from "../chunk-YTMKRL3L.js";
141
+ } from "../chunk-HZ4WCA37.js";
126
142
  import {
127
143
  parseReviewQueueItem
128
144
  } from "../chunk-GEYACSFW.js";
@@ -191,6 +207,7 @@ export {
191
207
  DEFAULT_EFFORT_LEVELS,
192
208
  DEFAULT_MENTION_EMPTY_TEXT,
193
209
  DEFAULT_MENTION_LIMIT,
210
+ DEFAULT_PROVENANCE_CONFIDENCE_POLICY,
194
211
  DISPATCH_MAX_MEDIA_PARTS,
195
212
  DISPATCH_MAX_PARTS,
196
213
  DISPATCH_REQUEST_MAX_BYTES,
@@ -216,7 +233,10 @@ export {
216
233
  MessageAttachments,
217
234
  MissionActivityLane,
218
235
  ModelPicker,
236
+ PROVENANCE_BASES,
237
+ ProvenanceLegend,
219
238
  ProvenanceStamp,
239
+ ProvenanceValue,
220
240
  ProviderLogo,
221
241
  QualityCheckList,
222
242
  QuestionOptionList,
@@ -248,6 +268,8 @@ export {
248
268
  createMemoryInteractionAttemptStore,
249
269
  createSessionInteractionAttemptStore,
250
270
  dedupeQuestionInteractionsByContent,
271
+ describeProvenance,
272
+ describeProvenanceSourceStatus,
251
273
  dispatchChatStreamLine,
252
274
  durableChatCardsFromParts,
253
275
  fieldAcceptsFreeText,
@@ -276,6 +298,7 @@ export {
276
298
  isTerminalInteractionStatus,
277
299
  lateAnswerMessage,
278
300
  loadAttachmentFile,
301
+ loadingProvenanceSources,
279
302
  mediaTypeForMentionPath,
280
303
  mentionInputToPart,
281
304
  mentionKindForPath,
@@ -293,6 +316,11 @@ export {
293
316
  pendingApprovalOf,
294
317
  persistedPartToInteraction,
295
318
  projectRecordGridRows,
319
+ provenanceBasisMeta,
320
+ provenanceGaps,
321
+ provenanceNextMove,
322
+ provenanceStandingMeta,
323
+ provenanceTriggerLabel,
296
324
  pruneRecordGridOverlay,
297
325
  questionInteractionContentSignature,
298
326
  rankFileMentions,
@@ -302,13 +330,16 @@ export {
302
330
  recordGridOk,
303
331
  recordGridRowLabel,
304
332
  resolveChatInteraction,
333
+ resolveProvenanceStanding,
305
334
  responseErrorMessage,
306
335
  restoreChatInteractions,
307
336
  reviewQueueStateLabel,
337
+ rollUpProvenanceStanding,
308
338
  sameRecordGridValue,
309
339
  segmentMentionContent,
310
340
  settleInteractionSubmit,
311
341
  stampInteractionAnswers,
342
+ standingFromConfidence,
312
343
  streamChatTurn,
313
344
  sumRecordGridColumn,
314
345
  tabTerminalConnectionId,
@@ -330,6 +361,7 @@ export {
330
361
  validateRecordGridCell,
331
362
  validateRecordGridRow,
332
363
  waterfallLayout,
364
+ weakerProvenanceStanding,
333
365
  withRecordGridCreated,
334
366
  withRecordGridRemoved,
335
367
  withRecordGridServerRow,
@@ -4,7 +4,7 @@ import {
4
4
  ProvenanceStamp,
5
5
  QualityCheckList,
6
6
  workProductStatusLabel
7
- } from "../chunk-YTMKRL3L.js";
7
+ } from "../chunk-HZ4WCA37.js";
8
8
  import "../chunk-GEYACSFW.js";
9
9
  import {
10
10
  unresolvedBlockingExceptions
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tangle-network/agent-app",
3
- "version": "0.45.22",
3
+ "version": "0.45.24",
4
4
  "packageManager": "pnpm@11.17.0",
5
5
  "description": "Build agent applications with typed chat, tools, sandboxes, integrations, billing, and evaluation.",
6
6
  "keywords": [
@@ -33,6 +33,7 @@
33
33
  ],
34
34
  "bin": {
35
35
  "agent-app-theme-check": "./dist/theme-contract/cli.js",
36
+ "agent-app-legibility-check": "./dist/legibility/cli.js",
36
37
  "agent-app-preflight": "./dist/preflight/cli.js",
37
38
  "agent-app-peer-check": "./dist/peer-floors/cli.js"
38
39
  },
@@ -460,6 +461,11 @@
460
461
  "default": "./dist/theme-contract/index.js"
461
462
  },
462
463
  "./styles": "./dist/theme/tokens.css",
464
+ "./legibility": {
465
+ "types": "./dist/legibility/index.d.ts",
466
+ "import": "./dist/legibility/index.js",
467
+ "default": "./dist/legibility/index.js"
468
+ },
463
469
  "./peer-floors": {
464
470
  "types": "./dist/peer-floors/check.d.ts",
465
471
  "import": "./dist/peer-floors/check.js",
@@ -1,7 +0,0 @@
1
- import {
2
- VaultPane
3
- } from "./chunk-FVJP2RTC.js";
4
- export {
5
- VaultPane
6
- };
7
- //# sourceMappingURL=VaultPane-HFH734K6.js.map