@tangle-network/agent-interface 2.20.1 → 3.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.
Files changed (58) hide show
  1. package/README.md +18 -23
  2. package/dist/agent-candidate-artifact-schema.d.ts +0 -4
  3. package/dist/agent-candidate-artifact-schema.js +1 -1
  4. package/dist/agent-candidate-execution-plan-schema.d.ts +52 -52
  5. package/dist/agent-candidate-promotion-schema.d.ts +340 -340
  6. package/dist/agent-candidate-receipt-schema.d.ts +68 -68
  7. package/dist/agent-candidate-schema-common.d.ts +0 -5
  8. package/dist/agent-candidate-schema-common.js +0 -27
  9. package/dist/agent-execution-limits.d.ts +0 -18
  10. package/dist/agent-execution-limits.js +0 -21
  11. package/dist/agent-execution-preparation-receipt.d.ts +2 -0
  12. package/dist/agent-execution-preparation.d.ts +2 -22
  13. package/dist/agent-execution-preparation.js +1 -25
  14. package/dist/agent-improvement-measurement-schema.d.ts +0 -17
  15. package/dist/agent-improvement-measurement-schema.js +3 -3
  16. package/dist/agent-improvement-source.d.ts +0 -2
  17. package/dist/agent-profile-materialization.d.ts +1 -1
  18. package/dist/agent-profile-materialization.js +3 -0
  19. package/dist/agent-profile.d.ts +22 -0
  20. package/dist/agent-workspace-lease.d.ts +0 -23
  21. package/dist/agent-workspace-lease.js +0 -4
  22. package/dist/contract-limits.d.ts +0 -3
  23. package/dist/contract-limits.js +0 -10
  24. package/dist/environment-interactive-control.d.ts +10 -0
  25. package/dist/environment-interactive-start.d.ts +28 -2
  26. package/dist/environment-interactive-start.js +1 -1
  27. package/dist/environment-observation.d.ts +0 -17
  28. package/dist/environment-observation.js +0 -13
  29. package/dist/environment-provider.d.ts +2 -1
  30. package/dist/environment-provider.js +2 -1
  31. package/dist/environment-runtime.d.ts +30 -16
  32. package/dist/environment-runtime.js +1 -5
  33. package/dist/index.d.ts +1 -3
  34. package/dist/index.js +1 -3
  35. package/dist/interaction-fields.d.ts +0 -1
  36. package/dist/interaction-response-validation.d.ts +0 -5
  37. package/dist/interaction-response-validation.js +0 -12
  38. package/dist/parts.d.ts +0 -3
  39. package/dist/parts.js +0 -9
  40. package/dist/plan.d.ts +0 -8
  41. package/dist/plan.js +0 -6
  42. package/dist/profile-diff.d.ts +2 -2
  43. package/dist/profile-diff.js +3 -31
  44. package/dist/profile-kb/index.d.ts +1 -22
  45. package/dist/profile-kb/index.js +1 -23
  46. package/dist/profile-schema.d.ts +58 -0
  47. package/dist/profile-schema.js +45 -0
  48. package/dist/runtime-control.d.ts +0 -61
  49. package/dist/runtime-control.js +0 -76
  50. package/dist/workspace-confidentiality.d.ts +0 -2
  51. package/dist/workspace-confidentiality.js +1 -1
  52. package/package.json +1 -11
  53. package/dist/agent-instance.d.ts +0 -98
  54. package/dist/agent-instance.js +0 -105
  55. package/dist/certified-context.d.ts +0 -118
  56. package/dist/certified-context.js +0 -220
  57. package/dist/environment-interactive.d.ts +0 -2
  58. package/dist/environment-interactive.js +0 -2
@@ -25,6 +25,7 @@ export const AGENT_PROFILE_MATERIALIZATION_AXES = [
25
25
  "modelMaxTotalOutputTokens",
26
26
  "modelMetadata",
27
27
  "harness",
28
+ "seats",
28
29
  "permissions",
29
30
  "tools",
30
31
  "mcp",
@@ -47,6 +48,7 @@ const profileProperties = [
47
48
  "prompt",
48
49
  "model",
49
50
  "harness",
51
+ "seats",
50
52
  "permissions",
51
53
  "tools",
52
54
  "mcp",
@@ -101,6 +103,7 @@ const AXIS_DESCRIPTORS = [
101
103
  value: (profile) => profile.model?.[property],
102
104
  })),
103
105
  { axis: "harness", rootPath: "/harness", value: (profile) => profile.harness },
