@librechat/agents 3.4.6 → 3.5.0

package/dist/esm/tools/intentArg.mjs

@@ -1,68 +1,16 @@
 //#region src/tools/intentArg.ts
-/** Argument carrying the model-authored label for a tool call. */
 const INTENT_ARG = "intent";
-/**
-* Opening words of {@link INTENT_DESCRIPTION}, and the discriminator that
-* tells the injected LABEL apart from a tool's own business parameter that
-* merely shares the name `intent`.
-*
-* Exported because host applications reimplement the same strip/sanitize
-* passes and would otherwise duplicate this as a string literal: if the two
-* copies drift, the host silently stops recognizing SDK-native labels and
-* fails OPEN (labels stay in schemas, opt-outs stop working) with no error.
-* Any edit to the description must preserve this prefix verbatim.
-*/
 const INTENT_LABEL_MARKER = "ALWAYS write this field FIRST";
-/**
-* Model-facing instruction for the injected `intent` property.
-*
-* Deliberately terse — it is repeated on every opted-in tool schema, on every
-* request, so each sentence is paid for many times over. What remains is
-* load-bearing: first-position placement (the entire streaming mechanism),
-* the one-sentence present-progressive form, who reads it, and the sibling
-* rule, without which models emit identical labels for parallel calls to one
-* tool and defeat the feature's headline case.
-*/
 const INTENT_DESCRIPTION = `${INTENT_LABEL_MARKER}, before any other argument. One present-progressive sentence saying what THIS call is about to do: "Searching for OAuth handling in the callback router". Shown to the user as this call's live status. Never name the tool. Sibling calls to one tool must differ.`;
-/**
-* Canonical (frozen) shape of the injected property. Always embed a COPY
-* (`{ ...INTENT_PROPERTY }`): LangChain's JSON-schema validator stamps a
-* `__absolute_uri__` marker onto every subschema it dereferences, which
-* throws on a frozen object — and a single shared instance would be stamped
-* with one schema's URI while embedded in many.
-*/
 const INTENT_PROPERTY = Object.freeze({
 	type: "string",
 	description: INTENT_DESCRIPTION
 });
-/**
-* Discriminates the intent LABEL property from a tool's own business
-* parameter that merely shares the name: the label contract always opens
-* with the same instruction. Removal/sanitize passes must never strip a
-* parameter the tool actually needs.
-*/
 function isIntentLabelProperty(property) {
 	if (property == null || typeof property !== "object") return false;
 	const record = property;
 	return record.type === "string" && typeof record.description === "string" && record.description.startsWith("ALWAYS write this field FIRST");
 }
-/**
-* Returns a copy of `parameters` without the injected intent LABEL — the
-* opt-out for consumers that render no status label and should not pay for
-* the property.
-*
-* The SDK's native schemas carry the label unconditionally, so without this
-* an embedder has no lever at all: `withIntent` is applied at module scope.
-* Marker-guarded, so a tool's own business parameter named `intent` is never
-* removed. Returns the input unchanged when there is nothing to strip.
-*
-* `required` is pruned alongside the property: a schema that lists `intent`
-* as required (strict-mode normalization does exactly that, since OpenAI
-* strict function schemas require every property to appear in `required`)
-* would otherwise be left naming a property it no longer declares, which is
-* invalid JSON Schema and gets rejected by the provider instead of quietly
-* opting out.
-*/
 function withoutIntent(parameters) {
 	const props = parameters?.properties;
 	if (parameters == null || props == null || !isIntentLabelProperty(props["intent"])) return parameters;
@@ -78,13 +26,6 @@ function withoutIntent(parameters) {
 	}
 	return next;
 }
-/**
-* Returns a copy of the parameters schema with `intent` prepended as the
-* FIRST property (object key order is insertion order and every provider
-* serializer preserves it — first key in the schema means first key in the
-* streamed input). Never mutates the input; no-op when the schema already
-* declares `intent`. The property is not added to `required`.
-*/
 function withIntent(parameters) {
 	const existingProps = parameters?.properties ?? {};
 	if ("intent" in existingProps) return parameters;
@@ -97,10 +38,6 @@ function withIntent(parameters) {
 		}
 	};
 }
