iosm-cli 0.2.6 → 0.2.8

package/dist/core/tools/git-read.js

@@ -0,0 +1,215 @@
+import { Type } from "@sinclair/typebox";
+import { resolveToCwd } from "./path-utils.js";
+import { DEFAULT_GIT_TIMEOUT_SECONDS, normalizePositiveInt, normalizeRefLike, requireRefLike, resolveGitCommandOptions, runGitAndFormatOutput, } from "./git-common.js";
+const gitReadSchema = Type.Object({
+    action: Type.Union([
+        Type.Literal("status"),
+        Type.Literal("diff"),
+        Type.Literal("log"),
+        Type.Literal("blame"),
+        Type.Literal("show"),
+        Type.Literal("branch_list"),
+        Type.Literal("remote_list"),
+        Type.Literal("rev_parse"),
+    ], { description: "Git action: status | diff | log | blame | show | branch_list | remote_list | rev_parse." }),
+    path: Type.Optional(Type.String({ description: "Repository working directory (default: current directory)." })),
+    file: Type.Optional(Type.String({ description: "Optional file path for diff/log/show, required for blame." })),
+    base: Type.Optional(Type.String({ description: "Optional base ref/commit for diff." })),
+    head: Type.Optional(Type.String({ description: "Optional head ref/commit for diff (requires base)." })),
+    staged: Type.Optional(Type.Boolean({ description: "For diff action: compare staged changes." })),
+    context: Type.Optional(Type.Number({ description: "For diff action: unified context lines (default: 3)." })),
+    porcelain: Type.Optional(Type.Boolean({
+        description: "For status action: use short porcelain format with branch (default: true).",
+    })),
+    untracked: Type.Optional(Type.Boolean({ description: "For status action: include untracked files (default: true)." })),
+    limit: Type.Optional(Type.Number({ description: "For log action: max entries (default: 20, max: 200)." })),
+    since: Type.Optional(Type.String({ description: "For log action: git --since value (e.g. '2 weeks ago')." })),
+    ref: Type.Optional(Type.String({ description: "For blame/show action: optional ref/commit (show defaults to HEAD)." })),
+    line_start: Type.Optional(Type.Number({ description: "For blame action: range start line (1-indexed)." })),
+    line_end: Type.Optional(Type.Number({ description: "For blame action: range end line (1-indexed)." })),
+    all: Type.Optional(Type.Boolean({ description: "For branch_list action: include remote branches (default: true)." })),
+    verbose: Type.Optional(Type.Boolean({
+        description: "For branch_list/remote_list action: include verbose output (branch_list default: false, remote_list default: true).",
+    })),
+    target: Type.Optional(Type.String({ description: "For rev_parse action: ref/commit to resolve (default: HEAD)." })),
+    short: Type.Optional(Type.Boolean({ description: "For rev_parse action: output short hash (default: false)." })),
+    timeout: Type.Optional(Type.Number({ description: "Timeout in seconds (default: 30)." })),
+});
+const DEFAULT_LOG_LIMIT = 20;
+const MAX_LOG_LIMIT = 200;
+function buildStatusArgs(input) {
+    const porcelain = input.porcelain ?? true;
+    const includeUntracked = input.untracked ?? true;
+    const args = ["status"];
+    if (porcelain) {
+        args.push("--short", "--branch");
+    }
+    if (!includeUntracked) {
+        args.push("--untracked-files=no");
+    }
+    return args;
+}
+function buildDiffArgs(input) {
+    if (input.head && !input.base) {
+        throw new Error("git_read diff requires base when head is provided.");
+    }
+    const context = normalizePositiveInt(input.context, 3, "context");
+    const base = normalizeRefLike(input.base, "base");
+    const head = normalizeRefLike(input.head, "head");
+    const args = ["diff", "--no-color", `--unified=${context}`];
+    if (input.staged) {
+        args.push("--staged");
+    }
+    if (base && head) {
+        args.push(`${base}..${head}`);
+    }
+    else if (base) {
+        args.push(base);
+    }
+    if (input.file) {
+        args.push("--", input.file);
+    }
+    return args;
+}
+function buildLogArgs(input) {
+    const limit = Math.min(MAX_LOG_LIMIT, normalizePositiveInt(input.limit, DEFAULT_LOG_LIMIT, "limit"));
+    const args = [
+        "log",
+        "--no-color",
+        `--max-count=${limit}`,
+        "--date=iso",
+        "--pretty=format:%H%x09%ad%x09%an%x09%s",
+    ];
+    if (input.since) {
+        args.push(`--since=${input.since}`);
+    }
+    if (input.file) {
+        args.push("--", input.file);
+    }
+    return args;
+}
+function buildBlameArgs(input) {
+    if (!input.file) {
+        throw new Error("git_read blame requires file.");
+    }
+    const hasLineStart = input.line_start !== undefined;
+    const hasLineEnd = input.line_end !== undefined;
+    if (hasLineStart !== hasLineEnd) {
+        throw new Error("git_read blame requires both line_start and line_end when specifying a range.");
+    }
+    const args = ["blame", "--line-porcelain"];
+    const ref = normalizeRefLike(input.ref, "ref");
+    if (ref) {
+        args.push(ref);
+    }
+    if (hasLineStart && hasLineEnd) {
+        const lineStart = normalizePositiveInt(input.line_start, 1, "line_start");
+        const lineEnd = normalizePositiveInt(input.line_end, 1, "line_end");
+        if (lineEnd < lineStart) {
+            throw new Error("line_end must be greater than or equal to line_start.");
+        }
+        args.push("-L", `${lineStart},${lineEnd}`);
+    }
+    args.push("--", input.file);
+    return args;
+}
+function buildShowArgs(input) {
+    const ref = requireRefLike(input.ref ?? "HEAD", "ref");
+    const args = ["show", "--no-color", ref];
+    if (input.file) {
+        args.push("--", input.file);
+    }
+    return args;
+}
+function buildBranchListArgs(input) {
+    const includeAll = input.all ?? true;
+    const verbose = input.verbose ?? false;
+    const args = ["branch", "--list"];
+    if (includeAll) {
+        args.push("--all");
+    }
+    if (verbose) {
+        args.push("--verbose");
+    }
+    return args;
+}
+function buildRemoteListArgs(input) {
+    const verbose = input.verbose ?? true;
+    const args = ["remote"];
+    if (verbose) {
+        args.push("-v");
+    }
+    return args;
+}
+function buildRevParseArgs(input) {
+    const target = requireRefLike(input.target ?? "HEAD", "target");
+    const args = ["rev-parse"];
+    if (input.short) {
+        args.push("--short");
+    }
+    args.push(target);
+    return args;
+}
+function buildGitReadArgs(input) {
+    switch (input.action) {
+        case "status":
+            return buildStatusArgs(input);
+        case "diff":
+            return buildDiffArgs(input);
+        case "log":
+            return buildLogArgs(input);
+        case "blame":
+            return buildBlameArgs(input);
+        case "show":
+            return buildShowArgs(input);
+        case "branch_list":
+            return buildBranchListArgs(input);
+        case "remote_list":
+            return buildRemoteListArgs(input);
+        case "rev_parse":
+            return buildRevParseArgs(input);
+        default:
+            throw new Error(`Unsupported git_read action: ${input.action}`);
+    }
+}
+export function createGitReadTool(cwd, options) {
+    const { hasCommand, runCommand } = resolveGitCommandOptions(options);
+    return {
+        name: "git_read",
+        label: "git_read",
+        description: "Structured read-only git introspection. Actions: status | diff | log | blame | show | branch_list | remote_list | rev_parse. Uses safe argv execution without shell interpolation.",
+        parameters: gitReadSchema,
+        execute: async (_toolCallId, input, signal) => {
+            if (!hasCommand("git")) {
+                throw new Error("git command is not available.");
+            }
+            const repoCwd = resolveToCwd(input.path || ".", cwd);
+            const args = buildGitReadArgs(input);
+            const timeoutSeconds = normalizePositiveInt(input.timeout, DEFAULT_GIT_TIMEOUT_SECONDS, "timeout");
+            const result = await runGitAndFormatOutput({
+                toolName: "git_read",
+                action: input.action,
+                args,
+                cwd: repoCwd,
+                timeoutSeconds,
+                runCommand,
+                signal,
+            });
+            const details = {
+                action: input.action,
+                command: "git",
+                args,
+                cwd: repoCwd,
+                exitCode: result.exitCode,
+                captureTruncated: result.captureTruncated || undefined,
+                truncation: result.truncation,
+            };
+            return {
+                content: [{ type: "text", text: result.output }],
+                details,
+            };
+        },
+    };
+}
+export const gitReadTool = createGitReadTool(process.cwd());
+//# sourceMappingURL=git-read.js.map

