@macro-inc/sdk 0.0.1 → 0.2.2

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 (165) hide show
  1. package/README.md +628 -21
  2. package/dist/{chunk-5HAKQN23.js → chunk-7LVVPVNT.js} +70 -57
  3. package/dist/{chunk-JXIQT5TH.js → chunk-7YJ6Y7HJ.js} +234 -16
  4. package/dist/chunk-LMJW65ML.js +836 -0
  5. package/dist/{chunk-SGAHIERJ.js → chunk-OGE7WXJE.js} +16 -0
  6. package/dist/chunk-PRUFPW3B.js +943 -0
  7. package/dist/{chunk-CTKR64MY.js → chunk-QVBNNMQS.js} +242 -367
  8. package/dist/{chunk-QNUS5BC5.js → chunk-SUINKDXF.js} +30 -84
  9. package/dist/{chunk-77EI4LSQ.js → chunk-ZQXOHNDB.js} +1518 -386
  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 +174 -4
  13. package/dist/generated/agent-harness/types.gen.d.ts +2511 -189
  14. package/dist/generated/auth/index.d.ts +1 -1
  15. package/dist/generated/auth/index.js +1 -1
  16. package/dist/generated/auth/sdk.gen.d.ts +106 -8
  17. package/dist/generated/auth/types.gen.d.ts +1473 -116
  18. package/dist/generated/calendar/client/client.gen.d.ts +2 -0
  19. package/dist/generated/calendar/client/index.d.ts +10 -0
  20. package/dist/generated/calendar/client/types.gen.d.ts +120 -0
  21. package/dist/generated/calendar/client/utils.gen.d.ts +37 -0
  22. package/dist/generated/calendar/client.gen.d.ts +12 -0
  23. package/dist/generated/calendar/core/auth.gen.d.ts +25 -0
  24. package/dist/generated/calendar/core/bodySerializer.gen.d.ts +25 -0
  25. package/dist/generated/calendar/core/params.gen.d.ts +43 -0
  26. package/dist/generated/calendar/core/pathSerializer.gen.d.ts +33 -0
  27. package/dist/generated/calendar/core/queryKeySerializer.gen.d.ts +18 -0
  28. package/dist/generated/calendar/core/serverSentEvents.gen.d.ts +71 -0
  29. package/dist/generated/calendar/core/types.gen.d.ts +83 -0
  30. package/dist/generated/calendar/core/utils.gen.d.ts +19 -0
  31. package/dist/generated/calendar/index.d.ts +2 -0
  32. package/dist/generated/calendar/index.js +6 -0
  33. package/dist/generated/calendar/sdk.gen.d.ts +95 -0
  34. package/dist/generated/calendar/types.gen.d.ts +1091 -0
  35. package/dist/generated/cognition/index.d.ts +1 -1
  36. package/dist/generated/cognition/index.js +1 -1
  37. package/dist/generated/cognition/sdk.gen.d.ts +6 -1
  38. package/dist/generated/cognition/types.gen.d.ts +304 -36
  39. package/dist/generated/connection/types.gen.d.ts +1 -1
  40. package/dist/generated/email/index.d.ts +1 -1
  41. package/dist/generated/email/index.js +1 -1
  42. package/dist/generated/email/sdk.gen.d.ts +32 -27
  43. package/dist/generated/email/types.gen.d.ts +586 -409
  44. package/dist/generated/notification/index.d.ts +1 -1
  45. package/dist/generated/notification/types.gen.d.ts +384 -19
  46. package/dist/generated/properties/types.gen.d.ts +8 -5
  47. package/dist/generated/scheduled-action/index.d.ts +1 -1
  48. package/dist/generated/scheduled-action/index.js +3 -842
  49. package/dist/generated/scheduled-action/sdk.gen.d.ts +3 -1
  50. package/dist/generated/scheduled-action/types.gen.d.ts +277 -41
  51. package/dist/generated/search/index.d.ts +1 -1
  52. package/dist/generated/search/types.gen.d.ts +262 -43
  53. package/dist/generated/storage/index.d.ts +1 -1
  54. package/dist/generated/storage/index.js +1 -1
  55. package/dist/generated/storage/sdk.gen.d.ts +678 -107
  56. package/dist/generated/storage/types.gen.d.ts +14827 -5995
  57. package/dist/generated/unfurl/index.d.ts +1 -1
  58. package/dist/generated/unfurl/index.js +3 -832
  59. package/dist/generated/unfurl/types.gen.d.ts +20 -0
  60. package/dist/src/config.d.ts +33 -13
  61. package/dist/src/entities/agent-sessions/agent-session.d.ts +150 -6
  62. package/dist/src/entities/agent-sessions/code-execution.d.ts +43 -0
  63. package/dist/src/entities/agent-sessions/conversation.d.ts +54 -0
  64. package/dist/src/entities/agent-sessions/namespace.d.ts +23 -5
  65. package/dist/src/entities/agent-sessions/queued-action.d.ts +46 -0
  66. package/dist/src/entities/agent-sessions/review.d.ts +107 -0
  67. package/dist/src/entities/agent-sessions/tool-approval.d.ts +21 -0
  68. package/dist/src/entities/agents/agent.d.ts +47 -0
  69. package/dist/src/entities/agents/namespace.d.ts +13 -0
  70. package/dist/src/entities/ai/namespace.d.ts +24 -0
  71. package/dist/src/entities/api-keys/api-key.d.ts +17 -0
  72. package/dist/src/entities/api-keys/namespace.d.ts +18 -0
  73. package/dist/src/entities/calendar/calendar.d.ts +35 -0
  74. package/dist/src/entities/calendar/event.d.ts +123 -0
  75. package/dist/src/entities/calendar/event.test.d.ts +1 -0
  76. package/dist/src/entities/calendar/namespace.d.ts +111 -0
  77. package/dist/src/entities/calendar/replacement.d.ts +15 -0
  78. package/dist/src/entities/calls/call-record.d.ts +62 -6
  79. package/dist/src/entities/calls/message.d.ts +33 -0
  80. package/dist/src/entities/channels/activity.d.ts +24 -0
  81. package/dist/src/entities/channels/channel.d.ts +44 -3
  82. package/dist/src/entities/channels/labels.d.ts +39 -0
  83. package/dist/src/entities/channels/message.d.ts +9 -17
  84. package/dist/src/entities/channels/namespace.d.ts +6 -0
  85. package/dist/src/entities/channels/picture.d.ts +11 -0
  86. package/dist/src/entities/channels/post.d.ts +1 -1
  87. package/dist/src/entities/channels/thread.d.ts +5 -0
  88. package/dist/src/entities/chats/chat.d.ts +11 -1
  89. package/dist/src/entities/chats/generation.d.ts +46 -0
  90. package/dist/src/entities/crm/comment.d.ts +55 -34
  91. package/dist/src/entities/crm/company.d.ts +42 -10
  92. package/dist/src/entities/crm/contact.d.ts +42 -10
  93. package/dist/src/entities/crm/namespace.d.ts +18 -1
  94. package/dist/src/entities/crm/pipeline.d.ts +122 -0
  95. package/dist/src/entities/crm/pipelines.d.ts +14 -0
  96. package/dist/src/entities/databases/column.d.ts +75 -0
  97. package/dist/src/entities/databases/database.d.ts +272 -0
  98. package/dist/src/entities/databases/namespace.d.ts +21 -0
  99. package/dist/src/entities/databases/query.d.ts +86 -0
  100. package/dist/src/entities/databases/row.d.ts +27 -0
  101. package/dist/src/entities/databases/table.d.ts +61 -0
  102. package/dist/src/entities/databases/view.d.ts +40 -0
  103. package/dist/src/entities/databases/webhook.d.ts +32 -0
  104. package/dist/src/entities/documents/anchor.d.ts +29 -0
  105. package/dist/src/entities/documents/comment.d.ts +25 -22
  106. package/dist/src/entities/documents/document.d.ts +60 -12
  107. package/dist/src/entities/documents/namespace.d.ts +30 -0
  108. package/dist/src/entities/documents/version.d.ts +22 -0
  109. package/dist/src/entities/email/draft.d.ts +79 -0
  110. package/dist/src/entities/email/filter.d.ts +34 -0
  111. package/dist/src/entities/email/link.d.ts +6 -4
  112. package/dist/src/entities/email/message.d.ts +12 -1
  113. package/dist/src/entities/email/namespace.d.ts +34 -1
  114. package/dist/src/entities/email/thread.d.ts +23 -1
  115. package/dist/src/entities/entity-mentions/mention.d.ts +16 -0
  116. package/dist/src/entities/entity-mentions/namespace.d.ts +12 -0
  117. package/dist/src/entities/entity.d.ts +7 -0
  118. package/dist/src/entities/favorites/namespace.d.ts +14 -2
  119. package/dist/src/entities/foreign/foreign-entity.d.ts +2 -0
  120. package/dist/src/entities/foreign/namespace.d.ts +40 -0
  121. package/dist/src/entities/forms/form.d.ts +227 -0
  122. package/dist/src/entities/forms/namespace.d.ts +18 -0
  123. package/dist/src/entities/forms/question.d.ts +37 -0
  124. package/dist/src/entities/forms/response.d.ts +32 -0
  125. package/dist/src/entities/forms/section.d.ts +19 -0
  126. package/dist/src/entities/github-pull-requests/namespace.d.ts +12 -0
  127. package/dist/src/entities/github-pull-requests/pull-request.d.ts +52 -0
  128. package/dist/src/entities/harnesses/harness.d.ts +19 -0
  129. package/dist/src/entities/harnesses/namespace.d.ts +33 -0
  130. package/dist/src/entities/harnesses/pairing.d.ts +39 -0
  131. package/dist/src/entities/initiatives/initiative.d.ts +50 -0
  132. package/dist/src/entities/initiatives/namespace.d.ts +13 -0
  133. package/dist/src/entities/meetings/meeting.d.ts +38 -0
  134. package/dist/src/entities/meetings/namespace.d.ts +18 -0
  135. package/dist/src/entities/messages/thread.d.ts +101 -0
  136. package/dist/src/entities/notifications/notification.d.ts +6 -3
  137. package/dist/src/entities/notifications/notification.test.d.ts +1 -0
  138. package/dist/src/entities/projects/project.d.ts +7 -0
  139. package/dist/src/entities/reference.d.ts +82 -0
  140. package/dist/src/entities/routines/namespace.d.ts +15 -0
  141. package/dist/src/entities/routines/routine.d.ts +115 -0
  142. package/dist/src/entities/sharing/access.d.ts +65 -0
  143. package/dist/src/entities/sharing/permissions.d.ts +13 -0
  144. package/dist/src/entities/tasks/namespace.d.ts +4 -0
  145. package/dist/src/entities/tasks/task.d.ts +6 -0
  146. package/dist/src/entities/unfurls/namespace.d.ts +10 -0
  147. package/dist/src/entities/webhooks/webhook.d.ts +3 -1
  148. package/dist/src/entities/workspace/items.d.ts +7 -0
  149. package/dist/src/entities/workspace/namespace.d.ts +83 -0
  150. package/dist/src/entities/workspace/query.d.ts +12 -0
  151. package/dist/src/entities/workspace/types.d.ts +96 -0
  152. package/dist/src/events/hydrate/agentSession.d.ts +192 -0
  153. package/dist/src/events/hydrate/channel.d.ts +2 -39
  154. package/dist/src/events/hydrate/message.d.ts +70 -0
  155. package/dist/src/events/receiver.d.ts +57 -19
  156. package/dist/src/events/types.d.ts +3 -1
  157. package/dist/src/macro.d.ts +80 -3
  158. package/dist/src/macro.js +8832 -2784
  159. package/dist/src/utils/activity.d.ts +11 -0
  160. package/dist/src/utils/activity.test.d.ts +1 -0
  161. package/dist/src/utils/client.d.ts +10 -1
  162. package/dist/src/utils/concurrency.d.ts +5 -0
  163. package/dist/src/utils/index.d.ts +1 -0
  164. package/dist/src/utils/pagination.d.ts +9 -4
  165. package/package.json +11 -3
