@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
@@ -26,6 +26,10 @@ export type ActivityWireRow = {
26
26
  * Originating code-mode invocation, absent on older events.
27
27
  */
28
28
  agent_correlation_id?: string | null;
29
+ /**
30
+ * SDK display verb, absent on older events.
31
+ */
32
+ agent_verb?: string | null;
29
33
  /**
30
34
  * The entity acted on.
31
35
  */
@@ -703,6 +707,66 @@ export type AgentSetModelAction = {
703
707
  */
704
708
  model: string;
705
709
  };
710
+ /**
711
+ * One pending interaction, or one stalled session.
712
+ */
713
+ export type AgentUpdate = {
714
+ /**
715
+ * The runtime the session runs on.
716
+ */
717
+ harness: string;
718
+ /**
719
+ * What the session is waiting for.
720
+ */
721
+ kind: AgentUpdateKind;
722
+ /**
723
+ * The choices a permission request offers; empty for other kinds.
724
+ */
725
+ options: Array<string>;
726
+ /**
727
+ * The session's pull request, if it has one.
728
+ */
729
+ pullRequestUrl?: string | null;
730
+ /**
731
+ * The session.
732
+ */
733
+ sessionId: string;
734
+ /**
735
+ * The session's name.
736
+ */
737
+ sessionName: string;
738
+ /**
739
+ * When the request was made, or the session's last activity.
740
+ */
741
+ since: string;
742
+ /**
743
+ * What is asked, or why the session looks stalled, in at most 240 characters.
744
+ */
745
+ summary: string;
746
+ };
747
+ /**
748
+ * A kind of action or inactivity the user should see: `permission` to run a tool, an
749
+ * `elicitation` question or form, a `tool_approval` held for the owner, or `stalled` with no
750
+ * activity for over 20 minutes.
751
+ */
752
+ export type AgentUpdateKind = 'permission' | 'elicitation' | 'tool_approval' | 'stalled';
753
+ /**
754
+ * Bounded results; truncation means older qualifying sessions were not folded.
755
+ */
756
+ export type AgentUpdates = {
757
+ /**
758
+ * One entry per pending request or stalled session, newest session activity first.
759
+ */
760
+ items: Array<AgentUpdate>;
761
+ /**
762
+ * Whether qualifying sessions beyond the 25 most recent were left out.
763
+ */
764
+ truncated: boolean;
765
+ /**
766
+ * Says what was left out, when truncated.
767
+ */
768
+ truncationNotice?: string | null;
769
+ };
706
770
  /**
707
771
  * Public admission error payload. Handlers with additional fields can reuse the
708
772
  * domain error's code and message and [`admission_status`].
@@ -1040,6 +1104,106 @@ export type ClassifyInputResponse = {
1040
1104
  */
1041
1105
  scores: Array<IntentScore>;
1042
1106
  };
