tenjin-cli 0.1.0-alpha.18 → 0.1.0-alpha.19
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.
- package/README.md +151 -40
- package/dist/{_esm-CE7KNONL.js → _esm-OVVGTKHH.js} +4 -4
- package/dist/{chunk-WUHY2AXD.js → chunk-2SQEFBAM.js} +4 -3
- package/dist/{chunk-FGR734LZ.js → chunk-3VYGDRRL.js} +5 -5
- package/dist/{chunk-PDA2BVFY.js → chunk-5DOHKQ24.js} +4 -15
- package/dist/chunk-5DOHKQ24.js.map +1 -0
- package/dist/{chunk-N35E6CM2.js → chunk-6DCELMQA.js} +6 -6
- package/dist/{chunk-WXC57XGG.js → chunk-A36LQPHV.js} +1 -1
- package/dist/chunk-A36LQPHV.js.map +1 -0
- package/dist/{chunk-BTX2QE2Y.js → chunk-A6CY6BUW.js} +3 -3
- package/dist/{chunk-TP4D47BY.js → chunk-AISBL7EY.js} +3 -3
- package/dist/{chunk-ON6C6WOX.js → chunk-AMG4SONW.js} +138 -58
- package/dist/chunk-AMG4SONW.js.map +1 -0
- package/dist/{chunk-AUKDYPPX.js → chunk-BG2EXNAA.js} +7 -6
- package/dist/chunk-BG2EXNAA.js.map +1 -0
- package/dist/{chunk-F3FUGWPZ.js → chunk-FHBGTOFA.js} +121 -40
- package/dist/chunk-FHBGTOFA.js.map +1 -0
- package/dist/{chunk-HPWO4O6S.js → chunk-FPUPBQHX.js} +2 -2
- package/dist/{chunk-3AUDA53C.js → chunk-KTAW4KGH.js} +6 -5
- package/dist/{chunk-J5INH7WB.js → chunk-LSWVVSFX.js} +106 -5
- package/dist/chunk-LSWVVSFX.js.map +1 -0
- package/dist/chunk-O2JYBOUO.js +47 -0
- package/dist/chunk-O2JYBOUO.js.map +1 -0
- package/dist/{chunk-NRQMOVKM.js → chunk-PZQRSZJV.js} +2 -2
- package/dist/{chunk-NRQMOVKM.js.map → chunk-PZQRSZJV.js.map} +1 -1
- package/dist/{chunk-N44H5TFB.js → chunk-SCAOYGKX.js} +315 -71
- package/dist/chunk-SCAOYGKX.js.map +1 -0
- package/dist/{chunk-35M3VITA.js → chunk-TDGN476R.js} +60 -7
- package/dist/chunk-TDGN476R.js.map +1 -0
- package/dist/{chunk-AR7U7BRG.js → chunk-UNV4K45L.js} +12 -18
- package/dist/{chunk-AR7U7BRG.js.map → chunk-UNV4K45L.js.map} +1 -1
- package/dist/{chunk-ZG7SFI34.js → chunk-VFVFVQM6.js} +4 -4
- package/dist/{chunk-EPCOMXLF.js → chunk-WUU3BH6G.js} +2 -2
- package/dist/{chunk-KUBEYXSO.js → chunk-XDADPAWW.js} +22 -22
- package/dist/{chunk-YPQSMIDH.js → chunk-XNP6VUAJ.js} +3 -3
- package/dist/{chunk-AWQPGIR6.js → chunk-Y66XUXVI.js} +5 -5
- package/dist/{chunk-TJMCBIZU.js → chunk-ZDKEU2GF.js} +2 -2
- package/dist/{chunk-WLMJE3GJ.js → chunk-ZTFIQC4C.js} +2 -2
- package/dist/{cli-MP3RAYHL.js → cli-456F77ZY.js} +33 -28
- package/dist/{cli-MP3RAYHL.js.map → cli-456F77ZY.js.map} +1 -1
- package/dist/{config-BJK6U5VY.js → config-BLUWOH6S.js} +9 -12
- package/dist/{doctor-KJROWE5V.js → doctor-PS45CR3T.js} +37 -29
- package/dist/{doctor-KJROWE5V.js.map → doctor-PS45CR3T.js.map} +1 -1
- package/dist/{fund-I5COXPEJ.js → fund-4SW2ZBWC.js} +17 -17
- package/dist/{hook-command-EJO2564A.js → hook-command-YTV7X333.js} +247 -24
- package/dist/hook-command-YTV7X333.js.map +1 -0
- package/dist/index.js +2 -2
- package/dist/{install-NUQLLHS2.js → install-U4BIDCHH.js} +14 -13
- package/dist/{install-wallet-JPFTEC6H.js → install-wallet-EYHELQMG.js} +14 -14
- package/dist/{mcp-I5XMVE64.js → mcp-AC4PIXH5.js} +30 -26
- package/dist/{mcp-I5XMVE64.js.map → mcp-AC4PIXH5.js.map} +1 -1
- package/dist/{pay-WA3JSCNB.js → pay-VJOP6TFT.js} +19 -19
- package/dist/{send-KVUH5WDO.js → send-YH75Z6LB.js} +14 -14
- package/dist/{status-FFC6FO72.js → status-5CHCDLUE.js} +24 -17
- package/dist/status-5CHCDLUE.js.map +1 -0
- package/dist/{status-line-SAXSU6CR.js → status-line-CZAZUOAY.js} +6 -6
- package/dist/{status-line-wiring-DQZCWIUO.js → status-line-wiring-2ABDVXSJ.js} +4 -4
- package/dist/tenjin-daemon.mjs +3 -14
- package/dist/{uninstall-SWICHBTF.js → uninstall-BYVGAQMO.js} +13 -15
- package/dist/{uninstall-SWICHBTF.js.map → uninstall-BYVGAQMO.js.map} +1 -1
- package/dist/{update-W572AMXG.js → update-7QJDSHST.js} +5 -5
- package/dist/{viemAdapter-By13KInL-X2VY6CY3.js → viemAdapter-By13KInL-N2GIVMZ7.js} +2 -2
- package/dist/{wallet-L2YLAJFN.js → wallet-YZOXIXBC.js} +14 -14
- package/docs/agent-permissions.md +29 -13
- package/docs/safety-model.md +7 -1
- package/package.json +1 -1
- package/dist/chunk-35M3VITA.js.map +0 -1
- package/dist/chunk-AUKDYPPX.js.map +0 -1
- package/dist/chunk-F3FUGWPZ.js.map +0 -1
- package/dist/chunk-J5INH7WB.js.map +0 -1
- package/dist/chunk-N44H5TFB.js.map +0 -1
- package/dist/chunk-ON6C6WOX.js.map +0 -1
- package/dist/chunk-PDA2BVFY.js.map +0 -1
- package/dist/chunk-U2DZISAH.js +0 -111
- package/dist/chunk-U2DZISAH.js.map +0 -1
- package/dist/chunk-WS4JA6TC.js +0 -137
- package/dist/chunk-WS4JA6TC.js.map +0 -1
- package/dist/chunk-WXC57XGG.js.map +0 -1
- package/dist/hook-command-EJO2564A.js.map +0 -1
- package/dist/skill-placement-JMDPSKE6.js +0 -299
- package/dist/skill-placement-JMDPSKE6.js.map +0 -1
- package/dist/status-FFC6FO72.js.map +0 -1
- /package/dist/{_esm-CE7KNONL.js.map → _esm-OVVGTKHH.js.map} +0 -0
- /package/dist/{chunk-WUHY2AXD.js.map → chunk-2SQEFBAM.js.map} +0 -0
- /package/dist/{chunk-FGR734LZ.js.map → chunk-3VYGDRRL.js.map} +0 -0
- /package/dist/{chunk-N35E6CM2.js.map → chunk-6DCELMQA.js.map} +0 -0
- /package/dist/{chunk-BTX2QE2Y.js.map → chunk-A6CY6BUW.js.map} +0 -0
- /package/dist/{chunk-TP4D47BY.js.map → chunk-AISBL7EY.js.map} +0 -0
- /package/dist/{chunk-HPWO4O6S.js.map → chunk-FPUPBQHX.js.map} +0 -0
- /package/dist/{chunk-3AUDA53C.js.map → chunk-KTAW4KGH.js.map} +0 -0
- /package/dist/{chunk-ZG7SFI34.js.map → chunk-VFVFVQM6.js.map} +0 -0
- /package/dist/{chunk-EPCOMXLF.js.map → chunk-WUU3BH6G.js.map} +0 -0
- /package/dist/{chunk-KUBEYXSO.js.map → chunk-XDADPAWW.js.map} +0 -0
- /package/dist/{chunk-YPQSMIDH.js.map → chunk-XNP6VUAJ.js.map} +0 -0
- /package/dist/{chunk-AWQPGIR6.js.map → chunk-Y66XUXVI.js.map} +0 -0
- /package/dist/{chunk-TJMCBIZU.js.map → chunk-ZDKEU2GF.js.map} +0 -0
- /package/dist/{chunk-WLMJE3GJ.js.map → chunk-ZTFIQC4C.js.map} +0 -0
- /package/dist/{config-BJK6U5VY.js.map → config-BLUWOH6S.js.map} +0 -0
- /package/dist/{fund-I5COXPEJ.js.map → fund-4SW2ZBWC.js.map} +0 -0
- /package/dist/{install-NUQLLHS2.js.map → install-U4BIDCHH.js.map} +0 -0
- /package/dist/{install-wallet-JPFTEC6H.js.map → install-wallet-EYHELQMG.js.map} +0 -0
- /package/dist/{pay-WA3JSCNB.js.map → pay-VJOP6TFT.js.map} +0 -0
- /package/dist/{send-KVUH5WDO.js.map → send-YH75Z6LB.js.map} +0 -0
- /package/dist/{status-line-SAXSU6CR.js.map → status-line-CZAZUOAY.js.map} +0 -0
- /package/dist/{status-line-wiring-DQZCWIUO.js.map → status-line-wiring-2ABDVXSJ.js.map} +0 -0
- /package/dist/{update-W572AMXG.js.map → update-7QJDSHST.js.map} +0 -0
- /package/dist/{viemAdapter-By13KInL-X2VY6CY3.js.map → viemAdapter-By13KInL-N2GIVMZ7.js.map} +0 -0
- /package/dist/{wallet-L2YLAJFN.js.map → wallet-YZOXIXBC.js.map} +0 -0
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/lib/permissions.ts"],"sourcesContent":["/**\n * The recommended HARNESS permission allowlist: the exact rule lines an operator\n * pastes into Claude Code (or an equivalent harness) so auto mode stops denying\n * the free Tenjin verbs, and so the one paying verb is cleared deliberately\n * rather than by accident.\n *\n * This is a HARNESS-side allowlist (which shell commands the agent may run at\n * all). It is NOT the CLI's spend policy and shares nothing with it: the shipped\n * `allowlistCreators` config key gates WHO you may pay, this file gates WHICH\n * COMMANDS the harness will run without a prompt. The two are deliberately kept\n * apart in name and in code — clearing `Bash(tenjin buy:*)` here never raises a\n * spend cap. That is a claim about this file, NOT a claim that the spend policy\n * stops an allowlisted `buy`: `--yes` is an ordinary flag on an allowlisted verb\n * and `confirmSpend` returns true on it before any TTY check\n * (src/commands/buy.ts), so under CONFIG_DEFAULTS nothing denies. See\n * OPT_IN_ALLOWLIST's note for the walk-through.\n *\n * These are static, shipped constants on purpose: there is NO config key for\n * them. An operator-editable \"which commands may run\" list stored next to the\n * spend policy would be a second, weaker copy of a control the harness already\n * owns, and a CLI that could widen its own permission grant is exactly the shape\n * this file exists to avoid.\n *\n * Scope: `tenjin mcp` exposes the same command cores over MCP, where the harness\n * gates TOOLS, not Bash lines. These rules say nothing about that surface, which\n * is why `tenjin mcp` is itself never recommended here: clearing it would route\n * around every rule below. MCP_CAVEAT names the tools to leave gated for an\n * operator who runs the server anyway.\n *\n * LIMIT OF A PREFIX RULE, read this before adding an entry: the rule constrains\n * the VERB and nothing else. `addGlobalFlags` (src/cli.ts) puts `--json`,\n * `--timeout`, and `--base-url` on every leaf command, so every rule below also\n * clears `--base-url <url>` in trailing position. `--base-url` is validated as a\n * URL and nothing more, and it wins settings precedence, so it re-points the\n * trust boundary itself: the `search` question goes to that host, `doctor` probes\n * it, and `assertOnBaseOrigin` only checks that a resource URL shares an origin\n * with the CONFIGURED base, so an attacker-controlled pair satisfies the pin. No\n * prefix syntax expresses \"this verb but not that flag\", so the mitigation is\n * disclosure rather than a narrower rule: FLAG_CAVEAT rides the `--json` payload\n * and docs/agent-permissions.md, every human surface points at that page, and the\n * skills tell the agent never to pass `--base-url` on an allowlisted verb. Pinning\n * the paying path to a constant origin instead is the real fix and is an\n * x402/payments-semantics change, tracked separately.\n */\n\nimport type { PublishMode } from './config';\n\n/** One pasteable allowlist rule plus why it is safe (or what it costs). */\nexport interface AllowlistEntry {\n /** The exact line to add to the harness permission allowlist. */\n rule: string;\n /** The verb it clears. */\n command: string;\n /** Why it is safe to pre-clear, or what the operator is opting into. */\n note: string;\n}\n\n/** A verb deliberately kept OUT of the recommended allowlist, and why. */\nexport interface ExcludedVerb {\n command: string;\n reason: string;\n}\n\n/**\n * FREE verbs: they CANNOT SPEND. That is the whole definition of this tier, and\n * it is deliberately narrower than the older \"no wallet, no signing, no\n * payment\" — which stopped being true the moment `read` gained the ability to\n * recover an owned piece. `read` signs, with a P-256 delegation, and mints one\n * with a wallet signature when none is live; what it cannot do is produce the\n * secp256k1/EIP-712 signature a payment authorization needs (wrong curve), which\n * is test-pinned by its import graph never reaching the payment module. Money\n * stays out of reach; a signature, and the keystore access behind minting one,\n * no longer do, so the tier says what it means. `doctor` decrypts locally to\n * check the wallet still opens.\n *\n * What the tier does NOT claim, because it is not true: that the read scope\n * limits what a leaked delegation is worth. Scope is enforced only on the request\n * shape that carries both a session signature and the delegation header; the same\n * delegation replayed as a plain `SIGN-IN-WITH-X` takes a different server path\n * where no scope logic runs. So a session file is a wallet-derived credential\n * with the authority of the wallet behind it, and the mitigations that actually\n * hold are the ones in this repo: it is 0600, short-lived (≤24h, server-clamped),\n * bound to the origin it was minted for, and never presented off that origin.\n * Treat \"read is allowlisted\" as \"read may transmit that credential to the\n * configured origin\", and see FLAG_CAVEAT for why the configured origin is not\n * automatically the one you configured.\n *\n * Not all of them are read-only, and the difference is disclosed rather than\n * papered over — `search` POSTs the (generalized, anonymous) question off-machine\n * and records it locally, `outcome` POSTs a report that moves the marketplace's\n * reuse signal (both unauthenticated remote writes), and `read` writes locally,\n * saving a delivered piece to the library, and `doctor` decrypts the keystore\n * locally to check it opens. Pre-clearing them is defensible because they cost\n * nothing and none of it leaves the machine; calling them read-only to justify it\n * would not be.\n *\n * Rules are PREFIX rules: `Bash(tenjin search:*)` clears commands that start with\n * `tenjin search` and nothing else. The narrow `wallet show` / `wallet balance` /\n * The `config get` form is deliberate: a `Bash(tenjin wallet:*)`\n * or `Bash(tenjin config:*)` rule would silently swallow `wallet create` and\n * `config set`, and `config set` can raise the spend caps.\n *\n * Two known gaps, both fail-closed (denied, never wrongly allowed):\n * - Bare `tenjin config` (runConfigList) is as read-only as `config get`, but no\n * prefix rule reaches it without also covering `config set`, so it stays out.\n * Use `tenjin config get <key>`, which is a different supported command rather\n * than a reworded one.\n * - Group-level flag forms like `tenjin wallet --json show` are not covered.\n * Put global flags AFTER the leaf verb (`tenjin wallet show --json`); the\n * CLI parses either, and only the trailing form matches these rules.\n */\nexport const ALWAYS_SAFE_ALLOWLIST: readonly AllowlistEntry[] = [\n {\n rule: 'Bash(tenjin search:*)',\n command: 'tenjin search',\n note:\n 'Free anonymous marketplace search. No wallet, no signing, no payment. ' +\n 'Not read-only: it POSTs the generalized question off-machine and records ' +\n 'the search locally.',\n },\n {\n rule: 'Bash(tenjin wallet fund:*)',\n command: 'tenjin wallet fund',\n note:\n 'Owner call (2026-08-12): free on both surfaces, because the command just opens the ' +\n 'fund modal. Minting moves no money: the destination is server-pinned to the wallet ' +\n 'that signed, the CLI refuses any checkout host but pay.coinbase.com, and payment ' +\n 'happens behind Coinbase\\u2019s own human gate. The usual --base-url caveat does not ' +\n 'apply: fund is pinned to the production origin and takes no override from flag, ' +\n 'env, or config.',\n },\n {\n rule: 'Bash(tenjin inspect:*)',\n command: 'tenjin inspect',\n note: 'Free pre-purchase card and preview. Never signs, never pays, never saves.',\n },\n {\n rule: 'Bash(tenjin read:*)',\n command: 'tenjin read',\n note:\n 'Free-only delivery: free pieces, local-library re-reads, and pieces this ' +\n 'wallet already owns. Cannot spend: the payment module is absent from its ' +\n 'import graph, and the key it signs with is a P-256 delegation, the wrong ' +\n 'curve to authorize a payment. OPENS THE KEYSTORE (one wallet signature) ' +\n 'when an owned piece is not on this machine and no session key is live, ' +\n 'minting the same ≤24h read-scoped delegation `publish` and `edit` mint; ' +\n 'every later owned read reuses it and asks for nothing. TRANSMITS A ' +\n 'CREDENTIAL: that wallet-derived delegation goes to the server on a cold ' +\n '402. It is minted and presented only for the origin of the piece being ' +\n 'read, and never for a second origin while one for another is cached, ' +\n 'which is what bounds a stray `--base-url`; no scope on it limits what a ' +\n 'holder could do with it. Not read-only: a freshly delivered piece is ' +\n 'saved to the library.',\n },\n {\n rule: 'Bash(tenjin outcome:*)',\n command: 'tenjin outcome',\n note:\n 'Free honest outcome report on a past search. No wallet, no payment. ' +\n 'Not read-only: it POSTs a report that moves the marketplace reuse signal.',\n },\n {\n rule: 'Bash(tenjin doctor:*)',\n command: 'tenjin doctor',\n note:\n 'Local environment and API reachability diagnostics. Decrypts the wallet ' +\n 'locally to check it still opens; signs nothing and sends nothing.',\n },\n {\n rule: 'Bash(tenjin wallet show:*)',\n command: 'tenjin wallet show',\n note: 'Prints the wallet address and key source. Never prints the key.',\n },\n {\n rule: 'Bash(tenjin wallet balance:*)',\n command: 'tenjin wallet balance',\n note: 'Read-only USDC balance query on Base.',\n },\n {\n rule: 'Bash(tenjin config get:*)',\n command: 'tenjin config get',\n note:\n 'Reads one effective config value. `config set` is excluded on purpose. ' +\n 'Note `config get rpcUrl` returns your RPC URL, which commonly embeds a ' +\n 'provider API key: no wallet secret, but a credential-adjacent read.',\n },\n];\n\n/**\n * The verbs offered as EXPLICIT opt-in lines rather than shipped in the safe set:\n * the one that spends, and the one that opens the keystore.\n *\n * Read the buy note carefully before pasting the line: on the DEFAULT config this\n * rule authorizes unattended spending up to the wallet balance. Walking\n * evaluateSpendPolicy (lib/policy.ts) against CONFIG_DEFAULTS with an agent that\n * passes `--yes` (which this repo's own skill snippet offers):\n * - `maxPriceAtomic` is unset unless the agent chooses to pass `--max-price`;\n * - `allowlistCreators` is empty, so the creator gate is off;\n * - `sessionBudget` is '0', which `if (policy.sessionBudgetAtomic > 0n)` reads\n * as DISABLED, not as a zero ceiling;\n * - `maxAutoSpend` '0' and `confirm` 'always' both land on `confirm`, and\n * `confirmSpend` returns true on `--yes` before any TTY check.\n * Nothing denies. Note the asymmetry that makes the pair read safer than it is:\n * `maxAutoSpend: '0'` means \"auto-approve nothing\" while `sessionBudget: '0'`\n * means \"no ceiling at all\".\n */\nexport const OPT_IN_ALLOWLIST: readonly AllowlistEntry[] = [\n {\n rule: 'Bash(tenjin buy:*)',\n command: 'tenjin buy',\n note:\n 'SPENDS USDC on Base, unrefundably. This authorizes UNATTENDED purchases: ' +\n '`--yes` is an ordinary flag on the same allowlisted verb and it clears the ' +\n 'confirm gate, so on the default config nothing stops a spend up to your ' +\n 'wallet balance. Set a real ceiling first with ' +\n '`tenjin config set maxAutoSpend <usd>` and ' +\n '`tenjin config set sessionBudget <usd>` (sessionBudget 0 means NO ceiling, ' +\n 'not a zero one). This line never raises a spend cap by itself, but do not ' +\n 'read that as a human being on every purchase. Fund small.',\n },\n {\n rule: 'Bash(tenjin pay:*)',\n command: 'tenjin pay',\n note:\n 'SPENDS USDC on Base, unrefundably, at ANY x402 endpoint the origin gate ' +\n 'allows: the configured base URL always, and with `bazaarPay` on, ' +\n 'registry-listed foreign sellers too. The same spend policy and `--yes` ' +\n 'caveat as the buy line apply, and unlike `buy` there is no library ' +\n 'dedupe: a looping agent pays on every call. Set maxAutoSpend and ' +\n 'sessionBudget first, and leave `bazaarPay` off unless you mean it.',\n },\n];\n\n/**\n * The one rule that is neither always-safe nor a standing opt-in: it exists only\n * while `publish.mode` is `auto` or `full-auto`.\n *\n * The mode IS the consent. An operator who set auto has already said a clean\n * publish should proceed without asking; leaving the harness prompt in front of\n * it asks the same question a second time, in a place the mode cannot answer,\n * and the agent that hits it does the only safe thing and stops. That was the\n * observed failure: a session ran `tenjin config get publish.mode` mid-publish to\n * discover it had permission it had already been given (#161).\n *\n * NOT part of {@link recommendedRules}, and not a tier an operator picks from.\n * There is no line to paste and no flag that adds it: `install` writes it when\n * the mode it just settled is auto or full-auto, takes it back when the mode is\n * review, and `uninstall` reclaims it like every other rule this CLI wrote.\n */\nexport const PUBLISH_MODE_ALLOWLIST: readonly AllowlistEntry[] = [\n {\n rule: 'Bash(tenjin publish:*)',\n command: 'tenjin publish',\n note:\n 'PUBLISHES PUBLICLY under your identity, and is cleared only while publish.mode is ' +\n 'auto or full-auto: the mode is the consent, and the harness prompt would ask for it ' +\n 'twice. Three things it clears that the free tier never did. It OPENS THE KEYSTORE: ' +\n 'publish always resolves a signer, and with no usable session it mints one at ' +\n 'read+write scope, which is strictly broader than the read-only key `tenjin read` ' +\n 'mints to recover an owned piece. It publishes the contents ' +\n 'of ANY REGULAR LOCAL FILE the agent can read, gated only by the heuristic scan. And it is a ' +\n 'PREFIX rule, so it pins the verb and not the flags: `--base-url` rides it (see the ' +\n 'flag caveat), and `--yes` is an ordinary flag on the same verb that clears exactly ' +\n 'the WARN findings auto stopped on, so a re-run collapses auto into full-auto with ' +\n 'nobody asked. The local scan is warn-only now and every finding routes through the ' +\n 'same consent flow this mode already governs; what still refuses a publish outright is ' +\n 'the SERVER’s ingest gate (vendor tokens, private keys, seed phrases, DB passwords, ' +\n 'bearer headers), which no mode and no flag clears. The skills hold the rest of that ' +\n 'line. Set publish.mode back to review and the rule is retracted.',\n },\n {\n rule: 'Bash(tenjin edit:*)',\n command: 'tenjin edit',\n note:\n 'Updates posts your wallet ALREADY OWNS: reprices, refreshes an as-of date, repairs an ' +\n 'answer card, and flips status both ways, so it CAN PROMOTE A DRAFT TO PUBLISHED under ' +\n 'this same gate (promotion re-runs the block-tier secret scan over the stored body). ' +\n 'Owner-scoped on both legs (GET and PUT /api/posts/<id> are signed and owner-only), ' +\n 'spends nothing, moves no keys, and mints no new posts: a narrower blast radius than ' +\n 'the publish rule beside it, though promotion means existing drafts can go public. It ' +\n 'rides the same mode for the same reason: edit runs the identical publish.mode consent ' +\n 'gate in the CLI (lib/consent.ts needsConfirmation), so a mode that publishes ' +\n 'unattended and then cannot fix its own post\\u2019s price is the asymmetry the mode ' +\n 'exists to remove. It opens the keystore on the same terms as the publish rule beside ' +\n 'it, and takes the same prefix-rule caveats. Removed by the same return to review.',\n },\n];\n\n/** The mode-gated rules in effect for `mode`; empty on review. */\nexport function modeGatedAllowlist(mode: PublishMode): AllowlistEntry[] {\n return mode === 'review' ? [] : PUBLISH_MODE_ALLOWLIST.map((e) => ({ ...e }));\n}\n\n/**\n * Verbs that must NEVER appear in the recommended allowlist, with the reason each\n * one is a human decision. `tenjin wallet send` is the wallet escape hatch\n * (tenjin-agent #40) and heads this list: it moves USDC to an arbitrary address,\n * outside the spend policy that bounds `buy`. Naming it here is load-bearing even\n * in versions where the verb does not exist yet — the exclusion ships before the\n * verb does.\n *\n * `tenjin publish` stays on this list under its own terms: nothing RECOMMENDS it,\n * and no line here or on the doc page adds it. {@link PUBLISH_MODE_ALLOWLIST} is\n * not a recommendation — it is what one specific operator choice already means.\n */\nexport const NEVER_ALLOWLISTED: readonly ExcludedVerb[] = [\n {\n command: 'tenjin wallet send',\n reason:\n 'Moves USDC out of the wallet to an arbitrary address (the escape hatch, #40). ' +\n 'Irreversible and not bounded by the buy spend policy. Always a human decision.',\n },\n {\n command: 'tenjin publish',\n reason:\n 'Puts your content on a public marketplace under your identity. Never pre-cleared by the ' +\n 'free tier or an opt-in line: the only thing that clears it is `publish.mode` auto or ' +\n 'full-auto, which is the same human decision said once instead of twice (see ' +\n 'PUBLISH_MODE_ALLOWLIST). Back on review, `install` takes the rule away again.',\n },\n {\n command: 'tenjin edit',\n reason:\n 'Write-capable despite the no-flag form reading as a pure show: it edits live posts ' +\n 'and answer cards under your identity, and moves prices. A prefix rule pins the verb, ' +\n 'not the flags, so no rule can clear the read half without clearing the write half. ' +\n 'Never pre-cleared as a recommendation: like `tenjin publish`, the only thing that ' +\n 'clears it is `publish.mode` auto or full-auto, whose consent gate it already shares ' +\n '(see PUBLISH_MODE_ALLOWLIST). Back on review, `install` takes the rule away again.',\n },\n {\n command: 'tenjin delete',\n reason:\n 'Destroys a published piece. It is the one write verb `publish.mode` deliberately does NOT ' +\n 'carry: the mode is consent to publish, and reading it as consent to destroy would let one ' +\n 'decision authorize a different, irreversible one. So no mode ever clears this rule, and ' +\n 'the CLI confirms on every run regardless — a prefix rule here would only remove the ' +\n 'harness prompt in front of a command that asks its own question anyway. Reach for ' +\n '`tenjin edit --status draft` when the piece should come down reversibly.',\n },\n {\n command: 'tenjin wallet create',\n reason: 'Creates the payment credential; a stray run is a wallet you did not mean to have.',\n },\n {\n command: 'tenjin config set',\n reason:\n 'Can raise maxAutoSpend / sessionBudget / confirm, i.e. widen the agent’s own spend policy — ' +\n 'and, through shelfBypassSecret + baseUrl, put the machine in team mode, where a publish ' +\n 'skips the scan’s warn tier (except secret-assignment, and hex32-value, the warn form a ' +\n 'block-tier check demotes to) and prices at 0. It also writes ' +\n 'publish.ackServerWarnings on, the most direct consent-loosening write on this verb: ' +\n 'it lets one --yes cover the marketplace’s own scan findings, which no payload had ' +\n 'rendered when that yes was given.',\n },\n {\n command: 'tenjin install',\n reason: 'Writes into harness config and skills directories.',\n },\n {\n command: 'tenjin mcp',\n reason:\n 'Long-running server that re-exposes every command core over stdio; ' +\n 'clearing it would indirectly clear everything above.',\n },\n {\n command: 'tenjin update',\n reason:\n 'Replaces the tenjin binary the agent then runs, with whatever npm serves ' +\n 'next. Which build an agent executes is an operator decision, not something ' +\n 'a rule pre-clears. `--check` only reports, but a prefix rule pins the verb, ' +\n 'not the flags.',\n },\n];\n\n/**\n * The flag-surface caveat. A prefix rule pins the verb, never the flags, and the\n * flag that matters is `--base-url`: it is accepted on every leaf, validated only\n * as a URL, and it wins settings precedence, so it moves the destination of every\n * allowlisted verb. Printed with the rules everywhere they are printed, because\n * an operator who only reads the verb list would never learn it.\n */\nexport const FLAG_CAVEAT: readonly string[] = [\n 'Caveat: a prefix rule pins the VERB, not the flags. Every line above also clears',\n '`--base-url <url>` on that verb, which re-points where the question, the probe, the',\n 'session key `read` mints and presents, and (for buy) the signature and payment go.',\n 'Signed and credential-bearing traffic is NOT confined to the paying verb: `read` is in',\n 'the safe tier and both mints a wallet-derived delegation and transmits it, which is why',\n 'that delegation is bound to the origin it was minted for and refused elsewhere.',\n 'Allowlist these verbs only if you are content for the agent to choose the destination',\n 'host, and set the base URL in config instead of letting it be an argument. The skills',\n 'tell agents never to pass --base-url on an allowlisted verb, but that is a convention,',\n 'not an enforced boundary.',\n 'This covers the two rules your publish.mode carries as well, and bites hardest there:',\n '`tenjin publish --base-url <host>` is cleared by default on auto, and it signs against',\n 'the host it is given.',\n];\n\n/**\n * The MCP caveat. `tenjin mcp` is never recommended as a Bash rule, but an\n * operator who registers the server anyway is on a different permission surface\n * (tools, not command strings) where three excluded verbs come back.\n */\nexport const MCP_CAVEAT: readonly string[] = [\n 'Note the asymmetry: publish.mode writes the Bash rules for `publish` and `edit`, and',\n 'deliberately does not touch the MCP tool grants below. The mode is a CLI-side consent',\n 'gate, and nothing reads it on the MCP surface, so clearing those tools would hand out',\n 'the same authority with none of the same gate. Aligning the two is tracked separately.',\n 'Running the local MCP server (`tenjin mcp`) instead? That is a different permission',\n 'surface: the harness gates TOOLS there, and these Bash rules do not apply. Leave',\n '`mcp__tenjin__tenjin_publish`, `mcp__tenjin__tenjin_edit`,',\n '`mcp__tenjin__tenjin_delete`, and `mcp__tenjin__tenjin_wallet` gated. `tenjin_buy` is',\n 'the same opt-in decision as the buy line above. `tenjin_delete` is the one whose own',\n 'core still confirms even if you clear it: it never reads publish.mode.',\n];\n\n/** The machine shape emitted by `tenjin doctor --json` and `tenjin install --json`. */\nexport interface RecommendedPermissions {\n alwaysSafe: AllowlistEntry[];\n optIn: AllowlistEntry[];\n neverAllowlisted: ExcludedVerb[];\n /**\n * Rules the CURRENT publish.mode carries, empty on review. Separate from the\n * three tiers above because it is not a recommendation to weigh: it is what\n * this machine's mode already means, so a consumer that renders it beside the\n * others would be offering a choice that has been made.\n */\n modeGated: AllowlistEntry[];\n /**\n * Whether any harness on THIS machine can carry the rules above. They are\n * `Bash(...)` lines, Claude Code's grammar; a reader that took this payload\n * for a description of a Codex-only machine concluded `publish.mode=auto`\n * was in force while Codex was rejecting `tenjin publish` before the CLI ran\n * (tenjin-agent#342). The document still ships for a harness you have not\n * installed yet, so check this before treating any rule below as granted.\n */\n effective: boolean;\n /** Caveats that qualify the rules above; never omit them when rendering. */\n caveats: { flags: string[]; mcp: string[] };\n}\n\n/**\n * `mode` defaults to the shipped `review`, i.e. no mode-gated rules.\n * `effective` defaults to FALSE, so a caller that has not established such a\n * harness cannot have the payload claim one by omission.\n */\nexport function recommendedPermissions(\n mode: PublishMode = 'review',\n effective = false,\n): RecommendedPermissions {\n return {\n alwaysSafe: ALWAYS_SAFE_ALLOWLIST.map((e) => ({ ...e })),\n optIn: OPT_IN_ALLOWLIST.map((e) => ({ ...e })),\n neverAllowlisted: NEVER_ALLOWLISTED.map((e) => ({ ...e })),\n modeGated: modeGatedAllowlist(mode),\n effective,\n caveats: { flags: [...FLAG_CAVEAT], mcp: [...MCP_CAVEAT] },\n };\n}\n\n/** Every rule this module recommends adding (safe + opt-in). */\nexport function recommendedRules(): string[] {\n return [...ALWAYS_SAFE_ALLOWLIST, ...OPT_IN_ALLOWLIST].map((e) => e.rule);\n}\n\n/**\n * The permission caveats' one home. `doctor` used to print the whole thing —\n * nine rules, both opt-in notes, every exclusion, the flag caveat and the MCP\n * caveat, ~60 lines ahead of the check list it was actually run for. No doctor\n * command in the wider ecosystem carries security prose, and an operator reading\n * a wall of it in a terminal cannot paste from it, search it, or link a colleague\n * to a section. The page can do all three, so it is where the caveats live and\n * where every human surface points; `--json` still carries them as data\n * (`recommendedPermissions`), which is what an agent reads.\n */\nexport const PERMISSIONS_DOC_URL =\n 'https://github.com/BackTrackCo/tenjin-agent/blob/main/docs/agent-permissions.md';\n\n/**\n * The rules the current mode is missing, or null when it needs none. This one\n * DOES name them: they are not a tier to weigh and paste, they\n * are lines that should already be in the operator's settings file, and an\n * operator whose agent is being prompted for work the mode said not to ask about\n * needs to see exactly which rules are missing.\n *\n * CONSULTS THE MACHINE. Rendering from the mode alone told operators to add\n * rules their settings file already had, and named a remedy that in one case\n * would not have written anything — a nag that is wrong twice over on a line\n * whose whole job is to prevent an agent stalling on a prompt (#161).\n */\nexport function modeGatedPointer(\n mode: PublishMode,\n /** The mode-gated rules this machine is actually MISSING. Empty renders nothing. */\n missing: readonly string[],\n /**\n * The command that would fix it. `tenjin install` for the ordinary case; a\n * mode coming from TENJIN_PUBLISH_MODE needs `config set` instead, because\n * install resolves the mode from the global file and would write nothing.\n */\n remedy = 'tenjin install',\n): string | null {\n if (modeGatedAllowlist(mode).length === 0 || missing.length === 0) return null;\n return `publish.mode=${mode} also needs ${missing.join(' and ')} in your harness allowlist, or it will prompt anyway; \\`${remedy}\\` writes them.`;\n}\n"],"mappings":";;;AAyPO,IAAM,yBAAoD;AAAA,EAC/D;AAAA,IACE,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MACE;AAAA,EAeJ;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,SAAS;AAAA,IACT,MACE;AAAA,EAWJ;AACF;AAGO,SAAS,mBAAmB,MAAqC;AACtE,SAAO,SAAS,WAAW,CAAC,IAAI,uBAAuB,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;AAC9E;AAwLO,IAAM,sBACX;AAcK,SAAS,iBACd,MAEA,SAMA,SAAS,kBACM;AACf,MAAI,mBAAmB,IAAI,EAAE,WAAW,KAAK,QAAQ,WAAW,EAAG,QAAO;AAC1E,SAAO,gBAAgB,IAAI,eAAe,QAAQ,KAAK,OAAO,CAAC,2DAA2D,MAAM;AAClI;","names":[]}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/router/hooks.ts","../src/router/context.ts","../src/router/gate.ts","../src/router/hook-command.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { homedir } from 'node:os';\nimport { z } from 'zod';\nimport { loadRawConfig, resolveSettings } from '../lib/config';\nimport type { PartialConfig } from '../lib/config';\nimport { walletPath } from '../lib/paths';\nimport { evaluateSpendPolicy } from '../lib/policy';\nimport { resolveContextSettings } from '../lib/settings';\nimport { readSpendSummary, spentOf } from '../lib/spend-ledger';\nimport { readUsdcBalance } from '../lib/usdc-balance';\nimport type { CommandContext } from '../context';\nimport {\n buildNativePacket,\n buildPromptPacket,\n seal,\n type NativeOutcome,\n type Packet,\n type PendingCall,\n type Sealed,\n} from './context';\nimport { requestDecision, ROUTER_PATH, type HookDecision } from './decision';\nimport { GATE_TIMEOUT_MS } from './gate';\nimport { REQUEST_TOOL } from './names';\nimport { requestToolAccess, type AgentLookup } from './agent-tools';\nimport {\n bindDecision,\n markOffered,\n newCallId,\n noteSession,\n pruneProgress,\n pruneSessions,\n sessionDir,\n wasOffered,\n writeProgress,\n} from './progress';\nimport { routerSettings, type RouterSettings } from './settings';\n\n/**\n * The four hook handlers. Between them they do exactly three things: build and\n * seal the packet, ask for one free decision, and say one thing back to the\n * harness. Before an `execute` is shown where nobody can approve it, they also\n * read the wallet's address from its file and its USDC balance from the RPC\n * (`withheldBecause`); that is the only other thing they touch.\n *\n * NOTHING ELSE IS IN REACH FROM HERE. No wallet module, no signer, no payment\n * SDK, no viem, no MCP server: a dist test asserts the chunk graph, because the\n * hooks run on every prompt and after every native search, and their cost is\n * the product's floor.\n * The decision is free, so nothing on this path can spend anything either.\n *\n * EVERY FAILURE IS SILENT. A backend that is down, slow or answering nonsense\n * leaves the prompt and the native result unchanged; the cause goes to\n * stderr. The user's turn is never blocked by this.\n *\n * A DENY ONLY WHERE IT CAN BE ACTED ON. The pre-call arm redirects a native\n * call the router routes, as every release has, because a note beside the call\n * was followed 0 times in 11 where the redirect is followed. But a denied\n * WebFetch stranded every subagent that could not reach `request`\n * (tenjin-agent#377), so a subagent is denied only when it is known to have\n * the tool (`requestToolAccess`) and the spend would auto-execute from a wallet\n * that can cover it; anyone else's call runs free. No arm ever returns `allow`: that would skip the user's own permission\n * rules for the call.\n */\n\nconst PromptEventSchema = z.object({\n session_id: z.string().min(1).max(200),\n /** The directory the session works in; `router.*` resolves from it. */\n cwd: z.string().optional(),\n transcript_path: z.string().optional(),\n prompt: z.string(),\n});\n\n/** What both native arms read: the call, whose it is, and where it runs. */\nconst NativeCallFields = {\n session_id: z.string().min(1).max(200),\n /** The harness's own path for THIS session: the decision reads the same\n * bounded history the prompt one does, so a restriction the user gave\n * reaches both gates. */\n transcript_path: z.string().optional(),\n tool_name: z.enum(['WebSearch', 'WebFetch']),\n tool_input: z.record(z.string(), z.unknown()),\n /** The harness's id for this one call, shared by its Pre and Post events. */\n tool_use_id: z.string().min(1).max(200).optional(),\n /** Present only inside a subagent, which is the one caller that cannot reach\n * the user to approve a spend. */\n agent_id: z.string().min(1).max(200).optional(),\n /** The subagent's type, which names its definition file. */\n agent_type: z.string().min(1).max(200).optional(),\n cwd: z.string().optional(),\n};\n\nconst NativeEventSchema = z.object({\n hook_event_name: z.literal('PreToolUse').optional(),\n ...NativeCallFields,\n});\n\nconst ShortfallEventSchema = z.object({\n hook_event_name: z.enum(['PostToolUse', 'PostToolUseFailure']),\n ...NativeCallFields,\n /** PostToolUse only: WebFetch's `{bytes, code, codeText, result, durationMs}`,\n * or WebSearch's `{query, results, durationSeconds, searchCount}`. */\n tool_response: z.unknown().optional(),\n /** PostToolUseFailure only: the failed call's own error, such as\n * `getaddrinfo ENOTFOUND x.test`. */\n error: z.unknown().optional(),\n is_interrupt: z.boolean().optional(),\n});\n\nconst DelegationEventSchema = z.object({\n session_id: z.string().min(1).max(200),\n transcript_path: z.string().optional(),\n /** `Task` is the tool's older name; the matcher `install` writes takes both. */\n tool_name: z.enum(['Agent', 'Task']),\n tool_input: z.record(z.string(), z.unknown()),\n cwd: z.string().optional(),\n});\n\n/** A native call as every arm past {@link decodeEvent} reads it. */\nexport interface NativeCall {\n sessionId: string;\n transcriptPath?: string;\n tool: 'WebSearch' | 'WebFetch';\n /** The search or URL, or null when the call carries none. */\n pending: PendingCall | null;\n toolUseId?: string;\n /** Present only inside a subagent. */\n agentId?: string;\n agentType?: string;\n cwd?: string;\n}\n\n/** One hook event, as this file uses it. */\nexport type HookEvent =\n | { kind: 'prompt'; sessionId: string; transcriptPath?: string; prompt: string; cwd?: string }\n | ({ kind: 'native' } & NativeCall)\n | ({\n kind: 'shortfall';\n eventName: 'PostToolUse' | 'PostToolUseFailure';\n /** What the harness reported, when it was a shortfall; null means none. */\n nativeOutcome: NativeOutcome | null;\n } & NativeCall)\n | {\n kind: 'delegation';\n sessionId: string;\n transcriptPath?: string;\n /** `tool_input.prompt`: the subagent's whole task. */\n task: string | null;\n subagentType: string;\n /** The whole tool input, echoed back with the task changed. */\n toolInput: Record<string, unknown>;\n cwd?: string;\n };\n\n/**\n * THE ONLY READER OF A HARNESS FIELD. `session_id`, `transcript_path`,\n * `prompt`, `tool_name`, `tool_input` (its `query`, `url`, `prompt` and\n * `subagent_type`), `tool_use_id`, `agent_id`, `agent_type`, `cwd`,\n * `tool_response` and `error` are Claude Code's names; everything past this\n * function reads {@link HookEvent}, so a second harness is a second decoder\n * rather than a change to each arm. `null` is an event no arm handles.\n */\nexport function decodeEvent(raw: unknown): HookEvent | null {\n const shortfall = ShortfallEventSchema.safeParse(raw);\n if (shortfall.success) {\n return {\n kind: 'shortfall',\n eventName: shortfall.data.hook_event_name,\n nativeOutcome: shortfallOf(shortfall.data),\n ...nativeCallOf(shortfall.data),\n };\n }\n const native = NativeEventSchema.safeParse(raw);\n if (native.success) return { kind: 'native', ...nativeCallOf(native.data) };\n const delegation = DelegationEventSchema.safeParse(raw);\n if (delegation.success) {\n const input = delegation.data.tool_input;\n return {\n kind: 'delegation',\n sessionId: delegation.data.session_id,\n ...optional('transcriptPath', delegation.data.transcript_path),\n task: typeof input.prompt === 'string' ? input.prompt : null,\n // With no type the harness runs its general-purpose agent.\n subagentType:\n typeof input.subagent_type === 'string' ? input.subagent_type : 'general-purpose',\n toolInput: input,\n ...optional('cwd', delegation.data.cwd),\n };\n }\n const prompt = PromptEventSchema.safeParse(raw);\n if (!prompt.success) return null;\n return {\n kind: 'prompt',\n sessionId: prompt.data.session_id,\n ...optional('transcriptPath', prompt.data.transcript_path),\n prompt: prompt.data.prompt,\n ...optional('cwd', prompt.data.cwd),\n };\n}\n\nfunction nativeCallOf(\n event: Omit<z.infer<typeof NativeEventSchema>, 'hook_event_name'>,\n): NativeCall {\n return {\n sessionId: event.session_id,\n ...optional('transcriptPath', event.transcript_path),\n tool: event.tool_name,\n pending: pendingCallOf(event.tool_name, event.tool_input),\n ...optional('toolUseId', event.tool_use_id),\n ...optional('agentId', event.agent_id),\n ...optional('agentType', event.agent_type),\n ...optional('cwd', event.cwd),\n };\n}\n\nfunction optional<K extends string>(key: K, value: string | undefined): Partial<Record<K, string>> {\n return value === undefined ? {} : ({ [key]: value } as Record<K, string>);\n}\n\n/** Acknowledgements that cannot be a lookup; `install` never gates them. */\nconst ACKNOWLEDGEMENTS = new Set(['y', 'yes', 'ok', 'okay', 'continue', 'go', 'sure', 'thanks']);\n\nexport type PromptSkip = 'slash' | 'acknowledgement';\n\n/**\n * Prompts that cannot need a lookup, decided locally with no network call. Any\n * OTHER short prompt still goes to the backend: `2^1000`, a bare URL and a task\n * typed without spaces can all need one, and a computation has no later\n * WebSearch or WebFetch hook to recover a skipped classification.\n */\nexport function promptSkipReason(prompt: string): PromptSkip | null {\n const trimmed = prompt.trim();\n if (trimmed.startsWith('/')) return 'slash';\n const normalized = trimmed.toLowerCase().replace(/[.!,]+$/, '');\n return ACKNOWLEDGEMENTS.has(normalized) ? 'acknowledgement' : null;\n}\n\n/**\n * EVERY LINE SAYS WHERE IT CAME FROM AND NAMES THE REAL TOOL. An unattributed\n * line asking for a call the model cannot find by that name reads like an\n * injection, and a subagent looking for `request` in its tool list finds\n * nothing. So each line opens with its source, and the server's `request({`\n * becomes the name the harness actually exposes, from the one place `install`\n * registers it. The server's words are otherwise untouched: this client names\n * no provider and no price of its own.\n */\nexport const HINT_SOURCE = 'Tenjin router (installed by the user)';\n\nconst BARE_CALL_RE = /(?<![\\w$])request\\(\\{/g;\n\nexport function toolNamed(hint: string): string {\n return hint.replace(BARE_CALL_RE, `${REQUEST_TOOL}({`);\n}\n\n/** The server's line as the prompt hint and the redirect both carry it. */\nfunction attributed(hint: string): string {\n return `${HINT_SOURCE}: ${toolNamed(hint)}`;\n}\n\n/** Where the offer sits after the free tool came back short. */\nfunction shortfallOffer(tool: 'WebSearch' | 'WebFetch', hint: string): string {\n return `${HINT_SOURCE}: your ${tool} call came back short. Optional: ${toolNamed(hint)}`;\n}\n\n/**\n * A WebFetch body smaller than this is empty for any purpose a reader has. The\n * smallest real page measured, example.com (a heading and two sentences),\n * reports 559 bytes; a 404 and x.com's blocked read both report 0. Sixty-four\n * bytes has no room for one sentence of content, so nothing a person would\n * call a page falls under it.\n */\nexport const NEAR_EMPTY_BYTES = 64;\n\n/**\n * DID THE FREE TOOL FALL SHORT, decided from the harness's own report and\n * nothing else: no model, no network call. Only clear signals count, and\n * everything else is `null`, which means the router is never asked:\n *\n * - a failed call (PostToolUseFailure), unless the user interrupted it;\n * - WebFetch refused or failing upstream: 401, 402, 403, 429 or any 5xx. A\n * 404 or 410 is not one: a page that is missing is missing for a paid\n * reader too;\n * - WebFetch answering 2xx, or no code, with under {@link NEAR_EMPTY_BYTES};\n * - WebSearch answering with no result links at all.\n *\n * A search that returned unrelated links is NOT one: it looks exactly like a\n * good search from here, and guessing would put the router on every call.\n */\nexport function shortfallOf(event: {\n hook_event_name: 'PostToolUse' | 'PostToolUseFailure';\n tool_name: 'WebSearch' | 'WebFetch';\n tool_response?: unknown;\n error?: unknown;\n is_interrupt?: boolean;\n}): NativeOutcome | null {\n if (event.hook_event_name === 'PostToolUseFailure') {\n if (event.is_interrupt === true) return null;\n // Neither masked nor cut here: seal() does both, in that order.\n const error = typeof event.error === 'string' ? event.error.trim() : '';\n return error.length > 0 ? { error } : null;\n }\n const response = event.tool_response;\n if (response === null || typeof response !== 'object' || Array.isArray(response)) return null;\n const fields = response as Record<string, unknown>;\n if (event.tool_name === 'WebFetch') {\n const code = wholeNumber(fields.code, 999);\n const bytes = wholeNumber(fields.bytes, Number.MAX_SAFE_INTEGER);\n const outcome = {\n ...(code !== undefined ? { code } : {}),\n ...(bytes !== undefined ? { bytes } : {}),\n };\n if (code !== undefined && isShortStatus(code)) return outcome;\n const success = code === undefined || (code >= 200 && code < 300);\n return success && bytes !== undefined && bytes < NEAR_EMPTY_BYTES ? outcome : null;\n }\n const results = fields.results;\n if (!Array.isArray(results)) return null;\n const linked = results.some(\n (entry) =>\n entry !== null &&\n typeof entry === 'object' &&\n Array.isArray((entry as { content?: unknown }).content) &&\n (entry as { content: unknown[] }).content.length > 0,\n );\n return linked ? null : { error: 'Web search returned no results' };\n}\n\n/** The statuses a paid reader can get past: auth walls, paywalls, bot blocks,\n * rate limits and upstream failures. Every other 4xx is the page's answer. */\nconst SHORT_STATUSES = new Set([401, 402, 403, 429]);\n\nfunction isShortStatus(code: number): boolean {\n return SHORT_STATUSES.has(code) || (code >= 500 && code <= 599);\n}\n\nfunction wholeNumber(value: unknown, max: number): number | undefined {\n return typeof value === 'number' && Number.isInteger(value) && value >= 0 && value <= max\n ? value\n : undefined;\n}\n\nfunction delegationOffer(hint: string): string {\n return `${HINT_SOURCE}, optional if your own tools fall short: ${toolNamed(hint)} Your own tools are fine when they are enough.`;\n}\n\nexport interface HookDeps {\n dataDir: string;\n /** Overrides the resolved base URL entirely; tests point it at a local stub. */\n baseUrl?: string;\n /** The environment the base URL precedence reads `TENJIN_BASE_URL` from. */\n env?: NodeJS.ProcessEnv;\n /** Every request a hook makes: the decision, and the balance read before an\n * offer. Tests answer both from one stub. */\n fetchImpl?: typeof fetch;\n timeoutMs?: number;\n now?: () => number;\n /** Where `~/.claude` is, for the user's agent definitions; tests point it\n * at a scratch directory. */\n homeDir?: string;\n /**\n * Where a silent failure says why. The harness keeps hook stderr in its log,\n * so one line there is the difference between \"the feature is off\" and \"the\n * router answered 401 at this URL\". Never stdout: that is the harness's\n * protocol channel.\n */\n warn?: (line: string) => void;\n}\n\n/**\n * The CLI's ONE precedence, not a second copy of it: flag, then\n * `TENJIN_BASE_URL`, then the config file, then the production default. The\n * hook read the file alone, so a session pointed somewhere by the environment\n * had its prompts routed against whatever the file said instead; on a machine\n * whose file named a protected deployment that was a 401, and a 401 is silence.\n */\nfunction resolveBaseUrl(deps: HookDeps, config: PartialConfig): string {\n if (deps.baseUrl !== undefined) return deps.baseUrl;\n return resolveSettings({ config, flags: {}, env: deps.env ?? process.env }).baseUrl.value;\n}\n\n/** The balance read's own ceiling, inside what the decision left of the gate's\n * budget. Base's public RPC answered `balanceOf` in 0.16 to 0.26 s. */\nconst BALANCE_TIMEOUT_MS = 1_000;\n\n/** When the gate's budget runs out. The decision and the balance read share it,\n * so the pair still fits the hook timeout `wire.test.ts` pins. */\nfunction gateDeadline(deps: HookDeps): number {\n return (deps.now?.() ?? Date.now()) + (deps.timeoutMs ?? GATE_TIMEOUT_MS);\n}\n\n/**\n * WHY THE PAID CALL WOULD NOT RUN ON ITS OWN, in the footer's words, or null\n * when it would. Every line that points at `request` where nobody can approve\n * asks this first: a subagent cannot reach the user, and the main agent's\n * pre-call deny and prompt hint send it to a call that has to run rather than\n * to the free tools that would have answered. Two things stop that call:\n *\n * - THE SPEND POLICY, asked the way `request` will ask it: the same settings,\n * the same session ledger and the same evaluation, with the provider's host\n * as the creator the way `pay` names it. Only `allow` runs alone. Nothing is\n * reserved, and the amount actually signed is still `gateSpend`'s to cap.\n * - THE WALLET. A fresh install's wallet holds no USDC, and the authorization\n * it signs is refused after the free call was already denied: the user got\n * neither. One `balanceOf`, read only once the policy said yes.\n *\n * ONLY A BALANCE READ BELOW THE PRICE WITHHOLDS. One that cannot be read (no\n * wallet file, an RPC that fails, rate-limits or runs past the gate's budget)\n * leaves the policy to decide alone, as before this check. Base's public RPC\n * refused the sixth `eth_call` in a second, and parallel fetches are an\n * ordinary turn, so withholding on a failed read would drop the redirect on\n * funded wallets exactly when the router is used most, and a dead `rpcUrl`\n * would switch it off for good. The cost of the other direction needs an\n * empty wallet AND a failed read, and lasts one call. A `TENJIN_WALLET_KEY`\n * wallet is left to the policy too: its address takes a curve this chunk\n * does not load, and the file beside it is not the wallet that pays.\n */\nasync function withheldBecause(\n decision: { providerPriceAtomic: string; endpoint: string },\n deps: HookDeps,\n deadline: number,\n): Promise<string | null> {\n let rpcUrl: string;\n try {\n const settings = await resolveContextSettings(hookContext(deps));\n const ledger = await readSpendSummary(deps.dataDir, {\n ...(deps.now !== undefined ? { now: deps.now } : {}),\n });\n const evaluation = evaluateSpendPolicy(settings.policy, {\n amountAtomic: BigInt(decision.providerPriceAtomic),\n creator: new URL(decision.endpoint).host,\n sessionSpentAtomic: ledger === null ? 0n : spentOf(ledger),\n });\n if (evaluation.decision !== 'allow') return 'offer needs approval';\n rpcUrl = settings.rpcUrl;\n } catch {\n return 'offer needs approval';\n }\n if ((deps.env ?? process.env).TENJIN_WALLET_KEY?.trim()) return null;\n const address = await walletAddress(deps.dataDir);\n if (address === null) return null;\n const balance = await readUsdcBalance(address, rpcUrl, {\n timeoutMs: Math.min(BALANCE_TIMEOUT_MS, deadline - (deps.now?.() ?? Date.now())),\n ...(deps.fetchImpl !== undefined ? { fetchImpl: deps.fetchImpl } : {}),\n });\n if (balance === null) {\n (deps.warn ?? ((line: string) => process.stderr.write(`${line}\\n`)))(\n `tenjin hook: the wallet's USDC balance could not be read from ${new URL(rpcUrl).host}, so the spend policy alone decides`,\n );\n return null;\n }\n return balance < BigInt(decision.providerPriceAtomic) ? 'wallet needs USDC' : null;\n}\n\n/**\n * The wallet file's address, which `lib/wallet/store.ts` keeps top-level in\n * cleartext so it reads without a passphrase; null when there is none to read.\n * Read here rather than through the wallet module, which stays out of this\n * chunk graph.\n */\nasync function walletAddress(dataDir: string): Promise<string | null> {\n try {\n const record: unknown = JSON.parse(await readFile(walletPath(dataDir), 'utf8'));\n const address = (record as { address?: unknown } | null)?.address;\n return typeof address === 'string' && /^0x[0-9a-fA-F]{40}$/.test(address) ? address : null;\n } catch {\n return null;\n }\n}\n\nfunction agentLookup(cwd: string | undefined, deps: HookDeps): AgentLookup {\n return { ...(cwd !== undefined ? { cwd } : {}), homeDir: deps.homeDir ?? homedir() };\n}\n\n/** The context the hook's own library calls run in: JSON, silent, no TTY. */\nfunction hookContext(deps: HookDeps): CommandContext {\n return {\n flags: { json: true, timeout: deps.timeoutMs ?? GATE_TIMEOUT_MS },\n dataDir: deps.dataDir,\n io: { stdout: nullStream(), stderr: nullStream(), isTTY: false },\n };\n}\n\nexport interface PromptHookOutcome {\n /** What the harness is told, or null for \"nothing to say\". */\n response: unknown | null;\n skipped?: PromptSkip;\n action?: HookDecision['action'];\n /** The turn id, for the smoke to correlate against. */\n id?: string;\n /** An `execute` whose hint was not shown: the paid call would not run on its\n * own, for want of approval or of funds. */\n withheld?: true;\n}\n\n/**\n * `tenjin hook prompt` (UserPromptSubmit). One free decision from the user's\n * own words. Only an `execute` gets a line: the server's hint, attributed.\n * `native`, `needs_input` and a decision that failed or timed out are silence:\n * a turn with no lookup carries nothing extra, and `decide` has already written\n * any failure cause to stderr.\n *\n * THE HINT ASKS FOR A CALL THAT HAS TO RUN. Over the cap or past the budget,\n * `request` answers `needs_approval`, and a model sent there stops to ask the\n * user where its free tools would have done: so the line is shown only when\n * the paid call would auto-execute, the same rule the pre-call deny follows.\n */\nexport async function runPromptHook(raw: unknown, deps: HookDeps): Promise<PromptHookOutcome> {\n const event = decodeEvent(raw);\n if (event?.kind !== 'prompt') return { response: null };\n const skipped = promptSkipReason(event.prompt);\n if (skipped !== null) return { response: null, skipped };\n const router = await routerFor(event.cwd, deps);\n if (router === null) return { response: null };\n\n const sealed = seal(\n scoped(\n await buildPromptPacket(event.transcriptPath, event.sessionId, event.prompt),\n router.settings,\n ),\n );\n const footer = await openFooter(deps, event.sessionId, 'prompt');\n const deadline = gateDeadline(deps);\n const outcome = await decide(sealed, deps, router.config);\n if (outcome === null || outcome.action !== 'execute') {\n await footer.close(outcome);\n return { response: null, ...(outcome !== null ? { action: outcome.action } : {}) };\n }\n const withheld = await withheldBecause(outcome, deps, deadline);\n if (withheld !== null) {\n await footer.close(outcome, { withheld });\n return { response: null, action: 'execute', withheld: true };\n }\n await footer.close(outcome);\n return { action: 'execute', id: outcome.id, ...injection(attributed(outcome.hint)) };\n}\n\nfunction injection(line: string): { response: unknown } {\n return {\n response: {\n hookSpecificOutput: { hookEventName: 'UserPromptSubmit', additionalContext: line },\n },\n };\n}\n\n/** What either native arm reports about itself; `response` is all the harness sees. */\nexport interface NativeHookOutcome {\n response: unknown | null;\n action?: HookDecision['action'];\n id?: string;\n /** An `execute` whose offer was not shown: the paid call would not run on\n * its own, for want of approval or of funds. */\n withheld?: true;\n /** No router call at all: the subagent is not known to have the request tool. */\n noRequestTool?: true;\n}\n\nexport interface ShortfallHookOutcome extends NativeHookOutcome {\n /** What the harness reported, when it was a shortfall; absent means the\n * router was never asked. */\n nativeOutcome?: NativeOutcome;\n /** The pre-call arm already redirected this very call, so nothing more is said. */\n alreadyOffered?: true;\n}\n\ntype ExecuteDecision = Extract<HookDecision, { action: 'execute' }>;\n\n/**\n * THE ONE ROUTE BOTH NATIVE ARMS TAKE, before the call and after it: the\n * agent's tool list, the packet from the right transcript, one free decision,\n * and the subagent spend rule. An `execute` that survives all of it comes back\n * as `offer`; everything else is the reason there is none.\n */\nasync function routeNativeCall(\n event: NativeCall,\n pending: PendingCall,\n deps: HookDeps,\n nativeOutcome?: NativeOutcome,\n): Promise<{ offer: ExecuteDecision } | { offer: null; outcome: NativeHookOutcome }> {\n // OFF MEANS NOTHING ABOUT THE TURN IS READ: the switch comes before the\n // agent lookup and the transcript, for both native arms.\n const router = await routerFor(event.cwd, deps);\n if (router === null) return { offer: null, outcome: { response: null } };\n // A SUBAGENT IS ROUTED ONLY WHEN IT IS KNOWN TO HAVE THE TOOL: redirecting\n // or offering to one that cannot make the call strands it (#377). Decided\n // before the router is asked, so an unknown one costs nothing.\n if (\n event.agentId !== undefined &&\n (await requestToolAccess(event.agentType, agentLookup(event.cwd, deps))) !== 'allowed'\n ) {\n return { offer: null, outcome: { response: null, noRequestTool: true } };\n }\n // THE USER'S WORDS COME WITH IT. Building this from the tool argument alone\n // made the search string the whole conversation, so \"native tools only, no\n // paid services\" never reached this gate. Inside a subagent, its own task\n // comes first: see `buildNativePacket`.\n const sealed = seal(\n scoped(\n await buildNativePacket(event.transcriptPath, event.sessionId, pending, {\n ...(event.agentId !== undefined ? { agentId: event.agentId } : {}),\n ...(nativeOutcome !== undefined ? { nativeOutcome } : {}),\n }),\n router.settings,\n ),\n );\n const { packet } = sealed;\n // A LOCAL TARGET ONLY EVER HAS A NATIVE ANSWER, so asking costs a round trip\n // and sends the conversation for nothing.\n if (sealed.localTarget) return { offer: null, outcome: { response: null } };\n // A CREDENTIAL IN THE SEARCH OR URL NEVER LEAVES. Sending it masked would put\n // the mask into the hint the server writes from it, and the model would call\n // the provider with the mask. The call stays native.\n if (sealed.subjectChanged) {\n (deps.warn ?? ((line: string) => process.stderr.write(`${line}\\n`)))(\n 'tenjin hook: the native call carries a credential-shaped value, so it is not routed',\n );\n return { offer: null, outcome: { response: null } };\n }\n // AND WHEN THEY CANNOT BE READ, NOTHING IS OFFERED. An offer routed on the\n // tool argument alone is how an instruction the user gave this turn gets\n // overruled by a decision that never saw it.\n if (packet.historyStatus !== 'ok') {\n (deps.warn ?? ((line: string) => process.stderr.write(`${line}\\n`)))(\n \"tenjin hook: this session's transcript could not be read, so no paid lookup is offered\",\n );\n return { offer: null, outcome: { response: null } };\n }\n const footer = await openFooter(deps, event.sessionId, 'search');\n const deadline = gateDeadline(deps);\n const outcome = await decide(sealed, deps, router.config);\n if (outcome === null || outcome.action !== 'execute') {\n await footer.close(outcome);\n return {\n offer: null,\n outcome: { response: null, ...(outcome !== null ? { action: outcome.action } : {}) },\n };\n }\n // THE SPEND RULE, WHERE AN OFFER WOULD BE A DEAD END. A subagent cannot ask\n // the user, so it is offered only what runs alone. The main agent's pre-call\n // arm DENIES the free call, so it redirects only when the paid call would run\n // without approval from a wallet that can pay: denying a fetch and then\n // answering `needs_approval`, or failing an unfunded payment, left the page\n // neither fetched nor bought. The main agent's after-call arm denies nothing,\n // so its offer stands and `request` can still ask.\n const denies = nativeOutcome === undefined;\n const withheld =\n event.agentId !== undefined || denies ? await withheldBecause(outcome, deps, deadline) : null;\n if (withheld !== null) {\n await footer.close(outcome, { withheld });\n return { offer: null, outcome: { response: null, action: 'execute', withheld: true } };\n }\n await footer.close(outcome);\n return { offer: outcome };\n}\n\n/**\n * `tenjin hook native` (PreToolUse on `WebSearch|WebFetch`). PER-LOOKUP\n * ROUTING BEFORE THE CALL, exactly as main: a clear `execute` denies the native\n * call with the server's hint as the reason, carrying the id so the redirected\n * call runs the decision just made. Anything else, including silence, a slow\n * backend and a `needs_input`, lets the call run with no output at all.\n *\n * WHAT IS NEW is who can be denied. A subagent not known to have the request\n * tool, or whose spend would need an approval it cannot ask for, is never\n * redirected: `routeNativeCall` answers without an offer, and its\n * call runs free. Neither is the main agent when the paid call would stop on\n * `needs_approval` or its wallet cannot cover the price: its free call runs,\n * and the after-call arm can still offer.\n *\n * A redirect leaves a mark under the call's `tool_use_id`, so the after-call\n * arm never offers on that same call.\n */\nexport async function runNativeHook(raw: unknown, deps: HookDeps): Promise<NativeHookOutcome> {\n const event = decodeEvent(raw);\n if (event?.kind !== 'native' || event.pending === null) return { response: null };\n const routed = await routeNativeCall(event, event.pending, deps);\n if (routed.offer === null) return routed.outcome;\n if (event.toolUseId !== undefined) {\n await markOffered(deps.dataDir, event.sessionId, event.toolUseId, deps.now?.());\n }\n return {\n response: {\n hookSpecificOutput: {\n hookEventName: 'PreToolUse',\n permissionDecision: 'deny',\n // THE SERVER'S LINE, attributed and tool-named, and nothing else. It\n // already carries the id and the exact search or URL that was denied.\n permissionDecisionReason: attributed(routed.offer.hint),\n },\n },\n action: 'execute',\n id: routed.offer.id,\n };\n}\n\n/**\n * `tenjin hook shortfall` (PostToolUse and PostToolUseFailure on\n * `WebSearch|WebFetch`). THE FREE TOOL HAS ALREADY RUN, and a result that is\n * fine ends here: no router call, no footer, no added latency. Only a clear\n * shortfall ({@link shortfallOf}) asks for one free decision, with what the\n * harness reported riding in the packet as `nativeOutcome`, and only an\n * `execute` says anything. A call the pre-call arm already redirected is not\n * offered on again.\n *\n * A server that does not know `nativeOutcome` yet refuses the packet; that is\n * a failed decision like any other, so the hook stays silent.\n */\nexport async function runShortfallHook(\n raw: unknown,\n deps: HookDeps,\n): Promise<ShortfallHookOutcome> {\n const event = decodeEvent(raw);\n if (event?.kind !== 'shortfall') return { response: null };\n const { nativeOutcome, pending, eventName } = event;\n if (nativeOutcome === null) return { response: null };\n if (pending === null) return { response: null };\n if (\n event.toolUseId !== undefined &&\n (await wasOffered(deps.dataDir, event.sessionId, event.toolUseId, deps.now?.()))\n ) {\n return { response: null, nativeOutcome, alreadyOffered: true };\n }\n const routed = await routeNativeCall(event, pending, deps, nativeOutcome);\n if (routed.offer === null) return { ...routed.outcome, nativeOutcome };\n return {\n response: {\n hookSpecificOutput: {\n hookEventName: eventName,\n // THE SERVER'S LINE, attributed and framed as the option it is. It\n // already carries the id and the exact search or URL that came back short.\n additionalContext: shortfallOffer(event.tool, routed.offer.hint),\n },\n },\n nativeOutcome,\n action: 'execute',\n id: routed.offer.id,\n };\n}\n\nexport interface DelegationHookOutcome {\n response: unknown | null;\n action?: HookDecision['action'];\n id?: string;\n withheld?: true;\n noRequestTool?: true;\n}\n\n/**\n * `tenjin hook agent` (PreToolUse on `Agent|Task`). The one moment a subagent's\n * whole assignment is visible: its task prompt IS the current message, and the\n * parent's own turn is the history, so the router decides on exactly what the\n * subagent will do. On a clear `execute` the offer is appended to that task as\n * one optional line, which reaches the subagent as part of its instructions\n * from its parent, before it starts. Anything else is no output at all.\n *\n * The subagent will be the payer, so the same auto-execute rule applies here.\n */\nexport async function runDelegationHook(\n raw: unknown,\n deps: HookDeps,\n): Promise<DelegationHookOutcome> {\n const event = decodeEvent(raw);\n if (event?.kind !== 'delegation') return { response: null };\n const { task } = event;\n if (task === null || task.trim().length === 0) return { response: null };\n const router = await routerFor(event.cwd, deps);\n if (router === null) return { response: null };\n // The subagent this task goes to is the one that would have to make the\n // call, so the same rule: only a type known to have the tool is offered. With\n // no type the harness runs its general-purpose agent, which inherits it.\n if ((await requestToolAccess(event.subagentType, agentLookup(event.cwd, deps))) !== 'allowed') {\n return { response: null, noRequestTool: true };\n }\n const sealed = seal(\n scoped(await buildPromptPacket(event.transcriptPath, event.sessionId, task), router.settings),\n );\n // The native hook's two rules, with the task as the subject: a task the mask\n // would change is not sent, since the offer is written back into it, and a\n // task naming a local target only ever has a native answer.\n if (sealed.localUrl) return { response: null };\n if (sealed.currentChanged) {\n (deps.warn ?? ((line: string) => process.stderr.write(`${line}\\n`)))(\n 'tenjin hook: the delegated task carries a credential-shaped value, so it is not routed',\n );\n return { response: null };\n }\n // The native hook's rule, for the same reason: a delegation routed without\n // the user's words could offer what they just ruled out.\n if (sealed.packet.historyStatus !== 'ok') return { response: null };\n const footer = await openFooter(deps, event.sessionId, 'delegate');\n const deadline = gateDeadline(deps);\n const outcome = await decide(sealed, deps, router.config);\n if (outcome === null || outcome.action !== 'execute') {\n await footer.close(outcome);\n return { response: null, ...(outcome !== null ? { action: outcome.action } : {}) };\n }\n const withheld = await withheldBecause(outcome, deps, deadline);\n if (withheld !== null) {\n await footer.close(outcome, { withheld });\n return { response: null, action: 'execute', withheld: true };\n }\n await footer.close(outcome);\n return {\n response: {\n hookSpecificOutput: {\n hookEventName: 'PreToolUse',\n // The whole input, with one line appended: `updatedInput` replaces it.\n updatedInput: {\n ...event.toolInput,\n prompt: `${task}\\n\\n${delegationOffer(outcome.hint)}`,\n },\n },\n },\n action: 'execute',\n id: outcome.id,\n };\n}\n\n/**\n * THE HOOK STAGE, WHICH IS THE ONE THE DEMO OPENS WITH. The decision is in\n * flight for about a second, and at a one-second refresh a state that is\n * written and then erased inside that second is a state nobody ever sees. So\n * the record is not cleared: `selecting service` is REPLACED by what the\n * decision turned out to be, and that outcome holds the line until the next\n * state arrives or its hold runs out.\n *\n * Display only. Every write inside swallows its own failure, and an `execute`\n * also leaves the id-to-session binding the tool resolves its progress through.\n */\nasync function openFooter(\n deps: HookDeps,\n sessionId: string,\n operation: 'prompt' | 'search' | 'delegate',\n): Promise<{\n /** `withheld` is why an `execute` was not shown, in the footer's words. */\n close: (decision: HookDecision | null, opts?: { withheld?: string }) => Promise<void>;\n}> {\n const now = (): number => deps.now?.() ?? Date.now();\n const directory = sessionDir(deps.dataDir, sessionId);\n const callId = newCallId();\n await noteSession(deps.dataDir, sessionId, now());\n await writeProgress(\n directory,\n callId,\n { phase: 'routing', operation, outcome: 'selecting service' },\n now(),\n );\n await pruneProgress(directory, now());\n // The root, not just this session: a directory per session ever opened would\n // eventually be more than the resolver can scan.\n await pruneSessions(deps.dataDir, now());\n return {\n close: async (decision, opts) => {\n const withheld = opts?.withheld;\n await writeProgress(\n directory,\n callId,\n {\n phase: 'done',\n operation,\n outcome: withheld !== undefined ? `native tools (${withheld})` : hookOutcome(decision),\n },\n now(),\n );\n if (withheld === undefined && decision !== null && decision.action === 'execute') {\n await bindDecision(deps.dataDir, sessionId, decision.id, now());\n }\n },\n };\n}\n\n/** What the gate decided, in the footer's own words. A silent backend is not a\n * blank line: the turn runs on native tools and the footer says which. */\nfunction hookOutcome(decision: HookDecision | null): string {\n if (decision === null) return 'native tools (router unavailable)';\n if (decision.action === 'execute') return `paid lookup offered (${decision.provider})`;\n if (decision.action === 'native') return 'native tools (no x402 payment)';\n return 'needs input';\n}\n\n/** One free decision, with the hook's own deadline and its own silence. It\n * takes what {@link seal} returns rather than a bare packet, so a call site\n * that skips the mask does not typecheck. */\nasync function decide(\n { packet }: Sealed,\n deps: HookDeps,\n config: PartialConfig,\n): Promise<HookDecision | null> {\n const baseUrl = resolveBaseUrl(deps, config);\n const warn = deps.warn ?? ((line: string) => process.stderr.write(`${line}\\n`));\n const outcome = await requestDecision(\n 'hook',\n { packet },\n {\n ctx: hookContext(deps),\n baseUrl,\n timeoutMs: deps.timeoutMs ?? GATE_TIMEOUT_MS,\n ...(deps.fetchImpl !== undefined ? { fetchImpl: deps.fetchImpl } : {}),\n },\n );\n if (outcome.status === 'failed') {\n warn(`tenjin hook: ${baseUrl}${ROUTER_PATH} ${outcome.reason}`);\n return null;\n }\n return outcome.decision.decision;\n}\n\n/** The hooks write their own protocol answer on stdout and nothing else. */\nfunction nullStream(): NodeJS.WritableStream {\n return { write: () => true } as unknown as NodeJS.WritableStream;\n}\n\nfunction pendingCallOf(\n tool: 'WebSearch' | 'WebFetch',\n input: Record<string, unknown>,\n): PendingCall | null {\n const value = tool === 'WebSearch' ? input.query : input.url;\n if (typeof value !== 'string') return null;\n // Not cut here: seal() masks the subject first and bounds it after, so a\n // token crossing the bound is seen whole by the mask.\n const subject = value.trim();\n if (subject.length === 0) return null;\n return tool === 'WebSearch' ? { tool, query: subject } : { tool, url: subject };\n}\n\n/**\n * `router.*` for the event's directory with the global config it came from,\n * which is read ONCE per event and also names the base URL; null when the\n * router is off there. FIRST, before any packet is built: `router.enabled\n * false` means nothing about this turn is read for the router or leaves the\n * machine. A config that cannot be read is off too, since a switch the user\n * set must not fail open.\n */\nasync function routerFor(\n cwd: string | undefined,\n deps: HookDeps,\n): Promise<{ settings: RouterSettings; config: PartialConfig } | null> {\n const warn = deps.warn ?? ((line: string) => process.stderr.write(`${line}\\n`));\n try {\n const config = await loadRawConfig(deps.dataDir);\n const settings = await routerSettings(\n { cwd: cwd ?? process.cwd(), dataDir: deps.dataDir, config },\n { warn: (line) => warn(`tenjin hook: ${line}`) },\n );\n return settings.enabled.value ? { settings, config } : null;\n } catch (err) {\n warn(`tenjin hook: ${err instanceof Error ? err.message : String(err)}, so the router is off`);\n return null;\n }\n}\n\n/**\n * `router.context turn`: the current turn and nothing before it. `current` is\n * kept (the prompt, the latest user message on a native call, the task on a\n * delegation) so an instruction given this turn still reaches the gate;\n * `historyStatus` is left as read, so a call whose turn could not be found is\n * still offered nothing.\n */\nfunction scoped(packet: Packet, router: RouterSettings): Packet {\n return router.context.value === 'turn' ? { ...packet, history: [] } : packet;\n}\n","import { open } from 'node:fs/promises';\nimport { isIP } from 'node:net';\nimport { dirname, join } from 'node:path';\nimport { isPublicAddress } from '../lib/destination';\nimport { mask } from '../lib/redact';\n\n/**\n * The bounded conversation packet the router's gate and paid decision read.\n *\n * WHAT GOES IN IT: ordinary user and assistant text from the CURRENT session\n * only (and, for a subagent's own native call, that one subagent's rows), at\n * most {@link MAX_HISTORY} prior messages and at most {@link MAX_PACKET_BYTES}\n * in total, oldest dropped first. The builders below choose the text;\n * {@link seal} masks and bounds it, and is the only way a packet reaches the\n * wire. Tool results are excluded: a tool result is other people's content,\n * and a packet that carried it would be a channel from a fetched page into a\n * routing decision.\n *\n * WHAT NEVER HAPPENS: a transcript this reader cannot vouch for (another\n * session, a subagent sidechain, a compaction boundary, malformed rows, an\n * oversized file) is reported as `unavailable` rather than partially believed,\n * and the user's turn is never blocked by any of that. Adapted from the draft\n * auto-mode experiment (PR #369 `context.ts`), whose 48,000-character reader\n * this tightens.\n */\n\nexport const MAX_HISTORY = 6;\nexport const MAX_PACKET_BYTES = 16 * 1024;\n/** Every bound here is the server's own (tenjin `lib/x402-router/wire.ts`). A\n * packet this side lets through and that side refuses is a paid 400. */\nexport const MAX_MESSAGE_CHARS = 16_000;\nconst MAX_TRANSCRIPT_BYTES = 4_000_000;\nconst MAX_LITERAL_URLS = 8;\nconst MAX_LITERAL_URL_CHARS = 2_000;\nconst MAX_PENDING_CHARS = 4_000;\n/** The server's cap on a native outcome's error text. */\nconst MAX_OUTCOME_ERROR_CHARS = 1_000;\n/** Scanned past each bound: longer than any secret shape the mask knows. */\nconst MASK_MARGIN = 4_096;\n\nexport type PacketRole = 'user' | 'assistant';\nexport interface PacketMessage {\n role: PacketRole;\n text: string;\n}\n\nexport type HistoryStatus = 'ok' | 'unavailable';\n\nexport interface Packet {\n current: PacketMessage;\n history: PacketMessage[];\n /** Absolute http(s) URLs written literally in the current message. */\n literalUrls: string[];\n historyStatus: HistoryStatus;\n pendingCall?: PendingCall;\n /** How the free tool already fared on `pendingCall`, sent only when it fell\n * short. Never without `pendingCall`: the server refuses it alone. */\n nativeOutcome?: NativeOutcome;\n}\n\n/** What the harness reported about a native call that came back short: its\n * status and size (WebFetch), or the error a failed call carried. At least one\n * field, always; the server's schema is the same strict object. */\nexport interface NativeOutcome {\n code?: number;\n bytes?: number;\n error?: string;\n}\n\n/** The pending native call, INSIDE the packet: the gate request is a strict\n * object with exactly `schemaVersion`, `source` and `packet`. */\nexport type PendingCall = { tool: 'WebSearch'; query: string } | { tool: 'WebFetch'; url: string };\n\nconst URL_RE = /\\bhttps?:\\/\\/[^\\s<>\"'`)\\]]+/gi;\n\nexport function literalUrlsIn(text: string): string[] {\n const found = new Set<string>();\n for (const match of text.matchAll(URL_RE)) {\n const candidate = match[0].replace(/[.,;:!?]+$/, '');\n try {\n const normalized = new URL(candidate).toString();\n if (normalized.length <= MAX_LITERAL_URL_CHARS) found.add(normalized);\n } catch {\n continue;\n }\n if (found.size >= MAX_LITERAL_URLS) break;\n }\n return [...found];\n}\n\n/**\n * Bring the packet inside the server's caps: oldest history first, then the\n * current message itself, measured on the WHOLE packet rather than on the two\n * message lists, because `literalUrls` and a pending call are bytes too.\n *\n * EXPORTED BECAUSE ATTACHING ANYTHING RE-OPENS THE QUESTION. A packet this\n * returned at exactly the cap is over it the moment a caller adds a field, and\n * the server refuses rather than truncates, so every caller that adds one runs\n * this again on what it is actually going to send.\n */\nexport function fit(packet: Packet): Packet {\n const size = (value: Packet): number => Buffer.byteLength(JSON.stringify(value));\n const next: Packet = { ...packet, history: packet.history.slice(-MAX_HISTORY) };\n // In order of what is cheapest to lose. History first: a prior turn is\n // context. Then the literal URLs, which are a convenience the server can\n // re-derive from the text. The current message LAST, because it is the task\n // itself, and only down to one character, so a packet is never empty.\n while (next.history.length > 0 && size(next) > MAX_PACKET_BYTES) {\n next.history = next.history.slice(1);\n }\n while (next.literalUrls.length > 0 && size(next) > MAX_PACKET_BYTES) {\n next.literalUrls = next.literalUrls.slice(0, -1);\n }\n while (size(next) > MAX_PACKET_BYTES && next.current.text.length > 1) {\n const over = size(next) - MAX_PACKET_BYTES;\n const keep = Math.max(1, next.current.text.length - Math.max(over, 1));\n next.current = { ...next.current, text: next.current.text.slice(0, keep) };\n }\n return next;\n}\n\nexport interface Sealed {\n packet: Packet;\n /** The mask changed the pending call's search or URL. */\n subjectChanged: boolean;\n /** The pending WebFetch targets this machine or a private network. */\n localTarget: boolean;\n /** The mask changed the current message. */\n currentChanged: boolean;\n /** A literal URL in the packet targets this machine or a private network. */\n localUrl: boolean;\n}\n\n/**\n * THE ONE OUTBOUND CHOKEPOINT. Every string that leaves in a hook packet is\n * masked here, `current`, `history`, `literalUrls` and the pending call alike,\n * and only then bounded ({@link maskWithin}): a secret cut in half by a bound\n * before the mask no longer matches its row, and its first half would leave. The server stores\n * the packet against the id, so a secret here is a secret in its database.\n *\n * It also says what the caller must not send at all. A masked subject would\n * become the query the server writes into its hint, and a local or private\n * target can only ever be answered natively; both run unrouted.\n */\nexport function seal(packet: Packet): Sealed {\n const pending = packet.pendingCall;\n const subject = pending === undefined ? '' : 'query' in pending ? pending.query : pending.url;\n const sealedSubject = maskWithin(subject, MAX_PENDING_CHARS);\n const bound = (text: string): string => maskWithin(text, MAX_MESSAGE_CHARS).text;\n const sealedCurrent = maskWithin(packet.current.text, MAX_MESSAGE_CHARS);\n const current = sealedCurrent.text;\n const outcome = packet.nativeOutcome;\n const sealed = fit({\n current: { role: packet.current.role, text: current.length > 0 ? current : '(no task text)' },\n history: packet.history\n .slice(-MAX_HISTORY)\n .map((message) => ({ role: message.role, text: bound(message.text) }))\n .filter((message) => message.text.length > 0),\n literalUrls: packet.literalUrls\n .filter((url) => !isLocalTarget(url))\n .map(mask)\n .filter((url) => url.length <= MAX_LITERAL_URL_CHARS),\n historyStatus: packet.historyStatus,\n ...(pending === undefined\n ? {}\n : {\n pendingCall:\n 'query' in pending\n ? { tool: pending.tool, query: sealedSubject.text }\n : { tool: pending.tool, url: sealedSubject.text },\n }),\n ...(outcome === undefined\n ? {}\n : {\n nativeOutcome: {\n ...outcome,\n ...(outcome.error !== undefined\n ? { error: maskWithin(outcome.error, MAX_OUTCOME_ERROR_CHARS).text }\n : {}),\n },\n }),\n });\n return {\n packet: sealed,\n subjectChanged: sealedSubject.changed,\n localTarget: pending !== undefined && 'url' in pending && isLocalTarget(pending.url),\n currentChanged: sealedCurrent.changed,\n localUrl: packet.literalUrls.some(isLocalTarget),\n };\n}\n\n/**\n * MASKED, THEN BOUNDED, over a window: the mask scans what can be sent plus a\n * margin longer than any secret shape, so its cost is bounded however large\n * the input, and a secret crossing `max` is seen whole before the cut. A PEM\n * block that opens inside the window is masked to the window's end. When the\n * window itself cut the text, the last `MASK_MARGIN` characters of its masked\n * form are never sent either: a secret cut at the window's edge can sit there\n * after earlier masks shortened the text, and must not leave in part.\n */\nfunction maskWithin(text: string, max: number): { text: string; changed: boolean } {\n const window = text.slice(0, max + MASK_MARGIN);\n const masked = mask(window);\n const limit = window.length < text.length ? Math.min(max, masked.length - MASK_MARGIN) : max;\n return { text: masked.slice(0, Math.max(0, limit)), changed: masked !== window };\n}\n\nconst LOCAL_NAME = /(?:^|\\.)(?:localhost|local)$/i;\n\n/**\n * A URL no public service can fetch: another scheme, a `localhost` or `.local`\n * name, or a literal address that is not public (loopback, private,\n * link-local, IPv6 ULA and the other reserved ranges `isPublicAddress` knows).\n * A string that does not parse as a URL is not a public target either.\n */\nfunction isLocalTarget(raw: string): boolean {\n let url: URL;\n try {\n url = new URL(raw);\n } catch {\n return true;\n }\n if (url.protocol !== 'http:' && url.protocol !== 'https:') return true;\n const host = url.hostname.replace(/^\\[|\\]$/g, '');\n if (LOCAL_NAME.test(host)) return true;\n return isIP(host) !== 0 && !isPublicAddress(host);\n}\n\n/**\n * A packet for a caller that has no conversation to send: the query itself is\n * the current message, because the server's message text is `min(1)` and an\n * empty one is a 400 after the routing fee has already settled.\n */\nexport function packetForText(text: string): Packet {\n const bounded = text.trim().slice(0, MAX_MESSAGE_CHARS);\n return fit({\n current: { role: 'user', text: bounded.length > 0 ? bounded : '(no task text)' },\n history: [],\n literalUrls: literalUrlsIn(bounded),\n historyStatus: 'unavailable',\n });\n}\n\n/**\n * Build the packet for one user prompt. `transcriptPath` is the harness's own\n * path for this session; an absent or unusable one yields `unavailable`. The\n * result is neither masked nor bounded: {@link seal} does both.\n */\nexport async function buildPromptPacket(\n transcriptPath: string | undefined,\n sessionId: string,\n prompt: string,\n): Promise<Packet> {\n const trimmed = prompt.trim();\n const text = trimmed.length > 0 ? trimmed : '(empty prompt)';\n const read = await readHistory(transcriptPath, { sessionId });\n return {\n current: { role: 'user', text },\n history: read ?? [],\n literalUrls: literalUrlsIn(text),\n historyStatus: read === null ? 'unavailable' : 'ok',\n };\n}\n\n/**\n * Build the packet for a native call, before it runs or after it came back\n * short. The same reader as a prompt packet, with tool results excluded, and\n * the same {@link seal} before it is sent.\n *\n * THE USER'S WORDS ARE WHAT CARRY THEIR AUTHORITY. Building this packet from\n * the tool argument alone made the search string the entire conversation, so a\n * turn that said \"native tools only, no paid services\" reached the prompt gate\n * and never reached this one: the same session could then be redirected to a\n * paid provider on a bare URL. Reading the transcript at the hook event is not\n * session guessing; the harness hands this hook the path to its own session.\n *\n * The call rides INSIDE the packet as `pendingCall`, with how it fared beside\n * it as `nativeOutcome`: the shape the route takes, pinned by\n * `wire-hook-request-native-shortfall.json`.\n */\nexport async function buildNativePacket(\n transcriptPath: string | undefined,\n sessionId: string,\n pending: PendingCall,\n opts: { agentId?: string; nativeOutcome?: NativeOutcome } = {},\n): Promise<Packet> {\n const { agentId, nativeOutcome } = opts;\n const subject = 'query' in pending ? pending.query : pending.url;\n const read = await readHistory(transcriptPath, { sessionId });\n // A SUBAGENT'S CALL BELONGS TO ITS OWN TASK. The harness hands every\n // subagent hook the PARENT's transcript, whose latest user message is not\n // what this subagent was asked to do, so two subagents with different\n // assignments sent the same packet (tenjin-agent#377). Its own transcript\n // opens with the delegated task; the parent's messages stay in front of it\n // as history, which is how a restriction the user gave the parent still\n // reaches this call. A subagent file that cannot be read is today's\n // behaviour, not a refusal.\n const own =\n agentId === undefined\n ? null\n : await readHistory(subagentTranscriptPath(transcriptPath, sessionId, agentId), {\n sessionId,\n agentId,\n });\n const messages = own === null ? (read ?? []) : [...(read ?? []), ...own];\n // The most recent user message is the turn this call belongs to; everything\n // before it is context. With no transcript the call speaks for itself, which\n // is what this hook did before it could read one.\n const lastUser = messages\n .map((message, index) => ({ message, index }))\n .filter((entry) => entry.message.role === 'user');\n const current = lastUser.at(-1);\n return {\n current: current?.message ?? { role: 'user', text: subject },\n history: current === undefined ? messages : messages.slice(0, current.index),\n literalUrls: literalUrlsIn(`${current?.message.text ?? ''}\\n${subject}`),\n historyStatus: read === null && own === null ? 'unavailable' : 'ok',\n pendingCall: pending,\n ...(nativeOutcome !== undefined ? { nativeOutcome } : {}),\n };\n}\n\n/** Both ids become path segments, so anything but an opaque token is refused. */\nconst PATH_SEGMENT_RE = /^[A-Za-z0-9_-]{1,200}$/;\n\n/**\n * Where the harness keeps one subagent's transcript: beside the parent's\n * `<session>.jsonl`, under `<session>/subagents/agent-<agent_id>.jsonl`\n * (Claude Code 2.1.x). `undefined` when either id could not be a path segment.\n */\nexport function subagentTranscriptPath(\n transcriptPath: string | undefined,\n sessionId: string,\n agentId: string,\n): string | undefined {\n if (transcriptPath === undefined || transcriptPath.length === 0) return undefined;\n if (!PATH_SEGMENT_RE.test(sessionId) || !PATH_SEGMENT_RE.test(agentId)) return undefined;\n return join(dirname(transcriptPath), sessionId, 'subagents', `agent-${agentId}.jsonl`);\n}\n\n/**\n * Whose rows a transcript read admits: the session's own, or with `agentId`,\n * exactly one subagent's sidechain and no other.\n */\ninterface RowScope {\n sessionId: string;\n agentId?: string;\n}\n\n/** `null` means \"cannot be vouched for\"; an empty array is a genuinely fresh session. */\nasync function readHistory(\n path: string | undefined,\n scope: RowScope,\n): Promise<PacketMessage[] | null> {\n if (path === undefined || path.length === 0) return null;\n let raw: string;\n let file;\n try {\n file = await open(path, 'r');\n } catch {\n return null;\n }\n try {\n const stat = await file.stat();\n if (!stat.isFile() || stat.size > MAX_TRANSCRIPT_BYTES) return null;\n const buffer = Buffer.alloc(MAX_TRANSCRIPT_BYTES + 1);\n const { bytesRead } = await file.read(buffer, 0, buffer.length, 0);\n if (bytesRead > MAX_TRANSCRIPT_BYTES) return null;\n raw = buffer.subarray(0, bytesRead).toString('utf8');\n } catch {\n return null;\n } finally {\n await file.close();\n }\n try {\n return parseRows(raw, scope);\n } catch {\n return null;\n }\n}\n\n/**\n * TOLERANT BY ROW, STRICT BY CONTENT. Every rule below still holds about what\n * may enter a packet: no other session's text, no subagent's, no tool results.\n * What changed is the blast radius of one bad row. Rejecting the whole\n * transcript over a compaction boundary or a sidechain line meant the native\n * hook routed on the tool argument alone, which is exactly how a current-turn\n * \"native tools only\" instruction went missing from the decision it was about.\n *\n * A compaction boundary is not a reason to read nothing: the rows after it are\n * the live context, so the collected messages start again there.\n */\nfunction parseRows(raw: string, scope: RowScope): PacketMessage[] {\n const { sessionId, agentId } = scope;\n let messages: PacketMessage[] = [];\n for (const line of raw.split('\\n')) {\n if (line.trim().length === 0) continue;\n let row: Record<string, unknown>;\n try {\n row = JSON.parse(line) as Record<string, unknown>;\n } catch {\n continue; // One unreadable line is one line, not the conversation.\n }\n if (row === null || typeof row !== 'object' || Array.isArray(row)) continue;\n // Everything before the boundary belongs to a context that was summarized\n // away; what follows is the turn in play.\n if (row.type === 'system' && row.subtype === 'compact_boundary') {\n messages = [];\n continue;\n }\n // Never ours to read: another window's rows and a subagent's are skipped\n // rather than allowed to void the file.\n if (typeof row.sessionId === 'string' && row.sessionId !== sessionId) continue;\n // Harness meta rows (a skill body, a command caveat) are not the user's words.\n if (row.isMeta === true) continue;\n // A subagent read admits that one sidechain and nothing else; the harness's\n // own reminders in it are not the task. Every other read admits none.\n if (agentId === undefined ? row.isSidechain === true : !ownSidechainRow(row, agentId)) {\n continue;\n }\n if (row.type !== 'user' && row.type !== 'assistant') continue;\n if (row.sessionId !== sessionId) continue;\n let text: string;\n try {\n text = textOf(row.message);\n } catch {\n continue; // A row this build cannot read contributes nothing, and no more.\n }\n // Nor is what the harness writes back into the user's turn (tenjin-agent#401).\n if (row.type === 'user' && harnessUserRow(row, text)) continue;\n if (text.length > 0) messages.push({ role: row.type, text });\n }\n return messages;\n}\n\n/** Output of a local command, as the harness wraps it into a user row. */\nconst LOCAL_COMMAND_OUTPUT = /^\\s*<local-command-(?:stdout|stderr)>/;\n\n/**\n * A `type: \"user\"` row the user never typed. The harness writes two kinds\n * without `isMeta`: a background task or subagent finishing\n * (`origin.kind: \"task-notification\"`, text `<task-notification>…`) and a\n * local command's output (`<local-command-stdout>`). Both carry tool output,\n * so neither can be the user's words, and neither can become `current`. A\n * `<command-name>` row stays: that is the command the user did type.\n */\nfunction harnessUserRow(row: Record<string, unknown>, text: string): boolean {\n const origin = row.origin;\n if (\n origin !== null &&\n typeof origin === 'object' &&\n (origin as { kind?: unknown }).kind === 'task-notification'\n ) {\n return true;\n }\n return text.trimStart().startsWith('<task-notification>') || LOCAL_COMMAND_OUTPUT.test(text);\n}\n\nfunction ownSidechainRow(row: Record<string, unknown>, agentId: string): boolean {\n return row.isSidechain === true && row.agentId === agentId && row.isMeta !== true;\n}\n\n/** Ordinary text blocks only; a tool result contributes nothing. */\nfunction textOf(message: unknown): string {\n if (message === null || typeof message !== 'object' || Array.isArray(message)) {\n throw new Error('malformed message');\n }\n const content = (message as { content?: unknown }).content;\n if (typeof content === 'string') return content;\n if (!Array.isArray(content)) throw new Error('malformed content');\n const parts: string[] = [];\n for (const part of content) {\n if (\n part === null ||\n typeof part !== 'object' ||\n typeof (part as { type?: unknown }).type !== 'string'\n ) {\n throw new Error('malformed block');\n }\n const block = part as { type: string; text?: unknown };\n if (block.type !== 'text') continue;\n if (typeof block.text !== 'string') throw new Error('malformed text block');\n parts.push(block.text);\n }\n return parts.join('\\n');\n}\n","/**\n * THE HOOK'S TIME BUDGET, which is the only thing this module still owns.\n *\n * There is no separate gate call any more: the hook asks `POST\n * /api/x402-router` for the one free decision, and the backend answers as soon\n * as the native-versus-paid question is settled, binding whatever it chose in\n * the background. What used to live here, the `/prepare` client and the\n * category-shaped hint validator, went with that second round trip.\n */\n\n/**\n * The hook's whole budget is 5 s (the timeout `install` writes). Stdin waits up\n * to 1 s of it, so the decision gets 3.5 s and the two together still leave\n * 500 ms for node's boot and the transcript read; `wire.test.ts` pins the sum.\n * The expected wait is about 1 s: the backend answers on the gate question and\n * binds afterwards.\n *\n * AN ABORT HERE IS A LOST HINT, not a lost turn. The hook falls back to one\n * line telling the model to call `request` with its own query, and the tool\n * makes the decision instead. One of four live prompts was swallowed at a 1.5 s\n * abort against a backend measured at 0.4 to 0.5 s, so this holds the slack the\n * harness budget was already leaving unused.\n */\nexport const GATE_TIMEOUT_MS = 3_500;\n","import {\n runDelegationHook,\n runNativeHook,\n runPromptHook,\n runShortfallHook,\n type HookDeps,\n} from './hooks';\nimport type { Io } from '../lib/output';\n\n/**\n * `tenjin hook prompt`, `native`, `shortfall` and `agent`. The harness writes\n * its event on stdin and reads a JSON object (or nothing) from stdout, so these\n * commands\n * bypass the CLI's envelope entirely. They never fail the turn: a stdin that\n * never arrives, an unreadable event or a handler that throws all exit 0 with\n * an empty stdout, which the harness reads as \"no opinion\".\n */\n\nconst MAX_EVENT_BYTES = 1_000_000;\n/** One fifth of the hook's 5 s budget, leaving the gate its 3.5 s; `wire.test.ts`\n * pins the sum against the timeout `install` writes. The harness writes its\n * event immediately, so this wait is a liveness check rather than a budget to\n * spend: every second it holds is a second the gate does not get. */\nexport const STDIN_TIMEOUT_MS = 1_000;\n\nexport type HookKind = 'prompt' | 'native' | 'shortfall' | 'agent';\n\nexport interface HookCommandDeps extends HookDeps {\n /** Test seam for the harness event; production reads stdin. */\n readEvent?: () => Promise<string>;\n}\n\nexport async function runHookCommand(kind: HookKind, io: Io, deps: HookCommandDeps): Promise<void> {\n let response: unknown;\n try {\n const raw = await (deps.readEvent ?? readStdin)();\n const event: unknown = JSON.parse(raw);\n const outcome =\n kind === 'prompt'\n ? await runPromptHook(event, deps)\n : kind === 'native'\n ? await runNativeHook(event, deps)\n : kind === 'shortfall'\n ? await runShortfallHook(event, deps)\n : await runDelegationHook(event, deps);\n response = outcome.response;\n } catch {\n response = null;\n }\n if (response !== null) io.stdout.write(`${JSON.stringify(response)}\\n`);\n}\n\nasync function readStdin(): Promise<string> {\n return new Promise((resolve, reject) => {\n const chunks: Buffer[] = [];\n let size = 0;\n const timer = setTimeout(() => reject(new Error('no harness event')), STDIN_TIMEOUT_MS);\n const done = (value: string): void => {\n clearTimeout(timer);\n resolve(value);\n };\n process.stdin.on('data', (chunk: Buffer) => {\n size += chunk.length;\n if (size > MAX_EVENT_BYTES) {\n clearTimeout(timer);\n reject(new Error('harness event too large'));\n return;\n }\n chunks.push(chunk);\n });\n process.stdin.once('end', () => done(Buffer.concat(chunks).toString('utf8')));\n process.stdin.once('error', () => {\n clearTimeout(timer);\n reject(new Error('harness event unreadable'));\n });\n });\n}\n"],"mappings":"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","names":[]}
|
|
@@ -1,299 +0,0 @@
|
|
|
1
|
-
import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
|
|
2
|
-
import {
|
|
3
|
-
emitWriteNotice
|
|
4
|
-
} from "./chunk-WLMJE3GJ.js";
|
|
5
|
-
import {
|
|
6
|
-
HOSTED_SKILL_NAME,
|
|
7
|
-
OPTIONAL_PAY_SKILL,
|
|
8
|
-
SKILL_NAMES,
|
|
9
|
-
readSkillFile,
|
|
10
|
-
resolveSkillsSource,
|
|
11
|
-
skillFrontmatterName,
|
|
12
|
-
skillsDirsFor
|
|
13
|
-
} from "./chunk-WS4JA6TC.js";
|
|
14
|
-
import {
|
|
15
|
-
hasCode
|
|
16
|
-
} from "./chunk-2I4QTOLB.js";
|
|
17
|
-
import {
|
|
18
|
-
isTeamModeConfig
|
|
19
|
-
} from "./chunk-PDA2BVFY.js";
|
|
20
|
-
import "./chunk-U2DZISAH.js";
|
|
21
|
-
import {
|
|
22
|
-
PRODUCTION_HOST,
|
|
23
|
-
loadRawConfig
|
|
24
|
-
} from "./chunk-AR7U7BRG.js";
|
|
25
|
-
import {
|
|
26
|
-
CliError,
|
|
27
|
-
writeFileAtomic
|
|
28
|
-
} from "./chunk-JLEF5WHM.js";
|
|
29
|
-
import "./chunk-2BKS2FVE.js";
|
|
30
|
-
import "./chunk-ZXTAQYNA.js";
|
|
31
|
-
|
|
32
|
-
// src/lib/skill-placement.ts
|
|
33
|
-
import { lstatSync } from "node:fs";
|
|
34
|
-
import { readdir as readdir2, rm, rmdir } from "node:fs/promises";
|
|
35
|
-
import { homedir } from "node:os";
|
|
36
|
-
import { isAbsolute, join as join2 } from "node:path";
|
|
37
|
-
import { fileURLToPath } from "node:url";
|
|
38
|
-
|
|
39
|
-
// src/lib/skill-materialize.ts
|
|
40
|
-
var OPEN_MARKER = /^\s*<!--\s*tenjin:when\s+([a-zA-Z][a-zA-Z0-9.]*)\s*-->\s*$/;
|
|
41
|
-
var CLOSE_MARKER = /^\s*<!--\s*\/tenjin:when\s*-->\s*$/;
|
|
42
|
-
var ELSE_MARKER = /^\s*<!--\s*tenjin:else\s*-->\s*$/;
|
|
43
|
-
var NEAR_MARKER = /^\s*<!--\s*\/?\s*tenjin:(?:when|else)\b/;
|
|
44
|
-
function skillContentFlags(facts) {
|
|
45
|
-
return { teamMode: facts.teamMode };
|
|
46
|
-
}
|
|
47
|
-
function skillMaterialize(facts) {
|
|
48
|
-
return materializeTransform(skillContentFlags(facts));
|
|
49
|
-
}
|
|
50
|
-
function materializeSkillMarkdown(text, flags) {
|
|
51
|
-
const lines = text.split("\n");
|
|
52
|
-
const out = [];
|
|
53
|
-
let inBlock = null;
|
|
54
|
-
let keep = false;
|
|
55
|
-
let elsed = false;
|
|
56
|
-
for (const [i, line] of lines.entries()) {
|
|
57
|
-
const open = OPEN_MARKER.exec(line);
|
|
58
|
-
if (open !== null) {
|
|
59
|
-
if (inBlock !== null) {
|
|
60
|
-
throw markerError(`nested tenjin:when at line ${i + 1} (already inside "${inBlock}")`);
|
|
61
|
-
}
|
|
62
|
-
inBlock = open[1];
|
|
63
|
-
keep = flags[inBlock] === true;
|
|
64
|
-
elsed = false;
|
|
65
|
-
continue;
|
|
66
|
-
}
|
|
67
|
-
if (ELSE_MARKER.test(line)) {
|
|
68
|
-
if (inBlock === null) throw markerError(`unopened tenjin:else at line ${i + 1}`);
|
|
69
|
-
if (elsed) throw markerError(`second tenjin:else at line ${i + 1} in "${inBlock}"`);
|
|
70
|
-
elsed = true;
|
|
71
|
-
keep = !keep;
|
|
72
|
-
continue;
|
|
73
|
-
}
|
|
74
|
-
if (CLOSE_MARKER.test(line)) {
|
|
75
|
-
if (inBlock === null) throw markerError(`unopened /tenjin:when at line ${i + 1}`);
|
|
76
|
-
inBlock = null;
|
|
77
|
-
continue;
|
|
78
|
-
}
|
|
79
|
-
if (NEAR_MARKER.test(line)) {
|
|
80
|
-
throw markerError(`malformed tenjin:when marker at line ${i + 1}: ${line.trim()}`);
|
|
81
|
-
}
|
|
82
|
-
if (inBlock === null || keep) out.push(line);
|
|
83
|
-
}
|
|
84
|
-
if (inBlock !== null) throw markerError(`unclosed tenjin:when "${inBlock}"`);
|
|
85
|
-
return out.join("\n");
|
|
86
|
-
}
|
|
87
|
-
function materializeTransform(flags) {
|
|
88
|
-
return (rel, content) => {
|
|
89
|
-
if (!rel.toLowerCase().endsWith(".md")) return content;
|
|
90
|
-
return Buffer.from(materializeSkillMarkdown(content.toString("utf8"), flags), "utf8");
|
|
91
|
-
};
|
|
92
|
-
}
|
|
93
|
-
function markerError(detail) {
|
|
94
|
-
return new CliError("INTERNAL", `Malformed skill markers: ${detail}.`, {
|
|
95
|
-
fix: "Reinstall tenjin-cli; the packaged skills must carry balanced tenjin:when markers."
|
|
96
|
-
});
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
// src/lib/skill-writer.ts
|
|
100
|
-
import { existsSync } from "node:fs";
|
|
101
|
-
import { lstat, readFile, readdir, realpath, stat } from "node:fs/promises";
|
|
102
|
-
import { dirname, join, relative } from "node:path";
|
|
103
|
-
async function installSkill(srcDir, destDir, dryRun, name, opts = {}) {
|
|
104
|
-
const src = await readTree(srcDir);
|
|
105
|
-
if (src === null) {
|
|
106
|
-
throw new CliError("INTERNAL", `Packaged skill source ${srcDir} is empty`);
|
|
107
|
-
}
|
|
108
|
-
if (opts.materialize !== void 0) {
|
|
109
|
-
for (const [rel, content] of src) src.set(rel, opts.materialize(rel, content));
|
|
110
|
-
}
|
|
111
|
-
const writeTo = /* @__PURE__ */ new Map();
|
|
112
|
-
await assertReachable(destDir, name);
|
|
113
|
-
await assertNoCaseCollision(destDir, name);
|
|
114
|
-
for (const rel of src.keys()) {
|
|
115
|
-
const declared = join(destDir, rel);
|
|
116
|
-
writeTo.set(
|
|
117
|
-
rel,
|
|
118
|
-
opts.followSymlinks === false ? declared : await resolveThroughLink(declared, name)
|
|
119
|
-
);
|
|
120
|
-
}
|
|
121
|
-
let differs = false;
|
|
122
|
-
let preexisting = false;
|
|
123
|
-
for (const [rel, content] of src) {
|
|
124
|
-
const current = await readShippedFile(writeTo.get(rel), name, destDir);
|
|
125
|
-
if (rel === "SKILL.md") preexisting = current !== null;
|
|
126
|
-
if (current === null || !current.equals(content)) differs = true;
|
|
127
|
-
}
|
|
128
|
-
const change = !preexisting ? "create" : differs ? "update" : "none";
|
|
129
|
-
if (!dryRun && change !== "none") {
|
|
130
|
-
for (const [rel, content] of src) {
|
|
131
|
-
const target = writeTo.get(rel);
|
|
132
|
-
try {
|
|
133
|
-
const current = await stat(target).catch(() => null);
|
|
134
|
-
await writeFileAtomic(
|
|
135
|
-
target,
|
|
136
|
-
content,
|
|
137
|
-
current === null ? {} : { mode: current.mode & 511 }
|
|
138
|
-
);
|
|
139
|
-
} catch (err) {
|
|
140
|
-
throw wrapWriteError(
|
|
141
|
-
err,
|
|
142
|
-
destDir,
|
|
143
|
-
`the ${name} skill`,
|
|
144
|
-
await deepestExisting(dirname(target)),
|
|
145
|
-
{ expected: ": a skill is a directory holding SKILL.md" }
|
|
146
|
-
);
|
|
147
|
-
}
|
|
148
|
-
}
|
|
149
|
-
}
|
|
150
|
-
if (change === "create") return { status: dryRun ? "would-install" : "installed", preexisting };
|
|
151
|
-
if (change === "none") return { status: "up-to-date", preexisting };
|
|
152
|
-
return {
|
|
153
|
-
status: dryRun ? "would-update" : "updated",
|
|
154
|
-
preexisting,
|
|
155
|
-
// The hosted skill is a MIRROR of tenjin.blog/skills.md (roadmap G4), so a
|
|
156
|
-
// differing local copy is a replacement, not the drift warning the CLI skills
|
|
157
|
-
// get. Neither side carries a version or date, so the wording claims no
|
|
158
|
-
// direction: the local file may well be a newer fetch than this package's copy.
|
|
159
|
-
warning: name === HOSTED_SKILL_NAME ? `${destDir}: the hosted Tenjin skill differed and ${dryRun ? "would be" : "was"} replaced by this package's mirror of ${PRODUCTION_HOST}/skills.md, which may be older; it stays as the zero-install fallback. Re-fetch it from ${PRODUCTION_HOST}/skills.md if you need the current one.` : `${destDir}: local edits to ${name}'s SKILL.md ${dryRun ? "would be" : "were"} overwritten (the packaged copy is canonical).`
|
|
160
|
-
};
|
|
161
|
-
}
|
|
162
|
-
async function readShippedFile(path, name, destDir) {
|
|
163
|
-
const read = await readSkillFile(path);
|
|
164
|
-
if (read.kind === "absent") return null;
|
|
165
|
-
if (read.kind === "ok") return read.bytes;
|
|
166
|
-
if (read.kind === "not-regular") {
|
|
167
|
-
throw new CliError("INTERNAL", `${path} is not a regular file, so ${name} was not written.`, {
|
|
168
|
-
fix: `A skill file must be a regular file. Check what is there (\`ls -l ${path}\`) and remove or replace it, then re-run \`tenjin install\`.`
|
|
169
|
-
});
|
|
170
|
-
}
|
|
171
|
-
throw wrapWriteError(read.err, destDir, `the ${name} skill`, path, { verb: "read" });
|
|
172
|
-
}
|
|
173
|
-
async function resolveThroughLink(path, name) {
|
|
174
|
-
const entry = await lstat(path).catch(() => null);
|
|
175
|
-
if (entry === null || !entry.isSymbolicLink()) return path;
|
|
176
|
-
const target = await realpath(path).catch(() => null);
|
|
177
|
-
if (target !== null) return target;
|
|
178
|
-
throw new CliError("INTERNAL", `${path} is a broken symlink, so ${name} was not written.`, {
|
|
179
|
-
fix: `Point it at a path that exists, or remove it (\`ls -ld ${path}\`), then re-run \`tenjin install\`.`
|
|
180
|
-
});
|
|
181
|
-
}
|
|
182
|
-
async function assertNoCaseCollision(destDir, name) {
|
|
183
|
-
if (!existsSync(destDir)) return;
|
|
184
|
-
const entries = await readdir(dirname(destDir)).catch(() => null);
|
|
185
|
-
if (entries === null || entries.includes(name)) return;
|
|
186
|
-
const variant = entries.find((e) => e.toLowerCase() === name.toLowerCase());
|
|
187
|
-
if (variant === void 0) return;
|
|
188
|
-
const actual = join(dirname(destDir), variant);
|
|
189
|
-
throw new CliError(
|
|
190
|
-
"INTERNAL",
|
|
191
|
-
`${actual} is a case variant of the ${name} skill and this filesystem treats them as the same directory, so ${name} was not written.`,
|
|
192
|
-
{
|
|
193
|
-
fix: `Rename or remove ${actual}, then re-run \`tenjin install\`.`
|
|
194
|
-
}
|
|
195
|
-
);
|
|
196
|
-
}
|
|
197
|
-
async function assertReachable(destDir, name) {
|
|
198
|
-
const entry = await lstat(destDir).catch(() => null);
|
|
199
|
-
if (entry?.isSymbolicLink() !== true) return;
|
|
200
|
-
if (await realpath(destDir).catch(() => null) !== null) return;
|
|
201
|
-
throw new CliError("INTERNAL", `${destDir} is a broken symlink, so ${name} was not written.`, {
|
|
202
|
-
fix: `Point it at a directory that exists, or remove it (\`ls -ld ${destDir}\`), then re-run \`tenjin install\`.`
|
|
203
|
-
});
|
|
204
|
-
}
|
|
205
|
-
async function deepestExisting(dir) {
|
|
206
|
-
for (let cur = dir; ; cur = dirname(cur)) {
|
|
207
|
-
if (existsSync(cur)) return realpath(cur).catch(() => cur);
|
|
208
|
-
if (dirname(cur) === cur) return cur;
|
|
209
|
-
}
|
|
210
|
-
}
|
|
211
|
-
function wrapWriteError(err, dest, subject, culprit, opts = {}) {
|
|
212
|
-
const verb = opts.verb ?? "write";
|
|
213
|
-
const denied = hasCode(err, "EACCES") || hasCode(err, "EPERM");
|
|
214
|
-
const missing = hasCode(err, "ENOENT");
|
|
215
|
-
const wrongKind = hasCode(err, "ENOTDIR") || hasCode(err, "EISDIR");
|
|
216
|
-
if (!denied && !missing && !wrongKind) return err;
|
|
217
|
-
const fix = denied ? `Permission denied on ${culprit}. Check it (\`ls -ld ${culprit}\`), then re-run \`tenjin install\`.` : wrongKind ? `${dest} (or a path inside it) is not the kind of thing it needs to be${opts.expected ?? ""}. Check it (\`ls -ld ${dest}\`), then re-run \`tenjin install\`.` : `${dest} could not be created; if it is a symlink, check that its target exists (\`ls -ld ${dest}\`), then re-run \`tenjin install\`.`;
|
|
218
|
-
return new CliError(
|
|
219
|
-
"INTERNAL",
|
|
220
|
-
`Could not ${verb} ${subject} ${verb === "read" ? "at" : "to"} ${dest}.`,
|
|
221
|
-
{ fix, cause: err }
|
|
222
|
-
);
|
|
223
|
-
}
|
|
224
|
-
async function readTree(dir) {
|
|
225
|
-
if (!existsSync(dir)) return null;
|
|
226
|
-
const entries = await readdir(dir, { recursive: true, withFileTypes: true });
|
|
227
|
-
const files = /* @__PURE__ */ new Map();
|
|
228
|
-
for (const entry of entries) {
|
|
229
|
-
if (!entry.isFile()) continue;
|
|
230
|
-
const full = join(entry.parentPath, entry.name);
|
|
231
|
-
files.set(relative(dir, full), await readFile(full));
|
|
232
|
-
}
|
|
233
|
-
return files;
|
|
234
|
-
}
|
|
235
|
-
|
|
236
|
-
// src/lib/skill-placement.ts
|
|
237
|
-
async function placeOptionalSkill(name, skillsDir, skillsSource, present, teamMode) {
|
|
238
|
-
const skillDir = join2(skillsDir, name);
|
|
239
|
-
if (present) {
|
|
240
|
-
const { status } = await installSkill(join2(skillsSource, name), skillDir, false, name, {
|
|
241
|
-
materialize: skillMaterialize({ teamMode })
|
|
242
|
-
});
|
|
243
|
-
return { changed: status !== "up-to-date" };
|
|
244
|
-
}
|
|
245
|
-
if (lstatSync(skillDir, { throwIfNoEntry: false })?.isDirectory() !== true) {
|
|
246
|
-
return { changed: false };
|
|
247
|
-
}
|
|
248
|
-
const path = join2(skillDir, "SKILL.md");
|
|
249
|
-
const read = await readSkillFile(path);
|
|
250
|
-
if (read.kind === "absent") return { changed: false };
|
|
251
|
-
if (read.kind !== "ok" || skillFrontmatterName(read.bytes.toString("utf8")) !== name) {
|
|
252
|
-
return { changed: false };
|
|
253
|
-
}
|
|
254
|
-
await rm(path, { force: true });
|
|
255
|
-
const rest = await readdir2(skillDir).catch(() => null);
|
|
256
|
-
if (rest !== null && rest.length === 0) await rmdir(skillDir).catch(() => void 0);
|
|
257
|
-
return { changed: true };
|
|
258
|
-
}
|
|
259
|
-
async function syncBazaarSkill(enabled, deps) {
|
|
260
|
-
const home = deps.homeDir ?? homedir();
|
|
261
|
-
if (!isAbsolute(home)) return;
|
|
262
|
-
const teamMode = deps.dataDir === void 0 ? false : isTeamModeConfig(await loadRawConfig(deps.dataDir));
|
|
263
|
-
let source;
|
|
264
|
-
try {
|
|
265
|
-
source = deps.skillsSourceDir ?? resolveSkillsSource(fileURLToPath(new URL(".", import.meta.url)));
|
|
266
|
-
} catch {
|
|
267
|
-
return;
|
|
268
|
-
}
|
|
269
|
-
const touched = [];
|
|
270
|
-
for (const dir of skillsDirsFor(home)) {
|
|
271
|
-
try {
|
|
272
|
-
if (lstatSync(dir, { throwIfNoEntry: false })?.isDirectory() !== true) continue;
|
|
273
|
-
const consented = SKILL_NAMES.some(
|
|
274
|
-
(name) => lstatSync(join2(dir, name, "SKILL.md"), { throwIfNoEntry: false })?.isFile() === true
|
|
275
|
-
);
|
|
276
|
-
if (!consented) continue;
|
|
277
|
-
const { changed } = await placeOptionalSkill(
|
|
278
|
-
OPTIONAL_PAY_SKILL,
|
|
279
|
-
dir,
|
|
280
|
-
source,
|
|
281
|
-
enabled,
|
|
282
|
-
teamMode
|
|
283
|
-
);
|
|
284
|
-
if (changed) touched.push(join2(dir, OPTIONAL_PAY_SKILL));
|
|
285
|
-
} catch {
|
|
286
|
-
}
|
|
287
|
-
}
|
|
288
|
-
if (touched.length > 0) {
|
|
289
|
-
emitWriteNotice(
|
|
290
|
-
deps.io,
|
|
291
|
-
`${enabled ? "Installed" : "Removed"} ${touched.join(" and ")} to match bazaarPay.`
|
|
292
|
-
);
|
|
293
|
-
}
|
|
294
|
-
}
|
|
295
|
-
export {
|
|
296
|
-
placeOptionalSkill,
|
|
297
|
-
syncBazaarSkill
|
|
298
|
-
};
|
|
299
|
-
//# sourceMappingURL=skill-placement-JMDPSKE6.js.map
|