@claudexor/schema 3.20.1 → 3.23.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 (147) hide show
  1. package/dist/agent-capabilities.d.ts +9 -9
  2. package/dist/agent-capabilities.d.ts.map +1 -1
  3. package/dist/agent-capabilities.js +2 -1
  4. package/dist/agent-capabilities.js.map +1 -1
  5. package/dist/command-list.d.ts +108 -37
  6. package/dist/command-list.d.ts.map +1 -1
  7. package/dist/command-list.js +17 -35
  8. package/dist/command-list.js.map +1 -1
  9. package/dist/command-summary.d.ts +8 -0
  10. package/dist/command-summary.d.ts.map +1 -0
  11. package/dist/command-summary.js +33 -0
  12. package/dist/command-summary.js.map +1 -0
  13. package/dist/continuation-admission.d.ts +41 -0
  14. package/dist/continuation-admission.d.ts.map +1 -0
  15. package/dist/continuation-admission.js +136 -0
  16. package/dist/continuation-admission.js.map +1 -0
  17. package/dist/control-operation-responses.d.ts +357 -0
  18. package/dist/control-operation-responses.d.ts.map +1 -1
  19. package/dist/control-operation-responses.js +2 -0
  20. package/dist/control-operation-responses.js.map +1 -1
  21. package/dist/control-run-detail.d.ts +726 -0
  22. package/dist/control-run-detail.d.ts.map +1 -1
  23. package/dist/control-run-execution.js +1 -1
  24. package/dist/control-run-execution.js.map +1 -1
  25. package/dist/control-thread-requests.d.ts +17 -3
  26. package/dist/control-thread-requests.d.ts.map +1 -1
  27. package/dist/control-thread-requests.js +24 -1
  28. package/dist/control-thread-requests.js.map +1 -1
  29. package/dist/control.d.ts +347 -22
  30. package/dist/control.d.ts.map +1 -1
  31. package/dist/control.js +32 -4
  32. package/dist/control.js.map +1 -1
  33. package/dist/credential-profile-snapshot.d.ts +144 -0
  34. package/dist/credential-profile-snapshot.d.ts.map +1 -1
  35. package/dist/credential-profile.d.ts +1 -1
  36. package/dist/credential-profile.js +1 -1
  37. package/dist/daemon-status.d.ts +177 -0
  38. package/dist/daemon-status.d.ts.map +1 -0
  39. package/dist/daemon-status.js +27 -0
  40. package/dist/daemon-status.js.map +1 -0
  41. package/dist/decision.d.ts +12 -0
  42. package/dist/decision.d.ts.map +1 -1
  43. package/dist/effort.d.ts +33 -12
  44. package/dist/effort.d.ts.map +1 -1
  45. package/dist/effort.js +43 -13
  46. package/dist/effort.js.map +1 -1
  47. package/dist/events.d.ts +4 -4
  48. package/dist/events.d.ts.map +1 -1
  49. package/dist/events.js +11 -0
  50. package/dist/events.js.map +1 -1
  51. package/dist/harness.d.ts +16 -9
  52. package/dist/harness.d.ts.map +1 -1
  53. package/dist/harness.js +3 -3
  54. package/dist/index.d.ts +6 -0
  55. package/dist/index.d.ts.map +1 -1
  56. package/dist/index.js +6 -0
  57. package/dist/index.js.map +1 -1
  58. package/dist/mcp-run-result.d.ts +155 -0
  59. package/dist/mcp-run-result.d.ts.map +1 -1
  60. package/dist/mcp-run-result.js +38 -0
  61. package/dist/mcp-run-result.js.map +1 -1
  62. package/dist/project.d.ts +2 -2
  63. package/dist/project.d.ts.map +1 -1
  64. package/dist/project.js +3 -3
  65. package/dist/project.js.map +1 -1
  66. package/dist/quota.d.ts +252 -0
  67. package/dist/quota.d.ts.map +1 -1
  68. package/dist/quota.js +42 -17
  69. package/dist/quota.js.map +1 -1
  70. package/dist/raw.d.ts +1 -1
  71. package/dist/raw.d.ts.map +1 -1
  72. package/dist/raw.js +0 -1
  73. package/dist/raw.js.map +1 -1
  74. package/dist/run-continuation.d.ts +166 -0
  75. package/dist/run-continuation.d.ts.map +1 -0
  76. package/dist/run-continuation.js +65 -0
  77. package/dist/run-continuation.js.map +1 -0
  78. package/dist/run-continuity.d.ts +215 -0
  79. package/dist/run-continuity.d.ts.map +1 -0
  80. package/dist/run-continuity.js +170 -0
  81. package/dist/run-continuity.js.map +1 -0
  82. package/dist/run-facts.d.ts +7 -0
  83. package/dist/run-facts.d.ts.map +1 -1
  84. package/dist/run-list-page.d.ts +74 -0
  85. package/dist/run-list-page.d.ts.map +1 -0
  86. package/dist/run-list-page.js +85 -0
  87. package/dist/run-list-page.js.map +1 -0
  88. package/dist/run-strategy.d.ts +18 -0
  89. package/dist/run-strategy.d.ts.map +1 -1
  90. package/dist/run-strategy.js +15 -0
  91. package/dist/run-strategy.js.map +1 -1
  92. package/dist/status-projection.d.ts +8 -1
  93. package/dist/status-projection.d.ts.map +1 -1
  94. package/dist/status-projection.js +22 -1
  95. package/dist/status-projection.js.map +1 -1
  96. package/dist/telemetry.d.ts +33 -3
  97. package/dist/telemetry.d.ts.map +1 -1
  98. package/dist/telemetry.js +3 -3
  99. package/dist/telemetry.js.map +1 -1
  100. package/dist/thread.d.ts +24 -10
  101. package/dist/thread.d.ts.map +1 -1
  102. package/dist/thread.js +14 -4
  103. package/dist/thread.js.map +1 -1
  104. package/dist/work-report.d.ts +18 -4
  105. package/dist/work-report.d.ts.map +1 -1
  106. package/dist/work-report.js +26 -5
  107. package/dist/work-report.js.map +1 -1
  108. package/generated/AgentCapabilityCatalog.schema.json +5 -4
  109. package/generated/CommandListQuery.schema.json +204 -0
  110. package/generated/ControlCredentialProfilesQueryResponse.schema.json +21 -6
  111. package/generated/ControlCredentialProfilesSnapshotResponse.schema.json +21 -6
  112. package/generated/ControlDaemonStatus.schema.json +150 -0
  113. package/generated/ControlHarnessListResponse.schema.json +1 -1
  114. package/generated/ControlHarnessSettingsPatch.schema.json +1 -1
  115. package/generated/ControlProjectRemoveReceipt.schema.json +1 -1
  116. package/generated/ControlQuotaResponse.schema.json +20 -5
  117. package/generated/ControlRetainedEnvelope.schema.json +63 -0
  118. package/generated/ControlRunAgainDraft.schema.json +17 -1
  119. package/generated/ControlRunDetail.schema.json +406 -1
  120. package/generated/ControlRunListResponse.schema.json +406 -1
  121. package/generated/ControlRunStartRequest.schema.json +17 -1
  122. package/generated/ControlRunSummary.schema.json +406 -1
  123. package/generated/ControlSettingsSnapshot.schema.json +1 -1
  124. package/generated/ControlSettingsUpdateRequest.schema.json +1 -1
  125. package/generated/ControlThread.schema.json +11 -2
  126. package/generated/ControlThreadCreateRequest.schema.json +7 -2
  127. package/generated/ControlThreadDetail.schema.json +25 -3
  128. package/generated/ControlThreadListResponse.schema.json +11 -2
  129. package/generated/ControlThreadTurnRequest.schema.json +4 -0
  130. package/generated/DecisionRecord.schema.json +14 -1
  131. package/generated/EnvelopeCustody.schema.json +195 -0
  132. package/generated/GlobalConfig.schema.json +1 -1
  133. package/generated/HarnessEvent.schema.json +7 -2
  134. package/generated/HarnessManifest.schema.json +1 -1
  135. package/generated/HarnessStatusDto.schema.json +1 -1
  136. package/generated/McpRunHandleResult.schema.json +109 -1
  137. package/generated/McpRunToolResult.schema.json +14 -1
  138. package/generated/RunContinuityReceipt.schema.json +182 -0
  139. package/generated/RunEvent.schema.json +3 -1
  140. package/generated/RunFacts.schema.json +14 -1
  141. package/generated/RunListQuery.schema.json +66 -0
  142. package/generated/RunResumable.schema.json +153 -0
  143. package/generated/RunTelemetry.schema.json +14 -1
  144. package/generated/SessionCapsule.schema.json +78 -0
  145. package/generated/TaskContract.schema.json +1 -1
  146. package/generated/Thread.schema.json +12 -3
  147. package/package.json +2 -2
