@tangle-network/agent-interface 3.2.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.
Files changed (25) hide show
  1. package/README.md +11 -2
  2. package/dist/environment-provider.d.ts +1 -0
  3. package/dist/environment-provider.js +1 -0
  4. package/dist/environment-requests.d.ts +72 -0
  5. package/dist/environment-requests.js +16 -0
  6. package/dist/environment-runtime.d.ts +789 -39
  7. package/dist/environment-runtime.js +11 -2
  8. package/dist/index.d.ts +2 -1
  9. package/dist/index.js +2 -1
  10. package/dist/portable-context-commitments.d.ts +47 -0
  11. package/dist/portable-context-commitments.js +48 -0
  12. package/dist/portable-context-plan-request.d.ts +2 -1
  13. package/dist/portable-context-plan-wire.d.ts +103 -0
  14. package/dist/portable-context-plan-wire.js +127 -0
  15. package/dist/portable-context-plan.d.ts +6 -13
  16. package/dist/portable-context-plan.js +12 -14
  17. package/dist/portable-context-transfer.d.ts +344 -37
  18. package/dist/portable-context-transfer.js +40 -3
  19. package/dist/portable-context.d.ts +1 -0
  20. package/dist/portable-context.js +1 -0
  21. package/dist/provider-adapter.d.ts +9 -3
  22. package/dist/provider-config.d.ts +5 -0
  23. package/dist/workspace-snapshot.d.ts +79 -0
  24. package/dist/workspace-snapshot.js +31 -0
  25. package/package.json +1 -1
package/dist/environment-runtime.d.ts CHANGED
@@ -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,39 +323,32 @@ 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;
350
344
  provider: z.ZodString;
351
- environmentId: z.ZodString;
345
+ environmentId: z.ZodOptional<z.ZodString>;
352
346
  sessionId: z.ZodString;
353
347
  runId: z.ZodString;
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<{
@@ -437,6 +414,324 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
437
414
  user: "user";
438
415
  }>;
439
416
  }, z.core.$strict>;