@@ -1,6 +1,78 @@
1
1
  export type ClientOptions = {
2
2
  baseUrl: `${string}://${string}` | (string & {});
3
3
  };
4
+ /**
5
+ * Side of a folded conversation.
6
+ */
7
+ export type AgentSessionAuthor = 'user' | 'agent';
8
+ /**
9
+ * Filters for agent sessions.
10
+ */
11
+ export type AgentSessionFilters = {
12
+ /**
13
+ * Agent session ids to filter by. Empty to include all accessible sessions.
14
+ */
15
+ ids?: Array<string>;
16
+ /**
17
+ * Opt this query into agent sessions at all. Agent sessions are off by
18
+ * default — see [`crate::ast::agent_session::AgentSessionLiteral::Include`].
19
+ * Asking for specific `ids` or `owners` also opts in.
20
+ */
21
+ include?: boolean;
22
+ /**
23
+ * Filter by session owner principal — a user ('macro|user1@user.com'), a bot
24
+ * ('bot|<uuid>'), or a team (a bare hyphenated uuid). Empty to include every
25
+ * owner.
26
+ */
27
+ owners?: Array<string>;
28
+ };
29
+ /**
30
+ * One accessible agent session, grouped with its matching folded messages.
31
+ */
32
+ export type AgentSessionSearchResponseItem = {
33
+ /**
34
+ * Name and folded-message matches.
35
+ */
36
+ agent_session_search_results: Array<AgentSessionSearchResult>;
37
+ /**
38
+ * Agent persona ID.
39
+ */
40
+ bot_id: string;
41
+ /**
42
+ * Session creation time.
43
+ */
44
+ created_at: string;
45
+ /**
46
+ * Session ID.
47
+ */
48
+ id: string;
49
+ /**
50
+ * Current persisted name.
51
+ */
52
+ name: string;
53
+ /**
54
+ * Session owner.
55
+ */
56
+ owner_id: string;
57
+ /**
58
+ * Current persisted modification time.
59
+ */
60
+ updated_at: string;
61
+ };
62
+ /**
63
+ * A name match or one matching folded message.
64
+ */
65
+ export type AgentSessionSearchResult = {
66
+ goto?: null | SearchGotoAgentSession;
67
+ /**
68
+ * Matched name/content fragments.
69
+ */
70
+ highlight: SearchHighlight;
71
+ /**
72
+ * Search score.
73
+ */
74
+ score?: number | null;
75
+ };
4
76
  /**
5
77
  * Filters for canonical calendar-event entities.
6
78
  */