@@ -0,0 +1,177 @@
1
+ import { z } from "zod/v3";
2
+ export declare const DaemonMemoryFacts: z.ZodObject<{
3
+ heapUsedBytes: z.ZodNumber;
4
+ heapLimitBytes: z.ZodNumber;
5
+ rssBytes: z.ZodNumber;
6
+ externalBytes: z.ZodNumber;
7
+ nodeHeapArgs: z.ZodArray<z.ZodString, "many">;
8
+ atAdmission: z.ZodNullable<z.ZodObject<{
9
+ heapUsedBytes: z.ZodNumber;
10
+ rssBytes: z.ZodNumber;
11
+ at: z.ZodString;
12
+ }, "strip", z.ZodTypeAny, {
13
+ heapUsedBytes: number;
14
+ rssBytes: number;
15
+ at: string;
16
+ }, {
17
+ heapUsedBytes: number;
18
+ rssBytes: number;
19
+ at: string;
20
+ }>>;
21
+ sampledAt: z.ZodString;
22
+ }, "strip", z.ZodTypeAny, {
23
+ heapUsedBytes: number;
24
+ heapLimitBytes: number;
25
+ rssBytes: number;
26
+ externalBytes: number;
27
+ nodeHeapArgs: string[];
28
+ atAdmission: {
29
+ heapUsedBytes: number;
30
+ rssBytes: number;
31
+ at: string;
32
+ } | null;
33
+ sampledAt: string;
34
+ }, {
35
+ heapUsedBytes: number;
36
+ heapLimitBytes: number;
37
+ rssBytes: number;
38
+ externalBytes: number;
39
+ nodeHeapArgs: string[];
40
+ atAdmission: {
41
+ heapUsedBytes: number;
42
+ rssBytes: number;
43
+ at: string;
44
+ } | null;
45
+ sampledAt: string;
46
+ }>;
47
+ export type DaemonMemoryFacts = z.infer<typeof DaemonMemoryFacts>;
48
+ /** Authenticated process facts, separate from the strict protocol handshake. */
49
+ export declare const ControlDaemonStatus: z.ZodObject<{
50
+ ok: z.ZodLiteral<true>;
51
+ uptime_ms: z.ZodNumber;
52
+ queue: z.ZodNumber;
53
+ running: z.ZodBoolean;
54
+ active: z.ZodNumber;
55
+ jobs: z.ZodNumber;
56
+ stopping: z.ZodBoolean;
57
+ servingMode: z.ZodEnum<["normal", "recovery_only"]>;
58
+ capacity: z.ZodObject<{
59
+ maxConcurrent: z.ZodNumber;
60
+ maxCouncilMembers: z.ZodOptional<z.ZodNumber>;
61
+ maxDeepScanWidth: z.ZodOptional<z.ZodNumber>;
62
+ maxParallelCandidates: z.ZodOptional<z.ZodNumber>;
63
+ }, "strip", z.ZodTypeAny, {
64
+ maxConcurrent: number;
65
+ maxCouncilMembers?: number | undefined;
66
+ maxDeepScanWidth?: number | undefined;
67
+ maxParallelCandidates?: number | undefined;
68
+ }, {
69
+ maxConcurrent: number;
70
+ maxCouncilMembers?: number | undefined;
71
+ maxDeepScanWidth?: number | undefined;
72
+ maxParallelCandidates?: number | undefined;
73
+ }>;
74
+ memory: z.ZodObject<{
75
+ heapUsedBytes: z.ZodNumber;
76
+ heapLimitBytes: z.ZodNumber;
77
+ rssBytes: z.ZodNumber;
78
+ externalBytes: z.ZodNumber;
79
+ nodeHeapArgs: z.ZodArray<z.ZodString, "many">;
80
+ atAdmission: z.ZodNullable<z.ZodObject<{
81
+ heapUsedBytes: z.ZodNumber;
82
+ rssBytes: z.ZodNumber;
83
+ at: z.ZodString;
84
+ }, "strip", z.ZodTypeAny, {
85
+ heapUsedBytes: number;
86
+ rssBytes: number;
87
+ at: string;
88
+ }, {
89
+ heapUsedBytes: number;
90
+ rssBytes: number;
91
+ at: string;
92
+ }>>;
93
+ sampledAt: z.ZodString;
94
+ }, "strip", z.ZodTypeAny, {
95
+ heapUsedBytes: number;
96
+ heapLimitBytes: number;
97
+ rssBytes: number;
98
+ externalBytes: number;
99
+ nodeHeapArgs: string[];
100
+ atAdmission: {
101
+ heapUsedBytes: number;
102
+ rssBytes: number;
103
+ at: string;
104
+ } | null;
105
+ sampledAt: string;
106
+ }, {
107
+ heapUsedBytes: number;
108
+ heapLimitBytes: number;
109
+ rssBytes: number;
110
+ externalBytes: number;
111
+ nodeHeapArgs: string[];
112
+ atAdmission: {
113
+ heapUsedBytes: number;
114
+ rssBytes: number;
115
+ at: string;
116
+ } | null;
117
+ sampledAt: string;
118
+ }>;
119
+ }, "strip", z.ZodTypeAny, {
120
+ ok: true;
121
+ uptime_ms: number;
122
+ queue: number;
123
+ running: boolean;
124
+ active: number;
125
+ jobs: number;
126
+ stopping: boolean;
127
+ servingMode: "normal" | "recovery_only";
128
+ capacity: {
129
+ maxConcurrent: number;
130
+ maxCouncilMembers?: number | undefined;
131
+ maxDeepScanWidth?: number | undefined;
132
+ maxParallelCandidates?: number | undefined;
133
+ };
134
+ memory: {
135
+ heapUsedBytes: number;
136
+ heapLimitBytes: number;
137
+ rssBytes: number;
138
+ externalBytes: number;
139
+ nodeHeapArgs: string[];
140
+ atAdmission: {
141
+ heapUsedBytes: number;
142
+ rssBytes: number;
143
+ at: string;
144
+ } | null;
145
+ sampledAt: string;
146
+ };
147
+ }, {
148
+ ok: true;
149
+ uptime_ms: number;
150
+ queue: number;
151
+ running: boolean;
152
+ active: number;
153
+ jobs: number;
154
+ stopping: boolean;
155
+ servingMode: "normal" | "recovery_only";
156
+ capacity: {
157
+ maxConcurrent: number;
158
+ maxCouncilMembers?: number | undefined;
159
+ maxDeepScanWidth?: number | undefined;
160
+ maxParallelCandidates?: number | undefined;
161
+ };
162
+ memory: {
163
+ heapUsedBytes: number;
164
+ heapLimitBytes: number;
165
+ rssBytes: number;
166
+ externalBytes: number;
167
+ nodeHeapArgs: string[];
168
+ atAdmission: {
169
+ heapUsedBytes: number;
170
+ rssBytes: number;
171
+ at: string;
172
+ } | null;
173
+ sampledAt: string;
174
+ };
175
+ }>;
176
+ export type ControlDaemonStatus = z.infer<typeof ControlDaemonStatus>;
177
+ //# sourceMappingURL=daemon-status.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"daemon-status.d.ts","sourceRoot":"","sources":["../src/daemon-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAK3B,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ5B,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,gFAAgF;AAChF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
@@ -0,0 +1,27 @@
1
+ import { z } from "zod/v3";
2
+ import { IsoTimestamp } from "./primitives.js";
3
+ import { RuntimeConcurrencyState } from "./runtime-concurrency.js";
4
+ const bytes = z.number().int().nonnegative();
5
+ export const DaemonMemoryFacts = z.object({
6
+ heapUsedBytes: bytes,
7
+ heapLimitBytes: bytes,
8
+ rssBytes: bytes,
9
+ externalBytes: bytes,
10
+ nodeHeapArgs: z.array(z.string()),
11
+ atAdmission: z.object({ heapUsedBytes: bytes, rssBytes: bytes, at: IsoTimestamp }).nullable(),
12
+ sampledAt: IsoTimestamp,
13
+ });
14
+ /** Authenticated process facts, separate from the strict protocol handshake. */
15
+ export const ControlDaemonStatus = z.object({
16
+ ok: z.literal(true),
17
+ uptime_ms: z.number().nonnegative(),
18
+ queue: z.number().int().nonnegative(),
19
+ running: z.boolean(),
20
+ active: z.number().int().nonnegative(),
21
+ jobs: z.number().int().nonnegative(),
22
+ stopping: z.boolean(),
23
+ servingMode: z.enum(["normal", "recovery_only"]),
24
+ capacity: RuntimeConcurrencyState.shape.effective.partial().required({ maxConcurrent: true }),
25
+ memory: DaemonMemoryFacts,
26
+ });
27
+ //# sourceMappingURL=daemon-status.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"daemon-status.js","sourceRoot":"","sources":["../src/daemon-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;AAC7C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,aAAa,EAAE,KAAK;IACpB,cAAc,EAAE,KAAK;IACrB,QAAQ,EAAE,KAAK;IACf,aAAa,EAAE,KAAK;IACpB,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7F,SAAS,EAAE,YAAY;CACxB,CAAC,CAAC;AAGH,gFAAgF;AAChF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACrC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACpC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAChD,QAAQ,EAAE,uBAAuB,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IAC7F,MAAM,EAAE,iBAAiB;CAC1B,CAAC,CAAC"}
@@ -76,6 +76,7 @@ export declare const RunOutcomeFacts: z.ZodObject<{
76
76
  locator?: string | null | undefined;
77
77
  description: string;
78
78
  }>, "many">>;