package/dist/core/tools/git-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-read.js","sourceRoot":"","sources":["../../../src/core/tools/git-read.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@mariozechner/pi-agent-core\";\nimport { type Static, Type } from \"@sinclair/typebox\";\nimport { resolveToCwd } from \"./path-utils.js\";\nimport {\n\tDEFAULT_GIT_TIMEOUT_SECONDS,\n\tnormalizePositiveInt,\n\tnormalizeRefLike,\n\trequireRefLike,\n\tresolveGitCommandOptions,\n\trunGitAndFormatOutput,\n\ttype GitCommandOptions,\n} from \"./git-common.js\";\nimport type { TruncationResult } from \"./truncate.js\";\n\nconst gitReadSchema = Type.Object({\n\taction: Type.Union(\n\t\t[\n\t\t\tType.Literal(\"status\"),\n\t\t\tType.Literal(\"diff\"),\n\t\t\tType.Literal(\"log\"),\n\t\t\tType.Literal(\"blame\"),\n\t\t\tType.Literal(\"show\"),\n\t\t\tType.Literal(\"branch_list\"),\n\t\t\tType.Literal(\"remote_list\"),\n\t\t\tType.Literal(\"rev_parse\"),\n\t\t],\n\t\t{ description: \"Git action: status | diff | log | blame | show | branch_list | remote_list | rev_parse.\" },\n\t),\n\tpath: Type.Optional(Type.String({ description: \"Repository working directory (default: current directory).\" })),\n\tfile: Type.Optional(Type.String({ description: \"Optional file path for diff/log/show, required for blame.\" })),\n\tbase: Type.Optional(Type.String({ description: \"Optional base ref/commit for diff.\" })),\n\thead: Type.Optional(Type.String({ description: \"Optional head ref/commit for diff (requires base).\" })),\n\tstaged: Type.Optional(Type.Boolean({ description: \"For diff action: compare staged changes.\" })),\n\tcontext: Type.Optional(Type.Number({ description: \"For diff action: unified context lines (default: 3).\" })),\n\tporcelain: Type.Optional(\n\t\tType.Boolean({\n\t\t\tdescription: \"For status action: use short porcelain format with branch (default: true).\",\n\t\t}),\n\t),\n\tuntracked: Type.Optional(Type.Boolean({ description: \"For status action: include untracked files (default: true).\" })),\n\tlimit: Type.Optional(Type.Number({ description: \"For log action: max entries (default: 20, max: 200).\" })),\n\tsince: Type.Optional(Type.String({ description: \"For log action: git --since value (e.g. '2 weeks ago').\" })),\n\tref: Type.Optional(Type.String({ description: \"For blame/show action: optional ref/commit (show defaults to HEAD).\" })),\n\tline_start: Type.Optional(Type.Number({ description: \"For blame action: range start line (1-indexed).\" })),\n\tline_end: Type.Optional(Type.Number({ description: \"For blame action: range end line (1-indexed).\" })),\n\tall: Type.Optional(Type.Boolean({ description: \"For branch_list action: include remote branches (default: true).\" })),\n\tverbose: Type.Optional(\n\t\tType.Boolean({\n\t\t\tdescription: \"For branch_list/remote_list action: include verbose output (branch_list default: false, remote_list default: true).\",\n\t\t}),\n\t),\n\ttarget: Type.Optional(Type.String({ description: \"For rev_parse action: ref/commit to resolve (default: HEAD).\" })),\n\tshort: Type.Optional(Type.Boolean({ description: \"For rev_parse action: output short hash (default: false).\" })),\n\ttimeout: Type.Optional(Type.Number({ description: \"Timeout in seconds (default: 30).\" })),\n});\n\nexport type GitReadToolInput = Static<typeof gitReadSchema>;\n\nconst DEFAULT_LOG_LIMIT = 20;\nconst MAX_LOG_LIMIT = 200;\n\ntype GitReadAction = GitReadToolInput[\"action\"];\n\nexport interface GitReadToolDetails {\n\taction: GitReadAction;\n\tcommand: string;\n\targs: string[];\n\tcwd: string;\n\texitCode: number;\n\tcaptureTruncated?: boolean;\n\ttruncation?: TruncationResult;\n}\n\nexport interface GitReadToolOptions extends GitCommandOptions {}\n\nfunction buildStatusArgs(input: GitReadToolInput): string[] {\n\tconst porcelain = input.porcelain ?? true;\n\tconst includeUntracked = input.untracked ?? true;\n\tconst args = [\"status\"];\n\tif (porcelain) {\n\t\targs.push(\"--short\", \"--branch\");\n\t}\n\tif (!includeUntracked) {\n\t\targs.push(\"--untracked-files=no\");\n\t}\n\treturn args;\n}\n\nfunction buildDiffArgs(input: GitReadToolInput): string[] {\n\tif (input.head && !input.base) {\n\t\tthrow new Error(\"git_read diff requires base when head is provided.\");\n\t}\n\tconst context = normalizePositiveInt(input.context, 3, \"context\");\n\tconst base = normalizeRefLike(input.base, \"base\");\n\tconst head = normalizeRefLike(input.head, \"head\");\n\tconst args = [\"diff\", \"--no-color\", `--unified=${context}`];\n\tif (input.staged) {\n\t\targs.push(\"--staged\");\n\t}\n\tif (base && head) {\n\t\targs.push(`${base}..${head}`);\n\t} else if (base) {\n\t\targs.push(base);\n\t}\n\tif (input.file) {\n\t\targs.push(\"--\", input.file);\n\t}\n\treturn args;\n}\n\nfunction buildLogArgs(input: GitReadToolInput): string[] {\n\tconst limit = Math.min(MAX_LOG_LIMIT, normalizePositiveInt(input.limit, DEFAULT_LOG_LIMIT, \"limit\"));\n\tconst args = [\n\t\t\"log\",\n\t\t\"--no-color\",\n\t\t`--max-count=${limit}`,\n\t\t\"--date=iso\",\n\t\t\"--pretty=format:%H%x09%ad%x09%an%x09%s\",\n\t];\n\tif (input.since) {\n\t\targs.push(`--since=${input.since}`);\n\t}\n\tif (input.file) {\n\t\targs.push(\"--\", input.file);\n\t}\n\treturn args;\n}\n\nfunction buildBlameArgs(input: GitReadToolInput): string[] {\n\tif (!input.file) {\n\t\tthrow new Error(\"git_read blame requires file.\");\n\t}\n\tconst hasLineStart = input.line_start !== undefined;\n\tconst hasLineEnd = input.line_end !== undefined;\n\tif (hasLineStart !== hasLineEnd) {\n\t\tthrow new Error(\"git_read blame requires both line_start and line_end when specifying a range.\");\n\t}\n\tconst args = [\"blame\", \"--line-porcelain\"];\n\tconst ref = normalizeRefLike(input.ref, \"ref\");\n\tif (ref) {\n\t\targs.push(ref);\n\t}\n\tif (hasLineStart && hasLineEnd) {\n\t\tconst lineStart = normalizePositiveInt(input.line_start, 1, \"line_start\");\n\t\tconst lineEnd = normalizePositiveInt(input.line_end, 1, \"line_end\");\n\t\tif (lineEnd < lineStart) {\n\t\t\tthrow new Error(\"line_end must be greater than or equal to line_start.\");\n\t\t}\n\t\targs.push(\"-L\", `${lineStart},${lineEnd}`);\n\t}\n\targs.push(\"--\", input.file);\n\treturn args;\n}\n\nfunction buildShowArgs(input: GitReadToolInput): string[] {\n\tconst ref = requireRefLike(input.ref ?? \"HEAD\", \"ref\");\n\tconst args = [\"show\", \"--no-color\", ref];\n\tif (input.file) {\n\t\targs.push(\"--\", input.file);\n\t}\n\treturn args;\n}\n\nfunction buildBranchListArgs(input: GitReadToolInput): string[] {\n\tconst includeAll = input.all ?? true;\n\tconst verbose = input.verbose ?? false;\n\tconst args = [\"branch\", \"--list\"];\n\tif (includeAll) {\n\t\targs.push(\"--all\");\n\t}\n\tif (verbose) {\n\t\targs.push(\"--verbose\");\n\t}\n\treturn args;\n}\n\nfunction buildRemoteListArgs(input: GitReadToolInput): string[] {\n\tconst verbose = input.verbose ?? true;\n\tconst args = [\"remote\"];\n\tif (verbose) {\n\t\targs.push(\"-v\");\n\t}\n\treturn args;\n}\n\nfunction buildRevParseArgs(input: GitReadToolInput): string[] {\n\tconst target = requireRefLike(input.target ?? \"HEAD\", \"target\");\n\tconst args = [\"rev-parse\"];\n\tif (input.short) {\n\t\targs.push(\"--short\");\n\t}\n\targs.push(target);\n\treturn args;\n}\n\nfunction buildGitReadArgs(input: GitReadToolInput): string[] {\n\tswitch (input.action) {\n\t\tcase \"status\":\n\t\t\treturn buildStatusArgs(input);\n\t\tcase \"diff\":\n\t\t\treturn buildDiffArgs(input);\n\t\tcase \"log\":\n\t\t\treturn buildLogArgs(input);\n\t\tcase \"blame\":\n\t\t\treturn buildBlameArgs(input);\n\t\tcase \"show\":\n\t\t\treturn buildShowArgs(input);\n\t\tcase \"branch_list\":\n\t\t\treturn buildBranchListArgs(input);\n\t\tcase \"remote_list\":\n\t\t\treturn buildRemoteListArgs(input);\n\t\tcase \"rev_parse\":\n\t\t\treturn buildRevParseArgs(input);\n\t\tdefault:\n\t\t\tthrow new Error(`Unsupported git_read action: ${(input as { action: string }).action}`);\n\t}\n}\n\nexport function createGitReadTool(cwd: string, options?: GitReadToolOptions): AgentTool<typeof gitReadSchema> {\n\tconst { hasCommand, runCommand } = resolveGitCommandOptions(options);\n\n\treturn {\n\t\tname: \"git_read\",\n\t\tlabel: \"git_read\",\n\t\tdescription:\n\t\t\t\"Structured read-only git introspection. Actions: status | diff | log | blame | show | branch_list | remote_list | rev_parse. Uses safe argv execution without shell interpolation.\",\n\t\tparameters: gitReadSchema,\n\t\texecute: async (_toolCallId: string, input: GitReadToolInput, signal?: AbortSignal) => {\n\t\t\tif (!hasCommand(\"git\")) {\n\t\t\t\tthrow new Error(\"git command is not available.\");\n\t\t\t}\n\n\t\t\tconst repoCwd = resolveToCwd(input.path || \".\", cwd);\n\t\t\tconst args = buildGitReadArgs(input);\n\t\t\tconst timeoutSeconds = normalizePositiveInt(input.timeout, DEFAULT_GIT_TIMEOUT_SECONDS, \"timeout\");\n\t\t\tconst result = await runGitAndFormatOutput({\n\t\t\t\ttoolName: \"git_read\",\n\t\t\t\taction: input.action,\n\t\t\t\targs,\n\t\t\t\tcwd: repoCwd,\n\t\t\t\ttimeoutSeconds,\n\t\t\t\trunCommand,\n\t\t\t\tsignal,\n\t\t\t});\n\n\t\t\tconst details: GitReadToolDetails = {\n\t\t\t\taction: input.action,\n\t\t\t\tcommand: \"git\",\n\t\t\t\targs,\n\t\t\t\tcwd: repoCwd,\n\t\t\t\texitCode: result.exitCode,\n\t\t\t\tcaptureTruncated: result.captureTruncated || undefined,\n\t\t\t\ttruncation: result.truncation,\n\t\t\t};\n\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: result.output }],\n\t\t\t\tdetails,\n\t\t\t};\n\t\t},\n\t};\n}\n\nexport const gitReadTool = createGitReadTool(process.cwd());\n"]}

