iosm-cli 0.2.6 → 0.2.8

package/dist/core/tools/fs-ops.js

@@ -0,0 +1,206 @@
+import { cp as fsCopy, mkdir as fsMkdir, rename as fsRename, rm as fsRm, stat as fsStat } from "node:fs/promises";
+import { Type } from "@sinclair/typebox";
+import { resolveToCwd } from "./path-utils.js";
+const fsOpsSchema = Type.Object({
+    action: Type.Union([Type.Literal("mkdir"), Type.Literal("move"), Type.Literal("copy"), Type.Literal("delete")], {
+        description: "Filesystem operation: mkdir | move | copy | delete.",
+    }),
+    path: Type.Optional(Type.String({ description: "Target path for mkdir/delete actions." })),
+    from: Type.Optional(Type.String({ description: "Source path for move/copy actions." })),
+    to: Type.Optional(Type.String({ description: "Destination path for move/copy actions." })),
+    recursive: Type.Optional(Type.Boolean({
+        description: "Enable recursive behavior (required for deleting/copying directories). mkdir defaults to recursive=true.",
+    })),
+    force: Type.Optional(Type.Boolean({
+        description: "Allow replacement/no-op safety escapes. Required to overwrite destinations or ignore missing delete target.",
+    })),
+});
+const defaultOps = {
+    mkdir: (path, options) => fsMkdir(path, options).then(() => { }),
+    rename: (from, to) => fsRename(from, to),
+    copy: (from, to, options) => fsCopy(from, to, options).then(() => { }),
+    remove: (path, options) => fsRm(path, options).then(() => { }),
+    stat: (path) => fsStat(path),
+};
+function ensureNotAborted(signal) {
+    if (signal?.aborted) {
+        throw new Error("Operation aborted");
+    }
+}
+async function pathExists(ops, path) {
+    try {
+        await ops.stat(path);
+        return true;
+    }
+    catch (error) {
+        if (error?.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+export function createFsOpsTool(cwd, options) {
+    const ops = options?.operations ?? defaultOps;
+    const permissionGuard = options?.permissionGuard;
+    return {
+        name: "fs_ops",
+        label: "fs_ops",
+        description: "Structured filesystem mutations: mkdir, move, copy, delete. Uses explicit recursive/force safety flags for destructive operations.",
+        parameters: fsOpsSchema,
+        execute: async (_toolCallId, input, signal) => {
+            ensureNotAborted(signal);
+            const action = input.action;
+            const recursive = input.recursive ?? (action === "mkdir");
+            const force = input.force ?? false;
+            const summary = action === "move" || action === "copy"
+                ? `${action} ${input.from ?? "(missing from)"} -> ${input.to ?? "(missing to)"}`
+                : `${action} ${input.path ?? "(missing path)"}`;
+            if (permissionGuard) {
+                const allowed = await permissionGuard({
+                    toolName: "fs_ops",
+                    cwd,
+                    input: {
+                        action,
+                        path: input.path,
+                        from: input.from,
+                        to: input.to,
+                        recursive,
+                        force,
+                    },
+                    summary,
+                });
+                if (!allowed) {
+                    throw new Error("Permission denied for fs_ops operation.");
+                }
+            }
+            if (action === "mkdir") {
+                if (!input.path) {
+                    throw new Error("fs_ops mkdir requires path.");
+                }
+                const resolvedPath = resolveToCwd(input.path, cwd);
+                await ops.mkdir(resolvedPath, { recursive });
+                return {
+                    content: [{ type: "text", text: `Created directory: ${input.path}` }],
+                    details: {
+                        action,
+                        resolvedPath,
+                        recursive,
+                        force,
+                    },
+                };
+            }
+            if (action === "delete") {
+                if (!input.path) {
+                    throw new Error("fs_ops delete requires path.");
+                }
+                const resolvedPath = resolveToCwd(input.path, cwd);
+                const exists = await pathExists(ops, resolvedPath);
+                if (!exists) {
+                    if (!force) {
+                        throw new Error(`Path not found: ${input.path}`);
+                    }
+                    return {
+                        content: [{ type: "text", text: `Skipped delete (path missing): ${input.path}` }],
+                        details: {
+                            action,
+                            resolvedPath,
+                            recursive,
+                            force,
+                            noop: true,
+                        },
+                    };
+                }
+                const sourceStat = await ops.stat(resolvedPath);
+                if (sourceStat.isDirectory() && !recursive) {
+                    throw new Error("Deleting a directory requires recursive=true.");
+                }
+                ensureNotAborted(signal);
+                await ops.remove(resolvedPath, {
+                    recursive: sourceStat.isDirectory(),
+                    force: false,
+                });
+                return {
+                    content: [{ type: "text", text: `Deleted: ${input.path}` }],
+                    details: {
+                        action,
+                        resolvedPath,
+                        recursive,
+                        force,
+                    },
+                };
+            }
+            if (!input.from || !input.to) {
+                throw new Error(`fs_ops ${action} requires both from and to.`);
+            }
+            const resolvedFrom = resolveToCwd(input.from, cwd);
+            const resolvedTo = resolveToCwd(input.to, cwd);
+            const sourceExists = await pathExists(ops, resolvedFrom);
+            if (!sourceExists) {
+                throw new Error(`Source path not found: ${input.from}`);
+            }
+            const destinationExists = await pathExists(ops, resolvedTo);
+            if (destinationExists && !force) {
+                throw new Error(`Destination already exists: ${input.to}. Pass force=true to replace.`);
+            }
+            if (destinationExists && force) {
+                ensureNotAborted(signal);
+                await ops.remove(resolvedTo, { recursive: true, force: true });
+            }
+            const sourceStat = await ops.stat(resolvedFrom);
+            const sourceIsDirectory = sourceStat.isDirectory();
+            if (action === "copy" && sourceIsDirectory && !recursive) {
+                throw new Error("Copying a directory requires recursive=true.");
+            }
+            if (action === "copy") {
+                ensureNotAborted(signal);
+                await ops.copy(resolvedFrom, resolvedTo, {
+                    recursive: sourceIsDirectory,
+                    force,
+                });
+                return {
+                    content: [{ type: "text", text: `Copied: ${input.from} -> ${input.to}` }],
+                    details: {
+                        action,
+                        resolvedFrom,
+                        resolvedTo,
+                        recursive,
+                        force,
+                    },
+                };
+            }
+            let exdevFallback = false;
+            try {
+                ensureNotAborted(signal);
+                await ops.rename(resolvedFrom, resolvedTo);
+            }
+            catch (error) {
+                if (error?.code !== "EXDEV") {
+                    throw error;
+                }
+                exdevFallback = true;
+                ensureNotAborted(signal);
+                await ops.copy(resolvedFrom, resolvedTo, {
+                    recursive: sourceIsDirectory,
+                    force: true,
+                });
+                await ops.remove(resolvedFrom, {
+                    recursive: sourceIsDirectory,
+                    force: false,
+                });
+            }
+            return {
+                content: [{ type: "text", text: `Moved: ${input.from} -> ${input.to}` }],
+                details: {
+                    action,
+                    resolvedFrom,
+                    resolvedTo,
+                    recursive,
+                    force,
+                    exdevFallback: exdevFallback || undefined,
+                },
+            };
+        },
+    };
+}
+export const fsOpsTool = createFsOpsTool(process.cwd());
+//# sourceMappingURL=fs-ops.js.map

package/dist/core/tools/fs-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-ops.js","sourceRoot":"","sources":["../../../src/core/tools/fs-ops.ts"],"names":[],"mappings":"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","sourcesContent":["import { cp as fsCopy, mkdir as fsMkdir, rename as fsRename, rm as fsRm, stat as fsStat } from \"node:fs/promises\";\nimport type { AgentTool } from \"@mariozechner/pi-agent-core\";\nimport { type Static, Type } from \"@sinclair/typebox\";\nimport { resolveToCwd } from \"./path-utils.js\";\nimport type { ToolPermissionGuard } from \"./permissions.js\";\n\nconst fsOpsSchema = Type.Object({\n\taction: Type.Union([Type.Literal(\"mkdir\"), Type.Literal(\"move\"), Type.Literal(\"copy\"), Type.Literal(\"delete\")], {\n\t\tdescription: \"Filesystem operation: mkdir | move | copy | delete.\",\n\t}),\n\tpath: Type.Optional(Type.String({ description: \"Target path for mkdir/delete actions.\" })),\n\tfrom: Type.Optional(Type.String({ description: \"Source path for move/copy actions.\" })),\n\tto: Type.Optional(Type.String({ description: \"Destination path for move/copy actions.\" })),\n\trecursive: Type.Optional(\n\t\tType.Boolean({\n\t\t\tdescription:\n\t\t\t\t\"Enable recursive behavior (required for deleting/copying directories). mkdir defaults to recursive=true.\",\n\t\t}),\n\t),\n\tforce: Type.Optional(\n\t\tType.Boolean({\n\t\t\tdescription:\n\t\t\t\t\"Allow replacement/no-op safety escapes. Required to overwrite destinations or ignore missing delete target.\",\n\t\t}),\n\t),\n});\n\nexport type FsOpsToolInput = Static<typeof fsOpsSchema>;\n\nexport interface FsOpsToolDetails {\n\taction: \"mkdir\" | \"move\" | \"copy\" | \"delete\";\n\tresolvedPath?: string;\n\tresolvedFrom?: string;\n\tresolvedTo?: string;\n\trecursive?: boolean;\n\tforce?: boolean;\n\texdevFallback?: boolean;\n\tnoop?: boolean;\n}\n\ninterface FsOpsOperations {\n\tmkdir(path: string, options: { recursive: boolean }): Promise<void>;\n\trename(from: string, to: string): Promise<void>;\n\tcopy(from: string, to: string, options: { recursive: boolean; force: boolean }): Promise<void>;\n\tremove(path: string, options: { recursive: boolean; force: boolean }): Promise<void>;\n\tstat(path: string): Promise<{ isDirectory: () => boolean }>;\n}\n\nconst defaultOps: FsOpsOperations = {\n\tmkdir: (path, options) => fsMkdir(path, options).then(() => {}),\n\trename: (from, to) => fsRename(from, to),\n\tcopy: (from, to, options) => fsCopy(from, to, options).then(() => {}),\n\tremove: (path, options) => fsRm(path, options).then(() => {}),\n\tstat: (path) => fsStat(path),\n};\n\nexport interface FsOpsToolOptions {\n\toperations?: FsOpsOperations;\n\tpermissionGuard?: ToolPermissionGuard;\n}\n\nfunction ensureNotAborted(signal?: AbortSignal): void {\n\tif (signal?.aborted) {\n\t\tthrow new Error(\"Operation aborted\");\n\t}\n}\n\nasync function pathExists(ops: FsOpsOperations, path: string): Promise<boolean> {\n\ttry {\n\t\tawait ops.stat(path);\n\t\treturn true;\n\t} catch (error: any) {\n\t\tif (error?.code === \"ENOENT\") {\n\t\t\treturn false;\n\t\t}\n\t\tthrow error;\n\t}\n}\n\nexport function createFsOpsTool(cwd: string, options?: FsOpsToolOptions): AgentTool<typeof fsOpsSchema> {\n\tconst ops = options?.operations ?? defaultOps;\n\tconst permissionGuard = options?.permissionGuard;\n\n\treturn {\n\t\tname: \"fs_ops\",\n\t\tlabel: \"fs_ops\",\n\t\tdescription:\n\t\t\t\"Structured filesystem mutations: mkdir, move, copy, delete. Uses explicit recursive/force safety flags for destructive operations.\",\n\t\tparameters: fsOpsSchema,\n\t\texecute: async (_toolCallId: string, input: FsOpsToolInput, signal?: AbortSignal) => {\n\t\t\tensureNotAborted(signal);\n\t\t\tconst action = input.action;\n\t\t\tconst recursive = input.recursive ?? (action === \"mkdir\");\n\t\t\tconst force = input.force ?? false;\n\n\t\t\tconst summary =\n\t\t\t\taction === \"move\" || action === \"copy\"\n\t\t\t\t\t? `${action} ${input.from ?? \"(missing from)\"} -> ${input.to ?? \"(missing to)\"}`\n\t\t\t\t\t: `${action} ${input.path ?? \"(missing path)\"}`;\n\n\t\t\tif (permissionGuard) {\n\t\t\t\tconst allowed = await permissionGuard({\n\t\t\t\t\ttoolName: \"fs_ops\",\n\t\t\t\t\tcwd,\n\t\t\t\t\tinput: {\n\t\t\t\t\t\taction,\n\t\t\t\t\t\tpath: input.path,\n\t\t\t\t\t\tfrom: input.from,\n\t\t\t\t\t\tto: input.to,\n\t\t\t\t\t\trecursive,\n\t\t\t\t\t\tforce,\n\t\t\t\t\t},\n\t\t\t\t\tsummary,\n\t\t\t\t});\n\t\t\t\tif (!allowed) {\n\t\t\t\t\tthrow new Error(\"Permission denied for fs_ops operation.\");\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (action === \"mkdir\") {\n\t\t\t\tif (!input.path) {\n\t\t\t\t\tthrow new Error(\"fs_ops mkdir requires path.\");\n\t\t\t\t}\n\t\t\t\tconst resolvedPath = resolveToCwd(input.path, cwd);\n\t\t\t\tawait ops.mkdir(resolvedPath, { recursive });\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: `Created directory: ${input.path}` }],\n\t\t\t\t\tdetails: {\n\t\t\t\t\t\taction,\n\t\t\t\t\t\tresolvedPath,\n\t\t\t\t\t\trecursive,\n\t\t\t\t\t\tforce,\n\t\t\t\t\t} as FsOpsToolDetails,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tif (action === \"delete\") {\n\t\t\t\tif (!input.path) {\n\t\t\t\t\tthrow new Error(\"fs_ops delete requires path.\");\n\t\t\t\t}\n\t\t\t\tconst resolvedPath = resolveToCwd(input.path, cwd);\n\t\t\t\tconst exists = await pathExists(ops, resolvedPath);\n\t\t\t\tif (!exists) {\n\t\t\t\t\tif (!force) {\n\t\t\t\t\t\tthrow new Error(`Path not found: ${input.path}`);\n\t\t\t\t\t}\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: `Skipped delete (path missing): ${input.path}` }],\n\t\t\t\t\t\tdetails: {\n\t\t\t\t\t\t\taction,\n\t\t\t\t\t\t\tresolvedPath,\n\t\t\t\t\t\t\trecursive,\n\t\t\t\t\t\t\tforce,\n\t\t\t\t\t\t\tnoop: true,\n\t\t\t\t\t\t} as FsOpsToolDetails,\n\t\t\t\t\t};\n\t\t\t\t}\n\n\t\t\t\tconst sourceStat = await ops.stat(resolvedPath);\n\t\t\t\tif (sourceStat.isDirectory() && !recursive) {\n\t\t\t\t\tthrow new Error(\"Deleting a directory requires recursive=true.\");\n\t\t\t\t}\n\n\t\t\t\tensureNotAborted(signal);\n\t\t\t\tawait ops.remove(resolvedPath, {\n\t\t\t\t\trecursive: sourceStat.isDirectory(),\n\t\t\t\t\tforce: false,\n\t\t\t\t});\n\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: `Deleted: ${input.path}` }],\n\t\t\t\t\tdetails: {\n\t\t\t\t\t\taction,\n\t\t\t\t\t\tresolvedPath,\n\t\t\t\t\t\trecursive,\n\t\t\t\t\t\tforce,\n\t\t\t\t\t} as FsOpsToolDetails,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tif (!input.from || !input.to) {\n\t\t\t\tthrow new Error(`fs_ops ${action} requires both from and to.`);\n\t\t\t}\n\n\t\t\tconst resolvedFrom = resolveToCwd(input.from, cwd);\n\t\t\tconst resolvedTo = resolveToCwd(input.to, cwd);\n\t\t\tconst sourceExists = await pathExists(ops, resolvedFrom);\n\t\t\tif (!sourceExists) {\n\t\t\t\tthrow new Error(`Source path not found: ${input.from}`);\n\t\t\t}\n\t\t\tconst destinationExists = await pathExists(ops, resolvedTo);\n\t\t\tif (destinationExists && !force) {\n\t\t\t\tthrow new Error(`Destination already exists: ${input.to}. Pass force=true to replace.`);\n\t\t\t}\n\t\t\tif (destinationExists && force) {\n\t\t\t\tensureNotAborted(signal);\n\t\t\t\tawait ops.remove(resolvedTo, { recursive: true, force: true });\n\t\t\t}\n\n\t\t\tconst sourceStat = await ops.stat(resolvedFrom);\n\t\t\tconst sourceIsDirectory = sourceStat.isDirectory();\n\t\t\tif (action === \"copy\" && sourceIsDirectory && !recursive) {\n\t\t\t\tthrow new Error(\"Copying a directory requires recursive=true.\");\n\t\t\t}\n\n\t\t\tif (action === \"copy\") {\n\t\t\t\tensureNotAborted(signal);\n\t\t\t\tawait ops.copy(resolvedFrom, resolvedTo, {\n\t\t\t\t\trecursive: sourceIsDirectory,\n\t\t\t\t\tforce,\n\t\t\t\t});\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: `Copied: ${input.from} -> ${input.to}` }],\n\t\t\t\t\tdetails: {\n\t\t\t\t\t\taction,\n\t\t\t\t\t\tresolvedFrom,\n\t\t\t\t\t\tresolvedTo,\n\t\t\t\t\t\trecursive,\n\t\t\t\t\t\tforce,\n\t\t\t\t\t} as FsOpsToolDetails,\n\t\t\t\t};\n\t\t\t}\n\n\t\t\tlet exdevFallback = false;\n\t\t\ttry {\n\t\t\t\tensureNotAborted(signal);\n\t\t\t\tawait ops.rename(resolvedFrom, resolvedTo);\n\t\t\t} catch (error: any) {\n\t\t\t\tif (error?.code !== \"EXDEV\") {\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t\texdevFallback = true;\n\t\t\t\tensureNotAborted(signal);\n\t\t\t\tawait ops.copy(resolvedFrom, resolvedTo, {\n\t\t\t\t\trecursive: sourceIsDirectory,\n\t\t\t\t\tforce: true,\n\t\t\t\t});\n\t\t\t\tawait ops.remove(resolvedFrom, {\n\t\t\t\t\trecursive: sourceIsDirectory,\n\t\t\t\t\tforce: false,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: `Moved: ${input.from} -> ${input.to}` }],\n\t\t\t\tdetails: {\n\t\t\t\t\taction,\n\t\t\t\t\tresolvedFrom,\n\t\t\t\t\tresolvedTo,\n\t\t\t\t\trecursive,\n\t\t\t\t\tforce,\n\t\t\t\t\texdevFallback: exdevFallback || undefined,\n\t\t\t\t} as FsOpsToolDetails,\n\t\t\t};\n\t\t},\n\t};\n}\n\nexport const fsOpsTool = createFsOpsTool(process.cwd());\n"]}

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

@@ -0,0 +1,45 @@
+import { type TruncationResult } from "./truncate.js";
+export declare const DEFAULT_GIT_TIMEOUT_SECONDS = 30;
+export declare const MAX_GIT_CAPTURE_BYTES: number;
+export interface RunGitCommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    captureTruncated: boolean;
+}
+export interface GitCommandExecutionOptions {
+    env?: NodeJS.ProcessEnv;
+}
+export type GitCommandExists = (command: string) => boolean;
+export type RunGitCommand = (args: string[], cwd: string, timeoutMs: number, signal?: AbortSignal, executionOptions?: GitCommandExecutionOptions) => Promise<RunGitCommandResult>;
+export interface GitCommandOptions {
+    commandExists?: GitCommandExists;
+    runCommand?: RunGitCommand;
+}
+export interface GitRunSummary {
+    output: string;
+    captureTruncated: boolean;
+    truncation?: TruncationResult;
+    exitCode: number;
+}
+export interface GitRunParams {
+    toolName: string;
+    action: string;
+    args: string[];
+    cwd: string;
+    timeoutSeconds: number;
+    runCommand: RunGitCommand;
+    signal?: AbortSignal;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function resolveGitCommandOptions(options?: GitCommandOptions): {
+    hasCommand: GitCommandExists;
+    runCommand: RunGitCommand;
+};
+export declare function normalizePositiveInt(raw: number | undefined, fallback: number, field: string): number;
+export declare function normalizeRefLike(raw: string | undefined, field: string): string | undefined;
+export declare function requireRefLike(raw: string | undefined, field: string): string;
+export declare function normalizeRequiredString(raw: string | undefined, field: string): string;
+export declare function normalizeFiles(files: string[] | undefined, field: string): string[];
+export declare function runGitAndFormatOutput(params: GitRunParams): Promise<GitRunSummary>;
+//# sourceMappingURL=git-common.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-common.d.ts","sourceRoot":"","sources":["../../../src/core/tools/git-common.ts"],"names":[],"mappings":"AACA,OAAO,EAIN,KAAK,gBAAgB,EAErB,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,qBAAqB,QAAa,CAAC;AAEhD,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG,CAC3B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,EACpB,gBAAgB,CAAC,EAAE,0BAA0B,KACzC,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAElC,MAAM,WAAW,iBAAiB;IACjC,aAAa,CAAC,EAAE,gBAAgB,CAAC;IACjC,UAAU,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,aAAa,CAAC;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAuHD,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG;IACtE,UAAU,EAAE,gBAAgB,CAAC;IAC7B,UAAU,EAAE,aAAa,CAAC;CAC1B,CAKA;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOrG;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAU3F;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7E;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAWnF;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAsCxF"}

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

@@ -0,0 +1,185 @@
+import { spawn, spawnSync } from "node:child_process";
+import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, truncateHead, } from "./truncate.js";
+export const DEFAULT_GIT_TIMEOUT_SECONDS = 30;
+export const MAX_GIT_CAPTURE_BYTES = 512 * 1024;
+function commandExists(command) {
+    try {
+        const result = spawnSync(command, ["--version"], { stdio: "pipe" });
+        const err = result.error;
+        return !err || err.code !== "ENOENT";
+    }
+    catch {
+        return false;
+    }
+}
+function runGitCommand(args, cwd, timeoutMs, signal, executionOptions) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new Error("Operation aborted"));
+            return;
+        }
+        const child = spawn("git", args, {
+            cwd,
+            stdio: ["ignore", "pipe", "pipe"],
+            env: executionOptions?.env ? { ...process.env, ...executionOptions.env } : process.env,
+        });
+        const stdoutChunks = [];
+        const stderrChunks = [];
+        let stdoutBytes = 0;
+        let stderrBytes = 0;
+        let captureTruncated = false;
+        let timedOut = false;
+        let aborted = false;
+        let settled = false;
+        const settle = (fn) => {
+            if (!settled) {
+                settled = true;
+                fn();
+            }
+        };
+        const captureChunk = (chunk, chunks, currentBytes) => {
+            if (currentBytes >= MAX_GIT_CAPTURE_BYTES) {
+                return { nextBytes: currentBytes, truncated: true };
+            }
+            const remaining = MAX_GIT_CAPTURE_BYTES - currentBytes;
+            if (chunk.length <= remaining) {
+                chunks.push(chunk);
+                return { nextBytes: currentBytes + chunk.length, truncated: false };
+            }
+            chunks.push(chunk.subarray(0, remaining));
+            return { nextBytes: MAX_GIT_CAPTURE_BYTES, truncated: true };
+        };
+        const timeoutHandle = setTimeout(() => {
+            timedOut = true;
+            child.kill("SIGTERM");
+        }, Math.max(1000, timeoutMs));
+        const onAbort = () => {
+            aborted = true;
+            child.kill("SIGTERM");
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+        const cleanup = () => {
+            clearTimeout(timeoutHandle);
+            signal?.removeEventListener("abort", onAbort);
+        };
+        child.stdout.on("data", (chunk) => {
+            const captured = captureChunk(chunk, stdoutChunks, stdoutBytes);
+            stdoutBytes = captured.nextBytes;
+            captureTruncated = captureTruncated || captured.truncated;
+        });
+        child.stderr.on("data", (chunk) => {
+            const captured = captureChunk(chunk, stderrChunks, stderrBytes);
+            stderrBytes = captured.nextBytes;
+            captureTruncated = captureTruncated || captured.truncated;
+        });
+        child.on("error", (error) => {
+            cleanup();
+            settle(() => reject(new Error(`Failed to run git: ${error.message}`)));
+        });
+        child.on("close", (code) => {
+            cleanup();
+            if (aborted) {
+                settle(() => reject(new Error("Operation aborted")));
+                return;
+            }
+            if (timedOut) {
+                settle(() => reject(new Error(`Command timed out after ${Math.round(timeoutMs / 1000)}s`)));
+                return;
+            }
+            settle(() => resolve({
+                stdout: Buffer.concat(stdoutChunks).toString("utf-8"),
+                stderr: Buffer.concat(stderrChunks).toString("utf-8"),
+                exitCode: code ?? -1,
+                captureTruncated,
+            }));
+        });
+    });
+}
+export function resolveGitCommandOptions(options) {
+    return {
+        hasCommand: options?.commandExists ?? commandExists,
+        runCommand: options?.runCommand ?? runGitCommand,
+    };
+}
+export function normalizePositiveInt(raw, fallback, field) {
+    if (raw === undefined)
+        return fallback;
+    const value = Math.floor(raw);
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`${field} must be a positive number.`);
+    }
+    return value;
+}
+export function normalizeRefLike(raw, field) {
+    if (raw === undefined)
+        return undefined;
+    const normalized = raw.trim();
+    if (normalized.length === 0) {
+        throw new Error(`${field} must not be empty.`);
+    }
+    if (normalized.startsWith("-")) {
+        throw new Error(`${field} must not start with '-'.`);
+    }
+    return normalized;
+}
+export function requireRefLike(raw, field) {
+    const normalized = normalizeRefLike(raw, field);
+    if (!normalized) {
+        throw new Error(`${field} is required.`);
+    }
+    return normalized;
+}
+export function normalizeRequiredString(raw, field) {
+    const value = raw?.trim();
+    if (!value) {
+        throw new Error(`${field} is required.`);
+    }
+    return value;
+}
+export function normalizeFiles(files, field) {
+    if (!files || files.length === 0) {
+        throw new Error(`${field} is required.`);
+    }
+    const normalized = files
+        .map((file) => file.trim())
+        .filter((file) => file.length > 0);
+    if (normalized.length === 0) {
+        throw new Error(`${field} must include at least one non-empty path.`);
+    }
+    return normalized;
+}
+export async function runGitAndFormatOutput(params) {
+    const result = await params.runCommand(params.args, params.cwd, params.timeoutSeconds * 1000, params.signal, {
+        env: params.env,
+    });
+    if (result.exitCode !== 0) {
+        const errorText = result.stderr.trim() || result.stdout.trim() || `${params.toolName} ${params.action} failed with exit code ${result.exitCode}`;
+        throw new Error(errorText);
+    }
+    let output = result.stdout.trimEnd();
+    if (!output && result.stderr.trim().length > 0) {
+        output = result.stderr.trimEnd();
+    }
+    if (!output) {
+        output = "No output";
+    }
+    const truncation = truncateHead(output);
+    let finalOutput = truncation.content;
+    const notices = [];
+    if (truncation.truncated) {
+        notices.push(`${formatSize(DEFAULT_MAX_BYTES)} output limit reached`);
+    }
+    if (result.captureTruncated) {
+        notices.push(`capture limit reached (${formatSize(MAX_GIT_CAPTURE_BYTES)})`);
+    }
+    if (notices.length > 0) {
+        finalOutput += `\n\n[${notices.join(". ")} · showing up to ${DEFAULT_MAX_LINES} lines]`;
+    }
+    return {
+        output: finalOutput,
+        captureTruncated: result.captureTruncated,
+        truncation: truncation.truncated ? truncation : undefined,
+        exitCode: result.exitCode,
+    };
+}
+//# sourceMappingURL=git-common.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-common.js","sourceRoot":"","sources":["../../../src/core/tools/git-common.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn, spawnSync } from \"node:child_process\";\nimport {\n\tDEFAULT_MAX_BYTES,\n\tDEFAULT_MAX_LINES,\n\tformatSize,\n\ttype TruncationResult,\n\ttruncateHead,\n} from \"./truncate.js\";\n\nexport const DEFAULT_GIT_TIMEOUT_SECONDS = 30;\nexport const MAX_GIT_CAPTURE_BYTES = 512 * 1024;\n\nexport interface RunGitCommandResult {\n\tstdout: string;\n\tstderr: string;\n\texitCode: number;\n\tcaptureTruncated: boolean;\n}\n\nexport interface GitCommandExecutionOptions {\n\tenv?: NodeJS.ProcessEnv;\n}\n\nexport type GitCommandExists = (command: string) => boolean;\n\nexport type RunGitCommand = (\n\targs: string[],\n\tcwd: string,\n\ttimeoutMs: number,\n\tsignal?: AbortSignal,\n\texecutionOptions?: GitCommandExecutionOptions,\n) => Promise<RunGitCommandResult>;\n\nexport interface GitCommandOptions {\n\tcommandExists?: GitCommandExists;\n\trunCommand?: RunGitCommand;\n}\n\nexport interface GitRunSummary {\n\toutput: string;\n\tcaptureTruncated: boolean;\n\ttruncation?: TruncationResult;\n\texitCode: number;\n}\n\nexport interface GitRunParams {\n\ttoolName: string;\n\taction: string;\n\targs: string[];\n\tcwd: string;\n\ttimeoutSeconds: number;\n\trunCommand: RunGitCommand;\n\tsignal?: AbortSignal;\n\tenv?: NodeJS.ProcessEnv;\n}\n\nfunction commandExists(command: string): boolean {\n\ttry {\n\t\tconst result = spawnSync(command, [\"--version\"], { stdio: \"pipe\" });\n\t\tconst err = result.error as NodeJS.ErrnoException | undefined;\n\t\treturn !err || err.code !== \"ENOENT\";\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction runGitCommand(\n\targs: string[],\n\tcwd: string,\n\ttimeoutMs: number,\n\tsignal?: AbortSignal,\n\texecutionOptions?: GitCommandExecutionOptions,\n): Promise<RunGitCommandResult> {\n\treturn new Promise((resolve, reject) => {\n\t\tif (signal?.aborted) {\n\t\t\treject(new Error(\"Operation aborted\"));\n\t\t\treturn;\n\t\t}\n\n\t\tconst child = spawn(\"git\", args, {\n\t\t\tcwd,\n\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t\tenv: executionOptions?.env ? { ...process.env, ...executionOptions.env } : process.env,\n\t\t});\n\n\t\tconst stdoutChunks: Buffer[] = [];\n\t\tconst stderrChunks: Buffer[] = [];\n\t\tlet stdoutBytes = 0;\n\t\tlet stderrBytes = 0;\n\t\tlet captureTruncated = false;\n\t\tlet timedOut = false;\n\t\tlet aborted = false;\n\t\tlet settled = false;\n\n\t\tconst settle = (fn: () => void) => {\n\t\t\tif (!settled) {\n\t\t\t\tsettled = true;\n\t\t\t\tfn();\n\t\t\t}\n\t\t};\n\n\t\tconst captureChunk = (\n\t\t\tchunk: Buffer,\n\t\t\tchunks: Buffer[],\n\t\t\tcurrentBytes: number,\n\t\t): { nextBytes: number; truncated: boolean } => {\n\t\t\tif (currentBytes >= MAX_GIT_CAPTURE_BYTES) {\n\t\t\t\treturn { nextBytes: currentBytes, truncated: true };\n\t\t\t}\n\t\t\tconst remaining = MAX_GIT_CAPTURE_BYTES - currentBytes;\n\t\t\tif (chunk.length <= remaining) {\n\t\t\t\tchunks.push(chunk);\n\t\t\t\treturn { nextBytes: currentBytes + chunk.length, truncated: false };\n\t\t\t}\n\t\t\tchunks.push(chunk.subarray(0, remaining));\n\t\t\treturn { nextBytes: MAX_GIT_CAPTURE_BYTES, truncated: true };\n\t\t};\n\n\t\tconst timeoutHandle = setTimeout(() => {\n\t\t\ttimedOut = true;\n\t\t\tchild.kill(\"SIGTERM\");\n\t\t}, Math.max(1000, timeoutMs));\n\n\t\tconst onAbort = () => {\n\t\t\taborted = true;\n\t\t\tchild.kill(\"SIGTERM\");\n\t\t};\n\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\n\t\tconst cleanup = () => {\n\t\t\tclearTimeout(timeoutHandle);\n\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t};\n\n\t\tchild.stdout.on(\"data\", (chunk: Buffer) => {\n\t\t\tconst captured = captureChunk(chunk, stdoutChunks, stdoutBytes);\n\t\t\tstdoutBytes = captured.nextBytes;\n\t\t\tcaptureTruncated = captureTruncated || captured.truncated;\n\t\t});\n\n\t\tchild.stderr.on(\"data\", (chunk: Buffer) => {\n\t\t\tconst captured = captureChunk(chunk, stderrChunks, stderrBytes);\n\t\t\tstderrBytes = captured.nextBytes;\n\t\t\tcaptureTruncated = captureTruncated || captured.truncated;\n\t\t});\n\n\t\tchild.on(\"error\", (error) => {\n\t\t\tcleanup();\n\t\t\tsettle(() => reject(new Error(`Failed to run git: ${error.message}`)));\n\t\t});\n\n\t\tchild.on(\"close\", (code) => {\n\t\t\tcleanup();\n\t\t\tif (aborted) {\n\t\t\t\tsettle(() => reject(new Error(\"Operation aborted\")));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (timedOut) {\n\t\t\t\tsettle(() => reject(new Error(`Command timed out after ${Math.round(timeoutMs / 1000)}s`)));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tsettle(() =>\n\t\t\t\tresolve({\n\t\t\t\t\tstdout: Buffer.concat(stdoutChunks).toString(\"utf-8\"),\n\t\t\t\t\tstderr: Buffer.concat(stderrChunks).toString(\"utf-8\"),\n\t\t\t\t\texitCode: code ?? -1,\n\t\t\t\t\tcaptureTruncated,\n\t\t\t\t}),\n\t\t\t);\n\t\t});\n\t});\n}\n\nexport function resolveGitCommandOptions(options?: GitCommandOptions): {\n\thasCommand: GitCommandExists;\n\trunCommand: RunGitCommand;\n} {\n\treturn {\n\t\thasCommand: options?.commandExists ?? commandExists,\n\t\trunCommand: options?.runCommand ?? runGitCommand,\n\t};\n}\n\nexport function normalizePositiveInt(raw: number | undefined, fallback: number, field: string): number {\n\tif (raw === undefined) return fallback;\n\tconst value = Math.floor(raw);\n\tif (!Number.isFinite(value) || value <= 0) {\n\t\tthrow new Error(`${field} must be a positive number.`);\n\t}\n\treturn value;\n}\n\nexport function normalizeRefLike(raw: string | undefined, field: string): string | undefined {\n\tif (raw === undefined) return undefined;\n\tconst normalized = raw.trim();\n\tif (normalized.length === 0) {\n\t\tthrow new Error(`${field} must not be empty.`);\n\t}\n\tif (normalized.startsWith(\"-\")) {\n\t\tthrow new Error(`${field} must not start with '-'.`);\n\t}\n\treturn normalized;\n}\n\nexport function requireRefLike(raw: string | undefined, field: string): string {\n\tconst normalized = normalizeRefLike(raw, field);\n\tif (!normalized) {\n\t\tthrow new Error(`${field} is required.`);\n\t}\n\treturn normalized;\n}\n\nexport function normalizeRequiredString(raw: string | undefined, field: string): string {\n\tconst value = raw?.trim();\n\tif (!value) {\n\t\tthrow new Error(`${field} is required.`);\n\t}\n\treturn value;\n}\n\nexport function normalizeFiles(files: string[] | undefined, field: string): string[] {\n\tif (!files || files.length === 0) {\n\t\tthrow new Error(`${field} is required.`);\n\t}\n\tconst normalized = files\n\t\t.map((file) => file.trim())\n\t\t.filter((file) => file.length > 0);\n\tif (normalized.length === 0) {\n\t\tthrow new Error(`${field} must include at least one non-empty path.`);\n\t}\n\treturn normalized;\n}\n\nexport async function runGitAndFormatOutput(params: GitRunParams): Promise<GitRunSummary> {\n\tconst result = await params.runCommand(params.args, params.cwd, params.timeoutSeconds * 1000, params.signal, {\n\t\tenv: params.env,\n\t});\n\n\tif (result.exitCode !== 0) {\n\t\tconst errorText = result.stderr.trim() || result.stdout.trim() || `${params.toolName} ${params.action} failed with exit code ${result.exitCode}`;\n\t\tthrow new Error(errorText);\n\t}\n\n\tlet output = result.stdout.trimEnd();\n\tif (!output && result.stderr.trim().length > 0) {\n\t\toutput = result.stderr.trimEnd();\n\t}\n\tif (!output) {\n\t\toutput = \"No output\";\n\t}\n\n\tconst truncation = truncateHead(output);\n\tlet finalOutput = truncation.content;\n\tconst notices: string[] = [];\n\n\tif (truncation.truncated) {\n\t\tnotices.push(`${formatSize(DEFAULT_MAX_BYTES)} output limit reached`);\n\t}\n\tif (result.captureTruncated) {\n\t\tnotices.push(`capture limit reached (${formatSize(MAX_GIT_CAPTURE_BYTES)})`);\n\t}\n\tif (notices.length > 0) {\n\t\tfinalOutput += `\\n\\n[${notices.join(\". \")} · showing up to ${DEFAULT_MAX_LINES} lines]`;\n\t}\n\n\treturn {\n\t\toutput: finalOutput,\n\t\tcaptureTruncated: result.captureTruncated,\n\t\ttruncation: truncation.truncated ? truncation : undefined,\n\t\texitCode: result.exitCode,\n\t};\n}\n"]}

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