417
+ profile: z.ZodOptional<z.ZodObject<{
418
+ name: z.ZodOptional<z.ZodString>;
419
+ description: z.ZodOptional<z.ZodString>;
420
+ version: z.ZodOptional<z.ZodString>;
421
+ tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
422
+ prompt: z.ZodOptional<z.ZodObject<{
423
+ systemPrompt: z.ZodOptional<z.ZodString>;
424
+ appendSystemPrompt: z.ZodOptional<z.ZodString>;
425
+ instructions: z.ZodOptional<z.ZodArray<z.ZodString>>;
426
+ }, z.core.$strict>>;
427
+ model: z.ZodOptional<z.ZodObject<{
428
+ default: z.ZodOptional<z.ZodString>;
429
+ small: z.ZodOptional<z.ZodString>;
430
+ provider: z.ZodOptional<z.ZodString>;
431
+ reasoningEffort: z.ZodOptional<z.ZodEnum<{
432
+ high: "high";
433
+ low: "low";
434
+ medium: "medium";
435
+ minimal: "minimal";
436
+ none: "none";
437
+ ultracode: "ultracode";
438
+ xhigh: "xhigh";
439
+ }>>;
440
+ maxVisibleOutputTokens: z.ZodOptional<z.ZodNumber>;
441
+ maxReasoningTokens: z.ZodOptional<z.ZodNumber>;
442
+ maxTotalOutputTokens: z.ZodOptional<z.ZodNumber>;
443
+ metadata: z.ZodOptional<z.ZodType<Record<string, unknown>, unknown, z.core.$ZodTypeInternals<Record<string, unknown>, unknown>>>;
444
+ }, z.core.$strict>>;
445
+ harness: z.ZodOptional<z.ZodEnum<{
446
+ acp: "acp";
447
+ amp: "amp";
448
+ "claude-code": "claude-code";
449
+ "cli-base": "cli-base";
450
+ codex: "codex";
451
+ cursor: "cursor";
452
+ "factory-droids": "factory-droids";
453
+ forge: "forge";
454
+ gemini: "gemini";
455
+ hermes: "hermes";
456
+ "kimi-code": "kimi-code";
457
+ nanoclaw: "nanoclaw";
458
+ openclaw: "openclaw";
459
+ opencode: "opencode";
460
+ pi: "pi";
461
+ prime: "prime";
462
+ }>>;
463
+ seats: z.ZodOptional<z.ZodArray<z.ZodObject<{
464
+ harness: z.ZodEnum<{
465
+ acp: "acp";
466
+ amp: "amp";
467
+ "claude-code": "claude-code";
468
+ "cli-base": "cli-base";
469
+ codex: "codex";
470
+ cursor: "cursor";
471
+ "factory-droids": "factory-droids";
472
+ forge: "forge";
473
+ gemini: "gemini";
474
+ hermes: "hermes";
475
+ "kimi-code": "kimi-code";
476
+ nanoclaw: "nanoclaw";
477
+ openclaw: "openclaw";
478
+ opencode: "opencode";
479
+ pi: "pi";
480
+ prime: "prime";
481
+ }>;
482
+ provider: z.ZodString;
483
+ model: z.ZodString;
484
+ selector: z.ZodUnion<readonly [z.ZodObject<{
485
+ kind: z.ZodLiteral<"all-eligible">;
486
+ }, z.core.$strict>, z.ZodObject<{
487
+ kind: z.ZodLiteral<"seat">;
488
+ id: z.ZodString;
489
+ }, z.core.$strict>]>;
490
+ tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
491
+ 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>>>;
492
+ }, z.core.$strict>>>;
493
+ 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>>>;
494
+ tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
495
+ mcp: z.ZodOptional<z.ZodType<Record<string, import("./agent-profile.js").AgentProfileMcpServer>, unknown, z.core.$ZodTypeInternals<Record<string, import("./agent-profile.js").AgentProfileMcpServer>, unknown>>>;
496
+ connections: z.ZodOptional<z.ZodArray<z.ZodObject<{
497
+ connectionId: z.ZodString;
498
+ capabilities: z.ZodArray<z.ZodString>;
499
+ alias: z.ZodOptional<z.ZodString>;
500
+ }, z.core.$strict>>>;
501
+ subagents: z.ZodOptional<z.ZodType<Record<string, {
502
+ description?: string | undefined;
503
+ prompt?: string | undefined;
504
+ model?: string | undefined;
505
+ tools?: Record<string, boolean> | undefined;
506
+ permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
507
+ maxSteps?: number | undefined;
508
+ metadata?: Record<string, unknown> | undefined;
509
+ }>, unknown, z.core.$ZodTypeInternals<Record<string, {
510
+ description?: string | undefined;
511
+ prompt?: string | undefined;
512
+ model?: string | undefined;
513
+ tools?: Record<string, boolean> | undefined;
514
+ permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
515
+ maxSteps?: number | undefined;
516
+ metadata?: Record<string, unknown> | undefined;
517
+ }>, unknown>>>;
518
+ resources: z.ZodOptional<z.ZodObject<{
519
+ files: z.ZodOptional<z.ZodArray<z.ZodObject<{
520
+ path: z.ZodString;
521
+ resource: z.ZodUnion<readonly [z.ZodObject<{
522
+ kind: z.ZodLiteral<"inline">;
523
+ name: z.ZodString;
524
+ content: z.ZodString;
525
+ }, z.core.$strict>, z.ZodObject<{
526
+ kind: z.ZodLiteral<"github">;
527
+ repository: z.ZodOptional<z.ZodString>;
528
+ path: z.ZodString;
529
+ ref: z.ZodOptional<z.ZodString>;
530
+ name: z.ZodOptional<z.ZodString>;
531
+ }, z.core.$strict>]>;
532
+ executable: z.ZodOptional<z.ZodBoolean>;
533
+ }, z.core.$strict>>>;
534
+ tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
535
+ kind: z.ZodLiteral<"inline">;
536
+ name: z.ZodString;
537
+ content: z.ZodString;
538
+ }, z.core.$strict>, z.ZodObject<{
539
+ kind: z.ZodLiteral<"github">;
540
+ repository: z.ZodOptional<z.ZodString>;
541
+ path: z.ZodString;
542
+ ref: z.ZodOptional<z.ZodString>;
543
+ name: z.ZodOptional<z.ZodString>;
544
+ }, z.core.$strict>]>>>;
545
+ skills: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
546
+ kind: z.ZodLiteral<"inline">;
547
+ name: z.ZodString;
548
+ content: z.ZodString;
549
+ }, z.core.$strict>, z.ZodObject<{
550
+ kind: z.ZodLiteral<"github">;
551
+ repository: z.ZodOptional<z.ZodString>;
552
+ path: z.ZodString;
553
+ ref: z.ZodOptional<z.ZodString>;
554
+ name: z.ZodOptional<z.ZodString>;
555
+ }, z.core.$strict>]>>>;
556
+ agents: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
557
+ kind: z.ZodLiteral<"inline">;
558
+ name: z.ZodString;
559
+ content: z.ZodString;
560
+ }, z.core.$strict>, z.ZodObject<{
561
+ kind: z.ZodLiteral<"github">;
562
+ repository: z.ZodOptional<z.ZodString>;
563
+ path: z.ZodString;
564
+ ref: z.ZodOptional<z.ZodString>;
565
+ name: z.ZodOptional<z.ZodString>;
566
+ }, z.core.$strict>]>>>;
567
+ commands: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
568
+ kind: z.ZodLiteral<"inline">;
569
+ name: z.ZodString;
570
+ content: z.ZodString;
571
+ }, z.core.$strict>, z.ZodObject<{
572
+ kind: z.ZodLiteral<"github">;
573
+ repository: z.ZodOptional<z.ZodString>;
574
+ path: z.ZodString;
575
+ ref: z.ZodOptional<z.ZodString>;
576
+ name: z.ZodOptional<z.ZodString>;
577
+ }, z.core.$strict>]>>>;
578
+ instructions: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
579
+ kind: z.ZodLiteral<"inline">;
580
+ name: z.ZodString;
581
+ content: z.ZodString;
582
+ }, z.core.$strict>, z.ZodObject<{
583
+ kind: z.ZodLiteral<"github">;
584
+ repository: z.ZodOptional<z.ZodString>;
585
+ path: z.ZodString;
586
+ ref: z.ZodOptional<z.ZodString>;
587
+ name: z.ZodOptional<z.ZodString>;
588
+ }, z.core.$strict>]>]>>;
589
+ failOnError: z.ZodOptional<z.ZodBoolean>;
590
+ }, z.core.$strict>>;
591
+ hooks: z.ZodOptional<z.ZodType<Record<string, {
592
+ command: string;
593
+ timeoutMs?: number | undefined;
594
+ blocking?: boolean | undefined;
595
+ matcher?: string | undefined;
596
+ env?: Record<string, {
597
+ kind: "public";
598
+ value: string;
599
+ } | {
600
+ kind: "secret-ref";
601
+ key: string;
602
+ format?: "bearer" | "raw" | undefined;
603
+ }> | undefined;
604
+ }[]>, unknown, z.core.$ZodTypeInternals<Record<string, {
605
+ command: string;
606
+ timeoutMs?: number | undefined;
607
+ blocking?: boolean | undefined;
608
+ matcher?: string | undefined;
609
+ env?: Record<string, {
610
+ kind: "public";
611
+ value: string;
612
+ } | {
613
+ kind: "secret-ref";
614
+ key: string;
615
+ format?: "bearer" | "raw" | undefined;
616
+ }> | undefined;
617
+ }[]>, unknown>>>;
618
+ modes: z.ZodOptional<z.ZodType<Record<string, {
619
+ description?: string | undefined;
620
+ model?: string | undefined;
621
+ prompt?: string | undefined;
622
+ tools?: Record<string, boolean> | undefined;
623
+ permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
624
+ metadata?: Record<string, unknown> | undefined;
625
+ }>, unknown, z.core.$ZodTypeInternals<Record<string, {
626
+ description?: string | undefined;
627
+ model?: string | undefined;
628
+ prompt?: string | undefined;
629
+ tools?: Record<string, boolean> | undefined;
630
+ permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
631
+ metadata?: Record<string, unknown> | undefined;
632
+ }>, unknown>>>;
633
+ confidential: z.ZodOptional<z.ZodObject<{
634
+ tee: z.ZodOptional<z.ZodString>;
635
+ attestationNonce: z.ZodOptional<z.ZodString>;
636
+ sealed: z.ZodOptional<z.ZodBoolean>;
637
+ attestationRefresh: z.ZodOptional<z.ZodBoolean>;
638
+ }, z.core.$strict>>;
639
+ metadata: z.ZodOptional<z.ZodType<import("./agent-profile.js").AgentProfileMetadata, unknown, z.core.$ZodTypeInternals<import("./agent-profile.js").AgentProfileMetadata, unknown>>>;
640
+ extensions: z.ZodOptional<z.ZodType<Record<string, Record<string, unknown> | undefined>, unknown, z.core.$ZodTypeInternals<Record<string, Record<string, unknown> | undefined>, unknown>>>;
641
+ }, z.core.$strict>>;
642
+ workspace: z.ZodOptional<z.ZodObject<{
643
+ environment: z.ZodOptional<z.ZodString>;
644
+ image: z.ZodOptional<z.ZodString>;
645
+ repoUrl: z.ZodOptional<z.ZodString>;
646
+ gitRef: z.ZodOptional<z.ZodString>;
647
+ cwd: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
648
+ base: z.ZodLiteral<"repository">;
649
+ path: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
650
+ }, z.core.$strict>, z.ZodObject<{
651
+ base: z.ZodLiteral<"host">;
652
+ path: z.ZodString;
653
+ }, z.core.$strict>], "base">>;
654
+ checkpoint: z.ZodOptional<z.ZodObject<{
655
+ checkpointId: z.ZodString;
656
+ provider: z.ZodString;
657
+ source: z.ZodObject<{
658
+ runId: z.ZodString;
659
+ provider: z.ZodString;
660
+ environmentId: z.ZodString;
661
+ sessionId: z.ZodString;
662
+ executionId: z.ZodString;
663
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
664
+ }, z.core.$strict>;
665
+ idempotencyKey: z.ZodString;
666
+ requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
667
+ createdAt: z.ZodISODateTime;
668
+ metadata: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
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>>;
726
+ providerOptions: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
727
+ }, z.core.$strict>>;
728
+ resources: z.ZodOptional<z.ZodObject<{
729
+ cpu: z.ZodOptional<z.ZodNumber>;
730
+ memoryMb: z.ZodOptional<z.ZodNumber>;
731
+ diskMb: z.ZodOptional<z.ZodNumber>;
732
+ gpu: z.ZodOptional<z.ZodString>;
733
+ providerOptions: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
734
+ }, z.core.$strict>>;
440
735
  }, z.core.$strict>>;