1107
+ /**
1108
+ * A computer's active Claude sign-in. Claude's long-lived credential names
1109
+ * no account, so there is no email or plan to show.
1110
+ */
1111
+ export type ClaudeAccountStatus = {
1112
+ /**
1113
+ * When the credential stops working, as the computer last reported it.
1114
+ */
1115
+ expiresAt?: string | null;
1116
+ /**
1117
+ * When it was signed in.
1118
+ */
1119
+ signedInAt: string;
1120
+ /**
1121
+ * Who signed it in through Macro; absent once that user is deleted or
1122
+ * when it was signed in on the computer itself.
1123
+ */
1124
+ signedInBy?: string | null;
1125
+ };
1126
+ /**
1127
+ * How Claude Code on a Macro computer is paid for: its own Claude account
1128
+ * when it has an active Claude login, otherwise Macro credits.
1129
+ */
1130
+ export type ClaudeMode = 'macro_credits' | 'own_account';
1131
+ /**
1132
+ * How Claude Code on a computer is paid for, and its Claude sign-in when it
1133
+ * uses its own.
1134
+ */
1135
+ export type ClaudeModeResponse = {
1136
+ account?: null | ClaudeAccountStatus;
1137
+ /**
1138
+ * How Claude Code is paid for.
1139
+ */
1140
+ mode: ClaudeMode;
1141
+ };
1142
+ /**
1143
+ * `POST /harnesses/{harness_id}/claude-sign-in/complete` body.
1144
+ */
1145
+ export type ClaudeSignInComplete = {
1146
+ /**
1147
+ * The code Claude showed after the user signed in.
1148
+ */
1149
+ code: string;
1150
+ };
1151
+ /**
1152
+ * `POST /harnesses/{harness_id}/claude-sign-in` answer.
1153
+ */
1154
+ export type ClaudeSignInStarted = {
1155
+ /**
1156
+ * Where the user signs in to Claude, in their own browser.
1157
+ */
1158
+ url: string;
1159
+ };
1160
+ /**
1161
+ * `POST /harnesses/{harness_id}/claude-sign-in/complete` answer.
1162
+ */
1163
+ export type ClaudeSignedIn = {
1164
+ /**
1165
+ * Always `true`.
1166
+ */
1167
+ signedIn: boolean;
1168
+ };
1169
+ /**
1170
+ * Information used to choose a coding persona for a task.
1171
+ */
1172
+ export type CodingAgent = {
1173
+ /**
1174
+ * What the persona is intended to do.
1175
+ */
1176
+ description?: string | null;
1177
+ /**
1178
+ * Runtime configured for the persona.
1179
+ */
1180
+ harness: string;
1181
+ /**
1182
+ * Persona id to pass to dispatch.
1183
+ */
1184
+ id: string;
1185
+ /**
1186
+ * Saved guidance describing the persona's repositories and specialties.
1187
+ */
1188
+ instructions: string;
1189
+ /**
1190
+ * Persona's configured default model, absent when the provider chooses it.
1191
+ */
1192
+ model?: string | null;
1193
+ /**
1194
+ * User-facing persona name.
1195
+ */
1196
+ name: string;
1197
+ };
1198
+ /**
1199
+ * The coding agents the caller can start a session as right now.
1200
+ */
1201
+ export type CodingAgentsResponse = {
1202
+ /**
1203
+ * Available coding personas, built-in ones such as Cursor first.
1204
+ */
1205
+ agents: Array<CodingAgent>;
1206
+ };
1043
1207
  /**
1044
1208
  * Request or response body for the caller's coding preferences.
1045
1209
  */