@@ -0,0 +1,62 @@
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import { type Static } from "@sinclair/typebox";
+import { type GitCommandOptions } from "./git-common.js";
+import type { TruncationResult } from "./truncate.js";
+declare const gitReadSchema: import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"status">, import("@sinclair/typebox").TLiteral<"diff">, import("@sinclair/typebox").TLiteral<"log">, import("@sinclair/typebox").TLiteral<"blame">, import("@sinclair/typebox").TLiteral<"show">, import("@sinclair/typebox").TLiteral<"branch_list">, import("@sinclair/typebox").TLiteral<"remote_list">, import("@sinclair/typebox").TLiteral<"rev_parse">]>;
+    path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    file: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    base: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    head: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    staged: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    context: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    porcelain: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    untracked: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    since: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    line_start: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    line_end: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    all: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    verbose: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    target: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    short: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
+export type GitReadToolInput = Static<typeof gitReadSchema>;
+type GitReadAction = GitReadToolInput["action"];
+export interface GitReadToolDetails {
+    action: GitReadAction;
+    command: string;
+    args: string[];
+    cwd: string;
+    exitCode: number;
+    captureTruncated?: boolean;
+    truncation?: TruncationResult;
+}
+export interface GitReadToolOptions extends GitCommandOptions {
+}
+export declare function createGitReadTool(cwd: string, options?: GitReadToolOptions): AgentTool<typeof gitReadSchema>;
+export declare const gitReadTool: AgentTool<import("@sinclair/typebox").TObject<{
+    action: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"status">, import("@sinclair/typebox").TLiteral<"diff">, import("@sinclair/typebox").TLiteral<"log">, import("@sinclair/typebox").TLiteral<"blame">, import("@sinclair/typebox").TLiteral<"show">, import("@sinclair/typebox").TLiteral<"branch_list">, import("@sinclair/typebox").TLiteral<"remote_list">, import("@sinclair/typebox").TLiteral<"rev_parse">]>;
+    path: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    file: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    base: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    head: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    staged: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    context: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    porcelain: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    untracked: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    since: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    line_start: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    line_end: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    all: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    verbose: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    target: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    short: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+    timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>, any>;
+export {};
+//# sourceMappingURL=git-read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-read.d.ts","sourceRoot":"","sources":["../../../src/core/tools/git-read.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,KAAK,MAAM,EAAQ,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAON,KAAK,iBAAiB,EACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;EAwCjB,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AAK5D,KAAK,aAAa,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AAEhD,MAAM,WAAW,kBAAkB;IAClC,MAAM,EAAE,aAAa,CAAC;IACtB,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,kBAAmB,SAAQ,iBAAiB;CAAG;AAiJhE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC,OAAO,aAAa,CAAC,CA2C5G;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;QAAmC,CAAC"}