owenloop 0.4.1 → 0.5.1

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 (282) hide show
  1. package/CHANGELOG.md +71 -0
  2. package/README.md +182 -53
  3. package/bin/owenloop.mjs +50 -2
  4. package/dist/packages/work/src/agent/brief.d.ts +176 -0
  5. package/dist/packages/work/src/agent/brief.js +197 -0
  6. package/dist/packages/work/src/agent/loop.d.ts +141 -0
  7. package/dist/packages/work/src/agent/loop.js +669 -0
  8. package/dist/packages/work/src/agent/model-policy.d.ts +49 -0
  9. package/dist/packages/work/src/agent/model-policy.js +138 -0
  10. package/dist/packages/work/src/agent/workdir.d.ts +210 -0
  11. package/dist/packages/work/src/agent/workdir.js +319 -0
  12. package/dist/packages/work/src/bundle/cache.d.ts +92 -0
  13. package/dist/packages/work/src/bundle/cache.js +338 -0
  14. package/dist/packages/work/src/bundle/fetch.d.ts +87 -0
  15. package/dist/packages/work/src/bundle/fetch.js +345 -0
  16. package/dist/packages/work/src/bundle/types.d.ts +164 -0
  17. package/dist/packages/work/src/bundle/types.js +1 -0
  18. package/dist/packages/work/src/consumed-verifier.d.ts +45 -0
  19. package/dist/packages/work/src/consumed-verifier.js +205 -0
  20. package/dist/packages/work/src/credentials/owenloop.d.ts +11 -0
  21. package/dist/packages/work/src/credentials/owenloop.js +28 -0
  22. package/dist/packages/work/src/credentials/reader.d.ts +36 -0
  23. package/dist/packages/work/src/credentials/reader.js +32 -0
  24. package/dist/packages/work/src/credentials/resolve.d.ts +19 -0
  25. package/dist/packages/work/src/credentials/resolve.js +56 -0
  26. package/dist/packages/work/src/exec/instructions.d.ts +99 -0
  27. package/dist/packages/work/src/exec/instructions.js +323 -0
  28. package/dist/packages/work/src/exec/loop.d.ts +40 -0
  29. package/dist/packages/work/src/exec/loop.js +332 -0
  30. package/dist/packages/work/src/exec/payload.d.ts +29 -0
  31. package/dist/packages/work/src/exec/payload.js +54 -0
  32. package/dist/packages/work/src/exec/receipt.d.ts +41 -0
  33. package/dist/packages/work/src/exec/receipt.js +32 -0
  34. package/dist/packages/work/src/exec/runner.d.ts +71 -0
  35. package/dist/packages/work/src/exec/runner.js +256 -0
  36. package/dist/packages/work/src/harness/child-env.d.ts +100 -0
  37. package/dist/packages/work/src/harness/child-env.js +134 -0
  38. package/dist/packages/work/src/harness/claude.d.ts +140 -0
  39. package/dist/packages/work/src/harness/claude.js +837 -0
  40. package/dist/packages/work/src/harness/codex.d.ts +111 -0
  41. package/dist/packages/work/src/harness/codex.js +1024 -0
  42. package/dist/packages/work/src/harness/contract.d.ts +308 -0
  43. package/dist/packages/work/src/harness/contract.js +32 -0
  44. package/dist/packages/work/src/harness/fake.d.ts +59 -0
  45. package/dist/packages/work/src/harness/fake.js +91 -0
  46. package/dist/packages/work/src/harness/jsonrpc-stdio.d.ts +108 -0
  47. package/dist/packages/work/src/harness/jsonrpc-stdio.js +351 -0
  48. package/dist/packages/work/src/harness/permissions.d.ts +75 -0
  49. package/dist/packages/work/src/harness/permissions.js +182 -0
  50. package/dist/packages/work/src/harness/registry.d.ts +47 -0
  51. package/dist/packages/work/src/harness/registry.js +45 -0
  52. package/dist/packages/work/src/harness/session-store.d.ts +181 -0
  53. package/dist/packages/work/src/harness/session-store.js +523 -0
  54. package/dist/packages/work/src/harness/types.d.ts +29 -0
  55. package/dist/packages/work/src/harness/types.js +14 -0
  56. package/dist/packages/work/src/harnesses.d.ts +38 -0
  57. package/dist/packages/work/src/harnesses.js +38 -0
  58. package/dist/packages/work/src/hold/loop.d.ts +36 -0
  59. package/dist/packages/work/src/hold/loop.js +23 -0
  60. package/dist/packages/work/src/hold/mcp.d.ts +75 -0
  61. package/dist/packages/work/src/hold/mcp.js +264 -0
  62. package/dist/packages/work/src/hub/client.d.ts +23 -0
  63. package/dist/packages/work/src/hub/client.js +91 -0
  64. package/dist/packages/work/src/hub/types.d.ts +326 -0
  65. package/dist/packages/work/src/hub/types.js +26 -0
  66. package/dist/packages/work/src/lease/loop.d.ts +94 -0
  67. package/dist/packages/work/src/lease/loop.js +277 -0
  68. package/dist/packages/work/src/main.d.ts +1 -0
  69. package/dist/packages/work/src/main.js +48 -0
  70. package/dist/packages/work/src/mcp/server.d.ts +125 -0
  71. package/dist/packages/work/src/mcp/server.js +320 -0
  72. package/dist/packages/work/src/owenloop-bin.d.ts +1 -0
  73. package/dist/packages/work/src/owenloop-bin.js +18 -0
  74. package/dist/packages/work/src/roles/agent-run.d.ts +124 -0
  75. package/dist/packages/work/src/roles/agent-run.js +529 -0
  76. package/dist/packages/work/src/roles/exec.d.ts +48 -0
  77. package/dist/packages/work/src/roles/exec.js +228 -0
  78. package/dist/packages/work/src/roles/hold.d.ts +72 -0
  79. package/dist/packages/work/src/roles/hold.js +363 -0
  80. package/dist/packages/work/src/roles/join.d.ts +18 -0
  81. package/dist/packages/work/src/roles/join.js +204 -0
  82. package/dist/packages/work/src/roles/lint.d.ts +58 -0
  83. package/dist/packages/work/src/roles/lint.js +234 -0
  84. package/dist/packages/work/src/roles/prepare.d.ts +1 -0
  85. package/dist/packages/work/src/roles/prepare.js +249 -0
  86. package/dist/packages/work/src/roles/release.d.ts +48 -0
  87. package/dist/packages/work/src/roles/release.js +137 -0
  88. package/dist/packages/work/src/roles/sessions.d.ts +61 -0
  89. package/dist/packages/work/src/roles/sessions.js +180 -0
  90. package/dist/packages/work/src/roles/settings.d.ts +6 -0
  91. package/dist/packages/work/src/roles/settings.js +71 -0
  92. package/dist/packages/work/src/roles/shift.d.ts +13 -0
  93. package/dist/packages/work/src/roles/shift.js +250 -0
  94. package/dist/packages/work/src/roles/signals.d.ts +55 -0
  95. package/dist/packages/work/src/roles/signals.js +62 -0
  96. package/dist/packages/work/src/settings/provision.d.ts +21 -0
  97. package/dist/packages/work/src/settings/provision.js +47 -0
  98. package/dist/packages/work/src/settings/settings.d.ts +136 -0
  99. package/dist/packages/work/src/settings/settings.js +155 -0
  100. package/dist/packages/work/src/shift/client.d.ts +24 -0
  101. package/dist/packages/work/src/shift/client.js +124 -0
  102. package/dist/packages/work/src/shift/loop.d.ts +131 -0
  103. package/dist/packages/work/src/shift/loop.js +751 -0
  104. package/dist/packages/work/src/shift/protocol.d.ts +95 -0
  105. package/dist/packages/work/src/shift/protocol.js +24 -0
  106. package/dist/packages/work/src/shift/routing.d.ts +35 -0
  107. package/dist/packages/work/src/shift/routing.js +50 -0
  108. package/dist/packages/work/src/shift/runtime.d.ts +45 -0
  109. package/dist/packages/work/src/shift/runtime.js +337 -0
  110. package/dist/packages/work/src/shift/server.d.ts +23 -0
  111. package/dist/packages/work/src/shift/server.js +716 -0
  112. package/dist/packages/work/src/shift/spawn.d.ts +109 -0
  113. package/dist/packages/work/src/shift/spawn.js +158 -0
  114. package/dist/packages/work/src/shift/state.d.ts +79 -0
  115. package/dist/packages/work/src/shift/state.js +385 -0
  116. package/dist/packages/work/src/submit-proof.d.ts +36 -0
  117. package/dist/packages/work/src/submit-proof.js +93 -0
  118. package/dist/packages/work/src/usage.d.ts +6 -0
  119. package/dist/packages/work/src/usage.js +175 -0
  120. package/dist/src/add.d.ts +189 -0
  121. package/dist/src/add.js +300 -0
  122. package/dist/src/archive.d.ts +97 -0
  123. package/dist/src/archive.js +591 -0
  124. package/dist/src/bundle/index.d.ts +64 -0
  125. package/dist/src/bundle/index.js +508 -0
  126. package/dist/src/bundle/manifest.d.ts +50 -0
  127. package/dist/src/bundle/manifest.js +435 -0
  128. package/dist/src/bundle/runtime.d.ts +26 -0
  129. package/dist/src/bundle/runtime.js +64 -0
  130. package/dist/src/bundle/tar.d.ts +62 -0
  131. package/dist/src/bundle/tar.js +238 -0
  132. package/dist/src/bundle/types.d.ts +105 -0
  133. package/dist/src/bundle/types.js +21 -0
  134. package/dist/{cli.d.ts → src/cli.d.ts} +92 -7
  135. package/dist/src/cli.js +5968 -0
  136. package/dist/{credentials.d.ts → src/credentials.d.ts} +22 -15
  137. package/dist/{credentials.js → src/credentials.js} +35 -31
  138. package/dist/src/crypto/allowed-signers.d.ts +68 -0
  139. package/dist/src/crypto/allowed-signers.js +307 -0
  140. package/dist/src/crypto/canonical.d.ts +8 -0
  141. package/dist/src/crypto/canonical.js +92 -0
  142. package/dist/src/crypto/chain.d.ts +65 -0
  143. package/dist/src/crypto/chain.js +377 -0
  144. package/dist/src/crypto/dsse.d.ts +209 -0
  145. package/dist/src/crypto/dsse.js +282 -0
  146. package/dist/src/crypto/enrollment.d.ts +78 -0
  147. package/dist/src/crypto/enrollment.js +186 -0
  148. package/dist/src/crypto/index.d.ts +48 -0
  149. package/dist/src/crypto/index.js +44 -0
  150. package/dist/src/crypto/keys.d.ts +258 -0
  151. package/dist/src/crypto/keys.js +908 -0
  152. package/dist/src/crypto/org-root.d.ts +33 -0
  153. package/dist/src/crypto/org-root.js +78 -0
  154. package/dist/src/crypto/origin-rules.d.ts +56 -0
  155. package/dist/src/crypto/origin-rules.js +143 -0
  156. package/dist/src/crypto/policy-floor.d.ts +98 -0
  157. package/dist/src/crypto/policy-floor.js +353 -0
  158. package/dist/src/crypto/records.d.ts +316 -0
  159. package/dist/src/crypto/records.js +157 -0
  160. package/dist/src/crypto/scope.d.ts +49 -0
  161. package/dist/src/crypto/scope.js +83 -0
  162. package/dist/src/crypto/ssh.d.ts +171 -0
  163. package/dist/src/crypto/ssh.js +396 -0
  164. package/dist/src/crypto/submission.d.ts +33 -0
  165. package/dist/src/crypto/submission.js +47 -0
  166. package/dist/src/crypto/trust-roots.d.ts +29 -0
  167. package/dist/src/crypto/trust-roots.js +39 -0
  168. package/dist/src/crypto/verify-consumed.d.ts +67 -0
  169. package/dist/src/crypto/verify-consumed.js +259 -0
  170. package/dist/src/crypto/verify-origin.d.ts +50 -0
  171. package/dist/src/crypto/verify-origin.js +151 -0
  172. package/dist/src/crypto/verify-publication.d.ts +60 -0
  173. package/dist/src/crypto/verify-publication.js +150 -0
  174. package/dist/{defs.d.ts → src/defs.d.ts} +24 -1
  175. package/dist/{defs.js → src/defs.js} +181 -61
  176. package/dist/{engine.d.ts → src/engine.d.ts} +105 -9
  177. package/dist/{engine.js → src/engine.js} +251 -47
  178. package/dist/{factory.d.ts → src/factory.d.ts} +16 -0
  179. package/dist/{factory.js → src/factory.js} +16 -4
  180. package/dist/src/global-config.d.ts +59 -0
  181. package/dist/src/global-config.js +84 -0
  182. package/dist/{hub.d.ts → src/hub.d.ts} +280 -31
  183. package/dist/{hub.js → src/hub.js} +493 -52
  184. package/dist/src/index.d.ts +47 -0
  185. package/dist/src/index.js +41 -0
  186. package/dist/src/install.d.ts +538 -0
  187. package/dist/src/install.js +1981 -0
  188. package/dist/src/lock.d.ts +38 -0
  189. package/dist/src/lock.js +325 -0
  190. package/dist/src/mcp/serve.d.ts +109 -0
  191. package/dist/{mcp → src/mcp}/serve.js +335 -75
  192. package/dist/{mcp → src/mcp}/server.d.ts +6 -9
  193. package/dist/{mcp → src/mcp}/server.js +18 -10
  194. package/dist/{model.d.ts → src/model.d.ts} +15 -0
  195. package/dist/{model.js → src/model.js} +112 -2
  196. package/dist/src/order-resolver.d.ts +184 -0
  197. package/dist/src/order-resolver.js +252 -0
  198. package/dist/src/package-version.d.ts +10 -0
  199. package/dist/src/package-version.js +42 -0
  200. package/dist/{paths.d.ts → src/paths.d.ts} +14 -1
  201. package/dist/{paths.js → src/paths.js} +18 -0
  202. package/dist/src/schemas/enrollment-grant.v1.schema.json +90 -0
  203. package/dist/src/schemas/index.d.ts +1416 -0
  204. package/dist/src/schemas/index.js +31 -0
  205. package/dist/src/schemas/order.v1.schema.json +106 -0
  206. package/dist/src/schemas/origin.v1.schema.json +68 -0
  207. package/dist/src/schemas/policy-floor.v1.schema.json +29 -0
  208. package/dist/src/schemas/publication.v1.schema.json +31 -0
  209. package/dist/src/schemas/revocation.v1.schema.json +39 -0
  210. package/dist/src/schemas/submission.v1.schema.json +61 -0
  211. package/dist/src/store/def-source.d.ts +52 -0
  212. package/dist/src/store/def-source.js +335 -0
  213. package/dist/src/store/index-file.d.ts +69 -0
  214. package/dist/src/store/index-file.js +151 -0
  215. package/dist/src/store/index.d.ts +27 -0
  216. package/dist/src/store/index.js +22 -0
  217. package/dist/src/store/ingestor.d.ts +43 -0
  218. package/dist/src/store/ingestor.js +211 -0
  219. package/dist/src/store/install.d.ts +228 -0
  220. package/dist/src/store/install.js +555 -0
  221. package/dist/src/store/instruction-source.d.ts +49 -0
  222. package/dist/src/store/instruction-source.js +298 -0
  223. package/dist/src/store/origin-evidence.d.ts +21 -0
  224. package/dist/src/store/origin-evidence.js +66 -0
  225. package/dist/src/store/pre-commit-verifier.d.ts +68 -0
  226. package/dist/src/store/pre-commit-verifier.js +418 -0
  227. package/dist/src/store/resolve.d.ts +138 -0
  228. package/dist/src/store/resolve.js +363 -0
  229. package/dist/src/store/types.d.ts +288 -0
  230. package/dist/src/store/types.js +356 -0
  231. package/dist/{types.d.ts → src/types.d.ts} +58 -24
  232. package/dist/{untar.d.ts → src/untar.d.ts} +8 -23
  233. package/dist/src/untar.js +38 -0
  234. package/dist/{util.d.ts → src/util.d.ts} +3 -2
  235. package/dist/{util.js → src/util.js} +3 -2
  236. package/dist/{owenwork.d.ts → src/work-settings.d.ts} +22 -22
  237. package/dist/{owenwork.js → src/work-settings.js} +27 -27
  238. package/docs/agent-runner.md +86 -0
  239. package/docs/authoring.md +150 -59
  240. package/docs/bundles.md +250 -0
  241. package/docs/cli.md +1758 -163
  242. package/docs/crypto.md +816 -0
  243. package/docs/design.md +374 -52
  244. package/docs/embedding.md +135 -27
  245. package/docs/wire-contracts.md +380 -0
  246. package/examples/workflows/{command-worker.yaml → command-executor.yaml} +15 -15
  247. package/examples/workflows/compile-dev-playbook.yaml +338 -0
  248. package/examples/workflows/judges/gate-sharpness.md +39 -0
  249. package/examples/workflows/judges/security.md +34 -0
  250. package/package.json +22 -8
  251. package/plugins/claude-code/.claude-plugin/marketplace.json +14 -0
  252. package/plugins/claude-code/plugin/.claude-plugin/plugin.json +8 -0
  253. package/plugins/claude-code/plugin/.mcp.json +14 -0
  254. package/plugins/claude-code/plugin/hooks/hooks.json +26 -0
  255. package/plugins/claude-code/plugin/hooks/session-end.sh +40 -0
  256. package/plugins/claude-code/plugin/hooks/session-start.sh +52 -0
  257. package/plugins/claude-code/plugin/skills/author/SKILL.md +181 -0
  258. package/plugins/claude-code/plugin/skills/conduct/SKILL.md +106 -0
  259. package/plugins/claude-code/plugin/skills/shift/SKILL.md +105 -0
  260. package/plugins/codex/.agents/plugins/marketplace.json +21 -0
  261. package/plugins/codex/plugins/owenloop/.codex-plugin/plugin.json +7 -0
  262. package/plugins/codex/plugins/owenloop/.mcp.json +20 -0
  263. package/plugins/codex/plugins/owenloop/hooks/hooks.json +26 -0
  264. package/plugins/codex/plugins/owenloop/hooks/session-end.sh +40 -0
  265. package/plugins/codex/plugins/owenloop/hooks/session-start.sh +52 -0
  266. package/plugins/codex/plugins/owenloop/skills/author/SKILL.md +181 -0
  267. package/plugins/codex/plugins/owenloop/skills/conduct/SKILL.md +106 -0
  268. package/plugins/codex/plugins/owenloop/skills/shift/SKILL.md +105 -0
  269. package/dist/add.d.ts +0 -384
  270. package/dist/add.js +0 -834
  271. package/dist/cli.js +0 -3270
  272. package/dist/index.d.ts +0 -32
  273. package/dist/index.js +0 -23
  274. package/dist/lock.d.ts +0 -80
  275. package/dist/lock.js +0 -217
  276. package/dist/mcp/serve.d.ts +0 -84
  277. package/dist/untar.js +0 -164
  278. /package/dist/{schema.d.ts → src/schema.d.ts} +0 -0
  279. /package/dist/{schema.js → src/schema.js} +0 -0
  280. /package/dist/{store.d.ts → src/store.d.ts} +0 -0
  281. /package/dist/{store.js → src/store.js} +0 -0
  282. /package/dist/{types.js → src/types.js} +0 -0
