@tangle-network/agent-interface 4.0.0 → 5.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -309,7 +309,9 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
309
309
  operationId: z.ZodString;
310
310
  requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
311
311
  plan: z.ZodObject<{
312
+ kind: z.ZodLiteral<"portable-context-transfer-plan">;
312
313
  planId: z.ZodString;
314
+ reviewDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
313
315
  source: z.ZodObject<{
314
316
  source: z.ZodObject<{
315
317
  runId: z.ZodString;
@@ -321,29 +323,21 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
321
323
  requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
322
324
  branchId: z.ZodOptional<z.ZodString>;
323
325
  }, z.core.$strict>;
326
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
324
327
  completeness: z.ZodEnum<{
325
328
  complete: "complete";
326
329
  partial: "partial";
327
330
  }>;
328
331
  messages: z.ZodArray<z.ZodObject<{
329
- id: z.ZodString;
330
- role: z.ZodEnum<{
331
- assistant: "assistant";
332
- system: "system";
333
- user: "user";
334
- }>;
335
- parts: z.ZodArray<z.ZodCustom<unknown, unknown>>;
336
- timestamp: z.ZodISODateTime;
337
- metadata: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
332
+ messageId: z.ZodString;
333
+ metadataDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
334
+ parts: z.ZodArray<z.ZodNullable<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>>;
338
335
  }, z.core.$strict>>;
339
336
  attachments: z.ZodArray<z.ZodObject<{
340
337
  messageId: z.ZodString;
341
338
  partIndex: z.ZodNumber;
342
339
  digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
343
- name: z.ZodOptional<z.ZodString>;
344
- mediaType: z.ZodOptional<z.ZodString>;
345
340
  }, z.core.$strict>>;
346
- digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
347
341
  }, z.core.$strict>;
348
342
  destination: z.ZodObject<{
349
343
  runner: z.ZodString;
@@ -354,6 +348,7 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
354
348
  executionId: z.ZodString;
355
349
  model: z.ZodOptional<z.ZodString>;
356
350
  profileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
351
+ workspaceSnapshotDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
357
352
  }, z.core.$strict>;
358
353
  messages: z.ZodArray<z.ZodObject<{
359
354
  messageId: z.ZodString;
@@ -368,26 +363,8 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
368
363
  omit: "omit";
369
364
  transform: "transform";
370
365
  }>;
371
- output: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
372
- type: z.ZodLiteral<"text">;
373
- text: z.ZodString;
374
- }, z.core.$strict>, z.ZodObject<{
375
- type: z.ZodLiteral<"file">;
376
- filename: z.ZodOptional<z.ZodString>;
377
- mediaType: z.ZodOptional<z.ZodString>;
378
- url: z.ZodOptional<z.ZodString>;
379
- path: z.ZodOptional<z.ZodString>;
380
- content: z.ZodOptional<z.ZodString>;
381
- }, z.core.$strict>, z.ZodObject<{
382
- type: z.ZodLiteral<"image">;
383
- filename: z.ZodOptional<z.ZodString>;
384
- mediaType: z.ZodOptional<z.ZodString>;
385
- url: z.ZodOptional<z.ZodString>;
386
- path: z.ZodOptional<z.ZodString>;
387
- }, z.core.$strict>], "type">>;
388
- reason: z.ZodOptional<z.ZodString>;
366
+ outputDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
389
367
  }, z.core.$strict>>;
390
- reason: z.ZodOptional<z.ZodString>;
391
368
  }, z.core.$strict>>;
