@archastro/sdk 0.5.3 → 0.7.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 (96) hide show
  1. package/README.md +25 -0
  2. package/dist/app-session.d.ts +66 -0
  3. package/dist/app-session.d.ts.map +1 -0
  4. package/dist/app-session.js +158 -0
  5. package/dist/app-session.js.map +1 -0
  6. package/dist/channels/api_chat_channel.d.ts +4 -0
  7. package/dist/channels/api_chat_channel.d.ts.map +1 -1
  8. package/dist/channels/api_chat_channel.js +9 -1
  9. package/dist/channels/api_chat_channel.js.map +1 -1
  10. package/dist/client.d.ts +4 -0
  11. package/dist/client.d.ts.map +1 -1
  12. package/dist/client.js +6 -1
  13. package/dist/client.js.map +1 -1
  14. package/dist/index.d.ts +1 -0
  15. package/dist/index.d.ts.map +1 -1
  16. package/dist/index.js +1 -1
  17. package/dist/index.js.map +1 -1
  18. package/dist/index.native.d.ts +14 -0
  19. package/dist/index.native.d.ts.map +1 -0
  20. package/dist/index.native.js +14 -0
  21. package/dist/index.native.js.map +1 -0
  22. package/dist/passwordless.d.ts +49 -0
  23. package/dist/passwordless.d.ts.map +1 -0
  24. package/dist/passwordless.js +70 -0
  25. package/dist/passwordless.js.map +1 -0
  26. package/dist/phx_channel/socket.d.ts.map +1 -1
  27. package/dist/phx_channel/socket.js +10 -22
  28. package/dist/phx_channel/socket.js.map +1 -1
  29. package/dist/phx_channel/websocket.d.ts +19 -0
  30. package/dist/phx_channel/websocket.d.ts.map +1 -0
  31. package/dist/phx_channel/websocket.js +28 -0
  32. package/dist/phx_channel/websocket.js.map +1 -0
  33. package/dist/phx_channel/websocket.native.d.ts +17 -0
  34. package/dist/phx_channel/websocket.native.d.ts.map +1 -0
  35. package/dist/phx_channel/websocket.native.js +16 -0
  36. package/dist/phx_channel/websocket.native.js.map +1 -0
  37. package/dist/platform-socket.d.ts +20 -0
  38. package/dist/platform-socket.d.ts.map +1 -0
  39. package/dist/platform-socket.js +25 -0
  40. package/dist/platform-socket.js.map +1 -0
  41. package/dist/runtime/http-client.d.ts +17 -0
  42. package/dist/runtime/http-client.d.ts.map +1 -1
  43. package/dist/runtime/http-client.js +123 -4
  44. package/dist/runtime/http-client.js.map +1 -1
  45. package/dist/runtime/url.d.ts +15 -0
  46. package/dist/runtime/url.d.ts.map +1 -0
  47. package/dist/runtime/url.js +34 -0
  48. package/dist/runtime/url.js.map +1 -0
  49. package/dist/types/ai.d.ts +271 -2
  50. package/dist/types/ai.d.ts.map +1 -1
  51. package/dist/types/ai.js +51 -1
  52. package/dist/types/ai.js.map +1 -1
  53. package/dist/types/chat.d.ts +142 -0
  54. package/dist/types/chat.d.ts.map +1 -1
  55. package/dist/types/common.d.ts +88 -27
  56. package/dist/types/common.d.ts.map +1 -1
  57. package/dist/types/common.js +12 -6
  58. package/dist/types/common.js.map +1 -1
  59. package/dist/types/config.d.ts +6 -6
  60. package/dist/types/teams.d.ts +12 -0
  61. package/dist/types/teams.d.ts.map +1 -1
  62. package/dist/types/threads.d.ts +10 -0
  63. package/dist/types/threads.d.ts.map +1 -1
  64. package/dist/v1/resources/activity_feed.d.ts +1 -0
  65. package/dist/v1/resources/activity_feed.d.ts.map +1 -1
  66. package/dist/v1/resources/activity_feed.js +1 -1
  67. package/dist/v1/resources/agents.d.ts +3 -1
  68. package/dist/v1/resources/agents.d.ts.map +1 -1
  69. package/dist/v1/resources/agents.js +3 -2
  70. package/dist/v1/resources/agents.js.map +1 -1
  71. package/dist/v1/resources/ai.d.ts +81 -3
  72. package/dist/v1/resources/ai.d.ts.map +1 -1
  73. package/dist/v1/resources/ai.js +26 -3
  74. package/dist/v1/resources/ai.js.map +1 -1
  75. package/dist/v1/resources/config.d.ts +8 -0
  76. package/dist/v1/resources/config.d.ts.map +1 -1
  77. package/dist/v1/resources/config.js +5 -1
  78. package/dist/v1/resources/config.js.map +1 -1
  79. package/dist/v1/resources/solutions.d.ts +11 -7
  80. package/dist/v1/resources/solutions.d.ts.map +1 -1
  81. package/dist/v1/resources/solutions.js +12 -8
  82. package/dist/v1/resources/solutions.js.map +1 -1
  83. package/dist/v1/resources/teams.d.ts +3 -0
  84. package/dist/v1/resources/teams.d.ts.map +1 -1
  85. package/dist/v1/resources/teams.js +1 -1
  86. package/dist/v1/resources/threads.d.ts +24 -4
  87. package/dist/v1/resources/threads.d.ts.map +1 -1
  88. package/dist/v1/resources/threads.js +37 -5
  89. package/dist/v1/resources/threads.js.map +1 -1
  90. package/dist/v1/resources/users.d.ts +2 -0
  91. package/dist/v1/resources/users.d.ts.map +1 -1
  92. package/dist/v1/resources/users.js +1 -1
  93. package/docs/authentication.md +91 -0
  94. package/docs/react-native.md +118 -0
  95. package/docs/scenarios.md +57 -0
  96. package/package.json +28 -6
