@agent-vm/controller-execution-contracts 0.0.114 → 0.0.116

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 (17) hide show
  1. package/dist/controller-dispatch-boundary/index.d.ts +132 -20
  2. package/dist/controller-dispatch-boundary/index.d.ts.map +1 -1
  3. package/dist/controller-dispatch-boundary/index.js +2 -2
  4. package/dist/controller-execution-data-boundary/index.d.ts +85 -0
  5. package/dist/controller-execution-data-boundary/index.d.ts.map +1 -0
  6. package/dist/controller-execution-data-boundary/index.js +53 -0
  7. package/dist/controller-execution-data-boundary/index.js.map +1 -0
  8. package/dist/controller-execution-result-schema-CWymsFAD.js +58 -0
  9. package/dist/controller-execution-result-schema-CWymsFAD.js.map +1 -0
  10. package/dist/controller-host-action-boundary/index.d.ts +111 -19
  11. package/dist/controller-host-action-boundary/index.d.ts.map +1 -1
  12. package/dist/controller-host-action-boundary/index.js +1 -1
  13. package/dist/index.d.ts +3 -2
  14. package/dist/index.js +3 -2
  15. package/package.json +6 -2
  16. package/dist/controller-execution-result-schema-BN0cqzhi.js +0 -18
  17. package/dist/controller-execution-result-schema-BN0cqzhi.js.map +0 -1
package/dist/controller-dispatch-boundary/index.d.ts CHANGED
@@ -3,18 +3,42 @@ import * as _$_agent_vm_agent_portal_sdk0 from "@agent-vm/agent-portal-sdk";
3
3
  import { z } from "zod";
4
4
 
5
5
  //#region src/controller-dispatch-boundary/models/controller-execution-result-schema.d.ts
6
+ declare const ControllerExecutionAuthorityBindingSchema: z.ZodObject<{
7
+ fingerprint: z.ZodString;
8
+ operationId: z.ZodString;
9
+ }, z.core.$strict>;
10
+ declare const ControllerExecutionNotDispatchedReasonSchema: z.ZodEnum<{
11
+ "authorization-fingerprint-changed": "authorization-fingerprint-changed";
12
+ "current-epoch-changed": "current-epoch-changed";
13
+ denied: "denied";
14
+ "duplicate-operation": "duplicate-operation";
15
+ "predecessor-owner-unsafe": "predecessor-owner-unsafe";
16
+ "public-authority-or-policy-override": "public-authority-or-policy-override";
17
+ "runner-setup-failed": "runner-setup-failed";
18
+ "stale-authority": "stale-authority";
19
+ }>;
20
+ declare const ControllerExecutionAmbiguousReasonSchema: z.ZodEnum<{
21
+ "containment-unproven": "containment-unproven";
22
+ "dispatch-armed": "dispatch-armed";
23
+ "dispatch-state-unknown": "dispatch-state-unknown";
24
+ }>;
6
25
  declare const ControllerExecutionResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
