@macro-inc/sdk 0.5.0 → 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 (138) hide show
  1. package/README.md +156 -23
  2. package/dist/{chunk-3SW6QVDV.js → chunk-4MI52GWV.js} +60 -1
  3. package/dist/{chunk-GT5EUYOR.js → chunk-HO75UE4Z.js} +133 -0
  4. package/dist/{chunk-P4DTO6VD.js → chunk-MCSQNZ4E.js} +6 -0
  5. package/dist/{chunk-HIW6KU2I.js → chunk-SJ6S2GAT.js} +712 -14
  6. package/dist/{chunk-J2VK3NOR.js → chunk-SK5CMXRV.js} +44 -14
  7. package/dist/{chunk-UVJLWLSJ.js → chunk-TMTYN2UK.js} +190 -2
  8. package/dist/{chunk-PPR7IWZ7.js → chunk-ZYBAKW25.js} +2 -1
  9. package/dist/generated/agent-fold/index.d.ts +194 -8
  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 +33 -2
  13. package/dist/generated/agent-harness/types.gen.d.ts +341 -8
  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 +69 -1
  18. package/dist/generated/auth/types.gen.d.ts +734 -3
  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 +23 -6
  23. package/dist/generated/cognition/types.gen.d.ts +202 -114
  24. package/dist/generated/contacts/index.d.ts +1 -1
  25. package/dist/generated/contacts/index.js +1 -1
  26. package/dist/generated/contacts/sdk.gen.d.ts +5 -1
  27. package/dist/generated/contacts/types.gen.d.ts +56 -0
  28. package/dist/generated/email/types.gen.d.ts +8 -2
  29. package/dist/generated/notification/index.d.ts +1 -1
  30. package/dist/generated/notification/index.js +1 -1
  31. package/dist/generated/notification/sdk.gen.d.ts +2 -1
  32. package/dist/generated/notification/types.gen.d.ts +138 -0
  33. package/dist/generated/scheduled-action/index.d.ts +1 -1
  34. package/dist/generated/scheduled-action/index.js +1 -1
  35. package/dist/generated/scheduled-action/sdk.gen.d.ts +92 -2
  36. package/dist/generated/scheduled-action/types.gen.d.ts +1455 -21
  37. package/dist/generated/search/index.d.ts +1 -1
  38. package/dist/generated/search/types.gen.d.ts +50 -11
  39. package/dist/generated/storage/index.d.ts +1 -1
  40. package/dist/generated/storage/index.js +1 -1
  41. package/dist/generated/storage/sdk.gen.d.ts +309 -15
  42. package/dist/generated/storage/types.gen.d.ts +12437 -8899
  43. package/dist/src/entities/agent-sessions/activity.d.ts +3 -2
  44. package/dist/src/entities/agent-sessions/agent-session.d.ts +17 -5
  45. package/dist/src/entities/agent-sessions/namespace.d.ts +5 -4
  46. package/dist/src/entities/agent-sessions/review.d.ts +1 -1
  47. package/dist/src/entities/ai/namespace.d.ts +2 -2
  48. package/dist/src/entities/api-keys/namespace.d.ts +5 -2
  49. package/dist/src/entities/bots/bot.d.ts +6 -3
  50. package/dist/src/entities/calendar/booking-namespace.d.ts +1 -1
  51. package/dist/src/entities/calendar/calendar.d.ts +3 -2
  52. package/dist/src/entities/calendar/event.d.ts +9 -0
  53. package/dist/src/entities/calendar/namespace.d.ts +3 -2
  54. package/dist/src/entities/calls/call-record.d.ts +19 -5
  55. package/dist/src/entities/canvases/canvas.d.ts +5 -0
  56. package/dist/src/entities/channels/channel.d.ts +27 -7
  57. package/dist/src/entities/channels/message.d.ts +65 -2
  58. package/dist/src/entities/channels/message.test.d.ts +1 -0
  59. package/dist/src/entities/channels/namespace.d.ts +9 -4
  60. package/dist/src/entities/channels/post.d.ts +13 -7
  61. package/dist/src/entities/channels/share.d.ts +9 -0
  62. package/dist/src/entities/channels/share.test.d.ts +1 -0
  63. package/dist/src/entities/channels/thread.d.ts +5 -1
  64. package/dist/src/entities/chats/chat.d.ts +1 -1
  65. package/dist/src/entities/chats/namespace.d.ts +1 -1
  66. package/dist/src/entities/connected-apps/connected-app.d.ts +2 -1
  67. package/dist/src/entities/connected-apps/namespace.d.ts +2 -0
  68. package/dist/src/entities/crm/company.d.ts +1 -1
  69. package/dist/src/entities/crm/contact.d.ts +44 -3
  70. package/dist/src/entities/crm/namespace.d.ts +30 -13
  71. package/dist/src/entities/crm/pipeline-entry.d.ts +10 -3
  72. package/dist/src/entities/crm/pipeline.d.ts +39 -20
  73. package/dist/src/entities/crm/pipelines.d.ts +33 -5
  74. package/dist/src/entities/crm-email-privacy/email-privacy.d.ts +238 -0
  75. package/dist/src/entities/crm-email-privacy/email-rule-preview.d.ts +55 -0
  76. package/dist/src/entities/crm-email-privacy/email-rule-revision.d.ts +27 -0
  77. package/dist/src/entities/crm-email-privacy/email-rules.d.ts +32 -0
  78. package/dist/src/entities/databases/database.d.ts +34 -6
  79. package/dist/src/entities/databases/namespace.d.ts +26 -6
  80. package/dist/src/entities/databases/saved-query.d.ts +7 -1
  81. package/dist/src/entities/databases/table.d.ts +9 -0
  82. package/dist/src/entities/databases/view.d.ts +10 -0
  83. package/dist/src/entities/documents/create.test.d.ts +1 -0
  84. package/dist/src/entities/documents/document.d.ts +41 -6
  85. package/dist/src/entities/documents/namespace.d.ts +17 -3
  86. package/dist/src/entities/email/draft.d.ts +2 -2
  87. package/dist/src/entities/email/message.d.ts +18 -7
  88. package/dist/src/entities/email/namespace.d.ts +11 -7
  89. package/dist/src/entities/email/thread.d.ts +26 -3
  90. package/dist/src/entities/entity.d.ts +10 -1
  91. package/dist/src/entities/external-chat/chat.d.ts +19 -2
  92. package/dist/src/entities/foreign/namespace.d.ts +1 -1
  93. package/dist/src/entities/forms/form.d.ts +20 -1
  94. package/dist/src/entities/harnesses/namespace.d.ts +1 -1
  95. package/dist/src/entities/harnesses/pairing.d.ts +2 -1
  96. package/dist/src/entities/imports/entry.d.ts +65 -0
  97. package/dist/src/entities/imports/namespace.d.ts +103 -0
  98. package/dist/src/entities/imports/namespace.test.d.ts +1 -0
  99. package/dist/src/entities/initiatives/initiative.d.ts +14 -4
  100. package/dist/src/entities/initiatives/namespace.d.ts +4 -2
  101. package/dist/src/entities/me/namespace.d.ts +1 -1
  102. package/dist/src/entities/meetings/meeting.d.ts +2 -1
  103. package/dist/src/entities/notifications/namespace.d.ts +2 -1
  104. package/dist/src/entities/notifications/notification.d.ts +2 -1
  105. package/dist/src/entities/passwords/item.d.ts +118 -0
  106. package/dist/src/entities/passwords/namespace.d.ts +45 -0
  107. package/dist/src/entities/projects/namespace.d.ts +1 -1
  108. package/dist/src/entities/projects/project.d.ts +11 -1
  109. package/dist/src/entities/referrals/namespace.d.ts +1 -1
  110. package/dist/src/entities/routines/namespace.d.ts +81 -18
  111. package/dist/src/entities/routines/routine.d.ts +65 -4
  112. package/dist/src/entities/routines/suggestion.d.ts +38 -0
  113. package/dist/src/entities/saved-views/namespace.d.ts +2 -1
  114. package/dist/src/entities/search/exclusions.d.ts +6 -0
  115. package/dist/src/entities/search/namespace.d.ts +4 -2
  116. package/dist/src/entities/search/options.d.ts +3 -2
  117. package/dist/src/entities/suggestions/namespace.d.ts +118 -0
  118. package/dist/src/entities/suggestions/suggestion.d.ts +172 -0
  119. package/dist/src/entities/suggestions/suggestion.test.d.ts +1 -0
  120. package/dist/src/entities/tasks/namespace.d.ts +6 -5
  121. package/dist/src/entities/tasks/task.d.ts +14 -2
  122. package/dist/src/entities/teams/team.d.ts +16 -3
  123. package/dist/src/entities/ui/app-link.d.ts +24 -0
  124. package/dist/src/entities/ui/namespace.d.ts +75 -0
  125. package/dist/src/entities/users/namespace.d.ts +7 -3
  126. package/dist/src/entities/web/namespace.d.ts +2 -2
  127. package/dist/src/entities/workspace/namespace.d.ts +5 -3
  128. package/dist/src/entities/workspace/query.test.d.ts +1 -0
  129. package/dist/src/events/hydrate/document.d.ts +5 -0
  130. package/dist/src/macro.d.ts +26 -1
  131. package/dist/src/macro.js +4086 -1234
  132. package/dist/src/utils/activity.d.ts +2 -0
  133. package/dist/src/utils/index.d.ts +1 -1
  134. package/dist/src/utils/lazy.d.ts +13 -0
  135. package/dist/src/utils/options.d.ts +7 -0
  136. package/dist/src/utils/pagination.d.ts +16 -0
  137. package/dist/src/utils/verbs.d.ts +3 -0
  138. package/package.json +1 -1