@@ -43,6 +115,11 @@ export type CalendarEventMetadata = {
43
115
  */
44
116
  conferenceUrl?: string | null;
45
117
  createdAt: string;
118
+ /**
119
+ * Free-text description, when the event carries one. May contain HTML from
120
+ * the source; clients render a plain-text preview.
121
+ */
122
+ description?: string | null;
46
123
  /**
47
124
  * Whether the canonical source prohibits mutation.
48
125
  */
@@ -53,6 +130,7 @@ export type CalendarEventMetadata = {
53
130
  */
54
131
  isRecurring: boolean;
55
132
  occurrence?: null | CalendarEventSearchOccurrence;
133
+ organizer?: null | CalendarEventOrganizer;
56
134
  /**
57
135
  * Canonical status (`confirmed`, `tentative`, `cancelled`).
58
136
  */
@@ -63,6 +141,20 @@ export type CalendarEventMetadata = {
63
141
  time: CalendarEventSearchTime;
64
142
  updatedAt: string;
65
143
  };
144
+ /**
145
+ * The event's organizer — its creator, in Google's model. Either field can be
146
+ * absent when the source does not name it.
147
+ */
148
+ export type CalendarEventOrganizer = {
149
+ /**
150
+ * Organizer email address, when known.
151
+ */
152
+ email?: string | null;
153
+ /**
154
+ * Display name, when the source provided one.
155
+ */
156
+ name?: string | null;
157
+ };
66
158
  /**
67
159
  * The instance a search row points at.
68
160
  *
@@ -188,7 +280,7 @@ export type CallRecordMetadata = {
188
280
  export type CallRecordSearchResponseItem = {
189
281
  call_id: string;
190
282
  call_search_results: Array<CallRecordSearchResult>;
191
- channel_id: string;
283
+ channel_id?: string | null;
192
284
  id: string;
193
285
  name?: string | null;
194
286
  owner_id: string;
@@ -523,7 +615,10 @@ export type ChatFilters = {
523
615
  */
524
616
  notification_filters?: NotificationFilters;
525
617
  /**
526
- * Filter by chat owner. Examples: ['macro|user1@user.com'], ['macro|user1@user.com', 'macro|user2@user.com']. Empty to search all owners.
618
+ * Filter by chat owner principal — a user ('macro|user1@user.com'), a bot
619
+ * ('bot|<uuid>'), or a team (a bare hyphenated uuid). Examples:
620
+ * ['macro|user1@user.com'], ['macro|user1@user.com', 'bot|0199...']. Empty to
621
+ * search all owners.
527
622
  */
528
623
  owners?: Array<string>;
529
624
  /**
@@ -747,7 +842,10 @@ export type DocumentFilters = {
747
842
  */
748
843
  notification_filters?: NotificationFilters;
749
844
  /**
750
- * Filter by document owner. Examples: ['macro|user1@user.com'], ['macro|user1@user.com', 'macro|user2@user.com']. Empty to search all owners.
845
+ * Filter by document owner principal — a user ('macro|user1@user.com'), a bot
846
+ * ('bot|<uuid>'), or a team (a bare hyphenated uuid). Examples:
847
+ * ['macro|user1@user.com'], ['macro|user1@user.com', 'bot|0199...']. Empty to
848
+ * search all owners.
751
849
  */
752
850
  owners?: Array<string>;
753
851
  /**
@@ -875,8 +973,11 @@ export type DocumentSearchResult = {
875
973
  /**
876
974
  * The document sub type enum represents all values of document sub types.
877
975
  * These values should match the `document_sub_type_value` table in macrodb.
976
+ *
977
+ * Wire, database, and `Display` spellings are all `snake_case` so a
978
+ * multi-word variant serializes identically in every system.
878
979
  */
879
- export type DocumentSubType = 'task' | 'snippet' | 'skill';
980
+ export type DocumentSubType = 'task' | 'snippet' | 'skill' | 'initiative_description';
880
981
  /**
881
982
  * The email filters used to filter down what emails you search over.
882
983
  */
@@ -933,6 +1034,10 @@ export type EmailFilters = {
933
1034
  * Note: SPAM and TRASH emails are not indexed in OpenSearch, so they will never appear in results regardless of this filter.
934
1035
  */
935
1036
  include_labels?: Array<string>;
1037
+ /**
1038
+ * Filter by the email thread's read flag, independently of notification state.
1039
+ */
1040
+ is_read?: boolean | null;
936
1041
  /**
937
1042
  * Restrict to specific inboxes by email_links.id. Empty means "any inbox the
938
1043
  * caller can access" (soup expands to the full set at the router edge).
@@ -1120,6 +1225,10 @@ export type EmptyResponse = {
1120
1225
  * a bundle of all of the filters for each entity type
1121
1226
  */
1122
1227
  export type EntityFilters = {
1228
+ /**
1229
+ * the bundled [AgentSessionFilters]
1230
+ */
1231
+ agent_session_filters?: AgentSessionFilters;
1123
1232
  /**
1124
1233
  * the bundled [CalendarEventFilters]
1125
1234
  */
@@ -1152,10 +1261,18 @@ export type EntityFilters = {
1152
1261
  * the bundled [EmailFilters]
1153
1262
  */
1154
1263
  email_filters?: EmailFilters;
1264
+ /**
1265
+ * Restrict results to the authenticated viewer's favorites when true.
1266
+ */
1267
+ favorites_only?: boolean | null;
1155
1268
  /**
1156
1269
  * the bundled [ForeignEntityFilters]
1157
1270
  */
1158
1271
  foreign_entity_filters?: ForeignEntityFilters;
1272
+ /**
1273
+ * Initiative filters. Initiatives are opt-in.
1274
+ */
1275
+ initiative_filters?: InitiativeFilters;
1159
1276
  /**
1160
1277
  * the bundled [ProjectFilters]
1161
1278
  */
@@ -1164,10 +1281,6 @@ export type EntityFilters = {
1164
1281
  * property-based filters applied across entity types
1165
1282
  */
1166
1283
  property_filters?: Array<PropertyFilter>;
1167
- /**
1168
- * the bundled [ReminderFilters]
1169
- */
1170
- reminder_filters?: ReminderFilters;
1171
1284
  /**
1172
1285
  * How the `tag_option_ids` combine: `any` (default) matches entities
1173
1286
  * holding at least one selected tag, `all` requires every selected tag.
@@ -1195,7 +1308,7 @@ export type EntityReference = {
1195
1308
  /**
1196
1309
  * Type of entity that can be referenced by entity properties.
1197
1310
  */
1198
- export type EntityType = 'CALENDAR_EVENT' | 'CALL_RECORD' | 'CHANNEL' | 'CHAT' | 'COMPANY' | 'DOCUMENT' | 'PROJECT' | 'TASK' | 'THREAD' | 'USER';
1311
+ export type EntityType = 'CALENDAR_EVENT' | 'CALL_RECORD' | 'CHANNEL' | 'CHAT' | 'COMPANY' | 'DATABASE_ROW' | 'CONTACT' | 'DOCUMENT' | 'INITIATIVE' | 'PROJECT' | 'TASK' | 'THREAD' | 'USER';
1199
1312
  /**
1200
1313
  * A plain old json error response for use with axum.
1201
1314
  * yup, thats it.
@@ -1222,7 +1335,7 @@ export type ErrorResponse = {
1222
1335
  * - ContentType::mime_type() - Gets MIME type for ContentType
1223
1336
  *
1224
1337
  */
1225
- export type FileType = 'docx' | 'pdf' | 'md' | 'canvas' | 'coffee' | 'cson' | 'iced' | 'c' | 'i' | 'cpp' | 'cppm' | 'cc' | 'ccm' | 'cxx' | 'cxxm' | 'cplusplus' | 'cplusplusm' | 'hpp' | 'hh' | 'hxx' | 'hplusplus' | 'h' | 'ii' | 'ino' | 'inl' | 'ipp' | 'ixx' | 'tpp' | 'txx' | 'hppin' | 'hin' | 'cu' | 'cuh' | 'cs' | 'csx' | 'cake' | 'css' | 'dart' | 'diff' | 'patch' | 'rej' | 'dockerfile' | 'containerfile' | 'go' | 'handlebars' | 'hbs' | 'hjs' | 'hlsl' | 'hlsli' | 'fx' | 'fxh' | 'vsh' | 'psh' | 'cginc' | 'compute' | 'html' | 'htm' | 'shtml' | 'xhtml' | 'xht' | 'mdoc' | 'jsp' | 'asp' | 'aspx' | 'jshtm' | 'volt' | 'ejs' | 'rhtml' | 'ini' | 'conf' | 'properties' | 'cfg' | 'directory' | 'gitattributes' | 'gitconfig' | 'gitmodules' | 'editorconfig' | 'repo' | 'java' | 'jav' | 'jsx' | 'js' | 'es6' | 'mjs' | 'cjs' | 'pac' | 'json' | 'bowerrc' | 'jscsrc' | 'webmanifest' | 'jsmap' | 'cssmap' | 'tsmap' | 'har' | 'jslintrc' | 'jsonld' | 'geojson' | 'ipynb' | 'vuerc' | 'jsonc' | 'eslintrc' | 'eslintrcjson' | 'jsfmtrc' | 'jshintrc' | 'swcrc' | 'hintrc' | 'babelrc' | 'jsonl' | 'ndjson' | 'codesnippets' | 'jl' | 'jmd' | 'sty' | 'cls' | 'bbx' | 'cbx' | 'tex' | 'ltx' | 'ctx' | 'bib' | 'less' | 'log' | 'lua' | 'mak' | 'mk' | 'mkd' | 'mdwn' | 'mdown' | 'markdown' | 'markdn' | 'mdtxt' | 'mdtext' | 'workbook' | 'm' | 'mm' | 'pl' | 'pm' | 'pod' | 't' | 'psgi' | 'raku' | 'rakumod' | 'rakutest' | 'rakudoc' | 'nqp' | 'p6' | 'pl6' | 'pm6' | 'php' | 'php4' | 'php5' | 'phtml' | 'ctp' | 'ps1' | 'psm1' | 'psd1' | 'pssc' | 'psrc' | 'py' | 'rpy' | 'pyw' | 'cpy' | 'gyp' | 'gypi' | 'pyi' | 'ipy' | 'pyt' | 'r' | 'rhistory' | 'rprofile' | 'rt' | 'cshtml' | 'razor' | 'rb' | 'rbx' | 'rjs' | 'gemspec' | 'rake' | 'ru' | 'erb' | 'podspec' | 'rbi' | 'rs' | 'scss' | 'sass' | 'shader' | 'sh' | 'bash' | 'bashrc' | 'bashaliases' | 'bashprofile' | 'bashlogin' | 'ebuild' | 'eclass' | 'profile' | 'bashlogout' | 'xprofile' | 'xsession' | 'xsessionrc' | 'zsh' | 'zshrc' | 'zprofile' | 'zlogin' | 'zlogout' | 'zshenv' | 'zshtheme' | 'fish' | 'ksh' | 'csh' | 'cshrc' | 'tcshrc' | 'yashrc' | 'yashprofile' | 'sql' | 'dsql' | 'swift' | 'ts' | 'cts' | 'mts' | 'tsx' | 'tsbuildinfo' | 'xml' | 'xsd' | 'ascx' | 'atom' | 'axml' | 'axaml' | 'bpmn' | 'cpt' | 'csl' | 'csproj' | 'csprojuser' | 'dita' | 'ditamap' | 'dtd' | 'ent' | 'mod' | 'dtml' | 'fsproj' | 'fxml' | 'iml' | 'isml' | 'jmx' | 'launch' | 'menu' | 'mxml' | 'nuspec' | 'opml' | 'owl' | 'proj' | 'props' | 'pt' | 'publishsettings' | 'pubxml' | 'pubxmluser' | 'rbxlx' | 'rbxmx' | 'rdf' | 'rng' | 'rss' | 'shproj' | 'storyboard' | 'targets' | 'tld' | 'tmx' | 'vbproj' | 'vbprojuser' | 'vcxproj' | 'vcxprojfilters' | 'wsdl' | 'wxi' | 'wxl' | 'wxs' | 'xaml' | 'xbl' | 'xib' | 'xlf' | 'xliff' | 'xpdl' | 'xul' | 'xoml' | 'xsl' | 'xslt' | 'yaml' | 'yml' | 'eyaml' | 'eyml' | 'cff' | 'yamltmlanguage' | 'yamltmpreferences' | 'yamltmtheme' | 'winget' | 'txt' | 'csv' | 'tsv' | 'jpeg' | 'jpg' | 'png' | 'gif' | 'svg' | 'webp' | 'avif' | 'bmp' | 'ico' | 'tiff' | 'tif' | 'heic' | 'heif' | 'tar' | 'targz' | 'tgz' | 'gz' | 'bz2' | 'tarbz2' | 'tbz2' | 'z' | 'tarz' | 'lz' | 'tarlz' | 'xz' | 'tarxz' | 'txz' | 'lzma' | 'tarlzma' | 'rar' | 'sevenz' | 'zst' | 'tarzst' | 'tzst' | 'zip' | 'exe' | 'msi' | 'dll' | 'bat' | 'cmd' | 'com' | 'appimage' | 'app' | 'bin' | 'deb' | 'rpm' | 'apk' | 'dmg' | 'pkg' | 'crx' | 'xpi' | 'mp3' | 'wav' | 'ogg' | 'flac' | 'aac' | 'm4a' | 'wma' | 'mid' | 'midi' | 'mp4' | 'mkv' | 'webm' | 'avi' | 'mov' | 'wmv' | 'mpg' | 'mpeg' | 'm4v' | 'flv' | 'f4v' | 'threegp' | 'ttf' | 'otf' | 'woff' | 'woff2' | 'eot' | 'rtf' | 'odt' | 'ods' | 'odp' | 'odg' | 'odf' | 'epub' | 'mobi' | 'azw' | 'azw3' | 'djvu' | 'xls' | 'ppt' | 'pptx' | 'xlsx' | 'db' | 'sqlite' | 'sqlite3' | 'mdb' | 'accdb' | 'dbf' | 'plist' | 'toml' | 'env' | 'dot' | 'gv' | 'torrent' | 'ics' | 'vcf' | 'ai' | 'eps' | 'ps' | 'dxf' | 'dwg' | 'stl' | 'obj' | 'fbx' | 'blend' | 'dae' | 'threeds' | 'gltf' | 'glb' | 'vhd' | 'vhdx' | 'vmdk' | 'ova' | 'ovf' | 'iso' | 'img' | 'swf';
1338
+ export type FileType = 'docx' | 'pdf' | 'md' | 'spreadsheet' | 'canvas' | 'coffee' | 'cson' | 'iced' | 'c' | 'i' | 'cpp' | 'cppm' | 'cc' | 'ccm' | 'cxx' | 'cxxm' | 'cplusplus' | 'cplusplusm' | 'hpp' | 'hh' | 'hxx' | 'hplusplus' | 'h' | 'ii' | 'ino' | 'inl' | 'ipp' | 'ixx' | 'tpp' | 'txx' | 'hppin' | 'hin' | 'cu' | 'cuh' | 'cs' | 'csx' | 'cake' | 'css' | 'dart' | 'diff' | 'patch' | 'rej' | 'dockerfile' | 'containerfile' | 'go' | 'handlebars' | 'hbs' | 'hjs' | 'hlsl' | 'hlsli' | 'fx' | 'fxh' | 'vsh' | 'psh' | 'cginc' | 'compute' | 'html' | 'htm' | 'shtml' | 'xhtml' | 'xht' | 'mdoc' | 'jsp' | 'asp' | 'aspx' | 'jshtm' | 'volt' | 'ejs' | 'rhtml' | 'ini' | 'conf' | 'properties' | 'cfg' | 'directory' | 'gitattributes' | 'gitconfig' | 'gitmodules' | 'editorconfig' | 'repo' | 'java' | 'jav' | 'jsx' | 'js' | 'es6' | 'mjs' | 'cjs' | 'pac' | 'json' | 'bowerrc' | 'jscsrc' | 'webmanifest' | 'jsmap' | 'cssmap' | 'tsmap' | 'har' | 'jslintrc' | 'jsonld' | 'geojson' | 'ipynb' | 'vuerc' | 'jsonc' | 'eslintrc' | 'eslintrcjson' | 'jsfmtrc' | 'jshintrc' | 'swcrc' | 'hintrc' | 'babelrc' | 'jsonl' | 'ndjson' | 'codesnippets' | 'jl' | 'jmd' | 'sty' | 'cls' | 'bbx' | 'cbx' | 'tex' | 'ltx' | 'ctx' | 'bib' | 'less' | 'log' | 'lua' | 'mak' | 'mk' | 'mkd' | 'mdwn' | 'mdown' | 'markdown' | 'markdn' | 'mdtxt' | 'mdtext' | 'workbook' | 'm' | 'mm' | 'pl' | 'pm' | 'pod' | 't' | 'psgi' | 'raku' | 'rakumod' | 'rakutest' | 'rakudoc' | 'nqp' | 'p6' | 'pl6' | 'pm6' | 'php' | 'php4' | 'php5' | 'phtml' | 'ctp' | 'ps1' | 'psm1' | 'psd1' | 'pssc' | 'psrc' | 'py' | 'rpy' | 'pyw' | 'cpy' | 'gyp' | 'gypi' | 'pyi' | 'ipy' | 'pyt' | 'r' | 'rhistory' | 'rprofile' | 'rt' | 'cshtml' | 'razor' | 'rb' | 'rbx' | 'rjs' | 'gemspec' | 'rake' | 'ru' | 'erb' | 'podspec' | 'rbi' | 'rs' | 'scss' | 'sass' | 'shader' | 'sh' | 'bash' | 'bashrc' | 'bashaliases' | 'bashprofile' | 'bashlogin' | 'ebuild' | 'eclass' | 'profile' | 'bashlogout' | 'xprofile' | 'xsession' | 'xsessionrc' | 'zsh' | 'zshrc' | 'zprofile' | 'zlogin' | 'zlogout' | 'zshenv' | 'zshtheme' | 'fish' | 'ksh' | 'csh' | 'cshrc' | 'tcshrc' | 'yashrc' | 'yashprofile' | 'sql' | 'dsql' | 'swift' | 'ts' | 'cts' | 'mts' | 'tsx' | 'tsbuildinfo' | 'xml' | 'xsd' | 'ascx' | 'atom' | 'axml' | 'axaml' | 'bpmn' | 'cpt' | 'csl' | 'csproj' | 'csprojuser' | 'dita' | 'ditamap' | 'dtd' | 'ent' | 'mod' | 'dtml' | 'fsproj' | 'fxml' | 'iml' | 'isml' | 'jmx' | 'launch' | 'menu' | 'mxml' | 'nuspec' | 'opml' | 'owl' | 'proj' | 'props' | 'pt' | 'publishsettings' | 'pubxml' | 'pubxmluser' | 'rbxlx' | 'rbxmx' | 'rdf' | 'rng' | 'rss' | 'shproj' | 'storyboard' | 'targets' | 'tld' | 'tmx' | 'vbproj' | 'vbprojuser' | 'vcxproj' | 'vcxprojfilters' | 'wsdl' | 'wxi' | 'wxl' | 'wxs' | 'xaml' | 'xbl' | 'xib' | 'xlf' | 'xliff' | 'xpdl' | 'xul' | 'xoml' | 'xsl' | 'xslt' | 'yaml' | 'yml' | 'eyaml' | 'eyml' | 'cff' | 'yamltmlanguage' | 'yamltmpreferences' | 'yamltmtheme' | 'winget' | 'txt' | 'csv' | 'tsv' | 'jpeg' | 'jpg' | 'png' | 'gif' | 'svg' | 'webp' | 'avif' | 'bmp' | 'ico' | 'tiff' | 'tif' | 'heic' | 'heif' | 'tar' | 'targz' | 'tgz' | 'gz' | 'bz2' | 'tarbz2' | 'tbz2' | 'z' | 'tarz' | 'lz' | 'tarlz' | 'xz' | 'tarxz' | 'txz' | 'lzma' | 'tarlzma' | 'rar' | 'sevenz' | 'zst' | 'tarzst' | 'tzst' | 'zip' | 'exe' | 'msi' | 'dll' | 'bat' | 'cmd' | 'com' | 'appimage' | 'app' | 'bin' | 'deb' | 'rpm' | 'apk' | 'dmg' | 'pkg' | 'crx' | 'xpi' | 'mp3' | 'wav' | 'ogg' | 'flac' | 'aac' | 'm4a' | 'wma' | 'mid' | 'midi' | 'mp4' | 'mkv' | 'webm' | 'avi' | 'mov' | 'wmv' | 'mpg' | 'mpeg' | 'm4v' | 'flv' | 'f4v' | 'threegp' | 'ttf' | 'otf' | 'woff' | 'woff2' | 'eot' | 'rtf' | 'odt' | 'ods' | 'odp' | 'odg' | 'odf' | 'epub' | 'mobi' | 'azw' | 'azw3' | 'djvu' | 'xls' | 'xlsm' | 'ppt' | 'doc' | 'pptx' | 'xlsx' | 'db' | 'sqlite' | 'sqlite3' | 'mdb' | 'accdb' | 'dbf' | 'plist' | 'toml' | 'env' | 'dot' | 'gv' | 'torrent' | 'ics' | 'vcf' | 'ai' | 'eps' | 'ps' | 'dxf' | 'dwg' | 'fig' | 'psd' | 'psb' | 'stl' | 'obj' | 'fbx' | 'blend' | 'dae' | 'threeds' | 'gltf' | 'glb' | 'vhd' | 'vhdx' | 'vmdk' | 'ova' | 'ovf' | 'iso' | 'img' | 'swf';
1226
1339
  /**
1227
1340
  * Filters for foreign entity records.
1228
1341
  */
@@ -1251,22 +1364,68 @@ export type ForeignEntityFilters = {
1251
1364
  */
1252
1365
  notification_filters?: NotificationFilters;
1253
1366
  };
1367
+ /**
1368
+ * The search service version of a highlight
1369
+ */
1370
+ export type Highlight = {
1371
+ /**
1372
+ * If the match was on the entity content, this will provide a list of highlights
1373
+ * for each content match
1374
+ */
1375
+ content?: Array<string>;
1376
+ /**
1377
+ * If the match was on the entity name, this will be present with that highlight
1378
+ */
1379
+ name?: string | null;
1380
+ };
1381
+ /**
1382
+ * Filters for initiatives.
1383
+ */
1384
+ export type InitiativeFilters = {
1385
+ /**
1386
+ * Inclusive lower due-date bound.
1387
+ */
1388
+ due_after?: string | null;
1389
+ /**
1390
+ * Inclusive upper due-date bound.
1391
+ */
1392
+ due_before?: string | null;
1393
+ /**
1394
+ * Opt this query into initiatives at all. Initiatives are off by
1395
+ * default — see [`crate::ast::initiative::InitiativeLiteral::Include`].
1396
+ * Asking for specific `initiative_ids` or `owners` also opts in.
1397
+ */
1398
+ include?: boolean;
1399
+ /**
1400
+ * Initiative ids to filter by. Empty to include all accessible initiatives.
1401
+ */
1402
+ initiative_ids?: Array<string>;
1403
+ /**
1404
+ * Case-insensitive name substring.
1405
+ */
1406
+ name?: string | null;
1407
+ /**
1408
+ * Filter by initiative owner principal — a user ('macro|user1@user.com'), a bot
1409
+ * ('bot|<uuid>'), or a team (a bare hyphenated uuid). Empty to include every
1410
+ * owner.
1411
+ */
1412
+ owners?: Array<string>;
1413
+ };
1254
1414
  export type MatchType = 'exact' | 'partial' | 'regexp' | 'query';
1255
1415
  /**
1256
1416
  * Notification-level filters that apply to an entity type.
1257
1417
  */
1258
1418
  export type NotificationFilters = {
1259
1419
  /**
1260
- * Filter by notification done state.
1261
- * None to ignore, true to include only done notifications, false to include only not-done notifications.
1420
+ * Include entities with a non-deleted notification in any of these exact states.
1421
+ * Empty means no notification restriction. Active means `[unseen, seen]`.
1262
1422
  */
1263
- done?: boolean | null;
1264
- /**
1265
- * Filter by notification seen state.
1266
- * None to ignore, true to include only seen notifications, false to include only unseen notifications.
1267
- */
1268
- seen?: boolean | null;
1423
+ states?: Array<NotificationState>;
1269
1424
  };
1425
+ /**
1426
+ * The mutually exclusive lifecycle states of a user's notification.
1427
+ */
1428
+ export type NotificationState = 'unseen' | 'seen' | 'done';
1270
1429
  /**
1271
1430
  * The project filters used to filter down what projects you search over.
1272
1431
  */
@@ -1284,7 +1443,10 @@ export type ProjectFilters = {
1284
1443
  */
1285
1444
  notification_filters?: NotificationFilters;
1286
1445
  /**
1287
- * Filter by project owner. Examples: ['macro|user1@user.com'], ['macro|user1@user.com', 'macro|user2@user.com']. Empty to search all owners.
1446
+ * Filter by project owner principal — a user ('macro|user1@user.com'), a bot
1447
+ * ('bot|<uuid>'), or a team (a bare hyphenated uuid). Examples:
1448
+ * ['macro|user1@user.com'], ['macro|user1@user.com', 'bot|0199...']. Empty to
1449
+ * search all owners.
1288
1450
  */
1289
1451
  owners?: Array<string>;
1290
1452
  /**
@@ -1390,7 +1552,7 @@ export type PropertyDefinition = {
1390
1552
  */
1391
1553
  is_system: boolean;
1392
1554
  owner: PropertyOwner;
1393
- specific_entity_type?: null | EntityType;
1555
+ specific_entity_type: null | EntityType;
1394
1556
  updated_at: string;
1395
1557
  };
1396
1558
  /**
@@ -1421,7 +1583,7 @@ export type PropertyFilter = {
1421
1583
  property_definition_id: string;
1422
1584
  };
1423
1585
  /**
1424
- * Defines who owns a property - user-scoped, team-scoped, or system.
1586
+ * Defines who owns a property - user-scoped, team-scoped, database-scoped, or system.
1425
1587
  */
1426
1588
  export type PropertyOwner = {
1427
1589
  scope: 'user';
@@ -1429,6 +1591,9 @@ export type PropertyOwner = {
1429
1591
  } | {
1430
1592
  scope: 'team';
1431
1593
  team_id: string;
1594
+ } | {
1595
+ database_id: string;
1596
+ scope: 'database';
1432
1597
  } | {
1433
1598
  scope: 'system';
1434
1599
  };
@@ -1492,37 +1657,70 @@ export type PropertyValue = {
1492
1657
  value: Array<string>;
1493
1658
  };
1494
1659
  /**
1495
- * Filters for reminders.
1660
+ * Stable navigation target from the fold, independent of raw ACP log IDs.
1496
1661
  */
1497
- export type ReminderFilters = {
1662
+ export type SearchGotoAgentSession = {
1498
1663
  /**
1499
- * Filter on whether the owner has marked the reminder done. `None` returns
1500
- * both.
1664
+ * Author within the turn.
1501
1665
  */
1502
- completed?: boolean | null;
1666
+ author: AgentSessionAuthor;
1503
1667
  /**
1504
- * Restrict to reminders attached to these entities, each `"{type}:{id}"`.
1668
+ * Fold-assigned turn.
1505
1669
  */
1506
- entities?: Array<string>;
1670
+ message_turn: number;
1671
+ };
1672
+ export type SearchGotoCallRecord = {
1673
+ channel_id?: string | null;
1674
+ ended_at?: string | null;
1675
+ participant_ids: Array<string>;
1676
+ sequence_num: number;
1677
+ speaker_id: string;
1678
+ started_at: string;
1679
+ transcript_id: string;
1680
+ };
1681
+ export type SearchGotoChannel = {
1507
1682
  /**
1508
- * Filter on whether the reminder's next run has come due, i.e. it has
1509
- * fired and is awaiting its owner. `None` returns both.
1510
- *
1511
- * Evaluated server-side against the database clock rather than a
1512
- * timestamp supplied by the caller: a timestamp would land in the query
1513
- * cache key and change on every render.
1683
+ * The channel message id
1514
1684
  */
1515
- fired?: boolean | null;
1685
+ channel_message_id: string;
1686
+ };
1687
+ export type SearchGotoChat = {
1516
1688
  /**
1517
- * Reminder ids to filter by. Empty to include all of the caller's reminders.
1689
+ * The chat message id
1518
1690
  */
1519
- ids?: Array<string>;
1691
+ chat_message_id: string;
1520
1692
  /**
1521
- * Opt this query into reminders at all. Reminders are off by default —
1522
- * see [`crate::ast::reminder::ReminderLiteral::Include`]. Asking for
1523
- * specific `ids` or `entities` also opts in.
1693
+ * The role of the chat message
1524
1694
  */
1525
- include?: boolean;
1695
+ role: string;
1696
+ };
1697
+ /**
1698
+ * The search service version of a goto
1699
+ */
1700
+ export type SearchGotoContent = SearchGotoAgentSession | SearchGotoDocument | SearchGotoChat | SearchGotoEmail | SearchGotoChannel | SearchGotoCallRecord;
1701
+ export type SearchGotoDocument = {
1702
+ /**
1703
+ * The node id of the document
1704
+ * This can be a stringified page number 0-indexed for pdf/docx files,
1705
+ * or it can be a unique id that is used in lexical for markdown files.
1706
+ */
1707
+ node_id: string;
1708
+ /**
1709
+ * The raw content of the document
1710
+ */
1711
+ raw_content?: string | null;
1712
+ };
1713
+ export type SearchGotoEmail = {
1714
+ bcc: Array<string>;
1715
+ cc: Array<string>;
1716
+ /**
1717
+ * The email message id
1718
+ */
1719
+ email_message_id: string;
1720
+ labels: Array<string>;
1721
+ recipients: Array<string>;
1722
+ sender: string;
1723
+ sent_at?: string | null;
1526
1724
  };
1527
1725
  export type SearchHighlight = {
1528
1726
  /**
@@ -1601,7 +1799,7 @@ export type SimpleCalendarEventSearchResponseBaseItemHumanReadableTimestamp = {
1601
1799
  };
1602
1800
  export type SimpleCallRecordSearchResponseBaseItemHumanReadableTimestamp = {
1603
1801
  call_id: string;
1604
- channel_id: string;
1802
+ channel_id?: string | null;
1605
1803
  channel_name?: string | null;
1606
1804
  duration_ms: number;
1607
1805
  /**
@@ -2023,6 +2221,25 @@ export type SimpleProjectSearchResponseBaseItemHumanReadableTimestamp = {
2023
2221
  */
2024
2222
  user_id: string;
2025
2223
  };
2224
+ /**
2225
+ * The response for simple search
2226
+ */
2227
+ export type SimpleSearchResponse = {
2228
+ results: Array<SimpleSearchResponseItem>;
2229
+ };
2230
+ /**
2231
+ * Simple response item to mimic what we get back from opensearch
2232
+ */
2233
+ export type SimpleSearchResponseItem = {
2234
+ /**
2235
+ * ID of the chat, channel, email, or document
2236
+ */
2237
+ entity_id: string;
2238
+ entity_type: string;
2239
+ goto?: null | SearchGotoContent;
2240
+ highlight: Highlight;
2241
+ score?: number | null;
2242
+ };
2026
2243
  export type SimpleUnifiedSearchBaseResponse = {
2027
2244
  results: Array<SimpleUnifiedSearchResponseBaseItemHumanReadableTimestamp>;
2028
2245
  };
@@ -2141,6 +2358,8 @@ export type UnifiedSearchResponseItem = (DocumentSearchResponseItemWithMetadata
2141
2358
  type: 'company';
2142
2359
  }) | (CalendarEventSearchResponseItemWithMetadata & {
2143
2360
  type: 'calendarEvent';
2361
+ }) | (AgentSessionSearchResponseItem & {
2362
+ type: 'agentSession';
2144
2363
  });
2145
2364
  export type UnifiedSearchData = {
2146
2365
  body: UnifiedSearchRequest;
@@ -2189,6 +2408,6 @@ export type SimpleUnifiedSearchErrors = {
2189
2408
  };
2190
2409
  export type SimpleUnifiedSearchError = SimpleUnifiedSearchErrors[keyof SimpleUnifiedSearchErrors];
2191
2410
  export type SimpleUnifiedSearchResponses = {
2192
- 200: SimpleUnifiedSearchBaseResponse;
2411
+ 200: SimpleSearchResponse;
2193
2412
  };
2194
2413
  export type SimpleUnifiedSearchResponse = SimpleUnifiedSearchResponses[keyof SimpleUnifiedSearchResponses];