7
- auditCorrelationId: z.ZodString;
26
+ binding: z.ZodObject<{
27
+ fingerprint: z.ZodString;
28
+ operationId: z.ZodString;
29
+ }, z.core.$strict>;
30
+ certainty: z.ZodLiteral<"proven">;
31
+ completion: z.ZodLiteral<"succeeded">;
8
32
  diagnostics: z.ZodDefault<z.ZodArray<z.ZodObject<{
9
33
  code: z.ZodEnum<{
10
- provider_unavailable: "provider_unavailable";
11
- capability_denied: "capability_denied";
12
34
  approval_required: "approval_required";
35
+ capability_denied: "capability_denied";
13
36
  validation_failed: "validation_failed";
37
+ provider_unavailable: "provider_unavailable";
14
38
  execution_failed: "execution_failed";
15
- output_truncated: "output_truncated";
16
- timeout: "timeout";
17
39
  cancelled: "cancelled";
40
+ timeout: "timeout";
41
+ output_truncated: "output_truncated";
18
42
  artifact_unavailable: "artifact_unavailable";
19
43
  }>;
20
44
  level: z.ZodEnum<{
@@ -26,20 +50,25 @@ declare const ControllerExecutionResultSchema: z.ZodDiscriminatedUnion<[z.ZodObj
26
50
  safeMessage: z.ZodString;
27
51
  safeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
28
52
  }, z.core.$strict>>>;
29
- status: z.ZodLiteral<"ok">;
53
+ kind: z.ZodLiteral<"completed">;
54
+ retryClass: z.ZodLiteral<"forbidden">;
30
55
  value: z.ZodType<_$_agent_vm_agent_portal_sdk0.JsonValue, unknown, z.core.$ZodTypeInternals<_$_agent_vm_agent_portal_sdk0.JsonValue, unknown>>;
31
56
  }, z.core.$strict>, z.ZodObject<{
32
- auditCorrelationId: z.ZodOptional<z.ZodString>;
57
+ binding: z.ZodOptional<z.ZodObject<{
58
+ fingerprint: z.ZodString;
59
+ operationId: z.ZodString;
60
+ }, z.core.$strict>>;
61
+ certainty: z.ZodLiteral<"proven">;
33
62
  diagnostics: z.ZodDefault<z.ZodArray<z.ZodObject<{
34
63
  code: z.ZodEnum<{
35
- provider_unavailable: "provider_unavailable";
36
- capability_denied: "capability_denied";
37
64
  approval_required: "approval_required";
65
+ capability_denied: "capability_denied";
38
66
  validation_failed: "validation_failed";
67
+ provider_unavailable: "provider_unavailable";
39
68
  execution_failed: "execution_failed";
40
- output_truncated: "output_truncated";
41
- timeout: "timeout";
42
69
  cancelled: "cancelled";
70
+ timeout: "timeout";
71
+ output_truncated: "output_truncated";
43
72
  artifact_unavailable: "artifact_unavailable";
44
73
  }>;
45
74
  level: z.ZodEnum<{
@@ -53,29 +82,105 @@ declare const ControllerExecutionResultSchema: z.ZodDiscriminatedUnion<[z.ZodObj
53
82
  }, z.core.$strict>>>;
54
83
  error: z.ZodObject<{
55
84
  code: z.ZodEnum<{
56
- provider_unavailable: "provider_unavailable";
57
- capability_denied: "capability_denied";
85
+ invalid_request: "invalid_request";
86
+ not_found: "not_found";
87
+ not_authorized: "not_authorized";
58
88
  approval_required: "approval_required";
89
+ capability_denied: "capability_denied";
59
90
  validation_failed: "validation_failed";
91
+ provider_unavailable: "provider_unavailable";
60
92
  execution_failed: "execution_failed";
93
+ cancelled: "cancelled";
61
94
  timeout: "timeout";
95
+ }>;
96
+ message: z.ZodString;
97
+ retryable: z.ZodOptional<z.ZodBoolean>;
98
+ safeDiagnostic: z.ZodOptional<z.ZodObject<{
99
+ code: z.ZodEnum<{
100
+ approval_required: "approval_required";
101
+ capability_denied: "capability_denied";
102
+ validation_failed: "validation_failed";
103
+ provider_unavailable: "provider_unavailable";
104
+ execution_failed: "execution_failed";
105
+ cancelled: "cancelled";
106
+ timeout: "timeout";
107
+ output_truncated: "output_truncated";
108
+ artifact_unavailable: "artifact_unavailable";
109
+ }>;
110
+ level: z.ZodEnum<{
111
+ error: "error";
112
+ debug: "debug";
113
+ info: "info";
114
+ warn: "warn";
115
+ }>;
116
+ safeMessage: z.ZodString;
117
+ safeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
118
+ }, z.core.$strict>>;
119
+ }, z.core.$strict>;
120
+ kind: z.ZodLiteral<"not-dispatched">;
121
+ reason: z.ZodEnum<{
122
+ "authorization-fingerprint-changed": "authorization-fingerprint-changed";
123
+ "current-epoch-changed": "current-epoch-changed";
124
+ denied: "denied";
125
+ "duplicate-operation": "duplicate-operation";
126
+ "predecessor-owner-unsafe": "predecessor-owner-unsafe";
127
+ "public-authority-or-policy-override": "public-authority-or-policy-override";
128
+ "runner-setup-failed": "runner-setup-failed";
129
+ "stale-authority": "stale-authority";
130
+ }>;
131
+ retryClass: z.ZodLiteral<"safe-before-dispatch">;
132
+ }, z.core.$strict>, z.ZodObject<{
133
+ binding: z.ZodObject<{
134
+ fingerprint: z.ZodString;
135
+ operationId: z.ZodString;
136
+ }, z.core.$strict>;
137
+ certainty: z.ZodLiteral<"side-effects-and-termination-unknown">;
138
+ diagnostics: z.ZodDefault<z.ZodArray<z.ZodObject<{
139
+ code: z.ZodEnum<{
140
+ approval_required: "approval_required";
141
+ capability_denied: "capability_denied";
142
+ validation_failed: "validation_failed";
143
+ provider_unavailable: "provider_unavailable";
144
+ execution_failed: "execution_failed";
62
145
  cancelled: "cancelled";
146
+ timeout: "timeout";
147
+ output_truncated: "output_truncated";
148
+ artifact_unavailable: "artifact_unavailable";
149
+ }>;
150
+ level: z.ZodEnum<{
151
+ error: "error";
152
+ debug: "debug";
153
+ info: "info";
154
+ warn: "warn";
155
+ }>;
156
+ safeMessage: z.ZodString;
157
+ safeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
158
+ }, z.core.$strict>>>;
159
+ error: z.ZodObject<{
160
+ code: z.ZodEnum<{
63
161
  invalid_request: "invalid_request";
64
162
  not_found: "not_found";
65
163
  not_authorized: "not_authorized";
164
+ approval_required: "approval_required";
165
+ capability_denied: "capability_denied";
166
+ validation_failed: "validation_failed";
167
+ provider_unavailable: "provider_unavailable";
168
+ execution_failed: "execution_failed";
169
+ cancelled: "cancelled";
170
+ timeout: "timeout";
66
171
  }>;
67
172
  message: z.ZodString;
68
173
  retryable: z.ZodOptional<z.ZodBoolean>;
69
174
  safeDiagnostic: z.ZodOptional<z.ZodObject<{
70
175
  code: z.ZodEnum<{
71
- provider_unavailable: "provider_unavailable";
72
- capability_denied: "capability_denied";
73
176
  approval_required: "approval_required";
177
+ capability_denied: "capability_denied";
74
178
  validation_failed: "validation_failed";
179
+ provider_unavailable: "provider_unavailable";
75
180
  execution_failed: "execution_failed";
76
- output_truncated: "output_truncated";
77
- timeout: "timeout";
78
181
  cancelled: "cancelled";
182
+ timeout: "timeout";
183
+ output_truncated: "output_truncated";
79
184
  artifact_unavailable: "artifact_unavailable";
80
185
  }>;
81
186
  level: z.ZodEnum<{
@@ -88,8 +193,15 @@ declare const ControllerExecutionResultSchema: z.ZodDiscriminatedUnion<[z.ZodObj
88
193
  safeParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
89
194
  }, z.core.$strict>>;
90
195
  }, z.core.$strict>;
91
- status: z.ZodLiteral<"error">;
92
- }, z.core.$strict>], "status">;
196
+ kind: z.ZodLiteral<"ambiguous">;
197
+ reason: z.ZodEnum<{
198
+ "containment-unproven": "containment-unproven";
199
+ "dispatch-armed": "dispatch-armed";
200
+ "dispatch-state-unknown": "dispatch-state-unknown";
201
+ }>;
202
+ retryClass: z.ZodLiteral<"forbidden">;
203
+ }, z.core.$strict>], "kind">;
204
+ type ControllerExecutionAuthorityBinding = z.infer<typeof ControllerExecutionAuthorityBindingSchema>;
93
205
  type ControllerExecutionResult = z.infer<typeof ControllerExecutionResultSchema>;
94
206
  //#endregion
95
207
  //#region src/controller-dispatch-boundary/models/execution-fingerprint-schema.d.ts
@@ -115,5 +227,5 @@ declare const ExecutionFingerprintSchema: z.ZodObject<{
115
227
  }, z.core.$strict>;
116
228
  type ExecutionFingerprint = z.infer<typeof ExecutionFingerprintSchema>;
117
229
  //#endregion
118
- export { ControllerDispatchIntent, ControllerDispatchIntentSchema, ControllerExecutionResult, ControllerExecutionResultSchema, ControllerTrustedScopeSchema, ExecutionFingerprint, ExecutionFingerprintSchema };
230
+ export { ControllerDispatchIntent, ControllerDispatchIntentSchema, ControllerExecutionAmbiguousReasonSchema, ControllerExecutionAuthorityBinding, ControllerExecutionAuthorityBindingSchema, ControllerExecutionNotDispatchedReasonSchema, ControllerExecutionResult, ControllerExecutionResultSchema, ControllerTrustedScopeSchema, ExecutionFingerprint, ExecutionFingerprintSchema };
119
231
  //# sourceMappingURL=index.d.ts.map
package/dist/controller-dispatch-boundary/index.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","names":[],"sources":["../../src/controller-dispatch-boundary/models/controller-execution-result-schema.ts","../../src/controller-dispatch-boundary/models/execution-fingerprint-schema.ts"],"mappings":";;;;;cAOa,+BAAA,EAA+B,CAAA,CAAA,qBAAA,EAAA,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmBhC,yBAAA,GAA4B,CAAA,CAAE,KAAA,QAAa,+BAAA;;;cCvB1C,0BAAA,EAA0B,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;KAiB3B,oBAAA,GAAuB,CAAA,CAAE,KAAA,QAAa,0BAAA"}
1
+ {"version":3,"file":"index.d.ts","names":[],"sources":["../../src/controller-dispatch-boundary/models/controller-execution-result-schema.ts","../../src/controller-dispatch-boundary/models/execution-fingerprint-schema.ts"],"mappings":";;;;;cAOa,yCAAA,EAAyC,CAAA,CAAA,SAAA;;;;cAOzC,4CAAA,EAA4C,CAAA,CAAA,OAAA;;;;;;;;;;cAW5C,wCAAA,EAAwC,CAAA,CAAA,OAAA;;;;;cA0CxC,+BAAA,EAA+B,CAAA,CAAA,qBAAA,EAAA,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAMhC,mCAAA,GAAsC,CAAA,CAAE,KAAA,QAC5C,yCAAA;AAAA,KAEI,yBAAA,GAA4B,CAAA,CAAE,KAAA,QAAa,+BAAA;;;cCzE1C,0BAAA,EAA0B,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;KAiB3B,oBAAA,GAAuB,CAAA,CAAE,KAAA,QAAa,0BAAA"}
package/dist/controller-dispatch-boundary/index.js CHANGED
@@ -1,4 +1,4 @@
1
1
  import { n as ControllerTrustedScopeSchema, t as ControllerDispatchIntentSchema } from "../controller-dispatch-intent-schema-dw3ugqpe.js";
2
- import { t as ControllerExecutionResultSchema } from "../controller-execution-result-schema-BN0cqzhi.js";
2
+ import { i as ControllerExecutionResultSchema, n as ControllerExecutionAuthorityBindingSchema, r as ControllerExecutionNotDispatchedReasonSchema, t as ControllerExecutionAmbiguousReasonSchema } from "../controller-execution-result-schema-CWymsFAD.js";
3
3
  import { t as ExecutionFingerprintSchema } from "../execution-fingerprint-schema-D4J978Oa.js";
4
- export { ControllerDispatchIntentSchema, ControllerExecutionResultSchema, ControllerTrustedScopeSchema, ExecutionFingerprintSchema };
4
+ export { ControllerDispatchIntentSchema, ControllerExecutionAmbiguousReasonSchema, ControllerExecutionAuthorityBindingSchema, ControllerExecutionNotDispatchedReasonSchema, ControllerExecutionResultSchema, ControllerTrustedScopeSchema, ExecutionFingerprintSchema };
package/dist/controller-execution-data-boundary/index.d.ts ADDED
@@ -0,0 +1,85 @@
1
+ import { z } from "zod/v4";
2
+
3
+ //#region src/controller-execution-data-boundary/index.d.ts
4
+ declare const ControllerExecutionDataPayloadMaxBytes: number;
5
+ declare const ControllerExecutionWebSocketPath = "/agent-vm/controller-execution";
6
+ declare const ControllerExecutionDataBindingSchema: z.ZodObject<{
7
+ audience: z.ZodLiteral<"controller-execution-data">;
8
+ channelId: z.ZodString;
9
+ controllerEpoch: z.ZodString;
10
+ executionFingerprint: z.ZodString;
11
+ gatewayEpoch: z.ZodString;
12
+ operationId: z.ZodString;
13
+ runtimeEpoch: z.ZodString;
14
+ stablePrincipal: z.ZodString;
15
+ }, z.core.$strict>;
16
+ declare const ControllerExecutionDataHandshakeSchema: z.ZodObject<{
17
+ audience: z.ZodLiteral<"controller-execution-data">;
18
+ channelId: z.ZodString;
19
+ controllerEpoch: z.ZodString;
20
+ executionFingerprint: z.ZodString;
21
+ gatewayEpoch: z.ZodString;
22
+ operationId: z.ZodString;
23
+ runtimeEpoch: z.ZodString;
24
+ stablePrincipal: z.ZodString;
25
+ kind: z.ZodLiteral<"handshake">;
26
+ }, z.core.$strict>;
27
+ declare const ControllerExecutionDataCreditSchema: z.ZodObject<{
28
+ audience: z.ZodLiteral<"controller-execution-data">;
29
+ channelId: z.ZodString;
30
+ controllerEpoch: z.ZodString;
31
+ executionFingerprint: z.ZodString;
32
+ gatewayEpoch: z.ZodString;
33
+ operationId: z.ZodString;
34
+ runtimeEpoch: z.ZodString;
35
+ stablePrincipal: z.ZodString;
36
+ availableCreditBytes: z.ZodNumber;
37
+ kind: z.ZodLiteral<"credit">;
38
+ nextSequence: z.ZodNumber;
39
+ queuedBytes: z.ZodNumber;
40
+ }, z.core.$strict>;
41
+ declare const ControllerExecutionDataFrameSchema: z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
42
+ audience: z.ZodLiteral<"controller-execution-data">;
43
+ channelId: z.ZodString;
44
+ controllerEpoch: z.ZodString;
45
+ executionFingerprint: z.ZodString;
46
+ gatewayEpoch: z.ZodString;
47
+ operationId: z.ZodString;
48
+ runtimeEpoch: z.ZodString;
49
+ stablePrincipal: z.ZodString;
50
+ creditBytes: z.ZodNumber;
51
+ kind: z.ZodLiteral<"data">;
52
+ payloadBase64: z.ZodString;
53
+ sequence: z.ZodNumber;
54
+ }, z.core.$strict>, z.ZodObject<{
55
+ audience: z.ZodLiteral<"controller-execution-data">;
56
+ channelId: z.ZodString;
57
+ controllerEpoch: z.ZodString;
58
+ executionFingerprint: z.ZodString;
59
+ gatewayEpoch: z.ZodString;
60
+ operationId: z.ZodString;
61
+ runtimeEpoch: z.ZodString;
62
+ stablePrincipal: z.ZodString;
63
+ creditBytes: z.ZodNumber;
64
+ kind: z.ZodLiteral<"eof">;
65
+ sequence: z.ZodNumber;
66
+ }, z.core.$strict>, z.ZodObject<{
67
+ audience: z.ZodLiteral<"controller-execution-data">;
68
+ channelId: z.ZodString;
69
+ controllerEpoch: z.ZodString;
70
+ executionFingerprint: z.ZodString;
71
+ gatewayEpoch: z.ZodString;
72
+ operationId: z.ZodString;
73
+ runtimeEpoch: z.ZodString;
74
+ stablePrincipal: z.ZodString;
75
+ creditBytes: z.ZodNumber;
76
+ kind: z.ZodLiteral<"cancel">;
77
+ sequence: z.ZodNumber;
78
+ }, z.core.$strict>], "kind">;
79
+ type ControllerExecutionDataBinding = z.infer<typeof ControllerExecutionDataBindingSchema>;
80
+ type ControllerExecutionDataCredit = z.infer<typeof ControllerExecutionDataCreditSchema>;
81
+ type ControllerExecutionDataFrame = z.infer<typeof ControllerExecutionDataFrameSchema>;
82
+ type ControllerExecutionDataHandshake = z.infer<typeof ControllerExecutionDataHandshakeSchema>;
83
+ //#endregion
84
+ export { ControllerExecutionDataBinding, ControllerExecutionDataCredit, ControllerExecutionDataCreditSchema, ControllerExecutionDataFrame, ControllerExecutionDataFrameSchema, ControllerExecutionDataHandshake, ControllerExecutionDataHandshakeSchema, ControllerExecutionDataPayloadMaxBytes, ControllerExecutionWebSocketPath };
85
+ //# sourceMappingURL=index.d.ts.map
package/dist/controller-execution-data-boundary/index.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","names":[],"sources":["../../src/controller-execution-data-boundary/index.ts"],"mappings":";;;cAGa,sCAAA;AAAA,cACA,gCAAA;AAAA,cAYP,oCAAA,EAAoC,CAAA,CAAA,SAAA;;;;;;;;;;cAe7B,sCAAA,EAAsC,CAAA,CAAA,SAAA;;;;;;;;;;;cAItC,mCAAA,EAAmC,CAAA,CAAA,SAAA;;;;;;;;;;;;;;cA8BnC,kCAAA,EAAkC,CAAA,CAAA,qBAAA,WAAA,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAKnC,8BAAA,GAAiC,CAAA,CAAE,KAAA,QAAa,oCAAA;AAAA,KAChD,6BAAA,GAAgC,CAAA,CAAE,KAAA,QAAa,mCAAA;AAAA,KAC/C,4BAAA,GAA+B,CAAA,CAAE,KAAA,QAAa,kCAAA;AAAA,KAC9C,gCAAA,GAAmC,CAAA,CAAE,KAAA,QACzC,sCAAA"}
package/dist/controller-execution-data-boundary/index.js ADDED
@@ -0,0 +1,53 @@
1
+ import { GatewayStablePrincipalDigestSchema } from "@agent-vm/agent-portal-sdk/contracts";
2
+ import { z } from "zod/v4";
3
+ //#region src/controller-execution-data-boundary/index.ts
4
+ const ControllerExecutionDataPayloadMaxBytes = 1024 * 1024;
5
+ const ControllerExecutionWebSocketPath = "/agent-vm/controller-execution";
6
+ const canonicalPaddedBase64Pattern = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/u;
7
+ function isCanonicalBoundedExecutionPayload(value) {
8
+ if (value.length < 4 || !canonicalPaddedBase64Pattern.test(value)) return false;
9
+ const paddingBytes = value.endsWith("==") ? 2 : value.endsWith("=") ? 1 : 0;
10
+ return value.length / 4 * 3 - paddingBytes <= ControllerExecutionDataPayloadMaxBytes;
11
+ }
12
+ const ControllerExecutionDataBindingSchema = z.object({
13
+ audience: z.literal("controller-execution-data"),
14
+ channelId: z.string().min(1),
15
+ controllerEpoch: z.string().min(1),
16
+ executionFingerprint: z.string().min(1),
17
+ gatewayEpoch: z.string().min(1),
18
+ operationId: z.string().min(1),
19
+ runtimeEpoch: z.string().min(1),
20
+ stablePrincipal: GatewayStablePrincipalDigestSchema
21
+ }).strict();
22
+ const ControllerExecutionFrameSequenceSchema = z.number().int().nonnegative().safe();
23
+ const ControllerExecutionDataHandshakeSchema = ControllerExecutionDataBindingSchema.extend({ kind: z.literal("handshake") }).strict();
24
+ const ControllerExecutionDataCreditSchema = ControllerExecutionDataBindingSchema.extend({
25
+ availableCreditBytes: ControllerExecutionFrameSequenceSchema,
26
+ kind: z.literal("credit"),
27
+ nextSequence: ControllerExecutionFrameSequenceSchema,
28
+ queuedBytes: ControllerExecutionFrameSequenceSchema
29
+ }).strict();
30
+ const ControllerExecutionDataPayloadSchema = z.string().refine(isCanonicalBoundedExecutionPayload, { message: `Execution data payload must be canonical padded base64 containing at most ${ControllerExecutionDataPayloadMaxBytes} decoded bytes.` });
31
+ const ControllerExecutionDataFrameVariantSchemas = [
32
+ ControllerExecutionDataBindingSchema.extend({
33
+ creditBytes: ControllerExecutionFrameSequenceSchema,
34
+ kind: z.literal("data"),
35
+ payloadBase64: ControllerExecutionDataPayloadSchema,
36
+ sequence: ControllerExecutionFrameSequenceSchema
37
+ }).strict(),
38
+ ControllerExecutionDataBindingSchema.extend({
39
+ creditBytes: ControllerExecutionFrameSequenceSchema,
40
+ kind: z.literal("eof"),
41
+ sequence: ControllerExecutionFrameSequenceSchema
42
+ }).strict(),
43
+ ControllerExecutionDataBindingSchema.extend({
44
+ creditBytes: ControllerExecutionFrameSequenceSchema,
45
+ kind: z.literal("cancel"),
46
+ sequence: ControllerExecutionFrameSequenceSchema
47
+ }).strict()
48
+ ];
49
+ const ControllerExecutionDataFrameSchema = z.discriminatedUnion("kind", ControllerExecutionDataFrameVariantSchemas);
50
+ //#endregion
51
+ export { ControllerExecutionDataCreditSchema, ControllerExecutionDataFrameSchema, ControllerExecutionDataHandshakeSchema, ControllerExecutionDataPayloadMaxBytes, ControllerExecutionWebSocketPath };
52
+
53
+ //# sourceMappingURL=index.js.map
package/dist/controller-execution-data-boundary/index.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","names":[],"sources":["../../src/controller-execution-data-boundary/index.ts"],"sourcesContent":["import { GatewayStablePrincipalDigestSchema } from '@agent-vm/agent-portal-sdk/contracts';\nimport { z } from 'zod/v4';\n\nexport const ControllerExecutionDataPayloadMaxBytes = 1024 * 1024;\nexport const ControllerExecutionWebSocketPath = '/agent-vm/controller-execution';\n\nconst canonicalPaddedBase64Pattern =\n\t/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/u;\n\nfunction isCanonicalBoundedExecutionPayload(value: string): boolean {\n\tif (value.length < 4 || !canonicalPaddedBase64Pattern.test(value)) return false;\n\tconst paddingBytes = value.endsWith('==') ? 2 : value.endsWith('=') ? 1 : 0;\n\tconst decodedBytes = (value.length / 4) * 3 - paddingBytes;\n\treturn decodedBytes <= ControllerExecutionDataPayloadMaxBytes;\n}\n\nconst ControllerExecutionDataBindingSchema = z\n\t.object({\n\t\taudience: z.literal('controller-execution-data'),\n\t\tchannelId: z.string().min(1),\n\t\tcontrollerEpoch: z.string().min(1),\n\t\texecutionFingerprint: z.string().min(1),\n\t\tgatewayEpoch: z.string().min(1),\n\t\toperationId: z.string().min(1),\n\t\truntimeEpoch: z.string().min(1),\n\t\tstablePrincipal: GatewayStablePrincipalDigestSchema,\n\t})\n\t.strict();\n\nconst ControllerExecutionFrameSequenceSchema = z.number().int().nonnegative().safe();\n\nexport const ControllerExecutionDataHandshakeSchema = ControllerExecutionDataBindingSchema.extend({\n\tkind: z.literal('handshake'),\n}).strict();\n\nexport const ControllerExecutionDataCreditSchema = ControllerExecutionDataBindingSchema.extend({\n\tavailableCreditBytes: ControllerExecutionFrameSequenceSchema,\n\tkind: z.literal('credit'),\n\tnextSequence: ControllerExecutionFrameSequenceSchema,\n\tqueuedBytes: ControllerExecutionFrameSequenceSchema,\n}).strict();\n\nconst ControllerExecutionDataPayloadSchema = z.string().refine(isCanonicalBoundedExecutionPayload, {\n\tmessage: `Execution data payload must be canonical padded base64 containing at most ${ControllerExecutionDataPayloadMaxBytes} decoded bytes.`,\n});\n\nconst ControllerExecutionDataFrameVariantSchemas = [\n\tControllerExecutionDataBindingSchema.extend({\n\t\tcreditBytes: ControllerExecutionFrameSequenceSchema,\n\t\tkind: z.literal('data'),\n\t\tpayloadBase64: ControllerExecutionDataPayloadSchema,\n\t\tsequence: ControllerExecutionFrameSequenceSchema,\n\t}).strict(),\n\tControllerExecutionDataBindingSchema.extend({\n\t\tcreditBytes: ControllerExecutionFrameSequenceSchema,\n\t\tkind: z.literal('eof'),\n\t\tsequence: ControllerExecutionFrameSequenceSchema,\n\t}).strict(),\n\tControllerExecutionDataBindingSchema.extend({\n\t\tcreditBytes: ControllerExecutionFrameSequenceSchema,\n\t\tkind: z.literal('cancel'),\n\t\tsequence: ControllerExecutionFrameSequenceSchema,\n\t}).strict(),\n] as const;\n\nexport const ControllerExecutionDataFrameSchema = z.discriminatedUnion(\n\t'kind',\n\tControllerExecutionDataFrameVariantSchemas,\n);\n\nexport type ControllerExecutionDataBinding = z.infer<typeof ControllerExecutionDataBindingSchema>;\nexport type ControllerExecutionDataCredit = z.infer<typeof ControllerExecutionDataCreditSchema>;\nexport type ControllerExecutionDataFrame = z.infer<typeof ControllerExecutionDataFrameSchema>;\nexport type ControllerExecutionDataHandshake = z.infer<\n\ttypeof ControllerExecutionDataHandshakeSchema\n>;\n"],"mappings":";;;AAGA,MAAa,yCAAyC,OAAO;AAC7D,MAAa,mCAAmC;AAEhD,MAAM,+BACL;AAED,SAAS,mCAAmC,OAAwB;CACnE,IAAI,MAAM,SAAS,KAAK,CAAC,6BAA6B,KAAK,MAAM,EAAE,OAAO;CAC1E,MAAM,eAAe,MAAM,SAAS,KAAK,GAAG,IAAI,MAAM,SAAS,IAAI,GAAG,IAAI;CAE1E,OADsB,MAAM,SAAS,IAAK,IAAI,gBACvB;;AAGxB,MAAM,uCAAuC,EAC3C,OAAO;CACP,UAAU,EAAE,QAAQ,4BAA4B;CAChD,WAAW,EAAE,QAAQ,CAAC,IAAI,EAAE;CAC5B,iBAAiB,EAAE,QAAQ,CAAC,IAAI,EAAE;CAClC,sBAAsB,EAAE,QAAQ,CAAC,IAAI,EAAE;CACvC,cAAc,EAAE,QAAQ,CAAC,IAAI,EAAE;CAC/B,aAAa,EAAE,QAAQ,CAAC,IAAI,EAAE;CAC9B,cAAc,EAAE,QAAQ,CAAC,IAAI,EAAE;CAC/B,iBAAiB;CACjB,CAAC,CACD,QAAQ;AAEV,MAAM,yCAAyC,EAAE,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM;AAEpF,MAAa,yCAAyC,qCAAqC,OAAO,EACjG,MAAM,EAAE,QAAQ,YAAY,EAC5B,CAAC,CAAC,QAAQ;AAEX,MAAa,sCAAsC,qCAAqC,OAAO;CAC9F,sBAAsB;CACtB,MAAM,EAAE,QAAQ,SAAS;CACzB,cAAc;CACd,aAAa;CACb,CAAC,CAAC,QAAQ;AAEX,MAAM,uCAAuC,EAAE,QAAQ,CAAC,OAAO,oCAAoC,EAClG,SAAS,6EAA6E,uCAAuC,kBAC7H,CAAC;AAEF,MAAM,6CAA6C;CAClD,qCAAqC,OAAO;EAC3C,aAAa;EACb,MAAM,EAAE,QAAQ,OAAO;EACvB,eAAe;EACf,UAAU;EACV,CAAC,CAAC,QAAQ;CACX,qCAAqC,OAAO;EAC3C,aAAa;EACb,MAAM,EAAE,QAAQ,MAAM;EACtB,UAAU;EACV,CAAC,CAAC,QAAQ;CACX,qCAAqC,OAAO;EAC3C,aAAa;EACb,MAAM,EAAE,QAAQ,SAAS;EACzB,UAAU;EACV,CAAC,CAAC,QAAQ;CACX;AAED,MAAa,qCAAqC,EAAE,mBACnD,QACA,2CACA"}
package/dist/controller-execution-result-schema-CWymsFAD.js ADDED
@@ -0,0 +1,58 @@
1
+ import { JsonValueSchema, PortalErrorSchema, SafeDiagnosticSchema } from "@agent-vm/agent-portal-sdk";
2
+ import { z } from "zod";
3
+ //#region src/controller-dispatch-boundary/models/controller-execution-result-schema.ts
4
+ const ControllerExecutionAuthorityBindingSchema = z.object({
5
+ fingerprint: z.string().min(1),
6
+ operationId: z.string().min(1)
7
+ }).strict();
8
+ const ControllerExecutionNotDispatchedReasonSchema = z.enum([
9
+ "authorization-fingerprint-changed",
10
+ "current-epoch-changed",
11
+ "denied",
12
+ "duplicate-operation",
13
+ "predecessor-owner-unsafe",
14
+ "public-authority-or-policy-override",
15
+ "runner-setup-failed",
16
+ "stale-authority"
17
+ ]);
18
+ const ControllerExecutionAmbiguousReasonSchema = z.enum([
19
+ "containment-unproven",
20
+ "dispatch-armed",
21
+ "dispatch-state-unknown"
22
+ ]);
23
+ const ControllerExecutionCompletedResultSchema = z.object({
24
+ binding: ControllerExecutionAuthorityBindingSchema,
25
+ certainty: z.literal("proven"),
26
+ completion: z.literal("succeeded"),
27
+ diagnostics: z.array(SafeDiagnosticSchema).default([]),
28
+ kind: z.literal("completed"),
29
+ retryClass: z.literal("forbidden"),
30
+ value: JsonValueSchema
31
+ }).strict();
32
+ const ControllerExecutionNotDispatchedResultSchema = z.object({
33
+ binding: ControllerExecutionAuthorityBindingSchema.optional(),
34
+ certainty: z.literal("proven"),
35
+ diagnostics: z.array(SafeDiagnosticSchema).default([]),
36
+ error: PortalErrorSchema,
37
+ kind: z.literal("not-dispatched"),
38
+ reason: ControllerExecutionNotDispatchedReasonSchema,
39
+ retryClass: z.literal("safe-before-dispatch")
40
+ }).strict();
41
+ const ControllerExecutionAmbiguousResultSchema = z.object({
42
+ binding: ControllerExecutionAuthorityBindingSchema,
43
+ certainty: z.literal("side-effects-and-termination-unknown"),
44
+ diagnostics: z.array(SafeDiagnosticSchema).default([]),
45
+ error: PortalErrorSchema,
46
+ kind: z.literal("ambiguous"),
47
+ reason: ControllerExecutionAmbiguousReasonSchema,
48
+ retryClass: z.literal("forbidden")
49
+ }).strict();
50
+ const ControllerExecutionResultSchema = z.discriminatedUnion("kind", [
51
+ ControllerExecutionCompletedResultSchema,
52
+ ControllerExecutionNotDispatchedResultSchema,
53
+ ControllerExecutionAmbiguousResultSchema
54
+ ]);
55
+ //#endregion
56
+ export { ControllerExecutionResultSchema as i, ControllerExecutionAuthorityBindingSchema as n, ControllerExecutionNotDispatchedReasonSchema as r, ControllerExecutionAmbiguousReasonSchema as t };
57
+
58
+ //# sourceMappingURL=controller-execution-result-schema-CWymsFAD.js.map
package/dist/controller-execution-result-schema-CWymsFAD.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"controller-execution-result-schema-CWymsFAD.js","names":[],"sources":["../src/controller-dispatch-boundary/models/controller-execution-result-schema.ts"],"sourcesContent":["import {\n\tJsonValueSchema,\n\tPortalErrorSchema,\n\tSafeDiagnosticSchema,\n} from '@agent-vm/agent-portal-sdk';\nimport { z } from 'zod';\n\nexport const ControllerExecutionAuthorityBindingSchema = z\n\t.object({\n\t\tfingerprint: z.string().min(1),\n\t\toperationId: z.string().min(1),\n\t})\n\t.strict();\n\nexport const ControllerExecutionNotDispatchedReasonSchema = z.enum([\n\t'authorization-fingerprint-changed',\n\t'current-epoch-changed',\n\t'denied',\n\t'duplicate-operation',\n\t'predecessor-owner-unsafe',\n\t'public-authority-or-policy-override',\n\t'runner-setup-failed',\n\t'stale-authority',\n]);\n\nexport const ControllerExecutionAmbiguousReasonSchema = z.enum([\n\t'containment-unproven',\n\t'dispatch-armed',\n\t'dispatch-state-unknown',\n]);\n\nconst ControllerExecutionCompletedResultSchema = z\n\t.object({\n\t\tbinding: ControllerExecutionAuthorityBindingSchema,\n\t\tcertainty: z.literal('proven'),\n\t\tcompletion: z.literal('succeeded'),\n\t\tdiagnostics: z.array(SafeDiagnosticSchema).default([]),\n\t\tkind: z.literal('completed'),\n\t\tretryClass: z.literal('forbidden'),\n\t\tvalue: JsonValueSchema,\n\t})\n\t.strict();\n\nconst ControllerExecutionNotDispatchedResultSchema = z\n\t.object({\n\t\tbinding: ControllerExecutionAuthorityBindingSchema.optional(),\n\t\tcertainty: z.literal('proven'),\n\t\tdiagnostics: z.array(SafeDiagnosticSchema).default([]),\n\t\terror: PortalErrorSchema,\n\t\tkind: z.literal('not-dispatched'),\n\t\treason: ControllerExecutionNotDispatchedReasonSchema,\n\t\tretryClass: z.literal('safe-before-dispatch'),\n\t})\n\t.strict();\n\nconst ControllerExecutionAmbiguousResultSchema = z\n\t.object({\n\t\tbinding: ControllerExecutionAuthorityBindingSchema,\n\t\tcertainty: z.literal('side-effects-and-termination-unknown'),\n\t\tdiagnostics: z.array(SafeDiagnosticSchema).default([]),\n\t\terror: PortalErrorSchema,\n\t\tkind: z.literal('ambiguous'),\n\t\treason: ControllerExecutionAmbiguousReasonSchema,\n\t\tretryClass: z.literal('forbidden'),\n\t})\n\t.strict();\n\nexport const ControllerExecutionResultSchema = z.discriminatedUnion('kind', [\n\tControllerExecutionCompletedResultSchema,\n\tControllerExecutionNotDispatchedResultSchema,\n\tControllerExecutionAmbiguousResultSchema,\n]);\n\nexport type ControllerExecutionAuthorityBinding = z.infer<\n\ttypeof ControllerExecutionAuthorityBindingSchema\n>;\nexport type ControllerExecutionResult = z.infer<typeof ControllerExecutionResultSchema>;\n"],"mappings":";;;AAOA,MAAa,4CAA4C,EACvD,OAAO;CACP,aAAa,EAAE,QAAQ,CAAC,IAAI,EAAE;CAC9B,aAAa,EAAE,QAAQ,CAAC,IAAI,EAAE;CAC9B,CAAC,CACD,QAAQ;AAEV,MAAa,+CAA+C,EAAE,KAAK;CAClE;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,CAAC;AAEF,MAAa,2CAA2C,EAAE,KAAK;CAC9D;CACA;CACA;CACA,CAAC;AAEF,MAAM,2CAA2C,EAC/C,OAAO;CACP,SAAS;CACT,WAAW,EAAE,QAAQ,SAAS;CAC9B,YAAY,EAAE,QAAQ,YAAY;CAClC,aAAa,EAAE,MAAM,qBAAqB,CAAC,QAAQ,EAAE,CAAC;CACtD,MAAM,EAAE,QAAQ,YAAY;CAC5B,YAAY,EAAE,QAAQ,YAAY;CAClC,OAAO;CACP,CAAC,CACD,QAAQ;AAEV,MAAM,+CAA+C,EACnD,OAAO;CACP,SAAS,0CAA0C,UAAU;CAC7D,WAAW,EAAE,QAAQ,SAAS;CAC9B,aAAa,EAAE,MAAM,qBAAqB,CAAC,QAAQ,EAAE,CAAC;CACtD,OAAO;CACP,MAAM,EAAE,QAAQ,iBAAiB;CACjC,QAAQ;CACR,YAAY,EAAE,QAAQ,uBAAuB;CAC7C,CAAC,CACD,QAAQ;AAEV,MAAM,2CAA2C,EAC/C,OAAO;CACP,SAAS;CACT,WAAW,EAAE,QAAQ,uCAAuC;CAC5D,aAAa,EAAE,MAAM,qBAAqB,CAAC,QAAQ,EAAE,CAAC;CACtD,OAAO;CACP,MAAM,EAAE,QAAQ,YAAY;CAC5B,QAAQ;CACR,YAAY,EAAE,QAAQ,YAAY;CAClC,CAAC,CACD,QAAQ;AAEV,MAAa,kCAAkC,EAAE,mBAAmB,QAAQ;CAC3E;CACA;CACA;CACA,CAAC"}
package/dist/controller-host-action-boundary/index.d.ts CHANGED
@@ -25,17 +25,22 @@ type ControllerHostActionRequest = z.infer<typeof ControllerHostActionRequestSch
25
25
  //#endregion