package/dist/core/tools/git-write.d.ts

@@ -0,0 +1,75 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import { type Static } from "@sinclair/typebox";
+import { type GitCommandOptions } from "./git-common.js";
+import type { ToolPermissionGuard } from "./permissions.js";
+import type { TruncationResult } from "./truncate.js";
+declare const gitWriteSchema: import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"add">, import("@sinclair/typebox").TLiteral<"restore">, import("@sinclair/typebox").TLiteral<"reset_index">, import("@sinclair/typebox").TLiteral<"commit">, import("@sinclair/typebox").TLiteral<"switch">, import("@sinclair/typebox").TLiteral<"branch_create">, import("@sinclair/typebox").TLiteral<"fetch">, import("@sinclair/typebox").TLiteral<"pull">, import("@sinclair/typebox").TLiteral<"push">, import("@sinclair/typebox").TLiteral<"stash_push">, import("@sinclair/typebox").TLiteral<"stash_pop">, import("@sinclair/typebox").TLiteral<"stash_apply">, import("@sinclair/typebox").TLiteral<"stash_drop">, import("@sinclair/typebox").TLiteral<"stash_list">]>;
+    path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    all: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    update: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    files: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    staged: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    source: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    message: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    allow_empty: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    branch: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    start_point: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    remote: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    ff_only: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    prune: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    set_upstream: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    tags: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    include_untracked: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    keep_index: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    stash_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export type GitWriteToolInput = Static<typeof gitWriteSchema>;
+type GitWriteAction = GitWriteToolInput["action"];
+export interface GitWriteToolDetails {
+    action: GitWriteAction;
+    command: string;
+    args: string[];
+    cwd: string;
+    exitCode: number;
+    captureTruncated?: boolean;
+    truncation?: TruncationResult;
+}
+export interface GitWriteRuntimeConfig {
+    networkEnabled: boolean;
+}
+export interface GitWriteToolOptions extends GitCommandOptions {
+    permissionGuard?: ToolPermissionGuard;
+    resolveRuntimeConfig?: () => Partial<GitWriteRuntimeConfig> | GitWriteRuntimeConfig;
+    resolveGithubToken?: () => string | undefined;
+}
+export declare function createGitWriteTool(cwd: string, options?: GitWriteToolOptions): AgentTool<typeof gitWriteSchema>;
+export declare const gitWriteTool: AgentTool<import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"add">, import("@sinclair/typebox").TLiteral<"restore">, import("@sinclair/typebox").TLiteral<"reset_index">, import("@sinclair/typebox").TLiteral<"commit">, import("@sinclair/typebox").TLiteral<"switch">, import("@sinclair/typebox").TLiteral<"branch_create">, import("@sinclair/typebox").TLiteral<"fetch">, import("@sinclair/typebox").TLiteral<"pull">, import("@sinclair/typebox").TLiteral<"push">, import("@sinclair/typebox").TLiteral<"stash_push">, import("@sinclair/typebox").TLiteral<"stash_pop">, import("@sinclair/typebox").TLiteral<"stash_apply">, import("@sinclair/typebox").TLiteral<"stash_drop">, import("@sinclair/typebox").TLiteral<"stash_list">]>;
+    path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    all: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    update: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    files: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    staged: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    source: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    message: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    allow_empty: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    branch: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    start_point: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    remote: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    ff_only: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    prune: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    set_upstream: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    tags: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    include_untracked: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    keep_index: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    stash_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>, any>;
+export {};
+//# sourceMappingURL=git-write.d.ts.map

