@spacefast/common 0.0.26 → 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 (302) hide show
  1. package/dist/agents/connect-targets.d.ts +6 -146
  2. package/dist/agents/connect-targets.js +63 -295
  3. package/dist/agents/private-key-oauth.d.ts +31 -1
  4. package/dist/agents/private-key-oauth.js +124 -33
  5. package/dist/agents/registry/core.d.ts +292 -0
  6. package/dist/agents/registry/core.js +1388 -0
  7. package/dist/agents/registry/deeplink-probes.d.ts +23 -0
  8. package/dist/agents/registry/deeplink-probes.js +18 -0
  9. package/dist/agents/registry/node.d.ts +56 -0
  10. package/dist/agents/registry/node.js +339 -0
  11. package/dist/brand-assets-build.js +1 -2
  12. package/dist/brand-assets.js +4 -7
  13. package/dist/brand.d.ts +17 -0
  14. package/dist/brand.js +24 -4
  15. package/dist/config/domains.d.ts +55 -28
  16. package/dist/config/domains.js +85 -41
  17. package/dist/config/index.js +1 -2
  18. package/dist/contracts/abuse.js +9 -24
  19. package/dist/contracts/access-profiles.d.ts +86 -0
  20. package/dist/contracts/access-profiles.js +89 -0
  21. package/dist/contracts/access.d.ts +21 -27
  22. package/dist/contracts/access.js +33 -64
  23. package/dist/contracts/activity.d.ts +18 -1
  24. package/dist/contracts/activity.js +70 -26
  25. package/dist/contracts/analytics.js +8 -10
  26. package/dist/contracts/api-keys.d.ts +77 -52
  27. package/dist/contracts/api-keys.js +44 -24
  28. package/dist/contracts/application-journal.d.ts +216 -0
  29. package/dist/contracts/application-journal.js +167 -0
  30. package/dist/contracts/auth.d.ts +90 -17
  31. package/dist/contracts/auth.js +86 -17
  32. package/dist/contracts/beta.d.ts +9 -4
  33. package/dist/contracts/beta.js +20 -16
  34. package/dist/contracts/billing.js +7 -11
  35. package/dist/contracts/bootstrap.d.ts +791 -0
  36. package/dist/contracts/bootstrap.js +51 -0
  37. package/dist/contracts/builds.d.ts +192 -7
  38. package/dist/contracts/builds.js +84 -21
  39. package/dist/contracts/channels.d.ts +43 -0
  40. package/dist/contracts/channels.js +25 -9
  41. package/dist/contracts/cli.d.ts +7 -0
  42. package/dist/contracts/cli.js +6 -0
  43. package/dist/contracts/collab-public.d.ts +1 -1
  44. package/dist/contracts/collab-public.js +5 -8
  45. package/dist/contracts/comments.d.ts +45 -35
  46. package/dist/contracts/comments.js +107 -77
  47. package/dist/contracts/commerce.d.ts +165 -0
  48. package/dist/contracts/commerce.js +146 -0
  49. package/dist/contracts/common.d.ts +3 -3
  50. package/dist/contracts/common.js +18 -29
  51. package/dist/contracts/content-contract-verification.d.ts +521 -0
  52. package/dist/contracts/content-contract-verification.js +320 -0
  53. package/dist/contracts/content-platform-fixture.d.ts +1278 -0
  54. package/dist/contracts/content-platform-fixture.js +44 -0
  55. package/dist/contracts/content-program.d.ts +994 -0
  56. package/dist/contracts/content-program.js +658 -0
  57. package/dist/contracts/content-sync.d.ts +290 -0
  58. package/dist/contracts/content-sync.js +167 -0
  59. package/dist/contracts/content.d.ts +432 -0
  60. package/dist/contracts/content.js +303 -0
  61. package/dist/contracts/continuation.d.ts +17 -1
  62. package/dist/contracts/continuation.js +23 -23
  63. package/dist/contracts/countries.js +3 -4
  64. package/dist/contracts/crons.d.ts +17 -0
  65. package/dist/contracts/crons.js +33 -15
  66. package/dist/contracts/dashboard-prefs.d.ts +56 -0
  67. package/dist/contracts/dashboard-prefs.js +51 -0
  68. package/dist/contracts/device-auth.d.ts +234 -37
  69. package/dist/contracts/device-auth.js +267 -53
  70. package/dist/contracts/docs.d.ts +6 -10
  71. package/dist/contracts/docs.js +5 -13
  72. package/dist/contracts/domains.d.ts +499 -102
  73. package/dist/contracts/domains.js +169 -58
  74. package/dist/contracts/email-preferences.d.ts +3 -3
  75. package/dist/contracts/email-preferences.js +6 -7
  76. package/dist/contracts/enums.d.ts +26 -26
  77. package/dist/contracts/enums.js +61 -54
  78. package/dist/contracts/error-code-meta.d.ts +273 -7
  79. package/dist/contracts/error-code-meta.js +81 -5
  80. package/dist/contracts/error-codes.d.ts +5 -5
  81. package/dist/contracts/error-codes.js +79 -16
  82. package/dist/contracts/events.d.ts +100 -20
  83. package/dist/contracts/events.js +107 -20
  84. package/dist/contracts/execution.d.ts +47 -66
  85. package/dist/contracts/execution.js +51 -64
  86. package/dist/contracts/feature-lifecycle.d.ts +70 -14
  87. package/dist/contracts/feature-lifecycle.js +86 -15
  88. package/dist/contracts/features.d.ts +100 -37
  89. package/dist/contracts/features.js +21 -27
  90. package/dist/contracts/fixtures/content-platform-v1.json +1108 -0
  91. package/dist/contracts/frame-session.d.ts +192 -0
  92. package/dist/contracts/frame-session.js +164 -0
  93. package/dist/contracts/functions.d.ts +218 -211
  94. package/dist/contracts/functions.js +273 -260
  95. package/dist/contracts/grant-copy.d.ts +43 -0
  96. package/dist/contracts/grant-copy.js +44 -0
  97. package/dist/contracts/grants.d.ts +64 -56
  98. package/dist/contracts/grants.js +124 -23
  99. package/dist/contracts/ids.d.ts +4 -1
  100. package/dist/contracts/ids.js +4 -1
  101. package/dist/contracts/internal.d.ts +5 -4
  102. package/dist/contracts/internal.js +12 -3
  103. package/dist/contracts/mcp.d.ts +17 -0
  104. package/dist/contracts/mcp.js +23 -0
  105. package/dist/contracts/me.d.ts +6 -1
  106. package/dist/contracts/me.js +12 -6
  107. package/dist/contracts/notifications.d.ts +27 -29
  108. package/dist/contracts/notifications.js +9 -4
  109. package/dist/contracts/oauth-resources.d.ts +121 -10
  110. package/dist/contracts/oauth-resources.js +130 -11
  111. package/dist/contracts/oauth-scope-actions.d.ts +90 -0
  112. package/dist/contracts/oauth-scope-actions.js +126 -0
  113. package/dist/contracts/operations.d.ts +27 -4
  114. package/dist/contracts/operations.js +11 -5
  115. package/dist/contracts/pages.d.ts +29 -5
  116. package/dist/contracts/pages.js +22 -5
  117. package/dist/contracts/partner-notifications.d.ts +3 -0
  118. package/dist/contracts/partner-notifications.js +65 -0
  119. package/dist/contracts/{platform.d.ts → partner.d.ts} +29 -42
  120. package/dist/contracts/{platform.js → partner.js} +27 -40
  121. package/dist/contracts/plan-policy.d.ts +1 -1
  122. package/dist/contracts/principal-assertion.d.ts +43 -0
  123. package/dist/contracts/principal-assertion.js +67 -0
  124. package/dist/contracts/principals.d.ts +73 -0
  125. package/dist/contracts/principals.js +59 -0
  126. package/dist/contracts/privacy.d.ts +11 -0
  127. package/dist/contracts/privacy.js +17 -0
  128. package/dist/contracts/problem-document.js +3 -4
  129. package/dist/contracts/publish-archive.d.ts +116 -18
  130. package/dist/contracts/publish-archive.js +6 -3
  131. package/dist/contracts/push-new.d.ts +4 -4
  132. package/dist/contracts/quotas.js +3 -3
  133. package/dist/contracts/realtime.d.ts +52 -0
  134. package/dist/contracts/realtime.js +54 -0
  135. package/dist/contracts/repository-connections.d.ts +1 -1
  136. package/dist/contracts/repository-connections.js +6 -2
  137. package/dist/contracts/resources.d.ts +105 -14
  138. package/dist/contracts/resources.js +145 -21
  139. package/dist/contracts/route-inventory.d.ts +358 -0
  140. package/dist/contracts/route-inventory.js +141 -0
  141. package/dist/contracts/runtime-api.d.ts +112 -35
  142. package/dist/contracts/runtime-api.js +86 -66
  143. package/dist/contracts/runtime-app.d.ts +11 -21
  144. package/dist/contracts/runtime-app.js +39 -24
  145. package/dist/contracts/runtime-components.d.ts +143 -0
  146. package/dist/contracts/runtime-components.js +199 -0
  147. package/dist/contracts/runtime-db.d.ts +45 -19
  148. package/dist/contracts/runtime-db.js +85 -20
  149. package/dist/contracts/runtime-purge.js +3 -5
  150. package/dist/contracts/runtime-services.d.ts +43 -75
  151. package/dist/contracts/runtime-services.js +29 -49
  152. package/dist/contracts/runtime-storage.d.ts +14 -14
  153. package/dist/contracts/runtime-storage.js +28 -13
  154. package/dist/contracts/sf-config-v1.d.ts +14 -18
  155. package/dist/contracts/slugs.js +13 -4
  156. package/dist/contracts/space-config.d.ts +235 -28
  157. package/dist/contracts/space-config.js +246 -91
  158. package/dist/contracts/spaces.d.ts +360 -255
  159. package/dist/contracts/spaces.js +190 -122
  160. package/dist/contracts/superadmin-activity.d.ts +3 -43
  161. package/dist/contracts/superadmin-activity.js +6 -30
  162. package/dist/contracts/superadmin-emails.d.ts +1 -0
  163. package/dist/contracts/superadmin-emails.js +17 -1
  164. package/dist/contracts/superadmin-runtime.d.ts +199 -0
  165. package/dist/contracts/superadmin-runtime.js +141 -0
  166. package/dist/contracts/superadmin-search.d.ts +22 -2
  167. package/dist/contracts/superadmin-search.js +14 -6
  168. package/dist/contracts/superadmin-spaces.d.ts +435 -186
  169. package/dist/contracts/superadmin-spaces.js +131 -25
  170. package/dist/contracts/superadmin-teams.d.ts +3 -0
  171. package/dist/contracts/superadmin-teams.js +1 -2
  172. package/dist/contracts/superadmin-tenants.d.ts +627 -6
  173. package/dist/contracts/superadmin-tenants.js +32 -7
  174. package/dist/contracts/superadmin.d.ts +98 -16
  175. package/dist/contracts/superadmin.js +63 -10
  176. package/dist/contracts/tags.d.ts +85 -58
  177. package/dist/contracts/tags.js +44 -34
  178. package/dist/contracts/teams.d.ts +72 -9
  179. package/dist/contracts/teams.js +84 -25
  180. package/dist/contracts/tenants.d.ts +135 -0
  181. package/dist/contracts/tenants.js +120 -0
  182. package/dist/contracts/test-triggers.d.ts +70 -0
  183. package/dist/contracts/test-triggers.js +116 -0
  184. package/dist/contracts/theme-json.js +3 -8
  185. package/dist/contracts/transfers.d.ts +1 -0
  186. package/dist/contracts/transfers.js +1 -0
  187. package/dist/contracts/usage.d.ts +209 -0
  188. package/dist/contracts/usage.js +124 -12
  189. package/dist/contracts/variables.d.ts +2 -2
  190. package/dist/contracts/variables.js +9 -13
  191. package/dist/contracts/webhooks.d.ts +13 -5
  192. package/dist/contracts/webhooks.js +3 -1
  193. package/dist/contracts/zero.d.ts +57 -64
  194. package/dist/contracts/zero.js +68 -66
  195. package/dist/dashboard-paths/index.d.ts +24 -21
  196. package/dist/dashboard-paths/index.js +35 -47
  197. package/dist/dashboard-paths/route-reservations.generated.d.ts +2 -0
  198. package/dist/dashboard-paths/route-reservations.generated.js +36 -0
  199. package/dist/docs/agent-arrival.d.ts +92 -0
  200. package/dist/docs/agent-arrival.js +227 -0
  201. package/dist/docs/agent-output-policy.d.ts +6 -0
  202. package/dist/docs/agent-output-policy.js +22 -0
  203. package/dist/docs/agent-prose.d.ts +11 -17
  204. package/dist/docs/agent-prose.js +62 -37
  205. package/dist/docs/agent-setup.d.ts +72 -41
  206. package/dist/docs/agent-setup.js +336 -436
  207. package/dist/docs/catalog.d.ts +147 -89
  208. package/dist/docs/catalog.js +157 -42
  209. package/dist/docs/error-docs.d.ts +2102 -1
  210. package/dist/docs/error-docs.js +285 -16
  211. package/dist/docs/index-build.d.ts +0 -1
  212. package/dist/docs/index-build.js +2 -3
  213. package/dist/docs/page-context-prompt.d.ts +77 -0
  214. package/dist/docs/page-context-prompt.js +131 -0
  215. package/dist/docs/reference-urls.d.ts +46 -0
  216. package/dist/docs/reference-urls.js +79 -0
  217. package/dist/docs/search.d.ts +6 -8
  218. package/dist/docs/search.js +10 -13
  219. package/dist/docs/skill-distribution.d.ts +4 -1
  220. package/dist/docs/skill-distribution.js +10 -5
  221. package/dist/docs/skills.d.ts +117 -117
  222. package/dist/docs/skills.js +120 -72
  223. package/dist/docs/start-prompts.d.ts +45 -0
  224. package/dist/docs/start-prompts.js +62 -0
  225. package/dist/domain-exploration.js +9 -13
  226. package/dist/og-template.d.ts +56 -0
  227. package/dist/og-template.js +56 -0
  228. package/dist/slug-policy/index.js +5 -11
  229. package/dist/utils/browser-credential.d.ts +13 -6
  230. package/dist/utils/browser-credential.js +14 -7
  231. package/dist/utils/build-settings.d.ts +16 -0
  232. package/dist/utils/build-settings.js +63 -17
  233. package/dist/utils/canonical-json.d.ts +3 -5
  234. package/dist/utils/canonical-json.js +3 -5
  235. package/dist/utils/cast-transport.d.ts +5 -17
  236. package/dist/utils/cast-transport.js +6 -19
  237. package/dist/utils/claim-token.js +1 -2
  238. package/dist/utils/comment-avatars.js +4 -6
  239. package/dist/utils/concurrency.js +2 -3
  240. package/dist/utils/content-type.d.ts +7 -6
  241. package/dist/utils/content-type.js +73 -51
  242. package/dist/utils/credential-policy.d.ts +50 -6
  243. package/dist/utils/credential-policy.js +123 -57
  244. package/dist/utils/egress-policy.fixtures.json +1 -1
  245. package/dist/utils/generate-space-name.d.ts +3 -8
  246. package/dist/utils/generate-space-name.js +3 -8
  247. package/dist/utils/grants.d.ts +0 -1
  248. package/dist/utils/grants.js +4 -7
  249. package/dist/utils/gravatar.d.ts +2 -4
  250. package/dist/utils/gravatar.js +6 -12
  251. package/dist/utils/id-hints.js +14 -23
  252. package/dist/utils/idempotency.d.ts +3 -3
  253. package/dist/utils/idempotency.js +6 -7
  254. package/dist/utils/local-space-state.d.ts +15 -15
  255. package/dist/utils/local-space-state.js +34 -23
  256. package/dist/utils/oauth-signed-query.d.ts +3 -5
  257. package/dist/utils/oauth-signed-query.js +6 -9
  258. package/dist/utils/one-shot-replay.d.ts +3 -5
  259. package/dist/utils/one-shot-replay.js +3 -5
  260. package/dist/utils/page-colors.d.ts +4 -10
  261. package/dist/utils/page-colors.js +11 -35
  262. package/dist/utils/page-fonts.js +6 -11
  263. package/dist/utils/page-preview.d.ts +0 -1
  264. package/dist/utils/page-preview.js +0 -1
  265. package/dist/utils/pages.d.ts +22 -11
  266. package/dist/utils/pages.js +70 -30
  267. package/dist/utils/privacy-regions.d.ts +19 -0
  268. package/dist/utils/privacy-regions.js +91 -0
  269. package/dist/utils/publish-form-data.d.ts +4 -5
  270. package/dist/utils/publish-form-data.js +2 -3
  271. package/dist/utils/publish-policy.d.ts +10 -23
  272. package/dist/utils/publish-policy.js +63 -116
  273. package/dist/utils/query-client.d.ts +2 -0
  274. package/dist/utils/query-client.js +10 -1
  275. package/dist/utils/runtime-paths.d.ts +4 -4
  276. package/dist/utils/runtime-paths.js +6 -8
  277. package/dist/utils/runtime-upload.d.ts +4 -0
  278. package/dist/utils/runtime-upload.js +5 -0
  279. package/dist/utils/secure-local-file.d.ts +3 -3
  280. package/dist/utils/secure-local-file.js +18 -24
  281. package/dist/utils/space-config.d.ts +11 -14
  282. package/dist/utils/space-config.js +10 -16
  283. package/dist/utils/static-runtime-policy.d.ts +5 -8
  284. package/dist/utils/static-runtime-policy.generated.d.ts +16 -0
  285. package/dist/utils/static-runtime-policy.generated.js +70 -0
  286. package/dist/utils/static-runtime-policy.js +17 -84
  287. package/dist/utils/storage-policy.js +1 -2
  288. package/dist/utils/upload-session.js +8 -14
  289. package/dist/utils/version-path.js +11 -19
  290. package/dist/utils/wpcom-auth-redirects.d.ts +5 -14
  291. package/dist/utils/wpcom-auth-redirects.js +1 -4
  292. package/dist/vocabulary.d.ts +7 -7
  293. package/dist/vocabulary.js +30 -16
  294. package/package.json +14 -2
  295. package/dist/agents/client-registry.d.ts +0 -22
  296. package/dist/agents/client-registry.js +0 -41
  297. package/dist/docs/agent-handoff-document.d.ts +0 -15
  298. package/dist/docs/agent-handoff-document.js +0 -180
  299. package/dist/docs/agent-solutions.d.ts +0 -110
  300. package/dist/docs/agent-solutions.js +0 -183
  301. package/dist/utils/query-keys.d.ts +0 -84
  302. package/dist/utils/query-keys.js +0 -108
