@macro-inc/sdk 0.4.0 → 0.5.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 (193) hide show
  1. package/CALLS.md +82 -0
  2. package/README.md +176 -7
  3. package/dist/chunk-2IVGAIGQ.js +80 -0
  4. package/dist/{chunk-PTX2RV2N.js → chunk-3SW6QVDV.js} +33 -0
  5. package/dist/{chunk-XFA7NCJ5.js → chunk-GT5EUYOR.js} +13 -15
  6. package/dist/{chunk-ZLBDES7U.js → chunk-HIW6KU2I.js} +490 -4
  7. package/dist/{chunk-AZJUIUIV.js → chunk-J2VK3NOR.js} +56 -0
  8. package/dist/{chunk-PZPTJI6F.js → chunk-UVJLWLSJ.js} +41 -2
  9. package/dist/generated/agent-fold/index.d.ts +8 -6
  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 +17 -1
  13. package/dist/generated/agent-harness/types.gen.d.ts +188 -3
  14. package/dist/generated/auth/index.js +1 -1
  15. package/dist/generated/auth/sdk.gen.d.ts +13 -15
  16. package/dist/generated/auth/types.gen.d.ts +36 -17
  17. package/dist/generated/cognition/index.d.ts +1 -1
  18. package/dist/generated/cognition/index.js +1 -1
  19. package/dist/generated/cognition/sdk.gen.d.ts +38 -1
  20. package/dist/generated/cognition/types.gen.d.ts +473 -4
  21. package/dist/generated/connection/types.gen.d.ts +1 -1
  22. package/dist/generated/notification/index.d.ts +1 -1
  23. package/dist/generated/notification/types.gen.d.ts +36 -1
  24. package/dist/generated/scheduled-action/index.d.ts +1 -1
  25. package/dist/generated/scheduled-action/index.js +1 -1
  26. package/dist/generated/scheduled-action/sdk.gen.d.ts +17 -2
  27. package/dist/generated/scheduled-action/types.gen.d.ts +642 -104
  28. package/dist/generated/storage/index.d.ts +1 -1
  29. package/dist/generated/storage/index.js +1 -1
  30. package/dist/generated/storage/sdk.gen.d.ts +204 -5
  31. package/dist/generated/storage/types.gen.d.ts +3969 -374
  32. package/dist/src/calls/browser.d.ts +14 -0
  33. package/dist/src/calls/browser.js +102 -0
  34. package/dist/src/calls/common.d.ts +18 -0
  35. package/dist/src/calls/node.d.ts +24 -0
  36. package/dist/src/calls/node.js +145 -0
  37. package/dist/src/calls/telemetry.d.ts +5 -0
  38. package/dist/src/entities/account-managers/grant.d.ts +28 -5
  39. package/dist/src/entities/account-managers/namespace.d.ts +15 -3
  40. package/dist/src/entities/activity/entity.d.ts +7 -0
  41. package/dist/src/entities/activity/namespace.d.ts +58 -0
  42. package/dist/src/entities/activity/namespace.test.d.ts +1 -0
  43. package/dist/src/entities/agent-sessions/activity.d.ts +10 -2
  44. package/dist/src/entities/agent-sessions/agent-session.d.ts +193 -18
  45. package/dist/src/entities/agent-sessions/code-execution.d.ts +15 -3
  46. package/dist/src/entities/agent-sessions/conversation.d.ts +46 -9
  47. package/dist/src/entities/agent-sessions/namespace.d.ts +71 -16
  48. package/dist/src/entities/agent-sessions/origin.d.ts +1 -1
  49. package/dist/src/entities/agent-sessions/queued-action.d.ts +17 -3
  50. package/dist/src/entities/agent-sessions/review.d.ts +55 -4
  51. package/dist/src/entities/agent-sessions/tool-approval.d.ts +5 -1
  52. package/dist/src/entities/agents/agent.d.ts +98 -3
  53. package/dist/src/entities/agents/namespace.d.ts +52 -8
  54. package/dist/src/entities/ai/namespace.d.ts +9 -1
  55. package/dist/src/entities/api-keys/api-key.d.ts +6 -1
  56. package/dist/src/entities/api-keys/namespace.d.ts +15 -3
  57. package/dist/src/entities/bots/bot.d.ts +38 -6
  58. package/dist/src/entities/bots/namespace.d.ts +13 -1
  59. package/dist/src/entities/bots/token.d.ts +6 -1
  60. package/dist/src/entities/calendar/booking-link.d.ts +7 -1
  61. package/dist/src/entities/calendar/booking-namespace.d.ts +13 -0
  62. package/dist/src/entities/calendar/booking.d.ts +15 -0
  63. package/dist/src/entities/calendar/calendar.d.ts +7 -1
  64. package/dist/src/entities/calendar/event.d.ts +59 -9
  65. package/dist/src/entities/calendar/namespace.d.ts +88 -10
  66. package/dist/src/entities/calendar/replacement.d.ts +19 -3
  67. package/dist/src/entities/calls/call-record.d.ts +90 -14
  68. package/dist/src/entities/calls/connection.d.ts +7 -1
  69. package/dist/src/entities/calls/message.d.ts +27 -5
  70. package/dist/src/entities/calls/namespace.d.ts +15 -3
  71. package/dist/src/entities/canvases/canvas.d.ts +324 -0
  72. package/dist/src/entities/channels/access-request.d.ts +10 -2
  73. package/dist/src/entities/channels/activity.d.ts +20 -4
  74. package/dist/src/entities/channels/channel.d.ts +130 -23
  75. package/dist/src/entities/channels/labels.d.ts +41 -7
  76. package/dist/src/entities/channels/message.d.ts +41 -7
  77. package/dist/src/entities/channels/namespace.d.ts +28 -3
  78. package/dist/src/entities/channels/post.test.d.ts +1 -0
  79. package/dist/src/entities/channels/thread.d.ts +19 -3
  80. package/dist/src/entities/chats/chat.d.ts +56 -6
  81. package/dist/src/entities/chats/generation.d.ts +11 -2
  82. package/dist/src/entities/chats/namespace.d.ts +10 -2
  83. package/dist/src/entities/connected-apps/connected-app.d.ts +14 -1
  84. package/dist/src/entities/connected-apps/connector.d.ts +3 -0
  85. package/dist/src/entities/connected-apps/namespace.d.ts +16 -0
  86. package/dist/src/entities/crm/company.d.ts +63 -15
  87. package/dist/src/entities/crm/contact.d.ts +60 -13
  88. package/dist/src/entities/crm/namespace.d.ts +85 -11
  89. package/dist/src/entities/crm/pipeline-entry.d.ts +102 -0
  90. package/dist/src/entities/crm/pipeline.d.ts +271 -27
  91. package/dist/src/entities/crm/pipelines.d.ts +39 -2
  92. package/dist/src/entities/databases/column.d.ts +54 -7
  93. package/dist/src/entities/databases/database.d.ts +126 -12
  94. package/dist/src/entities/databases/namespace.d.ts +16 -4
  95. package/dist/src/entities/databases/row.d.ts +2 -0
  96. package/dist/src/entities/databases/saved-query.d.ts +145 -0
  97. package/dist/src/entities/databases/table.d.ts +64 -10
  98. package/dist/src/entities/databases/view.d.ts +27 -5
  99. package/dist/src/entities/databases/webhook.d.ts +8 -1
  100. package/dist/src/entities/documents/ai-edit.d.ts +2 -0
  101. package/dist/src/entities/documents/anchor.d.ts +12 -2
  102. package/dist/src/entities/documents/comment.d.ts +29 -5
  103. package/dist/src/entities/documents/document.d.ts +243 -20
  104. package/dist/src/entities/documents/markdown.d.ts +25 -0
  105. package/dist/src/entities/documents/namespace.d.ts +132 -13
  106. package/dist/src/entities/documents/skills.test.d.ts +1 -0
  107. package/dist/src/entities/documents/system-skill.d.ts +21 -1
  108. package/dist/src/entities/documents/text-comment.d.ts +41 -0
  109. package/dist/src/entities/documents/text-comment.test.d.ts +1 -0
  110. package/dist/src/entities/documents/version.d.ts +5 -1
  111. package/dist/src/entities/email/attachment.d.ts +3 -0
  112. package/dist/src/entities/email/draft.d.ts +61 -9
  113. package/dist/src/entities/email/filter.d.ts +12 -2
  114. package/dist/src/entities/email/label.d.ts +7 -1
  115. package/dist/src/entities/email/link.d.ts +5 -1
  116. package/dist/src/entities/email/message.d.ts +55 -8
  117. package/dist/src/entities/email/namespace.d.ts +127 -21
  118. package/dist/src/entities/email/thread.d.ts +99 -16
  119. package/dist/src/entities/entity-mentions/mention.d.ts +6 -1
  120. package/dist/src/entities/entity-mentions/namespace.d.ts +5 -1
  121. package/dist/src/entities/entity.d.ts +56 -6
  122. package/dist/src/entities/external-chat/chat.d.ts +62 -11
  123. package/dist/src/entities/external-chat/message.d.ts +1 -1
  124. package/dist/src/entities/external-chat/namespace.d.ts +5 -1
  125. package/dist/src/entities/external-chat/send.d.ts +10 -2
  126. package/dist/src/entities/favorites/namespace.d.ts +20 -3
  127. package/dist/src/entities/foreign/foreign-entity.d.ts +5 -1
  128. package/dist/src/entities/foreign/namespace.d.ts +4 -0
  129. package/dist/src/entities/forms/form.d.ts +71 -13
  130. package/dist/src/entities/forms/namespace.d.ts +10 -2
  131. package/dist/src/entities/forms/question.d.ts +35 -7
  132. package/dist/src/entities/forms/response.d.ts +25 -5
  133. package/dist/src/entities/forms/section.d.ts +15 -3
  134. package/dist/src/entities/github-pull-requests/namespace.d.ts +5 -1
  135. package/dist/src/entities/github-pull-requests/pull-request.d.ts +15 -3
  136. package/dist/src/entities/harnesses/harness.d.ts +51 -3
  137. package/dist/src/entities/harnesses/namespace.d.ts +53 -7
  138. package/dist/src/entities/harnesses/pairing.d.ts +12 -2
  139. package/dist/src/entities/images/image.d.ts +16 -5
  140. package/dist/src/entities/images/namespace.d.ts +8 -1
  141. package/dist/src/entities/initiatives/initiative.d.ts +117 -3
  142. package/dist/src/entities/initiatives/initiative.test.d.ts +1 -0
  143. package/dist/src/entities/initiatives/namespace.d.ts +69 -7
  144. package/dist/src/entities/me/namespace.d.ts +27 -2
  145. package/dist/src/entities/meetings/meeting.d.ts +45 -8
  146. package/dist/src/entities/meetings/namespace.d.ts +20 -4
  147. package/dist/src/entities/memory/namespace.d.ts +49 -0
  148. package/dist/src/entities/memory/namespace.test.d.ts +1 -0
  149. package/dist/src/entities/messages/discussion.d.ts +84 -0
  150. package/dist/src/entities/messages/thread.d.ts +19 -5
  151. package/dist/src/entities/notifications/namespace.d.ts +40 -7
  152. package/dist/src/entities/notifications/notification.d.ts +29 -5
  153. package/dist/src/entities/pins/namespace.d.ts +23 -4
  154. package/dist/src/entities/projects/namespace.d.ts +29 -0
  155. package/dist/src/entities/projects/project.d.ts +47 -6
  156. package/dist/src/entities/properties/namespace.d.ts +67 -11
  157. package/dist/src/entities/properties/namespace.test.d.ts +1 -0
  158. package/dist/src/entities/properties/property-definition.d.ts +30 -5
  159. package/dist/src/entities/properties/property-option.d.ts +14 -2
  160. package/dist/src/entities/referrals/namespace.d.ts +8 -1
  161. package/dist/src/entities/routines/namespace.d.ts +128 -7
  162. package/dist/src/entities/routines/routine.d.ts +111 -25
  163. package/dist/src/entities/saved-views/namespace.d.ts +57 -0
  164. package/dist/src/entities/saved-views/saved-view.d.ts +78 -0
  165. package/dist/src/entities/search/namespace.d.ts +5 -1
  166. package/dist/src/entities/sharing/access.d.ts +50 -9
  167. package/dist/src/entities/spreadsheets/spreadsheet.d.ts +201 -0
  168. package/dist/src/entities/tasks/namespace.d.ts +13 -1
  169. package/dist/src/entities/tasks/task.d.ts +7 -1
  170. package/dist/src/entities/teams/invite.d.ts +3 -0
  171. package/dist/src/entities/teams/namespace.d.ts +10 -2
  172. package/dist/src/entities/teams/team.d.ts +7 -0
  173. package/dist/src/entities/unfurls/namespace.d.ts +12 -2
  174. package/dist/src/entities/users/namespace.d.ts +19 -1
  175. package/dist/src/entities/users/profile-picture.d.ts +29 -0
  176. package/dist/src/entities/users/profile-picture.test.d.ts +1 -0
  177. package/dist/src/entities/users/user.d.ts +52 -1
  178. package/dist/src/entities/web/namespace.d.ts +6 -0
  179. package/dist/src/entities/webhooks/namespace.d.ts +5 -0
  180. package/dist/src/entities/webhooks/webhook.d.ts +47 -7
  181. package/dist/src/entities/whatsapp/account.d.ts +5 -1
  182. package/dist/src/entities/whatsapp/chat.d.ts +9 -1
  183. package/dist/src/entities/whatsapp/namespace.d.ts +7 -1
  184. package/dist/src/entities/workspace/namespace.d.ts +7 -1
  185. package/dist/src/entities/workspace/query.d.ts +5 -1
  186. package/dist/src/events/hydrate/user.d.ts +14 -0
  187. package/dist/src/events/receiver.d.ts +2 -0
  188. package/dist/src/events/types.d.ts +2 -1
  189. package/dist/src/macro.d.ts +33 -5
  190. package/dist/src/macro.js +15635 -10132
  191. package/dist/src/utils/lazy.d.ts +7 -1
  192. package/package.json +32 -5
  193. 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' | '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
  */