package/dist/core/tools/git-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-write.d.ts","sourceRoot":"","sources":["../../../src/core/tools/git-write.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EASN,KAAK,iBAAiB,EACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;EAgDlB,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;AAO9D,KAAK,cAAc,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AAElD,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACrC,cAAc,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC7D,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,CAAC;IACpF,kBAAkB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAC9C;AA6MD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC,OAAO,cAAc,CAAC,CA0E/G;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;QAAoC,CAAC"}

package/dist/core/tools/git-write.js

@@ -0,0 +1,298 @@
+import { Type } from "@sinclair/typebox";
+import { resolveToCwd } from "./path-utils.js";
+import { DEFAULT_GIT_TIMEOUT_SECONDS, normalizeFiles, normalizePositiveInt, normalizeRefLike, normalizeRequiredString, requireRefLike, resolveGitCommandOptions, runGitAndFormatOutput, } from "./git-common.js";
+const gitWriteSchema = Type.Object({
+    action: Type.Union([
+        Type.Literal("add"),
+        Type.Literal("restore"),
+        Type.Literal("reset_index"),
+        Type.Literal("commit"),
+        Type.Literal("switch"),
+        Type.Literal("branch_create"),
+        Type.Literal("fetch"),
+        Type.Literal("pull"),
+        Type.Literal("push"),
+        Type.Literal("stash_push"),
+        Type.Literal("stash_pop"),
+        Type.Literal("stash_apply"),
+        Type.Literal("stash_drop"),
+        Type.Literal("stash_list"),
+    ], {
+        description: "Git write action: add | restore | reset_index | commit | switch | branch_create | fetch | pull | push | stash_push | stash_pop | stash_apply | stash_drop | stash_list.",
+    }),
+    path: Type.Optional(Type.String({ description: "Repository working directory (default: current directory)." })),
+    all: Type.Optional(Type.Boolean({ description: "For add action: stage all tracked and untracked changes." })),
+    update: Type.Optional(Type.Boolean({ description: "For add action: stage modified/deleted tracked files." })),
+    files: Type.Optional(Type.Array(Type.String(), { description: "For add/restore/reset_index action: file paths." })),
+    staged: Type.Optional(Type.Boolean({ description: "For restore action: restore index instead of working tree." })),
+    source: Type.Optional(Type.String({ description: "For restore action: source ref (e.g., HEAD)." })),
+    ref: Type.Optional(Type.String({ description: "For reset_index action: reference commit (default: HEAD)." })),
+    message: Type.Optional(Type.String({ description: "For commit/stash_push action: message." })),
+    allow_empty: Type.Optional(Type.Boolean({ description: "For commit action: allow empty commit." })),
+    branch: Type.Optional(Type.String({ description: "For switch/branch_create action: branch name." })),
+    start_point: Type.Optional(Type.String({ description: "For branch_create action: start point (default: HEAD)." })),
+    remote: Type.Optional(Type.String({ description: "For fetch/pull/push action: remote name (default: origin)." })),
+    ff_only: Type.Optional(Type.Boolean({ description: "For pull action: require fast-forward merge (default: true)." })),
+    prune: Type.Optional(Type.Boolean({ description: "For fetch action: prune deleted remote refs." })),
+    set_upstream: Type.Optional(Type.Boolean({ description: "For push action: set upstream for branch." })),
+    tags: Type.Optional(Type.Boolean({ description: "For fetch/push action: include tags." })),
+    include_untracked: Type.Optional(Type.Boolean({ description: "For stash_push action: include untracked files." })),
+    keep_index: Type.Optional(Type.Boolean({ description: "For stash_push action: keep index unchanged." })),
+    stash_ref: Type.Optional(Type.String({ description: "For stash_pop/stash_apply/stash_drop action: stash ref (default: stash@{0})." })),
+    limit: Type.Optional(Type.Number({ description: "For stash_list action: max entries (default: 20, max: 200)." })),
+    timeout: Type.Optional(Type.Number({ description: "Timeout in seconds (default: 30)." })),
+});
+const DEFAULT_STASH_LIST_LIMIT = 20;
+const MAX_STASH_LIST_LIMIT = 200;
+const DEFAULT_REMOTE = "origin";
+const DEFAULT_GIT_WRITE_NETWORK_ENABLED = false;
+function normalizeGitWriteRuntimeConfig(config) {
+    return {
+        networkEnabled: typeof config?.networkEnabled === "boolean"
+            ? config.networkEnabled
+            : DEFAULT_GIT_WRITE_NETWORK_ENABLED,
+    };
+}
+function buildAddArgs(input) {
+    const useAll = input.all === true;
+    const useUpdate = input.update === true;
+    const hasFiles = (input.files?.length ?? 0) > 0;
+    const modeCount = (useAll ? 1 : 0) + (useUpdate ? 1 : 0) + (hasFiles ? 1 : 0);
+    if (modeCount !== 1) {
+        throw new Error("git_write add requires exactly one mode: all=true, update=true, or files[].");
+    }
+    const args = ["add"];
+    if (useAll) {
+        args.push("--all");
+        return args;
+    }
+    if (useUpdate) {
+        args.push("--update");
+        return args;
+    }
+    const files = normalizeFiles(input.files, "files");
+    args.push("--", ...files);
+    return args;
+}
+function buildRestoreArgs(input) {
+    const files = normalizeFiles(input.files, "files");
+    const args = ["restore"];
+    if (input.staged) {
+        args.push("--staged");
+    }
+    const source = normalizeRefLike(input.source, "source");
+    if (source) {
+        args.push(`--source=${source}`);
+    }
+    args.push("--", ...files);
+    return args;
+}
+function buildResetIndexArgs(input) {
+    const files = normalizeFiles(input.files, "files");
+    const ref = requireRefLike(input.ref ?? "HEAD", "ref");
+    return ["reset", ref, "--", ...files];
+}
+function buildCommitArgs(input) {
+    const message = normalizeRequiredString(input.message, "message");
+    const args = ["commit", "-m", message];
+    if (input.allow_empty) {
+        args.push("--allow-empty");
+    }
+    return args;
+}
+function buildSwitchArgs(input) {
+    const branch = requireRefLike(input.branch, "branch");
+    return ["switch", branch];
+}
+function buildBranchCreateArgs(input) {
+    const branch = requireRefLike(input.branch, "branch");
+    const startPoint = requireRefLike(input.start_point ?? "HEAD", "start_point");
+    return ["branch", branch, startPoint];
+}
+function buildFetchArgs(input) {
+    const remote = requireRefLike(input.remote ?? DEFAULT_REMOTE, "remote");
+    const args = ["fetch"];
+    if (input.prune) {
+        args.push("--prune");
+    }
+    if (input.tags) {
+        args.push("--tags");
+    }
+    args.push(remote);
+    return args;
+}
+function buildPullArgs(input) {
+    const remote = requireRefLike(input.remote ?? DEFAULT_REMOTE, "remote");
+    const args = ["pull"];
+    if (input.ff_only ?? true) {
+        args.push("--ff-only");
+    }
+    args.push(remote);
+    const branch = normalizeRefLike(input.branch, "branch");
+    if (branch) {
+        args.push(branch);
+    }
+    return args;
+}
+function buildPushArgs(input) {
+    const remote = requireRefLike(input.remote ?? DEFAULT_REMOTE, "remote");
+    const args = ["push"];
+    if (input.set_upstream) {
+        args.push("--set-upstream");
+    }
+    if (input.tags) {
+        args.push("--tags");
+    }
+    args.push(remote);
+    const branch = normalizeRefLike(input.branch, "branch");
+    if (branch) {
+        args.push(branch);
+    }
+    return args;
+}
+function buildStashPushArgs(input) {
+    const args = ["stash", "push"];
+    if (input.include_untracked) {
+        args.push("--include-untracked");
+    }
+    if (input.keep_index) {
+        args.push("--keep-index");
+    }
+    if (input.message !== undefined) {
+        const message = normalizeRequiredString(input.message, "message");
+        args.push("-m", message);
+    }
+    return args;
+}
+function buildStashEntryActionArgs(input, action) {
+    const stashRef = requireRefLike(input.stash_ref ?? "stash@{0}", "stash_ref");
+    return ["stash", action, stashRef];
+}
+function buildStashListArgs(input) {
+    const limit = Math.min(MAX_STASH_LIST_LIMIT, normalizePositiveInt(input.limit, DEFAULT_STASH_LIST_LIMIT, "limit"));
+    return ["stash", "list", `--max-count=${limit}`, "--date=iso", "--pretty=format:%gd%x09%H%x09%ad%x09%s"];
+}
+function buildGitWriteArgs(input) {
+    switch (input.action) {
+        case "add":
+            return buildAddArgs(input);
+        case "restore":
+            return buildRestoreArgs(input);
+        case "reset_index":
+            return buildResetIndexArgs(input);
+        case "commit":
+            return buildCommitArgs(input);
+        case "switch":
+            return buildSwitchArgs(input);
+        case "branch_create":
+            return buildBranchCreateArgs(input);
+        case "fetch":
+            return buildFetchArgs(input);
+        case "pull":
+            return buildPullArgs(input);
+        case "push":
+            return buildPushArgs(input);
+        case "stash_push":
+            return buildStashPushArgs(input);
+        case "stash_pop":
+            return buildStashEntryActionArgs(input, "pop");
+        case "stash_apply":
+            return buildStashEntryActionArgs(input, "apply");
+        case "stash_drop":
+            return buildStashEntryActionArgs(input, "drop");
+        case "stash_list":
+            return buildStashListArgs(input);
+        default:
+            throw new Error(`Unsupported git_write action: ${input.action}`);
+    }
+}
+function isNetworkAction(action) {
+    return action === "fetch" || action === "pull" || action === "push";
+}
+function buildGitNetworkEnv(githubToken) {
+    const env = {
+        GIT_TERMINAL_PROMPT: "0",
+    };
+    const token = githubToken?.trim();
+    if (!token) {
+        return env;
+    }
+    const basic = Buffer.from(`x-access-token:${token}`, "utf-8").toString("base64");
+    const existingCountRaw = process.env.GIT_CONFIG_COUNT;
+    const existingCountParsed = existingCountRaw ? Number.parseInt(existingCountRaw, 10) : Number.NaN;
+    const existingCount = Number.isFinite(existingCountParsed) && existingCountParsed >= 0 ? existingCountParsed : 0;
+    const keyIndex = existingCount;
+    env.GIT_CONFIG_COUNT = String(existingCount + 1);
+    env[`GIT_CONFIG_KEY_${keyIndex}`] = "http.https://github.com/.extraheader";
+    env[`GIT_CONFIG_VALUE_${keyIndex}`] = `AUTHORIZATION: basic ${basic}`;
+    return env;
+}
+export function createGitWriteTool(cwd, options) {
+    const { hasCommand, runCommand } = resolveGitCommandOptions(options);
+    const permissionGuard = options?.permissionGuard;
+    const resolveRuntimeConfig = options?.resolveRuntimeConfig;
+    const resolveGithubToken = options?.resolveGithubToken;
+    return {
+        name: "git_write",
+        label: "git_write",
+        description: "Structured git mutation tool. Actions: add, restore, reset_index, commit, switch, branch_create, fetch, pull, push, stash_push, stash_pop, stash_apply, stash_drop, stash_list. Network actions are disabled by default and require explicit runtime enablement.",
+        parameters: gitWriteSchema,
+        execute: async (_toolCallId, input, signal) => {
+            if (!hasCommand("git")) {
+                throw new Error("git command is not available.");
+            }
+            const runtimeConfig = normalizeGitWriteRuntimeConfig(resolveRuntimeConfig?.());
+            const networkAction = isNetworkAction(input.action);
+            if (networkAction && !runtimeConfig.networkEnabled) {
+                throw new Error("git_write network actions are disabled. Enable Github tools network access in settings.");
+            }
+            const repoCwd = resolveToCwd(input.path || ".", cwd);
+            const args = buildGitWriteArgs(input);
+            const timeoutSeconds = normalizePositiveInt(input.timeout, DEFAULT_GIT_TIMEOUT_SECONDS, "timeout");
+            const env = networkAction ? buildGitNetworkEnv(resolveGithubToken?.()) : undefined;
+            if (permissionGuard) {
+                const allowed = await permissionGuard({
+                    toolName: "git_write",
+                    cwd,
+                    input: {
+                        action: input.action,
+                        path: input.path,
+                        repoCwd,
+                        args,
+                        timeoutSeconds,
+                        networkAction,
+                    },
+                    summary: `git ${args.join(" ")}`,
+                });
+                if (!allowed) {
+                    throw new Error("Permission denied for git_write operation.");
+                }
+            }
+            const result = await runGitAndFormatOutput({
+                toolName: "git_write",
+                action: input.action,
+                args,
+                cwd: repoCwd,
+                timeoutSeconds,
+                runCommand,
+                signal,
+                env,
+            });
+            const details = {
+                action: input.action,
+                command: "git",
+                args,
+                cwd: repoCwd,
+                exitCode: result.exitCode,
+                captureTruncated: result.captureTruncated || undefined,
+                truncation: result.truncation,
+            };
+            return {
+                content: [{ type: "text", text: result.output }],
+                details,
+            };
+        },
+    };
+}
+export const gitWriteTool = createGitWriteTool(process.cwd());
+//# sourceMappingURL=git-write.js.map