@@ -0,0 +1,51 @@
1
+ import { z } from "zod";
2
+ // Per-user dashboard preferences: one open key/value bag on the user row,
3
+ // surfaced on `GET /v1/me` and written through `PATCH /v1/me/dashboard-preferences`.
4
+ // Deliberately schemaless, because this is cosmetic client state that churns
5
+ // with the UI. The server owns only the sanity limits below; meaning lives at
6
+ // each consumer, which narrows its own key from `unknown`.
7
+ /** Most keys one user's preference bag may hold. */
8
+ export const DASHBOARD_PREFS_MAX_KEYS = 50;
9
+ /** Longest single preference key, in characters. */
10
+ export const DASHBOARD_PREFS_MAX_KEY_LENGTH = 64;
11
+ /** Largest serialized preference bag, in UTF-8 bytes. */
12
+ export const DASHBOARD_PREFS_MAX_BYTES = 16 * 1024;
13
+ /**
14
+ * The stored bag. Values stay `unknown`: every reader narrows with its own
15
+ * schema rather than trusting a shape the server never enforced.
16
+ */
17
+ export const dashboardPrefsSchema = z
18
+ .record(z.string(), z.unknown())
19
+ .describe("Per-user dashboard preferences as an open key/value bag. Values are arbitrary JSON; each dashboard surface owns the meaning of its own key.");
20
+ /**
21
+ * The PATCH body: a partial bag merged key-wise into the stored one. An explicit
22
+ * `null` deletes its key.
23
+ */
24
+ export const dashboardPrefsPatchSchema = z
25
+ .record(z.string(), z.unknown())
26
+ .describe("Preference keys to merge into the stored bag. A key set to `null` is deleted; every other key is overwritten. Keys you do not send are left alone.");
27
+ /** The dashboard appearance key. */
28
+ export const DASHBOARD_PREF_APPEARANCE = "appearance";
29
+ /** Personal space favorites: the starred space ids, across every team. */
30
+ export const DASHBOARD_PREF_SPACE_FAVORITES = "spaceFavorites";
31
+ /**
32
+ * Favorites value: unique space ids. Capped well under the bag's byte budget —
33
+ * a favorite is a shortcut, and hundreds of shortcuts stop being one. Ids the
34
+ * server can no longer resolve to a live space are dropped on write.
35
+ */
36
+ export const spaceFavoritesPreferenceSchema = z.array(z.string().max(64)).max(200);
37
+ /** Personal manual space ordering, keyed by team id. */
38
+ export const DASHBOARD_PREF_SPACE_ORDERS = "spaceOrders";
39
+ /**
40
+ * Per-team ordered space ids for the "custom order" of the spaces list. This is
41
+ * the only home for a manual space order: it is per-user, like every other
42
+ * dashboard preference. Ids the server can no longer resolve to a live space of
43
+ * that team are dropped on write, so a deleted space cannot squat a slot.
44
+ */
45
+ export const spaceOrdersPreferenceSchema = z.record(z.string().max(64), z.array(z.string().max(64)).max(200));
46
+ /**
47
+ * Values the appearance preference may take. `system` follows the OS setting
48
+ * live; the other two pin it. Mirrors the client-side `ThemePreference` union
49
+ * in `@spacefast/app-shell/lib/theme`.
50
+ */
51
+ export const appearancePreferenceSchema = z.enum(["light", "dark", "system"]);
@@ -1,9 +1,14 @@
1
1
  import { z } from "zod";
