@withgateway/sdk 0.2.6 → 0.2.9

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 (110) hide show
  1. package/README.md +24 -8
  2. package/dist/cli.js +15468 -11263
  3. package/dist/cli.js.map +1 -1
  4. package/dist/cli.mjs +15233 -11028
  5. package/dist/cli.mjs.map +1 -1
  6. package/dist/files/index.d.mts +1 -1
  7. package/dist/files/index.d.ts +1 -1
  8. package/dist/files/index.js +291 -40
  9. package/dist/files/index.js.map +1 -1
  10. package/dist/files/index.mjs +284 -37
  11. package/dist/files/index.mjs.map +1 -1
  12. package/dist/hooks/index.d.mts +1 -1
  13. package/dist/hooks/index.d.ts +1 -1
  14. package/dist/hooks/index.js +203 -47
  15. package/dist/hooks/index.js.map +1 -1
  16. package/dist/hooks/index.mjs +198 -42
  17. package/dist/hooks/index.mjs.map +1 -1
  18. package/dist/{index-BaKu5ZSU.d.mts → index-C3UzD0G3.d.mts} +75 -1
  19. package/dist/{index-BaKu5ZSU.d.ts → index-C3UzD0G3.d.ts} +75 -1
  20. package/dist/{index-CLkMr6VG.d.ts → index-D-_4Ibcn.d.ts} +36 -4
  21. package/dist/{index-CdbmO4aX.d.mts → index-FfK4Nump.d.mts} +36 -4
  22. package/dist/index.d.mts +3 -3
  23. package/dist/index.d.ts +3 -3
  24. package/dist/index.js +2149 -615
  25. package/dist/index.js.map +1 -1
  26. package/dist/index.mjs +2053 -566
  27. package/dist/index.mjs.map +1 -1
  28. package/dist/traces/index.js +268 -31
  29. package/dist/traces/index.js.map +1 -1
  30. package/dist/traces/index.mjs +262 -28
  31. package/dist/traces/index.mjs.map +1 -1
  32. package/dist/tracing/index.js +19 -11
  33. package/dist/tracing/index.js.map +1 -1
  34. package/dist/tracing/index.mjs +19 -11
  35. package/dist/tracing/index.mjs.map +1 -1
  36. package/dist/worlds/index.d.mts +886 -117
  37. package/dist/worlds/index.d.ts +886 -117
  38. package/dist/worlds/index.js +1770 -452
  39. package/dist/worlds/index.js.map +1 -1
  40. package/dist/worlds/index.mjs +1752 -434
  41. package/dist/worlds/index.mjs.map +1 -1
  42. package/package.json +14 -10
  43. package/runtime/gatewaysdk/environment/_toml.py +3 -10
  44. package/runtime/gatewaysdk/environment/_world.py +95 -28
  45. package/runtime/gatewaysdk/environment/runtime.py +10 -6
  46. package/runtime/gatewaysdk/environment/schema/__main__.py +35 -0
  47. package/runtime/gatewaysdk/environment/schema/api.py +19 -23
  48. package/runtime/gatewaysdk/environment/schema/batch.py +68 -14
  49. package/runtime/gatewaysdk/environment/schema/bundle_runtime.py +4 -2
  50. package/runtime/gatewaysdk/environment/schema/cast.py +264 -0
  51. package/runtime/gatewaysdk/environment/schema/compiler.py +35 -1
  52. package/runtime/gatewaysdk/environment/schema/conform.py +28 -10
  53. package/runtime/gatewaysdk/environment/schema/connector.py +59 -14
  54. package/runtime/gatewaysdk/environment/schema/connectors/custom/handlers.py +38 -1
  55. package/runtime/gatewaysdk/environment/schema/connectors/google-drive/readers/merge.toml +3 -1
  56. package/runtime/gatewaysdk/environment/schema/credentials.py +20 -0
  57. package/runtime/gatewaysdk/environment/schema/csv_rows.py +117 -0
  58. package/runtime/gatewaysdk/environment/schema/cycles.py +121 -0
  59. package/runtime/gatewaysdk/environment/schema/data.py +21 -5
  60. package/runtime/gatewaysdk/environment/schema/grading.py +95 -13
  61. package/runtime/gatewaysdk/environment/schema/handler_errors.py +44 -0
  62. package/runtime/gatewaysdk/environment/schema/handler_scan.py +175 -0
  63. package/runtime/gatewaysdk/environment/schema/host.py +68 -115
  64. package/runtime/gatewaysdk/environment/schema/host_requests.py +78 -0
  65. package/runtime/gatewaysdk/environment/schema/host_surfaces.py +12 -0
  66. package/runtime/gatewaysdk/environment/schema/ingest.py +5 -18
  67. package/runtime/gatewaysdk/environment/schema/local.py +7 -10
  68. package/runtime/gatewaysdk/environment/schema/openapi_document.py +322 -0
  69. package/runtime/gatewaysdk/environment/schema/openapi_import.py +382 -0
  70. package/runtime/gatewaysdk/environment/schema/openapi_routes.py +441 -0
  71. package/runtime/gatewaysdk/environment/schema/openapi_schemas.py +629 -0
  72. package/runtime/gatewaysdk/environment/schema/openapi_source.py +210 -0
  73. package/runtime/gatewaysdk/environment/schema/platform.py +110 -299
  74. package/runtime/gatewaysdk/environment/schema/platform_import.py +182 -0
  75. package/runtime/gatewaysdk/environment/schema/platform_query.py +95 -0
  76. package/runtime/gatewaysdk/environment/schema/route_bindings.py +176 -0
  77. package/runtime/gatewaysdk/environment/schema/runtime.py +56 -7
  78. package/runtime/gatewaysdk/environment/schema/scaffold.py +64 -5
  79. package/runtime/gatewaysdk/environment/schema/skills/benchmarks-getting-started/SKILL.md +70 -22
  80. package/runtime/gatewaysdk/environment/schema/skills/connector-schema-authoring/SKILL.md +54 -4
  81. package/runtime/gatewaysdk/environment/schema/skills/hooks-getting-started/SKILL.md +27 -2
  82. package/runtime/gatewaysdk/environment/schema/skills/world-data-ingestion/ROWS.md +62 -0
  83. package/runtime/gatewaysdk/environment/schema/skills/world-data-ingestion/SKILL.md +91 -54
  84. package/runtime/gatewaysdk/environment/schema/skills/worlds-getting-started/SKILL.md +146 -146
  85. package/runtime/gatewaysdk/environment/schema/skills/worlds-getting-started/references/cli-mcp-map.md +11 -7
  86. package/runtime/gatewaysdk/environment/schema/skills/worlds-getting-started/references/gotchas.md +30 -0
  87. package/runtime/gatewaysdk/environment/schema/skills/worlds-getting-started/references/new-world-sandbox.md +43 -0
  88. package/runtime/gatewaysdk/environment/schema/skills/worlds-getting-started/references/openapi-import.md +90 -0
  89. package/runtime/gatewaysdk/environment/schema/store.py +15 -6
  90. package/runtime/gatewaysdk/environment/schema/store_contract.py +119 -0
  91. package/runtime/gatewaysdk/environment/schema/tasks.py +121 -32
  92. package/runtime/gatewaysdk/environment/schema/tools_world.py +32 -10
  93. package/runtime/gatewaysdk/environment/schema/tree_import.py +228 -0
  94. package/runtime/gatewaysdk/environment/schema/ui.py +18 -2
  95. package/runtime/gatewaysdk/environment/schema/validation.py +35 -0
  96. package/runtime/gatewaysdk/environment/schema/verbs.py +8 -2
  97. package/runtime/gatewaysdk/environment/world.py +42 -3
  98. package/runtime/gatewaysdk/environment/world_session_contract.py +57 -0
  99. package/skills/benchmarks-getting-started/SKILL.md +70 -22
  100. package/skills/connector-schema-authoring/SKILL.md +54 -4
  101. package/skills/connector-schema-authoring/connector-worlds.md +21 -7
  102. package/skills/connector-schema-authoring/world-schema.md +144 -83
  103. package/skills/hooks-getting-started/SKILL.md +27 -2
  104. package/skills/world-data-ingestion/ROWS.md +62 -0
  105. package/skills/world-data-ingestion/SKILL.md +91 -54
  106. package/skills/worlds-getting-started/SKILL.md +146 -146
  107. package/skills/worlds-getting-started/references/cli-mcp-map.md +11 -7
  108. package/skills/worlds-getting-started/references/gotchas.md +30 -0
  109. package/skills/worlds-getting-started/references/new-world-sandbox.md +43 -0
  110. package/skills/worlds-getting-started/references/openapi-import.md +90 -0