@@ -1,3 +1,4 @@
1
+ import { type IterationOptions } from '../../utils';
1
2
  import type { MacroClient } from '../../utils/client';
2
3
  import type { WorkspaceItem, WorkspaceListOptions, WorkspacePage, WorkspacePageOptions } from './types';
3
4
  /**
@@ -82,13 +83,14 @@ export declare class WorkspaceNamespace {
82
83
  */
83
84
  page(options?: WorkspacePageOptions): Promise<WorkspacePage>;
84
85
  /**
85
- * Every matching item, newest first by default, auto-paginated. `limit` is a
86
- * page size, not a total result limit.
86
+ * Every matching item, newest first by default, auto-paginated; `maxItems` caps the total. `limit` is a
87
+ * page size; `maxItems` caps the total.
87
88
  * Break a `for await` loop to stop; no speculative next page is fetched.
88
89
  * Tag/inbox resolution is reused within this iterator.
89
90
  *
90
91
  * @readonly
91
92
  */
92
- list(options?: WorkspaceListOptions): AsyncGenerator<WorkspaceItem>;
93
+ list(options?: WorkspaceListOptions & IterationOptions): AsyncGenerator<WorkspaceItem>;
94
+ private listPages;
93
95
  private fetch;
94
96
  }
@@ -0,0 +1 @@
1
+ export {};
@@ -51,4 +51,9 @@ export declare function hydrateDocumentEvent(client: MacroClient, event: Documen
51
51
  event_type: "document.interaction";
52
52
  metadata: import("../../../generated/storage").DocumentInteractionMetadata;
53
53
  document: Document;
54
+ } | {
55
+ event_type: "document.email_attachments_released";
56
+ metadata: import("../../../generated/storage").EmailAttachmentsReleasedMetadata;
57
+ trashedDocuments: Document[];
58
+ keptDocuments: Document[];
54
59
  } | undefined;