2
2
  export { DeviceTeamScopeSchema } from "./device-team-scope.js";
3
3
  export type { DeviceTeamScope } from "./device-team-scope.js";
4
+ export declare const INTERACTIVE_GRANT_TTL_DAYS = 30;
5
+ export declare const INTERACTIVE_GRANT_IDLE_DAYS = 7;
4
6
  export declare const DeviceAuthorizationStartRequestSchema: z.ZodObject<{
5
7
  clientId: z.ZodDefault<z.ZodString>;
6
- scope: z.ZodOptional<z.ZodString>;
8
+ access: z.ZodDefault<z.ZodEnum<{
9
+ read: "read";
10
+ agent: "agent";
11
+ }>>;
7
12
  claim: z.ZodOptional<z.ZodObject<{
8
13
  spaceId: z.ZodString;
9
14
  claimToken: z.ZodString;
@@ -28,6 +33,24 @@ export declare const DeviceAuthorizationStatusSchema: z.ZodEnum<{
28
33
  denied: "denied";
29
34
  consumed: "consumed";
30
35
  }>;
36
+ export declare const DeviceGrantedAccessSchema: z.ZodObject<{
37
+ profile: z.ZodNullable<z.ZodEnum<{
38
+ read: "read";
39
+ agent: "agent";
40
+ }>>;
41
+ scopes: z.ZodArray<z.ZodEnum<{
42
+ "teams:read": "teams:read";
43
+ "teams:create": "teams:create";
44
+ "spaces:read": "spaces:read";
45
+ "spaces:write": "spaces:write";
46
+ "spaces:rename": "spaces:rename";
47
+ "publish:write": "publish:write";
48
+ "domains:read": "domains:read";
49
+ "domains:write": "domains:write";
50
+ }>>;
51
+ teams: z.ZodType<import("./device-team-scope.js").DeviceTeamScope, unknown, z.core.$ZodTypeInternals<import("./device-team-scope.js").DeviceTeamScope, unknown>>;
52
+ }, z.core.$strict>;
53
+ export type DeviceGrantedAccess = z.infer<typeof DeviceGrantedAccessSchema>;
31
54
  export declare const DeviceAuthorizationPollResponseSchema: z.ZodObject<{
32
55
  status: z.ZodEnum<{
33
56
  expired: "expired";
@@ -40,6 +63,10 @@ export declare const DeviceAuthorizationPollResponseSchema: z.ZodObject<{
40
63
  id: z.ZodString;
41
64
  name: z.ZodNullable<z.ZodString>;
42
65
  tenantId: z.ZodNullable<z.ZodString>;
66
+ mode: z.ZodEnum<{
67
+ live: "live";
68
+ test: "test";
69
+ }>;
43
70
  subject: z.ZodNullable<z.ZodObject<{
44
71
  type: z.ZodEnum<{
45
72
  team: "team";
@@ -61,10 +88,10 @@ export declare const DeviceAuthorizationPollResponseSchema: z.ZodObject<{
61
88
  ci_deploy: "ci_deploy";
62
89
  space_publisher: "space_publisher";
63
90
  space_admin: "space_admin";
64
- site_admin: "site_admin";
65
91
  domain_manager: "domain_manager";
66
92
  team_admin: "team_admin";
67
93
  billing_viewer: "billing_viewer";
94
+ partner_admin: "partner_admin";
68
95
  }>>;
69
96
  teamScope: z.ZodNullable<z.ZodType<import("./device-team-scope.js").DeviceTeamScope, unknown, z.core.$ZodTypeInternals<import("./device-team-scope.js").DeviceTeamScope, unknown>>>;
70
97
  policy: z.ZodNullable<z.ZodObject<{
@@ -83,18 +110,13 @@ export declare const DeviceAuthorizationPollResponseSchema: z.ZodObject<{
83
110
  "domains:read": "domains:read";
84
111
  "spaces:publish": "spaces:publish";
85
112
  "builds:trigger": "builds:trigger";
86
- "mcp:tools": "mcp:tools";
87
113
  "*": "*";
88
- "sites:read": "sites:read";
89
- "sites:create": "sites:create";
90
- "sites:write": "sites:write";
91
- "sites:delete": "sites:delete";
92
- "sites:policy.write": "sites:policy.write";
93
114
  "spaces:create": "spaces:create";
94
115
  "spaces:delete": "spaces:delete";
95
116
  "spaces:transfer": "spaces:transfer";
96
117
  "spaces:export": "spaces:export";
97
118
  "spaces:import": "spaces:import";
119
+ "spaces:policy.write": "spaces:policy.write";
98
120
  "versions:read": "versions:read";
99
121
  "versions:promote": "versions:promote";
100
122
  "versions:delete": "versions:delete";
@@ -111,6 +133,13 @@ export declare const DeviceAuthorizationPollResponseSchema: z.ZodObject<{
111
133
  "webhooks:write": "webhooks:write";
112
134
  "builds:read": "builds:read";
113
135
  "builds:create": "builds:create";
136
+ "variables:read": "variables:read";
137
+ "variables:write": "variables:write";
138
+ "tenants:read": "tenants:read";
139
+ "tenants:write": "tenants:write";
140
+ "principals:read": "principals:read";
141
+ "principals:write": "principals:write";
142
+ "infrastructure:read": "infrastructure:read";
114
143
  "teams:write": "teams:write";
115
144
  "teams:members.write": "teams:members.write";
116
145
  "billing:read": "billing:read";
@@ -143,6 +172,23 @@ export declare const DeviceAuthorizationPollResponseSchema: z.ZodObject<{
143
172
  updatedAt: z.ZodString;
144
173
  lastRequestAt: z.ZodNullable<z.ZodString>;
145
174
  }, z.core.$strip>>;
175
+ access: z.ZodOptional<z.ZodObject<{
176
+ profile: z.ZodNullable<z.ZodEnum<{
177
+ read: "read";
178
+ agent: "agent";
179
+ }>>;
180
+ scopes: z.ZodArray<z.ZodEnum<{
181
+ "teams:read": "teams:read";
182
+ "teams:create": "teams:create";
183
+ "spaces:read": "spaces:read";
184
+ "spaces:write": "spaces:write";
185
+ "spaces:rename": "spaces:rename";
186
+ "publish:write": "publish:write";
187
+ "domains:read": "domains:read";
188
+ "domains:write": "domains:write";
189
+ }>>;
190
+ teams: z.ZodType<import("./device-team-scope.js").DeviceTeamScope, unknown, z.core.$ZodTypeInternals<import("./device-team-scope.js").DeviceTeamScope, unknown>>;
191
+ }, z.core.$strict>>;
146
192
  claimedSpaceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
147
193
  }, z.core.$strip>;
148
194
  export type DeviceAuthorizationPollResponse = z.infer<typeof DeviceAuthorizationPollResponseSchema>;
@@ -158,7 +204,22 @@ export declare const DeviceAuthorizationVerifyResponseSchema: z.ZodObject<{
158
204
  consumed: "consumed";
159
205
  }>;
160
206
  clientId: z.ZodNullable<z.ZodString>;
161
- scope: z.ZodNullable<z.ZodString>;
207
+ requestedAccess: z.ZodObject<{
208
+ profile: z.ZodNullable<z.ZodEnum<{
209
+ read: "read";
210
+ agent: "agent";
211
+ }>>;
212
+ scopes: z.ZodArray<z.ZodEnum<{
213
+ "teams:read": "teams:read";
214
+ "teams:create": "teams:create";
215
+ "spaces:read": "spaces:read";
216
+ "spaces:write": "spaces:write";
217
+ "spaces:rename": "spaces:rename";
218
+ "publish:write": "publish:write";
219
+ "domains:read": "domains:read";
220
+ "domains:write": "domains:write";
221
+ }>>;
222
+ }, z.core.$strict>;
162
223
  origin: z.ZodNullable<z.ZodString>;
163
224
  expiresAt: z.ZodString;
164
225
  claim: z.ZodNullable<z.ZodObject<{
@@ -167,19 +228,30 @@ export declare const DeviceAuthorizationVerifyResponseSchema: z.ZodObject<{
167
228
  liveUrl: z.ZodNullable<z.ZodString>;
168
229
  }, z.core.$strict>>;
169
230
  }, z.core.$strip>;
231
+ export declare const DeviceAuthorizationApprovalScopeSchema: z.ZodEnum<{
232
+ "teams:read": "teams:read";
233
+ "teams:create": "teams:create";
234
+ "spaces:read": "spaces:read";
235
+ "spaces:write": "spaces:write";
236
+ "spaces:rename": "spaces:rename";
237
+ "publish:write": "publish:write";
238
+ "domains:read": "domains:read";
239
+ "domains:write": "domains:write";
240
+ }>;
170
241
  export declare const DeviceAuthorizationApproveRequestSchema: z.ZodObject<{
171
242
  userCode: z.ZodString;
172
243
  teams: z.ZodType<import("./device-team-scope.js").DeviceTeamScope, unknown, z.core.$ZodTypeInternals<import("./device-team-scope.js").DeviceTeamScope, unknown>>;
173
244
  claimTeamId: z.ZodOptional<z.ZodString>;
174
- preset: z.ZodEnum<{
175
- ci_deploy: "ci_deploy";
176
- space_publisher: "space_publisher";
177
- space_admin: "space_admin";
178
- site_admin: "site_admin";
179
- domain_manager: "domain_manager";
180
- team_admin: "team_admin";
181
- billing_viewer: "billing_viewer";
182
- }>;
245
+ scopes: z.ZodArray<z.ZodEnum<{
246
+ "teams:read": "teams:read";
247
+ "teams:create": "teams:create";
248
+ "spaces:read": "spaces:read";
249
+ "spaces:write": "spaces:write";
250
+ "spaces:rename": "spaces:rename";
251
+ "publish:write": "publish:write";
252
+ "domains:read": "domains:read";
253
+ "domains:write": "domains:write";
254
+ }>>;
183
255
  agentContinuation: z.ZodOptional<z.ZodBoolean>;
184
256
  }, z.core.$strict>;
185
257
  export declare const DeviceAuthorizationApproveResponseSchema: z.ZodObject<{
@@ -194,47 +266,135 @@ export declare const DeviceAuthorizationDenyResponseSchema: z.ZodObject<{
194
266
  }, z.core.$strip>;
195
267
  export declare const AGENT_HANDOFF_CLIENT_TARGETS: readonly ["claude-code", "codex", "cursor", "vscode"];
196
268
  export type AgentHandoffClientTarget = (typeof AGENT_HANDOFF_CLIENT_TARGETS)[number];
269
+ export declare const PAGE_CONTEXT_HANDOFF_TARGETS: readonly ["any", "v0", "chatgpt", "claude", "t3", "scira", "cursor"];
270
+ export type PageContextHandoffTarget = (typeof PAGE_CONTEXT_HANDOFF_TARGETS)[number];
271
+ export declare const AGENT_HANDOFF_TARGETS: readonly ["claude-code", "codex", "cursor", "vscode", "any", "v0", "chatgpt", "claude", "t3", "scira"];
272
+ export type AgentHandoffTarget = (typeof AGENT_HANDOFF_TARGETS)[number];
273
+ export declare function isAgentHandoffClientTarget(value: string): value is AgentHandoffClientTarget;
274
+ export declare function isPageContextHandoffTarget(value: string): value is PageContextHandoffTarget;
275
+ export declare const AGENT_HANDOFF_CLIENT_TARGET_LABELS: {
276
+ "claude-code": string;
277
+ codex: string;
278
+ cursor: string;
279
+ vscode: string;
280
+ any: string;
281
+ v0: string;
282
+ chatgpt: string;
283
+ claude: string;
284
+ t3: string;
285
+ scira: string;
286
+ };
287
+ /**
288
+ * Handoff purposes that name a subject: a Space to publish to, or the dashboard
289
+ * page the agent was launched from. Both are minted by a signed-in dashboard
290
+ * session, both appear in the team ledger, and both redeem for a credential.
291
+ */
292
+ export declare const AGENT_HANDOFF_SUBJECT_KINDS: readonly ["space", "page_context"];
293
+ export type AgentHandoffSubjectKind = (typeof AGENT_HANDOFF_SUBJECT_KINDS)[number];
294
+ /**
295
+ * Every handoff purpose, including `anonymous` — the signed-out /start handoff.
296
+ * It has no team, no Space, and no subject: its document is the public setup
297
+ * guide and it can never be redeemed. It exists so a visitor who has not signed
298
+ * up yet still gets told when their agent picked the prompt up, which is exactly
299
+ * the capability the retired connect beacon provided. Being subject-less is what
300
+ * keeps it out of team ledgers and out of the revoke-all sweep.
301
+ */
302
+ export declare const AGENT_HANDOFF_KINDS: readonly ["space", "page_context", "anonymous"];
303
+ export type AgentHandoffKind = (typeof AGENT_HANDOFF_KINDS)[number];
304
+ /** Wire-visible ceiling on how long an anonymous handoff stays fetchable. */
305
+ export declare const ANONYMOUS_AGENT_HANDOFF_TTL_MS: number;
306
+ export declare const AnonymousAgentHandoffSchema: z.ZodObject<{
307
+ kind: z.ZodLiteral<"anonymous">;
308
+ id: z.ZodString;
309
+ url: z.ZodString;
310
+ expiresAt: z.ZodString;
311
+ }, z.core.$strict>;
312
+ export type AnonymousAgentHandoff = z.infer<typeof AnonymousAgentHandoffSchema>;
313
+ export declare const AnonymousAgentHandoffStatusSchema: z.ZodObject<{
314
+ id: z.ZodString;
315
+ expiresAt: z.ZodString;
316
+ firstFetchedAt: z.ZodNullable<z.ZodString>;
317
+ lastFetchedAt: z.ZodNullable<z.ZodString>;
318
+ fetchCount: z.ZodNumber;
319
+ }, z.core.$strict>;
320
+ export type AnonymousAgentHandoffStatus = z.infer<typeof AnonymousAgentHandoffStatusSchema>;
197
321
  export declare const AgentHandoffCreateRequestSchema: z.ZodObject<{
322
+ kind: z.ZodOptional<z.ZodEnum<{
323
+ space: "space";
324
+ page_context: "page_context";
325
+ }>>;
198
326
  teamId: z.ZodString;
199
- spaceId: z.ZodString;
327
+ spaceId: z.ZodOptional<z.ZodString>;
328
+ pagePath: z.ZodOptional<z.ZodString>;
200
329
  clientTargetId: z.ZodEnum<{
330
+ any: "any";
201
331
  "claude-code": "claude-code";
202
- codex: "codex";
203
332
  cursor: "cursor";
333
+ codex: "codex";
334
+ chatgpt: "chatgpt";
204
335
  vscode: "vscode";
336
+ claude: "claude";
337
+ v0: "v0";
338
+ t3: "t3";
339
+ scira: "scira";
205
340
  }>;
206
341
  }, z.core.$strict>;
207
- export type AgentHandoffCreateRequest = z.infer<typeof AgentHandoffCreateRequestSchema>;
342
+ export type AgentHandoffCreateRequest = z.input<typeof AgentHandoffCreateRequestSchema>;
208
343
  export declare const AgentHandoffCreateResponseSchema: z.ZodObject<{
344
+ kind: z.ZodEnum<{
345
+ space: "space";
346
+ page_context: "page_context";
347
+ }>;
209
348
  id: z.ZodString;
210
349
  url: z.ZodString;
211
350
  expiresAt: z.ZodString;
212
351
  teamId: z.ZodString;
213
- spaceId: z.ZodString;
352
+ spaceId: z.ZodNullable<z.ZodString>;
353
+ pagePath: z.ZodNullable<z.ZodString>;
214
354
  clientTargetId: z.ZodEnum<{
355
+ any: "any";
215
356
  "claude-code": "claude-code";
216
- codex: "codex";
217
357
  cursor: "cursor";
358
+ codex: "codex";
359
+ chatgpt: "chatgpt";
218
360
  vscode: "vscode";
361
+ claude: "claude";
362
+ v0: "v0";
363
+ t3: "t3";
364
+ scira: "scira";
219
365
  }>;
220
366
  }, z.core.$strict>;
221
367
  export type AgentHandoffCreateResponse = z.infer<typeof AgentHandoffCreateResponseSchema>;
222
368
  export declare const AgentHandoffRedeemRequestSchema: z.ZodObject<{
223
369
  url: z.ZodString;
224
370
  clientTargetId: z.ZodOptional<z.ZodEnum<{
371
+ any: "any";
225
372
  "claude-code": "claude-code";
226
- codex: "codex";
227
373
  cursor: "cursor";
374
+ codex: "codex";
375
+ chatgpt: "chatgpt";
228
376
  vscode: "vscode";
377
+ claude: "claude";
378
+ v0: "v0";
379
+ t3: "t3";
380
+ scira: "scira";
229
381
  }>>;
230
382
  }, z.core.$strict>;
231
383
  export type AgentHandoffRedeemRequest = z.infer<typeof AgentHandoffRedeemRequestSchema>;
232
384
  export declare const AgentHandoffRedeemResponseSchema: z.ZodObject<{
233
385
  status: z.ZodLiteral<"redeemed">;
386
+ kind: z.ZodEnum<{
387
+ space: "space";
388
+ page_context: "page_context";
389
+ }>;
234
390
  apiKey: z.ZodObject<{
235
391
  id: z.ZodString;
236
392
  name: z.ZodNullable<z.ZodString>;
237
393
  tenantId: z.ZodNullable<z.ZodString>;
394
+ mode: z.ZodEnum<{
395
+ live: "live";
396
+ test: "test";
397
+ }>;
238
398
  subject: z.ZodNullable<z.ZodObject<{
239
399
  type: z.ZodEnum<{
240
400
  team: "team";
@@ -256,10 +416,10 @@ export declare const AgentHandoffRedeemResponseSchema: z.ZodObject<{
256
416
  ci_deploy: "ci_deploy";
257
417
  space_publisher: "space_publisher";
258
418
  space_admin: "space_admin";
259
- site_admin: "site_admin";
260
419
  domain_manager: "domain_manager";
261
420
  team_admin: "team_admin";
262
421
  billing_viewer: "billing_viewer";
422
+ partner_admin: "partner_admin";
263
423
  }>>;
264
424
  teamScope: z.ZodNullable<z.ZodType<import("./device-team-scope.js").DeviceTeamScope, unknown, z.core.$ZodTypeInternals<import("./device-team-scope.js").DeviceTeamScope, unknown>>>;
265
425
  policy: z.ZodNullable<z.ZodObject<{
@@ -278,18 +438,13 @@ export declare const AgentHandoffRedeemResponseSchema: z.ZodObject<{
278
438
  "domains:read": "domains:read";
279
439
  "spaces:publish": "spaces:publish";
280
440
  "builds:trigger": "builds:trigger";
281
- "mcp:tools": "mcp:tools";
282
441
  "*": "*";
283
- "sites:read": "sites:read";
284
- "sites:create": "sites:create";
285
- "sites:write": "sites:write";
286
- "sites:delete": "sites:delete";
287
- "sites:policy.write": "sites:policy.write";
288
442
  "spaces:create": "spaces:create";
289
443
  "spaces:delete": "spaces:delete";
290
444
  "spaces:transfer": "spaces:transfer";
291
445
  "spaces:export": "spaces:export";
292
446
  "spaces:import": "spaces:import";
447
+ "spaces:policy.write": "spaces:policy.write";
293
448
  "versions:read": "versions:read";
294
449
  "versions:promote": "versions:promote";
295
450
  "versions:delete": "versions:delete";
@@ -306,6 +461,13 @@ export declare const AgentHandoffRedeemResponseSchema: z.ZodObject<{
306
461
  "webhooks:write": "webhooks:write";
307
462
  "builds:read": "builds:read";
308
463
  "builds:create": "builds:create";
464
+ "variables:read": "variables:read";
465
+ "variables:write": "variables:write";
466
+ "tenants:read": "tenants:read";
467
+ "tenants:write": "tenants:write";
468
+ "principals:read": "principals:read";
469
+ "principals:write": "principals:write";
470
+ "infrastructure:read": "infrastructure:read";
309
471
  "teams:write": "teams:write";
310
472
  "teams:members.write": "teams:members.write";
311
473
  "billing:read": "billing:read";
@@ -339,12 +501,19 @@ export declare const AgentHandoffRedeemResponseSchema: z.ZodObject<{
339
501
  lastRequestAt: z.ZodNullable<z.ZodString>;
340
502
  }, z.core.$strip>;
341
503
  teamId: z.ZodString;
342
- spaceId: z.ZodString;
504
+ spaceId: z.ZodNullable<z.ZodString>;
505
+ pagePath: z.ZodNullable<z.ZodString>;
343
506
  clientTargetId: z.ZodEnum<{
507
+ any: "any";
344
508
  "claude-code": "claude-code";
345
- codex: "codex";
346
509
  cursor: "cursor";
510
+ codex: "codex";
511
+ chatgpt: "chatgpt";
347
512
  vscode: "vscode";
513
+ claude: "claude";
514
+ v0: "v0";
515
+ t3: "t3";
516
+ scira: "scira";
348
517
  }>;
349
518
  }, z.core.$strict>;
350
519
  export type AgentHandoffRedeemResponse = z.infer<typeof AgentHandoffRedeemResponseSchema>;
@@ -362,14 +531,25 @@ export declare const AgentHandoffStatusSchema: z.ZodEnum<{
362
531
  redeemed: "redeemed";
363
532
  }>;
364
533
  export declare const AgentHandoffSummarySchema: z.ZodObject<{
534
+ kind: z.ZodEnum<{
535
+ space: "space";
536
+ page_context: "page_context";
537
+ }>;
365
538
  id: z.ZodString;
366
539
  teamId: z.ZodString;
367
- spaceId: z.ZodString;
540
+ spaceId: z.ZodNullable<z.ZodString>;
541
+ pagePath: z.ZodNullable<z.ZodString>;
368
542
  clientTargetId: z.ZodEnum<{
543
+ any: "any";
369
544
  "claude-code": "claude-code";
370
- codex: "codex";
371
545
  cursor: "cursor";
546
+ codex: "codex";
547
+ chatgpt: "chatgpt";
372
548
  vscode: "vscode";
549
+ claude: "claude";
550
+ v0: "v0";
551
+ t3: "t3";
552
+ scira: "scira";
373
553
  }>;
374
554
  status: z.ZodEnum<{
375
555
  revoked: "revoked";
@@ -380,17 +560,31 @@ export declare const AgentHandoffSummarySchema: z.ZodObject<{
380
560
  expiresAt: z.ZodString;
381
561
  redeemedAt: z.ZodNullable<z.ZodString>;
382
562
  revokedAt: z.ZodNullable<z.ZodString>;
563
+ firstFetchedAt: z.ZodNullable<z.ZodString>;
564
+ lastFetchedAt: z.ZodNullable<z.ZodString>;
565
+ fetchCount: z.ZodNumber;
383
566
  }, z.core.$strict>;
384
567
  export type AgentHandoffSummary = z.infer<typeof AgentHandoffSummarySchema>;
385
568
  export declare const AgentHandoffListResponseSchema: z.ZodArray<z.ZodObject<{
569
+ kind: z.ZodEnum<{
570
+ space: "space";
571
+ page_context: "page_context";
572
+ }>;
386
573
  id: z.ZodString;
387
574
  teamId: z.ZodString;
388
- spaceId: z.ZodString;
575
+ spaceId: z.ZodNullable<z.ZodString>;
576
+ pagePath: z.ZodNullable<z.ZodString>;
389
577
  clientTargetId: z.ZodEnum<{
578
+ any: "any";
390
579
  "claude-code": "claude-code";
391
- codex: "codex";
392
580
  cursor: "cursor";
581
+ codex: "codex";
582
+ chatgpt: "chatgpt";
393
583
  vscode: "vscode";
584
+ claude: "claude";
585
+ v0: "v0";
586
+ t3: "t3";
587
+ scira: "scira";
394
588
  }>;
395
589
  status: z.ZodEnum<{
396
590
  revoked: "revoked";
@@ -401,6 +595,9 @@ export declare const AgentHandoffListResponseSchema: z.ZodArray<z.ZodObject<{
401
595
  expiresAt: z.ZodString;
402
596
  redeemedAt: z.ZodNullable<z.ZodString>;
403
597
  revokedAt: z.ZodNullable<z.ZodString>;
598
+ firstFetchedAt: z.ZodNullable<z.ZodString>;
599
+ lastFetchedAt: z.ZodNullable<z.ZodString>;
600
+ fetchCount: z.ZodNumber;
404
601
  }, z.core.$strict>>;
405
602
  export type AgentHandoffListResponse = z.infer<typeof AgentHandoffListResponseSchema>;
406
603
  export declare const AgentHandoffDeclineReasonSchema: z.ZodEnum<{