106
+ { axis: "seats", rootPath: "/seats", value: (profile) => profile.seats },
104
107
  {
105
108
  axis: "permissions",
106
109
  rootPath: "/permissions",
@@ -148,6 +148,22 @@ export interface AgentProfileModelHints {
148
148
  */
149
149
  metadata?: Record<string, unknown>;
150
150
  }
151
+ /** An authored subscription choice. The executor resolves account availability at run time. */
152
+ export interface AgentProfileSeat {
153
+ /** Exact harness to use for this segment. */
154
+ harness: HarnessType;
155
+ /** Provider that must serve `model`; a different provider requires another stage. */
156
+ provider: string;
157
+ /** Exact model requested from this provider. */
158
+ model: string;
159
+ /** Select all eligible accounts in account-manager order, or one named account. */
160
+ selector: {
161
+ kind: "all-eligible";
162
+ } | {
163
+ kind: "seat";
164
+ id: string;
165
+ };
166
+ }
151
167
  /**
152
168
  * Prompt shaping for an agent.
153
169
  *
@@ -413,6 +429,12 @@ export interface AgentProfile {
413
429
  * loop optimize harness routing as a first-class lever.
414
430
  */
415
431
  harness?: HarnessType;
432
+ /**
433
+ * Ordered, authored subscription chain for one logical agent. The first
434
+ * stage must match `harness`, `model.provider`, and `model.default` above.
435
+ * Omission preserves the existing single-provider execution policy.
436
+ */
437
+ seats?: AgentProfileSeat[];
416
438
  permissions?: Record<string, AgentProfilePermission>;
417
439
  tools?: Record<string, boolean>;
418
440
  mcp?: Record<string, AgentProfileMcpServer>;
@@ -78,29 +78,8 @@ type WithDigest<Material> = Material extends unknown ? Material & {
78
78
  } : never;
79
79
  /** Self-hashed public projection. Private authorization and durable state stay out. */
80
80
  export type AgentWorkspaceLeaseRecord = WithDigest<AgentWorkspaceLeaseRecordMaterial>;
81
- export type AgentWorkspaceCopyReadyLeaseRecord = WithDigest<AgentWorkspaceCopyReadyLeaseRecordMaterial>;
82
81
  export type AgentWorkspaceSealedLeaseRecord = WithDigest<AgentWorkspaceSealedLeaseRecordMaterial>;
83
82
  export type AgentWorkspaceExecutionBoundLeaseRecord = WithDigest<AgentWorkspaceExecutionBoundLeaseRecordMaterial>;
84
- export type AgentWorkspaceDestroyingLeaseRecord = WithDigest<AgentWorkspaceDestroyingLeaseRecordMaterial>;
85
- export type AgentWorkspaceCleanupFailedLeaseRecord = WithDigest<AgentWorkspaceCleanupFailedLeaseRecordMaterial>;
86
- export type AgentWorkspaceDestroyedLeaseRecord = WithDigest<AgentWorkspaceDestroyedLeaseRecordMaterial>;
87
- /**
88
- * Request-only owner capability. Providers persist at most a one-way digest;
89
- * this value never belongs in a public lease or execution receipt.
90
- */
91
- export interface AgentWorkspaceLeaseAuthorization {
92
- leaseId: string;
93
- ownerToken: string;
94
- }
95
- export interface AgentWorkspaceSealRequest extends AgentWorkspaceLeaseAuthorization {
96
- profileActivationDigest: Sha256Digest;
97
- }
98
- export interface AgentWorkspaceExecutionBindingRequest extends AgentWorkspaceLeaseAuthorization {
99
- executionPreparationDigest: Sha256Digest;
100
- }
101
- export interface AgentWorkspaceLeaseRenewalRequest extends AgentWorkspaceLeaseAuthorization {
102
- expiresAtMs: number;
103
- }
104
83
  export declare const agentWorkspaceLeasePhaseSchema: z.ZodEnum<{
105
84
  "cleanup-failed": "cleanup-failed";
106
85
  "copy-ready": "copy-ready";
@@ -116,7 +95,5 @@ export declare const agentWorkspaceAllocationIdentitySchema: z.ZodObject<{
116
95
  }, z.core.$strict>;
117
96
  export declare const agentWorkspaceLeaseRecordMaterialSchema: z.ZodType<AgentWorkspaceLeaseRecordMaterial>;
118
97
  export declare const agentWorkspaceLeaseRecordSchema: z.ZodType<AgentWorkspaceLeaseRecord>;
119
- /** Canonical public identity; private token/state fields cannot enter its schema. */
120
- export declare function canonicalAgentWorkspaceLeaseRecordDigest(material: AgentWorkspaceLeaseRecordMaterial): Sha256Digest;
121
98
  /** Build and self-hash one phase-valid public workspace lease record. */
122
99
  export declare function buildAgentWorkspaceLeaseRecord<Material extends AgentWorkspaceLeaseRecordMaterial>(material: Material): WithDigest<Material>;
@@ -92,10 +92,6 @@ export const agentWorkspaceLeaseRecordSchema = z
92
92
  }
93
93
  })
94
94
  .transform((record) => record);
95
- /** Canonical public identity; private token/state fields cannot enter its schema. */
96
- export function canonicalAgentWorkspaceLeaseRecordDigest(material) {
97
- return canonicalCandidateDigest(agentWorkspaceLeaseRecordMaterialSchema.parse(material));
98
- }
99
95
  /** Build and self-hash one phase-valid public workspace lease record. */
100
96
  export function buildAgentWorkspaceLeaseRecord(material) {
101
97
  const parsed = agentWorkspaceLeaseRecordMaterialSchema.parse(material);
@@ -37,6 +37,3 @@ export declare const boundedEventContentRecordSchema: z.ZodCustom<Record<string,
37
37
  export declare const boundedEventContentStringSchema: z.ZodCustom<string, string>;
38
38
  export declare function assertBoundedJson(value: unknown): void;
39
39
  export declare function assertBoundedSerializedJson(value: string): void;
40
- /** Copy arbitrary metadata into a map that cannot inherit prototype keys. */
41
- export declare function nullPrototypeRecord<T>(value: Record<string, T>): Record<string, T>;
42
- export declare function hasOwn(value: object, key: PropertyKey): boolean;
@@ -331,13 +331,3 @@ export function assertBoundedSerializedJson(value) {
331
331
  throw new Error("serialized contract material exceeds its byte bound");
332
332
  }
333
333
  }