@@ -23,11 +23,13 @@ import { FormNamespace } from './entities/forms/namespace';
23
23
  import { GithubPullRequestNamespace } from './entities/github-pull-requests/namespace';
24
24
  import { HarnessNamespace } from './entities/harnesses/namespace';
25
25
  import { ImagesNamespace } from './entities/images/namespace';
26
+ import { ImportNamespace } from './entities/imports/namespace';
26
27
  import { InitiativeNamespace } from './entities/initiatives/namespace';
27
28
  import { MeNamespace } from './entities/me/namespace';
28
29
  import { MeetingNamespace } from './entities/meetings/namespace';
29
30
  import { MemoryNamespace } from './entities/memory/namespace';
30
31
  import { NotificationNamespace } from './entities/notifications/namespace';
32
+ import { PasswordNamespace } from './entities/passwords/namespace';
31
33
  import { PinsNamespace } from './entities/pins/namespace';
32
34
  import { ProjectNamespace } from './entities/projects/namespace';
33
35
  import { PropertiesNamespace } from './entities/properties/namespace';
@@ -35,8 +37,10 @@ import { ReferralNamespace } from './entities/referrals/namespace';
35
37
  import { RoutineNamespace } from './entities/routines/namespace';
36
38
  import { SavedViewsNamespace } from './entities/saved-views/namespace';
37
39
  import { SearchNamespace } from './entities/search/namespace';
40
+ import { SuggestionNamespace } from './entities/suggestions/namespace';
38
41
  import { TaskNamespace } from './entities/tasks/namespace';
39
42
  import { TeamNamespace } from './entities/teams/namespace';
43
+ import { UiNamespace } from './entities/ui/namespace';
40
44
  import { UnfurlNamespace } from './entities/unfurls/namespace';
41
45
  import { UserNamespace } from './entities/users/namespace';
42
46
  import type { User } from './entities/users/user';
