@kitman-sh/loops 0.0.0-stage → 0.7.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 (41) hide show
  1. package/dist/index.js +1066 -0
  2. package/package.json +19 -4
  3. package/types/packages/core/src/agent-environment.d.ts +2429 -0
  4. package/types/packages/core/src/agent-sandbox-policy.d.ts +33 -0
  5. package/types/packages/core/src/common.d.ts +6 -0
  6. package/types/packages/core/src/context-pack.d.ts +182 -0
  7. package/types/packages/core/src/extension.d.ts +35 -0
  8. package/types/packages/core/src/kit.d.ts +1489 -0
  9. package/types/packages/core/src/loop-layers.d.ts +59 -0
  10. package/types/packages/core/src/loop-version.d.ts +59 -0
  11. package/types/packages/core/src/loop.d.ts +3076 -0
  12. package/types/packages/core/src/package-declarations.d.ts +435 -0
  13. package/types/packages/core/src/proposal.d.ts +292 -0
  14. package/types/packages/core/src/redaction.d.ts +73 -0
  15. package/types/packages/core/src/run.d.ts +566 -0
  16. package/types/packages/core/src/runtime-type.d.ts +36 -0
  17. package/types/packages/core/src/schedule.d.ts +136 -0
  18. package/types/packages/core/src/schema.d.ts +89 -0
  19. package/types/packages/core/src/trigger-dispatch.d.ts +421 -0
  20. package/types/packages/loops/src/build.d.ts +33 -0
  21. package/types/packages/loops/src/change-request-body.d.ts +14 -0
  22. package/types/packages/loops/src/code-quality-pass.d.ts +50 -0
  23. package/types/packages/loops/src/code-quality.d.ts +26 -0
  24. package/types/packages/loops/src/hello.d.ts +9 -0
  25. package/types/packages/loops/src/incident.d.ts +13 -0
  26. package/types/packages/loops/src/index.d.ts +172 -0
  27. package/types/packages/loops/src/plan.d.ts +37 -0
  28. package/types/packages/loops/src/release.d.ts +21 -0
  29. package/types/packages/loops/src/research.d.ts +8 -0
  30. package/types/packages/loops/src/review.d.ts +38 -0
  31. package/types/packages/sdk/src/loop/activities.d.ts +187 -0
  32. package/types/packages/sdk/src/loop/check.d.ts +39 -0
  33. package/types/packages/sdk/src/loop/config.d.ts +68 -0
  34. package/types/packages/sdk/src/loop/define.d.ts +76 -0
  35. package/types/packages/sdk/src/loop/evidence.d.ts +66 -0
  36. package/types/packages/sdk/src/loop/index.d.ts +9 -0
  37. package/types/packages/sdk/src/loop/plan.d.ts +43 -0
  38. package/types/packages/sdk/src/loop/review.d.ts +86 -0
  39. package/types/packages/sdk/src/loop/steps.d.ts +224 -0
  40. package/types/packages/sdk/src/loop/test-loop.d.ts +112 -0
  41. package/README.md +0 -3
