imprint-mcp 0.6.5 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/README.md +278 -16
  3. package/package.json +2 -2
  4. package/prompts/audit-agent.md +28 -7
  5. package/prompts/auth-compile-agent.md +65 -7
  6. package/prompts/build-planning.md +3 -3
  7. package/prompts/compile-agent.md +922 -183
  8. package/prompts/live-verifier-agent.md +25 -8
  9. package/prompts/master-teach-api-researcher.md +813 -0
  10. package/prompts/master-teach-baseline-mvp-review.md +217 -0
  11. package/prompts/master-teach-completion-review.md +188 -0
  12. package/prompts/master-teach-decision.md +885 -0
  13. package/prompts/master-teach-focused-planner.md +764 -0
  14. package/prompts/master-teach-parameter-advisor.md +58 -0
  15. package/prompts/master-teach-recording-evidence.md +19 -0
  16. package/prompts/master-teach-refine-plan.md +7 -0
  17. package/prompts/master-teach-tool-advisor.md +130 -0
  18. package/prompts/playbook-compilation.md +45 -54
  19. package/prompts/prereq-builder.md +28 -6
  20. package/prompts/prereq-planner.md +2 -2
  21. package/prompts/request-triage.md +51 -9
  22. package/prompts/tool-candidate-detection.md +75 -38
  23. package/prompts/tool-planning.md +3 -3
  24. package/src/cli.ts +197 -151
  25. package/src/imprint/agent.ts +47 -33
  26. package/src/imprint/api-research-agent.ts +933 -0
  27. package/src/imprint/audit.ts +72 -7
  28. package/src/imprint/auth-compile-agent.ts +136 -62
  29. package/src/imprint/auth-compile-tools.ts +99 -18
  30. package/src/imprint/auth-verifier.ts +10 -20
  31. package/src/imprint/backend-ladder.ts +517 -365
  32. package/src/imprint/body-structure.ts +656 -0
  33. package/src/imprint/build-plan.ts +54 -323
  34. package/src/imprint/cdp-browser-fetch.ts +734 -29
  35. package/src/imprint/cdp-jar-cache.ts +7 -12
  36. package/src/imprint/claude-cli-compile.ts +283 -321
  37. package/src/imprint/codex-cli-compile.ts +482 -350
  38. package/src/imprint/codex-sdk-turn.ts +102 -0
  39. package/src/imprint/compile-agent-types.ts +49 -10
  40. package/src/imprint/compile-agent.ts +222 -266
  41. package/src/imprint/compile-done-sentinel.ts +211 -0
  42. package/src/imprint/compile-provider-control.ts +401 -0
  43. package/src/imprint/compile-provider-recovery.ts +142 -0
  44. package/src/imprint/compile-strategy.ts +5 -0
  45. package/src/imprint/compile-tools.ts +1901 -3020
  46. package/src/imprint/compile-verification.ts +20 -3
  47. package/src/imprint/compile.ts +391 -84
  48. package/src/imprint/compiler-log.ts +12 -0
  49. package/src/imprint/compiler-process.ts +440 -0
  50. package/src/imprint/concurrency.ts +43 -58
  51. package/src/imprint/credential-extract.ts +1 -88
  52. package/src/imprint/effects.ts +9 -0
  53. package/src/imprint/emit.ts +18 -2
  54. package/src/imprint/evidence-inspection.ts +55 -0
  55. package/src/imprint/freeform-redact.ts +34 -234
  56. package/src/imprint/import-module-fresh.ts +30 -0
  57. package/src/imprint/live-finesse-runner.ts +299 -0
  58. package/src/imprint/live-verifier.ts +726 -364
  59. package/src/imprint/llm.ts +466 -422
  60. package/src/imprint/log.ts +1 -9
  61. package/src/imprint/login.ts +30 -12
  62. package/src/imprint/master-teach-agent-contracts.ts +875 -0
  63. package/src/imprint/master-teach-agents.ts +2850 -0
  64. package/src/imprint/master-teach-checks.ts +341 -0
  65. package/src/imprint/master-teach-controller.ts +7159 -0
  66. package/src/imprint/master-teach-plan.ts +1410 -0
  67. package/src/imprint/master-teach-prompt-projections.ts +347 -0
  68. package/src/imprint/master-teach-store.ts +961 -0
  69. package/src/imprint/mcp-cdp-sessions.ts +60 -0
  70. package/src/imprint/mcp-compile-server.ts +564 -662
  71. package/src/imprint/mcp-live-verifier-server.ts +267 -178
  72. package/src/imprint/mcp-server.ts +46 -57
  73. package/src/imprint/native-agent-pass.ts +260 -0
  74. package/src/imprint/native-agent-usage.ts +141 -0
  75. package/src/imprint/native-teach-agents.ts +495 -0
  76. package/src/imprint/param-grounding.ts +488 -347
  77. package/src/imprint/playbook-runner.ts +254 -63
  78. package/src/imprint/prereq-builder.ts +55 -543
  79. package/src/imprint/private-file.ts +18 -0
  80. package/src/imprint/probe-backends.ts +135 -33
  81. package/src/imprint/provider-retry.ts +501 -0
  82. package/src/imprint/provider-terminal.ts +214 -0
  83. package/src/imprint/recording-request.ts +297 -3
  84. package/src/imprint/recording-verification.ts +444 -0
  85. package/src/imprint/redact.ts +33 -749
  86. package/src/imprint/refine-worker.ts +326 -0
  87. package/src/imprint/refine.ts +241 -0
  88. package/src/imprint/replay-capture.ts +85 -37
  89. package/src/imprint/replay-evidence.ts +1007 -0
  90. package/src/imprint/request-capture.ts +14 -0
  91. package/src/imprint/research-response-evidence.ts +45 -0
  92. package/src/imprint/runtime.ts +616 -128
  93. package/src/imprint/sensitive-keys.ts +0 -6
  94. package/src/imprint/session-merge.ts +103 -7
  95. package/src/imprint/stealth-fetch.ts +25 -8
  96. package/src/imprint/stealth-token-cache.ts +16 -16
  97. package/src/imprint/teach-plan.ts +0 -242
  98. package/src/imprint/teach-research-memory.ts +229 -0
  99. package/src/imprint/teach-state.ts +47 -626
  100. package/src/imprint/teach.ts +12 -3477
  101. package/src/imprint/tool-candidates.ts +75 -210
  102. package/src/imprint/tool-loader.ts +3 -0
  103. package/src/imprint/tool-plan.ts +3 -134
  104. package/src/imprint/tracing.ts +24 -7
  105. package/src/imprint/triage-selection.ts +44 -0
  106. package/src/imprint/types.ts +107 -7
  107. package/src/imprint/endpoint-key.ts +0 -23
