iosm-cli 0.2.8 → 0.2.9

package/dist/core/tools/lint-run.js

@@ -0,0 +1,276 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { Type } from "@sinclair/typebox";
+import { resolveToCwd } from "./path-utils.js";
+import { detectPackageManager, ensureCommandOrThrow, formatVerificationOutput, readPackageJson, resolvePackageManagerExecInvocation, resolvePackageManagerRunInvocation, runVerificationCommand, } from "./verification-runner.js";
+const lintRunSchema = Type.Object({
+    runner: Type.Optional(Type.Union([
+        Type.Literal("auto"),
+        Type.Literal("npm"),
+        Type.Literal("pnpm"),
+        Type.Literal("yarn"),
+        Type.Literal("bun"),
+        Type.Literal("eslint"),
+        Type.Literal("prettier"),
+        Type.Literal("stylelint"),
+    ], {
+        description: "Linter runner: auto | npm | pnpm | yarn | bun | eslint | prettier | stylelint",
+    })),
+    mode: Type.Optional(Type.Union([Type.Literal("check"), Type.Literal("fix")], {
+        description: "Lint mode: check | fix (default: check).",
+    })),
+    script: Type.Optional(Type.String({
+        description: "Package script for npm/pnpm/yarn/bun runners (default: lint or lint:fix by mode).",
+    })),
+    targets: Type.Optional(Type.Array(Type.String(), {
+        description: "Optional explicit lint targets (paths/globs).",
+    })),
+    args: Type.Optional(Type.Array(Type.String(), {
+        description: "Additional CLI args forwarded to the selected linter runner.",
+    })),
+    path: Type.Optional(Type.String({ description: "Working directory for lint execution (default: current directory)." })),
+    timeout: Type.Optional(Type.Number({ description: "Timeout in seconds (default: 300)." })),
+});
+export const DEFAULT_LINT_RUN_TIMEOUT_SECONDS = 300;
+function normalizeTimeoutSeconds(raw) {
+    if (raw === undefined)
+        return DEFAULT_LINT_RUN_TIMEOUT_SECONDS;
+    const value = Math.floor(raw);
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error("timeout must be a positive number.");
+    }
+    return value;
+}
+function normalizeStringArray(raw) {
+    return (raw ?? []).map((item) => String(item));
+}
+function normalizeScriptName(raw, mode) {
+    const fallback = mode === "fix" ? "lint:fix" : "lint";
+    const script = (raw ?? fallback).trim();
+    if (script.length === 0) {
+        throw new Error("script must not be empty.");
+    }
+    return script;
+}
+function hasAnyFile(cwd, fileNames) {
+    return fileNames.some((name) => existsSync(join(cwd, name)));
+}
+function hasEslintConfig(cwd, packageJsonEslintConfig) {
+    if (packageJsonEslintConfig && typeof packageJsonEslintConfig === "object") {
+        return true;
+    }
+    return hasAnyFile(cwd, [
+        "eslint.config.js",
+        "eslint.config.cjs",
+        "eslint.config.mjs",
+        "eslint.config.ts",
+        "eslint.config.mts",
+        "eslint.config.cts",
+        ".eslintrc",
+        ".eslintrc.js",
+        ".eslintrc.cjs",
+        ".eslintrc.mjs",
+        ".eslintrc.yaml",
+        ".eslintrc.yml",
+        ".eslintrc.json",
+    ]);
+}
+function hasStylelintConfig(cwd, packageJsonStylelint) {
+    if (packageJsonStylelint && typeof packageJsonStylelint === "object") {
+        return true;
+    }
+    return hasAnyFile(cwd, [
+        "stylelint.config.js",
+        "stylelint.config.cjs",
+        "stylelint.config.mjs",
+        "stylelint.config.ts",
+        "stylelint.config.mts",
+        "stylelint.config.cts",
+        ".stylelintrc",
+        ".stylelintrc.js",
+        ".stylelintrc.cjs",
+        ".stylelintrc.mjs",
+        ".stylelintrc.yaml",
+        ".stylelintrc.yml",
+        ".stylelintrc.json",
+    ]);
+}
+function hasPrettierConfig(cwd, packageJsonPrettier) {
+    if (typeof packageJsonPrettier === "string" || (packageJsonPrettier && typeof packageJsonPrettier === "object")) {
+        return true;
+    }
+    return hasAnyFile(cwd, [
+        ".prettierrc",
+        ".prettierrc.js",
+        ".prettierrc.cjs",
+        ".prettierrc.mjs",
+        ".prettierrc.json",
+        ".prettierrc.yaml",
+        ".prettierrc.yml",
+        ".prettierrc.toml",
+        "prettier.config.js",
+        "prettier.config.cjs",
+        "prettier.config.mjs",
+    ]);
+}
+function assertPackageManagerAvailable(packageManager) {
+    if (packageManager === "bun") {
+        ensureCommandOrThrow("bun", 'Command "bun" is required for bun-based lint execution.');
+        return;
+    }
+    ensureCommandOrThrow(packageManager, `Command "${packageManager}" is required for lint execution.`);
+}
+function resolveScriptBasedCommand(packageManager, script, args) {
+    assertPackageManagerAvailable(packageManager);
+    const invocation = resolvePackageManagerRunInvocation(packageManager, script, args);
+    return {
+        resolvedRunner: packageManager,
+        command: invocation.command,
+        args: invocation.args,
+    };
+}
+function buildDirectLintArgs(runner, mode, targets, args) {
+    const effectiveTargets = targets.length > 0 ? targets : runner === "stylelint" ? ["**/*.{css,scss,sass,less}"] : ["."];
+    if (runner === "eslint") {
+        const modeArgs = mode === "fix" ? ["--fix"] : [];
+        return [...modeArgs, ...args, ...effectiveTargets];
+    }
+    if (runner === "prettier") {
+        const modeArgs = mode === "fix" ? ["--write"] : ["--check"];
+        return [...modeArgs, ...args, ...effectiveTargets];
+    }
+    const modeArgs = mode === "fix" ? ["--fix"] : [];
+    return [...modeArgs, ...args, ...effectiveTargets];
+}
+function resolveDirectLintCommand(packageManager, runner, mode, targets, args) {
+    assertPackageManagerAvailable(packageManager);
+    const directArgs = buildDirectLintArgs(runner, mode, targets, args);
+    const invocation = resolvePackageManagerExecInvocation(packageManager, runner, directArgs);
+    ensureCommandOrThrow(invocation.command, `Command "${invocation.command}" is required to run ${runner}. Install ${packageManager} tooling first.`);
+    return {
+        resolvedRunner: runner,
+        command: invocation.command,
+        args: invocation.args,
+    };
+}
+function resolveAutoRunner(cwd, script) {
+    const packageJson = readPackageJson(cwd);
+    if (packageJson?.scripts[script]) {
+        return detectPackageManager(cwd);
+    }
+    if (hasEslintConfig(cwd, packageJson?.raw?.eslintConfig))
+        return "eslint";
+    if (hasStylelintConfig(cwd, packageJson?.raw?.stylelint))
+        return "stylelint";
+    if (hasPrettierConfig(cwd, packageJson?.raw?.prettier))
+        return "prettier";
+    throw new Error('Unable to auto-detect lint runner. Expected package.json lint script or eslint/stylelint/prettier config.');
+}
+function hasCheckModeConflictArgs(args) {
+    for (const arg of args) {
+        if (arg === "--fix" || arg.startsWith("--fix=") || arg === "--write" || arg.startsWith("--write=")) {
+            return arg;
+        }
+    }
+    return undefined;
+}
+function resolveLintCommand(input) {
+    const packageJson = readPackageJson(input.cwd);
+    let resolvedRunner;
+    if (input.runner === "auto") {
+        resolvedRunner = resolveAutoRunner(input.cwd, input.script);
+    }
+    else {
+        resolvedRunner = input.runner;
+    }
+    if (resolvedRunner === "npm" || resolvedRunner === "pnpm" || resolvedRunner === "yarn" || resolvedRunner === "bun") {
+        if (!packageJson) {
+            throw new Error(`package.json is required to run ${resolvedRunner} scripts.`);
+        }
+        if (!packageJson.scripts[input.script]) {
+            throw new Error(`Script "${input.script}" is not defined in package.json.`);
+        }
+        return resolveScriptBasedCommand(resolvedRunner, input.script, input.args);
+    }
+    const packageManager = detectPackageManager(input.cwd);
+    return resolveDirectLintCommand(packageManager, resolvedRunner, input.mode, input.targets, input.args);
+}
+function mapLintStatus(exitCode) {
+    if (exitCode === 0)
+        return "passed";
+    if (exitCode === 1)
+        return "failed";
+    return "error";
+}
+function renderSummary(details, output) {
+    const argsText = details.resolvedArgs.length > 0 ? ` ${details.resolvedArgs.join(" ")}` : "";
+    return [
+        `lint_run status: ${details.status}`,
+        `runner: ${details.resolvedRunner}`,
+        `mode: ${details.mode}`,
+        `command: ${details.resolvedCommand}${argsText}`,
+        `cwd: ${details.cwd}`,
+        `exit_code: ${details.exitCode}`,
+        `duration_ms: ${details.durationMs}`,
+        "",
+        output,
+    ].join("\n");
+}
+export function createLintRunTool(cwd) {
+    return {
+        name: "lint_run",
+        label: "lint_run",
+        description: "Structured lint runner with auto detection across npm/pnpm/yarn/bun scripts and eslint/prettier/stylelint direct execution. Returns normalized status without throwing on ordinary lint failures.",
+        parameters: lintRunSchema,
+        execute: async (_toolCallId, input, signal) => {
+            const executionCwd = resolveToCwd(input.path || ".", cwd);
+            const timeoutSeconds = normalizeTimeoutSeconds(input.timeout);
+            const args = normalizeStringArray(input.args);
+            const targets = normalizeStringArray(input.targets);
+            const mode = input.mode ?? "check";
+            const script = normalizeScriptName(input.script, mode);
+            const runner = input.runner ?? "auto";
+            if (mode === "check") {
+                const conflictArg = hasCheckModeConflictArgs(args);
+                if (conflictArg) {
+                    throw new Error(`Argument "${conflictArg}" is incompatible with mode=check.`);
+                }
+            }
+            const command = resolveLintCommand({
+                cwd: executionCwd,
+                runner,
+                mode,
+                script,
+                args,
+                targets,
+            });
+            const result = await runVerificationCommand({
+                command: command.command,
+                args: command.args,
+                cwd: executionCwd,
+                timeoutMs: timeoutSeconds * 1000,
+                signal,
+            });
+            const status = mapLintStatus(result.exitCode);
+            const formatted = formatVerificationOutput(result.stdout, result.stderr, result.captureTruncated, "No lint output");
+            const details = {
+                resolvedRunner: command.resolvedRunner,
+                resolvedCommand: command.command,
+                resolvedArgs: command.args,
+                cwd: executionCwd,
+                mode,
+                exitCode: result.exitCode,
+                status,
+                durationMs: result.durationMs,
+                captureTruncated: result.captureTruncated || undefined,
+                truncation: formatted.truncation,
+            };
+            return {
+                content: [{ type: "text", text: renderSummary(details, formatted.text) }],
+                details,
+            };
+        },
+    };
+}
+export const lintRunTool = createLintRunTool(process.cwd());
+//# sourceMappingURL=lint-run.js.map

