@tangle-network/agent-interface 5.7.0 → 5.8.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 (44) hide show
  1. package/README.md +11 -2
  2. package/dist/agent-candidate-code-schema.d.ts +24 -24
  3. package/dist/agent-candidate-execution-plan-schema.d.ts +245 -245
  4. package/dist/agent-candidate-lineage-schema.d.ts +2 -2
  5. package/dist/agent-candidate-outcome-schema.d.ts +56 -56
  6. package/dist/agent-candidate-profile-schema.d.ts +22 -22
  7. package/dist/agent-candidate-promotion-schema.d.ts +1824 -1824
  8. package/dist/agent-candidate-receipt-schema.d.ts +201 -201
  9. package/dist/agent-candidate-schema-common.d.ts +3 -3
  10. package/dist/agent-candidate-schema.d.ts +36 -36
  11. package/dist/agent-candidate-task-schema.d.ts +16 -16
  12. package/dist/agent-execution-preparation-receipt.d.ts +81 -81
  13. package/dist/agent-improvement-measurement-schema.d.ts +25 -25
  14. package/dist/agent-profile-improvement-schema.d.ts +75 -75
  15. package/dist/agent-profile.d.ts +10 -28
  16. package/dist/agent-workspace-lease.d.ts +4 -4
  17. package/dist/environment-interactive-control.d.ts +473 -473
  18. package/dist/environment-interactive-start.d.ts +38 -29
  19. package/dist/environment-observation.d.ts +32 -32
  20. package/dist/environment-profile-capabilities.d.ts +1 -1
  21. package/dist/environment-runtime.d.ts +171 -144
  22. package/dist/harness-capabilities.d.ts +17 -18
  23. package/dist/harness-capabilities.js +41 -44
  24. package/dist/harness.d.ts +13 -11
  25. package/dist/harness.js +5 -0
  26. package/dist/interaction-envelope.d.ts +26 -26
  27. package/dist/interaction-fields.d.ts +22 -22
  28. package/dist/interaction-permissions.d.ts +2 -2
  29. package/dist/learning-state.d.ts +143 -143
  30. package/dist/portable-context-base.d.ts +1 -1
  31. package/dist/portable-context-commitments.d.ts +8 -8
  32. package/dist/portable-context-continuation.d.ts +4 -4
  33. package/dist/portable-context-plan-request.d.ts +1 -1
  34. package/dist/portable-context-plan-wire.d.ts +2 -2
  35. package/dist/portable-context-plan.d.ts +5 -5
  36. package/dist/portable-context-shared.d.ts +1 -1
  37. package/dist/portable-context-transfer.d.ts +43 -34
  38. package/dist/profile-schema.d.ts +78 -60
  39. package/dist/profile-schema.js +7 -3
  40. package/dist/proxy-secrets.d.ts +12 -12
  41. package/dist/runtime-control.d.ts +5 -5
  42. package/dist/workspace-cleanup.d.ts +3 -3
  43. package/dist/workspace-fork.d.ts +4 -4
  44. package/package.json +5 -5
@@ -63,13 +63,13 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
63
63
  small: z.ZodOptional<z.ZodString>;
64
64
  provider: z.ZodOptional<z.ZodString>;
65
65
  reasoningEffort: z.ZodOptional<z.ZodEnum<{
66
- high: "high";
66
+ none: "none";
67
+ minimal: "minimal";
67
68
  low: "low";
68
69
  medium: "medium";
69
- minimal: "minimal";
70
- none: "none";
71
- ultracode: "ultracode";
70
+ high: "high";
72
71
  xhigh: "xhigh";
72
+ ultracode: "ultracode";
73
73
  }>>;
74
74
  maxVisibleOutputTokens: z.ZodOptional<z.ZodNumber>;
75
75
  maxReasoningTokens: z.ZodOptional<z.ZodNumber>;
@@ -77,44 +77,53 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
77
77
  metadata: z.ZodOptional<z.ZodType<Record<string, unknown>, unknown, z.core.$ZodTypeInternals<Record<string, unknown>, unknown>>>;
78
78
  }, z.core.$strict>>;