441
736
  nativeContinuation: z.ZodOptional<z.ZodObject<{
442
737
  operationId: z.ZodString;
@@ -552,12 +847,13 @@ export declare const AgentTurnResultSchema: z.ZodObject<{
552
847
  destination: z.ZodObject<{
553
848
  runner: z.ZodString;
554
849
  provider: z.ZodString;
555
- environmentId: z.ZodString;
850
+ environmentId: z.ZodOptional<z.ZodString>;
556
851
  sessionId: z.ZodString;
557
852
  runId: z.ZodString;
558
853
  executionId: z.ZodString;
559
854
  model: z.ZodOptional<z.ZodString>;
560
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>>>;
561
857
  }, z.core.$strict>;
562
858
  provider: z.ZodString;
563
859
  environmentId: z.ZodString;
@@ -588,12 +884,13 @@ export declare const AgentTurnResultSchema: z.ZodObject<{
588
884
  destination: z.ZodObject<{
589
885
  runner: z.ZodString;
590
886
  provider: z.ZodString;
591
- environmentId: z.ZodString;
887
+ environmentId: z.ZodOptional<z.ZodString>;
592
888
  sessionId: z.ZodString;
593
889
  runId: z.ZodString;
594
890
  executionId: z.ZodString;
595
891
  model: z.ZodOptional<z.ZodString>;
596
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>>>;
597
894
  }, z.core.$strict>;
598
895
  provider: z.ZodString;
599
896
  environmentId: z.ZodString;
@@ -708,12 +1005,13 @@ export declare const AgentNativeContextContinuationResultSchema: z.ZodUnion<read
708
1005
  destination: z.ZodObject<{
709
1006
  runner: z.ZodString;
710
1007
  provider: z.ZodString;
711
- environmentId: z.ZodString;
1008
+ environmentId: z.ZodOptional<z.ZodString>;
712
1009
  sessionId: z.ZodString;
713
1010
  runId: z.ZodString;
714
1011
  executionId: z.ZodString;
715
1012
  model: z.ZodOptional<z.ZodString>;
716
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>>>;
717
1015
  }, z.core.$strict>;
718
1016
  provider: z.ZodString;
719
1017
  environmentId: z.ZodString;
@@ -744,12 +1042,13 @@ export declare const AgentNativeContextContinuationResultSchema: z.ZodUnion<read
744
1042
  destination: z.ZodObject<{
745
1043
  runner: z.ZodString;
746
1044
  provider: z.ZodString;
747
- environmentId: z.ZodString;
1045
+ environmentId: z.ZodOptional<z.ZodString>;
748
1046
  sessionId: z.ZodString;
749
1047
  runId: z.ZodString;
750
1048
  executionId: z.ZodString;
751
1049
  model: z.ZodOptional<z.ZodString>;
752
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>>>;
753
1052
  }, z.core.$strict>;
754
1053
  provider: z.ZodString;
755
1054
  environmentId: z.ZodString;
@@ -955,6 +1254,8 @@ export interface AgentEnvironment {
955
1254
  * provider cannot prove which outcome happened.
956
1255
  */
957
1256
  readonly creation?: AgentEnvironmentCreation;
1257
+ /** Authoritative receipt returned only by a qualified context-transfer attachment. */
1258
+ readonly contextTransferReceipt?: ContextTransferReceipt;
958
1259
  /**
959
1260
  * Detached metadata returned by the provider.
960
1261
  * It can contain caller-authored annotations and is not authorization evidence.
@@ -1062,6 +1363,8 @@ export interface AgentEnvironmentCapabilities {
1062
1363
  freshSession: boolean;
1063
1364
  requestIdempotency: boolean;
1064
1365
  lookup: boolean;
1366
+ /** get(id, { contextTransfer }) verifies the durable receipt and enables only its first turn. */
1367
+ attach?: boolean;
1065
1368
  };
1066
1369
  /** Absent when the provider cannot originate or answer interactions. */
1067
1370
  interactions?: InteractionCapabilities;
@@ -1106,6 +1409,8 @@ export interface AgentEnvironmentCapabilities {
1106
1409
  * exactly that, instead of advertising an egress mode it does not accept.
1107
1410
  */
1108
1411
  create?: {
1412
+ /** The provider durably binds keyed create input and can reconstruct it after restart. */
1413
+ durableIdempotency?: boolean;
1109
1414
  /**
1110
1415
  * Egress modes create accepts, each named once. A mode absent here is refused, never weakened
1111
1416
  * or widened. Absent altogether means create does not read
@@ -1126,6 +1431,8 @@ export interface AgentEnvironmentCapabilities {
1126
1431
  * including a checkpoint whose source environment is gone. Absent means create refuses one.
1127
1432
  */
1128
1433
  workspaceCheckpoint?: boolean;
1434
+ /** True only when this qualified receiver verifies and restores WorkspaceRequest.snapshot. */
1435
+ workspaceSnapshot?: boolean;
1129
1436
  };
1130
1437
  /** Per-surface flags for the normalized environment observation. */
1131
1438
  observation?: {
@@ -1213,6 +1520,7 @@ export declare const AgentEnvironmentCapabilitiesSchema: z.ZodObject<{
1213
1520
  freshSession: z.ZodBoolean;
1214
1521
  requestIdempotency: z.ZodBoolean;
1215
1522
  lookup: z.ZodBoolean;
1523
+ attach: z.ZodOptional<z.ZodBoolean>;
1216
1524
  }, z.core.$strict>>;
1217
1525
  interactions: z.ZodOptional<z.ZodObject<{
1218
1526
  kinds: z.ZodArray<z.ZodString>;
@@ -1268,11 +1576,13 @@ export declare const AgentEnvironmentCapabilitiesSchema: z.ZodObject<{
1268
1576
  open: "open";
1269
1577
  strict: "strict";
1270
1578
  }>>>;
1579
+ durableIdempotency: z.ZodOptional<z.ZodBoolean>;
1271
1580
  billingOwner: z.ZodOptional<z.ZodBoolean>;
1272
1581
  runtimeAttachments: z.ZodOptional<z.ZodObject<{
1273
1582
  mcp: z.ZodLiteral<true>;
1274
1583
  }, z.core.$strict>>;
1275
1584
  workspaceCheckpoint: z.ZodOptional<z.ZodBoolean>;
1585
+ workspaceSnapshot: z.ZodOptional<z.ZodBoolean>;
1276
1586
  }, z.core.$strict>>;
1277
1587
  observation: z.ZodOptional<z.ZodObject<{
1278
1588
  identity: z.ZodBoolean;
@@ -1391,6 +1701,448 @@ export interface AgentEnvironmentCreateIdempotencyRecord<T> {
1391
1701
  * @internal
1392
1702
  */
1393
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>;
1394
2146
  export interface AgentEnvironmentProvider {
1395
2147
  readonly name: string;
1396
2148
  readonly exactProcess?: AgentExactProcessProvider;
@@ -1424,9 +2176,7 @@ export interface AgentEnvironmentProvider {
1424
2176
  * Without a key, each call may create a fresh environment.
1425
2177
  */
1426
2178
  create(input: CreateAgentEnvironmentInput): Promise<AgentEnvironment>;
1427
- get?(id: string, options?: {
1428
- signal?: AbortSignal;
1429
- }): Promise<AgentEnvironment | null>;
2179
+ get?(id: string, options?: AgentEnvironmentGetOptions): Promise<AgentEnvironment | null>;
1430
2180
  list?(query?: AgentEnvironmentQuery, options?: {
1431
2181
  signal?: AbortSignal;
1432
2182
  }): Promise<AgentEnvironmentSummary[]>;