package/types/packages/core/src/loop.d.ts ADDED
@@ -0,0 +1,3076 @@
1
+ import * as Schema from 'effect/Schema';
2
+ export declare const LoopStepImplementationKinds: readonly ['built_in_action', 'agent', 'wait_for_event', 'human_approval', 'runner_sandbox', 'package_ref', 'repeat_until', 'call_loop'];
3
+ export declare const RunStatuses: readonly ['pending', 'running', 'blocked', 'completed', 'failed', 'canceled', 'expired'];
4
+ export declare const StepAttemptStatuses: readonly ['pending', 'running', 'waiting', 'blocked', 'completed', 'failed', 'canceled'];
5
+ export declare const QuestionStatuses: readonly ['open', 'answered', 'resume_requested', 'resumed', 'resume_failed', 'expired', 'cancelled'];
6
+ export declare const LoopGuardSources: readonly ['trigger_event', 'task', 'project', 'proposal', 'decision', 'step_attempt', 'change_request', 'context_feedback', 'run', 'project_policy'];
7
+ export declare const LoopSourceModes: readonly ['direct', 'git_backed'];
8
+ export declare const LoopCapabilityKinds: readonly ["read_task", "read_repo_binding", "read_agent_environment", "read_kit", "update_task_status", "read_change_request", "read_change_request_review", "read_task_link", "refresh_change_request_metadata", "record_change_request_review", "record_session_update", "create_task_link", "create_task_dependency", "create_task_asset", "create_follow_up_task", "execute_agent", "read_step_attempt", "record_task_thread_entry", "write_provider_repository", "write_provider_change_request", "publish_provider_check", "write_provider_comment", "request_provider_changes", "approve_provider_change_request", "merge_provider_change_request", "wait_for_event", "request_human_approval", "execute_package_ref", "read_context_feedback", "read_session_update", "read_repo_binding", "read_agent_environment", "read_kit", "read_memory", "read_decision", "create_task_dependency", "propose_memory", "propose_kit", "propose_decision", "propose_agent_environment_policy", "propose_project_context", "propose_context_relevance", "execute_runner_sandbox"];
9
+ export declare const LoopStatus: Schema.Literals<readonly ["draft", "active", "disabled", "archived"]>;
10
+ export declare const LoopTriggerEvent: Schema.String;
11
+ export declare const LoopStepImplementationKind: Schema.Literals<readonly ["built_in_action", "agent", "wait_for_event", "human_approval", "runner_sandbox", "package_ref", "repeat_until", "call_loop"]>;
12
+ export declare const RunStatus: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
13
+ export declare const StepAttemptStatus: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
14
+ export declare const QuestionStatus: Schema.Literals<readonly ["open", "answered", "resume_requested", "resumed", "resume_failed", "expired", "cancelled"]>;
15
+ export declare const LoopSourceMode: Schema.Literals<readonly ["direct", "git_backed"]>;
16
+ export declare const LoopCapabilityKind: Schema.Literals<readonly ["read_task", "read_repo_binding", "read_agent_environment", "read_kit", "update_task_status", "read_change_request", "read_change_request_review", "read_task_link", "refresh_change_request_metadata", "record_change_request_review", "record_session_update", "create_task_link", "create_task_dependency", "create_task_asset", "create_follow_up_task", "execute_agent", "read_step_attempt", "record_task_thread_entry", "write_provider_repository", "write_provider_change_request", "publish_provider_check", "write_provider_comment", "request_provider_changes", "approve_provider_change_request", "merge_provider_change_request", "wait_for_event", "request_human_approval", "execute_package_ref", "read_context_feedback", "read_session_update", "read_repo_binding", "read_agent_environment", "read_kit", "read_memory", "read_decision", "create_task_dependency", "propose_memory", "propose_kit", "propose_decision", "propose_agent_environment_policy", "propose_project_context", "propose_context_relevance", "execute_runner_sandbox"]>;
17
+ export declare const LoopDataSchemaRef: Schema.Struct<{
18
+ readonly kind: Schema.Literal<"typebox_ref">;
19
+ readonly name: Schema.String;
20
+ readonly version: Schema.optionalKey<Schema.String>;
21
+ readonly sha256: Schema.optionalKey<Schema.String>;
22
+ }>;
23
+ export type LoopStepOutputDataValue = string | number | boolean | null | readonly LoopStepOutputDataValue[] | {
24
+ readonly [key: string]: LoopStepOutputDataValue;
25
+ };
26
+ export declare const LoopStepOutputDataValue: Schema.Codec<LoopStepOutputDataValue>;
27
+ export declare const LoopSafeMetadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
28
+ export declare const LoopSafeRef: Schema.Struct<{
29
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
30
+ readonly id: Schema.optionalKey<Schema.String>;
31
+ readonly externalId: Schema.optionalKey<Schema.String>;
32
+ readonly provider: Schema.optionalKey<Schema.String>;
33
+ readonly title: Schema.optionalKey<Schema.String>;
34
+ }>;
35
+ export declare const LoopCapabilityScope: Schema.Struct<{
36
+ readonly kind: Schema.Literals<readonly ["workspace", "project", "task", "change_request", "step_attempt", "run", "repo_binding", "provider_host"]>;
37
+ readonly id: Schema.optionalKey<Schema.String>;
38
+ readonly idRef: Schema.optionalKey<Schema.String>;
39
+ readonly value: Schema.optionalKey<Schema.String>;
40
+ }>;
41
+ export declare const LoopCapabilityGrant: Schema.Struct<{
42
+ readonly capability: Schema.Literals<readonly ["read_task", "read_repo_binding", "read_agent_environment", "read_kit", "update_task_status", "read_change_request", "read_change_request_review", "read_task_link", "refresh_change_request_metadata", "record_change_request_review", "record_session_update", "create_task_link", "create_task_dependency", "create_task_asset", "create_follow_up_task", "execute_agent", "read_step_attempt", "record_task_thread_entry", "write_provider_repository", "write_provider_change_request", "publish_provider_check", "write_provider_comment", "request_provider_changes", "approve_provider_change_request", "merge_provider_change_request", "wait_for_event", "request_human_approval", "execute_package_ref", "read_context_feedback", "read_session_update", "read_repo_binding", "read_agent_environment", "read_kit", "read_memory", "read_decision", "create_task_dependency", "propose_memory", "propose_kit", "propose_decision", "propose_agent_environment_policy", "propose_project_context", "propose_context_relevance", "execute_runner_sandbox"]>;
43
+ readonly scope: Schema.optionalKey<Schema.Struct<{
44
+ readonly kind: Schema.Literals<readonly ["workspace", "project", "task", "change_request", "step_attempt", "run", "repo_binding", "provider_host"]>;
45
+ readonly id: Schema.optionalKey<Schema.String>;
46
+ readonly idRef: Schema.optionalKey<Schema.String>;
47
+ readonly value: Schema.optionalKey<Schema.String>;
48
+ }>>;
49
+ readonly reason: Schema.optionalKey<Schema.String>;
50
+ }>;
51
+ export declare const LoopRequiredContextSlice: Schema.Struct<{
52
+ readonly kind: Schema.Literals<readonly ["kit", "memory", "decision", "session", "session_update", "proposal", "task_dependency", "repo_binding", "agent_environment", "loop_step"]>;
53
+ readonly id: Schema.optionalKey<Schema.String>;
54
+ readonly idRef: Schema.optionalKey<Schema.String>;
55
+ readonly reason: Schema.String;
56
+ readonly required: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
57
+ }>;
58
+ export declare const LoopRetryPolicy: Schema.Struct<{
59
+ readonly maxAttempts: Schema.Int;
60
+ readonly backoff: Schema.Literals<readonly ["none", "fixed", "exponential"]>;
61
+ readonly delaySeconds: Schema.optionalKey<Schema.Int>;
62
+ }>;
63
+ export declare const LoopTimeoutPolicy: Schema.Struct<{
64
+ readonly timeoutSeconds: Schema.Int;
65
+ }>;
66
+ export declare const LoopSource: Schema.Union<readonly [Schema.Struct<{
67
+ readonly mode: Schema.Literal<"direct">;
68
+ readonly registeredFrom: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"api">, Schema.Literal<"cli">, Schema.Literal<"mcp">, Schema.Literal<"import">]>>;
69
+ readonly bundleRef: Schema.optionalKey<Schema.String>;
70
+ readonly bundleSha256: Schema.optionalKey<Schema.String>;
71
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
72
+ }>, Schema.Struct<{
73
+ readonly mode: Schema.Literal<"git_backed">;
74
+ readonly repoBindingId: Schema.String;
75
+ readonly gitRef: Schema.String;
76
+ readonly commitSha: Schema.String;
77
+ readonly definitionPath: Schema.optionalKey<Schema.String>;
78
+ readonly packagePath: Schema.optionalKey<Schema.String>;
79
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
80
+ }>]>;
81
+ export declare const LoopStepPackageMetadata: Schema.Struct<{
82
+ readonly packageName: Schema.String;
83
+ readonly version: Schema.optionalKey<Schema.String>;
84
+ readonly entrypoint: Schema.String;
85
+ readonly source: Schema.Union<readonly [Schema.Struct<{
86
+ readonly mode: Schema.Literal<"direct">;
87
+ readonly registeredFrom: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"api">, Schema.Literal<"cli">, Schema.Literal<"mcp">, Schema.Literal<"import">]>>;
88
+ readonly bundleRef: Schema.optionalKey<Schema.String>;
89
+ readonly bundleSha256: Schema.optionalKey<Schema.String>;
90
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
91
+ }>, Schema.Struct<{
92
+ readonly mode: Schema.Literal<"git_backed">;
93
+ readonly repoBindingId: Schema.String;
94
+ readonly gitRef: Schema.String;
95
+ readonly commitSha: Schema.String;
96
+ readonly definitionPath: Schema.optionalKey<Schema.String>;
97
+ readonly packagePath: Schema.optionalKey<Schema.String>;
98
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
99
+ }>]>;
100
+ readonly runtime: Schema.optionalKey<Schema.String>;
101
+ readonly integritySha256: Schema.optionalKey<Schema.String>;
102
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
103
+ }>;
104
+ export declare const LoopStepInputBinding: Schema.Union<readonly [Schema.Struct<{
105
+ readonly key: Schema.String;
106
+ readonly required: Schema.optionalKey<Schema.Boolean>;
107
+ readonly source: Schema.Literal<"trigger_event">;
108
+ readonly path: Schema.$Array<Schema.String>;
109
+ }>, Schema.Struct<{
110
+ readonly key: Schema.String;
111
+ readonly required: Schema.optionalKey<Schema.Boolean>;
112
+ readonly source: Schema.Literal<"subject">;
113
+ readonly path: Schema.$Array<Schema.String>;
114
+ }>, Schema.Struct<{
115
+ readonly key: Schema.String;
116
+ readonly required: Schema.optionalKey<Schema.Boolean>;
117
+ readonly source: Schema.Literal<"context">;
118
+ readonly path: Schema.$Array<Schema.String>;
119
+ }>, Schema.Struct<{
120
+ readonly key: Schema.String;
121
+ readonly required: Schema.optionalKey<Schema.Boolean>;
122
+ readonly source: Schema.Literal<"step_output">;
123
+ readonly stepKey: Schema.String;
124
+ readonly outputKey: Schema.String;
125
+ readonly path: Schema.optionalKey<Schema.$Array<Schema.String>>;
126
+ }>, Schema.Struct<{
127
+ readonly key: Schema.String;
128
+ readonly required: Schema.optionalKey<Schema.Boolean>;
129
+ readonly source: Schema.Literal<"run">;
130
+ readonly path: Schema.$Array<Schema.String>;
131
+ }>, Schema.Struct<{
132
+ readonly key: Schema.String;
133
+ readonly required: Schema.optionalKey<Schema.Boolean>;
134
+ readonly source: Schema.Literal<"literal">;
135
+ readonly value: Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>;
136
+ }>]>;
137
+ export declare const LoopStepOutputRef: Schema.Struct<{
138
+ readonly key: Schema.String;
139
+ readonly schemaRef: Schema.optionalKey<Schema.Struct<{
140
+ readonly kind: Schema.Literal<"typebox_ref">;
141
+ readonly name: Schema.String;
142
+ readonly version: Schema.optionalKey<Schema.String>;
143
+ readonly sha256: Schema.optionalKey<Schema.String>;
144
+ }>>;
145
+ readonly path: Schema.optionalKey<Schema.$Array<Schema.String>>;
146
+ readonly required: Schema.optionalKey<Schema.Boolean>;
147
+ }>;
148
+ export declare const LoopAgentRuntimeComponentSelector: Schema.Struct<{
149
+ readonly implementation: Schema.String;
150
+ readonly kind: Schema.Union<readonly [Schema.Literal<"preferred">, Schema.Literal<"required">]>;
151
+ }>;
152
+ export declare const LoopAgentStepImplementation: Schema.Struct<{
153
+ readonly kind: Schema.Literal<"agent">;
154
+ readonly taskIdRef: Schema.String;
155
+ readonly agentId: Schema.String;
156
+ readonly agentRef: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
157
+ readonly agentId: Schema.String;
158
+ readonly alias: Schema.String;
159
+ }>, Schema.Struct<{
160
+ readonly agentId: Schema.String;
161
+ readonly version: Schema.Int;
162
+ readonly digest: Schema.String;
163
+ }>]>>;
164
+ /**
165
+ * Concrete backend requirement (legacy form). Omitted in the portable
166
+ * form: the runner resolves the backend from its advertised capabilities
167
+ * instead of a Herdr-specific identity.
168
+ */
169
+ readonly runtimeKind: Schema.optionalKey<Schema.String>;
170
+ /** Optional harness preference; 'preferred' may fall back, 'required' is a hard constraint. */
171
+ readonly harness: Schema.optionalKey<Schema.Struct<{
172
+ readonly implementation: Schema.String;
173
+ readonly kind: Schema.Union<readonly [Schema.Literal<"preferred">, Schema.Literal<"required">]>;
174
+ }>>;
175
+ /** Optional sandbox preference; 'preferred' may fall back, 'required' is a hard constraint. */
176
+ readonly sandbox: Schema.optionalKey<Schema.Struct<{
177
+ readonly implementation: Schema.String;
178
+ readonly kind: Schema.Union<readonly [Schema.Literal<"preferred">, Schema.Literal<"required">]>;
179
+ }>>;
180
+ /** Ordered model candidates replacing the Agent defaults for this Step. */
181
+ readonly models: Schema.optionalKey<Schema.$Array<Schema.Struct<{
182
+ readonly providerRef: Schema.String;
183
+ readonly modelRef: Schema.String;
184
+ readonly profile: Schema.optionalKey<Schema.String>;
185
+ readonly reasoning: Schema.optionalKey<Schema.String>;
186
+ }>>>;
187
+ /**
188
+ * Namespaced, versioned native extension overlays. Optional overlays are
189
+ * skipped when unsupported (the portable base runs unchanged); required
190
+ * overlays block scheduling when unavailable.
191
+ */
192
+ readonly extensions: Schema.optionalKey<Schema.$Array<Schema.Struct<{
193
+ readonly extensionId: Schema.String;
194
+ readonly version: Schema.Int;
195
+ readonly policy: Schema.Literals<readonly ["optional", "required"]>;
196
+ readonly requiredCapabilities: Schema.optionalKey<Schema.$Array<Schema.String>>;
197
+ readonly configuration: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<import("./run").SafeJson, import("./run").SafeJson, never, never>>>;
198
+ }>>>;
199
+ }>;
200
+ export declare const LoopConcreteActionImplementation: Schema.Union<readonly [Schema.Struct<{
201
+ readonly kind: Schema.Literal<"built_in_action">;
202
+ readonly action: Schema.String;
203
+ readonly input: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
204
+ }>, Schema.Struct<{
205
+ readonly kind: Schema.Literal<"agent">;
206
+ readonly taskIdRef: Schema.String;
207
+ readonly agentId: Schema.String;
208
+ readonly agentRef: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
209
+ readonly agentId: Schema.String;
210
+ readonly alias: Schema.String;
211
+ }>, Schema.Struct<{
212
+ readonly agentId: Schema.String;
213
+ readonly version: Schema.Int;
214
+ readonly digest: Schema.String;
215
+ }>]>>;
216
+ /**
217
+ * Concrete backend requirement (legacy form). Omitted in the portable
218
+ * form: the runner resolves the backend from its advertised capabilities
219
+ * instead of a Herdr-specific identity.
220
+ */
221
+ readonly runtimeKind: Schema.optionalKey<Schema.String>;
222
+ /** Optional harness preference; 'preferred' may fall back, 'required' is a hard constraint. */
223
+ readonly harness: Schema.optionalKey<Schema.Struct<{
224
+ readonly implementation: Schema.String;
225
+ readonly kind: Schema.Union<readonly [Schema.Literal<"preferred">, Schema.Literal<"required">]>;
226
+ }>>;
227
+ /** Optional sandbox preference; 'preferred' may fall back, 'required' is a hard constraint. */
228
+ readonly sandbox: Schema.optionalKey<Schema.Struct<{
229
+ readonly implementation: Schema.String;
230
+ readonly kind: Schema.Union<readonly [Schema.Literal<"preferred">, Schema.Literal<"required">]>;
231
+ }>>;
232
+ /** Ordered model candidates replacing the Agent defaults for this Step. */
233
+ readonly models: Schema.optionalKey<Schema.$Array<Schema.Struct<{
234
+ readonly providerRef: Schema.String;
235
+ readonly modelRef: Schema.String;
236
+ readonly profile: Schema.optionalKey<Schema.String>;
237
+ readonly reasoning: Schema.optionalKey<Schema.String>;
238
+ }>>>;
239
+ /**
240
+ * Namespaced, versioned native extension overlays. Optional overlays are
241
+ * skipped when unsupported (the portable base runs unchanged); required
242
+ * overlays block scheduling when unavailable.
243
+ */
244
+ readonly extensions: Schema.optionalKey<Schema.$Array<Schema.Struct<{
245
+ readonly extensionId: Schema.String;
246
+ readonly version: Schema.Int;
247
+ readonly policy: Schema.Literals<readonly ["optional", "required"]>;
248
+ readonly requiredCapabilities: Schema.optionalKey<Schema.$Array<Schema.String>>;
249
+ readonly configuration: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<import("./run").SafeJson, import("./run").SafeJson, never, never>>>;
250
+ }>>>;
251
+ }>, Schema.Struct<{
252
+ readonly kind: Schema.Literal<"wait_for_event">;
253
+ readonly event: Schema.String;
254
+ readonly anyOf: Schema.optionalKey<Schema.$Array<Schema.String>>;
255
+ readonly correlationPath: Schema.$Array<Schema.String>;
256
+ readonly authPolicy: Schema.optionalKey<Schema.Struct<{
257
+ readonly mode: Schema.Union<readonly [Schema.Literal<"trusted_source">, Schema.Literal<"actor">]>;
258
+ readonly capability: Schema.optionalKey<Schema.String>;
259
+ }>>;
260
+ readonly cancellation: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"cancel">, Schema.Literal<"timeout">]>>;
261
+ readonly releaseRunner: Schema.optionalKey<Schema.Boolean>;
262
+ }>, Schema.Struct<{
263
+ readonly kind: Schema.Literal<"human_approval">;
264
+ readonly prompt: Schema.String;
265
+ readonly approvalPolicy: Schema.Struct<{
266
+ readonly mode: Schema.Literals<readonly ["auto_approve_low_risk", "require_other_project_member", "require_workspace_owner_or_admin"]>;
267
+ readonly requireDifferentApprover: Schema.optionalKey<Schema.Boolean>;
268
+ readonly autonomousAgentApprovalAllowed: Schema.Literal<false>;
269
+ readonly deniedViolationCodes: Schema.$Array<Schema.Literals<readonly ["autonomous_self_approval", "self_capability_escalation", "missing_required_approval", "unsafe_payload", "target_conflict"]>>;
270
+ }>;
271
+ }>, Schema.Struct<{
272
+ readonly kind: Schema.Literal<"runner_sandbox">;
273
+ readonly runnerSelector: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
274
+ readonly entrypoint: Schema.String;
275
+ readonly package: Schema.optionalKey<Schema.Struct<{
276
+ readonly packageName: Schema.String;
277
+ readonly version: Schema.optionalKey<Schema.String>;
278
+ readonly entrypoint: Schema.String;
279
+ readonly source: Schema.Union<readonly [Schema.Struct<{
280
+ readonly mode: Schema.Literal<"direct">;
281
+ readonly registeredFrom: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"api">, Schema.Literal<"cli">, Schema.Literal<"mcp">, Schema.Literal<"import">]>>;
282
+ readonly bundleRef: Schema.optionalKey<Schema.String>;
283
+ readonly bundleSha256: Schema.optionalKey<Schema.String>;
284
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
285
+ }>, Schema.Struct<{
286
+ readonly mode: Schema.Literal<"git_backed">;
287
+ readonly repoBindingId: Schema.String;
288
+ readonly gitRef: Schema.String;
289
+ readonly commitSha: Schema.String;
290
+ readonly definitionPath: Schema.optionalKey<Schema.String>;
291
+ readonly packagePath: Schema.optionalKey<Schema.String>;
292
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
293
+ }>]>;
294
+ readonly runtime: Schema.optionalKey<Schema.String>;
295
+ readonly integritySha256: Schema.optionalKey<Schema.String>;
296
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
297
+ }>>;
298
+ }>, Schema.Struct<{
299
+ readonly kind: Schema.Literal<"package_ref">;
300
+ readonly package: Schema.Struct<{
301
+ readonly packageName: Schema.String;
302
+ readonly version: Schema.optionalKey<Schema.String>;
303
+ readonly entrypoint: Schema.String;
304
+ readonly source: Schema.Union<readonly [Schema.Struct<{
305
+ readonly mode: Schema.Literal<"direct">;
306
+ readonly registeredFrom: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"api">, Schema.Literal<"cli">, Schema.Literal<"mcp">, Schema.Literal<"import">]>>;
307
+ readonly bundleRef: Schema.optionalKey<Schema.String>;
308
+ readonly bundleSha256: Schema.optionalKey<Schema.String>;
309
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
310
+ }>, Schema.Struct<{
311
+ readonly mode: Schema.Literal<"git_backed">;
312
+ readonly repoBindingId: Schema.String;
313
+ readonly gitRef: Schema.String;
314
+ readonly commitSha: Schema.String;
315
+ readonly definitionPath: Schema.optionalKey<Schema.String>;
316
+ readonly packagePath: Schema.optionalKey<Schema.String>;
317
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
318
+ }>]>;
319
+ readonly runtime: Schema.optionalKey<Schema.String>;
320
+ readonly integritySha256: Schema.optionalKey<Schema.String>;
321
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
322
+ }>;
323
+ }>]>;
324
+ export declare const LoopRepeatUntilSafetyPolicy: Schema.Struct<{
325
+ readonly maxIterations: Schema.Int;
326
+ readonly timeoutSeconds: Schema.optionalKey<Schema.Int>;
327
+ }>;
328
+ export declare const LoopStepImplementation: Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
329
+ readonly kind: Schema.Literal<"built_in_action">;
330
+ readonly action: Schema.String;
331
+ readonly input: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
332
+ }>, Schema.Struct<{
333
+ readonly kind: Schema.Literal<"agent">;
334
+ readonly taskIdRef: Schema.String;
335
+ readonly agentId: Schema.String;
336
+ readonly agentRef: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
337
+ readonly agentId: Schema.String;
338
+ readonly alias: Schema.String;
339
+ }>, Schema.Struct<{
340
+ readonly agentId: Schema.String;
341
+ readonly version: Schema.Int;
342
+ readonly digest: Schema.String;
343
+ }>]>>;
344
+ /**
345
+ * Concrete backend requirement (legacy form). Omitted in the portable
346
+ * form: the runner resolves the backend from its advertised capabilities
347
+ * instead of a Herdr-specific identity.
348
+ */
349
+ readonly runtimeKind: Schema.optionalKey<Schema.String>;
350
+ /** Optional harness preference; 'preferred' may fall back, 'required' is a hard constraint. */
351
+ readonly harness: Schema.optionalKey<Schema.Struct<{
352
+ readonly implementation: Schema.String;
353
+ readonly kind: Schema.Union<readonly [Schema.Literal<"preferred">, Schema.Literal<"required">]>;
354
+ }>>;
355
+ /** Optional sandbox preference; 'preferred' may fall back, 'required' is a hard constraint. */
356
+ readonly sandbox: Schema.optionalKey<Schema.Struct<{
357
+ readonly implementation: Schema.String;
358
+ readonly kind: Schema.Union<readonly [Schema.Literal<"preferred">, Schema.Literal<"required">]>;
359
+ }>>;
360
+ /** Ordered model candidates replacing the Agent defaults for this Step. */
361
+ readonly models: Schema.optionalKey<Schema.$Array<Schema.Struct<{
362
+ readonly providerRef: Schema.String;
363
+ readonly modelRef: Schema.String;
364
+ readonly profile: Schema.optionalKey<Schema.String>;
365
+ readonly reasoning: Schema.optionalKey<Schema.String>;
366
+ }>>>;
367
+ /**
368
+ * Namespaced, versioned native extension overlays. Optional overlays are
369
+ * skipped when unsupported (the portable base runs unchanged); required
370
+ * overlays block scheduling when unavailable.
371
+ */
372
+ readonly extensions: Schema.optionalKey<Schema.$Array<Schema.Struct<{
373
+ readonly extensionId: Schema.String;
374
+ readonly version: Schema.Int;
375
+ readonly policy: Schema.Literals<readonly ["optional", "required"]>;
376
+ readonly requiredCapabilities: Schema.optionalKey<Schema.$Array<Schema.String>>;
377
+ readonly configuration: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<import("./run").SafeJson, import("./run").SafeJson, never, never>>>;
378
+ }>>>;
379
+ }>, Schema.Struct<{
380
+ readonly kind: Schema.Literal<"wait_for_event">;
381
+ readonly event: Schema.String;
382
+ readonly anyOf: Schema.optionalKey<Schema.$Array<Schema.String>>;
383
+ readonly correlationPath: Schema.$Array<Schema.String>;
384
+ readonly authPolicy: Schema.optionalKey<Schema.Struct<{
385
+ readonly mode: Schema.Union<readonly [Schema.Literal<"trusted_source">, Schema.Literal<"actor">]>;
386
+ readonly capability: Schema.optionalKey<Schema.String>;
387
+ }>>;
388
+ readonly cancellation: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"cancel">, Schema.Literal<"timeout">]>>;
389
+ readonly releaseRunner: Schema.optionalKey<Schema.Boolean>;
390
+ }>, Schema.Struct<{
391
+ readonly kind: Schema.Literal<"human_approval">;
392
+ readonly prompt: Schema.String;
393
+ readonly approvalPolicy: Schema.Struct<{
394
+ readonly mode: Schema.Literals<readonly ["auto_approve_low_risk", "require_other_project_member", "require_workspace_owner_or_admin"]>;
395
+ readonly requireDifferentApprover: Schema.optionalKey<Schema.Boolean>;
396
+ readonly autonomousAgentApprovalAllowed: Schema.Literal<false>;
397
+ readonly deniedViolationCodes: Schema.$Array<Schema.Literals<readonly ["autonomous_self_approval", "self_capability_escalation", "missing_required_approval", "unsafe_payload", "target_conflict"]>>;
398
+ }>;
399
+ }>, Schema.Struct<{
400
+ readonly kind: Schema.Literal<"runner_sandbox">;
401
+ readonly runnerSelector: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
402
+ readonly entrypoint: Schema.String;
403
+ readonly package: Schema.optionalKey<Schema.Struct<{
404
+ readonly packageName: Schema.String;
405
+ readonly version: Schema.optionalKey<Schema.String>;
406
+ readonly entrypoint: Schema.String;
407
+ readonly source: Schema.Union<readonly [Schema.Struct<{
408
+ readonly mode: Schema.Literal<"direct">;
409
+ readonly registeredFrom: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"api">, Schema.Literal<"cli">, Schema.Literal<"mcp">, Schema.Literal<"import">]>>;
410
+ readonly bundleRef: Schema.optionalKey<Schema.String>;
411
+ readonly bundleSha256: Schema.optionalKey<Schema.String>;
412
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
413
+ }>, Schema.Struct<{
414
+ readonly mode: Schema.Literal<"git_backed">;
415
+ readonly repoBindingId: Schema.String;
416
+ readonly gitRef: Schema.String;
417
+ readonly commitSha: Schema.String;
418
+ readonly definitionPath: Schema.optionalKey<Schema.String>;
419
+ readonly packagePath: Schema.optionalKey<Schema.String>;
420
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
421
+ }>]>;
422
+ readonly runtime: Schema.optionalKey<Schema.String>;
423
+ readonly integritySha256: Schema.optionalKey<Schema.String>;
424
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
425
+ }>>;
426
+ }>, Schema.Struct<{
427
+ readonly kind: Schema.Literal<"package_ref">;
428
+ readonly package: Schema.Struct<{
429
+ readonly packageName: Schema.String;
430
+ readonly version: Schema.optionalKey<Schema.String>;
431
+ readonly entrypoint: Schema.String;
432
+ readonly source: Schema.Union<readonly [Schema.Struct<{
433
+ readonly mode: Schema.Literal<"direct">;
434
+ readonly registeredFrom: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"api">, Schema.Literal<"cli">, Schema.Literal<"mcp">, Schema.Literal<"import">]>>;
435
+ readonly bundleRef: Schema.optionalKey<Schema.String>;
436
+ readonly bundleSha256: Schema.optionalKey<Schema.String>;
437
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
438
+ }>, Schema.Struct<{
439
+ readonly mode: Schema.Literal<"git_backed">;
440
+ readonly repoBindingId: Schema.String;
441
+ readonly gitRef: Schema.String;
442
+ readonly commitSha: Schema.String;
443
+ readonly definitionPath: Schema.optionalKey<Schema.String>;
444
+ readonly packagePath: Schema.optionalKey<Schema.String>;
445
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
446
+ }>]>;
447
+ readonly runtime: Schema.optionalKey<Schema.String>;
448
+ readonly integritySha256: Schema.optionalKey<Schema.String>;
449
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
450
+ }>;
451
+ }>]>, Schema.Struct<{
452
+ readonly kind: Schema.Literal<"repeat_until">;
453
+ readonly body: Schema.Union<readonly [Schema.Struct<{
454
+ readonly kind: Schema.Literal<"built_in_action">;
455
+ readonly action: Schema.String;
456
+ readonly input: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
457
+ }>, Schema.Struct<{
458
+ readonly kind: Schema.Literal<"agent">;
459
+ readonly taskIdRef: Schema.String;
460
+ readonly agentId: Schema.String;
461
+ readonly agentRef: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
462
+ readonly agentId: Schema.String;
463
+ readonly alias: Schema.String;
464
+ }>, Schema.Struct<{
465
+ readonly agentId: Schema.String;
466
+ readonly version: Schema.Int;
467
+ readonly digest: Schema.String;
468
+ }>]>>;
469
+ /**
470
+ * Concrete backend requirement (legacy form). Omitted in the portable
471
+ * form: the runner resolves the backend from its advertised capabilities
472
+ * instead of a Herdr-specific identity.
473
+ */
474
+ readonly runtimeKind: Schema.optionalKey<Schema.String>;
475
+ /** Optional harness preference; 'preferred' may fall back, 'required' is a hard constraint. */
476
+ readonly harness: Schema.optionalKey<Schema.Struct<{
477
+ readonly implementation: Schema.String;
478
+ readonly kind: Schema.Union<readonly [Schema.Literal<"preferred">, Schema.Literal<"required">]>;
479
+ }>>;
480
+ /** Optional sandbox preference; 'preferred' may fall back, 'required' is a hard constraint. */
481
+ readonly sandbox: Schema.optionalKey<Schema.Struct<{
482
+ readonly implementation: Schema.String;
483
+ readonly kind: Schema.Union<readonly [Schema.Literal<"preferred">, Schema.Literal<"required">]>;
484
+ }>>;
485
+ /** Ordered model candidates replacing the Agent defaults for this Step. */
486
+ readonly models: Schema.optionalKey<Schema.$Array<Schema.Struct<{
487
+ readonly providerRef: Schema.String;
488
+ readonly modelRef: Schema.String;
489
+ readonly profile: Schema.optionalKey<Schema.String>;
490
+ readonly reasoning: Schema.optionalKey<Schema.String>;
491
+ }>>>;
492
+ /**
493
+ * Namespaced, versioned native extension overlays. Optional overlays are
494
+ * skipped when unsupported (the portable base runs unchanged); required
495
+ * overlays block scheduling when unavailable.
496
+ */
497
+ readonly extensions: Schema.optionalKey<Schema.$Array<Schema.Struct<{
498
+ readonly extensionId: Schema.String;
499
+ readonly version: Schema.Int;
500
+ readonly policy: Schema.Literals<readonly ["optional", "required"]>;
501
+ readonly requiredCapabilities: Schema.optionalKey<Schema.$Array<Schema.String>>;
502
+ readonly configuration: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<import("./run").SafeJson, import("./run").SafeJson, never, never>>>;
503
+ }>>>;
504
+ }>, Schema.Struct<{
505
+ readonly kind: Schema.Literal<"wait_for_event">;
506
+ readonly event: Schema.String;
507
+ readonly anyOf: Schema.optionalKey<Schema.$Array<Schema.String>>;
508
+ readonly correlationPath: Schema.$Array<Schema.String>;
509
+ readonly authPolicy: Schema.optionalKey<Schema.Struct<{
510
+ readonly mode: Schema.Union<readonly [Schema.Literal<"trusted_source">, Schema.Literal<"actor">]>;
511
+ readonly capability: Schema.optionalKey<Schema.String>;
512
+ }>>;
513
+ readonly cancellation: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"cancel">, Schema.Literal<"timeout">]>>;
514
+ readonly releaseRunner: Schema.optionalKey<Schema.Boolean>;
515
+ }>, Schema.Struct<{
516
+ readonly kind: Schema.Literal<"human_approval">;
517
+ readonly prompt: Schema.String;
518
+ readonly approvalPolicy: Schema.Struct<{
519
+ readonly mode: Schema.Literals<readonly ["auto_approve_low_risk", "require_other_project_member", "require_workspace_owner_or_admin"]>;
520
+ readonly requireDifferentApprover: Schema.optionalKey<Schema.Boolean>;
521
+ readonly autonomousAgentApprovalAllowed: Schema.Literal<false>;
522
+ readonly deniedViolationCodes: Schema.$Array<Schema.Literals<readonly ["autonomous_self_approval", "self_capability_escalation", "missing_required_approval", "unsafe_payload", "target_conflict"]>>;
523
+ }>;
524
+ }>, Schema.Struct<{
525
+ readonly kind: Schema.Literal<"runner_sandbox">;
526
+ readonly runnerSelector: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
527
+ readonly entrypoint: Schema.String;
528
+ readonly package: Schema.optionalKey<Schema.Struct<{
529
+ readonly packageName: Schema.String;
530
+ readonly version: Schema.optionalKey<Schema.String>;
531
+ readonly entrypoint: Schema.String;
532
+ readonly source: Schema.Union<readonly [Schema.Struct<{
533
+ readonly mode: Schema.Literal<"direct">;
534
+ readonly registeredFrom: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"api">, Schema.Literal<"cli">, Schema.Literal<"mcp">, Schema.Literal<"import">]>>;
535
+ readonly bundleRef: Schema.optionalKey<Schema.String>;
536
+ readonly bundleSha256: Schema.optionalKey<Schema.String>;
537
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
538
+ }>, Schema.Struct<{
539
+ readonly mode: Schema.Literal<"git_backed">;
540
+ readonly repoBindingId: Schema.String;
541
+ readonly gitRef: Schema.String;
542
+ readonly commitSha: Schema.String;
543
+ readonly definitionPath: Schema.optionalKey<Schema.String>;
544
+ readonly packagePath: Schema.optionalKey<Schema.String>;
545
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
546
+ }>]>;
547
+ readonly runtime: Schema.optionalKey<Schema.String>;
548
+ readonly integritySha256: Schema.optionalKey<Schema.String>;
549
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
550
+ }>>;
551
+ }>, Schema.Struct<{
552
+ readonly kind: Schema.Literal<"package_ref">;
553
+ readonly package: Schema.Struct<{
554
+ readonly packageName: Schema.String;
555
+ readonly version: Schema.optionalKey<Schema.String>;
556
+ readonly entrypoint: Schema.String;
557
+ readonly source: Schema.Union<readonly [Schema.Struct<{
558
+ readonly mode: Schema.Literal<"direct">;
559
+ readonly registeredFrom: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"api">, Schema.Literal<"cli">, Schema.Literal<"mcp">, Schema.Literal<"import">]>>;
560
+ readonly bundleRef: Schema.optionalKey<Schema.String>;
561
+ readonly bundleSha256: Schema.optionalKey<Schema.String>;
562
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
563
+ }>, Schema.Struct<{
564
+ readonly mode: Schema.Literal<"git_backed">;
565
+ readonly repoBindingId: Schema.String;
566
+ readonly gitRef: Schema.String;
567
+ readonly commitSha: Schema.String;
568
+ readonly definitionPath: Schema.optionalKey<Schema.String>;
569
+ readonly packagePath: Schema.optionalKey<Schema.String>;
570
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
571
+ }>]>;
572
+ readonly runtime: Schema.optionalKey<Schema.String>;
573
+ readonly integritySha256: Schema.optionalKey<Schema.String>;
574
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
575
+ }>;
576
+ }>]>;
577
+ readonly convergenceOutput: Schema.String;
578
+ readonly safetyPolicy: Schema.Struct<{
579
+ readonly maxIterations: Schema.Int;
580
+ readonly timeoutSeconds: Schema.optionalKey<Schema.Int>;
581
+ }>;
582
+ }>, Schema.Struct<{
583
+ readonly kind: Schema.Literal<"call_loop">;
584
+ readonly loop: Schema.Union<readonly [Schema.Struct<{
585
+ readonly loopId: Schema.String;
586
+ readonly alias: Schema.String;
587
+ }>, Schema.Struct<{
588
+ readonly loopId: Schema.String;
589
+ readonly versionId: Schema.String;
590
+ }>, Schema.Struct<{
591
+ readonly loopId: Schema.String;
592
+ readonly version: Schema.Int;
593
+ }>, Schema.Struct<{
594
+ readonly loopId: Schema.String;
595
+ readonly digest: Schema.String;
596
+ }>, Schema.Struct<{
597
+ readonly slug: Schema.String;
598
+ readonly alias: Schema.String;
599
+ }>, Schema.Struct<{
600
+ readonly slug: Schema.String;
601
+ readonly version: Schema.Int;
602
+ }>, Schema.Struct<{
603
+ readonly slug: Schema.String;
604
+ readonly digest: Schema.String;
605
+ }>]>;
606
+ readonly mode: Schema.Literal<"awaited">;
607
+ }>]>;
608
+ export declare const LoopStep: Schema.Struct<{
609
+ readonly key: Schema.String;
610
+ readonly title: Schema.String;
611
+ readonly required: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
612
+ readonly dependsOn: Schema.$Array<Schema.String>;
613
+ readonly requiredContext: Schema.$Array<Schema.Struct<{
614
+ readonly kind: Schema.Literals<readonly ["kit", "memory", "decision", "session", "session_update", "proposal", "task_dependency", "repo_binding", "agent_environment", "loop_step"]>;
615
+ readonly id: Schema.optionalKey<Schema.String>;
616
+ readonly idRef: Schema.optionalKey<Schema.String>;
617
+ readonly reason: Schema.String;
618
+ readonly required: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
619
+ }>>;
620
+ readonly guards: Schema.$Array<Schema.Struct<{
621
+ readonly key: Schema.String;
622
+ readonly source: Schema.Literals<readonly ["trigger_event", "task", "project", "proposal", "decision", "step_attempt", "change_request", "context_feedback", "run", "project_policy"]>;
623
+ readonly path: Schema.$Array<Schema.String>;
624
+ readonly operator: Schema.Literals<readonly ["equals", "not_equals", "in", "not_in", "exists", "not_exists"]>;
625
+ readonly value: Schema.optionalKey<Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean]>>;
626
+ readonly values: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean]>>>;
627
+ }>>;
628
+ readonly implementation: Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
629
+ readonly kind: Schema.Literal<"built_in_action">;
630
+ readonly action: Schema.String;
631
+ readonly input: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
632
+ }>, Schema.Struct<{
633
+ readonly kind: Schema.Literal<"agent">;
634
+ readonly taskIdRef: Schema.String;
635
+ readonly agentId: Schema.String;
636
+ readonly agentRef: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
637
+ readonly agentId: Schema.String;
638
+ readonly alias: Schema.String;
639
+ }>, Schema.Struct<{
640
+ readonly agentId: Schema.String;
641
+ readonly version: Schema.Int;
642
+ readonly digest: Schema.String;
643
+ }>]>>;
644
+ /**
645
+ * Concrete backend requirement (legacy form). Omitted in the portable
646
+ * form: the runner resolves the backend from its advertised capabilities
647
+ * instead of a Herdr-specific identity.
648
+ */
649
+ readonly runtimeKind: Schema.optionalKey<Schema.String>;
650
+ /** Optional harness preference; 'preferred' may fall back, 'required' is a hard constraint. */
651
+ readonly harness: Schema.optionalKey<Schema.Struct<{
652
+ readonly implementation: Schema.String;
653
+ readonly kind: Schema.Union<readonly [Schema.Literal<"preferred">, Schema.Literal<"required">]>;
654
+ }>>;
655
+ /** Optional sandbox preference; 'preferred' may fall back, 'required' is a hard constraint. */
656
+ readonly sandbox: Schema.optionalKey<Schema.Struct<{
657
+ readonly implementation: Schema.String;
658
+ readonly kind: Schema.Union<readonly [Schema.Literal<"preferred">, Schema.Literal<"required">]>;
659
+ }>>;
660
+ /** Ordered model candidates replacing the Agent defaults for this Step. */
661
+ readonly models: Schema.optionalKey<Schema.$Array<Schema.Struct<{
662
+ readonly providerRef: Schema.String;
663
+ readonly modelRef: Schema.String;
664
+ readonly profile: Schema.optionalKey<Schema.String>;
665
+ readonly reasoning: Schema.optionalKey<Schema.String>;
666
+ }>>>;
667
+ /**
668
+ * Namespaced, versioned native extension overlays. Optional overlays are
669
+ * skipped when unsupported (the portable base runs unchanged); required
670
+ * overlays block scheduling when unavailable.
671
+ */
672
+ readonly extensions: Schema.optionalKey<Schema.$Array<Schema.Struct<{
673
+ readonly extensionId: Schema.String;
674
+ readonly version: Schema.Int;
675
+ readonly policy: Schema.Literals<readonly ["optional", "required"]>;
676
+ readonly requiredCapabilities: Schema.optionalKey<Schema.$Array<Schema.String>>;
677
+ readonly configuration: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<import("./run").SafeJson, import("./run").SafeJson, never, never>>>;
678
+ }>>>;
679
+ }>, Schema.Struct<{
680
+ readonly kind: Schema.Literal<"wait_for_event">;
681
+ readonly event: Schema.String;
682
+ readonly anyOf: Schema.optionalKey<Schema.$Array<Schema.String>>;
683
+ readonly correlationPath: Schema.$Array<Schema.String>;
684
+ readonly authPolicy: Schema.optionalKey<Schema.Struct<{
685
+ readonly mode: Schema.Union<readonly [Schema.Literal<"trusted_source">, Schema.Literal<"actor">]>;
686
+ readonly capability: Schema.optionalKey<Schema.String>;
687
+ }>>;
688
+ readonly cancellation: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"cancel">, Schema.Literal<"timeout">]>>;
689
+ readonly releaseRunner: Schema.optionalKey<Schema.Boolean>;
690
+ }>, Schema.Struct<{
691
+ readonly kind: Schema.Literal<"human_approval">;
692
+ readonly prompt: Schema.String;
693
+ readonly approvalPolicy: Schema.Struct<{
694
+ readonly mode: Schema.Literals<readonly ["auto_approve_low_risk", "require_other_project_member", "require_workspace_owner_or_admin"]>;
695
+ readonly requireDifferentApprover: Schema.optionalKey<Schema.Boolean>;
696
+ readonly autonomousAgentApprovalAllowed: Schema.Literal<false>;
697
+ readonly deniedViolationCodes: Schema.$Array<Schema.Literals<readonly ["autonomous_self_approval", "self_capability_escalation", "missing_required_approval", "unsafe_payload", "target_conflict"]>>;
698
+ }>;
699
+ }>, Schema.Struct<{
700
+ readonly kind: Schema.Literal<"runner_sandbox">;
701
+ readonly runnerSelector: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
702
+ readonly entrypoint: Schema.String;
703
+ readonly package: Schema.optionalKey<Schema.Struct<{
704
+ readonly packageName: Schema.String;
705
+ readonly version: Schema.optionalKey<Schema.String>;
706
+ readonly entrypoint: Schema.String;
707
+ readonly source: Schema.Union<readonly [Schema.Struct<{
708
+ readonly mode: Schema.Literal<"direct">;
709
+ readonly registeredFrom: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"api">, Schema.Literal<"cli">, Schema.Literal<"mcp">, Schema.Literal<"import">]>>;
710
+ readonly bundleRef: Schema.optionalKey<Schema.String>;
711
+ readonly bundleSha256: Schema.optionalKey<Schema.String>;
712
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
713
+ }>, Schema.Struct<{
714
+ readonly mode: Schema.Literal<"git_backed">;
715
+ readonly repoBindingId: Schema.String;
716
+ readonly gitRef: Schema.String;
717
+ readonly commitSha: Schema.String;
718
+ readonly definitionPath: Schema.optionalKey<Schema.String>;
719
+ readonly packagePath: Schema.optionalKey<Schema.String>;
720
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
721
+ }>]>;
722
+ readonly runtime: Schema.optionalKey<Schema.String>;
723
+ readonly integritySha256: Schema.optionalKey<Schema.String>;
724
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
725
+ }>>;
726
+ }>, Schema.Struct<{
727
+ readonly kind: Schema.Literal<"package_ref">;
728
+ readonly package: Schema.Struct<{
729
+ readonly packageName: Schema.String;
730
+ readonly version: Schema.optionalKey<Schema.String>;
731
+ readonly entrypoint: Schema.String;
732
+ readonly source: Schema.Union<readonly [Schema.Struct<{
733
+ readonly mode: Schema.Literal<"direct">;
734
+ readonly registeredFrom: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"api">, Schema.Literal<"cli">, Schema.Literal<"mcp">, Schema.Literal<"import">]>>;
735
+ readonly bundleRef: Schema.optionalKey<Schema.String>;
736
+ readonly bundleSha256: Schema.optionalKey<Schema.String>;
737
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
738
+ }>, Schema.Struct<{
739
+ readonly mode: Schema.Literal<"git_backed">;
740
+ readonly repoBindingId: Schema.String;
741
+ readonly gitRef: Schema.String;
742
+ readonly commitSha: Schema.String;
743
+ readonly definitionPath: Schema.optionalKey<Schema.String>;
744
+ readonly packagePath: Schema.optionalKey<Schema.String>;
745
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
746
+ }>]>;
747
+ readonly runtime: Schema.optionalKey<Schema.String>;
748
+ readonly integritySha256: Schema.optionalKey<Schema.String>;
749
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
750
+ }>;
751
+ }>]>, Schema.Struct<{
752
+ readonly kind: Schema.Literal<"repeat_until">;
753
+ readonly body: Schema.Union<readonly [Schema.Struct<{
754
+ readonly kind: Schema.Literal<"built_in_action">;
755
+ readonly action: Schema.String;
756
+ readonly input: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
757
+ }>, Schema.Struct<{
758
+ readonly kind: Schema.Literal<"agent">;
759
+ readonly taskIdRef: Schema.String;
760
+ readonly agentId: Schema.String;
761
+ readonly agentRef: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
762
+ readonly agentId: Schema.String;
763
+ readonly alias: Schema.String;
764
+ }>, Schema.Struct<{
765
+ readonly agentId: Schema.String;
766
+ readonly version: Schema.Int;
767
+ readonly digest: Schema.String;
768
+ }>]>>;
769
+ /**
770
+ * Concrete backend requirement (legacy form). Omitted in the portable
771
+ * form: the runner resolves the backend from its advertised capabilities
772
+ * instead of a Herdr-specific identity.
773
+ */
774
+ readonly runtimeKind: Schema.optionalKey<Schema.String>;
775
+ /** Optional harness preference; 'preferred' may fall back, 'required' is a hard constraint. */
776
+ readonly harness: Schema.optionalKey<Schema.Struct<{
777
+ readonly implementation: Schema.String;
778
+ readonly kind: Schema.Union<readonly [Schema.Literal<"preferred">, Schema.Literal<"required">]>;
779
+ }>>;
780
+ /** Optional sandbox preference; 'preferred' may fall back, 'required' is a hard constraint. */
781
+ readonly sandbox: Schema.optionalKey<Schema.Struct<{
782
+ readonly implementation: Schema.String;
783
+ readonly kind: Schema.Union<readonly [Schema.Literal<"preferred">, Schema.Literal<"required">]>;
784
+ }>>;
785
+ /** Ordered model candidates replacing the Agent defaults for this Step. */
786
+ readonly models: Schema.optionalKey<Schema.$Array<Schema.Struct<{
787
+ readonly providerRef: Schema.String;
788
+ readonly modelRef: Schema.String;
789
+ readonly profile: Schema.optionalKey<Schema.String>;
790
+ readonly reasoning: Schema.optionalKey<Schema.String>;
791
+ }>>>;
792
+ /**
793
+ * Namespaced, versioned native extension overlays. Optional overlays are
794
+ * skipped when unsupported (the portable base runs unchanged); required
795
+ * overlays block scheduling when unavailable.
796
+ */
797
+ readonly extensions: Schema.optionalKey<Schema.$Array<Schema.Struct<{
798
+ readonly extensionId: Schema.String;
799
+ readonly version: Schema.Int;
800
+ readonly policy: Schema.Literals<readonly ["optional", "required"]>;
801
+ readonly requiredCapabilities: Schema.optionalKey<Schema.$Array<Schema.String>>;
802
+ readonly configuration: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<import("./run").SafeJson, import("./run").SafeJson, never, never>>>;
803
+ }>>>;
804
+ }>, Schema.Struct<{
805
+ readonly kind: Schema.Literal<"wait_for_event">;
806
+ readonly event: Schema.String;
807
+ readonly anyOf: Schema.optionalKey<Schema.$Array<Schema.String>>;
808
+ readonly correlationPath: Schema.$Array<Schema.String>;
809
+ readonly authPolicy: Schema.optionalKey<Schema.Struct<{
810
+ readonly mode: Schema.Union<readonly [Schema.Literal<"trusted_source">, Schema.Literal<"actor">]>;
811
+ readonly capability: Schema.optionalKey<Schema.String>;
812
+ }>>;
813
+ readonly cancellation: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"cancel">, Schema.Literal<"timeout">]>>;
814
+ readonly releaseRunner: Schema.optionalKey<Schema.Boolean>;
815
+ }>, Schema.Struct<{
816
+ readonly kind: Schema.Literal<"human_approval">;
817
+ readonly prompt: Schema.String;
818
+ readonly approvalPolicy: Schema.Struct<{
819
+ readonly mode: Schema.Literals<readonly ["auto_approve_low_risk", "require_other_project_member", "require_workspace_owner_or_admin"]>;
820
+ readonly requireDifferentApprover: Schema.optionalKey<Schema.Boolean>;
821
+ readonly autonomousAgentApprovalAllowed: Schema.Literal<false>;
822
+ readonly deniedViolationCodes: Schema.$Array<Schema.Literals<readonly ["autonomous_self_approval", "self_capability_escalation", "missing_required_approval", "unsafe_payload", "target_conflict"]>>;
823
+ }>;
824
+ }>, Schema.Struct<{
825
+ readonly kind: Schema.Literal<"runner_sandbox">;
826
+ readonly runnerSelector: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
827
+ readonly entrypoint: Schema.String;
828
+ readonly package: Schema.optionalKey<Schema.Struct<{
829
+ readonly packageName: Schema.String;
830
+ readonly version: Schema.optionalKey<Schema.String>;
831
+ readonly entrypoint: Schema.String;
832
+ readonly source: Schema.Union<readonly [Schema.Struct<{
833
+ readonly mode: Schema.Literal<"direct">;
834
+ readonly registeredFrom: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"api">, Schema.Literal<"cli">, Schema.Literal<"mcp">, Schema.Literal<"import">]>>;
835
+ readonly bundleRef: Schema.optionalKey<Schema.String>;
836
+ readonly bundleSha256: Schema.optionalKey<Schema.String>;
837
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
838
+ }>, Schema.Struct<{
839
+ readonly mode: Schema.Literal<"git_backed">;
840
+ readonly repoBindingId: Schema.String;
841
+ readonly gitRef: Schema.String;
842
+ readonly commitSha: Schema.String;
843
+ readonly definitionPath: Schema.optionalKey<Schema.String>;
844
+ readonly packagePath: Schema.optionalKey<Schema.String>;
845
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
846
+ }>]>;
847
+ readonly runtime: Schema.optionalKey<Schema.String>;
848
+ readonly integritySha256: Schema.optionalKey<Schema.String>;
849
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
850
+ }>>;
851
+ }>, Schema.Struct<{
852
+ readonly kind: Schema.Literal<"package_ref">;
853
+ readonly package: Schema.Struct<{
854
+ readonly packageName: Schema.String;
855
+ readonly version: Schema.optionalKey<Schema.String>;
856
+ readonly entrypoint: Schema.String;
857
+ readonly source: Schema.Union<readonly [Schema.Struct<{
858
+ readonly mode: Schema.Literal<"direct">;
859
+ readonly registeredFrom: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"api">, Schema.Literal<"cli">, Schema.Literal<"mcp">, Schema.Literal<"import">]>>;
860
+ readonly bundleRef: Schema.optionalKey<Schema.String>;
861
+ readonly bundleSha256: Schema.optionalKey<Schema.String>;
862
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
863
+ }>, Schema.Struct<{
864
+ readonly mode: Schema.Literal<"git_backed">;
865
+ readonly repoBindingId: Schema.String;
866
+ readonly gitRef: Schema.String;
867
+ readonly commitSha: Schema.String;
868
+ readonly definitionPath: Schema.optionalKey<Schema.String>;
869
+ readonly packagePath: Schema.optionalKey<Schema.String>;
870
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
871
+ }>]>;
872
+ readonly runtime: Schema.optionalKey<Schema.String>;
873
+ readonly integritySha256: Schema.optionalKey<Schema.String>;
874
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
875
+ }>;
876
+ }>]>;
877
+ readonly convergenceOutput: Schema.String;
878
+ readonly safetyPolicy: Schema.Struct<{
879
+ readonly maxIterations: Schema.Int;
880
+ readonly timeoutSeconds: Schema.optionalKey<Schema.Int>;
881
+ }>;
882
+ }>, Schema.Struct<{
883
+ readonly kind: Schema.Literal<"call_loop">;
884
+ readonly loop: Schema.Union<readonly [Schema.Struct<{
885
+ readonly loopId: Schema.String;
886
+ readonly alias: Schema.String;
887
+ }>, Schema.Struct<{
888
+ readonly loopId: Schema.String;
889
+ readonly versionId: Schema.String;
890
+ }>, Schema.Struct<{
891
+ readonly loopId: Schema.String;
892
+ readonly version: Schema.Int;
893
+ }>, Schema.Struct<{
894
+ readonly loopId: Schema.String;
895
+ readonly digest: Schema.String;
896
+ }>, Schema.Struct<{
897
+ readonly slug: Schema.String;
898
+ readonly alias: Schema.String;
899
+ }>, Schema.Struct<{
900
+ readonly slug: Schema.String;
901
+ readonly version: Schema.Int;
902
+ }>, Schema.Struct<{
903
+ readonly slug: Schema.String;
904
+ readonly digest: Schema.String;
905
+ }>]>;
906
+ readonly mode: Schema.Literal<"awaited">;
907
+ }>]>;
908
+ readonly inputSchemaRef: Schema.Struct<{
909
+ readonly kind: Schema.Literal<"typebox_ref">;
910
+ readonly name: Schema.String;
911
+ readonly version: Schema.optionalKey<Schema.String>;
912
+ readonly sha256: Schema.optionalKey<Schema.String>;
913
+ }>;
914
+ readonly outputSchemaRef: Schema.Struct<{
915
+ readonly kind: Schema.Literal<"typebox_ref">;
916
+ readonly name: Schema.String;
917
+ readonly version: Schema.optionalKey<Schema.String>;
918
+ readonly sha256: Schema.optionalKey<Schema.String>;
919
+ }>;
920
+ readonly inputBindings: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
921
+ readonly key: Schema.String;
922
+ readonly required: Schema.optionalKey<Schema.Boolean>;
923
+ readonly source: Schema.Literal<"trigger_event">;
924
+ readonly path: Schema.$Array<Schema.String>;
925
+ }>, Schema.Struct<{
926
+ readonly key: Schema.String;
927
+ readonly required: Schema.optionalKey<Schema.Boolean>;
928
+ readonly source: Schema.Literal<"subject">;
929
+ readonly path: Schema.$Array<Schema.String>;
930
+ }>, Schema.Struct<{
931
+ readonly key: Schema.String;
932
+ readonly required: Schema.optionalKey<Schema.Boolean>;
933
+ readonly source: Schema.Literal<"context">;
934
+ readonly path: Schema.$Array<Schema.String>;
935
+ }>, Schema.Struct<{
936
+ readonly key: Schema.String;
937
+ readonly required: Schema.optionalKey<Schema.Boolean>;
938
+ readonly source: Schema.Literal<"step_output">;
939
+ readonly stepKey: Schema.String;
940
+ readonly outputKey: Schema.String;
941
+ readonly path: Schema.optionalKey<Schema.$Array<Schema.String>>;
942
+ }>, Schema.Struct<{
943
+ readonly key: Schema.String;
944
+ readonly required: Schema.optionalKey<Schema.Boolean>;
945
+ readonly source: Schema.Literal<"run">;
946
+ readonly path: Schema.$Array<Schema.String>;
947
+ }>, Schema.Struct<{
948
+ readonly key: Schema.String;
949
+ readonly required: Schema.optionalKey<Schema.Boolean>;
950
+ readonly source: Schema.Literal<"literal">;
951
+ readonly value: Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>;
952
+ }>]>>;
953
+ readonly outputRefs: Schema.$Array<Schema.Struct<{
954
+ readonly key: Schema.String;
955
+ readonly schemaRef: Schema.optionalKey<Schema.Struct<{
956
+ readonly kind: Schema.Literal<"typebox_ref">;
957
+ readonly name: Schema.String;
958
+ readonly version: Schema.optionalKey<Schema.String>;
959
+ readonly sha256: Schema.optionalKey<Schema.String>;
960
+ }>>;
961
+ readonly path: Schema.optionalKey<Schema.$Array<Schema.String>>;
962
+ readonly required: Schema.optionalKey<Schema.Boolean>;
963
+ }>>;
964
+ readonly allowedCapabilities: Schema.$Array<Schema.Struct<{
965
+ readonly capability: Schema.Literals<readonly ["read_task", "read_repo_binding", "read_agent_environment", "read_kit", "update_task_status", "read_change_request", "read_change_request_review", "read_task_link", "refresh_change_request_metadata", "record_change_request_review", "record_session_update", "create_task_link", "create_task_dependency", "create_task_asset", "create_follow_up_task", "execute_agent", "read_step_attempt", "record_task_thread_entry", "write_provider_repository", "write_provider_change_request", "publish_provider_check", "write_provider_comment", "request_provider_changes", "approve_provider_change_request", "merge_provider_change_request", "wait_for_event", "request_human_approval", "execute_package_ref", "read_context_feedback", "read_session_update", "read_repo_binding", "read_agent_environment", "read_kit", "read_memory", "read_decision", "create_task_dependency", "propose_memory", "propose_kit", "propose_decision", "propose_agent_environment_policy", "propose_project_context", "propose_context_relevance", "execute_runner_sandbox"]>;
966
+ readonly scope: Schema.optionalKey<Schema.Struct<{
967
+ readonly kind: Schema.Literals<readonly ["workspace", "project", "task", "change_request", "step_attempt", "run", "repo_binding", "provider_host"]>;
968
+ readonly id: Schema.optionalKey<Schema.String>;
969
+ readonly idRef: Schema.optionalKey<Schema.String>;
970
+ readonly value: Schema.optionalKey<Schema.String>;
971
+ }>>;
972
+ readonly reason: Schema.optionalKey<Schema.String>;
973
+ }>>;
974
+ readonly retryPolicy: Schema.Struct<{
975
+ readonly maxAttempts: Schema.Int;
976
+ readonly backoff: Schema.Literals<readonly ["none", "fixed", "exponential"]>;
977
+ readonly delaySeconds: Schema.optionalKey<Schema.Int>;
978
+ }>;
979
+ readonly timeoutPolicy: Schema.Struct<{
980
+ readonly timeoutSeconds: Schema.Int;
981
+ }>;
982
+ readonly metadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
983
+ }>;
984
+ export declare const LoopStepOutput: Schema.Struct<{
985
+ readonly stepKey: Schema.String;
986
+ readonly outputSchemaRef: Schema.Struct<{
987
+ readonly kind: Schema.Literal<"typebox_ref">;
988
+ readonly name: Schema.String;
989
+ readonly version: Schema.optionalKey<Schema.String>;
990
+ readonly sha256: Schema.optionalKey<Schema.String>;
991
+ }>;
992
+ readonly summary: Schema.String;
993
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
994
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
995
+ readonly refs: Schema.$Array<Schema.Struct<{
996
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
997
+ readonly id: Schema.optionalKey<Schema.String>;
998
+ readonly externalId: Schema.optionalKey<Schema.String>;
999
+ readonly provider: Schema.optionalKey<Schema.String>;
1000
+ readonly title: Schema.optionalKey<Schema.String>;
1001
+ }>>;
1002
+ }>;
1003
+ export declare const RunStepState: Schema.Union<readonly [Schema.Struct<{
1004
+ readonly stepKey: Schema.String;
1005
+ readonly sequence: Schema.Int;
1006
+ readonly attempts: Schema.Int;
1007
+ readonly stepAttemptId: Schema.optionalKey<Schema.String>;
1008
+ readonly startedAt: Schema.optionalKey<Schema.String>;
1009
+ readonly endedAt: Schema.optionalKey<Schema.String>;
1010
+ readonly output: Schema.optionalKey<Schema.Struct<{
1011
+ readonly stepKey: Schema.String;
1012
+ readonly outputSchemaRef: Schema.Struct<{
1013
+ readonly kind: Schema.Literal<"typebox_ref">;
1014
+ readonly name: Schema.String;
1015
+ readonly version: Schema.optionalKey<Schema.String>;
1016
+ readonly sha256: Schema.optionalKey<Schema.String>;
1017
+ }>;
1018
+ readonly summary: Schema.String;
1019
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
1020
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
1021
+ readonly refs: Schema.$Array<Schema.Struct<{
1022
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
1023
+ readonly id: Schema.optionalKey<Schema.String>;
1024
+ readonly externalId: Schema.optionalKey<Schema.String>;
1025
+ readonly provider: Schema.optionalKey<Schema.String>;
1026
+ readonly title: Schema.optionalKey<Schema.String>;
1027
+ }>>;
1028
+ }>>;
1029
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
1030
+ readonly updatedAt: Schema.String;
1031
+ readonly required: Schema.Literal<true>;
1032
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
1033
+ }>, Schema.Struct<{
1034
+ readonly stepKey: Schema.String;
1035
+ readonly sequence: Schema.Int;
1036
+ readonly attempts: Schema.Int;
1037
+ readonly stepAttemptId: Schema.optionalKey<Schema.String>;
1038
+ readonly startedAt: Schema.optionalKey<Schema.String>;
1039
+ readonly endedAt: Schema.optionalKey<Schema.String>;
1040
+ readonly output: Schema.optionalKey<Schema.Struct<{
1041
+ readonly stepKey: Schema.String;
1042
+ readonly outputSchemaRef: Schema.Struct<{
1043
+ readonly kind: Schema.Literal<"typebox_ref">;
1044
+ readonly name: Schema.String;
1045
+ readonly version: Schema.optionalKey<Schema.String>;
1046
+ readonly sha256: Schema.optionalKey<Schema.String>;
1047
+ }>;
1048
+ readonly summary: Schema.String;
1049
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
1050
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
1051
+ readonly refs: Schema.$Array<Schema.Struct<{
1052
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
1053
+ readonly id: Schema.optionalKey<Schema.String>;
1054
+ readonly externalId: Schema.optionalKey<Schema.String>;
1055
+ readonly provider: Schema.optionalKey<Schema.String>;
1056
+ readonly title: Schema.optionalKey<Schema.String>;
1057
+ }>>;
1058
+ }>>;
1059
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
1060
+ readonly updatedAt: Schema.String;
1061
+ readonly required: Schema.Literal<false>;
1062
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "skipped", "canceled"]>;
1063
+ }>]>;
1064
+ export declare const RunState: Schema.Struct<{
1065
+ readonly stepStates: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
1066
+ readonly stepKey: Schema.String;
1067
+ readonly sequence: Schema.Int;
1068
+ readonly attempts: Schema.Int;
1069
+ readonly stepAttemptId: Schema.optionalKey<Schema.String>;
1070
+ readonly startedAt: Schema.optionalKey<Schema.String>;
1071
+ readonly endedAt: Schema.optionalKey<Schema.String>;
1072
+ readonly output: Schema.optionalKey<Schema.Struct<{
1073
+ readonly stepKey: Schema.String;
1074
+ readonly outputSchemaRef: Schema.Struct<{
1075
+ readonly kind: Schema.Literal<"typebox_ref">;
1076
+ readonly name: Schema.String;
1077
+ readonly version: Schema.optionalKey<Schema.String>;
1078
+ readonly sha256: Schema.optionalKey<Schema.String>;
1079
+ }>;
1080
+ readonly summary: Schema.String;
1081
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
1082
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
1083
+ readonly refs: Schema.$Array<Schema.Struct<{
1084
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
1085
+ readonly id: Schema.optionalKey<Schema.String>;
1086
+ readonly externalId: Schema.optionalKey<Schema.String>;
1087
+ readonly provider: Schema.optionalKey<Schema.String>;
1088
+ readonly title: Schema.optionalKey<Schema.String>;
1089
+ }>>;
1090
+ }>>;
1091
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
1092
+ readonly updatedAt: Schema.String;
1093
+ readonly required: Schema.Literal<true>;
1094
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
1095
+ }>, Schema.Struct<{
1096
+ readonly stepKey: Schema.String;
1097
+ readonly sequence: Schema.Int;
1098
+ readonly attempts: Schema.Int;
1099
+ readonly stepAttemptId: Schema.optionalKey<Schema.String>;
1100
+ readonly startedAt: Schema.optionalKey<Schema.String>;
1101
+ readonly endedAt: Schema.optionalKey<Schema.String>;
1102
+ readonly output: Schema.optionalKey<Schema.Struct<{
1103
+ readonly stepKey: Schema.String;
1104
+ readonly outputSchemaRef: Schema.Struct<{
1105
+ readonly kind: Schema.Literal<"typebox_ref">;
1106
+ readonly name: Schema.String;
1107
+ readonly version: Schema.optionalKey<Schema.String>;
1108
+ readonly sha256: Schema.optionalKey<Schema.String>;
1109
+ }>;
1110
+ readonly summary: Schema.String;
1111
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
1112
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
1113
+ readonly refs: Schema.$Array<Schema.Struct<{
1114
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
1115
+ readonly id: Schema.optionalKey<Schema.String>;
1116
+ readonly externalId: Schema.optionalKey<Schema.String>;
1117
+ readonly provider: Schema.optionalKey<Schema.String>;
1118
+ readonly title: Schema.optionalKey<Schema.String>;
1119
+ }>>;
1120
+ }>>;
1121
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
1122
+ readonly updatedAt: Schema.String;
1123
+ readonly required: Schema.Literal<false>;
1124
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "skipped", "canceled"]>;
1125
+ }>]>>;
1126
+ readonly summary: Schema.optionalKey<Schema.String>;
1127
+ readonly resultMetadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
1128
+ }>;
1129
+ /** Why a program Run is waiting, derived from its open deferreds. */
1130
+ export declare const RunWaiting: Schema.Union<readonly [Schema.Struct<{
1131
+ readonly kind: Schema.Literal<"question">;
1132
+ readonly name: Schema.String;
1133
+ readonly questionId: Schema.String;
1134
+ }>, Schema.Struct<{
1135
+ readonly kind: Schema.Literal<"clock">;
1136
+ readonly name: Schema.String;
1137
+ readonly firesAt: Schema.String;
1138
+ }>, Schema.Struct<{
1139
+ readonly kind: Schema.Literal<"event">;
1140
+ readonly name: Schema.String;
1141
+ readonly event: Schema.String;
1142
+ readonly timesOutAt: Schema.String;
1143
+ }>, Schema.Struct<{
1144
+ readonly kind: Schema.Literal<"step">;
1145
+ readonly name: Schema.String;
1146
+ readonly stepAttemptId: Schema.String;
1147
+ }>, Schema.Struct<{
1148
+ readonly kind: Schema.Literal<"child">;
1149
+ readonly name: Schema.String;
1150
+ readonly runId: Schema.String;
1151
+ }>, Schema.Struct<{
1152
+ readonly kind: Schema.Literal<"verification">;
1153
+ readonly name: Schema.String;
1154
+ readonly verificationId: Schema.String;
1155
+ }>]>;
1156
+ /** A check a Runner ran at a tree for one of the Run's `verify` Steps. Evidence, unlike an Output's claims. */
1157
+ export declare const RunEvidence: Schema.Struct<{
1158
+ readonly id: Schema.String;
1159
+ readonly step: Schema.String;
1160
+ readonly name: Schema.String;
1161
+ readonly command: Schema.String;
1162
+ readonly status: Schema.Literals<readonly ["passed", "failed"]>;
1163
+ /** It also fails on the default branch, so the Run did not cause it. */
1164
+ readonly preExisting: Schema.Boolean;
1165
+ readonly revision: Schema.String;
1166
+ readonly tree: Schema.String;
1167
+ readonly durationMs: Schema.Int;
1168
+ readonly outputTail: Schema.String;
1169
+ readonly recordedAt: Schema.String;
1170
+ }>;
1171
+ export type RunEvidence = (typeof RunEvidence)['Type'];
1172
+ /** An approved verification of a repository, as Kitman holds it. */
1173
+ export declare const ApprovedVerification: Schema.Struct<{
1174
+ readonly id: Schema.String;
1175
+ readonly repoBindingId: Schema.String;
1176
+ readonly name: Schema.String;
1177
+ readonly command: Schema.String;
1178
+ readonly workingDirectory: Schema.optionalKey<Schema.String>;
1179
+ readonly approvedByUserId: Schema.String;
1180
+ readonly createdAt: Schema.String;
1181
+ }>;
1182
+ export type ApprovedVerification = (typeof ApprovedVerification)['Type'];
1183
+ export declare const ApprovedVerificationList: Schema.Struct<{
1184
+ readonly items: Schema.$Array<Schema.Struct<{
1185
+ readonly id: Schema.String;
1186
+ readonly repoBindingId: Schema.String;
1187
+ readonly name: Schema.String;
1188
+ readonly command: Schema.String;
1189
+ readonly workingDirectory: Schema.optionalKey<Schema.String>;
1190
+ readonly approvedByUserId: Schema.String;
1191
+ readonly createdAt: Schema.String;
1192
+ }>>;
1193
+ }>;
1194
+ export type ApprovedVerificationList = (typeof ApprovedVerificationList)['Type'];
1195
+ /** A document a Run stored in Kitman: a plan, findings, a conclusion or notes. */
1196
+ export declare const RunArtifact: Schema.Struct<{
1197
+ readonly id: Schema.String;
1198
+ readonly runId: Schema.String;
1199
+ readonly projectId: Schema.optionalKey<Schema.String>;
1200
+ readonly taskId: Schema.optionalKey<Schema.String>;
1201
+ readonly step: Schema.String;
1202
+ readonly kind: Schema.String;
1203
+ readonly title: Schema.String;
1204
+ readonly text: Schema.String;
1205
+ readonly data: Schema.optionalKey<Schema.Unknown>;
1206
+ readonly createdAt: Schema.String;
1207
+ }>;
1208
+ export type RunArtifact = (typeof RunArtifact)['Type'];
1209
+ export declare const RunArtifactSearch: Schema.Struct<{
1210
+ readonly query: Schema.String;
1211
+ readonly limit: Schema.optionalKey<Schema.Int>;
1212
+ }>;
1213
+ export type RunArtifactSearch = (typeof RunArtifactSearch)['Type'];
1214
+ export declare const RunArtifactSearchResult: Schema.Struct<{
1215
+ readonly items: Schema.$Array<Schema.Struct<{
1216
+ readonly id: Schema.String;
1217
+ readonly runId: Schema.String;
1218
+ readonly projectId: Schema.optionalKey<Schema.String>;
1219
+ readonly taskId: Schema.optionalKey<Schema.String>;
1220
+ readonly step: Schema.String;
1221
+ readonly kind: Schema.String;
1222
+ readonly title: Schema.String;
1223
+ readonly text: Schema.String;
1224
+ readonly data: Schema.optionalKey<Schema.Unknown>;
1225
+ readonly createdAt: Schema.String;
1226
+ }>>;
1227
+ }>;
1228
+ export type RunArtifactSearchResult = (typeof RunArtifactSearchResult)['Type'];
1229
+ export declare const RunClosureKinds: readonly ['complete', 'abandoned'];
1230
+ export type RunClosureKind = (typeof RunClosureKinds)[number];
1231
+ /** What a human decided about a top-level Run; the Run's status keeps what the engine did. */
1232
+ export declare const RunClosure: Schema.Struct<{
1233
+ readonly kind: Schema.Literals<readonly ["complete", "abandoned"]>;
1234
+ readonly reason: Schema.optionalKey<Schema.String>;
1235
+ readonly closedByUserId: Schema.String;
1236
+ readonly closedAt: Schema.String;
1237
+ }>;
1238
+ export type RunClosure = (typeof RunClosure)['Type'];
1239
+ export declare const RunCloseInput: Schema.Struct<{
1240
+ readonly kind: Schema.Literals<readonly ["complete", "abandoned"]>;
1241
+ readonly reason: Schema.optionalKey<Schema.String>;
1242
+ }>;
1243
+ export type RunCloseInput = (typeof RunCloseInput)['Type'];
1244
+ export declare const RunAlignmentVerdicts: readonly ['aligned', 'not_aligned', 'unverified'];
1245
+ /** Whether a completed Run did what its Intent asked, with why, judged against one Intent version. */
1246
+ export declare const RunAlignment: Schema.Struct<{
1247
+ readonly verdict: Schema.Literals<readonly ["aligned", "not_aligned", "unverified"]>;
1248
+ readonly reasons: Schema.$Array<Schema.String>;
1249
+ readonly intentVersion: Schema.Int;
1250
+ readonly judgedAt: Schema.String;
1251
+ }>;
1252
+ export type RunAlignment = (typeof RunAlignment)['Type'];
1253
+ export declare const Run: Schema.Struct<{
1254
+ readonly id: Schema.String;
1255
+ readonly workspaceId: Schema.String;
1256
+ readonly projectId: Schema.optionalKey<Schema.String>;
1257
+ readonly taskId: Schema.optionalKey<Schema.String>;
1258
+ readonly sessionId: Schema.optionalKey<Schema.String>;
1259
+ /** The Loop's id in the Package that declared it. */
1260
+ readonly loopId: Schema.String;
1261
+ /** The Package version the Run was admitted with. */
1262
+ readonly packageVersionId: Schema.optionalKey<Schema.String>;
1263
+ readonly resourceVersion: Schema.Int;
1264
+ readonly status: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
1265
+ readonly trigger: Schema.Struct<{
1266
+ readonly event: Schema.String;
1267
+ readonly eventId: Schema.String;
1268
+ readonly subject: Schema.optionalKey<Schema.Struct<{
1269
+ readonly kind: Schema.String;
1270
+ readonly id: Schema.String;
1271
+ }>>;
1272
+ readonly occurredAt: Schema.String;
1273
+ readonly metadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
1274
+ }>;
1275
+ readonly state: Schema.Struct<{
1276
+ readonly stepStates: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
1277
+ readonly stepKey: Schema.String;
1278
+ readonly sequence: Schema.Int;
1279
+ readonly attempts: Schema.Int;
1280
+ readonly stepAttemptId: Schema.optionalKey<Schema.String>;
1281
+ readonly startedAt: Schema.optionalKey<Schema.String>;
1282
+ readonly endedAt: Schema.optionalKey<Schema.String>;
1283
+ readonly output: Schema.optionalKey<Schema.Struct<{
1284
+ readonly stepKey: Schema.String;
1285
+ readonly outputSchemaRef: Schema.Struct<{
1286
+ readonly kind: Schema.Literal<"typebox_ref">;
1287
+ readonly name: Schema.String;
1288
+ readonly version: Schema.optionalKey<Schema.String>;
1289
+ readonly sha256: Schema.optionalKey<Schema.String>;
1290
+ }>;
1291
+ readonly summary: Schema.String;
1292
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
1293
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
1294
+ readonly refs: Schema.$Array<Schema.Struct<{
1295
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
1296
+ readonly id: Schema.optionalKey<Schema.String>;
1297
+ readonly externalId: Schema.optionalKey<Schema.String>;
1298
+ readonly provider: Schema.optionalKey<Schema.String>;
1299
+ readonly title: Schema.optionalKey<Schema.String>;
1300
+ }>>;
1301
+ }>>;
1302
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
1303
+ readonly updatedAt: Schema.String;
1304
+ readonly required: Schema.Literal<true>;
1305
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
1306
+ }>, Schema.Struct<{
1307
+ readonly stepKey: Schema.String;
1308
+ readonly sequence: Schema.Int;
1309
+ readonly attempts: Schema.Int;
1310
+ readonly stepAttemptId: Schema.optionalKey<Schema.String>;
1311
+ readonly startedAt: Schema.optionalKey<Schema.String>;
1312
+ readonly endedAt: Schema.optionalKey<Schema.String>;
1313
+ readonly output: Schema.optionalKey<Schema.Struct<{
1314
+ readonly stepKey: Schema.String;
1315
+ readonly outputSchemaRef: Schema.Struct<{
1316
+ readonly kind: Schema.Literal<"typebox_ref">;
1317
+ readonly name: Schema.String;
1318
+ readonly version: Schema.optionalKey<Schema.String>;
1319
+ readonly sha256: Schema.optionalKey<Schema.String>;
1320
+ }>;
1321
+ readonly summary: Schema.String;
1322
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
1323
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
1324
+ readonly refs: Schema.$Array<Schema.Struct<{
1325
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
1326
+ readonly id: Schema.optionalKey<Schema.String>;
1327
+ readonly externalId: Schema.optionalKey<Schema.String>;
1328
+ readonly provider: Schema.optionalKey<Schema.String>;
1329
+ readonly title: Schema.optionalKey<Schema.String>;
1330
+ }>>;
1331
+ }>>;
1332
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
1333
+ readonly updatedAt: Schema.String;
1334
+ readonly required: Schema.Literal<false>;
1335
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "skipped", "canceled"]>;
1336
+ }>]>>;
1337
+ readonly summary: Schema.optionalKey<Schema.String>;
1338
+ readonly resultMetadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
1339
+ }>;
1340
+ /** A program Run's bundle digest, fixed at admission. */
1341
+ readonly loopDigest: Schema.optionalKey<Schema.String>;
1342
+ /** The layer a program Run's Loop resolved from. */
1343
+ readonly loopLayer: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
1344
+ /** A Child Run's parent. */
1345
+ readonly parentRunId: Schema.optionalKey<Schema.String>;
1346
+ readonly waiting: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
1347
+ readonly kind: Schema.Literal<"question">;
1348
+ readonly name: Schema.String;
1349
+ readonly questionId: Schema.String;
1350
+ }>, Schema.Struct<{
1351
+ readonly kind: Schema.Literal<"clock">;
1352
+ readonly name: Schema.String;
1353
+ readonly firesAt: Schema.String;
1354
+ }>, Schema.Struct<{
1355
+ readonly kind: Schema.Literal<"event">;
1356
+ readonly name: Schema.String;
1357
+ readonly event: Schema.String;
1358
+ readonly timesOutAt: Schema.String;
1359
+ }>, Schema.Struct<{
1360
+ readonly kind: Schema.Literal<"step">;
1361
+ readonly name: Schema.String;
1362
+ readonly stepAttemptId: Schema.String;
1363
+ }>, Schema.Struct<{
1364
+ readonly kind: Schema.Literal<"child">;
1365
+ readonly name: Schema.String;
1366
+ readonly runId: Schema.String;
1367
+ }>, Schema.Struct<{
1368
+ readonly kind: Schema.Literal<"verification">;
1369
+ readonly name: Schema.String;
1370
+ readonly verificationId: Schema.String;
1371
+ }>]>>>;
1372
+ readonly output: Schema.optionalKey<Schema.Unknown>;
1373
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
1374
+ /** The latest Closure of a top-level Run. */
1375
+ readonly closure: Schema.optionalKey<Schema.Struct<{
1376
+ readonly kind: Schema.Literals<readonly ["complete", "abandoned"]>;
1377
+ readonly reason: Schema.optionalKey<Schema.String>;
1378
+ readonly closedByUserId: Schema.String;
1379
+ readonly closedAt: Schema.String;
1380
+ }>>;
1381
+ readonly alignment: Schema.optionalKey<Schema.Struct<{
1382
+ readonly verdict: Schema.Literals<readonly ["aligned", "not_aligned", "unverified"]>;
1383
+ readonly reasons: Schema.$Array<Schema.String>;
1384
+ readonly intentVersion: Schema.Int;
1385
+ readonly judgedAt: Schema.String;
1386
+ }>>;
1387
+ readonly startedAt: Schema.optionalKey<Schema.String>;
1388
+ readonly completedAt: Schema.optionalKey<Schema.String>;
1389
+ readonly createdAt: Schema.String;
1390
+ readonly updatedAt: Schema.String;
1391
+ }>;
1392
+ export declare const StepAttemptInputManifest: Schema.Struct<{
1393
+ readonly manifestVersion: Schema.Int;
1394
+ readonly assembledAt: Schema.String;
1395
+ readonly entries: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
1396
+ readonly kind: Schema.Literals<readonly ["kit", "memory", "decision", "knowledge_record", "context_pack"]>;
1397
+ readonly sourceId: Schema.String;
1398
+ readonly sourceScope: Schema.Struct<{
1399
+ readonly kind: Schema.Literals<readonly ["workspace", "project", "task", "loop", "agent"]>;
1400
+ readonly id: Schema.String;
1401
+ }>;
1402
+ readonly inclusionReason: Schema.String;
1403
+ readonly resolvedAt: Schema.String;
1404
+ readonly appliedToStepKey: Schema.String;
1405
+ readonly availability: Schema.Union<readonly [Schema.Struct<{
1406
+ readonly kind: Schema.Literal<"available">;
1407
+ readonly inspectRef: Schema.Struct<{
1408
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
1409
+ readonly id: Schema.optionalKey<Schema.String>;
1410
+ readonly externalId: Schema.optionalKey<Schema.String>;
1411
+ readonly provider: Schema.optionalKey<Schema.String>;
1412
+ readonly title: Schema.optionalKey<Schema.String>;
1413
+ }>;
1414
+ }>, Schema.Struct<{
1415
+ readonly kind: Schema.Union<readonly [Schema.Literal<"redacted">, Schema.Literal<"unavailable">]>;
1416
+ readonly reason: Schema.String;
1417
+ }>]>;
1418
+ readonly sourceVersion: Schema.String;
1419
+ }>, Schema.Struct<{
1420
+ readonly kind: Schema.Literals<readonly ["kit", "memory", "decision", "knowledge_record", "context_pack"]>;
1421
+ readonly sourceId: Schema.String;
1422
+ readonly sourceScope: Schema.Struct<{
1423
+ readonly kind: Schema.Literals<readonly ["workspace", "project", "task", "loop", "agent"]>;
1424
+ readonly id: Schema.String;
1425
+ }>;
1426
+ readonly inclusionReason: Schema.String;
1427
+ readonly resolvedAt: Schema.String;
1428
+ readonly appliedToStepKey: Schema.String;
1429
+ readonly availability: Schema.Union<readonly [Schema.Struct<{
1430
+ readonly kind: Schema.Literal<"available">;
1431
+ readonly inspectRef: Schema.Struct<{
1432
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
1433
+ readonly id: Schema.optionalKey<Schema.String>;
1434
+ readonly externalId: Schema.optionalKey<Schema.String>;
1435
+ readonly provider: Schema.optionalKey<Schema.String>;
1436
+ readonly title: Schema.optionalKey<Schema.String>;
1437
+ }>;
1438
+ }>, Schema.Struct<{
1439
+ readonly kind: Schema.Union<readonly [Schema.Literal<"redacted">, Schema.Literal<"unavailable">]>;
1440
+ readonly reason: Schema.String;
1441
+ }>]>;
1442
+ readonly contentSha256: Schema.String;
1443
+ }>]>>;
1444
+ readonly budget: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
1445
+ }>;
1446
+ export declare const StepAttemptAgent: Schema.Struct<{
1447
+ readonly id: Schema.String;
1448
+ readonly version: Schema.optionalKey<Schema.String>;
1449
+ }>;
1450
+ export declare const StepAttemptExecutionEnvironment: Schema.Struct<{
1451
+ readonly agent: Schema.optionalKey<Schema.Struct<{
1452
+ readonly id: Schema.String;
1453
+ readonly version: Schema.optionalKey<Schema.String>;
1454
+ }>>;
1455
+ readonly runner: Schema.optionalKey<Schema.Struct<{
1456
+ readonly id: Schema.String;
1457
+ readonly capabilitySnapshot: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
1458
+ }>>;
1459
+ readonly harness: Schema.optionalKey<Schema.String>;
1460
+ readonly model: Schema.optionalKey<Schema.String>;
1461
+ readonly metadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
1462
+ }>;
1463
+ /** What an agent Step is told: its prompt, ContextPack and the Output it must submit, fixed at launch. */
1464
+ export declare const StepBrief: Schema.Struct<{
1465
+ readonly stepAttemptId: Schema.String;
1466
+ readonly harness: Schema.String;
1467
+ /** The Agent's model; the Harness's default when absent. */
1468
+ readonly model: Schema.optionalKey<Schema.String>;
1469
+ readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
1470
+ readonly prompt: Schema.String;
1471
+ /** Briefs stored before the prompt carried the ContextPack alone have it here too; a new brief leaves it out. */
1472
+ readonly contextPack: Schema.optionalKey<Schema.Struct<{
1473
+ /** Absent when the pack was assembled for a program's agent Step rather than stored for a Task. */
1474
+ readonly contextPackId: Schema.optionalKey<Schema.String>;
1475
+ readonly mode: Schema.String;
1476
+ readonly contentMarkdown: Schema.String;
1477
+ }>>;
1478
+ /** The JSON Schema the Output is validated against. */
1479
+ readonly outputSchema: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
1480
+ /** The skills of the Step's Kits, which the Runner writes where the Harness loads skills. */
1481
+ readonly skills: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1482
+ readonly name: Schema.String;
1483
+ /** By path relative to the skill's directory; `SKILL.md` among them. */
1484
+ readonly files: Schema.$Record<Schema.String, Schema.String>;
1485
+ }>>>;
1486
+ /** The agent may use no tool but reading this brief and submitting its Output. */
1487
+ readonly toolless: Schema.optionalKey<Schema.Literal<true>>;
1488
+ }>;
1489
+ export type StepBrief = (typeof StepBrief)['Type'];
1490
+ export declare const StepOutputSubmission: Schema.Struct<{
1491
+ readonly output: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
1492
+ }>;
1493
+ export type StepOutputSubmission = (typeof StepOutputSubmission)['Type'];
1494
+ /** What an agent records at a milestone; a retry of its Step on another Runner starts from these. */
1495
+ export declare const StepSessionUpdate: Schema.Struct<{
1496
+ readonly kind: Schema.String;
1497
+ readonly content: Schema.String;
1498
+ }>;
1499
+ export type StepSessionUpdate = (typeof StepSessionUpdate)['Type'];
1500
+ export declare const StepOutputSubmissionResult: Schema.Union<readonly [Schema.Struct<{
1501
+ readonly status: Schema.Literal<"accepted">;
1502
+ }>, Schema.Struct<{
1503
+ readonly status: Schema.Literal<"rejected">;
1504
+ readonly message: Schema.String;
1505
+ readonly submissionsLeft: Schema.Int;
1506
+ }>, Schema.Struct<{
1507
+ readonly status: Schema.Literal<"failed">;
1508
+ readonly message: Schema.String;
1509
+ }>]>;
1510
+ export type StepOutputSubmissionResult = (typeof StepOutputSubmissionResult)['Type'];
1511
+ export declare const StepAttempt: Schema.Struct<{
1512
+ readonly id: Schema.String;
1513
+ readonly workspaceId: Schema.String;
1514
+ readonly projectId: Schema.optionalKey<Schema.String>;
1515
+ readonly taskId: Schema.optionalKey<Schema.String>;
1516
+ readonly sessionId: Schema.optionalKey<Schema.String>;
1517
+ readonly runId: Schema.String;
1518
+ /** Absent for a program's agent Step. */
1519
+ readonly stepSnapshotId: Schema.optionalKey<Schema.String>;
1520
+ /** A program's agent Step name, such as `fix:1` or `judge:2`. */
1521
+ readonly stepKey: Schema.String;
1522
+ readonly sequence: Schema.Int;
1523
+ readonly required: Schema.Boolean;
1524
+ readonly attempt: Schema.Int;
1525
+ readonly retryOfAttemptId: Schema.optionalKey<Schema.String>;
1526
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
1527
+ readonly inputManifest: Schema.Struct<{
1528
+ readonly manifestVersion: Schema.Int;
1529
+ readonly assembledAt: Schema.String;
1530
+ readonly entries: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
1531
+ readonly kind: Schema.Literals<readonly ["kit", "memory", "decision", "knowledge_record", "context_pack"]>;
1532
+ readonly sourceId: Schema.String;
1533
+ readonly sourceScope: Schema.Struct<{
1534
+ readonly kind: Schema.Literals<readonly ["workspace", "project", "task", "loop", "agent"]>;
1535
+ readonly id: Schema.String;
1536
+ }>;
1537
+ readonly inclusionReason: Schema.String;
1538
+ readonly resolvedAt: Schema.String;
1539
+ readonly appliedToStepKey: Schema.String;
1540
+ readonly availability: Schema.Union<readonly [Schema.Struct<{
1541
+ readonly kind: Schema.Literal<"available">;
1542
+ readonly inspectRef: Schema.Struct<{
1543
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
1544
+ readonly id: Schema.optionalKey<Schema.String>;
1545
+ readonly externalId: Schema.optionalKey<Schema.String>;
1546
+ readonly provider: Schema.optionalKey<Schema.String>;
1547
+ readonly title: Schema.optionalKey<Schema.String>;
1548
+ }>;
1549
+ }>, Schema.Struct<{
1550
+ readonly kind: Schema.Union<readonly [Schema.Literal<"redacted">, Schema.Literal<"unavailable">]>;
1551
+ readonly reason: Schema.String;
1552
+ }>]>;
1553
+ readonly sourceVersion: Schema.String;
1554
+ }>, Schema.Struct<{
1555
+ readonly kind: Schema.Literals<readonly ["kit", "memory", "decision", "knowledge_record", "context_pack"]>;
1556
+ readonly sourceId: Schema.String;
1557
+ readonly sourceScope: Schema.Struct<{
1558
+ readonly kind: Schema.Literals<readonly ["workspace", "project", "task", "loop", "agent"]>;
1559
+ readonly id: Schema.String;
1560
+ }>;
1561
+ readonly inclusionReason: Schema.String;
1562
+ readonly resolvedAt: Schema.String;
1563
+ readonly appliedToStepKey: Schema.String;
1564
+ readonly availability: Schema.Union<readonly [Schema.Struct<{
1565
+ readonly kind: Schema.Literal<"available">;
1566
+ readonly inspectRef: Schema.Struct<{
1567
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
1568
+ readonly id: Schema.optionalKey<Schema.String>;
1569
+ readonly externalId: Schema.optionalKey<Schema.String>;
1570
+ readonly provider: Schema.optionalKey<Schema.String>;
1571
+ readonly title: Schema.optionalKey<Schema.String>;
1572
+ }>;
1573
+ }>, Schema.Struct<{
1574
+ readonly kind: Schema.Union<readonly [Schema.Literal<"redacted">, Schema.Literal<"unavailable">]>;
1575
+ readonly reason: Schema.String;
1576
+ }>]>;
1577
+ readonly contentSha256: Schema.String;
1578
+ }>]>>;
1579
+ readonly budget: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
1580
+ }>;
1581
+ readonly execution: Schema.Struct<{
1582
+ readonly agent: Schema.optionalKey<Schema.Struct<{
1583
+ readonly id: Schema.String;
1584
+ readonly version: Schema.optionalKey<Schema.String>;
1585
+ }>>;
1586
+ readonly runner: Schema.optionalKey<Schema.Struct<{
1587
+ readonly id: Schema.String;
1588
+ readonly capabilitySnapshot: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
1589
+ }>>;
1590
+ readonly harness: Schema.optionalKey<Schema.String>;
1591
+ readonly model: Schema.optionalKey<Schema.String>;
1592
+ readonly metadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
1593
+ }>;
1594
+ readonly output: Schema.optionalKey<Schema.Struct<{
1595
+ readonly stepKey: Schema.String;
1596
+ readonly outputSchemaRef: Schema.Struct<{
1597
+ readonly kind: Schema.Literal<"typebox_ref">;
1598
+ readonly name: Schema.String;
1599
+ readonly version: Schema.optionalKey<Schema.String>;
1600
+ readonly sha256: Schema.optionalKey<Schema.String>;
1601
+ }>;
1602
+ readonly summary: Schema.String;
1603
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
1604
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
1605
+ readonly refs: Schema.$Array<Schema.Struct<{
1606
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
1607
+ readonly id: Schema.optionalKey<Schema.String>;
1608
+ readonly externalId: Schema.optionalKey<Schema.String>;
1609
+ readonly provider: Schema.optionalKey<Schema.String>;
1610
+ readonly title: Schema.optionalKey<Schema.String>;
1611
+ }>>;
1612
+ }>>;
1613
+ readonly brief: Schema.optionalKey<Schema.Struct<{
1614
+ readonly stepAttemptId: Schema.String;
1615
+ readonly harness: Schema.String;
1616
+ /** The Agent's model; the Harness's default when absent. */
1617
+ readonly model: Schema.optionalKey<Schema.String>;
1618
+ readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
1619
+ readonly prompt: Schema.String;
1620
+ /** Briefs stored before the prompt carried the ContextPack alone have it here too; a new brief leaves it out. */
1621
+ readonly contextPack: Schema.optionalKey<Schema.Struct<{
1622
+ /** Absent when the pack was assembled for a program's agent Step rather than stored for a Task. */
1623
+ readonly contextPackId: Schema.optionalKey<Schema.String>;
1624
+ readonly mode: Schema.String;
1625
+ readonly contentMarkdown: Schema.String;
1626
+ }>>;
1627
+ /** The JSON Schema the Output is validated against. */
1628
+ readonly outputSchema: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
1629
+ /** The skills of the Step's Kits, which the Runner writes where the Harness loads skills. */
1630
+ readonly skills: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1631
+ readonly name: Schema.String;
1632
+ /** By path relative to the skill's directory; `SKILL.md` among them. */
1633
+ readonly files: Schema.$Record<Schema.String, Schema.String>;
1634
+ }>>>;
1635
+ /** The agent may use no tool but reading this brief and submitting its Output. */
1636
+ readonly toolless: Schema.optionalKey<Schema.Literal<true>>;
1637
+ }>>;
1638
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
1639
+ readonly reviewEvidence: Schema.$Array<Schema.Struct<{
1640
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
1641
+ readonly id: Schema.optionalKey<Schema.String>;
1642
+ readonly externalId: Schema.optionalKey<Schema.String>;
1643
+ readonly provider: Schema.optionalKey<Schema.String>;
1644
+ readonly title: Schema.optionalKey<Schema.String>;
1645
+ }>>;
1646
+ readonly lease: Schema.optionalKey<Schema.Struct<{
1647
+ readonly ownerId: Schema.String;
1648
+ readonly runnerReplicaId: Schema.optionalKey<Schema.String>;
1649
+ readonly leaseId: Schema.String;
1650
+ readonly fencingToken: Schema.String;
1651
+ readonly capacitySlot: Schema.optionalKey<Schema.String>;
1652
+ readonly expiresAt: Schema.String;
1653
+ readonly lastHeartbeatAt: Schema.optionalKey<Schema.String>;
1654
+ }>>;
1655
+ readonly claimIdempotencyKey: Schema.optionalKey<Schema.String>;
1656
+ readonly terminalIdempotencyKey: Schema.optionalKey<Schema.String>;
1657
+ readonly startedAt: Schema.optionalKey<Schema.String>;
1658
+ readonly completedAt: Schema.optionalKey<Schema.String>;
1659
+ readonly createdAt: Schema.String;
1660
+ readonly updatedAt: Schema.String;
1661
+ }>;
1662
+ export declare const StepAttemptList: Schema.Struct<{
1663
+ readonly items: Schema.$Array<Schema.Struct<{
1664
+ readonly id: Schema.String;
1665
+ readonly workspaceId: Schema.String;
1666
+ readonly projectId: Schema.optionalKey<Schema.String>;
1667
+ readonly taskId: Schema.optionalKey<Schema.String>;
1668
+ readonly sessionId: Schema.optionalKey<Schema.String>;
1669
+ readonly runId: Schema.String;
1670
+ /** Absent for a program's agent Step. */
1671
+ readonly stepSnapshotId: Schema.optionalKey<Schema.String>;
1672
+ /** A program's agent Step name, such as `fix:1` or `judge:2`. */
1673
+ readonly stepKey: Schema.String;
1674
+ readonly sequence: Schema.Int;
1675
+ readonly required: Schema.Boolean;
1676
+ readonly attempt: Schema.Int;
1677
+ readonly retryOfAttemptId: Schema.optionalKey<Schema.String>;
1678
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
1679
+ readonly inputManifest: Schema.Struct<{
1680
+ readonly manifestVersion: Schema.Int;
1681
+ readonly assembledAt: Schema.String;
1682
+ readonly entries: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
1683
+ readonly kind: Schema.Literals<readonly ["kit", "memory", "decision", "knowledge_record", "context_pack"]>;
1684
+ readonly sourceId: Schema.String;
1685
+ readonly sourceScope: Schema.Struct<{
1686
+ readonly kind: Schema.Literals<readonly ["workspace", "project", "task", "loop", "agent"]>;
1687
+ readonly id: Schema.String;
1688
+ }>;
1689
+ readonly inclusionReason: Schema.String;
1690
+ readonly resolvedAt: Schema.String;
1691
+ readonly appliedToStepKey: Schema.String;
1692
+ readonly availability: Schema.Union<readonly [Schema.Struct<{
1693
+ readonly kind: Schema.Literal<"available">;
1694
+ readonly inspectRef: Schema.Struct<{
1695
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
1696
+ readonly id: Schema.optionalKey<Schema.String>;
1697
+ readonly externalId: Schema.optionalKey<Schema.String>;
1698
+ readonly provider: Schema.optionalKey<Schema.String>;
1699
+ readonly title: Schema.optionalKey<Schema.String>;
1700
+ }>;
1701
+ }>, Schema.Struct<{
1702
+ readonly kind: Schema.Union<readonly [Schema.Literal<"redacted">, Schema.Literal<"unavailable">]>;
1703
+ readonly reason: Schema.String;
1704
+ }>]>;
1705
+ readonly sourceVersion: Schema.String;
1706
+ }>, Schema.Struct<{
1707
+ readonly kind: Schema.Literals<readonly ["kit", "memory", "decision", "knowledge_record", "context_pack"]>;
1708
+ readonly sourceId: Schema.String;
1709
+ readonly sourceScope: Schema.Struct<{
1710
+ readonly kind: Schema.Literals<readonly ["workspace", "project", "task", "loop", "agent"]>;
1711
+ readonly id: Schema.String;
1712
+ }>;
1713
+ readonly inclusionReason: Schema.String;
1714
+ readonly resolvedAt: Schema.String;
1715
+ readonly appliedToStepKey: Schema.String;
1716
+ readonly availability: Schema.Union<readonly [Schema.Struct<{
1717
+ readonly kind: Schema.Literal<"available">;
1718
+ readonly inspectRef: Schema.Struct<{
1719
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
1720
+ readonly id: Schema.optionalKey<Schema.String>;
1721
+ readonly externalId: Schema.optionalKey<Schema.String>;
1722
+ readonly provider: Schema.optionalKey<Schema.String>;
1723
+ readonly title: Schema.optionalKey<Schema.String>;
1724
+ }>;
1725
+ }>, Schema.Struct<{
1726
+ readonly kind: Schema.Union<readonly [Schema.Literal<"redacted">, Schema.Literal<"unavailable">]>;
1727
+ readonly reason: Schema.String;
1728
+ }>]>;
1729
+ readonly contentSha256: Schema.String;
1730
+ }>]>>;
1731
+ readonly budget: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
1732
+ }>;
1733
+ readonly execution: Schema.Struct<{
1734
+ readonly agent: Schema.optionalKey<Schema.Struct<{
1735
+ readonly id: Schema.String;
1736
+ readonly version: Schema.optionalKey<Schema.String>;
1737
+ }>>;
1738
+ readonly runner: Schema.optionalKey<Schema.Struct<{
1739
+ readonly id: Schema.String;
1740
+ readonly capabilitySnapshot: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
1741
+ }>>;
1742
+ readonly harness: Schema.optionalKey<Schema.String>;
1743
+ readonly model: Schema.optionalKey<Schema.String>;
1744
+ readonly metadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
1745
+ }>;
1746
+ readonly output: Schema.optionalKey<Schema.Struct<{
1747
+ readonly stepKey: Schema.String;
1748
+ readonly outputSchemaRef: Schema.Struct<{
1749
+ readonly kind: Schema.Literal<"typebox_ref">;
1750
+ readonly name: Schema.String;
1751
+ readonly version: Schema.optionalKey<Schema.String>;
1752
+ readonly sha256: Schema.optionalKey<Schema.String>;
1753
+ }>;
1754
+ readonly summary: Schema.String;
1755
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
1756
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
1757
+ readonly refs: Schema.$Array<Schema.Struct<{
1758
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
1759
+ readonly id: Schema.optionalKey<Schema.String>;
1760
+ readonly externalId: Schema.optionalKey<Schema.String>;
1761
+ readonly provider: Schema.optionalKey<Schema.String>;
1762
+ readonly title: Schema.optionalKey<Schema.String>;
1763
+ }>>;
1764
+ }>>;
1765
+ readonly brief: Schema.optionalKey<Schema.Struct<{
1766
+ readonly stepAttemptId: Schema.String;
1767
+ readonly harness: Schema.String;
1768
+ /** The Agent's model; the Harness's default when absent. */
1769
+ readonly model: Schema.optionalKey<Schema.String>;
1770
+ readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
1771
+ readonly prompt: Schema.String;
1772
+ /** Briefs stored before the prompt carried the ContextPack alone have it here too; a new brief leaves it out. */
1773
+ readonly contextPack: Schema.optionalKey<Schema.Struct<{
1774
+ /** Absent when the pack was assembled for a program's agent Step rather than stored for a Task. */
1775
+ readonly contextPackId: Schema.optionalKey<Schema.String>;
1776
+ readonly mode: Schema.String;
1777
+ readonly contentMarkdown: Schema.String;
1778
+ }>>;
1779
+ /** The JSON Schema the Output is validated against. */
1780
+ readonly outputSchema: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
1781
+ /** The skills of the Step's Kits, which the Runner writes where the Harness loads skills. */
1782
+ readonly skills: Schema.optionalKey<Schema.$Array<Schema.Struct<{
1783
+ readonly name: Schema.String;
1784
+ /** By path relative to the skill's directory; `SKILL.md` among them. */
1785
+ readonly files: Schema.$Record<Schema.String, Schema.String>;
1786
+ }>>>;
1787
+ /** The agent may use no tool but reading this brief and submitting its Output. */
1788
+ readonly toolless: Schema.optionalKey<Schema.Literal<true>>;
1789
+ }>>;
1790
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
1791
+ readonly reviewEvidence: Schema.$Array<Schema.Struct<{
1792
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
1793
+ readonly id: Schema.optionalKey<Schema.String>;
1794
+ readonly externalId: Schema.optionalKey<Schema.String>;
1795
+ readonly provider: Schema.optionalKey<Schema.String>;
1796
+ readonly title: Schema.optionalKey<Schema.String>;
1797
+ }>>;
1798
+ readonly lease: Schema.optionalKey<Schema.Struct<{
1799
+ readonly ownerId: Schema.String;
1800
+ readonly runnerReplicaId: Schema.optionalKey<Schema.String>;
1801
+ readonly leaseId: Schema.String;
1802
+ readonly fencingToken: Schema.String;
1803
+ readonly capacitySlot: Schema.optionalKey<Schema.String>;
1804
+ readonly expiresAt: Schema.String;
1805
+ readonly lastHeartbeatAt: Schema.optionalKey<Schema.String>;
1806
+ }>>;
1807
+ readonly claimIdempotencyKey: Schema.optionalKey<Schema.String>;
1808
+ readonly terminalIdempotencyKey: Schema.optionalKey<Schema.String>;
1809
+ readonly startedAt: Schema.optionalKey<Schema.String>;
1810
+ readonly completedAt: Schema.optionalKey<Schema.String>;
1811
+ readonly createdAt: Schema.String;
1812
+ readonly updatedAt: Schema.String;
1813
+ }>>;
1814
+ }>;
1815
+ /**
1816
+ * Product evidence correlated to one durable Wait. The Wait remains the only
1817
+ * resume authority; this record never mirrors or advances durable wait state.
1818
+ */
1819
+ export declare const QuestionResponderPolicy: Schema.Struct<{
1820
+ readonly eligibleMemberIds: Schema.$Array<Schema.String>;
1821
+ readonly allowWorkspaceAdmins: Schema.Boolean;
1822
+ }>;
1823
+ export declare const QuestionAnswer: Schema.Struct<{
1824
+ readonly value: Schema.String;
1825
+ readonly answeredByUserId: Schema.String;
1826
+ readonly answeredAt: Schema.String;
1827
+ readonly idempotencyKey: Schema.String;
1828
+ }>;
1829
+ export declare const Question: Schema.Struct<{
1830
+ readonly id: Schema.String;
1831
+ readonly workspaceId: Schema.String;
1832
+ readonly projectId: Schema.optionalKey<Schema.String>;
1833
+ readonly taskId: Schema.optionalKey<Schema.String>;
1834
+ readonly runId: Schema.String;
1835
+ /** The Step that asked: a program's `ask` name or an agent's Step name, such as `next:1`. */
1836
+ readonly stepKey: Schema.String;
1837
+ readonly waitId: Schema.String;
1838
+ readonly taskThreadEntryId: Schema.optionalKey<Schema.String>;
1839
+ readonly prompt: Schema.String;
1840
+ /** A program's closed options; an answer outside them is refused. */
1841
+ readonly options: Schema.optionalKey<Schema.$Array<Schema.String>>;
1842
+ readonly freeText: Schema.optionalKey<Schema.Boolean>;
1843
+ readonly responderPolicy: Schema.Struct<{
1844
+ readonly eligibleMemberIds: Schema.$Array<Schema.String>;
1845
+ readonly allowWorkspaceAdmins: Schema.Boolean;
1846
+ }>;
1847
+ readonly status: Schema.Literals<readonly ["open", "answered", "resume_requested", "resumed", "resume_failed", "expired", "cancelled"]>;
1848
+ readonly answer: Schema.optionalKey<Schema.Struct<{
1849
+ readonly value: Schema.String;
1850
+ readonly answeredByUserId: Schema.String;
1851
+ readonly answeredAt: Schema.String;
1852
+ readonly idempotencyKey: Schema.String;
1853
+ }>>;
1854
+ readonly resolutionOutcome: Schema.optionalKey<Schema.String>;
1855
+ readonly createdAt: Schema.String;
1856
+ readonly updatedAt: Schema.String;
1857
+ readonly resolvedAt: Schema.optionalKey<Schema.String>;
1858
+ }>;
1859
+ export declare const QuestionAnswerCreate: Schema.Struct<{
1860
+ readonly value: Schema.String;
1861
+ readonly idempotencyKey: Schema.String;
1862
+ }>;
1863
+ export declare const QuestionList: Schema.Struct<{
1864
+ readonly items: Schema.$Array<Schema.Struct<{
1865
+ readonly id: Schema.String;
1866
+ readonly workspaceId: Schema.String;
1867
+ readonly projectId: Schema.optionalKey<Schema.String>;
1868
+ readonly taskId: Schema.optionalKey<Schema.String>;
1869
+ readonly runId: Schema.String;
1870
+ /** The Step that asked: a program's `ask` name or an agent's Step name, such as `next:1`. */
1871
+ readonly stepKey: Schema.String;
1872
+ readonly waitId: Schema.String;
1873
+ readonly taskThreadEntryId: Schema.optionalKey<Schema.String>;
1874
+ readonly prompt: Schema.String;
1875
+ /** A program's closed options; an answer outside them is refused. */
1876
+ readonly options: Schema.optionalKey<Schema.$Array<Schema.String>>;
1877
+ readonly freeText: Schema.optionalKey<Schema.Boolean>;
1878
+ readonly responderPolicy: Schema.Struct<{
1879
+ readonly eligibleMemberIds: Schema.$Array<Schema.String>;
1880
+ readonly allowWorkspaceAdmins: Schema.Boolean;
1881
+ }>;
1882
+ readonly status: Schema.Literals<readonly ["open", "answered", "resume_requested", "resumed", "resume_failed", "expired", "cancelled"]>;
1883
+ readonly answer: Schema.optionalKey<Schema.Struct<{
1884
+ readonly value: Schema.String;
1885
+ readonly answeredByUserId: Schema.String;
1886
+ readonly answeredAt: Schema.String;
1887
+ readonly idempotencyKey: Schema.String;
1888
+ }>>;
1889
+ readonly resolutionOutcome: Schema.optionalKey<Schema.String>;
1890
+ readonly createdAt: Schema.String;
1891
+ readonly updatedAt: Schema.String;
1892
+ readonly resolvedAt: Schema.optionalKey<Schema.String>;
1893
+ }>>;
1894
+ }>;
1895
+ export declare const RunLaunchContext: Schema.Struct<{
1896
+ readonly projectId: Schema.optionalKey<Schema.String>;
1897
+ readonly remoteUrl: Schema.optionalKey<Schema.String>;
1898
+ readonly repoBindingId: Schema.optionalKey<Schema.String>;
1899
+ readonly branch: Schema.optionalKey<Schema.String>;
1900
+ }>;
1901
+ export declare const RunStart: Schema.Struct<{
1902
+ readonly workspaceId: Schema.String;
1903
+ /** The Loop to start; the Task's Type's default Loop when left out. */
1904
+ readonly loop: Schema.optionalKey<Schema.String>;
1905
+ readonly words: Schema.optionalKey<Schema.String>;
1906
+ /** The Task the Run is for, by id or any key it has had. */
1907
+ readonly task: Schema.optionalKey<Schema.String>;
1908
+ /** The Team a Task made from the words goes to. */
1909
+ readonly teamId: Schema.optionalKey<Schema.String>;
1910
+ /** The Task Type a Task made from the words gets; the first with the inferred Outcome when left out. */
1911
+ readonly taskTypeId: Schema.optionalKey<Schema.String>;
1912
+ /** Loop Input fields that win over inferred ones. */
1913
+ readonly input: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
1914
+ readonly context: Schema.optionalKey<Schema.Struct<{
1915
+ readonly projectId: Schema.optionalKey<Schema.String>;
1916
+ readonly remoteUrl: Schema.optionalKey<Schema.String>;
1917
+ readonly repoBindingId: Schema.optionalKey<Schema.String>;
1918
+ readonly branch: Schema.optionalKey<Schema.String>;
1919
+ }>>;
1920
+ /** Runs the Loop from the requester's dev version instead of resolving it. */
1921
+ readonly devVersionId: Schema.optionalKey<Schema.String>;
1922
+ /** The Intent's launch constraints; `rule:protected_paths:<glob>[,<glob>…]` spells a rule. */
1923
+ readonly constraints: Schema.optionalKey<Schema.$Array<Schema.String>>;
1924
+ }>;
1925
+ export type RunStart = (typeof RunStart)['Type'];
1926
+ export declare const RunStarted: Schema.Struct<{
1927
+ readonly run: Schema.Struct<{
1928
+ readonly id: Schema.String;
1929
+ readonly workspaceId: Schema.String;
1930
+ readonly projectId: Schema.optionalKey<Schema.String>;
1931
+ readonly taskId: Schema.optionalKey<Schema.String>;
1932
+ readonly sessionId: Schema.optionalKey<Schema.String>;
1933
+ /** The Loop's id in the Package that declared it. */
1934
+ readonly loopId: Schema.String;
1935
+ /** The Package version the Run was admitted with. */
1936
+ readonly packageVersionId: Schema.optionalKey<Schema.String>;
1937
+ readonly resourceVersion: Schema.Int;
1938
+ readonly status: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
1939
+ readonly trigger: Schema.Struct<{
1940
+ readonly event: Schema.String;
1941
+ readonly eventId: Schema.String;
1942
+ readonly subject: Schema.optionalKey<Schema.Struct<{
1943
+ readonly kind: Schema.String;
1944
+ readonly id: Schema.String;
1945
+ }>>;
1946
+ readonly occurredAt: Schema.String;
1947
+ readonly metadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
1948
+ }>;
1949
+ readonly state: Schema.Struct<{
1950
+ readonly stepStates: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
1951
+ readonly stepKey: Schema.String;
1952
+ readonly sequence: Schema.Int;
1953
+ readonly attempts: Schema.Int;
1954
+ readonly stepAttemptId: Schema.optionalKey<Schema.String>;
1955
+ readonly startedAt: Schema.optionalKey<Schema.String>;
1956
+ readonly endedAt: Schema.optionalKey<Schema.String>;
1957
+ readonly output: Schema.optionalKey<Schema.Struct<{
1958
+ readonly stepKey: Schema.String;
1959
+ readonly outputSchemaRef: Schema.Struct<{
1960
+ readonly kind: Schema.Literal<"typebox_ref">;
1961
+ readonly name: Schema.String;
1962
+ readonly version: Schema.optionalKey<Schema.String>;
1963
+ readonly sha256: Schema.optionalKey<Schema.String>;
1964
+ }>;
1965
+ readonly summary: Schema.String;
1966
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
1967
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
1968
+ readonly refs: Schema.$Array<Schema.Struct<{
1969
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
1970
+ readonly id: Schema.optionalKey<Schema.String>;
1971
+ readonly externalId: Schema.optionalKey<Schema.String>;
1972
+ readonly provider: Schema.optionalKey<Schema.String>;
1973
+ readonly title: Schema.optionalKey<Schema.String>;
1974
+ }>>;
1975
+ }>>;
1976
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
1977
+ readonly updatedAt: Schema.String;
1978
+ readonly required: Schema.Literal<true>;
1979
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
1980
+ }>, Schema.Struct<{
1981
+ readonly stepKey: Schema.String;
1982
+ readonly sequence: Schema.Int;
1983
+ readonly attempts: Schema.Int;
1984
+ readonly stepAttemptId: Schema.optionalKey<Schema.String>;
1985
+ readonly startedAt: Schema.optionalKey<Schema.String>;
1986
+ readonly endedAt: Schema.optionalKey<Schema.String>;
1987
+ readonly output: Schema.optionalKey<Schema.Struct<{
1988
+ readonly stepKey: Schema.String;
1989
+ readonly outputSchemaRef: Schema.Struct<{
1990
+ readonly kind: Schema.Literal<"typebox_ref">;
1991
+ readonly name: Schema.String;
1992
+ readonly version: Schema.optionalKey<Schema.String>;
1993
+ readonly sha256: Schema.optionalKey<Schema.String>;
1994
+ }>;
1995
+ readonly summary: Schema.String;
1996
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
1997
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
1998
+ readonly refs: Schema.$Array<Schema.Struct<{
1999
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
2000
+ readonly id: Schema.optionalKey<Schema.String>;
2001
+ readonly externalId: Schema.optionalKey<Schema.String>;
2002
+ readonly provider: Schema.optionalKey<Schema.String>;
2003
+ readonly title: Schema.optionalKey<Schema.String>;
2004
+ }>>;
2005
+ }>>;
2006
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
2007
+ readonly updatedAt: Schema.String;
2008
+ readonly required: Schema.Literal<false>;
2009
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "skipped", "canceled"]>;
2010
+ }>]>>;
2011
+ readonly summary: Schema.optionalKey<Schema.String>;
2012
+ readonly resultMetadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
2013
+ }>;
2014
+ /** A program Run's bundle digest, fixed at admission. */
2015
+ readonly loopDigest: Schema.optionalKey<Schema.String>;
2016
+ /** The layer a program Run's Loop resolved from. */
2017
+ readonly loopLayer: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2018
+ /** A Child Run's parent. */
2019
+ readonly parentRunId: Schema.optionalKey<Schema.String>;
2020
+ readonly waiting: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
2021
+ readonly kind: Schema.Literal<"question">;
2022
+ readonly name: Schema.String;
2023
+ readonly questionId: Schema.String;
2024
+ }>, Schema.Struct<{
2025
+ readonly kind: Schema.Literal<"clock">;
2026
+ readonly name: Schema.String;
2027
+ readonly firesAt: Schema.String;
2028
+ }>, Schema.Struct<{
2029
+ readonly kind: Schema.Literal<"event">;
2030
+ readonly name: Schema.String;
2031
+ readonly event: Schema.String;
2032
+ readonly timesOutAt: Schema.String;
2033
+ }>, Schema.Struct<{
2034
+ readonly kind: Schema.Literal<"step">;
2035
+ readonly name: Schema.String;
2036
+ readonly stepAttemptId: Schema.String;
2037
+ }>, Schema.Struct<{
2038
+ readonly kind: Schema.Literal<"child">;
2039
+ readonly name: Schema.String;
2040
+ readonly runId: Schema.String;
2041
+ }>, Schema.Struct<{
2042
+ readonly kind: Schema.Literal<"verification">;
2043
+ readonly name: Schema.String;
2044
+ readonly verificationId: Schema.String;
2045
+ }>]>>>;
2046
+ readonly output: Schema.optionalKey<Schema.Unknown>;
2047
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
2048
+ /** The latest Closure of a top-level Run. */
2049
+ readonly closure: Schema.optionalKey<Schema.Struct<{
2050
+ readonly kind: Schema.Literals<readonly ["complete", "abandoned"]>;
2051
+ readonly reason: Schema.optionalKey<Schema.String>;
2052
+ readonly closedByUserId: Schema.String;
2053
+ readonly closedAt: Schema.String;
2054
+ }>>;
2055
+ readonly alignment: Schema.optionalKey<Schema.Struct<{
2056
+ readonly verdict: Schema.Literals<readonly ["aligned", "not_aligned", "unverified"]>;
2057
+ readonly reasons: Schema.$Array<Schema.String>;
2058
+ readonly intentVersion: Schema.Int;
2059
+ readonly judgedAt: Schema.String;
2060
+ }>>;
2061
+ readonly startedAt: Schema.optionalKey<Schema.String>;
2062
+ readonly completedAt: Schema.optionalKey<Schema.String>;
2063
+ readonly createdAt: Schema.String;
2064
+ readonly updatedAt: Schema.String;
2065
+ }>;
2066
+ readonly task: Schema.optionalKey<Schema.Struct<{
2067
+ readonly id: Schema.String;
2068
+ readonly taskKey: Schema.String;
2069
+ }>>;
2070
+ readonly inferred: Schema.Struct<{
2071
+ readonly repoBindingId: Schema.optionalKey<Schema.String>;
2072
+ readonly branch: Schema.optionalKey<Schema.String>;
2073
+ readonly changeRequestId: Schema.optionalKey<Schema.String>;
2074
+ readonly trackerKeys: Schema.$Array<Schema.String>;
2075
+ readonly outcome: Schema.optionalKey<Schema.String>;
2076
+ }>;
2077
+ }>;
2078
+ export type RunStarted = (typeof RunStarted)['Type'];
2079
+ /** A program's agent Step and its attempts; `output` is what the latest attempt submitted. */
2080
+ export declare const RunStepSummary: Schema.Struct<{
2081
+ readonly name: Schema.String;
2082
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
2083
+ readonly startedAt: Schema.String;
2084
+ readonly completedAt: Schema.optionalKey<Schema.String>;
2085
+ readonly output: Schema.optionalKey<Schema.Unknown>;
2086
+ readonly attempts: Schema.$Array<Schema.Struct<{
2087
+ readonly id: Schema.String;
2088
+ readonly attempt: Schema.Int;
2089
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
2090
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
2091
+ }>>;
2092
+ }>;
2093
+ export declare const RunSteerDeliveries: readonly ['queued', 'delivered', 'failed'];
2094
+ /** A note a person sent a Run's agent: into its live Session, or with the Run's next agent Step. */
2095
+ export declare const RunSteer: Schema.Struct<{
2096
+ readonly id: Schema.String;
2097
+ readonly text: Schema.String;
2098
+ readonly delivery: Schema.Literals<readonly ["queued", "delivered", "failed"]>;
2099
+ /** The agent Step it was sent to; none while it waits for the next one. */
2100
+ readonly step: Schema.optionalKey<Schema.String>;
2101
+ readonly createdAt: Schema.String;
2102
+ }>;
2103
+ export type RunSteer = (typeof RunSteer)['Type'];
2104
+ export declare const RunSteerInput: Schema.Struct<{
2105
+ readonly text: Schema.String;
2106
+ readonly idempotencyKey: Schema.String;
2107
+ }>;
2108
+ export type RunSteerInput = (typeof RunSteerInput)['Type'];
2109
+ /** Where a steer went: into a live Session, or queued for the Run's next agent Step. */
2110
+ export declare const RunSteerSent: Schema.Struct<{
2111
+ readonly steer: Schema.Struct<{
2112
+ readonly id: Schema.String;
2113
+ readonly text: Schema.String;
2114
+ readonly delivery: Schema.Literals<readonly ["queued", "delivered", "failed"]>;
2115
+ /** The agent Step it was sent to; none while it waits for the next one. */
2116
+ readonly step: Schema.optionalKey<Schema.String>;
2117
+ readonly createdAt: Schema.String;
2118
+ }>;
2119
+ readonly target: Schema.Literals<readonly ["session", "next_step"]>;
2120
+ }>;
2121
+ export type RunSteerSent = (typeof RunSteerSent)['Type'];
2122
+ export declare const RunShow: Schema.Struct<{
2123
+ readonly run: Schema.Struct<{
2124
+ readonly id: Schema.String;
2125
+ readonly workspaceId: Schema.String;
2126
+ readonly projectId: Schema.optionalKey<Schema.String>;
2127
+ readonly taskId: Schema.optionalKey<Schema.String>;
2128
+ readonly sessionId: Schema.optionalKey<Schema.String>;
2129
+ /** The Loop's id in the Package that declared it. */
2130
+ readonly loopId: Schema.String;
2131
+ /** The Package version the Run was admitted with. */
2132
+ readonly packageVersionId: Schema.optionalKey<Schema.String>;
2133
+ readonly resourceVersion: Schema.Int;
2134
+ readonly status: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
2135
+ readonly trigger: Schema.Struct<{
2136
+ readonly event: Schema.String;
2137
+ readonly eventId: Schema.String;
2138
+ readonly subject: Schema.optionalKey<Schema.Struct<{
2139
+ readonly kind: Schema.String;
2140
+ readonly id: Schema.String;
2141
+ }>>;
2142
+ readonly occurredAt: Schema.String;
2143
+ readonly metadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
2144
+ }>;
2145
+ readonly state: Schema.Struct<{
2146
+ readonly stepStates: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
2147
+ readonly stepKey: Schema.String;
2148
+ readonly sequence: Schema.Int;
2149
+ readonly attempts: Schema.Int;
2150
+ readonly stepAttemptId: Schema.optionalKey<Schema.String>;
2151
+ readonly startedAt: Schema.optionalKey<Schema.String>;
2152
+ readonly endedAt: Schema.optionalKey<Schema.String>;
2153
+ readonly output: Schema.optionalKey<Schema.Struct<{
2154
+ readonly stepKey: Schema.String;
2155
+ readonly outputSchemaRef: Schema.Struct<{
2156
+ readonly kind: Schema.Literal<"typebox_ref">;
2157
+ readonly name: Schema.String;
2158
+ readonly version: Schema.optionalKey<Schema.String>;
2159
+ readonly sha256: Schema.optionalKey<Schema.String>;
2160
+ }>;
2161
+ readonly summary: Schema.String;
2162
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
2163
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
2164
+ readonly refs: Schema.$Array<Schema.Struct<{
2165
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
2166
+ readonly id: Schema.optionalKey<Schema.String>;
2167
+ readonly externalId: Schema.optionalKey<Schema.String>;
2168
+ readonly provider: Schema.optionalKey<Schema.String>;
2169
+ readonly title: Schema.optionalKey<Schema.String>;
2170
+ }>>;
2171
+ }>>;
2172
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
2173
+ readonly updatedAt: Schema.String;
2174
+ readonly required: Schema.Literal<true>;
2175
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
2176
+ }>, Schema.Struct<{
2177
+ readonly stepKey: Schema.String;
2178
+ readonly sequence: Schema.Int;
2179
+ readonly attempts: Schema.Int;
2180
+ readonly stepAttemptId: Schema.optionalKey<Schema.String>;
2181
+ readonly startedAt: Schema.optionalKey<Schema.String>;
2182
+ readonly endedAt: Schema.optionalKey<Schema.String>;
2183
+ readonly output: Schema.optionalKey<Schema.Struct<{
2184
+ readonly stepKey: Schema.String;
2185
+ readonly outputSchemaRef: Schema.Struct<{
2186
+ readonly kind: Schema.Literal<"typebox_ref">;
2187
+ readonly name: Schema.String;
2188
+ readonly version: Schema.optionalKey<Schema.String>;
2189
+ readonly sha256: Schema.optionalKey<Schema.String>;
2190
+ }>;
2191
+ readonly summary: Schema.String;
2192
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
2193
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
2194
+ readonly refs: Schema.$Array<Schema.Struct<{
2195
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
2196
+ readonly id: Schema.optionalKey<Schema.String>;
2197
+ readonly externalId: Schema.optionalKey<Schema.String>;
2198
+ readonly provider: Schema.optionalKey<Schema.String>;
2199
+ readonly title: Schema.optionalKey<Schema.String>;
2200
+ }>>;
2201
+ }>>;
2202
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
2203
+ readonly updatedAt: Schema.String;
2204
+ readonly required: Schema.Literal<false>;
2205
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "skipped", "canceled"]>;
2206
+ }>]>>;
2207
+ readonly summary: Schema.optionalKey<Schema.String>;
2208
+ readonly resultMetadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
2209
+ }>;
2210
+ /** A program Run's bundle digest, fixed at admission. */
2211
+ readonly loopDigest: Schema.optionalKey<Schema.String>;
2212
+ /** The layer a program Run's Loop resolved from. */
2213
+ readonly loopLayer: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2214
+ /** A Child Run's parent. */
2215
+ readonly parentRunId: Schema.optionalKey<Schema.String>;
2216
+ readonly waiting: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
2217
+ readonly kind: Schema.Literal<"question">;
2218
+ readonly name: Schema.String;
2219
+ readonly questionId: Schema.String;
2220
+ }>, Schema.Struct<{
2221
+ readonly kind: Schema.Literal<"clock">;
2222
+ readonly name: Schema.String;
2223
+ readonly firesAt: Schema.String;
2224
+ }>, Schema.Struct<{
2225
+ readonly kind: Schema.Literal<"event">;
2226
+ readonly name: Schema.String;
2227
+ readonly event: Schema.String;
2228
+ readonly timesOutAt: Schema.String;
2229
+ }>, Schema.Struct<{
2230
+ readonly kind: Schema.Literal<"step">;
2231
+ readonly name: Schema.String;
2232
+ readonly stepAttemptId: Schema.String;
2233
+ }>, Schema.Struct<{
2234
+ readonly kind: Schema.Literal<"child">;
2235
+ readonly name: Schema.String;
2236
+ readonly runId: Schema.String;
2237
+ }>, Schema.Struct<{
2238
+ readonly kind: Schema.Literal<"verification">;
2239
+ readonly name: Schema.String;
2240
+ readonly verificationId: Schema.String;
2241
+ }>]>>>;
2242
+ readonly output: Schema.optionalKey<Schema.Unknown>;
2243
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
2244
+ /** The latest Closure of a top-level Run. */
2245
+ readonly closure: Schema.optionalKey<Schema.Struct<{
2246
+ readonly kind: Schema.Literals<readonly ["complete", "abandoned"]>;
2247
+ readonly reason: Schema.optionalKey<Schema.String>;
2248
+ readonly closedByUserId: Schema.String;
2249
+ readonly closedAt: Schema.String;
2250
+ }>>;
2251
+ readonly alignment: Schema.optionalKey<Schema.Struct<{
2252
+ readonly verdict: Schema.Literals<readonly ["aligned", "not_aligned", "unverified"]>;
2253
+ readonly reasons: Schema.$Array<Schema.String>;
2254
+ readonly intentVersion: Schema.Int;
2255
+ readonly judgedAt: Schema.String;
2256
+ }>>;
2257
+ readonly startedAt: Schema.optionalKey<Schema.String>;
2258
+ readonly completedAt: Schema.optionalKey<Schema.String>;
2259
+ readonly createdAt: Schema.String;
2260
+ readonly updatedAt: Schema.String;
2261
+ }>;
2262
+ readonly steps: Schema.$Array<Schema.Struct<{
2263
+ readonly name: Schema.String;
2264
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
2265
+ readonly startedAt: Schema.String;
2266
+ readonly completedAt: Schema.optionalKey<Schema.String>;
2267
+ readonly output: Schema.optionalKey<Schema.Unknown>;
2268
+ readonly attempts: Schema.$Array<Schema.Struct<{
2269
+ readonly id: Schema.String;
2270
+ readonly attempt: Schema.Int;
2271
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
2272
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
2273
+ }>>;
2274
+ }>>;
2275
+ readonly questions: Schema.$Array<Schema.Struct<{
2276
+ readonly id: Schema.String;
2277
+ readonly workspaceId: Schema.String;
2278
+ readonly projectId: Schema.optionalKey<Schema.String>;
2279
+ readonly taskId: Schema.optionalKey<Schema.String>;
2280
+ readonly runId: Schema.String;
2281
+ /** The Step that asked: a program's `ask` name or an agent's Step name, such as `next:1`. */
2282
+ readonly stepKey: Schema.String;
2283
+ readonly waitId: Schema.String;
2284
+ readonly taskThreadEntryId: Schema.optionalKey<Schema.String>;
2285
+ readonly prompt: Schema.String;
2286
+ /** A program's closed options; an answer outside them is refused. */
2287
+ readonly options: Schema.optionalKey<Schema.$Array<Schema.String>>;
2288
+ readonly freeText: Schema.optionalKey<Schema.Boolean>;
2289
+ readonly responderPolicy: Schema.Struct<{
2290
+ readonly eligibleMemberIds: Schema.$Array<Schema.String>;
2291
+ readonly allowWorkspaceAdmins: Schema.Boolean;
2292
+ }>;
2293
+ readonly status: Schema.Literals<readonly ["open", "answered", "resume_requested", "resumed", "resume_failed", "expired", "cancelled"]>;
2294
+ readonly answer: Schema.optionalKey<Schema.Struct<{
2295
+ readonly value: Schema.String;
2296
+ readonly answeredByUserId: Schema.String;
2297
+ readonly answeredAt: Schema.String;
2298
+ readonly idempotencyKey: Schema.String;
2299
+ }>>;
2300
+ readonly resolutionOutcome: Schema.optionalKey<Schema.String>;
2301
+ readonly createdAt: Schema.String;
2302
+ readonly updatedAt: Schema.String;
2303
+ readonly resolvedAt: Schema.optionalKey<Schema.String>;
2304
+ }>>;
2305
+ readonly children: Schema.$Array<Schema.Struct<{
2306
+ readonly runId: Schema.String;
2307
+ readonly name: Schema.String;
2308
+ readonly status: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
2309
+ readonly createdAt: Schema.String;
2310
+ }>>;
2311
+ /** The program's own Activities, from the journal. */
2312
+ readonly activities: Schema.$Array<Schema.Struct<{
2313
+ readonly name: Schema.String;
2314
+ readonly attempt: Schema.Int;
2315
+ readonly status: Schema.Literals<readonly ["succeeded", "failed"]>;
2316
+ readonly recordedAt: Schema.String;
2317
+ }>>;
2318
+ readonly artifacts: Schema.$Array<Schema.Struct<{
2319
+ readonly id: Schema.String;
2320
+ readonly runId: Schema.String;
2321
+ readonly projectId: Schema.optionalKey<Schema.String>;
2322
+ readonly taskId: Schema.optionalKey<Schema.String>;
2323
+ readonly step: Schema.String;
2324
+ readonly kind: Schema.String;
2325
+ readonly title: Schema.String;
2326
+ readonly text: Schema.String;
2327
+ readonly data: Schema.optionalKey<Schema.Unknown>;
2328
+ readonly createdAt: Schema.String;
2329
+ }>>;
2330
+ readonly events: Schema.$Array<Schema.Struct<{
2331
+ readonly id: Schema.String;
2332
+ readonly type: Schema.String;
2333
+ readonly occurredAt: Schema.String;
2334
+ }>>;
2335
+ /** What Runners proved for the Run's `verify` Steps; Step Outputs stay claims. */
2336
+ readonly evidence: Schema.$Array<Schema.Struct<{
2337
+ readonly id: Schema.String;
2338
+ readonly step: Schema.String;
2339
+ readonly name: Schema.String;
2340
+ readonly command: Schema.String;
2341
+ readonly status: Schema.Literals<readonly ["passed", "failed"]>;
2342
+ /** It also fails on the default branch, so the Run did not cause it. */
2343
+ readonly preExisting: Schema.Boolean;
2344
+ readonly revision: Schema.String;
2345
+ readonly tree: Schema.String;
2346
+ readonly durationMs: Schema.Int;
2347
+ readonly outputTail: Schema.String;
2348
+ readonly recordedAt: Schema.String;
2349
+ }>>;
2350
+ readonly steers: Schema.$Array<Schema.Struct<{
2351
+ readonly id: Schema.String;
2352
+ readonly text: Schema.String;
2353
+ readonly delivery: Schema.Literals<readonly ["queued", "delivered", "failed"]>;
2354
+ /** The agent Step it was sent to; none while it waits for the next one. */
2355
+ readonly step: Schema.optionalKey<Schema.String>;
2356
+ readonly createdAt: Schema.String;
2357
+ }>>;
2358
+ readonly waiting: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
2359
+ readonly kind: Schema.Literal<"question">;
2360
+ readonly name: Schema.String;
2361
+ readonly questionId: Schema.String;
2362
+ }>, Schema.Struct<{
2363
+ readonly kind: Schema.Literal<"clock">;
2364
+ readonly name: Schema.String;
2365
+ readonly firesAt: Schema.String;
2366
+ }>, Schema.Struct<{
2367
+ readonly kind: Schema.Literal<"event">;
2368
+ readonly name: Schema.String;
2369
+ readonly event: Schema.String;
2370
+ readonly timesOutAt: Schema.String;
2371
+ }>, Schema.Struct<{
2372
+ readonly kind: Schema.Literal<"step">;
2373
+ readonly name: Schema.String;
2374
+ readonly stepAttemptId: Schema.String;
2375
+ }>, Schema.Struct<{
2376
+ readonly kind: Schema.Literal<"child">;
2377
+ readonly name: Schema.String;
2378
+ readonly runId: Schema.String;
2379
+ }>, Schema.Struct<{
2380
+ readonly kind: Schema.Literal<"verification">;
2381
+ readonly name: Schema.String;
2382
+ readonly verificationId: Schema.String;
2383
+ }>]>>;
2384
+ /** Every Closure, newest first; the first is the Run's. */
2385
+ readonly closures: Schema.$Array<Schema.Struct<{
2386
+ readonly kind: Schema.Literals<readonly ["complete", "abandoned"]>;
2387
+ readonly reason: Schema.optionalKey<Schema.String>;
2388
+ readonly closedByUserId: Schema.String;
2389
+ readonly closedAt: Schema.String;
2390
+ }>>;
2391
+ }>;
2392
+ export type RunShow = (typeof RunShow)['Type'];
2393
+ export declare const RunStartPreview: Schema.Struct<{
2394
+ readonly loop: Schema.Struct<{
2395
+ readonly id: Schema.String;
2396
+ readonly title: Schema.String;
2397
+ readonly outcome: Schema.optionalKey<Schema.String>;
2398
+ }>;
2399
+ /** The Loop Input's JSON Schema. */
2400
+ readonly inputSchema: Schema.$Record<Schema.String, Schema.Unknown>;
2401
+ readonly input: Schema.$Record<Schema.String, Schema.Unknown>;
2402
+ readonly missing: Schema.$Array<Schema.String>;
2403
+ readonly projectId: Schema.optionalKey<Schema.String>;
2404
+ readonly inferred: Schema.Struct<{
2405
+ readonly repoBindingId: Schema.optionalKey<Schema.String>;
2406
+ readonly branch: Schema.optionalKey<Schema.String>;
2407
+ readonly changeRequestId: Schema.optionalKey<Schema.String>;
2408
+ readonly trackerKeys: Schema.$Array<Schema.String>;
2409
+ readonly outcome: Schema.optionalKey<Schema.String>;
2410
+ }>;
2411
+ }>;
2412
+ export type RunStartPreview = (typeof RunStartPreview)['Type'];
2413
+ /** A Loop as Runs resolve it: the layer it comes from and the digest a new Run pins. */
2414
+ export declare const ProgramLoop: Schema.Struct<{
2415
+ readonly id: Schema.String;
2416
+ readonly title: Schema.String;
2417
+ readonly layer: Schema.Literals<readonly ["project", "workspace", "shipped"]>;
2418
+ readonly digest: Schema.String;
2419
+ readonly outcome: Schema.optionalKey<Schema.String>;
2420
+ readonly offers: Schema.$Array<Schema.Struct<{
2421
+ readonly id: Schema.String;
2422
+ readonly title: Schema.String;
2423
+ readonly loop: Schema.String;
2424
+ }>>;
2425
+ readonly publishedAt: Schema.String;
2426
+ /** The Package that declares it. */
2427
+ readonly package: Schema.String;
2428
+ }>;
2429
+ export type ProgramLoop = (typeof ProgramLoop)['Type'];
2430
+ /** A Loop as it resolves where it was asked about. */
2431
+ export declare const LoopDetail: Schema.Struct<{
2432
+ readonly id: Schema.String;
2433
+ readonly resolved: Schema.optionalKey<Schema.Struct<{
2434
+ readonly id: Schema.String;
2435
+ readonly title: Schema.String;
2436
+ readonly layer: Schema.Literals<readonly ["project", "workspace", "shipped"]>;
2437
+ readonly digest: Schema.String;
2438
+ readonly outcome: Schema.optionalKey<Schema.String>;
2439
+ readonly offers: Schema.$Array<Schema.Struct<{
2440
+ readonly id: Schema.String;
2441
+ readonly title: Schema.String;
2442
+ readonly loop: Schema.String;
2443
+ }>>;
2444
+ readonly publishedAt: Schema.String;
2445
+ /** The Package that declares it. */
2446
+ readonly package: Schema.String;
2447
+ }>>;
2448
+ }>;
2449
+ export type LoopDetail = (typeof LoopDetail)['Type'];
2450
+ /** What an Event did to one program Loop: the Run it started, or why it started none. */
2451
+ export declare const AutomaticStart: Schema.Struct<{
2452
+ readonly eventId: Schema.String;
2453
+ readonly eventType: Schema.String;
2454
+ readonly projectId: Schema.Union<readonly [Schema.String, Schema.Null]>;
2455
+ readonly loop: Schema.String;
2456
+ readonly runId: Schema.optionalKey<Schema.String>;
2457
+ readonly rejection: Schema.optionalKey<Schema.String>;
2458
+ readonly at: Schema.String;
2459
+ }>;
2460
+ export type AutomaticStart = (typeof AutomaticStart)['Type'];
2461
+ export declare const AutomaticStartList: Schema.Struct<{
2462
+ readonly items: Schema.$Array<Schema.Struct<{
2463
+ readonly eventId: Schema.String;
2464
+ readonly eventType: Schema.String;
2465
+ readonly projectId: Schema.Union<readonly [Schema.String, Schema.Null]>;
2466
+ readonly loop: Schema.String;
2467
+ readonly runId: Schema.optionalKey<Schema.String>;
2468
+ readonly rejection: Schema.optionalKey<Schema.String>;
2469
+ readonly at: Schema.String;
2470
+ }>>;
2471
+ }>;
2472
+ export type AutomaticStartList = (typeof AutomaticStartList)['Type'];
2473
+ /** An Agent as it resolves where it was asked about, merged with what it extends. */
2474
+ export declare const ProgramAgent: Schema.Struct<{
2475
+ readonly id: Schema.String;
2476
+ readonly layer: Schema.Literals<readonly ["project", "workspace", "shipped"]>;
2477
+ /** The Package that declares it. */
2478
+ readonly package: Schema.String;
2479
+ readonly extends: Schema.optionalKey<Schema.String>;
2480
+ readonly instructions: Schema.optionalKey<Schema.String>;
2481
+ readonly harness: Schema.optionalKey<Schema.String>;
2482
+ readonly model: Schema.optionalKey<Schema.String>;
2483
+ readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
2484
+ readonly kits: Schema.optionalKey<Schema.$Array<Schema.String>>;
2485
+ readonly network: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
2486
+ readonly hosts: Schema.$Array<Schema.String>;
2487
+ }>, Schema.Literal<"open">]>>;
2488
+ /** Steps run only on Runners that run agents in docker. */
2489
+ readonly sandbox: Schema.optionalKey<Schema.Literal<"docker">>;
2490
+ /** The layer each resolved field came from. */
2491
+ readonly fieldLayers: Schema.optionalKey<Schema.Struct<{
2492
+ readonly instructions: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2493
+ readonly harness: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2494
+ readonly model: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2495
+ readonly effort: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2496
+ readonly kits: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2497
+ readonly network: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2498
+ readonly sandbox: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2499
+ }>>;
2500
+ }>;
2501
+ export type ProgramAgent = (typeof ProgramAgent)['Type'];
2502
+ export declare const ProgramAgentList: Schema.Struct<{
2503
+ readonly items: Schema.$Array<Schema.Struct<{
2504
+ readonly id: Schema.String;
2505
+ readonly layer: Schema.Literals<readonly ["project", "workspace", "shipped"]>;
2506
+ /** The Package that declares it. */
2507
+ readonly package: Schema.String;
2508
+ readonly extends: Schema.optionalKey<Schema.String>;
2509
+ readonly instructions: Schema.optionalKey<Schema.String>;
2510
+ readonly harness: Schema.optionalKey<Schema.String>;
2511
+ readonly model: Schema.optionalKey<Schema.String>;
2512
+ readonly effort: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high", "xhigh"]>>;
2513
+ readonly kits: Schema.optionalKey<Schema.$Array<Schema.String>>;
2514
+ readonly network: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
2515
+ readonly hosts: Schema.$Array<Schema.String>;
2516
+ }>, Schema.Literal<"open">]>>;
2517
+ /** Steps run only on Runners that run agents in docker. */
2518
+ readonly sandbox: Schema.optionalKey<Schema.Literal<"docker">>;
2519
+ /** The layer each resolved field came from. */
2520
+ readonly fieldLayers: Schema.optionalKey<Schema.Struct<{
2521
+ readonly instructions: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2522
+ readonly harness: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2523
+ readonly model: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2524
+ readonly effort: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2525
+ readonly kits: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2526
+ readonly network: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2527
+ readonly sandbox: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2528
+ }>>;
2529
+ }>>;
2530
+ }>;
2531
+ export type ProgramAgentList = (typeof ProgramAgentList)['Type'];
2532
+ export declare const ProgramLoopList: Schema.Struct<{
2533
+ readonly items: Schema.$Array<Schema.Struct<{
2534
+ readonly id: Schema.String;
2535
+ readonly title: Schema.String;
2536
+ readonly layer: Schema.Literals<readonly ["project", "workspace", "shipped"]>;
2537
+ readonly digest: Schema.String;
2538
+ readonly outcome: Schema.optionalKey<Schema.String>;
2539
+ readonly offers: Schema.$Array<Schema.Struct<{
2540
+ readonly id: Schema.String;
2541
+ readonly title: Schema.String;
2542
+ readonly loop: Schema.String;
2543
+ }>>;
2544
+ readonly publishedAt: Schema.String;
2545
+ /** The Package that declares it. */
2546
+ readonly package: Schema.String;
2547
+ }>>;
2548
+ }>;
2549
+ export type ProgramLoopList = (typeof ProgramLoopList)['Type'];
2550
+ export declare const RunList: Schema.Struct<{
2551
+ readonly items: Schema.$Array<Schema.Struct<{
2552
+ readonly id: Schema.String;
2553
+ readonly workspaceId: Schema.String;
2554
+ readonly projectId: Schema.optionalKey<Schema.String>;
2555
+ readonly taskId: Schema.optionalKey<Schema.String>;
2556
+ readonly sessionId: Schema.optionalKey<Schema.String>;
2557
+ /** The Loop's id in the Package that declared it. */
2558
+ readonly loopId: Schema.String;
2559
+ /** The Package version the Run was admitted with. */
2560
+ readonly packageVersionId: Schema.optionalKey<Schema.String>;
2561
+ readonly resourceVersion: Schema.Int;
2562
+ readonly status: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
2563
+ readonly trigger: Schema.Struct<{
2564
+ readonly event: Schema.String;
2565
+ readonly eventId: Schema.String;
2566
+ readonly subject: Schema.optionalKey<Schema.Struct<{
2567
+ readonly kind: Schema.String;
2568
+ readonly id: Schema.String;
2569
+ }>>;
2570
+ readonly occurredAt: Schema.String;
2571
+ readonly metadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
2572
+ }>;
2573
+ readonly state: Schema.Struct<{
2574
+ readonly stepStates: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
2575
+ readonly stepKey: Schema.String;
2576
+ readonly sequence: Schema.Int;
2577
+ readonly attempts: Schema.Int;
2578
+ readonly stepAttemptId: Schema.optionalKey<Schema.String>;
2579
+ readonly startedAt: Schema.optionalKey<Schema.String>;
2580
+ readonly endedAt: Schema.optionalKey<Schema.String>;
2581
+ readonly output: Schema.optionalKey<Schema.Struct<{
2582
+ readonly stepKey: Schema.String;
2583
+ readonly outputSchemaRef: Schema.Struct<{
2584
+ readonly kind: Schema.Literal<"typebox_ref">;
2585
+ readonly name: Schema.String;
2586
+ readonly version: Schema.optionalKey<Schema.String>;
2587
+ readonly sha256: Schema.optionalKey<Schema.String>;
2588
+ }>;
2589
+ readonly summary: Schema.String;
2590
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
2591
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
2592
+ readonly refs: Schema.$Array<Schema.Struct<{
2593
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
2594
+ readonly id: Schema.optionalKey<Schema.String>;
2595
+ readonly externalId: Schema.optionalKey<Schema.String>;
2596
+ readonly provider: Schema.optionalKey<Schema.String>;
2597
+ readonly title: Schema.optionalKey<Schema.String>;
2598
+ }>>;
2599
+ }>>;
2600
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
2601
+ readonly updatedAt: Schema.String;
2602
+ readonly required: Schema.Literal<true>;
2603
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
2604
+ }>, Schema.Struct<{
2605
+ readonly stepKey: Schema.String;
2606
+ readonly sequence: Schema.Int;
2607
+ readonly attempts: Schema.Int;
2608
+ readonly stepAttemptId: Schema.optionalKey<Schema.String>;
2609
+ readonly startedAt: Schema.optionalKey<Schema.String>;
2610
+ readonly endedAt: Schema.optionalKey<Schema.String>;
2611
+ readonly output: Schema.optionalKey<Schema.Struct<{
2612
+ readonly stepKey: Schema.String;
2613
+ readonly outputSchemaRef: Schema.Struct<{
2614
+ readonly kind: Schema.Literal<"typebox_ref">;
2615
+ readonly name: Schema.String;
2616
+ readonly version: Schema.optionalKey<Schema.String>;
2617
+ readonly sha256: Schema.optionalKey<Schema.String>;
2618
+ }>;
2619
+ readonly summary: Schema.String;
2620
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
2621
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
2622
+ readonly refs: Schema.$Array<Schema.Struct<{
2623
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
2624
+ readonly id: Schema.optionalKey<Schema.String>;
2625
+ readonly externalId: Schema.optionalKey<Schema.String>;
2626
+ readonly provider: Schema.optionalKey<Schema.String>;
2627
+ readonly title: Schema.optionalKey<Schema.String>;
2628
+ }>>;
2629
+ }>>;
2630
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
2631
+ readonly updatedAt: Schema.String;
2632
+ readonly required: Schema.Literal<false>;
2633
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "skipped", "canceled"]>;
2634
+ }>]>>;
2635
+ readonly summary: Schema.optionalKey<Schema.String>;
2636
+ readonly resultMetadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
2637
+ }>;
2638
+ /** A program Run's bundle digest, fixed at admission. */
2639
+ readonly loopDigest: Schema.optionalKey<Schema.String>;
2640
+ /** The layer a program Run's Loop resolved from. */
2641
+ readonly loopLayer: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2642
+ /** A Child Run's parent. */
2643
+ readonly parentRunId: Schema.optionalKey<Schema.String>;
2644
+ readonly waiting: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
2645
+ readonly kind: Schema.Literal<"question">;
2646
+ readonly name: Schema.String;
2647
+ readonly questionId: Schema.String;
2648
+ }>, Schema.Struct<{
2649
+ readonly kind: Schema.Literal<"clock">;
2650
+ readonly name: Schema.String;
2651
+ readonly firesAt: Schema.String;
2652
+ }>, Schema.Struct<{
2653
+ readonly kind: Schema.Literal<"event">;
2654
+ readonly name: Schema.String;
2655
+ readonly event: Schema.String;
2656
+ readonly timesOutAt: Schema.String;
2657
+ }>, Schema.Struct<{
2658
+ readonly kind: Schema.Literal<"step">;
2659
+ readonly name: Schema.String;
2660
+ readonly stepAttemptId: Schema.String;
2661
+ }>, Schema.Struct<{
2662
+ readonly kind: Schema.Literal<"child">;
2663
+ readonly name: Schema.String;
2664
+ readonly runId: Schema.String;
2665
+ }>, Schema.Struct<{
2666
+ readonly kind: Schema.Literal<"verification">;
2667
+ readonly name: Schema.String;
2668
+ readonly verificationId: Schema.String;
2669
+ }>]>>>;
2670
+ readonly output: Schema.optionalKey<Schema.Unknown>;
2671
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
2672
+ /** The latest Closure of a top-level Run. */
2673
+ readonly closure: Schema.optionalKey<Schema.Struct<{
2674
+ readonly kind: Schema.Literals<readonly ["complete", "abandoned"]>;
2675
+ readonly reason: Schema.optionalKey<Schema.String>;
2676
+ readonly closedByUserId: Schema.String;
2677
+ readonly closedAt: Schema.String;
2678
+ }>>;
2679
+ readonly alignment: Schema.optionalKey<Schema.Struct<{
2680
+ readonly verdict: Schema.Literals<readonly ["aligned", "not_aligned", "unverified"]>;
2681
+ readonly reasons: Schema.$Array<Schema.String>;
2682
+ readonly intentVersion: Schema.Int;
2683
+ readonly judgedAt: Schema.String;
2684
+ }>>;
2685
+ readonly startedAt: Schema.optionalKey<Schema.String>;
2686
+ readonly completedAt: Schema.optionalKey<Schema.String>;
2687
+ readonly createdAt: Schema.String;
2688
+ readonly updatedAt: Schema.String;
2689
+ }>>;
2690
+ }>;
2691
+ export type RunList = (typeof RunList)['Type'];
2692
+ export declare const RunWaitUntils: readonly ['attention', 'finished'];
2693
+ export type RunWaitUntil = (typeof RunWaitUntils)[number];
2694
+ export declare const RunWaitReasons: readonly ['question', 'completed', 'failed', 'stopped', 'timeout'];
2695
+ export declare const RunWaitResult: Schema.Struct<{
2696
+ readonly reason: Schema.Literals<readonly ["question", "completed", "failed", "stopped", "timeout"]>;
2697
+ readonly run: Schema.Struct<{
2698
+ readonly id: Schema.String;
2699
+ readonly workspaceId: Schema.String;
2700
+ readonly projectId: Schema.optionalKey<Schema.String>;
2701
+ readonly taskId: Schema.optionalKey<Schema.String>;
2702
+ readonly sessionId: Schema.optionalKey<Schema.String>;
2703
+ /** The Loop's id in the Package that declared it. */
2704
+ readonly loopId: Schema.String;
2705
+ /** The Package version the Run was admitted with. */
2706
+ readonly packageVersionId: Schema.optionalKey<Schema.String>;
2707
+ readonly resourceVersion: Schema.Int;
2708
+ readonly status: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
2709
+ readonly trigger: Schema.Struct<{
2710
+ readonly event: Schema.String;
2711
+ readonly eventId: Schema.String;
2712
+ readonly subject: Schema.optionalKey<Schema.Struct<{
2713
+ readonly kind: Schema.String;
2714
+ readonly id: Schema.String;
2715
+ }>>;
2716
+ readonly occurredAt: Schema.String;
2717
+ readonly metadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
2718
+ }>;
2719
+ readonly state: Schema.Struct<{
2720
+ readonly stepStates: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
2721
+ readonly stepKey: Schema.String;
2722
+ readonly sequence: Schema.Int;
2723
+ readonly attempts: Schema.Int;
2724
+ readonly stepAttemptId: Schema.optionalKey<Schema.String>;
2725
+ readonly startedAt: Schema.optionalKey<Schema.String>;
2726
+ readonly endedAt: Schema.optionalKey<Schema.String>;
2727
+ readonly output: Schema.optionalKey<Schema.Struct<{
2728
+ readonly stepKey: Schema.String;
2729
+ readonly outputSchemaRef: Schema.Struct<{
2730
+ readonly kind: Schema.Literal<"typebox_ref">;
2731
+ readonly name: Schema.String;
2732
+ readonly version: Schema.optionalKey<Schema.String>;
2733
+ readonly sha256: Schema.optionalKey<Schema.String>;
2734
+ }>;
2735
+ readonly summary: Schema.String;
2736
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
2737
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
2738
+ readonly refs: Schema.$Array<Schema.Struct<{
2739
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
2740
+ readonly id: Schema.optionalKey<Schema.String>;
2741
+ readonly externalId: Schema.optionalKey<Schema.String>;
2742
+ readonly provider: Schema.optionalKey<Schema.String>;
2743
+ readonly title: Schema.optionalKey<Schema.String>;
2744
+ }>>;
2745
+ }>>;
2746
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
2747
+ readonly updatedAt: Schema.String;
2748
+ readonly required: Schema.Literal<true>;
2749
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
2750
+ }>, Schema.Struct<{
2751
+ readonly stepKey: Schema.String;
2752
+ readonly sequence: Schema.Int;
2753
+ readonly attempts: Schema.Int;
2754
+ readonly stepAttemptId: Schema.optionalKey<Schema.String>;
2755
+ readonly startedAt: Schema.optionalKey<Schema.String>;
2756
+ readonly endedAt: Schema.optionalKey<Schema.String>;
2757
+ readonly output: Schema.optionalKey<Schema.Struct<{
2758
+ readonly stepKey: Schema.String;
2759
+ readonly outputSchemaRef: Schema.Struct<{
2760
+ readonly kind: Schema.Literal<"typebox_ref">;
2761
+ readonly name: Schema.String;
2762
+ readonly version: Schema.optionalKey<Schema.String>;
2763
+ readonly sha256: Schema.optionalKey<Schema.String>;
2764
+ }>;
2765
+ readonly summary: Schema.String;
2766
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
2767
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
2768
+ readonly refs: Schema.$Array<Schema.Struct<{
2769
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
2770
+ readonly id: Schema.optionalKey<Schema.String>;
2771
+ readonly externalId: Schema.optionalKey<Schema.String>;
2772
+ readonly provider: Schema.optionalKey<Schema.String>;
2773
+ readonly title: Schema.optionalKey<Schema.String>;
2774
+ }>>;
2775
+ }>>;
2776
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
2777
+ readonly updatedAt: Schema.String;
2778
+ readonly required: Schema.Literal<false>;
2779
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "skipped", "canceled"]>;
2780
+ }>]>>;
2781
+ readonly summary: Schema.optionalKey<Schema.String>;
2782
+ readonly resultMetadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
2783
+ }>;
2784
+ /** A program Run's bundle digest, fixed at admission. */
2785
+ readonly loopDigest: Schema.optionalKey<Schema.String>;
2786
+ /** The layer a program Run's Loop resolved from. */
2787
+ readonly loopLayer: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2788
+ /** A Child Run's parent. */
2789
+ readonly parentRunId: Schema.optionalKey<Schema.String>;
2790
+ readonly waiting: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
2791
+ readonly kind: Schema.Literal<"question">;
2792
+ readonly name: Schema.String;
2793
+ readonly questionId: Schema.String;
2794
+ }>, Schema.Struct<{
2795
+ readonly kind: Schema.Literal<"clock">;
2796
+ readonly name: Schema.String;
2797
+ readonly firesAt: Schema.String;
2798
+ }>, Schema.Struct<{
2799
+ readonly kind: Schema.Literal<"event">;
2800
+ readonly name: Schema.String;
2801
+ readonly event: Schema.String;
2802
+ readonly timesOutAt: Schema.String;
2803
+ }>, Schema.Struct<{
2804
+ readonly kind: Schema.Literal<"step">;
2805
+ readonly name: Schema.String;
2806
+ readonly stepAttemptId: Schema.String;
2807
+ }>, Schema.Struct<{
2808
+ readonly kind: Schema.Literal<"child">;
2809
+ readonly name: Schema.String;
2810
+ readonly runId: Schema.String;
2811
+ }>, Schema.Struct<{
2812
+ readonly kind: Schema.Literal<"verification">;
2813
+ readonly name: Schema.String;
2814
+ readonly verificationId: Schema.String;
2815
+ }>]>>>;
2816
+ readonly output: Schema.optionalKey<Schema.Unknown>;
2817
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
2818
+ /** The latest Closure of a top-level Run. */
2819
+ readonly closure: Schema.optionalKey<Schema.Struct<{
2820
+ readonly kind: Schema.Literals<readonly ["complete", "abandoned"]>;
2821
+ readonly reason: Schema.optionalKey<Schema.String>;
2822
+ readonly closedByUserId: Schema.String;
2823
+ readonly closedAt: Schema.String;
2824
+ }>>;
2825
+ readonly alignment: Schema.optionalKey<Schema.Struct<{
2826
+ readonly verdict: Schema.Literals<readonly ["aligned", "not_aligned", "unverified"]>;
2827
+ readonly reasons: Schema.$Array<Schema.String>;
2828
+ readonly intentVersion: Schema.Int;
2829
+ readonly judgedAt: Schema.String;
2830
+ }>>;
2831
+ readonly startedAt: Schema.optionalKey<Schema.String>;
2832
+ readonly completedAt: Schema.optionalKey<Schema.String>;
2833
+ readonly createdAt: Schema.String;
2834
+ readonly updatedAt: Schema.String;
2835
+ }>;
2836
+ readonly questions: Schema.$Array<Schema.Struct<{
2837
+ readonly id: Schema.String;
2838
+ readonly workspaceId: Schema.String;
2839
+ readonly projectId: Schema.optionalKey<Schema.String>;
2840
+ readonly taskId: Schema.optionalKey<Schema.String>;
2841
+ readonly runId: Schema.String;
2842
+ /** The Step that asked: a program's `ask` name or an agent's Step name, such as `next:1`. */
2843
+ readonly stepKey: Schema.String;
2844
+ readonly waitId: Schema.String;
2845
+ readonly taskThreadEntryId: Schema.optionalKey<Schema.String>;
2846
+ readonly prompt: Schema.String;
2847
+ /** A program's closed options; an answer outside them is refused. */
2848
+ readonly options: Schema.optionalKey<Schema.$Array<Schema.String>>;
2849
+ readonly freeText: Schema.optionalKey<Schema.Boolean>;
2850
+ readonly responderPolicy: Schema.Struct<{
2851
+ readonly eligibleMemberIds: Schema.$Array<Schema.String>;
2852
+ readonly allowWorkspaceAdmins: Schema.Boolean;
2853
+ }>;
2854
+ readonly status: Schema.Literals<readonly ["open", "answered", "resume_requested", "resumed", "resume_failed", "expired", "cancelled"]>;
2855
+ readonly answer: Schema.optionalKey<Schema.Struct<{
2856
+ readonly value: Schema.String;
2857
+ readonly answeredByUserId: Schema.String;
2858
+ readonly answeredAt: Schema.String;
2859
+ readonly idempotencyKey: Schema.String;
2860
+ }>>;
2861
+ readonly resolutionOutcome: Schema.optionalKey<Schema.String>;
2862
+ readonly createdAt: Schema.String;
2863
+ readonly updatedAt: Schema.String;
2864
+ readonly resolvedAt: Schema.optionalKey<Schema.String>;
2865
+ }>>;
2866
+ }>;
2867
+ export type RunWaitResult = (typeof RunWaitResult)['Type'];
2868
+ export declare const RunAnswer: Schema.Struct<{
2869
+ readonly value: Schema.String;
2870
+ /** The Question's Step name; needed only while several are open. */
2871
+ readonly question: Schema.optionalKey<Schema.String>;
2872
+ readonly idempotencyKey: Schema.String;
2873
+ }>;
2874
+ export type RunAnswer = (typeof RunAnswer)['Type'];
2875
+ export declare const RunActionKinds: readonly ['offer', 'stop', 'resume'];
2876
+ export declare const RunActionSummary: Schema.Struct<{
2877
+ readonly id: Schema.String;
2878
+ readonly title: Schema.String;
2879
+ readonly kind: Schema.Literals<readonly ["offer", "stop", "resume"]>;
2880
+ readonly loop: Schema.optionalKey<Schema.String>;
2881
+ }>;
2882
+ export type RunActionSummary = (typeof RunActionSummary)['Type'];
2883
+ export declare const RunActionList: Schema.Struct<{
2884
+ readonly items: Schema.$Array<Schema.Struct<{
2885
+ readonly id: Schema.String;
2886
+ readonly title: Schema.String;
2887
+ readonly kind: Schema.Literals<readonly ["offer", "stop", "resume"]>;
2888
+ readonly loop: Schema.optionalKey<Schema.String>;
2889
+ }>>;
2890
+ }>;
2891
+ export type RunActionList = (typeof RunActionList)['Type'];
2892
+ export declare const RunActionTaken: Schema.Struct<{
2893
+ readonly action: Schema.String;
2894
+ readonly run: Schema.Struct<{
2895
+ readonly id: Schema.String;
2896
+ readonly workspaceId: Schema.String;
2897
+ readonly projectId: Schema.optionalKey<Schema.String>;
2898
+ readonly taskId: Schema.optionalKey<Schema.String>;
2899
+ readonly sessionId: Schema.optionalKey<Schema.String>;
2900
+ /** The Loop's id in the Package that declared it. */
2901
+ readonly loopId: Schema.String;
2902
+ /** The Package version the Run was admitted with. */
2903
+ readonly packageVersionId: Schema.optionalKey<Schema.String>;
2904
+ readonly resourceVersion: Schema.Int;
2905
+ readonly status: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
2906
+ readonly trigger: Schema.Struct<{
2907
+ readonly event: Schema.String;
2908
+ readonly eventId: Schema.String;
2909
+ readonly subject: Schema.optionalKey<Schema.Struct<{
2910
+ readonly kind: Schema.String;
2911
+ readonly id: Schema.String;
2912
+ }>>;
2913
+ readonly occurredAt: Schema.String;
2914
+ readonly metadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
2915
+ }>;
2916
+ readonly state: Schema.Struct<{
2917
+ readonly stepStates: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
2918
+ readonly stepKey: Schema.String;
2919
+ readonly sequence: Schema.Int;
2920
+ readonly attempts: Schema.Int;
2921
+ readonly stepAttemptId: Schema.optionalKey<Schema.String>;
2922
+ readonly startedAt: Schema.optionalKey<Schema.String>;
2923
+ readonly endedAt: Schema.optionalKey<Schema.String>;
2924
+ readonly output: Schema.optionalKey<Schema.Struct<{
2925
+ readonly stepKey: Schema.String;
2926
+ readonly outputSchemaRef: Schema.Struct<{
2927
+ readonly kind: Schema.Literal<"typebox_ref">;
2928
+ readonly name: Schema.String;
2929
+ readonly version: Schema.optionalKey<Schema.String>;
2930
+ readonly sha256: Schema.optionalKey<Schema.String>;
2931
+ }>;
2932
+ readonly summary: Schema.String;
2933
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
2934
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
2935
+ readonly refs: Schema.$Array<Schema.Struct<{
2936
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
2937
+ readonly id: Schema.optionalKey<Schema.String>;
2938
+ readonly externalId: Schema.optionalKey<Schema.String>;
2939
+ readonly provider: Schema.optionalKey<Schema.String>;
2940
+ readonly title: Schema.optionalKey<Schema.String>;
2941
+ }>>;
2942
+ }>>;
2943
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
2944
+ readonly updatedAt: Schema.String;
2945
+ readonly required: Schema.Literal<true>;
2946
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
2947
+ }>, Schema.Struct<{
2948
+ readonly stepKey: Schema.String;
2949
+ readonly sequence: Schema.Int;
2950
+ readonly attempts: Schema.Int;
2951
+ readonly stepAttemptId: Schema.optionalKey<Schema.String>;
2952
+ readonly startedAt: Schema.optionalKey<Schema.String>;
2953
+ readonly endedAt: Schema.optionalKey<Schema.String>;
2954
+ readonly output: Schema.optionalKey<Schema.Struct<{
2955
+ readonly stepKey: Schema.String;
2956
+ readonly outputSchemaRef: Schema.Struct<{
2957
+ readonly kind: Schema.Literal<"typebox_ref">;
2958
+ readonly name: Schema.String;
2959
+ readonly version: Schema.optionalKey<Schema.String>;
2960
+ readonly sha256: Schema.optionalKey<Schema.String>;
2961
+ }>;
2962
+ readonly summary: Schema.String;
2963
+ readonly data: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
2964
+ readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>>;
2965
+ readonly refs: Schema.$Array<Schema.Struct<{
2966
+ readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
2967
+ readonly id: Schema.optionalKey<Schema.String>;
2968
+ readonly externalId: Schema.optionalKey<Schema.String>;
2969
+ readonly provider: Schema.optionalKey<Schema.String>;
2970
+ readonly title: Schema.optionalKey<Schema.String>;
2971
+ }>>;
2972
+ }>>;
2973
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
2974
+ readonly updatedAt: Schema.String;
2975
+ readonly required: Schema.Literal<false>;
2976
+ readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "skipped", "canceled"]>;
2977
+ }>]>>;
2978
+ readonly summary: Schema.optionalKey<Schema.String>;
2979
+ readonly resultMetadata: Schema.$Record<Schema.String, Schema.Codec<LoopStepOutputDataValue, LoopStepOutputDataValue, never, never>>;
2980
+ }>;
2981
+ /** A program Run's bundle digest, fixed at admission. */
2982
+ readonly loopDigest: Schema.optionalKey<Schema.String>;
2983
+ /** The layer a program Run's Loop resolved from. */
2984
+ readonly loopLayer: Schema.optionalKey<Schema.Literals<readonly ["project", "workspace", "shipped"]>>;
2985
+ /** A Child Run's parent. */
2986
+ readonly parentRunId: Schema.optionalKey<Schema.String>;
2987
+ readonly waiting: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
2988
+ readonly kind: Schema.Literal<"question">;
2989
+ readonly name: Schema.String;
2990
+ readonly questionId: Schema.String;
2991
+ }>, Schema.Struct<{
2992
+ readonly kind: Schema.Literal<"clock">;
2993
+ readonly name: Schema.String;
2994
+ readonly firesAt: Schema.String;
2995
+ }>, Schema.Struct<{
2996
+ readonly kind: Schema.Literal<"event">;
2997
+ readonly name: Schema.String;
2998
+ readonly event: Schema.String;
2999
+ readonly timesOutAt: Schema.String;
3000
+ }>, Schema.Struct<{
3001
+ readonly kind: Schema.Literal<"step">;
3002
+ readonly name: Schema.String;
3003
+ readonly stepAttemptId: Schema.String;
3004
+ }>, Schema.Struct<{
3005
+ readonly kind: Schema.Literal<"child">;
3006
+ readonly name: Schema.String;
3007
+ readonly runId: Schema.String;
3008
+ }>, Schema.Struct<{
3009
+ readonly kind: Schema.Literal<"verification">;
3010
+ readonly name: Schema.String;
3011
+ readonly verificationId: Schema.String;
3012
+ }>]>>>;
3013
+ readonly output: Schema.optionalKey<Schema.Unknown>;
3014
+ readonly failureSummary: Schema.optionalKey<Schema.String>;
3015
+ /** The latest Closure of a top-level Run. */
3016
+ readonly closure: Schema.optionalKey<Schema.Struct<{
3017
+ readonly kind: Schema.Literals<readonly ["complete", "abandoned"]>;
3018
+ readonly reason: Schema.optionalKey<Schema.String>;
3019
+ readonly closedByUserId: Schema.String;
3020
+ readonly closedAt: Schema.String;
3021
+ }>>;
3022
+ readonly alignment: Schema.optionalKey<Schema.Struct<{
3023
+ readonly verdict: Schema.Literals<readonly ["aligned", "not_aligned", "unverified"]>;
3024
+ readonly reasons: Schema.$Array<Schema.String>;
3025
+ readonly intentVersion: Schema.Int;
3026
+ readonly judgedAt: Schema.String;
3027
+ }>>;
3028
+ readonly startedAt: Schema.optionalKey<Schema.String>;
3029
+ readonly completedAt: Schema.optionalKey<Schema.String>;
3030
+ readonly createdAt: Schema.String;
3031
+ readonly updatedAt: Schema.String;
3032
+ }>;
3033
+ }>;
3034
+ export type RunActionTaken = (typeof RunActionTaken)['Type'];
3035
+ export type LoopStatus = (typeof LoopStatus)['Type'];
3036
+ export type LoopTriggerEvent = (typeof LoopTriggerEvent)['Type'];
3037
+ export type LoopStepImplementationKind = (typeof LoopStepImplementationKind)['Type'];
3038
+ export type RunStatus = (typeof RunStatus)['Type'];
3039
+ export type StepAttemptStatus = (typeof StepAttemptStatus)['Type'];
3040
+ export type QuestionStatus = (typeof QuestionStatus)['Type'];
3041
+ export type LoopSourceMode = (typeof LoopSourceMode)['Type'];
3042
+ export type LoopCapabilityKind = (typeof LoopCapabilityKind)['Type'];
3043
+ export type LoopCapabilityScope = (typeof LoopCapabilityScope)['Type'];
3044
+ export type LoopCapabilityGrant = (typeof LoopCapabilityGrant)['Type'];
3045
+ export type LoopRequiredContextSlice = (typeof LoopRequiredContextSlice)['Type'];
3046
+ export type LoopRetryPolicy = (typeof LoopRetryPolicy)['Type'];
3047
+ export type LoopTimeoutPolicy = (typeof LoopTimeoutPolicy)['Type'];
3048
+ export type LoopDataSchemaRef = (typeof LoopDataSchemaRef)['Type'];
3049
+ export type LoopSafeMetadata = (typeof LoopSafeMetadata)['Type'];
3050
+ export type LoopSafeRef = (typeof LoopSafeRef)['Type'];
3051
+ export type LoopSource = (typeof LoopSource)['Type'];
3052
+ export type LoopStepPackageMetadata = (typeof LoopStepPackageMetadata)['Type'];
3053
+ export type LoopRepeatUntilSafetyPolicy = (typeof LoopRepeatUntilSafetyPolicy)['Type'];
3054
+ export type LoopStepInputBinding = (typeof LoopStepInputBinding)['Type'];
3055
+ export type LoopStepOutputRef = (typeof LoopStepOutputRef)['Type'];
3056
+ export type LoopAgentRuntimeComponentSelector = (typeof LoopAgentRuntimeComponentSelector)['Type'];
3057
+ export type LoopAgentStepImplementation = (typeof LoopAgentStepImplementation)['Type'];
3058
+ export type LoopConcreteActionImplementation = (typeof LoopConcreteActionImplementation)['Type'];
3059
+ export type LoopStepImplementation = (typeof LoopStepImplementation)['Type'];
3060
+ export type LoopStep = (typeof LoopStep)['Type'];
3061
+ export type LoopStepOutput = (typeof LoopStepOutput)['Type'];
3062
+ export type RunStepState = (typeof RunStepState)['Type'];
3063
+ export type RunState = (typeof RunState)['Type'];
3064
+ export type Run = (typeof Run)['Type'];
3065
+ export type RunWaiting = (typeof RunWaiting)['Type'];
3066
+ export type StepAttemptInputManifest = (typeof StepAttemptInputManifest)['Type'];
3067
+ export type StepAttemptAgent = (typeof StepAttemptAgent)['Type'];
3068
+ export type StepAttemptExecutionEnvironment = (typeof StepAttemptExecutionEnvironment)['Type'];
3069
+ export type StepAttempt = (typeof StepAttempt)['Type'];
3070
+ export type StepAttemptList = (typeof StepAttemptList)['Type'];
3071
+ export type QuestionResponderPolicy = (typeof QuestionResponderPolicy)['Type'];
3072
+ export type QuestionAnswer = (typeof QuestionAnswer)['Type'];
3073
+ export type Question = (typeof Question)['Type'];
3074
+ export type QuestionAnswerCreate = (typeof QuestionAnswerCreate)['Type'];
3075
+ export type QuestionList = (typeof QuestionList)['Type'];
3076
+ export declare function findForbiddenLoopPayloadPath<ValueType>(value: ValueType, path?: string): string | undefined;