package/dist/core/tools/lint-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-run.js","sourceRoot":"","sources":["../../../src/core/tools/lint-run.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport type { AgentTool } from \"@mariozechner/pi-agent-core\";\nimport { type Static, Type } from \"@sinclair/typebox\";\nimport { resolveToCwd } from \"./path-utils.js\";\nimport type { TruncationResult } from \"./truncate.js\";\nimport {\n\ttype PackageManager,\n\tdetectPackageManager,\n\tensureCommandOrThrow,\n\tformatVerificationOutput,\n\treadPackageJson,\n\tresolvePackageManagerExecInvocation,\n\tresolvePackageManagerRunInvocation,\n\trunVerificationCommand,\n} from \"./verification-runner.js\";\n\nconst lintRunSchema = Type.Object({\n\trunner: Type.Optional(\n\t\tType.Union(\n\t\t\t[\n\t\t\t\tType.Literal(\"auto\"),\n\t\t\t\tType.Literal(\"npm\"),\n\t\t\t\tType.Literal(\"pnpm\"),\n\t\t\t\tType.Literal(\"yarn\"),\n\t\t\t\tType.Literal(\"bun\"),\n\t\t\t\tType.Literal(\"eslint\"),\n\t\t\t\tType.Literal(\"prettier\"),\n\t\t\t\tType.Literal(\"stylelint\"),\n\t\t\t],\n\t\t\t{\n\t\t\t\tdescription: \"Linter runner: auto | npm | pnpm | yarn | bun | eslint | prettier | stylelint\",\n\t\t\t},\n\t\t),\n\t),\n\tmode: Type.Optional(\n\t\tType.Union([Type.Literal(\"check\"), Type.Literal(\"fix\")], {\n\t\t\tdescription: \"Lint mode: check | fix (default: check).\",\n\t\t}),\n\t),\n\tscript: Type.Optional(\n\t\tType.String({\n\t\t\tdescription: \"Package script for npm/pnpm/yarn/bun runners (default: lint or lint:fix by mode).\",\n\t\t}),\n\t),\n\ttargets: Type.Optional(\n\t\tType.Array(Type.String(), {\n\t\t\tdescription: \"Optional explicit lint targets (paths/globs).\",\n\t\t}),\n\t),\n\targs: Type.Optional(\n\t\tType.Array(Type.String(), {\n\t\t\tdescription: \"Additional CLI args forwarded to the selected linter runner.\",\n\t\t}),\n\t),\n\tpath: Type.Optional(Type.String({ description: \"Working directory for lint execution (default: current directory).\" })),\n\ttimeout: Type.Optional(Type.Number({ description: \"Timeout in seconds (default: 300).\" })),\n});\n\nexport type LintRunToolInput = Static<typeof lintRunSchema>;\nexport type LintRunRunner = \"auto\" | \"npm\" | \"pnpm\" | \"yarn\" | \"bun\" | \"eslint\" | \"prettier\" | \"stylelint\";\nexport type LintRunMode = \"check\" | \"fix\";\nexport type LintRunStatus = \"passed\" | \"failed\" | \"no_tests\" | \"error\";\n\ntype ResolvedLintRunner = Exclude<LintRunRunner, \"auto\">;\n\ninterface ResolvedLintCommand {\n\tresolvedRunner: ResolvedLintRunner;\n\tcommand: string;\n\targs: string[];\n}\n\nexport interface LintRunToolDetails {\n\tresolvedRunner: ResolvedLintRunner;\n\tresolvedCommand: string;\n\tresolvedArgs: string[];\n\tcwd: string;\n\tmode: LintRunMode;\n\texitCode: number;\n\tstatus: LintRunStatus;\n\tdurationMs: number;\n\tcaptureTruncated?: boolean;\n\ttruncation?: TruncationResult;\n}\n\nexport const DEFAULT_LINT_RUN_TIMEOUT_SECONDS = 300;\n\nfunction normalizeTimeoutSeconds(raw: number | undefined): number {\n\tif (raw === undefined) return DEFAULT_LINT_RUN_TIMEOUT_SECONDS;\n\tconst value = Math.floor(raw);\n\tif (!Number.isFinite(value) || value <= 0) {\n\t\tthrow new Error(\"timeout must be a positive number.\");\n\t}\n\treturn value;\n}\n\nfunction normalizeStringArray(raw: string[] | undefined): string[] {\n\treturn (raw ?? []).map((item) => String(item));\n}\n\nfunction normalizeScriptName(raw: string | undefined, mode: LintRunMode): string {\n\tconst fallback = mode === \"fix\" ? \"lint:fix\" : \"lint\";\n\tconst script = (raw ?? fallback).trim();\n\tif (script.length === 0) {\n\t\tthrow new Error(\"script must not be empty.\");\n\t}\n\treturn script;\n}\n\nfunction hasAnyFile(cwd: string, fileNames: string[]): boolean {\n\treturn fileNames.some((name) => existsSync(join(cwd, name)));\n}\n\nfunction hasEslintConfig(cwd: string, packageJsonEslintConfig: unknown): boolean {\n\tif (packageJsonEslintConfig && typeof packageJsonEslintConfig === \"object\") {\n\t\treturn true;\n\t}\n\treturn hasAnyFile(cwd, [\n\t\t\"eslint.config.js\",\n\t\t\"eslint.config.cjs\",\n\t\t\"eslint.config.mjs\",\n\t\t\"eslint.config.ts\",\n\t\t\"eslint.config.mts\",\n\t\t\"eslint.config.cts\",\n\t\t\".eslintrc\",\n\t\t\".eslintrc.js\",\n\t\t\".eslintrc.cjs\",\n\t\t\".eslintrc.mjs\",\n\t\t\".eslintrc.yaml\",\n\t\t\".eslintrc.yml\",\n\t\t\".eslintrc.json\",\n\t]);\n}\n\nfunction hasStylelintConfig(cwd: string, packageJsonStylelint: unknown): boolean {\n\tif (packageJsonStylelint && typeof packageJsonStylelint === \"object\") {\n\t\treturn true;\n\t}\n\treturn hasAnyFile(cwd, [\n\t\t\"stylelint.config.js\",\n\t\t\"stylelint.config.cjs\",\n\t\t\"stylelint.config.mjs\",\n\t\t\"stylelint.config.ts\",\n\t\t\"stylelint.config.mts\",\n\t\t\"stylelint.config.cts\",\n\t\t\".stylelintrc\",\n\t\t\".stylelintrc.js\",\n\t\t\".stylelintrc.cjs\",\n\t\t\".stylelintrc.mjs\",\n\t\t\".stylelintrc.yaml\",\n\t\t\".stylelintrc.yml\",\n\t\t\".stylelintrc.json\",\n\t]);\n}\n\nfunction hasPrettierConfig(cwd: string, packageJsonPrettier: unknown): boolean {\n\tif (typeof packageJsonPrettier === \"string\" || (packageJsonPrettier && typeof packageJsonPrettier === \"object\")) {\n\t\treturn true;\n\t}\n\treturn hasAnyFile(cwd, [\n\t\t\".prettierrc\",\n\t\t\".prettierrc.js\",\n\t\t\".prettierrc.cjs\",\n\t\t\".prettierrc.mjs\",\n\t\t\".prettierrc.json\",\n\t\t\".prettierrc.yaml\",\n\t\t\".prettierrc.yml\",\n\t\t\".prettierrc.toml\",\n\t\t\"prettier.config.js\",\n\t\t\"prettier.config.cjs\",\n\t\t\"prettier.config.mjs\",\n\t]);\n}\n\nfunction assertPackageManagerAvailable(packageManager: PackageManager): void {\n\tif (packageManager === \"bun\") {\n\t\tensureCommandOrThrow(\"bun\", 'Command \"bun\" is required for bun-based lint execution.');\n\t\treturn;\n\t}\n\tensureCommandOrThrow(packageManager, `Command \"${packageManager}\" is required for lint execution.`);\n}\n\nfunction resolveScriptBasedCommand(packageManager: PackageManager, script: string, args: string[]): ResolvedLintCommand {\n\tassertPackageManagerAvailable(packageManager);\n\tconst invocation = resolvePackageManagerRunInvocation(packageManager, script, args);\n\treturn {\n\t\tresolvedRunner: packageManager,\n\t\tcommand: invocation.command,\n\t\targs: invocation.args,\n\t};\n}\n\nfunction buildDirectLintArgs(\n\trunner: \"eslint\" | \"prettier\" | \"stylelint\",\n\tmode: LintRunMode,\n\ttargets: string[],\n\targs: string[],\n): string[] {\n\tconst effectiveTargets =\n\t\ttargets.length > 0 ? targets : runner === \"stylelint\" ? [\"**/*.{css,scss,sass,less}\"] : [\".\"];\n\n\tif (runner === \"eslint\") {\n\t\tconst modeArgs = mode === \"fix\" ? [\"--fix\"] : [];\n\t\treturn [...modeArgs, ...args, ...effectiveTargets];\n\t}\n\tif (runner === \"prettier\") {\n\t\tconst modeArgs = mode === \"fix\" ? [\"--write\"] : [\"--check\"];\n\t\treturn [...modeArgs, ...args, ...effectiveTargets];\n\t}\n\tconst modeArgs = mode === \"fix\" ? [\"--fix\"] : [];\n\treturn [...modeArgs, ...args, ...effectiveTargets];\n}\n\nfunction resolveDirectLintCommand(\n\tpackageManager: PackageManager,\n\trunner: \"eslint\" | \"prettier\" | \"stylelint\",\n\tmode: LintRunMode,\n\ttargets: string[],\n\targs: string[],\n): ResolvedLintCommand {\n\tassertPackageManagerAvailable(packageManager);\n\tconst directArgs = buildDirectLintArgs(runner, mode, targets, args);\n\tconst invocation = resolvePackageManagerExecInvocation(packageManager, runner, directArgs);\n\tensureCommandOrThrow(\n\t\tinvocation.command,\n\t\t`Command \"${invocation.command}\" is required to run ${runner}. Install ${packageManager} tooling first.`,\n\t);\n\treturn {\n\t\tresolvedRunner: runner,\n\t\tcommand: invocation.command,\n\t\targs: invocation.args,\n\t};\n}\n\nfunction resolveAutoRunner(cwd: string, script: string): ResolvedLintRunner {\n\tconst packageJson = readPackageJson(cwd);\n\tif (packageJson?.scripts[script]) {\n\t\treturn detectPackageManager(cwd);\n\t}\n\tif (hasEslintConfig(cwd, packageJson?.raw?.eslintConfig)) return \"eslint\";\n\tif (hasStylelintConfig(cwd, packageJson?.raw?.stylelint)) return \"stylelint\";\n\tif (hasPrettierConfig(cwd, packageJson?.raw?.prettier)) return \"prettier\";\n\tthrow new Error(\n\t\t'Unable to auto-detect lint runner. Expected package.json lint script or eslint/stylelint/prettier config.',\n\t);\n}\n\nfunction hasCheckModeConflictArgs(args: string[]): string | undefined {\n\tfor (const arg of args) {\n\t\tif (arg === \"--fix\" || arg.startsWith(\"--fix=\") || arg === \"--write\" || arg.startsWith(\"--write=\")) {\n\t\t\treturn arg;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction resolveLintCommand(input: {\n\tcwd: string;\n\trunner: LintRunRunner;\n\tmode: LintRunMode;\n\tscript: string;\n\targs: string[];\n\ttargets: string[];\n}): ResolvedLintCommand {\n\tconst packageJson = readPackageJson(input.cwd);\n\tlet resolvedRunner: ResolvedLintRunner;\n\n\tif (input.runner === \"auto\") {\n\t\tresolvedRunner = resolveAutoRunner(input.cwd, input.script);\n\t} else {\n\t\tresolvedRunner = input.runner;\n\t}\n\n\tif (resolvedRunner === \"npm\" || resolvedRunner === \"pnpm\" || resolvedRunner === \"yarn\" || resolvedRunner === \"bun\") {\n\t\tif (!packageJson) {\n\t\t\tthrow new Error(`package.json is required to run ${resolvedRunner} scripts.`);\n\t\t}\n\t\tif (!packageJson.scripts[input.script]) {\n\t\t\tthrow new Error(`Script \"${input.script}\" is not defined in package.json.`);\n\t\t}\n\t\treturn resolveScriptBasedCommand(resolvedRunner, input.script, input.args);\n\t}\n\n\tconst packageManager = detectPackageManager(input.cwd);\n\treturn resolveDirectLintCommand(packageManager, resolvedRunner, input.mode, input.targets, input.args);\n}\n\nfunction mapLintStatus(exitCode: number): LintRunStatus {\n\tif (exitCode === 0) return \"passed\";\n\tif (exitCode === 1) return \"failed\";\n\treturn \"error\";\n}\n\nfunction renderSummary(details: LintRunToolDetails, output: string): string {\n\tconst argsText = details.resolvedArgs.length > 0 ? ` ${details.resolvedArgs.join(\" \")}` : \"\";\n\treturn [\n\t\t`lint_run status: ${details.status}`,\n\t\t`runner: ${details.resolvedRunner}`,\n\t\t`mode: ${details.mode}`,\n\t\t`command: ${details.resolvedCommand}${argsText}`,\n\t\t`cwd: ${details.cwd}`,\n\t\t`exit_code: ${details.exitCode}`,\n\t\t`duration_ms: ${details.durationMs}`,\n\t\t\"\",\n\t\toutput,\n\t].join(\"\\n\");\n}\n\nexport function createLintRunTool(cwd: string): AgentTool<typeof lintRunSchema> {\n\treturn {\n\t\tname: \"lint_run\",\n\t\tlabel: \"lint_run\",\n\t\tdescription:\n\t\t\t\"Structured lint runner with auto detection across npm/pnpm/yarn/bun scripts and eslint/prettier/stylelint direct execution. Returns normalized status without throwing on ordinary lint failures.\",\n\t\tparameters: lintRunSchema,\n\t\texecute: async (_toolCallId: string, input: LintRunToolInput, signal?: AbortSignal) => {\n\t\t\tconst executionCwd = resolveToCwd(input.path || \".\", cwd);\n\t\t\tconst timeoutSeconds = normalizeTimeoutSeconds(input.timeout);\n\t\t\tconst args = normalizeStringArray(input.args);\n\t\t\tconst targets = normalizeStringArray(input.targets);\n\t\t\tconst mode: LintRunMode = input.mode ?? \"check\";\n\t\t\tconst script = normalizeScriptName(input.script, mode);\n\t\t\tconst runner: LintRunRunner = input.runner ?? \"auto\";\n\n\t\t\tif (mode === \"check\") {\n\t\t\t\tconst conflictArg = hasCheckModeConflictArgs(args);\n\t\t\t\tif (conflictArg) {\n\t\t\t\t\tthrow new Error(`Argument \"${conflictArg}\" is incompatible with mode=check.`);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst command = resolveLintCommand({\n\t\t\t\tcwd: executionCwd,\n\t\t\t\trunner,\n\t\t\t\tmode,\n\t\t\t\tscript,\n\t\t\t\targs,\n\t\t\t\ttargets,\n\t\t\t});\n\n\t\t\tconst result = await runVerificationCommand({\n\t\t\t\tcommand: command.command,\n\t\t\t\targs: command.args,\n\t\t\t\tcwd: executionCwd,\n\t\t\t\ttimeoutMs: timeoutSeconds * 1000,\n\t\t\t\tsignal,\n\t\t\t});\n\n\t\t\tconst status = mapLintStatus(result.exitCode);\n\t\t\tconst formatted = formatVerificationOutput(\n\t\t\t\tresult.stdout,\n\t\t\t\tresult.stderr,\n\t\t\t\tresult.captureTruncated,\n\t\t\t\t\"No lint output\",\n\t\t\t);\n\n\t\t\tconst details: LintRunToolDetails = {\n\t\t\t\tresolvedRunner: command.resolvedRunner,\n\t\t\t\tresolvedCommand: command.command,\n\t\t\t\tresolvedArgs: command.args,\n\t\t\t\tcwd: executionCwd,\n\t\t\t\tmode,\n\t\t\t\texitCode: result.exitCode,\n\t\t\t\tstatus,\n\t\t\t\tdurationMs: result.durationMs,\n\t\t\t\tcaptureTruncated: result.captureTruncated || undefined,\n\t\t\t\ttruncation: formatted.truncation,\n\t\t\t};\n\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: renderSummary(details, formatted.text) }],\n\t\t\t\tdetails,\n\t\t\t};\n\t\t},\n\t};\n}\n\nexport const lintRunTool = createLintRunTool(process.cwd());\n\n"]}

