@macro-inc/sdk 0.4.1 → 0.6.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.
Files changed (228) hide show
  1. package/README.md +316 -21
  2. package/dist/{chunk-PTX2RV2N.js → chunk-4MI52GWV.js} +93 -1
  3. package/dist/{chunk-XFA7NCJ5.js → chunk-HO75UE4Z.js} +146 -15
  4. package/dist/{chunk-P4DTO6VD.js → chunk-MCSQNZ4E.js} +6 -0
  5. package/dist/{chunk-ZLBDES7U.js → chunk-SJ6S2GAT.js} +1271 -87
  6. package/dist/{chunk-AZJUIUIV.js → chunk-SK5CMXRV.js} +100 -14
  7. package/dist/{chunk-PZPTJI6F.js → chunk-TMTYN2UK.js} +229 -2
  8. package/dist/{chunk-PPR7IWZ7.js → chunk-ZYBAKW25.js} +2 -1
  9. package/dist/generated/agent-fold/index.d.ts +202 -14
  10. package/dist/generated/agent-harness/index.d.ts +1 -1
  11. package/dist/generated/agent-harness/index.js +1 -1
  12. package/dist/generated/agent-harness/sdk.gen.d.ts +49 -2
  13. package/dist/generated/agent-harness/types.gen.d.ts +527 -9
  14. package/dist/generated/agent-reviews/index.d.ts +11 -9
  15. package/dist/generated/auth/index.d.ts +1 -1
  16. package/dist/generated/auth/index.js +1 -1
  17. package/dist/generated/auth/sdk.gen.d.ts +82 -16
  18. package/dist/generated/auth/types.gen.d.ts +768 -18
  19. package/dist/generated/calendar/types.gen.d.ts +10 -3
  20. package/dist/generated/cognition/index.d.ts +1 -1
  21. package/dist/generated/cognition/index.js +1 -1
  22. package/dist/generated/cognition/sdk.gen.d.ts +60 -6
  23. package/dist/generated/cognition/types.gen.d.ts +663 -106
  24. package/dist/generated/connection/types.gen.d.ts +1 -1
  25. package/dist/generated/contacts/index.d.ts +1 -1
  26. package/dist/generated/contacts/index.js +1 -1
  27. package/dist/generated/contacts/sdk.gen.d.ts +5 -1
  28. package/dist/generated/contacts/types.gen.d.ts +56 -0
  29. package/dist/generated/email/types.gen.d.ts +8 -2
  30. package/dist/generated/notification/index.d.ts +1 -1
  31. package/dist/generated/notification/index.js +1 -1
  32. package/dist/generated/notification/sdk.gen.d.ts +2 -1
  33. package/dist/generated/notification/types.gen.d.ts +174 -1
  34. package/dist/generated/scheduled-action/index.d.ts +1 -1
  35. package/dist/generated/scheduled-action/index.js +1 -1
  36. package/dist/generated/scheduled-action/sdk.gen.d.ts +107 -2
  37. package/dist/generated/scheduled-action/types.gen.d.ts +2451 -479
  38. package/dist/generated/search/index.d.ts +1 -1
  39. package/dist/generated/search/types.gen.d.ts +50 -11
  40. package/dist/generated/storage/index.d.ts +1 -1
  41. package/dist/generated/storage/index.js +1 -1
  42. package/dist/generated/storage/sdk.gen.d.ts +511 -18
  43. package/dist/generated/storage/types.gen.d.ts +18528 -11395
  44. package/dist/src/entities/account-managers/grant.d.ts +28 -5
  45. package/dist/src/entities/account-managers/namespace.d.ts +15 -3
  46. package/dist/src/entities/activity/entity.d.ts +7 -0
  47. package/dist/src/entities/activity/namespace.d.ts +58 -0
  48. package/dist/src/entities/activity/namespace.test.d.ts +1 -0
  49. package/dist/src/entities/agent-sessions/activity.d.ts +12 -3
  50. package/dist/src/entities/agent-sessions/agent-session.d.ts +209 -22
  51. package/dist/src/entities/agent-sessions/code-execution.d.ts +15 -3
  52. package/dist/src/entities/agent-sessions/conversation.d.ts +46 -9
  53. package/dist/src/entities/agent-sessions/namespace.d.ts +72 -16
  54. package/dist/src/entities/agent-sessions/origin.d.ts +1 -1
  55. package/dist/src/entities/agent-sessions/queued-action.d.ts +17 -3
  56. package/dist/src/entities/agent-sessions/review.d.ts +56 -5
  57. package/dist/src/entities/agent-sessions/tool-approval.d.ts +5 -1
  58. package/dist/src/entities/agents/agent.d.ts +98 -3
  59. package/dist/src/entities/agents/namespace.d.ts +52 -8
  60. package/dist/src/entities/ai/namespace.d.ts +10 -2
  61. package/dist/src/entities/api-keys/api-key.d.ts +6 -1
  62. package/dist/src/entities/api-keys/namespace.d.ts +18 -3
  63. package/dist/src/entities/bots/bot.d.ts +44 -9
  64. package/dist/src/entities/bots/namespace.d.ts +13 -1
  65. package/dist/src/entities/bots/token.d.ts +6 -1
  66. package/dist/src/entities/calendar/booking-link.d.ts +7 -1
  67. package/dist/src/entities/calendar/booking-namespace.d.ts +14 -1
  68. package/dist/src/entities/calendar/booking.d.ts +15 -0
  69. package/dist/src/entities/calendar/calendar.d.ts +10 -3
  70. package/dist/src/entities/calendar/event.d.ts +68 -9
  71. package/dist/src/entities/calendar/namespace.d.ts +91 -12
  72. package/dist/src/entities/calendar/replacement.d.ts +19 -3
  73. package/dist/src/entities/calls/call-record.d.ts +107 -17
  74. package/dist/src/entities/calls/connection.d.ts +7 -1
  75. package/dist/src/entities/calls/message.d.ts +27 -5
  76. package/dist/src/entities/calls/namespace.d.ts +15 -3
  77. package/dist/src/entities/canvases/canvas.d.ts +329 -0
  78. package/dist/src/entities/channels/access-request.d.ts +10 -2
  79. package/dist/src/entities/channels/activity.d.ts +20 -4
  80. package/dist/src/entities/channels/channel.d.ts +154 -27
  81. package/dist/src/entities/channels/labels.d.ts +41 -7
  82. package/dist/src/entities/channels/message.d.ts +105 -8
  83. package/dist/src/entities/channels/message.test.d.ts +1 -0
  84. package/dist/src/entities/channels/namespace.d.ts +37 -7
  85. package/dist/src/entities/channels/post.d.ts +13 -7
  86. package/dist/src/entities/channels/post.test.d.ts +1 -0
  87. package/dist/src/entities/channels/share.d.ts +9 -0
  88. package/dist/src/entities/channels/share.test.d.ts +1 -0
  89. package/dist/src/entities/channels/thread.d.ts +24 -4
  90. package/dist/src/entities/chats/chat.d.ts +57 -7
  91. package/dist/src/entities/chats/generation.d.ts +11 -2
  92. package/dist/src/entities/chats/namespace.d.ts +10 -2
  93. package/dist/src/entities/connected-apps/connected-app.d.ts +16 -2
  94. package/dist/src/entities/connected-apps/connector.d.ts +3 -0
  95. package/dist/src/entities/connected-apps/namespace.d.ts +18 -0
  96. package/dist/src/entities/crm/company.d.ts +64 -16
  97. package/dist/src/entities/crm/contact.d.ts +102 -14
  98. package/dist/src/entities/crm/namespace.d.ts +113 -22
  99. package/dist/src/entities/crm/pipeline-entry.d.ts +109 -0
  100. package/dist/src/entities/crm/pipeline.d.ts +292 -29
  101. package/dist/src/entities/crm/pipelines.d.ts +69 -4
  102. package/dist/src/entities/crm-email-privacy/email-privacy.d.ts +238 -0
  103. package/dist/src/entities/crm-email-privacy/email-rule-preview.d.ts +55 -0
  104. package/dist/src/entities/crm-email-privacy/email-rule-revision.d.ts +27 -0
  105. package/dist/src/entities/crm-email-privacy/email-rules.d.ts +32 -0
  106. package/dist/src/entities/databases/column.d.ts +54 -7
  107. package/dist/src/entities/databases/database.d.ts +160 -18
  108. package/dist/src/entities/databases/namespace.d.ts +40 -8
  109. package/dist/src/entities/databases/row.d.ts +2 -0
  110. package/dist/src/entities/databases/saved-query.d.ts +151 -0
  111. package/dist/src/entities/databases/table.d.ts +73 -10
  112. package/dist/src/entities/databases/view.d.ts +37 -5
  113. package/dist/src/entities/databases/webhook.d.ts +8 -1
  114. package/dist/src/entities/documents/ai-edit.d.ts +2 -0
  115. package/dist/src/entities/documents/anchor.d.ts +12 -2
  116. package/dist/src/entities/documents/comment.d.ts +29 -5
  117. package/dist/src/entities/documents/create.test.d.ts +1 -0
  118. package/dist/src/entities/documents/document.d.ts +284 -26
  119. package/dist/src/entities/documents/markdown.d.ts +25 -0
  120. package/dist/src/entities/documents/namespace.d.ts +146 -13
  121. package/dist/src/entities/documents/skills.test.d.ts +1 -0
  122. package/dist/src/entities/documents/system-skill.d.ts +21 -1
  123. package/dist/src/entities/documents/text-comment.d.ts +41 -0
  124. package/dist/src/entities/documents/text-comment.test.d.ts +1 -0
  125. package/dist/src/entities/documents/version.d.ts +5 -1
  126. package/dist/src/entities/email/attachment.d.ts +3 -0
  127. package/dist/src/entities/email/draft.d.ts +61 -9
  128. package/dist/src/entities/email/filter.d.ts +12 -2
  129. package/dist/src/entities/email/label.d.ts +7 -1
  130. package/dist/src/entities/email/link.d.ts +5 -1
  131. package/dist/src/entities/email/message.d.ts +72 -14
  132. package/dist/src/entities/email/namespace.d.ts +134 -24
  133. package/dist/src/entities/email/thread.d.ts +124 -18
  134. package/dist/src/entities/entity-mentions/mention.d.ts +6 -1
  135. package/dist/src/entities/entity-mentions/namespace.d.ts +5 -1
  136. package/dist/src/entities/entity.d.ts +65 -6
  137. package/dist/src/entities/external-chat/chat.d.ts +80 -12
  138. package/dist/src/entities/external-chat/message.d.ts +1 -1
  139. package/dist/src/entities/external-chat/namespace.d.ts +5 -1
  140. package/dist/src/entities/external-chat/send.d.ts +10 -2
  141. package/dist/src/entities/favorites/namespace.d.ts +20 -3
  142. package/dist/src/entities/foreign/foreign-entity.d.ts +5 -1
  143. package/dist/src/entities/foreign/namespace.d.ts +5 -1
  144. package/dist/src/entities/forms/form.d.ts +91 -14
  145. package/dist/src/entities/forms/namespace.d.ts +10 -2
  146. package/dist/src/entities/forms/question.d.ts +35 -7
  147. package/dist/src/entities/forms/response.d.ts +25 -5
  148. package/dist/src/entities/forms/section.d.ts +15 -3
  149. package/dist/src/entities/github-pull-requests/namespace.d.ts +5 -1
  150. package/dist/src/entities/github-pull-requests/pull-request.d.ts +15 -3
  151. package/dist/src/entities/harnesses/harness.d.ts +51 -3
  152. package/dist/src/entities/harnesses/namespace.d.ts +54 -8
  153. package/dist/src/entities/harnesses/pairing.d.ts +13 -2
  154. package/dist/src/entities/images/image.d.ts +16 -5
  155. package/dist/src/entities/images/namespace.d.ts +8 -1
  156. package/dist/src/entities/imports/entry.d.ts +65 -0
  157. package/dist/src/entities/imports/namespace.d.ts +103 -0
  158. package/dist/src/entities/imports/namespace.test.d.ts +1 -0
  159. package/dist/src/entities/initiatives/initiative.d.ts +128 -4
  160. package/dist/src/entities/initiatives/initiative.test.d.ts +1 -0
  161. package/dist/src/entities/initiatives/namespace.d.ts +71 -7
  162. package/dist/src/entities/me/namespace.d.ts +28 -3
  163. package/dist/src/entities/meetings/meeting.d.ts +46 -8
  164. package/dist/src/entities/meetings/namespace.d.ts +20 -4
  165. package/dist/src/entities/memory/namespace.d.ts +49 -0
  166. package/dist/src/entities/memory/namespace.test.d.ts +1 -0
  167. package/dist/src/entities/messages/discussion.d.ts +84 -0
  168. package/dist/src/entities/messages/thread.d.ts +19 -5
  169. package/dist/src/entities/notifications/namespace.d.ts +41 -7
  170. package/dist/src/entities/notifications/notification.d.ts +31 -6
  171. package/dist/src/entities/passwords/item.d.ts +118 -0
  172. package/dist/src/entities/passwords/namespace.d.ts +45 -0
  173. package/dist/src/entities/pins/namespace.d.ts +23 -4
  174. package/dist/src/entities/projects/namespace.d.ts +29 -0
  175. package/dist/src/entities/projects/project.d.ts +58 -7
  176. package/dist/src/entities/properties/namespace.d.ts +67 -11
  177. package/dist/src/entities/properties/namespace.test.d.ts +1 -0
  178. package/dist/src/entities/properties/property-definition.d.ts +30 -5
  179. package/dist/src/entities/properties/property-option.d.ts +14 -2
  180. package/dist/src/entities/referrals/namespace.d.ts +8 -1
  181. package/dist/src/entities/routines/namespace.d.ts +198 -14
  182. package/dist/src/entities/routines/routine.d.ts +174 -27
  183. package/dist/src/entities/routines/suggestion.d.ts +38 -0
  184. package/dist/src/entities/saved-views/namespace.d.ts +58 -0
  185. package/dist/src/entities/saved-views/saved-view.d.ts +78 -0
  186. package/dist/src/entities/search/exclusions.d.ts +6 -0
  187. package/dist/src/entities/search/namespace.d.ts +9 -3
  188. package/dist/src/entities/search/options.d.ts +3 -2
  189. package/dist/src/entities/sharing/access.d.ts +50 -9
  190. package/dist/src/entities/spreadsheets/spreadsheet.d.ts +201 -0
  191. package/dist/src/entities/suggestions/namespace.d.ts +118 -0
  192. package/dist/src/entities/suggestions/suggestion.d.ts +172 -0
  193. package/dist/src/entities/suggestions/suggestion.test.d.ts +1 -0
  194. package/dist/src/entities/tasks/namespace.d.ts +18 -5
  195. package/dist/src/entities/tasks/task.d.ts +21 -3
  196. package/dist/src/entities/teams/invite.d.ts +3 -0
  197. package/dist/src/entities/teams/namespace.d.ts +10 -2
  198. package/dist/src/entities/teams/team.d.ts +22 -2
  199. package/dist/src/entities/ui/app-link.d.ts +24 -0
  200. package/dist/src/entities/ui/namespace.d.ts +75 -0
  201. package/dist/src/entities/unfurls/namespace.d.ts +12 -2
  202. package/dist/src/entities/users/namespace.d.ts +26 -4
  203. package/dist/src/entities/users/profile-picture.d.ts +29 -0
  204. package/dist/src/entities/users/profile-picture.test.d.ts +1 -0
  205. package/dist/src/entities/users/user.d.ts +52 -1
  206. package/dist/src/entities/web/namespace.d.ts +6 -0
  207. package/dist/src/entities/webhooks/namespace.d.ts +5 -0
  208. package/dist/src/entities/webhooks/webhook.d.ts +47 -7
  209. package/dist/src/entities/whatsapp/account.d.ts +5 -1
  210. package/dist/src/entities/whatsapp/chat.d.ts +9 -1
  211. package/dist/src/entities/whatsapp/namespace.d.ts +7 -1
  212. package/dist/src/entities/workspace/namespace.d.ts +12 -4
  213. package/dist/src/entities/workspace/query.d.ts +5 -1
  214. package/dist/src/entities/workspace/query.test.d.ts +1 -0
  215. package/dist/src/events/hydrate/document.d.ts +5 -0
  216. package/dist/src/events/hydrate/user.d.ts +14 -0
  217. package/dist/src/events/receiver.d.ts +2 -0
  218. package/dist/src/events/types.d.ts +2 -1
  219. package/dist/src/macro.d.ts +59 -6
  220. package/dist/src/macro.js +18710 -10355
  221. package/dist/src/utils/activity.d.ts +2 -0
  222. package/dist/src/utils/index.d.ts +1 -1
  223. package/dist/src/utils/lazy.d.ts +20 -1
  224. package/dist/src/utils/options.d.ts +7 -0
  225. package/dist/src/utils/pagination.d.ts +16 -0
  226. package/dist/src/utils/verbs.d.ts +3 -0
  227. package/package.json +1 -1
  228. package/dist/src/entities/crm/comment.d.ts +0 -64