79
+ unverified_reason: z.ZodOptional<z.ZodEnum<["footer_missing", "footer_not_json", "footer_not_object", "report_missing", "report_malformed", "report_contradictory", "legacy_output_invalid"]>>;
79
80
  }, "strip", z.ZodTypeAny, {
80
81
  state: "completed" | "incomplete" | "needs_input" | "unverified";
81
82
  source: "absent" | "constrained" | "validated";
@@ -84,6 +85,7 @@ export declare const RunOutcomeFacts: z.ZodObject<{
84
85
  locator: string | null;
85
86
  description: string;
86
87
  }[] | undefined;
88
+ unverified_reason?: "footer_missing" | "footer_not_json" | "footer_not_object" | "legacy_output_invalid" | "report_contradictory" | "report_malformed" | "report_missing" | undefined;
87
89
  }, {
88
90
  state: "completed" | "incomplete" | "needs_input" | "unverified";
89
91
  source: "absent" | "constrained" | "validated";
@@ -92,6 +94,7 @@ export declare const RunOutcomeFacts: z.ZodObject<{
92
94
  locator?: string | null | undefined;
93
95
  description: string;
94
96
  }[] | undefined;
97
+ unverified_reason?: "footer_missing" | "footer_not_json" | "footer_not_object" | "legacy_output_invalid" | "report_contradictory" | "report_malformed" | "report_missing" | undefined;
95
98
  }>>;
96
99
  }, "strict", z.ZodTypeAny, {
97
100
  lifecycle: "cancelled" | "failed" | "interrupted" | "succeeded";
@@ -108,6 +111,7 @@ export declare const RunOutcomeFacts: z.ZodObject<{
108
111
  locator: string | null;
109
112
  description: string;
110
113
  }[] | undefined;
114
+ unverified_reason?: "footer_missing" | "footer_not_json" | "footer_not_object" | "legacy_output_invalid" | "report_contradictory" | "report_malformed" | "report_missing" | undefined;
111
115
  } | undefined;
112
116
  }, {
113
117
  lifecycle: "cancelled" | "failed" | "interrupted" | "succeeded";
@@ -124,6 +128,7 @@ export declare const RunOutcomeFacts: z.ZodObject<{
124
128
  locator?: string | null | undefined;
125
129
  description: string;
126
130
  }[] | undefined;
131
+ unverified_reason?: "footer_missing" | "footer_not_json" | "footer_not_object" | "legacy_output_invalid" | "report_contradictory" | "report_malformed" | "report_missing" | undefined;
127
132
  } | undefined;
128
133
  }>;
129
134
  export type RunOutcomeFacts = z.infer<typeof RunOutcomeFacts>;
@@ -222,6 +227,7 @@ export declare const DecisionRecord: z.ZodObject<{
222
227
  locator?: string | null | undefined;
223
228
  description: string;
224
229
  }>, "many">>;