26
26
  //#region src/controller-host-action-boundary/models/controller-host-action-result-schema.d.ts
27
27
  declare const ControllerHostActionResultSchema: _$zod.ZodDiscriminatedUnion<[_$zod.ZodObject<{
28
- auditCorrelationId: _$zod.ZodString;
28
+ binding: _$zod.ZodObject<{
29
+ fingerprint: _$zod.ZodString;
30
+ operationId: _$zod.ZodString;
31
+ }, _$zod_v4_core0.$strict>;
32
+ certainty: _$zod.ZodLiteral<"proven">;
33
+ completion: _$zod.ZodLiteral<"succeeded">;
29
34
  diagnostics: _$zod.ZodDefault<_$zod.ZodArray<_$zod.ZodObject<{
30
35
  code: _$zod.ZodEnum<{
31
- provider_unavailable: "provider_unavailable";
32
- capability_denied: "capability_denied";
33
36
  approval_required: "approval_required";
37
+ capability_denied: "capability_denied";
34
38
  validation_failed: "validation_failed";
39
+ provider_unavailable: "provider_unavailable";
35
40
  execution_failed: "execution_failed";
36
- output_truncated: "output_truncated";
37
- timeout: "timeout";
38
41
  cancelled: "cancelled";
42
+ timeout: "timeout";
43
+ output_truncated: "output_truncated";
39
44
  artifact_unavailable: "artifact_unavailable";
40
45
  }>;
41
46
  level: _$zod.ZodEnum<{
@@ -47,20 +52,25 @@ declare const ControllerHostActionResultSchema: _$zod.ZodDiscriminatedUnion<[_$z
47
52
  safeMessage: _$zod.ZodString;
48
53
  safeParams: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodNumber, _$zod.ZodBoolean]>>>;
49
54
  }, _$zod_v4_core0.$strict>>>;
50
- status: _$zod.ZodLiteral<"ok">;
55
+ kind: _$zod.ZodLiteral<"completed">;
56
+ retryClass: _$zod.ZodLiteral<"forbidden">;
51
57
  value: _$zod.ZodType<_$_agent_vm_agent_portal_sdk0.JsonValue, unknown, _$zod_v4_core0.$ZodTypeInternals<_$_agent_vm_agent_portal_sdk0.JsonValue, unknown>>;
52
58
  }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
53
- auditCorrelationId: _$zod.ZodOptional<_$zod.ZodString>;
59
+ binding: _$zod.ZodOptional<_$zod.ZodObject<{
60
+ fingerprint: _$zod.ZodString;
61
+ operationId: _$zod.ZodString;
62
+ }, _$zod_v4_core0.$strict>>;
63
+ certainty: _$zod.ZodLiteral<"proven">;
54
64
  diagnostics: _$zod.ZodDefault<_$zod.ZodArray<_$zod.ZodObject<{
55
65
  code: _$zod.ZodEnum<{
56
- provider_unavailable: "provider_unavailable";
57
- capability_denied: "capability_denied";
58
66
  approval_required: "approval_required";
67
+ capability_denied: "capability_denied";
59
68
  validation_failed: "validation_failed";
69
+ provider_unavailable: "provider_unavailable";
60
70
  execution_failed: "execution_failed";
61
- output_truncated: "output_truncated";
62
- timeout: "timeout";
63
71
  cancelled: "cancelled";
72
+ timeout: "timeout";
73
+ output_truncated: "output_truncated";
64
74
  artifact_unavailable: "artifact_unavailable";
65
75
  }>;
66
76
  level: _$zod.ZodEnum<{
@@ -74,29 +84,105 @@ declare const ControllerHostActionResultSchema: _$zod.ZodDiscriminatedUnion<[_$z
74
84
  }, _$zod_v4_core0.$strict>>>;
75
85
  error: _$zod.ZodObject<{
76
86
  code: _$zod.ZodEnum<{
77
- provider_unavailable: "provider_unavailable";
78
- capability_denied: "capability_denied";
87
+ invalid_request: "invalid_request";
88
+ not_found: "not_found";
89
+ not_authorized: "not_authorized";
79
90
  approval_required: "approval_required";
91
+ capability_denied: "capability_denied";
80
92
  validation_failed: "validation_failed";
93
+ provider_unavailable: "provider_unavailable";
81
94
  execution_failed: "execution_failed";
95
+ cancelled: "cancelled";
82
96
  timeout: "timeout";
97
+ }>;
98
+ message: _$zod.ZodString;
99
+ retryable: _$zod.ZodOptional<_$zod.ZodBoolean>;
100
+ safeDiagnostic: _$zod.ZodOptional<_$zod.ZodObject<{
101
+ code: _$zod.ZodEnum<{
102
+ approval_required: "approval_required";
103
+ capability_denied: "capability_denied";
104
+ validation_failed: "validation_failed";
105
+ provider_unavailable: "provider_unavailable";
106
+ execution_failed: "execution_failed";
107
+ cancelled: "cancelled";
108
+ timeout: "timeout";
109
+ output_truncated: "output_truncated";
110
+ artifact_unavailable: "artifact_unavailable";
111
+ }>;
112
+ level: _$zod.ZodEnum<{
113
+ error: "error";
114
+ debug: "debug";
115
+ info: "info";
116
+ warn: "warn";
117
+ }>;
118
+ safeMessage: _$zod.ZodString;
119
+ safeParams: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodNumber, _$zod.ZodBoolean]>>>;
120
+ }, _$zod_v4_core0.$strict>>;
121
+ }, _$zod_v4_core0.$strict>;
122
+ kind: _$zod.ZodLiteral<"not-dispatched">;
123
+ reason: _$zod.ZodEnum<{
124
+ "authorization-fingerprint-changed": "authorization-fingerprint-changed";
125
+ "current-epoch-changed": "current-epoch-changed";
126
+ denied: "denied";
127
+ "duplicate-operation": "duplicate-operation";
128
+ "predecessor-owner-unsafe": "predecessor-owner-unsafe";
129
+ "public-authority-or-policy-override": "public-authority-or-policy-override";
130
+ "runner-setup-failed": "runner-setup-failed";
131
+ "stale-authority": "stale-authority";
132
+ }>;
133
+ retryClass: _$zod.ZodLiteral<"safe-before-dispatch">;
134
+ }, _$zod_v4_core0.$strict>, _$zod.ZodObject<{
135
+ binding: _$zod.ZodObject<{
136
+ fingerprint: _$zod.ZodString;
137
+ operationId: _$zod.ZodString;
138
+ }, _$zod_v4_core0.$strict>;
139
+ certainty: _$zod.ZodLiteral<"side-effects-and-termination-unknown">;
140
+ diagnostics: _$zod.ZodDefault<_$zod.ZodArray<_$zod.ZodObject<{
141
+ code: _$zod.ZodEnum<{
142
+ approval_required: "approval_required";
143
+ capability_denied: "capability_denied";
144
+ validation_failed: "validation_failed";
145
+ provider_unavailable: "provider_unavailable";
146
+ execution_failed: "execution_failed";
83
147
  cancelled: "cancelled";
148
+ timeout: "timeout";
149
+ output_truncated: "output_truncated";
150
+ artifact_unavailable: "artifact_unavailable";
151
+ }>;
152
+ level: _$zod.ZodEnum<{
153
+ error: "error";
154
+ debug: "debug";
155
+ info: "info";
156
+ warn: "warn";
157
+ }>;
158
+ safeMessage: _$zod.ZodString;
159
+ safeParams: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodNumber, _$zod.ZodBoolean]>>>;
160
+ }, _$zod_v4_core0.$strict>>>;
161
+ error: _$zod.ZodObject<{
162
+ code: _$zod.ZodEnum<{
84
163
  invalid_request: "invalid_request";
85
164
  not_found: "not_found";
86
165
  not_authorized: "not_authorized";
166
+ approval_required: "approval_required";
167
+ capability_denied: "capability_denied";
168
+ validation_failed: "validation_failed";
169
+ provider_unavailable: "provider_unavailable";
170
+ execution_failed: "execution_failed";
171
+ cancelled: "cancelled";
172
+ timeout: "timeout";
87
173
  }>;
88
174
  message: _$zod.ZodString;
89
175
  retryable: _$zod.ZodOptional<_$zod.ZodBoolean>;
90
176
  safeDiagnostic: _$zod.ZodOptional<_$zod.ZodObject<{
91
177
  code: _$zod.ZodEnum<{
92
- provider_unavailable: "provider_unavailable";
93
- capability_denied: "capability_denied";
94
178
  approval_required: "approval_required";
179
+ capability_denied: "capability_denied";
95
180
  validation_failed: "validation_failed";
181
+ provider_unavailable: "provider_unavailable";
96
182
  execution_failed: "execution_failed";
97
- output_truncated: "output_truncated";
98
- timeout: "timeout";
99
183
  cancelled: "cancelled";
184
+ timeout: "timeout";
185
+ output_truncated: "output_truncated";
100
186
  artifact_unavailable: "artifact_unavailable";
101
187
  }>;
102
188
  level: _$zod.ZodEnum<{
@@ -109,8 +195,14 @@ declare const ControllerHostActionResultSchema: _$zod.ZodDiscriminatedUnion<[_$z
109
195
  safeParams: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodNumber, _$zod.ZodBoolean]>>>;
110
196
  }, _$zod_v4_core0.$strict>>;
111
197
  }, _$zod_v4_core0.$strict>;
112
- status: _$zod.ZodLiteral<"error">;
113
- }, _$zod_v4_core0.$strict>], "status">;
198
+ kind: _$zod.ZodLiteral<"ambiguous">;
199
+ reason: _$zod.ZodEnum<{
200
+ "containment-unproven": "containment-unproven";
201
+ "dispatch-armed": "dispatch-armed";
202
+ "dispatch-state-unknown": "dispatch-state-unknown";
203
+ }>;
204
+ retryClass: _$zod.ZodLiteral<"forbidden">;
205
+ }, _$zod_v4_core0.$strict>], "kind">;
114
206
  type ControllerHostActionResult = typeof ControllerHostActionResultSchema._output;