@@ -229,6 +229,7 @@ export interface ActivityFeedEntry {
229
229
  };
230
230
  } | undefined;
231
231
  team?: string | undefined;
232
+ template_upgrade_available?: boolean | undefined;
232
233
  updated_at?: string | undefined;
233
234
  user?: string | undefined;
234
235
  } | undefined;
@@ -677,6 +678,7 @@ export declare const activityFeedEntrySchema: z.ZodObject<{
677
678
  };
678
679
  }>>;
679
680
  team: z.ZodOptional<z.ZodString>;
681
+ template_upgrade_available: z.ZodOptional<z.ZodBoolean>;
680
682
  updated_at: z.ZodOptional<z.ZodString>;
681
683
  user: z.ZodOptional<z.ZodString>;
682
684
  }, "strip", z.ZodTypeAny, {
@@ -770,6 +772,7 @@ export declare const activityFeedEntrySchema: z.ZodObject<{
770
772
  display_name?: string | undefined;
771
773
  };
772
774
  } | undefined;
775
+ template_upgrade_available?: boolean | undefined;
773
776
  }, {
774
777
  id: string;
775
778
  email?: string | undefined;
@@ -861,6 +864,7 @@ export declare const activityFeedEntrySchema: z.ZodObject<{
861
864
  display_name?: string | undefined;
862
865
  };
863
866
  } | undefined;
867
+ template_upgrade_available?: boolean | undefined;
864
868
  }>]>>;
865
869
  /** ID of the application that produced this entry (`dap_...`). `null` if not scoped to an app. */
866
870
  app: z.ZodOptional<z.ZodString>;
@@ -1038,6 +1042,7 @@ export declare const activityFeedEntrySchema: z.ZodObject<{
1038
1042
  display_name?: string | undefined;
1039
1043
  };
1040
1044
  } | undefined;
1045
+ template_upgrade_available?: boolean | undefined;
1041
1046
  } | undefined;
1042
1047
  thread?: string | undefined;
1043
1048
  team?: string | undefined;
@@ -1164,6 +1169,7 @@ export declare const activityFeedEntrySchema: z.ZodObject<{
1164
1169
  display_name?: string | undefined;
1165
1170
  };
1166
1171
  } | undefined;
1172
+ template_upgrade_available?: boolean | undefined;
1167
1173
  } | undefined;
1168
1174
  thread?: string | undefined;
1169
1175
  team?: string | undefined;
@@ -1604,6 +1610,7 @@ export declare const activityFeedEntryListResponseSchema: z.ZodObject<{
1604
1610
  };
1605
1611
  }>>;
1606
1612
  team: z.ZodOptional<z.ZodString>;
1613
+ template_upgrade_available: z.ZodOptional<z.ZodBoolean>;
1607
1614
  updated_at: z.ZodOptional<z.ZodString>;
1608
1615
  user: z.ZodOptional<z.ZodString>;
1609
1616
  }, "strip", z.ZodTypeAny, {
@@ -1697,6 +1704,7 @@ export declare const activityFeedEntryListResponseSchema: z.ZodObject<{
1697
1704
  display_name?: string | undefined;
1698
1705
  };
1699
1706
  } | undefined;
1707
+ template_upgrade_available?: boolean | undefined;
1700
1708
  }, {
1701
1709
  id: string;
1702
1710
  email?: string | undefined;
@@ -1788,6 +1796,7 @@ export declare const activityFeedEntryListResponseSchema: z.ZodObject<{
1788
1796
  display_name?: string | undefined;
1789
1797
  };
1790
1798
  } | undefined;
1799
+ template_upgrade_available?: boolean | undefined;
1791
1800
  }>]>>;
1792
1801
  /** ID of the application that produced this entry (`dap_...`). `null` if not scoped to an app. */
1793
1802
  app: z.ZodOptional<z.ZodString>;
@@ -1965,6 +1974,7 @@ export declare const activityFeedEntryListResponseSchema: z.ZodObject<{
1965
1974
  display_name?: string | undefined;
1966
1975
  };
1967
1976
  } | undefined;
1977
+ template_upgrade_available?: boolean | undefined;
1968
1978
  } | undefined;
1969
1979
  thread?: string | undefined;
1970
1980
  team?: string | undefined;
@@ -2091,6 +2101,7 @@ export declare const activityFeedEntryListResponseSchema: z.ZodObject<{
2091
2101
  display_name?: string | undefined;
2092
2102
  };
2093
2103
  } | undefined;
2104
+ template_upgrade_available?: boolean | undefined;
2094
2105
  } | undefined;
2095
2106
  thread?: string | undefined;
2096
2107
  team?: string | undefined;
@@ -2221,6 +2232,7 @@ export declare const activityFeedEntryListResponseSchema: z.ZodObject<{
2221
2232
  display_name?: string | undefined;
2222
2233
  };
2223
2234
  } | undefined;
2235
+ template_upgrade_available?: boolean | undefined;
2224
2236
  } | undefined;
2225
2237
  thread?: string | undefined;
2226
2238
  team?: string | undefined;
@@ -2352,6 +2364,7 @@ export declare const activityFeedEntryListResponseSchema: z.ZodObject<{
2352
2364
  display_name?: string | undefined;
2353
2365
  };
2354
2366
  } | undefined;
2367
+ template_upgrade_available?: boolean | undefined;
2355
2368
  } | undefined;
2356
2369
  thread?: string | undefined;
2357
2370
  team?: string | undefined;