package/dist/core/tools/test-run.d.ts

@@ -0,0 +1,36 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import { type Static } from "@sinclair/typebox";
+import type { TruncationResult } from "./truncate.js";
+declare const testRunSchema: import("@sinclair/typebox").TObject<{
+    runner: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"auto">, import("@sinclair/typebox").TLiteral<"npm">, import("@sinclair/typebox").TLiteral<"pnpm">, import("@sinclair/typebox").TLiteral<"yarn">, import("@sinclair/typebox").TLiteral<"bun">, import("@sinclair/typebox").TLiteral<"vitest">, import("@sinclair/typebox").TLiteral<"jest">, import("@sinclair/typebox").TLiteral<"pytest">]>>;
+    script: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    args: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export type TestRunToolInput = Static<typeof testRunSchema>;
+export type TestRunRunner = "auto" | "npm" | "pnpm" | "yarn" | "bun" | "vitest" | "jest" | "pytest";
+export type TestRunStatus = "passed" | "failed" | "no_tests" | "error";
+type ResolvedTestRunner = Exclude<TestRunRunner, "auto">;
+export interface TestRunToolDetails {
+    resolvedRunner: ResolvedTestRunner;
+    resolvedCommand: string;
+    resolvedArgs: string[];
+    cwd: string;
+    exitCode: number;
+    status: TestRunStatus;
+    durationMs: number;
+    captureTruncated?: boolean;
+    truncation?: TruncationResult;
+}
+export declare const DEFAULT_TEST_RUN_TIMEOUT_SECONDS = 900;
+export declare function createTestRunTool(cwd: string): AgentTool<typeof testRunSchema>;
+export declare const testRunTool: AgentTool<import("@sinclair/typebox").TObject<{
+    runner: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"auto">, import("@sinclair/typebox").TLiteral<"npm">, import("@sinclair/typebox").TLiteral<"pnpm">, import("@sinclair/typebox").TLiteral<"yarn">, import("@sinclair/typebox").TLiteral<"bun">, import("@sinclair/typebox").TLiteral<"vitest">, import("@sinclair/typebox").TLiteral<"jest">, import("@sinclair/typebox").TLiteral<"pytest">]>>;
+    script: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    args: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>, any>;
+export {};
+//# sourceMappingURL=test-run.d.ts.map