@@ -603,6 +627,13 @@ export type ErrorResponse = {
603
627
  * How long a projection remains active without being requested.
604
628
  */
605
629
  export type Expiry = 'day' | 'week' | 'month';
630
+ /**
631
+ * A private explicit memory document and its optimistic concurrency token.
632
+ */
633
+ export type ExplicitMemory = {
634
+ content: string;
635
+ revision: number;
636
+ };
606
637
  /**
607
638
  * Recorded invocations and total for one feature.
608
639
  */
@@ -763,6 +794,10 @@ export type GetChatsForAttachmentResponse = {
763
794
  all_chats: Array<Chat>;
764
795
  recent_chat?: null | Chat;
765
796
  };
797
+ /**
798
+ * Fixed calendar granularity, always in UTC, with Monday-start weeks.
799
+ */
800
+ export type Granularity = 'day' | 'week' | 'month' | 'summary';
766
801
  /**
767
802
  * HTTP request payload for sending a chat message.
768
803
  * Unlike the WebSocket payload, this does not include stream_id as it's generated server-side.
@@ -987,6 +1022,22 @@ export type LinearIssueMeta = {
987
1022
  */
988
1023
  export type LinkShare = 'PUBLIC' | 'TEAM';
989
1024
  export type MacroUserIdStr = string;
1025
+ /**
1026
+ * An edit to one one-based line. A revision is required to prevent replay
1027
+ * or concurrent edits from inserting twice or deleting a different line.
1028
+ */
1029
+ export type MemoryEdit = {
1030
+ action: 'insert';
1031
+ content: string;
1032
+ line: number;
1033
+ } | {
1034
+ action: 'replace';
1035
+ content: string;
1036
+ line: number;
1037
+ } | {
1038
+ action: 'delete';
1039
+ line: number;
1040
+ };
990
1041
  export type MemoryErrorBody = {
991
1042
  /**
992
1043
  * Error description.
@@ -1599,6 +1650,19 @@ export type ProjectionStateResponse = {
1599
1650
  * The materialization status of a user's projection instance.
1600
1651
  */
1601
1652
  export type ProjectionStatus = 'loading' | 'cold' | 'ready' | 'refreshing' | 'error';
1653
+ /**
1654
+ * Response from [`ReadActivity`].
1655
+ */
1656
+ export type ReadActivityResponse = {
1657
+ /**
1658
+ * Matching activity events, newest first.
1659
+ */
1660
+ activities: Array<ToolActivityEvent>;
1661
+ /**
1662
+ * Whether more than 100 events matched the requested range.
1663
+ */
1664
+ truncated: boolean;
1665
+ };
1602
1666
  /**
1603
1667
  * How frequently an active projection is regenerated.
1604
1668
  */
@@ -1783,6 +1847,79 @@ export type SharePermissionV2 = {
1783
1847
  owner: string;
1784
1848
  teamShareAccessLevel?: null | AccessLevel;
1785
1849
  };
1850
+ /**
1851
+ * A skill's complete instructions.
1852
+ */
1853
+ export type SkillContentResponse = {
1854
+ /**
1855
+ * Whether this is a built-in skill, with no document behind it.
1856
+ */
1857
+ builtIn: boolean;
1858
+ /**
1859
+ * The skill's full markdown instructions.
1860
+ */
1861
+ content: string;
1862
+ /**
1863
+ * The skill's id.
1864
+ */
1865
+ id: string;
1866
+ /**
1867
+ * The skill's name.
1868
+ */
1869
+ name: string;
1870
+ };
1871
+ /**
1872
+ * Machine-readable failure of a skill request.
1873
+ */
1874
+ export type SkillErrorBody = {
1875
+ /**
1876
+ * Stable failure code.
1877
+ */
1878
+ code: string;
1879
+ /**
1880
+ * Explanation without backend diagnostics.
1881
+ */
1882
+ error: string;
1883
+ };
1884
+ /**
1885
+ * One skill the caller can read.
1886
+ */
1887
+ export type SkillListing = {
1888
+ /**
1889
+ * Whether this is a built-in skill, with no document behind it.
1890
+ */
1891
+ builtIn: boolean;
1892
+ /**
1893
+ * When to use the skill, when it says.
1894
+ */
1895
+ description?: string | null;
1896
+ /**
1897
+ * The skill document's id, or a built-in skill's well-known id.
1898
+ */
1899
+ id: string;
1900
+ /**
1901
+ * The skill's name.
1902
+ */
1903
+ name: string;
1904
+ /**
1905
+ * When the skill document was last updated; built-in skills have none.
1906
+ */
1907
+ updatedAt?: string | null;
1908
+ };
1909
+ /**
1910
+ * How search terms are matched against skill names.
1911
+ */
1912
+ export type SkillsMatchType = 'partial' | 'exact';
1913
+ /**
1914
+ * The skills matching a listing or search, most recently updated first,
1915
+ * built-in skills last.
1916
+ */
1917
+ export type SkillsResponse = {
1918
+ /**
1919
+ * The matching skills.
1920
+ */
1921
+ skills: Array<SkillListing>;
1922
+ };
1786
1923
  /**
1787
1924
  * Metadata for one staged Slack channel.
1788
1925
  */
@@ -1942,6 +2079,112 @@ export type StructuredToolActivity = {
1942
2079
  * The kind of entity a projection is materialized for.
1943
2080
  */
1944
2081
  export type TargetType = 'user' | 'team';
2082
+ /**
2083
+ * One activity action returned to the AI.
2084
+ */
2085
+ export type ToolActivityAction = {
2086
+ type: 'created';
2087
+ } | {
2088
+ type: 'edited';
2089
+ } | {
2090
+ type: 'opened';
2091
+ } | {
2092
+ type: 'deleted';
2093
+ } | {
2094
+ type: 'messaged';
2095
+ } | {
2096
+ type: 'sent';
2097
+ } | {
2098
+ type: 'responded';
2099
+ } | {
2100
+ /**
2101
+ * The previous value, when known.
2102
+ */
2103
+ from?: unknown;
2104
+ /**
2105
+ * Previous select/tag option ids resolved to display labels.
2106
+ */
2107
+ from_labels?: Array<string> | null;
2108
+ /**
2109
+ * The property definition id.
2110
+ */
2111
+ property: string;
2112
+ /**
2113
+ * The property definition's human-readable display name, when it is
2114
+ * still visible to the caller.
2115
+ */
2116
+ property_name?: string | null;
2117
+ /**
2118
+ * The property's canonical data type, including `tag` for tag sets.
2119
+ */
2120
+ property_type?: string | null;
2121
+ /**
2122
+ * The new value, or `None` when cleared.
2123
+ */
2124
+ to?: unknown;
2125
+ /**
2126
+ * New select/tag option ids resolved to display labels.
2127
+ */
2128
+ to_labels?: Array<string> | null;
2129
+ type: 'propertyChanged';
2130
+ } | {
2131
+ /**
2132
+ * The added principal.
2133
+ */
2134
+ participant: string;
2135
+ type: 'participantAdded';
2136
+ } | {
2137
+ /**
2138
+ * The removed principal.
2139
+ */
2140
+ participant: string;
2141
+ type: 'participantRemoved';
2142
+ } | {
2143
+ /**
2144
+ * The started call's id.
2145
+ */
2146
+ call_id: string;
2147
+ type: 'callStarted';
2148
+ } | {
2149
+ type: 'taskAdded';
2150
+ } | {
2151
+ type: 'taskRemoved';
2152
+ } | {
2153
+ /**
2154
+ * The stored payload, verbatim.
2155
+ */
2156
+ payload?: unknown;
2157
+ /**
2158
+ * The stored action tag.
2159
+ */
2160
+ tag: string;
2161
+ type: 'unknown';
2162
+ };
2163
+ /**
2164
+ * One activity event returned by [`ReadActivity`].
2165
+ */
2166
+ export type ToolActivityEvent = {
2167
+ /**
2168
+ * What the principal did.
2169
+ */
2170
+ action: ToolActivityAction;
2171
+ /**
2172
+ * The principal that mechanically performed the action.
2173
+ */
2174
+ actorId: string;
2175
+ /**
2176
+ * The entity acted on.
2177
+ */
2178
+ entityId: string;
2179
+ /**
2180
+ * The kind of entity acted on.
2181
+ */
2182
+ entityType: string;
2183
+ /**
2184
+ * When the action occurred.
2185
+ */
2186
+ occurredAt: string;
2187
+ };
1945
2188
  export type ToolOutcome = {
1946
2189
  changes: DatabaseChange;
1947
2190
  status: 'succeeded';
@@ -1969,6 +2212,19 @@ export type UpdateChannelSharePermission = {
1969
2212
  */
1970
2213
  operation: UpdateOperation;
1971
2214
  };
2215
+ /**
2216
+ * One explicit memory edit at the revision it was based on.
2217
+ */
2218
+ export type UpdateExplicitMemoryRequest = {
2219
+ /**
2220
+ * The one-based line edit to apply.
2221
+ */
2222
+ edit: MemoryEdit;
2223
+ /**
2224
+ * The revision returned by the last read or successful edit.
2225
+ */
2226
+ revision: number;
2227
+ };
1972
2228
  export type UpdateOperation = 'add' | 'remove' | 'replace';
1973
2229
  /**
1974
2230
  * Request body for updating an MCP server.
@@ -2314,6 +2570,39 @@ export type WebSearchTopic = 'general' | 'news';
2314
2570
  export type WithChatId = {
2315
2571
  chat_id: string;
2316
2572
  };
2573
+ export type ReadMyActivityData = {
2574
+ body?: never;
2575
+ path?: never;
2576
+ query: {
2577
+ /**
2578
+ * Inclusive start, RFC 3339.
2579
+ */
2580
+ from: string;
2581
+ /**
2582
+ * Exclusive end, RFC 3339; must be after `from`.
2583
+ */
2584
+ to: string;
2585
+ };
2586
+ url: '/activity';
2587
+ };
2588
+ export type ReadMyActivityErrors = {
2589
+ /**
2590
+ * `from` is not before `to`
2591
+ */
2592
+ 400: ActivityErrorBody;
2593
+ /**
2594
+ * Internal server error
2595
+ */
2596
+ 500: ActivityErrorBody;
2597
+ };
2598
+ export type ReadMyActivityError = ReadMyActivityErrors[keyof ReadMyActivityErrors];
2599
+ export type ReadMyActivityResponses = {
2600
+ /**
2601
+ * Activity in the range
2602
+ */
2603
+ 200: ReadActivityResponse;
2604
+ };
2605
+ export type ReadMyActivityResponse = ReadMyActivityResponses[keyof ReadMyActivityResponses];
2317
2606
  export type SetPricingHandlerData = {
2318
2607
  body: SetPricingRequest;
2319
2608
  path?: never;
@@ -3221,6 +3510,99 @@ export type GetMemoryHandlerResponses = {
3221
3510
  200: MemoryResponse;
3222
3511
  };
3223
3512
  export type GetMemoryHandlerResponse = GetMemoryHandlerResponses[keyof GetMemoryHandlerResponses];
3513
+ export type GetUserActivityData = {
3514
+ body?: never;
3515
+ path?: never;
3516
+ query: {
3517
+ /**
3518
+ * A `macro|` user id; omit for the caller.
3519
+ */
3520
+ user?: string;
3521
+ /**
3522
+ * Inclusive first UTC date.
3523
+ */
3524
+ start: string;
3525
+ /**
3526
+ * Inclusive last UTC date, at most 366 days after `start`.
3527
+ */
3528
+ end: string;
3529
+ };
3530
+ url: '/memory/activity';
3531
+ };
3532
+ export type GetUserActivityErrors = {
3533
+ /**
3534
+ * Invalid user id or date range
3535
+ */
3536
+ 400: MemoryErrorBody;
3537
+ /**
3538
+ * The user is not the caller or a current teammate
3539
+ */
3540
+ 403: MemoryErrorBody;
3541
+ /**
3542
+ * Internal server error
3543
+ */
3544
+ 500: MemoryErrorBody;
3545
+ };
3546
+ export type GetUserActivityError = GetUserActivityErrors[keyof GetUserActivityErrors];
3547
+ export type GetUserActivityResponses = {
3548
+ /**
3549
+ * Activity reports in the range
3550
+ */
3551
+ 200: ActivityReports;
3552
+ };
3553
+ export type GetUserActivityResponse = GetUserActivityResponses[keyof GetUserActivityResponses];
3554
+ export type ReadExplicitMemoryData = {
3555
+ body?: never;
3556
+ path?: never;
3557
+ query?: never;
3558
+ url: '/memory/explicit';
3559
+ };
3560
+ export type ReadExplicitMemoryErrors = {
3561
+ /**
3562
+ * Internal server error
3563
+ */
3564
+ 500: MemoryErrorBody;
3565
+ };
3566
+ export type ReadExplicitMemoryError = ReadExplicitMemoryErrors[keyof ReadExplicitMemoryErrors];
3567
+ export type ReadExplicitMemoryResponses = {
3568
+ /**
3569
+ * The caller's explicit memory
3570
+ */
3571
+ 200: ExplicitMemory;
3572
+ };
3573
+ export type ReadExplicitMemoryResponse = ReadExplicitMemoryResponses[keyof ReadExplicitMemoryResponses];
3574
+ export type EditExplicitMemoryData = {
3575
+ body: UpdateExplicitMemoryRequest;
3576
+ path?: never;
3577
+ query?: never;
3578
+ url: '/memory/explicit';
3579
+ };
3580
+ export type EditExplicitMemoryErrors = {
3581
+ /**
3582
+ * Invalid line or content
3583
+ */
3584
+ 400: MemoryErrorBody;
3585
+ /**
3586
+ * The revision is stale
3587
+ */
3588
+ 409: MemoryErrorBody;
3589
+ /**
3590
+ * Rejected by privacy review
3591
+ */
3592
+ 422: MemoryErrorBody;
3593
+ /**
3594
+ * Internal server error
3595
+ */
3596
+ 500: MemoryErrorBody;
3597
+ };
3598
+ export type EditExplicitMemoryError = EditExplicitMemoryErrors[keyof EditExplicitMemoryErrors];
3599
+ export type EditExplicitMemoryResponses = {
3600
+ /**
3601
+ * The edited explicit memory
3602
+ */
3603
+ 200: ExplicitMemory;
3604
+ };
3605
+ export type EditExplicitMemoryResponse = EditExplicitMemoryResponses[keyof EditExplicitMemoryResponses];
3224
3606
  export type GetStateHandler2Data = {
3225
3607
  body?: never;
3226
3608
  path?: never;
@@ -3485,6 +3867,85 @@ export type GetBatchPreviewResponses = {
3485
3867
  200: GetBatchPreviewResponse;
3486
3868
  };
3487
3869
  export type GetBatchPreviewResponse2 = GetBatchPreviewResponses[keyof GetBatchPreviewResponses];
3870
+ export type ListSkillsData = {
3871
+ body?: never;
3872
+ path?: never;
3873
+ query?: {
3874
+ /**
3875
+ * Words from the skill's name, matched as one adjacent phrase. Omit to
3876
+ * list the 100 most recently updated skills.
3877
+ */
3878
+ query?: string;
3879
+ /**
3880
+ * How `query` is matched; `partial` when omitted.
3881
+ */
3882
+ matchType?: SkillsMatchType;
3883
+ };
3884
+ url: '/skills';
3885
+ };
3886
+ export type ListSkillsErrors = {
3887
+ /**
3888
+ * Blank query
3889
+ */
3890
+ 400: SkillErrorBody;
3891
+ /**
3892
+ * Unauthorized
3893
+ */
3894
+ 401: unknown;
3895
+ /**
3896
+ * Listing failed
3897
+ */
3898
+ 500: SkillErrorBody;
3899
+ /**
3900
+ * Search failed
3901
+ */
3902
+ 502: SkillErrorBody;
3903
+ };
3904
+ export type ListSkillsError = ListSkillsErrors[keyof ListSkillsErrors];
3905
+ export type ListSkillsResponses = {
3906
+ /**
3907
+ * Matching skills, most recently updated first
3908
+ */
3909
+ 200: SkillsResponse;
3910
+ };
3911
+ export type ListSkillsResponse = ListSkillsResponses[keyof ListSkillsResponses];
3912
+ export type ReadSkillData = {
3913
+ body?: never;
3914
+ path: {
3915
+ /**
3916
+ * The skill's id
3917
+ */
3918
+ id: string;
3919
+ };
3920
+ query?: never;
3921
+ url: '/skills/{id}';
3922
+ };
3923
+ export type ReadSkillErrors = {
3924
+ /**
3925
+ * Unauthorized
3926
+ */
3927
+ 401: unknown;
3928
+ /**
3929
+ * No skill the caller can view has this id
3930
+ */
3931
+ 404: SkillErrorBody;
3932
+ /**
3933
+ * Reading failed
3934
+ */
3935
+ 500: SkillErrorBody;
3936
+ /**
3937
+ * Access check unavailable
3938
+ */
3939
+ 503: SkillErrorBody;
3940
+ };
3941
+ export type ReadSkillError = ReadSkillErrors[keyof ReadSkillErrors];
3942
+ export type ReadSkillResponses = {
3943
+ /**
3944
+ * The skill's instructions
3945
+ */
3946
+ 200: SkillContentResponse;
3947
+ };
3948
+ export type ReadSkillResponse = ReadSkillResponses[keyof ReadSkillResponses];
3488
3949
  export type SendChatMessageData = {
3489
3950
  body: HttpSendChatMessageRequest;
3490
3951
  path?: never;
@@ -3604,6 +4065,10 @@ export type FetchWebPageErrors = {
3604
4065
  * AI allowance exhausted
3605
4066
  */
3606
4067
  402: WebErrorBody;
4068
+ /**
4069
+ * Web fetch is not configured in this deployment
4070
+ */
4071
+ 404: WebErrorBody;
3607
4072
  /**
3608
4073
  * The page could not be read
3609
4074
  */
@@ -3617,7 +4082,7 @@ export type FetchWebPageErrors = {
3617
4082
  */
3618
4083
  502: WebErrorBody;
3619
4084
  /**
3620
- * Web fetch unconfigured, busy, or usage validation unavailable
4085
+ * Web fetch busy, or usage validation unavailable
3621
4086
  */
3622
4087
  503: WebErrorBody;
3623
4088
  };
@@ -3648,6 +4113,10 @@ export type SearchWebErrors = {
3648
4113
  * AI allowance exhausted
3649
4114
  */
3650
4115
  402: WebErrorBody;
4116
+ /**
4117
+ * Web search is not configured in this deployment
4118
+ */
4119
+ 404: WebErrorBody;
3651
4120
  /**
3652
4121
  * Per-user hourly rate limit exceeded
3653
4122
  */
@@ -3657,7 +4126,7 @@ export type SearchWebErrors = {
3657
4126
  */
3658
4127
  502: WebErrorBody;
3659
4128
  /**
3660
- * Web search unconfigured, busy, or usage validation unavailable
4129
+ * Web search busy, or usage validation unavailable
3661
4130
  */
3662
4131
  503: WebErrorBody;
3663
4132
  };
@@ -35,7 +35,7 @@ export type Entity = {
35
35
  /**
36
36
  * The type of an entity in Macro
37
37
  */
38
- 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';
38
+ 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';
39
39
  export type GenericErrorResponse = {
40
40
  /**
41
41
  * Indicates if an error occurred
@@ -1,2 +1,2 @@
1
1
  export { type Options, Sdk } from './sdk.gen';
2
- export type { AgentSessionMentionedMetadata, AgentSessionNotificationRef, AgentSessionOriginParent, AgentSessionSettledMetadata, AgentSessionWaitingForInputMetadata, AiResponseMetadata, ApiUserNotification, BulkDeleteUserNotificationsV2Data, BulkDeleteUserNotificationsV2Error, BulkDeleteUserNotificationsV2Errors, BulkDeleteUserNotificationsV2Responses, BulkGetByEventItemIdsRequest, BulkGetTypedNotificationsByEventItemIdsData, BulkGetTypedNotificationsByEventItemIdsError, BulkGetTypedNotificationsByEventItemIdsErrors, BulkGetTypedNotificationsByEventItemIdsResponse, BulkGetTypedNotificationsByEventItemIdsResponses, BulkItem, BulkMarkNotificationsDoneData, BulkMarkNotificationsDoneError, BulkMarkNotificationsDoneErrors, BulkMarkNotificationsDoneResponses, BulkMarkNotificationsSeenData, BulkMarkNotificationsSeenError, BulkMarkNotificationsSeenErrors, BulkMarkNotificationsSeenResponses, BulkMarkNotificationsUndoneData, BulkMarkNotificationsUndoneError, BulkMarkNotificationsUndoneErrors, BulkMarkNotificationsUndoneResponses, BulkRemoveItemsRequest, BulkSetItemsRequest, CalendarEventJoinRequestMetadata, CalendarEventReminderMetadata, CallStartedMetadata, ChannelAccessRequestedMetadata, ChannelInviteMetadata, ChannelMentionMetadata, ChannelMessageReactionMetadata, ChannelMessageSendMetadata, ChannelReplyMetadata, ChannelType, ClientOptions, CommentedOnDocumentMetadata, CommentRef, CommonChannelMetadata, ConnGatewayNotificationPayload, CreateNotification, CrmDiscussionMetadata, CrmDiscussionReason, DeleteUserNotificationV2Data, DeleteUserNotificationV2Error, DeleteUserNotificationV2Errors, DeleteUserNotificationV2Responses, DeviceRequest, DeviceType, DisableNotificationTypeData, DisableNotificationTypeError, DisableNotificationTypeErrors, DisableNotificationTypeResponses, DocumentMentionMetadata, EmptyResponse, EnableNotificationTypeData, EnableNotificationTypeError, EnableNotificationTypeErrors, EnableNotificationTypeResponses, Entity, EntityAccessGrantedMetadata, EntityAccessRequestedMetadata, EntityType, ErrorResponse, ExternalChatMessageMetadata, ExternalChatProvider, GetAllUserNotificationsResponse, GetNotificationTypePreferencesData, GetNotificationTypePreferencesError, GetNotificationTypePreferencesErrors, GetNotificationTypePreferencesResponse, GetNotificationTypePreferencesResponse2, GetNotificationTypePreferencesResponses, GetTypedNotificationByIdData, GetTypedNotificationByIdError, GetTypedNotificationByIdErrors, GetTypedNotificationByIdResponse, GetTypedNotificationByIdResponses, GetTypedNotificationsByEventItemIdData, GetTypedNotificationsByEventItemIdError, GetTypedNotificationsByEventItemIdErrors, GetTypedNotificationsByEventItemIdResponse, GetTypedNotificationsByEventItemIdResponses, GetUnsubscribesData, GetUnsubscribesError, GetUnsubscribesErrors, GetUnsubscribesResponse, GetUnsubscribesResponses, GithubPrCheckRun, GithubPrCheckRunState, GithubPrComment, GithubPrCommentKind, GithubPrEventAction, GithubPrEventStatus, GithubPrMention, GithubPrMentionLocation, GithubPrNotificationCommon, GithubPrReview, GithubPrReviewState, GithubPrStatusChanged, GithubReviewRequested, HealthHandlerData, HealthHandlerResponse, HealthHandlerResponses, InboxReauthRequiredMetadata, InitiativeDiscussionMetadata, InitiativeDiscussionReason, InviteePlan, InviteToTeamMetadata, ItemSharedMetadata, ListTypedNotificationsData, ListTypedNotificationsError, ListTypedNotificationsErrors, ListTypedNotificationsResponse, ListTypedNotificationsResponses, MacroUserIdStr, MentionedInDocumentCommentMetadata, NewEmailMetadata, NotifEvent, NotificationBulkRequest, NotificationDocumentSubType, NotificationServiceApiVersion, NotificationState, NotificationTypeName, PushNotificationData, PushNotificationNavigation, RealtimeNotifTaggedContentValue, ReminderMetadata, RemoveUnsubscribeAllData, RemoveUnsubscribeAllError, RemoveUnsubscribeAllErrors, RemoveUnsubscribeAllResponse, RemoveUnsubscribeAllResponses, RemoveUnsubscribeItemData, RemoveUnsubscribeItemError, RemoveUnsubscribeItemErrors, RemoveUnsubscribeItemResponse, RemoveUnsubscribeItemResponses, RemoveUnsubscribeItemsData, RemoveUnsubscribeItemsError, RemoveUnsubscribeItemsErrors, RemoveUnsubscribeItemsResponse, RemoveUnsubscribeItemsResponses, RepliedToDocumentCommentThreadMetadata, RequestedAccessLevel, RoutineRunFinishedMetadata, RoutineRunOutcome, TaskAssignedMetadata, UnsubscribeAllData, UnsubscribeAllError, UnsubscribeAllErrors, UnsubscribeAllResponse, UnsubscribeAllResponses, UnsubscribeEmailData, UnsubscribeEmailError, UnsubscribeEmailErrors, UnsubscribeEmailResponse, UnsubscribeEmailResponses, UnsubscribeItemData, UnsubscribeItemError, UnsubscribeItemErrors, UnsubscribeItemPathParams, UnsubscribeItemResponse, UnsubscribeItemResponses, UnsubscribeItemsData, UnsubscribeItemsError, UnsubscribeItemsErrors, UnsubscribeItemsResponse, UnsubscribeItemsResponses, UserUnsubscribe } from './types.gen';
2
+ export type { AgentSessionMentionedMetadata, AgentSessionNotificationRef, AgentSessionOriginParent, AgentSessionSettledMetadata, AgentSessionWaitingForInputMetadata, AiResponseMetadata, ApiUserNotification, BulkDeleteUserNotificationsV2Data, BulkDeleteUserNotificationsV2Error, BulkDeleteUserNotificationsV2Errors, BulkDeleteUserNotificationsV2Responses, BulkGetByEventItemIdsRequest, BulkGetTypedNotificationsByEventItemIdsData, BulkGetTypedNotificationsByEventItemIdsError, BulkGetTypedNotificationsByEventItemIdsErrors, BulkGetTypedNotificationsByEventItemIdsResponse, BulkGetTypedNotificationsByEventItemIdsResponses, BulkItem, BulkMarkNotificationsDoneData, BulkMarkNotificationsDoneError, BulkMarkNotificationsDoneErrors, BulkMarkNotificationsDoneResponses, BulkMarkNotificationsSeenData, BulkMarkNotificationsSeenError, BulkMarkNotificationsSeenErrors, BulkMarkNotificationsSeenResponses, BulkMarkNotificationsUndoneData, BulkMarkNotificationsUndoneError, BulkMarkNotificationsUndoneErrors, BulkMarkNotificationsUndoneResponses, BulkRemoveItemsRequest, BulkSetItemsRequest, CalendarEventJoinRequestMetadata, CalendarEventReminderMetadata, CallStartedMetadata, ChannelAccessRequestedMetadata, ChannelInviteMetadata, ChannelMentionMetadata, ChannelMessageReactionMetadata, ChannelMessageSendMetadata, ChannelReplyMetadata, ChannelType, ClientOptions, CommentedOnDocumentMetadata, CommentRef, CommonChannelMetadata, ConnGatewayNotificationPayload, CreateNotification, CrmDiscussionMetadata, CrmDiscussionReason, DeleteUserNotificationV2Data, DeleteUserNotificationV2Error, DeleteUserNotificationV2Errors, DeleteUserNotificationV2Responses, DeviceRequest, DeviceType, DisableNotificationTypeData, DisableNotificationTypeError, DisableNotificationTypeErrors, DisableNotificationTypeResponses, DocumentMentionMetadata, EmptyResponse, EnableNotificationTypeData, EnableNotificationTypeError, EnableNotificationTypeErrors, EnableNotificationTypeResponses, Entity, EntityAccessGrantedMetadata, EntityAccessRequestedMetadata, EntityType, ErrorResponse, ExternalChatMessageMetadata, ExternalChatProvider, GetAllUserNotificationsResponse, GetNotificationTypePreferencesData, GetNotificationTypePreferencesError, GetNotificationTypePreferencesErrors, GetNotificationTypePreferencesResponse, GetNotificationTypePreferencesResponse2, GetNotificationTypePreferencesResponses, GetTypedNotificationByIdData, GetTypedNotificationByIdError, GetTypedNotificationByIdErrors, GetTypedNotificationByIdResponse, GetTypedNotificationByIdResponses, GetTypedNotificationsByEventItemIdData, GetTypedNotificationsByEventItemIdError, GetTypedNotificationsByEventItemIdErrors, GetTypedNotificationsByEventItemIdResponse, GetTypedNotificationsByEventItemIdResponses, GetUnsubscribesData, GetUnsubscribesError, GetUnsubscribesErrors, GetUnsubscribesResponse, GetUnsubscribesResponses, GithubPrCheckRun, GithubPrCheckRunState, GithubPrComment, GithubPrCommentKind, GithubPrEventAction, GithubPrEventStatus, GithubPrMention, GithubPrMentionLocation, GithubPrNotificationCommon, GithubPrReview, GithubPrReviewState, GithubPrStatusChanged, GithubReviewRequested, HealthHandlerData, HealthHandlerResponse, HealthHandlerResponses, InboxReauthRequiredMetadata, InitiativeDiscussionMetadata, InitiativeDiscussionReason, InviteePlan, InviteToTeamMetadata, ItemSharedMetadata, ListTypedNotificationsData, ListTypedNotificationsError, ListTypedNotificationsErrors, ListTypedNotificationsResponse, ListTypedNotificationsResponses, MacroUserIdStr, MentionedInDocumentCommentMetadata, NewEmailMetadata, NotifEvent, NotificationBulkRequest, NotificationDocumentSubType, NotificationServiceApiVersion, NotificationState, NotificationTypeName, PushNotificationData, PushNotificationNavigation, RealtimeNotifTaggedContentValue, ReminderMetadata, RemoveUnsubscribeAllData, RemoveUnsubscribeAllError, RemoveUnsubscribeAllErrors, RemoveUnsubscribeAllResponse, RemoveUnsubscribeAllResponses, RemoveUnsubscribeItemData, RemoveUnsubscribeItemError, RemoveUnsubscribeItemErrors, RemoveUnsubscribeItemResponse, RemoveUnsubscribeItemResponses, RemoveUnsubscribeItemsData, RemoveUnsubscribeItemsError, RemoveUnsubscribeItemsErrors, RemoveUnsubscribeItemsResponse, RemoveUnsubscribeItemsResponses, RepliedToDocumentCommentThreadMetadata, RequestedAccessLevel, RoutineRunFinishedMetadata, RoutineRunOutcome, RuntimeAccessRemovedMetadata, StoppedAgent, TaskAssignedMetadata, UnsubscribeAllData, UnsubscribeAllError, UnsubscribeAllErrors, UnsubscribeAllResponse, UnsubscribeAllResponses, UnsubscribeEmailData, UnsubscribeEmailError, UnsubscribeEmailErrors, UnsubscribeEmailResponse, UnsubscribeEmailResponses, UnsubscribeItemData, UnsubscribeItemError, UnsubscribeItemErrors, UnsubscribeItemPathParams, UnsubscribeItemResponse, UnsubscribeItemResponses, UnsubscribeItemsData, UnsubscribeItemsError, UnsubscribeItemsErrors, UnsubscribeItemsResponse, UnsubscribeItemsResponses, UserUnsubscribe } from './types.gen';
@@ -606,7 +606,7 @@ export type EntityAccessRequestedMetadata = {
606
606
  /**
607
607
  * The type of an entity in Macro
608
608
  */
609
- 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';
609
+ 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';
610
610
  /**
611
611
  * A plain old json error response for use with axum.
612
612
  * yup, thats it.
@@ -1266,6 +1266,13 @@ export type NotifEvent = {
1266
1266
  */
1267
1267
  content: RoutineRunFinishedMetadata;
1268
1268
  tag: 'routine_run_finished';
1269
+ } | {
1270
+ /**
1271
+ * A runtime's owner removed the user's access to it, and agents of
1272
+ * theirs living there stopped.
1273
+ */
1274
+ content: RuntimeAccessRemovedMetadata;
1275
+ tag: 'runtime_access_removed';
1269
1276
  };
1270
1277
  /**
1271
1278
  * the notification ids that we are bulk updating
@@ -1477,6 +1484,34 @@ export type RoutineRunFinishedMetadata = {
1477
1484
  * How a routine run ended, as its notification reports it.
1478
1485
  */
1479
1486
  export type RoutineRunOutcome = 'succeeded' | 'failed';
1487
+ /**
1488
+ * A runtime's owner removed the recipient's access to it, or lowered it to
1489
+ * Read, and agents the recipient keeps living there stopped.
1490
+ */
1491
+ export type RuntimeAccessRemovedMetadata = {
1492
+ /**
1493
+ * The recipient's agents living on the runtime, which stopped. Never
1494
+ * empty: without one there is nothing to tell them.
1495
+ */
1496
+ agents: Array<StoppedAgent>;
1497
+ /**
1498
+ * The runtime's name.
1499
+ */
1500
+ runtimeName: string;
1501
+ };
1502
+ /**
1503
+ * One of the recipient's agents that stopped with their runtime access.
1504
+ */
1505
+ export type StoppedAgent = {
1506
+ /**
1507
+ * The agent's bot id.
1508
+ */
1509
+ botId: string;
1510
+ /**
1511
+ * The agent's display name.
1512
+ */
1513
+ name: string;
1514
+ };
1480
1515
  /**
1481
1516
  * Metadata for when a user is assigned to a task
1482
1517
  */