@@ -0,0 +1,323 @@
1
+ /**
2
+ * Driver-side instruction resolution.
3
+ *
4
+ * A worker packet is a reference packet. The packet's `defDigest` selects
5
+ * instruction bytes from a verified local workflow-store object; command text,
6
+ * prompt text, and step metadata supplied by a remote coordinator are never
7
+ * authoritative. The command resolver returns the exact authored command and
8
+ * does not perform placeholder substitution.
9
+ */
10
+ import { join } from 'node:path';
11
+ import { createBundleIngestor, createStoreInstructionSource } from "../../../../src/store/index.js";
12
+ import { readWorkflowStoreIndex } from "../../../../src/store/index-file.js";
13
+ import { projectStoreRoot, probeStoreRoot, storeIndexPath, globalStoreRoot } from "../../../../src/store/resolve.js";
14
+ import { compareStoreText, parseWorkflowCoordinate } from "../../../../src/store/types.js";
15
+ import { evaluateOriginRule, matchOriginRule } from "../../../../src/crypto/origin-rules.js";
16
+ import { mergePolicyFloorWithLocal } from "../../../../src/crypto/policy-floor.js";
17
+ import { createExecutionDefinitionVerifier, createExecutionOriginVerifier, resolveDefPolicy, resolveOriginPolicy, resolveArtifactPolicy, resolveOriginRules, } from "../../../../src/store/pre-commit-verifier.js";
18
+ function errorText(error) {
19
+ return error instanceof Error ? error.message : String(error);
20
+ }
21
+ function refusal(kind, order, detail) {
22
+ const digest = order.defDigest === undefined || order.defDigest === '' ? '<missing>' : order.defDigest;
23
+ return {
24
+ ok: false,
25
+ kind,
26
+ reason: `instruction refusal (${kind}) for ${order.workflow}/${order.run} step '${order.step}' defDigest '${digest}': ${detail}`,
27
+ };
28
+ }
29
+ function digestFor(order) {
30
+ if (typeof order.defDigest !== 'string' || order.defDigest.trim() === '') {
31
+ return refusal('no-digest', order, 'the order has no non-empty defDigest');
32
+ }
33
+ return order.defDigest;
34
+ }
35
+ function verdictDescription(verdict) {
36
+ if (verdict.kind === 'verified')
37
+ return 'definition is verified';
38
+ if (verdict.kind === 'unsigned')
39
+ return 'unsigned: definition has no publication signature';
40
+ return `${verdict.kind}: ${verdict.reason}`;
41
+ }
42
+ export function createStoreInstructionResolver(options) {
43
+ const source = options.source ?? createStoreInstructionSource({
44
+ projectRoot: options.projectRoot,
45
+ globalRoot: options.globalRoot,
46
+ verifier: options.verifier,
47
+ });
48
+ const env = options.env ?? {};
49
+ let mergedPolicies;
50
+ const readPolicies = () => {
51
+ mergedPolicies ??= mergePolicyFloorWithLocal(resolveDefPolicy(env, options.defPolicy), options.policyFloor, resolveOriginPolicy(env, options.originPolicy), resolveArtifactPolicy(env));
52
+ return mergedPolicies;
53
+ };
54
+ const readPolicy = () => readPolicies().effective;
55
+ const readOriginPolicy = () => readPolicies().originPolicy;
56
+ let originRules;
57
+ const readOriginRules = () => {
58
+ originRules ??= resolveOriginRules(env, options.originRules);
59
+ return originRules;
60
+ };
61
+ const warn = options.warn ?? ((line) => void console.error(line));
62
+ const resolveVerifiedStep = async (order) => {
63
+ const digest = digestFor(order);
64
+ if (typeof digest !== 'string')
65
+ return digest;
66
+ try {
67
+ const primed = await source.prime(digest);
68
+ if (primed === 'unknown-digest') {
69
+ return refusal('unknown-digest', order, 'no verified local workflow bundle matches the order digest');
70
+ }
71
+ const lookup = source.lookup({ defDigest: digest, step: order.step, key: order.key });
72
+ if (lookup.status === 'unknown-digest') {
73
+ return refusal('integrity', order, 'the primed workflow digest disappeared before instruction lookup');
74
+ }
75
+ if (lookup.status === 'unknown-step') {
76
+ return refusal('unknown-step', order, 'the verified workflow definition has no matching step');
77
+ }
78
+ if (lookup.status === 'ambiguous-step') {
79
+ return refusal('ambiguous-step', order, 'multiple workflows in the verified bundle define the requested step');
80
+ }
81
+ const step = source.getVerifiedStep(digest, order.step);
82
+ if (step === undefined) {
83
+ return refusal('integrity', order, 'the resolved workflow step is unavailable after instruction lookup');
84
+ }
85
+ const definition = source.getVerifiedDefinition(digest, order.step);
86
+ if (definition === undefined)
87
+ return refusal('integrity', order, 'the verified workflow definition is unavailable after priming');
88
+ const object = source.getVerifiedObject(digest);
89
+ if (object === undefined)
90
+ return refusal('integrity', order, 'the verified workflow object metadata is unavailable after priming');
91
+ return { ok: true, definition, step, bundleDigest: object.bundleDigest, objectPath: object.objectPath };
92
+ }
93
+ catch (error) {
94
+ return refusal('integrity', order, errorText(error));
95
+ }
96
+ };
97
+ const trustFor = async (order, resolved) => {
98
+ if (options.definitionVerifier === undefined) {
99
+ return { kind: 'unverifiable', reason: 'execution-time publication verifier is not configured' };
100
+ }
101
+ try {
102
+ return await options.definitionVerifier({ defDigest: order.defDigest, definition: resolved.definition, step: resolved.step, bundleDigest: resolved.bundleDigest, objectPath: resolved.objectPath });
103
+ }
104
+ catch (error) {
105
+ return { kind: 'unverifiable', reason: errorText(error) };
106
+ }
107
+ };
108
+ const refuseUnverified = (order, verdict) => refusal('unverified-def', order, verdictDescription(verdict));
109
+ const recoverOriginRule = (bundleDigest, rules) => {
110
+ const roots = [
111
+ options.projectRoot === undefined ? undefined : projectStoreRoot(options.projectRoot),
112
+ projectStoreRoot(options.globalRoot),
113
+ ].filter((root) => root !== undefined);
114
+ const uniqueRoots = [...new Set(roots)];
115
+ const entries = [];
116
+ let foundCoordinate = false;
117
+ for (const root of uniqueRoots) {
118
+ if (probeStoreRoot(root) !== 'dir')
119
+ continue;
120
+ const index = readWorkflowStoreIndex(storeIndexPath(root));
121
+ // Sorted, not index key order: `entries[0]` below supplies the rule KEY
122
+ // named in the refusal message, and the whole list is joined into the
123
+ // ambiguity message. Both would otherwise vary with JSON key order.
124
+ const coordinates = Object.keys(index.entries).sort(compareStoreText);
125
+ for (const coordinate of coordinates) {
126
+ const entry = index.entries[coordinate];
127
+ if (entry.digest !== bundleDigest)
128
+ continue;
129
+ foundCoordinate = true;
130
+ const { namespace } = parseWorkflowCoordinate(coordinate);
131
+ const match = matchOriginRule(rules, namespace);
132
+ if (match !== undefined)
133
+ entries.push({ coordinate, namespace, match });
134
+ }
135
+ }
136
+ if (!foundCoordinate)
137
+ return { kind: 'unknown' };
138
+ if (entries.length === 0)
139
+ return { kind: 'none' };
140
+ const requirements = new Set(entries.map((entry) => entry.match.value));
141
+ if (requirements.size > 1)
142
+ return { kind: 'ambiguous', entries };
143
+ return { kind: 'match', match: entries[0].match, entries };
144
+ };
145
+ const originFor = async (resolved) => {
146
+ if (options.originVerifier === undefined) {
147
+ return { kind: 'unverifiable', reason: 'execution-time origin verifier is not configured' };
148
+ }
149
+ try {
150
+ return await options.originVerifier({ bundleDigest: resolved.bundleDigest, objectPath: resolved.objectPath });
151
+ }
152
+ catch (error) {
153
+ return { kind: 'unverifiable', reason: errorText(error) };
154
+ }
155
+ };
156
+ const originPolicyWarning = (order, detail) => {
157
+ warn(`workflow definition '${order.defDigest}' was not admitted by origin policy; originPolicy=warn allows execution: ${detail}`);
158
+ };
159
+ const checkOrigin = async (order, resolved) => {
160
+ const rules = readOriginRules();
161
+ const verdict = await originFor(resolved);
162
+ if (verdict.kind === 'invalid') {
163
+ return refusal('origin-policy', order, `invalid origin evidence: ${verdict.reason}`);
164
+ }
165
+ if (Object.keys(rules).length === 0)
166
+ return undefined;
167
+ let resolution;
168
+ try {
169
+ resolution = recoverOriginRule(resolved.bundleDigest, rules);
170
+ }
171
+ catch (error) {
172
+ return refusal('origin-policy', order, `could not recover the definition namespace from workflow-store indexes: ${errorText(error)}`);
173
+ }
174
+ const selectedPolicy = readOriginPolicy();
175
+ if (resolution.kind === 'none')
176
+ return undefined;
177
+ if (resolution.kind === 'unknown') {
178
+ const detail = 'the definition digest is not indexed under any namespace, so its origin rule cannot be determined';
179
+ if (selectedPolicy === 'enforce')
180
+ return refusal('origin-policy', order, detail);
181
+ if (selectedPolicy === 'warn')
182
+ originPolicyWarning(order, detail);
183
+ return undefined;
184
+ }
185
+ if (resolution.kind === 'ambiguous') {
186
+ const detail = resolution.entries
187
+ .map((entry) => `${entry.namespace}=${entry.match.key} (${entry.match.value})`)
188
+ .join(', ');
189
+ const message = `the definition digest is indexed under namespaces with different origin rules: ${detail}`;
190
+ if (selectedPolicy === 'enforce')
191
+ return refusal('origin-policy', order, message);
192
+ if (selectedPolicy === 'warn')
193
+ originPolicyWarning(order, message);
194
+ return undefined;
195
+ }
196
+ const evaluation = evaluateOriginRule(resolution.match.value, verdict);
197
+ if (evaluation.ok)
198
+ return undefined;
199
+ const detail = `${evaluation.kind} — ${evaluation.detail}; rule ${resolution.match.key} requires ${resolution.match.value}`;
200
+ if (selectedPolicy === 'enforce')
201
+ return refusal('origin-policy', order, detail);
202
+ if (selectedPolicy === 'warn')
203
+ originPolicyWarning(order, detail);
204
+ return undefined;
205
+ };
206
+ const hasConsumedData = (order) => Object.keys(order.consumes).length > 0;
207
+ /**
208
+ * A command child receives neither `owes[].reasons` nor `owes[].proof`.
209
+ * Keep the launch gate scoped to dynamic values that can influence the child;
210
+ * the claim-time output version is separate lifecycle metadata retained by the
211
+ * exec holder for receipt signing. Agent holders still verify the complete
212
+ * order because their rendered prompt includes the feedback thread.
213
+ */
214
+ const commandConsumedOrder = (order) => ({
215
+ ...order,
216
+ owes: order.owes.map((owed) => ({
217
+ path: owed.path,
218
+ ...(owed.version !== undefined ? { version: owed.version } : {}),
219
+ judgmentRejects: owed.judgmentRejects,
220
+ schemaRejects: owed.schemaRejects,
221
+ reasons: [],
222
+ })),
223
+ });
224
+ const gateConsumed = async (order, hardRule) => {
225
+ if (!hasConsumedData(order))
226
+ return undefined;
227
+ if (options.consumedVerifier === undefined) {
228
+ return refusal('unverified-consumed', order, 'consume-side verifier is not configured; dynamic values cannot be admitted to a command worker');
229
+ }
230
+ try {
231
+ const checked = await options.consumedVerifier(commandConsumedOrder(order), { hardRule });
232
+ if (!checked.ok)
233
+ return refusal('unverified-consumed', order, checked.reason);
234
+ for (const warning of checked.warnings)
235
+ warn(warning);
236
+ return undefined;
237
+ }
238
+ catch (error) {
239
+ return refusal('unverified-consumed', order, `consume-side verification failed: ${errorText(error)}`);
240
+ }
241
+ };
242
+ const resolveAgentStep = async (order) => {
243
+ const resolved = await resolveVerifiedStep(order);
244
+ if (!resolved.ok)
245
+ return resolved;
246
+ const verdict = await trustFor(order, resolved);
247
+ // Read the policy only after the execution-time verdict is known. This
248
+ // keeps invalid signatures fail-closed and leaves command handling below
249
+ // independent from policy lookup.
250
+ if (verdict.kind !== 'verified') {
251
+ const selected = readPolicy();
252
+ if (verdict.kind === 'invalid' || selected === 'enforce')
253
+ return refuseUnverified(order, verdict);
254
+ if (selected === 'warn') {
255
+ warn(`workflow definition '${order.defDigest}' is ${verdict.kind}; defPolicy=warn allows agent execution: ${verdict.kind === 'unverifiable' ? verdict.reason : 'no publication signature'}`);
256
+ }
257
+ }
258
+ const originRefusal = await checkOrigin(order, resolved);
259
+ if (originRefusal !== undefined)
260
+ return originRefusal;
261
+ return { ok: true, step: resolved.step, ...(resolved.objectPath !== undefined ? { bundleDir: resolved.objectPath } : {}) };
262
+ };
263
+ return {
264
+ async resolveCommand(order) {
265
+ const resolved = await resolveVerifiedStep(order);
266
+ if (!resolved.ok)
267
+ return resolved;
268
+ const verdict = await trustFor(order, resolved);
269
+ // HARD RULE: command orders never consult defPolicy before this gate.
270
+ // An unverified definition must never reach `/bin/sh -c`, including off.
271
+ if (verdict.kind !== 'verified')
272
+ return refuseUnverified(order, verdict);
273
+ // HARD RULE: consume-side verification runs before any policy lookup,
274
+ // including origin and artifact policy. A command worker never admits
275
+ // absent, unverifiable, or invalid dynamic evidence under
276
+ // artifactPolicy=off; otherwise a future command interpolation could
277
+ // carry an unverified value into `/bin/sh -c`.
278
+ const consumedRefusal = await gateConsumed(order, true);
279
+ if (consumedRefusal !== undefined)
280
+ return consumedRefusal;
281
+ const originRefusal = await checkOrigin(order, resolved);
282
+ if (originRefusal !== undefined)
283
+ return originRefusal;
284
+ if (typeof resolved.step.command !== 'string' || resolved.step.command.trim() === '') {
285
+ return refusal('missing-command', order, 'the verified step has no non-empty command text');
286
+ }
287
+ // Deliberately return the authored bytes exactly. Runtime substitutions
288
+ // belong to prompts only; this string is passed to `/bin/sh -c`.
289
+ return { ok: true, command: resolved.step.command, ...(resolved.objectPath !== undefined ? { bundleDir: resolved.objectPath } : {}) };
290
+ },
291
+ resolveStep: resolveAgentStep,
292
+ };
293
+ }
294
+ /** Build the production resolver from injected process environment and cwd. */
295
+ export function createDefaultStoreInstructionResolver(args) {
296
+ const home = [args.env.HOME, args.env.USERPROFILE].find((value) => value !== undefined && value.trim() !== '');
297
+ if (home === undefined) {
298
+ throw new Error('cannot locate the global workflow store: set HOME or USERPROFILE');
299
+ }
300
+ const projectRoot = join(args.cwd, 'workflows');
301
+ const globalRoot = globalStoreRoot(home);
302
+ const verifier = args.verifier ?? createBundleIngestor();
303
+ const source = createStoreInstructionSource({
304
+ projectRoot,
305
+ globalRoot,
306
+ verifier,
307
+ });
308
+ return createStoreInstructionResolver({
309
+ projectRoot,
310
+ globalRoot,
311
+ verifier,
312
+ source,
313
+ definitionVerifier: args.definitionVerifier ?? createExecutionDefinitionVerifier({ env: args.env }),
314
+ originVerifier: args.originVerifier ?? createExecutionOriginVerifier({ env: args.env }),
315
+ ...(args.consumedVerifier !== undefined ? { consumedVerifier: args.consumedVerifier } : {}),
316
+ ...(args.defPolicy !== undefined ? { defPolicy: args.defPolicy } : {}),
317
+ ...(args.originPolicy !== undefined ? { originPolicy: args.originPolicy } : {}),
318
+ ...(args.originRules !== undefined ? { originRules: args.originRules } : {}),
319
+ ...(args.policyFloor !== undefined ? { policyFloor: args.policyFloor } : {}),
320
+ ...(args.warn !== undefined ? { warn: args.warn } : {}),
321
+ env: args.env,
322
+ });
323
+ }
@@ -0,0 +1,40 @@
1
+ import type { HubClient } from '../hub/client.ts';
2
+ import type { ContactHolder } from '../hub/types.ts';
3
+ import type { CommandRunner } from './runner.ts';
4
+ import type { InstructionResolver } from './instructions.ts';
5
+ import { type SubmissionKeyManager } from '../submit-proof.ts';
6
+ import type { SshProcessAdapter } from '../../../../src/crypto/ssh.ts';
7
+ /** Discriminated result of an exec run; the role maps these to exit codes. */
8
+ export type ExecOutcome = 'submitted' | 'completed' | 'misroute' | 'unresolved-instructions' | 'killed' | 'lease-lost' | 'ownership-error' | 'hub-unreachable' | 'submit-rejected' | 'submit-failed' | 'rejected' | 'judge-rejected' | 'judge-no-verdict' | 'reject-failed' | 'stopped';
9
+ export interface ExecLoopOptions {
10
+ hub: HubClient;
11
+ runner: CommandRunner;
12
+ workflow: string;
13
+ run: string;
14
+ /** Hub origin used to resolve the local machine signing key. */
15
+ origin?: string;
16
+ principalKeys?: SubmissionKeyManager;
17
+ env?: Record<string, string | undefined>;
18
+ /** Injectable ssh-keygen seam for hermetic submit-proof tests. */
19
+ sshProcess?: SshProcessAdapter;
20
+ /** The exec process holder tag `{kind:'exec', id}` — id is `<hostname>:<pid>`. */
21
+ holder: ContactHolder;
22
+ /** Resolves command text from a verified local workflow-store object. */
23
+ instructions: InstructionResolver;
24
+ /** cwd for the command when the order packet carries no `workdir`. */
25
+ cwd: string;
26
+ sleep: (ms: number) => Promise<void>;
27
+ now: () => number;
28
+ random?: () => number;
29
+ out: (line: string) => void;
30
+ err: (line: string) => void;
31
+ heartbeatIntervalMs?: number;
32
+ jumpToleranceMs?: number;
33
+ failureWindowMs?: number;
34
+ }
35
+ export interface ExecLoop {
36
+ run(): Promise<ExecOutcome>;
37
+ /** Final breath: kill the command group and release. Wired to SIGINT/SIGTERM. */
38
+ stop(reason?: string): void;
39
+ }
40
+ export declare function createExecLoop(opts: ExecLoopOptions): ExecLoop;