tenjin-cli 0.1.0-alpha.22 → 0.1.0-alpha.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/README.md +16 -13
  2. package/dist/{chunk-AG4DWNHO.js → chunk-3IOS6YG6.js} +2 -2
  3. package/dist/{chunk-3Q3UBMVB.js → chunk-6O6DFYF3.js} +2 -2
  4. package/dist/{chunk-UFCN7NCE.js → chunk-A2XMQSWI.js} +21 -11
  5. package/dist/chunk-A2XMQSWI.js.map +1 -0
  6. package/dist/{chunk-TU3IK7KK.js → chunk-HJYI52HM.js} +2 -2
  7. package/dist/{chunk-U5FFVIIF.js → chunk-HTC4VJFT.js} +6 -3
  8. package/dist/chunk-HTC4VJFT.js.map +1 -0
  9. package/dist/{chunk-UIOZRILX.js → chunk-I2GBBIDI.js} +2 -2
  10. package/dist/{chunk-DA53QKTD.js → chunk-K63HPLYT.js} +2 -2
  11. package/dist/{chunk-NZYVSZNF.js → chunk-N7A5EXJZ.js} +2 -2
  12. package/dist/{chunk-B4GA3HAK.js → chunk-RA2J3TWG.js} +2 -2
  13. package/dist/{chunk-B4GA3HAK.js.map → chunk-RA2J3TWG.js.map} +1 -1
  14. package/dist/{chunk-CYEUVU3F.js → chunk-Y3LKUXZA.js} +4 -4
  15. package/dist/{chunk-UAT3Q7VF.js → chunk-YT7A7DLY.js} +30 -17
  16. package/dist/{chunk-UAT3Q7VF.js.map → chunk-YT7A7DLY.js.map} +1 -1
  17. package/dist/{cli-5WM56Y7K.js → cli-MUYFTWWB.js} +17 -17
  18. package/dist/{config-JBF5BZNO.js → config-IIRRO3XC.js} +4 -4
  19. package/dist/{doctor-6KHBE77P.js → doctor-KGHM2CAC.js} +8 -8
  20. package/dist/{fund-GSFCXEF7.js → fund-DOWIT3JT.js} +3 -3
  21. package/dist/{hook-command-UQZ4DVDL.js → hook-command-RDT754KQ.js} +5 -5
  22. package/dist/index.js +2 -2
  23. package/dist/{install-TDYC22KI.js → install-BYQUMYBN.js} +6 -6
  24. package/dist/{install-identity-QS4UFF27.js → install-identity-KTQPYVAO.js} +4 -4
  25. package/dist/{mcp-JWOOSKLX.js → mcp-ZKOTURQN.js} +20 -8
  26. package/dist/{mcp-JWOOSKLX.js.map → mcp-ZKOTURQN.js.map} +1 -1
  27. package/dist/{pay-TDYQFSKY.js → pay-LZPU2HUT.js} +4 -4
  28. package/dist/{status-line-wiring-XKUVI5UW.js → status-line-wiring-7D2CSV3K.js} +4 -4
  29. package/dist/tenjin-daemon.mjs +1 -1
  30. package/dist/{uninstall-SJ6R2W2M.js → uninstall-VR44B4KD.js} +6 -6
  31. package/dist/{update-N2NZS3AA.js → update-SOYQLDBF.js} +3 -3
  32. package/docs/agent-permissions.md +1 -1
  33. package/package.json +1 -1
  34. package/dist/chunk-U5FFVIIF.js.map +0 -1
  35. package/dist/chunk-UFCN7NCE.js.map +0 -1
  36. /package/dist/{chunk-AG4DWNHO.js.map → chunk-3IOS6YG6.js.map} +0 -0
  37. /package/dist/{chunk-3Q3UBMVB.js.map → chunk-6O6DFYF3.js.map} +0 -0
  38. /package/dist/{chunk-TU3IK7KK.js.map → chunk-HJYI52HM.js.map} +0 -0
  39. /package/dist/{chunk-UIOZRILX.js.map → chunk-I2GBBIDI.js.map} +0 -0
  40. /package/dist/{chunk-DA53QKTD.js.map → chunk-K63HPLYT.js.map} +0 -0
  41. /package/dist/{chunk-NZYVSZNF.js.map → chunk-N7A5EXJZ.js.map} +0 -0
  42. /package/dist/{chunk-CYEUVU3F.js.map → chunk-Y3LKUXZA.js.map} +0 -0
  43. /package/dist/{cli-5WM56Y7K.js.map → cli-MUYFTWWB.js.map} +0 -0
  44. /package/dist/{config-JBF5BZNO.js.map → config-IIRRO3XC.js.map} +0 -0
  45. /package/dist/{doctor-6KHBE77P.js.map → doctor-KGHM2CAC.js.map} +0 -0
  46. /package/dist/{fund-GSFCXEF7.js.map → fund-DOWIT3JT.js.map} +0 -0
  47. /package/dist/{hook-command-UQZ4DVDL.js.map → hook-command-RDT754KQ.js.map} +0 -0
  48. /package/dist/{install-TDYC22KI.js.map → install-BYQUMYBN.js.map} +0 -0
  49. /package/dist/{install-identity-QS4UFF27.js.map → install-identity-KTQPYVAO.js.map} +0 -0
  50. /package/dist/{pay-TDYQFSKY.js.map → pay-LZPU2HUT.js.map} +0 -0
  51. /package/dist/{status-line-wiring-XKUVI5UW.js.map → status-line-wiring-7D2CSV3K.js.map} +0 -0
  52. /package/dist/{uninstall-SJ6R2W2M.js.map → uninstall-VR44B4KD.js.map} +0 -0
  53. /package/dist/{update-N2NZS3AA.js.map → update-SOYQLDBF.js.map} +0 -0
