@tangle-network/agent-interface 4.0.0 → 5.1.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.
@@ -1,7 +1,7 @@
1
1
  import { z } from "zod";
2
2
  import type { AgentRuntimeAttachments } from "./runtime-attachments.js";
3
3
  export { AgentRuntimeAttachmentsSchema, type AgentRuntimeAttachments } from "./runtime-attachments.js";
4
- import type { Sha256Digest } from "./agent-candidate.js";
4
+ import type { AgentCandidateArtifactPort, Sha256Digest } from "./agent-candidate.js";
5
5
  import type { AgentProfile, AgentProfileCapabilities, AgentProfileValidationResult } from "./agent-profile.js";
6
6
  import type { InputPart } from "./parts.js";
7
7
  import type { StreamEvent } from "./stream-events.js";
@@ -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.
@@ -1319,11 +1358,15 @@ export interface AgentEnvironmentCapabilities {
1319
1358
  /** The provider exposes the exact continued run before terminal output. */
1320
1359
  admissionControl?: boolean;
1321
1360
  };
1322
- /** Present only when fresh-session portable context transfer is durable. */
1361
+ /** Durable portable-context lookup and independently qualified fresh-session admission. */
1323
1362
  contextTransfer?: {
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;
1368
+ /** Restores accepted snapshot refs before native admission. Absent or false means unsupported. */
1369
+ workspaceSnapshot?: boolean;
1327
1370
  };
1328
1371
  /** Absent when the provider cannot originate or answer interactions. */
1329
1372
  interactions?: InteractionCapabilities;
@@ -1390,6 +1433,8 @@ export interface AgentEnvironmentCapabilities {
1390
1433
  * including a checkpoint whose source environment is gone. Absent means create refuses one.
1391
1434
  */
1392
1435
  workspaceCheckpoint?: boolean;
1436
+ /** True only when this qualified receiver verifies and restores WorkspaceRequest.snapshot. */
1437
+ workspaceSnapshot?: boolean;
1393
1438
  };
1394
1439
  /** Per-surface flags for the normalized environment observation. */