@@ -5,6 +5,30 @@ export type ClientOptions = {
5
5
  * Ordered from least to most access top -> bottom
6
6
  */
7
7
  export type AccessLevel = 'view' | 'comment' | 'edit' | 'owner';
8
+ /**
9
+ * A privacy-reviewed activity report; period_end is inclusive.
10
+ */
11
+ export type Activity = {
12
+ content: string;
13
+ granularity: Granularity;
14
+ periodEnd: string;
15
+ periodStart: string;
16
+ };
17
+ /**
18
+ * Error body for activity reads.
19
+ */
20
+ export type ActivityErrorBody = {
21
+ /**
22
+ * Error description.
23
+ */
24
+ error: string;
25
+ };
26
+ /**
27
+ * Activity reports for one user, ordered by period.
28
+ */
29
+ export type ActivityReports = {
30
+ reports: Array<Activity>;
31
+ };
8
32
  /**
9
33
  * Request body for adding a new MCP server.
10
34
  */
@@ -22,7 +46,7 @@ export type AddServerRequest = {
22
46
  * Everything we use AI for. The wire / DB form of each variant is its
23
47
  * `snake_case` name.
24
48
  */
25
- export type AiFeature = 'chat' | 'memory' | 'automation' | 'dynamic_completions_api' | 'chat_rename' | 'call_summary' | 'channel_bot' | 'ai_projection' | 'ai_editing' | 'import' | 'agent_session' | 'agent_repository_choice' | 'agent_mode_choice' | 'dictation' | 'image_generation' | 'email_focus' | 'web_search';
49
+ export type AiFeature = 'chat' | 'memory' | 'automation' | 'dynamic_completions_api' | 'chat_rename' | 'call_summary' | 'channel_bot' | 'ai_projection' | 'ai_editing' | 'import' | 'agent_session' | 'agent_repository_choice' | 'agent_mode_choice' | 'agent_activity_summary' | 'dictation' | 'image_generation' | 'email_focus' | 'web_search' | 'non_billable_agent_session';
26
50
  /**
27
51
  * A structured part within an assistant message.
28
52
  *
@@ -579,7 +603,7 @@ export type Entity = {
579
603
  /**
580
604
  * The type of an entity in Macro
581
605
  */
582
- export type EntityType = 'user' | 'chat' | 'channel' | 'channel_message' | 'document' | 'project' | 'email_thread' | 'calendar_event' | 'team' | 'call' | 'foreign_entity' | 'static_file' | 'crm_company' | 'crm_contact' | 'crm_pipeline' | 'reminder' | 'skill' | 'agent_session' | 'scheduled_action' | 'initiative' | 'database' | 'database_row' | 'form' | 'external_chat';
606
+ export type EntityType = 'user' | 'chat' | 'channel' | 'channel_message' | 'document' | 'project' | 'email_thread' | 'calendar_event' | 'team' | 'call' | 'foreign_entity' | 'static_file' | 'crm_company' | 'crm_contact' | 'crm_pipeline' | 'reminder' | 'harness' | 'skill' | 'agent_session' | 'scheduled_action' | 'initiative' | 'database' | 'database_row' | 'form' | 'external_chat';
583
607
  /**
584
608
  * Error response body.
585
609
  */
@@ -600,9 +624,12 @@ export type ErrorResponse = {
600
624
  message: string;
601
625
  };
602
626
  /**
603
- * How long a projection remains active without being requested.
627
+ * A private explicit memory document and its optimistic concurrency token.
604
628
  */
605
- export type Expiry = 'day' | 'week' | 'month';
629
+ export type ExplicitMemory = {
630
+ content: string;
631
+ revision: number;
632
+ };
606
633
  /**
607
634
  * Recorded invocations and total for one feature.
608
635
  */
@@ -763,6 +790,10 @@ export type GetChatsForAttachmentResponse = {
763
790
  all_chats: Array<Chat>;
764
791
  recent_chat?: null | Chat;
765
792
  };
793
+ /**
794
+ * Fixed calendar granularity, always in UTC, with Monday-start weeks.
795
+ */
796
+ export type Granularity = 'day' | 'week' | 'month' | 'summary';
766
797
  /**
767
798
  * HTTP request payload for sending a chat message.
768
799
  * Unlike the WebSocket payload, this does not include stream_id as it's generated server-side.
@@ -797,6 +828,15 @@ export type HttpSendChatMessageRequest = {
797
828
  */
798
829
  toolset?: ToolSet;
799
830
  };
831
+ /**
832
+ * The caller's ledger rows.
833
+ */
834
+ export type ImportEntitiesResponse = {
835
+ /**
836
+ * The caller's own rows and their team's imported rows, newest first.
837
+ */
838
+ entities: Array<ImportEntity>;
839
+ };
800
840
  /**
801
841
  * One row of the import ledger.
802
842
  */
@@ -884,6 +924,32 @@ export type ImportEntity = {
884
924
  * Linear issue, are tracked and deduplicated separately.
885
925
  */
886
926
  export type ImportKind = 'issue' | 'project' | 'document' | 'page' | 'database' | 'data_source' | 'row' | 'jira_issue' | 'jira_project' | 'jira_epic' | 'channel';
927
+ /**
928
+ * Body for importing one Notion page.
929
+ */
930
+ export type ImportNotionPageRequest = {
931
+ /**
932
+ * The Notion page URL or 32-character page id.
933
+ */
934
+ page: string;
935
+ };
936
+ /**
937
+ * The outcome of importing a Notion page, with its ledger row.
938
+ */
939
+ export type ImportNotionPageResponse = {
940
+ /**
941
+ * The row behind the outcome; `entity_id` is the document once imported.
942
+ */
943
+ entity: ImportEntity;
944
+ /**
945
+ * What happened.
946
+ */
947
+ outcome: ImportNotionPageResult;
948
+ };
949
+ /**
950
+ * What importing one Notion page did.
951
+ */
952
+ export type ImportNotionPageResult = 'imported' | 'already_imported' | 'already_imported_by_teammate' | 'previously_declined' | 'import_in_progress';
887
953
  /**
888
954
  * Discovery-run state for one user × source.
889
955
  */
@@ -897,6 +963,10 @@ export type ImportRun = {
897
963
  * presented while it is still `running`; rows staged after that take it.
898
964
  */
899
965
  review_id?: string | null;
966
+ /**
967
+ * The agent session presenting that review.
968
+ */
969
+ review_session_id?: string | null;
900
970
  scanned?: null | ScanCounts;
901
971
  /**
902
972
  * The source this run discovered from.
@@ -987,6 +1057,22 @@ export type LinearIssueMeta = {
987
1057
  */
988
1058
  export type LinkShare = 'PUBLIC' | 'TEAM';
989
1059
  export type MacroUserIdStr = string;
1060
+ /**
1061
+ * An edit to one one-based line. A revision is required to prevent replay
1062
+ * or concurrent edits from inserting twice or deleting a different line.
1063
+ */
1064
+ export type MemoryEdit = {
1065
+ action: 'insert';
1066
+ content: string;
1067
+ line: number;
1068
+ } | {
1069
+ action: 'replace';
1070
+ content: string;
1071
+ line: number;
1072
+ } | {
1073
+ action: 'delete';
1074
+ line: number;
1075
+ };
990
1076
  export type MemoryErrorBody = {
991
1077
  /**
992
1078
  * Error description.
@@ -1010,7 +1096,7 @@ export type MessageWithAttachments = {
1010
1096
  /**
1011
1097
  * The requested inference speed. Standard is backward compatible with old clients.
1012
1098
  */
1013
- export type ModelSpeed = 'standard' | 'fast' | 'ultrafast';
1099
+ export type ModelSpeed = 'standard' | 'priority' | 'fast' | 'ultrafast';
1014
1100
  export type NewAttachment = {
1015
1101
  attachment_id: string;
1016
1102
  attachment_type: AttachmentType;
@@ -1566,43 +1652,18 @@ export type Price = {
1566
1652
  total: number;
1567
1653
  };
1568
1654
  /**
1569
- * The current state of a user's projection instance.
1655
+ * Response from [`ReadActivity`].
1570
1656
  */
1571
- export type ProjectionStateResponse = {
1572
- /**
1573
- * The cached result, if any. JSON-encoded when the projection defines an
1574
- * `output_schema`.
1575
- */
1576
- data?: string | null;
1577
- /**
1578
- * The most recent materialization error, if any.
1579
- */
1580
- error?: string | null;
1657
+ export type ReadActivityResponse = {
1581
1658
  /**
1582
- * When the result was generated.
1659
+ * Matching activity events, newest first.
1583
1660
  */
1584
- generated_at?: string | null;
1661
+ activities: Array<ToolActivityEvent>;
1585
1662
  /**
1586
- * The projection id.
1663
+ * Whether more than 100 events matched the requested range.
1587
1664
  */
1588
- id: string;
1589
- /**
1590
- * When the result becomes stale.
1591
- */
1592
- stale_at?: string | null;
1593
- /**
1594
- * The materialization status.
1595
- */
1596
- status: ProjectionStatus;
1665
+ truncated: boolean;
1597
1666
  };
1598
- /**
1599
- * The materialization status of a user's projection instance.
1600
- */
1601
- export type ProjectionStatus = 'loading' | 'cold' | 'ready' | 'refreshing' | 'error';
1602
- /**
1603
- * How frequently an active projection is regenerated.
1604
- */
1605
- export type RefreshCadence = 'high' | 'medium' | 'low';
1606
1667
  /**
1607
1668
  * Request body for rejecting a pending tool call.
1608
1669
  */
@@ -1783,6 +1844,79 @@ export type SharePermissionV2 = {
1783
1844
  owner: string;
1784
1845
  teamShareAccessLevel?: null | AccessLevel;
1785
1846
  };
1847
+ /**
1848
+ * A skill's complete instructions.
1849
+ */
1850
+ export type SkillContentResponse = {
1851
+ /**
1852
+ * Whether this is a built-in skill, with no document behind it.
1853
+ */
1854
+ builtIn: boolean;
1855
+ /**
1856
+ * The skill's full markdown instructions.
1857
+ */
1858
+ content: string;
1859
+ /**
1860
+ * The skill's id.
1861
+ */
1862
+ id: string;
1863
+ /**
1864
+ * The skill's name.
1865
+ */
1866
+ name: string;
1867
+ };
1868
+ /**
1869
+ * Machine-readable failure of a skill request.
1870
+ */
1871
+ export type SkillErrorBody = {
1872
+ /**
1873
+ * Stable failure code.
1874
+ */
1875
+ code: string;
1876
+ /**
1877
+ * Explanation without backend diagnostics.
1878
+ */
1879
+ error: string;
1880
+ };
1881
+ /**
1882
+ * One skill the caller can read.
1883
+ */
1884
+ export type SkillListing = {
1885
+ /**
1886
+ * Whether this is a built-in skill, with no document behind it.
1887
+ */
1888
+ builtIn: boolean;
1889
+ /**
1890
+ * When to use the skill, when it says.
1891
+ */
1892
+ description?: string | null;
1893
+ /**
1894
+ * The skill document's id, or a built-in skill's well-known id.
1895
+ */
1896
+ id: string;
1897
+ /**
1898
+ * The skill's name.
1899
+ */
1900
+ name: string;
1901
+ /**
1902
+ * When the skill document was last updated; built-in skills have none.
1903
+ */
1904
+ updatedAt?: string | null;
1905
+ };
1906
+ /**
1907
+ * How search terms are matched against skill names.
1908
+ */
1909
+ export type SkillsMatchType = 'partial' | 'exact';
1910
+ /**
1911
+ * The skills matching a listing or search, most recently updated first,
1912
+ * built-in skills last.
1913
+ */
1914
+ export type SkillsResponse = {
1915
+ /**
1916
+ * The matching skills.
1917
+ */
1918
+ skills: Array<SkillListing>;
1919
+ };
1786
1920
  /**
1787
1921
  * Metadata for one staged Slack channel.
1788
1922
  */
@@ -1939,9 +2073,111 @@ export type StructuredToolActivity = {
1939
2073
  outcome: ToolOutcome;
1940
2074
  };
1941
2075
  /**
1942
- * The kind of entity a projection is materialized for.
2076
+ * One activity action returned to the AI.
2077
+ */
2078
+ export type ToolActivityAction = {
2079
+ type: 'created';
2080
+ } | {
2081
+ type: 'edited';
2082
+ } | {
2083
+ type: 'opened';
2084
+ } | {
2085
+ type: 'deleted';
2086
+ } | {
2087
+ type: 'messaged';
2088
+ } | {
2089
+ type: 'sent';
2090
+ } | {
2091
+ type: 'responded';
2092
+ } | {
2093
+ /**
2094
+ * The previous value, when known.
2095
+ */
2096
+ from?: unknown;
2097
+ /**
2098
+ * Previous select/tag option ids resolved to display labels.
2099
+ */
2100
+ from_labels?: Array<string> | null;
2101
+ /**
2102
+ * The property definition id.
2103
+ */
2104
+ property: string;
2105
+ /**
2106
+ * The property definition's human-readable display name, when it is
2107
+ * still visible to the caller.
2108
+ */
2109
+ property_name?: string | null;
2110
+ /**
2111
+ * The property's canonical data type, including `tag` for tag sets.
2112
+ */
2113
+ property_type?: string | null;
2114
+ /**
2115
+ * The new value, or `None` when cleared.
2116
+ */
2117
+ to?: unknown;
2118
+ /**
2119
+ * New select/tag option ids resolved to display labels.
2120
+ */
2121
+ to_labels?: Array<string> | null;
2122
+ type: 'propertyChanged';
2123
+ } | {
2124
+ /**
2125
+ * The added principal.
2126
+ */
2127
+ participant: string;
2128
+ type: 'participantAdded';
2129
+ } | {
2130
+ /**
2131
+ * The removed principal.
2132
+ */
2133
+ participant: string;
2134
+ type: 'participantRemoved';
2135
+ } | {
2136
+ /**
2137
+ * The started call's id.
2138
+ */
2139
+ call_id: string;
2140
+ type: 'callStarted';
2141
+ } | {
2142
+ type: 'taskAdded';
2143
+ } | {
2144
+ type: 'taskRemoved';
2145
+ } | {
2146
+ /**
2147
+ * The stored payload, verbatim.
2148
+ */
2149
+ payload?: unknown;
2150
+ /**
2151
+ * The stored action tag.
2152
+ */
2153
+ tag: string;
2154
+ type: 'unknown';
2155
+ };
2156
+ /**
2157
+ * One activity event returned by [`ReadActivity`].
1943
2158
  */
1944
- export type TargetType = 'user' | 'team';
2159
+ export type ToolActivityEvent = {
2160
+ /**
2161
+ * What the principal did.
2162
+ */
2163
+ action: ToolActivityAction;
2164
+ /**
2165
+ * The principal that mechanically performed the action.
2166
+ */
2167
+ actorId: string;
2168
+ /**
2169
+ * The entity acted on.
2170
+ */
2171
+ entityId: string;
2172
+ /**
2173
+ * The kind of entity acted on.
2174
+ */
2175
+ entityType: string;
2176
+ /**
2177
+ * When the action occurred.
2178
+ */
2179
+ occurredAt: string;
2180
+ };
1945
2181
  export type ToolOutcome = {
1946
2182
  changes: DatabaseChange;
1947
2183
  status: 'succeeded';
@@ -1957,6 +2193,58 @@ export type ToolSet = {
1957
2193
  } | {
1958
2194
  type: 'databases_read_only';
1959
2195
  };
2196
+ /**
2197
+ * Body for tracking one external item in the ledger.
2198
+ */
2199
+ export type TrackImportEntityRequest = {
2200
+ /**
2201
+ * The Macro entity created from the item; required when `status` is
2202
+ * `imported`.
2203
+ */
2204
+ entityId?: string | null;
2205
+ /**
2206
+ * Stable id of the item in its source: a Linear identifier such as
2207
+ * `ENG-142`, a Notion page URL or id, or a Slack channel id.
2208
+ */
2209
+ foreignId: string;
2210
+ /**
2211
+ * Per-source metadata. Linear: `{identifier, title, …}`; Notion:
2212
+ * `{title, url?, summary?}`; Slack: `{name, …}`.
2213
+ */
2214
+ metadata: {
2215
+ [key: string]: unknown;
2216
+ };
2217
+ /**
2218
+ * The external system the item comes from.
2219
+ */
2220
+ source: ImportSource;
2221
+ /**
2222
+ * `staged` to propose the item, `imported` to record an entity already
2223
+ * created from it.
2224
+ */
2225
+ status: TrackImportStatus;
2226
+ };
2227
+ /**
2228
+ * The outcome of tracking an item, with its ledger row.
2229
+ */
2230
+ export type TrackImportEntityResponse = {
2231
+ /**
2232
+ * The row behind the outcome.
2233
+ */
2234
+ entity: ImportEntity;
2235
+ /**
2236
+ * What happened.
2237
+ */
2238
+ outcome: TrackImportOutcome;
2239
+ };
2240
+ /**
2241
+ * What tracking an item did.
2242
+ */
2243
+ export type TrackImportOutcome = 'staged' | 'recorded_imported' | 'already_imported' | 'already_imported_by_teammate' | 'previously_declined' | 'import_in_progress';
2244
+ /**
2245
+ * Whether a tracked item is a candidate or an import already made.
2246
+ */
2247
+ export type TrackImportStatus = 'staged' | 'imported';
1960
2248
  export type UpdateChannelSharePermission = {
1961
2249
  accessLevel?: null | AccessLevel;
1962
2250
  /**
@@ -1969,6 +2257,19 @@ export type UpdateChannelSharePermission = {
1969
2257
  */
1970
2258
  operation: UpdateOperation;
1971
2259
  };
2260
+ /**
2261
+ * One explicit memory edit at the revision it was based on.
2262
+ */
2263
+ export type UpdateExplicitMemoryRequest = {
2264
+ /**
2265
+ * The one-based line edit to apply.
2266
+ */
2267
+ edit: MemoryEdit;
2268
+ /**
2269
+ * The revision returned by the last read or successful edit.
2270
+ */
2271
+ revision: number;
2272
+ };
1972
2273
  export type UpdateOperation = 'add' | 'remove' | 'replace';
1973
2274
  /**
1974
2275
  * Request body for updating an MCP server.
@@ -2030,56 +2331,6 @@ export type UpdateToolResponseRequest = {
2030
2331
  */
2031
2332
  toolCallId: string;
2032
2333
  };
2033
- /**
2034
- * Request body for getting or creating an ai projection. The concrete target
2035
- * id is resolved from the authenticated user, so only the target type is sent.
2036
- */
2037
- export type UpsertProjectionRequest = {
2038
- /**
2039
- * When `true` and generation is needed (cold instance or `regenerate`),
2040
- * the server generates inline and responds with the finished result
2041
- * instead of returning immediately and pushing an update through the
2042
- * connection gateway.
2043
- */
2044
- await?: boolean;
2045
- /**
2046
- * How long the projection remains active without being requested.
2047
- */
2048
- expiry: Expiry;
2049
- /**
2050
- * The frontend-defined projection id (e.g. `notification_important_widget`).
2051
- */
2052
- id: string;
2053
- /**
2054
- * Optional `provider/model` id used for generation (e.g.
2055
- * `cerebras/llama-3.3-70b`). The default model is used when absent.
2056
- */
2057
- model?: string | null;
2058
- /**
2059
- * Optional JSON schema the generated result must conform to. When set,
2060
- * `data` holds the JSON serialization of a conforming value. Enforcement
2061
- * is prompted (non-strict), so it works across providers.
2062
- */
2063
- output_schema?: {
2064
- [key: string]: unknown;
2065
- } | null;
2066
- /**
2067
- * The prompt used to materialize the projection.
2068
- */
2069
- prompt: string;
2070
- /**
2071
- * How frequently the projection should be regenerated.
2072
- */
2073
- refresh_cadence: RefreshCadence;
2074
- /**
2075
- * When `true`, regenerate even if a cached result exists.
2076
- */
2077
- regenerate?: boolean;
2078
- /**
2079
- * Whether the projection is materialized for the requesting user or their team.
2080
- */
2081
- target_type: TargetType;
2082
- };
2083
2334
  /**
2084
2335
  * Measured usage for one invocation.
2085
2336
  */
@@ -2314,6 +2565,39 @@ export type WebSearchTopic = 'general' | 'news';
2314
2565
  export type WithChatId = {
2315
2566
  chat_id: string;
2316
2567
  };
2568
+ export type ReadMyActivityData = {
2569
+ body?: never;
2570
+ path?: never;
2571
+ query: {
2572
+ /**
2573
+ * Inclusive start, RFC 3339.
2574
+ */
2575
+ from: string;
2576
+ /**
2577
+ * Exclusive end, RFC 3339; must be after `from`.
2578
+ */
2579
+ to: string;
2580
+ };
2581
+ url: '/activity';
2582
+ };
2583
+ export type ReadMyActivityErrors = {
2584
+ /**
2585
+ * `from` is not before `to`
2586
+ */
2587
+ 400: ActivityErrorBody;
2588
+ /**
2589
+ * Internal server error
2590
+ */
2591
+ 500: ActivityErrorBody;
2592
+ };
2593
+ export type ReadMyActivityError = ReadMyActivityErrors[keyof ReadMyActivityErrors];
2594
+ export type ReadMyActivityResponses = {
2595
+ /**
2596
+ * Activity in the range
2597
+ */
2598
+ 200: ReadActivityResponse;
2599
+ };
2600
+ export type ReadMyActivityResponse = ReadMyActivityResponses[keyof ReadMyActivityResponses];
2317
2601
  export type SetPricingHandlerData = {
2318
2602
  body: SetPricingRequest;
2319
2603
  path?: never;
@@ -2369,22 +2653,6 @@ export type GetUsageHandlerResponses = {
2369
2653
  200: UsageSummary;
2370
2654
  };
2371
2655
  export type GetUsageHandlerResponse = GetUsageHandlerResponses[keyof GetUsageHandlerResponses];
2372
- export type UpsertAiProjectionData = {
2373
- body: UpsertProjectionRequest;
2374
- path?: never;
2375
- query?: never;
2376
- url: '/ai-projections';
2377
- };
2378
- export type UpsertAiProjectionErrors = {
2379
- 400: ErrorResponse;
2380
- 403: ErrorResponse;
2381
- 500: ErrorResponse;
2382
- };
2383
- export type UpsertAiProjectionError = UpsertAiProjectionErrors[keyof UpsertAiProjectionErrors];
2384
- export type UpsertAiProjectionResponses = {
2385
- 200: ProjectionStateResponse;
2386
- };
2387
- export type UpsertAiProjectionResponse = UpsertAiProjectionResponses[keyof UpsertAiProjectionResponses];
2388
2656
  export type GetChatsForAttachmentHandlerData = {
2389
2657
  body?: never;
2390
2658
  path: {
@@ -2941,6 +3209,87 @@ export type GenerateImageResponses = {
2941
3209
  200: GenerateImageResponse;
2942
3210
  };
2943
3211
  export type GenerateImageResponse2 = GenerateImageResponses[keyof GenerateImageResponses];
3212
+ export type ListImportEntitiesData = {
3213
+ body?: never;
3214
+ path?: never;
3215
+ query?: {
3216
+ /**
3217
+ * Only rows from this source.
3218
+ */
3219
+ source?: ImportSource;
3220
+ /**
3221
+ * Only rows in this status.
3222
+ */
3223
+ status?: ImportStatus;
3224
+ };
3225
+ url: '/import/entities';
3226
+ };
3227
+ export type ListImportEntitiesErrors = {
3228
+ /**
3229
+ * Internal server error
3230
+ */
3231
+ 500: unknown;
3232
+ };
3233
+ export type ListImportEntitiesResponses = {
3234
+ 200: ImportEntitiesResponse;
3235
+ };
3236
+ export type ListImportEntitiesResponse = ListImportEntitiesResponses[keyof ListImportEntitiesResponses];
3237
+ export type TrackImportEntityData = {
3238
+ body: TrackImportEntityRequest;
3239
+ path?: never;
3240
+ query?: never;
3241
+ url: '/import/entities';
3242
+ };
3243
+ export type TrackImportEntityErrors = {
3244
+ /**
3245
+ * Invalid item or metadata
3246
+ */
3247
+ 400: unknown;
3248
+ /**
3249
+ * The import service refused the item
3250
+ */
3251
+ 422: unknown;
3252
+ /**
3253
+ * Internal server error
3254
+ */
3255
+ 500: unknown;
3256
+ };
3257
+ export type TrackImportEntityResponses = {
3258
+ 200: TrackImportEntityResponse;
3259
+ };
3260
+ export type TrackImportEntityResponse2 = TrackImportEntityResponses[keyof TrackImportEntityResponses];
3261
+ export type DeclineImportEntityData = {
3262
+ body?: never;
3263
+ path: {
3264
+ /**
3265
+ * Ledger row id
3266
+ */
3267
+ id: string;
3268
+ };
3269
+ query?: never;
3270
+ url: '/import/entities/{id}';
3271
+ };
3272
+ export type DeclineImportEntityErrors = {
3273
+ /**
3274
+ * No such row belongs to the caller
3275
+ */
3276
+ 404: unknown;
3277
+ /**
3278
+ * Only staged rows can be declined
3279
+ */
3280
+ 409: unknown;
3281
+ /**
3282
+ * Internal server error
3283
+ */
3284
+ 500: unknown;
3285
+ };
3286
+ export type DeclineImportEntityResponses = {
3287
+ /**
3288
+ * Declined
3289
+ */
3290
+ 204: void;
3291
+ };
3292
+ export type DeclineImportEntityResponse = DeclineImportEntityResponses[keyof DeclineImportEntityResponses];
2944
3293
  export type NotionReportHandlerData = {
2945
3294
  body?: never;
2946
3295
  path?: never;
@@ -2976,6 +3325,30 @@ export type CancelNotionHandlerResponses = {
2976
3325
  200: NotionImportReport;
2977
3326
  };
2978
3327
  export type CancelNotionHandlerResponse = CancelNotionHandlerResponses[keyof CancelNotionHandlerResponses];
3328
+ export type ImportNotionPageData = {
3329
+ body: ImportNotionPageRequest;
3330
+ path?: never;
3331
+ query?: never;
3332
+ url: '/import/notion/pages';
3333
+ };
3334
+ export type ImportNotionPageErrors = {
3335
+ /**
3336
+ * No page given
3337
+ */
3338
+ 400: unknown;
3339
+ /**
3340
+ * Not a page that can be imported, or Notion is not connected
3341
+ */
3342
+ 422: unknown;
3343
+ /**
3344
+ * Internal server error
3345
+ */
3346
+ 500: unknown;
3347
+ };
3348
+ export type ImportNotionPageResponses = {
3349
+ 200: ImportNotionPageResponse;
3350
+ };
3351
+ export type ImportNotionPageResponse2 = ImportNotionPageResponses[keyof ImportNotionPageResponses];
2979
3352
  export type RunImportHandlerData = {
2980
3353
  body: RunImportRequest;
2981
3354
  path?: never;
@@ -3221,6 +3594,103 @@ export type GetMemoryHandlerResponses = {
3221
3594
  200: MemoryResponse;
3222
3595
  };
3223
3596
  export type GetMemoryHandlerResponse = GetMemoryHandlerResponses[keyof GetMemoryHandlerResponses];
3597
+ export type GetUserActivityData = {
3598
+ body?: never;
3599
+ path?: never;
3600
+ query: {
3601
+ /**
3602
+ * A `macro|` user id; omit for the caller.
3603
+ */
3604
+ user?: string;
3605
+ /**
3606
+ * Inclusive first UTC date.
3607
+ */
3608
+ start: string;
3609
+ /**
3610
+ * Inclusive last UTC date, at most 366 days after `start`.
3611
+ */
3612
+ end: string;
3613
+ };
3614
+ url: '/memory/activity';
3615
+ };
3616
+ export type GetUserActivityErrors = {
3617
+ /**
3618
+ * Invalid user id or date range
3619
+ */
3620
+ 400: MemoryErrorBody;
3621
+ /**
3622
+ * The user is not the caller or a current teammate
3623
+ */
3624
+ 403: MemoryErrorBody;
3625
+ /**
3626
+ * Internal server error
3627
+ */
3628
+ 500: MemoryErrorBody;
3629
+ };
3630
+ export type GetUserActivityError = GetUserActivityErrors[keyof GetUserActivityErrors];
3631
+ export type GetUserActivityResponses = {
3632
+ /**
3633
+ * Activity reports in the range
3634
+ */
3635
+ 200: ActivityReports;
3636
+ };
3637
+ export type GetUserActivityResponse = GetUserActivityResponses[keyof GetUserActivityResponses];
3638
+ export type ReadExplicitMemoryData = {
3639
+ body?: never;
3640
+ path?: never;
3641
+ query?: never;
3642
+ url: '/memory/explicit';
3643
+ };
3644
+ export type ReadExplicitMemoryErrors = {
3645
+ /**
3646
+ * Internal server error
3647
+ */
3648
+ 500: MemoryErrorBody;
3649
+ };
3650
+ export type ReadExplicitMemoryError = ReadExplicitMemoryErrors[keyof ReadExplicitMemoryErrors];
3651
+ export type ReadExplicitMemoryResponses = {
3652
+ /**
3653
+ * The caller's explicit memory
3654
+ */
3655
+ 200: ExplicitMemory;
3656
+ };
3657
+ export type ReadExplicitMemoryResponse = ReadExplicitMemoryResponses[keyof ReadExplicitMemoryResponses];
3658
+ export type EditExplicitMemoryData = {
3659
+ body: UpdateExplicitMemoryRequest;
3660
+ path?: never;
3661
+ query?: never;
3662
+ url: '/memory/explicit';
3663
+ };
3664
+ export type EditExplicitMemoryErrors = {
3665
+ /**
3666
+ * Invalid line or content
3667
+ */
3668
+ 400: MemoryErrorBody;
3669
+ /**
3670
+ * The revision is stale
3671
+ */
3672
+ 409: MemoryErrorBody;
3673
+ /**
3674
+ * Rejected by privacy review
3675
+ */
3676
+ 422: MemoryErrorBody;
3677
+ /**
3678
+ * Internal server error
3679
+ */
3680
+ 500: MemoryErrorBody;
3681
+ /**
3682
+ * Privacy review is unavailable; nothing was saved
3683
+ */
3684
+ 503: MemoryErrorBody;
3685
+ };
3686
+ export type EditExplicitMemoryError = EditExplicitMemoryErrors[keyof EditExplicitMemoryErrors];
3687
+ export type EditExplicitMemoryResponses = {
3688
+ /**
3689
+ * The edited explicit memory
3690
+ */
3691
+ 200: ExplicitMemory;
3692
+ };
3693
+ export type EditExplicitMemoryResponse = EditExplicitMemoryResponses[keyof EditExplicitMemoryResponses];
3224
3694
  export type GetStateHandler2Data = {
3225
3695
  body?: never;
3226
3696
  path?: never;
@@ -3485,6 +3955,85 @@ export type GetBatchPreviewResponses = {
3485
3955
  200: GetBatchPreviewResponse;
3486
3956
  };
3487
3957
  export type GetBatchPreviewResponse2 = GetBatchPreviewResponses[keyof GetBatchPreviewResponses];
3958
+ export type ListSkillsData = {
3959
+ body?: never;
3960
+ path?: never;
3961
+ query?: {
3962
+ /**
3963
+ * Words from the skill's name, matched as one adjacent phrase. Omit to
3964
+ * list the 100 most recently updated skills.
3965
+ */
3966
+ query?: string;
3967
+ /**
3968
+ * How `query` is matched; `partial` when omitted.
3969
+ */
3970
+ matchType?: SkillsMatchType;
3971
+ };
3972
+ url: '/skills';
3973
+ };
3974
+ export type ListSkillsErrors = {
3975
+ /**
3976
+ * Blank query
3977
+ */
3978
+ 400: SkillErrorBody;
3979
+ /**
3980
+ * Unauthorized
3981
+ */
3982
+ 401: unknown;
3983
+ /**
3984
+ * Listing failed
3985
+ */
3986
+ 500: SkillErrorBody;
3987
+ /**
3988
+ * Search failed
3989
+ */
3990
+ 502: SkillErrorBody;
3991
+ };
3992
+ export type ListSkillsError = ListSkillsErrors[keyof ListSkillsErrors];
3993
+ export type ListSkillsResponses = {
3994
+ /**
3995
+ * Matching skills, most recently updated first
3996
+ */
3997
+ 200: SkillsResponse;
3998
+ };
3999
+ export type ListSkillsResponse = ListSkillsResponses[keyof ListSkillsResponses];
4000
+ export type ReadSkillData = {
4001
+ body?: never;
4002
+ path: {
4003
+ /**
4004
+ * The skill's id
4005
+ */
4006
+ id: string;
4007
+ };
4008
+ query?: never;
4009
+ url: '/skills/{id}';
4010
+ };
4011
+ export type ReadSkillErrors = {
4012
+ /**
4013
+ * Unauthorized
4014
+ */
4015
+ 401: unknown;
4016
+ /**
4017
+ * No skill the caller can view has this id
4018
+ */
4019
+ 404: SkillErrorBody;
4020
+ /**
4021
+ * Reading failed
4022
+ */
4023
+ 500: SkillErrorBody;
4024
+ /**
4025
+ * Access check unavailable
4026
+ */
4027
+ 503: SkillErrorBody;
4028
+ };
4029
+ export type ReadSkillError = ReadSkillErrors[keyof ReadSkillErrors];
4030
+ export type ReadSkillResponses = {
4031
+ /**
4032
+ * The skill's instructions
4033
+ */
4034
+ 200: SkillContentResponse;
4035
+ };
4036
+ export type ReadSkillResponse = ReadSkillResponses[keyof ReadSkillResponses];
3488
4037
  export type SendChatMessageData = {
3489
4038
  body: HttpSendChatMessageRequest;
3490
4039
  path?: never;
@@ -3604,6 +4153,10 @@ export type FetchWebPageErrors = {
3604
4153
  * AI allowance exhausted
3605
4154
  */
3606
4155
  402: WebErrorBody;
4156
+ /**
4157
+ * Web fetch is not configured in this deployment
4158
+ */
4159
+ 404: WebErrorBody;
3607
4160
  /**
3608
4161
  * The page could not be read
3609
4162
  */
@@ -3617,7 +4170,7 @@ export type FetchWebPageErrors = {
3617
4170
  */
3618
4171
  502: WebErrorBody;
3619
4172
  /**
3620
- * Web fetch unconfigured, busy, or usage validation unavailable
4173
+ * Web fetch busy, or usage validation unavailable
3621
4174
  */
3622
4175
  503: WebErrorBody;
3623
4176
  };
@@ -3648,6 +4201,10 @@ export type SearchWebErrors = {
3648
4201
  * AI allowance exhausted
3649
4202
  */
3650
4203
  402: WebErrorBody;
4204
+ /**
4205
+ * Web search is not configured in this deployment
4206
+ */
4207
+ 404: WebErrorBody;
3651
4208
  /**
3652
4209
  * Per-user hourly rate limit exceeded
3653
4210
  */
@@ -3657,7 +4214,7 @@ export type SearchWebErrors = {
3657
4214
  */
3658
4215
  502: WebErrorBody;
3659
4216
  /**
3660
- * Web search unconfigured, busy, or usage validation unavailable
4217
+ * Web search busy, or usage validation unavailable
3661
4218
  */
3662
4219
  503: WebErrorBody;
3663
4220
  };