tenjin-cli 0.1.0-alpha.11 → 0.1.0-alpha.13
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 +236 -596
- package/dist/{buy-THMVOPUH.js → buy-X4VPHFUA.js} +20 -20
- package/dist/{chunk-GKV6VZSZ.js → chunk-3NZCU6SD.js} +7 -7
- package/dist/chunk-3NZCU6SD.js.map +1 -0
- package/dist/{chunk-Y7ERTA7D.js → chunk-3P3ES4XU.js} +4 -6
- package/dist/chunk-3P3ES4XU.js.map +1 -0
- package/dist/{chunk-OZHJ3FLR.js → chunk-47YKYDOF.js} +5 -5
- package/dist/{chunk-IXTENA2H.js → chunk-6JKD46OJ.js} +12 -10
- package/dist/{chunk-IXTENA2H.js.map → chunk-6JKD46OJ.js.map} +1 -1
- package/dist/chunk-736DW4V3.js +65 -0
- package/dist/chunk-736DW4V3.js.map +1 -0
- package/dist/{chunk-IB63U6BM.js → chunk-B676GPS2.js} +34 -11
- package/dist/chunk-B676GPS2.js.map +1 -0
- package/dist/{chunk-4NTZETIL.js → chunk-BRAVLUGI.js} +2 -2
- package/dist/{chunk-UY6CGULW.js → chunk-CA3JV7FX.js} +2 -2
- package/dist/{chunk-UY6CGULW.js.map → chunk-CA3JV7FX.js.map} +1 -1
- package/dist/{chunk-ALUNME53.js → chunk-ELVDOTU7.js} +50 -66
- package/dist/chunk-ELVDOTU7.js.map +1 -0
- package/dist/{chunk-IAFYUFIC.js → chunk-GCGMXA2O.js} +13 -11
- package/dist/{chunk-IAFYUFIC.js.map → chunk-GCGMXA2O.js.map} +1 -1
- package/dist/{chunk-XWHXX2BI.js → chunk-IAR25V2E.js} +6 -6
- package/dist/{chunk-6UY2UQMY.js → chunk-IFPKA32J.js} +4 -4
- package/dist/{chunk-JTYIX6OD.js → chunk-IGHSLJUF.js} +6 -4
- package/dist/{chunk-JTYIX6OD.js.map → chunk-IGHSLJUF.js.map} +1 -1
- package/dist/{chunk-2SDUV6MQ.js → chunk-IKAJSA7E.js} +12 -10
- package/dist/{chunk-2SDUV6MQ.js.map → chunk-IKAJSA7E.js.map} +1 -1
- package/dist/{chunk-NUF2PKJO.js → chunk-J6FUAIRR.js} +4 -6
- package/dist/{chunk-NUF2PKJO.js.map → chunk-J6FUAIRR.js.map} +1 -1
- package/dist/{chunk-CNUXRXI2.js → chunk-JVBMPU5G.js} +5 -7
- package/dist/{chunk-CNUXRXI2.js.map → chunk-JVBMPU5G.js.map} +1 -1
- package/dist/{chunk-VWY3U732.js → chunk-L4XNT3UW.js} +21 -16
- package/dist/chunk-L4XNT3UW.js.map +1 -0
- package/dist/{chunk-EDVI7RRD.js → chunk-NKN4YC5C.js} +6 -6
- package/dist/{chunk-EDVI7RRD.js.map → chunk-NKN4YC5C.js.map} +1 -1
- package/dist/{chunk-P74I3WH4.js → chunk-OC3EIDCP.js} +3 -5
- package/dist/{chunk-P74I3WH4.js.map → chunk-OC3EIDCP.js.map} +1 -1
- package/dist/{chunk-E6YOODH7.js → chunk-OE36HRWG.js} +31 -5
- package/dist/{chunk-E6YOODH7.js.map → chunk-OE36HRWG.js.map} +1 -1
- package/dist/chunk-OUJDDY5L.js +189 -0
- package/dist/chunk-OUJDDY5L.js.map +1 -0
- package/dist/{chunk-6BGYHARE.js → chunk-OWVVI4VQ.js} +15 -15
- package/dist/{chunk-4TCU3YRD.js → chunk-OXUJ3FXU.js} +5 -1
- package/dist/{chunk-4TCU3YRD.js.map → chunk-OXUJ3FXU.js.map} +1 -1
- package/dist/{chunk-PZRAAAY2.js → chunk-PAOVPSP6.js} +10 -3
- package/dist/chunk-PAOVPSP6.js.map +1 -0
- package/dist/{chunk-3GSZUADW.js → chunk-SPUORKD7.js} +3 -3
- package/dist/{chunk-UFPJBS4C.js → chunk-T4UWMVKV.js} +9 -7
- package/dist/{chunk-UFPJBS4C.js.map → chunk-T4UWMVKV.js.map} +1 -1
- package/dist/{chunk-GUUAYR3K.js → chunk-TXVC46SA.js} +8 -8
- package/dist/chunk-TXVC46SA.js.map +1 -0
- package/dist/{chunk-SFGXAZ3M.js → chunk-UUARTUY2.js} +42 -9
- package/dist/chunk-UUARTUY2.js.map +1 -0
- package/dist/{chunk-ZE7KOO7A.js → chunk-WMFRCSNC.js} +8 -8
- package/dist/{chunk-TDDN5GXR.js → chunk-WU5CZPLD.js} +5 -5
- package/dist/{chunk-RSBN67PA.js → chunk-WVHPGQH5.js} +4 -6
- package/dist/{chunk-RSBN67PA.js.map → chunk-WVHPGQH5.js.map} +1 -1
- package/dist/{chunk-PZSUWDF2.js → chunk-XGZ5EVMB.js} +2 -2
- package/dist/{chunk-O25VWJCG.js → chunk-XXY77EZJ.js} +24 -24
- package/dist/{chunk-OCN27NJV.js → chunk-YMUJZWHB.js} +10 -8
- package/dist/{chunk-OCN27NJV.js.map → chunk-YMUJZWHB.js.map} +1 -1
- package/dist/{cli-Y2HBOSGK.js → cli-XK5JZWU6.js} +51 -146
- package/dist/cli-XK5JZWU6.js.map +1 -0
- package/dist/{config-WDGMZKHU.js → config-CNK7MYUR.js} +7 -7
- package/dist/doctor-R7N7FUX5.js +27 -0
- package/dist/{edit-E7N6F3OY.js → edit-QSUEG7CL.js} +19 -19
- package/dist/{fund-OKK627GL.js → fund-JF6A76YS.js} +16 -16
- package/dist/index.js +1 -1
- package/dist/{inspect-573WHEV4.js → inspect-NFNAA4LA.js} +17 -17
- package/dist/{install-SQAYMNQC.js → install-YQVM3SUW.js} +20 -21
- package/dist/{install-SQAYMNQC.js.map → install-YQVM3SUW.js.map} +1 -1
- package/dist/outcome-IUSYFJTN.js +22 -0
- package/dist/{publish-N5U4XYVA.js → publish-O2I6IAEL.js} +20 -20
- package/dist/{read-PJ7Z6UGF.js → read-UF7QVQOU.js} +21 -21
- package/dist/{run-FSO3MMXN.js → run-GDZWHNWZ.js} +30 -30
- package/dist/search-JVOHEF3E.js +23 -0
- package/dist/{send-F34ZDXDZ.js → send-SI254H3R.js} +11 -10
- package/dist/{send-F34ZDXDZ.js.map → send-SI254H3R.js.map} +1 -1
- package/dist/{session-4N4ZT3AH.js → session-GJZJEXLJ.js} +14 -14
- package/dist/{skill-heal-XBEK272G.js → skill-heal-BPFT22XS.js} +5 -6
- package/dist/{skill-heal-XBEK272G.js.map → skill-heal-BPFT22XS.js.map} +1 -1
- package/dist/{uninstall-BTKPHPDL.js → uninstall-7ZZG6WQ5.js} +6 -7
- package/dist/{uninstall-BTKPHPDL.js.map → uninstall-7ZZG6WQ5.js.map} +1 -1
- package/dist/update-FPSBITLB.js +315 -0
- package/dist/update-FPSBITLB.js.map +1 -0
- package/dist/{wallet-UL4P2JRO.js → wallet-NS7TYWNN.js} +5 -6
- package/dist/{wallet-WJ6UP5OU.js → wallet-TZVD2M4I.js} +9 -9
- package/docs/agent-permissions.md +13 -2
- package/docs/command-reference.md +251 -0
- package/docs/safety-model.md +45 -0
- package/package.json +1 -1
- package/skills/tenjin/SKILL.md +3 -3
- package/skills/tenjin-publish/SKILL.md +27 -11
- package/skills/tenjin-search/SKILL.md +14 -13
- package/dist/chunk-2I4QTOLB.js +0 -11
- package/dist/chunk-2I4QTOLB.js.map +0 -1
- package/dist/chunk-ALUNME53.js.map +0 -1
- package/dist/chunk-GKV6VZSZ.js.map +0 -1
- package/dist/chunk-GUUAYR3K.js.map +0 -1
- package/dist/chunk-IB63U6BM.js.map +0 -1
- package/dist/chunk-PZRAAAY2.js.map +0 -1
- package/dist/chunk-SFGXAZ3M.js.map +0 -1
- package/dist/chunk-VWY3U732.js.map +0 -1
- package/dist/chunk-Y7ERTA7D.js.map +0 -1
- package/dist/cli-Y2HBOSGK.js.map +0 -1
- package/dist/doctor-CSIWKWM2.js +0 -27
- package/dist/outcome-W3KYGF23.js +0 -22
- package/dist/search-ZWOP4EGK.js +0 -23
- /package/dist/{buy-THMVOPUH.js.map → buy-X4VPHFUA.js.map} +0 -0
- /package/dist/{chunk-OZHJ3FLR.js.map → chunk-47YKYDOF.js.map} +0 -0
- /package/dist/{chunk-4NTZETIL.js.map → chunk-BRAVLUGI.js.map} +0 -0
- /package/dist/{chunk-XWHXX2BI.js.map → chunk-IAR25V2E.js.map} +0 -0
- /package/dist/{chunk-6UY2UQMY.js.map → chunk-IFPKA32J.js.map} +0 -0
- /package/dist/{chunk-6BGYHARE.js.map → chunk-OWVVI4VQ.js.map} +0 -0
- /package/dist/{chunk-3GSZUADW.js.map → chunk-SPUORKD7.js.map} +0 -0
- /package/dist/{chunk-ZE7KOO7A.js.map → chunk-WMFRCSNC.js.map} +0 -0
- /package/dist/{chunk-TDDN5GXR.js.map → chunk-WU5CZPLD.js.map} +0 -0
- /package/dist/{chunk-PZSUWDF2.js.map → chunk-XGZ5EVMB.js.map} +0 -0
- /package/dist/{chunk-O25VWJCG.js.map → chunk-XXY77EZJ.js.map} +0 -0
- /package/dist/{config-WDGMZKHU.js.map → config-CNK7MYUR.js.map} +0 -0
- /package/dist/{doctor-CSIWKWM2.js.map → doctor-R7N7FUX5.js.map} +0 -0
- /package/dist/{edit-E7N6F3OY.js.map → edit-QSUEG7CL.js.map} +0 -0
- /package/dist/{fund-OKK627GL.js.map → fund-JF6A76YS.js.map} +0 -0
- /package/dist/{inspect-573WHEV4.js.map → inspect-NFNAA4LA.js.map} +0 -0
- /package/dist/{outcome-W3KYGF23.js.map → outcome-IUSYFJTN.js.map} +0 -0
- /package/dist/{publish-N5U4XYVA.js.map → publish-O2I6IAEL.js.map} +0 -0
- /package/dist/{read-PJ7Z6UGF.js.map → read-UF7QVQOU.js.map} +0 -0
- /package/dist/{run-FSO3MMXN.js.map → run-GDZWHNWZ.js.map} +0 -0
- /package/dist/{search-ZWOP4EGK.js.map → search-JVOHEF3E.js.map} +0 -0
- /package/dist/{session-4N4ZT3AH.js.map → session-GJZJEXLJ.js.map} +0 -0
- /package/dist/{wallet-UL4P2JRO.js.map → wallet-NS7TYWNN.js.map} +0 -0
- /package/dist/{wallet-WJ6UP5OU.js.map → wallet-TZVD2M4I.js.map} +0 -0
|
@@ -2,30 +2,32 @@ import { createRequire as __tenjinCreateRequire } from 'node:module'; const requ
|
|
|
2
2
|
import {
|
|
3
3
|
permissionsPointer,
|
|
4
4
|
recommendedPermissions
|
|
5
|
-
} from "./chunk-
|
|
6
|
-
import {
|
|
7
|
-
fetchJson
|
|
8
|
-
} from "./chunk-3GSZUADW.js";
|
|
5
|
+
} from "./chunk-OXUJ3FXU.js";
|
|
9
6
|
import {
|
|
10
7
|
isSessionPresentable,
|
|
11
8
|
readSessionFile,
|
|
12
9
|
scopeSatisfies
|
|
13
|
-
} from "./chunk-
|
|
10
|
+
} from "./chunk-J6FUAIRR.js";
|
|
11
|
+
import {
|
|
12
|
+
fetchJson
|
|
13
|
+
} from "./chunk-SPUORKD7.js";
|
|
14
14
|
import {
|
|
15
15
|
trimSlash,
|
|
16
16
|
tryOriginOf
|
|
17
|
-
} from "./chunk-
|
|
17
|
+
} from "./chunk-XGZ5EVMB.js";
|
|
18
18
|
import {
|
|
19
19
|
walletFileExists
|
|
20
|
-
} from "./chunk-
|
|
20
|
+
} from "./chunk-3P3ES4XU.js";
|
|
21
21
|
import {
|
|
22
22
|
sanitizeForTerminal
|
|
23
|
-
} from "./chunk-
|
|
23
|
+
} from "./chunk-B676GPS2.js";
|
|
24
24
|
import {
|
|
25
|
-
loadRawConfig,
|
|
26
|
-
resolveSettings,
|
|
27
25
|
toMoney
|
|
28
|
-
} from "./chunk-
|
|
26
|
+
} from "./chunk-736DW4V3.js";
|
|
27
|
+
import {
|
|
28
|
+
loadRawConfig,
|
|
29
|
+
resolveSettings
|
|
30
|
+
} from "./chunk-ELVDOTU7.js";
|
|
29
31
|
import {
|
|
30
32
|
configPath,
|
|
31
33
|
sessionPath
|
|
@@ -46,10 +48,10 @@ import {
|
|
|
46
48
|
readSkillFile,
|
|
47
49
|
resolveSkillsSource,
|
|
48
50
|
shadowedCliSkills
|
|
49
|
-
} from "./chunk-
|
|
51
|
+
} from "./chunk-OC3EIDCP.js";
|
|
50
52
|
import {
|
|
51
53
|
CliError
|
|
52
|
-
} from "./chunk-
|
|
54
|
+
} from "./chunk-PAOVPSP6.js";
|
|
53
55
|
|
|
54
56
|
// src/commands/doctor.ts
|
|
55
57
|
import { styleText } from "util";
|
|
@@ -265,6 +267,9 @@ async function checkSkills(home, which, requested, skillsSourceDir) {
|
|
|
265
267
|
status: "warn",
|
|
266
268
|
required: false,
|
|
267
269
|
detail: `${CLI_SKILL_NAMES.join(" + ")} wired, but this build's packaged copies could not be read, so whether they are current is unknown`,
|
|
270
|
+
// NOT `tenjin update`: this warning means the packaged copies are
|
|
271
|
+
// unreadable, which a current version answers with "up to date" and no
|
|
272
|
+
// work at all. Reinstalling the same version is the actual repair.
|
|
268
273
|
fix: "Reinstall the CLI: `npm i -g tenjin-cli`, then `tenjin install`.",
|
|
269
274
|
data
|
|
270
275
|
}
|
|
@@ -514,7 +519,7 @@ async function checkReadPath(baseUrl, timeoutMs, fetchImpl) {
|
|
|
514
519
|
async function checkWallet(ctx, deps, env, rpcUrl) {
|
|
515
520
|
const provider = deps.provider ?? await resolveLocalProviderOrNull(ctx, env, deps);
|
|
516
521
|
if (provider === null) return [noWalletCheck()];
|
|
517
|
-
const { describeWallet } = await import("./wallet-
|
|
522
|
+
const { describeWallet } = await import("./wallet-NS7TYWNN.js");
|
|
518
523
|
let desc;
|
|
519
524
|
try {
|
|
520
525
|
desc = await describeWallet(provider);
|
|
@@ -533,7 +538,7 @@ async function resolveLocalProviderOrNull(ctx, env, deps) {
|
|
|
533
538
|
const envKey = env.TENJIN_WALLET_KEY;
|
|
534
539
|
const envKeySet = typeof envKey === "string" && envKey.length > 0;
|
|
535
540
|
if (!envKeySet && !await walletFileExists(ctx.dataDir)) return null;
|
|
536
|
-
const { resolveWalletProvider } = await import("./wallet-
|
|
541
|
+
const { resolveWalletProvider } = await import("./wallet-NS7TYWNN.js");
|
|
537
542
|
return resolveWalletProvider(ctx, {
|
|
538
543
|
...deps.walletPassphrase !== void 0 ? { passphrase: deps.walletPassphrase } : {}
|
|
539
544
|
});
|
|
@@ -671,4 +676,4 @@ export {
|
|
|
671
676
|
isNoWalletCheck,
|
|
672
677
|
renderDoctorHuman
|
|
673
678
|
};
|
|
674
|
-
//# sourceMappingURL=chunk-
|
|
679
|
+
//# sourceMappingURL=chunk-L4XNT3UW.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/commands/doctor.ts"],"sourcesContent":["import { styleText } from 'node:util';\nimport { Stream } from 'node:stream';\nimport { homedir } from 'node:os';\nimport { join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { resolveSkillsSource } from '../lib/skills-source';\nimport { CliError } from '../lib/errors';\nimport {\n CLI_SKILL_NAMES,\n HOSTED_SKILL_NAME,\n anyTenjinSkill,\n cliSkillsWired,\n detectHarnesses,\n harnessFlagFor,\n harnessInPlay,\n harnessReads,\n harnessRequested,\n missingCliSkills,\n onPath,\n readAllWiring,\n readSkillFile,\n shadowedCliSkills,\n} from '../lib/skill-wiring';\nimport type {\n DirState,\n HarnessTarget,\n HarnessWiring,\n NotInvocableReason,\n} from '../lib/skill-wiring';\nimport { fetchJson } from '../lib/http';\nimport { loadRawConfig, resolveSettings } from '../lib/config';\nimport { tryOriginOf, trimSlash } from '../lib/url';\nimport { configPath, sessionPath } from '../lib/paths';\nimport { toMoney } from '../lib/money';\nimport { walletFileExists } from '../lib/wallet/store';\nimport { isSessionPresentable, readSessionFile, scopeSatisfies } from '../lib/session-present';\nimport { sanitizeForTerminal } from '../lib/output';\nimport { permissionsPointer, recommendedPermissions } from '../lib/permissions';\nimport type { PartialConfig } from '../lib/config';\nimport type { ErrorCode } from '../schemas';\nimport type { Io } from '../lib/output';\nimport type {\n PassphraseOverrides,\n WalletDescription,\n WalletProvider,\n WalletVerification,\n} from '../lib/wallet';\nimport type { CommandContext, CommandResult } from '../context';\n\n/**\n * One environment/reachability check. The doctor agent builds the check list\n * against this shape without changing it: `required` drives the exit code (exit\n * 0 iff every required check is ok), `status` drives the TTY rendering, and a\n * `fix` is mandatory on every failure (spec 10). Warn-level checks never fail\n * the command.\n */\nexport interface CheckResult {\n name: string;\n status: 'ok' | 'warn' | 'fail';\n required: boolean;\n detail: string;\n fix?: string;\n /**\n * Optional structured payload for machine consumers, so `--json` carries the\n * check's findings as data instead of only as the prose in `detail`. Additive\n * and per-check; the human renderer ignores it.\n */\n data?: unknown;\n}\n\n/** ~$20 in atomic USDC (6 decimals). Above this, the pocket-money wallet warns. */\nconst POCKET_MONEY_CEILING_ATOMIC = 20_000_000n;\n\n/**\n * `doctor` is an allowlisted verb an unattended agent runs on its own, and its\n * `fix:` lines reach that agent both on the TTY and in `error.details.checks`.\n * So they name the CONFIGURED base URL and the operator command that changes it,\n * never `--base-url`: the flag rides every allowlisted verb (see FLAG_CAVEAT in\n * lib/permissions), and a fix line telling the agent to pass it would be the CLI\n * coaching the exact move the skills forbid. `config set` is not allowlisted, so\n * pointing there routes the change through the operator by construction.\n */\nconst FIX_POINT_AT_TENJIN_API =\n 'Point the configured base URL at a Tenjin API (expected an OpenAPI document): `tenjin config set baseUrl <url>`.';\nconst FIX_CHECK_NETWORK_AND_BASE_URL =\n 'Check your network connection and the configured base URL (`tenjin config get baseUrl`).';\n\n/**\n * A CheckResult plus the error code to raise if it is a *required* failure. Only\n * required checks carry a `failCode`; the outcome step raises the first one, so\n * the failure envelope's `error.code` names what actually broke (api-contract\n * unreachable vs malformed differ) while still carrying the whole check list.\n */\ninterface BuiltCheck {\n result: CheckResult;\n failCode?: ErrorCode;\n}\n\nexport interface DoctorDeps {\n /** Environment for wallet-key detection and settings precedence. */\n env?: NodeJS.ProcessEnv;\n /** Injected fetch for the reachability checks; tests pass a canned stub. */\n fetchImpl?: typeof fetch;\n /** Inject the active wallet provider. When set, NO local fs/env is consulted —\n * the provider owns its own describe() and diagnostics(), so a remote provider's\n * checks can't be contaminated by a stale local wallet file. */\n provider?: WalletProvider;\n /** Home directory root for the skill-wiring check. Defaults to os.homedir(); tests\n * (and `install`, which reuses these checks) inject their own. */\n homeDir?: string;\n /** PATH probe for the `claude`/`codex` binaries, half of harness detection. Defaults\n * to probing `env.PATH`, so a test passing `env: {}` detects neither. */\n which?: (bin: string) => boolean;\n /** Clock seam (ms since epoch) for the session-expiry check. */\n now?: () => number;\n /** Packaged skills to compare the wired copies against; defaults to this build's. */\n skillsSourceDir?: string;\n /**\n * Passphrase seams for the wallet verification (#70), which reads the OS\n * credential store. Tests inject a platform with no store, or a stubbed exec,\n * so no assertion here depends on what is in the developer's real keychain.\n */\n walletPassphrase?: Omit<PassphraseOverrides, 'isTTY'>;\n}\n\n/**\n * The full check list plus the first required failure, if any. `install` reuses\n * this to run the doctor checks as its last step and EMBED the summary without\n * throwing (D39: doctor is diagnostics, it never blocks the caller); `runDoctor`\n * wraps it and turns a required failure into the thrown failure envelope.\n */\nexport interface DoctorChecks {\n checks: CheckResult[];\n failure?: { code: ErrorCode; result: CheckResult };\n}\n\nexport async function collectDoctorChecks(\n ctx: CommandContext,\n deps: DoctorDeps = {},\n): Promise<DoctorChecks> {\n const env = deps.env ?? process.env;\n const { config, check: configCheck } = await loadConfigForDoctor(ctx.dataDir);\n const settings = resolveSettings({ config, flags: { baseUrl: ctx.flags.baseUrl }, env });\n const baseUrl = settings.baseUrl.value;\n\n const built: BuiltCheck[] = [\n checkNode(),\n configCheck,\n await checkApiContract(baseUrl, ctx.flags.timeout, deps.fetchImpl),\n await checkReadPath(baseUrl, ctx.flags.timeout, deps.fetchImpl),\n await checkSearchContract(baseUrl, ctx.flags.timeout, deps.fetchImpl),\n await checkSkills(\n deps.homeDir ?? homedir(),\n deps.which ?? ((bin) => onPath(bin, env)),\n config.install?.harness ?? [],\n deps.skillsSourceDir,\n ),\n await checkSession(ctx.dataDir, deps.now ?? Date.now, tryOriginOf(baseUrl)),\n ];\n\n // The wallet/custody/balance checks all come from the ACTIVE provider: it owns\n // describe() and diagnostics(), so doctor never runs its own fs/env probe.\n for (const result of await checkWallet(ctx, deps, env, settings.rpcUrl.value)) {\n built.push({ result });\n }\n\n const checks = built.map((b) => b.result);\n const firstFail = built.find((b) => b.result.required && b.result.status === 'fail');\n if (firstFail === undefined) return { checks };\n return { checks, failure: { code: firstFail.failCode ?? 'INTERNAL', result: firstFail.result } };\n}\n\nexport async function runDoctor(\n ctx: CommandContext,\n deps: DoctorDeps = {},\n): Promise<CommandResult> {\n const { checks, failure } = await collectDoctorChecks(ctx, deps);\n if (failure !== undefined) {\n const r = failure.result;\n // The allowlist rides on the FAILURE envelope too. An operator whose fresh\n // install is broken is the likeliest one to be reading doctor output at all,\n // and the earlier version dropped the block on exactly that path while the\n // comment below claimed otherwise. The human failure path still renders only\n // the error and its fix (that is emitFailure's contract, not doctor's), so\n // the machine payload is where this has to land.\n throw new CliError(failure.code, r.detail, {\n ...(r.fix !== undefined ? { fix: r.fix } : {}),\n details: { checks, permissions: recommendedPermissions() },\n });\n }\n\n // The discoverability surface for the auto-mode denial problem (#33), now one\n // line rather than the ~60 that used to bury the check list this command was\n // run for: an operator whose agent just got denied still learns the allowlist\n // exists and where to get it. It reports nothing about the local machine, so it\n // is deliberately NOT a check: it can never pass or fail. `--json` is unchanged\n // and still carries the whole recommendation as data.\n return {\n data: { status: 'pass', checks, permissions: recommendedPermissions() },\n humanLines: [...renderDoctorHuman(ctx.io, checks), '', permissionsPointer()],\n };\n}\n\nfunction checkNode(): BuiltCheck {\n const version = process.versions.node;\n const major = Number.parseInt(version.split('.')[0] ?? '0', 10);\n if (major >= 22) {\n return { result: { name: 'node', status: 'ok', required: true, detail: `Node ${version}` } };\n }\n return {\n result: {\n name: 'node',\n status: 'fail',\n required: true,\n detail: `Node ${version} is unsupported (need >= 22)`,\n fix: 'Install Node 22 or newer',\n },\n failCode: 'NODE_UNSUPPORTED',\n };\n}\n\n/**\n * loadRawConfig throws CONFIG_INVALID on a bad file (which we convert into a\n * failing check) but the config value is also needed for baseUrl/rpcUrl\n * resolution; an invalid file falls back to {} so the reachability checks still\n * run and appear in the list, and config is reported as the first required fail.\n */\nasync function loadConfigForDoctor(\n dataDir: string,\n): Promise<{ config: PartialConfig; check: BuiltCheck }> {\n try {\n const config = await loadRawConfig(dataDir);\n const detail =\n Object.keys(config).length === 0\n ? 'No config file; using defaults'\n : `Config at ${configPath(dataDir)} is valid`;\n return { config, check: { result: { name: 'config', status: 'ok', required: true, detail } } };\n } catch (err) {\n if (err instanceof CliError && err.code === 'CONFIG_INVALID') {\n return {\n config: {},\n check: {\n result: {\n name: 'config',\n status: 'fail',\n required: true,\n detail: err.message,\n ...(err.fix !== undefined ? { fix: err.fix } : {}),\n },\n failCode: 'CONFIG_INVALID',\n },\n };\n }\n throw err;\n }\n}\n\nasync function checkApiContract(\n baseUrl: string,\n timeoutMs: number,\n fetchImpl?: typeof fetch,\n): Promise<BuiltCheck> {\n const url = `${trimSlash(baseUrl)}/openapi.json`;\n const res = await fetchJson(url, { timeoutMs, fetchImpl });\n if (!res.ok) {\n const malformed = res.kind === 'invalid-json';\n return {\n result: {\n name: 'api-contract',\n status: 'fail',\n required: true,\n detail: malformed\n ? `OpenAPI document at ${url} was not valid JSON`\n : `Could not reach the Tenjin API at ${url}: ${res.message}`,\n fix: malformed ? FIX_POINT_AT_TENJIN_API : FIX_CHECK_NETWORK_AND_BASE_URL,\n },\n failCode: malformed ? 'CONTRACT_MISMATCH' : 'API_UNREACHABLE',\n };\n }\n const version = infoVersion(res.json);\n if (version === undefined) {\n return {\n result: {\n name: 'api-contract',\n status: 'fail',\n required: true,\n detail: `OpenAPI document at ${url} is missing a string info.version`,\n fix: FIX_POINT_AT_TENJIN_API,\n },\n failCode: 'CONTRACT_MISMATCH',\n };\n }\n return {\n result: {\n name: 'api-contract',\n status: 'ok',\n required: true,\n detail: `Tenjin API ${version} at ${baseUrl}`,\n },\n };\n}\n\n/**\n * WARN-level (never fails doctor): is the A2 search endpoint advertised in the\n * OpenAPI doc? Absent means the deployment predates A2 (the buy/search path will\n * not work against it yet). Warn-only because doctor's job is a working READ path,\n * and search is additive.\n */\nasync function checkSearchContract(\n baseUrl: string,\n timeoutMs: number,\n fetchImpl?: typeof fetch,\n): Promise<BuiltCheck> {\n const url = `${trimSlash(baseUrl)}/openapi.json`;\n const res = await fetchJson(url, { timeoutMs, fetchImpl });\n if (!res.ok) {\n return {\n result: {\n name: 'search-contract',\n status: 'warn',\n required: false,\n detail: `Could not confirm the search endpoint at ${url}`,\n fix: 'Check the configured base URL (`tenjin config get baseUrl`); search/buy need the A2 endpoints deployed.',\n },\n };\n }\n const present = hasSearchPath(res.json);\n return {\n result: present\n ? {\n name: 'search-contract',\n status: 'ok',\n required: false,\n detail: 'Search endpoint advertised',\n }\n : {\n name: 'search-contract',\n status: 'warn',\n required: false,\n detail: 'This deployment does not advertise POST /api/agent/search (A2 not deployed)',\n fix: 'search/buy need A2 deployed; point the configured base URL at a deploy that has it (`tenjin config set baseUrl <url>`).',\n },\n };\n}\n\nfunction hasSearchPath(json: unknown): boolean {\n if (!isRecord(json)) return false;\n const paths = json.paths;\n return isRecord(paths) && '/api/agent/search' in paths;\n}\n\n/**\n * WARN-level (never fails doctor): is the harness skill wiring usable? #35 was\n * invisible without a screen recording, because the publish skill was on disk yet\n * the model never saw it and only the hosted skill answered publish asks.\n *\n * Verdicts are per DIRECTORY, never unioned across them — in EITHER direction.\n * Unioning the problems contradicts itself on a real machine: a Claude-only install\n * leaves a stray hosted skill in ~/.agents/skills, and flat-mapping announced both\n * CLI skills \"missing\" in the same sentence that listed them wired. Unioning the\n * successes is the same bug inverted, and worse: Claude Code reads ~/.claude/skills\n * and Codex reads ~/.agents/skills, so a wired .agents cannot answer for .claude,\n * and asking whether SOME directory is wired reported `ok` on a machine where\n * `tenjin-publish` was unreachable from Claude Code — exactly the #35 shape.\n *\n * So each directory is judged alone, and only when a harness on this machine\n * actually reads it (`harnessReads`, the probes `install` picks targets with). That\n * gate is what keeps a leftover mirror quiet: a hosted-only ~/.agents/skills with no\n * Codex is nobody's problem, while a hosted-only ~/.claude/skills with Claude Code\n * installed is the bug.\n *\n * Warn and never required: a CI or server machine legitimately has no harness, so\n * this must not move the exit code.\n */\n/**\n * `requested` is the `--harness` set a past `install` recorded (config `install.harness`).\n * It joins detection in deciding which directories are in play, and rides in the data as\n * its own field so `harnessPresent` keeps meaning \"a harness detected here reads this\".\n */\nasync function checkSkills(\n home: string,\n which: (bin: string) => boolean,\n requested: readonly HarnessTarget[],\n skillsSourceDir?: string,\n): Promise<BuiltCheck> {\n const present = detectHarnesses(home, which);\n const wiring = await readAllWiring(home);\n const data = {\n directories: wiring.map((w) => ({\n ...w,\n harnessPresent: harnessReads(home, w.dir, present),\n requested: harnessRequested(home, w.dir, requested),\n })),\n };\n const inPlay = wiring.filter((w) => anyTenjinSkill(w));\n\n if (inPlay.length === 0) {\n // Same fixFor path every other branch uses, over the same harnessInPlay\n // predicate (detected OR requested) — filtering on `requested` alone named\n // only the recorded directory and left a DETECTED one unwired, which just\n // swapped which directory the first command missed. Gated on\n // `requested.length > 0` so a machine with no record at all keeps the plain\n // `tenjin install` rather than newly spelling out a detected harness that\n // nobody asked to see named.\n const targeted =\n requested.length > 0\n ? wiring.filter((w) => harnessInPlay(home, w.dir, present, requested))\n : [];\n return {\n result: {\n name: 'skills',\n status: 'warn',\n required: false,\n detail: `No Tenjin skills wired under ${home} (looked in .claude/skills and .agents/skills)`,\n fix: targeted.length > 0 ? fixFor(home, targeted) : 'tenjin install',\n data,\n },\n };\n }\n\n // Every directory in play must carry BOTH CLI skills, model-invocable. Anything less\n // is the defect, whether it is shadowed, half-installed, hosted-only or absent; a\n // directory neither detected nor asked for is described but never warned about.\n const broken = wiring.filter(\n (w) => harnessInPlay(home, w.dir, present, requested) && !cliSkillsWired(w),\n );\n if (broken.length > 0) {\n return {\n result: {\n name: 'skills',\n status: 'warn',\n required: false,\n detail: `${broken.map(describeProblem).join('; ')}. Full state: ${describeWiring(inPlay)}`,\n fix: fixFor(home, broken),\n data,\n },\n };\n }\n\n // Wired is not the same as CURRENT. `npm i -g tenjin-cli` updates the binary and\n // nothing else, so the copies install wrote stay at whatever version wrote them\n // until someone re-runs install, and every check above passes the whole time.\n //\n // EVERY directory, not just the ones in play. The checks above ask what a\n // harness on this machine reads; this one has to cover what the self-heal\n // writes, which is any directory holding one of our adapters. A ~/.agents/skills\n // that fell out of play (a fallback install, then Claude Code arrives) is where\n // the heal keeps working and, when it cannot, keeps quiet: reporting a narrower\n // set than it writes would leave a stale directory nothing ever names.\n const { stale, verifiable } = await compareWiredSkills(\n wiring.map((w) => w.dir),\n skillsSourceDir,\n );\n if (!verifiable) {\n return {\n result: {\n name: 'skills',\n status: 'warn',\n required: false,\n detail: `${CLI_SKILL_NAMES.join(' + ')} wired, but this build's packaged copies could not be read, so whether they are current is unknown`,\n // NOT `tenjin update`: this warning means the packaged copies are\n // unreadable, which a current version answers with \"up to date\" and no\n // work at all. Reinstalling the same version is the actual repair.\n fix: 'Reinstall the CLI: `npm i -g tenjin-cli`, then `tenjin install`.',\n data,\n },\n };\n }\n if (stale.length > 0) {\n return {\n result: {\n name: 'skills',\n status: 'warn',\n required: false,\n detail: `${CLI_SKILL_NAMES.join(' + ')} wired but not from this CLI build (${stale.join(', ')}); agents are reading an older version's instructions`,\n // fixFor, like every neighbouring branch: a plain `tenjin install` targets\n // DETECTED harnesses only, so for a directory that exists because someone\n // passed --harness it would be a fix that never clears the warning.\n fix: fixFor(\n home,\n wiring.filter((w) => stale.includes(w.dir)),\n ),\n data,\n },\n };\n }\n\n return {\n result: {\n name: 'skills',\n status: 'ok',\n required: false,\n detail: `${CLI_SKILL_NAMES.join(' + ')} wired: ${describeWiring(inPlay)}`,\n data,\n },\n };\n}\n\n/**\n * How the wired CLI adapter skills compare to the packaged ones.\n *\n * `verifiable` is false when this build cannot read its own packaged copies, which\n * is a broken package rather than evidence of no drift; reporting that as current\n * would make the check quietly green on exactly the install doctor should describe.\n *\n * Only the ADAPTERS are compared: the hosted mirror is a copy of\n * tenjin.blog/skills.md that an operator may legitimately have re-fetched newer\n * than this package ships.\n *\n * This is also where a skill the post-command self-heal could NOT rewrite\n * surfaces. That writer stays silent about its failures on purpose: a cause it\n * cannot clear (an unwritable skills directory) would otherwise print the same\n * line on every command forever. Stale here means exactly that, and the fix names\n * the harness. For the handoff to hold, the CALLER has to pass every directory\n * the heal can reach, not only the ones a detected harness reads.\n */\nasync function compareWiredSkills(\n dirs: readonly string[],\n sourceDir?: string,\n): Promise<{ stale: string[]; verifiable: boolean }> {\n let source: string;\n try {\n source = sourceDir ?? resolveSkillsSource(fileURLToPath(new URL('.', import.meta.url)));\n } catch {\n return { stale: [], verifiable: false };\n }\n // Read once, not once per directory.\n const packaged = new Map<string, Buffer>();\n for (const name of CLI_SKILL_NAMES) {\n const read = await readSkillFile(join(source, name, 'SKILL.md'));\n if (read.kind === 'ok') packaged.set(name, read.bytes);\n }\n if (packaged.size !== CLI_SKILL_NAMES.length) return { stale: [], verifiable: false };\n\n const stale: string[] = [];\n for (const dir of dirs) {\n for (const name of CLI_SKILL_NAMES) {\n // Guarded: a pipe or device at this path would otherwise block the whole\n // diagnostic. Anything but a readable regular file is the wiring check's\n // business, not this one's.\n const onDisk = await readSkillFile(join(dir, name, 'SKILL.md'));\n if (onDisk.kind !== 'ok') continue;\n if (!packaged.get(name)!.equals(onDisk.bytes)) {\n stale.push(dir);\n break;\n }\n }\n }\n return { stale, verifiable: true };\n}\n\n/** What is wrong in ONE directory, naming the directory and the skills. */\nfunction describeProblem(w: HarnessWiring): string {\n const shadowed = shadowedCliSkills(w);\n const missing = missingCliSkills(w);\n const parts: string[] = [];\n // Grouped BY REASON, not into one clause: the two claims differ in strength. A\n // readable file with the flag set is a fact; an unreadable one is a disjunction,\n // because the whole reason we cannot assert the flag is that we could not read it.\n // Merging them would spread that hedge onto a skill we know the answer for.\n const unreadable = shadowed.filter((n) => reasonFor(w, n) === 'unreadable');\n const disabled = shadowed.filter((n) => reasonFor(w, n) !== 'unreadable');\n if (disabled.length > 0) {\n parts.push(\n `${disabled.join(', ')} installed but not model-invocable (disable-model-invocation: true)`,\n );\n }\n if (unreadable.length > 0) {\n parts.push(\n `${unreadable.join(', ')} installed but not model-invocable (unreadable or disable-model-invocation: true)`,\n );\n }\n // Naming both by name reads as a half-install; when NEITHER is there the state is\n // \"this harness has no CLI skills at all\", which is a different sentence.\n if (missing.length === CLI_SKILL_NAMES.length) {\n parts.push(\n w.state === 'hosted-only'\n ? `the hosted ${HOSTED_SKILL_NAME} skill is here but neither CLI skill is wired`\n : 'neither CLI skill is wired',\n );\n } else if (missing.length > 0) parts.push(`${missing.join(', ')} missing`);\n return `${w.dir}: ${parts.join(' and ')}`;\n}\n\nfunction reasonFor(w: HarnessWiring, name: string): NotInvocableReason | undefined {\n return w.skills.find((s) => s.name === name)?.reason;\n}\n\n/** Is the hosted zero-install mirror in THIS directory? */\nfunction hostedHere(w: HarnessWiring): boolean {\n return w.skills.find((s) => s.name === HOSTED_SKILL_NAME)?.present === true;\n}\n\n/**\n * A fix that can actually clear the warning. A bare `tenjin install` only targets\n * the directories detection picks, so a problem in ~/.agents/skills on a\n * Claude-only machine needs `--harness shared` spelled out.\n */\nfunction fixFor(home: string, dirs: HarnessWiring[]): string {\n const flags = [...new Set(dirs.map((w) => harnessFlagFor(home, w.dir)))];\n return `tenjin install ${flags.map((f) => `--harness ${f}`).join(' ')}`;\n}\n\n/** One-line per-directory summary: `<dir> -> <skills> (<posture>)`. */\nfunction describeWiring(wiring: HarnessWiring[]): string {\n return wiring\n .map((w) => {\n const parts = w.skills\n .filter((s) => s.present)\n .map((s) =>\n s.modelInvocable === false ? `${s.name} [${s.reason ?? 'shadowed'}]` : s.name,\n );\n return `${w.dir} -> ${parts.join(', ')} (${posture(w)})`;\n })\n .join('; ');\n}\n\n/**\n * The precedence half of the `wired` posture is only true when there is a mirror\n * here to take precedence OVER. `classify` keys `wired` off the two CLI skills\n * alone, so a directory whose mirror was deleted is `wired` with no `tenjin` in it,\n * and the unconditional string claimed a file the same line had just not listed.\n */\nfunction posture(w: HarnessWiring): string {\n if (w.state !== 'wired') return POSTURE[w.state];\n return hostedHere(w)\n ? 'CLI skills wired, take precedence over the hosted mirror'\n : 'CLI skills wired';\n}\n\nconst POSTURE: Record<DirState, string> = {\n empty: 'no Tenjin skills',\n 'hosted-only': 'hosted skill only, no CLI skills here',\n partial: 'only one CLI skill',\n // \"at least one\": a directory with one CLI skill shadowed and the other absent\n // classifies as `shadowed` too, and \"CLI skills present\" would be false there.\n shadowed: 'at least one CLI skill present but not model-invocable',\n wired: 'CLI skills wired, take precedence over the hosted mirror',\n};\n\n/**\n * The delegated session key `tenjin read` presents to recover a piece this wallet\n * already owns (`tenjin session start --scope read` mints it). Never required and\n * never a fail — `read` works without one — so ABSENT is `ok`: the normal\n * posture, not a defect. So are the states that are ordinary decay rather than\n * damage: an older CLI's file, a spent 24h expiry, a scope that does not cover\n * reading. One command re-mints all of them, and a check that yellowed on them\n * would be permanently yellow on any machine that ever minted a key.\n *\n * A genuine fault still warns, and the states are kept apart on purpose. A 0600 file\n * that is now group-readable, or one whose contents no longer parse, is a TAMPER\n * signal on a wallet-derived credential; `loadSessionFile` fails closed on both\n * and collapses them to \"no session\", which is the right instruction for a caller\n * that can re-mint and exactly the wrong report for the verb an operator runs\n * when something looks wrong. `readSessionFile` keeps them distinguishable and\n * this is the one caller that needs them.\n *\n * An unreadable file (EACCES after a `sudo` run, EIO) warns rather than throwing:\n * doctor is diagnostics, and a session cache nobody asked about must never take\n * down the run that was going to explain the rest of the machine.\n *\n * Reports address / origin / scope / expiry and nothing else. The delegation and\n * the private JWK never reach this output — doctor's payload is the single most\n * likely thing in this CLI to be pasted into an issue.\n */\nasync function checkSession(\n dataDir: string,\n now: () => number,\n origin: string | null,\n): Promise<BuiltCheck> {\n const warn = (detail: string, data?: unknown): BuiltCheck => ({\n result: {\n name: 'session',\n status: 'warn',\n required: false,\n detail,\n fix: 'tenjin session start --scope read',\n ...(data !== undefined ? { data } : {}),\n },\n });\n\n const state = await readSessionFile(dataDir);\n if (state.kind === 'absent') {\n return {\n result: {\n name: 'session',\n status: 'ok',\n required: false,\n detail:\n 'No session key; `tenjin read` delivers free and locally-cached pieces (`tenjin session start --scope read` adds owned-piece recovery)',\n },\n };\n }\n if (state.kind === 'loosened') {\n return warn(\n `Session key at ${sessionPath(dataDir)} is mode 0${state.mode.toString(8)}, not 0600, so it is refused; it holds a wallet-derived credential and was changed out of band. Delete it and re-mint`,\n );\n }\n // Same standing as `absent`: a cache this CLI cannot use, re-minted by one\n // command. A failing check here meant a permanent post-update warning.\n if (state.kind === 'outdated') {\n return {\n result: {\n name: 'session',\n status: 'ok',\n required: false,\n detail: `Cached session key at ${sessionPath(dataDir)} predates this CLI version (no \\`${state.field}\\`) and is not used; \\`tenjin session start --scope read\\` mints a current one`,\n },\n };\n }\n if (state.kind === 'corrupt') {\n return warn(`Session key at ${sessionPath(dataDir)} could not be parsed (${state.reason})`);\n }\n if (state.kind === 'unreadable') {\n return warn(`Session key at ${sessionPath(dataDir)} could not be read: ${state.message}`);\n }\n\n const file = state.file;\n // A base URL that is not an http(s) origin cannot be compared against, and this\n // is the diagnostic verb: it reports that and keeps going. The `config` check\n // above owns the fix for the value itself.\n if (origin === null) {\n return {\n result: {\n name: 'session',\n status: 'warn',\n required: false,\n detail: `Session key was minted for ${file.origin}, but the configured base URL is not an http(s) origin, so it cannot be matched`,\n fix: 'Set an absolute http(s) base URL: `tenjin config set baseUrl <url>`.',\n data: { address: file.address, origin: file.origin, scope: file.scope, exp: file.exp },\n },\n };\n }\n const data = { address: file.address, origin: file.origin, scope: file.scope, exp: file.exp };\n if (file.origin !== origin) {\n return warn(\n `Session key was minted for ${file.origin}, but the configured base URL is ${origin}; it is not presented off its own origin`,\n data,\n );\n }\n // Expiry and scope are DESIGNED DECAY, not faults. A delegation lives 24h by\n // construction, so warning on a spent one made every machine that ever ran\n // `tenjin session start` permanently yellow for behaving exactly as intended —\n // the same permanent-warning trap `outdated` above was already pulled out of.\n // Both are re-minted by the one command named in the detail. An expiry that\n // does not PARSE is a different thing and stays a warning: that is a malformed\n // file, not a spent one.\n if (!Number.isFinite(Date.parse(file.exp))) {\n return warn(\n `Session key for ${file.address} carries an unparseable expiry (exp ${file.exp})`,\n data,\n );\n }\n if (!scopeSatisfies(file.scope, 'read')) {\n return {\n result: {\n name: 'session',\n status: 'ok',\n required: false,\n detail: `Session key has scope ${file.scope}, which does not cover reading; \\`tenjin session start --scope read\\` mints one that does`,\n data,\n },\n };\n }\n if (!isSessionPresentable(file, now(), 'read', origin)) {\n return {\n result: {\n name: 'session',\n status: 'ok',\n required: false,\n detail:\n 'Session key expired (normal after 24h); mint one with `tenjin session start --scope read` when you want free re-reads of owned pieces',\n data,\n },\n };\n }\n return {\n result: {\n name: 'session',\n status: 'ok',\n required: false,\n detail: `Session key ${file.address}, scope ${file.scope}, for ${file.origin}, expires ${file.exp}`,\n data,\n },\n };\n}\n\nasync function checkReadPath(\n baseUrl: string,\n timeoutMs: number,\n fetchImpl?: typeof fetch,\n): Promise<BuiltCheck> {\n // The shipped public read path. The A2 search-contract check is a B2 follow-up.\n // Probe the UNFILTERED listing: the server logs every nonblank first-page `q`\n // as agent search demand, so a `q` here would fabricate that demand into the\n // experiment this CLI exists to measure. Never add a `q` to this probe.\n const url = `${trimSlash(baseUrl)}/api/articles?limit=1`;\n const res = await fetchJson(url, { timeoutMs, fetchImpl });\n if (!res.ok) {\n return {\n result: {\n name: 'read-path',\n status: 'fail',\n required: true,\n detail: `Read path ${url} failed: ${res.message}`,\n fix: FIX_CHECK_NETWORK_AND_BASE_URL,\n },\n failCode: 'API_UNREACHABLE',\n };\n }\n const items = isRecord(res.json) ? res.json.items : undefined;\n if (!Array.isArray(items)) {\n return {\n result: {\n name: 'read-path',\n status: 'fail',\n required: true,\n detail: `Read path ${url} did not return an items array`,\n fix: 'Point the configured base URL at a Tenjin API: `tenjin config set baseUrl <url>`.',\n },\n failCode: 'API_UNREACHABLE',\n };\n }\n return {\n result: { name: 'read-path', status: 'ok', required: true, detail: `Read path OK at ${url}` },\n };\n}\n\n/**\n * Diagnose the wallet the CLI would actually use, entirely through the ACTIVE\n * provider. An injected provider owns everything — no local file or env is touched.\n * With no injected provider we do ONE cheap fs/env probe purely to decide whether\n * any credential exists: none → emit the \"no wallet\" warn WITHOUT importing the\n * wallet lib (that import statically pulls viem, and a no-wallet run must not parse\n * it). Otherwise the provider describes itself (address + source), PROVES the\n * credential can sign when it can do so without prompting (#70), reports its own\n * custody warnings, and the balance probes describe()'s address. A custody problem\n * (bad key, provider refusal) is warn-level, never a hard fail.\n */\nasync function checkWallet(\n ctx: CommandContext,\n deps: DoctorDeps,\n env: NodeJS.ProcessEnv,\n rpcUrl: string,\n): Promise<CheckResult[]> {\n const provider = deps.provider ?? (await resolveLocalProviderOrNull(ctx, env, deps));\n if (provider === null) return [noWalletCheck()];\n\n const { describeWallet } = await import('../lib/wallet');\n let desc: WalletDescription;\n try {\n desc = await describeWallet(provider);\n } catch (err) {\n if (err instanceof CliError && err.code === 'WALLET_MISSING') return [noWalletCheck()];\n return [walletWarn(err)];\n }\n\n const checks: CheckResult[] = [walletCheck(desc, await verifyWallet(provider))];\n // Custody warnings are the provider's own (perms, env-shadow for the local\n // provider; none for a remote one). Render each as a warn check; the fix text,\n // when there is one, is carried inline in the warning string.\n for (const warning of (await provider.diagnostics()).warnings) {\n checks.push({ name: 'wallet-custody', status: 'warn', required: false, detail: warning });\n }\n checks.push(await checkBalance(desc.address, rpcUrl));\n return checks;\n}\n\n/**\n * The active local provider, or null when no credential exists at all. The null\n * path never imports the wallet lib, keeping a no-wallet doctor run off viem.\n */\nasync function resolveLocalProviderOrNull(\n ctx: CommandContext,\n env: NodeJS.ProcessEnv,\n deps: DoctorDeps,\n): Promise<WalletProvider | null> {\n const envKey = env.TENJIN_WALLET_KEY;\n const envKeySet = typeof envKey === 'string' && envKey.length > 0;\n if (!envKeySet && !(await walletFileExists(ctx.dataDir))) return null;\n const { resolveWalletProvider } = await import('../lib/wallet');\n return resolveWalletProvider(ctx, {\n ...(deps.walletPassphrase !== undefined ? { passphrase: deps.walletPassphrase } : {}),\n });\n}\n\n/**\n * Ask the provider to prove the credential can sign (#70). A provider without a\n * `verify` is not a failure and not a pass: it is the `unverified` state, same as\n * a keystore whose passphrase only a human could supply. A provider that throws\n * is treated the same way — doctor reports what it could not establish and keeps\n * going; it never turns a diagnostic's own failure into a verdict about the\n * wallet.\n */\nasync function verifyWallet(provider: WalletProvider): Promise<WalletVerification> {\n if (provider.verify === undefined) {\n return {\n status: 'unverified',\n detail: `provider \"${provider.id}\" cannot verify without a key`,\n };\n }\n try {\n return await provider.verify();\n } catch (err) {\n return {\n status: 'unverified',\n detail: `verification could not run (${err instanceof Error ? err.message : String(err)})`,\n };\n }\n}\n\n/**\n * The wallet check, with the verification folded INTO its status rather than\n * reported beside it. #70 was exactly a green `wallet` line above an unopenable\n * keystore, so an `ok` here has to mean the key is usable, not merely that a file\n * parsed. Still never `required` and never a `fail`: a wallet nobody can open is\n * a real problem, but `read` and `search` work without one, so it must not move\n * the exit code.\n */\nfunction walletCheck(desc: WalletDescription, v: WalletVerification): CheckResult {\n const head = `Wallet ${desc.address} (${desc.credentialSource})`;\n if (v.status === 'broken') {\n return {\n name: 'wallet',\n status: 'warn',\n required: false,\n detail: `${head}: ${v.detail}`,\n fix: v.fix,\n };\n }\n if (v.status === 'unverified') {\n return {\n name: 'wallet',\n status: 'warn',\n required: false,\n detail: `${head} present, not verified: ${v.detail}`,\n fix: 'Set TENJIN_WALLET_PASSPHRASE, or store the passphrase in your OS credential store, so doctor can prove the keystore still opens.',\n };\n }\n return { name: 'wallet', status: 'ok', required: false, detail: `${head}, ${v.detail}` };\n}\n\nfunction noWalletCheck(): CheckResult {\n return {\n name: 'wallet',\n status: 'warn',\n required: false,\n detail: 'No wallet; needed only for buy/publish',\n fix: 'tenjin wallet create',\n data: { credential: 'absent' },\n };\n}\n\n/**\n * Is this the check that says there is no credential at all? `install` prints its\n * own line for that state and drops the duplicate, so it has to recognise THIS\n * check and not merely one named `wallet`: a warn about a credential that exists\n * and does not work (an unopenable keystore, an invalid TENJIN_WALLET_KEY) shares\n * the name and is the one wallet state nothing else in install's output carries.\n */\nexport function isNoWalletCheck(c: CheckResult): boolean {\n return c.name === 'wallet' && isRecord(c.data) && c.data.credential === 'absent';\n}\n\nfunction walletWarn(err: unknown): CheckResult {\n return {\n name: 'wallet',\n status: 'warn',\n required: false,\n detail: err instanceof Error ? err.message : String(err),\n ...(err instanceof CliError && err.fix !== undefined ? { fix: err.fix } : {}),\n };\n}\n\n/**\n * Balance is best-effort: a zero balance is a fundable warning and an RPC flake\n * must never fail doctor. viem loads only here, via a lazy import, so a doctor\n * run without a wallet never parses the viem chunk.\n */\nasync function checkBalance(address: string, rpcUrl: string): Promise<CheckResult> {\n try {\n const { getUsdcBalance } = await import('../lib/usdc');\n const balance = await getUsdcBalance(address as `0x${string}`, rpcUrl);\n if (balance === 0n) {\n return {\n name: 'balance',\n status: 'warn',\n required: false,\n detail: 'Wallet USDC balance is 0',\n fix: 'Fund it with `tenjin fund` (card via Coinbase), or send USDC on Base. $5 covers ~50 typical resources.',\n };\n }\n const money = toMoney(balance.toString());\n // Pocket-money posture (roadmap B2): a plaintext-adjacent local key should\n // hold only small change, so a balance over ~$20 is a warn, not an error.\n if (balance > POCKET_MONEY_CEILING_ATOMIC) {\n return {\n name: 'balance',\n status: 'warn',\n required: false,\n detail: `Balance ${money.usd} USDC is above the ~$20 pocket-money ceiling`,\n fix: 'Keep only small change in the CLI wallet; sweep the excess to cold storage.',\n };\n }\n return {\n name: 'balance',\n status: 'ok',\n required: false,\n detail: `Balance ${money.usd} USDC (${money.atomic} atomic)`,\n };\n } catch (err) {\n return {\n name: 'balance',\n status: 'warn',\n required: false,\n detail: `Could not read balance: ${err instanceof Error ? err.message : String(err)}`,\n fix: 'Check rpcUrl or retry; a balance read failure never fails doctor.',\n };\n }\n}\n\nexport function renderDoctorHuman(io: Io, checks: CheckResult[]): string[] {\n const nameWidth = Math.max(...checks.map((c) => c.name.length));\n const lines: string[] = [];\n for (const c of checks) {\n const icon =\n c.status === 'ok'\n ? paint(io, 'green', '✓')\n : c.status === 'warn'\n ? paint(io, 'yellow', '!')\n : paint(io, 'red', '✗');\n // `detail` and `fix` interpolate SERVER-sourced strings (the OpenAPI\n // info.version, a provider's error text), so a newline or ANSI in a hostile\n // deployment's version string could forge extra lines here — including a\n // convincing closing pointer at a URL of its choosing. Sanitize at the render\n // seam: output.ts exempts doctor on the assumption it only paints its OWN\n // text, which has not been true since these lines began carrying server text.\n lines.push(\n `${icon} ${c.name.padEnd(nameWidth)} ${paint(io, 'dim', sanitizeForTerminal(c.detail))}`,\n );\n if (c.status !== 'ok' && c.fix !== undefined) {\n lines.push(` ${paint(io, 'dim', `fix: ${sanitizeForTerminal(c.fix)}`)}`);\n }\n }\n return lines;\n}\n\n/**\n * Color for stderr, honoring NO_COLOR and the target's color depth: styleText\n * takes the stderr stream when it is a genuine Stream (it throws on anything\n * else, so a test/redirected sink falls back to the default plain check).\n */\nfunction paint(io: Io, format: Parameters<typeof styleText>[0], text: string): string {\n if (io.stdout instanceof Stream) return styleText(format, text, { stream: io.stdout });\n return styleText(format, text);\n}\n\nfunction infoVersion(json: unknown): string | undefined {\n if (!isRecord(json)) return undefined;\n const info = json.info;\n if (!isRecord(info)) return undefined;\n return typeof info.version === 'string' ? info.version : undefined;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === 'object' && value !== null;\n}\n"],"mappings":"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","names":["data"]}
|
|
@@ -1,18 +1,18 @@
|
|
|
1
1
|
import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
|
|
2
2
|
import {
|
|
3
3
|
httpRequest
|
|
4
|
-
} from "./chunk-
|
|
4
|
+
} from "./chunk-SPUORKD7.js";
|
|
5
5
|
import {
|
|
6
6
|
trimSlash
|
|
7
|
-
} from "./chunk-
|
|
7
|
+
} from "./chunk-XGZ5EVMB.js";
|
|
8
8
|
import {
|
|
9
9
|
ATOMIC_RE,
|
|
10
10
|
UUID_RE
|
|
11
|
-
} from "./chunk-
|
|
11
|
+
} from "./chunk-736DW4V3.js";
|
|
12
12
|
import {
|
|
13
13
|
CliError,
|
|
14
14
|
external_exports
|
|
15
|
-
} from "./chunk-
|
|
15
|
+
} from "./chunk-PAOVPSP6.js";
|
|
16
16
|
|
|
17
17
|
// src/lib/agent-api.ts
|
|
18
18
|
var FRESH_WITHIN_RE = /^P(\d+)[DWMY]$/;
|
|
@@ -283,7 +283,7 @@ async function postOutcomes(searchId, items, opts) {
|
|
|
283
283
|
fix: "Report between 1 and 10 outcomes per call."
|
|
284
284
|
});
|
|
285
285
|
}
|
|
286
|
-
const url = `${trimSlash(opts.baseUrl)}/api/
|
|
286
|
+
const url = `${trimSlash(opts.baseUrl)}/api/searches/${searchId}/outcomes`;
|
|
287
287
|
const res = await httpRequest(url, {
|
|
288
288
|
method: "POST",
|
|
289
289
|
timeoutMs: opts.timeoutMs,
|
|
@@ -314,4 +314,4 @@ export {
|
|
|
314
314
|
buildOutcomeItem,
|
|
315
315
|
postOutcomes
|
|
316
316
|
};
|
|
317
|
-
//# sourceMappingURL=chunk-
|
|
317
|
+
//# sourceMappingURL=chunk-NKN4YC5C.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/lib/agent-api.ts"],"sourcesContent":["import { z } from 'zod';\nimport { CliError } from './errors';\nimport { httpRequest, type HttpResult } from './http';\nimport { ATOMIC_RE, UUID_RE } from './ids';\nimport { trimSlash } from './url';\n\n/**\n * The search + outcome HTTP contract (A2, tenjin#370). Request building and\n * response validation live here; the wire shape is validated defensively, an\n * unknown `schemaVersion` degrades to a parse refusal rather than a guess, and\n * unrecognized candidate fields are ignored (forward-compatible), per spec 10.\n *\n * These endpoints are anonymous: no wallet, no SIWX. The shared transport's\n * User-Agent is what attributes a later purchase back to the search flow.\n */\n\nconst FRESH_WITHIN_RE = /^P(\\d+)[DWMY]$/;\nconst CANONICAL_KEY_RE = /^[a-z][a-z0-9_]{0,31}$/;\n\n/** The server's `limit` ceiling. Exported because the truncation advice in\n * `search` has to name it: past search v2 the response budget scales with the\n * candidates returned, so a truncated page is recovered by asking for MORE, and\n * this is the value to ask for. One definition, so the cap the CLI enforces and\n * the number it tells the operator to retry with cannot drift apart. */\nexport const MAX_LIMIT = 10;\n\n/** Client-side search request (mirrors the server lookupRequestSchema bounds\n * so a malformed flag fails locally as USAGE, before a round trip). */\nexport interface SearchInput {\n question: string;\n freshWithin?: string;\n maxPrice?: string;\n appliesTo?: Record<string, string[]>;\n limit?: number;\n}\n\nexport interface SearchRequestBody {\n schemaVersion: 2;\n question: string;\n freshWithin?: string;\n maxPrice?: string;\n appliesTo?: Record<string, string[]>;\n limit: number;\n}\n\nexport function buildSearchRequest(input: SearchInput): SearchRequestBody {\n const question = input.question.trim();\n if (question.length === 0 || question.length > 512) {\n throw new CliError('USAGE', 'question must be 1 to 512 characters', {\n fix: 'Pass a non-empty question under 512 characters.',\n });\n }\n if (input.freshWithin !== undefined) {\n // The server rejects ANY zero-valued duration (P0D, P0W, P00M, ...), so a\n // zero window fails here as USAGE instead of a remote 400.\n const digits = FRESH_WITHIN_RE.exec(input.freshWithin)?.[1];\n if (digits === undefined || Number(digits) === 0) {\n throw new CliError('USAGE', `Invalid --fresh-within: ${JSON.stringify(input.freshWithin)}`, {\n fix: 'Use a nonzero ISO-like window P<n>[DWMY], e.g. P30D, P2W, P1Y.',\n });\n }\n }\n if (input.maxPrice !== undefined && !ATOMIC_RE.test(input.maxPrice)) {\n throw new CliError('USAGE', `Invalid --max-price: ${JSON.stringify(input.maxPrice)}`, {\n fix: 'Pass an atomic USDC integer, e.g. 100000 for $0.10.',\n });\n }\n const limit = input.limit ?? 5;\n if (!Number.isInteger(limit) || limit < 1 || limit > MAX_LIMIT) {\n throw new CliError('USAGE', `Invalid --limit: ${JSON.stringify(input.limit)}`, {\n fix: `Pass an integer between 1 and ${MAX_LIMIT}.`,\n });\n }\n if (input.appliesTo !== undefined) {\n // Mirror the server's strictObject bounds (<=8 keys, <=20 values/key,\n // 1..120 chars/value) so a bad filter fails locally, never as a remote 400.\n const keys = Object.keys(input.appliesTo);\n if (keys.length > 8) {\n throw new CliError('USAGE', 'Too many --applies-to keys (max 8).');\n }\n for (const [key, values] of Object.entries(input.appliesTo)) {\n if (!CANONICAL_KEY_RE.test(key)) {\n throw new CliError('USAGE', `Invalid appliesTo key: ${JSON.stringify(key)}`, {\n fix: 'Keys must be canonical lowercase identifiers, e.g. products=Vercel.',\n });\n }\n if (values.length === 0) {\n throw new CliError('USAGE', `appliesTo key ${JSON.stringify(key)} has no values`, {\n fix: 'Give each --applies-to key at least one value.',\n });\n }\n if (values.length > 20) {\n throw new CliError('USAGE', `Too many --applies-to values for ${key} (max 20).`);\n }\n for (const value of values) {\n if (value.length === 0 || value.length > 120) {\n throw new CliError(\n 'USAGE',\n `Invalid --applies-to value for ${key}: must be 1 to 120 characters.`,\n );\n }\n }\n }\n }\n return {\n schemaVersion: 2,\n question,\n ...(input.freshWithin !== undefined ? { freshWithin: input.freshWithin } : {}),\n ...(input.maxPrice !== undefined ? { maxPrice: input.maxPrice } : {}),\n ...(input.appliesTo !== undefined ? { appliesTo: input.appliesTo } : {}),\n limit,\n };\n}\n\n// Response schemas. `.passthrough()` on the candidate keeps unknown future fields\n// instead of stripping them (forward-compatible), while still requiring the\n// contract fields this CLI reads. `decision` is uppercase on the wire.\n//\n// A candidate is a LEAN hit (search v2): identity, price, freshness and why it\n// matched, and nothing more. The full answer card is one free unpaid GET of `url`\n// away, which is what `tenjin inspect` does, so breadth here costs no depth there.\nexport const searchCandidateSchema = z\n .object({\n resourceId: z.string().regex(UUID_RE, 'resourceId must be a uuid'),\n url: z.string(),\n slug: z.string(),\n title: z.string(),\n artifactType: z.string(),\n price: z.string().regex(ATOMIC_RE, 'price must be an atomic integer string'),\n asOf: z.string().nullable(),\n validUntil: z.string().nullable(),\n matchReasons: z.array(z.string()),\n estimatedTokens: z.number(),\n creator: z.object({ handle: z.string() }).passthrough(),\n })\n .passthrough();\n\nexport type SearchCandidate = z.infer<typeof searchCandidateSchema>;\n\n/** Per-field caps for a browse pointer's free-form strings. `url` gets its own,\n * looser bound so a legitimate read URL is never mangled while an invented one\n * still cannot run away. Declared above the schema because the schema enforces\n * the `url` bound at parse time (see below). */\nconst BROWSE_BOUNDS = { title: 200, url: 512, handle: 64 } as const;\n\n// A browse pointer, carried ONLY on a MISS (tenjin#460): a piece from the broad\n// discoverable corpus with deliberately NO matchReasons, NO estimatedTokens and\n// no confidence field. It is a \"you might browse this\" hint, never a scored\n// answer candidate, so it is kept strictly out of `candidates` and never\n// recorded in the local search store.\n//\n// That store exclusion makes `inspect`/`buy`/`outcome` unreachable BY\n// `resourceId` (resolveResourceRef's uuid arm needs a store hit and fails with\n// RESOURCE_NOT_FOUND), but NOT by url: resolveResourceRef's URL arm is gated on\n// origin alone and never consults the store, so `tenjin buy <browse url>` does\n// pay. That is by design here, since the url is the payable read endpoint and\n// the contract re-emits it verbatim, but it is a real spend path, so the human\n// hint line carries the price and every spend gate still applies. Do not\n// restate the old \"never reachable by inspect/buy/outcome\" claim: it was false.\n//\n// A malformed pointer fails the WHOLE response into CONTRACT_MISMATCH rather\n// than being dropped. Deliberate: this client is fail-closed on every other\n// contract deviation, and silently swallowing a bad tail would hide server\n// drift that contract.test.ts exists to catch. Pinned in agent-api.test.ts.\n//\n// The `url` bound is enforced HERE rather than by truncation in the projection\n// below, and that asymmetry with `title`/`handle` is deliberate. Those two are\n// display strings: clipping one degrades gracefully and the human still reads\n// something true. `url` is an actionable payable pointer, and a clipped url is\n// not a shorter url, it is a DIFFERENT and broken one that still looks payable\n// in `--json`. Refusing is also the only ordering-independent answer: capping\n// first would hand the origin assertion in `runSearch` a string the server never\n// sent. 512 is far above any real read endpoint, so exceeding it is server drift.\nexport const searchBrowseSchema = z\n .object({\n resourceId: z.string().regex(UUID_RE, 'resourceId must be a uuid'),\n url: z.string().max(BROWSE_BOUNDS.url, `url must be at most ${BROWSE_BOUNDS.url} characters`),\n title: z.string(),\n price: z.string().regex(ATOMIC_RE, 'price must be an atomic integer string'),\n creator: z.object({ handle: z.string() }).passthrough(),\n })\n .passthrough();\n\nexport type SearchBrowse = z.infer<typeof searchBrowseSchema>;\n\nexport const searchResponseSchema = z.object({\n schemaVersion: z.literal(2),\n searchId: z.string().regex(UUID_RE, 'searchId must be a uuid'),\n decision: z.enum(['CANDIDATES', 'MISS']),\n calibration: z.string(),\n candidates: z.array(searchCandidateSchema).optional(),\n // Set only when the server's size backstop dropped trailing candidates the\n // requested limit had room for; omitted entirely otherwise. There is no cursor,\n // so a retry at a SMALLER limit returns strictly fewer rows; the ceiling scales\n // with the candidates returned, so a LARGER limit (up to MAX_LIMIT) is what\n // recovers the tail, and at MAX_LIMIT the tail is unrecoverable and narrowing the\n // question is the remedy. `runSearch` picks the half that applies.\n truncated: z.literal(true).optional(),\n // Omitted entirely by the server when empty, and only ever present on a MISS.\n // Not enforced here (a stricter schema would reject an otherwise-usable\n // response); truncateResponse drops it on a CANDIDATES decision instead.\n browse: z.array(searchBrowseSchema).optional(),\n});\n\nexport type SearchResponse = z.infer<typeof searchResponseSchema>;\n\nexport interface AgentApiOptions {\n baseUrl: string;\n timeoutMs: number;\n fetchImpl?: typeof fetch;\n /** Spec 09 §3 evaluation-cohort opt-in: sends X-Tenjin-Eval-Cohort: 1. */\n evalCohort?: boolean;\n}\n\n/** Turn a non-2xx / transport HttpResult into the CLI error contract. */\nfunction apiFailure(url: string, result: Exclude<HttpResult, { ok: true }>): CliError {\n const code =\n result.kind === 'network' || result.kind === 'timeout' ? 'NETWORK_ERROR' : 'API_UNREACHABLE';\n return new CliError(code, `${url}: ${result.message}`, {\n fix: 'Check your network and the configured base URL (`tenjin config get baseUrl`), then retry.',\n });\n}\n\n/** 429 with Retry-After: a recoverable pause, not an outage; agents branch on it. */\nexport function rateLimitError(\n url: string,\n header: (name: string) => string | undefined,\n): CliError {\n const retryAfter = header('retry-after');\n const seconds = retryAfter !== undefined ? Number(retryAfter) : undefined;\n return new CliError('RATE_LIMITED', `${url}: rate limited by the server.`, {\n fix:\n seconds !== undefined && Number.isFinite(seconds)\n ? `Retry after ${seconds}s.`\n : 'Back off and retry shortly.',\n details: {\n ...(seconds !== undefined && Number.isFinite(seconds) ? { retryAfterSeconds: seconds } : {}),\n },\n });\n}\n\nfunction serverErrorMessage(json: unknown): string | undefined {\n if (typeof json === 'object' && json !== null) {\n const rec = json as Record<string, unknown>;\n const err = rec.error;\n if (typeof err === 'string') return err;\n if (typeof err === 'object' && err !== null) {\n const m = (err as Record<string, unknown>).message;\n if (typeof m === 'string') return m;\n }\n if (typeof rec.message === 'string') return rec.message;\n }\n return undefined;\n}\n\nexport async function postSearch(\n body: SearchRequestBody,\n opts: AgentApiOptions,\n): Promise<SearchResponse> {\n const url = `${trimSlash(opts.baseUrl)}/api/agent/search`;\n const res = await httpRequest(url, {\n method: 'POST',\n timeoutMs: opts.timeoutMs,\n headers: opts.evalCohort === true ? { 'x-tenjin-eval-cohort': '1' } : {},\n jsonBody: body,\n fetchImpl: opts.fetchImpl,\n });\n if (!res.ok) throw apiFailure(url, res);\n if (res.status === 429) throw rateLimitError(url, (n) => res.header(n));\n if (res.status !== 200) {\n // The REQUEST gate is where a pre-v2 server actually refuses us, and it is\n // the arm that fires in practice. Old tenjin declares `schemaVersion:\n // z.literal(1)` inside a strictObject, so a v2 request never reaches the\n // handler: it comes back 400 \"Invalid request body\" with the zod flatten in\n // `error.details`, and the response check further down can never see it.\n // Without this the operator is told to retry a request that cannot succeed.\n if (res.status === 400 && rejectedSchemaVersion(res.json)) {\n throw outdatedServerError('The server rejected schemaVersion 2: it predates search v2.', {\n details: res.json,\n });\n }\n throw new CliError(\n 'API_UNREACHABLE',\n serverErrorMessage(res.json) ?? `Search failed (${res.status})`,\n {\n fix: 'Retry; if it persists the search endpoint may be unavailable.',\n details: res.json,\n },\n );\n }\n const parsed = searchResponseSchema.safeParse(res.json);\n if (!parsed.success) {\n // The other way a stale server surfaces: it answered 200 with a v1 body.\n // Unreachable against today's old tenjin (the request gate above refuses\n // first), but correct for anything that accepts the request and replies v1.\n const served = serverSchemaVersion(res.json);\n if (served !== undefined && served !== 2) {\n throw outdatedServerError(\n `Search response is schemaVersion ${served}; this CLI requires 2 (search v2).`,\n { details: parsed.error.issues },\n );\n }\n throw new CliError('CONTRACT_MISMATCH', 'Search response did not match the expected contract', {\n fix: 'Update tenjin-cli; the server contract may have changed.',\n details: parsed.error.issues,\n });\n }\n return truncateResponse(parsed.data);\n}\n\n/** One wording for both ways a pre-v2 server refuses this CLI, so the request-gate\n * arm and the response arm can never drift apart. */\nfunction outdatedServerError(message: string, opts: { details: unknown }): CliError {\n return new CliError('CONTRACT_MISMATCH', message, {\n fix: 'The server predates search v2. Point the configured base URL (`tenjin config set baseUrl`) at an updated deployment, or install an older tenjin-cli.',\n details: opts.details,\n });\n}\n\n/** True when a 400 body is the old server's request-gate refusal of our\n * `schemaVersion`: an ApiError envelope whose zod `flatten()` details carry a\n * `schemaVersion` fieldError. Keyed on the field, never the message text. */\nfunction rejectedSchemaVersion(json: unknown): boolean {\n const record = (v: unknown): Record<string, unknown> | undefined =>\n typeof v === 'object' && v !== null ? (v as Record<string, unknown>) : undefined;\n const fieldErrors = record(record(record(json)?.error)?.details)?.fieldErrors;\n return Array.isArray(record(fieldErrors)?.schemaVersion);\n}\n\n/** The `schemaVersion` an unparsed body claims, when it claims a number at all. */\nfunction serverSchemaVersion(json: unknown): number | undefined {\n if (typeof json !== 'object' || json === null) return undefined;\n const v = (json as { schemaVersion?: unknown }).schemaVersion;\n return typeof v === 'number' ? v : undefined;\n}\n\n/**\n * The server bounds every free-form candidate string (spec 09); re-apply the same\n * caps defensively so a misbehaving server cannot blow up an agent transcript\n * through the CLI (spec 10 response-size discipline).\n *\n * `slug` is deliberately absent: it is an identifier, not display text, so\n * clipping it would not shorten it but change it into a slug that resolves to\n * nothing while still looking usable in `--json`. The server tolerates an\n * uncapped slug for the same reason (that is the one case its `truncated` flag\n * exists for), so capping here would fail on a response the server calls valid.\n */\nconst CAND_BOUNDS = {\n title: 200,\n matchReasons: 3,\n matchReasonChars: 80,\n} as const;\n\nconst cap = (s: string, n: number): string => (s.length > n ? s.slice(0, n) : s);\n\nfunction truncateResponse(res: SearchResponse): SearchResponse {\n const out: SearchResponse = { ...res };\n if (res.candidates !== undefined) out.candidates = res.candidates.map(truncateCandidate);\n // Browse pointers ride the same defensive discipline, and then some. The\n // schema is `.passthrough()` so a server-invented key would otherwise survive\n // at unbounded length into `--json` and MCP structuredContent; we rebuild each\n // pointer explicitly from the five contract fields instead of spreading, which\n // drops unknown keys and is what makes the contract.test.ts \"no score-like\n // field\" pin hold at runtime and not just against the fixture. Count is capped\n // at the server's BROWSE_MAX, and every free-form string (title, url, handle)\n // at its own bound.\n //\n // `browse` is MISS-only by contract; drop it outright on a CANDIDATES decision\n // rather than trust the server, since humanLines renders no hint line there and\n // it would otherwise be an unrendered channel of server text and payable urls.\n if (res.browse !== undefined && res.decision === 'MISS') {\n out.browse = res.browse.slice(0, BROWSE_MAX).map((b) => ({\n resourceId: b.resourceId,\n // Not capped: the schema already refused anything over BROWSE_BOUNDS.url,\n // so this is the url the server sent, verbatim and payable.\n url: b.url,\n title: cap(b.title, BROWSE_BOUNDS.title),\n price: b.price,\n creator: { handle: cap(b.creator.handle, BROWSE_BOUNDS.handle) },\n }));\n } else {\n delete out.browse;\n }\n return out;\n}\n\n/** Mirrors the server's BROWSE_MAX (lib/search-browse.ts): a MISS carries at\n * most three browse pointers. */\nconst BROWSE_MAX = 3;\n\nfunction truncateCandidate(c: SearchCandidate): SearchCandidate {\n return {\n ...c,\n title: cap(c.title, CAND_BOUNDS.title),\n matchReasons: c.matchReasons\n .slice(0, CAND_BOUNDS.matchReasons)\n .map((r) => cap(r, CAND_BOUNDS.matchReasonChars)),\n };\n}\n\nconst OUTCOME_STATUSES = [\n 'used',\n 'partially_used',\n 'rejected',\n 'regenerated',\n 'purchase_declined',\n] as const;\nexport type OutcomeStatus = (typeof OUTCOME_STATUSES)[number];\nexport const OUTCOME_STATUS_VALUES: readonly string[] = OUTCOME_STATUSES;\n\nconst CONTENT_HASH_RE = /^sha256:[0-9a-f]{64}$/;\n\nexport interface OutcomeInput {\n status: string;\n resourceId?: string;\n contentHash?: string;\n}\n\nexport interface OutcomeBodyItem {\n status: OutcomeStatus;\n resourceId?: string;\n contentHash?: string;\n}\n\nexport function buildOutcomeItem(input: OutcomeInput): OutcomeBodyItem {\n if (!OUTCOME_STATUS_VALUES.includes(input.status)) {\n throw new CliError('USAGE', `Invalid outcome status: ${JSON.stringify(input.status)}`, {\n fix: `Use one of: ${OUTCOME_STATUSES.join(', ')}.`,\n });\n }\n if (input.resourceId !== undefined && !UUID_RE.test(input.resourceId)) {\n throw new CliError('USAGE', `Invalid --resource id: ${JSON.stringify(input.resourceId)}`, {\n fix: 'Pass the resourceId (a uuid) from a search candidate.',\n });\n }\n if (input.contentHash !== undefined && !CONTENT_HASH_RE.test(input.contentHash)) {\n throw new CliError('USAGE', `Invalid content hash: ${JSON.stringify(input.contentHash)}`, {\n fix: 'A content hash is \"sha256:<64 hex>\".',\n });\n }\n return {\n status: input.status as OutcomeStatus,\n ...(input.resourceId !== undefined ? { resourceId: input.resourceId } : {}),\n ...(input.contentHash !== undefined ? { contentHash: input.contentHash } : {}),\n };\n}\n\nconst SEARCH_ID_RE = UUID_RE;\n\nexport async function postOutcomes(\n searchId: string,\n items: OutcomeBodyItem[],\n opts: AgentApiOptions,\n): Promise<{ accepted: number }> {\n if (!SEARCH_ID_RE.test(searchId)) {\n throw new CliError('USAGE', `Invalid search id: ${JSON.stringify(searchId)}`, {\n fix: 'Pass the searchId from a prior search (or use --last).',\n });\n }\n if (items.length === 0 || items.length > 10) {\n throw new CliError('USAGE', 'An outcome report carries 1 to 10 items', {\n fix: 'Report between 1 and 10 outcomes per call.',\n });\n }\n const url = `${trimSlash(opts.baseUrl)}/api/agent/searches/${searchId}/outcomes`;\n const res = await httpRequest(url, {\n method: 'POST',\n timeoutMs: opts.timeoutMs,\n jsonBody: items.length === 1 ? items[0] : items,\n fetchImpl: opts.fetchImpl,\n });\n if (!res.ok) throw apiFailure(url, res);\n if (res.status === 429) throw rateLimitError(url, (n) => res.header(n));\n // 202 is the only success; the body is a uniform { accepted } regardless of\n // whether the searchId existed (no existence oracle, by design).\n if (res.status !== 202) {\n throw new CliError(\n 'API_UNREACHABLE',\n serverErrorMessage(res.json) ?? `Outcome report failed (${res.status})`,\n {\n fix: 'Check the status vocabulary and search id, then retry.',\n details: res.json,\n },\n );\n }\n const accepted =\n typeof res.json === 'object' && res.json !== null && 'accepted' in res.json\n ? Number((res.json as { accepted: unknown }).accepted)\n : items.length;\n return { accepted: Number.isFinite(accepted) ? accepted : items.length };\n}\n"],"mappings":"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","names":[]}
|
|
1
|
+
{"version":3,"sources":["../src/lib/agent-api.ts"],"sourcesContent":["import { z } from 'zod';\nimport { CliError } from './errors';\nimport { httpRequest, type HttpResult } from './http';\nimport { ATOMIC_RE, UUID_RE } from './ids';\nimport { trimSlash } from './url';\n\n/**\n * The search + outcome HTTP contract (A2, tenjin#370). Request building and\n * response validation live here; the wire shape is validated defensively, an\n * unknown `schemaVersion` degrades to a parse refusal rather than a guess, and\n * unrecognized candidate fields are ignored (forward-compatible), per spec 10.\n *\n * These endpoints are anonymous: no wallet, no SIWX. The shared transport's\n * User-Agent is what attributes a later purchase back to the search flow.\n */\n\nconst FRESH_WITHIN_RE = /^P(\\d+)[DWMY]$/;\nconst CANONICAL_KEY_RE = /^[a-z][a-z0-9_]{0,31}$/;\n\n/** The server's `limit` ceiling. Exported because the truncation advice in\n * `search` has to name it: past search v2 the response budget scales with the\n * candidates returned, so a truncated page is recovered by asking for MORE, and\n * this is the value to ask for. One definition, so the cap the CLI enforces and\n * the number it tells the operator to retry with cannot drift apart. */\nexport const MAX_LIMIT = 10;\n\n/** Client-side search request (mirrors the server lookupRequestSchema bounds\n * so a malformed flag fails locally as USAGE, before a round trip). */\nexport interface SearchInput {\n question: string;\n freshWithin?: string;\n maxPrice?: string;\n appliesTo?: Record<string, string[]>;\n limit?: number;\n}\n\nexport interface SearchRequestBody {\n schemaVersion: 2;\n question: string;\n freshWithin?: string;\n maxPrice?: string;\n appliesTo?: Record<string, string[]>;\n limit: number;\n}\n\nexport function buildSearchRequest(input: SearchInput): SearchRequestBody {\n const question = input.question.trim();\n if (question.length === 0 || question.length > 512) {\n throw new CliError('USAGE', 'question must be 1 to 512 characters', {\n fix: 'Pass a non-empty question under 512 characters.',\n });\n }\n if (input.freshWithin !== undefined) {\n // The server rejects ANY zero-valued duration (P0D, P0W, P00M, ...), so a\n // zero window fails here as USAGE instead of a remote 400.\n const digits = FRESH_WITHIN_RE.exec(input.freshWithin)?.[1];\n if (digits === undefined || Number(digits) === 0) {\n throw new CliError('USAGE', `Invalid --fresh-within: ${JSON.stringify(input.freshWithin)}`, {\n fix: 'Use a nonzero ISO-like window P<n>[DWMY], e.g. P30D, P2W, P1Y.',\n });\n }\n }\n if (input.maxPrice !== undefined && !ATOMIC_RE.test(input.maxPrice)) {\n throw new CliError('USAGE', `Invalid --max-price: ${JSON.stringify(input.maxPrice)}`, {\n fix: 'Pass an atomic USDC integer, e.g. 100000 for $0.10.',\n });\n }\n const limit = input.limit ?? 5;\n if (!Number.isInteger(limit) || limit < 1 || limit > MAX_LIMIT) {\n throw new CliError('USAGE', `Invalid --limit: ${JSON.stringify(input.limit)}`, {\n fix: `Pass an integer between 1 and ${MAX_LIMIT}.`,\n });\n }\n if (input.appliesTo !== undefined) {\n // Mirror the server's strictObject bounds (<=8 keys, <=20 values/key,\n // 1..120 chars/value) so a bad filter fails locally, never as a remote 400.\n const keys = Object.keys(input.appliesTo);\n if (keys.length > 8) {\n throw new CliError('USAGE', 'Too many --applies-to keys (max 8).');\n }\n for (const [key, values] of Object.entries(input.appliesTo)) {\n if (!CANONICAL_KEY_RE.test(key)) {\n throw new CliError('USAGE', `Invalid appliesTo key: ${JSON.stringify(key)}`, {\n fix: 'Keys must be canonical lowercase identifiers, e.g. products=Vercel.',\n });\n }\n if (values.length === 0) {\n throw new CliError('USAGE', `appliesTo key ${JSON.stringify(key)} has no values`, {\n fix: 'Give each --applies-to key at least one value.',\n });\n }\n if (values.length > 20) {\n throw new CliError('USAGE', `Too many --applies-to values for ${key} (max 20).`);\n }\n for (const value of values) {\n if (value.length === 0 || value.length > 120) {\n throw new CliError(\n 'USAGE',\n `Invalid --applies-to value for ${key}: must be 1 to 120 characters.`,\n );\n }\n }\n }\n }\n return {\n schemaVersion: 2,\n question,\n ...(input.freshWithin !== undefined ? { freshWithin: input.freshWithin } : {}),\n ...(input.maxPrice !== undefined ? { maxPrice: input.maxPrice } : {}),\n ...(input.appliesTo !== undefined ? { appliesTo: input.appliesTo } : {}),\n limit,\n };\n}\n\n// Response schemas. `.passthrough()` on the candidate keeps unknown future fields\n// instead of stripping them (forward-compatible), while still requiring the\n// contract fields this CLI reads. `decision` is uppercase on the wire.\n//\n// A candidate is a LEAN hit (search v2): identity, price, freshness and why it\n// matched, and nothing more. The full answer card is one free unpaid GET of `url`\n// away, which is what `tenjin inspect` does, so breadth here costs no depth there.\nexport const searchCandidateSchema = z\n .object({\n resourceId: z.string().regex(UUID_RE, 'resourceId must be a uuid'),\n url: z.string(),\n slug: z.string(),\n title: z.string(),\n artifactType: z.string(),\n price: z.string().regex(ATOMIC_RE, 'price must be an atomic integer string'),\n asOf: z.string().nullable(),\n validUntil: z.string().nullable(),\n matchReasons: z.array(z.string()),\n estimatedTokens: z.number(),\n creator: z.object({ handle: z.string() }).passthrough(),\n })\n .passthrough();\n\nexport type SearchCandidate = z.infer<typeof searchCandidateSchema>;\n\n/** Per-field caps for a browse pointer's free-form strings. `url` gets its own,\n * looser bound so a legitimate read URL is never mangled while an invented one\n * still cannot run away. Declared above the schema because the schema enforces\n * the `url` bound at parse time (see below). */\nconst BROWSE_BOUNDS = { title: 200, url: 512, handle: 64 } as const;\n\n// A browse pointer, carried ONLY on a MISS (tenjin#460): a piece from the broad\n// discoverable corpus with deliberately NO matchReasons, NO estimatedTokens and\n// no confidence field. It is a \"you might browse this\" hint, never a scored\n// answer candidate, so it is kept strictly out of `candidates` and never\n// recorded in the local search store.\n//\n// That store exclusion makes `inspect`/`buy`/`outcome` unreachable BY\n// `resourceId` (resolveResourceRef's uuid arm needs a store hit and fails with\n// RESOURCE_NOT_FOUND), but NOT by url: resolveResourceRef's URL arm is gated on\n// origin alone and never consults the store, so `tenjin buy <browse url>` does\n// pay. That is by design here, since the url is the payable read endpoint and\n// the contract re-emits it verbatim, but it is a real spend path, so the human\n// hint line carries the price and every spend gate still applies. Do not\n// restate the old \"never reachable by inspect/buy/outcome\" claim: it was false.\n//\n// A malformed pointer fails the WHOLE response into CONTRACT_MISMATCH rather\n// than being dropped. Deliberate: this client is fail-closed on every other\n// contract deviation, and silently swallowing a bad tail would hide server\n// drift that contract.test.ts exists to catch. Pinned in agent-api.test.ts.\n//\n// The `url` bound is enforced HERE rather than by truncation in the projection\n// below, and that asymmetry with `title`/`handle` is deliberate. Those two are\n// display strings: clipping one degrades gracefully and the human still reads\n// something true. `url` is an actionable payable pointer, and a clipped url is\n// not a shorter url, it is a DIFFERENT and broken one that still looks payable\n// in `--json`. Refusing is also the only ordering-independent answer: capping\n// first would hand the origin assertion in `runSearch` a string the server never\n// sent. 512 is far above any real read endpoint, so exceeding it is server drift.\nexport const searchBrowseSchema = z\n .object({\n resourceId: z.string().regex(UUID_RE, 'resourceId must be a uuid'),\n url: z.string().max(BROWSE_BOUNDS.url, `url must be at most ${BROWSE_BOUNDS.url} characters`),\n title: z.string(),\n price: z.string().regex(ATOMIC_RE, 'price must be an atomic integer string'),\n creator: z.object({ handle: z.string() }).passthrough(),\n })\n .passthrough();\n\nexport type SearchBrowse = z.infer<typeof searchBrowseSchema>;\n\nexport const searchResponseSchema = z.object({\n schemaVersion: z.literal(2),\n searchId: z.string().regex(UUID_RE, 'searchId must be a uuid'),\n decision: z.enum(['CANDIDATES', 'MISS']),\n calibration: z.string(),\n candidates: z.array(searchCandidateSchema).optional(),\n // Set only when the server's size backstop dropped trailing candidates the\n // requested limit had room for; omitted entirely otherwise. There is no cursor,\n // so a retry at a SMALLER limit returns strictly fewer rows; the ceiling scales\n // with the candidates returned, so a LARGER limit (up to MAX_LIMIT) is what\n // recovers the tail, and at MAX_LIMIT the tail is unrecoverable and narrowing the\n // question is the remedy. `runSearch` picks the half that applies.\n truncated: z.literal(true).optional(),\n // Omitted entirely by the server when empty, and only ever present on a MISS.\n // Not enforced here (a stricter schema would reject an otherwise-usable\n // response); truncateResponse drops it on a CANDIDATES decision instead.\n browse: z.array(searchBrowseSchema).optional(),\n});\n\nexport type SearchResponse = z.infer<typeof searchResponseSchema>;\n\nexport interface AgentApiOptions {\n baseUrl: string;\n timeoutMs: number;\n fetchImpl?: typeof fetch;\n /** Spec 09 §3 evaluation-cohort opt-in: sends X-Tenjin-Eval-Cohort: 1. */\n evalCohort?: boolean;\n}\n\n/** Turn a non-2xx / transport HttpResult into the CLI error contract. */\nfunction apiFailure(url: string, result: Exclude<HttpResult, { ok: true }>): CliError {\n const code =\n result.kind === 'network' || result.kind === 'timeout' ? 'NETWORK_ERROR' : 'API_UNREACHABLE';\n return new CliError(code, `${url}: ${result.message}`, {\n fix: 'Check your network and the configured base URL (`tenjin config get baseUrl`), then retry.',\n });\n}\n\n/** 429 with Retry-After: a recoverable pause, not an outage; agents branch on it. */\nexport function rateLimitError(\n url: string,\n header: (name: string) => string | undefined,\n): CliError {\n const retryAfter = header('retry-after');\n const seconds = retryAfter !== undefined ? Number(retryAfter) : undefined;\n return new CliError('RATE_LIMITED', `${url}: rate limited by the server.`, {\n fix:\n seconds !== undefined && Number.isFinite(seconds)\n ? `Retry after ${seconds}s.`\n : 'Back off and retry shortly.',\n details: {\n ...(seconds !== undefined && Number.isFinite(seconds) ? { retryAfterSeconds: seconds } : {}),\n },\n });\n}\n\nfunction serverErrorMessage(json: unknown): string | undefined {\n if (typeof json === 'object' && json !== null) {\n const rec = json as Record<string, unknown>;\n const err = rec.error;\n if (typeof err === 'string') return err;\n if (typeof err === 'object' && err !== null) {\n const m = (err as Record<string, unknown>).message;\n if (typeof m === 'string') return m;\n }\n if (typeof rec.message === 'string') return rec.message;\n }\n return undefined;\n}\n\nexport async function postSearch(\n body: SearchRequestBody,\n opts: AgentApiOptions,\n): Promise<SearchResponse> {\n const url = `${trimSlash(opts.baseUrl)}/api/agent/search`;\n const res = await httpRequest(url, {\n method: 'POST',\n timeoutMs: opts.timeoutMs,\n headers: opts.evalCohort === true ? { 'x-tenjin-eval-cohort': '1' } : {},\n jsonBody: body,\n fetchImpl: opts.fetchImpl,\n });\n if (!res.ok) throw apiFailure(url, res);\n if (res.status === 429) throw rateLimitError(url, (n) => res.header(n));\n if (res.status !== 200) {\n // The REQUEST gate is where a pre-v2 server actually refuses us, and it is\n // the arm that fires in practice. Old tenjin declares `schemaVersion:\n // z.literal(1)` inside a strictObject, so a v2 request never reaches the\n // handler: it comes back 400 \"Invalid request body\" with the zod flatten in\n // `error.details`, and the response check further down can never see it.\n // Without this the operator is told to retry a request that cannot succeed.\n if (res.status === 400 && rejectedSchemaVersion(res.json)) {\n throw outdatedServerError('The server rejected schemaVersion 2: it predates search v2.', {\n details: res.json,\n });\n }\n throw new CliError(\n 'API_UNREACHABLE',\n serverErrorMessage(res.json) ?? `Search failed (${res.status})`,\n {\n fix: 'Retry; if it persists the search endpoint may be unavailable.',\n details: res.json,\n },\n );\n }\n const parsed = searchResponseSchema.safeParse(res.json);\n if (!parsed.success) {\n // The other way a stale server surfaces: it answered 200 with a v1 body.\n // Unreachable against today's old tenjin (the request gate above refuses\n // first), but correct for anything that accepts the request and replies v1.\n const served = serverSchemaVersion(res.json);\n if (served !== undefined && served !== 2) {\n throw outdatedServerError(\n `Search response is schemaVersion ${served}; this CLI requires 2 (search v2).`,\n { details: parsed.error.issues },\n );\n }\n throw new CliError('CONTRACT_MISMATCH', 'Search response did not match the expected contract', {\n fix: 'Update tenjin-cli; the server contract may have changed.',\n details: parsed.error.issues,\n });\n }\n return truncateResponse(parsed.data);\n}\n\n/** One wording for both ways a pre-v2 server refuses this CLI, so the request-gate\n * arm and the response arm can never drift apart. */\nfunction outdatedServerError(message: string, opts: { details: unknown }): CliError {\n return new CliError('CONTRACT_MISMATCH', message, {\n fix: 'The server predates search v2. Point the configured base URL (`tenjin config set baseUrl`) at an updated deployment, or install an older tenjin-cli.',\n details: opts.details,\n });\n}\n\n/** True when a 400 body is the old server's request-gate refusal of our\n * `schemaVersion`: an ApiError envelope whose zod `flatten()` details carry a\n * `schemaVersion` fieldError. Keyed on the field, never the message text. */\nfunction rejectedSchemaVersion(json: unknown): boolean {\n const record = (v: unknown): Record<string, unknown> | undefined =>\n typeof v === 'object' && v !== null ? (v as Record<string, unknown>) : undefined;\n const fieldErrors = record(record(record(json)?.error)?.details)?.fieldErrors;\n return Array.isArray(record(fieldErrors)?.schemaVersion);\n}\n\n/** The `schemaVersion` an unparsed body claims, when it claims a number at all. */\nfunction serverSchemaVersion(json: unknown): number | undefined {\n if (typeof json !== 'object' || json === null) return undefined;\n const v = (json as { schemaVersion?: unknown }).schemaVersion;\n return typeof v === 'number' ? v : undefined;\n}\n\n/**\n * The server bounds every free-form candidate string (spec 09); re-apply the same\n * caps defensively so a misbehaving server cannot blow up an agent transcript\n * through the CLI (spec 10 response-size discipline).\n *\n * `slug` is deliberately absent: it is an identifier, not display text, so\n * clipping it would not shorten it but change it into a slug that resolves to\n * nothing while still looking usable in `--json`. The server tolerates an\n * uncapped slug for the same reason (that is the one case its `truncated` flag\n * exists for), so capping here would fail on a response the server calls valid.\n */\nconst CAND_BOUNDS = {\n title: 200,\n matchReasons: 3,\n matchReasonChars: 80,\n} as const;\n\nconst cap = (s: string, n: number): string => (s.length > n ? s.slice(0, n) : s);\n\nfunction truncateResponse(res: SearchResponse): SearchResponse {\n const out: SearchResponse = { ...res };\n if (res.candidates !== undefined) out.candidates = res.candidates.map(truncateCandidate);\n // Browse pointers ride the same defensive discipline, and then some. The\n // schema is `.passthrough()` so a server-invented key would otherwise survive\n // at unbounded length into `--json` and MCP structuredContent; we rebuild each\n // pointer explicitly from the five contract fields instead of spreading, which\n // drops unknown keys and is what makes the contract.test.ts \"no score-like\n // field\" pin hold at runtime and not just against the fixture. Count is capped\n // at the server's BROWSE_MAX, and every free-form string (title, url, handle)\n // at its own bound.\n //\n // `browse` is MISS-only by contract; drop it outright on a CANDIDATES decision\n // rather than trust the server, since humanLines renders no hint line there and\n // it would otherwise be an unrendered channel of server text and payable urls.\n if (res.browse !== undefined && res.decision === 'MISS') {\n out.browse = res.browse.slice(0, BROWSE_MAX).map((b) => ({\n resourceId: b.resourceId,\n // Not capped: the schema already refused anything over BROWSE_BOUNDS.url,\n // so this is the url the server sent, verbatim and payable.\n url: b.url,\n title: cap(b.title, BROWSE_BOUNDS.title),\n price: b.price,\n creator: { handle: cap(b.creator.handle, BROWSE_BOUNDS.handle) },\n }));\n } else {\n delete out.browse;\n }\n return out;\n}\n\n/** Mirrors the server's BROWSE_MAX (lib/search-browse.ts): a MISS carries at\n * most three browse pointers. */\nconst BROWSE_MAX = 3;\n\nfunction truncateCandidate(c: SearchCandidate): SearchCandidate {\n return {\n ...c,\n title: cap(c.title, CAND_BOUNDS.title),\n matchReasons: c.matchReasons\n .slice(0, CAND_BOUNDS.matchReasons)\n .map((r) => cap(r, CAND_BOUNDS.matchReasonChars)),\n };\n}\n\nconst OUTCOME_STATUSES = [\n 'used',\n 'partially_used',\n 'rejected',\n 'regenerated',\n 'purchase_declined',\n] as const;\nexport type OutcomeStatus = (typeof OUTCOME_STATUSES)[number];\nexport const OUTCOME_STATUS_VALUES: readonly string[] = OUTCOME_STATUSES;\n\nconst CONTENT_HASH_RE = /^sha256:[0-9a-f]{64}$/;\n\nexport interface OutcomeInput {\n status: string;\n resourceId?: string;\n contentHash?: string;\n}\n\nexport interface OutcomeBodyItem {\n status: OutcomeStatus;\n resourceId?: string;\n contentHash?: string;\n}\n\nexport function buildOutcomeItem(input: OutcomeInput): OutcomeBodyItem {\n if (!OUTCOME_STATUS_VALUES.includes(input.status)) {\n throw new CliError('USAGE', `Invalid outcome status: ${JSON.stringify(input.status)}`, {\n fix: `Use one of: ${OUTCOME_STATUSES.join(', ')}.`,\n });\n }\n if (input.resourceId !== undefined && !UUID_RE.test(input.resourceId)) {\n throw new CliError('USAGE', `Invalid --resource id: ${JSON.stringify(input.resourceId)}`, {\n fix: 'Pass the resourceId (a uuid) from a search candidate.',\n });\n }\n if (input.contentHash !== undefined && !CONTENT_HASH_RE.test(input.contentHash)) {\n throw new CliError('USAGE', `Invalid content hash: ${JSON.stringify(input.contentHash)}`, {\n fix: 'A content hash is \"sha256:<64 hex>\".',\n });\n }\n return {\n status: input.status as OutcomeStatus,\n ...(input.resourceId !== undefined ? { resourceId: input.resourceId } : {}),\n ...(input.contentHash !== undefined ? { contentHash: input.contentHash } : {}),\n };\n}\n\nconst SEARCH_ID_RE = UUID_RE;\n\nexport async function postOutcomes(\n searchId: string,\n items: OutcomeBodyItem[],\n opts: AgentApiOptions,\n): Promise<{ accepted: number }> {\n if (!SEARCH_ID_RE.test(searchId)) {\n throw new CliError('USAGE', `Invalid search id: ${JSON.stringify(searchId)}`, {\n fix: 'Pass the searchId from a prior search (or use --last).',\n });\n }\n if (items.length === 0 || items.length > 10) {\n throw new CliError('USAGE', 'An outcome report carries 1 to 10 items', {\n fix: 'Report between 1 and 10 outcomes per call.',\n });\n }\n const url = `${trimSlash(opts.baseUrl)}/api/searches/${searchId}/outcomes`;\n const res = await httpRequest(url, {\n method: 'POST',\n timeoutMs: opts.timeoutMs,\n jsonBody: items.length === 1 ? items[0] : items,\n fetchImpl: opts.fetchImpl,\n });\n if (!res.ok) throw apiFailure(url, res);\n if (res.status === 429) throw rateLimitError(url, (n) => res.header(n));\n // 202 is the only success; the body is a uniform { accepted } regardless of\n // whether the searchId existed (no existence oracle, by design).\n if (res.status !== 202) {\n throw new CliError(\n 'API_UNREACHABLE',\n serverErrorMessage(res.json) ?? `Outcome report failed (${res.status})`,\n {\n fix: 'Check the status vocabulary and search id, then retry.',\n details: res.json,\n },\n );\n }\n const accepted =\n typeof res.json === 'object' && res.json !== null && 'accepted' in res.json\n ? Number((res.json as { accepted: unknown }).accepted)\n : items.length;\n return { accepted: Number.isFinite(accepted) ? accepted : items.length };\n}\n"],"mappings":"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","names":[]}
|
|
@@ -1,10 +1,8 @@
|
|
|
1
1
|
import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
|
|
2
2
|
import {
|
|
3
|
+
CliError,
|
|
3
4
|
hasCode
|
|
4
|
-
} from "./chunk-
|
|
5
|
-
import {
|
|
6
|
-
CliError
|
|
7
|
-
} from "./chunk-PZRAAAY2.js";
|
|
5
|
+
} from "./chunk-PAOVPSP6.js";
|
|
8
6
|
|
|
9
7
|
// src/lib/skills-source.ts
|
|
10
8
|
import { existsSync } from "fs";
|
|
@@ -201,4 +199,4 @@ export {
|
|
|
201
199
|
shadowedCliSkills,
|
|
202
200
|
anyTenjinSkill
|
|
203
201
|
};
|
|
204
|
-
//# sourceMappingURL=chunk-
|
|
202
|
+
//# sourceMappingURL=chunk-OC3EIDCP.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/lib/skills-source.ts","../src/lib/skill-wiring.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { CliError } from './errors';\n\n/**\n * The packaged skills `install` copies into every target harness. All three go to\n * every target: `tenjin` (the zero-install curriculum, works with no CLI),\n * `tenjin-search` and `tenjin-publish` (thin CLI adapters). Order is the install\n * order and the human-render order.\n */\nexport const SKILL_NAMES = ['tenjin-search', 'tenjin-publish', 'tenjin'] as const;\nexport type SkillName = (typeof SKILL_NAMES)[number];\n\n// A `skills/` directory is the real one iff it holds `tenjin/SKILL.md`; a bare\n// `skills/` created for some other reason up the tree can't false-positive.\nconst SENTINEL = join('tenjin', 'SKILL.md');\n\n/**\n * Locate the packaged `skills/` directory by walking up from `startDir`. This has\n * to work in two layouts from one resolver: a global npm install where the module\n * lives in `dist/` with `skills/` a sibling (the `files` array ships it), and a\n * repo/source run where the module is under `src/` and `skills/` sits at the repo\n * root. Walking up until a `skills/` with the sentinel appears covers both without\n * hard-coding either depth. Sync (existsSync) on purpose: this is one-shot path\n * resolution at command start, the same shape as `require.resolve`.\n */\nexport function resolveSkillsSource(startDir: string): string {\n let dir = startDir;\n for (let i = 0; i < 8; i += 1) {\n const candidate = join(dir, 'skills');\n if (existsSync(join(candidate, SENTINEL))) return candidate;\n const parent = dirname(dir);\n if (parent === dir) break;\n dir = parent;\n }\n throw new CliError('INTERNAL', 'Could not locate the packaged Tenjin skills directory', {\n fix: 'Reinstall tenjin-cli; the published package must ship the skills/ directory (files array).',\n details: { startDir },\n });\n}\n","import { existsSync, statSync } from 'node:fs';\nimport { constants, open } from 'node:fs/promises';\nimport type { FileHandle } from 'node:fs/promises';\nimport { hasCode } from './errno';\nimport { delimiter, join } from 'node:path';\nimport { SKILL_NAMES } from './skills-source';\nimport type { SkillName } from './skills-source';\n\n/**\n * CLI_SKILL_NAMES are the thin adapter skills (roadmap C1), both required for the\n * CLI to be usable from a harness; HOSTED_SKILL_NAME is the zero-install\n * curriculum mirror (roadmap G4), typed as their complement so a rename in\n * skills-source.ts is a compile error here rather than a silently-always-false\n * `cliSkillsWired`.\n */\nexport const CLI_SKILL_NAMES = [\n 'tenjin-search',\n 'tenjin-publish',\n] as const satisfies readonly SkillName[];\nexport type CliSkillName = (typeof CLI_SKILL_NAMES)[number];\nexport type HostedSkillName = Exclude<SkillName, CliSkillName>;\nexport const HOSTED_SKILL_NAME: HostedSkillName = 'tenjin';\n\nexport type NotInvocableReason = 'disabled' | 'unreadable';\n\nexport interface SkillWiring {\n name: string;\n present: boolean;\n /** Undefined when absent. False means on disk yet never surfaced to the model. */\n modelInvocable?: boolean;\n reason?: NotInvocableReason;\n}\n\n/**\n * One directory's verdict. `shadowed` and `partial` are actionable; `hosted-only`\n * is a working zero-install machine, not a defect; `empty` is not a Tenjin dir.\n */\nexport type DirState = 'empty' | 'hosted-only' | 'partial' | 'shadowed' | 'wired';\n\nexport interface HarnessWiring {\n dir: string;\n exists: boolean;\n skills: SkillWiring[];\n state: DirState;\n}\n\nexport function skillsDirsFor(home: string): string[] {\n return [join(home, '.claude', 'skills'), join(home, '.agents', 'skills')];\n}\n\n/**\n * Every value `install --harness` accepts: the two detectable harnesses plus the\n * `shared` fallback. It lives beside the detection probes because `doctor` has to map\n * a PERSISTED choice back to a directory using the same rules `install` targeted it\n * with, and a second copy of that mapping is exactly the drift this module exists to\n * prevent.\n */\nexport const HARNESS_TARGETS = ['claude', 'codex', 'shared'] as const;\nexport type HarnessTarget = (typeof HARNESS_TARGETS)[number];\n\n/** The skills directory a target writes to. `codex` and `shared` share ~/.agents/skills. */\nexport function harnessTargetDir(home: string, harness: HarnessTarget): string {\n return harness === 'claude' ? join(home, '.claude', 'skills') : join(home, '.agents', 'skills');\n}\n\n/**\n * The `--harness` value that targets `dir`. A Claude-only machine never targets\n * ~/.agents/skills by default, so a bare `tenjin install` cannot clear a problem\n * found there.\n */\nexport function harnessFlagFor(home: string, dir: string): string {\n return dir === join(home, '.claude', 'skills') ? 'claude' : 'shared';\n}\n\n/** The harnesses `install` probes for. `shared` is a fallback target, never detected. */\nexport type DetectableHarness = Exclude<HarnessTarget, 'shared'>;\n\n/**\n * Why we think `harness` is on this machine: its home dir (~/.claude, ~/.codex) and\n * its binary on PATH. Single-sourced so `install` picks its targets and `doctor`\n * decides which directories MUST be wired from the same two probes — a directory no\n * harness here reads is a leftover, not a defect.\n */\nexport function harnessDetectedBy(\n home: string,\n harness: DetectableHarness,\n which: (bin: string) => boolean,\n): string[] {\n const reasons: string[] = [];\n if (existsSync(join(home, `.${harness}`))) reasons.push('home-dir');\n if (which(harness)) reasons.push('binary');\n return reasons;\n}\n\nexport interface HarnessPresence {\n claude: boolean;\n codex: boolean;\n}\n\nexport function detectHarnesses(home: string, which: (bin: string) => boolean): HarnessPresence {\n return {\n claude: harnessDetectedBy(home, 'claude', which).length > 0,\n codex: harnessDetectedBy(home, 'codex', which).length > 0,\n };\n}\n\n/**\n * Does a harness ON THIS MACHINE read `dir`? Claude Code reads ~/.claude/skills and\n * Codex reads ~/.agents/skills, so a wired .agents does NOT make Claude Code wired:\n * the question has to be asked per directory. When neither harness is detected the\n * shared directory is still in play, because that is the fallback target `install`\n * writes to, so a half-written fallback install is still reported.\n */\nexport function harnessReads(home: string, dir: string, present: HarnessPresence): boolean {\n return harnessFlagFor(home, dir) === 'claude' ? present.claude : present.codex || !present.claude;\n}\n\n/**\n * Did a past `tenjin install --harness ...` name `dir` on purpose? Detection only sees\n * the harnesses this CLI probes for, and ~/.agents/skills is the cross-harness Agent\n * Skills convention, so \"no Codex here\" is not \"nothing reads it\". `requested` is the\n * user's own answer to that question and outranks the probes.\n */\nexport function harnessRequested(\n home: string,\n dir: string,\n requested: readonly HarnessTarget[],\n): boolean {\n return requested.some((h) => harnessTargetDir(home, h) === dir);\n}\n\n/**\n * Is `dir` this machine's business at all: read by a detected harness, or explicitly\n * requested. The union is kept separate from `harnessReads` so the reported\n * `harnessPresent` stays a detection fact and does not quietly absorb a config value.\n */\nexport function harnessInPlay(\n home: string,\n dir: string,\n present: HarnessPresence,\n requested: readonly HarnessTarget[],\n): boolean {\n return harnessReads(home, dir, present) || harnessRequested(home, dir, requested);\n}\n\n/**\n * Is `bin` a real executable file on PATH? Gates on statSync().isFile() so a\n * same-named DIRECTORY on PATH never false-positives as the binary, and probes the\n * PATHEXT extensions on win32 where the real binary is `claude.cmd`/`claude.exe`\n * rather than a bare `claude`.\n */\nexport function onPath(bin: string, env: NodeJS.ProcessEnv): boolean {\n const raw = env.PATH ?? '';\n const exts =\n process.platform === 'win32'\n ? ['', ...(env.PATHEXT ?? '.EXE;.CMD;.BAT;.COM').split(';').filter((e) => e.length > 0)]\n : [''];\n for (const part of raw.split(delimiter)) {\n if (part.length === 0) continue;\n for (const ext of exts) {\n if (isFile(join(part, bin + ext))) return true;\n }\n }\n return false;\n}\n\nfunction isFile(p: string): boolean {\n try {\n return statSync(p).isFile();\n } catch {\n return false;\n }\n}\n\nexport async function readHarnessWiring(dir: string): Promise<HarnessWiring> {\n const exists = existsSync(dir);\n const skills: SkillWiring[] = [];\n for (const name of SKILL_NAMES) skills.push(await readSkillWiring(dir, name));\n return { dir, exists, skills, state: classify(skills) };\n}\n\nexport async function readAllWiring(home: string): Promise<HarnessWiring[]> {\n const out: HarnessWiring[] = [];\n for (const dir of skillsDirsFor(home)) out.push(await readHarnessWiring(dir));\n return out;\n}\n\nfunction classify(skills: SkillWiring[]): DirState {\n const cli = CLI_SKILL_NAMES.map((n) => skills.find((s) => s.name === n)).filter(\n (s) => s?.present === true,\n );\n if (cli.length === 0) return skills.some((s) => s.present) ? 'hosted-only' : 'empty';\n if (cli.some((s) => s?.modelInvocable === false)) return 'shadowed';\n return cli.length === CLI_SKILL_NAMES.length ? 'wired' : 'partial';\n}\n\n/**\n * What reading a SKILL.md found. A skill path is operator-controlled, so it is not\n * necessarily a file at all.\n */\nexport type SkillFileRead =\n | { kind: 'ok'; bytes: Buffer }\n | { kind: 'absent' }\n | { kind: 'not-regular' }\n | { kind: 'unreadable'; err: unknown };\n\n/**\n * Read a SKILL.md through ONE descriptor, and only when it is a regular file.\n *\n * `readFile` on a FIFO blocks until a writer appears, and on a character device it\n * streams without end; neither call fails, so no error handling reaches them. A\n * pipe at a wired SKILL.md path hung `tenjin doctor` and `tenjin install` past\n * SIGTERM. Opening non-blocking returns immediately whatever the node type is,\n * `fstat` on that descriptor says what it actually is, and only a regular file is\n * read. Checking the pathname and then reading the pathname would let the two\n * answer about different files.\n *\n * O_NONBLOCK does not exist on Windows, where it degrades to 0; FIFOs are not a\n * meaningful case there.\n */\nexport async function readSkillFile(path: string): Promise<SkillFileRead> {\n let handle: FileHandle;\n try {\n handle = await open(path, constants.O_RDONLY | (constants.O_NONBLOCK ?? 0));\n } catch (err) {\n if (hasCode(err, 'ENOENT')) return { kind: 'absent' };\n return { kind: 'unreadable', err };\n }\n try {\n if (!(await handle.stat()).isFile()) return { kind: 'not-regular' };\n return { kind: 'ok', bytes: await handle.readFile() };\n } catch (err) {\n return { kind: 'unreadable', err };\n } finally {\n await handle.close().catch(() => undefined);\n }\n}\n\nasync function readSkillWiring(dir: string, name: string): Promise<SkillWiring> {\n const read = await readSkillFile(join(dir, name, 'SKILL.md'));\n if (read.kind === 'absent') return { name, present: false };\n // A pipe or a device is there, but it is not a skill and must never be read as\n // one; `unreadable` is the state that already describes \"present, unusable\".\n if (read.kind !== 'ok')\n return { name, present: true, modelInvocable: false, reason: 'unreadable' };\n const text = read.bytes.toString('utf8');\n if (isModelInvocationDisabled(text)) {\n return { name, present: true, modelInvocable: false, reason: 'disabled' };\n }\n return { name, present: true, modelInvocable: true };\n}\n\n/** YAML 1.1 truthy spellings a harness frontmatter parser may accept. */\nconst YAML_TRUE = /^(?:true|yes|on)$/i;\n\n/**\n * Deliberately not a general YAML parse: only the leading `---` block is read,\n * because this repo's own skills discuss the key in prose and a whole-file match\n * would call a working skill disabled.\n */\nexport function isModelInvocationDisabled(skillMd: string): boolean {\n const frontmatter = extractFrontmatter(skillMd);\n if (frontmatter === null) return false;\n return frontmatter.some((line) => {\n const m = /^disable-model-invocation:\\s*(.+?)\\s*$/.exec(line.trim());\n if (m === null) return false;\n // Strip an inline `# comment` and optional quotes before testing truthiness.\n const value = (m[1] ?? '').replace(/\\s+#.*$/, '').replace(/^[\"']|[\"']$/g, '');\n return YAML_TRUE.test(value);\n });\n}\n\n/**\n * The `name:` a SKILL.md declares in its leading frontmatter, or null when it\n * declares none. It is what a harness registers the skill AS, so it is also the\n * cheapest evidence that a file at one of our paths is one of ours: the\n * unattended self-heal refuses to overwrite a same-named third-party skill.\n */\nexport function skillFrontmatterName(skillMd: string): string | null {\n const frontmatter = extractFrontmatter(skillMd);\n if (frontmatter === null) return null;\n for (const line of frontmatter) {\n const m = /^name:\\s*(.+?)\\s*$/.exec(line);\n if (m !== null) return (m[1] ?? '').replace(/^[\"']|[\"']$/g, '');\n }\n return null;\n}\n\nfunction extractFrontmatter(text: string): string[] | null {\n // Tolerate a UTF-8 BOM, CRLF, and leading blank lines before the opening fence.\n const lines = text.replace(/^\\uFEFF/, '').split(/\\r?\\n/);\n const open = lines.findIndex((l) => l.trim().length > 0);\n if (open === -1 || lines[open]?.trim() !== '---') return null;\n const end = lines.findIndex((l, i) => i > open && l.trim() === '---');\n if (end === -1) return null;\n return lines.slice(open + 1, end);\n}\n\nexport function cliSkillsWired(wiring: HarnessWiring): boolean {\n return wiring.state === 'wired';\n}\n\nexport function missingCliSkills(wiring: HarnessWiring): string[] {\n return CLI_SKILL_NAMES.filter(\n (name) => wiring.skills.find((x) => x.name === name)?.present !== true,\n );\n}\n\nexport function shadowedCliSkills(wiring: HarnessWiring): string[] {\n return CLI_SKILL_NAMES.filter((name) => {\n const s = wiring.skills.find((x) => x.name === name);\n return s?.present === true && s.modelInvocable === false;\n });\n}\n\nexport function anyTenjinSkill(wiring: HarnessWiring): boolean {\n return wiring.state !== 'empty';\n}\n"],"mappings":"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","names":["existsSync","join","join","existsSync","open"]}
|
|
1
|
+
{"version":3,"sources":["../src/lib/skills-source.ts","../src/lib/skill-wiring.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { CliError } from './errors';\n\n/**\n * The packaged skills `install` copies into every target harness. All three go to\n * every target: `tenjin` (the zero-install curriculum, works with no CLI),\n * `tenjin-search` and `tenjin-publish` (thin CLI adapters). Order is the install\n * order and the human-render order.\n */\nexport const SKILL_NAMES = ['tenjin-search', 'tenjin-publish', 'tenjin'] as const;\nexport type SkillName = (typeof SKILL_NAMES)[number];\n\n// A `skills/` directory is the real one iff it holds `tenjin/SKILL.md`; a bare\n// `skills/` created for some other reason up the tree can't false-positive.\nconst SENTINEL = join('tenjin', 'SKILL.md');\n\n/**\n * Locate the packaged `skills/` directory by walking up from `startDir`. This has\n * to work in two layouts from one resolver: a global npm install where the module\n * lives in `dist/` with `skills/` a sibling (the `files` array ships it), and a\n * repo/source run where the module is under `src/` and `skills/` sits at the repo\n * root. Walking up until a `skills/` with the sentinel appears covers both without\n * hard-coding either depth. Sync (existsSync) on purpose: this is one-shot path\n * resolution at command start, the same shape as `require.resolve`.\n */\nexport function resolveSkillsSource(startDir: string): string {\n let dir = startDir;\n for (let i = 0; i < 8; i += 1) {\n const candidate = join(dir, 'skills');\n if (existsSync(join(candidate, SENTINEL))) return candidate;\n const parent = dirname(dir);\n if (parent === dir) break;\n dir = parent;\n }\n throw new CliError('INTERNAL', 'Could not locate the packaged Tenjin skills directory', {\n fix: 'Reinstall tenjin-cli; the published package must ship the skills/ directory (files array).',\n details: { startDir },\n });\n}\n","import { existsSync, statSync } from 'node:fs';\nimport { constants, open } from 'node:fs/promises';\nimport type { FileHandle } from 'node:fs/promises';\nimport { hasCode } from './errno';\nimport { delimiter, join } from 'node:path';\nimport { SKILL_NAMES } from './skills-source';\nimport type { SkillName } from './skills-source';\n\n/**\n * CLI_SKILL_NAMES are the thin adapter skills (roadmap C1), both required for the\n * CLI to be usable from a harness; HOSTED_SKILL_NAME is the zero-install\n * curriculum mirror (roadmap G4), typed as their complement so a rename in\n * skills-source.ts is a compile error here rather than a silently-always-false\n * `cliSkillsWired`.\n */\nexport const CLI_SKILL_NAMES = [\n 'tenjin-search',\n 'tenjin-publish',\n] as const satisfies readonly SkillName[];\nexport type CliSkillName = (typeof CLI_SKILL_NAMES)[number];\nexport type HostedSkillName = Exclude<SkillName, CliSkillName>;\nexport const HOSTED_SKILL_NAME: HostedSkillName = 'tenjin';\n\nexport type NotInvocableReason = 'disabled' | 'unreadable';\n\nexport interface SkillWiring {\n name: string;\n present: boolean;\n /** Undefined when absent. False means on disk yet never surfaced to the model. */\n modelInvocable?: boolean;\n reason?: NotInvocableReason;\n}\n\n/**\n * One directory's verdict. `shadowed` and `partial` are actionable; `hosted-only`\n * is a working zero-install machine, not a defect; `empty` is not a Tenjin dir.\n */\nexport type DirState = 'empty' | 'hosted-only' | 'partial' | 'shadowed' | 'wired';\n\nexport interface HarnessWiring {\n dir: string;\n exists: boolean;\n skills: SkillWiring[];\n state: DirState;\n}\n\nexport function skillsDirsFor(home: string): string[] {\n return [join(home, '.claude', 'skills'), join(home, '.agents', 'skills')];\n}\n\n/**\n * Every value `install --harness` accepts: the two detectable harnesses plus the\n * `shared` fallback. It lives beside the detection probes because `doctor` has to map\n * a PERSISTED choice back to a directory using the same rules `install` targeted it\n * with, and a second copy of that mapping is exactly the drift this module exists to\n * prevent.\n */\nexport const HARNESS_TARGETS = ['claude', 'codex', 'shared'] as const;\nexport type HarnessTarget = (typeof HARNESS_TARGETS)[number];\n\n/** The skills directory a target writes to. `codex` and `shared` share ~/.agents/skills. */\nexport function harnessTargetDir(home: string, harness: HarnessTarget): string {\n return harness === 'claude' ? join(home, '.claude', 'skills') : join(home, '.agents', 'skills');\n}\n\n/**\n * The `--harness` value that targets `dir`. A Claude-only machine never targets\n * ~/.agents/skills by default, so a bare `tenjin install` cannot clear a problem\n * found there.\n */\nexport function harnessFlagFor(home: string, dir: string): string {\n return dir === join(home, '.claude', 'skills') ? 'claude' : 'shared';\n}\n\n/** The harnesses `install` probes for. `shared` is a fallback target, never detected. */\nexport type DetectableHarness = Exclude<HarnessTarget, 'shared'>;\n\n/**\n * Why we think `harness` is on this machine: its home dir (~/.claude, ~/.codex) and\n * its binary on PATH. Single-sourced so `install` picks its targets and `doctor`\n * decides which directories MUST be wired from the same two probes — a directory no\n * harness here reads is a leftover, not a defect.\n */\nexport function harnessDetectedBy(\n home: string,\n harness: DetectableHarness,\n which: (bin: string) => boolean,\n): string[] {\n const reasons: string[] = [];\n if (existsSync(join(home, `.${harness}`))) reasons.push('home-dir');\n if (which(harness)) reasons.push('binary');\n return reasons;\n}\n\nexport interface HarnessPresence {\n claude: boolean;\n codex: boolean;\n}\n\nexport function detectHarnesses(home: string, which: (bin: string) => boolean): HarnessPresence {\n return {\n claude: harnessDetectedBy(home, 'claude', which).length > 0,\n codex: harnessDetectedBy(home, 'codex', which).length > 0,\n };\n}\n\n/**\n * Does a harness ON THIS MACHINE read `dir`? Claude Code reads ~/.claude/skills and\n * Codex reads ~/.agents/skills, so a wired .agents does NOT make Claude Code wired:\n * the question has to be asked per directory. When neither harness is detected the\n * shared directory is still in play, because that is the fallback target `install`\n * writes to, so a half-written fallback install is still reported.\n */\nexport function harnessReads(home: string, dir: string, present: HarnessPresence): boolean {\n return harnessFlagFor(home, dir) === 'claude' ? present.claude : present.codex || !present.claude;\n}\n\n/**\n * Did a past `tenjin install --harness ...` name `dir` on purpose? Detection only sees\n * the harnesses this CLI probes for, and ~/.agents/skills is the cross-harness Agent\n * Skills convention, so \"no Codex here\" is not \"nothing reads it\". `requested` is the\n * user's own answer to that question and outranks the probes.\n */\nexport function harnessRequested(\n home: string,\n dir: string,\n requested: readonly HarnessTarget[],\n): boolean {\n return requested.some((h) => harnessTargetDir(home, h) === dir);\n}\n\n/**\n * Is `dir` this machine's business at all: read by a detected harness, or explicitly\n * requested. The union is kept separate from `harnessReads` so the reported\n * `harnessPresent` stays a detection fact and does not quietly absorb a config value.\n */\nexport function harnessInPlay(\n home: string,\n dir: string,\n present: HarnessPresence,\n requested: readonly HarnessTarget[],\n): boolean {\n return harnessReads(home, dir, present) || harnessRequested(home, dir, requested);\n}\n\n/**\n * Is `bin` a real executable file on PATH? Gates on statSync().isFile() so a\n * same-named DIRECTORY on PATH never false-positives as the binary, and probes the\n * PATHEXT extensions on win32 where the real binary is `claude.cmd`/`claude.exe`\n * rather than a bare `claude`.\n */\nexport function onPath(bin: string, env: NodeJS.ProcessEnv): boolean {\n const raw = env.PATH ?? '';\n const exts =\n process.platform === 'win32'\n ? ['', ...(env.PATHEXT ?? '.EXE;.CMD;.BAT;.COM').split(';').filter((e) => e.length > 0)]\n : [''];\n for (const part of raw.split(delimiter)) {\n if (part.length === 0) continue;\n for (const ext of exts) {\n if (isFile(join(part, bin + ext))) return true;\n }\n }\n return false;\n}\n\nfunction isFile(p: string): boolean {\n try {\n return statSync(p).isFile();\n } catch {\n return false;\n }\n}\n\nexport async function readHarnessWiring(dir: string): Promise<HarnessWiring> {\n const exists = existsSync(dir);\n const skills: SkillWiring[] = [];\n for (const name of SKILL_NAMES) skills.push(await readSkillWiring(dir, name));\n return { dir, exists, skills, state: classify(skills) };\n}\n\nexport async function readAllWiring(home: string): Promise<HarnessWiring[]> {\n const out: HarnessWiring[] = [];\n for (const dir of skillsDirsFor(home)) out.push(await readHarnessWiring(dir));\n return out;\n}\n\nfunction classify(skills: SkillWiring[]): DirState {\n const cli = CLI_SKILL_NAMES.map((n) => skills.find((s) => s.name === n)).filter(\n (s) => s?.present === true,\n );\n if (cli.length === 0) return skills.some((s) => s.present) ? 'hosted-only' : 'empty';\n if (cli.some((s) => s?.modelInvocable === false)) return 'shadowed';\n return cli.length === CLI_SKILL_NAMES.length ? 'wired' : 'partial';\n}\n\n/**\n * What reading a SKILL.md found. A skill path is operator-controlled, so it is not\n * necessarily a file at all.\n */\nexport type SkillFileRead =\n | { kind: 'ok'; bytes: Buffer }\n | { kind: 'absent' }\n | { kind: 'not-regular' }\n | { kind: 'unreadable'; err: unknown };\n\n/**\n * Read a SKILL.md through ONE descriptor, and only when it is a regular file.\n *\n * `readFile` on a FIFO blocks until a writer appears, and on a character device it\n * streams without end; neither call fails, so no error handling reaches them. A\n * pipe at a wired SKILL.md path hung `tenjin doctor` and `tenjin install` past\n * SIGTERM. Opening non-blocking returns immediately whatever the node type is,\n * `fstat` on that descriptor says what it actually is, and only a regular file is\n * read. Checking the pathname and then reading the pathname would let the two\n * answer about different files.\n *\n * O_NONBLOCK does not exist on Windows, where it degrades to 0; FIFOs are not a\n * meaningful case there.\n */\nexport async function readSkillFile(path: string): Promise<SkillFileRead> {\n let handle: FileHandle;\n try {\n handle = await open(path, constants.O_RDONLY | (constants.O_NONBLOCK ?? 0));\n } catch (err) {\n if (hasCode(err, 'ENOENT')) return { kind: 'absent' };\n return { kind: 'unreadable', err };\n }\n try {\n if (!(await handle.stat()).isFile()) return { kind: 'not-regular' };\n return { kind: 'ok', bytes: await handle.readFile() };\n } catch (err) {\n return { kind: 'unreadable', err };\n } finally {\n await handle.close().catch(() => undefined);\n }\n}\n\nasync function readSkillWiring(dir: string, name: string): Promise<SkillWiring> {\n const read = await readSkillFile(join(dir, name, 'SKILL.md'));\n if (read.kind === 'absent') return { name, present: false };\n // A pipe or a device is there, but it is not a skill and must never be read as\n // one; `unreadable` is the state that already describes \"present, unusable\".\n if (read.kind !== 'ok')\n return { name, present: true, modelInvocable: false, reason: 'unreadable' };\n const text = read.bytes.toString('utf8');\n if (isModelInvocationDisabled(text)) {\n return { name, present: true, modelInvocable: false, reason: 'disabled' };\n }\n return { name, present: true, modelInvocable: true };\n}\n\n/** YAML 1.1 truthy spellings a harness frontmatter parser may accept. */\nconst YAML_TRUE = /^(?:true|yes|on)$/i;\n\n/**\n * Deliberately not a general YAML parse: only the leading `---` block is read,\n * because this repo's own skills discuss the key in prose and a whole-file match\n * would call a working skill disabled.\n */\nexport function isModelInvocationDisabled(skillMd: string): boolean {\n const frontmatter = extractFrontmatter(skillMd);\n if (frontmatter === null) return false;\n return frontmatter.some((line) => {\n const m = /^disable-model-invocation:\\s*(.+?)\\s*$/.exec(line.trim());\n if (m === null) return false;\n // Strip an inline `# comment` and optional quotes before testing truthiness.\n const value = (m[1] ?? '').replace(/\\s+#.*$/, '').replace(/^[\"']|[\"']$/g, '');\n return YAML_TRUE.test(value);\n });\n}\n\n/**\n * The `name:` a SKILL.md declares in its leading frontmatter, or null when it\n * declares none. It is what a harness registers the skill AS, so it is also the\n * cheapest evidence that a file at one of our paths is one of ours: the\n * unattended self-heal refuses to overwrite a same-named third-party skill.\n */\nexport function skillFrontmatterName(skillMd: string): string | null {\n const frontmatter = extractFrontmatter(skillMd);\n if (frontmatter === null) return null;\n for (const line of frontmatter) {\n const m = /^name:\\s*(.+?)\\s*$/.exec(line);\n if (m !== null) return (m[1] ?? '').replace(/^[\"']|[\"']$/g, '');\n }\n return null;\n}\n\nfunction extractFrontmatter(text: string): string[] | null {\n // Tolerate a UTF-8 BOM, CRLF, and leading blank lines before the opening fence.\n const lines = text.replace(/^\\uFEFF/, '').split(/\\r?\\n/);\n const open = lines.findIndex((l) => l.trim().length > 0);\n if (open === -1 || lines[open]?.trim() !== '---') return null;\n const end = lines.findIndex((l, i) => i > open && l.trim() === '---');\n if (end === -1) return null;\n return lines.slice(open + 1, end);\n}\n\nexport function cliSkillsWired(wiring: HarnessWiring): boolean {\n return wiring.state === 'wired';\n}\n\nexport function missingCliSkills(wiring: HarnessWiring): string[] {\n return CLI_SKILL_NAMES.filter(\n (name) => wiring.skills.find((x) => x.name === name)?.present !== true,\n );\n}\n\nexport function shadowedCliSkills(wiring: HarnessWiring): string[] {\n return CLI_SKILL_NAMES.filter((name) => {\n const s = wiring.skills.find((x) => x.name === name);\n return s?.present === true && s.modelInvocable === false;\n });\n}\n\nexport function anyTenjinSkill(wiring: HarnessWiring): boolean {\n return wiring.state !== 'empty';\n}\n"],"mappings":"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","names":["existsSync","join","join","existsSync","open"]}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { createRequire as __tenjinCreateRequire } from 'node:module'; const require = __tenjinCreateRequire(import.meta.url);
|
|
2
2
|
import {
|
|
3
3
|
resolveThroughLink
|
|
4
|
-
} from "./chunk-
|
|
4
|
+
} from "./chunk-WVHPGQH5.js";
|
|
5
5
|
import {
|
|
6
6
|
hooksDir
|
|
7
7
|
} from "./chunk-ZQIQ55KK.js";
|
|
@@ -11,10 +11,10 @@ import {
|
|
|
11
11
|
readSkillFile,
|
|
12
12
|
skillFrontmatterName,
|
|
13
13
|
skillsDirsFor
|
|
14
|
-
} from "./chunk-
|
|
14
|
+
} from "./chunk-OC3EIDCP.js";
|
|
15
15
|
import {
|
|
16
16
|
writeFileAtomic
|
|
17
|
-
} from "./chunk-
|
|
17
|
+
} from "./chunk-PAOVPSP6.js";
|
|
18
18
|
|
|
19
19
|
// src/lib/harness-permissions.ts
|
|
20
20
|
import { lstat, readFile, realpath } from "fs/promises";
|
|
@@ -330,6 +330,30 @@ function clean(value, max) {
|
|
|
330
330
|
.slice(0, max);
|
|
331
331
|
}
|
|
332
332
|
|
|
333
|
+
/**
|
|
334
|
+
* "A newer tenjin-cli exists", appended to whatever this hook was already going
|
|
335
|
+
* to say. The CLI's own nudge is one dim stderr line that only a human at a
|
|
336
|
+
* terminal sees; a harness reads additionalContext, so this is where the AGENT
|
|
337
|
+
* finds out it can update itself. Pure cache read, and the comparison was
|
|
338
|
+
* already made by the CLI (see update-check.ts, the cached signal), because it
|
|
339
|
+
* runs standalone and does not know which version is installed.
|
|
340
|
+
*/
|
|
341
|
+
function updateLine() {
|
|
342
|
+
try {
|
|
343
|
+
const cfg = readJsonFile(join(DATA_DIR, 'config.json'));
|
|
344
|
+
const update = isRecord(cfg) && isRecord(cfg.update) ? cfg.update : {};
|
|
345
|
+
if (update.mode === 'off') return null;
|
|
346
|
+
const cache = readJsonFile(join(DATA_DIR, 'update-check.json'));
|
|
347
|
+
const signal = isRecord(cache) && isRecord(cache.signal) ? cache.signal : null;
|
|
348
|
+
if (signal === null) return null;
|
|
349
|
+
if (typeof signal.current !== 'string' || typeof signal.latest !== 'string') return null;
|
|
350
|
+
return 'tenjin-cli ' + clean(signal.latest, 40) + ' is available (you have ' +
|
|
351
|
+
clean(signal.current, 40) + '). Run tenjin update to install it.';
|
|
352
|
+
} catch {
|
|
353
|
+
return null;
|
|
354
|
+
}
|
|
355
|
+
}
|
|
356
|
+
|
|
333
357
|
/**
|
|
334
358
|
* Emit additionalContext for this event and leave. writeFileSync to fd 1, not
|
|
335
359
|
* process.stdout.write: a write to a pipe is asynchronous, so exiting on the next
|
|
@@ -337,7 +361,9 @@ function clean(value, max) {
|
|
|
337
361
|
*/
|
|
338
362
|
function emit(hookEventName, additionalContext) {
|
|
339
363
|
try {
|
|
340
|
-
|
|
364
|
+
const extra = updateLine();
|
|
365
|
+
const context = extra === null ? additionalContext : additionalContext + '\\n' + extra;
|
|
366
|
+
writeFileSync(1, JSON.stringify({ hookSpecificOutput: { hookEventName, additionalContext: context } }));
|
|
341
367
|
} catch {
|
|
342
368
|
// A closed or full stdout is not this hook's problem to report.
|
|
343
369
|
}
|
|
@@ -910,4 +936,4 @@ export {
|
|
|
910
936
|
removeSkills,
|
|
911
937
|
removeMarkerLines
|
|
912
938
|
};
|
|
913
|
-
//# sourceMappingURL=chunk-
|
|
939
|
+
//# sourceMappingURL=chunk-OE36HRWG.js.map
|