115
207
  //#endregion
116
208
  export { ControllerHostActionRequest, ControllerHostActionRequestSchema, ControllerHostActionResult, ControllerHostActionResultSchema };
package/dist/controller-host-action-boundary/index.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","names":[],"sources":["../../src/controller-host-action-boundary/models/controller-host-action-request-schema.ts","../../src/controller-host-action-boundary/models/controller-host-action-result-schema.ts"],"mappings":";;;;;;cAKa,iCAAA,EAAiC,CAAA,CAAA,SAAA;gCAMpC,6BAAA,CAAA,UAAA;;;;;;;;;;;;;;;;KAEE,2BAAA,GAA8B,CAAA,CAAE,KAAA,QAAa,iCAAA;;;cCX5C,gCAAA,QAAgC,qBAAA,QAAA,SAAA;sBAAkC,KAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;wCAAlC,KAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAEjC,0BAAA,UAAoC,gCAAA,CAAiC,OAAA"}
1
+ {"version":3,"file":"index.d.ts","names":[],"sources":["../../src/controller-host-action-boundary/models/controller-host-action-request-schema.ts","../../src/controller-host-action-boundary/models/controller-host-action-result-schema.ts"],"mappings":";;;;;;cAKa,iCAAA,EAAiC,CAAA,CAAA,SAAA;gCAMpC,6BAAA,CAAA,UAAA;;;;;;;;;;;;;;;;KAEE,2BAAA,GAA8B,CAAA,CAAE,KAAA,QAAa,iCAAA;;;cCX5C,gCAAA,QAAgC,qBAAA,QAAA,SAAA;;iBAAkC,KAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAlC,KAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAEjC,0BAAA,UAAoC,gCAAA,CAAiC,OAAA"}
package/dist/controller-host-action-boundary/index.js CHANGED
@@ -1,5 +1,5 @@
1
1
  import { t as ControllerDispatchIntentSchema } from "../controller-dispatch-intent-schema-dw3ugqpe.js";