1395
1440
  observation?: {
@@ -1477,6 +1522,8 @@ export declare const AgentEnvironmentCapabilitiesSchema: z.ZodObject<{
1477
1522
  freshSession: z.ZodBoolean;
1478
1523
  requestIdempotency: z.ZodBoolean;
1479
1524
  lookup: z.ZodBoolean;
1525
+ attach: z.ZodOptional<z.ZodBoolean>;
1526
+ workspaceSnapshot: z.ZodOptional<z.ZodBoolean>;
1480
1527
  }, z.core.$strict>>;
1481
1528
  interactions: z.ZodOptional<z.ZodObject<{
1482
1529
  kinds: z.ZodArray<z.ZodString>;
@@ -1538,6 +1585,7 @@ export declare const AgentEnvironmentCapabilitiesSchema: z.ZodObject<{
1538
1585
  mcp: z.ZodLiteral<true>;
1539
1586
  }, z.core.$strict>>;
1540
1587
  workspaceCheckpoint: z.ZodOptional<z.ZodBoolean>;
1588
+ workspaceSnapshot: z.ZodOptional<z.ZodBoolean>;
1541
1589
  }, z.core.$strict>>;
1542
1590
  observation: z.ZodOptional<z.ZodObject<{
1543
1591
  identity: z.ZodBoolean;
@@ -1656,6 +1704,448 @@ export interface AgentEnvironmentCreateIdempotencyRecord<T> {
1656
1704
  * @internal
1657
1705
  */
1658
1706
  export declare function createAgentEnvironmentWithIdempotency<T extends object>(records: Map<string, AgentEnvironmentCreateIdempotencyRecord<T>>, input: CreateAgentEnvironmentInput, create: (input: CreateAgentEnvironmentInput) => Promise<T>): Promise<T>;
1707
+ /** Reconstruct an existing environment; never allocates a replacement. */
1708
+ export interface AgentEnvironmentGetOptions {
1709
+ signal?: AbortSignal;
1710
+ /**
1711
+ * Authorize the first turn of an accepted portable transfer. The provider looks up the exact
1712
+ * durable operation and returns its dispatch-capable environment with contextTransferReceipt.
1713
+ * A missing, uncertain, conflicting or unsupported receipt refuses attachment. The request's
1714
+ * exact profile, workspace and resources remain authoritative; ordinary get remains read-only.
1715
+ */
1716
+ contextTransfer?: ContextTransferRequest;
1717
+ }
1718
+ export declare const AgentEnvironmentGetOptionsSchema: z.ZodObject<{
1719
+ signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
1720
+ contextTransfer: z.ZodOptional<z.ZodObject<{
1721
+ operationId: z.ZodString;
1722
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1723
+ plan: z.ZodObject<{
1724
+ kind: z.ZodLiteral<"portable-context-transfer-plan">;
1725
+ planId: z.ZodString;
1726
+ reviewDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1727
+ source: z.ZodObject<{
1728
+ source: z.ZodObject<{
1729
+ runId: z.ZodString;
1730
+ messageId: z.ZodString;
1731
+ provider: z.ZodString;
1732
+ environmentId: z.ZodString;
1733
+ sessionId: z.ZodString;
1734
+ executionId: z.ZodString;
1735
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1736
+ branchId: z.ZodOptional<z.ZodString>;
1737
+ }, z.core.$strict>;
1738
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1739
+ completeness: z.ZodEnum<{
1740
+ complete: "complete";
1741
+ partial: "partial";
1742
+ }>;
1743
+ messages: z.ZodArray<z.ZodObject<{
1744
+ messageId: z.ZodString;
1745
+ metadataDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
1746
+ parts: z.ZodArray<z.ZodNullable<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>>;
1747
+ }, z.core.$strict>>;
1748
+ attachments: z.ZodArray<z.ZodObject<{
1749
+ messageId: z.ZodString;
1750
+ partIndex: z.ZodNumber;
1751
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1752
+ }, z.core.$strict>>;
1753
+ }, z.core.$strict>;
1754
+ destination: z.ZodObject<{
1755
+ runner: z.ZodString;
1756
+ provider: z.ZodString;
1757
+ environmentId: z.ZodOptional<z.ZodString>;
1758
+ sessionId: z.ZodString;
1759
+ runId: z.ZodString;
1760
+ executionId: z.ZodString;
1761
+ model: z.ZodOptional<z.ZodString>;
1762
+ profileDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1763
+ workspaceSnapshotDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
1764
+ }, z.core.$strict>;
1765
+ messages: z.ZodArray<z.ZodObject<{
1766
+ messageId: z.ZodString;
1767
+ action: z.ZodEnum<{
1768
+ include: "include";
1769
+ omit: "omit";
1770
+ }>;
1771
+ parts: z.ZodArray<z.ZodObject<{
1772
+ partIndex: z.ZodNumber;
1773
+ action: z.ZodEnum<{
1774
+ include: "include";
1775
+ omit: "omit";
1776
+ transform: "transform";
1777
+ }>;
1778
+ outputDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
1779
+ }, z.core.$strict>>;
1780
+ }, z.core.$strict>>;
1781
+ context: z.ZodObject<{
1782
+ source: z.ZodObject<{
1783
+ runId: z.ZodString;
1784
+ messageId: z.ZodString;
1785
+ provider: z.ZodString;
1786
+ environmentId: z.ZodString;
1787
+ sessionId: z.ZodString;
1788
+ executionId: z.ZodString;
1789
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1790
+ branchId: z.ZodOptional<z.ZodString>;
1791
+ }, z.core.$strict>;
1792
+ completeness: z.ZodEnum<{
1793
+ complete: "complete";
1794
+ partial: "partial";
1795
+ }>;
1796
+ messages: z.ZodArray<z.ZodObject<{
1797
+ id: z.ZodString;
1798
+ role: z.ZodEnum<{
1799
+ assistant: "assistant";
1800
+ system: "system";
1801
+ user: "user";
1802
+ }>;
1803
+ parts: z.ZodArray<z.ZodCustom<unknown, unknown>>;
1804
+ timestamp: z.ZodISODateTime;
1805
+ metadata: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
1806
+ }, z.core.$strict>>;
1807
+ attachments: z.ZodArray<z.ZodObject<{
1808
+ messageId: z.ZodString;
1809
+ partIndex: z.ZodNumber;
1810
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1811
+ name: z.ZodOptional<z.ZodString>;
1812
+ mediaType: z.ZodOptional<z.ZodString>;
1813
+ }, z.core.$strict>>;
1814
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1815
+ }, z.core.$strict>;
1816
+ estimatedTokens: z.ZodOptional<z.ZodNumber>;
1817
+ requiresAcceptance: z.ZodBoolean;
1818
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1819
+ }, z.core.$strict>;
1820
+ acceptance: z.ZodObject<{
1821
+ planDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1822
+ acceptedAt: z.ZodISODateTime;
1823
+ acceptedBy: z.ZodEnum<{
1824
+ policy: "policy";
1825
+ system: "system";
1826
+ user: "user";
1827
+ }>;
1828
+ }, z.core.$strict>;
1829
+ profile: z.ZodOptional<z.ZodObject<{
1830
+ name: z.ZodOptional<z.ZodString>;
1831
+ description: z.ZodOptional<z.ZodString>;
1832
+ version: z.ZodOptional<z.ZodString>;
1833
+ tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
1834
+ prompt: z.ZodOptional<z.ZodObject<{
1835
+ systemPrompt: z.ZodOptional<z.ZodString>;
1836
+ appendSystemPrompt: z.ZodOptional<z.ZodString>;
1837
+ instructions: z.ZodOptional<z.ZodArray<z.ZodString>>;
1838
+ }, z.core.$strict>>;
1839
+ model: z.ZodOptional<z.ZodObject<{
1840
+ default: z.ZodOptional<z.ZodString>;
1841
+ small: z.ZodOptional<z.ZodString>;
1842
+ provider: z.ZodOptional<z.ZodString>;
1843
+ reasoningEffort: z.ZodOptional<z.ZodEnum<{
1844
+ high: "high";
1845
+ low: "low";
1846
+ medium: "medium";
1847
+ minimal: "minimal";
1848
+ none: "none";
1849
+ ultracode: "ultracode";
1850
+ xhigh: "xhigh";
1851
+ }>>;
1852
+ maxVisibleOutputTokens: z.ZodOptional<z.ZodNumber>;
1853
+ maxReasoningTokens: z.ZodOptional<z.ZodNumber>;
1854
+ maxTotalOutputTokens: z.ZodOptional<z.ZodNumber>;
1855
+ metadata: z.ZodOptional<z.ZodType<Record<string, unknown>, unknown, z.core.$ZodTypeInternals<Record<string, unknown>, unknown>>>;
1856
+ }, z.core.$strict>>;
1857
+ harness: z.ZodOptional<z.ZodEnum<{
1858
+ acp: "acp";
1859
+ amp: "amp";
1860
+ "claude-code": "claude-code";
1861
+ "cli-base": "cli-base";
1862
+ codex: "codex";
1863
+ cursor: "cursor";
1864
+ "factory-droids": "factory-droids";
1865
+ forge: "forge";
1866
+ gemini: "gemini";
1867
+ hermes: "hermes";
1868
+ "kimi-code": "kimi-code";
1869
+ nanoclaw: "nanoclaw";
1870
+ openclaw: "openclaw";
1871
+ opencode: "opencode";
1872
+ pi: "pi";
1873
+ prime: "prime";
1874
+ }>>;
1875
+ seats: z.ZodOptional<z.ZodArray<z.ZodObject<{
1876
+ harness: z.ZodEnum<{
1877
+ acp: "acp";
1878
+ amp: "amp";
1879
+ "claude-code": "claude-code";
1880
+ "cli-base": "cli-base";
1881
+ codex: "codex";
1882
+ cursor: "cursor";
1883
+ "factory-droids": "factory-droids";
1884
+ forge: "forge";
1885
+ gemini: "gemini";
1886
+ hermes: "hermes";
1887
+ "kimi-code": "kimi-code";
1888
+ nanoclaw: "nanoclaw";
1889
+ openclaw: "openclaw";
1890
+ opencode: "opencode";
1891
+ pi: "pi";
1892
+ prime: "prime";
1893
+ }>;
1894
+ provider: z.ZodString;
1895
+ model: z.ZodString;
1896
+ selector: z.ZodUnion<readonly [z.ZodObject<{
1897
+ kind: z.ZodLiteral<"all-eligible">;
1898
+ }, z.core.$strict>, z.ZodObject<{
1899
+ kind: z.ZodLiteral<"seat">;
1900
+ id: z.ZodString;
1901
+ }, z.core.$strict>]>;
1902
+ tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
1903
+ 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>>>;
1904
+ }, z.core.$strict>>>;
1905
+ 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>>>;
1906
+ tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
1907
+ mcp: z.ZodOptional<z.ZodType<Record<string, import("./agent-profile.js").AgentProfileMcpServer>, unknown, z.core.$ZodTypeInternals<Record<string, import("./agent-profile.js").AgentProfileMcpServer>, unknown>>>;
1908
+ connections: z.ZodOptional<z.ZodArray<z.ZodObject<{
1909
+ connectionId: z.ZodString;
1910
+ capabilities: z.ZodArray<z.ZodString>;
1911
+ alias: z.ZodOptional<z.ZodString>;
1912
+ }, z.core.$strict>>>;
1913
+ subagents: z.ZodOptional<z.ZodType<Record<string, {
1914
+ description?: string | undefined;
1915
+ prompt?: string | undefined;
1916
+ model?: string | undefined;
1917
+ tools?: Record<string, boolean> | undefined;
1918
+ permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
1919
+ maxSteps?: number | undefined;
1920
+ metadata?: Record<string, unknown> | undefined;
1921
+ }>, unknown, z.core.$ZodTypeInternals<Record<string, {
1922
+ description?: string | undefined;
1923
+ prompt?: string | undefined;
1924
+ model?: string | undefined;
1925
+ tools?: Record<string, boolean> | undefined;
1926
+ permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
1927
+ maxSteps?: number | undefined;
1928
+ metadata?: Record<string, unknown> | undefined;
1929
+ }>, unknown>>>;
1930
+ resources: z.ZodOptional<z.ZodObject<{
1931
+ files: z.ZodOptional<z.ZodArray<z.ZodObject<{
1932
+ path: z.ZodString;
1933
+ resource: z.ZodUnion<readonly [z.ZodObject<{
1934
+ kind: z.ZodLiteral<"inline">;
1935
+ name: z.ZodString;
1936
+ content: z.ZodString;
1937
+ }, z.core.$strict>, z.ZodObject<{
1938
+ kind: z.ZodLiteral<"github">;
1939
+ repository: z.ZodOptional<z.ZodString>;
1940
+ path: z.ZodString;
1941
+ ref: z.ZodOptional<z.ZodString>;
1942
+ name: z.ZodOptional<z.ZodString>;
1943
+ }, z.core.$strict>]>;
1944
+ executable: z.ZodOptional<z.ZodBoolean>;
1945
+ }, z.core.$strict>>>;
1946
+ tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
1947
+ kind: z.ZodLiteral<"inline">;
1948
+ name: z.ZodString;
1949
+ content: z.ZodString;
1950
+ }, z.core.$strict>, z.ZodObject<{
1951
+ kind: z.ZodLiteral<"github">;
1952
+ repository: z.ZodOptional<z.ZodString>;
1953
+ path: z.ZodString;
1954
+ ref: z.ZodOptional<z.ZodString>;
1955
+ name: z.ZodOptional<z.ZodString>;
1956
+ }, z.core.$strict>]>>>;
1957
+ skills: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
1958
+ kind: z.ZodLiteral<"inline">;
1959
+ name: z.ZodString;
1960
+ content: z.ZodString;
1961
+ }, z.core.$strict>, z.ZodObject<{
1962
+ kind: z.ZodLiteral<"github">;
1963
+ repository: z.ZodOptional<z.ZodString>;
1964
+ path: z.ZodString;
1965
+ ref: z.ZodOptional<z.ZodString>;
1966
+ name: z.ZodOptional<z.ZodString>;
1967
+ }, z.core.$strict>]>>>;
1968
+ agents: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
1969
+ kind: z.ZodLiteral<"inline">;
1970
+ name: z.ZodString;
1971
+ content: z.ZodString;
1972
+ }, z.core.$strict>, z.ZodObject<{
1973
+ kind: z.ZodLiteral<"github">;
1974
+ repository: z.ZodOptional<z.ZodString>;
1975
+ path: z.ZodString;
1976
+ ref: z.ZodOptional<z.ZodString>;
1977
+ name: z.ZodOptional<z.ZodString>;
1978
+ }, z.core.$strict>]>>>;
1979
+ commands: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
1980
+ kind: z.ZodLiteral<"inline">;
1981
+ name: z.ZodString;
1982
+ content: z.ZodString;
1983
+ }, z.core.$strict>, z.ZodObject<{
1984
+ kind: z.ZodLiteral<"github">;
1985
+ repository: z.ZodOptional<z.ZodString>;
1986
+ path: z.ZodString;
1987
+ ref: z.ZodOptional<z.ZodString>;
1988
+ name: z.ZodOptional<z.ZodString>;
1989
+ }, z.core.$strict>]>>>;
1990
+ instructions: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
1991
+ kind: z.ZodLiteral<"inline">;
1992
+ name: z.ZodString;
1993
+ content: z.ZodString;
1994
+ }, z.core.$strict>, z.ZodObject<{
1995
+ kind: z.ZodLiteral<"github">;
1996
+ repository: z.ZodOptional<z.ZodString>;
1997
+ path: z.ZodString;
1998
+ ref: z.ZodOptional<z.ZodString>;
1999
+ name: z.ZodOptional<z.ZodString>;
2000
+ }, z.core.$strict>]>]>>;
2001
+ failOnError: z.ZodOptional<z.ZodBoolean>;
2002
+ }, z.core.$strict>>;
2003
+ hooks: z.ZodOptional<z.ZodType<Record<string, {
2004
+ command: string;
2005
+ timeoutMs?: number | undefined;
2006
+ blocking?: boolean | undefined;
2007
+ matcher?: string | undefined;
2008
+ env?: Record<string, {
2009
+ kind: "public";
2010
+ value: string;
2011
+ } | {
2012
+ kind: "secret-ref";
2013
+ key: string;
2014
+ format?: "bearer" | "raw" | undefined;
2015
+ }> | undefined;
2016
+ }[]>, unknown, z.core.$ZodTypeInternals<Record<string, {
2017
+ command: string;
2018
+ timeoutMs?: number | undefined;
2019
+ blocking?: boolean | undefined;
2020
+ matcher?: string | undefined;
2021
+ env?: Record<string, {
2022
+ kind: "public";
2023
+ value: string;
2024
+ } | {
2025
+ kind: "secret-ref";
2026
+ key: string;
2027
+ format?: "bearer" | "raw" | undefined;
2028
+ }> | undefined;
2029
+ }[]>, unknown>>>;
2030
+ modes: z.ZodOptional<z.ZodType<Record<string, {
2031
+ description?: string | undefined;
2032
+ model?: string | undefined;
2033
+ prompt?: string | undefined;
2034
+ tools?: Record<string, boolean> | undefined;
2035
+ permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
2036
+ metadata?: Record<string, unknown> | undefined;
2037
+ }>, unknown, z.core.$ZodTypeInternals<Record<string, {
2038
+ description?: string | undefined;
2039
+ model?: string | undefined;
2040
+ prompt?: string | undefined;
2041
+ tools?: Record<string, boolean> | undefined;
2042
+ permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
2043
+ metadata?: Record<string, unknown> | undefined;
2044
+ }>, unknown>>>;
2045
+ confidential: z.ZodOptional<z.ZodObject<{
2046
+ tee: z.ZodOptional<z.ZodString>;
2047
+ attestationNonce: z.ZodOptional<z.ZodString>;
2048
+ sealed: z.ZodOptional<z.ZodBoolean>;
2049
+ attestationRefresh: z.ZodOptional<z.ZodBoolean>;
2050
+ }, z.core.$strict>>;
2051
+ metadata: z.ZodOptional<z.ZodType<import("./agent-profile.js").AgentProfileMetadata, unknown, z.core.$ZodTypeInternals<import("./agent-profile.js").AgentProfileMetadata, unknown>>>;
2052
+ extensions: z.ZodOptional<z.ZodType<Record<string, Record<string, unknown> | undefined>, unknown, z.core.$ZodTypeInternals<Record<string, Record<string, unknown> | undefined>, unknown>>>;
2053
+ }, z.core.$strict>>;
2054
+ workspace: z.ZodOptional<z.ZodObject<{
2055
+ environment: z.ZodOptional<z.ZodString>;
2056
+ image: z.ZodOptional<z.ZodString>;
2057
+ repoUrl: z.ZodOptional<z.ZodString>;
2058
+ gitRef: z.ZodOptional<z.ZodString>;
2059
+ cwd: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
2060
+ base: z.ZodLiteral<"repository">;
2061
+ path: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
2062
+ }, z.core.$strict>, z.ZodObject<{
2063
+ base: z.ZodLiteral<"host">;
2064
+ path: z.ZodString;
2065
+ }, z.core.$strict>], "base">>;
2066
+ checkpoint: z.ZodOptional<z.ZodObject<{
2067
+ checkpointId: z.ZodString;
2068
+ provider: z.ZodString;
2069
+ source: z.ZodObject<{
2070
+ runId: z.ZodString;
2071
+ provider: z.ZodString;
2072
+ environmentId: z.ZodString;
2073
+ sessionId: z.ZodString;
2074
+ executionId: z.ZodString;
2075
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2076
+ }, z.core.$strict>;
2077
+ idempotencyKey: z.ZodString;
2078
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2079
+ createdAt: z.ZodISODateTime;
2080
+ metadata: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
2081
+ }, z.core.$strict>>;
2082
+ snapshot: z.ZodOptional<z.ZodObject<{
2083
+ kind: z.ZodLiteral<"agent-candidate-workspace-snapshot">;
2084
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2085
+ manifest: z.ZodObject<{
2086
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
2087
+ kind: z.ZodLiteral<"s3">;
2088
+ bucket: z.ZodString;
2089
+ key: z.ZodString;
2090
+ region: z.ZodOptional<z.ZodString>;
2091
+ }, z.core.$strict>, z.ZodObject<{
2092
+ kind: z.ZodLiteral<"ipfs">;
2093
+ cid: z.ZodString;
2094
+ path: z.ZodOptional<z.ZodString>;
2095
+ }, z.core.$strict>, z.ZodObject<{
2096
+ kind: z.ZodLiteral<"private-cas">;
2097
+ namespace: z.ZodString;
2098
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2099
+ }, z.core.$strict>], "kind">;
2100
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2101
+ byteLength: z.ZodNumber;
2102
+ }, z.core.$strict>;
2103
+ archive: z.ZodObject<{
2104
+ locator: z.ZodDiscriminatedUnion<[z.ZodObject<{
2105
+ kind: z.ZodLiteral<"s3">;
2106
+ bucket: z.ZodString;
2107
+ key: z.ZodString;
2108
+ region: z.ZodOptional<z.ZodString>;
2109
+ }, z.core.$strict>, z.ZodObject<{
2110
+ kind: z.ZodLiteral<"ipfs">;
2111
+ cid: z.ZodString;
2112
+ path: z.ZodOptional<z.ZodString>;
2113
+ }, z.core.$strict>, z.ZodObject<{
2114
+ kind: z.ZodLiteral<"private-cas">;
2115
+ namespace: z.ZodString;
2116
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2117
+ }, z.core.$strict>], "kind">;
2118
+ sha256: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2119
+ byteLength: z.ZodNumber;
2120
+ }, z.core.$strict>;
2121
+ source: z.ZodObject<{
2122
+ leaseId: z.ZodString;
2123
+ leaseRecordDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2124
+ workspace: z.ZodObject<{
2125
+ provider: z.ZodString;
2126
+ root: z.ZodString;
2127
+ identityDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2128
+ }, z.core.$strict>;
2129
+ sourceSnapshotDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2130
+ sourceSnapshotPolicy: z.ZodObject<{
2131
+ kind: z.ZodLiteral<"provider-declared">;
2132
+ name: z.ZodString;
2133
+ version: z.ZodNumber;
2134
+ digest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
2135
+ }, z.core.$strict>;
2136
+ }, z.core.$strict>;
2137
+ }, z.core.$strict>>;
2138
+ providerOptions: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
2139
+ }, z.core.$strict>>;
2140
+ resources: z.ZodOptional<z.ZodObject<{
2141
+ cpu: z.ZodOptional<z.ZodNumber>;
2142
+ memoryMb: z.ZodOptional<z.ZodNumber>;
2143
+ diskMb: z.ZodOptional<z.ZodNumber>;
2144
+ gpu: z.ZodOptional<z.ZodString>;
2145
+ providerOptions: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
2146
+ }, z.core.$strict>>;
2147
+ }, z.core.$strict>>;
2148
+ }, z.core.$strict>;
1659
2149
  export interface AgentEnvironmentProvider {
1660
2150
  readonly name: string;
1661
2151
  readonly exactProcess?: AgentExactProcessProvider;
@@ -1689,9 +2179,7 @@ export interface AgentEnvironmentProvider {
1689
2179
  * Without a key, each call may create a fresh environment.
1690
2180
  */
1691
2181
  create(input: CreateAgentEnvironmentInput): Promise<AgentEnvironment>;
1692
- get?(id: string, options?: {
1693
- signal?: AbortSignal;
1694
- }): Promise<AgentEnvironment | null>;
2182
+ get?(id: string, options?: AgentEnvironmentGetOptions): Promise<AgentEnvironment | null>;
1695
2183
  list?(query?: AgentEnvironmentQuery, options?: {
1696
2184
  signal?: AbortSignal;
1697
2185
  }): Promise<AgentEnvironmentSummary[]>;
@@ -1700,6 +2188,8 @@ export interface AgentEnvironmentProvider {
1700
2188
  export interface AgentContextTransferProvider {
1701
2189
  transfer(request: ContextTransferRequest, options?: {
1702
2190
  signal?: AbortSignal;
2191
+ /** Authorized source artifacts for this attempt; never part of the accepted wire request. */
2192
+ artifacts?: AgentCandidateArtifactPort;
1703
2193
  }): Promise<ContextTransferResult>;
1704
2194
  lookup(request: ContextTransferRequest, options?: {
1705
2195
  signal?: AbortSignal;