@runeditrun/rer 0.2.84 → 0.2.86

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 (236) hide show
  1. package/README.md +156 -50
  2. package/cli/README.md +78 -2
  3. package/cli/agent-door.mjs +149 -0
  4. package/cli/agent-fixtures.mjs +16 -0
  5. package/cli/agent-mail.mjs +54 -0
  6. package/cli/agent-network.mjs +64 -0
  7. package/cli/agent-reviewers.mjs +110 -0
  8. package/cli/agent-secrets.mjs +23 -0
  9. package/cli/agent-sponsors.mjs +43 -0
  10. package/cli/agent-surface.mjs +34 -0
  11. package/cli/agent-webhooks.mjs +19 -0
  12. package/cli/authoring.mjs +2 -1
  13. package/cli/bounded.mjs +1 -1
  14. package/cli/business/archive-task.mjs +32 -0
  15. package/cli/business/carry.mjs +151 -0
  16. package/cli/business/catchup-task.mjs +42 -0
  17. package/cli/business/choices.mjs +97 -0
  18. package/cli/business/command.mjs +29 -6
  19. package/cli/business/connect.mjs +20 -8
  20. package/cli/business/detector.mjs +4 -1
  21. package/cli/business/device.mjs +13 -0
  22. package/cli/business/export-inputs.mjs +69 -0
  23. package/cli/business/export-task.mjs +17 -0
  24. package/cli/business/invocation.mjs +8 -1
  25. package/cli/business/keychain.mjs +8 -1
  26. package/cli/business/lease.mjs +11 -1
  27. package/cli/business/local-commands.mjs +80 -30
  28. package/cli/business/outbound.mjs +9 -4
  29. package/cli/business/parsers-config.mjs +8 -7
  30. package/cli/business/parsers-syntax.mjs +7 -3
  31. package/cli/business/permissions.mjs +2 -0
  32. package/cli/business/questions.mjs +89 -6
  33. package/cli/business/setup-command.mjs +49 -0
  34. package/cli/business/setup-company.json +15 -0
  35. package/cli/business/setup-demo.mjs +95 -0
  36. package/cli/business/state.mjs +44 -10
  37. package/cli/business/supervisor.mjs +97 -32
  38. package/cli/business/vendor-door.mjs +230 -0
  39. package/cli/business/vendors/README.md +29 -3
  40. package/cli/business/vendors/common.mjs +8 -6
  41. package/cli/business/vendors/index.mjs +22 -11
  42. package/cli/business/vendors/sorry.mjs +106 -0
  43. package/cli/container-transfer.mjs +2 -2
  44. package/cli/contract.mjs +7 -7
  45. package/cli/demo-deploy-error.mjs +14 -0
  46. package/cli/demo-native.mjs +6 -2
  47. package/cli/deploy-command.mjs +6 -4
  48. package/cli/deploy-config.mjs +1 -1
  49. package/cli/deploy-owner-input.mjs +3 -1
  50. package/cli/deploy-variables.mjs +58 -0
  51. package/cli/deploy.mjs +9 -7
  52. package/cli/door-clauses.mjs +157 -0
  53. package/cli/errors.mjs +1 -1
  54. package/cli/export.mjs +16 -4
  55. package/cli/hosted-output.mjs +17 -7
  56. package/cli/human-error.mjs +20 -0
  57. package/cli/inspect.mjs +4 -0
  58. package/cli/jsonc.mjs +8 -4
  59. package/cli/lifecycle.mjs +26 -6
  60. package/cli/main.mjs +2 -1
  61. package/cli/managed-data-schema.mjs +127 -0
  62. package/cli/managed-data-zip.mjs +116 -0
  63. package/cli/managed-data.mjs +110 -0
  64. package/cli/managed-server.mjs +25 -14
  65. package/cli/native-owner-entry.mjs +86 -0
  66. package/cli/output.mjs +3 -2
  67. package/cli/parse.mjs +2 -2
  68. package/cli/portability-empty.mjs +65 -0
  69. package/cli/portability-migrations.mjs +33 -9
  70. package/cli/portability-policy.mjs +5 -2
  71. package/cli/portability-worker.mjs +15 -6
  72. package/cli/portability.mjs +30 -8
  73. package/cli/production-auth.mjs +1 -1
  74. package/cli/production-mail.mjs +8 -2
  75. package/cli/ready-summary.mjs +9 -0
  76. package/cli/run-transfers.mjs +37 -0
  77. package/cli/runtime-front-door.mjs +4 -4
  78. package/cli/server-proxy.mjs +4 -3
  79. package/cli/server-registry.mjs +13 -8
  80. package/cli/site.mjs +6 -1
  81. package/cli/transfers.mjs +17 -4
  82. package/edition-authoring/archive-source.mjs +59 -0
  83. package/edition-authoring/base-copies.mjs +147 -25
  84. package/edition-authoring/cli.mjs +1 -1
  85. package/edition-authoring/edition-migrations.mjs +7 -3
  86. package/edition-authoring/module-closure.mjs +2 -16
  87. package/edition-authoring/workflow-copies.mjs +1 -1
  88. package/edition-authoring/workflow-scripts.mjs +12 -3
  89. package/foundation/runtime/contract-docs.mjs +218 -34
  90. package/foundation/runtime/contract-prose-patterns.mjs +14 -0
  91. package/foundation/runtime/contract-prose.mjs +88 -0
  92. package/foundation/runtime/run-data.d.mts +1 -0
  93. package/foundation/runtime/run-data.mjs +2 -0
  94. package/global/CHANGELOG.md +126 -0
  95. package/global/README.md +156 -50
  96. package/global/cli/command.mjs +8 -2
  97. package/global/cli/install.mjs +4 -5
  98. package/global/cli/path-link.mjs +3 -2
  99. package/global/cli/repo-command.mjs +3 -7
  100. package/global/door/command.mjs +3 -1
  101. package/global/launch/dev.mjs +12 -2
  102. package/global/launch/facts.mjs +2 -2
  103. package/global/launch/render.mjs +16 -9
  104. package/global/launch/state.mjs +4 -4
  105. package/global/main.mjs +13 -8
  106. package/install.sh +17 -6
  107. package/modules/agent-door/CLAUSES.md +215 -0
  108. package/modules/agent-door/conformance/audit.mjs +66 -0
  109. package/modules/agent-door/conformance/authority.d.mts +2 -0
  110. package/modules/agent-door/conformance/authority.mjs +17 -0
  111. package/modules/agent-door/conformance/crypto.mjs +36 -0
  112. package/modules/agent-door/conformance/discovery.mjs +61 -0
  113. package/modules/agent-door/conformance/index.mjs +41 -0
  114. package/modules/agent-door/conformance/invocation.mjs +32 -0
  115. package/modules/agent-door/conformance/journey.mjs +112 -0
  116. package/modules/agent-door/conformance/narrowing.d.mts +1 -0
  117. package/modules/agent-door/conformance/narrowing.mjs +21 -0
  118. package/modules/agent-door/conformance/negative.mjs +47 -0
  119. package/modules/agent-door/conformance/network-modules.mjs +86 -0
  120. package/modules/agent-door/conformance/network-runtime.mjs +46 -0
  121. package/modules/agent-door/conformance/policy-phases.mjs +75 -0
  122. package/modules/agent-door/conformance/protocol.mjs +145 -0
  123. package/modules/agent-door/conformance/replay.mjs +38 -0
  124. package/modules/agent-door/conformance/schema.mjs +71 -0
  125. package/modules/agent-door/conformance/security.mjs +33 -0
  126. package/modules/agent-door/conformance/sponsors.mjs +68 -0
  127. package/modules/agent-door/conformance/surface.mjs +89 -0
  128. package/modules/agent-door/conformance/target.mjs +18 -0
  129. package/modules/agent-door/conformance/tool-name.d.mts +1 -0
  130. package/modules/agent-door/conformance/tool-name.mjs +7 -0
  131. package/modules/agent-door/conformance/webhooks.mjs +30 -0
  132. package/modules/container/README.md +6 -1
  133. package/modules/container/adapters/d1-limits.mjs +286 -0
  134. package/modules/container/adapters/d1-sqlite.mjs +95 -0
  135. package/modules/container/adapters/d1-workerd-preload.mjs +19 -0
  136. package/modules/container/adapters/d1-workerd-setup.mjs +26 -0
  137. package/modules/container/adapters/d1-workerd.mjs +5 -0
  138. package/modules/container/adapters/sqlite-worker.mjs +5 -3
  139. package/modules/container/build.mjs +1 -0
  140. package/modules/container/image-variables.mjs +14 -3
  141. package/modules/container/transfer.mjs +14 -4
  142. package/modules/container/worker-engine.mjs +3 -3
  143. package/modules/demo-host/README.md +6 -0
  144. package/modules/demo-host/build.mjs +1 -0
  145. package/modules/demo-host/native/prepare.mjs +2 -1
  146. package/modules/demo-host/native/sql.mjs +7 -2
  147. package/modules/demo-host/ownership.mjs +39 -0
  148. package/modules/demo-host/plan.mjs +2 -1
  149. package/modules/demo-host/remove.mjs +6 -1
  150. package/modules/deploy-kit/README.md +22 -2
  151. package/modules/deploy-kit/d1-import-diagnostics.mjs +56 -0
  152. package/modules/deploy-kit/d1-import.mjs +17 -5
  153. package/modules/deploy-kit/diagnostics.mjs +29 -3
  154. package/modules/deploy-kit/owner-cli.mjs +20 -7
  155. package/modules/deploy-kit/provider-transport.mjs +19 -4
  156. package/modules/deploy-kit/provider.mjs +57 -22
  157. package/modules/deploy-kit/readiness-window.mjs +1 -1
  158. package/modules/deploy-kit/site.mjs +8 -3
  159. package/modules/deploy-kit/worker.mjs +4 -4
  160. package/modules/import-kit/schema/importer-verification-receipt.schema.json +171 -0
  161. package/modules/import-kit/schema/importers.schema.json +107 -0
  162. package/modules/import-kit/src/d1/README.md +23 -4
  163. package/modules/import-kit/src/d1/atomic-prefix.ts +2 -2
  164. package/modules/import-kit/src/d1/budget.ts +15 -7
  165. package/modules/import-kit/src/d1/column-layout.ts +5 -0
  166. package/modules/import-kit/src/d1/creation.ts +15 -8
  167. package/modules/import-kit/src/d1/database.ts +3 -3
  168. package/modules/import-kit/src/d1/erasure-pages.ts +2 -1
  169. package/modules/import-kit/src/d1/erasure.ts +2 -2
  170. package/modules/import-kit/src/d1/jobs.ts +10 -6
  171. package/modules/import-kit/src/d1/plans.ts +14 -8
  172. package/modules/import-kit/src/d1/retirement.ts +2 -2
  173. package/modules/import-kit/src/d1/sets.ts +1 -3
  174. package/modules/import-kit/src/d1/staged-creation.ts +3 -3
  175. package/modules/import-kit/src/door/ADOPTING.md +20 -0
  176. package/modules/import-kit/src/door/README.md +2 -1
  177. package/modules/import-kit/src/door/admission.ts +5 -3
  178. package/modules/import-kit/src/door/archive.ts +5 -2
  179. package/modules/import-kit/src/door/authority.ts +1 -0
  180. package/modules/import-kit/src/door/grants.ts +1 -1
  181. package/modules/import-kit/src/door/handler.ts +14 -8
  182. package/modules/import-kit/src/door/index.ts +1 -1
  183. package/modules/import-kit/src/door/jobs.ts +40 -0
  184. package/modules/import-kit/src/door/limits.ts +1 -1
  185. package/modules/import-kit/src/door/operator.ts +3 -3
  186. package/modules/import-kit/src/door/planning.ts +10 -6
  187. package/modules/import-kit/src/door/protocol.ts +2 -2
  188. package/modules/import-kit/src/door/raw.ts +25 -0
  189. package/modules/import-kit/src/door/refusals.ts +2 -1
  190. package/modules/import-kit/src/door/types.ts +26 -6
  191. package/modules/import-kit/src/receipt/encoding.ts +37 -0
  192. package/modules/import-kit/src/receipt/index.ts +69 -0
  193. package/modules/import-kit/src/receipt/policy.ts +24 -0
  194. package/modules/import-kit/src/receipt/types.ts +64 -0
  195. package/modules/import-kit/src/receipt/uri.ts +45 -0
  196. package/modules/import-kit/src/receipt/validation.ts +87 -0
  197. package/modules/import-kit/src/status/encoding.ts +13 -0
  198. package/modules/import-kit/src/status/evidence.ts +218 -0
  199. package/modules/import-kit/src/status/index.ts +56 -0
  200. package/modules/import-kit/src/status/schema.ts +208 -0
  201. package/modules/import-kit/src/status/types.ts +86 -0
  202. package/modules/operator-auth/accounts/delegated.mjs +48 -0
  203. package/modules/operator-auth/index.d.mts +7 -0
  204. package/modules/operator-auth/service.mjs +2 -0
  205. package/modules/portability/README.md +138 -9
  206. package/modules/portability/backfills.mjs +9 -8
  207. package/modules/portability/bridge.mjs +32 -5
  208. package/modules/portability/catalogue.mjs +12 -5
  209. package/modules/portability/copies.mjs +8 -1
  210. package/modules/portability/derived.mjs +33 -0
  211. package/modules/portability/files.mjs +4 -3
  212. package/modules/portability/http-errors.mjs +1 -1
  213. package/modules/portability/http.mjs +3 -3
  214. package/modules/portability/import.mjs +29 -13
  215. package/modules/portability/index.d.mts +4 -3
  216. package/modules/portability/index.mjs +1 -1
  217. package/modules/portability/ledgers.mjs +3 -2
  218. package/modules/portability/legacy-safety.mjs +11 -2
  219. package/modules/portability/migration-history.mjs +2 -2
  220. package/modules/portability/progress.mjs +1 -0
  221. package/modules/portability/restore-empty.mjs +12 -0
  222. package/modules/release/github-verify.mjs +11 -2
  223. package/onboarding/adapter.mjs +35 -6
  224. package/onboarding/app-fetch.mjs +6 -4
  225. package/onboarding/development-runtime.mjs +19 -0
  226. package/onboarding/local/operation.mjs +45 -27
  227. package/onboarding/loopback-fetch.mjs +16 -0
  228. package/onboarding/operator-installer.mjs +2 -4
  229. package/onboarding/process-diagnostics.mjs +6 -2
  230. package/onboarding/production-runtime.mjs +4 -2
  231. package/onboarding/readiness.mjs +1 -0
  232. package/package.json +4 -2
  233. package/scripts/publish-check/copy_identities.py +3 -1
  234. package/scripts/publish-check/github_refs.py +32 -13
  235. package/scripts/publish-check/public_hygiene.py +1 -1
  236. package/cli/business/opt-ins.mjs +0 -33