2
- import { t as ControllerExecutionResultSchema } from "../controller-execution-result-schema-BN0cqzhi.js";
2
+ import { i as ControllerExecutionResultSchema } from "../controller-execution-result-schema-CWymsFAD.js";
3
3
  import { JsonObjectSchema } from "@agent-vm/agent-portal-sdk";
4
4
  import { z } from "zod";
5
5
  //#region src/controller-host-action-boundary/models/controller-host-action-request-schema.ts
package/dist/index.d.ts CHANGED
@@ -1,6 +1,7 @@
1
1
  import { n as ControllerDispatchIntentSchema, r as ControllerTrustedScopeSchema, t as ControllerDispatchIntent } from "./controller-dispatch-intent-schema-fqjx2pb2.js";
2
- import { ControllerExecutionResult, ControllerExecutionResultSchema, ExecutionFingerprint, ExecutionFingerprintSchema } from "./controller-dispatch-boundary/index.js";
2
+ import { ControllerExecutionAmbiguousReasonSchema, ControllerExecutionAuthorityBinding, ControllerExecutionAuthorityBindingSchema, ControllerExecutionNotDispatchedReasonSchema, ControllerExecutionResult, ControllerExecutionResultSchema, ExecutionFingerprint, ExecutionFingerprintSchema } from "./controller-dispatch-boundary/index.js";
3
+ import { ControllerExecutionDataBinding, ControllerExecutionDataCredit, ControllerExecutionDataCreditSchema, ControllerExecutionDataFrame, ControllerExecutionDataFrameSchema, ControllerExecutionDataHandshake, ControllerExecutionDataHandshakeSchema, ControllerExecutionDataPayloadMaxBytes, ControllerExecutionWebSocketPath } from "./controller-execution-data-boundary/index.js";
3
4
  import { ControllerHostActionRequest, ControllerHostActionRequestSchema, ControllerHostActionResult, ControllerHostActionResultSchema } from "./controller-host-action-boundary/index.js";