392
369
  context: z.ZodObject<{
393
370
  source: z.ZodObject<{
@@ -690,6 +667,62 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
690
667
  createdAt: z.ZodISODateTime;
691
668
  metadata: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
692
669
  }, z.core.$strict>>;
670
+ snapshot: z.ZodOptional<z.ZodObject<{
671
+ kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
672
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
673
+ manifest: z.ZodObject<{
674
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
675
+ kind: z.ZodLiteral<"s3">;
676
+ bucket: z.ZodString;
677
+ key: z.ZodString;
678
+ region: z.ZodOptional<z.ZodString>;
679
+ }, z.core.$strict>, z.ZodObject<{
680
+ kind: z.ZodLiteral<"ipfs">;
681
+ cid: z.ZodString;
682
+ path: z.ZodOptional<z.ZodString>;
683
+ }, z.core.$strict>, z.ZodObject<{
684
+ kind: z.ZodLiteral<"private-cas">;
685
+ namespace: z.ZodString;
686
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
687
+ }, z.core.$strict>], "kind">;
688
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
689
+ byteLength: z.ZodNumber;
690
+ }, z.core.$strict>;
691
+ archive: z.ZodObject<{
692
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
693
+ kind: z.ZodLiteral<"s3">;
694
+ bucket: z.ZodString;
695
+ key: z.ZodString;
696
+ region: z.ZodOptional<z.ZodString>;
697
+ }, z.core.$strict>, z.ZodObject<{
698
+ kind: z.ZodLiteral<"ipfs">;
699
+ cid: z.ZodString;
700
+ path: z.ZodOptional<z.ZodString>;
701
+ }, z.core.$strict>, z.ZodObject<{
702
+ kind: z.ZodLiteral<"private-cas">;
703
+ namespace: z.ZodString;
704
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
705
+ }, z.core.$strict>], "kind">;
706
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
707
+ byteLength: z.ZodNumber;
708
+ }, z.core.$strict>;
709
+ source: z.ZodObject<{
710
+ leaseId: z.ZodString;
711
+ leaseRecordDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
712
+ workspace: z.ZodObject<{
713
+ provider: z.ZodString;
714
+ root: z.ZodString;
715
+ identityDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
716
+ }, z.core.$strict>;
717
+ sourceSnapshotDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
718
+ sourceSnapshotPolicy: z.ZodObject<{
719
+ kind: z.ZodLiteral<"provider-declared">;
720
+ name: z.ZodString;
721
+ version: z.ZodNumber;
722
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
723
+ }, z.core.$strict>;
724
+ }, z.core.$strict>;
725
+ }, z.core.$strict>>;
693
726
  providerOptions: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
694
727
  }, z.core.$strict>>;
695
728
  resources: z.ZodOptional<z.ZodObject<{
@@ -820,6 +853,7 @@ export declare const AgentTurnResultSchema: z.ZodObject<{
820
853
  executionId: z.ZodString;
821
854
  model: z.ZodOptional<z.ZodString>;
822
855
  profileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
856
+ workspaceSnapshotDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
823
857
  }, z.core.$strict>;
824
858
  provider: z.ZodString;
825
859
  environmentId: z.ZodString;
@@ -856,6 +890,7 @@ export declare const AgentTurnResultSchema: z.ZodObject<{
856
890
  executionId: z.ZodString;
857
891
  model: z.ZodOptional<z.ZodString>;
858
892
  profileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
893
+ workspaceSnapshotDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
859
894
  }, z.core.$strict>;
860
895
  provider: z.ZodString;
861
896
  environmentId: z.ZodString;
@@ -976,6 +1011,7 @@ export declare const AgentNativeContextContinuationResultSchema: z.ZodUnion<read
976
1011
  executionId: z.ZodString;
977
1012
  model: z.ZodOptional<z.ZodString>;
978
1013
  profileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1014
+ workspaceSnapshotDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
979
1015
  }, z.core.$strict>;
980
1016
  provider: z.ZodString;
981
1017
  environmentId: z.ZodString;
@@ -1012,6 +1048,7 @@ export declare const AgentNativeContextContinuationResultSchema: z.ZodUnion<read
1012
1048
  executionId: z.ZodString;
1013
1049
  model: z.ZodOptional<z.ZodString>;
1014
1050
  profileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1051
+ workspaceSnapshotDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
1015
1052
  }, z.core.$strict>;
1016
1053
  provider: z.ZodString;
1017
1054
  environmentId: z.ZodString;
@@ -1217,6 +1254,8 @@ export interface AgentEnvironment {
1217
1254
  * provider cannot prove which outcome happened.
1218
1255
  */
1219
1256
  readonly creation?: AgentEnvironmentCreation;
1257
+ /** Authoritative receipt returned only by a qualified context-transfer attachment. */
1258
+ readonly contextTransferReceipt?: ContextTransferReceipt;
1220
1259
  /**
1221
1260
  * Detached metadata returned by the provider.
1222
1261
  * It can contain caller-authored annotations and is not authorization evidence.
@@ -1324,6 +1363,8 @@ export interface AgentEnvironmentCapabilities {
1324
1363
  freshSession: boolean;
1325
1364
  requestIdempotency: boolean;
1326
1365
  lookup: boolean;
1366
+ /** get(id, { contextTransfer }) verifies the durable receipt and enables only its first turn. */
1367
+ attach?: boolean;
1327
1368
  };