230
+ unverified_reason: z.ZodOptional<z.ZodEnum<["footer_missing", "footer_not_json", "footer_not_object", "report_missing", "report_malformed", "report_contradictory", "legacy_output_invalid"]>>;
225
231
  }, "strip", z.ZodTypeAny, {
226
232
  state: "completed" | "incomplete" | "needs_input" | "unverified";
227
233
  source: "absent" | "constrained" | "validated";
@@ -230,6 +236,7 @@ export declare const DecisionRecord: z.ZodObject<{
230
236
  locator: string | null;
231
237
  description: string;
232
238
  }[] | undefined;
239
+ unverified_reason?: "footer_missing" | "footer_not_json" | "footer_not_object" | "legacy_output_invalid" | "report_contradictory" | "report_malformed" | "report_missing" | undefined;
233
240
  }, {
234
241
  state: "completed" | "incomplete" | "needs_input" | "unverified";
235
242
  source: "absent" | "constrained" | "validated";
@@ -238,6 +245,7 @@ export declare const DecisionRecord: z.ZodObject<{
238
245
  locator?: string | null | undefined;
239
246
  description: string;
240
247
  }[] | undefined;
248
+ unverified_reason?: "footer_missing" | "footer_not_json" | "footer_not_object" | "legacy_output_invalid" | "report_contradictory" | "report_malformed" | "report_missing" | undefined;
241
249
  }>>;
242
250
  }, "strict", z.ZodTypeAny, {
243
251
  lifecycle: "cancelled" | "failed" | "interrupted" | "succeeded";
@@ -254,6 +262,7 @@ export declare const DecisionRecord: z.ZodObject<{
254
262
  locator: string | null;
255
263
  description: string;
256
264
  }[] | undefined;
265
+ unverified_reason?: "footer_missing" | "footer_not_json" | "footer_not_object" | "legacy_output_invalid" | "report_contradictory" | "report_malformed" | "report_missing" | undefined;
257
266
  } | undefined;
258
267
  }, {
259
268
  lifecycle: "cancelled" | "failed" | "interrupted" | "succeeded";
@@ -270,6 +279,7 @@ export declare const DecisionRecord: z.ZodObject<{
270
279
  locator?: string | null | undefined;
271
280
  description: string;
272
281
  }[] | undefined;
282
+ unverified_reason?: "footer_missing" | "footer_not_json" | "footer_not_object" | "legacy_output_invalid" | "report_contradictory" | "report_malformed" | "report_missing" | undefined;
273
283
  } | undefined;
274
284
  }>;
275
285
  why_winner: z.ZodDefault<z.ZodString>;
@@ -388,6 +398,7 @@ export declare const DecisionRecord: z.ZodObject<{
388
398
  locator: string | null;
389
399
  description: string;
390
400
  }[] | undefined;
401
+ unverified_reason?: "footer_missing" | "footer_not_json" | "footer_not_object" | "legacy_output_invalid" | "report_contradictory" | "report_malformed" | "report_missing" | undefined;
391
402
  } | undefined;
392
403
  };
393
404
  why_winner: string;
@@ -446,6 +457,7 @@ export declare const DecisionRecord: z.ZodObject<{
446
457
  locator?: string | null | undefined;
447
458
  description: string;
448
459
  }[] | undefined;
460
+ unverified_reason?: "footer_missing" | "footer_not_json" | "footer_not_object" | "legacy_output_invalid" | "report_contradictory" | "report_malformed" | "report_missing" | undefined;
449
461
  } | undefined;
450
462
  };
451
463
  why_winner?: string | undefined;