4
5
  import { a as ManagedVmExecRequestSchema, c as ManagedVmTimeoutMaxMs, i as ManagedVmExecRequest, l as ManagedVmTokenMaxLength, n as ManagedVmEnvironmentMaxEntries, o as ManagedVmStdinMaxBytes, r as ManagedVmEnvironmentValueMaxLength, s as ManagedVmStreamMaxBytes, t as ManagedVmArgvMaxItems } from "./managed-vm-exec-request-schema-BkkZ7zYn.js";
5
6
  import { ArtifactPolicySchema, CancellationPolicySchema, ControllerExecutionArgvMaxItems, ControllerExecutionArgvTokenMaxLength, ControllerExecutionOutputMaxBytes, ControllerExecutionTimeoutMaxMs, CwdPolicySchema, EgressPolicySchema, EnvironmentPolicySchema, ManagedVmArtifactReadMaxBytes, ManagedVmArtifactReadRequest, ManagedVmArtifactReadRequestSchema, OutputPolicySchema, ValidatedCliInvocation, ValidatedCliInvocationSchema } from "./tool-vm-runner-boundary/index.js";
6
- export { ArtifactPolicySchema, CancellationPolicySchema, ControllerDispatchIntent, ControllerDispatchIntentSchema, ControllerExecutionArgvMaxItems, ControllerExecutionArgvTokenMaxLength, ControllerExecutionOutputMaxBytes, ControllerExecutionResult, ControllerExecutionResultSchema, ControllerExecutionTimeoutMaxMs, ControllerHostActionRequest, ControllerHostActionRequestSchema, ControllerHostActionResult, ControllerHostActionResultSchema, ControllerTrustedScopeSchema, CwdPolicySchema, EgressPolicySchema, EnvironmentPolicySchema, ExecutionFingerprint, ExecutionFingerprintSchema, ManagedVmArgvMaxItems, ManagedVmArtifactReadMaxBytes, ManagedVmArtifactReadRequest, ManagedVmArtifactReadRequestSchema, ManagedVmEnvironmentMaxEntries, ManagedVmEnvironmentValueMaxLength, ManagedVmExecRequest, ManagedVmExecRequestSchema, ManagedVmStdinMaxBytes, ManagedVmStreamMaxBytes, ManagedVmTimeoutMaxMs, ManagedVmTokenMaxLength, OutputPolicySchema, ValidatedCliInvocation, ValidatedCliInvocationSchema };
7
+ export { ArtifactPolicySchema, CancellationPolicySchema, ControllerDispatchIntent, ControllerDispatchIntentSchema, ControllerExecutionAmbiguousReasonSchema, ControllerExecutionArgvMaxItems, ControllerExecutionArgvTokenMaxLength, ControllerExecutionAuthorityBinding, ControllerExecutionAuthorityBindingSchema, ControllerExecutionDataBinding, ControllerExecutionDataCredit, ControllerExecutionDataCreditSchema, ControllerExecutionDataFrame, ControllerExecutionDataFrameSchema, ControllerExecutionDataHandshake, ControllerExecutionDataHandshakeSchema, ControllerExecutionDataPayloadMaxBytes, ControllerExecutionNotDispatchedReasonSchema, ControllerExecutionOutputMaxBytes, ControllerExecutionResult, ControllerExecutionResultSchema, ControllerExecutionTimeoutMaxMs, ControllerExecutionWebSocketPath, ControllerHostActionRequest, ControllerHostActionRequestSchema, ControllerHostActionResult, ControllerHostActionResultSchema, ControllerTrustedScopeSchema, CwdPolicySchema, EgressPolicySchema, EnvironmentPolicySchema, ExecutionFingerprint, ExecutionFingerprintSchema, ManagedVmArgvMaxItems, ManagedVmArtifactReadMaxBytes, ManagedVmArtifactReadRequest, ManagedVmArtifactReadRequestSchema, ManagedVmEnvironmentMaxEntries, ManagedVmEnvironmentValueMaxLength, ManagedVmExecRequest, ManagedVmExecRequestSchema, ManagedVmStdinMaxBytes, ManagedVmStreamMaxBytes, ManagedVmTimeoutMaxMs, ManagedVmTokenMaxLength, OutputPolicySchema, ValidatedCliInvocation, ValidatedCliInvocationSchema };
package/dist/index.js CHANGED
@@ -1,8 +1,9 @@
1
1
  import { n as ControllerTrustedScopeSchema, t as ControllerDispatchIntentSchema } from "./controller-dispatch-intent-schema-dw3ugqpe.js";