1328
1369
  /** Absent when the provider cannot originate or answer interactions. */
1329
1370
  interactions?: InteractionCapabilities;
@@ -1390,6 +1431,8 @@ export interface AgentEnvironmentCapabilities {
1390
1431
  * including a checkpoint whose source environment is gone. Absent means create refuses one.
1391
1432
  */
1392
1433
  workspaceCheckpoint?: boolean;
1434
+ /** True only when this qualified receiver verifies and restores WorkspaceRequest.snapshot. */
1435
+ workspaceSnapshot?: boolean;
1393
1436
  };
1394
1437
  /** Per-surface flags for the normalized environment observation. */
1395
1438
  observation?: {
@@ -1477,6 +1520,7 @@ export declare const AgentEnvironmentCapabilitiesSchema: z.ZodObject<{
1477
1520
  freshSession: z.ZodBoolean;
1478
1521
  requestIdempotency: z.ZodBoolean;
1479
1522
  lookup: z.ZodBoolean;
1523
+ attach: z.ZodOptional<z.ZodBoolean>;
1480
1524
  }, z.core.$strict>>;
1481
1525
  interactions: z.ZodOptional<z.ZodObject<{
1482
1526
  kinds: z.ZodArray<z.ZodString>;
@@ -1538,6 +1582,7 @@ export declare const AgentEnvironmentCapabilitiesSchema: z.ZodObject<{
1538
1582
  mcp: z.ZodLiteral<true>;
1539
1583
  }, z.core.$strict>>;
1540
1584
  workspaceCheckpoint: z.ZodOptional<z.ZodBoolean>;
1585
+ workspaceSnapshot: z.ZodOptional<z.ZodBoolean>;
1541
1586
  }, z.core.$strict>>;
1542
1587
  observation: z.ZodOptional<z.ZodObject<{
1543
1588
  identity: z.ZodBoolean;
@@ -1656,6 +1701,448 @@ export interface AgentEnvironmentCreateIdempotencyRecord<T> {
1656
1701
  * @internal
1657
1702
  */
1658
1703
  export declare function createAgentEnvironmentWithIdempotency<T extends object>(records: Map<string, AgentEnvironmentCreateIdempotencyRecord<T>>, input: CreateAgentEnvironmentInput, create: (input: CreateAgentEnvironmentInput) => Promise<T>): Promise<T>;
1704
+ /** Reconstruct an existing environment; never allocates a replacement. */
1705
+ export interface AgentEnvironmentGetOptions {
1706
+ signal?: AbortSignal;
1707
+ /**
1708
+ * Authorize the first turn of an accepted portable transfer. The provider looks up the exact
1709
+ * durable operation and returns its dispatch-capable environment with contextTransferReceipt.
1710
+ * A missing, uncertain, conflicting or unsupported receipt refuses attachment. The request's
1711
+ * exact profile, workspace and resources remain authoritative; ordinary get remains read-only.
1712
+ */
1713
+ contextTransfer?: ContextTransferRequest;
1714
+ }
1715
+ export declare const AgentEnvironmentGetOptionsSchema: z.ZodObject<{
1716
+ signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
1717
+ contextTransfer: z.ZodOptional<z.ZodObject<{
1718
+ operationId: z.ZodString;
1719
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1720
+ plan: z.ZodObject<{
1721
+ kind: z.ZodLiteral<"portable-context-transfer-plan">;
1722
+ planId: z.ZodString;
1723
+ reviewDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1724
+ source: z.ZodObject<{
1725
+ source: z.ZodObject<{
1726
+ runId: z.ZodString;
1727
+ messageId: z.ZodString;
1728
+ provider: z.ZodString;
1729
+ environmentId: z.ZodString;
1730
+ sessionId: z.ZodString;
1731
+ executionId: z.ZodString;
1732
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1733
+ branchId: z.ZodOptional<z.ZodString>;
1734
+ }, z.core.$strict>;
1735
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1736
+ completeness: z.ZodEnum<{
1737
+ complete: "complete";
1738
+ partial: "partial";
1739
+ }>;
1740
+ messages: z.ZodArray<z.ZodObject<{
1741
+ messageId: z.ZodString;
1742
+ metadataDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
1743
+ parts: z.ZodArray<z.ZodNullable<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>>;
1744
+ }, z.core.$strict>>;
1745
+ attachments: z.ZodArray<z.ZodObject<{
1746
+ messageId: z.ZodString;
1747
+ partIndex: z.ZodNumber;
1748
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1749
+ }, z.core.$strict>>;
1750
+ }, z.core.$strict>;
1751
+ destination: z.ZodObject<{
1752
+ runner: z.ZodString;
1753
+ provider: z.ZodString;
1754
+ environmentId: z.ZodOptional<z.ZodString>;
1755
+ sessionId: z.ZodString;
1756
+ runId: z.ZodString;
1757
+ executionId: z.ZodString;
1758
+ model: z.ZodOptional<z.ZodString>;
1759
+ profileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1760
+ workspaceSnapshotDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
1761
+ }, z.core.$strict>;
1762
+ messages: z.ZodArray<z.ZodObject<{
1763
+ messageId: z.ZodString;
1764
+ action: z.ZodEnum<{
1765
+ include: "include";
1766
+ omit: "omit";
1767
+ }>;
1768
+ parts: z.ZodArray<z.ZodObject<{
1769
+ partIndex: z.ZodNumber;
1770
+ action: z.ZodEnum<{
1771
+ include: "include";
1772
+ omit: "omit";
1773
+ transform: "transform";
1774
+ }>;
1775
+ outputDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
1776
+ }, z.core.$strict>>;
1777
+ }, z.core.$strict>>;
1778
+ context: z.ZodObject<{
1779
+ source: z.ZodObject<{
1780
+ runId: z.ZodString;
1781
+ messageId: z.ZodString;
1782
+ provider: z.ZodString;
1783
+ environmentId: z.ZodString;
1784
+ sessionId: z.ZodString;
1785
+ executionId: z.ZodString;
1786
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1787
+ branchId: z.ZodOptional<z.ZodString>;
1788
+ }, z.core.$strict>;
1789
+ completeness: z.ZodEnum<{
1790
+ complete: "complete";
1791
+ partial: "partial";
1792
+ }>;
1793
+ messages: z.ZodArray<z.ZodObject<{
1794
+ id: z.ZodString;
1795
+ role: z.ZodEnum<{
1796
+ assistant: "assistant";
1797
+ system: "system";
1798
+ user: "user";
1799
+ }>;
1800
+ parts: z.ZodArray<z.ZodCustom<unknown, unknown>>;
1801
+ timestamp: z.ZodISODateTime;
1802
+ metadata: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
1803
+ }, z.core.$strict>>;
1804
+ attachments: z.ZodArray<z.ZodObject<{
1805
+ messageId: z.ZodString;
1806
+ partIndex: z.ZodNumber;
1807
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1808
+ name: z.ZodOptional<z.ZodString>;
1809
+ mediaType: z.ZodOptional<z.ZodString>;
1810
+ }, z.core.$strict>>;
1811
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1812
+ }, z.core.$strict>;
1813
+ estimatedTokens: z.ZodOptional<z.ZodNumber>;
1814
+ requiresAcceptance: z.ZodBoolean;
1815
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1816
+ }, z.core.$strict>;
1817
+ acceptance: z.ZodObject<{
1818
+ planDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1819
+ acceptedAt: z.ZodISODateTime;
1820
+ acceptedBy: z.ZodEnum<{
1821
+ policy: "policy";
1822
+ system: "system";
1823
+ user: "user";
1824
+ }>;
1825
+ }, z.core.$strict>;
1826
+ profile: z.ZodOptional<z.ZodObject<{
1827
+ name: z.ZodOptional<z.ZodString>;
1828
+ description: z.ZodOptional<z.ZodString>;
1829
+ version: z.ZodOptional<z.ZodString>;
1830
+ tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
1831
+ prompt: z.ZodOptional<z.ZodObject<{
1832
+ systemPrompt: z.ZodOptional<z.ZodString>;
1833
+ appendSystemPrompt: z.ZodOptional<z.ZodString>;
1834
+ instructions: z.ZodOptional<z.ZodArray<z.ZodString>>;
1835
+ }, z.core.$strict>>;
1836
+ model: z.ZodOptional<z.ZodObject<{
1837
+ default: z.ZodOptional<z.ZodString>;
1838
+ small: z.ZodOptional<z.ZodString>;
1839
+ provider: z.ZodOptional<z.ZodString>;
1840
+ reasoningEffort: z.ZodOptional<z.ZodEnum<{
1841
+ high: "high";
1842
+ low: "low";
1843
+ medium: "medium";
1844
+ minimal: "minimal";
1845
+ none: "none";
1846
+ ultracode: "ultracode";
1847
+ xhigh: "xhigh";
1848
+ }>>;
1849
+ maxVisibleOutputTokens: z.ZodOptional<z.ZodNumber>;
1850
+ maxReasoningTokens: z.ZodOptional<z.ZodNumber>;
1851
+ maxTotalOutputTokens: z.ZodOptional<z.ZodNumber>;
1852
+ metadata: z.ZodOptional<z.ZodType<Record<string, unknown>, unknown, z.core.$ZodTypeInternals<Record<string, unknown>, unknown>>>;
1853
+ }, z.core.$strict>>;
1854
+ harness: z.ZodOptional<z.ZodEnum<{
1855
+ acp: "acp";
1856
+ amp: "amp";
1857
+ "claude-code": "claude-code";
1858
+ "cli-base": "cli-base";
1859
+ codex: "codex";
1860
+ cursor: "cursor";
1861
+ "factory-droids": "factory-droids";
1862
+ forge: "forge";
1863
+ gemini: "gemini";
1864
+ hermes: "hermes";
1865
+ "kimi-code": "kimi-code";
1866
+ nanoclaw: "nanoclaw";
1867
+ openclaw: "openclaw";
1868
+ opencode: "opencode";
1869
+ pi: "pi";
1870
+ prime: "prime";
1871
+ }>>;
1872
+ seats: z.ZodOptional<z.ZodArray<z.ZodObject<{
1873
+ harness: z.ZodEnum<{
1874
+ acp: "acp";
1875
+ amp: "amp";
1876
+ "claude-code": "claude-code";
1877
+ "cli-base": "cli-base";
1878
+ codex: "codex";
1879
+ cursor: "cursor";
1880
+ "factory-droids": "factory-droids";
1881
+ forge: "forge";
1882
+ gemini: "gemini";
1883
+ hermes: "hermes";
1884
+ "kimi-code": "kimi-code";
1885
+ nanoclaw: "nanoclaw";
1886
+ openclaw: "openclaw";
1887
+ opencode: "opencode";
1888
+ pi: "pi";
1889
+ prime: "prime";
1890
+ }>;
1891
+ provider: z.ZodString;
1892
+ model: z.ZodString;
1893
+ selector: z.ZodUnion<readonly [z.ZodObject<{
1894
+ kind: z.ZodLiteral<"all-eligible">;
1895
+ }, z.core.$strict>, z.ZodObject<{
1896
+ kind: z.ZodLiteral<"seat">;
1897
+ id: z.ZodString;
1898
+ }, z.core.$strict>]>;
1899
+ tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
1900
+ permissions: z.ZodOptional<z.ZodType<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown, z.core.$ZodTypeInternals<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown>>>;
1901
+ }, z.core.$strict>>>;
1902
+ permissions: z.ZodOptional<z.ZodType<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown, z.core.$ZodTypeInternals<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown>>>;
1903
+ tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
1904
+ mcp: z.ZodOptional<z.ZodType<Record<string, import("./agent-profile.js").AgentProfileMcpServer>, unknown, z.core.$ZodTypeInternals<Record<string, import("./agent-profile.js").AgentProfileMcpServer>, unknown>>>;
1905
+ connections: z.ZodOptional<z.ZodArray<z.ZodObject<{
1906
+ connectionId: z.ZodString;
1907
+ capabilities: z.ZodArray<z.ZodString>;
1908
+ alias: z.ZodOptional<z.ZodString>;
1909
+ }, z.core.$strict>>>;
1910
+ subagents: z.ZodOptional<z.ZodType<Record<string, {
1911
+ description?: string | undefined;
1912
+ prompt?: string | undefined;
1913
+ model?: string | undefined;
1914
+ tools?: Record<string, boolean> | undefined;
1915
+ permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
1916
+ maxSteps?: number | undefined;
1917
+ metadata?: Record<string, unknown> | undefined;
1918
+ }>, unknown, z.core.$ZodTypeInternals<Record<string, {
1919
+ description?: string | undefined;
1920
+ prompt?: string | undefined;
1921
+ model?: string | undefined;
1922
+ tools?: Record<string, boolean> | undefined;
1923
+ permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
1924
+ maxSteps?: number | undefined;
1925
+ metadata?: Record<string, unknown> | undefined;
1926
+ }>, unknown>>>;
1927
+ resources: z.ZodOptional<z.ZodObject<{
1928
+ files: z.ZodOptional<z.ZodArray<z.ZodObject<{
1929
+ path: z.ZodString;
1930
+ resource: z.ZodUnion<readonly [z.ZodObject<{
1931
+ kind: z.ZodLiteral<"inline">;
1932
+ name: z.ZodString;
1933
+ content: z.ZodString;
1934
+ }, z.core.$strict>, z.ZodObject<{
1935
+ kind: z.ZodLiteral<"github">;
1936
+ repository: z.ZodOptional<z.ZodString>;
1937
+ path: z.ZodString;
1938
+ ref: z.ZodOptional<z.ZodString>;
1939
+ name: z.ZodOptional<z.ZodString>;
1940
+ }, z.core.$strict>]>;
1941
+ executable: z.ZodOptional<z.ZodBoolean>;
1942
+ }, z.core.$strict>>>;
1943
+ tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
1944
+ kind: z.ZodLiteral<"inline">;
1945
+ name: z.ZodString;
1946
+ content: z.ZodString;
1947
+ }, z.core.$strict>, z.ZodObject<{
1948
+ kind: z.ZodLiteral<"github">;
1949
+ repository: z.ZodOptional<z.ZodString>;
1950
+ path: z.ZodString;
1951
+ ref: z.ZodOptional<z.ZodString>;
1952
+ name: z.ZodOptional<z.ZodString>;
1953
+ }, z.core.$strict>]>>>;
1954
+ skills: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
1955
+ kind: z.ZodLiteral<"inline">;
1956
+ name: z.ZodString;
1957
+ content: z.ZodString;
1958
+ }, z.core.$strict>, z.ZodObject<{
1959
+ kind: z.ZodLiteral<"github">;
1960
+ repository: z.ZodOptional<z.ZodString>;
1961
+ path: z.ZodString;
1962
+ ref: z.ZodOptional<z.ZodString>;
1963
+ name: z.ZodOptional<z.ZodString>;
1964
+ }, z.core.$strict>]>>>;
1965
+ agents: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
1966
+ kind: z.ZodLiteral<"inline">;
1967
+ name: z.ZodString;
1968
+ content: z.ZodString;
1969
+ }, z.core.$strict>, z.ZodObject<{
1970
+ kind: z.ZodLiteral<"github">;
1971
+ repository: z.ZodOptional<z.ZodString>;
1972
+ path: z.ZodString;
1973
+ ref: z.ZodOptional<z.ZodString>;
1974
+ name: z.ZodOptional<z.ZodString>;
1975
+ }, z.core.$strict>]>>>;
1976
+ commands: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
1977
+ kind: z.ZodLiteral<"inline">;
1978
+ name: z.ZodString;
1979
+ content: z.ZodString;
1980
+ }, z.core.$strict>, z.ZodObject<{
1981
+ kind: z.ZodLiteral<"github">;
1982
+ repository: z.ZodOptional<z.ZodString>;
1983
+ path: z.ZodString;
1984
+ ref: z.ZodOptional<z.ZodString>;
1985
+ name: z.ZodOptional<z.ZodString>;
1986
+ }, z.core.$strict>]>>>;
1987
+ instructions: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
1988
+ kind: z.ZodLiteral<"inline">;
1989
+ name: z.ZodString;
1990
+ content: z.ZodString;
1991
+ }, z.core.$strict>, z.ZodObject<{
1992
+ kind: z.ZodLiteral<"github">;
1993
+ repository: z.ZodOptional<z.ZodString>;
1994
+ path: z.ZodString;
1995
+ ref: z.ZodOptional<z.ZodString>;
1996
+ name: z.ZodOptional<z.ZodString>;
1997
+ }, z.core.$strict>]>]>>;
1998
+ failOnError: z.ZodOptional<z.ZodBoolean>;
1999
+ }, z.core.$strict>>;
2000
+ hooks: z.ZodOptional<z.ZodType<Record<string, {
2001
+ command: string;
2002
+ timeoutMs?: number | undefined;
2003
+ blocking?: boolean | undefined;
2004
+ matcher?: string | undefined;
2005
+ env?: Record<string, {
2006
+ kind: "public";
2007
+ value: string;
2008
+ } | {
2009
+ kind: "secret-ref";
2010
+ key: string;
2011
+ format?: "bearer" | "raw" | undefined;
2012
+ }> | undefined;
2013
+ }[]>, unknown, z.core.$ZodTypeInternals<Record<string, {
2014
+ command: string;
2015
+ timeoutMs?: number | undefined;
2016
+ blocking?: boolean | undefined;
2017
+ matcher?: string | undefined;
2018
+ env?: Record<string, {
2019
+ kind: "public";
2020
+ value: string;
2021
+ } | {
2022
+ kind: "secret-ref";
2023
+ key: string;
2024
+ format?: "bearer" | "raw" | undefined;
2025
+ }> | undefined;
2026
+ }[]>, unknown>>>;
2027
+ modes: z.ZodOptional<z.ZodType<Record<string, {
2028
+ description?: string | undefined;
2029
+ model?: string | undefined;
2030
+ prompt?: string | undefined;
2031
+ tools?: Record<string, boolean> | undefined;
2032
+ permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
2033
+ metadata?: Record<string, unknown> | undefined;
2034
+ }>, unknown, z.core.$ZodTypeInternals<Record<string, {
2035
+ description?: string | undefined;
2036
+ model?: string | undefined;
2037
+ prompt?: string | undefined;
2038
+ tools?: Record<string, boolean> | undefined;
2039
+ permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
2040
+ metadata?: Record<string, unknown> | undefined;
2041
+ }>, unknown>>>;
2042
+ confidential: z.ZodOptional<z.ZodObject<{
2043
+ tee: z.ZodOptional<z.ZodString>;
2044
+ attestationNonce: z.ZodOptional<z.ZodString>;
2045
+ sealed: z.ZodOptional<z.ZodBoolean>;
2046
+ attestationRefresh: z.ZodOptional<z.ZodBoolean>;
2047
+ }, z.core.$strict>>;
2048
+ metadata: z.ZodOptional<z.ZodType<import("./agent-profile.js").AgentProfileMetadata, unknown, z.core.$ZodTypeInternals<import("./agent-profile.js").AgentProfileMetadata, unknown>>>;
2049
+ extensions: z.ZodOptional<z.ZodType<Record<string, Record<string, unknown> | undefined>, unknown, z.core.$ZodTypeInternals<Record<string, Record<string, unknown> | undefined>, unknown>>>;
2050
+ }, z.core.$strict>>;
2051
+ workspace: z.ZodOptional<z.ZodObject<{
2052
+ environment: z.ZodOptional<z.ZodString>;
2053
+ image: z.ZodOptional<z.ZodString>;
2054
+ repoUrl: z.ZodOptional<z.ZodString>;
2055
+ gitRef: z.ZodOptional<z.ZodString>;
2056
+ cwd: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
2057
+ base: z.ZodLiteral<"repository">;
2058
+ path: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
2059
+ }, z.core.$strict>, z.ZodObject<{
2060
+ base: z.ZodLiteral<"host">;
2061
+ path: z.ZodString;
2062
+ }, z.core.$strict>], "base">>;
2063
+ checkpoint: z.ZodOptional<z.ZodObject<{
2064
+ checkpointId: z.ZodString;
2065
+ provider: z.ZodString;
2066
+ source: z.ZodObject<{
2067
+ runId: z.ZodString;
2068
+ provider: z.ZodString;
2069
+ environmentId: z.ZodString;
2070
+ sessionId: z.ZodString;
2071
+ executionId: z.ZodString;
2072
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2073
+ }, z.core.$strict>;
2074
+ idempotencyKey: z.ZodString;
2075
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2076
+ createdAt: z.ZodISODateTime;
2077
+ metadata: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
2078
+ }, z.core.$strict>>;
2079
+ snapshot: z.ZodOptional<z.ZodObject<{
2080
+ kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
2081
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2082
+ manifest: z.ZodObject<{
2083
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
2084
+ kind: z.ZodLiteral<"s3">;
2085
+ bucket: z.ZodString;
2086
+ key: z.ZodString;
2087
+ region: z.ZodOptional<z.ZodString>;
2088
+ }, z.core.$strict>, z.ZodObject<{
2089
+ kind: z.ZodLiteral<"ipfs">;
2090
+ cid: z.ZodString;
2091
+ path: z.ZodOptional<z.ZodString>;
2092
+ }, z.core.$strict>, z.ZodObject<{
2093
+ kind: z.ZodLiteral<"private-cas">;
2094
+ namespace: z.ZodString;
2095
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2096
+ }, z.core.$strict>], "kind">;
2097
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2098
+ byteLength: z.ZodNumber;
2099
+ }, z.core.$strict>;
2100
+ archive: z.ZodObject<{
2101
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
2102
+ kind: z.ZodLiteral<"s3">;
2103
+ bucket: z.ZodString;
2104
+ key: z.ZodString;
2105
+ region: z.ZodOptional<z.ZodString>;
2106
+ }, z.core.$strict>, z.ZodObject<{
2107
+ kind: z.ZodLiteral<"ipfs">;
2108
+ cid: z.ZodString;
2109
+ path: z.ZodOptional<z.ZodString>;
2110
+ }, z.core.$strict>, z.ZodObject<{
2111
+ kind: z.ZodLiteral<"private-cas">;
2112
+ namespace: z.ZodString;
2113
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2114
+ }, z.core.$strict>], "kind">;
2115
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2116
+ byteLength: z.ZodNumber;
2117
+ }, z.core.$strict>;
2118
+ source: z.ZodObject<{
2119
+ leaseId: z.ZodString;
2120
+ leaseRecordDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2121
+ workspace: z.ZodObject<{
2122
+ provider: z.ZodString;
2123
+ root: z.ZodString;
2124
+ identityDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2125
+ }, z.core.$strict>;
2126
+ sourceSnapshotDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2127
+ sourceSnapshotPolicy: z.ZodObject<{
2128
+ kind: z.ZodLiteral<"provider-declared">;
2129
+ name: z.ZodString;
2130
+ version: z.ZodNumber;
2131
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2132
+ }, z.core.$strict>;
2133
+ }, z.core.$strict>;
2134
+ }, z.core.$strict>>;
2135
+ providerOptions: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
2136
+ }, z.core.$strict>>;
2137
+ resources: z.ZodOptional<z.ZodObject<{
2138
+ cpu: z.ZodOptional<z.ZodNumber>;
2139
+ memoryMb: z.ZodOptional<z.ZodNumber>;
2140
+ diskMb: z.ZodOptional<z.ZodNumber>;
2141
+ gpu: z.ZodOptional<z.ZodString>;
2142
+ providerOptions: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
2143
+ }, z.core.$strict>>;
2144
+ }, z.core.$strict>>;
2145
+ }, z.core.$strict>;
1659
2146
  export interface AgentEnvironmentProvider {
1660
2147
  readonly name: string;
1661
2148
  readonly exactProcess?: AgentExactProcessProvider;
@@ -1689,9 +2176,7 @@ export interface AgentEnvironmentProvider {
1689
2176
  * Without a key, each call may create a fresh environment.
1690
2177
  */
1691
2178
  create(input: CreateAgentEnvironmentInput): Promise<AgentEnvironment>;
1692
- get?(id: string, options?: {
1693
- signal?: AbortSignal;
1694
- }): Promise<AgentEnvironment | null>;
2179
+ get?(id: string, options?: AgentEnvironmentGetOptions): Promise<AgentEnvironment | null>;
1695
2180
  list?(query?: AgentEnvironmentQuery, options?: {
1696
2181
  signal?: AbortSignal;
1697
2182
  }): Promise<AgentEnvironmentSummary[]>;