@@ -9,9 +9,16 @@ tool-level input parameters, parsed ToolResult, backend, and attempt metadata.
9
9
  Treat those parsed outputs as the primary evidence. Suite and call labels are for
10
10
  navigation only; do not manufacture or cite evidence IDs.
11
11
 
12
- You also receive read-only artifact context: the generated workflow, parser,
13
- parser tests, integration suite, current playbook when one exists, and this
14
- tool's build-plan contract. Use it to interpret live results and catch concrete
12
+ You also receive read-only artifact context: the generated workflow, request
13
+ transform and its tests when one exists, parser, parser tests, integration
14
+ suite, current playbook when one exists, and this tool's build-plan contract.
15
+ Workflow request bodies are templates. When `requestTransformModule` exists, the
16
+ transform can replace the final outgoing URL, headers, or body. Never infer the
17
+ emitted request bytes from the workflow template alone: inspect the transform
18
+ and its tests, then use backend-preparation `requestStageFacts` as factual
19
+ execution receipts. A passed send stage proves that request reached transport;
20
+ a later transform failure does not mean earlier requests used their templates.
21
+ Use this context to interpret live results and catch concrete
15
22
  contradictions such as a producer/consumer type mismatch, a required recorded
16
23
  header omitted from the workflow, a synthetic-only positive parser test, or an
17
24
  integration suite that cannot construct its producer inputs. Artifact context
@@ -20,9 +27,19 @@ is `changes_required` even when infrastructure prevents the live suite from
20
27
  starting. Do not label a report infrastructure-only inconclusive when the
21
28
  supplied artifacts already explain the failure.
22
29
 
23
- You have four tools:
30
+ You have five tools:
24
31
 
25
- 1. `prepare_live_backend` checks whether the workflow already has a valid backend
32
+ 1. `refresh_auth_session` re-runs the site's generated authentication tool. Use
33
+ it only after actual live evidence says the stored session is expired,
34
+ invalid, or unauthenticated. Set `cleanSession: true` only when rejected state
35
+ must be withheld; this clears browser state and auth-produced durable values
36
+ while retaining provisioned login credentials. You have one stateful refresh
37
+ session. Omit `action` on its first call. The result may name `nextAction`;
38
+ inspect its message and call again with exactly that action and any parameters
39
+ declared by the compiled auth flow. You decide whether and how to continue;
40
+ the runtime does not auto-follow the action graph. Never invent unavailable
41
+ human input. After success, prepare the backend again and run the suite.
42
+ 2. `prepare_live_backend` checks whether the workflow already has a valid backend
26
43
  preference. Supply realistic complete parameters. A valid cache is reused
27
44
  without live probing, including across compiler revisions. A missing or invalid
28
45
  preference runs the existing backend probe. Call it with `forceReprobe: true`
@@ -32,16 +49,16 @@ You have four tools:
32
49
  Preparation can legitimately take several minutes. Wait for its completed
33
50
  tool result; never infer timeout from elapsed wall time or start a duplicate
34
51
  preparation while one is still running.
35
- 2. `run_live_integration_suite` runs the compiler-proposed final live suite. You
52
+ 3. `run_live_integration_suite` runs the compiler-proposed final live suite. You
36
53
  own this execution and must inspect both its test outcome and every captured
37
54
  parsed output. Run it after backend preparation. A justified rerun is allowed
38
55
  after failure, timeout, or successful reprobe; explain why in `reason`.
39
- 3. `run_live_integration_test` makes a targeted live call for a specific unresolved
56
+ 4. `run_live_integration_test` makes a targeted live call for a specific unresolved
40
57
  semantic question. Explain the question in `reason` and choose discriminating
41
58
  parameters. You may make as many useful calls as the shared deadline permits.
42
59
  Repeating parameters is valid when testing after a reprobe or confirming an
43
60
  unstable result, but say why.
44
- 4. `submit_verification_report` submits your structured final judgment. Call it
61
+ 5. `submit_verification_report` submits your structured final judgment. Call it
45
62
  exactly once when you have enough evidence.
46
63
 
47
64
  Probe time has a separate infrastructure budget. Do not treat a successful or