-/**
-* Coerces tool-call args to an object, parsing a stringified JSON object
-* (some providers deliver args as a string). Returns undefined otherwise.
-*/
 function coerceArgsObject(args) {
 	if (typeof args === "object" && args !== null && !Array.isArray(args)) return args;
 	if (typeof args === "string" && args.trim().startsWith("{")) try {
@@ -110,68 +47,26 @@ function coerceArgsObject(args) {
 		return;
 	}
 }
-/**
-* Reads the model-authored intent from tool-call args (handles stringified
-* args). Returns undefined when absent, empty, or not a string.
-*/
 function readIntent(args) {
 	const value = coerceArgsObject(args)?.[INTENT_ARG];
 	if (typeof value !== "string") return;
 	const trimmed = value.trim();
 	return trimmed === "" ? void 0 : trimmed;
 }
-/**
-* Returns the args without the `intent` key so downstream consumers that did
-* not declare it never receive it. Parses stringified JSON object args;
-* returns the value unchanged when the key is absent.
-*/
 function stripIntent(args) {
 	const obj = coerceArgsObject(args);
 	if (!obj || !("intent" in obj)) return args;
 	const { [INTENT_ARG]: _omit, ...rest } = obj;
 	return rest;
 }
-/**
-* Resolves the settled label for a call from its model-authored `intent` and
-* the tool's result fields, in precedence order:
-*
-*  1. `outcome` — full replacement authored by the tool.
-*  2. `outcome_patch` — first occurrence of `from` in the intent replaced
-*     with `to` (case-sensitive); no-op when `from` is absent or empty.
-*  3. Otherwise the intent is returned UNCHANGED.
-*
-* There is deliberately no mechanical present-progressive→past-tense rewrite.
-* Such a transform can only be a closed list of English verbs, which makes it
-* wrong in three ways at once: it never fires for the non-English labels this
-* feature expects (the model answers in the user's language), it fires for
-* some sibling calls and not others inside one group — "Searched…" beside
-* "Recording…" — and it quietly enumerates a vocabulary in a feature whose
-* premise is that the sentence is free-form. Completion is conveyed by UI
-* state (the shimmer stopping, the icon settling), which is language-neutral
-* and always consistent; a tool that wants past tense says so explicitly via
-* `outcome` or `outcome_patch`.
-*
-* Returns undefined when there is neither an intent nor an outcome, so
-* callers fall back to their default label. Pure and dependency-free — host
-* UIs needing identical logic can import or mirror it.
-*/
 function applyOutcome(intent, result) {
 	const outcome = result?.outcome;
 	if (typeof outcome === "string" && outcome.trim() !== "") return outcome;
 	if (intent == null || intent === "") return;
 	const patch = result?.outcome_patch;
-	if (patch != null && patch.from !== "" && intent.includes(patch.from))
- /** Replacement callback keeps `to` verbatim — a direct string second
-	*  argument would interpret `$&`/`$'`-style tokens in tool-authored
-	*  text (e.g. labels derived from shell syntax). */
-	return intent.replace(patch.from, () => patch.to);
+	if (patch != null && patch.from !== "" && intent.includes(patch.from)) return intent.replace(patch.from, () => patch.to);
 	return intent;
 }
-/**
-* Hard cap on an emitted outcome label. The label is a single progress line
-* in UI chrome; a tool that derives it from data (or a malformed patch)
-* must not be able to inflate completion events or persisted parts.
-*/
 const MAX_OUTCOME_CHARS = 256;
 function boundOutcomeLabel(label) {
 	if (label == null) return;
@@ -180,20 +75,6 @@ function boundOutcomeLabel(label) {
 	if (singleLine.length <= MAX_OUTCOME_CHARS) return singleLine;
 	return `${singleLine.slice(0, MAX_OUTCOME_CHARS - 1)}…`;
 }
-/**
-* Resolves the settled label to emit on a completion event: only when the
-* tool actually authored `outcome`/`outcome_patch` fields. Returns undefined
-* otherwise, so the wire never carries a label the host already has — a bare
-* intent needs no settled form, because it is displayed unchanged and the UI
-* conveys completion through its own state. Hosts must NOT rewrite it (see
-* {@link applyOutcome} for why a tense transform is deliberately absent). The
-* result is collapsed to a bounded single line before emission.
-*
-* For failed calls (`isError`), only tool-AUTHORED text may label the call:
-* an explicit `outcome`, or a patch whose `from` actually matches the intent.
-* An unmatched patch resolves to undefined rather than silently reusing the
-* in-flight intent, so a failure is never labelled as though it succeeded.
-*/
 function resolveToolOutcome(args, fields, options) {
 	if (fields == null || fields.outcome == null && fields.outcome_patch == null) return;
 	if (options?.isError !== true) return boundOutcomeLabel(applyOutcome(readIntent(args), fields));
@@ -203,22 +84,10 @@ function resolveToolOutcome(args, fields, options) {
 	const patch = fields.outcome_patch;
 	if (intent != null && patch != null && patch.from !== "" && intent.includes(patch.from)) return boundOutcomeLabel(intent.replace(patch.from, () => patch.to));
 }
-/**
-* Reads the outcome fields off a tool-execution result: the typed
-* `outcome`/`outcome_patch` fields when present, else the artifact channel
-* (see {@link readOutcomeFields}) — so a `content_and_artifact` tool authors
-* its label the same way on the direct and event-driven paths.
-*/
 function outcomeFieldsFromResult(result) {
 	if (result.outcome != null || result.outcome_patch != null) return result;
 	return readOutcomeFields(result.artifact);
 }
-/**
-* Extracts validated `outcome`/`outcome_patch` fields from an arbitrary
-* value — the artifact channel through which an in-process
-* `content_and_artifact` tool authors its settled label. Returns undefined
-* when neither field is usable.
-*/
 function readOutcomeFields(source) {
 	if (source == null || typeof source !== "object" || Array.isArray(source)) return;
 	const record = source;

package/dist/esm/tools/intentArg.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"intentArg.mjs","names":[],"sources":["../../../src/tools/intentArg.ts"],"sourcesContent":["/**\n * @fileoverview Tool intent labels.\n *\n * Lets a tool declare, as the FIRST property of its input schema, an `intent`\n * string: one model-authored sentence stating what that specific call is about\n * to do (\"Searching for OAuth handling in the callback router\"). Because the\n * property is first, it is the first key providers stream in the tool-call\n * args, so a host UI can render it as the call's live status label before the\n * rest of the args exist. When the call settles, {@link applyOutcome} edits\n * the sentence in place into its outcome form — a tool-supplied replacement\n * (`outcome`) or a tool-supplied span edit (`outcome_patch`). Absent either,\n * the label is left exactly as the model wrote it: completion is a UI state\n * (the shimmer stopping, the icon settling), not a tense change.\n *\n * The arg is always optional (never listed in `required`): the same schemas\n * are callable from programmatic tool calling, where no UI renders a label\n * and forcing generated code to fabricate one would be pure cost. Tool bodies\n * must call {@link stripIntent} before using their args so no tool receives a\n * parameter it did not declare.\n */\n\nimport type { JsonSchemaType, OutcomePatch } from '@/types';\n\n/** Argument carrying the model-authored label for a tool call. */\nexport const INTENT_ARG = 'intent';\n\n/**\n * Opening words of {@link INTENT_DESCRIPTION}, and the discriminator that\n * tells the injected LABEL apart from a tool's own business parameter that\n * merely shares the name `intent`.\n *\n * Exported because host applications reimplement the same strip/sanitize\n * passes and would otherwise duplicate this as a string literal: if the two\n * copies drift, the host silently stops recognizing SDK-native labels and\n * fails OPEN (labels stay in schemas, opt-outs stop working) with no error.\n * Any edit to the description must preserve this prefix verbatim.\n */\nexport const INTENT_LABEL_MARKER = 'ALWAYS write this field FIRST';\n\n/**\n * Model-facing instruction for the injected `intent` property.\n *\n * Deliberately terse — it is repeated on every opted-in tool schema, on every\n * request, so each sentence is paid for many times over. What remains is\n * load-bearing: first-position placement (the entire streaming mechanism),\n * the one-sentence present-progressive form, who reads it, and the sibling\n * rule, without which models emit identical labels for parallel calls to one\n * tool and defeat the feature's headline case.\n */\nexport const INTENT_DESCRIPTION =\n  `${INTENT_LABEL_MARKER}, before any other argument. One present-progressive ` +\n  'sentence saying what THIS call is about to do: \"Searching for OAuth handling ' +\n  'in the callback router\". Shown to the user as this call\\'s live status. ' +\n  'Never name the tool. Sibling calls to one tool must differ.';\n\n/**\n * Canonical (frozen) shape of the injected property. Always embed a COPY\n * (`{ ...INTENT_PROPERTY }`): LangChain's JSON-schema validator stamps a\n * `__absolute_uri__` marker onto every subschema it dereferences, which\n * throws on a frozen object — and a single shared instance would be stamped\n * with one schema's URI while embedded in many.\n */\nexport const INTENT_PROPERTY: JsonSchemaType = Object.freeze<JsonSchemaType>({\n  type: 'string',\n  description: INTENT_DESCRIPTION,\n});\n\n/**\n * Discriminates the intent LABEL property from a tool's own business\n * parameter that merely shares the name: the label contract always opens\n * with the same instruction. Removal/sanitize passes must never strip a\n * parameter the tool actually needs.\n */\nexport function isIntentLabelProperty(property: unknown): boolean {\n  if (property == null || typeof property !== 'object') {\n    return false;\n  }\n  const record = property as { type?: unknown; description?: unknown };\n  return (\n    record.type === 'string' &&\n    typeof record.description === 'string' &&\n    record.description.startsWith(INTENT_LABEL_MARKER)\n  );\n}\n\n/**\n * Schema shape accepted by {@link withoutIntent}.\n *\n * `required` is widened to `readonly string[]` because the SDK's own native\n * schemas are declared `as const` — their `required` is a readonly tuple, and\n * a mutable `string[]` parameter would reject the very schemas this helper\n * exists for (TS2345), forcing embedders to cast to use the advertised API.\n */\nexport type IntentStrippableSchema = Omit<JsonSchemaType, 'required'> & {\n  required?: readonly string[];\n};\n\n/**\n * Returns a copy of `parameters` without the injected intent LABEL — the\n * opt-out for consumers that render no status label and should not pay for\n * the property.\n *\n * The SDK's native schemas carry the label unconditionally, so without this\n * an embedder has no lever at all: `withIntent` is applied at module scope.\n * Marker-guarded, so a tool's own business parameter named `intent` is never\n * removed. Returns the input unchanged when there is nothing to strip.\n *\n * `required` is pruned alongside the property: a schema that lists `intent`\n * as required (strict-mode normalization does exactly that, since OpenAI\n * strict function schemas require every property to appear in `required`)\n * would otherwise be left naming a property it no longer declares, which is\n * invalid JSON Schema and gets rejected by the provider instead of quietly\n * opting out.\n */\nexport function withoutIntent(parameters?: IntentStrippableSchema): JsonSchemaType | undefined {\n  const props = parameters?.properties;\n  if (parameters == null || props == null || !isIntentLabelProperty(props[INTENT_ARG])) {\n    return parameters as JsonSchemaType | undefined;\n  }\n  const { [INTENT_ARG]: _omit, ...rest } = props;\n  const next: JsonSchemaType = {\n    ...(parameters as JsonSchemaType),\n    properties: rest,\n  };\n  if (parameters.required != null) {\n    const required = parameters.required.filter((key) => key !== INTENT_ARG);\n    if (required.length > 0) {\n      next.required = required;\n    } else {\n      delete next.required;\n    }\n  }\n  return next;\n}\n\n/**\n * Returns a copy of the parameters schema with `intent` prepended as the\n * FIRST property (object key order is insertion order and every provider\n * serializer preserves it — first key in the schema means first key in the\n * streamed input). Never mutates the input; no-op when the schema already\n * declares `intent`. The property is not added to `required`.\n */\nexport function withIntent(parameters?: JsonSchemaType): JsonSchemaType {\n  const existingProps = parameters?.properties ?? {};\n  if (INTENT_ARG in existingProps) {\n    return parameters as JsonSchemaType;\n  }\n  return {\n    ...parameters,\n    type: 'object',\n    properties: { [INTENT_ARG]: { ...INTENT_PROPERTY }, ...existingProps },\n  };\n}\n\n/**\n * Coerces tool-call args to an object, parsing a stringified JSON object\n * (some providers deliver args as a string). Returns undefined otherwise.\n */\nfunction coerceArgsObject(args: unknown): Record<string, unknown> | undefined {\n  if (typeof args === 'object' && args !== null && !Array.isArray(args)) {\n    return args as Record<string, unknown>;\n  }\n  if (typeof args === 'string' && args.trim().startsWith('{')) {\n    try {\n      const parsed = JSON.parse(args) as unknown;\n      if (parsed != null && typeof parsed === 'object' && !Array.isArray(parsed)) {\n        return parsed as Record<string, unknown>;\n      }\n    } catch {\n      return undefined;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Reads the model-authored intent from tool-call args (handles stringified\n * args). Returns undefined when absent, empty, or not a string.\n */\nexport function readIntent(args: unknown): string | undefined {\n  const value = coerceArgsObject(args)?.[INTENT_ARG];\n  if (typeof value !== 'string') {\n    return undefined;\n  }\n  const trimmed = value.trim();\n  return trimmed === '' ? undefined : trimmed;\n}\n\n/**\n * Returns the args without the `intent` key so downstream consumers that did\n * not declare it never receive it. Parses stringified JSON object args;\n * returns the value unchanged when the key is absent.\n */\nexport function stripIntent(args: unknown): unknown {\n  const obj = coerceArgsObject(args);\n  if (!obj || !(INTENT_ARG in obj)) {\n    return args;\n  }\n  const { [INTENT_ARG]: _omit, ...rest } = obj;\n  return rest;\n}\n\n/**\n * Resolves the settled label for a call from its model-authored `intent` and\n * the tool's result fields, in precedence order:\n *\n *  1. `outcome` — full replacement authored by the tool.\n *  2. `outcome_patch` — first occurrence of `from` in the intent replaced\n *     with `to` (case-sensitive); no-op when `from` is absent or empty.\n *  3. Otherwise the intent is returned UNCHANGED.\n *\n * There is deliberately no mechanical present-progressive→past-tense rewrite.\n * Such a transform can only be a closed list of English verbs, which makes it\n * wrong in three ways at once: it never fires for the non-English labels this\n * feature expects (the model answers in the user's language), it fires for\n * some sibling calls and not others inside one group — \"Searched…\" beside\n * \"Recording…\" — and it quietly enumerates a vocabulary in a feature whose\n * premise is that the sentence is free-form. Completion is conveyed by UI\n * state (the shimmer stopping, the icon settling), which is language-neutral\n * and always consistent; a tool that wants past tense says so explicitly via\n * `outcome` or `outcome_patch`.\n *\n * Returns undefined when there is neither an intent nor an outcome, so\n * callers fall back to their default label. Pure and dependency-free — host\n * UIs needing identical logic can import or mirror it.\n */\nexport function applyOutcome(\n  intent: string | undefined,\n  result?: { outcome?: string; outcome_patch?: OutcomePatch },\n): string | undefined {\n  const outcome = result?.outcome;\n  if (typeof outcome === 'string' && outcome.trim() !== '') {\n    return outcome;\n  }\n  if (intent == null || intent === '') {\n    return undefined;\n  }\n  const patch = result?.outcome_patch;\n  if (patch != null && patch.from !== '' && intent.includes(patch.from)) {\n    /** Replacement callback keeps `to` verbatim — a direct string second\n     *  argument would interpret `$&`/`$'`-style tokens in tool-authored\n     *  text (e.g. labels derived from shell syntax). */\n    return intent.replace(patch.from, () => patch.to);\n  }\n  return intent;\n}\n\n/**\n * Hard cap on an emitted outcome label. The label is a single progress line\n * in UI chrome; a tool that derives it from data (or a malformed patch)\n * must not be able to inflate completion events or persisted parts.\n */\nconst MAX_OUTCOME_CHARS = 256;\n\nfunction boundOutcomeLabel(label: string | undefined): string | undefined {\n  if (label == null) {\n    return undefined;\n  }\n  const singleLine = label.replace(/\\s+/g, ' ').trim();\n  if (singleLine === '') {\n    return undefined;\n  }\n  if (singleLine.length <= MAX_OUTCOME_CHARS) {\n    return singleLine;\n  }\n  return `${singleLine.slice(0, MAX_OUTCOME_CHARS - 1)}…`;\n}\n\n/**\n * Resolves the settled label to emit on a completion event: only when the\n * tool actually authored `outcome`/`outcome_patch` fields. Returns undefined\n * otherwise, so the wire never carries a label the host already has — a bare\n * intent needs no settled form, because it is displayed unchanged and the UI\n * conveys completion through its own state. Hosts must NOT rewrite it (see\n * {@link applyOutcome} for why a tense transform is deliberately absent). The\n * result is collapsed to a bounded single line before emission.\n *\n * For failed calls (`isError`), only tool-AUTHORED text may label the call:\n * an explicit `outcome`, or a patch whose `from` actually matches the intent.\n * An unmatched patch resolves to undefined rather than silently reusing the\n * in-flight intent, so a failure is never labelled as though it succeeded.\n */\nexport function resolveToolOutcome(\n  args: unknown,\n  fields?: { outcome?: string; outcome_patch?: OutcomePatch } | null,\n  options?: { isError?: boolean },\n): string | undefined {\n  if (fields == null || (fields.outcome == null && fields.outcome_patch == null)) {\n    return undefined;\n  }\n  if (options?.isError !== true) {\n    return boundOutcomeLabel(applyOutcome(readIntent(args), fields));\n  }\n  const outcome = fields.outcome;\n  if (typeof outcome === 'string' && outcome.trim() !== '') {\n    return boundOutcomeLabel(outcome);\n  }\n  const intent = readIntent(args);\n  const patch = fields.outcome_patch;\n  if (\n    intent != null &&\n    patch != null &&\n    patch.from !== '' &&\n    intent.includes(patch.from)\n  ) {\n    return boundOutcomeLabel(intent.replace(patch.from, () => patch.to));\n  }\n  return undefined;\n}\n\n/**\n * Reads the outcome fields off a tool-execution result: the typed\n * `outcome`/`outcome_patch` fields when present, else the artifact channel\n * (see {@link readOutcomeFields}) — so a `content_and_artifact` tool authors\n * its label the same way on the direct and event-driven paths.\n */\nexport function outcomeFieldsFromResult(result: {\n  outcome?: string;\n  outcome_patch?: OutcomePatch;\n  artifact?: unknown;\n}): { outcome?: string; outcome_patch?: OutcomePatch } | undefined {\n  if (result.outcome != null || result.outcome_patch != null) {\n    return result;\n  }\n  return readOutcomeFields(result.artifact);\n}\n\n/**\n * Extracts validated `outcome`/`outcome_patch` fields from an arbitrary\n * value — the artifact channel through which an in-process\n * `content_and_artifact` tool authors its settled label. Returns undefined\n * when neither field is usable.\n */\nexport function readOutcomeFields(\n  source: unknown,\n): { outcome?: string; outcome_patch?: OutcomePatch } | undefined {\n  if (source == null || typeof source !== 'object' || Array.isArray(source)) {\n    return undefined;\n  }\n  const record = source as Record<string, unknown>;\n  const outcome =\n    typeof record.outcome === 'string' && record.outcome.trim() !== ''\n      ? record.outcome\n      : undefined;\n  let outcome_patch: OutcomePatch | undefined;\n  const rawPatch = record.outcome_patch;\n  if (rawPatch != null && typeof rawPatch === 'object' && !Array.isArray(rawPatch)) {\n    const patch = rawPatch as Record<string, unknown>;\n    if (typeof patch.from === 'string' && typeof patch.to === 'string') {\n      outcome_patch = { from: patch.from, to: patch.to };\n    }\n  }\n  if (outcome == null && outcome_patch == null) {\n    return undefined;\n  }\n  return { outcome, outcome_patch };\n}\n"],"mappings":"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"}
+{"version":3,"file":"intentArg.mjs","names":[],"sources":["../../../src/tools/intentArg.ts"],"mappings":"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"}

package/dist/esm/tools/local/CompileCheckTool.mjs

@@ -6,31 +6,6 @@ import { getLocalCwd, getWorkspaceFS, spawnLocalProcess, truncateLocalOutput, va
 import { tool } from "@langchain/core/tools";
 import { resolve } from "path";
 //#region src/tools/local/CompileCheckTool.ts
-/**
-* `compile_check` — a thin LLM-callable wrapper around the project's
-* standard typecheck/lint command. Lets the agent answer "did my
-* change break anything?" without us shipping a real LSP client.
-*
-* Auto-detection priority (first hit wins):
-*
-*   1. `local.compileCheck.command`            — explicit override
-*   2. `tsconfig.json`                          → `npx --no-install tsc --noEmit`
-*   3. `package.json` with a typescript dep    → same as 2
-*   4. `pyproject.toml` or `setup.py` / `setup.cfg`
-*      with a dev dep on mypy                  → `python3 -m mypy .`
-*      else                                    → `python3 -m py_compile <every .py>`
-*      (bounded by find-walk so node_modules
-*      and `.venv` don't blow up)
-*   5. `Cargo.toml`                            → `cargo check --message-format=short`
-*   6. `go.mod`                                → `go vet ./...`
-*   7. otherwise                               → tells the agent there's
-*                                                 no detected toolchain.
-*
-* Output is the spawn process's stdout/stderr passed through
-* `truncateLocalOutput` so a 10MB tsc dump can't blow context. The
-* exit code is reported.
-*/
-/** Back-compat alias; canonical name lives on `Constants.COMPILE_CHECK`. */
 const CompileCheckToolName = "compile_check";
 const CompileCheckSchema = withIntent({
 	type: "object",

package/dist/esm/tools/local/CompileCheckTool.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"CompileCheckTool.mjs","names":[],"sources":["../../../../src/tools/local/CompileCheckTool.ts"],"sourcesContent":["/**\n * `compile_check` — a thin LLM-callable wrapper around the project's\n * standard typecheck/lint command. Lets the agent answer \"did my\n * change break anything?\" without us shipping a real LSP client.\n *\n * Auto-detection priority (first hit wins):\n *\n *   1. `local.compileCheck.command`            — explicit override\n *   2. `tsconfig.json`                          → `npx --no-install tsc --noEmit`\n *   3. `package.json` with a typescript dep    → same as 2\n *   4. `pyproject.toml` or `setup.py` / `setup.cfg`\n *      with a dev dep on mypy                  → `python3 -m mypy .`\n *      else                                    → `python3 -m py_compile <every .py>`\n *      (bounded by find-walk so node_modules\n *      and `.venv` don't blow up)\n *   5. `Cargo.toml`                            → `cargo check --message-format=short`\n *   6. `go.mod`                                → `go vet ./...`\n *   7. otherwise                               → tells the agent there's\n *                                                 no detected toolchain.\n *\n * Output is the spawn process's stdout/stderr passed through\n * `truncateLocalOutput` so a 10MB tsc dump can't blow context. The\n * exit code is reported.\n */\n\nimport { resolve } from 'path';\nimport { tool } from '@langchain/core/tools';\nimport type { DynamicStructuredTool } from '@langchain/core/tools';\nimport type { WorkspaceFS } from './workspaceFS';\nimport type * as t from '@/types';\nimport {\n  getLocalCwd,\n  getWorkspaceFS,\n  spawnLocalProcess,\n  truncateLocalOutput,\n  validateBashCommand,\n} from './LocalExecutionEngine';\nimport { isWorkspaceClientTimeoutError } from './workspaceFS';\nimport { withIntent } from '@/tools/intentArg';\nimport { Constants } from '@/common';\n\n/** Back-compat alias; canonical name lives on `Constants.COMPILE_CHECK`. */\nexport const CompileCheckToolName = Constants.COMPILE_CHECK;\n\nconst CompileCheckSchema: t.JsonSchemaType = withIntent({\n  type: 'object',\n  properties: {\n    command: {\n      type: 'string',\n      description:\n        'Optional explicit command to run instead of the auto-detected one. Runs verbatim from the local engine cwd; honours the standard sandbox/AST gate.',\n    },\n    timeout_ms: {\n      type: 'integer',\n      description:\n        'Optional timeout in milliseconds. Defaults to 120000 (2 min).',\n    },\n  },\n});\n\ntype DetectedKind =\n  | 'typescript'\n  | 'python-mypy'\n  | 'python-compile'\n  | 'rust'\n  | 'go'\n  | 'unknown';\n\ntype Detection = {\n  kind: DetectedKind;\n  command: string;\n  reason: string;\n};\n\nasync function pathExists(fs: WorkspaceFS, p: string): Promise<boolean> {\n  try {\n    await fs.stat(p);\n    return true;\n  } catch (error) {\n    // A stalled-RPC timeout is not \"absent\" — don't let it pick a weaker/wrong\n    // toolchain after waiting through the backstop; surface it.\n    if (isWorkspaceClientTimeoutError(error)) {\n      throw error;\n    }\n    return false;\n  }\n}\n\n// Probes for project markers via the configured WorkspaceFS so a Run\n// with `local.exec.fs` (in-memory or remote engine) detects the right\n// toolchain against the actual workspace — not the host filesystem.\n// Codex P1 #25.\nasync function detect(cwd: string, fs: WorkspaceFS): Promise<Detection> {\n  if (await pathExists(fs, resolve(cwd, 'tsconfig.json'))) {\n    return {\n      kind: 'typescript',\n      command: 'npx --no-install tsc --noEmit',\n      reason: 'tsconfig.json present',\n    };\n  }\n  if (await pathExists(fs, resolve(cwd, 'package.json'))) {\n    const pkgRaw = await fs\n      .readFile(resolve(cwd, 'package.json'), 'utf8')\n      .catch((error) => {\n        if (isWorkspaceClientTimeoutError(error)) {\n          throw error;\n        }\n        return '';\n      });\n    if (pkgRaw.includes('\"typescript\"')) {\n      return {\n        kind: 'typescript',\n        command: 'npx --no-install tsc --noEmit',\n        reason: 'package.json declares typescript',\n      };\n    }\n  }\n  if (await pathExists(fs, resolve(cwd, 'Cargo.toml'))) {\n    return {\n      kind: 'rust',\n      command: 'cargo check --message-format=short',\n      reason: 'Cargo.toml present',\n    };\n  }\n  if (await pathExists(fs, resolve(cwd, 'go.mod'))) {\n    return {\n      kind: 'go',\n      command: 'go vet ./...',\n      reason: 'go.mod present',\n    };\n  }\n  if (\n    (await pathExists(fs, resolve(cwd, 'pyproject.toml'))) ||\n    (await pathExists(fs, resolve(cwd, 'setup.py'))) ||\n    (await pathExists(fs, resolve(cwd, 'setup.cfg')))\n  ) {\n    const pyToml = await fs\n      .readFile(resolve(cwd, 'pyproject.toml'), 'utf8')\n      .catch((error) => {\n        if (isWorkspaceClientTimeoutError(error)) {\n          throw error;\n        }\n        return '';\n      });\n    if (pyToml.includes('mypy')) {\n      return {\n        kind: 'python-mypy',\n        command: 'python3 -m mypy .',\n        reason: 'pyproject.toml declares mypy',\n      };\n    }\n    return {\n      kind: 'python-compile',\n      command:\n        'python3 -c \"import compileall, sys; sys.exit(0 if compileall.compile_dir(\\'.\\', quiet=1, rx=__import__(\\'re\\').compile(r\\'(node_modules|\\\\.venv|\\\\.git|build|dist)\\')) else 1)\"',\n      reason: 'Python project (no mypy detected)',\n    };\n  }\n  return {\n    kind: 'unknown',\n    command: '',\n    reason:\n      'no recognised project marker (tsconfig.json, package.json[typescript], Cargo.toml, go.mod, pyproject.toml, setup.py)',\n  };\n}\n\nconst DEFAULT_TIMEOUT_MS = 120_000;\n\nexport function createCompileCheckTool(\n  config: t.LocalExecutionConfig = {}\n): DynamicStructuredTool {\n  return tool(\n    async (rawInput) => {\n      const input = rawInput as {\n        command?: string;\n        timeout_ms?: number;\n      };\n      const cwd = getLocalCwd(config);\n      const fs = getWorkspaceFS(config);\n      const overrideCommand = input.command ?? config.compileCheck?.command;\n      let detection: Detection;\n      if (overrideCommand != null && overrideCommand.trim() !== '') {\n        detection = {\n          kind: 'unknown',\n          command: overrideCommand,\n          reason: 'explicit override',\n        };\n      } else {\n        detection = await detect(cwd, fs);\n      }\n\n      if (detection.command === '') {\n        const explainer = `compile_check: ${detection.reason}. Pass an explicit \\`command\\` (e.g. \\`npm run typecheck\\`) to override.`;\n        return [\n          explainer,\n          {\n            kind: detection.kind,\n            ran: false,\n            reason: detection.reason,\n            cwd,\n          },\n        ];\n      }\n\n      // Codex P1 #21: route the resolved command through the same\n      // safety gates the rest of the local engine uses. Without this\n      // a host with `readOnly: true` (or relying on the destructive-\n      // command guard) could be bypassed by passing a `command`\n      // override to compile_check that performs writes/deletes.\n      // Auto-detected commands (tsc/cargo/etc.) pass these gates\n      // unchanged — the validation is only blocking for genuinely\n      // mutating overrides.\n      const validation = await validateBashCommand(detection.command, config);\n      if (!validation.valid) {\n        const explainer = `compile_check refused to run \\`${detection.command}\\`: ${validation.errors.join('; ')}`;\n        return [\n          explainer,\n          {\n            kind: detection.kind,\n            ran: false,\n            reason: validation.errors.join('; '),\n            cwd,\n          },\n        ];\n      }\n\n      const timeoutMs =\n        input.timeout_ms ??\n        config.compileCheck?.timeoutMs ??\n        DEFAULT_TIMEOUT_MS;\n      const result = await spawnLocalProcess(\n        config.shell ?? (process.platform === 'win32' ? 'bash.exe' : 'bash'),\n        ['-lc', detection.command],\n        {\n          ...config,\n          timeoutMs,\n          maxOutputChars: config.maxOutputChars ?? 8000,\n        }\n      );\n\n      const passed = result.exitCode === 0 && !result.timedOut;\n      const headline = passed\n        ? `compile_check (${detection.kind}) PASSED via \\`${detection.command}\\``\n        : `compile_check (${detection.kind}) FAILED via \\`${detection.command}\\` ` +\n          `(exit=${result.exitCode ?? 'unknown'}${result.timedOut ? ', timed_out=true' : ''})`;\n\n      let body = '';\n      if (result.stdout !== '') {\n        body += `\\n\\nstdout:\\n${truncateLocalOutput(result.stdout, 4000)}`;\n      }\n      if (result.stderr !== '') {\n        body += `\\n\\nstderr:\\n${truncateLocalOutput(result.stderr, 4000)}`;\n      }\n      if (result.fullOutputPath != null) {\n        body += `\\n\\nfull_output_path: ${result.fullOutputPath}`;\n      }\n      const summary = `${headline}${body}\\n\\nworking_directory: ${cwd}\\nreason: ${detection.reason}`;\n\n      return [\n        summary,\n        {\n          kind: detection.kind,\n          ran: true,\n          passed,\n          exit_code: result.exitCode,\n          timed_out: result.timedOut,\n          command: detection.command,\n          cwd,\n        },\n      ];\n    },\n    {\n      name: CompileCheckToolName,\n      description:\n        'Run the project\\'s standard typecheck or lint pass and return its output. Auto-detects from project markers (tsconfig.json/package.json -> tsc; Cargo.toml -> cargo check; go.mod -> go vet; pyproject.toml -> mypy or py_compile). Pass `command` to override.',\n      schema: CompileCheckSchema,\n      responseFormat: Constants.CONTENT_AND_ARTIFACT,\n    }\n  );\n}\n\nexport function createCompileCheckToolDefinition(): t.LCTool {\n  return {\n    name: CompileCheckToolName,\n    description:\n      'Run the project\\'s standard typecheck or lint pass and return its output.',\n    parameters: CompileCheckSchema,\n    allowed_callers: ['direct', 'code_execution'],\n    responseFormat: Constants.CONTENT_AND_ARTIFACT,\n    toolType: 'builtin',\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"CompileCheckTool.mjs","names":[],"sources":["../../../../src/tools/local/CompileCheckTool.ts"],"mappings":"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"}

package/dist/esm/tools/local/FileCheckpointer.mjs

@@ -1,23 +1,6 @@
 import { isWorkspaceClientTimeoutError, nodeWorkspaceFS } from "./workspaceFS.mjs";
 import { dirname } from "path";
 //#region src/tools/local/FileCheckpointer.ts
-/**
-* Per-Run snapshot store for write_file / edit_file. Captures the
-* pre-write byte content of every path the local engine is about to
-* mutate so a later `rewind()` can restore the working tree to its
-* original state. Notes:
-*
-*  - Idempotent per path: subsequent captures preserve the first
-*    snapshot (so rewind always restores the *original* content).
-*  - Captures missing files as `{ kind: 'absent' }`; rewind deletes
-*    those paths so created files are removed.
-*  - In-memory: snapshots live for the lifetime of this instance and
-*    are not persisted across processes. Tie the lifetime to a Run.
-*  - Bounded by `maxBytesPerFile` (default 32 MiB) to bound memory.
-*    A file larger than the cap is recorded but not snapshotted; the
-*    rewind of that path is best-effort and the caller is told via
-*    the result count not to trust it.
-*/
 var LocalFileCheckpointerImpl = class {
 	maxBytesPerFile;
 	fs;
@@ -72,12 +55,6 @@ var LocalFileCheckpointerImpl = class {
 		return [...this.snapshots.keys(), ...this.oversizePaths];
 	}
 };
-/**
-* Convenience factory so callers don't have to reach for the impl
-* class directly. Accepts an optional `WorkspaceFS` so a host using a
-* non-default engine (remote sandbox, in-memory test FS, etc.) can
-* route the checkpointer through the same I/O.
-*/
 function createLocalFileCheckpointer(options = {}) {
 	return new LocalFileCheckpointerImpl(options.maxBytesPerFile, options.fs);
 }

package/dist/esm/tools/local/FileCheckpointer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"FileCheckpointer.mjs","names":[],"sources":["../../../../src/tools/local/FileCheckpointer.ts"],"sourcesContent":["import { dirname } from 'path';\nimport type { WorkspaceFS } from './workspaceFS';\nimport type * as t from '@/types';\nimport { isWorkspaceClientTimeoutError, nodeWorkspaceFS } from './workspaceFS';\n\ntype Snapshot = { kind: 'absent' } | { kind: 'present'; content: Buffer };\n\n/**\n * Per-Run snapshot store for write_file / edit_file. Captures the\n * pre-write byte content of every path the local engine is about to\n * mutate so a later `rewind()` can restore the working tree to its\n * original state. Notes:\n *\n *  - Idempotent per path: subsequent captures preserve the first\n *    snapshot (so rewind always restores the *original* content).\n *  - Captures missing files as `{ kind: 'absent' }`; rewind deletes\n *    those paths so created files are removed.\n *  - In-memory: snapshots live for the lifetime of this instance and\n *    are not persisted across processes. Tie the lifetime to a Run.\n *  - Bounded by `maxBytesPerFile` (default 32 MiB) to bound memory.\n *    A file larger than the cap is recorded but not snapshotted; the\n *    rewind of that path is best-effort and the caller is told via\n *    the result count not to trust it.\n */\nexport class LocalFileCheckpointerImpl implements t.LocalFileCheckpointer {\n  private snapshots = new Map<string, Snapshot>();\n  private oversizePaths = new Set<string>();\n\n  constructor(\n    private readonly maxBytesPerFile: number = 32 * 1024 * 1024,\n    private readonly fs: WorkspaceFS = nodeWorkspaceFS\n  ) {}\n\n  async captureBeforeWrite(absolutePath: string): Promise<void> {\n    if (\n      this.snapshots.has(absolutePath) ||\n      this.oversizePaths.has(absolutePath)\n    ) {\n      return;\n    }\n    let info;\n    try {\n      info = await this.fs.stat(absolutePath);\n    } catch (error) {\n      // A stalled-RPC timeout is NOT \"file absent\" — snapshotting it as absent\n      // would delete an existing file on revert. Surface it instead.\n      if (isWorkspaceClientTimeoutError(error)) {\n        throw error;\n      }\n      this.snapshots.set(absolutePath, { kind: 'absent' });\n      return;\n    }\n    if (!info.isFile()) {\n      return;\n    }\n    if (info.size > this.maxBytesPerFile) {\n      this.oversizePaths.add(absolutePath);\n      return;\n    }\n    const content = (await this.fs.readFile(absolutePath)) as Buffer;\n    this.snapshots.set(absolutePath, { kind: 'present', content });\n  }\n\n  async rewind(): Promise<number> {\n    let restored = 0;\n    for (const [path, snapshot] of this.snapshots.entries()) {\n      if (snapshot.kind === 'absent') {\n        await this.fs.unlink(path).catch((error) => {\n          // A timed-out delete did NOT happen — surface it rather than counting\n          // the path as restored (which would falsely claim the workspace is\n          // back to its pre-write state).\n          if (isWorkspaceClientTimeoutError(error)) {\n            throw error;\n          }\n        });\n        restored++;\n        continue;\n      }\n      try {\n        await this.fs.mkdir(dirname(path), { recursive: true });\n        await this.fs.writeFile(path, snapshot.content);\n        restored++;\n      } catch (error) {\n        // A timed-out restore left the bad write in place — surface it.\n        if (isWorkspaceClientTimeoutError(error)) {\n          throw error;\n        }\n        // Best-effort: ignore individual restore failures so the rest\n        // of the rewind continues.\n      }\n    }\n    return restored;\n  }\n\n  capturedPaths(): string[] {\n    return [...this.snapshots.keys(), ...this.oversizePaths];\n  }\n}\n\n/**\n * Convenience factory so callers don't have to reach for the impl\n * class directly. Accepts an optional `WorkspaceFS` so a host using a\n * non-default engine (remote sandbox, in-memory test FS, etc.) can\n * route the checkpointer through the same I/O.\n */\nexport function createLocalFileCheckpointer(\n  options: { maxBytesPerFile?: number; fs?: WorkspaceFS } = {}\n): t.LocalFileCheckpointer {\n  return new LocalFileCheckpointerImpl(options.maxBytesPerFile, options.fs);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAwBA,IAAa,4BAAb,MAA0E;CAKrD;CACA;CALnB,4BAAoB,IAAI,IAAsB;CAC9C,gCAAwB,IAAI,IAAY;CAExC,YACE,kBAA2C,KAAK,OAAO,MACvD,KAAmC,iBACnC;EAFiB,KAAA,kBAAA;EACA,KAAA,KAAA;CAChB;CAEH,MAAM,mBAAmB,cAAqC;EAC5D,IACE,KAAK,UAAU,IAAI,YAAY,KAC/B,KAAK,cAAc,IAAI,YAAY,GAEnC;EAEF,IAAI;EACJ,IAAI;GACF,OAAO,MAAM,KAAK,GAAG,KAAK,YAAY;EACxC,SAAS,OAAO;GAGd,IAAI,8BAA8B,KAAK,GACrC,MAAM;GAER,KAAK,UAAU,IAAI,cAAc,EAAE,MAAM,SAAS,CAAC;GACnD;EACF;EACA,IAAI,CAAC,KAAK,OAAO,GACf;EAEF,IAAI,KAAK,OAAO,KAAK,iBAAiB;GACpC,KAAK,cAAc,IAAI,YAAY;GACnC;EACF;EACA,MAAM,UAAW,MAAM,KAAK,GAAG,SAAS,YAAY;EACpD,KAAK,UAAU,IAAI,cAAc;GAAE,MAAM;GAAW;EAAQ,CAAC;CAC/D;CAEA,MAAM,SAA0B;EAC9B,IAAI,WAAW;EACf,KAAK,MAAM,CAAC,MAAM,aAAa,KAAK,UAAU,QAAQ,GAAG;GACvD,IAAI,SAAS,SAAS,UAAU;IAC9B,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,CAAC,OAAO,UAAU;KAI1C,IAAI,8BAA8B,KAAK,GACrC,MAAM;IAEV,CAAC;IACD;IACA;GACF;GACA,IAAI;IACF,MAAM,KAAK,GAAG,MAAM,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;IACtD,MAAM,KAAK,GAAG,UAAU,MAAM,SAAS,OAAO;IAC9C;GACF,SAAS,OAAO;IAEd,IAAI,8BAA8B,KAAK,GACrC,MAAM;GAIV;EACF;EACA,OAAO;CACT;CAEA,gBAA0B;EACxB,OAAO,CAAC,GAAG,KAAK,UAAU,KAAK,GAAG,GAAG,KAAK,aAAa;CACzD;AACF;;;;;;;AAQA,SAAgB,4BACd,UAA0D,CAAC,GAClC;CACzB,OAAO,IAAI,0BAA0B,QAAQ,iBAAiB,QAAQ,EAAE;AAC1E"}
+{"version":3,"file":"FileCheckpointer.mjs","names":[],"sources":["../../../../src/tools/local/FileCheckpointer.ts"],"mappings":";;;AAwBA,IAAa,4BAAb,MAA0E;CAKrD;CACA;CALnB,4BAAoB,IAAI,IAAsB;CAC9C,gCAAwB,IAAI,IAAY;CAExC,YACE,kBAA2C,KAAK,OAAO,MACvD,KAAmC,iBACnC;EAFiB,KAAA,kBAAA;EACA,KAAA,KAAA;CAChB;CAEH,MAAM,mBAAmB,cAAqC;EAC5D,IACE,KAAK,UAAU,IAAI,YAAY,KAC/B,KAAK,cAAc,IAAI,YAAY,GAEnC;EAEF,IAAI;EACJ,IAAI;GACF,OAAO,MAAM,KAAK,GAAG,KAAK,YAAY;EACxC,SAAS,OAAO;GAGd,IAAI,8BAA8B,KAAK,GACrC,MAAM;GAER,KAAK,UAAU,IAAI,cAAc,EAAE,MAAM,SAAS,CAAC;GACnD;EACF;EACA,IAAI,CAAC,KAAK,OAAO,GACf;EAEF,IAAI,KAAK,OAAO,KAAK,iBAAiB;GACpC,KAAK,cAAc,IAAI,YAAY;GACnC;EACF;EACA,MAAM,UAAW,MAAM,KAAK,GAAG,SAAS,YAAY;EACpD,KAAK,UAAU,IAAI,cAAc;GAAE,MAAM;GAAW;EAAQ,CAAC;CAC/D;CAEA,MAAM,SAA0B;EAC9B,IAAI,WAAW;EACf,KAAK,MAAM,CAAC,MAAM,aAAa,KAAK,UAAU,QAAQ,GAAG;GACvD,IAAI,SAAS,SAAS,UAAU;IAC9B,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,CAAC,OAAO,UAAU;KAI1C,IAAI,8BAA8B,KAAK,GACrC,MAAM;IAEV,CAAC;IACD;IACA;GACF;GACA,IAAI;IACF,MAAM,KAAK,GAAG,MAAM,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;IACtD,MAAM,KAAK,GAAG,UAAU,MAAM,SAAS,OAAO;IAC9C;GACF,SAAS,OAAO;IAEd,IAAI,8BAA8B,KAAK,GACrC,MAAM;GAIV;EACF;EACA,OAAO;CACT;CAEA,gBAA0B;EACxB,OAAO,CAAC,GAAG,KAAK,UAAU,KAAK,GAAG,GAAG,KAAK,aAAa;CACzD;AACF;AAQA,SAAgB,4BACd,UAA0D,CAAC,GAClC;CACzB,OAAO,IAAI,0BAA0B,QAAQ,iBAAiB,QAAQ,EAAE;AAC1E"}

package/dist/esm/tools/local/LocalCodingTools.mjs

@@ -19,12 +19,6 @@ const MAX_READ_CHARS = 256e3;
 const DEFAULT_MAX_RESULTS = 200;
 const DEFAULT_MAX_READ_BYTES = 10 * 1024 * 1024;
 const BINARY_DETECTION_BYTES = 8e3;
-/**
-* Tool name aliases retained for back-compat with consumers that imported
-* the per-file `Local*ToolName` constants. The canonical names live on
-* `Constants.*` (see `src/common/enum.ts`); these aliases just point at
-* them so a typo upstream gets caught at the type level.
-*/
 const LocalWriteFileToolName = "write_file";
 const LocalEditFileToolName = "edit_file";
 const LocalGrepSearchToolName = "grep_search";
@@ -192,20 +186,6 @@ function appendSyntaxCheckSummary(base, run) {
 	if (run.outcome.ok) return base;
 	return `${base}${run.mode === "strict" ? `\n\n[syntax-check FAILED via ${run.outcome.checker}]\n` : `\n\n[syntax-check warning via ${run.outcome.checker}]\n`}${run.outcome.output}`;
 }
-/**
-* Revert a write_file/edit_file mutation in `postEditSyntaxCheck:
-* 'strict'` mode after the post-write syntax check failed. Strict
-* mode advertises a safety gate, so leaving the corrupted file on
-* disk + throwing is a half-broken contract — the model "reacts" to
-* the error but the next call sees broken on-disk state. Codex P2
-* [49]. Best-effort: a swallowed error here means the workspace is
-* still in the bad post-write state, but we still throw the
-* original syntax-check error so the caller knows.
-*
-* - If the file existed pre-write: restore the previous bytes with
-*   the original encoding.
-* - If the file is brand-new: unlink it.
-*/
 async function revertStrictWrite(fs, path, existed, before, encoding) {
 	try {
 		if (existed) await fs.writeFile(path, encodeFile(before, {
@@ -434,17 +414,6 @@ function createLocalEditFileTool(config = {}, checkpointer) {
 		responseFormat: "content_and_artifact"
 	});
 }
-/**
-* Ripgrep availability cache, keyed on the *effective execution
-* backend* — whatever function `getSpawn(config)` returns. Without
-* the backend key, a Run that probes `rg` over Node's
-* `child_process.spawn` would poison subsequent Runs whose
-* `local.exec.spawn` routes to a remote sandbox or container that
-* doesn't have rg installed: the cached `true` would skip the probe,
-* the rg invocation would throw, and the Node fallback wouldn't be
-* reached. Per-backend caching avoids that without paying for a
-* spawn-per-search.
-*/
 let ripgrepAvailabilityByBackend = /* @__PURE__ */ new WeakMap();
 function envCacheKey(env) {
 	if (env == null) return "";
@@ -471,14 +440,6 @@ async function isRipgrepAvailable(config) {
 	}
 	return probePromise;
 }
-/**
-* Test-only reset hook. Clears the ripgrep-availability cache so
-* tests can swap in mocked spawn backends and reprobe deterministically.
-*
-* @internal Not part of the public SDK surface; the leading underscore
-*   and `@internal` tag together signal that consumers should not call
-*   this. Tests import it via the module path directly.
-*/
 function _resetRipgrepCacheForTests() {
 	ripgrepAvailabilityByBackend = /* @__PURE__ */ new WeakMap();
 }
@@ -543,44 +504,9 @@ async function* walkFiles(root, fs) {
 		}
 	}
 }
-/**
-* Catastrophic-backtracking guardrails for the fallback grep path.
-*
-* Without ripgrep we run the model-supplied pattern through Node's
-* `RegExp` engine, which uses a backtracking implementation. Patterns
-* with nested unbounded quantifiers (`(a+)+`, `(.*)*`, etc.) can
-* monopolise the event loop for arbitrary wall-clock time on
-* pathological input, and `setTimeout` cannot interrupt a synchronous
-* `RegExp.exec`. Manual review (finding D) flagged this as a real DoS.
-*
-* Mitigations applied here, in order of severity:
-*   1. Cap pattern length so an obviously oversize regex is rejected
-*      before compile.
-*   2. Reject patterns that contain a nested unbounded quantifier of
-*      the form `(...+|*)([+*]|{n,})` — the standard pathological
-*      shape. Still a heuristic (not a full safety proof), but blocks
-*      every common DoS construction we've seen in coding-agent logs.
-*   3. Wall-clock budget for the overall search: each file's regex
-*      pass is checked against a deadline; once exceeded the search
-*      bails with a partial result. Doesn't interrupt a stuck
-*      `exec()` call, but stops a slow pattern from making the whole
-*      Run hang once the first hung file finishes.
-*
-* Hosts that need bulletproof regex safety should install `rg` —
-* ripgrep uses RE2 internally and has no backtracking.
-*/
 const MAX_FALLBACK_PATTERN_LENGTH = 1024;
 const FALLBACK_GREP_BUDGET_MS = 5e3;
 const FALLBACK_GREP_MAX_FILE_BYTES = 5 * 1024 * 1024;
-/**
-* Heuristic: walks `pattern` to find any `(<contents>)<quant>` where
-* `<contents>` itself has an unbounded quantifier. Catches the
-* classic `(a+)+` form AND the double-nested `((a+)+)` form (which a
-* single-pass regex misses because `[^)]*` stops at the first inner
-* close-paren). Misses sufficiently obfuscated cases — bulletproof
-* ReDoS detection requires a real parser. The 5 s wall-clock budget
-* is the hard backstop for anything this slip past.
-*/
 function hasNestedUnboundedQuantifier(pattern) {
 	for (let i = 1; i < pattern.length - 1; i++) {
 		if (pattern[i] !== ")") continue;
@@ -622,7 +548,6 @@ function compileFallbackRegex(pattern) {
 		throw new FallbackGrepError("invalid-pattern", `Invalid regex: ${e.message}`);
 	}
 }
-/** Renders fallback-grep output: real matches first, skip diagnostics appended. */
 function formatFallbackGrepDisplay(result) {
 	if (result.matches.length > 0) return [...result.matches, ...result.skipped].join("\n");
 	if (result.skipped.length > 0) return result.skipped.join("\n");
@@ -832,11 +757,6 @@ function createLocalCodingTools(config = {}, options = {}) {
 		createLocalBashProgrammaticToolCallingTool(config)
 	];
 }
-/**
-* Variant of `createLocalCodingTools` that returns the bundle alongside
-* the file checkpointer so callers can later call
-* `bundle.checkpointer?.rewind()`.
-*/
 function createLocalCodingToolBundle(config = {}, options = {}) {
 	const checkpointer = options.checkpointer ?? (config.fileCheckpointing === true ? createLocalFileCheckpointer({ fs: config.exec?.fs }) : void 0);
 	return {