package/dist/core/tools/test-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-run.d.ts","sourceRoot":"","sources":["../../../src/core/tools/test-run.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAatD,QAAA,MAAM,aAAa;;;;;;EA8BjB,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AACpG,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAEvE,KAAK,kBAAkB,GAAG,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;AAQzD,MAAM,WAAW,kBAAkB;IAClC,cAAc,EAAE,kBAAkB,CAAC;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,eAAO,MAAM,gCAAgC,MAAM,CAAC;AAiMpD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,aAAa,CAAC,CA6E9E;AAED,eAAO,MAAM,WAAW;;;;;;QAAmC,CAAC"}

package/dist/core/tools/test-run.js

@@ -0,0 +1,255 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { Type } from "@sinclair/typebox";
+import { resolveToCwd } from "./path-utils.js";
+import { commandExists, detectPackageManager, ensureCommandOrThrow, formatVerificationOutput, readPackageJson, resolvePackageManagerExecInvocation, resolvePackageManagerRunInvocation, runVerificationCommand, } from "./verification-runner.js";
+const testRunSchema = Type.Object({
+    runner: Type.Optional(Type.Union([
+        Type.Literal("auto"),
+        Type.Literal("npm"),
+        Type.Literal("pnpm"),
+        Type.Literal("yarn"),
+        Type.Literal("bun"),
+        Type.Literal("vitest"),
+        Type.Literal("jest"),
+        Type.Literal("pytest"),
+    ], {
+        description: "Test runner: auto | npm | pnpm | yarn | bun | vitest | jest | pytest",
+    })),
+    script: Type.Optional(Type.String({
+        description: "Package script for npm/pnpm/yarn/bun runners (default: test).",
+    })),
+    args: Type.Optional(Type.Array(Type.String(), {
+        description: "Additional arguments forwarded to the selected runner.",
+    })),
+    path: Type.Optional(Type.String({ description: "Working directory for running tests (default: current directory)." })),
+    timeout: Type.Optional(Type.Number({ description: "Timeout in seconds (default: 900)." })),
+});
+export const DEFAULT_TEST_RUN_TIMEOUT_SECONDS = 900;
+function normalizeTimeoutSeconds(raw) {
+    if (raw === undefined)
+        return DEFAULT_TEST_RUN_TIMEOUT_SECONDS;
+    const value = Math.floor(raw);
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error("timeout must be a positive number.");
+    }
+    return value;
+}
+function normalizeStringArray(raw) {
+    return (raw ?? []).map((item) => String(item));
+}
+function normalizeScriptName(raw, fallback) {
+    const script = (raw ?? fallback).trim();
+    if (script.length === 0) {
+        throw new Error("script must not be empty.");
+    }
+    return script;
+}
+function hasAnyFile(cwd, fileNames) {
+    return fileNames.some((name) => existsSync(join(cwd, name)));
+}
+function hasVitestConfig(cwd) {
+    return hasAnyFile(cwd, [
+        "vitest.config.ts",
+        "vitest.config.js",
+        "vitest.config.mjs",
+        "vitest.config.cjs",
+        "vitest.config.mts",
+        "vitest.config.cts",
+    ]);
+}
+function hasJestConfig(cwd, packageJsonJest) {
+    if (packageJsonJest && typeof packageJsonJest === "object") {
+        return true;
+    }
+    return hasAnyFile(cwd, [
+        "jest.config.ts",
+        "jest.config.js",
+        "jest.config.mjs",
+        "jest.config.cjs",
+        "jest.config.json",
+        "jest.config.mts",
+        "jest.config.cts",
+    ]);
+}
+function hasPythonMarkers(cwd) {
+    return hasAnyFile(cwd, [
+        "pyproject.toml",
+        "pytest.ini",
+        "tox.ini",
+        "setup.cfg",
+        "requirements.txt",
+        "requirements-dev.txt",
+    ]);
+}
+function assertPackageManagerAvailable(packageManager) {
+    if (packageManager === "bun") {
+        ensureCommandOrThrow("bun", 'Command "bun" is required for bun-based test execution.');
+        return;
+    }
+    ensureCommandOrThrow(packageManager, `Command "${packageManager}" is required for test execution.`);
+}
+function resolveScriptBasedCommand(packageManager, script, args) {
+    assertPackageManagerAvailable(packageManager);
+    const invocation = resolvePackageManagerRunInvocation(packageManager, script, args);
+    return {
+        resolvedRunner: packageManager,
+        command: invocation.command,
+        args: invocation.args,
+    };
+}
+function resolveFrameworkCommand(packageManager, runner, args) {
+    assertPackageManagerAvailable(packageManager);
+    const invocation = resolvePackageManagerExecInvocation(packageManager, runner, args);
+    ensureCommandOrThrow(invocation.command, `Command "${invocation.command}" is required to run ${runner}. Install ${packageManager} tooling first.`);
+    return {
+        resolvedRunner: runner,
+        command: invocation.command,
+        args: invocation.args,
+    };
+}
+function resolvePytestCommand(args) {
+    if (commandExists("python3")) {
+        return {
+            resolvedRunner: "pytest",
+            command: "python3",
+            args: ["-m", "pytest", ...args],
+        };
+    }
+    if (commandExists("pytest")) {
+        return {
+            resolvedRunner: "pytest",
+            command: "pytest",
+            args,
+        };
+    }
+    throw new Error('No pytest runtime found. Install python3 + pytest or expose "pytest" in PATH.');
+}
+function resolveAutoRunner(cwd, script) {
+    const packageJson = readPackageJson(cwd);
+    if (packageJson?.scripts[script]) {
+        return detectPackageManager(cwd);
+    }
+    if (hasVitestConfig(cwd))
+        return "vitest";
+    if (hasJestConfig(cwd, packageJson?.raw?.jest))
+        return "jest";
+    if (hasPythonMarkers(cwd))
+        return "pytest";
+    throw new Error('Unable to auto-detect test runner. Expected package.json script, vitest/jest config, or python pytest markers.');
+}
+function resolveTestCommand(input) {
+    const packageJson = readPackageJson(input.cwd);
+    const detectedPackageManager = detectPackageManager(input.cwd);
+    let resolvedRunner;
+    if (input.runner === "auto") {
+        resolvedRunner = resolveAutoRunner(input.cwd, input.script);
+    }
+    else {
+        resolvedRunner = input.runner;
+    }
+    if (resolvedRunner === "npm" || resolvedRunner === "pnpm" || resolvedRunner === "yarn" || resolvedRunner === "bun") {
+        if (!packageJson) {
+            throw new Error(`package.json is required to run ${resolvedRunner} scripts.`);
+        }
+        if (!packageJson.scripts[input.script]) {
+            throw new Error(`Script "${input.script}" is not defined in package.json.`);
+        }
+        return resolveScriptBasedCommand(resolvedRunner, input.script, input.args);
+    }
+    if (resolvedRunner === "vitest" || resolvedRunner === "jest") {
+        return resolveFrameworkCommand(detectedPackageManager, resolvedRunner, input.args);
+    }
+    return resolvePytestCommand(input.args);
+}
+function mapTestStatus(resolvedRunner, exitCode) {
+    if (exitCode === 0)
+        return "passed";
+    if (resolvedRunner === "pytest" && exitCode === 5)
+        return "no_tests";
+    if (exitCode === 1)
+        return "failed";
+    return "error";
+}
+function indicatesPytestModuleMissing(output) {
+    return /No module named pytest|ModuleNotFoundError:\s*No module named ['"]pytest['"]/i.test(output);
+}
+function renderSummary(details, output) {
+    const argsText = details.resolvedArgs.length > 0 ? ` ${details.resolvedArgs.join(" ")}` : "";
+    return [
+        `test_run status: ${details.status}`,
+        `runner: ${details.resolvedRunner}`,
+        `command: ${details.resolvedCommand}${argsText}`,
+        `cwd: ${details.cwd}`,
+        `exit_code: ${details.exitCode}`,
+        `duration_ms: ${details.durationMs}`,
+        "",
+        output,
+    ].join("\n");
+}
+export function createTestRunTool(cwd) {
+    return {
+        name: "test_run",
+        label: "test_run",
+        description: "Structured test runner with auto detection across npm/pnpm/yarn/bun, vitest, jest, and pytest. Returns normalized status without throwing on ordinary test failures.",
+        parameters: testRunSchema,
+        execute: async (_toolCallId, input, signal) => {
+            const executionCwd = resolveToCwd(input.path || ".", cwd);
+            const timeoutSeconds = normalizeTimeoutSeconds(input.timeout);
+            const normalizedArgs = normalizeStringArray(input.args);
+            const script = normalizeScriptName(input.script, "test");
+            const runner = input.runner ?? "auto";
+            let command = resolveTestCommand({
+                cwd: executionCwd,
+                runner,
+                script,
+                args: normalizedArgs,
+            });
+            let result = await runVerificationCommand({
+                command: command.command,
+                args: command.args,
+                cwd: executionCwd,
+                timeoutMs: timeoutSeconds * 1000,
+                signal,
+            });
+            // python3 -m pytest fallback to bare pytest when pytest module is unavailable
+            if (command.resolvedRunner === "pytest" &&
+                command.command === "python3" &&
+                result.exitCode !== 0 &&
+                indicatesPytestModuleMissing(`${result.stdout}\n${result.stderr}`) &&
+                commandExists("pytest")) {
+                const fallback = await runVerificationCommand({
+                    command: "pytest",
+                    args: normalizedArgs,
+                    cwd: executionCwd,
+                    timeoutMs: timeoutSeconds * 1000,
+                    signal,
+                });
+                command = { resolvedRunner: "pytest", command: "pytest", args: normalizedArgs };
+                result = {
+                    ...fallback,
+                    durationMs: result.durationMs + fallback.durationMs,
+                };
+            }
+            const status = mapTestStatus(command.resolvedRunner, result.exitCode);
+            const formatted = formatVerificationOutput(result.stdout, result.stderr, result.captureTruncated, "No test output");
+            const details = {
+                resolvedRunner: command.resolvedRunner,
+                resolvedCommand: command.command,
+                resolvedArgs: command.args,
+                cwd: executionCwd,
+                exitCode: result.exitCode,
+                status,
+                durationMs: result.durationMs,
+                captureTruncated: result.captureTruncated || undefined,
+                truncation: formatted.truncation,
+            };
+            return {
+                content: [{ type: "text", text: renderSummary(details, formatted.text) }],
+                details,
+            };
+        },
+    };
+}
+export const testRunTool = createTestRunTool(process.cwd());
+//# sourceMappingURL=test-run.js.map