@@ -3370,6 +3383,8 @@ export interface Message {
3370
3383
  actors?: Actor[] | undefined;
3371
3384
  /** ID of the agent user that sent this message (`agi_...`). `null` for messages sent by human users. */
3372
3385
  agent?: string | undefined;
3386
+ /** Local agent execution mode for this message. One of `cli`, `embedded`, or `null` when the message was not created by a local agent execution path. */
3387
+ agent_mode?: "cli" | "embedded" | undefined;
3373
3388
  /** Files, links, tasks, media, artifacts, and actions attached to this message. Empty array if there are no attachments. */
3374
3389
  attachments?: Attachment[] | undefined;
3375
3390
  /** ID of the thread that was branched from this message (`thr_...`). `null` if this message has not spawned a branch thread. */
@@ -3478,6 +3493,8 @@ export declare const messageSchema: z.ZodObject<{
3478
3493
  }>, "many">>;
3479
3494
  /** ID of the agent user that sent this message (`agi_...`). `null` for messages sent by human users. */
3480
3495
  agent: z.ZodOptional<z.ZodString>;
3496
+ /** Local agent execution mode for this message. One of `cli`, `embedded`, or `null` when the message was not created by a local agent execution path. */
3497
+ agent_mode: z.ZodOptional<z.ZodEnum<["cli", "embedded"]>>;
3481
3498
  /** Files, links, tasks, media, artifacts, and actions attached to this message. Empty array if there are no attachments. */
3482
3499
  attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
3483
3500
  /** MIME type of the attached file, e.g. `"image/png"` or `"application/pdf"`. Present on `file`, `artifact`, and `media` types. `null` otherwise. */
@@ -3850,6 +3867,7 @@ export declare const messageSchema: z.ZodObject<{
3850
3867
  width?: number | undefined;
3851
3868
  } | undefined;
3852
3869
  }[] | undefined;
3870
+ agent_mode?: "cli" | "embedded" | undefined;
3853
3871
  branched_thread?: string | undefined;
3854
3872
  has_replies?: boolean | undefined;
3855
3873
  idempotency_key?: string | undefined;
@@ -3938,6 +3956,7 @@ export declare const messageSchema: z.ZodObject<{
3938
3956
  width?: number | undefined;
3939
3957
  } | undefined;
3940
3958
  }[] | undefined;
3959
+ agent_mode?: "cli" | "embedded" | undefined;
3941
3960
  branched_thread?: string | undefined;
3942
3961
  has_replies?: boolean | undefined;
3943
3962
  idempotency_key?: string | undefined;