2
- import { t as ControllerExecutionResultSchema } from "./controller-execution-result-schema-BN0cqzhi.js";
2
+ import { i as ControllerExecutionResultSchema, n as ControllerExecutionAuthorityBindingSchema, r as ControllerExecutionNotDispatchedReasonSchema, t as ControllerExecutionAmbiguousReasonSchema } from "./controller-execution-result-schema-CWymsFAD.js";
3
3
  import { t as ExecutionFingerprintSchema } from "./execution-fingerprint-schema-D4J978Oa.js";
4
4
  import "./controller-dispatch-boundary/index.js";
5
+ import { ControllerExecutionDataCreditSchema, ControllerExecutionDataFrameSchema, ControllerExecutionDataHandshakeSchema, ControllerExecutionDataPayloadMaxBytes, ControllerExecutionWebSocketPath } from "./controller-execution-data-boundary/index.js";
5
6
  import { ControllerHostActionRequestSchema, ControllerHostActionResultSchema } from "./controller-host-action-boundary/index.js";
6
7
  import { _ as EnvironmentPolicySchema, a as ManagedVmStdinMaxBytes, c as ManagedVmTokenMaxLength, d as ControllerExecutionArgvMaxItems, f as ControllerExecutionArgvTokenMaxLength, g as EgressPolicySchema, h as CwdPolicySchema, i as ManagedVmExecRequestSchema, l as ArtifactPolicySchema, m as ControllerExecutionTimeoutMaxMs, n as ManagedVmEnvironmentMaxEntries, o as ManagedVmStreamMaxBytes, p as ControllerExecutionOutputMaxBytes, r as ManagedVmEnvironmentValueMaxLength, s as ManagedVmTimeoutMaxMs, t as ManagedVmArgvMaxItems, u as CancellationPolicySchema, v as OutputPolicySchema, y as ValidatedCliInvocationSchema } from "./managed-vm-exec-request-schema-oPmsc4H8.js";
