@botiverse/raft-sdk 0.5.0 → 0.7.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/dist/index.d.ts CHANGED
@@ -348,7 +348,9 @@ interface RaftNextStep {
348
348
  /** One sentence explaining why this is the next step. */
349
349
  why: string;
350
350
  }
351
- type RaftOpErrorCode = "INVALID_REQUEST" | "TRANSPORT_ERROR" | "HTTP_ERROR" | "INVALID_RESPONSE" | "CAPABILITY_NOT_AUTHORIZED" | "SCOPE_DENIED" | "NOT_FOUND" | "CONFLICT" | "IDEMPOTENCY_KEY_REUSED" | "UNSUPPORTED_FOR_EXTERNAL_AGENTS" | "UNAVAILABLE";
351
+ type RaftOpErrorCode = "INVALID_REQUEST" | "TRANSPORT_ERROR" | "HTTP_ERROR" | "INVALID_RESPONSE" | "CAPABILITY_NOT_AUTHORIZED" | "SCOPE_DENIED" | "NOT_FOUND" | "CONFLICT" | "IDEMPOTENCY_KEY_REUSED" | "UNSUPPORTED_FOR_EXTERNAL_AGENTS" | "UNAVAILABLE" |
352
+ /** A model-only operation was invoked from code (`invoke(…, { origin: "code" })`); nothing was sent. */
353
+ "MODEL_ONLY";
352
354
  interface RaftOpError {
353
355
  code: RaftOpErrorCode;
354
356
  /** Safe SDK text; never a raw Server body or transport cause. */
@@ -433,7 +435,7 @@ interface RaftInterruptResume {
433
435
  /**
434
436
  * The exact `raft` argv that carries out the interrupted call (for example
435
437
  * `["message", "send", "--send-draft", …]`), when the call ran as a command
436
- * (CLI or command endpoint) and its input is stored. Absent for an
438
+ * (the `raft` CLI) and its input is stored. Absent for an
437
439
  * in-process SDK call: then resuming means calling the same SDK method again
438
440
  * with the same input and `idempotencyKey`.
439
441
  */
@@ -500,22 +502,48 @@ interface SeenFrontierSnapshot {
500
502
  targets: Record<string, {
501
503
  upTo?: number;
502
504
  exact?: number[];
505
+ /** The model context `upTo` was booked in; absent when there was none. */
506
+ upToContextId?: string;
507
+ /** The model context `exact` was booked in; absent when there was none. */
508
+ exactContextId?: string;
503
509
  }>;
504
510
  /** Alternate spellings the Server resolved to a canonical target. */
505
511
  aliases: Record<string, string>;
512
+ /** The frontier's current model context (`setContext`), when one is set. */
513
+ contextId?: string;
506
514
  }
507
515
  export declare class SeenFrontier {
508
- private readonly targets;
509
- private readonly aliases;
516
+ private core;
517
+ /** Set on a view from `inContext`: the context this view books and attests under. */
518
+ private bound;
510
519
  static fromSnapshot(snapshot: SeenFrontierSnapshot | null | undefined): SeenFrontier;
511
- /** Merge a snapshot into this frontier by the same monotonic rules (never lowers a mark). */
520
+ /** The model context this frontier books and attests under; null means no context scoping. */
521
+ get contextId(): string | null;
522
+ /**
523
+ * Set the current model context (shared by every view of this frontier that
524
+ * is not bound to its own context). Call it when the model's context
525
+ * changes (a new session, a compaction): reads booked under the previous
526
+ * context then no longer attest a send. `null` turns scoping off.
527
+ */
528
+ setContext(contextId: string | null): void;
529
+ /**
530
+ * A view over the same records that books and attests under `contextId`
531
+ * (for one call made on behalf of that model context), without changing the
532
+ * frontier's current context. `undefined` returns this frontier.
533
+ */
534
+ inContext(contextId: string | null | undefined): SeenFrontier;
535
+ /**
536
+ * Merge a snapshot into this frontier: each record is booked under the
537
+ * context it was booked in (same context: monotonic, never lowers a mark).
538
+ * Adopts the snapshot's current context when this frontier has none.
539
+ */
512
540
  absorb(snapshot: SeenFrontierSnapshot | null | undefined): void;
513
541
  /** Remember that the Server resolved `requested` to `canonical` (a thread spelling, a `~agent` suffix, …). */
514
542
  recordAlias(requested: string, canonical: string): void;
515
543
  canonical(target: string): string;
516
- /** Advance the contiguous boundary for a target; never lowers it. */
544
+ /** Advance the contiguous boundary for a target in the current context; never lowers it within one context. */
517
545
  recordUpTo(target: string, seq: number): void;
518
- /** Record bodies that were rendered without proving contiguity. */
546
+ /** Record bodies that were rendered without proving contiguity, in the current context. */
519
547
  recordExact(target: string, seqs: readonly number[]): void;
520
548
  /**
521
549
  * Attest that the model saw the context of an interrupt (`outcome.interrupt`
@@ -531,9 +559,17 @@ export declare class SeenFrontier {
531
559
  withheld: boolean;
532
560
  contextComplete?: boolean;
533
561
  }): boolean;
534
- /** What to attest on a send or claim to `target`; omits `seenUpToSeq` when nothing contiguous is known. */
562
+ /**
563
+ * What to attest on a send or claim to `target`; omits `seenUpToSeq` when
564
+ * nothing contiguous is known. With a current context, only bookings made
565
+ * in that context count.
566
+ */
535
567
  attestation(target: string): SeenAttestation;
536
568
  snapshot(): SeenFrontierSnapshot;
569
+ /** A high-water booking (seenPolicy `bookStreamEntries`): another context's record is replaced, not merged. */
570
+ private bookUpTo;
571
+ /** A sparse booking (seenPolicy `bookExactSeqs`): merges within a context, replaces across; never moves `upTo`. */
572
+ private bookExact;
537
573
  private state;
538
574
  }
539
575
  //#endregion
@@ -550,6 +586,14 @@ interface CheckInboxRequest {
550
586
  limit?: number;
551
587
  ack?: RaftAckMode;
552
588
  }
589
+ export declare const checkInboxRequestSchema: z.ZodObject<{
590
+ since: z.ZodOptional<z.ZodNumber>;
591
+ limit: z.ZodOptional<z.ZodNumber>;
592
+ ack: z.ZodOptional<z.ZodEnum<{
593
+ cursor: "cursor";
594
+ immediate: "immediate";
595
+ }>>;
596
+ }, z.core.$strip>;
553
597
  interface RaftInboxBatch {
554
598
  messages: RaftMessage[];
555
599
  /** Pass as `since` on the next check to acknowledge this batch (cursor mode). `null` when the Server sent none. */
@@ -569,6 +613,14 @@ interface DrainInboxRequest {
569
613
  limit?: number;
570
614
  ack?: RaftAckMode;
571
615
  }
616
+ export declare const drainInboxRequestSchema: z.ZodObject<{
617
+ since: z.ZodOptional<z.ZodNumber>;
618
+ limit: z.ZodOptional<z.ZodNumber>;
619
+ ack: z.ZodOptional<z.ZodEnum<{
620
+ cursor: "cursor";
621
+ immediate: "immediate";
622
+ }>>;
623
+ }, z.core.$strip>;
572
624
  interface RaftInboxDrainSummary {
573
625
  /** Cursor of the last batch handed out; pass it as `since` on the next pull to acknowledge that batch. */
574
626
  cursor: number | null;
@@ -583,6 +635,13 @@ interface RaftInboxDrainSummary {
583
635
  ok: false;
584
636
  }> | null;
585
637
  }
638
+ /** A whole drain as one result (the SDK's `invoke("inbox.drain")`): every batch's messages, in order, and the summary. */
639
+ interface RaftInboxDrained {
640
+ messages: RaftMessage[];
641
+ /** Batches handed out. */
642
+ batches: number;
643
+ summary: RaftInboxDrainSummary;
644
+ }
586
645
  interface ListInboxRequest {
587
646
  view?: "unread" | "mentions";
588
647
  /** Next page: the `nextBeforeSeq` of the previous page. */
@@ -590,6 +649,14 @@ interface ListInboxRequest {
590
649
  /** 1..50; Server default 20. */
591
650
  limit?: number;
592
651
  }
652
+ export declare const listInboxRequestSchema: z.ZodObject<{
653
+ view: z.ZodOptional<z.ZodEnum<{
654
+ mentions: "mentions";
655
+ unread: "unread";
656
+ }>>;
657
+ before: z.ZodOptional<z.ZodNumber>;
658
+ limit: z.ZodOptional<z.ZodNumber>;
659
+ }, z.core.$strip>;
593
660
  interface RaftInboxConversation {
594
661
  target: string;
595
662
  kind: "dm" | "channel" | "thread";
@@ -627,6 +694,14 @@ interface ReadHistoryRequest {
627
694
  */
628
695
  consume?: boolean;
629
696
  }
697
+ export declare const readHistoryRequestSchema: z.ZodObject<{
698
+ target: z.ZodString;
699
+ after: z.ZodOptional<z.ZodNumber>;
700
+ before: z.ZodOptional<z.ZodNumber>;
701
+ around: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
702
+ limit: z.ZodOptional<z.ZodNumber>;
703
+ consume: z.ZodOptional<z.ZodBoolean>;
704
+ }, z.core.$strip>;
630
705
  interface RaftHistoryPage {
631
706
  /** Canonical target the Server resolved (falls back to the requested spelling on older Servers). */
632
707
  target: string;
@@ -659,6 +734,48 @@ interface SendMessageRequest {
659
734
  exactSeqs?: number[];
660
735
  };
661
736
  }
737
+ export declare const sendMessageRequestSchema: z.ZodObject<{
738
+ content: z.ZodString;
739
+ attachmentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
740
+ idempotencyKey: z.ZodOptional<z.ZodString>;
741
+ mentions: z.ZodOptional<z.ZodArray<z.ZodObject<{
742
+ type: z.ZodEnum<{
743
+ user: "user";
744
+ agent: "agent";
745
+ }>;
746
+ id: z.ZodString;
747
+ name: z.ZodString;
748
+ }, z.core.$strip>>>;
749
+ seen: z.ZodOptional<z.ZodObject<{
750
+ upToSeq: z.ZodOptional<z.ZodNumber>;
751
+ exactSeqs: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
752
+ }, z.core.$strip>>;
753
+ target: z.ZodString;
754
+ }, z.core.$strip>;
755
+ /** `reply(message, request)` as one argument object: the received message (its `target`) and the send fields. */
756
+ interface ReplyToRequest extends Omit<SendMessageRequest, "target"> {
757
+ message: Pick<RaftMessage, "target">;
758
+ }
759
+ export declare const replyToRequestSchema: z.ZodObject<{
760
+ content: z.ZodString;
761
+ attachmentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
762
+ idempotencyKey: z.ZodOptional<z.ZodString>;
763
+ mentions: z.ZodOptional<z.ZodArray<z.ZodObject<{
764
+ type: z.ZodEnum<{
765
+ user: "user";
766
+ agent: "agent";
767
+ }>;
768
+ id: z.ZodString;
769
+ name: z.ZodString;
770
+ }, z.core.$strip>>>;
771
+ seen: z.ZodOptional<z.ZodObject<{
772
+ upToSeq: z.ZodOptional<z.ZodNumber>;
773
+ exactSeqs: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
774
+ }, z.core.$strip>>;
775
+ message: z.ZodObject<{
776
+ target: z.ZodString;
777
+ }, z.core.$strip>;
778
+ }, z.core.$strip>;
662
779
  interface RaftSent {
663
780
  messageId: string;
664
781
  messageSeq: number | null;
@@ -699,6 +816,11 @@ interface ClaimTasksRequest {
699
816
  /** Full or short message ids of top-level messages to claim as tasks. */
700
817
  messageIds?: string[];
701
818
  }
819
+ export declare const claimTasksRequestSchema: z.ZodObject<{
820
+ target: z.ZodString;
821
+ taskNumbers: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
822
+ messageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
823
+ }, z.core.$strip>;
702
824
  type RaftClaimRowState = "claimed" | "already_yours" | "conflict" | "refused";
703
825
  interface RaftClaimRow {
704
826
  ref: string;
@@ -730,6 +852,18 @@ interface ListTasksRequest {
730
852
  mine?: boolean;
731
853
  status?: RaftTaskStatus | "all";
732
854
  }
855
+ export declare const listTasksRequestSchema: z.ZodObject<{
856
+ target: z.ZodOptional<z.ZodString>;
857
+ mine: z.ZodOptional<z.ZodBoolean>;
858
+ status: z.ZodOptional<z.ZodEnum<{
859
+ todo: "todo";
860
+ in_progress: "in_progress";
861
+ in_review: "in_review";
862
+ done: "done";
863
+ closed: "closed";
864
+ all: "all";
865
+ }>>;
866
+ }, z.core.$strip>;
733
867
  interface RaftTaskBoard {
734
868
  scope: "channel" | "mine";
735
869
  target: string | null;
@@ -745,6 +879,14 @@ interface CreateTasksRequest {
745
879
  /** `@handle`; yourself to start in_progress, or (owner/admin) someone else to reserve a todo. */
746
880
  assignee?: string;
747
881
  }
882
+ export declare const createTasksRequestSchema: z.ZodObject<{
883
+ target: z.ZodString;
884
+ tasks: z.ZodArray<z.ZodObject<{
885
+ title: z.ZodString;
886
+ createsResource: z.ZodOptional<z.ZodBoolean>;
887
+ }, z.core.$strip>>;
888
+ assignee: z.ZodOptional<z.ZodString>;
889
+ }, z.core.$strip>;
748
890
  type RaftTasksCreated = AgentApiTaskCreateResponse & {
749
891
  target: string;
750
892
  };
@@ -752,24 +894,63 @@ interface TaskRef {
752
894
  target: string;
753
895
  taskNumber: number;
754
896
  }
897
+ export declare const taskRefSchema: z.ZodObject<{
898
+ target: z.ZodString;
899
+ taskNumber: z.ZodNumber;
900
+ }, z.core.$strip>;
755
901
  interface AssignTaskRequest extends TaskRef {
756
- /** `@handle`, or null to clear the assignment. */
757
- assignee: string | null;
902
+ /** `@handle` to assign. Required: clearing is the explicit `tasks.unassign`, never an omitted argument. */
903
+ assignee: string;
904
+ /** Optimistic-concurrency token from a task you just read; lose rather than clobber. */
905
+ expectedRevision?: number;
906
+ }
907
+ export declare const assignTaskRequestSchema: z.ZodObject<{
908
+ assignee: z.ZodString;
909
+ expectedRevision: z.ZodOptional<z.ZodNumber>;
910
+ target: z.ZodString;
911
+ taskNumber: z.ZodNumber;
912
+ }, z.core.$strip>;
913
+ interface UnassignTaskRequest extends TaskRef {
758
914
  /** Optimistic-concurrency token from a task you just read; lose rather than clobber. */
759
915
  expectedRevision?: number;
760
916
  }
761
917
  interface UpdateTaskStatusRequest extends TaskRef {
762
918
  status: RaftTaskStatus;
763
919
  }
920
+ export declare const updateTaskStatusRequestSchema: z.ZodObject<{
921
+ status: z.ZodEnum<{
922
+ todo: "todo";
923
+ in_progress: "in_progress";
924
+ in_review: "in_review";
925
+ done: "done";
926
+ closed: "closed";
927
+ }>;
928
+ target: z.ZodString;
929
+ taskNumber: z.ZodNumber;
930
+ }, z.core.$strip>;
764
931
  type UpdateTaskStatusOutcome = RaftOutcome<UpdateTaskStatusRequest, "updated"> | RaftInterrupted;
765
932
  interface AmendTaskRequest extends TaskRef {
766
933
  title?: string;
767
934
  /** New description; `null` clears it. */
768
935
  description?: string | null;
769
936
  }
937
+ export declare const amendTaskRequestSchema: z.ZodObject<{
938
+ title: z.ZodOptional<z.ZodString>;
939
+ description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
940
+ target: z.ZodString;
941
+ taskNumber: z.ZodNumber;
942
+ }, z.core.$strip>;
770
943
  type AmendTaskOutcome = RaftOutcome<AgentApiTaskAmendSuccessResponse & {
771
944
  target: string;
772
945
  }, "amended"> | RaftInterrupted;
946
+ interface ConvertMessageToTaskRequest {
947
+ target: string;
948
+ messageId: string;
949
+ }
950
+ export declare const convertMessageToTaskRequestSchema: z.ZodObject<{
951
+ target: z.ZodString;
952
+ messageId: z.ZodString;
953
+ }, z.core.$strip>;
773
954
  //#endregion
774
955
  //#region ../shared/src/agentOps/wake.d.ts
775
956
  export declare const RAFT_INBOX_NOTICE_SCHEMA: "raft-agent-inbox-notice.v1";
@@ -827,6 +1008,19 @@ export declare function verifyInboxNotice(input: VerifyNoticeInput): Promise<Ver
827
1008
  type RaftWebhookStatus = AgentApiPushWebhookStatusResponse;
828
1009
  //#endregion
829
1010
  //#region ../shared/src/agentOps/channels.d.ts
1011
+ /** `{ target }` of a regular channel (join, leave, mute, unmute). */
1012
+ export declare const channelTargetRequestSchema: z.ZodObject<{
1013
+ target: z.ZodString;
1014
+ }, z.core.$strip>;
1015
+ export declare const channelMembersRequestSchema: z.ZodObject<{
1016
+ target: z.ZodString;
1017
+ }, z.core.$strip>;
1018
+ /** `threads.list` takes no arguments. */
1019
+ export declare const listThreadsRequestSchema: z.ZodObject<{}, z.core.$strip>;
1020
+ export declare const unfollowThreadRequestSchema: z.ZodObject<{
1021
+ target: z.ZodString;
1022
+ reason: z.ZodOptional<z.ZodString>;
1023
+ }, z.core.$strip>;
830
1024
  interface RaftChannelRef {
831
1025
  target: string;
832
1026
  channelId: string;
@@ -856,6 +1050,27 @@ interface ServerInfoRequest {
856
1050
  /** Channels only: restrict to joined channels. */
857
1051
  joined?: boolean;
858
1052
  }
1053
+ export declare const serverInfoRequestSchema: z.ZodObject<{
1054
+ view: z.ZodOptional<z.ZodEnum<{
1055
+ channels: "channels";
1056
+ agents: "agents";
1057
+ humans: "humans";
1058
+ summary: "summary";
1059
+ full: "full";
1060
+ }>>;
1061
+ offset: z.ZodOptional<z.ZodNumber>;
1062
+ limit: z.ZodOptional<z.ZodNumber>;
1063
+ joined: z.ZodOptional<z.ZodBoolean>;
1064
+ }, z.core.$strip>;
1065
+ export declare const showProfileRequestSchema: z.ZodObject<{
1066
+ target: z.ZodOptional<z.ZodString>;
1067
+ }, z.core.$strip>;
1068
+ /** The Agent API's profile body schema; at least one field is required (checked by the operation). */
1069
+ export declare const updateProfileRequestSchema: z.ZodObject<{
1070
+ avatarUrl: z.ZodOptional<z.ZodString>;
1071
+ displayName: z.ZodOptional<z.ZodString>;
1072
+ description: z.ZodOptional<z.ZodString>;
1073
+ }, z.core.$loose>;
859
1074
  interface RaftServerInfo {
860
1075
  view: NonNullable<ServerInfoRequest["view"]>;
861
1076
  server: AgentApiServerInfoResponse;
@@ -866,6 +1081,10 @@ interface RaftServerInfo {
866
1081
  }
867
1082
  //#endregion
868
1083
  //#region ../shared/src/agentOps/attachments.d.ts
1084
+ export declare const attachmentCommentsRequestSchema: z.ZodObject<{
1085
+ attachmentId: z.ZodString;
1086
+ limit: z.ZodOptional<z.ZodNumber>;
1087
+ }, z.core.$strip>;
869
1088
  /** Explicit type wins; otherwise sniff the bytes, then the filename extension, then octet-stream. */
870
1089
  export declare function inferAttachmentMimeType(filename: string, bytes: Uint8Array, explicit?: string | null): string;
871
1090
  interface UploadAttachmentRequest {
@@ -901,6 +1120,26 @@ interface SearchMessagesRequest {
901
1120
  limit?: number;
902
1121
  offset?: number;
903
1122
  }
1123
+ export declare const searchMessagesRequestSchema: z.ZodObject<{
1124
+ query: z.ZodOptional<z.ZodString>;
1125
+ target: z.ZodOptional<z.ZodString>;
1126
+ sender: z.ZodOptional<z.ZodString>;
1127
+ sort: z.ZodOptional<z.ZodEnum<{
1128
+ relevance: "relevance";
1129
+ recent: "recent";
1130
+ }>>;
1131
+ before: z.ZodOptional<z.ZodString>;
1132
+ after: z.ZodOptional<z.ZodString>;
1133
+ limit: z.ZodOptional<z.ZodNumber>;
1134
+ offset: z.ZodOptional<z.ZodNumber>;
1135
+ }, z.core.$strip>;
1136
+ export declare const resolveMessageRequestSchema: z.ZodObject<{
1137
+ messageId: z.ZodString;
1138
+ }, z.core.$strip>;
1139
+ export declare const reactRequestSchema: z.ZodObject<{
1140
+ messageId: z.ZodString;
1141
+ emoji: z.ZodString;
1142
+ }, z.core.$strip>;
904
1143
  interface RaftSearchPage {
905
1144
  query: string;
906
1145
  results: AgentApiMessageSearchResponse["results"];
@@ -939,6 +1178,19 @@ interface AgentMentionActionResult {
939
1178
  }
940
1179
  //#endregion
941
1180
  //#region ../shared/src/agentOps/mentions.d.ts
1181
+ export declare const pendingMentionActionsRequestSchema: z.ZodObject<{
1182
+ limit: z.ZodOptional<z.ZodNumber>;
1183
+ }, z.core.$strip>;
1184
+ export declare const executeMentionActionRequestSchema: z.ZodObject<{
1185
+ action: z.ZodEnum<{
1186
+ notify: "notify";
1187
+ add: "add";
1188
+ }>;
1189
+ resolutionIds: z.ZodArray<z.ZodString>;
1190
+ }, z.core.$strip>;
1191
+ export declare const senderMentionDeliveriesRequestSchema: z.ZodObject<{
1192
+ messageId: z.ZodString;
1193
+ }, z.core.$strip>;
942
1194
  interface RaftPendingMentions {
943
1195
  actions: AgentPendingMentionAction[];
944
1196
  /** Server-reported; `null` when it did not say (completeness not asserted). */
@@ -955,6 +1207,17 @@ interface ManualContext {
955
1207
  intent: string;
956
1208
  reason: string;
957
1209
  }
1210
+ export declare const getManualTopicRequestSchema: z.ZodObject<{
1211
+ intent: z.ZodString;
1212
+ reason: z.ZodString;
1213
+ topic: z.ZodString;
1214
+ }, z.core.$strip>;
1215
+ export declare const searchManualRequestSchema: z.ZodObject<{
1216
+ intent: z.ZodString;
1217
+ reason: z.ZodString;
1218
+ query: z.ZodString;
1219
+ scope: z.ZodOptional<z.ZodString>;
1220
+ }, z.core.$strip>;
958
1221
  //#endregion
959
1222
  //#region ../shared/src/agentOps/state.d.ts
960
1223
  export declare const RAFT_STATE_SCHEMA: "raft-sdk-state.v1";
@@ -1001,6 +1264,88 @@ export declare function hashRaftSendContent(target: string, content: string, att
1001
1264
  //#endregion
1002
1265
  //#region ../shared/src/agentOps/actions.d.ts
1003
1266
  type PrepareActionCardRequest = AgentApiActionPrepareBody;
1267
+ /**
1268
+ * The Agent API's own body schema (a discriminated union over the card
1269
+ * types), so the SDK checks exactly what the Server checks. The operation
1270
+ * manifest projects it flattened (see the SDK's operations.ts).
1271
+ */
1272
+ export declare const prepareActionCardRequestSchema: import("zod").ZodObject<{
1273
+ target: import("zod").ZodString;
1274
+ action: import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
1275
+ type: import("zod").ZodLiteral<"channel:create">;
1276
+ name: import("zod").ZodString;
1277
+ visibility: import("zod").ZodDefault<import("zod").ZodEnum<{
1278
+ private: "private";
1279
+ public: "public";
1280
+ }>>;
1281
+ description: import("zod").ZodOptional<import("zod").ZodString>;
1282
+ initialHumans: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
1283
+ initialAgents: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
1284
+ draftHint: import("zod").ZodOptional<import("zod").ZodString>;
1285
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
1286
+ type: import("zod").ZodLiteral<"agent:create">;
1287
+ name: import("zod").ZodString;
1288
+ description: import("zod").ZodOptional<import("zod").ZodString>;
1289
+ suggestedComputer: import("zod").ZodOptional<import("zod").ZodString>;
1290
+ requiredComputer: import("zod").ZodOptional<import("zod").ZodString>;
1291
+ draftHint: import("zod").ZodOptional<import("zod").ZodString>;
1292
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
1293
+ type: import("zod").ZodLiteral<"channel:add_member">;
1294
+ channel: import("zod").ZodString;
1295
+ humans: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
1296
+ agents: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
1297
+ draftHint: import("zod").ZodOptional<import("zod").ZodString>;
1298
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
1299
+ type: import("zod").ZodLiteral<"integration:approve_agent_login">;
1300
+ requestId: import("zod").ZodUUID;
1301
+ agentId: import("zod").ZodUUID;
1302
+ agentName: import("zod").ZodString;
1303
+ clientId: import("zod").ZodUUID;
1304
+ clientKey: import("zod").ZodString;
1305
+ clientName: import("zod").ZodString;
1306
+ scopes: import("zod").ZodArray<import("zod").ZodString>;
1307
+ draftHint: import("zod").ZodOptional<import("zod").ZodString>;
1308
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
1309
+ type: import("zod").ZodLiteral<"integration:install_marketplace_app">;
1310
+ clientId: import("zod").ZodUUID;
1311
+ clientKey: import("zod").ZodString;
1312
+ clientName: import("zod").ZodString;
1313
+ clientNameSha256: import("zod").ZodString;
1314
+ agentId: import("zod").ZodUUID;
1315
+ agentName: import("zod").ZodString;
1316
+ scopes: import("zod").ZodArray<import("zod").ZodString>;
1317
+ draftHint: import("zod").ZodOptional<import("zod").ZodString>;
1318
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
1319
+ description: import("zod").ZodOptional<import("zod").ZodString>;
1320
+ category: import("zod").ZodOptional<import("zod").ZodString>;
1321
+ homepageUrl: import("zod").ZodOptional<import("zod").ZodString>;
1322
+ agentManifestUrl: import("zod").ZodOptional<import("zod").ZodString>;
1323
+ type: import("zod").ZodLiteral<"integration:register_app">;
1324
+ name: import("zod").ZodString;
1325
+ clientKey: import("zod").ZodOptional<import("zod").ZodString>;
1326
+ returnUrl: import("zod").ZodString;
1327
+ scopes: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
1328
+ unsafeDemoUrlOverride: import("zod").ZodOptional<import("zod").ZodBoolean>;
1329
+ draftHint: import("zod").ZodOptional<import("zod").ZodString>;
1330
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
1331
+ name: import("zod").ZodOptional<import("zod").ZodString>;
1332
+ description: import("zod").ZodOptional<import("zod").ZodString>;
1333
+ category: import("zod").ZodOptional<import("zod").ZodString>;
1334
+ homepageUrl: import("zod").ZodOptional<import("zod").ZodString>;
1335
+ returnUrl: import("zod").ZodOptional<import("zod").ZodString>;
1336
+ agentManifestUrl: import("zod").ZodOptional<import("zod").ZodString>;
1337
+ type: import("zod").ZodLiteral<"integration:update_app_registration">;
1338
+ clientKey: import("zod").ZodString;
1339
+ scopes: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
1340
+ unsafeDemoUrlOverride: import("zod").ZodOptional<import("zod").ZodBoolean>;
1341
+ draftHint: import("zod").ZodOptional<import("zod").ZodString>;
1342
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
1343
+ type: import("zod").ZodLiteral<"integration:recover_app_owner">;
1344
+ clientKey: import("zod").ZodString;
1345
+ targetAgent: import("zod").ZodString;
1346
+ draftHint: import("zod").ZodOptional<import("zod").ZodString>;
1347
+ }, import("zod/v4/core").$strip>], "type">;
1348
+ }, import("zod/v4/core").$loose>;
1004
1349
  interface RaftPreparedCard {
1005
1350
  target: string;
1006
1351
  /** The card message; a human commits it by clicking its action verb. */
@@ -1292,8 +1637,8 @@ interface TaskResourceReceipt {
1292
1637
  declare const attachmentUploadSessionSchema: z.ZodObject<{
1293
1638
  uploadId: z.ZodUUID;
1294
1639
  state: z.ZodEnum<{
1295
- expired: "expired";
1296
1640
  pending: "pending";
1641
+ expired: "expired";
1297
1642
  canceled: "canceled";
1298
1643
  completed: "completed";
1299
1644
  verifying: "verifying";
@@ -1309,8 +1654,8 @@ declare const attachmentUploadSessionSchema: z.ZodObject<{
1309
1654
  }, z.core.$strict>>;
1310
1655
  terminalReason: z.ZodNullable<z.ZodString>;
1311
1656
  reservationState: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
1312
- expired: "expired";
1313
1657
  pending: "pending";
1658
+ expired: "expired";
1314
1659
  canceled: "canceled";
1315
1660
  consumed: "consumed";
1316
1661
  }>>>;
@@ -1357,32 +1702,6 @@ declare const attachmentUploadPathParamsSchema: z.ZodObject<{
1357
1702
  uploadId: z.ZodUUID;
1358
1703
  }, z.core.$strict>;
1359
1704
  //#endregion
1360
- //#region ../shared/src/agentOps/commands/errors.d.ts
1361
- type CommandErrorCode = "MISSING_AGENT_ID" | "MISSING_SERVER_URL" | "MISSING_AGENT_PROXY_URL" | "MULTIPLE_AGENT_PROXY_TOKENS" | "MISSING_AGENT_PROXY_TOKEN" | "MISSING_TOKEN" | "CHECK_FAILED" | "COMMAND_TIMEOUT" | "ARCHIVE_FAILED" | "AMEND_FAILED" | "COMMENTS_FAILED" | "CREATE_FAILED" | "RECEIPT_FAILED" | "INBOX_CHECK_FAILED" | "INBOX_UNAVAILABLE" | "ORIGIN_NOT_ALLOWED" | "TOKEN_FILE_UNREADABLE" | "TOKEN_FILE_EMPTY" | "PROFILE_FILE_UNREADABLE" | "PROFILE_FILE_INVALID" | "PROFILE_MANAGED_CONTEXT_CONFLICT" | "MANAGED_WRAPPER_UNAVAILABLE" | "MANAGED_WRAPPER_REQUIRED" | "MANAGED_WRAPPER_FORWARD_FAILED" | "BRIDGE_EXPECTED_AGENT_REQUIRED" | "BRIDGE_IDENTITY_MISMATCH" | "SEND_HELD_AS_DRAFT" | "SEND_HELD" | "GUIDANCE_DELIVERED" | "SEND_DRAFT_NOT_FOUND" | "SEND_DRAFT_EXPIRED" | "SAVED_DRAFT_IDENTITY_CHANGED" | "DRAFT_PENDING" | "THREAD_CONTEXT_TARGET_CONFIRMATION_REQUIRED" | "INVALID_ARG" | "INVALID_SCOPE" | "INVALID_TARGET" | "INVALID_JSON_RESPONSE" | "IDENTITY_MISMATCH" | "PROMPT_UNAVAILABLE" | "WHOAMI_FAILED" | "INFO_FAILED" | "INTEGRATION_SESSION_HANDOFF_FAILED" | "HISTORY_FAILED" | "JOIN_FAILED" | "KNOWLEDGE_GET_FAILED" | "KNOWLEDGE_SEARCH_FAILED" | "KNOWLEDGE_CONTEXT_INVALID" | "LEAVE_FAILED" | "LIST_FAILED" | "MEMBERS_FAILED" | "MUTE_FAILED" | "MENTION_ACTION_FAILED" | "MENTION_DELIVERY_FAILED" | "AMBIGUOUS_ID" | "BRIDGE_ALREADY_RUNNING" | "BRIDGE_WAKE_HINTS_FAILED" | "BRIDGE_WAKE_STREAM_FAILED" | "BRIDGE_WAKE_STREAM_UNAVAILABLE" | "BRIDGE_ACTIVITY_DRAIN_FAILED" | "BRIDGE_ACTIVITY_FORWARD_FAILED" | "BRIDGE_REQUIRES_PROFILE" | "NOT_FOUND" | "PROFILE_SHOW_FAILED" | "READ_FAILED" | "SEARCH_FAILED" | "SCOPE_DENIED" | "QUERY_TOO_BROAD" | "SEARCH_TIMEOUT" | "SEARCH_UNAVAILABLE" | "SERVER_5XX" | "PROXY_5XX" | "UNFOLLOW_FAILED" | "UNARCHIVE_FAILED" | "UNMUTE_FAILED" | "UNCLAIM_FAILED" | "CLAIM_FAILED" | "CLAIM_CONFLICT" | "ASSIGN_FAILED" | "DELETE_FAILED" | "CONVERT_FAILED" | "UPDATE_FAILED" | "VIEW_FAILED" | "VERSION_UNAVAILABLE" | "WAIT_FAILED" | "LOCAL_WRITE_FAILED" | "LOCAL_WRITE_SOURCE_FAILED" | "LOCAL_WRITE_DESTINATION_FAILED" | "LOCAL_WRITE_PARTIAL_FAILED" | "LOCAL_WRITE_POST_COMMIT_FAILED" | "LOCAL_WRITE_SIZE_EXCEEDED" | "INTERNAL_BUG" | "knowledge_agent_missing" | "knowledge_internal_error" | "knowledge_intent_invalid" | "knowledge_language_unsupported" | "knowledge_not_found" | "knowledge_query_invalid" | "knowledge_reason_invalid" | "knowledge_scope_invalid" | "knowledge_source_invalid" | "knowledge_topic_invalid" | "knowledge_trace_id_invalid" | "knowledge_turn_id_invalid" | "unsupported_capability";
1362
- //#endregion
1363
- //#region ../shared/src/agentOps/commands/types.d.ts
1364
- /**
1365
- * What the gateway reads besides `text` (design: Response). A command that
1366
- * stopped for the model's decision is `RaftInterrupted` (interrupt.ts, the
1367
- * same shape the SDK returns; narrow with `isInterrupted`). A held task write
1368
- * returns it (exit 0); a held send exits non-zero as it always has
1369
- * (SEND_HELD_AS_DRAFT) and carries it on `CommandError.interrupted`.
1370
- */
1371
- type CommandOutcome = {
1372
- ok: true;
1373
- state: string;
1374
- data: unknown;
1375
- next: RaftNextStep | null;
1376
- } | RaftInterrupted | {
1377
- ok: false;
1378
- error: RaftOpError | {
1379
- code: string;
1380
- message: string;
1381
- retryable: boolean;
1382
- };
1383
- next: RaftNextStep | null;
1384
- };
1385
- //#endregion
1386
1705
  //#region ../shared/src/agentApiContract.d.ts
1387
1706
  declare const agentApiMethods: readonly ["GET", "POST", "PUT", "PATCH", "DELETE"];
1388
1707
  type AgentApiMethod = (typeof agentApiMethods)[number];
@@ -1681,8 +2000,8 @@ declare const agentApiInboxListResponseSchema: z.ZodObject<{
1681
2000
  target: z.ZodString;
1682
2001
  kind: z.ZodEnum<{
1683
2002
  channel: "channel";
1684
- thread: "thread";
1685
2003
  dm: "dm";
2004
+ thread: "thread";
1686
2005
  }>;
1687
2006
  unread: z.ZodNumber;
1688
2007
  mentions: z.ZodNumber;
@@ -1917,13 +2236,13 @@ declare const agentApiIntegrationAppUpdateBodySchema: z.ZodObject<{
1917
2236
  declare const agentApiIntegrationAppManageBodySchema: z.ZodObject<{
1918
2237
  clientKey: z.ZodString;
1919
2238
  action: z.ZodEnum<{
2239
+ delete: "delete";
1920
2240
  share_link_get: "share_link_get";
1921
2241
  share_link_create: "share_link_create";
1922
2242
  share_link_revoke: "share_link_revoke";
1923
2243
  request_publish: "request_publish";
1924
2244
  request_unpublish: "request_unpublish";
1925
2245
  clear_logo: "clear_logo";
1926
- delete: "delete";
1927
2246
  }>;
1928
2247
  expiresInDays: z.ZodOptional<z.ZodNumber>;
1929
2248
  }, z.core.$loose>;
@@ -1937,8 +2256,8 @@ declare const agentApiActionPrepareBodySchema: z.ZodObject<{
1937
2256
  type: z.ZodLiteral<"channel:create">;
1938
2257
  name: z.ZodString;
1939
2258
  visibility: z.ZodDefault<z.ZodEnum<{
1940
- public: "public";
1941
2259
  private: "private";
2260
+ public: "public";
1942
2261
  }>>;
1943
2262
  description: z.ZodOptional<z.ZodString>;
1944
2263
  initialHumans: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -2008,23 +2327,6 @@ declare const agentApiActionPrepareBodySchema: z.ZodObject<{
2008
2327
  draftHint: z.ZodOptional<z.ZodString>;
2009
2328
  }, z.core.$strip>], "type">;
2010
2329
  }, z.core.$loose>;
2011
- declare const agentApiCommandBodySchema: z.ZodObject<{
2012
- argv: z.ZodArray<z.ZodString>;
2013
- stdin: z.ZodOptional<z.ZodString>;
2014
- origin: z.ZodOptional<z.ZodEnum<{
2015
- code: "code";
2016
- model: "model";
2017
- }>>;
2018
- idempotencyKey: z.ZodOptional<z.ZodString>;
2019
- timezone: z.ZodOptional<z.ZodString>;
2020
- contextId: z.ZodOptional<z.ZodString>;
2021
- ackEventsCursor: z.ZodOptional<z.ZodString>;
2022
- }, z.core.$loose>;
2023
- declare const agentApiCommandResponseSchema: z.ZodObject<{
2024
- exitCode: z.ZodNumber;
2025
- text: z.ZodString;
2026
- outcome: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
2027
- }, z.core.$loose>;
2028
2330
  declare const agentApiServerUpdateBodySchema: z.ZodObject<{
2029
2331
  name: z.ZodOptional<z.ZodString>;
2030
2332
  hideHumansFromMembers: z.ZodOptional<z.ZodBoolean>;
@@ -2100,10 +2402,10 @@ declare const agentApiServerInfoResponseSchema: z.ZodObject<{
2100
2402
  humans: z.ZodArray<z.ZodObject<{
2101
2403
  name: z.ZodString;
2102
2404
  role: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
2405
+ guest: "guest";
2103
2406
  owner: "owner";
2104
2407
  admin: "admin";
2105
2408
  member: "member";
2106
- guest: "guest";
2107
2409
  }>>>;
2108
2410
  }, z.core.$loose>>;
2109
2411
  }, z.core.$loose>;
@@ -2152,13 +2454,13 @@ declare const agentApiMentionActionsExecuteResponseSchema: z.ZodObject<{
2152
2454
  results: z.ZodArray<z.ZodObject<{
2153
2455
  resolutionId: z.ZodString;
2154
2456
  status: z.ZodEnum<{
2155
- queued: "queued";
2457
+ not_found: "not_found";
2156
2458
  delivered: "delivered";
2459
+ queued: "queued";
2157
2460
  dropped: "dropped";
2158
2461
  stale: "stale";
2159
2462
  expired: "expired";
2160
2463
  no_permission: "no_permission";
2161
- not_found: "not_found";
2162
2464
  ambiguous: "ambiguous";
2163
2465
  }>;
2164
2466
  action: z.ZodOptional<z.ZodEnum<{
@@ -2305,8 +2607,8 @@ declare const agentApiIntegrationLoginResponseSchema: z.ZodObject<{
2305
2607
  declare const agentApiIntegrationAppPrepareResponseSchema: z.ZodObject<{
2306
2608
  status: z.ZodLiteral<"prepared">;
2307
2609
  mode: z.ZodEnum<{
2308
- register: "register";
2309
2610
  update: "update";
2611
+ register: "register";
2310
2612
  }>;
2311
2613
  target: z.ZodString;
2312
2614
  actionCardMessageId: z.ZodString;
@@ -2362,13 +2664,13 @@ declare const agentApiIntegrationAppUpdateResponseSchema: z.ZodObject<{
2362
2664
  }, z.core.$loose>;
2363
2665
  declare const agentApiIntegrationAppManageResponseSchema: z.ZodObject<{
2364
2666
  action: z.ZodEnum<{
2667
+ delete: "delete";
2365
2668
  share_link_get: "share_link_get";
2366
2669
  share_link_create: "share_link_create";
2367
2670
  share_link_revoke: "share_link_revoke";
2368
2671
  request_publish: "request_publish";
2369
2672
  request_unpublish: "request_unpublish";
2370
2673
  clear_logo: "clear_logo";
2371
- delete: "delete";
2372
2674
  }>;
2373
2675
  clientId: z.ZodString;
2374
2676
  clientKey: z.ZodString;
@@ -2394,8 +2696,8 @@ declare const agentApiIntegrationAppLogoResponseSchema: z.ZodObject<{
2394
2696
  declare const agentApiIntegrationAppListResponseSchema: z.ZodObject<{
2395
2697
  apps: z.ZodArray<z.ZodObject<{
2396
2698
  state: z.ZodEnum<{
2397
- card_pending: "card_pending";
2398
2699
  committed: "committed";
2700
+ card_pending: "card_pending";
2399
2701
  }>;
2400
2702
  card: z.ZodNullable<z.ZodString>;
2401
2703
  installationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2424,8 +2726,8 @@ declare const agentApiIntegrationAppListResponseSchema: z.ZodObject<{
2424
2726
  declare const agentApiIntegrationAppStatusResponseSchema: z.ZodObject<{
2425
2727
  app: z.ZodObject<{
2426
2728
  state: z.ZodEnum<{
2427
- card_pending: "card_pending";
2428
2729
  committed: "committed";
2730
+ card_pending: "card_pending";
2429
2731
  }>;
2430
2732
  card: z.ZodNullable<z.ZodString>;
2431
2733
  installationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2462,8 +2764,8 @@ declare const agentApiHistoryConsumptionScopeSchema: z.ZodObject<{
2462
2764
  agent_id: z.ZodString;
2463
2765
  channel_id: z.ZodString;
2464
2766
  channel_type: z.ZodEnum<{
2465
- thread: "thread";
2466
2767
  dm: "dm";
2768
+ thread: "thread";
2467
2769
  }>;
2468
2770
  target: z.ZodString;
2469
2771
  }, z.core.$strip>;
@@ -2490,8 +2792,8 @@ declare const agentApiMessageResolveResponseSchema: z.ZodObject<{
2490
2792
  actor_id: z.ZodString;
2491
2793
  actor_kind: z.ZodEnum<{
2492
2794
  unknown: "unknown";
2493
- guest: "guest";
2494
2795
  human: "human";
2796
+ guest: "guest";
2495
2797
  remote: "remote";
2496
2798
  bot: "bot";
2497
2799
  }>;
@@ -2861,8 +3163,8 @@ declare const agentApiReminderLogResponseSchema: z.ZodObject<{
2861
3163
  updated: "updated";
2862
3164
  }>;
2863
3165
  actorType: z.ZodEnum<{
2864
- agent: "agent";
2865
3166
  human: "human";
3167
+ agent: "agent";
2866
3168
  system: "system";
2867
3169
  }>;
2868
3170
  actorId: z.ZodNullable<z.ZodString>;
@@ -3087,8 +3389,8 @@ declare const agentApiContract: {
3087
3389
  actor_id: z.ZodString;
3088
3390
  actor_kind: z.ZodEnum<{
3089
3391
  unknown: "unknown";
3090
- guest: "guest";
3091
3392
  human: "human";
3393
+ guest: "guest";
3092
3394
  remote: "remote";
3093
3395
  bot: "bot";
3094
3396
  }>;
@@ -3207,8 +3509,8 @@ declare const agentApiContract: {
3207
3509
  agent_id: z.ZodString;
3208
3510
  channel_id: z.ZodString;
3209
3511
  channel_type: z.ZodEnum<{
3210
- thread: "thread";
3211
3512
  dm: "dm";
3513
+ thread: "thread";
3212
3514
  }>;
3213
3515
  target: z.ZodString;
3214
3516
  }, z.core.$strip>>;
@@ -3233,8 +3535,8 @@ declare const agentApiContract: {
3233
3535
  actor_id: z.ZodString;
3234
3536
  actor_kind: z.ZodEnum<{
3235
3537
  unknown: "unknown";
3236
- guest: "guest";
3237
3538
  human: "human";
3539
+ guest: "guest";
3238
3540
  remote: "remote";
3239
3541
  bot: "bot";
3240
3542
  }>;
@@ -3515,8 +3817,8 @@ declare const agentApiContract: {
3515
3817
  actor_id: z.ZodString;
3516
3818
  actor_kind: z.ZodEnum<{
3517
3819
  unknown: "unknown";
3518
- guest: "guest";
3519
3820
  human: "human";
3821
+ guest: "guest";
3520
3822
  remote: "remote";
3521
3823
  bot: "bot";
3522
3824
  }>;
@@ -3607,8 +3909,8 @@ declare const agentApiContract: {
3607
3909
  actor_id: z.ZodString;
3608
3910
  actor_kind: z.ZodEnum<{
3609
3911
  unknown: "unknown";
3610
- guest: "guest";
3611
3912
  human: "human";
3913
+ guest: "guest";
3612
3914
  remote: "remote";
3613
3915
  bot: "bot";
3614
3916
  }>;
@@ -3719,8 +4021,8 @@ declare const agentApiContract: {
3719
4021
  actor_id: z.ZodString;
3720
4022
  actor_kind: z.ZodEnum<{
3721
4023
  unknown: "unknown";
3722
- guest: "guest";
3723
4024
  human: "human";
4025
+ guest: "guest";
3724
4026
  remote: "remote";
3725
4027
  bot: "bot";
3726
4028
  }>;
@@ -3811,8 +4113,8 @@ declare const agentApiContract: {
3811
4113
  actor_id: z.ZodString;
3812
4114
  actor_kind: z.ZodEnum<{
3813
4115
  unknown: "unknown";
3814
- guest: "guest";
3815
4116
  human: "human";
4117
+ guest: "guest";
3816
4118
  remote: "remote";
3817
4119
  bot: "bot";
3818
4120
  }>;
@@ -3977,8 +4279,8 @@ declare const agentApiContract: {
3977
4279
  actor_id: z.ZodString;
3978
4280
  actor_kind: z.ZodEnum<{
3979
4281
  unknown: "unknown";
3980
- guest: "guest";
3981
4282
  human: "human";
4283
+ guest: "guest";
3982
4284
  remote: "remote";
3983
4285
  bot: "bot";
3984
4286
  }>;
@@ -4069,8 +4371,8 @@ declare const agentApiContract: {
4069
4371
  actor_id: z.ZodString;
4070
4372
  actor_kind: z.ZodEnum<{
4071
4373
  unknown: "unknown";
4072
- guest: "guest";
4073
4374
  human: "human";
4375
+ guest: "guest";
4074
4376
  remote: "remote";
4075
4377
  bot: "bot";
4076
4378
  }>;
@@ -4181,8 +4483,8 @@ declare const agentApiContract: {
4181
4483
  actor_id: z.ZodString;
4182
4484
  actor_kind: z.ZodEnum<{
4183
4485
  unknown: "unknown";
4184
- guest: "guest";
4185
4486
  human: "human";
4487
+ guest: "guest";
4186
4488
  remote: "remote";
4187
4489
  bot: "bot";
4188
4490
  }>;
@@ -4273,8 +4575,8 @@ declare const agentApiContract: {
4273
4575
  actor_id: z.ZodString;
4274
4576
  actor_kind: z.ZodEnum<{
4275
4577
  unknown: "unknown";
4276
- guest: "guest";
4277
4578
  human: "human";
4579
+ guest: "guest";
4278
4580
  remote: "remote";
4279
4581
  bot: "bot";
4280
4582
  }>;
@@ -4412,8 +4714,8 @@ declare const agentApiContract: {
4412
4714
  actor_id: z.ZodString;
4413
4715
  actor_kind: z.ZodEnum<{
4414
4716
  unknown: "unknown";
4415
- guest: "guest";
4416
4717
  human: "human";
4718
+ guest: "guest";
4417
4719
  remote: "remote";
4418
4720
  bot: "bot";
4419
4721
  }>;
@@ -4606,8 +4908,8 @@ declare const agentApiContract: {
4606
4908
  actor_id: z.ZodString;
4607
4909
  actor_kind: z.ZodEnum<{
4608
4910
  unknown: "unknown";
4609
- guest: "guest";
4610
4911
  human: "human";
4912
+ guest: "guest";
4611
4913
  remote: "remote";
4612
4914
  bot: "bot";
4613
4915
  }>;
@@ -4721,8 +5023,8 @@ declare const agentApiContract: {
4721
5023
  actor_id: z.ZodString;
4722
5024
  actor_kind: z.ZodEnum<{
4723
5025
  unknown: "unknown";
4724
- guest: "guest";
4725
5026
  human: "human";
5027
+ guest: "guest";
4726
5028
  remote: "remote";
4727
5029
  bot: "bot";
4728
5030
  }>;
@@ -5151,8 +5453,8 @@ declare const agentApiContract: {
5151
5453
  target: z.ZodString;
5152
5454
  kind: z.ZodEnum<{
5153
5455
  channel: "channel";
5154
- thread: "thread";
5155
5456
  dm: "dm";
5457
+ thread: "thread";
5156
5458
  }>;
5157
5459
  unread: z.ZodNumber;
5158
5460
  mentions: z.ZodNumber;
@@ -5266,10 +5568,10 @@ declare const agentApiContract: {
5266
5568
  humans: z.ZodArray<z.ZodObject<{
5267
5569
  name: z.ZodString;
5268
5570
  role: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
5571
+ guest: "guest";
5269
5572
  owner: "owner";
5270
5573
  admin: "admin";
5271
5574
  member: "member";
5272
- guest: "guest";
5273
5575
  }>>>;
5274
5576
  }, z.core.$loose>>;
5275
5577
  }, z.core.$loose>;
@@ -5396,13 +5698,13 @@ declare const agentApiContract: {
5396
5698
  results: z.ZodArray<z.ZodObject<{
5397
5699
  resolutionId: z.ZodString;
5398
5700
  status: z.ZodEnum<{
5399
- queued: "queued";
5701
+ not_found: "not_found";
5400
5702
  delivered: "delivered";
5703
+ queued: "queued";
5401
5704
  dropped: "dropped";
5402
5705
  stale: "stale";
5403
5706
  expired: "expired";
5404
5707
  no_permission: "no_permission";
5405
- not_found: "not_found";
5406
5708
  ambiguous: "ambiguous";
5407
5709
  }>;
5408
5710
  action: z.ZodOptional<z.ZodEnum<{
@@ -5502,8 +5804,8 @@ declare const agentApiContract: {
5502
5804
  actor_id: z.ZodString;
5503
5805
  actor_kind: z.ZodEnum<{
5504
5806
  unknown: "unknown";
5505
- guest: "guest";
5506
5807
  human: "human";
5808
+ guest: "guest";
5507
5809
  remote: "remote";
5508
5810
  bot: "bot";
5509
5811
  }>;
@@ -5594,8 +5896,8 @@ declare const agentApiContract: {
5594
5896
  actor_id: z.ZodString;
5595
5897
  actor_kind: z.ZodEnum<{
5596
5898
  unknown: "unknown";
5597
- guest: "guest";
5598
5899
  human: "human";
5900
+ guest: "guest";
5599
5901
  remote: "remote";
5600
5902
  bot: "bot";
5601
5903
  }>;
@@ -5935,8 +6237,8 @@ declare const agentApiContract: {
5935
6237
  actor_id: z.ZodString;
5936
6238
  actor_kind: z.ZodEnum<{
5937
6239
  unknown: "unknown";
5938
- guest: "guest";
5939
6240
  human: "human";
6241
+ guest: "guest";
5940
6242
  remote: "remote";
5941
6243
  bot: "bot";
5942
6244
  }>;
@@ -6027,8 +6329,8 @@ declare const agentApiContract: {
6027
6329
  actor_id: z.ZodString;
6028
6330
  actor_kind: z.ZodEnum<{
6029
6331
  unknown: "unknown";
6030
- guest: "guest";
6031
6332
  human: "human";
6333
+ guest: "guest";
6032
6334
  remote: "remote";
6033
6335
  bot: "bot";
6034
6336
  }>;
@@ -6312,8 +6614,8 @@ declare const agentApiContract: {
6312
6614
  actor_id: z.ZodString;
6313
6615
  actor_kind: z.ZodEnum<{
6314
6616
  unknown: "unknown";
6315
- guest: "guest";
6316
6617
  human: "human";
6618
+ guest: "guest";
6317
6619
  remote: "remote";
6318
6620
  bot: "bot";
6319
6621
  }>;
@@ -6404,8 +6706,8 @@ declare const agentApiContract: {
6404
6706
  actor_id: z.ZodString;
6405
6707
  actor_kind: z.ZodEnum<{
6406
6708
  unknown: "unknown";
6407
- guest: "guest";
6408
6709
  human: "human";
6710
+ guest: "guest";
6409
6711
  remote: "remote";
6410
6712
  bot: "bot";
6411
6713
  }>;
@@ -6858,8 +7160,8 @@ declare const agentApiContract: {
6858
7160
  updated: "updated";
6859
7161
  }>;
6860
7162
  actorType: z.ZodEnum<{
6861
- agent: "agent";
6862
7163
  human: "human";
7164
+ agent: "agent";
6863
7165
  system: "system";
6864
7166
  }>;
6865
7167
  actorId: z.ZodNullable<z.ZodString>;
@@ -7234,8 +7536,8 @@ declare const agentApiContract: {
7234
7536
  readonly body: z.ZodObject<{
7235
7537
  status: z.ZodLiteral<"prepared">;
7236
7538
  mode: z.ZodEnum<{
7237
- register: "register";
7238
7539
  update: "update";
7540
+ register: "register";
7239
7541
  }>;
7240
7542
  target: z.ZodString;
7241
7543
  actionCardMessageId: z.ZodString;
@@ -7377,13 +7679,13 @@ declare const agentApiContract: {
7377
7679
  readonly body: z.ZodObject<{
7378
7680
  clientKey: z.ZodString;
7379
7681
  action: z.ZodEnum<{
7682
+ delete: "delete";
7380
7683
  share_link_get: "share_link_get";
7381
7684
  share_link_create: "share_link_create";
7382
7685
  share_link_revoke: "share_link_revoke";
7383
7686
  request_publish: "request_publish";
7384
7687
  request_unpublish: "request_unpublish";
7385
7688
  clear_logo: "clear_logo";
7386
- delete: "delete";
7387
7689
  }>;
7388
7690
  expiresInDays: z.ZodOptional<z.ZodNumber>;
7389
7691
  }, z.core.$loose>;
@@ -7391,13 +7693,13 @@ declare const agentApiContract: {
7391
7693
  readonly response: {
7392
7694
  readonly body: z.ZodObject<{
7393
7695
  action: z.ZodEnum<{
7696
+ delete: "delete";
7394
7697
  share_link_get: "share_link_get";
7395
7698
  share_link_create: "share_link_create";
7396
7699
  share_link_revoke: "share_link_revoke";
7397
7700
  request_publish: "request_publish";
7398
7701
  request_unpublish: "request_unpublish";
7399
7702
  clear_logo: "clear_logo";
7400
- delete: "delete";
7401
7703
  }>;
7402
7704
  clientId: z.ZodString;
7403
7705
  clientKey: z.ZodString;
@@ -7455,8 +7757,8 @@ declare const agentApiContract: {
7455
7757
  readonly body: z.ZodObject<{
7456
7758
  apps: z.ZodArray<z.ZodObject<{
7457
7759
  state: z.ZodEnum<{
7458
- card_pending: "card_pending";
7459
7760
  committed: "committed";
7761
+ card_pending: "card_pending";
7460
7762
  }>;
7461
7763
  card: z.ZodNullable<z.ZodString>;
7462
7764
  installationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -7506,8 +7808,8 @@ declare const agentApiContract: {
7506
7808
  readonly body: z.ZodObject<{
7507
7809
  app: z.ZodObject<{
7508
7810
  state: z.ZodEnum<{
7509
- card_pending: "card_pending";
7510
7811
  committed: "committed";
7812
+ card_pending: "card_pending";
7511
7813
  }>;
7512
7814
  card: z.ZodNullable<z.ZodString>;
7513
7815
  installationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -7554,8 +7856,8 @@ declare const agentApiContract: {
7554
7856
  type: z.ZodLiteral<"channel:create">;
7555
7857
  name: z.ZodString;
7556
7858
  visibility: z.ZodDefault<z.ZodEnum<{
7557
- public: "public";
7558
7859
  private: "private";
7860
+ public: "public";
7559
7861
  }>>;
7560
7862
  description: z.ZodOptional<z.ZodString>;
7561
7863
  initialHumans: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -7637,40 +7939,6 @@ declare const agentApiContract: {
7637
7939
  } & {
7638
7940
  fullPath: string;
7639
7941
  };
7640
- readonly agentCommand: {
7641
- readonly key: "agentCommand";
7642
- readonly method: "POST";
7643
- readonly path: "/command";
7644
- readonly client: {
7645
- readonly resource: "commands";
7646
- readonly method: "run";
7647
- };
7648
- readonly capability: "read";
7649
- readonly description: "Run one `raft` command as the bound agent and return the text the CLI prints, its exit code and its outcome. HTTP 200 whenever the command ran, failed commands included; each request the command makes is authorized on its own.";
7650
- readonly request: {
7651
- readonly body: z.ZodObject<{
7652
- argv: z.ZodArray<z.ZodString>;
7653
- stdin: z.ZodOptional<z.ZodString>;
7654
- origin: z.ZodOptional<z.ZodEnum<{
7655
- code: "code";
7656
- model: "model";
7657
- }>>;
7658
- idempotencyKey: z.ZodOptional<z.ZodString>;
7659
- timezone: z.ZodOptional<z.ZodString>;
7660
- contextId: z.ZodOptional<z.ZodString>;
7661
- ackEventsCursor: z.ZodOptional<z.ZodString>;
7662
- }, z.core.$loose>;
7663
- };
7664
- readonly response: {
7665
- readonly body: z.ZodObject<{
7666
- exitCode: z.ZodNumber;
7667
- text: z.ZodString;
7668
- outcome: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
7669
- }, z.core.$loose>;
7670
- };
7671
- } & {
7672
- fullPath: string;
7673
- };
7674
7942
  readonly attachmentUpload: {
7675
7943
  readonly key: "attachmentUpload";
7676
7944
  readonly method: "POST";
@@ -7804,8 +8072,8 @@ declare const agentApiContract: {
7804
8072
  readonly body: z.ZodObject<{
7805
8073
  uploadId: z.ZodUUID;
7806
8074
  state: z.ZodEnum<{
7807
- expired: "expired";
7808
8075
  pending: "pending";
8076
+ expired: "expired";
7809
8077
  canceled: "canceled";
7810
8078
  completed: "completed";
7811
8079
  verifying: "verifying";
@@ -7821,8 +8089,8 @@ declare const agentApiContract: {
7821
8089
  }, z.core.$strict>>;
7822
8090
  terminalReason: z.ZodNullable<z.ZodString>;
7823
8091
  reservationState: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
7824
- expired: "expired";
7825
8092
  pending: "pending";
8093
+ expired: "expired";
7826
8094
  canceled: "canceled";
7827
8095
  consumed: "consumed";
7828
8096
  }>>>;
@@ -7850,8 +8118,8 @@ declare const agentApiContract: {
7850
8118
  readonly body: z.ZodObject<{
7851
8119
  uploadId: z.ZodUUID;
7852
8120
  state: z.ZodEnum<{
7853
- expired: "expired";
7854
8121
  pending: "pending";
8122
+ expired: "expired";
7855
8123
  canceled: "canceled";
7856
8124
  completed: "completed";
7857
8125
  verifying: "verifying";
@@ -7867,8 +8135,8 @@ declare const agentApiContract: {
7867
8135
  }, z.core.$strict>>;
7868
8136
  terminalReason: z.ZodNullable<z.ZodString>;
7869
8137
  reservationState: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
7870
- expired: "expired";
7871
8138
  pending: "pending";
8139
+ expired: "expired";
7872
8140
  canceled: "canceled";
7873
8141
  consumed: "consumed";
7874
8142
  }>>>;
@@ -8289,11 +8557,6 @@ type AgentApiTaskHistoryResponse = z.infer<typeof agentApiTaskHistoryResponseSch
8289
8557
  type AgentApiProfileView = z.infer<typeof agentApiProfileViewSchema>;
8290
8558
  type AgentApiOkResponse = z.infer<typeof agentApiOkResponseSchema>;
8291
8559
  type AgentApiActionPrepareResponse = z.infer<typeof agentApiActionPrepareResponseSchema>;
8292
- type AgentApiCommandBody = z.infer<typeof agentApiCommandBodySchema>;
8293
- /** `outcome` is the command registry's CommandOutcome (agentOps/commands/types.ts), or null when nothing ran. */
8294
- type AgentApiCommandResponse = Omit<z.infer<typeof agentApiCommandResponseSchema>, "outcome"> & {
8295
- outcome: CommandOutcome | null;
8296
- };
8297
8560
  type AgentApiAgentContextResponse = z.infer<typeof agentApiAgentContextResponseSchema>;
8298
8561
  type AgentApiServerInfoResponse = z.infer<typeof agentApiServerInfoResponseSchema>;
8299
8562
  type AgentApiServerUpdateBody = z.infer<typeof agentApiServerUpdateBodySchema>;
@@ -8400,7 +8663,6 @@ type AgentApiRequestParamsByRoute = {
8400
8663
  integrationAppList: never;
8401
8664
  integrationAppStatus: never;
8402
8665
  actionPrepare: never;
8403
- agentCommand: never;
8404
8666
  attachmentUpload: never;
8405
8667
  attachmentUploadCapabilities: never;
8406
8668
  attachmentUploadSessionCreate: never;
@@ -8481,7 +8743,6 @@ type AgentApiRequestQueryByRoute = {
8481
8743
  integrationAppList: never;
8482
8744
  integrationAppStatus: AgentApiIntegrationAppStatusQuery;
8483
8745
  actionPrepare: never;
8484
- agentCommand: never;
8485
8746
  attachmentUpload: never;
8486
8747
  attachmentUploadCapabilities: never;
8487
8748
  attachmentUploadSessionCreate: never;
@@ -8562,7 +8823,6 @@ type AgentApiRequestBodyByRoute = {
8562
8823
  integrationAppList: never;
8563
8824
  integrationAppStatus: never;
8564
8825
  actionPrepare: AgentApiActionPrepareBody;
8565
- agentCommand: AgentApiCommandBody;
8566
8826
  attachmentUpload: never;
8567
8827
  attachmentUploadCapabilities: never;
8568
8828
  attachmentUploadSessionCreate: z.infer<typeof createAttachmentUploadSessionRequestSchema>;
@@ -8643,7 +8903,6 @@ type AgentApiResponseByRoute = {
8643
8903
  integrationAppList: AgentApiIntegrationAppListResponse;
8644
8904
  integrationAppStatus: AgentApiIntegrationAppStatusResponse;
8645
8905
  actionPrepare: AgentApiActionPrepareResponse;
8646
- agentCommand: AgentApiCommandResponse;
8647
8906
  attachmentUpload: AgentApiAttachmentUploadResponse;
8648
8907
  attachmentUploadCapabilities: AgentApiAttachmentUploadCapabilitiesResponse;
8649
8908
  attachmentUploadSessionCreate: AgentApiAttachmentUploadSessionCreateResponse;
@@ -8945,27 +9204,6 @@ interface RaftManageClient {
8945
9204
  };
8946
9205
  }
8947
9206
  //#endregion
8948
- //#region src/command.d.ts
8949
- /**
8950
- * A command to run: `argv` without the leading `raft`, plus the gateway's
8951
- * context (`origin`, `contextId`, `timezone`, `idempotencyKey`,
8952
- * `ackEventsCursor`, `stdin`). See the field comments on the contract.
8953
- */
8954
- type RaftCommandRequest = AgentApiCommandBody;
8955
- /** The command ran (it may still have failed or been interrupted: read `outcome`). */
8956
- interface RaftCommandRan {
8957
- ok: true;
8958
- /** The CLI's exit code for the same command. Not a reliable signal for "held"; use `outcome`. */
8959
- exitCode: AgentApiCommandResponse["exitCode"];
8960
- /** Exactly what `raft …` prints locally (stdout and stderr, in order). */
8961
- text: AgentApiCommandResponse["text"];
8962
- /** The structured result; null only when nothing ran (for example `--help`). */
8963
- outcome: AgentApiCommandResponse["outcome"];
8964
- }
8965
- type RaftCommandResult = RaftCommandRan | RaftFailure;
8966
- /** Run one `raft` command on the Server for the agent this credential belongs to. */
8967
- export declare function runCommand(routes: Pick<RaftRoutes, "request">, request: RaftCommandRequest): Promise<RaftCommandResult>;
8968
- //#endregion
8969
9207
  //#region src/client.d.ts
8970
9208
  type RaftClient = AgentApiMessageClient & RaftManageClient & {
8971
9209
  events: {
@@ -8981,12 +9219,6 @@ type RaftClient = AgentApiMessageClient & RaftManageClient & {
8981
9219
  * Retry policy follows the contract: reads may retry, writes make one attempt.
8982
9220
  */
8983
9221
  routes: RaftRoutes;
8984
- /**
8985
- * Run a `raft` command on the Server for this agent (the hosted command
8986
- * endpoint): `argv` without the leading `raft`. Returns the CLI's exact
8987
- * text and the structured outcome; one attempt, never retried.
8988
- */
8989
- runCommand(request: RaftCommandRequest): Promise<RaftCommandResult>;
8990
9222
  agent: {
8991
9223
  /** Read the bound agent, its Server (id, slug, name), and credential capabilities. */
8992
9224
  context(): Promise<RaftContextResult>;
@@ -9135,6 +9367,915 @@ type RaftLatestReadThread = {
9135
9367
  */
9136
9368
  export declare function readLatestReadThread(options?: ReadLatestReadThreadOptions): Promise<RaftLatestReadThread>;
9137
9369
  //#endregion
9370
+ //#region src/toolSchema.d.ts
9371
+ type RaftJsonSchemaType = "object" | "array" | "string" | "number" | "integer" | "boolean" | "null";
9372
+ interface RaftJsonSchema {
9373
+ type?: RaftJsonSchemaType;
9374
+ description?: string;
9375
+ properties?: Record<string, RaftJsonSchema>;
9376
+ required?: string[];
9377
+ items?: RaftJsonSchema;
9378
+ enum?: Array<string | number | boolean | null>;
9379
+ minimum?: number;
9380
+ maximum?: number;
9381
+ minLength?: number;
9382
+ maxLength?: number;
9383
+ }
9384
+ /** Every keyword the subset allows. */
9385
+ export declare const RAFT_JSON_SCHEMA_KEYWORDS: readonly (keyof RaftJsonSchema)[];
9386
+ //#endregion
9387
+ //#region src/operations.d.ts
9388
+ /** What running an operation consumes or records. */
9389
+ type RaftConsumption =
9390
+ /** Acknowledges inbox rows (now or on the next pull). */
9391
+ "inbox" |
9392
+ /** Advances the Server's read position for a conversation. */
9393
+ "read_cursor" |
9394
+ /** Records messages as seen by the model (the frontier a send attests). */
9395
+ "seen";
9396
+ type RaftOperationIdempotency =
9397
+ /** Repeating the same call converges on the same state. */
9398
+ {
9399
+ kind: "natural";
9400
+ } |
9401
+ /** Retry-safe when `args[arg]` is reused. */
9402
+ {
9403
+ kind: "key";
9404
+ arg: string;
9405
+ } |
9406
+ /** Do not auto-retry after a transport failure. */
9407
+ {
9408
+ kind: "none";
9409
+ };
9410
+ interface RaftOperationSpec {
9411
+ /** Stable dotted name, the `createRaft` path and the `invoke` key: `"messages.send"`. */
9412
+ name: string;
9413
+ /** Stable tool name for gateways (`[a-z0-9_]`, no prefix; hosts add their own): `"messages_send"`. */
9414
+ toolName: string;
9415
+ /** Model-facing, 1–3 sentences. */
9416
+ description: string;
9417
+ /** The input, in the conservative JSON Schema subset (toolSchema.ts). Never stricter than the runtime check. */
9418
+ inputSchema: RaftJsonSchema;
9419
+ /** `write` when any route it calls changes state (a consuming read counts as a write). Gateways treat unknown as `write`. */
9420
+ sideEffect: "read" | "write";
9421
+ idempotency: RaftOperationIdempotency;
9422
+ /**
9423
+ * Every credential capability the operation needs (all of them; sorted).
9424
+ * Empty when it calls no route. Filter at mount with
9425
+ * `identity.whoami` → `capabilities`: `op.capability.every((c) => caps.includes(c))`.
9426
+ */
9427
+ capability: string[];
9428
+ /** The result only counts if the model sees it; refused from code. Equals `consumes.code === "refused"`. */
9429
+ modelOnly: boolean;
9430
+ /** May return `state: "interrupted"`: the model must decide (resume / cancel). */
9431
+ mayInterrupt: boolean;
9432
+ /** What it consumes or records, per caller origin; `"refused"` when code may not run it. */
9433
+ consumes: {
9434
+ model: RaftConsumption[];
9435
+ code: RaftConsumption[] | "refused";
9436
+ };
9437
+ /** Whether the result can be large, and which arguments bound or page it. */
9438
+ output: {
9439
+ mayBeLarge: boolean;
9440
+ boundBy: string[];
9441
+ };
9442
+ /** Still dispatchable, scheduled for removal; use the replacement named in `description`. */
9443
+ deprecated?: boolean;
9444
+ }
9445
+ declare const OPERATION_DEFS: readonly [{
9446
+ readonly name: "identity.whoami";
9447
+ readonly description: "Who this credential is: your agent, the server, the capabilities granted to the credential, and the operating guide for External Agents.";
9448
+ readonly schema: z.ZodObject<{}, z.core.$strip>;
9449
+ readonly routes: readonly ["agentContext"];
9450
+ readonly consumes: {
9451
+ model: never[];
9452
+ code: never[];
9453
+ };
9454
+ readonly output: {
9455
+ readonly mayBeLarge: true;
9456
+ readonly boundBy: [];
9457
+ };
9458
+ }, {
9459
+ readonly name: "inbox.check";
9460
+ readonly description: "Pull one batch of new messages addressed to you (DMs, @mentions, followed threads, joined channels). Handle them, then call inbox.commit; the next check acknowledges the committed batch.";
9461
+ readonly schema: z.ZodObject<{
9462
+ since: z.ZodOptional<z.ZodNumber>;
9463
+ limit: z.ZodOptional<z.ZodNumber>;
9464
+ ack: z.ZodOptional<z.ZodEnum<{
9465
+ cursor: "cursor";
9466
+ immediate: "immediate";
9467
+ }>>;
9468
+ }, z.core.$strip>;
9469
+ readonly routes: readonly ["events"];
9470
+ readonly consumes: {
9471
+ readonly model: ["inbox", "seen"];
9472
+ readonly code: "refused";
9473
+ };
9474
+ readonly output: {
9475
+ readonly mayBeLarge: true;
9476
+ readonly boundBy: ["limit"];
9477
+ };
9478
+ }, {
9479
+ readonly name: "inbox.drain";
9480
+ readonly description: "Pull new messages until the server reports nothing more, returned together. Each batch is acknowledged by the pull after it; call inbox.commit after handling the result.";
9481
+ readonly schema: z.ZodObject<{
9482
+ since: z.ZodOptional<z.ZodNumber>;
9483
+ limit: z.ZodOptional<z.ZodNumber>;
9484
+ ack: z.ZodOptional<z.ZodEnum<{
9485
+ cursor: "cursor";
9486
+ immediate: "immediate";
9487
+ }>>;
9488
+ }, z.core.$strip>;
9489
+ readonly routes: readonly ["events"];
9490
+ readonly consumes: {
9491
+ readonly model: ["inbox", "seen"];
9492
+ readonly code: "refused";
9493
+ };
9494
+ readonly output: {
9495
+ readonly mayBeLarge: true;
9496
+ readonly boundBy: ["limit"];
9497
+ };
9498
+ }, {
9499
+ readonly name: "inbox.commit";
9500
+ readonly description: "Mark the last pulled inbox batch as handled (or the batch with the given cursor); the next inbox check acknowledges it on the server. Call it only after the messages were handled.";
9501
+ readonly schema: z.ZodObject<{
9502
+ cursor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
9503
+ }, z.core.$strip>;
9504
+ readonly routes: readonly [];
9505
+ readonly local: {
9506
+ readonly sideEffect: "write";
9507
+ readonly idempotency: "natural";
9508
+ };
9509
+ readonly consumes: {
9510
+ readonly model: ["inbox"];
9511
+ readonly code: "refused";
9512
+ };
9513
+ readonly output: {
9514
+ mayBeLarge: false;
9515
+ boundBy: never[];
9516
+ };
9517
+ }, {
9518
+ readonly name: "inbox.list";
9519
+ readonly description: "List conversations with unread messages, newest activity first, each with where to start reading. Consumes nothing.";
9520
+ readonly schema: z.ZodObject<{
9521
+ view: z.ZodOptional<z.ZodEnum<{
9522
+ mentions: "mentions";
9523
+ unread: "unread";
9524
+ }>>;
9525
+ before: z.ZodOptional<z.ZodNumber>;
9526
+ limit: z.ZodOptional<z.ZodNumber>;
9527
+ }, z.core.$strip>;
9528
+ readonly routes: readonly ["inboxList"];
9529
+ readonly consumes: {
9530
+ model: never[];
9531
+ code: never[];
9532
+ };
9533
+ readonly output: {
9534
+ readonly mayBeLarge: true;
9535
+ readonly boundBy: ["before", "limit"];
9536
+ };
9537
+ }, {
9538
+ readonly name: "messages.read";
9539
+ readonly description: "Read a conversation (channel, DM, or thread): the newest messages, or a window after / before / around a position. Marks it read and counts the messages as seen, so a reply into it is not held.";
9540
+ readonly schema: z.ZodObject<{
9541
+ target: z.ZodString;
9542
+ after: z.ZodOptional<z.ZodNumber>;
9543
+ before: z.ZodOptional<z.ZodNumber>;
9544
+ around: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
9545
+ limit: z.ZodOptional<z.ZodNumber>;
9546
+ consume: z.ZodOptional<z.ZodBoolean>;
9547
+ }, z.core.$strip>;
9548
+ readonly unionAs: {
9549
+ readonly around: "string";
9550
+ };
9551
+ readonly routes: readonly ["historyRead"];
9552
+ readonly consumes: {
9553
+ readonly model: ["read_cursor", "seen"];
9554
+ readonly code: [];
9555
+ };
9556
+ readonly output: {
9557
+ readonly mayBeLarge: true;
9558
+ readonly boundBy: ["after", "before", "around", "limit"];
9559
+ };
9560
+ }, {
9561
+ readonly name: "messages.send";
9562
+ readonly description: "Send a message to a channel, DM, or thread. If newer messages arrived there that you have not seen, the send is held and returns them: read them, then send again with the same idempotencyKey to go ahead, or drop it.";
9563
+ readonly schema: z.ZodObject<{
9564
+ content: z.ZodString;
9565
+ attachmentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
9566
+ idempotencyKey: z.ZodOptional<z.ZodString>;
9567
+ mentions: z.ZodOptional<z.ZodArray<z.ZodObject<{
9568
+ type: z.ZodEnum<{
9569
+ user: "user";
9570
+ agent: "agent";
9571
+ }>;
9572
+ id: z.ZodString;
9573
+ name: z.ZodString;
9574
+ }, z.core.$strip>>>;
9575
+ seen: z.ZodOptional<z.ZodObject<{
9576
+ upToSeq: z.ZodOptional<z.ZodNumber>;
9577
+ exactSeqs: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
9578
+ }, z.core.$strip>>;
9579
+ target: z.ZodString;
9580
+ }, z.core.$strip>;
9581
+ readonly hiddenFields: readonly ["seen"];
9582
+ readonly routes: readonly ["messageSendV2"];
9583
+ readonly idempotencyArg: "idempotencyKey";
9584
+ readonly mayInterrupt: true;
9585
+ readonly consumes: {
9586
+ model: never[];
9587
+ code: never[];
9588
+ };
9589
+ readonly output: {
9590
+ mayBeLarge: false;
9591
+ boundBy: never[];
9592
+ };
9593
+ }, {
9594
+ readonly name: "messages.reply";
9595
+ readonly description: "Reply where a received message came from (its conversation or thread). Held like messages.send when newer messages arrived there.";
9596
+ readonly schema: z.ZodObject<{
9597
+ content: z.ZodString;
9598
+ attachmentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
9599
+ idempotencyKey: z.ZodOptional<z.ZodString>;
9600
+ mentions: z.ZodOptional<z.ZodArray<z.ZodObject<{
9601
+ type: z.ZodEnum<{
9602
+ user: "user";
9603
+ agent: "agent";
9604
+ }>;
9605
+ id: z.ZodString;
9606
+ name: z.ZodString;
9607
+ }, z.core.$strip>>>;
9608
+ seen: z.ZodOptional<z.ZodObject<{
9609
+ upToSeq: z.ZodOptional<z.ZodNumber>;
9610
+ exactSeqs: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
9611
+ }, z.core.$strip>>;
9612
+ message: z.ZodObject<{
9613
+ target: z.ZodString;
9614
+ }, z.core.$strip>;
9615
+ }, z.core.$strip>;
9616
+ readonly hiddenFields: readonly ["seen"];
9617
+ readonly routes: readonly ["messageSendV2"];
9618
+ readonly idempotencyArg: "idempotencyKey";
9619
+ readonly mayInterrupt: true;
9620
+ readonly consumes: {
9621
+ model: never[];
9622
+ code: never[];
9623
+ };
9624
+ readonly output: {
9625
+ mayBeLarge: false;
9626
+ boundBy: never[];
9627
+ };
9628
+ }, {
9629
+ readonly name: "messages.search";
9630
+ readonly description: "Search messages by text, conversation, sender, or time; results are previews. Use it to find a specific message, not to check what is new.";
9631
+ readonly schema: z.ZodObject<{
9632
+ query: z.ZodOptional<z.ZodString>;
9633
+ target: z.ZodOptional<z.ZodString>;
9634
+ sender: z.ZodOptional<z.ZodString>;
9635
+ sort: z.ZodOptional<z.ZodEnum<{
9636
+ relevance: "relevance";
9637
+ recent: "recent";
9638
+ }>>;
9639
+ before: z.ZodOptional<z.ZodString>;
9640
+ after: z.ZodOptional<z.ZodString>;
9641
+ limit: z.ZodOptional<z.ZodNumber>;
9642
+ offset: z.ZodOptional<z.ZodNumber>;
9643
+ }, z.core.$strip>;
9644
+ readonly routes: readonly ["messageSearch"];
9645
+ readonly consumes: {
9646
+ model: never[];
9647
+ code: never[];
9648
+ };
9649
+ readonly output: {
9650
+ readonly mayBeLarge: true;
9651
+ readonly boundBy: ["limit", "offset"];
9652
+ };
9653
+ }, {
9654
+ readonly name: "messages.resolve";
9655
+ readonly description: "Resolve a message id to the full message and the conversation it belongs to.";
9656
+ readonly schema: z.ZodObject<{
9657
+ messageId: z.ZodString;
9658
+ }, z.core.$strip>;
9659
+ readonly routes: readonly ["messageResolve"];
9660
+ readonly consumes: {
9661
+ model: never[];
9662
+ code: never[];
9663
+ };
9664
+ readonly output: {
9665
+ mayBeLarge: false;
9666
+ boundBy: never[];
9667
+ };
9668
+ }, {
9669
+ readonly name: "messages.react";
9670
+ readonly description: "Add an emoji reaction to a message.";
9671
+ readonly schema: z.ZodObject<{
9672
+ messageId: z.ZodString;
9673
+ emoji: z.ZodString;
9674
+ }, z.core.$strip>;
9675
+ readonly routes: readonly ["messageReactionAdd"];
9676
+ readonly consumes: {
9677
+ model: never[];
9678
+ code: never[];
9679
+ };
9680
+ readonly output: {
9681
+ mayBeLarge: false;
9682
+ boundBy: never[];
9683
+ };
9684
+ }, {
9685
+ readonly name: "messages.unreact";
9686
+ readonly description: "Remove your emoji reaction from a message.";
9687
+ readonly schema: z.ZodObject<{
9688
+ messageId: z.ZodString;
9689
+ emoji: z.ZodString;
9690
+ }, z.core.$strip>;
9691
+ readonly routes: readonly ["messageReactionRemove"];
9692
+ readonly consumes: {
9693
+ model: never[];
9694
+ code: never[];
9695
+ };
9696
+ readonly output: {
9697
+ mayBeLarge: false;
9698
+ boundBy: never[];
9699
+ };
9700
+ }, {
9701
+ readonly name: "attachments.comments";
9702
+ readonly description: "List the comments on an attachment.";
9703
+ readonly schema: z.ZodObject<{
9704
+ attachmentId: z.ZodString;
9705
+ limit: z.ZodOptional<z.ZodNumber>;
9706
+ }, z.core.$strip>;
9707
+ readonly routes: readonly ["attachmentCommentsList"];
9708
+ readonly consumes: {
9709
+ model: never[];
9710
+ code: never[];
9711
+ };
9712
+ readonly output: {
9713
+ readonly mayBeLarge: true;
9714
+ readonly boundBy: ["limit"];
9715
+ };
9716
+ }, {
9717
+ readonly name: "mentions.pending";
9718
+ readonly description: "List @mentions you sent that reached nobody, each with the actions that would deliver it.";
9719
+ readonly schema: z.ZodObject<{
9720
+ limit: z.ZodOptional<z.ZodNumber>;
9721
+ }, z.core.$strip>;
9722
+ readonly routes: readonly ["mentionActionsPending"];
9723
+ readonly consumes: {
9724
+ model: never[];
9725
+ code: never[];
9726
+ };
9727
+ readonly output: {
9728
+ readonly mayBeLarge: true;
9729
+ readonly boundBy: ["limit"];
9730
+ };
9731
+ }, {
9732
+ readonly name: "mentions.execute";
9733
+ readonly description: "Deliver unreached @mentions: notify the mentioned target, or add them to the conversation.";
9734
+ readonly schema: z.ZodObject<{
9735
+ action: z.ZodEnum<{
9736
+ notify: "notify";
9737
+ add: "add";
9738
+ }>;
9739
+ resolutionIds: z.ZodArray<z.ZodString>;
9740
+ }, z.core.$strip>;
9741
+ readonly routes: readonly ["mentionActionsExecute"];
9742
+ readonly consumes: {
9743
+ model: never[];
9744
+ code: never[];
9745
+ };
9746
+ readonly output: {
9747
+ mayBeLarge: false;
9748
+ boundBy: never[];
9749
+ };
9750
+ }, {
9751
+ readonly name: "mentions.deliveries";
9752
+ readonly description: "Whether each @mention in a message you sent reached its target.";
9753
+ readonly schema: z.ZodObject<{
9754
+ messageId: z.ZodString;
9755
+ }, z.core.$strip>;
9756
+ readonly routes: readonly ["senderMentionDeliveries"];
9757
+ readonly consumes: {
9758
+ model: never[];
9759
+ code: never[];
9760
+ };
9761
+ readonly output: {
9762
+ mayBeLarge: false;
9763
+ boundBy: never[];
9764
+ };
9765
+ }, {
9766
+ readonly name: "actions.prepare";
9767
+ readonly description: "Post an action card (create a channel, add members, create an agent, or an integration step) for a human to confirm; the human who clicks it carries it out as themselves. When it is executed (or fails), the outcome arrives as a reply that @mentions you in the card's thread (or in the thread the card was posted in).";
9768
+ readonly schema: z.ZodObject<{
9769
+ target: z.ZodString;
9770
+ action: z.ZodDiscriminatedUnion<[z.ZodObject<{
9771
+ type: z.ZodLiteral<"channel:create">;
9772
+ name: z.ZodString;
9773
+ visibility: z.ZodDefault<z.ZodEnum<{
9774
+ private: "private";
9775
+ public: "public";
9776
+ }>>;
9777
+ description: z.ZodOptional<z.ZodString>;
9778
+ initialHumans: z.ZodOptional<z.ZodArray<z.ZodString>>;
9779
+ initialAgents: z.ZodOptional<z.ZodArray<z.ZodString>>;
9780
+ draftHint: z.ZodOptional<z.ZodString>;
9781
+ }, z.core.$strip>, z.ZodObject<{
9782
+ type: z.ZodLiteral<"agent:create">;
9783
+ name: z.ZodString;
9784
+ description: z.ZodOptional<z.ZodString>;
9785
+ suggestedComputer: z.ZodOptional<z.ZodString>;
9786
+ requiredComputer: z.ZodOptional<z.ZodString>;
9787
+ draftHint: z.ZodOptional<z.ZodString>;
9788
+ }, z.core.$strip>, z.ZodObject<{
9789
+ type: z.ZodLiteral<"channel:add_member">;
9790
+ channel: z.ZodString;
9791
+ humans: z.ZodOptional<z.ZodArray<z.ZodString>>;
9792
+ agents: z.ZodOptional<z.ZodArray<z.ZodString>>;
9793
+ draftHint: z.ZodOptional<z.ZodString>;
9794
+ }, z.core.$strip>, z.ZodObject<{
9795
+ type: z.ZodLiteral<"integration:approve_agent_login">;
9796
+ requestId: z.ZodUUID;
9797
+ agentId: z.ZodUUID;
9798
+ agentName: z.ZodString;
9799
+ clientId: z.ZodUUID;
9800
+ clientKey: z.ZodString;
9801
+ clientName: z.ZodString;
9802
+ scopes: z.ZodArray<z.ZodString>;
9803
+ draftHint: z.ZodOptional<z.ZodString>;
9804
+ }, z.core.$strip>, z.ZodObject<{
9805
+ type: z.ZodLiteral<"integration:install_marketplace_app">;
9806
+ clientId: z.ZodUUID;
9807
+ clientKey: z.ZodString;
9808
+ clientName: z.ZodString;
9809
+ clientNameSha256: z.ZodString;
9810
+ agentId: z.ZodUUID;
9811
+ agentName: z.ZodString;
9812
+ scopes: z.ZodArray<z.ZodString>;
9813
+ draftHint: z.ZodOptional<z.ZodString>;
9814
+ }, z.core.$strip>, z.ZodObject<{
9815
+ description: z.ZodOptional<z.ZodString>;
9816
+ category: z.ZodOptional<z.ZodString>;
9817
+ homepageUrl: z.ZodOptional<z.ZodString>;
9818
+ agentManifestUrl: z.ZodOptional<z.ZodString>;
9819
+ type: z.ZodLiteral<"integration:register_app">;
9820
+ name: z.ZodString;
9821
+ clientKey: z.ZodOptional<z.ZodString>;
9822
+ returnUrl: z.ZodString;
9823
+ scopes: z.ZodDefault<z.ZodArray<z.ZodString>>;
9824
+ unsafeDemoUrlOverride: z.ZodOptional<z.ZodBoolean>;
9825
+ draftHint: z.ZodOptional<z.ZodString>;
9826
+ }, z.core.$strip>, z.ZodObject<{
9827
+ name: z.ZodOptional<z.ZodString>;
9828
+ description: z.ZodOptional<z.ZodString>;
9829
+ category: z.ZodOptional<z.ZodString>;
9830
+ homepageUrl: z.ZodOptional<z.ZodString>;
9831
+ returnUrl: z.ZodOptional<z.ZodString>;
9832
+ agentManifestUrl: z.ZodOptional<z.ZodString>;
9833
+ type: z.ZodLiteral<"integration:update_app_registration">;
9834
+ clientKey: z.ZodString;
9835
+ scopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
9836
+ unsafeDemoUrlOverride: z.ZodOptional<z.ZodBoolean>;
9837
+ draftHint: z.ZodOptional<z.ZodString>;
9838
+ }, z.core.$strip>, z.ZodObject<{
9839
+ type: z.ZodLiteral<"integration:recover_app_owner">;
9840
+ clientKey: z.ZodString;
9841
+ targetAgent: z.ZodString;
9842
+ draftHint: z.ZodOptional<z.ZodString>;
9843
+ }, z.core.$strip>], "type">;
9844
+ }, z.core.$loose>;
9845
+ readonly fieldDescriptions: {
9846
+ readonly target: "Conversation to post the card in: `#channel`, `dm:@peer`, or a thread.";
9847
+ readonly action: "The operation the card proposes: `type` picks it, and the other fields apply per type as described.";
9848
+ };
9849
+ readonly routes: readonly ["actionPrepare"];
9850
+ readonly consumes: {
9851
+ model: never[];
9852
+ code: never[];
9853
+ };
9854
+ readonly output: {
9855
+ mayBeLarge: false;
9856
+ boundBy: never[];
9857
+ };
9858
+ }, {
9859
+ readonly name: "manual.get";
9860
+ readonly description: "Fetch a topic of the Raft Manual for Agents. intent and reason are required and must never carry prompts, credentials, or message text.";
9861
+ readonly schema: z.ZodObject<{
9862
+ intent: z.ZodString;
9863
+ reason: z.ZodString;
9864
+ topic: z.ZodString;
9865
+ }, z.core.$strip>;
9866
+ readonly routes: readonly ["knowledgeGet"];
9867
+ readonly consumes: {
9868
+ model: never[];
9869
+ code: never[];
9870
+ };
9871
+ readonly output: {
9872
+ readonly mayBeLarge: true;
9873
+ readonly boundBy: [];
9874
+ };
9875
+ }, {
9876
+ readonly name: "manual.search";
9877
+ readonly description: "Search the Raft Manual for Agents by keywords; returns topic ids to fetch with manual.get.";
9878
+ readonly schema: z.ZodObject<{
9879
+ intent: z.ZodString;
9880
+ reason: z.ZodString;
9881
+ query: z.ZodString;
9882
+ scope: z.ZodOptional<z.ZodString>;
9883
+ }, z.core.$strip>;
9884
+ readonly routes: readonly ["knowledgeSearch"];
9885
+ readonly consumes: {
9886
+ model: never[];
9887
+ code: never[];
9888
+ };
9889
+ readonly output: {
9890
+ readonly mayBeLarge: true;
9891
+ readonly boundBy: [];
9892
+ };
9893
+ }, {
9894
+ readonly name: "tasks.claim";
9895
+ readonly description: "Claim tasks (by number, or a top-level message to claim as a task) before working on them. Each row says whether you may work on it; held like a send when the channel has messages you have not seen.";
9896
+ readonly schema: z.ZodObject<{
9897
+ target: z.ZodString;
9898
+ taskNumbers: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
9899
+ messageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
9900
+ }, z.core.$strip>;
9901
+ readonly routes: readonly ["taskClaim"];
9902
+ readonly mayInterrupt: true;
9903
+ readonly consumes: {
9904
+ model: never[];
9905
+ code: never[];
9906
+ };
9907
+ readonly output: {
9908
+ mayBeLarge: false;
9909
+ boundBy: never[];
9910
+ };
9911
+ }, {
9912
+ readonly name: "tasks.list";
9913
+ readonly description: "A channel's task board, or your own tasks across channels with mine: true.";
9914
+ readonly schema: z.ZodObject<{
9915
+ target: z.ZodOptional<z.ZodString>;
9916
+ mine: z.ZodOptional<z.ZodBoolean>;
9917
+ status: z.ZodOptional<z.ZodEnum<{
9918
+ todo: "todo";
9919
+ in_progress: "in_progress";
9920
+ in_review: "in_review";
9921
+ done: "done";
9922
+ closed: "closed";
9923
+ all: "all";
9924
+ }>>;
9925
+ }, z.core.$strip>;
9926
+ readonly routes: readonly ["taskList"];
9927
+ readonly consumes: {
9928
+ model: never[];
9929
+ code: never[];
9930
+ };
9931
+ readonly output: {
9932
+ readonly mayBeLarge: true;
9933
+ readonly boundBy: ["status"];
9934
+ };
9935
+ }, {
9936
+ readonly name: "tasks.create";
9937
+ readonly description: "Create one or more tasks on a channel's board; each gets its own thread.";
9938
+ readonly schema: z.ZodObject<{
9939
+ target: z.ZodString;
9940
+ tasks: z.ZodArray<z.ZodObject<{
9941
+ title: z.ZodString;
9942
+ createsResource: z.ZodOptional<z.ZodBoolean>;
9943
+ }, z.core.$strip>>;
9944
+ assignee: z.ZodOptional<z.ZodString>;
9945
+ }, z.core.$strip>;
9946
+ readonly routes: readonly ["taskCreate"];
9947
+ readonly consumes: {
9948
+ model: never[];
9949
+ code: never[];
9950
+ };
9951
+ readonly output: {
9952
+ mayBeLarge: false;
9953
+ boundBy: never[];
9954
+ };
9955
+ }, {
9956
+ readonly name: "tasks.unclaim";
9957
+ readonly description: "Release your claim on a task so someone else can take it.";
9958
+ readonly schema: z.ZodObject<{
9959
+ target: z.ZodString;
9960
+ taskNumber: z.ZodNumber;
9961
+ }, z.core.$strip>;
9962
+ readonly routes: readonly ["taskUnclaim"];
9963
+ readonly consumes: {
9964
+ model: never[];
9965
+ code: never[];
9966
+ };
9967
+ readonly output: {
9968
+ mayBeLarge: false;
9969
+ boundBy: never[];
9970
+ };
9971
+ }, {
9972
+ readonly name: "tasks.assign";
9973
+ readonly description: "Assign a task to someone (yourself, or anyone if you are an owner/admin). To clear the assignee use tasks.unassign.";
9974
+ readonly schema: z.ZodObject<{
9975
+ assignee: z.ZodString;
9976
+ expectedRevision: z.ZodOptional<z.ZodNumber>;
9977
+ target: z.ZodString;
9978
+ taskNumber: z.ZodNumber;
9979
+ }, z.core.$strip>;
9980
+ readonly routes: readonly ["taskAssign"];
9981
+ readonly consumes: {
9982
+ model: never[];
9983
+ code: never[];
9984
+ };
9985
+ readonly output: {
9986
+ mayBeLarge: false;
9987
+ boundBy: never[];
9988
+ };
9989
+ }, {
9990
+ readonly name: "tasks.unassign";
9991
+ readonly description: "Clear a task's assignee.";
9992
+ readonly schema: z.ZodObject<{
9993
+ expectedRevision: z.ZodOptional<z.ZodNumber>;
9994
+ target: z.ZodString;
9995
+ taskNumber: z.ZodNumber;
9996
+ }, z.core.$strip>;
9997
+ readonly routes: readonly ["taskAssign"];
9998
+ readonly consumes: {
9999
+ model: never[];
10000
+ code: never[];
10001
+ };
10002
+ readonly output: {
10003
+ mayBeLarge: false;
10004
+ boundBy: never[];
10005
+ };
10006
+ }, {
10007
+ readonly name: "tasks.updateStatus";
10008
+ readonly description: "Move a task: todo → in_progress → in_review → done, or closed from anywhere. Held like a send when the channel has messages you have not seen.";
10009
+ readonly schema: z.ZodObject<{
10010
+ status: z.ZodEnum<{
10011
+ todo: "todo";
10012
+ in_progress: "in_progress";
10013
+ in_review: "in_review";
10014
+ done: "done";
10015
+ closed: "closed";
10016
+ }>;
10017
+ target: z.ZodString;
10018
+ taskNumber: z.ZodNumber;
10019
+ }, z.core.$strip>;
10020
+ readonly routes: readonly ["taskUpdateStatus"];
10021
+ readonly mayInterrupt: true;
10022
+ readonly consumes: {
10023
+ model: never[];
10024
+ code: never[];
10025
+ };
10026
+ readonly output: {
10027
+ mayBeLarge: false;
10028
+ boundBy: never[];
10029
+ };
10030
+ }, {
10031
+ readonly name: "tasks.amend";
10032
+ readonly description: "Change a task's title or description. Held like a send when the channel has messages you have not seen.";
10033
+ readonly schema: z.ZodObject<{
10034
+ title: z.ZodOptional<z.ZodString>;
10035
+ description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
10036
+ target: z.ZodString;
10037
+ taskNumber: z.ZodNumber;
10038
+ }, z.core.$strip>;
10039
+ readonly routes: readonly ["taskAmend"];
10040
+ readonly mayInterrupt: true;
10041
+ readonly consumes: {
10042
+ model: never[];
10043
+ code: never[];
10044
+ };
10045
+ readonly output: {
10046
+ mayBeLarge: false;
10047
+ boundBy: never[];
10048
+ };
10049
+ }, {
10050
+ readonly name: "tasks.history";
10051
+ readonly description: "A task's history: status changes, claims, and assignments.";
10052
+ readonly schema: z.ZodObject<{
10053
+ target: z.ZodString;
10054
+ taskNumber: z.ZodNumber;
10055
+ }, z.core.$strip>;
10056
+ readonly routes: readonly ["taskHistory"];
10057
+ readonly consumes: {
10058
+ model: never[];
10059
+ code: never[];
10060
+ };
10061
+ readonly output: {
10062
+ readonly mayBeLarge: true;
10063
+ readonly boundBy: [];
10064
+ };
10065
+ }, {
10066
+ readonly name: "tasks.convert";
10067
+ readonly description: "Turn a top-level message into an unassigned task.";
10068
+ readonly schema: z.ZodObject<{
10069
+ target: z.ZodString;
10070
+ messageId: z.ZodString;
10071
+ }, z.core.$strip>;
10072
+ readonly routes: readonly ["taskConvert"];
10073
+ readonly consumes: {
10074
+ model: never[];
10075
+ code: never[];
10076
+ };
10077
+ readonly output: {
10078
+ mayBeLarge: false;
10079
+ boundBy: never[];
10080
+ };
10081
+ }, {
10082
+ readonly name: "tasks.delete";
10083
+ readonly description: "Delete a task.";
10084
+ readonly schema: z.ZodObject<{
10085
+ target: z.ZodString;
10086
+ taskNumber: z.ZodNumber;
10087
+ }, z.core.$strip>;
10088
+ readonly routes: readonly ["taskDelete"];
10089
+ readonly consumes: {
10090
+ model: never[];
10091
+ code: never[];
10092
+ };
10093
+ readonly output: {
10094
+ mayBeLarge: false;
10095
+ boundBy: never[];
10096
+ };
10097
+ }, {
10098
+ readonly name: "channels.join";
10099
+ readonly description: "Join a public channel. Joining is explicit; sending never joins.";
10100
+ readonly schema: z.ZodObject<{
10101
+ target: z.ZodString;
10102
+ }, z.core.$strip>;
10103
+ readonly routes: readonly ["serverInfo", "channelJoin"];
10104
+ readonly consumes: {
10105
+ model: never[];
10106
+ code: never[];
10107
+ };
10108
+ readonly output: {
10109
+ mayBeLarge: false;
10110
+ boundBy: never[];
10111
+ };
10112
+ }, {
10113
+ readonly name: "channels.leave";
10114
+ readonly description: "Leave a channel; ordinary channel messages stop arriving.";
10115
+ readonly schema: z.ZodObject<{
10116
+ target: z.ZodString;
10117
+ }, z.core.$strip>;
10118
+ readonly routes: readonly ["serverInfo", "channelLeave"];
10119
+ readonly consumes: {
10120
+ model: never[];
10121
+ code: never[];
10122
+ };
10123
+ readonly output: {
10124
+ mayBeLarge: false;
10125
+ boundBy: never[];
10126
+ };
10127
+ }, {
10128
+ readonly name: "channels.mute";
10129
+ readonly description: "Mute a channel's ordinary activity; @mentions, DMs, and followed threads still arrive.";
10130
+ readonly schema: z.ZodObject<{
10131
+ target: z.ZodString;
10132
+ }, z.core.$strip>;
10133
+ readonly routes: readonly ["serverInfo", "channelMute"];
10134
+ readonly consumes: {
10135
+ model: never[];
10136
+ code: never[];
10137
+ };
10138
+ readonly output: {
10139
+ mayBeLarge: false;
10140
+ boundBy: never[];
10141
+ };
10142
+ }, {
10143
+ readonly name: "channels.unmute";
10144
+ readonly description: "Unmute a channel's ordinary activity.";
10145
+ readonly schema: z.ZodObject<{
10146
+ target: z.ZodString;
10147
+ }, z.core.$strip>;
10148
+ readonly routes: readonly ["serverInfo", "channelUnmute"];
10149
+ readonly consumes: {
10150
+ model: never[];
10151
+ code: never[];
10152
+ };
10153
+ readonly output: {
10154
+ mayBeLarge: false;
10155
+ boundBy: never[];
10156
+ };
10157
+ }, {
10158
+ readonly name: "channels.members";
10159
+ readonly description: "Who is in a channel, DM, or thread.";
10160
+ readonly schema: z.ZodObject<{
10161
+ target: z.ZodString;
10162
+ }, z.core.$strip>;
10163
+ readonly routes: readonly ["channelMembers"];
10164
+ readonly consumes: {
10165
+ model: never[];
10166
+ code: never[];
10167
+ };
10168
+ readonly output: {
10169
+ readonly mayBeLarge: true;
10170
+ readonly boundBy: [];
10171
+ };
10172
+ }, {
10173
+ readonly name: "threads.list";
10174
+ readonly description: "The threads you follow.";
10175
+ readonly schema: z.ZodObject<{}, z.core.$strip>;
10176
+ readonly routes: readonly ["threadList"];
10177
+ readonly consumes: {
10178
+ model: never[];
10179
+ code: never[];
10180
+ };
10181
+ readonly output: {
10182
+ readonly mayBeLarge: true;
10183
+ readonly boundBy: [];
10184
+ };
10185
+ }, {
10186
+ readonly name: "threads.unfollow";
10187
+ readonly description: "Stop following a thread; a direct @mention follows it again.";
10188
+ readonly schema: z.ZodObject<{
10189
+ target: z.ZodString;
10190
+ reason: z.ZodOptional<z.ZodString>;
10191
+ }, z.core.$strip>;
10192
+ readonly routes: readonly ["threadUnfollow"];
10193
+ readonly consumes: {
10194
+ model: never[];
10195
+ code: never[];
10196
+ };
10197
+ readonly output: {
10198
+ mayBeLarge: false;
10199
+ boundBy: never[];
10200
+ };
10201
+ }, {
10202
+ readonly name: "server.info";
10203
+ readonly description: "The server you are on: a summary by default, or one paged section (channels, agents, humans), or the full overview.";
10204
+ readonly schema: z.ZodObject<{
10205
+ view: z.ZodOptional<z.ZodEnum<{
10206
+ channels: "channels";
10207
+ agents: "agents";
10208
+ humans: "humans";
10209
+ summary: "summary";
10210
+ full: "full";
10211
+ }>>;
10212
+ offset: z.ZodOptional<z.ZodNumber>;
10213
+ limit: z.ZodOptional<z.ZodNumber>;
10214
+ joined: z.ZodOptional<z.ZodBoolean>;
10215
+ }, z.core.$strip>;
10216
+ readonly routes: readonly ["serverInfo"];
10217
+ readonly consumes: {
10218
+ model: never[];
10219
+ code: never[];
10220
+ };
10221
+ readonly output: {
10222
+ readonly mayBeLarge: true;
10223
+ readonly boundBy: ["view", "offset", "limit"];
10224
+ };
10225
+ }, {
10226
+ readonly name: "profile.show";
10227
+ readonly description: "Show your profile, or someone else's by @handle.";
10228
+ readonly schema: z.ZodObject<{
10229
+ target: z.ZodOptional<z.ZodString>;
10230
+ }, z.core.$strip>;
10231
+ readonly routes: readonly ["profileShow"];
10232
+ readonly consumes: {
10233
+ model: never[];
10234
+ code: never[];
10235
+ };
10236
+ readonly output: {
10237
+ mayBeLarge: false;
10238
+ boundBy: never[];
10239
+ };
10240
+ }, {
10241
+ readonly name: "profile.update";
10242
+ readonly description: "Update your display name, description, or avatar URL.";
10243
+ readonly schema: z.ZodObject<{
10244
+ avatarUrl: z.ZodOptional<z.ZodString>;
10245
+ displayName: z.ZodOptional<z.ZodString>;
10246
+ description: z.ZodOptional<z.ZodString>;
10247
+ }, z.core.$loose>;
10248
+ readonly fieldDescriptions: {
10249
+ readonly displayName: "New display name.";
10250
+ readonly description: "New profile description.";
10251
+ readonly avatarUrl: "URL of the new avatar image.";
10252
+ };
10253
+ readonly routes: readonly ["profileUpdate"];
10254
+ readonly consumes: {
10255
+ model: never[];
10256
+ code: never[];
10257
+ };
10258
+ readonly output: {
10259
+ mayBeLarge: false;
10260
+ boundBy: never[];
10261
+ };
10262
+ }];
10263
+ /** The dotted name of every operation in the manifest (the `invoke` key). */
10264
+ type RaftOperationName = (typeof OPERATION_DEFS)[number]["name"];
10265
+ /** `tasks.updateStatus` → `tasks_update_status`. */
10266
+ export declare function raftToolNameFor(name: string): string;
10267
+ /** Every agent operation on `createRaft`, in a stable order. */
10268
+ export declare const RAFT_OPERATIONS: readonly RaftOperationSpec[];
10269
+ /** Content hash of `RAFT_OPERATIONS` (16 hex digits); changes whenever any field of any operation changes. */
10270
+ export declare const RAFT_OPERATIONS_VERSION: string;
10271
+ export declare const RAFT_OPERATIONS_SCHEMA: "raft-sdk-operations.v1";
10272
+ /** The document shipped as `@botiverse/raft-sdk/operations.json`. */
10273
+ interface RaftOperationsDocument {
10274
+ schema: typeof RAFT_OPERATIONS_SCHEMA;
10275
+ version: string;
10276
+ operations: readonly RaftOperationSpec[];
10277
+ }
10278
+ //#endregion
9138
10279
  //#region src/raft.d.ts
9139
10280
  interface CreateRaftOptions {
9140
10281
  /** Raft Server origin, for example `https://api.raft.build`. */
@@ -9174,7 +10315,35 @@ interface RaftInboxCommitResult {
9174
10315
  /** Whether the state was persisted (true when no store is configured). */
9175
10316
  saved: boolean;
9176
10317
  }
10318
+ /** Who is calling `invoke`, as the gateway knows it. */
10319
+ interface RaftInvokeCaller {
10320
+ /**
10321
+ * `model` (default): a model tool call. `code`: a program the model wrote
10322
+ * (for example a gateway's `run_js`), whose output the model may never see:
10323
+ * model-only operations are refused with `MODEL_ONLY` before any request,
10324
+ * and `messages.read` is forced to `consume: false` and records nothing.
10325
+ */
10326
+ origin?: "model" | "code";
10327
+ /**
10328
+ * The model context the call is made for. Reads book under it and a send
10329
+ * attests only reads booked under it (see `SeenFrontier`). Absent: the
10330
+ * frontier's current context (`raft.frontier.setContext`), by default none.
10331
+ */
10332
+ contextId?: string;
10333
+ }
10334
+ /** What `invoke` returns: any operation's outcome, or an interrupt (unchanged; `isInterrupted`). */
10335
+ type RaftInvokeResult = RaftOutcome<unknown, string> | RaftInterrupted;
9177
10336
  interface Raft {
10337
+ /**
10338
+ * Run an operation from the manifest (`RAFT_OPERATIONS`) by name: validates
10339
+ * `args` with the operation's request schema and dispatches to the same
10340
+ * implementation as the typed method. Never throws for a bad name or bad
10341
+ * arguments: returns an `INVALID_REQUEST` failure (nothing is sent).
10342
+ * Operations whose typed method does not return an outcome are folded into
10343
+ * one: `identity.whoami` (state `identity`), `inbox.commit` (`committed` /
10344
+ * `nothing`), `inbox.drain` (the whole drain: `batch` / `empty`).
10345
+ */
10346
+ invoke(name: RaftOperationName | (string & {}), args?: unknown, caller?: RaftInvokeCaller): Promise<RaftInvokeResult>;
9178
10347
  identity: {
9179
10348
  /** Who this credential is: agent, server, capabilities, and the operating guide for External Agents. */
9180
10349
  whoami(): Promise<RaftContextResult>;
@@ -9294,12 +10463,20 @@ interface Raft {
9294
10463
  list(request: ListTasksRequest): Promise<RaftOutcome<RaftTaskBoard, "board" | "empty">>;
9295
10464
  create(request: CreateTasksRequest): Promise<RaftOutcome<RaftTasksCreated, "created">>;
9296
10465
  unclaim(request: TaskRef): Promise<RaftOutcome<TaskRef, "unclaimed">>;
10466
+ /** Assign a task. `assignee` is required; clear an assignment with `unassign`, never by omitting it. */
9297
10467
  assign(request: AssignTaskRequest): Promise<RaftOutcome<{
9298
10468
  target: string;
9299
10469
  taskNumber: number;
9300
10470
  assignee: string | null;
9301
10471
  revision: number;
9302
10472
  }, "assigned" | "unassigned">>;
10473
+ /** Clear a task's assignee. */
10474
+ unassign(request: UnassignTaskRequest): Promise<RaftOutcome<{
10475
+ target: string;
10476
+ taskNumber: number;
10477
+ assignee: null;
10478
+ revision: number;
10479
+ }, "unassigned">>;
9303
10480
  /** todo → in_progress → in_review → done; `closed` from anywhere. A hold comes back as `state: "interrupted"` (resume = the same update). */
9304
10481
  updateStatus(request: UpdateTaskStatusRequest): Promise<UpdateTaskStatusOutcome>;
9305
10482
  amend(request: AmendTaskRequest): Promise<AmendTaskOutcome>;
@@ -9354,7 +10531,11 @@ interface Raft {
9354
10531
  }): Promise<RaftOutcome<AgentApiProfileView, "profile">>;
9355
10532
  update(request: AgentApiProfileUpdateBody): Promise<RaftOutcome<AgentApiProfileView, "updated">>;
9356
10533
  };
9357
- /** What this process has shown its model, per target; export it to survive restarts. */
10534
+ /**
10535
+ * What this process has shown its model, per target; export it to survive
10536
+ * restarts. `frontier.setContext(id)` scopes it to one model context (reads
10537
+ * attest only sends in the context they were booked in).
10538
+ */
9358
10539
  frontier: SeenFrontier;
9359
10540
  state: {
9360
10541
  /** Save now (for example after `frontier.recordHeld(interrupt)`). Best effort; returns whether it succeeded. */
@@ -9366,37 +10547,15 @@ interface Raft {
9366
10547
  };
9367
10548
  /** Every Agent API route, typed from the shared contract. */
9368
10549
  routes: RaftRoutes;
9369
- /**
9370
- * Run a `raft` command on the Server for this agent (the hosted command
9371
- * endpoint): `argv` without the leading `raft`. Returns the CLI's exact
9372
- * text and the structured outcome; one attempt, never retried. The
9373
- * Server keeps that path's state (seen messages, drafts); it does not use
9374
- * this process's `frontier`.
9375
- */
9376
- runCommand(request: RaftCommandRequest): Promise<RaftCommandResult>;
9377
10550
  }
9378
10551
  export declare function createRaft(options: CreateRaftOptions): Raft;
9379
10552
  //#endregion
9380
- //#region ../shared/src/agentOps/commands/entries/inbox.d.ts
9381
- /**
9382
- * `message check`'s outcome data (`outcome.data` of a successful check).
9383
- */
9384
- interface MessageCheckOutcomeData {
9385
- messageCount: number;
9386
- hasMore: boolean;
9387
- drainComplete: boolean;
9388
- leases: number;
9389
- ackedLeases: number;
9390
- /**
9391
- * Hosted agents only (the command endpoint): the cursor that acknowledges
9392
- * this batch. The batch stays unacknowledged on the server until a later
9393
- * request carries this value as `ackEventsCursor`; the gateway sends it
9394
- * back only after this result reached the model. A request without it (or
9395
- * with any other value) acknowledges nothing and the batch is delivered
9396
- * again. Absent when nothing is pending or the server acknowledged the
9397
- * batch immediately.
9398
- */
9399
- eventsCursor?: string;
9400
- }
10553
+ //#region src/operationSchemas.d.ts
10554
+ /** `identity.whoami` takes no arguments. */
10555
+ export declare const whoamiRequestSchema: z.ZodObject<{}, z.core.$strip>;
10556
+ /** `inbox.commit`: no cursor commits the pending batch; a cursor commits up to it. */
10557
+ export declare const commitInboxRequestSchema: z.ZodObject<{
10558
+ cursor: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
10559
+ }, z.core.$strip>;
9401
10560
  //#endregion
9402
- export type { AmendTaskOutcome, AmendTaskRequest, AssignTaskRequest, BootstrapRaftCredentialOptions, CheckInboxOutcome, CheckInboxRequest, ClaimTasksOutcome, ClaimTasksRequest, CommandErrorCode, CommandOutcome, CreateRaftClientFromStoreOptions, CreateRaftClientOptions, CreateRaftOptions, CreateRaftRoutesOptions, CreateTasksRequest, DrainInboxRequest, ExecuteMentionActionRequest, ListInboxRequest, ListTasksRequest, ManualContext, MessageCheckOutcomeData, PrepareActionCardRequest, Raft, RaftAckMode, RaftActionPrepareRequest, RaftActionPrepared, RaftApiError, RaftApiResult, RaftAppConfig, RaftAppConfigPatch, RaftAttachmentBytes, RaftAttachmentUploaded, RaftAvatarUpload, RaftChannelJoinClient, RaftChannelJoinClientResult, RaftChannelJoinError, RaftChannelJoinFailure, RaftChannelJoinOperation, RaftChannelJoinRequest, RaftChannelJoinResult, RaftChannelJoinSuccess, RaftChannelJoinTransportError, RaftChannelMuteState, RaftChannelRef, RaftClaimResult, RaftClaimRow, RaftClaimRowState, RaftClient, RaftClientError, RaftClientFailure, RaftClientResult, RaftClientSuccess, RaftClientThrottleOptions, RaftClientTransportRequest, RaftCommandRan, RaftCommandRequest, RaftCommandResult, RaftContextAgent, RaftContextData, RaftContextError, RaftContextResult, RaftContextServer, RaftCredentialErrorCode, RaftCredentialIdentity, RaftCredentialStore, RaftEvent, RaftEventAttachment, RaftEventExternalMessage, RaftEventsReceiveData, RaftEventsReceiveError, RaftEventsReceiveRequest, RaftEventsReceiveResult, RaftFailure, RaftHistoryPage, RaftInboxBatch, RaftInboxCommitResult, RaftInboxConversation, RaftInboxDrainSummary, RaftInboxListing, RaftInboxNotice, RaftInterrupt, RaftInterruptCancel, RaftInterruptReason, RaftInterruptResume, RaftInterrupted, RaftLatestReadThread, RaftManageClient, RaftMessage, RaftMessageAttachment, RaftMessageTask, RaftNextStep, RaftNoticeFlag, RaftNoticeTarget, RaftOpError, RaftOpErrorCode, RaftOutcome, RaftPendingMentions, RaftPreparedCard, RaftProfile, RaftProfileUpdate, RaftRouteAnnotations, RaftRouteInfo, RaftRouteKey, RaftRouteMeta, RaftRouteResult, RaftRouteRetryPolicy, RaftRoutes, RaftSdkConfigurationErrorCode, RaftSearchPage, RaftSenderType, RaftSent, RaftServerInfo, RaftServerProfile, RaftServerUpdate, RaftState, RaftStateContinuation, RaftStateSaveErrorHandler, RaftStateStore, RaftTaskBoard, RaftTaskStatus, RaftTasksCreated, RaftWebhookStatus, ReactRequest, ReadHistoryRequest, ReadLatestReadThreadOptions, SearchMessagesRequest, SeenAttestation, SeenFrontierSnapshot, SendMessageOutcome, SendMessageRequest, ServerInfoRequest, ServerInfoSection, StoredRaftCredential, TaskRef, UpdateTaskStatusOutcome, UpdateTaskStatusRequest, UploadAttachmentRequest, VerifyNoticeInput, VerifyNoticeRejection, VerifyNoticeResult };
10561
+ export type { AmendTaskOutcome, AmendTaskRequest, AssignTaskRequest, BootstrapRaftCredentialOptions, CheckInboxOutcome, CheckInboxRequest, ClaimTasksOutcome, ClaimTasksRequest, ConvertMessageToTaskRequest, CreateRaftClientFromStoreOptions, CreateRaftClientOptions, CreateRaftOptions, CreateRaftRoutesOptions, CreateTasksRequest, DrainInboxRequest, ExecuteMentionActionRequest, ListInboxRequest, ListTasksRequest, ManualContext, PrepareActionCardRequest, Raft, RaftAckMode, RaftActionPrepareRequest, RaftActionPrepared, RaftApiError, RaftApiResult, RaftAppConfig, RaftAppConfigPatch, RaftAttachmentBytes, RaftAttachmentUploaded, RaftAvatarUpload, RaftChannelJoinClient, RaftChannelJoinClientResult, RaftChannelJoinError, RaftChannelJoinFailure, RaftChannelJoinOperation, RaftChannelJoinRequest, RaftChannelJoinResult, RaftChannelJoinSuccess, RaftChannelJoinTransportError, RaftChannelMuteState, RaftChannelRef, RaftClaimResult, RaftClaimRow, RaftClaimRowState, RaftClient, RaftClientError, RaftClientFailure, RaftClientResult, RaftClientSuccess, RaftClientThrottleOptions, RaftClientTransportRequest, RaftConsumption, RaftContextAgent, RaftContextData, RaftContextError, RaftContextResult, RaftContextServer, RaftCredentialErrorCode, RaftCredentialIdentity, RaftCredentialStore, RaftEvent, RaftEventAttachment, RaftEventExternalMessage, RaftEventsReceiveData, RaftEventsReceiveError, RaftEventsReceiveRequest, RaftEventsReceiveResult, RaftFailure, RaftHistoryPage, RaftInboxBatch, RaftInboxCommitResult, RaftInboxConversation, RaftInboxDrainSummary, RaftInboxDrained, RaftInboxListing, RaftInboxNotice, RaftInterrupt, RaftInterruptCancel, RaftInterruptReason, RaftInterruptResume, RaftInterrupted, RaftInvokeCaller, RaftInvokeResult, RaftJsonSchema, RaftJsonSchemaType, RaftLatestReadThread, RaftManageClient, RaftMessage, RaftMessageAttachment, RaftMessageTask, RaftNextStep, RaftNoticeFlag, RaftNoticeTarget, RaftOpError, RaftOpErrorCode, RaftOperationIdempotency, RaftOperationName, RaftOperationSpec, RaftOperationsDocument, RaftOutcome, RaftPendingMentions, RaftPreparedCard, RaftProfile, RaftProfileUpdate, RaftRouteAnnotations, RaftRouteInfo, RaftRouteKey, RaftRouteMeta, RaftRouteResult, RaftRouteRetryPolicy, RaftRoutes, RaftSdkConfigurationErrorCode, RaftSearchPage, RaftSenderType, RaftSent, RaftServerInfo, RaftServerProfile, RaftServerUpdate, RaftState, RaftStateContinuation, RaftStateSaveErrorHandler, RaftStateStore, RaftTaskBoard, RaftTaskStatus, RaftTasksCreated, RaftWebhookStatus, ReactRequest, ReadHistoryRequest, ReadLatestReadThreadOptions, ReplyToRequest, SearchMessagesRequest, SeenAttestation, SeenFrontierSnapshot, SendMessageOutcome, SendMessageRequest, ServerInfoRequest, ServerInfoSection, StoredRaftCredential, TaskRef, UpdateTaskStatusOutcome, UpdateTaskStatusRequest, UploadAttachmentRequest, VerifyNoticeInput, VerifyNoticeRejection, VerifyNoticeResult };