@@ -1,3 +1,50 @@
1
+ /** A stand-in the task chose, instead of one the door generates.
2
+ *
3
+ * A task may know ahead of time what a subject must look like to the model and which
4
+ * other spellings of the real value the sources carry (a forum's misspelling, a phone
5
+ * with its country digit dropped). It declares them on the seed entity:
6
+ *
7
+ * { type: "username", value: "<real>", alias: "kmarsh7", variants: ["<misspelling>"] }
8
+ *
9
+ * The door builds every pairing from the declared stand-in exactly as it would from a
10
+ * generated one, and pairs each extra spelling with the stand-in too. The pools stay the
11
+ * fallback when nothing is declared. Twin of `gatewaysdk/hooks/declared.py`. */
12
+ type Pair$1 = [real: string, fake: string];
13
+ type PairBuilder = (real: string, fake: string) => Pair$1[];
14
+ declare class DeclaredStandIn {
15
+ readonly alias: string | null;
16
+ readonly variants: readonly string[];
17
+ constructor(alias?: unknown, variants?: unknown);
18
+ static of(entity: {
19
+ alias?: unknown;
20
+ variants?: unknown;
21
+ }): DeclaredStandIn;
22
+ get declared(): boolean;
23
+ /** The pairings for `display`: the real value's forms, then every extra spelling in the
24
+ * same forms, each mapped onto the stand-in. */
25
+ pairs(real: string, display: string, build: PairBuilder): Pair$1[];
26
+ }
27
+
28
+ /**
29
+ * The alias two-way door: a private individual becomes a PLAUSIBLE STAND-IN whose
30
+ * every attribute is consistent, and the boundary between the agent and the world
31
+ * swaps the two directions.
32
+ *
33
+ * index = HMAC-SHA256(run_key, "<kind>:<canonical value>:<salt>") -> selects from a pool
34
+ *
35
+ * agent -> tool / vendor every alias variant is replaced by the REAL value
36
+ * tool / vendor -> agent every real value AND EVERY VARIANT of it is replaced by
37
+ * the matching alias variant, then what slipped is metered
38
+ *
39
+ * This is the TypeScript twin of the Python SDK's `gatewaysdk.hooks.alias`: the
40
+ * same pools, the same derivation, the same variant forms in the same order, so the
41
+ * same run key, kind and value yield the same alias string and the same variant list
42
+ * in both. `gatewaysdk/fixtures/hooks/alias-vectors.json` pins the two to each other.
43
+ *
44
+ * What this does NOT do: hide the subject from a live provider. The real name is what
45
+ * reaches the search engine or the vendor, exactly as in production.
46
+ */
47
+
1
48
  /** The kinds with a dedicated derivation; any other kind gets a `REF-nnnn` stand-in. */
2
49
  declare const KINDS: readonly ["person_name", "email", "username", "phone", "company", "domain", "ip", "account", "machine", "log"];
3
50
  type Pair = [real: string, alias: string];
@@ -70,6 +117,10 @@ type SeedEntity = {
70
117
  value: unknown;
71
118
  role?: "private" | "public";
72
119
  identity?: string;
120
+ /** A stand-in the task chose; the door generates one when absent (see `declared.ts`). */
121
+ alias?: string;
122
+ /** Other spellings of the real value the sources carry, paired with the stand-in too. */
123
+ variants?: readonly string[];
73
124
  };