@@ -1 +1 @@
1
- {"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../src/decision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAI3B,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAciD,CAAC;AACjF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;uEAEuE;AACvE,eAAO,MAAM,WAAW,mDAIrB,CAAC;AACJ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;wEACwE;AACxE,eAAO,MAAM,WAAW,+CAIrB,CAAC;AACJ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;cAEc;AACd,eAAO,MAAM,SAAS,0YA2B+D,CAAC;AACtF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;;+EAG+E;AAC/E,eAAO,MAAM,eAAe;;;;;;;IAqBxB;;;;;;OAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM4D,CAAC;AACpE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;kFACkF;AAClF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,kBAAkB,CAAC,GAC1D,OAAO,CAIT;AAED,eAAO,MAAM,mBAAmB,6DAI7B,CAAC;AACJ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAItE,eAAO,MAAM,iBAAiB,4EAI3B,CAAC;AACJ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;IAO1B,8EAA8E;;;;;;;;;;;;;;;IAgC9E,0FAA0F;;;;;;;;;;;;;;;;;;;;;;;;;;EAW3F,CAAC;AACJ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,cAAc;;IAGvB;;0DAEsD;;;;;;;;QA1GtD;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAiDH,8EAA8E;;;;;;;;;;;;;;;QAgC9E,0FAA0F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwI3F,CAAC;AACJ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}
1
+ {"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../src/decision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAI3B,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAciD,CAAC;AACjF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;uEAEuE;AACvE,eAAO,MAAM,WAAW,mDAIrB,CAAC;AACJ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;wEACwE;AACxE,eAAO,MAAM,WAAW,+CAIrB,CAAC;AACJ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;cAEc;AACd,eAAO,MAAM,SAAS,0YA2B+D,CAAC;AACtF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;;+EAG+E;AAC/E,eAAO,MAAM,eAAe;;;;;;;IAqBxB;;;;;;OAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM4D,CAAC;AACpE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;kFACkF;AAClF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,kBAAkB,CAAC,GAC1D,OAAO,CAIT;AAED,eAAO,MAAM,mBAAmB,6DAI7B,CAAC;AACJ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAItE,eAAO,MAAM,iBAAiB,4EAI3B,CAAC;AACJ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;IAO1B,8EAA8E;;;;;;;;;;;;;;;IAgC9E,0FAA0F;;;;;;;;;;;;;;;;;;;;;;;;;;EAW3F,CAAC;AACJ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,cAAc;;IAGvB;;0DAEsD;;;;;;;;QA1GtD;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAiDH,8EAA8E;;;;;;;;;;;;;;;QAgC9E,0FAA0F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwI3F,CAAC;AACJ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}
package/dist/effort.d.ts CHANGED
@@ -6,15 +6,26 @@ import { z } from "zod/v3";
6
6
  * its own consumers — adapters, the CLI, the MCP tool schema and the macOS
7
7
  * picker all resolve through here rather than copying a level list.
8
8
  *
9
- * There is deliberately NO static rank table here. Vendors already return
10
- * their effort levels ORDERED weakest→strongest (codex `model/list` →
11
- * `supportedReasoningEfforts` is an ordered array per model; `claude --help`
12
- * prints the `--effort` values in order), and that order is part of the parsed
13
- * vendor response. Ordering authority is therefore the vendor's own advertised
14
- * sequence: a model's ladder is its own ordered list, a harness's ladder is
9
+ * ORDERING DOCTRINE. The vendor's own advertised order is the primary rank
10
+ * authority: vendors already return their effort levels ORDERED
11
+ * weakest→strongest (codex `model/list` → `supportedReasoningEfforts` is an
12
+ * ordered array per model; `claude --help` prints the `--effort` values in
13
+ * order), so a model's ladder is its own ordered list, a harness's ladder is
15
14
  * the positional merge of its models' lists (`mergeEffortLadders`), and a
16
- * level's rank is its position in that merged list. A second, hand-maintained
17
- * copy of that knowledge can only ever disagree with the first.
15
+ * level's rank is its position in that merged list. A brand-new vendor level
16
+ * therefore sorts correctly with no code change.
17
+ *
18
+ * `EFFORT_PREFERENCE_ORDER` below is NOT a second copy of that knowledge and
19
+ * never replaces it. It is the shared vocabulary every Claudexor client speaks
20
+ * (Ouroboros' `EFFORT_SCALE` is the same row), consulted ONLY to place a
21
+ * requested word that the route's own vendor ladder does not list at all
22
+ * (`ultra` on a Claude binary that stops at `max`, `none` on a vendor whose
23
+ * ladder starts at `low`). Placing a word is not a claim that the vendor
24
+ * supports it, nor that two vendors' words of the same name are of equal
25
+ * quality: the resolver still submits only a level the route actually
26
+ * advertises, and the receipt says the shared order did the placing. Where the
27
+ * vendor lists contradict the shared order, the vendor wins inside its own
28
+ * ladder and the shared fallback is unavailable (never an invented rank).
18
29
  */
19
30
  /** Longest effort slug accepted on the wire. */
20
31
  export declare const EFFORT_HINT_MAX_LENGTH = 32;
@@ -26,13 +37,23 @@ export declare const EFFORT_HINT_PATTERN: RegExp;
26
37
  * `ReasoningEffort` as "a non-empty reasoning effort value advertised by the
27
38
  * model"). Adapters advertise the subset they actually accept per (harness,
28
39
  * model); the shared normalizer passes an advertised level through verbatim,
29
- * resolves a known preference downward (or to the known minimum)
30
- * inside the vendor's own order, and REFUSES a level the merged ladder has
31
- * never seen — so a vendor level newer than this repo works with no code
32
- * change, and a typo is never silently downgraded.
40
+ * resolves a known preference downward (or to the known minimum) inside the
41
+ * vendor's own order, falls back to `EFFORT_PREFERENCE_ORDER` only to place a
42
+ * word the vendor ladder does not list, and REFUSES a word neither places — so
43
+ * a vendor level newer than this repo works with no code change, and a typo is
44
+ * never silently downgraded.
33
45
  */
34
46
  export declare const EffortHint: z.ZodString;
35
47
  export type EffortHint = z.infer<typeof EffortHint>;
48
+ /**
49
+ * The shared preference order every Claudexor client speaks, weakest→strongest.
50
+ * A FALLBACK placement aid, not a rank table (see the doctrine above): the
51
+ * resolver consults it only for a word the route's own vendor ladder does not
52
+ * list, submits only vendor-advertised levels, and names the placement in the
53
+ * receipt. Listing a word here declares neither vendor support nor equal
54
+ * quality across vendors. Same row as Ouroboros' `EFFORT_SCALE`.
55
+ */
56
+ export declare const EFFORT_PREFERENCE_ORDER: readonly EffortHint[];
36
57
  /** One receipt for preparation and independent provider observation. Dispatch
37
58
  * remains the operation/session lifecycle's fact, never inferred from this. */
38
59
  export declare const EffortResolution: z.ZodObject<{
@@ -1 +1 @@
1
- {"version":3,"file":"effort.d.ts","sourceRoot":"","sources":["../src/effort.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAG3B;;;;;;;;;;;;;;;;GAgBG;AAEH,gDAAgD;AAChD,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,QAAkC,CAAC;AAEnE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,aAUpB,CAAC;AACJ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;+EAC+E;AAC/E,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuBlB,CAAC;AACZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,mFAAmF;AACnF,eAAO,MAAM,qBAAqB;;;;;;;;;EAamC,CAAC;AACtE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,QAEiD,CAAC;AAE/E;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ7E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE;IACZ,aAAa,EAAE,SAAS,UAAU,EAAE,CAAC;IACrC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CAC5D,EACD,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,SAAS,UAAU,EAAE,CAIvB;AAED,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB;;;;;;;;;OASG;IACH,aAAa,EAAE,UAAU,EAAE,CAAC;IAC5B;;;;;;OAMG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,CAAC,SAAS,UAAU,EAAE,CAAC,GAC1C,kBAAkB,CAkDpB"}
1
+ {"version":3,"file":"effort.d.ts","sourceRoot":"","sources":["../src/effort.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAG3B;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,gDAAgD;AAChD,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,QAAkC,CAAC;AAEnE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,aAUpB,CAAC;AACJ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,UAAU,EASxD,CAAC;AAEF;+EAC+E;AAC/E,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuBlB,CAAC;AACZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,mFAAmF;AACnF,eAAO,MAAM,qBAAqB;;;;;;;;;EAamC,CAAC;AACtE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,QAEiD,CAAC;AAE/E;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ7E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE;IACZ,aAAa,EAAE,SAAS,UAAU,EAAE,CAAC;IACrC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CAC5D,EACD,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,SAAS,UAAU,EAAE,CAIvB;AAED,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB;;;;;;;;;OASG;IACH,aAAa,EAAE,UAAU,EAAE,CAAC;IAC5B;;;;;;OAMG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,CAAC,SAAS,UAAU,EAAE,CAAC,GAC1C,kBAAkB,CAkDpB"}
package/dist/effort.js CHANGED
@@ -7,15 +7,26 @@ import { NonBlankString } from "./primitives.js";
7
7
  * its own consumers — adapters, the CLI, the MCP tool schema and the macOS
8
8
  * picker all resolve through here rather than copying a level list.
9
9
  *
10
- * There is deliberately NO static rank table here. Vendors already return
11
- * their effort levels ORDERED weakest→strongest (codex `model/list` →
12
- * `supportedReasoningEfforts` is an ordered array per model; `claude --help`
13
- * prints the `--effort` values in order), and that order is part of the parsed
14
- * vendor response. Ordering authority is therefore the vendor's own advertised
15
- * sequence: a model's ladder is its own ordered list, a harness's ladder is
10
+ * ORDERING DOCTRINE. The vendor's own advertised order is the primary rank
11
+ * authority: vendors already return their effort levels ORDERED
12
+ * weakest→strongest (codex `model/list` → `supportedReasoningEfforts` is an
13
+ * ordered array per model; `claude --help` prints the `--effort` values in
14
+ * order), so a model's ladder is its own ordered list, a harness's ladder is
16
15
  * the positional merge of its models' lists (`mergeEffortLadders`), and a
17
- * level's rank is its position in that merged list. A second, hand-maintained
18
- * copy of that knowledge can only ever disagree with the first.
16
+ * level's rank is its position in that merged list. A brand-new vendor level
17
+ * therefore sorts correctly with no code change.
18
+ *
19
+ * `EFFORT_PREFERENCE_ORDER` below is NOT a second copy of that knowledge and
20
+ * never replaces it. It is the shared vocabulary every Claudexor client speaks
21
+ * (Ouroboros' `EFFORT_SCALE` is the same row), consulted ONLY to place a
22
+ * requested word that the route's own vendor ladder does not list at all
23
+ * (`ultra` on a Claude binary that stops at `max`, `none` on a vendor whose
24
+ * ladder starts at `low`). Placing a word is not a claim that the vendor
25
+ * supports it, nor that two vendors' words of the same name are of equal
26
+ * quality: the resolver still submits only a level the route actually
27
+ * advertises, and the receipt says the shared order did the placing. Where the
28
+ * vendor lists contradict the shared order, the vendor wins inside its own
29
+ * ladder and the shared fallback is unavailable (never an invented rank).
19
30
  */
20
31
  /** Longest effort slug accepted on the wire. */
21
32
  export const EFFORT_HINT_MAX_LENGTH = 32;
@@ -27,17 +38,36 @@ export const EFFORT_HINT_PATTERN = /^[a-z0-9]+(?:[_-][a-z0-9]+)*$/;
27
38
  * `ReasoningEffort` as "a non-empty reasoning effort value advertised by the
28
39
  * model"). Adapters advertise the subset they actually accept per (harness,
29
40
  * model); the shared normalizer passes an advertised level through verbatim,
30
- * resolves a known preference downward (or to the known minimum)
31
- * inside the vendor's own order, and REFUSES a level the merged ladder has
32
- * never seen — so a vendor level newer than this repo works with no code
33
- * change, and a typo is never silently downgraded.
41
+ * resolves a known preference downward (or to the known minimum) inside the
42
+ * vendor's own order, falls back to `EFFORT_PREFERENCE_ORDER` only to place a
43
+ * word the vendor ladder does not list, and REFUSES a word neither places — so
44
+ * a vendor level newer than this repo works with no code change, and a typo is
45
+ * never silently downgraded.
34
46
  */
35
47
  export const EffortHint = z
36
48
  .string()
37
49
  .min(1)
38
50
  .max(EFFORT_HINT_MAX_LENGTH)
39
51
  .regex(EFFORT_HINT_PATTERN, "effort must be a lowercase slug (letters, digits, single - or _ separators)")
40
- .describe("Cross-harness reasoning-effort level as a lowercase slug (open vocabulary, mirroring the vendor contract); adapters advertise the levels they accept per model, ordered weakest to strongest by the vendor itself, and a shared normalizer passes advertised levels through, clamps inside the vendor order, and refuses levels the advertised ladder has never seen.");
52
+ .describe("Cross-harness reasoning-effort level as a lowercase slug (open vocabulary, mirroring the vendor contract); adapters advertise the levels they accept per model, ordered weakest to strongest by the vendor itself, and a shared normalizer passes advertised levels through, clamps inside the vendor order, places a word the vendor order lacks by the shared preference order (none < minimal < low < medium < high < xhigh < max < ultra) onto an advertised level, and refuses words neither order places.");
53
+ /**
54
+ * The shared preference order every Claudexor client speaks, weakest→strongest.
55
+ * A FALLBACK placement aid, not a rank table (see the doctrine above): the
56
+ * resolver consults it only for a word the route's own vendor ladder does not
57
+ * list, submits only vendor-advertised levels, and names the placement in the
58
+ * receipt. Listing a word here declares neither vendor support nor equal
59
+ * quality across vendors. Same row as Ouroboros' `EFFORT_SCALE`.
60
+ */
61
+ export const EFFORT_PREFERENCE_ORDER = [
62
+ "none",
63
+ "minimal",
64
+ "low",
65
+ "medium",
66
+ "high",
67
+ "xhigh",
68
+ "max",
69
+ "ultra",
70
+ ];
41
71
  /** One receipt for preparation and independent provider observation. Dispatch
42
72
  * remains the operation/session lifecycle's fact, never inferred from this. */
43
73
  export const EffortResolution = z
@@ -1 +1 @@
1
- {"version":3,"file":"effort.js","sourceRoot":"","sources":["../src/effort.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"effort.js","sourceRoot":"","sources":["../src/effort.ts"],"names":[],"mappings":"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"}
package/dist/events.d.ts CHANGED
@@ -56,7 +56,7 @@ export declare const JournaledRunCreatedPayload: z.ZodObject<{
56
56
  prompt_bytes: z.ZodNumber;
57
57
  }, z.ZodTypeAny, "passthrough">>;
58
58
  export type JournaledRunCreatedPayload = z.infer<typeof JournaledRunCreatedPayload>;
59
- export declare const RunEventType: z.ZodEnum<["run.created", "task.contract.created", "context.pack.created", "project.git.initialized", "project.claude_bridge.created", "budget.lease.created", "budget.observation", "budget.cash", "policy.web.upgraded", "harness.started", "harness.event", "harness.completed", "route.fallback.started", "route.fallback.completed", "route.fallback.exhausted", "route.transient.detected", "route.transient.retry_scheduled", "route.profile.headroom_exceeded", "route.profile.rotated", "route.profile.rotation_exhausted", "route.profile.credential_unusable", "route.account.pool_selected", "route.account.lane_switch", "route.account.pool_exhausted", "route.transient.exhausted", "route.fallback.auth_switched", "route.primary.diverged", "route.pool.degraded", "session.continuity", "interaction.requested", "interaction.answered", "interaction.timeout", "interaction.answer_discarded", "message.accepted", "message.delivered", "message.refused", "plan.progress", "plan.questions", "plan.brief.materialized", "council.started", "council.draft", "council.member.failed", "council.merged", "budget.quota_pressure", "delegation.belt.unavailable", "delegation.belt.degraded", "output.ready", "gate.started", "gate.completed", "review.preflight", "review.started", "review.skipped", "reviewer.started", "reviewer.first_event", "reviewer.auth_switched", "reviewer.completed", "reviewer.timed_out", "reviewer.failed", "finding.revalidated", "synthesis.started", "arbitration.completed", "work_product.emitted", "work_product.adopted", "control.requested", "control.applied", "control.rejected", "run.blocked", "run.completed", "run.failed", "run.continuation", "run.continuation.denied"]>;
59
+ export declare const RunEventType: z.ZodEnum<["run.created", "task.contract.created", "context.pack.created", "project.git.initialized", "project.claude_bridge.created", "budget.lease.created", "budget.observation", "budget.cash", "policy.web.upgraded", "harness.started", "harness.event", "harness.completed", "route.fallback.started", "route.fallback.completed", "route.fallback.exhausted", "route.transient.detected", "route.transient.retry_scheduled", "route.profile.headroom_exceeded", "route.profile.rotated", "route.profile.rotation_exhausted", "route.profile.credential_unusable", "route.account.pool_selected", "route.account.lane_switch", "route.account.pool_exhausted", "route.transient.exhausted", "route.fallback.auth_switched", "route.primary.diverged", "route.pool.degraded", "session.continuity", "interaction.requested", "interaction.answered", "interaction.timeout", "interaction.answer_discarded", "message.accepted", "message.delivered", "message.refused", "plan.progress", "plan.questions", "plan.brief.materialized", "council.started", "council.draft", "council.member.failed", "council.merged", "budget.quota_pressure", "delegation.belt.unavailable", "delegation.belt.degraded", "output.ready", "gate.started", "gate.completed", "review.preflight", "review.started", "review.skipped", "reviewer.started", "reviewer.first_event", "reviewer.auth_switched", "reviewer.completed", "reviewer.timed_out", "reviewer.failed", "finding.revalidated", "synthesis.started", "arbitration.completed", "work_product.emitted", "work_product.adopted", "control.requested", "control.applied", "control.rejected", "run.blocked", "run.completed", "run.failed", "run.continuation", "run.continuation.denied", "run.continuity", "workspace.retained"]>;
60
60
  export type RunEventType = z.infer<typeof RunEventType>;
61
61
  /**
62
62
  * Typed receipt emitted only after a user-facing run artifact has materialized.
@@ -248,7 +248,7 @@ export declare const RunEvent: z.ZodObject<{
248
248
  /** Thread this run is a turn of, when any. Lets the global event multiplex
249
249
  * route live progress to a chat surface without a reverse job lookup. */
250
250
  thread_id: z.ZodOptional<z.ZodString>;
251
- type: z.ZodEnum<["run.created", "task.contract.created", "context.pack.created", "project.git.initialized", "project.claude_bridge.created", "budget.lease.created", "budget.observation", "budget.cash", "policy.web.upgraded", "harness.started", "harness.event", "harness.completed", "route.fallback.started", "route.fallback.completed", "route.fallback.exhausted", "route.transient.detected", "route.transient.retry_scheduled", "route.profile.headroom_exceeded", "route.profile.rotated", "route.profile.rotation_exhausted", "route.profile.credential_unusable", "route.account.pool_selected", "route.account.lane_switch", "route.account.pool_exhausted", "route.transient.exhausted", "route.fallback.auth_switched", "route.primary.diverged", "route.pool.degraded", "session.continuity", "interaction.requested", "interaction.answered", "interaction.timeout", "interaction.answer_discarded", "message.accepted", "message.delivered", "message.refused", "plan.progress", "plan.questions", "plan.brief.materialized", "council.started", "council.draft", "council.member.failed", "council.merged", "budget.quota_pressure", "delegation.belt.unavailable", "delegation.belt.degraded", "output.ready", "gate.started", "gate.completed", "review.preflight", "review.started", "review.skipped", "reviewer.started", "reviewer.first_event", "reviewer.auth_switched", "reviewer.completed", "reviewer.timed_out", "reviewer.failed", "finding.revalidated", "synthesis.started", "arbitration.completed", "work_product.emitted", "work_product.adopted", "control.requested", "control.applied", "control.rejected", "run.blocked", "run.completed", "run.failed", "run.continuation", "run.continuation.denied"]>;
251
+ type: z.ZodEnum<["run.created", "task.contract.created", "context.pack.created", "project.git.initialized", "project.claude_bridge.created", "budget.lease.created", "budget.observation", "budget.cash", "policy.web.upgraded", "harness.started", "harness.event", "harness.completed", "route.fallback.started", "route.fallback.completed", "route.fallback.exhausted", "route.transient.detected", "route.transient.retry_scheduled", "route.profile.headroom_exceeded", "route.profile.rotated", "route.profile.rotation_exhausted", "route.profile.credential_unusable", "route.account.pool_selected", "route.account.lane_switch", "route.account.pool_exhausted", "route.transient.exhausted", "route.fallback.auth_switched", "route.primary.diverged", "route.pool.degraded", "session.continuity", "interaction.requested", "interaction.answered", "interaction.timeout", "interaction.answer_discarded", "message.accepted", "message.delivered", "message.refused", "plan.progress", "plan.questions", "plan.brief.materialized", "council.started", "council.draft", "council.member.failed", "council.merged", "budget.quota_pressure", "delegation.belt.unavailable", "delegation.belt.degraded", "output.ready", "gate.started", "gate.completed", "review.preflight", "review.started", "review.skipped", "reviewer.started", "reviewer.first_event", "reviewer.auth_switched", "reviewer.completed", "reviewer.timed_out", "reviewer.failed", "finding.revalidated", "synthesis.started", "arbitration.completed", "work_product.emitted", "work_product.adopted", "control.requested", "control.applied", "control.rejected", "run.blocked", "run.completed", "run.failed", "run.continuation", "run.continuation.denied", "run.continuity", "workspace.retained"]>;
252
252
  payload: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
253
253
  }, "strip", z.ZodTypeAny, {
254
254
  seq?: number | undefined;
@@ -256,7 +256,7 @@ export declare const RunEvent: z.ZodObject<{
256
256
  run_id: string;
257
257
  task_id: string;
258
258
  thread_id?: string | undefined;
259
- type: "arbitration.completed" | "budget.cash" | "budget.lease.created" | "budget.observation" | "budget.quota_pressure" | "context.pack.created" | "control.applied" | "control.rejected" | "control.requested" | "council.draft" | "council.member.failed" | "council.merged" | "council.started" | "delegation.belt.degraded" | "delegation.belt.unavailable" | "finding.revalidated" | "gate.completed" | "gate.started" | "harness.completed" | "harness.event" | "harness.started" | "interaction.answer_discarded" | "interaction.answered" | "interaction.requested" | "interaction.timeout" | "message.accepted" | "message.delivered" | "message.refused" | "output.ready" | "plan.brief.materialized" | "plan.progress" | "plan.questions" | "policy.web.upgraded" | "project.claude_bridge.created" | "project.git.initialized" | "review.preflight" | "review.skipped" | "review.started" | "reviewer.auth_switched" | "reviewer.completed" | "reviewer.failed" | "reviewer.first_event" | "reviewer.started" | "reviewer.timed_out" | "route.account.lane_switch" | "route.account.pool_exhausted" | "route.account.pool_selected" | "route.fallback.auth_switched" | "route.fallback.completed" | "route.fallback.exhausted" | "route.fallback.started" | "route.pool.degraded" | "route.primary.diverged" | "route.profile.credential_unusable" | "route.profile.headroom_exceeded" | "route.profile.rotated" | "route.profile.rotation_exhausted" | "route.transient.detected" | "route.transient.exhausted" | "route.transient.retry_scheduled" | "run.blocked" | "run.completed" | "run.continuation" | "run.continuation.denied" | "run.created" | "run.failed" | "session.continuity" | "synthesis.started" | "task.contract.created" | "work_product.adopted" | "work_product.emitted";
259
+ type: "arbitration.completed" | "budget.cash" | "budget.lease.created" | "budget.observation" | "budget.quota_pressure" | "context.pack.created" | "control.applied" | "control.rejected" | "control.requested" | "council.draft" | "council.member.failed" | "council.merged" | "council.started" | "delegation.belt.degraded" | "delegation.belt.unavailable" | "finding.revalidated" | "gate.completed" | "gate.started" | "harness.completed" | "harness.event" | "harness.started" | "interaction.answer_discarded" | "interaction.answered" | "interaction.requested" | "interaction.timeout" | "message.accepted" | "message.delivered" | "message.refused" | "output.ready" | "plan.brief.materialized" | "plan.progress" | "plan.questions" | "policy.web.upgraded" | "project.claude_bridge.created" | "project.git.initialized" | "review.preflight" | "review.skipped" | "review.started" | "reviewer.auth_switched" | "reviewer.completed" | "reviewer.failed" | "reviewer.first_event" | "reviewer.started" | "reviewer.timed_out" | "route.account.lane_switch" | "route.account.pool_exhausted" | "route.account.pool_selected" | "route.fallback.auth_switched" | "route.fallback.completed" | "route.fallback.exhausted" | "route.fallback.started" | "route.pool.degraded" | "route.primary.diverged" | "route.profile.credential_unusable" | "route.profile.headroom_exceeded" | "route.profile.rotated" | "route.profile.rotation_exhausted" | "route.transient.detected" | "route.transient.exhausted" | "route.transient.retry_scheduled" | "run.blocked" | "run.completed" | "run.continuation" | "run.continuation.denied" | "run.continuity" | "run.created" | "run.failed" | "session.continuity" | "synthesis.started" | "task.contract.created" | "work_product.adopted" | "work_product.emitted" | "workspace.retained";
260
260
  payload: Record<string, unknown>;
261
261
  }, {
262
262
  seq?: number | undefined;
@@ -264,7 +264,7 @@ export declare const RunEvent: z.ZodObject<{
264
264
  run_id: string;
265
265
  task_id: string;
266
266
  thread_id?: string | undefined;
267
- type: "arbitration.completed" | "budget.cash" | "budget.lease.created" | "budget.observation" | "budget.quota_pressure" | "context.pack.created" | "control.applied" | "control.rejected" | "control.requested" | "council.draft" | "council.member.failed" | "council.merged" | "council.started" | "delegation.belt.degraded" | "delegation.belt.unavailable" | "finding.revalidated" | "gate.completed" | "gate.started" | "harness.completed" | "harness.event" | "harness.started" | "interaction.answer_discarded" | "interaction.answered" | "interaction.requested" | "interaction.timeout" | "message.accepted" | "message.delivered" | "message.refused" | "output.ready" | "plan.brief.materialized" | "plan.progress" | "plan.questions" | "policy.web.upgraded" | "project.claude_bridge.created" | "project.git.initialized" | "review.preflight" | "review.skipped" | "review.started" | "reviewer.auth_switched" | "reviewer.completed" | "reviewer.failed" | "reviewer.first_event" | "reviewer.started" | "reviewer.timed_out" | "route.account.lane_switch" | "route.account.pool_exhausted" | "route.account.pool_selected" | "route.fallback.auth_switched" | "route.fallback.completed" | "route.fallback.exhausted" | "route.fallback.started" | "route.pool.degraded" | "route.primary.diverged" | "route.profile.credential_unusable" | "route.profile.headroom_exceeded" | "route.profile.rotated" | "route.profile.rotation_exhausted" | "route.transient.detected" | "route.transient.exhausted" | "route.transient.retry_scheduled" | "run.blocked" | "run.completed" | "run.continuation" | "run.continuation.denied" | "run.created" | "run.failed" | "session.continuity" | "synthesis.started" | "task.contract.created" | "work_product.adopted" | "work_product.emitted";
267
+ type: "arbitration.completed" | "budget.cash" | "budget.lease.created" | "budget.observation" | "budget.quota_pressure" | "context.pack.created" | "control.applied" | "control.rejected" | "control.requested" | "council.draft" | "council.member.failed" | "council.merged" | "council.started" | "delegation.belt.degraded" | "delegation.belt.unavailable" | "finding.revalidated" | "gate.completed" | "gate.started" | "harness.completed" | "harness.event" | "harness.started" | "interaction.answer_discarded" | "interaction.answered" | "interaction.requested" | "interaction.timeout" | "message.accepted" | "message.delivered" | "message.refused" | "output.ready" | "plan.brief.materialized" | "plan.progress" | "plan.questions" | "policy.web.upgraded" | "project.claude_bridge.created" | "project.git.initialized" | "review.preflight" | "review.skipped" | "review.started" | "reviewer.auth_switched" | "reviewer.completed" | "reviewer.failed" | "reviewer.first_event" | "reviewer.started" | "reviewer.timed_out" | "route.account.lane_switch" | "route.account.pool_exhausted" | "route.account.pool_selected" | "route.fallback.auth_switched" | "route.fallback.completed" | "route.fallback.exhausted" | "route.fallback.started" | "route.pool.degraded" | "route.primary.diverged" | "route.profile.credential_unusable" | "route.profile.headroom_exceeded" | "route.profile.rotated" | "route.profile.rotation_exhausted" | "route.transient.detected" | "route.transient.exhausted" | "route.transient.retry_scheduled" | "run.blocked" | "run.completed" | "run.continuation" | "run.continuation.denied" | "run.continuity" | "run.created" | "run.failed" | "session.continuity" | "synthesis.started" | "task.contract.created" | "work_product.adopted" | "work_product.emitted" | "workspace.retained";
268
268
  payload?: Record<string, unknown> | undefined;
269
269
  }>;
270
270
  export type RunEvent = z.infer<typeof RunEvent>;
@@ -1 +1 @@
1
- {"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAK3B,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;EAU4C,CAAC;AAC7E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,eAAO,MAAM,cAAc;;;;;;;;;;;;EAoBxB,CAAC;AACJ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;gCAiBpC,CAAC;AACJ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEpF,eAAO,MAAM,YAAY,8oDA6JtB,CAAC;AACJ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAY+B,CAAC;AAC/D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ1C,CAAC;AACF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE5F;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;EAoB9B,CAAC;AACJ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;EAiBrC,CAAC;AACJ,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEtF;;4EAE4E;AAC5E,eAAO,MAAM,cAAc,2GAW6C,CAAC;AACzE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBlC,CAAC;AACJ,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF,iDAAiD;AACjD,eAAO,MAAM,QAAQ;IAEjB;;;;OAIG;;;;;IAYH;6EACyE;;;;;;;;;;;;;;;;;;;;EAKO,CAAC;AACrF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC"}
1
+ {"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAK3B,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;EAU4C,CAAC;AAC7E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,eAAO,MAAM,cAAc;;;;;;;;;;;;EAoBxB,CAAC;AACJ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;gCAiBpC,CAAC;AACJ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAEpF,eAAO,MAAM,YAAY,srDAwKtB,CAAC;AACJ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAY+B,CAAC;AAC/D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ1C,CAAC;AACF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAE5F;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;EAoB9B,CAAC;AACJ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;EAiBrC,CAAC;AACJ,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEtF;;4EAE4E;AAC5E,eAAO,MAAM,cAAc,2GAW6C,CAAC;AACzE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBlC,CAAC;AACJ,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEhF,iDAAiD;AACjD,eAAO,MAAM,QAAQ;IAEjB;;;;OAIG;;;;;IAYH;6EACyE;;;;;;;;;;;;;;;;;;;;EAKO,CAAC;AACrF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC"}
package/dist/events.js CHANGED
@@ -208,6 +208,17 @@ export const RunEventType = z
208
208
  * never leaves a disclosure claiming a continuation launched. No attempt ran
209
209
  * and the one-shot is not consumed. Payload: {from_attempt, cause, reason}. */
210
210
  "run.continuation.denied",
211
+ /** Per-try receipt of a CONTINUED try: the in-run continuation ladder's
212
+ * later tries and the first try of a `continueFrom` successor. Carrier,
213
+ * cause, accounts, workspace, memory and this try's model attestation.
214
+ * Payload: {harness_id, attempt_id, session_id, receipt:
215
+ * RunContinuityReceipt}. */
216
+ "run.continuity",
217
+ /** A stopped run's isolated envelope was kept for continuation (custody
218
+ * `retained`). Payload: {attempt_id, root, cause, bytes}. Released by
219
+ * adoption (`continueFrom`), apply or the discard decision; never removed
220
+ * automatically. */
221
+ "workspace.retained",
211
222
  ])
212
223
  .describe("Type of an append-only run event, covering run lifecycle, contract/context creation, budget, routing fallbacks, harness activity, interactions, gates, review, arbitration, work products, and control verbs.");
213
224
  /**