@@ -46,6 +50,7 @@ import { WhatsAppNamespace } from './entities/whatsapp/namespace';
46
50
  import { WorkspaceNamespace } from './entities/workspace/namespace';
47
51
  import type { MacroEvents } from './events/receiver';
48
52
  import { MacroClient } from './utils/client';
53
+ export type { AppearanceColor, AppearanceIcon, EntityAppearance, } from '../generated/storage/types.gen';
49
54
  export type { MacroOpts } from './config';
50
55
  export type { ActivityAction, ActivityEvent, ActivityRange, } from './entities/activity/namespace';
51
56
  export { CodeExecution } from './entities/agent-sessions/code-execution';
@@ -59,12 +64,17 @@ export { CallParticipant } from './entities/calls/participant';
59
64
  export { ConnectedApp, ConnectedTool, } from './entities/connected-apps/connected-app';
60
65
  export { Connector } from './entities/connected-apps/connector';
61
66
  export { ConnectedAppNamespace } from './entities/connected-apps/namespace';
62
- export { type AddColumnOptions, type ApplyOpsOptions, type ChangeColumnTypeOptions, type ColumnType, type ConvertIntoNewColumnOptions, MacroOpRefusedError, type OpResultOf, } from './entities/databases/database';
67
+ export type { CrmEmailPolicy, CrmEmailPolicyHistoryEvent, CrmEmailPolicyResult, CrmEmailPolicyToken, CrmEmailPolicyWriteOptions, CrmEmailPrivacySettings, CrmEmailRuleValidation, CrmExcludedEmailThread, } from './entities/crm-email-privacy/email-privacy';
68
+ export { type CrmEmailPreviewState, CrmEmailRulePreview, } from './entities/crm-email-privacy/email-rule-preview';
69
+ export { type CrmEmailRuleDefinition, CrmEmailRuleRevision, } from './entities/crm-email-privacy/email-rule-revision';
70
+ export type { CrmEmailRule, CrmEmailRuleSet, } from './entities/crm-email-privacy/email-rules';
71
+ export { type AddColumnOptions, type ApplyOpsOptions, type ChangeColumnTypeOptions, type ColumnType, type ConvertIntoNewColumnOptions, type CreateDatabaseOptions, MacroOpRefusedError, type OpResultOf, } from './entities/databases/database';
63
72
  export { Form, type FormAnswer, type FormAnswerValue, type FormBookingStep, type FormBookingTarget, type FormEntityHandle, type FormLayoutResult, type FormQuestionPlacement, type FormQuestionTally, FormReference, type FormResponseSummary, type FormRules, type FormRuleTest, type FormSectionPlacement, type FormSubmissionOutcome, type MyFormResponse, type SavedFormResponse, } from './entities/forms/form';
64
73
  export { FormOption, FormQuestion } from './entities/forms/question';
65
74
  export { FormResponse } from './entities/forms/response';
66
75
  export { FormSection } from './entities/forms/section';
67
76
  export type { CreatedEntity } from './entities/routines/namespace';
77
+ export { AppLink, UiNamespace, type UiOpenOptions, type UiOpenResult, type UiTarget, } from './entities/ui/namespace';
68
78
  export type { ListenOptions, MacroEvents } from './events/receiver';
69
79
  export { here, type Interpolation, type Mentionable, type MentionPart, msg, type RichMessage, type SimpleMention, toBody, wrapXml, } from './mentions';
70
80
  export type { RequestActivity } from './utils/activity';