74
125
  type SeedRow = {
75
126
  type: string;
@@ -112,6 +163,9 @@ declare class AliasMap {
112
163
  readonly aliasDigests: Set<string>;
113
164
  readonly leaksIn: Leak[];
114
165
  readonly leaksOut: Leak[];
166
+ /** As `leaksIn` / `leaksOut`, for values minted on sight: counted, never a failure. */
167
+ readonly bystandersIn: Leak[];
168
+ readonly bystandersOut: Leak[];
115
169
  readonly unresolvedOut: Finding$1[];
116
170
  /** Every value minted on sight: `{where, kind, alias}`. */
117
171
  readonly found: {
@@ -141,11 +195,17 @@ declare class AliasMap {
141
195
  * subject. Off (the default) such a value reaches the agent as it is — the seed
142
196
  * list is the whole map. */
143
197
  readonly mintInbound: readonly string[];
198
+ /** Every private seed must carry its own `alias`; a seed without one is refused instead
199
+ * of getting a generated persona, and nothing is minted on arrival. */
200
+ readonly declaredOnly: boolean;
144
201
  constructor(runKey: string, slugs?: readonly string[], options?: {
145
202
  publicLayerWins?: boolean;
146
203
  publicMailboxDomains?: readonly string[] | null;
147
204
  mintInbound?: readonly string[];
205
+ declaredOnly?: boolean;
148
206
  });
207
+ /** `declaredOnly`: refuse a private value that would need a generated persona. */
208
+ private requireDeclared;
149
209
  private mailboxDomains;
150
210
  private isPublic;
151
211
  private static key;
@@ -156,6 +216,7 @@ declare class AliasMap {
156
216
  identityKey?: string;
157
217
  role?: "private" | "public";
158
218
  provenance?: "seed" | "world" | "web" | "found";
219
+ declared?: DeclaredStandIn;
159
220
  }): Alias;
160
221
  /** A value of an inbound kind met in a result and never seeded: minted there and
161
222
  * then (`provenance: "found"`), its variants spliced into the live pair lists so
@@ -185,7 +246,10 @@ declare class AliasMap {
185
246
  token?: string;
186
247
  where?: string;
187
248
  }): T;
249
+ /** The stand-in and its pairings. A declared stand-in replaces the generated one; the
250
+ * kind's own pair builder runs over it and over every declared spelling. */
188
251
  private derive;
252
+ private generated;
189
253
  /** A world serves hashed personal fields as `sha256:<hex>`. If the plaintext is
190
254
  * one we know, the digest is that alias's; otherwise it is an identity we have no
191
255
  * plaintext for, and it gets its own stable stand-in digest so records still join. */
@@ -219,8 +283,14 @@ declare class AliasMap {
219
283
  /** Requirement 3: count what slipped, do not assume nothing did. The scan is
220
284
  * case-folded with whitespace collapsed and walks EVERY variant of every alias,
221
285
  * not only the pairs the rewriter used. */
286
+ /** Every private alias with a real variant of 4+ characters in the folded text,
287
+ * case subjects first. */
288
+ private surviving;
289
+ /** A leak is about a CASE SUBJECT (a seeded entity); a value that only arrived in a
290
+ * result and was given a stand-in on sight is a bystander, counted apart. */
222
291
  private meter;
223
- /** Requirement 4: the report and the artifacts must contain no real value. */
292
+ /** Requirement 4: the report and the artifacts must contain no real value OF A CASE
293
+ * SUBJECT. Bystanders are counted, never returned. */
224
294
  scanOutgoing(text: unknown, where: string): Leak[];
225
295
  /** The task the agent is given, in alias space. */
226
296
  rewriteInstruction(text: string): string;
@@ -466,6 +536,9 @@ type HookConfig = {
466
536
  aliasPublicMailboxDomains: string[] | null;
467
537
  /** `[alias] mint_inbound`: kinds minted on sight; empty = seeds only (the default). */
468
538
  aliasMintInbound: string[];
539
+ /** `[alias] declared_only`: every private seed carries its own `alias`; a seed without one is
540
+ * refused, and nothing is minted on sight. */
541
+ aliasDeclaredOnly: boolean;
469
542
  /** `[alias] legend`: where the run writes its legend at run_end (`{run_dir}`,
470
543
  * `{run_id}` interpolated); null (the default) writes nothing. */
471
544
  aliasLegend: string | null;
@@ -1029,6 +1102,7 @@ type HookRunOptions = {
1029
1102
  /** Overrides the file's `[alias] mint_inbound` for this run: what a task wants
1030
1103
  * aliased is the task's decision, not the file's. */
1031
1104
  mintInbound?: readonly string[];
1105
+ declaredOnly?: boolean;
1032
1106
  /** Where the legend is written at run_end; overrides the file's `[alias] legend`
1033
1107
  * (`null` writes nothing). The owner's way back to the real data. */
1034
1108
  legend?: string | null;
@@ -1,3 +1,50 @@
1
+ /** A stand-in the task chose, instead of one the door generates.
2
+ *
3
+ * A task may know ahead of time what a subject must look like to the model and which
4
+ * other spellings of the real value the sources carry (a forum's misspelling, a phone
5
+ * with its country digit dropped). It declares them on the seed entity:
6
+ *
7
+ * { type: "username", value: "<real>", alias: "kmarsh7", variants: ["<misspelling>"] }
8
+ *
9
+ * The door builds every pairing from the declared stand-in exactly as it would from a
10
+ * generated one, and pairs each extra spelling with the stand-in too. The pools stay the
11
+ * fallback when nothing is declared. Twin of `gatewaysdk/hooks/declared.py`. */
12
+ type Pair$1 = [real: string, fake: string];
13
+ type PairBuilder = (real: string, fake: string) => Pair$1[];
14
+ declare class DeclaredStandIn {
15
+ readonly alias: string | null;
16
+ readonly variants: readonly string[];
17
+ constructor(alias?: unknown, variants?: unknown);
18
+ static of(entity: {
19
+ alias?: unknown;
20
+ variants?: unknown;
21
+ }): DeclaredStandIn;
22
+ get declared(): boolean;
23
+ /** The pairings for `display`: the real value's forms, then every extra spelling in the
24
+ * same forms, each mapped onto the stand-in. */
25
+ pairs(real: string, display: string, build: PairBuilder): Pair$1[];
26
+ }
27
+
28
+ /**
29
+ * The alias two-way door: a private individual becomes a PLAUSIBLE STAND-IN whose
30
+ * every attribute is consistent, and the boundary between the agent and the world
31
+ * swaps the two directions.
32
+ *
33
+ * index = HMAC-SHA256(run_key, "<kind>:<canonical value>:<salt>") -> selects from a pool
34
+ *
35
+ * agent -> tool / vendor every alias variant is replaced by the REAL value
36
+ * tool / vendor -> agent every real value AND EVERY VARIANT of it is replaced by
37
+ * the matching alias variant, then what slipped is metered
38
+ *
39
+ * This is the TypeScript twin of the Python SDK's `gatewaysdk.hooks.alias`: the
40
+ * same pools, the same derivation, the same variant forms in the same order, so the
41
+ * same run key, kind and value yield the same alias string and the same variant list
42
+ * in both. `gatewaysdk/fixtures/hooks/alias-vectors.json` pins the two to each other.
43
+ *
44
+ * What this does NOT do: hide the subject from a live provider. The real name is what
45
+ * reaches the search engine or the vendor, exactly as in production.
46
+ */
47
+
1
48
  /** The kinds with a dedicated derivation; any other kind gets a `REF-nnnn` stand-in. */
2
49
  declare const KINDS: readonly ["person_name", "email", "username", "phone", "company", "domain", "ip", "account", "machine", "log"];
3
50
  type Pair = [real: string, alias: string];
@@ -70,6 +117,10 @@ type SeedEntity = {
70
117
  value: unknown;
71
118
  role?: "private" | "public";
72
119
  identity?: string;
120
+ /** A stand-in the task chose; the door generates one when absent (see `declared.ts`). */
121
+ alias?: string;
122
+ /** Other spellings of the real value the sources carry, paired with the stand-in too. */
123
+ variants?: readonly string[];
73
124
  };
74
125
  type SeedRow = {
75
126
  type: string;
@@ -112,6 +163,9 @@ declare class AliasMap {
112
163
  readonly aliasDigests: Set<string>;
113
164
  readonly leaksIn: Leak[];
114
165
  readonly leaksOut: Leak[];
166
+ /** As `leaksIn` / `leaksOut`, for values minted on sight: counted, never a failure. */
167
+ readonly bystandersIn: Leak[];
168
+ readonly bystandersOut: Leak[];
115
169
  readonly unresolvedOut: Finding$1[];
116
170
  /** Every value minted on sight: `{where, kind, alias}`. */
117
171
  readonly found: {
@@ -141,11 +195,17 @@ declare class AliasMap {
141
195
  * subject. Off (the default) such a value reaches the agent as it is — the seed
142
196
  * list is the whole map. */
143
197
  readonly mintInbound: readonly string[];
198
+ /** Every private seed must carry its own `alias`; a seed without one is refused instead
199
+ * of getting a generated persona, and nothing is minted on arrival. */
200
+ readonly declaredOnly: boolean;
144
201
  constructor(runKey: string, slugs?: readonly string[], options?: {
145
202
  publicLayerWins?: boolean;
146
203
  publicMailboxDomains?: readonly string[] | null;
147
204
  mintInbound?: readonly string[];
205
+ declaredOnly?: boolean;
148
206
  });
207
+ /** `declaredOnly`: refuse a private value that would need a generated persona. */
208
+ private requireDeclared;
149
209
  private mailboxDomains;
150
210
  private isPublic;
151
211
  private static key;
@@ -156,6 +216,7 @@ declare class AliasMap {
156
216
  identityKey?: string;
157
217
  role?: "private" | "public";
158
218
  provenance?: "seed" | "world" | "web" | "found";
219
+ declared?: DeclaredStandIn;
159
220
  }): Alias;
160
221
  /** A value of an inbound kind met in a result and never seeded: minted there and
161
222
  * then (`provenance: "found"`), its variants spliced into the live pair lists so
@@ -185,7 +246,10 @@ declare class AliasMap {
185
246
  token?: string;
186
247
  where?: string;
187
248
  }): T;
249
+ /** The stand-in and its pairings. A declared stand-in replaces the generated one; the
250
+ * kind's own pair builder runs over it and over every declared spelling. */
188
251
  private derive;
252
+ private generated;
189
253
  /** A world serves hashed personal fields as `sha256:<hex>`. If the plaintext is
190
254
  * one we know, the digest is that alias's; otherwise it is an identity we have no
191
255
  * plaintext for, and it gets its own stable stand-in digest so records still join. */
@@ -219,8 +283,14 @@ declare class AliasMap {
219
283
  /** Requirement 3: count what slipped, do not assume nothing did. The scan is
220
284
  * case-folded with whitespace collapsed and walks EVERY variant of every alias,
221
285
  * not only the pairs the rewriter used. */
286
+ /** Every private alias with a real variant of 4+ characters in the folded text,
287
+ * case subjects first. */
288
+ private surviving;
289
+ /** A leak is about a CASE SUBJECT (a seeded entity); a value that only arrived in a
290
+ * result and was given a stand-in on sight is a bystander, counted apart. */
222
291
  private meter;
223
- /** Requirement 4: the report and the artifacts must contain no real value. */
292
+ /** Requirement 4: the report and the artifacts must contain no real value OF A CASE
293
+ * SUBJECT. Bystanders are counted, never returned. */
224
294
  scanOutgoing(text: unknown, where: string): Leak[];
225
295
  /** The task the agent is given, in alias space. */
226
296
  rewriteInstruction(text: string): string;
@@ -466,6 +536,9 @@ type HookConfig = {
466
536
  aliasPublicMailboxDomains: string[] | null;
467
537
  /** `[alias] mint_inbound`: kinds minted on sight; empty = seeds only (the default). */
468
538
  aliasMintInbound: string[];
539
+ /** `[alias] declared_only`: every private seed carries its own `alias`; a seed without one is
540
+ * refused, and nothing is minted on sight. */
541
+ aliasDeclaredOnly: boolean;
469
542
  /** `[alias] legend`: where the run writes its legend at run_end (`{run_dir}`,
470
543
  * `{run_id}` interpolated); null (the default) writes nothing. */
471
544
  aliasLegend: string | null;
@@ -1029,6 +1102,7 @@ type HookRunOptions = {
1029
1102
  /** Overrides the file's `[alias] mint_inbound` for this run: what a task wants
1030
1103
  * aliased is the task's decision, not the file's. */
1031
1104
  mintInbound?: readonly string[];
1105
+ declaredOnly?: boolean;
1032
1106
  /** Where the legend is written at run_end; overrides the file's `[alias] legend`
1033
1107
  * (`null` writes nothing). The owner's way back to the real data. */
1034
1108
  legend?: string | null;
@@ -12,6 +12,8 @@ import { WorldsClientOptions } from './worlds/index.js';
12
12
  * DELETE /api/public/files?path= a file, or a folder subtree
13
13
  * POST /api/public/files/move { fromPath, toPath }
14
14
  * POST /api/public/files/folders { path }
15
+ * POST /api/public/files/fetch { url, path, headers?, contentType?, overwrite? }
16
+ * the platform downloads a URL
15
17
  *
16
18
  * Bytes go straight to storage: an upload is a PUT to the presigned URL with
17
19
  * the SHA-256 S3 enforces, a download a GET from one. The app never proxies
@@ -78,8 +80,11 @@ declare function listFiles(options?: WorldsClientOptions, params?: {
78
80
  declare function iterateFiles(options?: WorldsClientOptions, prefix?: string): AsyncGenerator<DriveFile>;
79
81
  /** Metadata plus a presigned URL for one file; a 404 names the path. */
80
82
  declare function getFile(options: WorldsClientOptions | undefined, filePath: string): Promise<DriveDownload>;
81
- /** The whole file in memory — for text, configs, anything you would `cat`. */
82
- declare function readFile(options: WorldsClientOptions | undefined, filePath: string): Promise<Buffer>;
83
+ /** The whole file in memory — for text, configs, anything you would `cat`; with
84
+ * `maxBytes` a larger file is refused before any byte is fetched. */
85
+ declare function readFile(options: WorldsClientOptions | undefined, filePath: string, limits?: {
86
+ maxBytes?: number;
87
+ }): Promise<Buffer>;
83
88
  /** Stream one file to a local path; the parent directory is created. */
84
89
  declare function downloadFile(options: WorldsClientOptions | undefined, filePath: string, outPath: string, onProgress?: (received: number, total: number | null) => void): Promise<DriveDownload & {
85
90
  out: string;
@@ -118,6 +123,29 @@ declare function deleteFile(options: WorldsClientOptions | undefined, filePath:
118
123
  declare function moveFile(options: WorldsClientOptions | undefined, fromPath: string, toPath: string): Promise<{
119
124
  moved: number;
120
125
  }>;
126
+ type FetchHeader = {
127
+ name: string;
128
+ value: string;
129
+ };
130
+ type FetchToDriveOptions = {
131
+ /** Request headers for the URL's origin; a value may name a project secret as `{{secret:NAME}}`, expanded on the platform. */
132
+ headers?: FetchHeader[];
133
+ contentType?: string;
134
+ overwrite?: boolean;
135
+ };
136
+ type FetchToDriveResult = {
137
+ path: string;
138
+ sizeBytes: number;
139
+ contentType: string | null;
140
+ sourceUrl: string;
141
+ /** What the caller should know (a plaintext http:// fetch); never a header value. */
142
+ warnings: string[];
143
+ };
144
+ /**
145
+ * The platform fetches a public URL into the drive: the bytes never touch this
146
+ * machine and `{{secret:NAME}}` in a header value is expanded server-side.
147
+ */
148
+ declare function fetchToDrive(options: WorldsClientOptions | undefined, url: string, targetPath: string, fetchOptions?: FetchToDriveOptions): Promise<FetchToDriveResult>;
121
149
  /** Create an (empty) folder. Idempotent. */
122
150
  declare function createFolder(options: WorldsClientOptions | undefined, folderPath: string): Promise<{
123
151
  path: string;
@@ -143,6 +171,9 @@ type index_DriveDownload = DriveDownload;
143
171
  type index_DriveFile = DriveFile;
144
172
  type index_DriveFolder = DriveFolder;
145
173
  type index_DriveListing = DriveListing;
174
+ type index_FetchHeader = FetchHeader;
175
+ type index_FetchToDriveOptions = FetchToDriveOptions;
176
+ type index_FetchToDriveResult = FetchToDriveResult;
146
177
  type index_FileConnector = FileConnector;
147
178
  type index_UploadOptions = UploadOptions;
148
179
  type index_UploadResult = UploadResult;
@@ -152,6 +183,7 @@ declare const index_createFolder: typeof createFolder;
152
183
  declare const index_deleteFile: typeof deleteFile;
153
184
  declare const index_downloadFile: typeof downloadFile;
154
185
  declare const index_drivePath: typeof drivePath;
186
+ declare const index_fetchToDrive: typeof fetchToDrive;
155
187
  declare const index_getFile: typeof getFile;
156
188
  declare const index_isDriveRef: typeof isDriveRef;
157
189
  declare const index_iterateFiles: typeof iterateFiles;
@@ -165,7 +197,7 @@ declare const index_syncFileConnector: typeof syncFileConnector;
165
197
  declare const index_uploadBytes: typeof uploadBytes;
166
198
  declare const index_uploadFile: typeof uploadFile;
167
199
  declare namespace index {
168
- export { index_DRIVE_PREFIX as DRIVE_PREFIX, type index_DriveDownload as DriveDownload, type index_DriveFile as DriveFile, type index_DriveFolder as DriveFolder, type index_DriveListing as DriveListing, type index_FileConnector as FileConnector, type index_UploadOptions as UploadOptions, type index_UploadResult as UploadResult, index_confirmUpload as confirmUpload, index_contentTypeFor as contentTypeFor, index_createFolder as createFolder, index_deleteFile as deleteFile, index_downloadFile as downloadFile, index_drivePath as drivePath, index_getFile as getFile, index_isDriveRef as isDriveRef, index_iterateFiles as iterateFiles, index_listFileConnectors as listFileConnectors, index_listFiles as listFiles, index_moveFile as moveFile, index_readFile as readFile, index_requestUpload as requestUpload, index_sha256Base64 as sha256Base64, index_syncFileConnector as syncFileConnector, index_uploadBytes as uploadBytes, index_uploadFile as uploadFile };
200
+ export { index_DRIVE_PREFIX as DRIVE_PREFIX, type index_DriveDownload as DriveDownload, type index_DriveFile as DriveFile, type index_DriveFolder as DriveFolder, type index_DriveListing as DriveListing, type index_FetchHeader as FetchHeader, type index_FetchToDriveOptions as FetchToDriveOptions, type index_FetchToDriveResult as FetchToDriveResult, type index_FileConnector as FileConnector, type index_UploadOptions as UploadOptions, type index_UploadResult as UploadResult, index_confirmUpload as confirmUpload, index_contentTypeFor as contentTypeFor, index_createFolder as createFolder, index_deleteFile as deleteFile, index_downloadFile as downloadFile, index_drivePath as drivePath, index_fetchToDrive as fetchToDrive, index_getFile as getFile, index_isDriveRef as isDriveRef, index_iterateFiles as iterateFiles, index_listFileConnectors as listFileConnectors, index_listFiles as listFiles, index_moveFile as moveFile, index_readFile as readFile, index_requestUpload as requestUpload, index_sha256Base64 as sha256Base64, index_syncFileConnector as syncFileConnector, index_uploadBytes as uploadBytes, index_uploadFile as uploadFile };
169
201
  }
170
202
 
171
- export { DRIVE_PREFIX as D, type FileConnector as F, type UploadOptions as U, type DriveDownload as a, type DriveFile as b, type DriveFolder as c, type DriveListing as d, type UploadResult as e, confirmUpload as f, contentTypeFor as g, createFolder as h, index as i, deleteFile as j, downloadFile as k, drivePath as l, getFile as m, isDriveRef as n, iterateFiles as o, listFileConnectors as p, listFiles as q, moveFile as r, readFile as s, requestUpload as t, sha256Base64 as u, syncFileConnector as v, uploadBytes as w, uploadFile as x };
203
+ export { uploadBytes as A, uploadFile as B, DRIVE_PREFIX as D, type FetchHeader as F, type UploadOptions as U, type DriveDownload as a, type DriveFile as b, type DriveFolder as c, type DriveListing as d, type FetchToDriveOptions as e, type FetchToDriveResult as f, type FileConnector as g, type UploadResult as h, index as i, confirmUpload as j, contentTypeFor as k, createFolder as l, deleteFile as m, downloadFile as n, drivePath as o, fetchToDrive as p, getFile as q, isDriveRef as r, iterateFiles as s, listFileConnectors as t, listFiles as u, moveFile as v, readFile as w, requestUpload as x, sha256Base64 as y, syncFileConnector as z };
@@ -12,6 +12,8 @@ import { WorldsClientOptions } from './worlds/index.mjs';
12
12
  * DELETE /api/public/files?path= a file, or a folder subtree
13
13
  * POST /api/public/files/move { fromPath, toPath }
14
14
  * POST /api/public/files/folders { path }
15
+ * POST /api/public/files/fetch { url, path, headers?, contentType?, overwrite? }
16
+ * the platform downloads a URL
15
17
  *
16
18
  * Bytes go straight to storage: an upload is a PUT to the presigned URL with
17
19
  * the SHA-256 S3 enforces, a download a GET from one. The app never proxies
@@ -78,8 +80,11 @@ declare function listFiles(options?: WorldsClientOptions, params?: {
78
80
  declare function iterateFiles(options?: WorldsClientOptions, prefix?: string): AsyncGenerator<DriveFile>;
79
81
  /** Metadata plus a presigned URL for one file; a 404 names the path. */
80
82
  declare function getFile(options: WorldsClientOptions | undefined, filePath: string): Promise<DriveDownload>;
81
- /** The whole file in memory — for text, configs, anything you would `cat`. */
82
- declare function readFile(options: WorldsClientOptions | undefined, filePath: string): Promise<Buffer>;
83
+ /** The whole file in memory — for text, configs, anything you would `cat`; with
84
+ * `maxBytes` a larger file is refused before any byte is fetched. */
85
+ declare function readFile(options: WorldsClientOptions | undefined, filePath: string, limits?: {
86
+ maxBytes?: number;
87
+ }): Promise<Buffer>;
83
88
  /** Stream one file to a local path; the parent directory is created. */
84
89
  declare function downloadFile(options: WorldsClientOptions | undefined, filePath: string, outPath: string, onProgress?: (received: number, total: number | null) => void): Promise<DriveDownload & {
85
90
  out: string;
@@ -118,6 +123,29 @@ declare function deleteFile(options: WorldsClientOptions | undefined, filePath:
118
123
  declare function moveFile(options: WorldsClientOptions | undefined, fromPath: string, toPath: string): Promise<{
119
124
  moved: number;
120
125
  }>;
126
+ type FetchHeader = {
127
+ name: string;
128
+ value: string;
129
+ };
130
+ type FetchToDriveOptions = {
131
+ /** Request headers for the URL's origin; a value may name a project secret as `{{secret:NAME}}`, expanded on the platform. */
132
+ headers?: FetchHeader[];
133
+ contentType?: string;
134
+ overwrite?: boolean;
135
+ };
136
+ type FetchToDriveResult = {
137
+ path: string;
138
+ sizeBytes: number;
139
+ contentType: string | null;
140
+ sourceUrl: string;
141
+ /** What the caller should know (a plaintext http:// fetch); never a header value. */
142
+ warnings: string[];
143
+ };
144
+ /**
145
+ * The platform fetches a public URL into the drive: the bytes never touch this
146
+ * machine and `{{secret:NAME}}` in a header value is expanded server-side.
147
+ */
148
+ declare function fetchToDrive(options: WorldsClientOptions | undefined, url: string, targetPath: string, fetchOptions?: FetchToDriveOptions): Promise<FetchToDriveResult>;
121
149
  /** Create an (empty) folder. Idempotent. */
122
150
  declare function createFolder(options: WorldsClientOptions | undefined, folderPath: string): Promise<{
123
151
  path: string;
@@ -143,6 +171,9 @@ type index_DriveDownload = DriveDownload;
143
171
  type index_DriveFile = DriveFile;
144
172
  type index_DriveFolder = DriveFolder;
145
173
  type index_DriveListing = DriveListing;
174
+ type index_FetchHeader = FetchHeader;
175
+ type index_FetchToDriveOptions = FetchToDriveOptions;
176
+ type index_FetchToDriveResult = FetchToDriveResult;
146
177
  type index_FileConnector = FileConnector;
147
178
  type index_UploadOptions = UploadOptions;
148
179
  type index_UploadResult = UploadResult;
@@ -152,6 +183,7 @@ declare const index_createFolder: typeof createFolder;
152
183
  declare const index_deleteFile: typeof deleteFile;
153
184
  declare const index_downloadFile: typeof downloadFile;
154
185
  declare const index_drivePath: typeof drivePath;
186
+ declare const index_fetchToDrive: typeof fetchToDrive;
155
187
  declare const index_getFile: typeof getFile;
156
188
  declare const index_isDriveRef: typeof isDriveRef;
157
189
  declare const index_iterateFiles: typeof iterateFiles;
@@ -165,7 +197,7 @@ declare const index_syncFileConnector: typeof syncFileConnector;
165
197
  declare const index_uploadBytes: typeof uploadBytes;
166
198
  declare const index_uploadFile: typeof uploadFile;
167
199
  declare namespace index {
168
- export { index_DRIVE_PREFIX as DRIVE_PREFIX, type index_DriveDownload as DriveDownload, type index_DriveFile as DriveFile, type index_DriveFolder as DriveFolder, type index_DriveListing as DriveListing, type index_FileConnector as FileConnector, type index_UploadOptions as UploadOptions, type index_UploadResult as UploadResult, index_confirmUpload as confirmUpload, index_contentTypeFor as contentTypeFor, index_createFolder as createFolder, index_deleteFile as deleteFile, index_downloadFile as downloadFile, index_drivePath as drivePath, index_getFile as getFile, index_isDriveRef as isDriveRef, index_iterateFiles as iterateFiles, index_listFileConnectors as listFileConnectors, index_listFiles as listFiles, index_moveFile as moveFile, index_readFile as readFile, index_requestUpload as requestUpload, index_sha256Base64 as sha256Base64, index_syncFileConnector as syncFileConnector, index_uploadBytes as uploadBytes, index_uploadFile as uploadFile };
200
+ export { index_DRIVE_PREFIX as DRIVE_PREFIX, type index_DriveDownload as DriveDownload, type index_DriveFile as DriveFile, type index_DriveFolder as DriveFolder, type index_DriveListing as DriveListing, type index_FetchHeader as FetchHeader, type index_FetchToDriveOptions as FetchToDriveOptions, type index_FetchToDriveResult as FetchToDriveResult, type index_FileConnector as FileConnector, type index_UploadOptions as UploadOptions, type index_UploadResult as UploadResult, index_confirmUpload as confirmUpload, index_contentTypeFor as contentTypeFor, index_createFolder as createFolder, index_deleteFile as deleteFile, index_downloadFile as downloadFile, index_drivePath as drivePath, index_fetchToDrive as fetchToDrive, index_getFile as getFile, index_isDriveRef as isDriveRef, index_iterateFiles as iterateFiles, index_listFileConnectors as listFileConnectors, index_listFiles as listFiles, index_moveFile as moveFile, index_readFile as readFile, index_requestUpload as requestUpload, index_sha256Base64 as sha256Base64, index_syncFileConnector as syncFileConnector, index_uploadBytes as uploadBytes, index_uploadFile as uploadFile };
169
201
  }
170
202
 
171
- export { DRIVE_PREFIX as D, type FileConnector as F, type UploadOptions as U, type DriveDownload as a, type DriveFile as b, type DriveFolder as c, type DriveListing as d, type UploadResult as e, confirmUpload as f, contentTypeFor as g, createFolder as h, index as i, deleteFile as j, downloadFile as k, drivePath as l, getFile as m, isDriveRef as n, iterateFiles as o, listFileConnectors as p, listFiles as q, moveFile as r, readFile as s, requestUpload as t, sha256Base64 as u, syncFileConnector as v, uploadBytes as w, uploadFile as x };
203
+ export { uploadBytes as A, uploadFile as B, DRIVE_PREFIX as D, type FetchHeader as F, type UploadOptions as U, type DriveDownload as a, type DriveFile as b, type DriveFolder as c, type DriveListing as d, type FetchToDriveOptions as e, type FetchToDriveResult as f, type FileConnector as g, type UploadResult as h, index as i, confirmUpload as j, contentTypeFor as k, createFolder as l, deleteFile as m, downloadFile as n, drivePath as o, fetchToDrive as p, getFile as q, isDriveRef as r, iterateFiles as s, listFileConnectors as t, listFiles as u, moveFile as v, readFile as w, requestUpload as x, sha256Base64 as y, syncFileConnector as z };
package/dist/index.d.mts CHANGED
@@ -7,10 +7,10 @@ export { GatewayAgentDescriptor, GatewaySecurity, GatewaySecurityConfig, Gateway
7
7
  export { DEFAULT_TIMEOUT_SECONDS, ENV_GATEWAY_HOST, ENV_GATEWAY_PUBLIC_KEY, ENV_GATEWAY_SECRET_KEY, LoadSessionOptions, SessionLoadError, SessionObservation, SessionRecording, SessionTrace, basicAuthHeader, loadSession, sessionObservationFromApi, sessions } from './sessions/index.mjs';
8
8
  export { UserEvent, UserEventOptions, UserProfile, UserProfileError, UserProfileUpdate, UsersClient, UsersClientConfig, UsersClientFromEnvConfig, users } from './users/index.mjs';
9
9
  export { AGENT_ID_KEY, SUCCESS_METRIC_NAME_KEY, SUCCESS_SIGNAL_KEY, ScoreDataType, ScoreError, ScoreOptions, ScoresClient, ScoresClientConfig, ScoresClientFromEnvConfig, SuccessOptions, currentTraceId, scores, success } from './scores/index.mjs';
10
- export { ApiError, BrowserActionEvent, BrowserActionRecorder, BrowserMode, BrowserPage, COMPUTER_USE_SPECS, CreateEvaluationOptions, DEFAULT_BRANCH, DEFAULT_VIEWPORT, DispatchedRun, EVENT_BATCH_SIZE, EVENT_FLUSH_INTERVAL_MS, EVENT_MAX_RETRIES, EvalSample, FinalizeEvaluationOptions, GatewayEvalsClient, GradeResult, IngestExplode, IngestFieldSpec, IngestMapping, IngestMode, IngestOptions, IngestRefusal, IngestReport, IngestSource, IngestSourceReport, IngestToolCallsOptions, IngestToolCallsReport, LiveTaskSession, LocalMeta, MigrateWorldOptions, ObservationConversion, ObservationLike, OpenSessionOptions, OpenTaskOptions, ParsedToolCall, Plaintext, PlaywrightBrowserLike, PlaywrightLike, PushSlugConflict, PushSlugResolution, RedactMode, RedactPolicy, Redaction, ResolvedWorldVersion, RunConfigInput, RunConfigSummary, RunProvenance, RunReport, RunTaskOptions, RunTaskSummary, STRIP_PREFIX, SURFACE_KINDS, SandboxChanges, SandboxCheckResult, SandboxCommitResult, SandboxExecResult, SandboxOpened, SandboxSummary, SeedResult, SessionRunReport, SessionRunResult, SessionSurfaces, SlugDeclaration, TRANSFORMS, TaskExport, TaskGrade, TaskManifest, TaskManifestSession, TaskRun, TaskRunResult, TaskSessions, TaskSessionsResponse, TaskWorldSessionState, ToolCallRecord, ToolCallSink, ToolFunctions, Transform, ValidateReport, ValidatedRun, WHITESPACE, WorldBrowser, WorldDependency, WorldDeprecation, WorldDescription, WorldEntity, WorldEntityMapping, WorldField, WorldMigrationRefusal, WorldMigrationReport, WorldQueryAcrossOptions, WorldQueryAcrossResult, WorldQueryCompare, WorldQueryCompareStatus, WorldQueryGroup, WorldQueryOptions, WorldQueryResult, WorldQuerySnapshot, WorldQueryWhere, WorldRelationship, WorldSandboxClient, WorldSession, WorldSessionCall, WorldSessionCallError, WorldSessionState, WorldSessionTask, WorldSessionTimeout, WorldSet, WorldSurfaceKind, WorldSurfaceUnavailable, WorldTask, WorldTaskCheck, WorldTaskDetail, WorldTaskFieldOp, WorldTaskGrader, WorldTaskIdRef, WorldTaskInfo, WorldTaskPage, WorldTaskRef, WorldTaskRubricCriterion, WorldTaskRubricGrader, WorldTaskScalar, WorldTaskSeed, WorldTaskSpec, WorldTaskSummary, WorldTaskValidation, WorldTaskVersionSummary, WorldTaskWorld, WorldTaskWorldValidation, WorldToolSpec, WorldToolkit, WorldsClientOptions, aggregateTaskGrade, apiRequest, applyTransforms, archiveMode, attachManifest, attachSession, attachTask, buildFileManifest, buildSourceTarball, captureToolCalls, collectArchiveRelPaths, computeContentHash, computerUseToolkit, createRef, createTask, deleteEnvSecret, deleteTask, describeWorld, detectProvenance, extractBundle, getRun, getTask, hashForm, ingest, ingestToolCalls, isTaskIdRef, isTaskManifest, isTaskSpec, listEnvSecretKeys, listRunConfigs, listTaskSessions, listTasks, localTreeState, migrateProjectWorlds, migrateWorld, modelToolName, openBrowser, openSession, openTask, openWorld, openWorldVersion, parseSlugRef, parseToolCallRecord, parseTransform, parseWorldTaskRefs, preserveForm, propose, pull, push, pushSlug, pyText, queryRows, queryRowsSearch, readLocalMeta, readToolCallRecords, redactActionArgs, redactionOf, resolveBrowserMode, resolvePushSlug, roundForm, runSessions, runTask, schemaFromSignature, sessionToolObservations, setEnvSecret, shapeText, snapshotTreeHashes, storedForms, surfaceKinds, taskLabel, toolCallRecordsIn, toolCallsFromObservations, uiEntryUrl, uiUrl, updateTask, upsertRunConfig, validateTask, validateWorld, waitForRun, withoutUiToken, writeLocalMeta } from './worlds/index.mjs';
11
- export { i as files } from './index-CdbmO4aX.mjs';
10
+ export { ApiError, BROWSER_GONE_PATTERNS, BROWSER_TIERS, BrowserActionEvent, BrowserActionRecorder, BrowserConnection, BrowserMode, BrowserPage, BrowserReconnected, BrowserReconnector, BrowserTier, BrowserUnrecoverable, CALL_BODY_LIMIT_BYTES, CALL_BODY_LIMIT_LABEL, COMPUTER_USE_SPECS, Checkout, CheckoutProvenance, CreateEvaluationOptions, DEFAULT_BRANCH, DEFAULT_VIEWPORT, DRY_RUN_AGENT, DRY_RUN_KIND, DetachedPushError, DispatchedRun, DryRunImageDecision, DryRunOutcome, DryRunSettlement, EVENT_BATCH_SIZE, EVENT_FLUSH_INTERVAL_MS, EVENT_MAX_RETRIES, EXPLORATORY_TASK, EXPLORATORY_TASK_SOURCE, EditSessionCloseInput, EditSessionList, EditSessionListQuery, EditSessionResult, EditSessionRollbackInput, EditSessionSummary, EvalSample, FinalizeEvaluationOptions, GatewayEvalsClient, GradeResult, HostedDryRunClient, HostedDryRunDispatch, HostedDryRunStatus, HostedDryRunVerdict, IDLE_WARNING_MINUTES, IngestExplode, IngestFieldSpec, IngestMapping, IngestMode, IngestOptions, IngestRefusal, IngestReport, IngestSource, IngestSourceReport, IngestToolCallsOptions, IngestToolCallsReport, ListRunsFilter, ListSessionsFilter, LiveTaskSession, LocalMeta, MigrateWorldOptions, NO_GRADER_REASON, ObservationConversion, ObservationLike, OpenSessionOptions, OpenTaskOptions, PLATFORM_TIMEOUT_DEFAULT_MS, PLATFORM_TIMEOUT_ENV, ParsedToolCall, Plaintext, PlatformEndpoint, PlatformMethod, PlatformReply, PlatformTransport, PlaywrightBrowserLike, PlaywrightLike, PushSlugConflict, PushSlugResolution, RECOVER_BUDGET_MS, RebaseConflictPath, RecoveryResult, RedactMode, RedactPolicy, Redaction, RepairAnswer, ResolvedWorldVersion, RunConfigInput, RunConfigSummary, RunProvenance, RunReport, RunSetOptions, RunSetResult, RunSummary, RunTaskOptions, RunTaskSummary, SANDBOX_REQUEST_TIMEOUT_MS, SESSION_STATES, STATUS_WAIT_CAP_SECONDS, STRIP_PREFIX, SURFACE_KINDS, SandboxChanges, SandboxCheckResult, SandboxCommitInput, SandboxCommitResult, SandboxExecResult, SandboxImportInput, SandboxImportPending, SandboxImportResult, SandboxListFilter, SandboxOpenExisting, SandboxOpenNew, SandboxOpenTarget, SandboxOpened, SandboxSummary, SecretScrubber, SeedResult, SessionRunReport, SessionRunResult, SessionSurfaces, SetRunDoc, SettleOptions, SlugDeclaration, TRANSFORMS, TaskExport, TaskGrade, TaskManifest, TaskManifestSession, TaskRun, TaskRunResult, TaskSessions, TaskSessionsResponse, TaskWorldSessionState, ToolCallRecord, ToolCallSink, ToolFunctions, Transform, TransportCause, UnreachableError, VERIFIER_REWARD_PREFIX, ValidateReport, ValidatedRun, VerifierGrade, WHITESPACE, WorldBrowser, WorldCallTooLarge, WorldDependency, WorldDeprecation, WorldDescription, WorldEditClient, WorldEntity, WorldEntityMapping, WorldField, WorldMigrationRefusal, WorldMigrationReport, WorldQueryAcrossOptions, WorldQueryAcrossResult, WorldQueryCompare, WorldQueryCompareStatus, WorldQueryGroup, WorldQueryOptions, WorldQueryResult, WorldQuerySnapshot, WorldQueryWhere, WorldRelationship, WorldSandboxClient, WorldSession, WorldSessionCall, WorldSessionCallError, WorldSessionListItem, WorldSessionState, WorldSessionTask, WorldSessionTimeout, WorldSet, WorldSurfaceKind, WorldSurfaceUnavailable, WorldTask, WorldTaskCheck, WorldTaskDetail, WorldTaskFieldOp, WorldTaskGrader, WorldTaskIdRef, WorldTaskInfo, WorldTaskPage, WorldTaskRef, WorldTaskRubricCriterion, WorldTaskRubricGrader, WorldTaskScalar, WorldTaskSeed, WorldTaskSpec, WorldTaskSummary, WorldTaskValidation, WorldTaskVerifier, WorldTaskVerifierRow, WorldTaskVersionSummary, WorldTaskWorld, WorldTaskWorldValidation, WorldToolSpec, WorldToolkit, WorldsClientOptions, aggregateTaskGrade, apiRequest, applyTransforms, archiveMode, assertBrowserTier, assertTaskRef, attachManifest, attachSession, attachTask, buildFileManifest, buildSourceTarball, captureToolCalls, checkoutIdentity, closeConnection, collectArchiveRelPaths, computeContentHash, computerUseToolkit, createRef, createTask, deleteEnvSecret, deleteTask, describeWorld, detectProvenance, extractBundle, getRun, getTask, hashForm, idleWarning, ingest, ingestToolCalls, isBrowserGone, isSandboxImportPending, isTaskIdRef, isTaskManifest, isTaskSpec, listEnvSecretKeys, listRunConfigs, listRuns, listSessions, listTaskSessions, listTasks, localTreeState, migrateProjectWorlds, migrateWorld, modelToolName, openBrowser, openSession, openTask, openWorld, openWorldVersion, parseErrorBody, parseSlugRef, parseToolCallRecord, parseTransform, parseWorldTaskRefs, platformTimeoutMs, preserveForm, propose, pull, push, pushBranch, pushSlug, pyText, queryRows, queryRowsSearch, readLocalMeta, readToolCallRecords, rebaseConflicts, redactActionArgs, redactionOf, releaseConnection, resolveBrowserMode, resolvePushSlug, roundForm, runSessions, runSet, runTask, schemaFromSignature, serializeCallBody, sessionToolObservations, setEnvSecret, shapeText, snapshotTreeHashes, storedForms, surfaceKinds, taskLabel, toolCallRecordsIn, toolCallsFromObservations, uiEntryUrl, uiUrl, uncommittedPaths, updateTask, upsertRunConfig, validateTask, validateWorld, waitForRun, withoutUiToken, writeLocalMeta } from './worlds/index.mjs';
11
+ export { i as files } from './index-FfK4Nump.mjs';
12
12
  export { i as traces } from './index-CiKWoroJ.mjs';
13
- export { i as hooks } from './index-BaKu5ZSU.mjs';
13
+ export { i as hooks } from './index-C3UzD0G3.mjs';
14
14
  import { _ as _tracingModule } from './index-Cz8Q6Keo.mjs';
15
15
  export { I as IdentifyOptions, i as identify, r as resolveUserId } from './index-Cz8Q6Keo.mjs';
16
16
  import 'async_hooks';
package/dist/index.d.ts CHANGED
@@ -7,10 +7,10 @@ export { GatewayAgentDescriptor, GatewaySecurity, GatewaySecurityConfig, Gateway
7
7
  export { DEFAULT_TIMEOUT_SECONDS, ENV_GATEWAY_HOST, ENV_GATEWAY_PUBLIC_KEY, ENV_GATEWAY_SECRET_KEY, LoadSessionOptions, SessionLoadError, SessionObservation, SessionRecording, SessionTrace, basicAuthHeader, loadSession, sessionObservationFromApi, sessions } from './sessions/index.js';
8
8
  export { UserEvent, UserEventOptions, UserProfile, UserProfileError, UserProfileUpdate, UsersClient, UsersClientConfig, UsersClientFromEnvConfig, users } from './users/index.js';
9
9
  export { AGENT_ID_KEY, SUCCESS_METRIC_NAME_KEY, SUCCESS_SIGNAL_KEY, ScoreDataType, ScoreError, ScoreOptions, ScoresClient, ScoresClientConfig, ScoresClientFromEnvConfig, SuccessOptions, currentTraceId, scores, success } from './scores/index.js';
10
- export { ApiError, BrowserActionEvent, BrowserActionRecorder, BrowserMode, BrowserPage, COMPUTER_USE_SPECS, CreateEvaluationOptions, DEFAULT_BRANCH, DEFAULT_VIEWPORT, DispatchedRun, EVENT_BATCH_SIZE, EVENT_FLUSH_INTERVAL_MS, EVENT_MAX_RETRIES, EvalSample, FinalizeEvaluationOptions, GatewayEvalsClient, GradeResult, IngestExplode, IngestFieldSpec, IngestMapping, IngestMode, IngestOptions, IngestRefusal, IngestReport, IngestSource, IngestSourceReport, IngestToolCallsOptions, IngestToolCallsReport, LiveTaskSession, LocalMeta, MigrateWorldOptions, ObservationConversion, ObservationLike, OpenSessionOptions, OpenTaskOptions, ParsedToolCall, Plaintext, PlaywrightBrowserLike, PlaywrightLike, PushSlugConflict, PushSlugResolution, RedactMode, RedactPolicy, Redaction, ResolvedWorldVersion, RunConfigInput, RunConfigSummary, RunProvenance, RunReport, RunTaskOptions, RunTaskSummary, STRIP_PREFIX, SURFACE_KINDS, SandboxChanges, SandboxCheckResult, SandboxCommitResult, SandboxExecResult, SandboxOpened, SandboxSummary, SeedResult, SessionRunReport, SessionRunResult, SessionSurfaces, SlugDeclaration, TRANSFORMS, TaskExport, TaskGrade, TaskManifest, TaskManifestSession, TaskRun, TaskRunResult, TaskSessions, TaskSessionsResponse, TaskWorldSessionState, ToolCallRecord, ToolCallSink, ToolFunctions, Transform, ValidateReport, ValidatedRun, WHITESPACE, WorldBrowser, WorldDependency, WorldDeprecation, WorldDescription, WorldEntity, WorldEntityMapping, WorldField, WorldMigrationRefusal, WorldMigrationReport, WorldQueryAcrossOptions, WorldQueryAcrossResult, WorldQueryCompare, WorldQueryCompareStatus, WorldQueryGroup, WorldQueryOptions, WorldQueryResult, WorldQuerySnapshot, WorldQueryWhere, WorldRelationship, WorldSandboxClient, WorldSession, WorldSessionCall, WorldSessionCallError, WorldSessionState, WorldSessionTask, WorldSessionTimeout, WorldSet, WorldSurfaceKind, WorldSurfaceUnavailable, WorldTask, WorldTaskCheck, WorldTaskDetail, WorldTaskFieldOp, WorldTaskGrader, WorldTaskIdRef, WorldTaskInfo, WorldTaskPage, WorldTaskRef, WorldTaskRubricCriterion, WorldTaskRubricGrader, WorldTaskScalar, WorldTaskSeed, WorldTaskSpec, WorldTaskSummary, WorldTaskValidation, WorldTaskVersionSummary, WorldTaskWorld, WorldTaskWorldValidation, WorldToolSpec, WorldToolkit, WorldsClientOptions, aggregateTaskGrade, apiRequest, applyTransforms, archiveMode, attachManifest, attachSession, attachTask, buildFileManifest, buildSourceTarball, captureToolCalls, collectArchiveRelPaths, computeContentHash, computerUseToolkit, createRef, createTask, deleteEnvSecret, deleteTask, describeWorld, detectProvenance, extractBundle, getRun, getTask, hashForm, ingest, ingestToolCalls, isTaskIdRef, isTaskManifest, isTaskSpec, listEnvSecretKeys, listRunConfigs, listTaskSessions, listTasks, localTreeState, migrateProjectWorlds, migrateWorld, modelToolName, openBrowser, openSession, openTask, openWorld, openWorldVersion, parseSlugRef, parseToolCallRecord, parseTransform, parseWorldTaskRefs, preserveForm, propose, pull, push, pushSlug, pyText, queryRows, queryRowsSearch, readLocalMeta, readToolCallRecords, redactActionArgs, redactionOf, resolveBrowserMode, resolvePushSlug, roundForm, runSessions, runTask, schemaFromSignature, sessionToolObservations, setEnvSecret, shapeText, snapshotTreeHashes, storedForms, surfaceKinds, taskLabel, toolCallRecordsIn, toolCallsFromObservations, uiEntryUrl, uiUrl, updateTask, upsertRunConfig, validateTask, validateWorld, waitForRun, withoutUiToken, writeLocalMeta } from './worlds/index.js';
11
- export { i as files } from './index-CLkMr6VG.js';
10
+ export { ApiError, BROWSER_GONE_PATTERNS, BROWSER_TIERS, BrowserActionEvent, BrowserActionRecorder, BrowserConnection, BrowserMode, BrowserPage, BrowserReconnected, BrowserReconnector, BrowserTier, BrowserUnrecoverable, CALL_BODY_LIMIT_BYTES, CALL_BODY_LIMIT_LABEL, COMPUTER_USE_SPECS, Checkout, CheckoutProvenance, CreateEvaluationOptions, DEFAULT_BRANCH, DEFAULT_VIEWPORT, DRY_RUN_AGENT, DRY_RUN_KIND, DetachedPushError, DispatchedRun, DryRunImageDecision, DryRunOutcome, DryRunSettlement, EVENT_BATCH_SIZE, EVENT_FLUSH_INTERVAL_MS, EVENT_MAX_RETRIES, EXPLORATORY_TASK, EXPLORATORY_TASK_SOURCE, EditSessionCloseInput, EditSessionList, EditSessionListQuery, EditSessionResult, EditSessionRollbackInput, EditSessionSummary, EvalSample, FinalizeEvaluationOptions, GatewayEvalsClient, GradeResult, HostedDryRunClient, HostedDryRunDispatch, HostedDryRunStatus, HostedDryRunVerdict, IDLE_WARNING_MINUTES, IngestExplode, IngestFieldSpec, IngestMapping, IngestMode, IngestOptions, IngestRefusal, IngestReport, IngestSource, IngestSourceReport, IngestToolCallsOptions, IngestToolCallsReport, ListRunsFilter, ListSessionsFilter, LiveTaskSession, LocalMeta, MigrateWorldOptions, NO_GRADER_REASON, ObservationConversion, ObservationLike, OpenSessionOptions, OpenTaskOptions, PLATFORM_TIMEOUT_DEFAULT_MS, PLATFORM_TIMEOUT_ENV, ParsedToolCall, Plaintext, PlatformEndpoint, PlatformMethod, PlatformReply, PlatformTransport, PlaywrightBrowserLike, PlaywrightLike, PushSlugConflict, PushSlugResolution, RECOVER_BUDGET_MS, RebaseConflictPath, RecoveryResult, RedactMode, RedactPolicy, Redaction, RepairAnswer, ResolvedWorldVersion, RunConfigInput, RunConfigSummary, RunProvenance, RunReport, RunSetOptions, RunSetResult, RunSummary, RunTaskOptions, RunTaskSummary, SANDBOX_REQUEST_TIMEOUT_MS, SESSION_STATES, STATUS_WAIT_CAP_SECONDS, STRIP_PREFIX, SURFACE_KINDS, SandboxChanges, SandboxCheckResult, SandboxCommitInput, SandboxCommitResult, SandboxExecResult, SandboxImportInput, SandboxImportPending, SandboxImportResult, SandboxListFilter, SandboxOpenExisting, SandboxOpenNew, SandboxOpenTarget, SandboxOpened, SandboxSummary, SecretScrubber, SeedResult, SessionRunReport, SessionRunResult, SessionSurfaces, SetRunDoc, SettleOptions, SlugDeclaration, TRANSFORMS, TaskExport, TaskGrade, TaskManifest, TaskManifestSession, TaskRun, TaskRunResult, TaskSessions, TaskSessionsResponse, TaskWorldSessionState, ToolCallRecord, ToolCallSink, ToolFunctions, Transform, TransportCause, UnreachableError, VERIFIER_REWARD_PREFIX, ValidateReport, ValidatedRun, VerifierGrade, WHITESPACE, WorldBrowser, WorldCallTooLarge, WorldDependency, WorldDeprecation, WorldDescription, WorldEditClient, WorldEntity, WorldEntityMapping, WorldField, WorldMigrationRefusal, WorldMigrationReport, WorldQueryAcrossOptions, WorldQueryAcrossResult, WorldQueryCompare, WorldQueryCompareStatus, WorldQueryGroup, WorldQueryOptions, WorldQueryResult, WorldQuerySnapshot, WorldQueryWhere, WorldRelationship, WorldSandboxClient, WorldSession, WorldSessionCall, WorldSessionCallError, WorldSessionListItem, WorldSessionState, WorldSessionTask, WorldSessionTimeout, WorldSet, WorldSurfaceKind, WorldSurfaceUnavailable, WorldTask, WorldTaskCheck, WorldTaskDetail, WorldTaskFieldOp, WorldTaskGrader, WorldTaskIdRef, WorldTaskInfo, WorldTaskPage, WorldTaskRef, WorldTaskRubricCriterion, WorldTaskRubricGrader, WorldTaskScalar, WorldTaskSeed, WorldTaskSpec, WorldTaskSummary, WorldTaskValidation, WorldTaskVerifier, WorldTaskVerifierRow, WorldTaskVersionSummary, WorldTaskWorld, WorldTaskWorldValidation, WorldToolSpec, WorldToolkit, WorldsClientOptions, aggregateTaskGrade, apiRequest, applyTransforms, archiveMode, assertBrowserTier, assertTaskRef, attachManifest, attachSession, attachTask, buildFileManifest, buildSourceTarball, captureToolCalls, checkoutIdentity, closeConnection, collectArchiveRelPaths, computeContentHash, computerUseToolkit, createRef, createTask, deleteEnvSecret, deleteTask, describeWorld, detectProvenance, extractBundle, getRun, getTask, hashForm, idleWarning, ingest, ingestToolCalls, isBrowserGone, isSandboxImportPending, isTaskIdRef, isTaskManifest, isTaskSpec, listEnvSecretKeys, listRunConfigs, listRuns, listSessions, listTaskSessions, listTasks, localTreeState, migrateProjectWorlds, migrateWorld, modelToolName, openBrowser, openSession, openTask, openWorld, openWorldVersion, parseErrorBody, parseSlugRef, parseToolCallRecord, parseTransform, parseWorldTaskRefs, platformTimeoutMs, preserveForm, propose, pull, push, pushBranch, pushSlug, pyText, queryRows, queryRowsSearch, readLocalMeta, readToolCallRecords, rebaseConflicts, redactActionArgs, redactionOf, releaseConnection, resolveBrowserMode, resolvePushSlug, roundForm, runSessions, runSet, runTask, schemaFromSignature, serializeCallBody, sessionToolObservations, setEnvSecret, shapeText, snapshotTreeHashes, storedForms, surfaceKinds, taskLabel, toolCallRecordsIn, toolCallsFromObservations, uiEntryUrl, uiUrl, uncommittedPaths, updateTask, upsertRunConfig, validateTask, validateWorld, waitForRun, withoutUiToken, writeLocalMeta } from './worlds/index.js';
11
+ export { i as files } from './index-D-_4Ibcn.js';
12
12
  export { i as traces } from './index-BgvvQ3BC.js';
13
- export { i as hooks } from './index-BaKu5ZSU.js';
13
+ export { i as hooks } from './index-C3UzD0G3.js';
14
14
  import { _ as _tracingModule } from './index-BO2SNSgy.js';
15
15
  export { I as IdentifyOptions, i as identify, r as resolveUserId } from './index-BO2SNSgy.js';
16
16
  import 'async_hooks';