334
- /** Copy arbitrary metadata into a map that cannot inherit prototype keys. */
335
- export function nullPrototypeRecord(value) {
336
- const result = Object.create(null);
337
- for (const key of Object.keys(value))
338
- result[key] = value[key];
339
- return result;
340
- }
341
- export function hasOwn(value, key) {
342
- return Object.prototype.hasOwnProperty.call(value, key);
343
- }
@@ -119,6 +119,7 @@ export declare const AgentInteractiveSessionRefSchema: z.ZodObject<{
119
119
  resourceFailOnError: "resourceFailOnError";
120
120
  resourceInstructions: "resourceInstructions";
121
121
  resourceTools: "resourceTools";
122
+ seats: "seats";
122
123
  skills: "skills";
123
124
  subagents: "subagents";
124
125
  systemPrompt: "systemPrompt";
@@ -294,6 +295,7 @@ export declare const AgentInteractiveSessionControlClaimRequestSchema: z.ZodObje
294
295
  resourceFailOnError: "resourceFailOnError";
295
296
  resourceInstructions: "resourceInstructions";
296
297
  resourceTools: "resourceTools";
298
+ seats: "seats";
297
299
  skills: "skills";
298
300
  subagents: "subagents";
299
301
  systemPrompt: "systemPrompt";
@@ -462,6 +464,7 @@ export declare const AgentInteractiveSessionControlClaimAcknowledgementSchema: z
462
464
  resourceFailOnError: "resourceFailOnError";
463
465
  resourceInstructions: "resourceInstructions";
464
466
  resourceTools: "resourceTools";
467
+ seats: "seats";
465
468
  skills: "skills";
466
469
  subagents: "subagents";
467
470
  systemPrompt: "systemPrompt";
@@ -651,6 +654,7 @@ export declare const AgentInteractiveSessionStatusSchema: z.ZodDiscriminatedUnio
651
654
  resourceFailOnError: "resourceFailOnError";
652
655
  resourceInstructions: "resourceInstructions";
653
656
  resourceTools: "resourceTools";
657
+ seats: "seats";
654
658
  skills: "skills";
655
659
  subagents: "subagents";
656
660
  systemPrompt: "systemPrompt";
@@ -799,6 +803,7 @@ export declare const AgentInteractiveSessionStatusSchema: z.ZodDiscriminatedUnio
799
803
  resourceFailOnError: "resourceFailOnError";
800
804
  resourceInstructions: "resourceInstructions";
801
805
  resourceTools: "resourceTools";
806
+ seats: "seats";
802
807
  skills: "skills";
803
808
  subagents: "subagents";
804
809
  systemPrompt: "systemPrompt";
@@ -955,6 +960,7 @@ export declare const AgentInteractiveSessionStatusSchema: z.ZodDiscriminatedUnio
955
960
  resourceFailOnError: "resourceFailOnError";
956
961
  resourceInstructions: "resourceInstructions";
957
962
  resourceTools: "resourceTools";
963
+ seats: "seats";
958
964
  skills: "skills";
959
965
  subagents: "subagents";
960
966
  systemPrompt: "systemPrompt";
@@ -1116,6 +1122,7 @@ export declare const AgentInteractiveSessionStopCommandSchema: z.ZodObject<{
1116
1122
  resourceFailOnError: "resourceFailOnError";
1117
1123
  resourceInstructions: "resourceInstructions";
1118
1124
  resourceTools: "resourceTools";
1125
+ seats: "seats";
1119
1126
  skills: "skills";
1120
1127
  subagents: "subagents";
1121
1128
  systemPrompt: "systemPrompt";
@@ -1286,6 +1293,7 @@ export declare const AgentInteractiveSessionStopAcknowledgementSchema: z.ZodObje
1286
1293
  resourceFailOnError: "resourceFailOnError";
1287
1294
  resourceInstructions: "resourceInstructions";
1288
1295
  resourceTools: "resourceTools";
1296
+ seats: "seats";
1289
1297
  skills: "skills";
1290
1298
  subagents: "subagents";
1291
1299
  systemPrompt: "systemPrompt";
@@ -1472,6 +1480,7 @@ export declare const AgentInteractiveSessionPromptCommandSchema: z.ZodObject<{
1472
1480
  resourceFailOnError: "resourceFailOnError";
1473
1481
  resourceInstructions: "resourceInstructions";
1474
1482
  resourceTools: "resourceTools";
1483
+ seats: "seats";
1475
1484
  skills: "skills";
1476
1485
  subagents: "subagents";
1477
1486
  systemPrompt: "systemPrompt";
@@ -1641,6 +1650,7 @@ export declare const AgentInteractiveSessionPromptAcknowledgementSchema: z.ZodOb
1641
1650
  resourceFailOnError: "resourceFailOnError";
1642
1651
  resourceInstructions: "resourceInstructions";
1643
1652
  resourceTools: "resourceTools";
1653
+ seats: "seats";
1644
1654
  skills: "skills";
1645
1655
  subagents: "subagents";
1646
1656
  systemPrompt: "systemPrompt";
@@ -70,6 +70,34 @@ export declare const AgentInteractiveSessionStartSchema: z.ZodObject<{
70
70
  pi: "pi";
71
71
  prime: "prime";
72
72
  }>>;
73
+ seats: z.ZodOptional<z.ZodArray<z.ZodObject<{
74
+ harness: z.ZodEnum<{
75
+ acp: "acp";
76
+ amp: "amp";
77
+ "claude-code": "claude-code";
78
+ "cli-base": "cli-base";
79
+ codex: "codex";
80
+ cursor: "cursor";
81
+ "factory-droids": "factory-droids";
82
+ forge: "forge";
83
+ gemini: "gemini";
84
+ hermes: "hermes";
85
+ "kimi-code": "kimi-code";
86
+ nanoclaw: "nanoclaw";
87
+ openclaw: "openclaw";
88
+ opencode: "opencode";
89
+ pi: "pi";
90
+ prime: "prime";
91
+ }>;
92
+ provider: z.ZodString;
93
+ model: z.ZodString;
94
+ selector: z.ZodUnion<readonly [z.ZodObject<{
95
+ kind: z.ZodLiteral<"all-eligible">;
96
+ }, z.core.$strict>, z.ZodObject<{
97
+ kind: z.ZodLiteral<"seat">;
98
+ id: z.ZodString;
99
+ }, z.core.$strict>]>;
100
+ }, z.core.$strict>>>;
73
101
  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>>>;
74
102
  tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
75
103
  mcp: z.ZodOptional<z.ZodType<Record<string, import("./agent-profile.js").AgentProfileMcpServer>, unknown, z.core.$ZodTypeInternals<Record<string, import("./agent-profile.js").AgentProfileMcpServer>, unknown>>>;
@@ -228,8 +256,6 @@ export declare const AgentInteractiveSessionStartSchema: z.ZodObject<{
228
256
  }, z.core.$strict>;
229
257
  export type AgentInteractiveSessionStart = z.infer<typeof AgentInteractiveSessionStartSchema>;
230
258
  export type AgentInteractiveSessionStartInput = Omit<AgentInteractiveSessionStart, "run">;
231
- /** Digest the exact process-start request independently of its derived run id. */
232
- export declare function agentInteractiveSessionRequestDigest(coordinates: AgentInteractiveSessionRunCoordinates, input: AgentInteractiveSessionStartInput): `sha256:${string}`;
233
259
  /** Mint the one exact run reference a provider must acknowledge for this start. */
234
260
  export declare function agentInteractiveSessionRunRef(coordinates: AgentInteractiveSessionRunCoordinates, input: AgentInteractiveSessionStartInput): AgentExactRunControlRef;
235
261
  /** Parse a start request and prove its profile identity before provider work. */
@@ -31,7 +31,7 @@ export const AgentInteractiveSessionStartSchema = z.strictObject({
31
31
  rows: interactiveDimensionSchema.optional(),
32
32
  });
33
33
  /** Digest the exact process-start request independently of its derived run id. */
34
- export function agentInteractiveSessionRequestDigest(coordinates, input) {
34
+ function agentInteractiveSessionRequestDigest(coordinates, input) {
35
35
  const exactCoordinates = AgentInteractiveSessionRunCoordinatesSchema.parse(coordinates);
36
36
  const exactInput = AgentInteractiveSessionStartSchema.omit({ run: true }).parse(input);
37
37
  return canonicalCandidateDigest({
@@ -1,18 +1,4 @@
1
1
  import { z } from "zod";
2
- /**
3
- * Freshness discriminator for one observed value. A missing value never reads
4
- * as a measured zero: a value exists only on `known` and `stale`, so the
5
- * absence of a number is always visible as `unavailable`, `redacted`, or
6
- * `unknown`.
7
- */
8
- export type ObservationState = "known" | "stale" | "unavailable" | "redacted" | "unknown";
9
- export declare const ObservationStateSchema: z.ZodEnum<{
10
- known: "known";
11
- redacted: "redacted";
12
- stale: "stale";
13
- unavailable: "unavailable";
14
- unknown: "unknown";
15
- }>;
16
2
  /** How a known or stale value was obtained, and when. */
17
3
  export interface ObservationProvenance {
18
4
  origin: "measured" | "reported" | "estimated";
@@ -374,7 +360,6 @@ export declare const AccountUsageSchema: z.ZodObject<{
374
360
  state: z.ZodLiteral<"unknown">;
375
361
  }, z.core.$strict>], "state">>;
376
362
  }, z.core.$strict>;
377
- export type AccountUsage = z.infer<typeof AccountUsageSchema>;
378
363
  /**
379
364
  * Optional normalized observation of one execution environment.
380
365
  *
@@ -1072,5 +1057,3 @@ export declare function agentEnvironmentObservationIdentityMatches(live: AgentEn
1072
1057
  * tests use this to prove the observation surface never transports a secret.
1073
1058
  */
1074
1059
  export declare function observationContainsCredential(value: unknown): boolean;
1075
- /** Throw when an observation payload carries a credential. */
1076
- export declare function assertObservationCredentialFree(value: unknown): void;
@@ -1,12 +1,5 @@
1
1
  import { z } from "zod";
2
2
  import { boundedIdentifierSchema, boundedStringSchema, } from "./contract-limits.js";
3
- export const ObservationStateSchema = z.enum([
4
- "known",
5
- "stale",
6
- "unavailable",
7
- "redacted",
8
- "unknown",
9
- ]);
10
3
  export const ObservationProvenanceSchema = z.strictObject({
11
4
  origin: z.enum(["measured", "reported", "estimated"]),
12
5
  observedAt: z.iso.datetime().max(64),
@@ -298,9 +291,3 @@ export function observationContainsCredential(value) {
298
291
  }
299
292
  return false;
300
293
  }
301
- /** Throw when an observation payload carries a credential. */
302
- export function assertObservationCredentialFree(value) {
303
- if (observationContainsCredential(value)) {
304
- throw new Error("observation payload must not carry a credential");
305
- }
306
- }
@@ -1,7 +1,8 @@
1
1
  export { AgentEnvironmentEgressPolicySchema } from "./environment-requests.js";
2
2
  export * from "./environment-requests.js";
3
3
  export * from "./environment-exact-process.js";
4
- export * from "./environment-interactive.js";
4
+ export * from "./environment-interactive-control.js";
5
+ export * from "./environment-interactive-start.js";
5
6
  export * from "./environment-observation.js";
6
7
  export * from "./environment-terminal.js";
7
8
  export * from "./environment-runtime.js";
@@ -1,7 +1,8 @@
1
1
  export { AgentEnvironmentEgressPolicySchema } from "./environment-requests.js";
2
2
  export * from "./environment-requests.js";
3
3
  export * from "./environment-exact-process.js";
4
- export * from "./environment-interactive.js";
4
+ export * from "./environment-interactive-control.js";
5
+ export * from "./environment-interactive-start.js";
5
6
  export * from "./environment-observation.js";
6
7
  export * from "./environment-terminal.js";
7
8
  export * from "./environment-runtime.js";
@@ -13,7 +13,8 @@ import type { AgentWorkspaceBranching, AgentWorkspaceBranchingProvider } from ".
13
13
  import type { AgentEnvironmentEgressMode, AgentEnvironmentEgressPolicy, AgentEnvironmentQuery, AgentEnvironmentStatus, AgentEnvironmentSummary, AgentProfileRef, AgentSessionStatus, CheckpointRef, CheckpointRequest, ExecRequest, ExecResult, ForkRequest, PlacementInfo, ResourceRequest, WorkspaceRequest } from "./environment-requests.js";
14
14
  import type { AgentExactProcessEgressMode, AgentExactProcessProvider } from "./environment-exact-process.js";
15
15
  import type { AgentEnvironmentObservation } from "./environment-observation.js";
16
- import type { AgentInteractiveSession, AgentInteractiveSessionRef, AgentInteractiveSessionStart } from "./environment-interactive.js";
16
+ import type { AgentInteractiveSession, AgentInteractiveSessionRef } from "./environment-interactive-control.js";
17
+ import type { AgentInteractiveSessionStart } from "./environment-interactive-start.js";
17
18
  import type { AgentTerminalSession, TerminalAttachRequest, TerminalAttachResult } from "./environment-terminal.js";
18
19
  export interface AgentTurnInput {
19
20
  /** Exact behavior for this turn, separate from bounded provider metadata. */
@@ -86,6 +87,34 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
86
87
  pi: "pi";
87
88
  prime: "prime";
88
89
  }>>;
90
+ seats: z.ZodOptional<z.ZodArray<z.ZodObject<{
91
+ harness: z.ZodEnum<{
92
+ acp: "acp";
93
+ amp: "amp";
94
+ "claude-code": "claude-code";
95
+ "cli-base": "cli-base";
96
+ codex: "codex";
97
+ cursor: "cursor";
98
+ "factory-droids": "factory-droids";
99
+ forge: "forge";
100
+ gemini: "gemini";
101
+ hermes: "hermes";
102
+ "kimi-code": "kimi-code";
103
+ nanoclaw: "nanoclaw";
104
+ openclaw: "openclaw";
105
+ opencode: "opencode";
106
+ pi: "pi";
107
+ prime: "prime";
108
+ }>;
109
+ provider: z.ZodString;
110
+ model: z.ZodString;
111
+ selector: z.ZodUnion<readonly [z.ZodObject<{
112
+ kind: z.ZodLiteral<"all-eligible">;
113
+ }, z.core.$strict>, z.ZodObject<{
114
+ kind: z.ZodLiteral<"seat">;
115
+ id: z.ZodString;
116
+ }, z.core.$strict>]>;
117
+ }, z.core.$strict>>>;
89
118
  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>>>;
90
119
  tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
91
120
  mcp: z.ZodOptional<z.ZodType<Record<string, import("./agent-profile.js").AgentProfileMcpServer>, unknown, z.core.$ZodTypeInternals<Record<string, import("./agent-profile.js").AgentProfileMcpServer>, unknown>>>;
@@ -899,10 +928,6 @@ export interface AgentSession {
899
928
  * whose creation it cannot prove, because another caller can hold it.
900
929
  */
901
930
  export type AgentEnvironmentCreation = "created" | "replayed";
902
- export declare const AgentEnvironmentCreationSchema: z.ZodEnum<{
903
- created: "created";
904
- replayed: "replayed";
905
- }>;
906
931
  export interface AgentEnvironment {
907
932
  readonly id: string;
908
933
  readonly provider: string;
@@ -1330,17 +1355,6 @@ export interface AgentEnvironmentCreateIdempotencyRecord<T> {
1330
1355
  readonly pending: Promise<T>;
1331
1356
  environment?: T;
1332
1357
  }
1333
- /**
1334
- * Return the per-call view of an environment that a same-key create replayed.
1335
- *
1336
- * The view shares every member of the environment, so operations act on the
1337
- * one environment, and it states `creation: "replayed"` because this call
1338
- * provisioned nothing. The copy is shallow, so the environment must be a plain
1339
- * object whose members do not read `this`; a class instance loses its
1340
- * prototype members in a copy and is rejected.
1341
- * @internal
1342
- */
1343
- export declare function replayedAgentEnvironmentView<T extends object>(environment: T): T;
1344
1358
  /**
1345
1359
  * Apply the generic create contract to one provider adapter's keyed requests.
1346
1360
  *
@@ -158,10 +158,6 @@ export function agentNativeContextContinuationResultMatchesRequest(request, outc
158
158
  (exactOutcome.result.sessionId === undefined ||
159
159
  exactOutcome.result.sessionId === current.sessionId));
160
160
  }
161
- export const AgentEnvironmentCreationSchema = z.enum([
162
- "created",
163
- "replayed",
164
- ]);
165
161
  /** Strict runtime validator for provider capability negotiation. */
166
162
  export const AgentEnvironmentCapabilitiesSchema = z
167
163
  .strictObject({
@@ -451,7 +447,7 @@ export function agentEnvironmentCreateInputDigest(input) {
451
447
  * prototype members in a copy and is rejected.
452
448
  * @internal
453
449
  */
454
- export function replayedAgentEnvironmentView(environment) {
450
+ function replayedAgentEnvironmentView(environment) {
455
451
  const prototype = Object.getPrototypeOf(environment);
456
452
  if (prototype !== Object.prototype && prototype !== null) {
457
453
  throw new Error("a replayed agent environment view requires a plain object environment");
package/dist/index.d.ts CHANGED
@@ -9,7 +9,7 @@ export * from "./host-services.js";
9
9
  export * from "./mcp.js";
10
10
  export * from "./provider-adapter.js";
11
11
  export type * from "./environment-provider.js";
12
- export { AgentEnvironmentCapabilitiesSchema, AgentRuntimeAttachmentsSchema, AgentNativeContextContinuationAdmissionSchema, AgentNativeContextContinuationResultSchema, AgentTurnInputSchema, AgentTurnResultSchema, agentEnvironmentCreateInputDigest, agentNativeContextContinuationAdmissionMatchesRequest, agentNativeContextContinuationResultMatchesRequest, AccountUsageSchema, AgentEnvironmentObservationSchema, AgentEnvironmentStatusSchema, ComputeBillingSchema, EnvironmentLifecycleSchema, ModelUsageSchema, ObservationProvenanceSchema, ObservationStateSchema, PlacementDescriptorSchema, ProviderIdentitySchema, ResourceProfileSchema, ResourceUseSampleSchema, SafeEndpointSchema, agentEnvironmentObservationIdentityMatches, assertObservationCredentialFree, observationContainsCredential, observationOf, AgentInteractiveSessionAttachSchema, AgentInteractiveSessionControlClaimAcknowledgementSchema, AgentInteractiveSessionControlClaimRequestSchema, AgentInteractiveSessionControlClaimSchema, AgentInteractiveSessionPromptAcknowledgementSchema, AgentInteractiveSessionPromptCommandSchema, AgentInteractiveSessionRefSchema, AgentInteractiveSessionStartSchema, AgentInteractiveSessionStopAcknowledgementSchema, AgentInteractiveSessionStopCommandSchema, AgentInteractiveSessionStatusSchema, agentInteractiveSessionControlClaimAcknowledgementMatchesRequest, agentInteractiveSessionControlClaimRequestDigest, agentInteractiveSessionControlClaimMatchesRef, agentInteractiveSessionControlClaimIsNewer, agentInteractiveSessionPromptAcknowledgementMatchesCommand, agentInteractiveSessionPromptRequestDigest, agentInteractiveSessionStopAcknowledgementMatchesCommand, agentInteractiveSessionStopRequestDigest, agentInteractiveSessionRequestDigest, agentInteractiveSessionRefMatchesStart, agentInteractiveSessionRunRef, agentInteractiveSessionStatusMatchesRef, exactAgentInteractiveSessionStart, AgentEnvironmentCreationSchema, createAgentEnvironmentWithIdempotency, replayedAgentEnvironmentView, canonicalWorkspaceCwd, MAX_WORKSPACE_CWD_LENGTH, workspaceCwdSchema, workspaceCwdPathForBase, WorkspaceRequestSchema, TerminalAttachRequestSchema, TerminalAttachResultSchema, TerminalDetachAckSchema, TerminalInputSchema, TerminalOutputEventSchema, TerminalReplayWindowSchema, TerminalResizeSchema, TerminalSessionRefSchema, terminalAttachResultMatchesRequest, terminalSessionUsable, } from "./environment-provider.js";
12
+ export { AgentEnvironmentCapabilitiesSchema, AgentRuntimeAttachmentsSchema, AgentNativeContextContinuationAdmissionSchema, AgentNativeContextContinuationResultSchema, AgentTurnInputSchema, AgentTurnResultSchema, agentEnvironmentCreateInputDigest, agentNativeContextContinuationAdmissionMatchesRequest, agentNativeContextContinuationResultMatchesRequest, AccountUsageSchema, AgentEnvironmentObservationSchema, AgentEnvironmentStatusSchema, ComputeBillingSchema, EnvironmentLifecycleSchema, ModelUsageSchema, ObservationProvenanceSchema, PlacementDescriptorSchema, ProviderIdentitySchema, ResourceProfileSchema, ResourceUseSampleSchema, SafeEndpointSchema, agentEnvironmentObservationIdentityMatches, observationContainsCredential, observationOf, AgentInteractiveSessionAttachSchema, AgentInteractiveSessionControlClaimAcknowledgementSchema, AgentInteractiveSessionControlClaimRequestSchema, AgentInteractiveSessionControlClaimSchema, AgentInteractiveSessionPromptAcknowledgementSchema, AgentInteractiveSessionPromptCommandSchema, AgentInteractiveSessionRefSchema, AgentInteractiveSessionStartSchema, AgentInteractiveSessionStopAcknowledgementSchema, AgentInteractiveSessionStopCommandSchema, AgentInteractiveSessionStatusSchema, agentInteractiveSessionControlClaimAcknowledgementMatchesRequest, agentInteractiveSessionControlClaimRequestDigest, agentInteractiveSessionControlClaimMatchesRef, agentInteractiveSessionControlClaimIsNewer, agentInteractiveSessionPromptAcknowledgementMatchesCommand, agentInteractiveSessionPromptRequestDigest, agentInteractiveSessionStopAcknowledgementMatchesCommand, agentInteractiveSessionStopRequestDigest, agentInteractiveSessionRefMatchesStart, agentInteractiveSessionRunRef, agentInteractiveSessionStatusMatchesRef, exactAgentInteractiveSessionStart, createAgentEnvironmentWithIdempotency, canonicalWorkspaceCwd, MAX_WORKSPACE_CWD_LENGTH, workspaceCwdSchema, workspaceCwdPathForBase, WorkspaceRequestSchema, TerminalAttachRequestSchema, TerminalAttachResultSchema, TerminalDetachAckSchema, TerminalInputSchema, TerminalOutputEventSchema, TerminalReplayWindowSchema, TerminalResizeSchema, TerminalSessionRefSchema, terminalAttachResultMatchesRequest, terminalSessionUsable, } from "./environment-provider.js";
13
13
  export * from "./plan.js";
14
14
  export * from "./runtime-control.js";
15
15
  export * from "./portable-context.js";
@@ -27,14 +27,12 @@ export * from "./agent-profile-improvement.js";
27
27
  export * from "./agent-profile-improvement-schema.js";
28
28
  export * from "./agent-execution-limits.js";
29
29
  export * from "./agent-profile.js";
30
- export * from "./agent-instance.js";
31
30
  export * from "./agent-profile-snapshot.js";
32
31
  export * from "./agent-profile-activation.js";
33
32
  export * from "./agent-profile-materialization.js";
34
33
  export * from "./agent-profile-measurements.js";
35
34
  export * from "./agent-execution-preparation.js";
36
35
  export * from "./agent-workspace-lease.js";
37
- export * from "./certified-context.js";
38
36
  export * from "./deep-freeze.js";
39
37
  export * from "./profile-diff.js";
40
38
  export * from "./harness.js";
package/dist/index.js CHANGED
@@ -8,7 +8,7 @@ export * from "./provider-config.js";
8
8
  export * from "./host-services.js";
9
9
  export * from "./mcp.js";
10
10
  export * from "./provider-adapter.js";
11
- export { AgentEnvironmentCapabilitiesSchema, AgentRuntimeAttachmentsSchema, AgentNativeContextContinuationAdmissionSchema, AgentNativeContextContinuationResultSchema, AgentTurnInputSchema, AgentTurnResultSchema, agentEnvironmentCreateInputDigest, agentNativeContextContinuationAdmissionMatchesRequest, agentNativeContextContinuationResultMatchesRequest, AccountUsageSchema, AgentEnvironmentObservationSchema, AgentEnvironmentStatusSchema, ComputeBillingSchema, EnvironmentLifecycleSchema, ModelUsageSchema, ObservationProvenanceSchema, ObservationStateSchema, PlacementDescriptorSchema, ProviderIdentitySchema, ResourceProfileSchema, ResourceUseSampleSchema, SafeEndpointSchema, agentEnvironmentObservationIdentityMatches, assertObservationCredentialFree, observationContainsCredential, observationOf, AgentInteractiveSessionAttachSchema, AgentInteractiveSessionControlClaimAcknowledgementSchema, AgentInteractiveSessionControlClaimRequestSchema, AgentInteractiveSessionControlClaimSchema, AgentInteractiveSessionPromptAcknowledgementSchema, AgentInteractiveSessionPromptCommandSchema, AgentInteractiveSessionRefSchema, AgentInteractiveSessionStartSchema, AgentInteractiveSessionStopAcknowledgementSchema, AgentInteractiveSessionStopCommandSchema, AgentInteractiveSessionStatusSchema, agentInteractiveSessionControlClaimAcknowledgementMatchesRequest, agentInteractiveSessionControlClaimRequestDigest, agentInteractiveSessionControlClaimMatchesRef, agentInteractiveSessionControlClaimIsNewer, agentInteractiveSessionPromptAcknowledgementMatchesCommand, agentInteractiveSessionPromptRequestDigest, agentInteractiveSessionStopAcknowledgementMatchesCommand, agentInteractiveSessionStopRequestDigest, agentInteractiveSessionRequestDigest, agentInteractiveSessionRefMatchesStart, agentInteractiveSessionRunRef, agentInteractiveSessionStatusMatchesRef, exactAgentInteractiveSessionStart, AgentEnvironmentCreationSchema, createAgentEnvironmentWithIdempotency, replayedAgentEnvironmentView, canonicalWorkspaceCwd, MAX_WORKSPACE_CWD_LENGTH, workspaceCwdSchema, workspaceCwdPathForBase, WorkspaceRequestSchema, TerminalAttachRequestSchema, TerminalAttachResultSchema, TerminalDetachAckSchema, TerminalInputSchema, TerminalOutputEventSchema, TerminalReplayWindowSchema, TerminalResizeSchema, TerminalSessionRefSchema, terminalAttachResultMatchesRequest, terminalSessionUsable, } from "./environment-provider.js";
11
+ export { AgentEnvironmentCapabilitiesSchema, AgentRuntimeAttachmentsSchema, AgentNativeContextContinuationAdmissionSchema, AgentNativeContextContinuationResultSchema, AgentTurnInputSchema, AgentTurnResultSchema, agentEnvironmentCreateInputDigest, agentNativeContextContinuationAdmissionMatchesRequest, agentNativeContextContinuationResultMatchesRequest, AccountUsageSchema, AgentEnvironmentObservationSchema, AgentEnvironmentStatusSchema, ComputeBillingSchema, EnvironmentLifecycleSchema, ModelUsageSchema, ObservationProvenanceSchema, PlacementDescriptorSchema, ProviderIdentitySchema, ResourceProfileSchema, ResourceUseSampleSchema, SafeEndpointSchema, agentEnvironmentObservationIdentityMatches, observationContainsCredential, observationOf, AgentInteractiveSessionAttachSchema, AgentInteractiveSessionControlClaimAcknowledgementSchema, AgentInteractiveSessionControlClaimRequestSchema, AgentInteractiveSessionControlClaimSchema, AgentInteractiveSessionPromptAcknowledgementSchema, AgentInteractiveSessionPromptCommandSchema, AgentInteractiveSessionRefSchema, AgentInteractiveSessionStartSchema, AgentInteractiveSessionStopAcknowledgementSchema, AgentInteractiveSessionStopCommandSchema, AgentInteractiveSessionStatusSchema, agentInteractiveSessionControlClaimAcknowledgementMatchesRequest, agentInteractiveSessionControlClaimRequestDigest, agentInteractiveSessionControlClaimMatchesRef, agentInteractiveSessionControlClaimIsNewer, agentInteractiveSessionPromptAcknowledgementMatchesCommand, agentInteractiveSessionPromptRequestDigest, agentInteractiveSessionStopAcknowledgementMatchesCommand, agentInteractiveSessionStopRequestDigest, agentInteractiveSessionRefMatchesStart, agentInteractiveSessionRunRef, agentInteractiveSessionStatusMatchesRef, exactAgentInteractiveSessionStart, createAgentEnvironmentWithIdempotency, canonicalWorkspaceCwd, MAX_WORKSPACE_CWD_LENGTH, workspaceCwdSchema, workspaceCwdPathForBase, WorkspaceRequestSchema, TerminalAttachRequestSchema, TerminalAttachResultSchema, TerminalDetachAckSchema, TerminalInputSchema, TerminalOutputEventSchema, TerminalReplayWindowSchema, TerminalResizeSchema, TerminalSessionRefSchema, terminalAttachResultMatchesRequest, terminalSessionUsable, } from "./environment-provider.js";
12
12
  export * from "./plan.js";
13
13
  export * from "./runtime-control.js";
14
14
  export * from "./portable-context.js";
@@ -25,14 +25,12 @@ export * from "./agent-profile-improvement.js";
25
25
  export * from "./agent-profile-improvement-schema.js";
26
26
  export * from "./agent-execution-limits.js";
27
27
  export * from "./agent-profile.js";
28
- export * from "./agent-instance.js";
29
28
  export * from "./agent-profile-snapshot.js";
30
29
  export * from "./agent-profile-activation.js";
31
30
  export * from "./agent-profile-materialization.js";
32
31
  export * from "./agent-profile-measurements.js";
33
32
  export * from "./agent-execution-preparation.js";
34
33
  export * from "./agent-workspace-lease.js";
35
- export * from "./certified-context.js";
36
34
  export * from "./deep-freeze.js";
37
35
  export * from "./profile-diff.js";
38
36
  export * from "./harness.js";
@@ -106,7 +106,6 @@ export declare const InteractionFieldTypeSchema: z.ZodEnum<{
106
106
  select: "select";
107
107
  text: "text";
108
108
  }>;
109
- export type InteractionFieldType = z.infer<typeof InteractionFieldTypeSchema>;
110
109
  /** Scope at which an accepted answer may be reused by an explicit policy. */
111
110
  export declare const InteractionResponseScopeSchema: z.ZodEnum<{
112
111
  interaction: "interaction";
@@ -1,5 +1,4 @@
1
1
  import { type InteractionRequest, type InteractionResponse, type InteractionResponseCommand } from "./interaction-envelope.js";
2
- import { type InteractionValidation } from "./interaction-answer-validation.js";
3
2
  export type InteractionResponseValidation = {
4
3
  ok: true;
5
4
  response: InteractionResponse;
@@ -11,7 +10,3 @@ export type InteractionResponseValidation = {
11
10
  export declare function validateInteractionResponse(request: InteractionRequest, response: unknown): InteractionResponseValidation;
12
11
  /** Validate a durable response command, including its run and request digest. */
13
12
  export declare function validateInteractionResponseCommand(request: InteractionRequest, command: InteractionResponseCommand): InteractionResponseValidation;
14
- /** Parse and return the safe response for callers that need an enumerable result. */
15
- export declare function validateAndParseInteractionResponse(request: InteractionRequest, response: unknown): InteractionResponseValidation;
16
- /** Verdict-only form for callers that never forward the value. */
17
- export declare function interactionResponseIsValid(request: InteractionRequest, response: unknown): InteractionValidation;
@@ -88,15 +88,3 @@ export function validateInteractionResponseCommand(request, command) {
88
88
  }
89
89
  return validateInteractionResponse(parsedRequest.data, parsedCommand.data.response);
90
90
  }
91
- /** Parse and return the safe response for callers that need an enumerable result. */
92
- export function validateAndParseInteractionResponse(request, response) {
93
- const result = validateInteractionResponse(request, response);
94
- if (!result.ok)
95
- return result;
96
- return { ok: true, response: result.response };
97
- }
98
- /** Verdict-only form for callers that never forward the value. */
99
- export function interactionResponseIsValid(request, response) {
100
- const result = validateInteractionResponse(request, response);
101
- return result.ok ? { ok: true } : { ok: false, errors: result.errors };
102
- }
package/dist/parts.d.ts CHANGED
@@ -94,9 +94,6 @@ export type InputImagePart = {
94
94
  path?: string;
95
95
  };
96
96
  export type InputPart = InputTextPart | InputFilePart | InputImagePart;
97
- export declare function isInputTextPart(part: InputPart): part is InputTextPart;
98
- export declare function isInputFilePart(part: InputPart): part is InputFilePart;
99
- export declare function isInputImagePart(part: InputPart): part is InputImagePart;
100
97
  export declare function normalizeInputParts(input: {
101
98
  message?: string;
102
99
  parts?: InputPart[];
package/dist/parts.js CHANGED
@@ -13,15 +13,6 @@ export function isFilePart(part) {
13
13
  export function isSubtaskPart(part) {
14
14
  return part.type === "subtask";
15
15
  }
16
- export function isInputTextPart(part) {
17
- return part.type === "text";
18
- }
19
- export function isInputFilePart(part) {
20
- return part.type === "file";
21
- }
22
- export function isInputImagePart(part) {
23
- return part.type === "image";
24
- }
25
16
  export function normalizeInputParts(input) {
26
17
  if (Array.isArray(input.parts) && input.parts.length > 0) {
27
18
  return input.parts;
package/dist/plan.d.ts CHANGED
@@ -1,11 +1,4 @@
1
1
  import { z } from "zod";
2
- /** Harnesses with an enforceable durable-plan continuation contract. */
3
- export declare const PlanProviderKindSchema: z.ZodEnum<{
4
- "claude-code": "claude-code";
5
- codex: "codex";
6
- opencode: "opencode";
7
- }>;
8
- export type PlanProviderKind = z.infer<typeof PlanProviderKindSchema>;
9
2
  /**
10
3
  * Credential-free provider correlation committed with the plan. This union is
11
4
  * deliberately closed: adding plan support for another harness requires an
@@ -63,7 +56,6 @@ export declare const PlanDecisionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
63
56
  outcome: z.ZodLiteral<"rejected">;
64
57
  feedback: z.ZodString;
65
58
  }, z.core.$strict>], "outcome">;
66
- export type PlanDecision = z.infer<typeof PlanDecisionSchema>;
67
59
  /**
68
60
  * Typed server-originated continuation. Adapters consume this instead of
69
61
  * inferring approval from a free-form user message.
package/dist/plan.js CHANGED
@@ -1,10 +1,4 @@
1
1
  import { z } from "zod";
2
- /** Harnesses with an enforceable durable-plan continuation contract. */
3
- export const PlanProviderKindSchema = z.enum([
4
- "claude-code",
5
- "codex",
6
- "opencode",
7
- ]);
8
2
  /**
9
3
  * Credential-free provider correlation committed with the plan. This union is
10
4
  * deliberately closed: adding plan support for another harness requires an
@@ -1,5 +1,5 @@
1
1
  import type { AgentProfile } from "./agent-profile.js";
2
- declare const agentProfileDiffPropertyAxes: readonly ["prompt", "model", "harness", "permissions", "tools", "mcp", "connections", "subagents", "resources", "hooks", "modes", "confidential", "metadata", "extensions"];
2
+ declare const agentProfileDiffPropertyAxes: readonly ["prompt", "model", "harness", "seats", "permissions", "tools", "mcp", "connections", "subagents", "resources", "hooks", "modes", "confidential", "metadata", "extensions"];
3
3
  export type AgentProfileDiffAxis = "identity" | (typeof agentProfileDiffPropertyAxes)[number];
4
4
  export type AgentProfileRemoveList = true | readonly string[];
5
5
  export interface AgentProfilePromptRemoval {
@@ -22,6 +22,7 @@ export interface AgentProfileDiffRemoval {
22
22
  prompt?: true | AgentProfilePromptRemoval;
23
23
  model?: AgentProfileRemoveList;
24
24
  harness?: true;
25
+ seats?: true;
25
26
  permissions?: AgentProfileRemoveList;
26
27
  tools?: AgentProfileRemoveList;
27
28
  mcp?: AgentProfileRemoveList;
@@ -76,5 +77,4 @@ export declare function defineAgentProfileDiff<T extends AgentProfileDiff>(diff:
76
77
  export declare function diffAgentProfiles(baseline: AgentProfile, candidate: AgentProfile): AgentProfileDiff[];
77
78
  export declare function applyAgentProfileDiff(base: AgentProfile, diff: AgentProfileDiff): AgentProfile;
78
79
  export declare function changedAgentProfileAxes(diff: AgentProfileDiff): AgentProfileDiffAxis[];
79
- export declare function pruneAgentProfileDiff(diff: AgentProfileDiff, axesToRemove: readonly AgentProfileDiffAxis[]): AgentProfileDiff;
80
80
  export {};