7
8
  import { ManagedVmArtifactReadMaxBytes, ManagedVmArtifactReadRequestSchema } from "./tool-vm-runner-boundary/index.js";
8
- export { ArtifactPolicySchema, CancellationPolicySchema, ControllerDispatchIntentSchema, ControllerExecutionArgvMaxItems, ControllerExecutionArgvTokenMaxLength, ControllerExecutionOutputMaxBytes, ControllerExecutionResultSchema, ControllerExecutionTimeoutMaxMs, ControllerHostActionRequestSchema, ControllerHostActionResultSchema, ControllerTrustedScopeSchema, CwdPolicySchema, EgressPolicySchema, EnvironmentPolicySchema, ExecutionFingerprintSchema, ManagedVmArgvMaxItems, ManagedVmArtifactReadMaxBytes, ManagedVmArtifactReadRequestSchema, ManagedVmEnvironmentMaxEntries, ManagedVmEnvironmentValueMaxLength, ManagedVmExecRequestSchema, ManagedVmStdinMaxBytes, ManagedVmStreamMaxBytes, ManagedVmTimeoutMaxMs, ManagedVmTokenMaxLength, OutputPolicySchema, ValidatedCliInvocationSchema };
9
+ export { ArtifactPolicySchema, CancellationPolicySchema, ControllerDispatchIntentSchema, ControllerExecutionAmbiguousReasonSchema, ControllerExecutionArgvMaxItems, ControllerExecutionArgvTokenMaxLength, ControllerExecutionAuthorityBindingSchema, ControllerExecutionDataCreditSchema, ControllerExecutionDataFrameSchema, ControllerExecutionDataHandshakeSchema, ControllerExecutionDataPayloadMaxBytes, ControllerExecutionNotDispatchedReasonSchema, ControllerExecutionOutputMaxBytes, ControllerExecutionResultSchema, ControllerExecutionTimeoutMaxMs, ControllerExecutionWebSocketPath, ControllerHostActionRequestSchema, ControllerHostActionResultSchema, ControllerTrustedScopeSchema, CwdPolicySchema, EgressPolicySchema, EnvironmentPolicySchema, ExecutionFingerprintSchema, ManagedVmArgvMaxItems, ManagedVmArtifactReadMaxBytes, ManagedVmArtifactReadRequestSchema, ManagedVmEnvironmentMaxEntries, ManagedVmEnvironmentValueMaxLength, ManagedVmExecRequestSchema, ManagedVmStdinMaxBytes, ManagedVmStreamMaxBytes, ManagedVmTimeoutMaxMs, ManagedVmTokenMaxLength, OutputPolicySchema, ValidatedCliInvocationSchema };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agent-vm/controller-execution-contracts",
3
- "version": "0.0.114",
3
+ "version": "0.0.116",
4
4
  "description": "Zod contracts for controller-owned portal execution boundaries.",
5
5
  "homepage": "https://github.com/ShravanSunder/agent-vm#readme",
6
6
  "bugs": {
@@ -28,6 +28,10 @@
28
28
  "types": "./dist/controller-dispatch-boundary/index.d.ts",
29
29
  "import": "./dist/controller-dispatch-boundary/index.js"
30
30
  },
31
+ "./controller-execution-data-boundary": {
32
+ "types": "./dist/controller-execution-data-boundary/index.d.ts",
33
+ "import": "./dist/controller-execution-data-boundary/index.js"
34
+ },
31
35
  "./controller-host-action-boundary": {
32
36
  "types": "./dist/controller-host-action-boundary/index.d.ts",
33
37
  "import": "./dist/controller-host-action-boundary/index.js"
@@ -46,7 +50,7 @@
46
50
  },
47
51
  "dependencies": {
48
52
  "zod": "^4.4.3",
49
- "@agent-vm/agent-portal-sdk": "0.0.114"
53
+ "@agent-vm/agent-portal-sdk": "0.0.116"
50
54
  },
51
55
  "devDependencies": {
52
56
  "vitest": "^4.1.5"
package/dist/controller-execution-result-schema-BN0cqzhi.js DELETED
@@ -1,18 +0,0 @@
1
- import { JsonValueSchema, PortalErrorSchema, SafeDiagnosticSchema } from "@agent-vm/agent-portal-sdk";
2
- import { z } from "zod";
3
- //#region src/controller-dispatch-boundary/models/controller-execution-result-schema.ts
4
- const ControllerExecutionResultSchema = z.discriminatedUnion("status", [z.object({
5
- auditCorrelationId: z.string().min(1),
6
- diagnostics: z.array(SafeDiagnosticSchema).default([]),
7
- status: z.literal("ok"),
8
- value: JsonValueSchema
9
- }).strict(), z.object({
10
- auditCorrelationId: z.string().min(1).optional(),
11
- diagnostics: z.array(SafeDiagnosticSchema).default([]),
12
- error: PortalErrorSchema,
13
- status: z.literal("error")
14
- }).strict()]);
15
- //#endregion
16
- export { ControllerExecutionResultSchema as t };
17
-
18
- //# sourceMappingURL=controller-execution-result-schema-BN0cqzhi.js.map
package/dist/controller-execution-result-schema-BN0cqzhi.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"controller-execution-result-schema-BN0cqzhi.js","names":[],"sources":["../src/controller-dispatch-boundary/models/controller-execution-result-schema.ts"],"sourcesContent":["import {\n\tJsonValueSchema,\n\tPortalErrorSchema,\n\tSafeDiagnosticSchema,\n} from '@agent-vm/agent-portal-sdk';\nimport { z } from 'zod';\n\nexport const ControllerExecutionResultSchema = z.discriminatedUnion('status', [\n\tz\n\t\t.object({\n\t\t\tauditCorrelationId: z.string().min(1),\n\t\t\tdiagnostics: z.array(SafeDiagnosticSchema).default([]),\n\t\t\tstatus: z.literal('ok'),\n\t\t\tvalue: JsonValueSchema,\n\t\t})\n\t\t.strict(),\n\tz\n\t\t.object({\n\t\t\tauditCorrelationId: z.string().min(1).optional(),\n\t\t\tdiagnostics: z.array(SafeDiagnosticSchema).default([]),\n\t\t\terror: PortalErrorSchema,\n\t\t\tstatus: z.literal('error'),\n\t\t})\n\t\t.strict(),\n]);\n\nexport type ControllerExecutionResult = z.infer<typeof ControllerExecutionResultSchema>;\n"],"mappings":";;;AAOA,MAAa,kCAAkC,EAAE,mBAAmB,UAAU,CAC7E,EACE,OAAO;CACP,oBAAoB,EAAE,QAAQ,CAAC,IAAI,EAAE;CACrC,aAAa,EAAE,MAAM,qBAAqB,CAAC,QAAQ,EAAE,CAAC;CACtD,QAAQ,EAAE,QAAQ,KAAK;CACvB,OAAO;CACP,CAAC,CACD,QAAQ,EACV,EACE,OAAO;CACP,oBAAoB,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU;CAChD,aAAa,EAAE,MAAM,qBAAqB,CAAC,QAAQ,EAAE,CAAC;CACtD,OAAO;CACP,QAAQ,EAAE,QAAQ,QAAQ;CAC1B,CAAC,CACD,QAAQ,CACV,CAAC"}