@@ -76,6 +86,8 @@ export type { RequestActivity } from './utils/activity';
76
86
  export declare class Macro<T extends MacroOpts = MacroOpts> {
77
87
  /** routines resources and operations. */
78
88
  readonly routines: RoutineNamespace;
89
+ /** suggestions resources and operations. */
90
+ readonly suggestions: SuggestionNamespace;
79
91
  /** unfurls resources and operations. */
80
92
  readonly unfurls: UnfurlNamespace;
81
93
  /** agents resources and operations. */
@@ -111,12 +123,16 @@ export declare class Macro<T extends MacroOpts = MacroOpts> {
111
123
  readonly email: EmailNamespace;
112
124
  /** Call the user's connected apps and MCP servers from a code execution. */
113
125
  readonly connectedApps: ConnectedAppNamespace;
126
+ /** Open items in the Macro app tab the user prompted from. */
127
+ readonly ui: UiNamespace;
114
128
  readonly favorites: FavoritesNamespace;
115
129
  readonly foreignEntities: ForeignEntityNamespace;
116
130
  /** Build forms and submit answers without granting respondents database access. */
117
131
  readonly forms: FormNamespace;
118
132
  /** Generate images with AI and attach them to messages. */
119
133
  readonly images: ImagesNamespace;
134
+ /** The import ledger: external items proposed for, or copied into, Macro. */
135
+ readonly imports: ImportNamespace;
120
136
  /** Search the public web and read web pages. */
121
137
  readonly web: WebNamespace;
122
138
  /** The acting user's private explicit memory. */
@@ -133,6 +149,8 @@ export declare class Macro<T extends MacroOpts = MacroOpts> {
133
149
  readonly referrals: ReferralNamespace;
134
150
  /** Saved views: named filter definitions shown in a surface's sidebar, such as Email. */
135
151
  readonly savedViews: SavedViewsNamespace;
152
+ /** The authenticated agent's view of its team vaults; agent API keys only. */
153
+ readonly passwords: PasswordNamespace;
136
154
  readonly tasks: TaskNamespace;
137
155
  /** Search every kind of item at once: documents, email, channels, calls, events, sessions and chats. */
138
156
  readonly search: SearchNamespace;
@@ -181,6 +199,7 @@ export { BotToken } from './entities/bots/token';
181
199
  export { Canvas, type CanvasApplyOptions, type CanvasApplyResult, type CanvasBounds, type CanvasEditOptions, CanvasEditRejectedError, type CanvasEditResult, CanvasRenderImage, type CanvasRenderObject, type CanvasRenderOptions, CanvasRevisionConflictError, type CanvasScene, type CanvasSceneItem, type CanvasSceneOptions, type CanvasTextLayout, type CanvasUnavailable, } from './entities/canvases/canvas';
182
200
  export { ChannelAccessRequest } from './entities/channels/access-request';
183
201
  export { ChannelActivity } from './entities/channels/activity';
202
+ export type { MessageContext, MessageContextOptions, ReplyContext, } from './entities/channels/message';
184
203
  export { ChannelPicture } from './entities/channels/picture';
185
204
  export { ChatGeneration, ChatMessage } from './entities/chats/generation';
186
205
  export type { ConnectedAppKind, ConnectedToolResult, } from './entities/connected-apps/connected-app';
@@ -216,16 +235,22 @@ export { Meeting } from './entities/meetings/meeting';
216
235
  export type { ExplicitMemory, MemoryEdit, } from './entities/memory/namespace';
217
236
  export type { TimelineOptions } from './entities/messages/thread';
218
237
  export { type MessageParent, MessageThread } from './entities/messages/thread';
238
+ export type { AgentAccessRequest, AgentWake, DisclosedSecret, SecretSelector, VerificationCode, } from './entities/passwords/item';
239
+ export { PasswordItem } from './entities/passwords/item';
240
+ export { AgentVault, PasswordNamespace } from './entities/passwords/namespace';
219
241
  export type { EntityReference } from './entities/reference';
220
242
  export type { ReferralLink } from './entities/referrals/namespace';
221
243
  export type { RoutineEventFilter, RoutineTriggerOptions, SingleRoutineTrigger, } from './entities/routines/routine';
222
244
  export { Routine, RoutineExecution, type RoutineOptions, } from './entities/routines/routine';
245
+ export { RoutineSuggestion } from './entities/routines/suggestion';
223
246
  export { SavedView, type SavedViewConfig, } from './entities/saved-views/saved-view';
224
247
  export type { SearchOn, SearchOpts } from './entities/search/options';
225
248
  export type { SearchOptions, SearchPage, SearchPageOptions, SearchResult, SearchType, } from './entities/search/types';
226
249
  export { AccessRequest, EntityAccess } from './entities/sharing/access';
227
250
  export type { SharePermissionOptions } from './entities/sharing/permissions';
228
251
  export { RevisionConflictError, Spreadsheet, type SpreadsheetCalculateOptions, type SpreadsheetCalculation, type SpreadsheetEdited, type SpreadsheetEditOptions, type SpreadsheetRead, type SpreadsheetReadOptions, type SpreadsheetSheet, } from './entities/spreadsheets/spreadsheet';
252
+ export type { SuggestionInput, SuggestionsReview, } from './entities/suggestions/namespace';
253
+ export { Suggestion, type SuggestionChanges, type SuggestionItem, type SuggestionWriteOutcome, } from './entities/suggestions/suggestion';
229
254
  export type { TaskSummary } from './entities/tasks/task';
230
255
  export { TeamInvite } from './entities/teams/invite';
231
256
  export { ExternalProfilePicture, type ProfilePicture, } from './entities/users/profile-picture';