@@ -4515,7 +4534,7 @@ export interface AgentHealthAction {
4515
4534
  last_verifier_message?: string | undefined;
4516
4535
  /** ID of the organization this action is associated with (`org_...`). `null` when not org-scoped. */
4517
4536
  org?: string | undefined;
4518
- /** Kind-specific structured data used to construct the deep-link for this action. For `"env_var"` actions includes `key` and `scope`; for `"install"` actions includes `installation_kind`; for `"integration"` actions includes `mcp_server_ref`, and when resolvable also includes `provider` and `integration_id` for OAuth handoff. Empty object `{}` when no additional parameters are needed. */
4537
+ /** Kind-specific structured data used to construct the deep-link for this action. For `"env_var"` actions includes `key` and `scope`; for `"install"` actions includes `installation_kind`; for `"integration"` actions includes `mcp_server_ref`, and when resolvable also includes `provider`, `integration_id` for OAuth handoff, and `connection_status` (`"connected"`, `"disconnected"`, or `"token_expired"`). Empty object `{}` when no additional parameters are needed. */
4519
4538
  params?: Record<string, unknown> | undefined;
4520
4539
  /** `true` if this action must be completed before the agent is considered fully operational and counts toward the blocking checklist progress bar. */
4521
4540
  required: boolean;
@@ -4554,7 +4573,7 @@ export declare const agentHealthActionSchema: z.ZodObject<{
4554
4573
  last_verifier_message: z.ZodOptional<z.ZodString>;
4555
4574
  /** ID of the organization this action is associated with (`org_...`). `null` when not org-scoped. */
4556
4575
  org: z.ZodOptional<z.ZodString>;
4557
- /** Kind-specific structured data used to construct the deep-link for this action. For `"env_var"` actions includes `key` and `scope`; for `"install"` actions includes `installation_kind`; for `"integration"` actions includes `mcp_server_ref`, and when resolvable also includes `provider` and `integration_id` for OAuth handoff. Empty object `{}` when no additional parameters are needed. */
4576
+ /** Kind-specific structured data used to construct the deep-link for this action. For `"env_var"` actions includes `key` and `scope`; for `"install"` actions includes `installation_kind`; for `"integration"` actions includes `mcp_server_ref`, and when resolvable also includes `provider`, `integration_id` for OAuth handoff, and `connection_status` (`"connected"`, `"disconnected"`, or `"token_expired"`). Empty object `{}` when no additional parameters are needed. */
4558
4577
  params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
4559
4578
  /** `true` if this action must be completed before the agent is considered fully operational and counts toward the blocking checklist progress bar. */
4560
4579
  required: z.ZodBoolean;
@@ -4638,7 +4657,7 @@ export declare const healthActionListResponseSchema: z.ZodObject<{
4638
4657
  last_verifier_message: z.ZodOptional<z.ZodString>;
4639
4658
  /** ID of the organization this action is associated with (`org_...`). `null` when not org-scoped. */
4640
4659
  org: z.ZodOptional<z.ZodString>;
4641
- /** Kind-specific structured data used to construct the deep-link for this action. For `"env_var"` actions includes `key` and `scope`; for `"install"` actions includes `installation_kind`; for `"integration"` actions includes `mcp_server_ref`, and when resolvable also includes `provider` and `integration_id` for OAuth handoff. Empty object `{}` when no additional parameters are needed. */
4660
+ /** Kind-specific structured data used to construct the deep-link for this action. For `"env_var"` actions includes `key` and `scope`; for `"install"` actions includes `installation_kind`; for `"integration"` actions includes `mcp_server_ref`, and when resolvable also includes `provider`, `integration_id` for OAuth handoff, and `connection_status` (`"connected"`, `"disconnected"`, or `"token_expired"`). Empty object `{}` when no additional parameters are needed. */
4642
4661
  params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
4643
4662
  /** `true` if this action must be completed before the agent is considered fully operational and counts toward the blocking checklist progress bar. */
4644
4663
  required: z.ZodBoolean;
@@ -5215,14 +5234,14 @@ export declare const keyValueStorageEntrySchema: z.ZodObject<{
5215
5234
  /** The string value stored under `key` for this user. */
5216
5235
  value: z.ZodString;
5217
5236
  }, "strip", z.ZodTypeAny, {
5218
- key: string;
5219
5237
  value: string;
5238
+ key: string;
5220
5239
  user: string;
5221
5240
  created_at?: string | undefined;
5222
5241
  updated_at?: string | undefined;
5223
5242
  }, {
5224
- key: string;
5225
5243
  value: string;
5244
+ key: string;
5226
5245
  user: string;
5227
5246
  created_at?: string | undefined;
5228
5247
  updated_at?: string | undefined;
@@ -5261,16 +5280,16 @@ export declare const keyValueStorageEntryWithUserSchema: z.ZodObject<{
5261
5280
  /** The string value stored under `key` for this user. */
5262
5281
  value: z.ZodString;
5263
5282
  }, "strip", z.ZodTypeAny, {
5264
- key: string;
5265
5283
  value: string;
5284
+ key: string;
5266
5285
  created_at: string;
5267
5286
  updated_at: string;
5268
5287
  user: string;
5269
5288
  user_email?: string | undefined;
5270
5289
  user_name?: string | undefined;
5271
5290
  }, {
5272
- key: string;
5273
5291
  value: string;
5292
+ key: string;
5274
5293
  created_at: string;
5275
5294
  updated_at: string;
5276
5295
  user: string;
@@ -5313,16 +5332,16 @@ export declare const keyValueStorageEntryPageSchema: z.ZodObject<{
5313
5332
  /** The string value stored under `key` for this user. */
5314
5333
  value: z.ZodString;
5315
5334
  }, "strip", z.ZodTypeAny, {
5316
- key: string;
5317
5335
  value: string;
5336
+ key: string;
5318
5337
  created_at: string;
5319
5338
  updated_at: string;
5320
5339
  user: string;
5321
5340
  user_email?: string | undefined;
5322
5341
  user_name?: string | undefined;
5323
5342
  }, {
5324
- key: string;
5325
5343
  value: string;
5344
+ key: string;
5326
5345
  created_at: string;
5327
5346
  updated_at: string;
5328
5347
  user: string;
@@ -5343,8 +5362,8 @@ export declare const keyValueStorageEntryPageSchema: z.ZodObject<{
5343
5362
  total_pages: z.ZodOptional<z.ZodNumber>;
5344
5363
  }, "strip", z.ZodTypeAny, {
5345
5364
  data: {
5346
- key: string;
5347
5365
  value: string;
5366
+ key: string;
5348
5367
  created_at: string;
5349
5368
  updated_at: string;
5350
5369
  user: string;
@@ -5359,8 +5378,8 @@ export declare const keyValueStorageEntryPageSchema: z.ZodObject<{
5359
5378
  total_pages?: number | undefined;
5360
5379
  }, {
5361
5380
  data: {
5362
- key: string;
5363
5381
  value: string;
5382
+ key: string;
5364
5383
  created_at: string;
5365
5384
  updated_at: string;
5366
5385
  user: string;
@@ -5735,6 +5754,8 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
5735
5754
  }>, "many">>;
5736
5755
  /** ID of the agent user that sent this message (`agi_...`). `null` for messages sent by human users. */
5737
5756
  agent: z.ZodOptional<z.ZodString>;
5757
+ /** Local agent execution mode for this message. One of `cli`, `embedded`, or `null` when the message was not created by a local agent execution path. */
5758
+ agent_mode: z.ZodOptional<z.ZodEnum<["cli", "embedded"]>>;
5738
5759
  /** Files, links, tasks, media, artifacts, and actions attached to this message. Empty array if there are no attachments. */
5739
5760
  attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
5740
5761
  /** MIME type of the attached file, e.g. `"image/png"` or `"application/pdf"`. Present on `file`, `artifact`, and `media` types. `null` otherwise. */
@@ -6107,6 +6128,7 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
6107
6128
  width?: number | undefined;
6108
6129
  } | undefined;
6109
6130
  }[] | undefined;
6131
+ agent_mode?: "cli" | "embedded" | undefined;
6110
6132
  branched_thread?: string | undefined;
6111
6133
  has_replies?: boolean | undefined;
6112
6134
  idempotency_key?: string | undefined;
@@ -6195,6 +6217,7 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
6195
6217
  width?: number | undefined;
6196
6218
  } | undefined;
6197
6219
  }[] | undefined;
6220
+ agent_mode?: "cli" | "embedded" | undefined;
6198
6221
  branched_thread?: string | undefined;
6199
6222
  has_replies?: boolean | undefined;
6200
6223
  idempotency_key?: string | undefined;
@@ -6287,6 +6310,7 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
6287
6310
  width?: number | undefined;
6288
6311
  } | undefined;
6289
6312
  }[] | undefined;
6313
+ agent_mode?: "cli" | "embedded" | undefined;
6290
6314
  branched_thread?: string | undefined;
6291
6315
  has_replies?: boolean | undefined;
6292
6316
  idempotency_key?: string | undefined;
@@ -6381,6 +6405,7 @@ export declare const paginatedRepliesSchema: z.ZodObject<{
6381
6405
  width?: number | undefined;
6382
6406
  } | undefined;
6383
6407
  }[] | undefined;
6408
+ agent_mode?: "cli" | "embedded" | undefined;
6384
6409
  branched_thread?: string | undefined;
6385
6410
  has_replies?: boolean | undefined;
6386
6411
  idempotency_key?: string | undefined;
@@ -6756,16 +6781,16 @@ export declare const workingMemoryEntrySchema: z.ZodObject<{
6756
6781
  value: z.ZodOptional<z.ZodString>;
6757
6782
  }, "strip", z.ZodTypeAny, {
6758
6783
  id: string;
6759
- key?: string | undefined;
6760
6784
  value?: string | undefined;
6785
+ key?: string | undefined;
6761
6786
  agent?: string | undefined;
6762
6787
  created_at?: string | undefined;
6763
6788
  updated_at?: string | undefined;
6764
6789
  expires_at?: string | undefined;
6765
6790
  }, {
6766
6791
  id: string;
6767
- key?: string | undefined;
6768
6792
  value?: string | undefined;
6793
+ key?: string | undefined;
6769
6794
  agent?: string | undefined;
6770
6795
  created_at?: string | undefined;
6771
6796
  updated_at?: string | undefined;
@@ -6808,16 +6833,16 @@ export declare const workingMemoryEntryListResponseSchema: z.ZodObject<{
6808
6833
  value: z.ZodOptional<z.ZodString>;
6809
6834
  }, "strip", z.ZodTypeAny, {
6810
6835
  id: string;
6811
- key?: string | undefined;
6812
6836
  value?: string | undefined;
6837
+ key?: string | undefined;
6813
6838
  agent?: string | undefined;
6814
6839
  created_at?: string | undefined;
6815
6840
  updated_at?: string | undefined;
6816
6841
  expires_at?: string | undefined;
6817
6842
  }, {
6818
6843
  id: string;
6819
- key?: string | undefined;
6820
6844
  value?: string | undefined;
6845
+ key?: string | undefined;
6821
6846
  agent?: string | undefined;
6822
6847
  created_at?: string | undefined;
6823
6848
  updated_at?: string | undefined;
@@ -6838,8 +6863,8 @@ export declare const workingMemoryEntryListResponseSchema: z.ZodObject<{
6838
6863
  }, "strip", z.ZodTypeAny, {
6839
6864
  data: {
6840
6865
  id: string;
6841
- key?: string | undefined;
6842
6866
  value?: string | undefined;
6867
+ key?: string | undefined;
6843
6868
  agent?: string | undefined;
6844
6869
  created_at?: string | undefined;
6845
6870
  updated_at?: string | undefined;
@@ -6854,8 +6879,8 @@ export declare const workingMemoryEntryListResponseSchema: z.ZodObject<{
6854
6879
  }, {
6855
6880
  data: {
6856
6881
  id: string;
6857
- key?: string | undefined;
6858
6882
  value?: string | undefined;
6883
+ key?: string | undefined;
6859
6884
  agent?: string | undefined;
6860
6885
  created_at?: string | undefined;
6861
6886
  updated_at?: string | undefined;
@@ -7565,6 +7590,8 @@ export interface Agent {
7565
7590
  source_solution?: AgentSourceSolution | undefined;
7566
7591
  /** ID of the team that owns this agent (`tem_...`). `null` if the agent is not team-scoped. */
7567
7592
  team?: string | undefined;
7593
+ /** True when the agent's last-applied template version is behind the current version of its AgentTemplate config — i.e. reapplying the template (a per-agent upgrade) would bring it newer Solution content. Self-clears once the agent is reapplied. Computed only on list endpoints; `null` on single-agent GET. */
7594
+ template_upgrade_available?: boolean | undefined;
7568
7595
  /** When the agent was last modified (ISO 8601). */
7569
7596
  updated_at?: string | undefined;
7570
7597
  /** ID of the user that owns this agent (`usr_...`). `null` if the agent is not user-scoped. */
@@ -8032,6 +8059,8 @@ export declare const agentSchema: z.ZodObject<{
8032
8059
  }>>;
8033
8060
  /** ID of the team that owns this agent (`tem_...`). `null` if the agent is not team-scoped. */
8034
8061
  team: z.ZodOptional<z.ZodString>;
8062
+ /** True when the agent's last-applied template version is behind the current version of its AgentTemplate config — i.e. reapplying the template (a per-agent upgrade) would bring it newer Solution content. Self-clears once the agent is reapplied. Computed only on list endpoints; `null` on single-agent GET. */
8063
+ template_upgrade_available: z.ZodOptional<z.ZodBoolean>;
8035
8064
  /** When the agent was last modified (ISO 8601). */
8036
8065
  updated_at: z.ZodOptional<z.ZodString>;
8037
8066
  /** ID of the user that owns this agent (`usr_...`). `null` if the agent is not user-scoped. */
@@ -8127,6 +8156,7 @@ export declare const agentSchema: z.ZodObject<{
8127
8156
  display_name?: string | undefined;
8128
8157
  };
8129
8158
  } | undefined;
8159
+ template_upgrade_available?: boolean | undefined;
8130
8160
  }, {
8131
8161
  id: string;
8132
8162
  email?: string | undefined;
@@ -8218,6 +8248,7 @@ export declare const agentSchema: z.ZodObject<{
8218
8248
  display_name?: string | undefined;
8219
8249
  };
8220
8250
  } | undefined;
8251
+ template_upgrade_available?: boolean | undefined;
8221
8252
  }>;
8222
8253
  /** A cloud computer resource provisioned for an agent to use for browser and desktop automation tasks. */
8223
8254
  export interface AgentComputer {
@@ -8241,7 +8272,9 @@ export interface AgentComputer {
8241
8272
  metadata?: Record<string, unknown> | undefined;
8242
8273
  /** Human-readable display name for the computer. `null` if not set. */
8243
8274
  name?: string | undefined;
8244
- /** Cloud region where the computer is hosted, e.g. `"us-east-1"`. `null` if not yet assigned. */
8275
+ /** Compute backend powering this computer: `"sprites"` (Fly Sprites) or `"vercel"` (Vercel Sandbox). */
8276
+ provider?: string | undefined;
8277
+ /** Cloud region where the computer is hosted, e.g. `"us-east-1"`. `null` if not yet assigned or when the provider has no region concept (e.g. `"vercel"`). */
8245
8278
  region?: string | undefined;
8246
8279
  /** URL of the live screenshot sprite used to render a real-time preview of the computer's screen. `null` when no sprite is available. */
8247
8280
  sprite_url?: string | undefined;
@@ -8272,7 +8305,9 @@ export declare const agentComputerSchema: z.ZodObject<{
8272
8305
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
8273
8306
  /** Human-readable display name for the computer. `null` if not set. */
8274
8307
  name: z.ZodOptional<z.ZodString>;
8275
- /** Cloud region where the computer is hosted, e.g. `"us-east-1"`. `null` if not yet assigned. */
8308
+ /** Compute backend powering this computer: `"sprites"` (Fly Sprites) or `"vercel"` (Vercel Sandbox). */
8309
+ provider: z.ZodOptional<z.ZodString>;
8310
+ /** Cloud region where the computer is hosted, e.g. `"us-east-1"`. `null` if not yet assigned or when the provider has no region concept (e.g. `"vercel"`). */
8276
8311
  region: z.ZodOptional<z.ZodString>;
8277
8312
  /** URL of the live screenshot sprite used to render a real-time preview of the computer's screen. `null` when no sprite is available. */
8278
8313
  sprite_url: z.ZodOptional<z.ZodString>;
@@ -8291,6 +8326,7 @@ export declare const agentComputerSchema: z.ZodObject<{
8291
8326
  app?: string | undefined;
8292
8327
  metadata?: Record<string, unknown> | undefined;
8293
8328
  config?: Record<string, unknown> | undefined;
8329
+ provider?: string | undefined;
8294
8330
  error_message?: string | undefined;
8295
8331
  last_active_at?: string | undefined;
8296
8332
  region?: string | undefined;
@@ -8306,6 +8342,7 @@ export declare const agentComputerSchema: z.ZodObject<{
8306
8342
  app?: string | undefined;
8307
8343
  metadata?: Record<string, unknown> | undefined;
8308
8344
  config?: Record<string, unknown> | undefined;
8345
+ provider?: string | undefined;
8309
8346
  error_message?: string | undefined;
8310
8347
  last_active_at?: string | undefined;
8311
8348
  region?: string | undefined;
@@ -8340,7 +8377,9 @@ export declare const agentComputerListResponseSchema: z.ZodObject<{
8340
8377
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
8341
8378
  /** Human-readable display name for the computer. `null` if not set. */
8342
8379
  name: z.ZodOptional<z.ZodString>;
8343
- /** Cloud region where the computer is hosted, e.g. `"us-east-1"`. `null` if not yet assigned. */
8380
+ /** Compute backend powering this computer: `"sprites"` (Fly Sprites) or `"vercel"` (Vercel Sandbox). */
8381
+ provider: z.ZodOptional<z.ZodString>;
8382
+ /** Cloud region where the computer is hosted, e.g. `"us-east-1"`. `null` if not yet assigned or when the provider has no region concept (e.g. `"vercel"`). */
8344
8383
  region: z.ZodOptional<z.ZodString>;
8345
8384
  /** URL of the live screenshot sprite used to render a real-time preview of the computer's screen. `null` when no sprite is available. */
8346
8385
  sprite_url: z.ZodOptional<z.ZodString>;
@@ -8359,6 +8398,7 @@ export declare const agentComputerListResponseSchema: z.ZodObject<{
8359
8398
  app?: string | undefined;
8360
8399
  metadata?: Record<string, unknown> | undefined;
8361
8400
  config?: Record<string, unknown> | undefined;
8401
+ provider?: string | undefined;
8362
8402
  error_message?: string | undefined;
8363
8403
  last_active_at?: string | undefined;
8364
8404
  region?: string | undefined;
@@ -8374,6 +8414,7 @@ export declare const agentComputerListResponseSchema: z.ZodObject<{
8374
8414
  app?: string | undefined;
8375
8415
  metadata?: Record<string, unknown> | undefined;
8376
8416
  config?: Record<string, unknown> | undefined;
8417
+ provider?: string | undefined;
8377
8418
  error_message?: string | undefined;
8378
8419
  last_active_at?: string | undefined;
8379
8420
  region?: string | undefined;
@@ -8391,6 +8432,7 @@ export declare const agentComputerListResponseSchema: z.ZodObject<{
8391
8432
  app?: string | undefined;
8392
8433
  metadata?: Record<string, unknown> | undefined;
8393
8434
  config?: Record<string, unknown> | undefined;
8435
+ provider?: string | undefined;
8394
8436
  error_message?: string | undefined;
8395
8437
  last_active_at?: string | undefined;
8396
8438
  region?: string | undefined;
@@ -8408,6 +8450,7 @@ export declare const agentComputerListResponseSchema: z.ZodObject<{
8408
8450
  app?: string | undefined;
8409
8451
  metadata?: Record<string, unknown> | undefined;
8410
8452
  config?: Record<string, unknown> | undefined;
8453
+ provider?: string | undefined;
8411
8454
  error_message?: string | undefined;
8412
8455
  last_active_at?: string | undefined;
8413
8456
  region?: string | undefined;
@@ -8803,20 +8846,20 @@ export declare const agentExportSchema: z.ZodObject<{
8803
8846
  }, "strip", z.ZodTypeAny, {
8804
8847
  id: string;
8805
8848
  version_number: number;
8849
+ data?: Record<string, unknown> | undefined;
8806
8850
  org?: string | undefined;
8807
8851
  change_description?: string | undefined;
8808
8852
  content_hash?: string | undefined;
8809
8853
  created_at?: string | undefined;
8810
- data?: Record<string, unknown> | undefined;
8811
8854
  sandbox?: string | undefined;
8812
8855
  }, {
8813
8856
  id: string;
8814
8857
  version_number: number;
8858
+ data?: Record<string, unknown> | undefined;
8815
8859
  org?: string | undefined;
8816
8860
  change_description?: string | undefined;
8817
8861
  content_hash?: string | undefined;
8818
8862
  created_at?: string | undefined;
8819
- data?: Record<string, unknown> | undefined;
8820
8863
  sandbox?: string | undefined;
8821
8864
  }>>;
8822
8865
  id: z.ZodString;
@@ -8845,11 +8888,11 @@ export declare const agentExportSchema: z.ZodObject<{
8845
8888
  current_version?: {
8846
8889
  id: string;
8847
8890
  version_number: number;
8891
+ data?: Record<string, unknown> | undefined;
8848
8892
  org?: string | undefined;
8849
8893
  change_description?: string | undefined;
8850
8894
  content_hash?: string | undefined;
8851
8895
  created_at?: string | undefined;
8852
- data?: Record<string, unknown> | undefined;
8853
8896
  sandbox?: string | undefined;
8854
8897
  } | undefined;
8855
8898
  is_archived?: boolean | undefined;
@@ -8873,11 +8916,11 @@ export declare const agentExportSchema: z.ZodObject<{
8873
8916
  current_version?: {
8874
8917
  id: string;
8875
8918
  version_number: number;
8919
+ data?: Record<string, unknown> | undefined;
8876
8920
  org?: string | undefined;
8877
8921
  change_description?: string | undefined;
8878
8922
  content_hash?: string | undefined;
8879
8923
  created_at?: string | undefined;
8880
- data?: Record<string, unknown> | undefined;
8881
8924
  sandbox?: string | undefined;
8882
8925
  } | undefined;
8883
8926
  is_archived?: boolean | undefined;
@@ -8906,11 +8949,11 @@ export declare const agentExportSchema: z.ZodObject<{
8906
8949
  current_version?: {
8907
8950
  id: string;
8908
8951
  version_number: number;
8952
+ data?: Record<string, unknown> | undefined;
8909
8953
  org?: string | undefined;
8910
8954
  change_description?: string | undefined;
8911
8955
  content_hash?: string | undefined;
8912
8956
  created_at?: string | undefined;
8913
- data?: Record<string, unknown> | undefined;
8914
8957
  sandbox?: string | undefined;
8915
8958
  } | undefined;
8916
8959
  is_archived?: boolean | undefined;
@@ -8937,11 +8980,11 @@ export declare const agentExportSchema: z.ZodObject<{
8937
8980
  current_version?: {
8938
8981
  id: string;
8939
8982
  version_number: number;
8983
+ data?: Record<string, unknown> | undefined;
8940
8984
  org?: string | undefined;
8941
8985
  change_description?: string | undefined;
8942
8986
  content_hash?: string | undefined;
8943
8987
  created_at?: string | undefined;
8944
- data?: Record<string, unknown> | undefined;
8945
8988
  sandbox?: string | undefined;
8946
8989
  } | undefined;
8947
8990
  is_archived?: boolean | undefined;
@@ -9443,6 +9486,8 @@ export declare const agentHealthSchema: z.ZodObject<{
9443
9486
  }>>;
9444
9487
  /** ID of the team that owns this agent (`tem_...`). `null` if the agent is not team-scoped. */
9445
9488
  team: z.ZodOptional<z.ZodString>;
9489
+ /** True when the agent's last-applied template version is behind the current version of its AgentTemplate config — i.e. reapplying the template (a per-agent upgrade) would bring it newer Solution content. Self-clears once the agent is reapplied. Computed only on list endpoints; `null` on single-agent GET. */
9490
+ template_upgrade_available: z.ZodOptional<z.ZodBoolean>;
9446
9491
  /** When the agent was last modified (ISO 8601). */
9447
9492
  updated_at: z.ZodOptional<z.ZodString>;
9448
9493
  /** ID of the user that owns this agent (`usr_...`). `null` if the agent is not user-scoped. */
@@ -9538,6 +9583,7 @@ export declare const agentHealthSchema: z.ZodObject<{
9538
9583
  display_name?: string | undefined;
9539
9584
  };
9540
9585
  } | undefined;
9586
+ template_upgrade_available?: boolean | undefined;
9541
9587
  }, {
9542
9588
  id: string;
9543
9589
  email?: string | undefined;
@@ -9629,6 +9675,7 @@ export declare const agentHealthSchema: z.ZodObject<{
9629
9675
  display_name?: string | undefined;
9630
9676
  };
9631
9677
  } | undefined;
9678
+ template_upgrade_available?: boolean | undefined;
9632
9679
  }>;
9633
9680
  /** When the health profile was last computed (ISO 8601). */
9634
9681
  checked_at: z.ZodString;
@@ -9658,7 +9705,7 @@ export declare const agentHealthSchema: z.ZodObject<{
9658
9705
  last_verifier_message: z.ZodOptional<z.ZodString>;
9659
9706
  /** ID of the organization this action is associated with (`org_...`). `null` when not org-scoped. */
9660
9707
  org: z.ZodOptional<z.ZodString>;
9661
- /** Kind-specific structured data used to construct the deep-link for this action. For `"env_var"` actions includes `key` and `scope`; for `"install"` actions includes `installation_kind`; for `"integration"` actions includes `mcp_server_ref`, and when resolvable also includes `provider` and `integration_id` for OAuth handoff. Empty object `{}` when no additional parameters are needed. */
9708
+ /** Kind-specific structured data used to construct the deep-link for this action. For `"env_var"` actions includes `key` and `scope`; for `"install"` actions includes `installation_kind`; for `"integration"` actions includes `mcp_server_ref`, and when resolvable also includes `provider`, `integration_id` for OAuth handoff, and `connection_status` (`"connected"`, `"disconnected"`, or `"token_expired"`). Empty object `{}` when no additional parameters are needed. */
9662
9709
  params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
9663
9710
  /** `true` if this action must be completed before the agent is considered fully operational and counts toward the blocking checklist progress bar. */
9664
9711
  required: z.ZodBoolean;
@@ -9811,6 +9858,7 @@ export declare const agentHealthSchema: z.ZodObject<{
9811
9858
  display_name?: string | undefined;
9812
9859
  };
9813
9860
  } | undefined;
9861
+ template_upgrade_available?: boolean | undefined;
9814
9862
  };
9815
9863
  status: string;
9816
9864
  activity: Record<string, unknown>;
@@ -9931,6 +9979,7 @@ export declare const agentHealthSchema: z.ZodObject<{
9931
9979
  display_name?: string | undefined;
9932
9980
  };
9933
9981
  } | undefined;
9982
+ template_upgrade_available?: boolean | undefined;
9934
9983
  };
9935
9984
  status: string;
9936
9985
  activity: Record<string, unknown>;
@@ -10441,6 +10490,8 @@ export declare const agentListResponseSchema: z.ZodObject<{
10441
10490
  }>>;
10442
10491
  /** ID of the team that owns this agent (`tem_...`). `null` if the agent is not team-scoped. */
10443
10492
  team: z.ZodOptional<z.ZodString>;
10493
+ /** True when the agent's last-applied template version is behind the current version of its AgentTemplate config — i.e. reapplying the template (a per-agent upgrade) would bring it newer Solution content. Self-clears once the agent is reapplied. Computed only on list endpoints; `null` on single-agent GET. */
10494
+ template_upgrade_available: z.ZodOptional<z.ZodBoolean>;
10444
10495
  /** When the agent was last modified (ISO 8601). */
10445
10496
  updated_at: z.ZodOptional<z.ZodString>;
10446
10497
  /** ID of the user that owns this agent (`usr_...`). `null` if the agent is not user-scoped. */
@@ -10536,6 +10587,7 @@ export declare const agentListResponseSchema: z.ZodObject<{
10536
10587
  display_name?: string | undefined;
10537
10588
  };
10538
10589
  } | undefined;
10590
+ template_upgrade_available?: boolean | undefined;
10539
10591
  }, {
10540
10592
  id: string;
10541
10593
  email?: string | undefined;
@@ -10627,6 +10679,7 @@ export declare const agentListResponseSchema: z.ZodObject<{
10627
10679
  display_name?: string | undefined;
10628
10680
  };
10629
10681
  } | undefined;
10682
+ template_upgrade_available?: boolean | undefined;
10630
10683
  }>, "many">;
10631
10684
  /** `true` when a subsequent page of results exists. */
10632
10685
  has_next: z.ZodOptional<z.ZodBoolean>;
@@ -10732,6 +10785,7 @@ export declare const agentListResponseSchema: z.ZodObject<{
10732
10785
  display_name?: string | undefined;
10733
10786
  };
10734
10787
  } | undefined;
10788
+ template_upgrade_available?: boolean | undefined;
10735
10789
  }[];
10736
10790
  has_next?: boolean | undefined;
10737
10791
  has_prev?: boolean | undefined;
@@ -10831,6 +10885,7 @@ export declare const agentListResponseSchema: z.ZodObject<{
10831
10885
  display_name?: string | undefined;
10832
10886
  };
10833
10887
  } | undefined;
10888
+ template_upgrade_available?: boolean | undefined;
10834
10889
  }[];
10835
10890
  has_next?: boolean | undefined;
10836
10891
  has_prev?: boolean | undefined;
@@ -13890,6 +13945,8 @@ export declare const agentUpgradeResponseSchema: z.ZodObject<{
13890
13945
  }>>;
13891
13946
  /** ID of the team that owns this agent (`tem_...`). `null` if the agent is not team-scoped. */
13892
13947
  team: z.ZodOptional<z.ZodString>;
13948
+ /** True when the agent's last-applied template version is behind the current version of its AgentTemplate config — i.e. reapplying the template (a per-agent upgrade) would bring it newer Solution content. Self-clears once the agent is reapplied. Computed only on list endpoints; `null` on single-agent GET. */
13949
+ template_upgrade_available: z.ZodOptional<z.ZodBoolean>;
13893
13950
  /** When the agent was last modified (ISO 8601). */
13894
13951
  updated_at: z.ZodOptional<z.ZodString>;
13895
13952
  /** ID of the user that owns this agent (`usr_...`). `null` if the agent is not user-scoped. */
@@ -13985,6 +14042,7 @@ export declare const agentUpgradeResponseSchema: z.ZodObject<{
13985
14042
  display_name?: string | undefined;
13986
14043
  };
13987
14044
  } | undefined;
14045
+ template_upgrade_available?: boolean | undefined;
13988
14046
  }, {
13989
14047
  id: string;
13990
14048
  email?: string | undefined;
@@ -14076,6 +14134,7 @@ export declare const agentUpgradeResponseSchema: z.ZodObject<{
14076
14134
  display_name?: string | undefined;
14077
14135
  };
14078
14136
  } | undefined;
14137
+ template_upgrade_available?: boolean | undefined;
14079
14138
  }>>;
14080
14139
  /** Summary of the parent Solution the agent was upgraded from. */
14081
14140
  solution: z.ZodObject<{
@@ -14836,6 +14895,7 @@ export declare const agentUpgradeResponseSchema: z.ZodObject<{
14836
14895
  display_name?: string | undefined;
14837
14896
  };
14838
14897
  } | undefined;
14898
+ template_upgrade_available?: boolean | undefined;
14839
14899
  } | undefined;
14840
14900
  }, {
14841
14901
  solution: {
@@ -15033,6 +15093,7 @@ export declare const agentUpgradeResponseSchema: z.ZodObject<{
15033
15093
  display_name?: string | undefined;
15034
15094
  };
15035
15095
  } | undefined;
15096
+ template_upgrade_available?: boolean | undefined;
15036
15097
  } | undefined;
15037
15098
  }>;
15038
15099
  /** A solution category that organizes solutions in the catalog, identified by a stable key and optionally nested under a parent category. */