@@ -0,0 +1,61 @@
1
+ import { isDeepStrictEqual } from 'node:util';
2
+ import { accessToken } from './crypto.mjs';
3
+ import { narrowingContract } from './narrowing.mjs';
4
+ import { VERSION } from './protocol.mjs';
5
+
6
+ export async function discoverDoor(c) {
7
+ const discover = await c.mcp('server/discover');
8
+ c.add('BASE-AGENT-001.1', discover.status === 200 && discover.result && Array.isArray(discover.result.supportedVersions) && discover.result.supportedVersions.includes(VERSION) && discover.result.supportedVersions.includes('2025-11-25') && discover.result.capabilities && discover.result._meta?.['io.modelcontextprotocol/serverInfo'] && typeof discover.result.instructions === 'string', 'server/discover must identify versions, capabilities, serverInfo and instructions.');
9
+ const limits = discover.result?._meta?.['com.runeditrun/limits'];
10
+ c.add('BASE-AGENT-001.6.limits', Number.isSafeInteger(limits?.requestsPerMinute) && limits.requestsPerMinute > 0 && Number.isSafeInteger(limits?.maxBodyBytes) && limits.maxBodyBytes > 0 && discover.result.instructions.includes(c.surface.specialist), 'Discovery must name the specialist and the capacity limits in force.');
11
+ const foreign = await c.mcp('server/discover', {}, { headers: { Origin: 'https://foreign.invalid' } });
12
+ c.add('BASE-AGENT-001.5.origin', foreign.status === 403, `Foreign Origin returned ${foreign.status}.`);
13
+ const mismatch = await c.mcp('server/discover', {}, { headers: { 'Mcp-Method': 'tools/list' } });
14
+ c.add('BASE-AGENT-001.5.method', mismatch.status === 400 && mismatch.message?.error?.code === -32020, 'A header/body method mismatch must return HeaderMismatch.');
15
+ const unsupported = await c.mcp('server/discover', {}, { version: '2099-01-01' });
16
+ c.add('BASE-AGENT-001.3', unsupported.status === 400 && unsupported.message?.error?.code === -32022 && unsupported.message.error.data?.supported?.includes(VERSION), 'An unsupported version must return UnsupportedProtocolVersion.');
17
+ const metadata = await c.request('/.well-known/oauth-protected-resource/mcp');
18
+ let oauth; try { oauth = await metadata.json(); } catch {}
19
+ c.resourceScopes = Array.isArray(oauth?.scopes_supported) ? oauth.scopes_supported.filter(scope => typeof scope === 'string') : [];
20
+ c.add('BASE-AGENT-004.1.metadata', metadata.ok && oauth?.resource === `${c.origin}/mcp` && oauth.authorization_servers?.includes(c.signer.issuer) && c.surface.tools.every(tool => oauth.scopes_supported?.includes(tool.scope)), 'Resource metadata must identify the canonical MCP resource, trusted issuer and all declared scopes.');
21
+ const oversize = await c.request('/mcp', { method: 'POST', headers: { Authorization: `Bearer ${await accessToken(c)}`, Origin: c.origin, 'Content-Type': 'application/json', 'MCP-Protocol-Version': VERSION, 'Mcp-Method': 'tools/call', 'Mcp-Name': c.surface.witness.tool }, body: JSON.stringify({ jsonrpc: '2.0', id: 9999, method: 'tools/call', params: { name: c.surface.witness.tool, arguments: { oversized: 'x'.repeat(limits?.maxBodyBytes + 1 || 2 * 1024 * 1024) } } }) });
22
+ c.add('BASE-AGENT-001.6', oversize.status === 413, `Oversized body returned ${oversize.status}.`);
23
+ await oversize.body?.cancel();
24
+ }
25
+
26
+ export async function listedDoor(c) {
27
+ const first = await c.mcp('tools/list'), second = await c.mcp('tools/list');
28
+ const tools = first.result?.tools ?? [], names = tools.map(tool => tool.name), expected = c.surface.tools.map(tool => tool.name).sort();
29
+ c.listed = new Map(tools.map(tool => [tool.name, tool]));
30
+ c.add('BASE-AGENT-002.1.registry', isDeepStrictEqual(names, expected), `tools/list differs from surface: actual ${names.join(', ')}, expected ${expected.join(', ')}.`);
31
+ c.add('BASE-AGENT-001.4', isDeepStrictEqual(first.result, second.result) && typeof first.result?.ttlMs === 'number' && first.result.ttlMs >= 0 && first.result.cacheScope === 'private', 'Repeated tools/list results must have deterministic order, ttlMs and private cache scope.');
32
+ for (const declared of c.surface.tools) {
33
+ const tool = c.listed.get(declared.name);
34
+ if (declared.proof) c.add(`BASE-AGENT-004.proof.${declared.name}.declaration`, tool?._meta?.['com.runeditrun/proof'] === declared.proof && tool?._meta?.['com.runeditrun/proof-kind'] === declared.proofKind, `${declared.name} must expose its native proof requirement.`);
35
+ if (declared.widens === false) {
36
+ const { idempotency_key: _key, expected_revision: _revision, ...properties } = tool?.inputSchema?.properties ?? {};
37
+ const schema = { ...tool?.inputSchema, properties, required: tool?.inputSchema?.required?.filter(key => !['idempotency_key', 'expected_revision'].includes(key)) };
38
+ c.add(`BASE-AGENT-005.narrowing.${declared.name}.schema`, narrowingContract({ ...declared, inputSchema: schema }) && tool?._meta?.['com.runeditrun/widens'] === false && isDeepStrictEqual(tool?._meta?.['com.runeditrun/narrowing'], declared.narrowing) && isDeepStrictEqual(schema, declared.inputSchema), `${declared.name} narrowing check requires the runtime's exact closed target-only schema and effect.`);
39
+ }
40
+ if (declared.authority === 'none') c.add(`BASE-AGENT-005.no-subject.schema.${declared.name}`, tool?._meta?.['com.runeditrun/authority'] === 'none' && isDeepStrictEqual(tool?._meta?.['com.runeditrun/effect'], declared.effect) && isDeepStrictEqual(Object.fromEntries(Object.entries(tool?.inputSchema?.properties ?? {}).filter(([key]) => !['idempotency_key', 'expected_revision'].includes(key))), declared.inputSchema.properties), 'No-subject declarations must match the actual runtime schema and record effect.');
41
+ c.add(`BASE-AGENT-002.2.schema.${declared.name}`, tool?.inputSchema?.type === 'object' && tool.outputSchema !== undefined, `${declared.name} must carry input and output schemas.`);
42
+ c.add(`BASE-AGENT-002.3.${declared.name}`, tool?.annotations?.readOnlyHint === declared.readOnly && tool?.annotations?.destructiveHint === declared.classes.includes('destructive') && tool?.annotations?.openWorldHint === declared.classes.includes('external'), `${declared.name} annotations differ from its declared behavior.`);
43
+ c.add(`BASE-AGENT-006.1.${declared.name}`, isDeepStrictEqual([...(tool?._meta?.['com.runeditrun/classes'] ?? [])].sort(), [...declared.classes].sort()) && tool?._meta?.['com.runeditrun/scope'] === declared.scope && isDeepStrictEqual([...(tool?._meta?.['com.runeditrun/clauses'] ?? [])].sort(), [...declared.clauses].sort()), `${declared.name} classes, scope or clauses differ from the Agent surface.`);
44
+ }
45
+ for (const version of [VERSION, '2025-11-25']) {
46
+ const initialized = await c.mcp('initialize', { protocolVersion: version, capabilities: {}, clientInfo: { name: 'rer-agent-conformance', version: '1' } }, { version });
47
+ const listed = await c.mcp('tools/list', {}, { version });
48
+ c.add(`BASE-AGENT-001.2.${version}`, !initialized.headers.has('mcp-session-id') && initialized.result?.protocolVersion === version && isDeepStrictEqual(listed.result?.tools?.map(tool => tool.name), names), `${version} must negotiate and expose the same tools.`);
49
+ }
50
+ const march = await c.mcp('initialize', { protocolVersion: '2025-03-26', capabilities: {} }, { version: '2025-03-26' });
51
+ c.add('BASE-AGENT-001.3.2025-03-26', march.status === 400 && march.message?.error?.code === -32022 && march.message.error.message === 'UnsupportedProtocolVersion', 'March 2025 batching is not implemented; refuse its negotiation explicitly.');
52
+ const templates = await c.mcp('resources/templates/list');
53
+ c.add('BASE-AGENT-003.1', isDeepStrictEqual((templates.result?.resourceTemplates ?? []).map(item => item.uriTemplate).sort(), [...c.surface.resources].sort()), 'resources/templates/list must match the Agent surface.');
54
+ const prompts = await c.mcp('prompts/list');
55
+ c.add('BASE-AGENT-013.5.prompts', Array.isArray(prompts.result?.prompts), 'prompts/list must list the declared specialist prompts.');
56
+ if (prompts.result?.prompts?.length) {
57
+ const prompt = await c.mcp('prompts/get', { name: prompts.result.prompts[0].name });
58
+ c.add('BASE-AGENT-001.1.prompts', Array.isArray(prompt.result?.messages) && prompt.result.messages.length > 0, 'A specialist prompt must be retrievable with Mcp-Name.');
59
+ }
60
+
61
+ }
@@ -0,0 +1,41 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { validateAgentSurface } from './surface.mjs';
3
+ import { createProtocol } from './protocol.mjs';
4
+ import { autonomousPolicy, heldPolicy } from './crypto.mjs';
5
+ import { discoverDoor, listedDoor } from './discovery.mjs';
6
+ import { runJourney } from './journey.mjs';
7
+ import { unsetPolicy, removalPhase, blockedPhases, pausePhase, consentRevocationPhase } from './policy-phases.mjs';
8
+ import { negativePhase } from './negative.mjs';
9
+ import { replayAdmissionPhase } from './replay.mjs';
10
+ import { webhookPhase } from './webhooks.mjs';
11
+ import { recordSecurityPhase } from './security.mjs';
12
+ import { crossSponsorPhase } from './sponsors.mjs';
13
+ import { auditPhase } from './audit.mjs';
14
+ import { invocationPhase } from './invocation.mjs';
15
+
16
+ export { validateAgentSurface } from './surface.mjs';
17
+
18
+ /** Run against a fresh, real installation using its HTTP and person doors. */
19
+ export async function runAgentDoorConformance({ fetch, invoke, origin, surface, signer, person, sponsors = [person], webhooks, business = 'rer-agent-conformance', consent = randomUUID(), now, prove, nativeJourney }) {
20
+ const validation = validateAgentSurface(surface), points = [...validation.points];
21
+ if (!validation.ok) return { ok: false, points };
22
+ if (typeof fetch !== 'function' || !signer?.privateKey || !signer.issuer || !signer.installationId || !signer.kid || !person?.email || !person.cookie || typeof person.sub !== 'string' || !person.sub.trim() || typeof consent !== 'string' || !consent.trim() || new URL(origin).origin !== origin) throw new TypeError('Conformance requires fetch, canonical origin, signer, consent and signed-in person {email,cookie,sub}');
23
+ const c = createProtocol({ fetch, origin, surface, signer, person, business, consent, now, prove, points, agentId: `rer-conformance-${randomUUID()}`, seq: 0, revision: 0, listed: new Map() });
24
+ await c.phase('BASE-AGENT-001.transport', () => discoverDoor(c));
25
+ await c.phase('BASE-AGENT-007.phase0', () => unsetPolicy(c, true));
26
+ await c.phase('BASE-AGENT-007.phase1', () => removalPhase(c));
27
+ await c.phase('BASE-AGENT-013.phase2', async () => { await c.adopt(autonomousPolicy()); await listedDoor(c); await runJourney(c, 'autonomous', { injections: true, replay: true }); });
28
+ await c.phase('BASE-AGENT-013.phase3', async () => { await c.adopt(heldPolicy()); await runJourney(c, 'held', { held: true }); });
29
+ await c.phase('BASE-AGENT-007.phase4', () => blockedPhases(c));
30
+ await c.phase('BASE-AGENT-011.phase5', () => pausePhase(c));
31
+ await c.phase('BASE-AGENT-004.phase6', () => negativePhase(c));
32
+ await c.phase('BASE-AGENT-004.consent', () => consentRevocationPhase(c));
33
+ if (invoke) await c.phase('BASE-AGENT-012.invocation', () => invocationPhase(c, invoke));
34
+ if (nativeJourney) await c.phase('BASE-AGENT-013.native-journey', async () => { await nativeJourney({ tool: c.tool }); c.add('BASE-AGENT-013.native-journey', true); });
35
+ if (surface.tools.some(tool => tool.authority === 'none')) await c.phase('BASE-AGENT-005.no-subject', () => recordSecurityPhase(c));
36
+ if (surface.verification?.replayAdmission) await c.phase('BASE-AGENT-012.replay', () => replayAdmissionPhase(c, surface.verification.replayAdmission));
37
+ if (webhooks) await c.phase('BASE-AGENT-006.webhook', () => webhookPhase(c, webhooks));
38
+ await c.phase('BASE-AGENT-009.phase7', () => auditPhase(c));
39
+ if (sponsors.length > 1) await c.phase('BASE-AGENT-004.cross-sponsor', () => crossSponsorPhase(c, sponsors));
40
+ return { ok: points.every(point => point.ok), points };
41
+ }
@@ -0,0 +1,32 @@
1
+ import { isDeepStrictEqual } from 'node:util';
2
+ import { autonomousPolicy } from './crypto.mjs';
3
+ import { auditRows } from './audit.mjs';
4
+
5
+ /** The adapter drains serialized job input through the edition's real invoke door. */
6
+ export async function invocationPhase(c, invoke) {
7
+ const step = c.surface.journey.find(item => !c.surface.tools.find(tool => tool.name === item.tool)?.readOnly);
8
+ if (!step) throw new Error('Durable invocation conformance requires a mutating journey step.');
9
+ await c.adopt(autonomousPolicy());
10
+ const who = { person: { id: c.sponsor.id }, agent: { id: c.agentId, name: 'Agent door conformance', specialist: c.surface.specialist }, consent: c.consent, scopes: [c.surface.tools.find(tool => tool.name === step.tool).scope] };
11
+ const schedule = () => JSON.stringify({ name: step.tool, args: c.args(step, new Map(), { unresolved: true }), who });
12
+ const run = async saved => {
13
+ const job = JSON.parse(saved), result = await invoke(job.name, job.args, job.who);
14
+ c.calls.push({ kind: 'embedded', name: job.name, args: job.args, decision: result.decision, code: result.code });
15
+ return { job, result };
16
+ };
17
+ const before = await c.witness(), first = await run(schedule()), after = await c.witness();
18
+ c.add('BASE-AGENT-012.invocation-effect', first.result.outcome === 'done' && !isDeepStrictEqual(before, after), 'A serialized invocation under live consent must complete its native effect.');
19
+ const saved = schedule();
20
+ await c.adopt(autonomousPolicy(), { revoked: { agents: [], consents: [c.consent] } });
21
+ const second = await run(saved);
22
+ c.add('BASE-AGENT-012.invocation-revoked', second.result.outcome === 'refused' && second.result.code === 'consent_revoked', 'Final worker admission must refuse the saved originating consent with consent_revoked.');
23
+ const { rows } = await auditRows(c);
24
+ for (const [label, { job, result }] of [['done', first], ['refused', second]]) {
25
+ const row = rows.find(item => item.door === 'embedded' && item.idempotency_key === job.args.idempotency_key);
26
+ c.add(`BASE-AGENT-012.invocation-audit.${label}`, row?.consent === c.consent && row.agent?.id === who.agent.id && row.sponsor?.id === who.person.id
27
+ && row.tool === job.name && row.outcome === result.outcome && row.code === (result.code ?? null) && Number.isFinite(Date.parse(row.at)) && Boolean(row.id)
28
+ && (label !== 'refused' || row.revision === c.revision), 'Durable invocation audit must retain consent, agent, sponsor, tool, time, revision and outcome.');
29
+ }
30
+ await c.adopt(autonomousPolicy());
31
+ c.add('BASE-AGENT-012.invocation-no-effect', isDeepStrictEqual(after, await c.witness()), 'A saved job under revoked consent changed native state.');
32
+ }
@@ -0,0 +1,112 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { isDeepStrictEqual } from 'node:util';
3
+ import { classIds, subset, errorCode, APPROVAL } from './protocol.mjs';
4
+ import { grantSet } from './narrowing.mjs';
5
+ import { schemaErrors } from './schema.mjs';
6
+ import { checkTarget } from './target.mjs';
7
+
8
+ export function checkClasses(c, step, answer, phase) {
9
+ const actual = answer.decision?.classes;
10
+ c.add(`BASE-AGENT-006.2.${phase}.${step.id}`, isDeepStrictEqual(classIds(actual), classIds(step.expect)) && step.expect.every(expected => actual?.some(item => item.class === expected.class && subset(item.facts, expected.facts ?? {}))), `${step.tool} computed classes/facts differ from ${step.id}: ${JSON.stringify(actual)}.`);
11
+ }
12
+ function checkOutput(c, step, answer, phase) {
13
+ const schema = c.listed.get(step.tool)?.outputSchema;
14
+ const errors = schema === undefined ? ['missing outputSchema'] : schemaErrors(schema, answer.result?.structuredContent);
15
+ c.add(`BASE-AGENT-002.2.${phase}.${step.id}`, errors.length === 0, `${step.tool} output does not validate: ${errors.slice(0, 8).join('; ')}.`);
16
+ }
17
+ async function checkResources(c, step, answer, phase, held) {
18
+ const links = answer.result?.content?.filter(item => item.type === 'resource_link') ?? [];
19
+ for (const [i, link] of links.entries()) {
20
+ const read = await c.mcp('resources/read', { uri: link.uri });
21
+ const classes = read.decision?.classes, needsApproval = held && classes?.some(item => item.class !== 'standard');
22
+ c.add(`BASE-AGENT-006.2.resource.${phase}.${step.id}.${i}`, Array.isArray(classes) && classes.length > 0 && read.decision.revision === c.revision && classes.every(item => item.do === (held ? item.class === 'standard' ? 'review' : 'approval' : 'autonomous')), `${link.uri} must apply the policy to its computed resource classes.`);
23
+ c.add(`BASE-AGENT-003.4.${phase}.${step.id}.${i}`, read.status === 200 && (needsApproval
24
+ ? errorCode(read) === 'approval_required' && read.decision?.disposition === 'approval' && !read.result?.contents?.length
25
+ : !read.message?.error && read.decision?.disposition === (held ? 'review' : 'autonomous') && Array.isArray(read.result?.contents) && read.result.contents.length > 0), `${step.tool} resource_link ${link.uri} must ${needsApproval ? 'withhold content pending approval' : 'read back under the current policy'}.`);
26
+ if (needsApproval) {
27
+ const pending = read.body?.error?.data?.approval;
28
+ c.add(`BASE-AGENT-007.5.resource.${phase}.${step.id}.${i}`, pending?.id && typeof pending.url === 'string' && new URL(pending.url, c.origin).origin === c.origin && Number.isFinite(Date.parse(pending.expires_at)), `${link.uri} must expose a pending approval on the native person door.`);
29
+ if (pending?.id) {
30
+ const { approval } = await c.personJson(`/agents/api/approvals/${encodeURIComponent(pending.id)}`);
31
+ c.add(`BASE-AGENT-008.5.resource-summary.${phase}.${step.id}.${i}`, approval?.id === pending.id && approval.decision_id === read.decision.id && approval.revision === c.revision && /^[a-f0-9]{64}$/.test(approval.summary_sha256), `${link.uri} pending read must expose its exact summary hash and revision.`);
32
+ }
33
+ }
34
+ }
35
+ }
36
+ export async function runJourney(c, phase, { held = false, injections = false, replay = false } = {}) {
37
+ const outputs = new Map(); let replayed = false;
38
+ try {
39
+ for (const step of c.surface.journey) {
40
+ const args = c.args(step, outputs), needsApproval = held && step.expect.some(item => item.class !== 'standard');
41
+ const narrowing = !held && c.surface.narrowings?.find(fixture => fixture.step === step.id);
42
+ const grantsBefore = narrowing ? await grantSet(c, narrowing.witness, outputs) : null;
43
+ const before = needsApproval ? await c.witness() : undefined;
44
+ const declared = c.surface.tools.find(tool => tool.name === step.tool);
45
+ let proof = {};
46
+ if (declared.proof) {
47
+ if (!held) {
48
+ const original = await c.witness(), challenge = await c.tool(step.tool, args), bogus = await c.tool(step.tool, args, { proofReference: 'bogus-native-proof' });
49
+ const fields = challenge.result?._meta?.['com.runeditrun/error'];
50
+ c.add(`BASE-AGENT-004.native-proof.${step.id}.challenge`, errorCode(challenge) === 'native_proof_required' && fields?.kind === declared.proofKind && typeof fields?.handoff === 'string' && new URL(fields.handoff).origin === c.origin, `${step.tool} requires its named native proof and a local human handoff.`);
51
+ c.add(`BASE-AGENT-004.native-proof.${step.id}.bogus`, errorCode(bogus) === 'native_proof_required' && isDeepStrictEqual(original, await c.witness()), `${step.tool} must refuse bogus proof with no native effect.`);
52
+ proof = await c.proof(step.tool, args, fields?.handoff);
53
+ } else proof = await c.proof(step.tool, args);
54
+ }
55
+ let answer = await c.tool(step.tool, args, proof);
56
+ checkClasses(c, step, answer, phase);
57
+ await checkTarget(c, step, outputs, answer, phase);
58
+ const expectedDisposition = held ? needsApproval ? 'approval' : 'review' : 'autonomous';
59
+ c.add(`BASE-AGENT-007.1.${phase}.${step.id}`, answer.decision?.disposition === expectedDisposition && answer.decision.revision === c.revision && answer.decision.classes.every(item => item.do === (held ? item.class === 'standard' ? 'review' : 'approval' : 'autonomous')), `${step.tool} must receive ${expectedDisposition} under revision ${c.revision}.`);
60
+ if (needsApproval) {
61
+ const approval = answer.result?._meta?.[APPROVAL];
62
+ c.add(`BASE-AGENT-007.5.pending.${step.id}`, answer.result?.resultType === 'input_required' && approval?.id && typeof approval.url === 'string' && new URL(approval.url, c.origin).origin === c.origin && Number.isFinite(Date.parse(approval.expires_at)), `${step.tool} must return a pending handle, URL elicitation and expiry.`);
63
+ const after = await c.witness();
64
+ c.add(`BASE-AGENT-007.5.no-effect.${step.id}`, isDeepStrictEqual(before, after), `${step.tool} changed native state before approval.`);
65
+ if (!approval?.id) continue;
66
+ const approved = await c.decideApproval(answer);
67
+ await checkTarget(c, step, outputs, answer, phase, true);
68
+ c.add(`BASE-AGENT-008.5.approver.${step.id}`, approved.ok, `Signed-in sponsor approval returned HTTP ${approved.status}.`);
69
+ answer = await c.tool(step.tool, args, { ...proof, requestState: answer.result.requestState });
70
+ checkClasses(c, step, answer, `${phase}.approved`);
71
+ c.add(`BASE-AGENT-007.5.receipt.${step.id}`, !answer.result?.isError && answer.result?.resultType !== 'input_required' && Boolean(answer.result?._meta?.['com.runeditrun/receipt']) && answer.decision?.disposition === 'approval', 'The approved retry must complete with an approval receipt.');
72
+ }
73
+ c.add(`BASE-AGENT-013.4.${phase}.${step.id}`, answer.status === 200 && answer.result && !answer.result.isError && answer.result.resultType !== 'input_required', `${step.tool} did not complete (${errorCode(answer) ?? answer.status}).`);
74
+ if (answer.result?.isError || answer.result?.structuredContent === undefined) continue;
75
+ outputs.set(step.id, answer.result.structuredContent);
76
+ checkOutput(c, step, answer, phase);
77
+ await checkResources(c, step, answer, phase, held);
78
+ if (narrowing) {
79
+ c.add(`BASE-AGENT-005.narrowing.${step.tool}.target`, isDeepStrictEqual(c.resolve(narrowing.witness.args, outputs)[declared.narrowing.target], args[declared.narrowing.target]), `${step.tool} must witness the same targeted subject.`);
80
+ const after = await grantSet(c, narrowing.witness, outputs);
81
+ c.add(`BASE-AGENT-005.narrowing.${step.tool}.subset`, after.length < grantsBefore.length && after.every(grant => grantsBefore.includes(grant)), `${step.tool} must strictly reduce the targeted subject's native grant set.`);
82
+ const beforeInjection = await c.witness();
83
+ const smuggled = await c.tool(step.tool, { ...args, idempotency_key: randomUUID(), grant_to_add: 'admin' });
84
+ c.add(`BASE-AGENT-005.narrowing.${step.tool}.undeclared`, errorCode(smuggled) === 'invalid_arguments' && isDeepStrictEqual(beforeInjection, await c.witness()), `${step.tool} must refuse an undeclared widening argument without an effect.`);
85
+ }
86
+ if (!c.surface.tools.find(tool => tool.name === step.tool)?.readOnly) {
87
+ const snapshot = await c.tool(`${c.surface.seed}.events.list`, { limit: 200 });
88
+ if (!Array.isArray(snapshot.result?.structuredContent?.events)) throw new Error('Post-effect events.list must return events');
89
+ (c.effectEvents ??= []).push(...snapshot.result.structuredContent.events);
90
+ }
91
+ if (injections && step.inject) {
92
+ const injected = { ...args, ...c.resolve(step.inject, outputs), ...(!c.surface.tools.find(tool => tool.name === step.tool)?.readOnly ? { idempotency_key: randomUUID() } : {}) };
93
+ const checked = await c.tool(step.tool, injected, proof);
94
+ c.add(`BASE-AGENT-005.5.${phase}.${step.id}`, isDeepStrictEqual(checked.decision?.classes, answer.decision?.classes) && checked.decision?.disposition === answer.decision?.disposition && !checked.result?.isError, `${step.tool} changed class, facts or decision for additional arguments.`);
95
+ }
96
+ if (replay && !replayed && !c.surface.tools.find(tool => tool.name === step.tool)?.readOnly) {
97
+ replayed = true;
98
+ const beforeReplay = await c.witness(), repeated = await c.tool(step.tool, args, proof), afterReplay = await c.witness();
99
+ c.add(`BASE-AGENT-012.1.${phase}`, !repeated.result?.isError && isDeepStrictEqual(answer.result.structuredContent, repeated.result?.structuredContent) && isDeepStrictEqual(beforeReplay, afterReplay), `${step.tool} replay changed native state or returned a different result.`);
100
+
101
+ }
102
+ }
103
+ } finally {
104
+ if (!held) for (const step of c.surface.escalations ?? []) await c.phase(`BASE-AGENT-005.escalation.${step.id}`, async () => {
105
+ const args = c.args(step, outputs), before = await c.witness();
106
+ const answer = await c.tool(step.tool, args), after = await c.witness();
107
+ c.add(`BASE-AGENT-005.1.${step.id}`, errorCode(answer) === 'self_escalation', `${step.tool} must refuse sponsor escalation with self_escalation (${errorCode(answer) ?? answer.status}).`);
108
+ c.add(`BASE-AGENT-005.2.${step.id}`, isDeepStrictEqual(before, after), `${step.tool} changed native state while attempting sponsor escalation.`);
109
+ });
110
+ }
111
+ return outputs;
112
+ }
@@ -0,0 +1 @@
1
+ export function narrowingContract(tool: unknown): boolean
@@ -0,0 +1,21 @@
1
+ /** A closed target-only schema cannot encode a grant to add. Unknown schema
2
+ * constructs fail closed, rather than hiding widening fields in a union/ref. */
3
+ export function narrowingContract(tool) {
4
+ const schema = tool?.inputSchema, target = tool?.narrowing?.target;
5
+ if (tool?.widens !== false || !['revoke', 'narrow'].includes(tool.narrowing?.effect) || typeof target !== 'string'
6
+ || !/^(?:id|[a-z][a-z0-9_]*_id)$/.test(target) || !schema || schema.type !== 'object' || schema.additionalProperties !== false
7
+ || Object.keys(schema).some(key => !['type', 'properties', 'required', 'additionalProperties'].includes(key))
8
+ || !Array.isArray(schema.required) || schema.required.length !== 1 || schema.required[0] !== target
9
+ || !schema.properties || Object.keys(schema.properties).length !== 1) return false;
10
+ const field = schema.properties[target];
11
+ return field?.type === 'string' && Object.keys(field).every(key => ['type', 'minLength', 'maxLength', 'pattern', 'enum', 'description', 'title'].includes(key));
12
+ }
13
+
14
+ export async function grantSet(c, witness, outputs) {
15
+ const answer = await c.tool(witness.tool, c.resolve(witness.args, outputs));
16
+ if (answer.result?.isError) throw new Error('Native grant witness refused');
17
+ let value = answer.result?.structuredContent;
18
+ for (const part of witness.pointer.split('/').slice(1)) value = value?.[part.replace(/~1/g, '/').replace(/~0/g, '~')];
19
+ if (!Array.isArray(value) || value.some(grant => typeof grant !== 'string') || new Set(value).size !== value.length) throw new Error('Native grant witness must return a unique string grant set');
20
+ return value;
21
+ }
@@ -0,0 +1,47 @@
1
+ import { isDeepStrictEqual } from 'node:util';
2
+ import { webcrypto } from 'node:crypto';
3
+ import { accessToken, autonomousPolicy, policyEnvelope, seconds, signJws } from './crypto.mjs';
4
+ import { errorCode, VERSION } from './protocol.mjs';
5
+
6
+ export async function negativePhase(c) {
7
+ await c.adopt(autonomousPolicy());
8
+ const before = await c.witness(), iat = seconds(c.now);
9
+ const unavailable = await c.mcp('resources/read', { uri: `unregistered://${crypto.randomUUID()}` });
10
+ c.add('BASE-AGENT-003.refusal-code', unavailable.message?.error?.data?.code === 'tool_not_found' && unavailable.result === undefined, 'An unregistered resource must refuse with JSON-RPC error.data.code and no content.');
11
+ const noToken = await c.mcp('tools/list', {}, { token: null });
12
+ c.add('BASE-AGENT-004.1.challenge', noToken.status === 401 && /resource_metadata=/.test(noToken.headers.get('www-authenticate') ?? ''), 'An unauthenticated call must return 401 and a resource_metadata challenge.');
13
+ for (const [name, overrides] of [
14
+ ['audience', { aud: 'https://sibling.invalid/mcp' }],
15
+ ['expired', { iat: iat - 600, exp: iat - 1 }],
16
+ ['lifetime', { iat, exp: iat + 901 }],
17
+ ]) {
18
+ const answer = await c.mcp('tools/list', {}, { token: await accessToken(c, overrides) });
19
+ c.add(`BASE-AGENT-004.${name === 'audience' ? '2' : '3'}.${name}`, answer.status === 401, `${name} token returned HTTP ${answer.status}, expected 401.`);
20
+ }
21
+ const write = c.surface.journey.find(step => !c.surface.tools.find(tool => tool.name === step.tool)?.readOnly);
22
+ if (write) {
23
+ const answer = await c.tool(write.tool, c.args(write, new Map(), { unresolved: true }), { token: await accessToken(c, { scope: 'events:read' }) });
24
+ const needed = c.surface.tools.find(tool => tool.name === write.tool).scope;
25
+ c.add('BASE-AGENT-004.4', answer.status === 403 && errorCode(answer) === 'insufficient_scope' && (answer.headers.get('www-authenticate') ?? '').includes(needed), 'A token missing the write scope must be refused with all needed scopes in its challenge.');
26
+ }
27
+ const queryToken = await accessToken(c);
28
+ const query = await c.request(`/mcp?access_token=${encodeURIComponent(queryToken)}`, { method: 'POST', headers: { 'Content-Type': 'application/json', 'MCP-Protocol-Version': VERSION, 'Mcp-Method': 'tools/list' }, body: JSON.stringify({ jsonrpc: '2.0', id: 9876, method: 'tools/list', params: {} }) });
29
+ c.add('BASE-AGENT-004.5', query.status === 401, `A query-string token returned HTTP ${query.status}.`);
30
+ await query.body?.cancel();
31
+ const agentOnPersonDoor = await c.request('/agents/api/pause', { method: 'POST', headers: { Origin: c.origin, Authorization: `Bearer ${await accessToken(c)}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ paused: false }) });
32
+ c.add('BASE-AGENT-008.2.person-door', agentOnPersonDoor.status === 403, `An agent token at a person's pause control returned HTTP ${agentOnPersonDoor.status}.`);
33
+ await agentOnPersonDoor.body?.cancel();
34
+ const state = await c.personJson('/agents/api/state');
35
+ const signed = await policyEnvelope(c, autonomousPolicy());
36
+ const foreignKeys = await webcrypto.subtle.generateKey({ name: 'ECDSA', namedCurve: 'P-256' }, false, ['sign', 'verify']);
37
+ const badSignature = await signJws(foreignKeys.privateKey, c.signer.kid, 'rer-agent-policy+jwt', signed.payload);
38
+ const invalid = await c.request('/api/rer/agent-policy', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ policy: badSignature }) });
39
+ c.add('BASE-AGENT-007.8.signature', !invalid.ok, 'A policy envelope signed by an untrusted key was accepted.');
40
+ await invalid.body?.cancel();
41
+ const foreignBusiness = await policyEnvelope(c, autonomousPolicy(), { business: 'conformance-foreign-business' });
42
+ const foreign = await c.request('/api/rer/agent-policy', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ policy: foreignBusiness.policy }) });
43
+ c.add('BASE-AGENT-007.8.business', !foreign.ok, 'An envelope whose Business does not match its revision signature was accepted.');
44
+ await foreign.body?.cancel();
45
+ c.add('BASE-AGENT-007.8.state', isDeepStrictEqual(state, await c.personJson('/agents/api/state')), 'An invalid envelope changed the adopted policy state or revision.');
46
+ c.add('BASE-AGENT-004.negative-no-effect', isDeepStrictEqual(before, await c.witness()), 'An authentication/person-door/policy-envelope negative changed native state.');
47
+ }
@@ -0,0 +1,86 @@
1
+ import { readFile, realpath, stat } from 'node:fs/promises';
2
+ import { dirname, extname, isAbsolute, relative, resolve, sep } from 'node:path';
3
+ import { parse } from '../../../edition-authoring/vendor/babel-parser/babel-parser/index.mjs';
4
+
5
+ export class NetworkAdapterError extends Error {}
6
+ const invalid = message => new NetworkAdapterError(`Agent conformance network: ${message}`);
7
+ const contained = (root, path) => {
8
+ const name = relative(root, path);
9
+ return name !== '' && name !== '..' && !name.startsWith(`..${sep}`) && !isAbsolute(name);
10
+ };
11
+
12
+ export function validateNetworkAdapter(config) {
13
+ if (!config || typeof config !== 'object' || Array.isArray(config) ||
14
+ Object.keys(config).some(key => !['module', 'origins'].includes(key)) ||
15
+ typeof config.module !== 'string' || !config.module || isAbsolute(config.module) || config.module.includes('\\') ||
16
+ !Array.isArray(config.origins) || !config.origins.length) {
17
+ throw invalid('verification.network must declare a seed-relative module and a nonempty origins array.');
18
+ }
19
+ const origins = new Set();
20
+ for (const origin of config.origins) {
21
+ let url;
22
+ try { url = new URL(origin); } catch { /* Report only the declaration field, never a credential-bearing URL. */ }
23
+ if (typeof origin !== 'string' || !url || !['http:', 'https:'].includes(url.protocol) || url.origin !== origin || url.username || url.password) {
24
+ throw invalid('verification.network.origins must contain exact HTTP(S) origins without credentials, paths, queries or fragments.');
25
+ }
26
+ if (origins.has(origin)) throw invalid('verification.network.origins must not repeat an origin.');
27
+ origins.add(origin);
28
+ }
29
+ return { module: config.module, origins };
30
+ }
31
+
32
+ function imports(source) {
33
+ let ast;
34
+ try { ast = parse(source, { sourceType: 'module', createImportExpressions: true }); }
35
+ catch { throw invalid('the adapter or a relative helper is not valid ES module JavaScript.'); }
36
+ const pending = [ast], result = [];
37
+ while (pending.length) {
38
+ const node = pending.pop();
39
+ let specifier;
40
+ if (['ImportDeclaration', 'ExportNamedDeclaration', 'ExportAllDeclaration', 'ImportExpression'].includes(node.type) && node.source) {
41
+ if (node.source.type !== 'StringLiteral') throw invalid('adapter imports must use literal relative module paths.');
42
+ specifier = node.source.value;
43
+ }
44
+ if (specifier !== undefined) {
45
+ if (!(specifier.startsWith('./') || specifier.startsWith('../')) || specifier.includes('\\') || specifier.includes('?') || specifier.includes('#')) {
46
+ throw invalid('adapter imports must be relative JavaScript modules; packages, Node APIs and runtime built-ins are unavailable.');
47
+ }
48
+ result.push(specifier);
49
+ }
50
+ for (const value of Object.values(node)) {
51
+ if (Array.isArray(value)) pending.push(...value.filter(item => item && typeof item.type === 'string'));
52
+ else if (value && typeof value.type === 'string') pending.push(value);
53
+ }
54
+ }
55
+ return result;
56
+ }
57
+
58
+ // Supply only snapshotted, checked module bytes to workerd. It has no filesystem
59
+ // loader, so an unresolved or computed import cannot read another host file.
60
+ export async function networkAdapterModules(root, entry) {
61
+ let directory;
62
+ try { directory = await realpath(root); }
63
+ catch { throw invalid('the seed root is unreadable.'); }
64
+ const pending = [resolve(directory, entry)], seen = new Set(), modules = [];
65
+ while (pending.length) {
66
+ const path = pending.shift();
67
+ if (seen.has(path)) continue;
68
+ if (!contained(directory, path) || !['.mjs', '.js'].includes(extname(path))) {
69
+ throw invalid('the adapter and every helper must be .mjs or .js files contained in the seed root.');
70
+ }
71
+ let canonical, contents;
72
+ try {
73
+ canonical = await realpath(path);
74
+ if (!contained(directory, canonical)) throw invalid('an adapter module symlink escapes the seed root.');
75
+ if (!(await stat(canonical)).isFile()) throw invalid('an adapter module is not a regular file.');
76
+ contents = await readFile(canonical, 'utf8');
77
+ } catch (error) {
78
+ if (error instanceof NetworkAdapterError) throw error;
79
+ throw invalid('the declared adapter or a relative helper cannot be read. Use explicit relative .mjs or .js file paths.');
80
+ }
81
+ seen.add(path);
82
+ modules.push({ type: 'ESModule', path, contents });
83
+ pending.push(...imports(contents).map(specifier => resolve(dirname(path), specifier)));
84
+ }
85
+ return { root: directory, modules };
86
+ }
@@ -0,0 +1,46 @@
1
+ import { createRequire } from 'node:module';
2
+ import { join, relative } from 'node:path';
3
+ import { pathToFileURL } from 'node:url';
4
+ import { networkAdapterModules, NetworkAdapterError } from './network-modules.mjs';
5
+
6
+ // The adapter runs in its own disposable workerd instance, with neither app
7
+ // bindings nor Node compatibility. Its own fetch can never reach the network.
8
+ export async function isolatedNetworkAdapter(root, entry, deny) {
9
+ const source = await networkAdapterModules(root, entry);
10
+ let mf;
11
+ try {
12
+ const wrangler = createRequire(join(root, 'package.json')).resolve('wrangler/package.json');
13
+ const { Miniflare, convertV4MiniflareOptions = options => options } = await import(pathToFileURL(createRequire(wrangler).resolve('miniflare')));
14
+ // Host control data is carried on a private request header, overwritten on
15
+ // every dispatch and removed before the seed adapter sees its native request.
16
+ // There is no control URL or app binding. Adapter egress is still denied.
17
+ const header = 'x-rer-conformance-fixture', urlHeader = 'x-rer-conformance-url', entry = join(source.root, '__rer_network_entry__.mjs');
18
+ if (source.modules.some(module => module.path === entry)) throw new Error('Reserved network entry');
19
+ const wrapper = { type: 'ESModule', path: entry, contents: `import adapter from ${JSON.stringify('./' + relative(source.root, source.modules[0].path))};
20
+ export default { async fetch(request, env) {
21
+ const encoded = request.headers.get(${JSON.stringify(header)});
22
+ const fixture = encoded ? JSON.parse(new TextDecoder().decode(Uint8Array.from(atob(encoded), char => char.charCodeAt(0)))) : null;
23
+ const url = new URL(request.headers.get(${JSON.stringify(urlHeader)}));
24
+ const headers = new Headers(request.headers); headers.delete(${JSON.stringify(header)}); headers.delete(${JSON.stringify(urlHeader)}); headers.set('host', url.host);
25
+ return adapter.fetch(new Request(url, { method: request.method, headers, redirect: 'manual', ...(!['GET','HEAD'].includes(request.method) ? { body: request.body } : {}) }), { fixture, secrets: env.secrets });
26
+ } };` };
27
+ const options = { host: '127.0.0.1', port: 0, cf: false, unsafeLocalExplorer: false,
28
+ modules: [wrapper, ...source.modules], modulesRoot: source.root, compatibilityDate: '2026-09-01', compatibilityFlags: [],
29
+ bindings: {}, outboundService: deny,
30
+ };
31
+ mf = new Miniflare(convertV4MiniflareOptions(options));
32
+ let loopback = await mf.ready;
33
+ return { fetch: (request, fixture) => {
34
+ const headers = new Headers(request.headers);
35
+ headers.set(header, Buffer.from(JSON.stringify(fixture ?? null)).toString('base64'));
36
+ headers.set(urlHeader, request.url);
37
+ return fetch(loopback, { method: request.method, headers: Object.fromEntries(headers), body: request.body, duplex: 'half', redirect: 'manual' });
38
+ }, provision: async secrets => {
39
+ await mf.setOptions(convertV4MiniflareOptions({ ...options, bindings: { secrets } }));
40
+ loopback = await mf.ready;
41
+ }, close: () => mf.dispose() };
42
+ } catch {
43
+ if (mf) await mf.dispose();
44
+ throw new NetworkAdapterError('Agent conformance network: the adapter could not start in isolated workerd. Check the seed\'s installed wrangler and use Worker-compatible ES modules with a default fetch export; Node APIs and runtime bindings are unavailable.');
45
+ }
46
+ }
@@ -0,0 +1,75 @@
1
+ import { isDeepStrictEqual } from 'node:util';
2
+ import { autonomousPolicy } from './crypto.mjs';
3
+ import { errorCode } from './protocol.mjs';
4
+
5
+ export async function unsetPolicy(c, initial = false) {
6
+ const listed = await c.mcp('tools/list');
7
+ c.add(`BASE-AGENT-007.2.${initial ? 'initial' : 'removed'}.list`, isDeepStrictEqual(listed.result?.tools, []), 'An unanswered door must list no tools.');
8
+ if (initial) {
9
+ const inventory = await c.personJson('/agents/api/agents');
10
+ const sponsor = inventory.agents?.find(agent => agent.id === c.agentId)?.sponsor;
11
+ c.add('BASE-AGENT-004.6.sponsor', typeof sponsor?.id === 'string' && sponsor.id.length > 0, 'The native person agents inventory must identify the authenticated agent sponsor.');
12
+ if (!sponsor?.id) throw new Error('Cannot resolve native sponsor ID from the person agents door');
13
+ c.sponsor.id = sponsor.id;
14
+ }
15
+ for (const step of c.surface.journey) {
16
+ // No prior result exists here; unresolved references cannot identify native
17
+ // records. Resolvable calls still retain their computed classification.
18
+ const answer = await c.tool(step.tool, c.args(step, new Map(), { unresolved: true }));
19
+ c.add(`BASE-AGENT-007.2.${initial ? 'initial' : 'removed'}.${step.id}`, errorCode(answer) === 'policy_unset', `${step.tool} must refuse with policy_unset before setup.`);
20
+ }
21
+ }
22
+ export async function removalPhase(c) {
23
+ await c.adopt(autonomousPolicy());
24
+ const before = await c.witness();
25
+ await c.adopt(null);
26
+ await unsetPolicy(c);
27
+ await c.adopt(autonomousPolicy());
28
+ c.add('BASE-AGENT-007.2.unset-no-effect', isDeepStrictEqual(before, await c.witness()), 'Calls under the removed policy changed native state.');
29
+ }
30
+ export async function blockedPhases(c) {
31
+ const nonstandard = [...new Set(c.surface.tools.flatMap(tool => tool.classes))].filter(cls => cls !== 'standard');
32
+ for (const cls of nonstandard) {
33
+ await c.adopt(autonomousPolicy());
34
+ const outputs = new Map();
35
+ for (const step of c.surface.journey) {
36
+ const args = c.args(step, outputs);
37
+ if (step.expect.some(item => item.class === cls)) {
38
+ const policy = autonomousPolicy(); policy.rules.push({ id: `block-${cls}`, class: cls, do: 'blocked' });
39
+ await c.adopt(policy);
40
+ const before = await c.witness(), refused = await c.tool(step.tool, args), after = await c.witness();
41
+ c.add(`BASE-AGENT-007.1.blocked.${cls}.${step.id}`, errorCode(refused) === 'policy_blocked' && refused.decision?.disposition === 'blocked' && refused.decision.revision === c.revision && refused.decision.classes.some(item => item.class === cls && item.do === 'blocked'), `${step.tool} must be blocked by ${cls}.`);
42
+ c.add(`BASE-AGENT-007.1.blocked-no-effect.${cls}.${step.id}`, isDeepStrictEqual(before, after), `${step.tool} changed native state while ${cls} was blocked.`);
43
+ await c.adopt(autonomousPolicy());
44
+ }
45
+ const completed = await c.tool(step.tool, args, await c.proof(step.tool, args));
46
+ if (completed.result?.isError || completed.result?.structuredContent === undefined) throw new Error(`Could not prepare ${step.id} for the ${cls} blocked variant (${errorCode(completed) ?? completed.status})`);
47
+ outputs.set(step.id, completed.result.structuredContent);
48
+ }
49
+ }
50
+ }
51
+ export async function pausePhase(c) {
52
+ await c.adopt(autonomousPolicy());
53
+ const before = await c.witness();
54
+ await c.adopt(autonomousPolicy(), { paused: true });
55
+ for (const tool of c.surface.tools) {
56
+ const step = c.surface.journey.find(item => item.tool === tool.name);
57
+ const paused = await c.tool(tool.name, c.args(step, new Map(), { unresolved: true }));
58
+ c.add(`BASE-AGENT-011.6.pause.${tool.name}`, errorCode(paused) === 'agents_paused', `${tool.name} ran while Business Pause was set.`);
59
+ }
60
+ const state = await c.personJson('/agents/api/state');
61
+ c.add('BASE-AGENT-011.6.person', state.paused?.business === true, 'The signed-in person must still read paused state.');
62
+ await c.adopt(autonomousPolicy());
63
+ c.add('BASE-AGENT-011.6.resume', isDeepStrictEqual(before, await c.witness()), 'Pause calls changed native state, or resume did not restore access.');
64
+ }
65
+
66
+ export async function consentRevocationPhase(c) {
67
+ await c.adopt(autonomousPolicy());
68
+ const before = await c.witness();
69
+ await c.adopt(autonomousPolicy(), { revoked: { agents: [], consents: [c.consent] } });
70
+ const step = c.surface.journey[0];
71
+ const refused = await c.tool(step.tool, c.args(step, new Map(), { unresolved: true }));
72
+ c.add('BASE-AGENT-004.consent-revoked', refused.status === 401, 'A revoked originating consent must refuse the next authenticated call.');
73
+ await c.adopt(autonomousPolicy());
74
+ c.add('BASE-AGENT-004.consent-no-effect', isDeepStrictEqual(before, await c.witness()), 'A call under revoked consent changed native state.');
75
+ }