@@ -1208,6 +1372,12 @@ export type ConnectorTool = {
1208
1372
  */
1209
1373
  export type ControlRequest = AgentAction & {
1210
1374
  actionId?: null | AgentActionId;
1375
+ /**
1376
+ * The app tab the person typed this in (a UUID the tab keeps for its
1377
+ * lifetime), so what the turn opens in the app reaches that tab only.
1378
+ * Only a person's own request may send it; a runtime's is refused.
1379
+ */
1380
+ clientId?: string | null;
1211
1381
  /**
1212
1382
  * Why the agent is being asked. Only a runtime forwarding a triggered
1213
1383
  * prompt may send it; a user's request carrying it is refused.
@@ -1305,9 +1475,11 @@ export type CreateAgentSessionRequest = {
1305
1475
  */
1306
1476
  owner?: string | null;
1307
1477
  /**
1308
- * First prompt to deliver once the session is running. Managed sessions
1309
- * only - an external runtime sends its own first prompt through the
1310
- * control endpoint. Omitted, the session opens idle.
1478
+ * First prompt to deliver once the session is running. The managed shape
1479
+ * only: a persona its operator runs gets it through the session's control
1480
+ * path once its runtime opens the session, while a runtime opening its
1481
+ * own (the `workspace` shape) sends its first prompt through the control
1482
+ * endpoint. Omitted, the session opens idle.
1311
1483
  */
1312
1484
  prompt?: string | null;
1313
1485
  promptActionId?: null | AgentActionId;
@@ -1316,6 +1488,14 @@ export type CreateAgentSessionRequest = {
1316
1488
  * Requires `prompt`.
1317
1489
  */
1318
1490
  promptAttachments?: Array<PromptAttachment>;
1491
+ /**
1492
+ * The app tab the person typed `prompt` in, as `clientId` on a control
1493
+ * request, so what the first turn opens in the app reaches that tab
1494
+ * only. Requires `prompt`. Only a person's own request may send it; a
1495
+ * runtime's is refused, and a program using a person's credential has
1496
+ * it dropped.
1497
+ */
1498
+ promptClientId?: string | null;
1319
1499
  /**
1320
1500
  * Starting branch for a managed coding session's selected repository.
1321
1501
  * Omitted, the session starts on the repository's default branch.
@@ -1392,6 +1572,22 @@ export type CreateSessionThread = {
1392
1572
  */
1393
1573
  threadId?: string | null;
1394
1574
  };
1575
+ /**
1576
+ * Error body for a provider that refused the caller's connected credential.
1577
+ *
1578
+ * JSON rather than the plain text other failures answer with, so a client
1579
+ * can tell this 409 from a disconnected runtime and show `message` as is.
1580
+ */
1581
+ export type CredentialRejectedResponse = {
1582
+ /**
1583
+ * Always [`Self::CODE`].
1584
+ */
1585
+ code: string;
1586
+ /**
1587
+ * What to tell the caller, e.g. which kind of key to reconnect with.
1588
+ */
1589
+ message: string;
1590
+ };
1395
1591
  /**
1396
1592
  * Surface of a review decision.
1397
1593
  */
@@ -1599,7 +1795,17 @@ export type EmailSuggestions = {
1599
1795
  /**
1600
1796
  * The type of an entity in Macro
1601
1797
  */
1602
- 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';
1798
+ 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';
1799
+ /**
1800
+ * A plain old json error response for use with axum.
1801
+ * yup, thats it.
1802
+ */
1803
+ export type ErrorResponse = {
1804
+ /**
1805
+ * Message to explain failure
1806
+ */
1807
+ message: string;
1808
+ };
1603
1809
  /**
1604
1810
  * A bounded SDK operation observed during execution; not an authorization or write receipt.
1605
1811
  */
@@ -1850,6 +2056,32 @@ export type Lineage = {
1850
2056
  * Defines who can access an item through its share link.
1851
2057
  */
1852
2058
  export type LinkShare = 'PUBLIC' | 'TEAM';
2059
+ /**
2060
+ * The task to link a session to.
2061
+ */
2062
+ export type LinkTaskRequest = {
2063
+ /**
2064
+ * The task document's id.
2065
+ */
2066
+ taskId: string;
2067
+ };
2068
+ /**
2069
+ * The task a session is now linked to.
2070
+ */
2071
+ export type LinkedTaskResponse = {
2072
+ /**
2073
+ * The session's pull request, now linked to the task, if it has one.
2074
+ */
2075
+ pullRequestUrl?: string | null;
2076
+ /**
2077
+ * Put this in the pull request description so GitHub activity reaches the task.
2078
+ */
2079
+ reference: string;
2080
+ /**
2081
+ * The task document's id.
2082
+ */
2083
+ taskId: string;
2084
+ };
1853
2085
  /**
1854
2086
  * HTTP request selecting one provider to probe.
1855
2087
  */
@@ -1867,6 +2099,11 @@ export type LoadAgentModelsRequest = {
1867
2099
  * Successful model-discovery response.
1868
2100
  */
1869
2101
  export type LoadAgentModelsResponse = {
2102
+ /**
2103
+ * When a paired runtime that is off or unreachable last reported this
2104
+ * catalog; null when it was probed live.
2105
+ */
2106
+ cachedAt?: string | null;
1870
2107
  /**
1871
2108
  * Current provider model, if model selection is available.
1872
2109
  */
@@ -1990,6 +2227,25 @@ export type NoteSuggestions = {
1990
2227
  */
1991
2228
  title?: string | null;
1992
2229
  };
2230
+ /**
2231
+ * Open an item in the prompting person's app tab.
2232
+ */
2233
+ export type OpenInApp = {
2234
+ /**
2235
+ * The running execution asking; it must belong to the session's
2236
+ * current turn.
2237
+ */
2238
+ executionId: ExecutionId;
2239
+ /**
2240
+ * An app path, such as `/md/<id>` or `/channels/<id>?s0.channels.messageId=<id>`:
2241
+ * what follows `/app` in a Macro link. Never an origin.
2242
+ */
2243
+ path: string;
2244
+ /**
2245
+ * Where to put it; beside the agent by default.
2246
+ */
2247
+ placement?: UiPlacement;
2248
+ };
1993
2249
  /**
1994
2250
  * The decision carried by an [`AgentPermissionAction`].
1995
2251
  */
@@ -2714,6 +2970,32 @@ export type TriggerOrigin = {
2714
2970
  } | {
2715
2971
  origin: 'unknown';
2716
2972
  };
2973
+ /**
2974
+ * What happened to a command.
2975
+ */
2976
+ export type UiCommandOutcome = {
2977
+ /**
2978
+ * The command's id, as the tab sees it.
2979
+ */
2980
+ commandId: string;
2981
+ status: 'sent';
2982
+ } | {
2983
+ status: 'no_client';
2984
+ } | {
2985
+ /**
2986
+ * Why.
2987
+ */
2988
+ reason: UiDeclineReason;
2989
+ status: 'declined';
2990
+ };
2991
+ /**
2992
+ * Why a command was not sent.
2993
+ */
2994
+ export type UiDeclineReason = 'turned_off' | 'not_allowed_route' | 'rate_limited';
2995
+ /**
2996
+ * Where the opened item goes. Neither replaces what the person is reading.
2997
+ */
2998
+ export type UiPlacement = 'beside-agent' | 'new';
2717
2999
  export type UpdateChannelSharePermission = {
2718
3000
  accessLevel?: null | AccessLevel;
2719
3001
  /**
@@ -2736,6 +3018,31 @@ export type UpdateSharePermissionRequestV2 = {
2736
3018
  linkShareAccessLevel?: null | AccessLevel;
2737
3019
  teamShareAccessLevel?: null | AccessLevel;
2738
3020
  };
3021
+ /**
3022
+ * One voice of the provider's catalog.
3023
+ */
3024
+ export type Voice = {
3025
+ /**
3026
+ * The provider's accent label.
3027
+ */
3028
+ accent: string;
3029
+ /**
3030
+ * Languages the voice speaks.
3031
+ */
3032
+ languages: Array<string>;
3033
+ /**
3034
+ * The model to save as the agent's voice.
3035
+ */
3036
+ model: string;
3037
+ /**
3038
+ * The provider's name for the voice.
3039
+ */
3040
+ name: string;
3041
+ /**
3042
+ * The provider's gender and character tags.
3043
+ */
3044
+ tags: Array<string>;
3045
+ };
2739
3046
  /**
2740
3047
  * A client-minted id deduplicates warm calls without creating a conversation.
2741
3048
  */
@@ -2837,9 +3144,9 @@ export type DiscoverAgentCapabilitiesHandlerErrors = {
2837
3144
  */
2838
3145
  403: unknown;
2839
3146
  /**
2840
- * Macrod runtime or Cursor account is not connected
3147
+ * Macrod machine or Cursor account is not connected (plain text), or the provider refused the connected credential (JSON)
2841
3148
  */
2842
- 409: unknown;
3149
+ 409: CredentialRejectedResponse;
2843
3150
  /**
2844
3151
  * Provider probe failed
2845
3152
  */
@@ -2849,6 +3156,7 @@ export type DiscoverAgentCapabilitiesHandlerErrors = {
2849
3156
  */
2850
3157
  504: unknown;
2851
3158
  };
3159
+ export type DiscoverAgentCapabilitiesHandlerError = DiscoverAgentCapabilitiesHandlerErrors[keyof DiscoverAgentCapabilitiesHandlerErrors];
2852
3160
  export type DiscoverAgentCapabilitiesHandlerResponses = {
2853
3161
  /**
2854
3162
  * Fresh provider session capabilities
@@ -3032,9 +3340,9 @@ export type LoadAgentModelsHandlerErrors = {
3032
3340
  */
3033
3341
  403: unknown;
3034
3342
  /**
3035
- * Macrod runtime or Cursor account is not connected
3343
+ * Macrod machine or Cursor account is not connected (plain text), or the provider refused the connected credential (JSON)
3036
3344
  */
3037
- 409: unknown;
3345
+ 409: CredentialRejectedResponse;
3038
3346
  /**
3039
3347
  * Provider probe failed
3040
3348
  */
@@ -3044,6 +3352,7 @@ export type LoadAgentModelsHandlerErrors = {
3044
3352
  */
3045
3353
  504: unknown;
3046
3354
  };
3355
+ export type LoadAgentModelsHandlerError = LoadAgentModelsHandlerErrors[keyof LoadAgentModelsHandlerErrors];
3047
3356
  export type LoadAgentModelsHandlerResponses = {
3048
3357
  /**
3049
3358
  * Fresh provider model catalog
@@ -3217,6 +3526,21 @@ export type PreviewAgentSessionsResponses = {
3217
3526
  200: PreviewAgentSessionsResponse;
3218
3527
  };
3219
3528
  export type PreviewAgentSessionsResponse2 = PreviewAgentSessionsResponses[keyof PreviewAgentSessionsResponses];
3529
+ export type ListAgentSessionUpdatesData = {
3530
+ body?: never;
3531
+ path?: never;
3532
+ query?: never;
3533
+ url: '/agent-sessions/updates';
3534
+ };
3535
+ export type ListAgentSessionUpdatesErrors = {
3536
+ 401: string;
3537
+ 500: string;
3538
+ };
3539
+ export type ListAgentSessionUpdatesError = ListAgentSessionUpdatesErrors[keyof ListAgentSessionUpdatesErrors];
3540
+ export type ListAgentSessionUpdatesResponses = {
3541
+ 200: AgentUpdates;
3542
+ };
3543
+ export type ListAgentSessionUpdatesResponse = ListAgentSessionUpdatesResponses[keyof ListAgentSessionUpdatesResponses];
3220
3544
  export type WarmAgentSessionHandlerData = {
3221
3545
  body: WarmAgentSessionRequest;
3222
3546
  path?: never;
@@ -4034,6 +4358,29 @@ export type PutAgentSessionSandboxSizeResponses = {
4034
4358
  200: SandboxSizeBody;
4035
4359
  };
4036
4360
  export type PutAgentSessionSandboxSizeResponse = PutAgentSessionSandboxSizeResponses[keyof PutAgentSessionSandboxSizeResponses];
4361
+ export type LinkAgentSessionTaskData = {
4362
+ body: LinkTaskRequest;
4363
+ path: {
4364
+ /**
4365
+ * ID of the agent session
4366
+ */
4367
+ session_id: string;
4368
+ };
4369
+ query?: never;
4370
+ url: '/agent-sessions/{session_id}/task';
4371
+ };
4372
+ export type LinkAgentSessionTaskErrors = {
4373
+ 400: string;
4374
+ 401: string;
4375
+ 403: string;
4376
+ 404: string;
4377
+ 500: string;
4378
+ };
4379
+ export type LinkAgentSessionTaskError = LinkAgentSessionTaskErrors[keyof LinkAgentSessionTaskErrors];
4380
+ export type LinkAgentSessionTaskResponses = {
4381
+ 200: LinkedTaskResponse;
4382
+ };
4383
+ export type LinkAgentSessionTaskResponse = LinkAgentSessionTaskResponses[keyof LinkAgentSessionTaskResponses];
4037
4384
  export type AnswerAgentSessionToolApprovalData = {
4038
4385
  body: AnswerToolApprovalRequest;
4039
4386
  path: {
@@ -4052,7 +4399,7 @@ export type AnswerAgentSessionToolApprovalData = {
4052
4399
  export type AnswerAgentSessionToolApprovalErrors = {
4053
4400
  401: string;
4054
4401
  /**
4055
- * Not the owner, for approve or deny; or no edit access
4402
+ * Agent run approving, not the owner for approve or deny, or no edit access
4056
4403
  */
4057
4404
  403: string;
4058
4405
  404: string;
@@ -4071,6 +4418,22 @@ export type AnswerAgentSessionToolApprovalResponses = {
4071
4418
  200: AnswerToolApprovalResponse;
4072
4419
  };
4073
4420
  export type AnswerAgentSessionToolApprovalResponse = AnswerAgentSessionToolApprovalResponses[keyof AnswerAgentSessionToolApprovalResponses];
4421
+ export type OpenInAppData = {
4422
+ body: OpenInApp;
4423
+ path: {
4424
+ session_id: string;
4425
+ };
4426
+ query?: never;
4427
+ url: '/agent-sessions/{session_id}/ui-commands';
4428
+ };
4429
+ export type OpenInAppErrors = {
4430
+ 400: unknown;
4431
+ 403: unknown;
4432
+ };
4433
+ export type OpenInAppResponses = {
4434
+ 200: UiCommandOutcome;
4435
+ };
4436
+ export type OpenInAppResponse = OpenInAppResponses[keyof OpenInAppResponses];
4074
4437
  export type PresentSessionViewData = {
4075
4438
  body: PresentView;
4076
4439
  path: {
@@ -4147,6 +4510,120 @@ export type ListAgentWorkRegistrationsResponses = {
4147
4510
  200: Array<WorkRegistrationResponse>;
4148
4511
  };
4149
4512
  export type ListAgentWorkRegistrationsResponse = ListAgentWorkRegistrationsResponses[keyof ListAgentWorkRegistrationsResponses];
4513
+ export type ListCodingAgentsData = {
4514
+ body?: never;
4515
+ path?: never;
4516
+ query?: never;
4517
+ url: '/coding-agents';
4518
+ };
4519
+ export type ListCodingAgentsErrors = {
4520
+ /**
4521
+ * Unauthenticated
4522
+ */
4523
+ 401: unknown;
4524
+ /**
4525
+ * The personas or their runtime connections could not be read
4526
+ */
4527
+ 500: unknown;
4528
+ };
4529
+ export type ListCodingAgentsResponses = {
4530
+ /**
4531
+ * The caller's available coding agents
4532
+ */
4533
+ 200: CodingAgentsResponse;
4534
+ };
4535
+ export type ListCodingAgentsResponse = ListCodingAgentsResponses[keyof ListCodingAgentsResponses];
4536
+ export type GetClaudeModeData = {
4537
+ body?: never;
4538
+ path: {
4539
+ /**
4540
+ * Harness ID
4541
+ */
4542
+ harness_id: string;
4543
+ };
4544
+ query?: never;
4545
+ url: '/harnesses/{harness_id}/claude-mode';
4546
+ };
4547
+ export type GetClaudeModeErrors = {
4548
+ 403: unknown;
4549
+ 404: unknown;
4550
+ 503: unknown;
4551
+ };
4552
+ export type GetClaudeModeResponses = {
4553
+ 200: ClaudeModeResponse;
4554
+ };
4555
+ export type GetClaudeModeResponse = GetClaudeModeResponses[keyof GetClaudeModeResponses];
4556
+ export type StartClaudeSignInData = {
4557
+ body?: never;
4558
+ path: {
4559
+ /**
4560
+ * Harness ID
4561
+ */
4562
+ harness_id: string;
4563
+ };
4564
+ query?: never;
4565
+ url: '/harnesses/{harness_id}/claude-sign-in';
4566
+ };
4567
+ export type StartClaudeSignInErrors = {
4568
+ 400: unknown;
4569
+ 403: unknown;
4570
+ 404: unknown;
4571
+ 409: unknown;
4572
+ 422: unknown;
4573
+ 503: unknown;
4574
+ 504: unknown;
4575
+ };
4576
+ export type StartClaudeSignInResponses = {
4577
+ 200: ClaudeSignInStarted;
4578
+ };
4579
+ export type StartClaudeSignInResponse = StartClaudeSignInResponses[keyof StartClaudeSignInResponses];
4580
+ export type CompleteClaudeSignInData = {
4581
+ body: ClaudeSignInComplete;
4582
+ path: {
4583
+ /**
4584
+ * Harness ID
4585
+ */
4586
+ harness_id: string;
4587
+ };
4588
+ query?: never;
4589
+ url: '/harnesses/{harness_id}/claude-sign-in/complete';
4590
+ };
4591
+ export type CompleteClaudeSignInErrors = {
4592
+ 400: unknown;
4593
+ 403: unknown;
4594
+ 404: unknown;
4595
+ 409: unknown;
4596
+ 422: unknown;
4597
+ 503: unknown;
4598
+ 504: unknown;
4599
+ };
4600
+ export type CompleteClaudeSignInResponses = {
4601
+ 200: ClaudeSignedIn;
4602
+ };
4603
+ export type CompleteClaudeSignInResponse = CompleteClaudeSignInResponses[keyof CompleteClaudeSignInResponses];
4604
+ export type ClaudeSignOutData = {
4605
+ body?: never;
4606
+ path: {
4607
+ /**
4608
+ * Harness ID
4609
+ */
4610
+ harness_id: string;
4611
+ };
4612
+ query?: never;
4613
+ url: '/harnesses/{harness_id}/claude-sign-out';
4614
+ };
4615
+ export type ClaudeSignOutErrors = {
4616
+ 403: unknown;
4617
+ 404: unknown;
4618
+ 409: unknown;
4619
+ 422: unknown;
4620
+ 503: unknown;
4621
+ 504: unknown;
4622
+ };
4623
+ export type ClaudeSignOutResponses = {
4624
+ 200: ClaudeModeResponse;
4625
+ };
4626
+ export type ClaudeSignOutResponse = ClaudeSignOutResponses[keyof ClaudeSignOutResponses];
4150
4627
  export type ClassifyData = {
4151
4628
  body: ClassifyInputRequest;
4152
4629
  path?: never;
@@ -4203,3 +4680,44 @@ export type ExtractResponses = {
4203
4680
  200: ExtractInputResponse;
4204
4681
  };
4205
4682
  export type ExtractResponse = ExtractResponses[keyof ExtractResponses];
4683
+ export type GetAgentVoicesData = {
4684
+ body?: never;
4685
+ path?: never;
4686
+ query?: never;
4687
+ url: '/voices';
4688
+ };
4689
+ export type GetAgentVoicesErrors = {
4690
+ 401: ErrorResponse;
4691
+ 403: ErrorResponse;
4692
+ 502: ErrorResponse;
4693
+ };
4694
+ export type GetAgentVoicesError = GetAgentVoicesErrors[keyof GetAgentVoicesErrors];
4695
+ export type GetAgentVoicesResponses = {
4696
+ 200: Array<Voice>;
4697
+ };
4698
+ export type GetAgentVoicesResponse = GetAgentVoicesResponses[keyof GetAgentVoicesResponses];
4699
+ export type GetAgentVoiceSampleData = {
4700
+ body?: never;
4701
+ path: {
4702
+ /**
4703
+ * An Aura-2 model, such as aura-2-thalia-en
4704
+ */
4705
+ model: string;
4706
+ };
4707
+ query?: never;
4708
+ url: '/voices/{model}/sample';
4709
+ };
4710
+ export type GetAgentVoiceSampleErrors = {
4711
+ 400: ErrorResponse;
4712
+ 401: ErrorResponse;
4713
+ 403: ErrorResponse;
4714
+ 502: ErrorResponse;
4715
+ };
4716
+ export type GetAgentVoiceSampleError = GetAgentVoiceSampleErrors[keyof GetAgentVoiceSampleErrors];
4717
+ export type GetAgentVoiceSampleResponses = {
4718
+ /**
4719
+ * WAV audio
4720
+ */
4721
+ 200: Array<number>;
4722
+ };
4723
+ export type GetAgentVoiceSampleResponse = GetAgentVoiceSampleResponses[keyof GetAgentVoiceSampleResponses];