79
79
  harness: z.ZodOptional<z.ZodEnum<{
80
- acp: "acp";
81
- amp: "amp";
82
80
  "claude-code": "claude-code";
83
- "cli-base": "cli-base";
84
- codex: "codex";
85
- cursor: "cursor";
86
- "factory-droids": "factory-droids";
87
- forge: "forge";
88
- gemini: "gemini";
89
- hermes: "hermes";
90
- "kimi-code": "kimi-code";
91
81
  nanoclaw: "nanoclaw";
92
- openclaw: "openclaw";
82
+ codex: "codex";
93
83
  opencode: "opencode";
84
+ "kimi-code": "kimi-code";
94
85
  pi: "pi";
95
86
  prime: "prime";
87
+ gemini: "gemini";
88
+ hermes: "hermes";
89
+ openclaw: "openclaw";
90
+ amp: "amp";
91
+ "factory-droids": "factory-droids";
92
+ forge: "forge";
93
+ cursor: "cursor";
94
+ acp: "acp";
95
+ "cli-base": "cli-base";
96
96
  }>>;
97
97
  seats: z.ZodOptional<z.ZodArray<z.ZodObject<{
98
98
  harness: z.ZodEnum<{
99
- acp: "acp";
100
- amp: "amp";
101
99
  "claude-code": "claude-code";
102
- "cli-base": "cli-base";
103
- codex: "codex";
104
- cursor: "cursor";
105
- "factory-droids": "factory-droids";
106
- forge: "forge";
107
- gemini: "gemini";
108
- hermes: "hermes";
109
- "kimi-code": "kimi-code";
110
100
  nanoclaw: "nanoclaw";
111
- openclaw: "openclaw";
101
+ codex: "codex";
112
102
  opencode: "opencode";
103
+ "kimi-code": "kimi-code";
113
104
  pi: "pi";
114
105
  prime: "prime";
106
+ gemini: "gemini";
107
+ hermes: "hermes";
108
+ openclaw: "openclaw";
109
+ amp: "amp";
110
+ "factory-droids": "factory-droids";
111
+ forge: "forge";
112
+ cursor: "cursor";
113
+ acp: "acp";
114
+ "cli-base": "cli-base";
115
115
  }>;
116
116
  provider: z.ZodString;
117
117
  model: z.ZodString;
118
+ reasoningEffort: z.ZodOptional<z.ZodEnum<{
119
+ none: "none";
120
+ minimal: "minimal";
121
+ low: "low";
122
+ medium: "medium";
123
+ high: "high";
124
+ xhigh: "xhigh";
125
+ ultracode: "ultracode";
126
+ }>>;
118
127
  selector: z.ZodUnion<readonly [z.ZodObject<{
119
128
  kind: z.ZodLiteral<"all-eligible">;
120
129
  }, z.core.$strict>, z.ZodObject<{
@@ -130,8 +139,8 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
130
139
  paths: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
131
140
  envName: z.ZodString;
132
141
  secretRef: z.ZodObject<{
133
- kind: z.ZodLiteral<"secret-ref">;
134
142
  key: z.ZodString;
143
+ kind: z.ZodLiteral<"secret-ref">;
135
144
  }, z.core.$strict>;
136
145
  presentation: z.ZodDiscriminatedUnion<[z.ZodObject<{
137
146
  type: z.ZodLiteral<"bearer">;
@@ -261,7 +270,7 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
261
270
  env?: Record<string, {
262
271
  kind: "secret-ref";
263
272
  key: string;
264
- format?: "bearer" | "raw" | undefined;
273
+ format?: "raw" | "bearer" | undefined;
265
274
  } | {
266
275
  kind: "public";
267
276
  value: string;
@@ -274,7 +283,7 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
274
283
  env?: Record<string, {
275
284
  kind: "secret-ref";
276
285
  key: string;
277
- format?: "bearer" | "raw" | undefined;
286
+ format?: "raw" | "bearer" | undefined;
278
287
  } | {
279
288
  kind: "public";
280
289
  value: string;
@@ -391,9 +400,9 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
391
400
  parts: z.ZodArray<z.ZodObject<{
392
401
  partIndex: z.ZodNumber;
393
402
  action: z.ZodEnum<{
403
+ transform: "transform";
394
404
  include: "include";
395
405
  omit: "omit";
396
- transform: "transform";
397
406
  }>;
398
407
  outputDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
399
408
  }, z.core.$strict>>;
@@ -416,9 +425,9 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
416
425
  messages: z.ZodArray<z.ZodObject<{
417
426
  id: z.ZodString;
418
427
  role: z.ZodEnum<{
428
+ user: "user";
419
429
  assistant: "assistant";
420
430
  system: "system";
421
- user: "user";
422
431
  }>;
423
432
  parts: z.ZodArray<z.ZodCustom<unknown, unknown>>;
424
433
  timestamp: z.ZodISODateTime;
@@ -442,8 +451,8 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
442
451
  acceptedAt: z.ZodISODateTime;
443
452
  acceptedBy: z.ZodEnum<{
444
453
  policy: "policy";
445
- system: "system";
446
454
  user: "user";
455
+ system: "system";
447
456
  }>;
448
457
  }, z.core.$strict>;
449
458
  profile: z.ZodOptional<z.ZodObject<{
@@ -461,13 +470,13 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
461
470
  small: z.ZodOptional<z.ZodString>;
462
471
  provider: z.ZodOptional<z.ZodString>;
463
472
  reasoningEffort: z.ZodOptional<z.ZodEnum<{
464
- high: "high";
473
+ none: "none";
474
+ minimal: "minimal";
465
475
  low: "low";
466
476
  medium: "medium";
467
- minimal: "minimal";
468
- none: "none";
469
- ultracode: "ultracode";
477
+ high: "high";
470
478
  xhigh: "xhigh";
479
+ ultracode: "ultracode";
471
480
  }>>;
472
481
  maxVisibleOutputTokens: z.ZodOptional<z.ZodNumber>;
473
482
  maxReasoningTokens: z.ZodOptional<z.ZodNumber>;
@@ -475,44 +484,53 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
475
484
  metadata: z.ZodOptional<z.ZodType<Record<string, unknown>, unknown, z.core.$ZodTypeInternals<Record<string, unknown>, unknown>>>;
476
485
  }, z.core.$strict>>;
477
486
  harness: z.ZodOptional<z.ZodEnum<{
478
- acp: "acp";
479
- amp: "amp";
480
487
  "claude-code": "claude-code";
481
- "cli-base": "cli-base";
482
- codex: "codex";
483
- cursor: "cursor";
484
- "factory-droids": "factory-droids";
485
- forge: "forge";
486
- gemini: "gemini";
487
- hermes: "hermes";
488
- "kimi-code": "kimi-code";
489
488
  nanoclaw: "nanoclaw";
490
- openclaw: "openclaw";
489
+ codex: "codex";
491
490
  opencode: "opencode";
491
+ "kimi-code": "kimi-code";
492
492
  pi: "pi";
493
493
  prime: "prime";
494
+ gemini: "gemini";
495
+ hermes: "hermes";
496
+ openclaw: "openclaw";
497
+ amp: "amp";
498
+ "factory-droids": "factory-droids";
499
+ forge: "forge";
500
+ cursor: "cursor";
501
+ acp: "acp";
502
+ "cli-base": "cli-base";
494
503
  }>>;
495
504
  seats: z.ZodOptional<z.ZodArray<z.ZodObject<{
496
505
  harness: z.ZodEnum<{
497
- acp: "acp";
498
- amp: "amp";
499
506
  "claude-code": "claude-code";
500
- "cli-base": "cli-base";
501
- codex: "codex";
502
- cursor: "cursor";
503
- "factory-droids": "factory-droids";
504
- forge: "forge";
505
- gemini: "gemini";
506
- hermes: "hermes";
507
- "kimi-code": "kimi-code";
508
507
  nanoclaw: "nanoclaw";
509
- openclaw: "openclaw";
508
+ codex: "codex";
510
509
  opencode: "opencode";
510
+ "kimi-code": "kimi-code";
511
511
  pi: "pi";
512
512
  prime: "prime";
513
+ gemini: "gemini";
514
+ hermes: "hermes";
515
+ openclaw: "openclaw";
516
+ amp: "amp";
517
+ "factory-droids": "factory-droids";
518
+ forge: "forge";
519
+ cursor: "cursor";
520
+ acp: "acp";
521
+ "cli-base": "cli-base";
513
522
  }>;
514
523
  provider: z.ZodString;
515
524
  model: z.ZodString;
525
+ reasoningEffort: z.ZodOptional<z.ZodEnum<{
526
+ none: "none";
527
+ minimal: "minimal";
528
+ low: "low";
529
+ medium: "medium";
530
+ high: "high";
531
+ xhigh: "xhigh";
532
+ ultracode: "ultracode";
533
+ }>>;
516
534
  selector: z.ZodUnion<readonly [z.ZodObject<{
517
535
  kind: z.ZodLiteral<"all-eligible">;
518
536
  }, z.core.$strict>, z.ZodObject<{
@@ -528,8 +546,8 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
528
546
  paths: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
529
547
  envName: z.ZodString;
530
548
  secretRef: z.ZodObject<{
531
- kind: z.ZodLiteral<"secret-ref">;
532
549
  key: z.ZodString;
550
+ kind: z.ZodLiteral<"secret-ref">;
533
551
  }, z.core.$strict>;
534
552
  presentation: z.ZodDiscriminatedUnion<[z.ZodObject<{
535
553
  type: z.ZodLiteral<"bearer">;
@@ -659,7 +677,7 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
659
677
  env?: Record<string, {
660
678
  kind: "secret-ref";
661
679
  key: string;
662
- format?: "bearer" | "raw" | undefined;
680
+ format?: "raw" | "bearer" | undefined;
663
681
  } | {
664
682
  kind: "public";
665
683
  value: string;
@@ -672,7 +690,7 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
672
690
  env?: Record<string, {
673
691
  kind: "secret-ref";
674
692
  key: string;
675
- format?: "bearer" | "raw" | undefined;
693
+ format?: "raw" | "bearer" | undefined;
676
694
  } | {
677
695
  kind: "public";
678
696
  value: string;
@@ -886,8 +904,8 @@ export declare const AgentTurnResultSchema: z.ZodObject<{
886
904
  cost: z.ZodOptional<z.ZodNumber>;
887
905
  }, z.core.$strict>>;
888
906
  usageMode: z.ZodOptional<z.ZodEnum<{
889
- cumulative: "cumulative";
890
907
  delta: "delta";
908
+ cumulative: "cumulative";
891
909
  }>>;
892
910
  providerEvent: z.ZodOptional<z.ZodCustom<unknown, unknown>>;
893
911
  }, z.core.$strict>>>;
@@ -973,13 +991,13 @@ export declare const AgentNativeContextContinuationResultSchema: z.ZodUnion<read
973
991
  operationId: z.ZodString;
974
992
  requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
975
993
  status: z.ZodEnum<{
976
- accepted: "accepted";
977
- boundary_mismatch: "boundary_mismatch";
978
994
  conflict: "conflict";
979
- replayed: "replayed";
995
+ accepted: "accepted";
980
996
  transport_failure: "transport_failure";
981
- unknown_session: "unknown_session";
997
+ replayed: "replayed";
998
+ boundary_mismatch: "boundary_mismatch";
982
999
  unverified: "unverified";
1000
+ unknown_session: "unknown_session";
983
1001
  }>;
984
1002
  historyMessagesSent: z.ZodNumber;
985
1003
  existingRequestDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
@@ -1044,8 +1062,8 @@ export declare const AgentNativeContextContinuationResultSchema: z.ZodUnion<read
1044
1062
  cost: z.ZodOptional<z.ZodNumber>;
1045
1063
  }, z.core.$strict>>;
1046
1064
  usageMode: z.ZodOptional<z.ZodEnum<{
1047
- cumulative: "cumulative";
1048
1065
  delta: "delta";
1066
+ cumulative: "cumulative";
1049
1067
  }>>;
1050
1068
  providerEvent: z.ZodOptional<z.ZodCustom<unknown, unknown>>;
1051
1069
  }, z.core.$strict>>>;
@@ -1138,13 +1156,13 @@ export declare const AgentNativeContextContinuationResultSchema: z.ZodUnion<read
1138
1156
  operationId: z.ZodString;
1139
1157
  requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
1140
1158
  status: z.ZodEnum<{
1141
- accepted: "accepted";
1142
- boundary_mismatch: "boundary_mismatch";
1143
1159
  conflict: "conflict";
1144
- replayed: "replayed";
1160
+ accepted: "accepted";
1145
1161
  transport_failure: "transport_failure";
1146
- unknown_session: "unknown_session";
1162
+ replayed: "replayed";
1163
+ boundary_mismatch: "boundary_mismatch";
1147
1164
  unverified: "unverified";
1165
+ unknown_session: "unknown_session";
1148
1166
  }>;
1149
1167
  historyMessagesSent: z.ZodNumber;
1150
1168
  existingRequestDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
@@ -1175,11 +1193,11 @@ export declare const AgentNativeContextContinuationResultSchema: z.ZodUnion<read
1175
1193
  retryable: z.ZodOptional<z.ZodBoolean>;
1176
1194
  }, z.core.$strict>, z.ZodObject<{
1177
1195
  status: z.ZodEnum<{
1178
- boundary_mismatch: "boundary_mismatch";
1179
1196
  conflict: "conflict";
1180
1197
  transport_failure: "transport_failure";
1181
- unknown_session: "unknown_session";
1198
+ boundary_mismatch: "boundary_mismatch";
1182
1199
  unverified: "unverified";
1200
+ unknown_session: "unknown_session";
1183
1201
  }>;
1184
1202
  }, z.core.$strip>>;
1185
1203
  }, z.core.$strict>]>;
@@ -1545,8 +1563,8 @@ export declare const AgentEnvironmentCapabilitiesSchema: z.ZodObject<{
1545
1563
  protocolVersion: z.ZodLiteral<1>;
1546
1564
  supportedDrivers: z.ZodArray<z.ZodString>;
1547
1565
  presentations: z.ZodArray<z.ZodEnum<{
1548
- basic: "basic";
1549
1566
  bearer: "bearer";
1567
+ basic: "basic";
1550
1568
  header: "header";
1551
1569
  query: "query";
1552
1570
  }>>;
@@ -1614,16 +1632,16 @@ export declare const AgentEnvironmentCapabilitiesSchema: z.ZodObject<{
1614
1632
  interactions: z.ZodOptional<z.ZodObject<{
1615
1633
  kinds: z.ZodArray<z.ZodString>;
1616
1634
  answerFieldTypes: z.ZodArray<z.ZodEnum<{
1617
- boolean: "boolean";
1618
1635
  number: "number";
1619
- secret: "secret";
1620
- select: "select";
1636
+ boolean: "boolean";
1621
1637
  text: "text";
1638
+ select: "select";
1639
+ secret: "secret";
1622
1640
  }>>;
1623
1641
  responseScopes: z.ZodArray<z.ZodEnum<{
1624
1642
  interaction: "interaction";
1625
- persistent: "persistent";
1626
1643
  session: "session";
1644
+ persistent: "persistent";
1627
1645
  }>>;
1628
1646
  secretAnswers: z.ZodBoolean;
1629
1647
  concurrentRequests: z.ZodBoolean;
@@ -1655,15 +1673,15 @@ export declare const AgentEnvironmentCapabilitiesSchema: z.ZodObject<{
1655
1673
  confidential: z.ZodBoolean;
1656
1674
  exactProcess: z.ZodOptional<z.ZodObject<{
1657
1675
  egress: z.ZodArray<z.ZodEnum<{
1658
- blocked: "blocked";
1659
1676
  strict: "strict";
1677
+ blocked: "blocked";
1660
1678
  }>>;
1661
1679
  }, z.core.$strict>>;
1662
1680
  create: z.ZodOptional<z.ZodObject<{
1663
1681
  egress: z.ZodOptional<z.ZodArray<z.ZodEnum<{
1664
- blocked: "blocked";
1665
1682
  open: "open";
1666
1683
  strict: "strict";
1684
+ blocked: "blocked";
1667
1685
  }>>>;
1668
1686
  durableIdempotency: z.ZodOptional<z.ZodBoolean>;
1669
1687
  billingOwner: z.ZodOptional<z.ZodBoolean>;
@@ -1674,8 +1692,8 @@ export declare const AgentEnvironmentCapabilitiesSchema: z.ZodObject<{
1674
1692
  protocolVersion: z.ZodLiteral<1>;
1675
1693
  supportedDrivers: z.ZodArray<z.ZodString>;
1676
1694
  presentations: z.ZodArray<z.ZodEnum<{
1677
- basic: "basic";
1678
1695
  bearer: "bearer";
1696
+ basic: "basic";
1679
1697
  header: "header";
1680
1698
  query: "query";
1681
1699
  }>>;
@@ -1836,37 +1854,6 @@ export interface AgentEnvironmentGetOptions {
1836
1854
  contextTransfer?: ContextTransferRequest;
1837
1855
  }
1838
1856
  export declare const AgentEnvironmentGetOptionsSchema: z.ZodObject<{
1839
- expectedProxySecretGeneration: z.ZodOptional<z.ZodNumber>;
1840
- requireInPlace: z.ZodOptional<z.ZodBoolean>;
1841
- signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
1842
- proxySecrets: z.ZodOptional<z.ZodArray<z.ZodObject<{
1843
- hosts: z.ZodReadonly<z.ZodArray<z.ZodString>>;
1844
- methods: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
1845
- paths: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
1846
- envName: z.ZodString;
1847
- secretRef: z.ZodObject<{
1848
- kind: z.ZodLiteral<"secret-ref">;
1849
- key: z.ZodString;
1850
- }, z.core.$strict>;
1851
- presentation: z.ZodDiscriminatedUnion<[z.ZodObject<{
1852
- type: z.ZodLiteral<"bearer">;
1853
- }, z.core.$strict>, z.ZodObject<{
1854
- type: z.ZodLiteral<"basic">;
1855
- username: z.ZodString;
1856
- }, z.core.$strict>, z.ZodObject<{
1857
- type: z.ZodLiteral<"header">;
1858
- name: z.ZodString;
1859
- }, z.core.$strict>, z.ZodObject<{
1860
- type: z.ZodLiteral<"query">;
1861
- name: z.ZodString;
1862
- }, z.core.$strict>], "type">;
1863
- placeholderFormat: z.ZodOptional<z.ZodEnum<{
1864
- jwt: "jwt";
1865
- opaque: "opaque";
1866
- }>>;
1867
- ttlSeconds: z.ZodOptional<z.ZodNumber>;
1868
- }, z.core.$strict>>>;
1869
- proxySecretParents: z.ZodOptional<z.ZodType<Record<string, string | null>, unknown, z.core.$ZodTypeInternals<Record<string, string | null>, unknown>>>;
1870
1857
  contextTransfer: z.ZodOptional<z.ZodObject<{
1871
1858
  operationId: z.ZodString;
1872
1859
  requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
@@ -1921,9 +1908,9 @@ export declare const AgentEnvironmentGetOptionsSchema: z.ZodObject<{
1921
1908
  parts: z.ZodArray<z.ZodObject<{
1922
1909
  partIndex: z.ZodNumber;
1923
1910
  action: z.ZodEnum<{
1911
+ transform: "transform";
1924
1912
  include: "include";
1925
1913
  omit: "omit";
1926
- transform: "transform";
1927
1914
  }>;
1928
1915
  outputDigest: z.ZodOptional<z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>>;
1929
1916
  }, z.core.$strict>>;
@@ -1946,9 +1933,9 @@ export declare const AgentEnvironmentGetOptionsSchema: z.ZodObject<{
1946
1933
  messages: z.ZodArray<z.ZodObject<{
1947
1934
  id: z.ZodString;
1948
1935
  role: z.ZodEnum<{
1936
+ user: "user";
1949
1937
  assistant: "assistant";
1950
1938
  system: "system";
1951
- user: "user";
1952
1939
  }>;
1953
1940
  parts: z.ZodArray<z.ZodCustom<unknown, unknown>>;
1954
1941
  timestamp: z.ZodISODateTime;
@@ -1972,8 +1959,8 @@ export declare const AgentEnvironmentGetOptionsSchema: z.ZodObject<{
1972
1959
  acceptedAt: z.ZodISODateTime;
1973
1960
  acceptedBy: z.ZodEnum<{
1974
1961
  policy: "policy";
1975
- system: "system";
1976
1962
  user: "user";
1963
+ system: "system";
1977
1964
  }>;
1978
1965
  }, z.core.$strict>;
1979
1966
  profile: z.ZodOptional<z.ZodObject<{
@@ -1991,13 +1978,13 @@ export declare const AgentEnvironmentGetOptionsSchema: z.ZodObject<{
1991
1978
  small: z.ZodOptional<z.ZodString>;
1992
1979
  provider: z.ZodOptional<z.ZodString>;
1993
1980
  reasoningEffort: z.ZodOptional<z.ZodEnum<{
1994
- high: "high";
1981
+ none: "none";
1982
+ minimal: "minimal";
1995
1983
  low: "low";
1996
1984
  medium: "medium";
1997
- minimal: "minimal";
1998
- none: "none";
1999
- ultracode: "ultracode";
1985
+ high: "high";
2000
1986
  xhigh: "xhigh";
1987
+ ultracode: "ultracode";
2001
1988
  }>>;
2002
1989
  maxVisibleOutputTokens: z.ZodOptional<z.ZodNumber>;
2003
1990
  maxReasoningTokens: z.ZodOptional<z.ZodNumber>;
@@ -2005,44 +1992,53 @@ export declare const AgentEnvironmentGetOptionsSchema: z.ZodObject<{
2005
1992
  metadata: z.ZodOptional<z.ZodType<Record<string, unknown>, unknown, z.core.$ZodTypeInternals<Record<string, unknown>, unknown>>>;
2006
1993
  }, z.core.$strict>>;
2007
1994
  harness: z.ZodOptional<z.ZodEnum<{
2008
- acp: "acp";
2009
- amp: "amp";
2010
1995
  "claude-code": "claude-code";
2011
- "cli-base": "cli-base";
2012
- codex: "codex";
2013
- cursor: "cursor";
2014
- "factory-droids": "factory-droids";
2015
- forge: "forge";
2016
- gemini: "gemini";
2017
- hermes: "hermes";
2018
- "kimi-code": "kimi-code";
2019
1996
  nanoclaw: "nanoclaw";
2020
- openclaw: "openclaw";
1997
+ codex: "codex";
2021
1998
  opencode: "opencode";
1999
+ "kimi-code": "kimi-code";
2022
2000
  pi: "pi";
2023
2001
  prime: "prime";
2002
+ gemini: "gemini";
2003
+ hermes: "hermes";
2004
+ openclaw: "openclaw";
2005
+ amp: "amp";
2006
+ "factory-droids": "factory-droids";
2007
+ forge: "forge";
2008
+ cursor: "cursor";
2009
+ acp: "acp";
2010
+ "cli-base": "cli-base";
2024
2011
  }>>;
2025
2012
  seats: z.ZodOptional<z.ZodArray<z.ZodObject<{
2026
2013
  harness: z.ZodEnum<{
2027
- acp: "acp";
2028
- amp: "amp";
2029
2014
  "claude-code": "claude-code";
2030
- "cli-base": "cli-base";
2031
- codex: "codex";
2032
- cursor: "cursor";
2033
- "factory-droids": "factory-droids";
2034
- forge: "forge";
2035
- gemini: "gemini";
2036
- hermes: "hermes";
2037
- "kimi-code": "kimi-code";
2038
2015
  nanoclaw: "nanoclaw";
2039
- openclaw: "openclaw";
2016
+ codex: "codex";
2040
2017
  opencode: "opencode";
2018
+ "kimi-code": "kimi-code";
2041
2019
  pi: "pi";
2042
2020
  prime: "prime";
2021
+ gemini: "gemini";
2022
+ hermes: "hermes";
2023
+ openclaw: "openclaw";
2024
+ amp: "amp";
2025
+ "factory-droids": "factory-droids";
2026
+ forge: "forge";
2027
+ cursor: "cursor";
2028
+ acp: "acp";
2029
+ "cli-base": "cli-base";
2043
2030
  }>;
2044
2031
  provider: z.ZodString;
2045
2032
  model: z.ZodString;
2033
+ reasoningEffort: z.ZodOptional<z.ZodEnum<{
2034
+ none: "none";
2035
+ minimal: "minimal";
2036
+ low: "low";
2037
+ medium: "medium";
2038
+ high: "high";
2039
+ xhigh: "xhigh";
2040
+ ultracode: "ultracode";
2041
+ }>>;
2046
2042
  selector: z.ZodUnion<readonly [z.ZodObject<{
2047
2043
  kind: z.ZodLiteral<"all-eligible">;
2048
2044
  }, z.core.$strict>, z.ZodObject<{
@@ -2058,8 +2054,8 @@ export declare const AgentEnvironmentGetOptionsSchema: z.ZodObject<{
2058
2054
  paths: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
2059
2055
  envName: z.ZodString;
2060
2056
  secretRef: z.ZodObject<{
2061
- kind: z.ZodLiteral<"secret-ref">;
2062
2057
  key: z.ZodString;
2058
+ kind: z.ZodLiteral<"secret-ref">;
2063
2059
  }, z.core.$strict>;
2064
2060
  presentation: z.ZodDiscriminatedUnion<[z.ZodObject<{
2065
2061
  type: z.ZodLiteral<"bearer">;
@@ -2189,7 +2185,7 @@ export declare const AgentEnvironmentGetOptionsSchema: z.ZodObject<{
2189
2185
  env?: Record<string, {
2190
2186
  kind: "secret-ref";
2191
2187
  key: string;
2192
- format?: "bearer" | "raw" | undefined;
2188
+ format?: "raw" | "bearer" | undefined;
2193
2189
  } | {
2194
2190
  kind: "public";
2195
2191
  value: string;
@@ -2202,7 +2198,7 @@ export declare const AgentEnvironmentGetOptionsSchema: z.ZodObject<{
2202
2198
  env?: Record<string, {
2203
2199
  kind: "secret-ref";
2204
2200
  key: string;
2205
- format?: "bearer" | "raw" | undefined;
2201
+ format?: "raw" | "bearer" | undefined;
2206
2202
  } | {
2207
2203
  kind: "public";
2208
2204
  value: string;
@@ -2326,6 +2322,37 @@ export declare const AgentEnvironmentGetOptionsSchema: z.ZodObject<{
2326
2322
  providerOptions: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
2327
2323
  }, z.core.$strict>>;
2328
2324
  }, z.core.$strict>>;
2325
+ expectedProxySecretGeneration: z.ZodOptional<z.ZodNumber>;
2326
+ requireInPlace: z.ZodOptional<z.ZodBoolean>;
2327
+ signal: z.ZodOptional<z.ZodCustom<AbortSignal, AbortSignal>>;
2328
+ proxySecrets: z.ZodOptional<z.ZodArray<z.ZodObject<{
2329
+ hosts: z.ZodReadonly<z.ZodArray<z.ZodString>>;
2330
+ methods: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
2331
+ paths: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
2332
+ envName: z.ZodString;
2333
+ secretRef: z.ZodObject<{
2334
+ key: z.ZodString;
2335
+ kind: z.ZodLiteral<"secret-ref">;
2336
+ }, z.core.$strict>;
2337
+ presentation: z.ZodDiscriminatedUnion<[z.ZodObject<{
2338
+ type: z.ZodLiteral<"bearer">;
2339
+ }, z.core.$strict>, z.ZodObject<{
2340
+ type: z.ZodLiteral<"basic">;
2341
+ username: z.ZodString;
2342
+ }, z.core.$strict>, z.ZodObject<{
2343
+ type: z.ZodLiteral<"header">;
2344
+ name: z.ZodString;
2345
+ }, z.core.$strict>, z.ZodObject<{
2346
+ type: z.ZodLiteral<"query">;
2347
+ name: z.ZodString;
2348
+ }, z.core.$strict>], "type">;
2349
+ placeholderFormat: z.ZodOptional<z.ZodEnum<{
2350
+ jwt: "jwt";
2351
+ opaque: "opaque";
2352
+ }>>;
2353
+ ttlSeconds: z.ZodOptional<z.ZodNumber>;
2354
+ }, z.core.$strict>>>;
2355
+ proxySecretParents: z.ZodOptional<z.ZodType<Record<string, string | null>, unknown, z.core.$ZodTypeInternals<Record<string, string | null>, unknown>>>;
2329
2356
  }, z.core.$strict>;
2330
2357
  /** Explicit opt-in for providers implementing side-effect-free, non-executable discovery. */
2331
2358
  export declare const AgentEnvironmentReadOnlyGetOptionsSchema: z.ZodObject<{
@@ -1,24 +1,23 @@
1
1
  import { type AgentProfileSystemPromptCapability, type ReasoningEffort } from "./agent-profile.js";
2
- import type { HarnessType } from "./harness.js";
3
- /**
4
- * The unified harness capability layer — the single source of truth for:
5
- * 1. harness ↔ model compatibility (which models a harness can run),
6
- * 2. reasoning-effort support (which thinking levels a harness/model expresses), and
7
- * 3. system-prompt intents (whether a harness can replace its own prompt, add to it, or neither).
8
- *
9
- * All are facets of the same question — "what can this (harness, model) pair actually do" — and
10
- * apply to BOTH harness-backed systems (CLIs that speak a vendor wire, like claude-code, codex and kimi-code) AND
11
- * router-backed systems (opencode, cli-base: any model the router serves). Lifted here so the
12
- * cli-bridge backends, the sandbox UI pickers, and the router all read one truth instead of each
13
- * hand-rolling a divergent copy.
14
- *
15
- * Grounded in the native CLI controls (Codex is `minimal..ultra`, Kimi is binary on/off, Claude is
16
- * `low..max`, cli-base has no agent) — NOT a guessed matrix. The
17
- * per-MODEL reasoning capability (does this specific model reason at all) is dynamic catalog data the
18
- * caller supplies.
19
- */
2
+ import { type HarnessType } from "./harness.js";
3
+ /** Canonical harness/model, effort and prompt controls. Model-specific capability comes from the serving catalog. */
20
4
  /** low → high. `none` = thinking off; `ultracode` = max (claude-code mode). */
21
5
  export declare const reasoningLadder: readonly ReasoningEffort[];
6
+ /** A command's model selector, before account or serving-catalog resolution. */
7
+ export interface SeatSpec {
8
+ readonly harness: HarnessType;
9
+ readonly model: string;
10
+ readonly provider: string | null;
11
+ readonly reasoningEffort?: ReasoningEffort;
12
+ }
13
+ export declare class SeatSpecError extends Error {
14
+ readonly code: "SEAT_SYNTAX" | "UNKNOWN_HARNESS" | "SEAT_EFFORT_UNSUPPORTED" | "MODEL_PROVIDER_MISMATCH";
15
+ constructor(code: "SEAT_SYNTAX" | "UNKNOWN_HARNESS" | "SEAT_EFFORT_UNSUPPORTED" | "MODEL_PROVIDER_MISMATCH", message: string);
16
+ }
17
+ /** Parse harness/model[@effort] without credentials, account selection or model substitution. */
18
+ export declare function parseSeatSpec(value: string): SeatSpec;
19
+ /** Preserve the authored model and distinguish inherited effort from explicit none. */
20
+ export declare function formatSeatSpec(seat: Pick<SeatSpec, "harness" | "model" | "reasoningEffort">): string;
22
21
  /** Provider prefix of a canonical model id (`anthropic/claude-…` → `anthropic`), or null. */
23
22
  export declare function modelProvider(modelId: string): string | null;
24
23
  /**