@@ -4,7 +4,7 @@ import {
4
4
  paidLegTimeoutMs,
5
5
  runPay,
6
6
  settlementTx
7
- } from "./chunk-UAT3Q7VF.js";
7
+ } from "./chunk-YT7A7DLY.js";
8
8
  import "./chunk-LAIZ2AQA.js";
9
9
  import "./chunk-RGVOODF4.js";
10
10
  import "./chunk-TTNESUPQ.js";
@@ -26,13 +26,13 @@ import "./chunk-RBJPAZFI.js";
26
26
  import "./chunk-BPMWXTFX.js";
27
27
  import "./chunk-UGLTSPXQ.js";
28
28
  import "./chunk-7QKHZQKW.js";
29
- import "./chunk-AG4DWNHO.js";
29
+ import "./chunk-3IOS6YG6.js";
30
30
  import "./chunk-MEFB5KHA.js";
31
31
  import "./chunk-2I4QTOLB.js";
32
32
  import "./chunk-UHEMZEGW.js";
33
33
  import "./chunk-O2JYBOUO.js";
34
34
  import "./chunk-SAN5PFTL.js";
35
- import "./chunk-B4GA3HAK.js";
35
+ import "./chunk-RA2J3TWG.js";
36
36
  import "./chunk-JLEF5WHM.js";
37
37
  import "./chunk-K6AXXYCG.js";
38
38
  import "./chunk-ZXTAQYNA.js";
@@ -42,4 +42,4 @@ export {
42
42
  runPay,
43
43
  settlementTx
44
44
  };
45
- //# sourceMappingURL=pay-TDYQFSKY.js.map
45
+ //# sourceMappingURL=pay-LZPU2HUT.js.map
@@ -9,9 +9,9 @@ import {
9
9
  inspectStatusLine,
10
10
  removeStatusLine,
11
11
  statusLineMode
12
- } from "./chunk-TU3IK7KK.js";
13
- import "./chunk-3Q3UBMVB.js";
14
- import "./chunk-B4GA3HAK.js";
12
+ } from "./chunk-HJYI52HM.js";
13
+ import "./chunk-6O6DFYF3.js";
14
+ import "./chunk-RA2J3TWG.js";
15
15
  import "./chunk-JLEF5WHM.js";
16
16
  import "./chunk-K6AXXYCG.js";
17
17
  import "./chunk-ZXTAQYNA.js";
@@ -26,4 +26,4 @@ export {
26
26
  removeStatusLine,
27
27
  statusLineMode
28
28
  };
29
- //# sourceMappingURL=status-line-wiring-XKUVI5UW.js.map
29
+ //# sourceMappingURL=status-line-wiring-7D2CSV3K.js.map
@@ -11,7 +11,7 @@ import { readFileSync as readFileSync4, statSync as statSync4 } from "node:fs";
11
11
  // package.json
12
12
  var package_default = {
13
13
  name: "tenjin-cli",
14
- version: "0.1.0-alpha.22",
14
+ version: "0.1.0-alpha.23",
15
15
  mcpName: "blog.tenjin/tenjin",
16
16
  type: "module",
17
17
  description: "x402 router for coding agents: one paid decision per lookup, a local wallet that pays each provider per call in USDC on Base.",
@@ -5,7 +5,7 @@ import {
5
5
  mcpScope,
6
6
  readMcpEntry,
7
7
  routerSettingsPath
8
- } from "./chunk-CYEUVU3F.js";
8
+ } from "./chunk-Y3LKUXZA.js";
9
9
  import {
10
10
  MCP_SERVER_NAME
11
11
  } from "./chunk-TGLKKLQG.js";
@@ -13,7 +13,7 @@ import "./chunk-UGLTSPXQ.js";
13
13
  import {
14
14
  onPath,
15
15
  persistRouterProject
16
- } from "./chunk-UIOZRILX.js";
16
+ } from "./chunk-I2GBBIDI.js";
17
17
  import "./chunk-A36LQPHV.js";
18
18
  import "./chunk-2QYORQBF.js";
19
19
  import "./chunk-MEFB5KHA.js";
@@ -24,12 +24,12 @@ import "./chunk-O2JYBOUO.js";
24
24
  import "./chunk-SAN5PFTL.js";
25
25
  import {
26
26
  removeStatusLine
27
- } from "./chunk-TU3IK7KK.js";
27
+ } from "./chunk-HJYI52HM.js";
28
28
  import {
29
29
  inspectHooksFile,
30
30
  pruneHooks
31
- } from "./chunk-3Q3UBMVB.js";
32
- import "./chunk-B4GA3HAK.js";
31
+ } from "./chunk-6O6DFYF3.js";
32
+ import "./chunk-RA2J3TWG.js";
33
33
  import {
34
34
  writeFileAtomic
35
35
  } from "./chunk-JLEF5WHM.js";
@@ -162,4 +162,4 @@ export {
162
162
  MCP_REMOVE_COMMAND,
163
163
  runRouterUninstall
164
164
  };
