@litfamily/litcodex 1.0.7 → 1.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (30) hide show
  1. package/README-Ko-KR.md +207 -0
  2. package/README.md +155 -576
  3. package/dist/install/doctor-render.js +1 -0
  4. package/dist/install/doctor.js +8 -0
  5. package/dist/install/generated-skill-payload-hashes.d.ts +2 -2
  6. package/dist/install/generated-skill-payload-hashes.js +2 -2
  7. package/dist/install/types.d.ts +3 -0
  8. package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
  9. package/marketplace/plugins/litcodex/components/auto-update/package.json +1 -1
  10. package/marketplace/plugins/litcodex/components/comment-checker/package.json +1 -1
  11. package/marketplace/plugins/litcodex/components/git-bash/package.json +1 -1
  12. package/marketplace/plugins/litcodex/components/lit-loop/dist/hook-cli.d.ts +8 -1
  13. package/marketplace/plugins/litcodex/components/lit-loop/dist/hook-cli.js +36 -4
  14. package/marketplace/plugins/litcodex/components/lit-loop/dist/jev-hint.d.ts +123 -0
  15. package/marketplace/plugins/litcodex/components/lit-loop/dist/jev-hint.js +553 -0
  16. package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
  17. package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
  18. package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
  19. package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
  20. package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
  21. package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
  22. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/office-run.mjs +7 -1
  23. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/runtime.mjs +5 -1
  24. package/node_modules/@litcodex/lit-loop/dist/hook-cli.d.ts +8 -1
  25. package/node_modules/@litcodex/lit-loop/dist/hook-cli.js +36 -4
  26. package/node_modules/@litcodex/lit-loop/dist/jev-hint.d.ts +123 -0
  27. package/node_modules/@litcodex/lit-loop/dist/jev-hint.js +553 -0
  28. package/node_modules/@litcodex/lit-loop/package.json +1 -1
  29. package/package.json +4 -3
  30. package/readme-assets/badge-version.svg +1 -1
@@ -26,6 +26,7 @@ export function renderDoctorText(report) {
26
26
  : [
27
27
  ` auto-update: ${report.autoUpdate.enabled ? "enabled" : "disabled"} (${report.autoUpdate.status ?? "no receipt"}; ${report.autoUpdate.detail})`,
28
28
  ]),
29
+ ...(report.jevSkillHint === undefined ? [] : [` Jev skill hint: ${report.jevSkillHint}`]),
29
30
  ` concurrency: ${capabilityText(report.capabilities.concurrency)}`,
30
31
  ` probe-only explicit context/auto-compaction override: ${capabilityText(report.capabilities.autoCompaction)}`,
31
32
  ];
@@ -82,6 +82,7 @@ export function runDoctor(deps) {
82
82
  scientificVisualizationInstalled: false,
83
83
  capabilities: unavailableCapabilities,
84
84
  autoUpdate: readAutoUpdateReport(deps.env),
85
+ jevSkillHint: jevSkillHintState(deps.env),
85
86
  issues,
86
87
  warnings,
87
88
  };
@@ -169,10 +170,17 @@ export function runDoctor(deps) {
169
170
  ...bundledSkills,
170
171
  capabilities,
171
172
  autoUpdate,
173
+ jevSkillHint: jevSkillHintState(deps.env),
172
174
  issues,
173
175
  warnings,
174
176
  };
175
177
  }
178
+ /** Mirrors the lit-loop hook switch: `LITCODEX_JEV=1` plus a non-empty `TYPESAFE_API_KEY`. */
179
+ function jevSkillHintState(env) {
180
+ if (env["LITCODEX_JEV"] !== "1")
181
+ return "off";
182
+ return (env["TYPESAFE_API_KEY"]?.trim() ?? "") !== "" ? "on" : "flag on but TYPESAFE_API_KEY missing";
183
+ }
176
184
  /** Read the updater receipt without touching the updater lock, journal, or npm. */
