@muse-code/sdk 0.1.1 → 1.3.0
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.
- package/README.md +56 -253
- package/dist/src/facade/approval.d.ts +21 -1
- package/dist/src/facade/approval.js +97 -1
- package/dist/src/facade/client.d.ts +3 -4
- package/dist/src/facade/client.js +7 -3
- package/dist/src/facade/session.js +26 -12
- package/dist/src/fingerprint.d.ts +1 -1
- package/dist/src/fingerprint.js +1 -1
- package/dist/src/fold/session-fold.d.ts +74 -12
- package/dist/src/fold/session-fold.js +6 -2
- package/dist/src/index.d.ts +8 -1
- package/dist/src/msp.d.ts +477 -13
- package/package.json +9 -1
package/dist/src/msp.d.ts
CHANGED
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
// artifact (spec 14990 INV-008) while the tarball stays self-contained.
|
|
7
7
|
|
|
8
8
|
// Muse Session Protocol (MSP) v1 TypeScript declarations.
|
|
9
|
+
// STABLE surface only; experimental twin: experimental/msp.d.ts.
|
|
9
10
|
// Generated by tbh-protocol (spec 206) from the same schema model as
|
|
10
11
|
// the JSON Schema bundle (INV-017). Do not edit by hand.
|
|
11
12
|
|
|
@@ -112,6 +113,8 @@ export interface ApprovalRequestParams {
|
|
|
112
113
|
rawArgs: string;
|
|
113
114
|
sessionId: string;
|
|
114
115
|
sourceRange: SourceRange;
|
|
116
|
+
/** Present only for a child (native subagent) approval projected onto the parent session's plane (ADR 36182); parent-own approvals omit it. */
|
|
117
|
+
subagentOrigin?: ApprovalSubagentOrigin;
|
|
115
118
|
subject: ApprovalSubject;
|
|
116
119
|
taskId: string;
|
|
117
120
|
toolCallId: string;
|
|
@@ -147,6 +150,8 @@ export interface ApprovalResolvedParams {
|
|
|
147
150
|
sessionId: string;
|
|
148
151
|
sourceRange: SourceRange;
|
|
149
152
|
stageEvidence: ApprovalStageEvidence[];
|
|
153
|
+
/** Present only for a child (native subagent) approval projected onto the parent session's plane (ADR 36182); parent-own approvals omit it. */
|
|
154
|
+
subagentOrigin?: ApprovalSubagentOrigin;
|
|
150
155
|
turnId: string;
|
|
151
156
|
viewCursor: string;
|
|
152
157
|
}
|
|
@@ -175,12 +180,22 @@ export interface ApprovalStageResolution {
|
|
|
175
180
|
kind: string;
|
|
176
181
|
}
|
|
177
182
|
|
|
183
|
+
/** Child (native subagent) provenance for an approval projected onto the PARENT session's approval plane (#36182 / ADR 36182): identifies the originating child run/agent so a client can attribute the prompt. Omitted (`skip_serializing_if`) on the parent's own approvals, so pre-existing parent frames stay byte-identical. */
|
|
184
|
+
export interface ApprovalSubagentOrigin {
|
|
185
|
+
/** The child run that parked on this approval. */
|
|
186
|
+
childRunId: string;
|
|
187
|
+
/** The child session stream id whose records carry this approval. */
|
|
188
|
+
childSessionId: string;
|
|
189
|
+
/** The originating child's subagent id, from the parent session's durable subagent control records. */
|
|
190
|
+
subagentId: string;
|
|
191
|
+
}
|
|
192
|
+
|
|
178
193
|
/** Open approval subject union. Unknown kinds are rendered generically and never auto-approved by clients (tdd SS5.2). */
|
|
179
194
|
export interface ApprovalSubject {
|
|
180
195
|
access?: string;
|
|
181
196
|
command?: string;
|
|
182
197
|
host?: string;
|
|
183
|
-
/** Open discriminator: `shell | fileAccess | network | process | tool`. */
|
|
198
|
+
/** Open discriminator: `shell | fileAccess | network | unixSocket | process | tool`. */
|
|
184
199
|
kind: string;
|
|
185
200
|
origin?: ApprovalOrigin;
|
|
186
201
|
path?: string;
|
|
@@ -205,10 +220,15 @@ export interface ApprovalUpdatedParams {
|
|
|
205
220
|
currentRequirementId: ApprovalRequirementRef;
|
|
206
221
|
sessionId: string;
|
|
207
222
|
sourceRange: SourceRange;
|
|
223
|
+
/** Present only for a child (native subagent) approval projected onto the parent session's plane (ADR 36182); parent-own approvals omit it. */
|
|
224
|
+
subagentOrigin?: ApprovalSubagentOrigin;
|
|
208
225
|
subject: ApprovalSubject;
|
|
209
226
|
viewCursor: string;
|
|
210
227
|
}
|
|
211
228
|
|
|
229
|
+
/** One attention flag (tdd SS2.4, ADR 31983 D3): a pending server-initiated request class parked on the session. Open on the wire — clients MUST ignore unknown values; future attention kinds are additive. */
|
|
230
|
+
export type AttentionFlag = "approvalPending" | "inputPending" | (string & {});
|
|
231
|
+
|
|
212
232
|
/** Who durably backgrounded a task (tdd SS4.5.5, `TaskBackgroundedInitiator`). Open — runtime vocabulary. */
|
|
213
233
|
export type BackgroundInitiator = "user" | "timeout" | (string & {});
|
|
214
234
|
|
|
@@ -223,7 +243,7 @@ export interface BranchState {
|
|
|
223
243
|
}
|
|
224
244
|
|
|
225
245
|
/** A grantable capability name (SS1.4.4). Open: the reserved `rawLog` entry joins this domain as an additive open-enum extension when SS6 un-defers (#13929, Scenario 5 AS-3) — closed would make that a retype. */
|
|
226
|
-
export type CapabilityName = "userShell" | (string & {});
|
|
246
|
+
export type CapabilityName = "userShell" | "sessionMcp" | "sessionListStream" | (string & {});
|
|
227
247
|
|
|
228
248
|
/** The client's requested capability posture (SS1.4.1). Every member defaults; an absent `capabilities` object means all defaults. */
|
|
229
249
|
export interface ClientCapabilities {
|
|
@@ -233,6 +253,8 @@ export interface ClientCapabilities {
|
|
|
233
253
|
optOutNotificationMethods?: string[];
|
|
234
254
|
/** Names from the capability registry. Unknown entries are not an error and simply do not appear in `grantedCapabilities` — which is why this is a list of free strings rather than of registry names. */
|
|
235
255
|
requestedCapabilities?: string[];
|
|
256
|
+
/** Whether this client can render a `userInput/request` dialog and answer it (SS5.10). **Absent means capable** (D-047): a client that predates the member keeps today's contract, so no existing client changes its handshake. `false` makes the host withhold `userInput/request` toward this client — the D-027 additive-optional-field + withheld-method convention. Deliberately NOT a `requestedCapabilities` name: that registry records operations a host GRANTS (SS1.4.4), and whether a client can draw a dialog is a fact about the client, never a privilege the host hands out. */
|
|
257
|
+
userInputDialogs?: boolean;
|
|
236
258
|
}
|
|
237
259
|
|
|
238
260
|
/** Client identification inside `initialize` params (SS1.4.1). Diagnostics and telemetry attribution only; never an authority claim (SS1.10). */
|
|
@@ -319,6 +341,8 @@ export interface ErrorData {
|
|
|
319
341
|
anchor?: string | null;
|
|
320
342
|
/** Approval identity on SS5 errors. */
|
|
321
343
|
approvalId?: string;
|
|
344
|
+
/** The stored output's availability on `outputUnavailable` — the durable `ToolOutputAvailability` value, read-time-derived when the durable record still says `available` (SS4.5.5; spec 208 FM-008). */
|
|
345
|
+
availability?: string;
|
|
322
346
|
/** The missing capability, on `capabilityRequired` errors. Typed on the grantable registry, so `rawLog` is outside the v1 domain and joins it as an additive open-enum extension when SS6 un-defers (TEST-009). */
|
|
323
347
|
capability?: CapabilityName;
|
|
324
348
|
/** The configured command-admission bound, on `backpressured` errors. */
|
|
@@ -335,6 +359,8 @@ export interface ErrorData {
|
|
|
335
359
|
details?: Record<string, unknown>;
|
|
336
360
|
/** The oldest servable view position on `viewTruncated` (`-32040`, SS4.11); served as an explicit `null` when nothing before the head is servable — the null is present on the wire, never a dropped key (spec 208 FM-005 / Scenario 6.2). */
|
|
337
361
|
earliestCursor?: string | null;
|
|
362
|
+
/** The item whose stored output was requested, on the `item/readOutput` arms (`notFound`, `outputUnavailable`, and the misaligned-offset `invalidParams`). */
|
|
363
|
+
itemId?: string;
|
|
338
364
|
/** The stable camelCase category clients branch on. */
|
|
339
365
|
kind: ErrorKind;
|
|
340
366
|
/** Rejected inclusive fork boundary on `forkBoundaryInvalid`. */
|
|
@@ -343,6 +369,8 @@ export interface ErrorData {
|
|
|
343
369
|
latestBoundaryCursor?: string | null;
|
|
344
370
|
/** The exceeded byte limit, on `inputTooLarge` errors. */
|
|
345
371
|
limitBytes?: number;
|
|
372
|
+
/** The requested `outputRef.id`, on the same `item/readOutput` arms. */
|
|
373
|
+
outputRef?: string;
|
|
346
374
|
/** Candidate retained paths on `sessionAmbiguous`. */
|
|
347
375
|
paths?: string[];
|
|
348
376
|
/** Failure detail vocabulary (e.g. `"missingAnchor"` on `notFound` for a missing view-cursor anchor). */
|
|
@@ -351,6 +379,8 @@ export interface ErrorData {
|
|
|
351
379
|
resolution?: ApprovalResolutionSummary;
|
|
352
380
|
/** Whether retrying can succeed (e.g. `overloaded`). When present, overrides the error table row's `retryable` default for this code. */
|
|
353
381
|
retryable?: boolean;
|
|
382
|
+
/** The rejected skill selector on `skillNotFound` (`-32032`, SS3.22.4). */
|
|
383
|
+
selector?: string;
|
|
354
384
|
/** Session identity on errors whose lookup is session-scoped. */
|
|
355
385
|
sessionId?: string;
|
|
356
386
|
/** Winning settlement on `userInputAlreadySettled`. */
|
|
@@ -362,7 +392,7 @@ export interface ErrorData {
|
|
|
362
392
|
}
|
|
363
393
|
|
|
364
394
|
/** A stable `error.data.kind` category (SS1.6): camelCase, the value clients branch on. Open: SS2–SS5 lanes add kinds additively as their methods land (Appendix B already registers them), and the spec's edge-case rule makes a new `kind` additive only because this domain is declared open. */
|
|
365
|
-
export type ErrorKind = "parseError" | "invalidRequest" | "notInitialized" | "alreadyInitialized" | "methodNotFound" | "invalidParams" | "experimentalRequired" | "internal" | "pageEventTooLarge" | "outputResultTooLarge" | "overloaded" | "inputTooLarge" | "capabilityRequired" | "notFound" | "interrupted" | "cancelled" | "sessionNotFound" | "sessionInUse" | "sessionAmbiguous" | "forkBoundaryInvalid" | "sessionNotLoaded" | "sessionStreamMismatch" | "commandRejected" | "backpressured" | "viewTruncated" | "boundaryPruned" | "boundaryUnusable" | "noBoundary" | "approvalNotFound" | "approvalAlreadyResolved" | "approvalChoiceInvalid" | "approvalRequirementStale" | "approvalReviewerUnavailable" | "userInputNotFound" | "userInputAlreadySettled" | "userInputAnswerInvalid" | (string & {});
|
|
395
|
+
export type ErrorKind = "parseError" | "invalidRequest" | "notInitialized" | "alreadyInitialized" | "methodNotFound" | "invalidParams" | "experimentalRequired" | "internal" | "pageEventTooLarge" | "outputResultTooLarge" | "overloaded" | "inputTooLarge" | "capabilityRequired" | "notFound" | "interrupted" | "cancelled" | "sessionNotFound" | "sessionInUse" | "sessionAmbiguous" | "forkBoundaryInvalid" | "sessionNotLoaded" | "sessionStreamMismatch" | "commandRejected" | "backpressured" | "skillNotFound" | "viewTruncated" | "outputUnavailable" | "boundaryPruned" | "boundaryUnusable" | "noBoundary" | "approvalNotFound" | "approvalAlreadyResolved" | "approvalChoiceInvalid" | "approvalRequirementStale" | "approvalReviewerUnavailable" | "userInputNotFound" | "userInputAlreadySettled" | "userInputAnswerInvalid" | (string & {});
|
|
366
396
|
|
|
367
397
|
/** The `error` member of an error response (SS1.2 §2.4). */
|
|
368
398
|
export interface ErrorObject {
|
|
@@ -416,6 +446,60 @@ export interface Goal {
|
|
|
416
446
|
status: string;
|
|
417
447
|
}
|
|
418
448
|
|
|
449
|
+
/** `goal/clear` params (tdd SS3.18). An `objective` here is an unknown field and rejects `-32602 invalidParams` — the bare verbs carry exactly this pair. */
|
|
450
|
+
export interface GoalClearParams {
|
|
451
|
+
/** The SS3.1.1 idempotency handle (UUIDv7). */
|
|
452
|
+
commandId: string;
|
|
453
|
+
/** The target session. */
|
|
454
|
+
sessionId: string;
|
|
455
|
+
}
|
|
456
|
+
|
|
457
|
+
/** The shared SS3.18 goal ack, admission-only: all five verbs answer this one shape (the tdd's "Shared contract"), differing only in when `turnId` is present. */
|
|
458
|
+
export interface GoalCommandResult {
|
|
459
|
+
/** Echoes the client's id. */
|
|
460
|
+
commandId: string;
|
|
461
|
+
/** Admission status. */
|
|
462
|
+
status: CommandStatus;
|
|
463
|
+
/** Present by exactly the four SS3.18 result cases: an idle wake carries the fresh goal turn's id; a busy `set`/`edit`/`resume` carries the admission-time active turn's id (a routing fact, not a delivery promise); `pause`/`clear` never carry it; an idle admission whose resulting goal is not unfinished parks the notification and carries none. **Additive-optional**: absent means "no turn named", never fabricated. */
|
|
464
|
+
turnId?: string;
|
|
465
|
+
}
|
|
466
|
+
|
|
467
|
+
/** `goal/edit` params (tdd SS3.18): replace the current goal's objective. Same shape as `goal/set`; the verbs differ in their `missing_goal` precondition, not their payload. */
|
|
468
|
+
export interface GoalEditParams {
|
|
469
|
+
/** The SS3.1.1 idempotency handle (UUIDv7). */
|
|
470
|
+
commandId: string;
|
|
471
|
+
/** The replacement objective; same trim/non-empty rule as `goal/set`. */
|
|
472
|
+
objective: string;
|
|
473
|
+
/** The target session. */
|
|
474
|
+
sessionId: string;
|
|
475
|
+
}
|
|
476
|
+
|
|
477
|
+
/** `goal/pause` params (tdd SS3.18); shape as `goal/clear`. */
|
|
478
|
+
export interface GoalPauseParams {
|
|
479
|
+
/** The SS3.1.1 idempotency handle (UUIDv7). */
|
|
480
|
+
commandId: string;
|
|
481
|
+
/** The target session. */
|
|
482
|
+
sessionId: string;
|
|
483
|
+
}
|
|
484
|
+
|
|
485
|
+
/** `goal/resume` params (tdd SS3.18); shape as `goal/clear`. */
|
|
486
|
+
export interface GoalResumeParams {
|
|
487
|
+
/** The SS3.1.1 idempotency handle (UUIDv7). */
|
|
488
|
+
commandId: string;
|
|
489
|
+
/** The target session. */
|
|
490
|
+
sessionId: string;
|
|
491
|
+
}
|
|
492
|
+
|
|
493
|
+
/** `goal/set` params (tdd SS3.18): set the session's goal objective. */
|
|
494
|
+
export interface GoalSetParams {
|
|
495
|
+
/** The SS3.1.1 idempotency handle (UUIDv7). */
|
|
496
|
+
commandId: string;
|
|
497
|
+
/** The objective text; required, non-empty after Unicode-whitespace trim (the trimmed text is the payload). Empty-after-trim is `-32602 invalidParams` (tdd SS3.18). */
|
|
498
|
+
objective: string;
|
|
499
|
+
/** The target session. */
|
|
500
|
+
sessionId: string;
|
|
501
|
+
}
|
|
502
|
+
|
|
419
503
|
/** What history a lifecycle result actually served (tdd SS2.5.2). Open on the client side: report-what-was-served means a client treats an unknown mode as "page it yourself". */
|
|
420
504
|
export type HistoryMode = "anchoredSnapshot" | "inline" | "snapshot" | "none" | (string & {});
|
|
421
505
|
|
|
@@ -520,6 +604,10 @@ export interface Item {
|
|
|
520
604
|
outcome?: CompactionOutcome;
|
|
521
605
|
/** `toolCall`/`userShell`: stored-output reference; fetch the full bytes via `item/readOutput` (served by #208). */
|
|
522
606
|
outputRef?: OutputRef;
|
|
607
|
+
/** `toolCall`: stored structured-patch reference (`kind: "tool_patch"`, `mediaType: "application/json"`); the body is fetched via `item/readOutput` with `patchRef.id`, and the ref survives the SS2.5.2 elided-snapshot rung exactly like `outputRef` without ever being an elision trigger (tdd SS2.5.2, SS4.5.5; #33025). */
|
|
608
|
+
patchRef?: OutputRef;
|
|
609
|
+
/** `toolCall`: server-authored edit-family diff summary (#33025) — always beside `patchRef`; absent = no diff available (tdd SS4.5.5). */
|
|
610
|
+
patchSummary?: PatchSummary;
|
|
523
611
|
/** `reasoning`: provider reasoning item id (e.g. `rs_...`), for provider-side correlation. */
|
|
524
612
|
providerItemId?: string;
|
|
525
613
|
/** `compaction`: noop/failure reason, verbatim (snake_case durable vocabulary, e.g. `"no_compactable_history"`). */
|
|
@@ -569,7 +657,7 @@ export interface Item {
|
|
|
569
657
|
/** `true` when the server's per-surface text budget saturated a streamed surface (`agentMessage.text`, `reasoning.summary[*]`, `toolCall.visibleOutput`, `userShell.visibleOutput`); the durable full text remains in the log (tdd SS4.5.4). */
|
|
570
658
|
truncated?: boolean;
|
|
571
659
|
/** The owning turn (== the submitting `commandId` for fresh turns, tdd SS3.1.4). `null` only for `userShell` — the one kind outside a turn (tdd SS4.5.6). */
|
|
572
|
-
turnId?: string;
|
|
660
|
+
turnId?: string | null;
|
|
573
661
|
/** `subagent`: **transitive** observed usage — the child and its own descendants; updated in place, absent until first observation; never folded into `session/tokenUsage.cumulative` (tdd SS4.6.5). */
|
|
574
662
|
usage?: TokenUsage;
|
|
575
663
|
/** `toolCall`/`userShell`: bounded transcript-visible result text (budget per tdd SS4.5.4); streams via `item/delta` field `"output"`. */
|
|
@@ -607,6 +695,39 @@ export interface ItemDeltaParams {
|
|
|
607
695
|
/** The nine v1 item kinds (tdd SS4.5.2–4.5.10). Open: a new kind is additive evolution, and clients MUST render unknown kinds generically (tdd SS4.10). */
|
|
608
696
|
export type ItemKind = "userMessage" | "agentMessage" | "reasoning" | "toolCall" | "userShell" | "subagent" | "workflow" | "reminderChild" | "compaction" | (string & {});
|
|
609
697
|
|
|
698
|
+
/** The `item/readOutput` content encoding (tdd SS4.7.4). Closed: text media is ALWAYS `utf8` and binary media `base64`; a third value would change the client's decode contract. */
|
|
699
|
+
export type ItemReadOutputEncoding = "utf8" | "base64";
|
|
700
|
+
|
|
701
|
+
/** `item/readOutput` params (tdd SS4.7.4): byte-ranged fetch of stored full output that the view truncated — the `outputRef` fetch path SS3.9 and SS4.5.5 owe. Read-only; works on loaded and unloaded sessions; no lease. */
|
|
702
|
+
export interface ItemReadOutputParams {
|
|
703
|
+
/** The item whose stored output is fetched. */
|
|
704
|
+
itemId: string;
|
|
705
|
+
/** STORED bytes requested; default and max 6 MiB (tdd SS4.7.4). A value above the max is served at the max. */
|
|
706
|
+
lengthBytes?: number;
|
|
707
|
+
/** STORED-byte offset to start from; 0 when omitted. STORED bytes are a property of the output, not of a transport (tdd SS4.7.4). */
|
|
708
|
+
offsetBytes?: number;
|
|
709
|
+
/** The `outputRef.id` from the item (never the `uri`; the uri is display/provenance). */
|
|
710
|
+
outputRef: string;
|
|
711
|
+
/** The session the item belongs to. */
|
|
712
|
+
sessionId: string;
|
|
713
|
+
}
|
|
714
|
+
|
|
715
|
+
/** `item/readOutput` result (tdd SS4.7.4): one stored-byte page. */
|
|
716
|
+
export interface ItemReadOutputResult {
|
|
717
|
+
/** STORED bytes served in THIS response (not the output's total; that is `outputRef.byteLen` on the item). The next page's `offsetBytes` is `offsetBytes + byteLen` — short-serving and advancing are separate, so paging never skips or double-reads a byte (tdd SS4.7.4). */
|
|
718
|
+
byteLen: number;
|
|
719
|
+
/** The served range, decoded per `encoding`. */
|
|
720
|
+
content: string;
|
|
721
|
+
/** How `content` encodes the stored bytes. */
|
|
722
|
+
encoding: ItemReadOutputEncoding;
|
|
723
|
+
/** `true` when this range reached the end of the stored output. */
|
|
724
|
+
eof: boolean;
|
|
725
|
+
/** The stored output's media type (e.g. `text/plain`). */
|
|
726
|
+
mediaType: string;
|
|
727
|
+
/** The STORED-byte offset this response actually served from. */
|
|
728
|
+
offsetBytes: number;
|
|
729
|
+
}
|
|
730
|
+
|
|
610
731
|
/** `item/started` params (tdd SS4.3): a new item opened on the transcript. `sourceRange` is absent when the item opens on an ephemeral record (the delta-streamed kinds); the item's authoritative open is re-stated by its durable-sourced `item/completed` (tdd SS4.2). */
|
|
611
732
|
export interface ItemStartedParams {
|
|
612
733
|
/** The full item at revision 1. */
|
|
@@ -774,6 +895,16 @@ export interface OutputRef {
|
|
|
774
895
|
/** Whether a stored output's bytes are servable (tdd SS4.5.5). Open — durable runtime vocabulary may grow additively. */
|
|
775
896
|
export type OutputRefAvailability = "available" | "missing" | "unsupported" | "accessFailed" | (string & {});
|
|
776
897
|
|
|
898
|
+
/** Server-authored edit-family diff summary (tdd SS4.5.5, #33025): `files` counts the stored patch document's file entries; `added` and `removed` are the total `+`/`-` prefixed LINE counts summed over the stored patch's hunks across all files — line counts, never hunk or byte counts. Rides the `toolCall` item beside `patchRef`; the body is fetched via `item/readOutput` with `patchRef.id`. */
|
|
899
|
+
export interface PatchSummary {
|
|
900
|
+
/** Total `+`-prefixed line count across all files' hunks. */
|
|
901
|
+
added: number;
|
|
902
|
+
/** File entries in the stored patch document. */
|
|
903
|
+
files: number;
|
|
904
|
+
/** Total `-`-prefixed line count across all files' hunks. */
|
|
905
|
+
removed: number;
|
|
906
|
+
}
|
|
907
|
+
|
|
777
908
|
/** A pending approval in the snapshot: the SS2.5.2 pointer shape plus the gated `itemId` when one exists (tdd SS4.9.1). */
|
|
778
909
|
export interface PendingApprovalPointer {
|
|
779
910
|
/** The pending approval's id. */
|
|
@@ -816,7 +947,18 @@ export type PlatformFamily = "unix" | "windows";
|
|
|
816
947
|
export type PlatformOs = "macos" | "linux" | "windows";
|
|
817
948
|
|
|
818
949
|
/** The reasoning-effort tier sampled at submission (tdd SS3.2, SS3.3). The **same closed tier vocabulary** on both the fresh-turn and steer lanes, spelled identically; invalid tiers are invalid params. `none` is a tier of the vocabulary (ask for no reasoning), not a way to say "unset". */
|
|
819
|
-
export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "ultra";
|
|
950
|
+
export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | "ultra";
|
|
951
|
+
|
|
952
|
+
/** What drove a reasoning-effort default change (tdd SS4.6.9). Open; v1's only producer is `user` (an accepted `session/setReasoningEffort`). */
|
|
953
|
+
export type ReasoningEffortChangeSource = "user" | "default" | "policy" | (string & {});
|
|
954
|
+
|
|
955
|
+
/** The snapshot's standing session-default reasoning effort (tdd SS4.9.1, ADR 31255 D1): the fold of the latest completed `runtime.reasoning_effort_reconfigure` fact — the same pair `session/reasoningEffortChanged` carries. */
|
|
956
|
+
export interface ReasoningEffortState {
|
|
957
|
+
/** The standing default tier — the closed SS3.2 vocabulary, spelled identically to `turn/start.reasoningEffort`. */
|
|
958
|
+
reasoningEffort: ReasoningEffort;
|
|
959
|
+
/** Which actor class set the default. */
|
|
960
|
+
source: ReasoningEffortChangeSource;
|
|
961
|
+
}
|
|
820
962
|
|
|
821
963
|
/** One end of a [`SourceRange`]: a record's event id and its sequence number within the stream (tdd SS4.2). */
|
|
822
964
|
export interface RecordPosition {
|
|
@@ -843,6 +985,10 @@ export interface Request {
|
|
|
843
985
|
/** A request id (SS1.3): client-chosen string or integer. `1` and `"1"` do not compare equal; each direction owns its own id space. */
|
|
844
986
|
export type RequestId = number | string;
|
|
845
987
|
|
|
988
|
+
/** The SS5.3.3 presentation receipt — the client's response to a server-initiated request (`approval/request`, `userInput/request`). The response acknowledges presentation only ("a surface showed or will show this"): it changes no state, the server uses it for diagnostics alone, and the decision/answer travels as a command (`approval/decide`, `userInput/answer`). An error response or a dropped connection means this connection could not present the request; the approval or prompt stays pending and the request is re-issued on the next subscribe (SS5.6). There is no dismiss-without-deciding on the wire. */
|
|
989
|
+
export interface RequestReceipt {
|
|
990
|
+
}
|
|
991
|
+
|
|
846
992
|
/** The `schema` pair in [`InitializeResult`] (SS1.4.1, SS1.5.3). `version` is the wire **envelope** schema version — distinct from the session-view `schemaVersion`, the raw-log `schema_version`, and the 0.x/1.0 stability posture, which is not on the wire at all (INV-006a). */
|
|
847
993
|
export interface SchemaInfo {
|
|
848
994
|
/** `sha256:<64 lower hex>` content hash of this server binary's stable-surface bundle (INV-003). A mismatch is a warning condition, not an error (SS1.4.1). */
|
|
@@ -865,12 +1011,22 @@ export interface Session {
|
|
|
865
1011
|
activeTurnId: string | null;
|
|
866
1012
|
/** The folded effective approval mode. **Additive-optional**: a Session object that omits it means the host has not folded a mode, which is why the index-derived `session/list` entry may legitimately omit it (tdd SS2.4, SS5.12). */
|
|
867
1013
|
approvalMode?: EffectiveApprovalModeState;
|
|
1014
|
+
/** Attention flags (tdd SS2.4, ADR 31983 D3). **Additive-optional**, present only when at least one flag is set; absence is a NON-assertion (nothing pending, or the loaded session's pending source declined to answer). Loaded sessions only: a `notLoaded` row omits it even while its durable pending set is non-empty. */
|
|
1015
|
+
attention?: AttentionFlag[];
|
|
1016
|
+
/** Derived workspace branch (tdd SS2.14.1, #27598) — the index's last derived value; the live-change signal stays `session/branchChanged` (SS4.6.4). **Additive-optional**, omitted when underivable. */
|
|
1017
|
+
branch?: string;
|
|
868
1018
|
/** RFC3339. For a fork this is the fork session id's UUIDv7 mint instant (tdd SS2.4). */
|
|
869
1019
|
createdAt: string;
|
|
1020
|
+
/** Derived first-user-prompt preview (tdd SS2.14.1, #27598). **Additive-optional**, omitted when underivable. */
|
|
1021
|
+
firstUserPrompt?: string;
|
|
870
1022
|
/** `null` for root sessions; fork provenance otherwise (tdd SS2.4). */
|
|
871
1023
|
forkedFrom: ForkProvenance | null;
|
|
1024
|
+
/** Content-activity recency, RFC3339 (tdd SS2.4, ADR 31983 D5). **Additive-optional**: omitted when no content record exists. Never advanced by lifecycle bookkeeping (the resume marker, re-stamps) or a fork's copied seed-replay records, and never precedes `createdAt`. */
|
|
1025
|
+
lastActivityAt?: string;
|
|
872
1026
|
/** The winning metadata fold's model; `null` when that record omits it. */
|
|
873
1027
|
modelId: string | null;
|
|
1028
|
+
/** The durable allocated session name (tdd SS2.4/SS2.14.1, #27598; ADR 27598 D2/D4). **Additive-optional**: present when the serving path holds an allocated name, omitted otherwise — absent is never fabricated. Authoritative and renameable via `session/rename`. */
|
|
1029
|
+
name?: string;
|
|
874
1030
|
/** Absolute path of the session's durable log; non-nullable. Under the ephemeral session profile it is the **empty string**, meaning "no durable log exists" (tdd SS2.13.2) — the one value a client must not hand to a filesystem call. */
|
|
875
1031
|
path: string;
|
|
876
1032
|
/** The winning metadata fold's provider; `null` when that record omits it. */
|
|
@@ -879,6 +1035,8 @@ export interface Session {
|
|
|
879
1035
|
sessionId: string;
|
|
880
1036
|
/** Load state as this host knows it; `session/list` reports `notLoaded` for sessions loaded by *other* hosts (tdd SS2.4). */
|
|
881
1037
|
status: SessionStatus;
|
|
1038
|
+
/** Derived display title (tdd SS2.14.1, #27598): a heuristic that may evolve — its carriage, not its derivation, is the contract. **Additive-optional**, omitted when underivable. */
|
|
1039
|
+
title?: string;
|
|
882
1040
|
/** Completed-turn count from the session view fold (tdd SS2.4). */
|
|
883
1041
|
turnCount: number;
|
|
884
1042
|
/** RFC3339; never precedes `createdAt` (tdd SS2.4). */
|
|
@@ -941,8 +1099,10 @@ export interface SessionCompactResult {
|
|
|
941
1099
|
status: CompactStatus;
|
|
942
1100
|
}
|
|
943
1101
|
|
|
944
|
-
/** `session/start`
|
|
1102
|
+
/** The open configuration extension object shared by `session/start` and `session/resume` (ADR 32760 D1). Unknown keys are ignored on the wire, never rejected (tdd SS1.5.4, spec 206 INV-015; D-052 resolving [#23456](https://github.com/mslsrc/tbh/issues/23456)): the live decoder is D-042's tolerant path, and TEST-024 keeps every exported bundle free of `additionalProperties: false`. The Rust typed model's `deny_unknown_fields` is internal and never exported — the #22785 E6b closedness export applies nowhere, and the `x-msp-closed` opt-in mechanism stays inert. Recognized `mcpServers` values are typed and validated before they leave the wire boundary. */
|
|
945
1103
|
export interface SessionConfig {
|
|
1104
|
+
/** Native MCP servers added only to this session runtime. */
|
|
1105
|
+
mcpServers?: Record<string, SessionMcpServerConfig>;
|
|
946
1106
|
}
|
|
947
1107
|
|
|
948
1108
|
/** `session/contextUsage` params (tdd SS4.6.6, #14405): context-window pressure — the counted-once occupancy at the latest provider-reported durable fact, joined with the host's pressure basis. Replace wholesale; emitted only when the `(windowTokens, usedTokens, pressure)` triple changes value (identical adoptions emit nothing). */
|
|
@@ -1012,6 +1172,12 @@ export interface SessionHistory {
|
|
|
1012
1172
|
snapshot: ViewSnapshot | null;
|
|
1013
1173
|
}
|
|
1014
1174
|
|
|
1175
|
+
/** `session/listChanged` params (#33084, ADR 33084 D3): one changed row of the `session/list` shape — the full SS2.4 Session object as the answering host's list face serves it at emission (the ADR 29243 live-overlaid row), a replace, never a delta. Emitted only on connections that negotiated the `sessionListStream` capability at `initialize` (ADR 33084 D2); row birth stays on `session/started`, unload pairs with `session/closed`. */
|
|
1176
|
+
export interface SessionListChangedParams {
|
|
1177
|
+
/** The served list row for the changed session. */
|
|
1178
|
+
session: Session;
|
|
1179
|
+
}
|
|
1180
|
+
|
|
1015
1181
|
/** `session/list` params (tdd SS2.5.4). Read-only; never touches leases. */
|
|
1016
1182
|
export interface SessionListParams {
|
|
1017
1183
|
/** Opaque page cursor from a prior result. Page cursors are a distinct opaque-string family from view cursors and stream cursors, valid only for re-issuing the same listing (tdd SS2.5.4). Omitted and explicit `null` both mean "first page" (#23468). */
|
|
@@ -1032,6 +1198,15 @@ export interface SessionListResult {
|
|
|
1032
1198
|
sessions: Session[];
|
|
1033
1199
|
}
|
|
1034
1200
|
|
|
1201
|
+
/** One native MCP server supplied at session construction (ADR 32760 D1). **Closed union** (#33295 owner ruling A1, extending D-033/D-050 to `oneOf`): a validator MUST reject an undeclared `transport` arm — the server fails `session/start` decode on an unknown transport, and a future transport arrives as an explicit schema addition. */
|
|
1202
|
+
export type SessionMcpServerConfig = { /** Ordered child arguments. */ args?: string[]; /** Executable name or path. Configuration diagnostics never echo it. */ command: string; /** Explicit child environment additions. */ env?: Record<string, string>; /** Stdio framing mode; defaults to automatic detection. */ framing?: SessionMcpStdioFraming; /** Required/optional startup posture; defaults to required. */ mode?: SessionMcpServerMode; transport: "stdio"; } | { /** Explicit request headers. */ headers?: Record<string, string>; /** Required/optional startup posture; defaults to required. */ mode?: SessionMcpServerMode; transport: "streamableHttp"; /** HTTP(S) endpoint. Configuration diagnostics never echo it. */ url: string; };
|
|
1203
|
+
|
|
1204
|
+
/** Startup failure posture for a session MCP server. */
|
|
1205
|
+
export type SessionMcpServerMode = "required" | "optional";
|
|
1206
|
+
|
|
1207
|
+
/** Stdio framing choices exposed by session MCP configuration. */
|
|
1208
|
+
export type SessionMcpStdioFraming = "auto" | "contentLength" | "lineDelimitedJson";
|
|
1209
|
+
|
|
1035
1210
|
/** `session/modelChanged` params (tdd SS4.6.1): a durable model-selection record landed (tdd SS3.8). */
|
|
1036
1211
|
export interface SessionModelChangedParams {
|
|
1037
1212
|
/** The selected model. */
|
|
@@ -1048,6 +1223,36 @@ export interface SessionModelChangedParams {
|
|
|
1048
1223
|
viewCursor: string;
|
|
1049
1224
|
}
|
|
1050
1225
|
|
|
1226
|
+
/** `session/modelRouteUnserved` params (#25603, ADR 25603 D1, spec 5469 Amendment 16): an accepted `login.credential_update` installed a provider that cannot serve the session's STANDING model route. Disclosure only — the standing selection is unchanged (no `session/modelChanged` fires) and the repair path is a routable `session/setModel`. Folded from the durable `runtime.provider_reconfigure.standing_route_unserved` record; additive — clients that predate it skip the unknown method. */
|
|
1227
|
+
export interface SessionModelRouteUnservedParams {
|
|
1228
|
+
/** The command whose accepted swap installed the provider. */
|
|
1229
|
+
commandId: string;
|
|
1230
|
+
/** The provider id the swap installed. */
|
|
1231
|
+
installedProviderId: string;
|
|
1232
|
+
/** The standing (still bound, now unroutable) model. */
|
|
1233
|
+
modelId: string;
|
|
1234
|
+
/** The standing model's provider; `null` when the selection names none. */
|
|
1235
|
+
providerId?: string;
|
|
1236
|
+
/** The owning session. */
|
|
1237
|
+
sessionId: string;
|
|
1238
|
+
/** The durable records this event folded from. */
|
|
1239
|
+
sourceRange: SourceRange;
|
|
1240
|
+
/** Opaque, strictly monotonic view cursor (tdd SS4.1). */
|
|
1241
|
+
viewCursor: string;
|
|
1242
|
+
}
|
|
1243
|
+
|
|
1244
|
+
/** `session/nameChanged` params (tdd SS4.6.7, #27598): the fold of ANY durable session-name record — the FIRST-NAMING automatic allocate as well as an accepted `session/rename` (or the same in-process runtime command). Replace-wholesale like every SS4.6 sibling. */
|
|
1245
|
+
export interface SessionNameChangedParams {
|
|
1246
|
+
/** The new canonical name now in effect. */
|
|
1247
|
+
name: string;
|
|
1248
|
+
/** The owning session. */
|
|
1249
|
+
sessionId: string;
|
|
1250
|
+
/** The durable records this event folded from. */
|
|
1251
|
+
sourceRange: SourceRange;
|
|
1252
|
+
/** Opaque, strictly monotonic view cursor (tdd SS4.1). */
|
|
1253
|
+
viewCursor: string;
|
|
1254
|
+
}
|
|
1255
|
+
|
|
1051
1256
|
/** `session/read` params (tdd SS2.5.5): read one stored session **without attaching** — no writer lease, no load, no subscription, no `SessionResumed` record. */
|
|
1052
1257
|
export interface SessionReadParams {
|
|
1053
1258
|
/** Metadata-only unless you ask: `false` carries the folded item history. Same name and polarity as `session/resume`/`session/fork`; only the default differs — here it is `true` (tdd SS2.5.5). */
|
|
@@ -1068,10 +1273,46 @@ export interface SessionReadResult {
|
|
|
1068
1273
|
viewCursor: string;
|
|
1069
1274
|
}
|
|
1070
1275
|
|
|
1276
|
+
/** `session/reasoningEffortChanged` params (tdd SS4.6.9, ADR 31255 D1): a durable reasoning-effort reconfigure record landed (tdd SS3.21). Replace wholesale, latest wins; the snapshot carries the latest value (SS4.9.1). */
|
|
1277
|
+
export interface SessionReasoningEffortChangedParams {
|
|
1278
|
+
/** The new session default: the closed eight-string tier vocabulary of tdd SS3.2, spelled identically. */
|
|
1279
|
+
reasoningEffort: ReasoningEffort;
|
|
1280
|
+
/** The owning session. */
|
|
1281
|
+
sessionId: string;
|
|
1282
|
+
/** What drove the change. */
|
|
1283
|
+
source: ReasoningEffortChangeSource;
|
|
1284
|
+
/** The durable records this event folded from. */
|
|
1285
|
+
sourceRange: SourceRange;
|
|
1286
|
+
/** Opaque, strictly monotonic view cursor (tdd SS4.1). */
|
|
1287
|
+
viewCursor: string;
|
|
1288
|
+
}
|
|
1289
|
+
|
|
1290
|
+
/** `session/rename` params (tdd SS2.14.2, #27598): set or change the durable allocated session name through the runtime `session_name` command. One writer; withheld under the ephemeral profile. */
|
|
1291
|
+
export interface SessionRenameParams {
|
|
1292
|
+
/** The SS3.1.1 idempotency handle (UUIDv7). */
|
|
1293
|
+
commandId: string;
|
|
1294
|
+
/** The requested name; the runtime's normalization and validation apply. */
|
|
1295
|
+
name: string;
|
|
1296
|
+
/** The target session. */
|
|
1297
|
+
sessionId: string;
|
|
1298
|
+
}
|
|
1299
|
+
|
|
1300
|
+
/** `session/rename` result (tdd SS2.14.2, #27598): `name` is the canonical (normalized) name the durable record settled. */
|
|
1301
|
+
export interface SessionRenameResult {
|
|
1302
|
+
/** Echoes the client's id. */
|
|
1303
|
+
commandId: string;
|
|
1304
|
+
/** The settled canonical name. Omitted on the `RecoveryPending` arm, which answers `{commandId, status: "accepted"}` and delivers the name via `session/nameChanged` / `Session.name` (tdd SS2.14.2). */
|
|
1305
|
+
name?: string;
|
|
1306
|
+
/** Admission status. */
|
|
1307
|
+
status: CommandStatus;
|
|
1308
|
+
}
|
|
1309
|
+
|
|
1071
1310
|
/** `session/resume` params (tdd SS2.5.2). */
|
|
1072
1311
|
export interface SessionResumeParams {
|
|
1073
1312
|
/** The SS2.5 idempotency handle (UUIDv7). A resume that loads a session writes a durable `SessionResumed` record. */
|
|
1074
1313
|
commandId: string;
|
|
1314
|
+
/** The same open construction-time extension object as `session/start`. */
|
|
1315
|
+
config?: SessionConfig;
|
|
1075
1316
|
/** A view cursor previously observed by this client — or an observed `summarizedThrough` compaction anchor (tdd SS4.5.10, D-029). When present the server returns only the suffix and `history.mode` is `none` (tdd SS2.5.2). Omitted and explicit `null` both mean "no cursor" (#23468). */
|
|
1076
1317
|
cursor?: string | null;
|
|
1077
1318
|
/** Return only session metadata and live resume state; page history separately with `view/page`. Default `false` (tdd SS2.5.2). */
|
|
@@ -1090,7 +1331,7 @@ export interface SessionResumeResult {
|
|
|
1090
1331
|
pendingRequests: PendingRequestPointer[];
|
|
1091
1332
|
/** The loaded session. */
|
|
1092
1333
|
session: Session;
|
|
1093
|
-
/** The session view head; the connection is subscribed after it. */
|
|
1334
|
+
/** The session view head; the connection is subscribed after it. A still-loaded session a prior `view/unsubscribe` detached is RE-ATTACHED by this resume (spec 208 FR-002a, #28920): live delivery resumes from this head. Explicit-cursor re-attach with `(after, head]` engine replay stays `view/subscribe` (SS4.7.1). */
|
|
1094
1335
|
viewCursor: string;
|
|
1095
1336
|
}
|
|
1096
1337
|
|
|
@@ -1134,13 +1375,31 @@ export interface SessionSetModelResult {
|
|
|
1134
1375
|
status: CommandStatus;
|
|
1135
1376
|
}
|
|
1136
1377
|
|
|
1378
|
+
/** `session/setReasoningEffort` params (tdd SS3.21, ADR 31255 D1): set the session's standing reasoning-effort default. A turn carrying its own `reasoningEffort` overrides it for that turn only; the default overrides the host's configured default. Same accept/reject and `commandId` idempotency shape as `session/setModel` (SS3.8). */
|
|
1379
|
+
export interface SessionSetReasoningEffortParams {
|
|
1380
|
+
/** The SS3.1.1 idempotency handle (UUIDv7). */
|
|
1381
|
+
commandId: string;
|
|
1382
|
+
/** The new session default: the closed eight-string tier vocabulary `turn/start` carries (SS3.2), spelled identically. Invalid tiers are invalid params. A default of `max` rides provider requests verbatim, never clamped (ADR 28621 D8, ADR 31131 D1). */
|
|
1383
|
+
reasoningEffort: ReasoningEffort;
|
|
1384
|
+
/** The target session. */
|
|
1385
|
+
sessionId: string;
|
|
1386
|
+
}
|
|
1387
|
+
|
|
1388
|
+
/** `session/setReasoningEffort` result (tdd SS3.21). The default is durable on ack and applies to turns launched after admission; a running turn keeps the request options it already resolved. */
|
|
1389
|
+
export interface SessionSetReasoningEffortResult {
|
|
1390
|
+
/** Echoes the client's id. */
|
|
1391
|
+
commandId: string;
|
|
1392
|
+
/** Admission status. */
|
|
1393
|
+
status: CommandStatus;
|
|
1394
|
+
}
|
|
1395
|
+
|
|
1137
1396
|
/** `session/start` params (tdd SS2.5.1). */
|
|
1138
1397
|
export interface SessionStartParams {
|
|
1139
1398
|
/** The session's starting approval mode; server default when omitted or explicit `null` — both spellings select the default (#23468). Select, never create — the value names a mode the host's configuration already defines (tdd SS2.5.1, SS5.12). This is the only surface that declares a non-interactive run's policy (tdd SS5.11, D-008). */
|
|
1140
1399
|
approvalMode?: ApprovalMode | null;
|
|
1141
1400
|
/** The SS2.5 idempotency handle (UUIDv7). Required; the server never mints one. */
|
|
1142
1401
|
commandId: string;
|
|
1143
|
-
/** Reserved for per-session overrides owned by a future Configuration section
|
|
1402
|
+
/** Reserved for per-session overrides owned by a future Configuration section. Issue #32760 admits only its `mcpServers` member. */
|
|
1144
1403
|
config?: SessionConfig;
|
|
1145
1404
|
/** Initial model; server default when omitted. */
|
|
1146
1405
|
modelId?: string;
|
|
@@ -1163,6 +1422,18 @@ export interface SessionStartResult {
|
|
|
1163
1422
|
/** A session's load state (tdd SS2.4). */
|
|
1164
1423
|
export type SessionStatus = "notLoaded" | "idle" | "running" | (string & {});
|
|
1165
1424
|
|
|
1425
|
+
/** `session/statusChanged` params (tdd SS4.6.10, ADR 31983 D2): a loaded session's projected `(status, attention)` value flipped. A command-plane broadcast — delivered to every connection regardless of its view subscription set, never gated, no `sourceRange`; the same facts live on the Session object, which is how a client seeds its table (no initial burst on connect). */
|
|
1426
|
+
export interface SessionStatusChangedParams {
|
|
1427
|
+
/** Attention flags after the transition; present only when at least one flag is set (tdd SS2.4, ADR 31983 D3). */
|
|
1428
|
+
attention?: AttentionFlag[];
|
|
1429
|
+
/** The owning session. */
|
|
1430
|
+
sessionId: string;
|
|
1431
|
+
/** Load state after the transition (the closed SS2.4 enum, unchanged). */
|
|
1432
|
+
status: SessionStatus;
|
|
1433
|
+
/** The causing record's view cursor (ADR 31983 D4). Required-nullable: `null` exactly when the paired `session/closed`'s cursor is `null` (the unload fold-failure arm); a definite cursor everywhere else. */
|
|
1434
|
+
viewCursor: string | null;
|
|
1435
|
+
}
|
|
1436
|
+
|
|
1166
1437
|
/** `session/todoListChanged` params (tdd SS4.6.3): a `TodoSnapshotUpdated` record landed. Replace the whole list on every event; an empty `items` array is a cleared list, not a no-op. */
|
|
1167
1438
|
export interface SessionTodoListChangedParams {
|
|
1168
1439
|
/** The full todo list, replaced wholesale. */
|
|
@@ -1223,6 +1494,56 @@ export interface SessionUserShellResult {
|
|
|
1223
1494
|
status: CommandStatus;
|
|
1224
1495
|
}
|
|
1225
1496
|
|
|
1497
|
+
/** The view-health state (tdd SS2.5.2 companion). Open enum (`x-msp-openness: open`): a client MUST ignore an unrecognized value. v1 emits only `Unavailable`; openness itself reserves additive room for a future re-arm (ADR 32557 D1 names it `healthy`) and for the #14401 durable-degraded axis, so no never-emitted token is baked onto the stable surface now. */
|
|
1498
|
+
export type SessionViewHealth = "unavailable" | (string & {});
|
|
1499
|
+
|
|
1500
|
+
/** `session/viewHealthChanged` params (ADR 32557; #32557): the named session's live view stream became unavailable, and why. Best-effort: ordered after already-queued view frames and may be dropped (for example when the connection is closing), so a client MUST NOT assume a guaranteed push and still reads `history.noneReason` on its next resume/read (FM-005). */
|
|
1501
|
+
export interface SessionViewHealthChangedParams {
|
|
1502
|
+
/** The new view-health state. In v1 the host emits only `Unavailable`. */
|
|
1503
|
+
health: SessionViewHealth;
|
|
1504
|
+
/** Why the view is unavailable — the SAME typed `HistoryNoneReason` vocabulary the pull path stamps on `history.noneReason` (tdd SS2.5.2, D-050), so a client reuses one handler for push and pull. `projectionUnavailable` in v1; present only when `health` is `Unavailable`. Open on the client side: an unknown reason decodes conservatively and renders generically. */
|
|
1505
|
+
noneReason?: HistoryNoneReason;
|
|
1506
|
+
/** The session whose live view health changed. */
|
|
1507
|
+
sessionId: string;
|
|
1508
|
+
}
|
|
1509
|
+
|
|
1510
|
+
/** One typed-invocable shortcut spelling (tdd SS3.22.1). A plugin skill may contribute two rows: its bare-name winner and its qualified `<pluginId>:<skillId>` form. */
|
|
1511
|
+
export interface SkillCatalogEntry {
|
|
1512
|
+
/** Present when the skill declares an argument hint. */
|
|
1513
|
+
argumentHint?: string;
|
|
1514
|
+
/** The skill's palette summary. */
|
|
1515
|
+
description: string;
|
|
1516
|
+
/** The skill display name the first-party palette shows. */
|
|
1517
|
+
displayName: string;
|
|
1518
|
+
/** The owning plugin's identifier; present when `source` is `plugin`. */
|
|
1519
|
+
pluginId?: string;
|
|
1520
|
+
/** The shortcut token without the leading slash — bare (`fix-bug`) or plugin-qualified (`acme:deploy`) — the exact value a `skill` input part submits. Unique within one response. */
|
|
1521
|
+
selector: string;
|
|
1522
|
+
/** Where the skill comes from. */
|
|
1523
|
+
source: SkillSource;
|
|
1524
|
+
}
|
|
1525
|
+
|
|
1526
|
+
/** `skill/changed` params (tdd SS3.22.2): the session's user-invocable set changed; clients re-issue `skill/list`. Advisory — the host may coalesce bursts and guarantees no ordering relative to view events (ADR 32471 D3). */
|
|
1527
|
+
export interface SkillChangedParams {
|
|
1528
|
+
/** The session whose set changed. */
|
|
1529
|
+
sessionId: string;
|
|
1530
|
+
}
|
|
1531
|
+
|
|
1532
|
+
/** `skill/list` params (tdd SS3.22.1). Per-session because skill scope follows the session's workspace and plugin state. */
|
|
1533
|
+
export interface SkillListParams {
|
|
1534
|
+
/** The target session. */
|
|
1535
|
+
sessionId: string;
|
|
1536
|
+
}
|
|
1537
|
+
|
|
1538
|
+
/** `skill/list` result (tdd SS3.22.1): one row per typed-invocable shortcut spelling — exactly the invocations the first-party typed dispatch accepts (spec 11352 INV-007 predicate and the shared shortcut layer's name resolution, both by call-through; ADR 32471 D2). */
|
|
1539
|
+
export interface SkillListResult {
|
|
1540
|
+
/** The session's user-invocable skill rows. */
|
|
1541
|
+
skills: SkillCatalogEntry[];
|
|
1542
|
+
}
|
|
1543
|
+
|
|
1544
|
+
/** A skill row's source scope (tdd SS3.22.1): the projection of the skills crate's `SkillsSourceScope`. Open (server-produced result vocabulary, the #22785 enum-openness rule): a future scope value is additive. */
|
|
1545
|
+
export type SkillSource = "bundled" | "user" | "project" | "plugin" | (string & {});
|
|
1546
|
+
|
|
1226
1547
|
/** The compaction boundary an anchored snapshot is anchored at (tdd SS2.5.2). */
|
|
1227
1548
|
export interface SnapshotAnchor {
|
|
1228
1549
|
/** The view cursor of the boundary's `compaction` event. */
|
|
@@ -1247,12 +1568,16 @@ export interface SnapshotState {
|
|
|
1247
1568
|
goal: Goal | null;
|
|
1248
1569
|
/** Every item, in first-opened order, each at its latest revision at the snapshot cursor. One schema per kind, shared with the notification item object — which is what makes snapshot+suffix a pure splice (tdd SS4.9.1). */
|
|
1249
1570
|
items: Item[];
|
|
1571
|
+
/** The settled canonical session name; `null` when the session was never named (#27598, tdd SS4.9.1 / SS2.14). Folds the same durable `session/nameChanged` record `Session.name` reports. */
|
|
1572
|
+
name?: string;
|
|
1250
1573
|
/** The pending-approval half of the pending set. */
|
|
1251
1574
|
pendingApprovals: PendingApprovalPointer[];
|
|
1252
1575
|
/** The pending-user-input half of the pending set. */
|
|
1253
1576
|
pendingUserInputs: PendingUserInputPointer[];
|
|
1254
1577
|
/** Admitted-but-not-launched submits, in launch order (tdd SS3.1.4). */
|
|
1255
1578
|
queuedTurns: TurnRef[];
|
|
1579
|
+
/** The latest session-default reasoning effort with its source; ABSENT until a set lands (tdd SS4.9.1 `reasoningEffort`, ADR 31255 D1 — the `contextUsage` absent arm, never present-null). */
|
|
1580
|
+
reasoningEffort?: ReasoningEffortState;
|
|
1256
1581
|
/** Latest todo list; `null` when no fact has landed. */
|
|
1257
1582
|
todoList: TodoListState | null;
|
|
1258
1583
|
/** The `cumulative` block of the last `session/tokenUsage` event; zeroes when none (tdd SS4.9.1). */
|
|
@@ -1332,6 +1657,36 @@ export interface SubagentTargetParams {
|
|
|
1332
1657
|
subagentId: string;
|
|
1333
1658
|
}
|
|
1334
1659
|
|
|
1660
|
+
/** The one usage payload shape: the `usage/read` result's `usage` member and the `usage/changed` params (ADR 32563 D2/D3). The numbers are point-in-time — `observedAtMs` is the host's arrival stamp, so a client renders "as of", never implies live data (spec 18742 US-FR-004). */
|
|
1661
|
+
export interface SubscriptionUsage {
|
|
1662
|
+
/** When the host RECEIVED this observation (frame arrival or mint request-send), epoch milliseconds. */
|
|
1663
|
+
observedAtMs: number;
|
|
1664
|
+
/** The provider's subscription tier id, verbatim. */
|
|
1665
|
+
tier: string;
|
|
1666
|
+
/** The rolling weekly block. */
|
|
1667
|
+
weekly: SubscriptionUsageWeekly;
|
|
1668
|
+
/** The current window. */
|
|
1669
|
+
window: SubscriptionUsageWindow;
|
|
1670
|
+
}
|
|
1671
|
+
|
|
1672
|
+
/** The rolling weekly block: same semantics as [`SubscriptionUsageWindow`] without a duration (ADR 32563 D2). */
|
|
1673
|
+
export interface SubscriptionUsageWeekly {
|
|
1674
|
+
/** When the weekly window resets, epoch milliseconds. */
|
|
1675
|
+
resetsAtMs: number;
|
|
1676
|
+
/** Percent of the weekly budget used (integer ≥ 0, may exceed 100). */
|
|
1677
|
+
usedPercent: number;
|
|
1678
|
+
}
|
|
1679
|
+
|
|
1680
|
+
/** The current usage window (the provider's 5-hour-class block): verbatim provider percentages with the reset stamp normalized to epoch milliseconds (ADR 32563 D2). */
|
|
1681
|
+
export interface SubscriptionUsageWindow {
|
|
1682
|
+
/** When the window resets, epoch milliseconds. */
|
|
1683
|
+
resetsAtMs: number;
|
|
1684
|
+
/** Percent of the window's budget used: an integer ≥ 0, verbatim from the provider — over-quota values above 100 are valid. */
|
|
1685
|
+
usedPercent: number;
|
|
1686
|
+
/** The window's length in minutes (> 0). */
|
|
1687
|
+
windowDurationMins: number;
|
|
1688
|
+
}
|
|
1689
|
+
|
|
1335
1690
|
/** A success response frame (SS1.2 §2.3). */
|
|
1336
1691
|
export interface SuccessResponse {
|
|
1337
1692
|
/** Echo of the request id. */
|
|
@@ -1342,6 +1697,52 @@ export interface SuccessResponse {
|
|
|
1342
1697
|
result: Record<string, unknown>;
|
|
1343
1698
|
}
|
|
1344
1699
|
|
|
1700
|
+
/** `task/background` params (tdd §3.13): durably send a running foreground tool task to the background. */
|
|
1701
|
+
export interface TaskBackgroundParams {
|
|
1702
|
+
/** The SS3.1.1 idempotency handle (UUIDv7). */
|
|
1703
|
+
commandId: string;
|
|
1704
|
+
/** The target session. */
|
|
1705
|
+
sessionId: string;
|
|
1706
|
+
/** The task to background, exactly as the view names it: the `toolCall` item's `itemId` IS the task id (SS4.5.5). */
|
|
1707
|
+
taskId: string;
|
|
1708
|
+
}
|
|
1709
|
+
|
|
1710
|
+
/** The `task/background` / `task/stop` ack (tdd §3.13/§3.14): admission-only, echoing the targeted task. */
|
|
1711
|
+
export interface TaskCommandResult {
|
|
1712
|
+
/** Echoes the client's id. */
|
|
1713
|
+
commandId: string;
|
|
1714
|
+
/** Admission status. */
|
|
1715
|
+
status: CommandStatus;
|
|
1716
|
+
/** Echoes the targeted task id. */
|
|
1717
|
+
taskId: string;
|
|
1718
|
+
}
|
|
1719
|
+
|
|
1720
|
+
/** `task/stopAll` params (tdd §3.15): stop every stoppable background workload live at admission. */
|
|
1721
|
+
export interface TaskStopAllParams {
|
|
1722
|
+
/** The SS3.1.1 idempotency handle (UUIDv7). */
|
|
1723
|
+
commandId: string;
|
|
1724
|
+
/** The target session. */
|
|
1725
|
+
sessionId: string;
|
|
1726
|
+
}
|
|
1727
|
+
|
|
1728
|
+
/** The `task/stopAll` ack (tdd §3.15): always `accepted`, including over an empty set — a blanket stop over nothing is a satisfied gesture. The ack deliberately carries no stopped-task list; count the kills from the view. */
|
|
1729
|
+
export interface TaskStopAllResult {
|
|
1730
|
+
/** Echoes the client's id. */
|
|
1731
|
+
commandId: string;
|
|
1732
|
+
/** Admission status. */
|
|
1733
|
+
status: CommandStatus;
|
|
1734
|
+
}
|
|
1735
|
+
|
|
1736
|
+
/** `task/stop` params (tdd §3.14): stop one named background task. Required target, never "whichever is loudest" — §3.15 is the blanket verb. */
|
|
1737
|
+
export interface TaskStopParams {
|
|
1738
|
+
/** The SS3.1.1 idempotency handle (UUIDv7). */
|
|
1739
|
+
commandId: string;
|
|
1740
|
+
/** The target session. */
|
|
1741
|
+
sessionId: string;
|
|
1742
|
+
/** The task to stop, the `toolCall` item's `itemId` (SS4.5.5). */
|
|
1743
|
+
taskId: string;
|
|
1744
|
+
}
|
|
1745
|
+
|
|
1345
1746
|
/** One todo entry (tdd SS4.6.3). */
|
|
1346
1747
|
export interface TodoItem {
|
|
1347
1748
|
/** Present-tense active form, when the tool supplied one. */
|
|
@@ -1444,16 +1845,20 @@ export interface TurnError {
|
|
|
1444
1845
|
}
|
|
1445
1846
|
|
|
1446
1847
|
/** Turn failure classes (tdd SS4.5.1, `TerminalErrorKind` plus the model-task failure class). Open. */
|
|
1447
|
-
export type TurnErrorKind = "stepLimit" | "configError" | "projectionError" | "logError" | "workflowLaunchError" | "environmentError" | "modelError" | "launchError" | (string & {});
|
|
1848
|
+
export type TurnErrorKind = "stepLimit" | "configError" | "projectionError" | "logError" | "workflowLaunchError" | "environmentError" | "modelError" | "launchError" | "authRequired" | (string & {});
|
|
1448
1849
|
|
|
1449
1850
|
/** One ordered content part of a turn submission (tdd SS3.2). File mentions are text, not a part type: write `@relative/path` in a text part. A structured `mention` part is reserved and currently rejected, and an unknown part type is `invalidParams` (tdd SS3.1.2, SS3.2) — which is what closes [`TurnInputPartType`]. Modelled as a discriminated flat object rather than a Rust `enum`, the convention [`crate::view::approval::ApprovalSubject`] already established for a wire union in this crate: the v1 schema model names no object-variant union shape and fails closed on one. The serialized JSON is the tdd shape either way; what a flat object cannot express is "`mediaType` is required exactly when `type` is `image`". **RULED (#22785 E4, owner, 2026-08-26): the precedent is accepted.** A strict union node kind may be funded later as a follow-up; if it is, it must cover [`crate::method::lifecycle::PendingRequestPointer`] too. `height` may only appear together with `width`. `width` may only appear together with `height`. */
|
|
1450
1851
|
export interface TurnInputPart {
|
|
1852
|
+
/** Free-text skill arguments, optional on a `skill` part — the wire twin of what the TUI accepts after the shortcut token (tdd SS3.22.3). */
|
|
1853
|
+
arguments?: string;
|
|
1451
1854
|
/** Base64 payload, required on an `image` part. Invalid base64 or an empty payload is rejected with invalid params. */
|
|
1452
1855
|
base64Data?: string;
|
|
1453
1856
|
/** Pixel height; must be provided together with `width` or not at all (tdd SS3.2, #22785 E6c). */
|
|
1454
1857
|
height?: number;
|
|
1455
1858
|
/** Media type, required on an `image` part. */
|
|
1456
1859
|
mediaType?: string;
|
|
1860
|
+
/** The skill to invoke, required on a `skill` part (tdd SS3.2, SS3.22.3; ADR 32471 D4): a bare or plugin-qualified shortcut token from `skill/list`. The HOST resolves and expands; an unknown selector is the typed `-32032 skillNotFound` request error. */
|
|
1861
|
+
selector?: string;
|
|
1457
1862
|
/** User prompt text, on a `text` part. Multiple text parts are joined in order into the turn's prompt. */
|
|
1458
1863
|
text?: string;
|
|
1459
1864
|
/** The part type. */
|
|
@@ -1463,7 +1868,7 @@ export interface TurnInputPart {
|
|
|
1463
1868
|
}
|
|
1464
1869
|
|
|
1465
1870
|
/** The `type` discriminator of a turn input part (tdd SS3.2). Closed: an unknown part type is `invalidParams` (tdd SS3.1.2). */
|
|
1466
|
-
export type TurnInputPartType = "text" | "image";
|
|
1871
|
+
export type TurnInputPartType = "text" | "image" | "skill";
|
|
1467
1872
|
|
|
1468
1873
|
/** `turn/interrupt` params (tdd SS3.4): the "user pressed stop" gesture, on the runtime's priority lane. */
|
|
1469
1874
|
export interface TurnInterruptParams {
|
|
@@ -1657,6 +2062,12 @@ export interface UnframedViewNotificationParams {
|
|
|
1657
2062
|
viewCursor: string;
|
|
1658
2063
|
}
|
|
1659
2064
|
|
|
2065
|
+
/** `usage/read` result: `{usage?}` — omitted, never `null`, when the host has observed nothing (ADR 32563 D2: truthful absence, no "nothing observed" error). */
|
|
2066
|
+
export interface UsageReadResult {
|
|
2067
|
+
/** The last-observed subscription usage window, when one exists. */
|
|
2068
|
+
usage?: SubscriptionUsage;
|
|
2069
|
+
}
|
|
2070
|
+
|
|
1660
2071
|
export interface UserInputAnswer {
|
|
1661
2072
|
freeText?: string;
|
|
1662
2073
|
note?: string;
|
|
@@ -1859,6 +2270,20 @@ export interface ViewSnapshot {
|
|
|
1859
2270
|
viewCursor: string;
|
|
1860
2271
|
}
|
|
1861
2272
|
|
|
2273
|
+
/** `view/subscribe` params (tdd SS4.7.1): attach this connection's live view subscription for a session at an explicit cursor — the fine-grained counterpart of the SS2 auto-subscribe, and the gap-free re-attachment path after `view/unsubscribe`. It never loads a session, takes no lease, writes nothing. */
|
|
2274
|
+
export interface ViewSubscribeParams {
|
|
2275
|
+
/** Resume cursor. When present, the server replays `(after, head]` as ordinary view notifications before any live event — one gapless cursor sequence. Omitted means "from now": no historical replay (tdd SS4.7.1). */
|
|
2276
|
+
after?: string;
|
|
2277
|
+
/** The session to follow. */
|
|
2278
|
+
sessionId: string;
|
|
2279
|
+
}
|
|
2280
|
+
|
|
2281
|
+
/** `view/subscribe` result (tdd SS4.7.1). */
|
|
2282
|
+
export interface ViewSubscribeResult {
|
|
2283
|
+
/** The view head at subscribe time; the client knows it is live once cursors pass it. */
|
|
2284
|
+
viewCursor: string;
|
|
2285
|
+
}
|
|
2286
|
+
|
|
1862
2287
|
/** `view/unsubscribe` params (tdd SS4.7.2): remove this connection from the session's view subscription set — the protocol's single unsubscribe operation, at the altitude that owns subscriptions (tdd SS2.5.6 points here). It does not unload the session; unloading is the idle policy (tdd SS2.8). */
|
|
1863
2288
|
export interface ViewUnsubscribeParams {
|
|
1864
2289
|
/** The session to stop following. */
|
|
@@ -1869,6 +2294,16 @@ export interface ViewUnsubscribeParams {
|
|
|
1869
2294
|
export interface ViewUnsubscribeResult {
|
|
1870
2295
|
}
|
|
1871
2296
|
|
|
2297
|
+
/** `workflow/cancel` params (tdd SS3.19): cancel a live workflow run. */
|
|
2298
|
+
export interface WorkflowCancelParams {
|
|
2299
|
+
/** The SS3.1.1 idempotency handle (UUIDv7). */
|
|
2300
|
+
commandId: string;
|
|
2301
|
+
/** The target session. */
|
|
2302
|
+
sessionId: string;
|
|
2303
|
+
/** The run to cancel, exactly as the `workflow` item names it (SS4.5.8); required, non-empty. */
|
|
2304
|
+
workflowRunId: string;
|
|
2305
|
+
}
|
|
2306
|
+
|
|
1872
2307
|
/** One workflow child's folded state (tdd SS4.5.8, `WorkflowChildLifecycleFact`), keyed by `(childId, attempt)`. */
|
|
1873
2308
|
export interface WorkflowChild {
|
|
1874
2309
|
/** The attempt number. */
|
|
@@ -1891,9 +2326,38 @@ export interface WorkflowChild {
|
|
|
1891
2326
|
usage?: TokenUsage;
|
|
1892
2327
|
}
|
|
1893
2328
|
|
|
2329
|
+
/** Which control to apply to the child's current attempt (tdd SS3.20). Closed on the wire: an unknown value is `-32602 invalidParams`. */
|
|
2330
|
+
export type WorkflowChildAction = "skip" | "retry";
|
|
2331
|
+
|
|
2332
|
+
/** `workflow/childControl` params (tdd SS3.20): skip or retry one workflow child, keyed by the `(childId, attempt)` pair the `workflow` item's `children[]` carries. */
|
|
2333
|
+
export interface WorkflowChildControlParams {
|
|
2334
|
+
/** The control to apply. */
|
|
2335
|
+
action: WorkflowChildAction;
|
|
2336
|
+
/** The child's CURRENT attempt (integer >= 1). A stale value rejects `"stale_attempt"`; re-read the item and re-key — never guess. Minimum 1. */
|
|
2337
|
+
attempt: number;
|
|
2338
|
+
/** The child, from the item's `children[]`; required, non-empty. */
|
|
2339
|
+
childId: string;
|
|
2340
|
+
/** The SS3.1.1 idempotency handle (UUIDv7). */
|
|
2341
|
+
commandId: string;
|
|
2342
|
+
/** The target session. */
|
|
2343
|
+
sessionId: string;
|
|
2344
|
+
/** The run owning the child (SS4.5.8); required, non-empty. */
|
|
2345
|
+
workflowRunId: string;
|
|
2346
|
+
}
|
|
2347
|
+
|
|
2348
|
+
/** The shared SS3.19/SS3.20 admission-only ack: deliberately bare `{commandId, status}` — settlement arrives as the workflow item's view events, never through the ack. */
|
|
2349
|
+
export interface WorkflowControlResult {
|
|
2350
|
+
/** Echoes the client's id. */
|
|
2351
|
+
commandId: string;
|
|
2352
|
+
/** Admission status. */
|
|
2353
|
+
status: CommandStatus;
|
|
2354
|
+
}
|
|
2355
|
+
|
|
1894
2356
|
/** Every wire method in this schema (SS1.9 index). */
|
|
1895
|
-
export type MspMethod = "initialize" | "subagent/sendMessage" | "subagent/followupTask" | "subagent/interrupt" | "subagent/stop" | "subagent/resume" | "subagent/reopen" | "subagent/close" | "subagent/readResult" | "session/start" | "session/resume" | "session/fork" | "session/list" | "session/read" | "turn/start" | "turn/steer" | "turn/interrupt" | "turn/cancel" | "turn/unqueue" | "session/compact" | "session/setModel" | "session/userShell" | "model/list" | "view/unsubscribe" | "view/page" | "approval/decide" | "approval/listPending" | "session/setApprovalMode" | "userInput/answer" | "userInput/cancel" | "userInput/clarify";
|
|
2357
|
+
export type MspMethod = "initialize" | "subagent/sendMessage" | "subagent/followupTask" | "subagent/interrupt" | "subagent/stop" | "subagent/resume" | "subagent/reopen" | "subagent/close" | "subagent/readResult" | "session/start" | "session/resume" | "session/fork" | "session/list" | "session/read" | "turn/start" | "turn/steer" | "turn/interrupt" | "turn/cancel" | "turn/unqueue" | "session/compact" | "session/setModel" | "session/rename" | "session/setReasoningEffort" | "session/userShell" | "model/list" | "skill/list" | "task/background" | "task/stop" | "task/stopAll" | "goal/set" | "goal/edit" | "goal/clear" | "goal/pause" | "goal/resume" | "workflow/cancel" | "workflow/childControl" | "view/subscribe" | "view/unsubscribe" | "view/page" | "item/readOutput" | "approval/decide" | "approval/listPending" | "session/setApprovalMode" | "userInput/answer" | "userInput/cancel" | "userInput/clarify" | "usage/read";
|
|
1896
2358
|
/** Every wire notification in this schema (SS1.9 index). */
|
|
1897
|
-
export type MspNotification = "initialized" | "turn/started" | "turn/completed" | "turn/retracted" | "turn/retryScheduled" | "turn/unqueued" | "item/started" | "item/updated" | "item/delta" | "item/completed" | "view/gap" | "approval/requested" | "approval/updated" | "approval/resolved" | "userInput/requested" | "userInput/settled" | "session/modelChanged" | "session/goalChanged" | "session/todoListChanged" | "session/branchChanged" | "session/tokenUsage" | "session/contextUsage" | "session/approvalModeChanged";
|
|
2359
|
+
export type MspNotification = "initialized" | "skill/changed" | "turn/started" | "turn/completed" | "turn/retracted" | "turn/retryScheduled" | "turn/unqueued" | "item/started" | "item/updated" | "item/delta" | "item/completed" | "view/gap" | "approval/requested" | "approval/updated" | "approval/resolved" | "userInput/requested" | "userInput/settled" | "session/modelChanged" | "session/reasoningEffortChanged" | "session/statusChanged" | "session/goalChanged" | "session/todoListChanged" | "session/branchChanged" | "session/tokenUsage" | "session/contextUsage" | "session/approvalModeChanged" | "session/modelRouteUnserved" | "session/nameChanged" | "session/viewHealthChanged" | "session/listChanged" | "usage/changed";
|
|
2360
|
+
/** Every server-initiated wire request in this schema (SS5.3/SS5.10.1 index). */
|
|
2361
|
+
export type MspServerRequest = "approval/request" | "userInput/request";
|
|
1898
2362
|
/** Every error `data.kind` in this schema's error table (SS1.6) — each code's primary kind plus its override kinds. */
|
|
1899
|
-
export type MspErrorDataKind = "parseError" | "invalidRequest" | "notInitialized" | "alreadyInitialized" | "methodNotFound" | "experimentalRequired" | "invalidParams" | "internal" | "pageEventTooLarge" | "outputResultTooLarge" | "overloaded" | "inputTooLarge" | "capabilityRequired" | "notFound" | "interrupted" | "cancelled" | "sessionNotFound" | "sessionInUse" | "sessionAmbiguous" | "forkBoundaryInvalid" | "sessionNotLoaded" | "sessionStreamMismatch" | "commandRejected" | "backpressured" | "viewTruncated" | "boundaryPruned" | "boundaryUnusable" | "noBoundary" | "approvalNotFound" | "approvalAlreadyResolved" | "approvalChoiceInvalid" | "approvalRequirementStale" | "approvalReviewerUnavailable" | "userInputNotFound" | "userInputAlreadySettled" | "userInputAnswerInvalid";
|
|
2363
|
+
export type MspErrorDataKind = "parseError" | "invalidRequest" | "notInitialized" | "alreadyInitialized" | "methodNotFound" | "experimentalRequired" | "invalidParams" | "internal" | "pageEventTooLarge" | "outputResultTooLarge" | "overloaded" | "inputTooLarge" | "capabilityRequired" | "notFound" | "interrupted" | "cancelled" | "sessionNotFound" | "sessionInUse" | "sessionAmbiguous" | "forkBoundaryInvalid" | "sessionNotLoaded" | "sessionStreamMismatch" | "commandRejected" | "backpressured" | "skillNotFound" | "viewTruncated" | "outputUnavailable" | "boundaryPruned" | "boundaryUnusable" | "noBoundary" | "approvalNotFound" | "approvalAlreadyResolved" | "approvalChoiceInvalid" | "approvalRequirementStale" | "approvalReviewerUnavailable" | "userInputNotFound" | "userInputAlreadySettled" | "userInputAnswerInvalid";
|