165
- //# sourceMappingURL=uninstall-SJ6R2W2M.js.map
165
+ //# sourceMappingURL=uninstall-VR44B4KD.js.map
@@ -5,7 +5,7 @@ import {
5
5
  fetchDistTags,
6
6
  isNewer,
7
7
  resolveTarget
8
- } from "./chunk-NZYVSZNF.js";
8
+ } from "./chunk-N7A5EXJZ.js";
9
9
  import {
10
10
  emitWriteNotice,
11
11
  sanitizeForTerminal
@@ -13,7 +13,7 @@ import {
13
13
  import "./chunk-SAN5PFTL.js";
14
14
  import {
15
15
  package_default
16
- } from "./chunk-B4GA3HAK.js";
16
+ } from "./chunk-RA2J3TWG.js";
17
17
  import {
18
18
  CliError
19
19
  } from "./chunk-JLEF5WHM.js";
@@ -430,4 +430,4 @@ export {
430
430
  spawnCapture,
431
431
  versionFreeEntry
432
432
  };
433
- //# sourceMappingURL=update-N2NZS3AA.js.map
433
+ //# sourceMappingURL=update-SOYQLDBF.js.map
@@ -104,7 +104,7 @@ To stop the router without removing anything, `tenjin config set router.enabled
104
104
 
105
105
  1. You type a turn. The hook sends the bounded packet to Tenjin, which answers whether a paid capability fits and, if it does, keeps that packet under a short-lived id.
106
106
  2. When one fits, your assistant sees one line, opening with `Tenjin router (installed by the user):`, that names the service, its price and the call to make: `mcp__x402__request({id, input})` with the required fields as placeholders, or already filled in when the hook holds them (the search a native call was about to run, or the page it was about to fetch). The hook keeps the service's spec on this machine under the id.
107
- 3. Your assistant fills the fields and calls `request({id, input})` once. This CLI validates the input against the spec, builds the request, pays that provider once under your limits, hands back the result, and tells Tenjin only how the call ended. Deciding costs nothing.
107
+ 3. Your assistant fills the fields and calls `request({id, input})` once. This CLI validates the input against the spec, builds the request, pays that provider once under your limits, hands back the result, and tells Tenjin only how the call ended. Deciding costs nothing. Where the spec names the fields its result promises, the result holds only those, and the provider's whole response is saved under `~/.tenjin/results/` (readable by you alone, kept a day) at the path the result names in `fullResultPath`.
108
108
  4. An input that does not fit the spec is refused before anything is sent: your assistant gets every problem and the whole spec (each input with its description and allowed values, the required fields inside a nested object, an example and what comes back), locally and with nothing paid, and calls again. `request({id})` alone shows the same spec. A spec whose input schema this CLI cannot compile is refused outright, with nothing sent or paid.
109
109
 
110
110
  ## What the hooks send
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tenjin-cli",
3
- "version": "0.1.0-alpha.22",
3
+ "version": "0.1.0-alpha.23",
4
4
  "mcpName": "blog.tenjin/tenjin",
5
5
  "type": "module",
6
6
  "description": "x402 router for coding agents: one paid decision per lookup, a local wallet that pays each provider per call in USDC on Base.",
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/router/decision.ts"],"sourcesContent":["import { z } from 'zod';\nimport { fetchFailureToCliError, httpRequest } from '../lib/http';\nimport type { HttpRequestOptions, HttpResult } from '../lib/http';\nimport type { CommandContext } from '../context';\nimport type { Packet } from './context';\n\n/**\n * `POST /api/x402-router`: ONE FREE DECISION PER LOOKUP.\n *\n * The routing decision costs nothing and nobody signs for it. The hook asks for\n * it from the user's own words, the backend answers with what it would do and\n * what the provider charges, and the only payment on the wire is the one\n * `runPay` makes to that provider. That deletes the router fee and everything\n * built to carry it: the 402 probe, the requirements cache, the stale-quote\n * retry, the settlement accounting and one Base settlement of about 1.5 s from\n * every paid lookup.\n *\n * NOTHING IS STORED LOCALLY. The bounded packet travels with the request and\n * the backend keeps it against the decision id until that id expires, which is\n * how `request({query})` reaches the same calibrated input with no session\n * file, no timestamp latch and no guess about which window this process serves.\n */\n\nexport const ROUTER_PATH = '/api/x402-router';\n\n/**\n * The request the server builds and this client sends verbatim. Query assembly,\n * body encoding and header choice are the server's; what stays here is every\n * check that decides whether to send it at all.\n */\nconst RequestSchema = z.object({\n url: z.string().min(1).max(16_384),\n method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS']),\n headers: z.record(z.string(), z.string()),\n body: z\n .string()\n .max(256 * 1024)\n .optional(),\n});\n\nconst ContractSchema = z.object({\n /** Flat, for display and for the result check; never re-encoded into a call:\n * the server built `request` from them and this client sends that verbatim. */\n arguments: z.record(z.string(), z.unknown()).optional(),\n resultSchema: z.record(z.string(), z.unknown()).optional(),\n request: RequestSchema,\n});\nexport type DecisionContract = z.infer<typeof ContractSchema>;\n\n/**\n * What stopped an outcome this client cannot execute, in terms the host can act\n * on: a stable reason code, the stage that stopped, the fields or scope choices\n * the user can supply, and one concrete next action.\n */\nconst DiagnosticsSchema = z.object({\n reasonCode: z.string().min(1).max(64),\n stage: z.string().min(1).max(32),\n missing: z.array(z.string().max(200)).max(60),\n nextAction: z.string().max(500),\n});\nexport type DecisionDiagnostics = z.infer<typeof DiagnosticsSchema>;\n\n/**\n * ONE VARIANT PER ANSWER, DISCRIMINATED ON THE ACTION. Optional fields made\n * every shape legal: an `execute` with no contract parsed and came back to the\n * host as a routine `needs_input`, a non-execute with no diagnostics parsed\n * with nothing to act on, and a hook answer carrying a contract parsed as\n * though the hook had quoted a price. Each of those is drift the shared\n * fixtures exist to catch, so each is now a parse failure that names itself.\n *\n * The two calls ask different questions and get different answers, so they get\n * different parsers. The HOOK asks whether a paid lookup is worth offering: an\n * id, or a reason it is not. The TOOL asks for the decision: the capability,\n * its price and the contract together, so a caller cannot approve one offer and\n * receive another.\n */\nconst IdSchema = z\n .string()\n .regex(/^[A-Za-z0-9_-]{8,64}$/)\n .describe(\n 'The turn id, an OPAQUE HANDLE: it is the one piece of server text this ' +\n 'client puts in a model-facing line, so the alphabet is pinned here ' +\n 'rather than escaped later.',\n );\n\n/** Every non-execute answer carries these, beside the action they explain. */\nconst RefusedSchema = z.strictObject({\n reason: z.string().max(2_000).optional(),\n diagnostics: DiagnosticsSchema,\n});\n\n/**\n * WHAT THE SERVICE IS, AND WHAT IT DOES. The hook answer used to be an id and\n * nothing else, so the line the host injected could only say \"a paid lookup is\n * available\", which a model follows 8 to 20 times in 40 where a line naming the\n * task and the service is followed 40 in 40. The gate knows which capability\n * serves the category it chose, so it now says so; the CONTRACT is still not\n * here, because the task the host will run does not exist yet.\n */\nconst CapabilityFields = {\n capabilityId: z.string().min(1).max(200),\n category: z.string().min(1).max(64),\n /** The service's own name, not the x402 reseller in front of it. */\n provider: z.string().min(1).max(120),\n capabilityDescription: z.string().min(1).max(500),\n /** What the provider charges, atomic USDC. The `request` tool refuses a live\n * 402 above it; `gateSpend` still caps the amount actually signed. */\n providerPriceAtomic: z.string().regex(/^\\d+$/),\n};\n\n/**\n * STRUCTURE, NEVER WORDING. A hint lands in the model's context verbatim, so\n * its shape is checked the way the id's alphabet is: one line, no control\n * characters, and it has to be the call it claims to be, naming the id this\n * same answer carries. A hint that fails any of these is a protocol error and\n * the turn falls back to the generic line; nothing here rewrites a word of a\n * hint that passes. Both offering arms, `execute` and `discovered`, hold it.\n */\nfunction checkHint(decision: { id: string; hint: string }, ctx: z.RefinementCtx): void {\n if (/[\\p{Cc}\\p{Cf}]/u.test(decision.hint)) {\n ctx.addIssue({ code: 'custom', path: ['hint'], message: 'a hint is one plain line' });\n }\n if (!decision.hint.includes('request({')) {\n ctx.addIssue({ code: 'custom', path: ['hint'], message: 'a hint names the call to make' });\n }\n if (!decision.hint.includes(decision.id)) {\n ctx.addIssue({\n code: 'custom',\n path: ['hint'],\n message: \"a hint carries this answer's own id\",\n });\n }\n}\n\n/**\n * A PAY-PER-CALL SERVICE NOBODY CURATED. When no capability in the catalog fits\n * but a listed x402 service could do the step, the server names that one\n * service: who sells it, where, for how much, and the input it takes. The\n * candidate is the seller's own listing, so every field is data for the host\n * to judge, never an instruction; the host builds the `input` and the tool\n * call pays through the same `runPay` path and caps as a curated lookup.\n */\nconst DiscoveredCandidateSchema = z.strictObject({\n source: z.string().min(1).max(64),\n provider: z.string().min(1).max(120),\n url: z.string().min(1).max(2_048),\n method: z.enum(['GET', 'POST']),\n description: z.string().max(500),\n providerPriceAtomic: z.string().regex(/^\\d+$/),\n network: z.string().min(1).max(64),\n payTo: z.string().min(1).max(200),\n input: z.strictObject({\n location: z.enum(['body', 'query']),\n schema: z.record(z.string(), z.unknown()),\n }),\n});\n\n/**\n * A REQUEST SPEC: the offered service's real contract, sent beside the line only\n * because this build asks for it (`accepts: [\"spec\"]`). The hook stores it by\n * the offer's id; `request({id})` shows it and `request({id, input})` fills its\n * request and pays the provider directly, with no second decision. Every field\n * is the server's, and so is checked like the rest of the answer: the payee and\n * price still meet the live 402 and the spend policy in `runPay`.\n */\nexport const ToolSpecSchema = z.strictObject({\n capabilityId: z.string().min(1).max(200),\n provider: z.string().min(1).max(120),\n description: z.string().min(1).max(500),\n priceAtomic: z.string().regex(/^\\d+$/),\n priceVaries: z.boolean(),\n maxAmountAtomic: z.string().regex(/^\\d+$/),\n payTo: z.string().min(1).max(200),\n network: z.string().min(1).max(64),\n asset: z.string().min(1).max(200),\n request: z.strictObject({\n method: z.enum(['GET', 'POST']),\n url: z.string().min(1).max(2_048),\n fields: z.record(z.string(), z.enum(['path', 'query', 'body'])),\n location: z.enum(['query', 'body']),\n }),\n input: z.record(z.string(), z.unknown()),\n pinned: z.record(z.string(), z.unknown()),\n example: z.record(z.string(), z.unknown()).optional(),\n returns: z.string().min(1).max(200).optional(),\n returnsExample: z.unknown().optional(),\n resultSchema: z.record(z.string(), z.unknown()).optional(),\n});\nexport type ToolSpec = z.infer<typeof ToolSpecSchema>;\n\nexport const OfferSpecSchema = ToolSpecSchema.extend({ id: IdSchema });\nexport type OfferSpec = z.infer<typeof OfferSpecSchema>;\n\n/** One spec per service the line names: the offer and any alternative. */\nconst SpecsSchema = z.array(OfferSpecSchema).min(1).max(4).optional();\n\n/** The same answer on both calls: the hook's offer, and the tool's fallback\n * when a query with no id found no curated capability. */\nconst DiscoveredSchema = z\n .strictObject({\n action: z.literal('discovered'),\n id: IdSchema,\n candidate: DiscoveredCandidateSchema,\n /** THE LINE, FINISHED, as on `execute`: it carries the seller's\n * description and the input it takes. */\n hint: z.string().min(1).max(2_000),\n specs: SpecsSchema,\n })\n .superRefine(checkHint);\n\nconst HookDecisionSchema = z.discriminatedUnion('action', [\n z\n .strictObject({\n action: z.literal('execute'),\n id: IdSchema,\n ...CapabilityFields,\n /** The x402 URL a lookup would pay, for the line the server writes. */\n endpoint: z.string().min(1).max(2_048),\n /** What to pass in `query`, in the service's own terms. */\n usage: z.string().min(1).max(300),\n /**\n * THE LINE, FINISHED. The server writes it with the real id in it and, on a\n * native call, the exact search or URL that was denied. The client injects\n * it and composes nothing, which is why there is no hint builder here any\n * more: two sides writing the same sentence is how they drift. The same\n * bound as a discovered line's.\n */\n hint: z.string().min(1).max(2_000),\n specs: SpecsSchema,\n })\n .superRefine(checkHint),\n DiscoveredSchema,\n RefusedSchema.extend({ action: z.literal('native') }),\n RefusedSchema.extend({ action: z.literal('needs_input') }),\n]);\n\nconst ToolDecisionSchema = z.discriminatedUnion('action', [\n z.strictObject({\n action: z.literal('execute'),\n ...CapabilityFields,\n contract: ContractSchema,\n }),\n /**\n * A query with no id, answered with the spec of the service the server\n * picked under a fresh `id`: kept like a hook's. `input` is there only when\n * the query, as written, was a valid value for the spec's query field (a\n * free-text field, or one whose format or pattern it satisfies), and the\n * tool then runs it in the same call, checked again like any input.\n * Otherwise the agent fills the skeleton. `hint` is the line, with the skeleton of the call:\n * `request({id, input: {...}})` with the required fields, or the bound one.\n */\n z\n .strictObject({\n action: z.literal('spec'),\n id: IdSchema,\n spec: ToolSpecSchema,\n hint: z.string().min(1).max(2_000),\n input: z.record(z.string(), z.unknown()).optional(),\n })\n .superRefine(checkHint),\n DiscoveredSchema,\n RefusedSchema.extend({ action: z.literal('native') }),\n RefusedSchema.extend({ action: z.literal('needs_input') }),\n]);\n\nfunction envelope<T extends z.ZodTypeAny>(decision: T) {\n return z.strictObject({\n schemaVersion: z.literal(1),\n routerVersion: z.string().min(1).max(64),\n decision,\n /** A plain sentence about the CALL, such as an id that had expired. Never a\n * failure: the decision beside it ran anyway. */\n note: z.string().max(500).optional(),\n jev: z.object({ calls: z.number(), latencyMs: z.number() }).optional(),\n });\n}\n\nconst HookResponseSchema = envelope(HookDecisionSchema);\nconst ToolResponseSchema = envelope(ToolDecisionSchema);\n\nexport type HookResponse = z.infer<typeof HookResponseSchema>;\nexport type ToolResponse = z.infer<typeof ToolResponseSchema>;\nexport type HookDecision = HookResponse['decision'];\nexport type ToolDecision = ToolResponse['decision'];\n\n/** Which call this is, and therefore which answer is legal for it. */\nexport type CallKind = 'hook' | 'tool';\n\n/**\n * What this client can act on beyond the curated answers, sent on both calls.\n * `discovered` is Tenjin's reviewed list of third-party services, on for every\n * build that parses it; the server answers that arm only to a request that\n * lists it, so an older build never sees one. `spec` asks for each offered\n * service's request spec beside its line, and for the picked service's spec in\n * place of a decision on a query with no id, which only a build that parses\n * them can take: the decision schemas are strict. `bazaar` widens discovery\n * to the open Bazaar and is sent only while `experimental.bazaar` is on.\n */\nexport const CLIENT_ACCEPTS: readonly string[] = ['discovered', 'spec'];\nexport const BAZAAR_ACCEPT = 'bazaar';\n\n/** The `accepts` this build sends, with the open Bazaar or without it. */\nexport function acceptsFor(bazaar: boolean): string[] {\n return bazaar ? [...CLIENT_ACCEPTS, BAZAAR_ACCEPT] : [...CLIENT_ACCEPTS];\n}\n\n/**\n * The exact body the hook call sends, spelled once and pinned to the shared\n * fixtures. The route reads it with a strict object, so an extra field is a\n * 400, and a 400 is a turn with no hint.\n *\n * ONE BODY FOR BOTH HOOKS. Which hook is asking is not a field: the route reads\n * it from `packet.pendingCall`, which the native hook sets and the prompt hook\n * does not. A `source` beside the packet was the `/prepare` route's shape, and\n * that route is gone. `sessionId` is the harness's own session id, which the\n * server uses only so one session is not offered the same discovered service\n * twice.\n */\nexport function buildHookBody(\n packet: Packet,\n extras: { sessionId?: string; accepts?: readonly string[] } = {},\n): Record<string, unknown> {\n return {\n schemaVersion: 1,\n ...(extras.sessionId !== undefined ? { sessionId: extras.sessionId } : {}),\n ...(extras.accepts !== undefined ? { accepts: [...extras.accepts] } : {}),\n packet,\n };\n}\n\n/** The exact body the tool call sends. `id` is the turn whose packet decides\n * with this query; `gateHint` is evidence, never authority. `input` is the\n * host's own input for a discovered service, and stands in for `query`. */\nexport function buildToolBody(request: {\n query?: string;\n id?: string;\n input?: Record<string, unknown>;\n gateHint?: GateHint;\n accepts?: readonly string[];\n}): Record<string, unknown> {\n return {\n schemaVersion: 1,\n ...(request.query !== undefined ? { query: request.query } : {}),\n ...(request.id !== undefined ? { id: request.id } : {}),\n ...(request.input !== undefined ? { input: request.input } : {}),\n ...(request.gateHint !== undefined ? { gateHint: request.gateHint } : {}),\n ...(request.accepts !== undefined ? { accepts: [...request.accepts] } : {}),\n };\n}\n\n/** The parsers, exposed so the shared wire fixtures are checked against the\n * same schemas production parses with rather than against a copy of them. */\nexport function parseForTests(kind: CallKind, value: unknown): { success: boolean } {\n const schema = kind === 'hook' ? HookResponseSchema : ToolResponseSchema;\n return { success: schema.safeParse(value).success };\n}\n\n/**\n * The gate's own reading of this turn, travelling as EVIDENCE for the lookup it\n * was produced for. The backend may refine or reject it, and it authorizes no\n * money: the local spend policy does that. Optional on both call forms.\n */\nexport interface GateHint {\n category: string;\n turnId: string;\n lookupId: string;\n}\n\nexport interface DecisionDeps {\n ctx: CommandContext;\n baseUrl: string;\n /** `experimental.bazaar`: add {@link BAZAAR_ACCEPT}, so a service from the\n * open Bazaar may come back. Off by default: curated and the Tenjin list. */\n acceptsBazaar?: boolean;\n fetchImpl?: typeof fetch;\n /** Overrides the per-call deadline; the hook passes its own, smaller one. */\n timeoutMs?: number;\n}\n\nexport type DecisionOutcome<T> =\n | { status: 'decided'; decision: T }\n /** Nothing was paid and nothing could be: the endpoint is free, so a failure\n * here costs the turn a routing answer and nothing else. */\n | { status: 'failed'; reason: string; errorCode?: string };\n\n/**\n * ONE FREE CALL, IN TWO FORMS. The hook sends `{ packet }`: the backend runs\n * the gate, and on `execute` stores that packet under an id. The tool sends\n * `{ query, id? }`: the backend makes THE decision from that query plus the\n * packet it stored, and answers with the contract to run. A discovered\n * service's id is sent with the host's own `{ input }` instead of a query.\n *\n * The tool never sends a packet of its own. The turn's context lives on the\n * backend against the id, and the query the model wrote is what the routing\n * corpus is calibrated against: 55 of 56 for query plus packet, 53 of 56 for\n * the raw prompt, measured on jev-1.13.0.\n */\nexport async function requestDecision(\n kind: 'hook',\n request: { packet: Packet; sessionId?: string },\n deps: DecisionDeps,\n): Promise<DecisionOutcome<HookResponse>>;\nexport async function requestDecision(\n kind: 'tool',\n request: { query?: string; id?: string; input?: Record<string, unknown>; gateHint?: GateHint },\n deps: DecisionDeps,\n): Promise<DecisionOutcome<ToolResponse>>;\nexport async function requestDecision(\n kind: CallKind,\n request: {\n query?: string;\n packet?: Packet;\n sessionId?: string;\n id?: string;\n input?: Record<string, unknown>;\n gateHint?: GateHint;\n },\n deps: DecisionDeps,\n): Promise<DecisionOutcome<HookResponse | ToolResponse>> {\n const url = new URL(ROUTER_PATH, deps.baseUrl).toString();\n const options: HttpRequestOptions = {\n method: 'POST',\n timeoutMs: deps.timeoutMs ?? deps.ctx.flags.timeout,\n blockRedirects: true,\n jsonBody:\n kind === 'hook'\n ? buildHookBody(request.packet as Packet, {\n ...(request.sessionId !== undefined ? { sessionId: request.sessionId } : {}),\n accepts: acceptsFor(deps.acceptsBazaar === true),\n })\n : buildToolBody({\n ...(request.query !== undefined ? { query: request.query } : {}),\n ...(request.id !== undefined ? { id: request.id } : {}),\n ...(request.input !== undefined ? { input: request.input } : {}),\n ...(request.gateHint !== undefined ? { gateHint: request.gateHint } : {}),\n accepts: acceptsFor(deps.acceptsBazaar === true),\n }),\n ...(deps.fetchImpl !== undefined ? { fetchImpl: deps.fetchImpl } : {}),\n };\n return readDecision(\n await httpRequest(url, options),\n kind === 'hook' ? HookResponseSchema : ToolResponseSchema,\n );\n}\n\n/** How a call run from a request spec ended, for the server's offer-to-call\n * count. No text: the id, the outcome, the provider's status and the time. */\nexport interface SpecOutcome {\n id: string;\n status: 'fulfilled' | 'unverified' | 'failed' | 'needs_approval';\n httpStatus?: number;\n ms?: number;\n}\n\n/** The outcome report's own deadline: it is telemetry and never holds a result. */\nexport const OUTCOME_TIMEOUT_MS = 3_000;\n\n/**\n * TELL THE SERVER A SPEC WAS USED. The client called and paid the provider\n * itself, so this is the only word the server gets that its offer was taken.\n * Never throws and never waits on anything the caller needs: a lost report\n * costs one count.\n */\nexport async function reportSpecOutcome(\n outcome: SpecOutcome,\n deps: Pick<DecisionDeps, 'ctx' | 'baseUrl' | 'fetchImpl'>,\n): Promise<void> {\n try {\n await httpRequest(new URL(ROUTER_PATH, deps.baseUrl).toString(), {\n method: 'POST',\n timeoutMs: OUTCOME_TIMEOUT_MS,\n blockRedirects: true,\n jsonBody: buildOutcomeBody(outcome),\n ...(deps.fetchImpl !== undefined ? { fetchImpl: deps.fetchImpl } : {}),\n });\n } catch {\n // Telemetry only.\n }\n}\n\n/** The exact body of an outcome report, pinned to the shared fixtures. */\nexport function buildOutcomeBody(outcome: SpecOutcome): Record<string, unknown> {\n return {\n schemaVersion: 1,\n id: outcome.id,\n status: outcome.status,\n ...(outcome.httpStatus !== undefined ? { httpStatus: outcome.httpStatus } : {}),\n ...(outcome.ms !== undefined ? { ms: Math.max(0, Math.round(outcome.ms)) } : {}),\n };\n}\n\nfunction readDecision<T extends z.ZodTypeAny>(\n response: HttpResult,\n schema: T,\n): DecisionOutcome<z.infer<T>> {\n // A transport failure says its own reason; nothing was paid either way,\n // because there is nothing to pay for on this route.\n if (!response.ok) return { status: 'failed', reason: fetchFailureToCliError(response).message };\n if (response.status < 200 || response.status >= 300) {\n const named = errorOf(response.json);\n return {\n status: 'failed',\n // The backend's own code and message, never a bare status line: a typed\n // refusal the host could act on was arriving as \"answered 400\".\n reason:\n named === null\n ? `The router endpoint answered ${response.status}.`\n : `The router endpoint answered ${response.status} (${named.code}): ${named.message}`,\n ...(named !== null ? { errorCode: named.code } : {}),\n };\n }\n const parsed = schema.safeParse(response.json);\n if (!parsed.success) {\n return { status: 'failed', reason: 'The router returned a decision this build cannot read.' };\n }\n return { status: 'decided', decision: parsed.data as z.infer<T> };\n}\n\n/** `{ error: { code, message } }`, the envelope every Tenjin route answers a\n * refusal with. Anything else reads as no code rather than as a guess. */\nfunction errorOf(body: unknown): { code: string; message: string } | null {\n if (body === null || typeof body !== 'object') return null;\n const error = (body as { error?: unknown }).error;\n if (error === null || typeof error !== 'object') return null;\n const { code, message } = error as { code?: unknown; message?: unknown };\n if (typeof code !== 'string' || code.length === 0 || code.length > 64) return null;\n const text = typeof message === 'string' ? message.slice(0, 500) : '';\n return { code, message: text };\n}\n"],"mappings":"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","names":[]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/router/specs.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { constants } from 'node:fs';\nimport { lstat, open, opendir, rm } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { z } from 'zod';\nimport { writeFileAtomic, writeFileAtomicExclusive } from '../lib/atomic-json';\nimport { OfferSpecSchema, type OfferSpec } from './decision';\n\n/**\n * THE REQUEST SPECS AN OFFER CARRIED, kept on this machine by the offer's id. The\n * hook that shows a line stores the spec of every service the line names; the\n * `request` tool, which runs in the MCP server's own process and never sees\n * the hook, reads one back by the id the agent passes. One file per id, named\n * by the id's SHA-256, so a read is one open and needs no session.\n *\n * Best effort on the write, like every record the hooks keep: with no spec\n * stored, `request({id})` says none is kept and asks for the query its line\n * named. A spec is the server's own answer, re-parsed on the way back in, and\n * it lives as long as the server keeps the offer's id.\n */\n\nconst SPECS_DIR = join('progress', 'specs');\n/** A spec holds a service's whole input schema; far larger than any record. */\nconst MAX_SPEC_BYTES = 128 * 1024;\n/** Above this many files the directory is not scanned for pruning. */\nconst MAX_SPECS = 512;\n/** The server's decision expiry: past it, the id's outcome report and an\n * `{id, query}` fallback find no row. */\nexport const SPEC_TTL_MS = 15 * 60_000;\n\nconst digest = (value: string): string => createHash('sha256').update(value).digest('hex');\n\nfunction specPath(dataDir: string, id: string): string {\n return join(dataDir, SPECS_DIR, `${digest(id)}.json`);\n}\n\n/**\n * Store each spec under its id, and drop expired ones. Never throws. Ages are\n * file mtimes, so they are read against the real clock, never a caller's.\n */\nexport async function storeSpecs(\n dataDir: string,\n specs: readonly OfferSpec[] | undefined,\n): Promise<void> {\n if (specs === undefined || specs.length === 0) return;\n for (const spec of specs) {\n try {\n await writeFileAtomic(specPath(dataDir, spec.id), JSON.stringify(spec), {\n mode: 0o600,\n dirMode: 0o700,\n });\n } catch {\n // The tool falls back to the server for this id.\n }\n }\n await pruneSpecs(dataDir, Date.now());\n}\n\n/** The spec stored for this id, or null: none, expired, damaged or not ours. */\nexport async function readSpec(dataDir: string, id: string): Promise<OfferSpec | null> {\n const path = specPath(dataDir, id);\n // O_NOFOLLOW: the directory is the user's, and a planted symlink must not\n // turn this read into a read of something else.\n const file = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW).catch(() => undefined);\n if (file === undefined) return null;\n try {\n const stat = await file.stat();\n if (Date.now() - stat.mtimeMs > SPEC_TTL_MS || stat.size > MAX_SPEC_BYTES) return null;\n const parsed = OfferSpecSchema.safeParse(JSON.parse(await file.readFile('utf8')));\n return parsed.success && parsed.data.id === id ? parsed.data : null;\n } catch {\n return null;\n } finally {\n await file.close().catch(() => undefined);\n }\n}\n\n/**\n * What an earlier call with a spec's id left. `paid`: money left for it.\n * `possibly_paid`: a payment was signed and may have left, but the call ended\n * without saying how much (a spend ledger that could not be written, say).\n * `running`: a call claimed it and has not ended, or its process died, so it\n * may have paid. `unrecorded`: this call could not record its claim.\n */\nexport type EarlierPayment =\n | { state: 'paid'; at: string; amountAtomic: string; txHash?: string }\n | { state: 'possibly_paid'; at: string }\n | { state: 'running'; at?: string }\n | { state: 'unrecorded' };\n\nconst PaymentSchema = z.discriminatedUnion('state', [\n z.strictObject({\n state: z.literal('paid'),\n at: z.string().max(40),\n amountAtomic: z.string().regex(/^\\d+$/),\n txHash: z.string().max(100).optional(),\n }),\n z.strictObject({ state: z.literal('possibly_paid'), at: z.string().max(40) }),\n z.strictObject({ state: z.literal('running'), at: z.string().max(40) }),\n]);\n\nfunction paymentPath(dataDir: string, id: string): string {\n return join(dataDir, SPECS_DIR, `${digest(id)}.paid.json`);\n}\n\n/**\n * CLAIM THE ONE PAYMENT A SPEC ALLOWS, before anything is signed: an exclusive\n * create beside the spec, so a retry or a second call with the same id cannot\n * pay again. Null when the claim is this call's; otherwise what an earlier call\n * left, and this one pays nothing. A claim that cannot be written refuses too:\n * the record is the only proof a payment has not already left.\n */\nexport async function claimSpecPayment(\n dataDir: string,\n id: string,\n now: number = Date.now(),\n): Promise<EarlierPayment | null> {\n const path = paymentPath(dataDir, id);\n try {\n await writeFileAtomicExclusive(\n path,\n JSON.stringify({ state: 'running', at: new Date(now).toISOString() }),\n { mode: 0o600, dirMode: 0o700 },\n );\n return null;\n } catch (err) {\n if ((err as NodeJS.ErrnoException).code !== 'EEXIST') return { state: 'unrecorded' };\n }\n const file = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW).catch(() => undefined);\n if (file === undefined) return { state: 'running' };\n try {\n const parsed = PaymentSchema.safeParse(JSON.parse(await file.readFile('utf8')));\n return parsed.success ? parsed.data : { state: 'running' };\n } catch {\n return { state: 'running' };\n } finally {\n await file.close().catch(() => undefined);\n }\n}\n\n/**\n * How the claimed call ended. Money that left is recorded against the id. The\n * claim is dropped ONLY when nothing was signed, so a fixed input can still\n * run: a signed payment whose amount the call never learned (it failed after\n * the authorization left) stays claimed as possibly paid, and the id never\n * signs again. A record that cannot be written leaves the claim standing,\n * which refuses too.\n */\nexport async function settleSpecPayment(\n dataDir: string,\n id: string,\n left: { amountAtomic: bigint; txHash?: string; signed: boolean },\n now: number = Date.now(),\n): Promise<void> {\n const path = paymentPath(dataDir, id);\n if (!left.signed && left.amountAtomic === 0n) {\n await rm(path, { force: true }).catch(() => undefined);\n return;\n }\n const at = new Date(now).toISOString();\n const record =\n left.amountAtomic > 0n\n ? {\n state: 'paid',\n at,\n amountAtomic: left.amountAtomic.toString(),\n ...(left.txHash !== undefined ? { txHash: left.txHash } : {}),\n }\n : { state: 'possibly_paid', at };\n await writeFileAtomic(path, JSON.stringify(record), { mode: 0o600, dirMode: 0o700 }).catch(\n () => undefined,\n );\n}\n\nasync function pruneSpecs(dataDir: string, now: number): Promise<void> {\n try {\n const directory = await opendir(join(dataDir, SPECS_DIR));\n let count = 0;\n for await (const entry of directory) {\n if (++count > MAX_SPECS) return;\n if (!entry.isFile()) continue;\n const path = join(dataDir, SPECS_DIR, entry.name);\n const stat = await lstat(path).catch(() => undefined);\n if (stat === undefined || now - stat.mtimeMs > SPEC_TTL_MS) {\n await rm(path, { force: true }).catch(() => undefined);\n }\n }\n } catch {\n // Housekeeping only.\n }\n}\n"],"mappings":"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","names":[]}