177
185
  function readAutoUpdateReport(env) {
178
186
  const configuredRoot = env["LITCODEX_AUTO_UPDATE_STATE_ROOT"]?.trim();
@@ -774,7 +774,7 @@ export declare const PPTX_PAYLOAD_HASHES: {
774
774
  readonly "scripts/lib/slide-ast.js": "f4f2d93490c8922f450f3aa9bb12f4100ffee1f7bda7d5c79fab81421c1a1acc";
775
775
  readonly "scripts/lib/spec-validator.js": "0869ff328654de5c8c6eb36a22e9865683ba667b11eba6a85bd3e5428a3fccf3";
776
776
  readonly "scripts/lib/template-registry.js": "67f8d4c190d48d6f8d24f80fc03ba43d7eaec7bb817e03abd85cf46bde274f09";
777
- readonly "scripts/office-run.mjs": "c6d418a710bb4ffe18519efb1dd67fd6d9439c4f665ae08f5559193c763ed144";
777
+ readonly "scripts/office-run.mjs": "bb930a2fc3bd92729ee99e161f523bdc1851b88173b11b06ff501d10811ac3e1";
778
778
  readonly "scripts/package.json": "dbf8353f77358bc12169b7bb7301e1978d5b503e002ee927229a8993672818fc";
779
779
  readonly "scripts/qa_deck.py": "26aca0e0d3672d5c85415640b1731a0e8c2394d2299aa0c8238666e8f4d8ed6e";
780
780
  readonly "scripts/validate_pptx.py": "0e0644a6f7889945b2435f9e87fc6862b396ad0253619e76c48e289a97423a8f";
@@ -817,7 +817,7 @@ export declare const MOTION_PAYLOAD_HASHES: {
817
817
  readonly "engine/passes.mjs": "78684a132f91d3719493f193be3688478d93a97a25a9cffee528adc986bc20fa";
818
818
  readonly "engine/presets.mjs": "792b3105b63bb78667a78b8cdb0f93d52dbd6d81de2b4e21e400daee61042d5d";
819
819
  readonly "engine/report.mjs": "bd29b0c5ebcc15958c9f26626edcc0e8be2842d5886a9f4e66f8108db00ff9e2";
820
- readonly "engine/runtime.mjs": "cce88a580af6ee4336d601be6e8dfd48c2afa0121134c0f96831052a77d2d7c4";
820
+ readonly "engine/runtime.mjs": "1106825ac5ac38609da45ad8dfca5e1f45d172ba398e77a5a8948fd2a7781cd8";
821
821
  readonly "engine/scenes.mjs": "55257926ca326c8fa4816a716d7118811241a858960a5748921b95938d96ea49";
822
822
  readonly "engine/sound.mjs": "4d0891bf97412c3ff2233dbf4b6b1c95f5aadedc800e9462d49391201bdcfa3f";
823
823
  readonly "engine/stage-gate.mjs": "fc847c0d03a49fc05c77406b1512035ed282bf70c9c778776b60086a3750dcf6";
@@ -775,7 +775,7 @@ export const PPTX_PAYLOAD_HASHES = {
775
775
  "scripts/lib/slide-ast.js": "f4f2d93490c8922f450f3aa9bb12f4100ffee1f7bda7d5c79fab81421c1a1acc",
776
776
  "scripts/lib/spec-validator.js": "0869ff328654de5c8c6eb36a22e9865683ba667b11eba6a85bd3e5428a3fccf3",
777
777
  "scripts/lib/template-registry.js": "67f8d4c190d48d6f8d24f80fc03ba43d7eaec7bb817e03abd85cf46bde274f09",
778
- "scripts/office-run.mjs": "c6d418a710bb4ffe18519efb1dd67fd6d9439c4f665ae08f5559193c763ed144",
778
+ "scripts/office-run.mjs": "bb930a2fc3bd92729ee99e161f523bdc1851b88173b11b06ff501d10811ac3e1",
779
779
  "scripts/package.json": "dbf8353f77358bc12169b7bb7301e1978d5b503e002ee927229a8993672818fc",
780
780
  "scripts/qa_deck.py": "26aca0e0d3672d5c85415640b1731a0e8c2394d2299aa0c8238666e8f4d8ed6e",
781
781
  "scripts/validate_pptx.py": "0e0644a6f7889945b2435f9e87fc6862b396ad0253619e76c48e289a97423a8f",
@@ -818,7 +818,7 @@ export const MOTION_PAYLOAD_HASHES = {
818
818
  "engine/passes.mjs": "78684a132f91d3719493f193be3688478d93a97a25a9cffee528adc986bc20fa",
819
819
  "engine/presets.mjs": "792b3105b63bb78667a78b8cdb0f93d52dbd6d81de2b4e21e400daee61042d5d",
820
820
  "engine/report.mjs": "bd29b0c5ebcc15958c9f26626edcc0e8be2842d5886a9f4e66f8108db00ff9e2",
821
- "engine/runtime.mjs": "cce88a580af6ee4336d601be6e8dfd48c2afa0121134c0f96831052a77d2d7c4",
821
+ "engine/runtime.mjs": "1106825ac5ac38609da45ad8dfca5e1f45d172ba398e77a5a8948fd2a7781cd8",
822
822
  "engine/scenes.mjs": "55257926ca326c8fa4816a716d7118811241a858960a5748921b95938d96ea49",
823
823
  "engine/sound.mjs": "4d0891bf97412c3ff2233dbf4b6b1c95f5aadedc800e9462d49391201bdcfa3f",
824
824
  "engine/stage-gate.mjs": "fc847c0d03a49fc05c77406b1512035ed282bf70c9c778776b60086a3750dcf6",
@@ -89,7 +89,10 @@ export interface DoctorReport {
89
89
  readonly warnings: readonly string[];
90
90
  /** Read-only foreground update barrier state; the updater owns the receipt/journal files. */
91
91
  readonly autoUpdate?: AutoUpdateDoctorReport;
92
+ /** Opt-in Jev skill hint switch, read from this process's environment. Never carries the key. */
93
+ readonly jevSkillHint?: JevSkillHintState;
92
94
  }
95
+ export type JevSkillHintState = "off" | "on" | "flag on but TYPESAFE_API_KEY missing";
93
96
  export interface AutoUpdateDoctorReport {
94
97
  readonly enabled: boolean;
95
98
  readonly status: string | null;
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "litcodex",
3
- "version": "1.0.7",
3
+ "version": "1.0.9",
4
4
  "description": "LitCodex Codex plugin: the lit-loop activation, durable loop runtime, and local review-gated knowledge.",
5
5
  "license": "MIT",
6
6
  "keywords": [
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/auto-update",
3
- "version": "1.0.7",
3
+ "version": "1.0.9",
4
4
  "description": "LitCodex foreground update barrier for the SessionStart and management lifecycles.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/comment-checker",
3
- "version": "1.0.7",
3
+ "version": "1.0.9",
4
4
  "description": "LitCodex Comment-Checker hook: flags low-value / AI-slop comments introduced by edits.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@litcodex/git-bash",
3
- "version": "1.0.7",
3
+ "version": "1.0.9",
4
4
  "description": "LitCodex Git-Bash hook: reminds Windows sessions to prefer the git_bash MCP before the built-in shell.",
5
5
  "type": "module",
6
6
  "private": true,
@@ -1,3 +1,4 @@
1
+ import { type JevHttpClient } from "./jev-hint.js";
1
2
  /** Hard cap on stdin to bound memory / ReDoS exposure inside the 5 s Codex hook budget. 8 MB. */
2
3
  export declare const MAX_STDIN_BYTES = 8000000;
3
4
  /** Machine-readable error envelope emitted to stderr on a NON-zero exit. */
@@ -14,7 +15,13 @@ export type LitHookErrorCode = "LIT_HOOK_STDIN_INVALID_JSON" | "LIT_HOOK_STDIN_T
14
15
  * NEVER throws. Writes the camelCase activation line to stdout (empty on no-op), or a LitHookError
15
16
  * line to stderr on malformed / oversized stdin.
16
17
  */
17
- export declare function runUserPromptSubmitHookCli(stdin: NodeJS.ReadableStream, stdout: NodeJS.WritableStream, stderr: NodeJS.WritableStream, repoRoot?: string): Promise<number>;
18
+ export declare function runUserPromptSubmitHookCli(stdin: NodeJS.ReadableStream, stdout: NodeJS.WritableStream, stderr: NodeJS.WritableStream, repoRoot?: string, jev?: JevHookOptions): Promise<number>;
19
+ /** Injectable Jev dependencies; production uses the process environment and built-in `fetch`. */
20
+ export interface JevHookOptions {
21
+ readonly env?: NodeJS.ProcessEnv;
22
+ readonly http?: JevHttpClient;
23
+ readonly skillsRoot?: string;
24
+ }
18
25
  /** Enforce lit-plan persistence when a Stop hook event arrives. */
19
26
  export declare function runStopPlanPersistenceHookCli(stdin: NodeJS.ReadableStream, stdout: NodeJS.WritableStream, stderr: NodeJS.WritableStream, repoRoot?: string): Promise<number>;
20
27
  export declare function runPreToolUseCreateGoalGuardCli(stdin: NodeJS.ReadableStream, stdout: NodeJS.WritableStream, stderr: NodeJS.WritableStream): Promise<number>;
@@ -5,9 +5,12 @@
5
5
  // hands the parsed value to the pure engine, and writes the decision. Exit map: any structurally
6
6
  // valid event → 0 (no-op writes zero bytes); unparseable or oversized stdin → 2 with a
7
7
  // machine-readable LitHookError JSON line on stderr. NEVER calls process.exit (the dispatcher does)
8
- // and NEVER throws.
8
+ // and NEVER throws. A UserPromptSubmit turn the router leaves alone may carry the opt-in Jev skill
9
+ // hint (./jev-hint.ts) and, once per session while it is on, a plain-text banner; with its switch
10
+ // off, that path makes no request and writes nothing.
9
11
  import { isAbsolute } from "node:path";
10
- import { applyPreToolUseCreateGoalGuard, runUserPromptSubmitHook } from "./codex-hook.js";
12
+ import { applyPreToolUseCreateGoalGuard, isLitUserPromptSubmitInput, runUserPromptSubmitHook } from "./codex-hook.js";
13
+ import { claimJevOnBanner, formatJevHookOutput, jevSwitchState, runJevSkillHint, withJevBanner, } from "./jev-hint.js";
11
14
  import { evaluatePlanPersistence, formatStopBlockOutput, recordLitPlanActivation } from "./plan-persistence.js";
12
15
  /** Hard cap on stdin to bound memory / ReDoS exposure inside the 5 s Codex hook budget. 8 MB. */
13
16
  export const MAX_STDIN_BYTES = 8_000_000;
@@ -66,7 +69,7 @@ function readStdin(stdin) {
66
69
  * NEVER throws. Writes the camelCase activation line to stdout (empty on no-op), or a LitHookError
67
70
  * line to stderr on malformed / oversized stdin.
68
71
  */
69
- export async function runUserPromptSubmitHookCli(stdin, stdout, stderr, repoRoot = process.cwd()) {
72
+ export async function runUserPromptSubmitHookCli(stdin, stdout, stderr, repoRoot = process.cwd(), jev = {}) {
70
73
  const decoded = await readStdin(stdin);
71
74
  if (decoded === null) {
72
75
  stderr.write(errorLine("LIT_HOOK_STDIN_TOO_LARGE", TOO_LARGE_MESSAGE));
@@ -94,10 +97,39 @@ export async function runUserPromptSubmitHookCli(stdin, stdout, stderr, repoRoot
94
97
  if (scope !== null)
95
98
  recordLitPlanActivation(scope.cwd, scope.sessionId);
96
99
  }
97
- if (decision.kind === "inject")
100
+ if (decision.kind === "inject") {
98
101
  stdout.write(decision.stdout);
102
+ return 0;
103
+ }
104
+ const hint = await jevHintOutput(parsed, repoRoot, jev);
105
+ if (hint !== "")
106
+ stdout.write(hint);
99
107
  return 0;
100
108
  }
109
+ /** Optional Jev skill hint for a turn the deterministic router left alone. Never throws. */
110
+ async function jevHintOutput(parsed, repoRoot, options) {
111
+ const env = options.env ?? process.env;
112
+ if (jevSwitchState(env) === "off" || !isLitUserPromptSubmitInput(parsed))
113
+ return "";
114
+ const record = parsed;
115
+ const sessionId = typeof record["session_id"] === "string" ? record["session_id"] : null;
116
+ const cwd = typeof record["cwd"] === "string" && isAbsolute(record["cwd"]) ? record["cwd"] : repoRoot;
117
+ try {
118
+ const banner = claimJevOnBanner(cwd, sessionId, env);
119
+ const result = await runJevSkillHint({
120
+ prompt: parsed.prompt,
121
+ sessionId,
122
+ repoRoot: cwd,
123
+ env,
124
+ ...(options.http === undefined ? {} : { http: options.http }),
125
+ ...(options.skillsRoot === undefined ? {} : { skillsRoot: options.skillsRoot }),
126
+ });
127
+ return formatJevHookOutput(withJevBanner(result, banner));
128
+ }
129
+ catch {
130
+ return "";
131
+ }
132
+ }
101
133
  /** Read `{ session_id, cwd }` from a hook event; `cwd` falls back to `repoRoot` when absent or relative. */
102
134
  function hookSessionScope(parsed, repoRoot) {
103
135
  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
@@ -0,0 +1,123 @@
1
+ export declare const JEV_FLAG_ENV = "LITCODEX_JEV";
2
+ export declare const JEV_KEY_ENV = "TYPESAFE_API_KEY";
3
+ export declare const JEV_ENDPOINT = "https://api.typesafe.ai/v1/systemone";
4
+ export declare const JEV_DEFAULT_MODEL = "jev-1.13.0";
5
+ export declare const JEV_DEFAULT_TIMEOUT_MS = 1500;
6
+ export declare const JEV_MAX_TIMEOUT_MS = 3000;
7
+ export declare const JEV_DEFAULT_MAX_CALLS = 200;
8
+ export declare const JEV_DEFAULT_MIN_CONFIDENCE = 0.35;
9
+ export declare const JEV_MAX_PROMPT_CHARS = 2000;
10
+ export declare const JEV_REDACTION_WINDOW_CHARS = 8000;
11
+ export declare const JEV_MAX_DESCRIPTION_CHARS = 300;
12
+ export declare const JEV_MAX_BODY_BYTES: number;
13
+ export declare const JEV_STATE_DIR = ".litcodex/jev";
14
+ export type JevSwitchState = "off" | "on" | "flag on but TYPESAFE_API_KEY missing";
15
+ /** The doctor/status state. Never reveals the key or its length. */
16
+ export declare function jevSwitchState(env: NodeJS.ProcessEnv): JevSwitchState;
17
+ /**
18
+ * Redact an 8,000-character window (home paths, e-mail addresses, the literal key and token-shaped
19
+ * strings, in that order), then cut to 2,000 characters. A run of 8 or more token characters left at
20
+ * the cut is part of something the cut split, so it becomes `[secret]` too.
21
+ */
22
+ export declare function redactJevPrompt(prompt: string, key?: string): string;
23
+ export interface JevCatalogEntry {
24
+ readonly id: string;
25
+ readonly description: string;
26
+ }
27
+ /** The installed plugin's `skills/` directory, resolved the same way the mode router finds bodies. */
28
+ export declare function defaultJevSkillsRoot(): string;
29
+ /**
30
+ * This plugin's own skills that the host may load on the model's initiative: every `skills/<id>/SKILL.md`
31
+ * whose frontmatter `name` equals its directory, minus skills whose `agents/openai.yaml` sets
32
+ * `allow_implicit_invocation: false` (those run only on an explicit user invocation).
33
+ */
34
+ export declare function loadJevCatalog(skillsRoot?: string): JevCatalogEntry[];
35
+ export type JevSkipReason = "slash-command" | "skill-mention" | "routed" | "too-short";
36
+ /** Why this turn gets no Jev request, or null when it is eligible. Pure. */
37
+ export declare function jevSkipReason(prompt: string, catalogIds?: ReadonlySet<string>): JevSkipReason | null;
38
+ export interface JevRequestBody {
39
+ readonly model: string;
40
+ readonly state: string;
41
+ readonly questions: {
42
+ readonly which: {
43
+ readonly type: "choice";
44
+ readonly instructions: string;
45
+ readonly criteria: Readonly<Record<string, string>>;
46
+ };
47
+ };
48
+ }
49
+ export declare function buildJevRequestBody(model: string, state: string, catalog: readonly JevCatalogEntry[]): JevRequestBody;
50
+ export type JevVerdict = {
51
+ readonly kind: "hint";
52
+ readonly skillId: string;
53
+ readonly confidence: number;
54
+ } | {
55
+ readonly kind: "none";
56
+ readonly confidence: number;
57
+ } | {
58
+ readonly kind: "low-confidence";
59
+ readonly choice: string;
60
+ readonly confidence: number;
61
+ } | {
62
+ readonly kind: "rejected";
63
+ };
64
+ /** Validate an already-parsed response against the ids that were sent. Nothing else is trusted. */
65
+ export declare function judgeJevResponse(parsed: unknown, catalogIds: ReadonlySet<string>, minConfidence: number): JevVerdict;
66
+ export declare function jevHintLine(skillId: string): string;
67
+ /** The opt-in (`LITCODEX_JEV_SHOW=1`) visible line for a hinted turn: skill id and latency only. */
68
+ export declare function jevShowLine(skillId: string, latencyMs: number): string;
69
+ /** Once-per-session awareness banner. Plain text: Codex renders hook systemMessage control characters literally. */
70
+ export declare const JEV_ON_BANNER = "\u2726 Jev skill hint ON";
71
+ export declare function jevFallbackNote(reason: string): string;
72
+ export interface JevHttpRequest {
73
+ readonly method: "POST";
74
+ readonly headers: Readonly<Record<string, string>>;
75
+ readonly body: string;
76
+ readonly signal: AbortSignal;
77
+ }
78
+ export interface JevHttpResponse {
79
+ readonly status: number;
80
+ text(): Promise<string>;
81
+ }
82
+ /** Injected in tests; the default uses the runtime's built-in `fetch`. */
83
+ export type JevHttpClient = (url: string, request: JevHttpRequest) => Promise<JevHttpResponse>;
84
+ export declare const fetchJevHttpClient: JevHttpClient;
85
+ export interface JevSessionState {
86
+ readonly version: 1;
87
+ readonly calls: number;
88
+ readonly noted: boolean;
89
+ readonly announced: boolean;
90
+ }
91
+ /**
92
+ * The session record: fresh when missing or malformed, null when `.litcodex`, `.litcodex/jev` or the
93
+ * record itself is a symlink or the wrong kind of entry, so a checked-in link is never read through.
94
+ */
95
+ export declare function readJevSessionState(path: string): JevSessionState | null;
96
+ export interface JevHintInput {
97
+ readonly prompt: string;
98
+ readonly sessionId: string | null;
99
+ readonly repoRoot: string;
100
+ readonly env: NodeJS.ProcessEnv;
101
+ readonly http?: JevHttpClient;
102
+ readonly skillsRoot?: string;
103
+ readonly now?: () => number;
104
+ }
105
+ /** A hint sets `additionalContext`, plus `systemMessage` only with `LITCODEX_JEV_SHOW=1`; a note sets `systemMessage`. */
106
+ export interface JevHintResult {
107
+ readonly additionalContext?: string;
108
+ readonly systemMessage?: string;
109
+ }
110
+ /**
111
+ * Decide the optional hint for one UserPromptSubmit turn. Never throws; every failure resolves to at
112
+ * most one visible fallback note per session and otherwise to nothing.
113
+ */
114
+ export declare function runJevSkillHint(input: JevHintInput): Promise<JevHintResult>;
115
+ /**
116
+ * The once-per-session banner, or null. Only when the hint is fully on (flag and key); it is claimed in
117
+ * the session state before it is shown, so a state write failure shows nothing rather than repeating.
118
+ */
119
+ export declare function claimJevOnBanner(repoRoot: string, sessionId: string | null, env: NodeJS.ProcessEnv): string | null;
120
+ /** Put the banner (when claimed) on its own line ahead of any other visible Jev line. */
121
+ export declare function withJevBanner(result: JevHintResult, banner: string | null): JevHintResult;
122
+ /** Codex UserPromptSubmit output for a hint and/or visible line; "" when there is nothing to say. */
123
+ export declare function formatJevHookOutput(result: JevHintResult): string;