@easynet/agent-tool-buildin 0.0.44 → 0.0.46

package/dist/src/calendar/calendarUpdateEvent.js

@@ -0,0 +1,58 @@
+import { createTaggedError } from "@easynet/agent-tool";
+import { quoteAppleScriptString, runOsaScript } from "../osascript/common.js";
+/**
+ * Update calendar event by uid in specific calendar.
+ * @tool
+ * @effect local_write
+ */
+export async function calendarUpdateEvent(args) {
+    const id = args.id?.trim();
+    const calendar = args.calendar?.trim() || "Home";
+    if (!id)
+        throw createTaggedError("CALENDAR_INVALID", "id is required", {});
+    if (!args.title && !args.startDateText && !args.endDateText && !args.location && !args.notes) {
+        throw createTaggedError("CALENDAR_INVALID", "at least one field to update is required", {});
+    }
+    const lines = [
+        'tell application "Calendar"',
+        "activate",
+        `set calName to ${quoteAppleScriptString(calendar)}`,
+        `set wantedId to ${quoteAppleScriptString(id)}`,
+        "set targetCal to calendar calName",
+        "set targetEvent to first event of targetCal whose (uid as text) is wantedId",
+        ...(args.title?.trim() ? [`set summary of targetEvent to ${quoteAppleScriptString(args.title.trim())}`] : []),
+        ...(args.startDateText?.trim()
+            ? [
+                `set stText to ${quoteAppleScriptString(args.startDateText.trim())}`,
+                "set start date of targetEvent to date stText",
+            ]
+            : []),
+        ...(args.endDateText?.trim()
+            ? [
+                `set edText to ${quoteAppleScriptString(args.endDateText.trim())}`,
+                "set end date of targetEvent to date edText",
+            ]
+            : []),
+        ...(args.location?.trim() ? [`set location of targetEvent to ${quoteAppleScriptString(args.location.trim())}`] : []),
+        ...(args.notes?.trim() ? [`set description of targetEvent to ${quoteAppleScriptString(args.notes.trim())}`] : []),
+        'return "updated"',
+        "end tell",
+    ];
+    const output = await runOsaScript(lines, "CALENDAR");
+    return {
+        result: {
+            id,
+            calendar,
+            status: output || "updated",
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "calendarUpdateEvent",
+                summary: `Updated calendar event ${id} in ${calendar}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=calendarUpdateEvent.js.map

package/dist/src/calendar/calendarUpdateEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendarUpdateEvent.js","sourceRoot":"","sources":["../../../src/calendar/calendarUpdateEvent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE9E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAQzC;IACC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC;IACjD,IAAI,CAAC,EAAE;QAAE,MAAM,iBAAiB,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAC3E,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAC7F,MAAM,iBAAiB,CAAC,kBAAkB,EAAE,0CAA0C,EAAE,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,6BAA6B;QAC7B,UAAU;QACV,kBAAkB,sBAAsB,CAAC,QAAQ,CAAC,EAAE;QACpD,mBAAmB,sBAAsB,CAAC,EAAE,CAAC,EAAE;QAC/C,mCAAmC;QACnC,6EAA6E;QAC7E,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,iCAAiC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7G,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE;YAC5B,CAAC,CAAC;gBACE,iBAAiB,sBAAsB,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE;gBACpE,8CAA8C;aAC/C;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE;YAC1B,CAAC,CAAC;gBACE,iBAAiB,sBAAsB,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE;gBAClE,4CAA4C;aAC7C;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,kCAAkC,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpH,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,qCAAqC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjH,kBAAkB;QAClB,UAAU;KACX,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAErD,OAAO;QACL,MAAM,EAAE;YACN,EAAE;YACF,QAAQ;YACR,MAAM,EAAE,MAAM,IAAI,SAAS;SAC5B;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,qBAAqB;gBAC1B,OAAO,EAAE,0BAA0B,EAAE,OAAO,QAAQ,EAAE;gBACtD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/cron/cronListEntries.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Canonical name for listing cron entries.
+ * @tool
+ * @effect none
+ */
+export declare function cronListEntries(_?: {}): Promise<{
+    result: {
+        count: number;
+        entries: string[];
+        raw: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=cronListEntries.d.ts.map

package/dist/src/cron/cronListEntries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronListEntries.d.ts","sourceRoot":"","sources":["../../../src/cron/cronListEntries.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,CAAC,GAAE,EAAO;;;;;;;;;;;;GA2B/C"}

package/dist/src/cron/cronListEntries.js

@@ -0,0 +1,33 @@
+import { runOsaScript } from "../osascript/common.js";
+/**
+ * Canonical name for listing cron entries.
+ * @tool
+ * @effect none
+ */
+export async function cronListEntries(_ = {}) {
+    const lines = [
+        "set sh to \"crontab -l 2>/dev/null || true\"",
+        "return do shell script sh",
+    ];
+    const output = await runOsaScript(lines, "CRON");
+    const linesOut = output
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0);
+    return {
+        result: {
+            count: linesOut.length,
+            entries: linesOut,
+            raw: output,
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "cronListEntries",
+                summary: `Listed ${linesOut.length} cron entries`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=cronListEntries.js.map

package/dist/src/cron/cronListEntries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronListEntries.js","sourceRoot":"","sources":["../../../src/cron/cronListEntries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAQ,EAAE;IAC9C,MAAM,KAAK,GAAG;QACZ,8CAA8C;QAC9C,2BAA2B;KAC5B,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM;SACpB,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAErC,OAAO;QACL,MAAM,EAAE;YACN,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,OAAO,EAAE,QAAQ;YACjB,GAAG,EAAE,MAAM;SACZ;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,iBAAiB;gBACtB,OAAO,EAAE,UAAU,QAAQ,CAAC,MAAM,eAAe;gBACjD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/cron/cronRemoveTaggedEntries.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Canonical name for removing tagged cron entries.
+ * @tool
+ * @effect local_write
+ */
+export declare function cronRemoveTaggedEntries(args: {
+    tag: string;
+}): Promise<{
+    result: {
+        tag: string;
+        marker: string;
+        status: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=cronRemoveTaggedEntries.d.ts.map

package/dist/src/cron/cronRemoveTaggedEntries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronRemoveTaggedEntries.d.ts","sourceRoot":"","sources":["../../../src/cron/cronRemoveTaggedEntries.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GA+BlE"}

package/dist/src/cron/cronRemoveTaggedEntries.js

@@ -0,0 +1,41 @@
+import { createTaggedError } from "@easynet/agent-tool";
+import { quoteAppleScriptString, runOsaScript } from "../osascript/common.js";
+function b64(input) {
+    return Buffer.from(input, "utf-8").toString("base64");
+}
+/**
+ * Canonical name for removing tagged cron entries.
+ * @tool
+ * @effect local_write
+ */
+export async function cronRemoveTaggedEntries(args) {
+    const tag = args.tag?.trim();
+    if (!tag)
+        throw createTaggedError("CRON_INVALID", "tag is required", {});
+    const marker = `# easynet:${tag}`;
+    const script = [
+        "set -e",
+        `marker=$(printf '%s' ${JSON.stringify(b64(marker))} | base64 -D)`,
+        "existing=$(crontab -l 2>/dev/null || true)",
+        "filtered=$(printf '%s\\n' \"$existing\" | grep -vF \"$marker\" || true)",
+        "printf '%s\\n' \"$filtered\" | sed '/^[[:space:]]*$/d' | crontab -",
+        "printf '%s' \"$marker\"",
+    ].join("; ");
+    const output = await runOsaScript([`return do shell script ${quoteAppleScriptString(script)}`], "CRON");
+    return {
+        result: {
+            tag,
+            marker: output || marker,
+            status: "removed",
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "cronRemoveTaggedEntries",
+                summary: `Removed cron entries with tag ${tag}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=cronRemoveTaggedEntries.js.map

package/dist/src/cron/cronRemoveTaggedEntries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronRemoveTaggedEntries.js","sourceRoot":"","sources":["../../../src/cron/cronRemoveTaggedEntries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE9E,SAAS,GAAG,CAAC,KAAa;IACxB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAAqB;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,GAAG;QAAE,MAAM,iBAAiB,CAAC,cAAc,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAEzE,MAAM,MAAM,GAAG,aAAa,GAAG,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG;QACb,QAAQ;QACR,wBAAwB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,eAAe;QAClE,4CAA4C;QAC5C,yEAAyE;QACzE,oEAAoE;QACpE,yBAAyB;KAC1B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,CAAC,0BAA0B,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAExG,OAAO;QACL,MAAM,EAAE;YACN,GAAG;YACH,MAAM,EAAE,MAAM,IAAI,MAAM;YACxB,MAAM,EAAE,SAAS;SAClB;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,yBAAyB;gBAC9B,OAAO,EAAE,iCAAiC,GAAG,EAAE;gBAC/C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/cron/cronSetTaggedEntry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Canonical name for creating/updating a tagged cron entry.
+ * @tool
+ * @effect local_write
+ */
+export declare function cronSetTaggedEntry(args: {
+    expression: string;
+    command: string;
+    tag: string;
+}): Promise<{
+    result: {
+        tag: string;
+        marker: string;
+        line: string;
+        status: string;
+    };
+    evidence: {
+        type: string;
+        ref: string;
+        summary: string;
+        createdAt: string;
+    }[];
+}>;
+//# sourceMappingURL=cronSetTaggedEntry.d.ts.map

package/dist/src/cron/cronSetTaggedEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronSetTaggedEntry.d.ts","sourceRoot":"","sources":["../../../src/cron/cronSetTaggedEntry.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;;;;;;;;;;;;;GAyCA"}

package/dist/src/cron/cronSetTaggedEntry.js

@@ -0,0 +1,51 @@
+import { createTaggedError } from "@easynet/agent-tool";
+import { quoteAppleScriptString, runOsaScript } from "../osascript/common.js";
+function b64(input) {
+    return Buffer.from(input, "utf-8").toString("base64");
+}
+/**
+ * Canonical name for creating/updating a tagged cron entry.
+ * @tool
+ * @effect local_write
+ */
+export async function cronSetTaggedEntry(args) {
+    const expression = args.expression?.trim();
+    const command = args.command?.trim();
+    const tag = args.tag?.trim();
+    if (!expression)
+        throw createTaggedError("CRON_INVALID", "expression is required", {});
+    if (!command)
+        throw createTaggedError("CRON_INVALID", "command is required", {});
+    if (!tag)
+        throw createTaggedError("CRON_INVALID", "tag is required", {});
+    const marker = `# easynet:${tag}`;
+    const newLine = `${expression} ${command} ${marker}`;
+    const script = [
+        "set -e",
+        `marker=$(printf '%s' ${JSON.stringify(b64(marker))} | base64 -D)`,
+        `new_line=$(printf '%s' ${JSON.stringify(b64(newLine))} | base64 -D)`,
+        "existing=$(crontab -l 2>/dev/null || true)",
+        "filtered=$(printf '%s\\n' \"$existing\" | grep -vF \"$marker\" || true)",
+        "next=$(printf '%s\\n%s\\n' \"$filtered\" \"$new_line\" | sed '/^[[:space:]]*$/d')",
+        "printf '%s\\n' \"$next\" | crontab -",
+        "printf '%s' \"$new_line\"",
+    ].join("; ");
+    const output = await runOsaScript([`return do shell script ${quoteAppleScriptString(script)}`], "CRON");
+    return {
+        result: {
+            tag,
+            marker,
+            line: output || newLine,
+            status: "upserted",
+        },
+        evidence: [
+            {
+                type: "tool",
+                ref: "cronSetTaggedEntry",
+                summary: `Upserted cron entry with tag ${tag}`,
+                createdAt: new Date().toISOString(),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=cronSetTaggedEntry.js.map

package/dist/src/cron/cronSetTaggedEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cronSetTaggedEntry.js","sourceRoot":"","sources":["../../../src/cron/cronSetTaggedEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE9E,SAAS,GAAG,CAAC,KAAa;IACxB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAIxC;IACC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAE7B,IAAI,CAAC,UAAU;QAAE,MAAM,iBAAiB,CAAC,cAAc,EAAE,wBAAwB,EAAE,EAAE,CAAC,CAAC;IACvF,IAAI,CAAC,OAAO;QAAE,MAAM,iBAAiB,CAAC,cAAc,EAAE,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACjF,IAAI,CAAC,GAAG;QAAE,MAAM,iBAAiB,CAAC,cAAc,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAEzE,MAAM,MAAM,GAAG,aAAa,GAAG,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,GAAG,UAAU,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;IAErD,MAAM,MAAM,GAAG;QACb,QAAQ;QACR,wBAAwB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,eAAe;QAClE,0BAA0B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,eAAe;QACrE,4CAA4C;QAC5C,yEAAyE;QACzE,mFAAmF;QACnF,sCAAsC;QACtC,2BAA2B;KAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,CAAC,0BAA0B,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAExG,OAAO;QACL,MAAM,EAAE;YACN,GAAG;YACH,MAAM;YACN,IAAI,EAAE,MAAM,IAAI,OAAO;YACvB,MAAM,EAAE,UAAU;SACnB;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,oBAAoB;gBACzB,OAAO,EAAE,gCAAgC,GAAG,EAAE;gBAC9C,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/exec/runCommand.d.ts

@@ -1,20 +1,36 @@
+type RunCommandOutput = {
+    result: {
+        stdout: string;
+        stderr: string;
+        exitCode: number | null;
+        timedOut: boolean;
+        signal?: string;
+    };
+    evidence: Array<{
+        type: string;
+        ref?: string;
+        summary: string;
+        createdAt: string;
+    }>;
+};
 /**
  * Run an allowlisted command in the sandbox via spawn (no shell), with timeout and output limits.
  * Uses spawn (no shell) to avoid injection; command and args are separate.
+ * Accepts either command+args or cmd as array [executable, ...args] (e.g. ["bash", "-lc", "echo hi"]).
  * @tool
  * @effect local_write
  */
 export declare function runCommand(args: {
-    command: string;
-    /** Alias for command (accepted when agents send "cmd" instead of "command"). */
+    command?: string;
+    /** Alias for command. */
     cmd?: string;
+    /** Explicit array form: [executable, ...args]. */
+    cmdArray?: string[];
     args?: string[];
     /** Alias for args (accepted when agents send "arguments" instead of "args"). */
     arguments?: string[];
     cwd?: string;
     timeoutMs?: number;
-}): Promise<{
-    result: unknown;
-    evidence: unknown[];
-}>;
+}): Promise<RunCommandOutput>;
+export {};
 //# sourceMappingURL=runCommand.d.ts.map

package/dist/src/exec/runCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runCommand.d.ts","sourceRoot":"","sources":["../../../src/exec/runCommand.ts"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;YA+D8B,OAAO;cAAY,OAAO,EAAE;GAmF1D"}
+{"version":3,"file":"runCommand.d.ts","sourceRoot":"","sources":["../../../src/exec/runCommand.ts"],"names":[],"mappings":"AAYA,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,QAAQ,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyJ5B"}

package/dist/src/exec/runCommand.js

@@ -8,6 +8,7 @@ import { overrideWithConfig } from "../util/overrideWithConfig.js";
 /**
  * Run an allowlisted command in the sandbox via spawn (no shell), with timeout and output limits.
  * Uses spawn (no shell) to avoid injection; command and args are separate.
+ * Accepts either command+args or cmd as array [executable, ...args] (e.g. ["bash", "-lc", "echo hi"]).
  * @tool
  * @effect local_write
  */
@@ -26,15 +27,28 @@ export async function runCommand(args) {
     const timeoutMs = typeof ctx.config?.timeoutMs === "number"
         ? ctx.config.timeoutMs
         : commandTimeoutMs;
-    // Step 2: Validate exec is enabled and command input (required, single name, allowlist).
+    // Step 2: Normalize command and args (support cmd as array [executable, ...args]).
+    let rawCommand;
+    let cmdArgs;
+    if (Array.isArray(args.cmdArray) && args.cmdArray.length > 0) {
+        rawCommand = String(args.cmdArray[0]).trim();
+        cmdArgs = args.cmdArray.slice(1).map(String);
+    }
+    else {
+        rawCommand = (args.command ?? args.cmd)?.trim() ?? "";
+        if (!rawCommand) {
+            throw createTaggedError("EXEC_INVALID", "command is required (pass 'command', 'cmd', or 'cmdArray')", {});
+        }
+        cmdArgs = Array.isArray(args.args)
+            ? args.args
+            : Array.isArray(args.arguments)
+                ? args.arguments
+                : [];
+    }
+    // Step 3: Validate exec is enabled and command input (single name, allowlist).
     if (!allowedCommands.length) {
         throw createTaggedError("EXEC_DISABLED", "Exec is disabled: allowedCommands is empty", {});
     }
-    const rawCommand = (args.command ?? args.cmd)?.trim();
-    if (!rawCommand) {
-        throw createTaggedError("EXEC_INVALID", "command is required (pass 'command' or 'cmd')", {});
-    }
-    // Only allow bare command name (no path, no shell metacharacters)
     const baseName = rawCommand.replace(/^.*\//, "").trim();
     if (baseName !== rawCommand || /[;&|$`\s]/.test(rawCommand)) {
         throw createTaggedError("EXEC_INVALID", "command must be a single executable name (no path, no shell chars)", { command: rawCommand });
@@ -42,18 +56,13 @@ export async function runCommand(args) {
     if (!allowedCommands.includes(baseName)) {
         throw createTaggedError("EXEC_NOT_ALLOWED", `Command "${baseName}" is not in allowedCommands`, { command: baseName, allowed: allowedCommands });
     }
-    // Step 3: Resolve cwd and spawn process with timeout and output limit.
-    const cmdArgs = Array.isArray(args.args)
-        ? args.args
-        : Array.isArray(args.arguments)
-            ? args.arguments
-            : [];
+    // Step 4: Resolve cwd and spawn process with timeout and output limit.
     const sandboxRoot = sandboxRootFromCfg ?? "";
     let cwd = pathResolve(sandboxRoot);
     if (args.cwd != null && args.cwd !== "") {
         cwd = await resolveSandboxedPath(args.cwd, sandboxRoot);
     }
-    // Step 4: Collect stdout/stderr and resolve with result and evidence.
+    // Step 5: Collect stdout/stderr and resolve with result and evidence.
     return new Promise((resolvePromise, rejectPromise) => {
         const proc = spawn(baseName, cmdArgs, {
             cwd,

package/dist/src/exec/runCommand.js.map

@@ -1 +1 @@
-{"version":3,"file":"runCommand.js","sourceRoot":"","sources":["../../../src/exec/runCommand.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runCommand.js","sourceRoot":"","sources":["../../../src/exec/runCommand.ts"],"names":[],"mappings":"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"}

package/dist/src/fs/listDir.d.ts

@@ -11,7 +11,8 @@ interface DirEntry {
  * @effect none
  */
 export declare function listDir(args: {
-    path: string;
+    /** Directory path to list; defaults to "." when missing or empty. */
+    path?: string;
     maxEntries?: number;
     includeHidden?: boolean;
     recursive?: boolean;

package/dist/src/fs/listDir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listDir.d.ts","sourceRoot":"","sources":["../../../src/fs/listDir.ts"],"names":[],"mappings":"AAWA,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,4FAA4F;IAC5F,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;;;;;;;;;;;;;GAoDA"}
+{"version":3,"file":"listDir.d.ts","sourceRoot":"","sources":["../../../src/fs/listDir.ts"],"names":[],"mappings":"AAWA,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,4FAA4F;IAC5F,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;;;;;;;;;;;;;GAiDA"}

package/dist/src/fs/listDir.js

@@ -19,10 +19,7 @@ export async function listDir(args) {
     };
     const ctx = getExtensionContext();
     const cfg = overrideWithConfig(defaults, ctx.config);
-    const inputPath = args.path?.trim();
-    if (!inputPath) {
-        throw new Error("path is required");
-    }
+    const inputPath = args.path?.trim() || ".";
     const sandboxRoot = cfg.sandboxRoot ?? "";
     const maxEntries = args.maxEntries ?? cfg.maxEntries ?? defaults.maxEntries;
     const includeHidden = args.includeHidden ?? false;

package/dist/src/fs/listDir.js.map

@@ -1 +1 @@
-{"version":3,"file":"listDir.js","sourceRoot":"","sources":["../../../src/fs/listDir.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"listDir.js","sourceRoot":"","sources":["../../../src/fs/listDir.ts"],"names":[],"mappings":"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"}

package/dist/src/git/common.d.ts

@@ -0,0 +1,34 @@
+export interface GitExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface GitHistoryCommit {
+    hash: string;
+    authorName: string;
+    authorEmail: string;
+    date: string;
+    subject: string;
+    body: string;
+}
+export declare function runProcess(args: {
+    bin: string;
+    cmdArgs: string[];
+    cwd: string;
+    timeoutMs: number;
+    maxOutputBytes: number;
+}): Promise<GitExecResult>;
+export declare function resolveRepoPath(inputPath: string, sandboxRoot: string): Promise<string>;
+export declare function failOnNonZero(command: string, out: GitExecResult): void;
+export declare function parseGitHistory(stdout: string): GitHistoryCommit[];
+export declare function buildGitConfig(): {
+    sandboxRoot: string;
+    gitTimeoutMs: number;
+    gitMaxOutputBytes: number;
+};
+export declare function ensureGhAvailable(args: {
+    cwd: string;
+    timeoutMs: number;
+}): Promise<void>;
+export declare function resolveCwd(repoPath: string): string;
+//# sourceMappingURL=common.d.ts.map

package/dist/src/git/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/git/common.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,aAAa,CAAC,CA0EzB;AAED,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK7F;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAQvE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAiBlE;AAED,wBAAgB,cAAc;;;;EAQ7B;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAehB;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/src/git/common.js

@@ -0,0 +1,119 @@
+import { spawn } from "node:child_process";
+import { resolve as pathResolve } from "node:path";
+import { createTaggedError, resolveSandboxedPath } from "@easynet/agent-tool";
+import { getExtensionContext } from "../../index.js";
+import { overrideWithConfig } from "../util/overrideWithConfig.js";
+import { DEFAULT_GIT_MAX_OUTPUT_BYTES, DEFAULT_GIT_TIMEOUT_MS, } from "./defaults.js";
+export async function runProcess(args) {
+    return new Promise((resolvePromise, rejectPromise) => {
+        const proc = spawn(args.bin, args.cmdArgs, {
+            cwd: args.cwd,
+            shell: false,
+            stdio: ["ignore", "pipe", "pipe"],
+            env: { ...process.env, GIT_PAGER: "cat" },
+        });
+        let stdout = "";
+        let stderr = "";
+        let totalBytes = 0;
+        let settled = false;
+        const failOnce = (err) => {
+            if (settled)
+                return;
+            settled = true;
+            rejectPromise(err);
+        };
+        const doneOnce = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            resolvePromise(value);
+        };
+        const append = (chunk, dest) => {
+            const len = Buffer.byteLength(chunk, "utf-8");
+            if (totalBytes + len > args.maxOutputBytes) {
+                proc.kill("SIGKILL");
+                failOnce(createTaggedError("GIT_OUTPUT_TOO_LARGE", `Git command output exceeded ${args.maxOutputBytes} bytes`, { maxBytes: args.maxOutputBytes }));
+                return;
+            }
+            totalBytes += len;
+            if (dest === "stdout")
+                stdout += chunk;
+            else
+                stderr += chunk;
+        };
+        proc.stdout?.setEncoding("utf-8");
+        proc.stderr?.setEncoding("utf-8");
+        proc.stdout?.on("data", (chunk) => append(chunk, "stdout"));
+        proc.stderr?.on("data", (chunk) => append(chunk, "stderr"));
+        const timer = setTimeout(() => {
+            proc.kill("SIGKILL");
+            failOnce(createTaggedError("GIT_TIMEOUT", `${args.bin} ${args.cmdArgs.join(" ")} timed out after ${args.timeoutMs}ms`, { timeoutMs: args.timeoutMs }));
+        }, args.timeoutMs);
+        proc.on("error", (err) => {
+            clearTimeout(timer);
+            failOnce(createTaggedError("GIT_SPAWN_ERROR", err.message, { command: args.bin }));
+        });
+        proc.on("close", (code) => {
+            clearTimeout(timer);
+            doneOnce({
+                stdout,
+                stderr,
+                exitCode: code ?? 1,
+            });
+        });
+    });
+}
+export async function resolveRepoPath(inputPath, sandboxRoot) {
+    if (!inputPath.trim()) {
+        throw createTaggedError("GIT_INVALID", "path is required", {});
+    }
+    return resolveSandboxedPath(inputPath, sandboxRoot);
+}
+export function failOnNonZero(command, out) {
+    if (out.exitCode !== 0) {
+        throw createTaggedError("GIT_COMMAND_FAILED", `git ${command} failed with exit ${out.exitCode}: ${(out.stderr || out.stdout).slice(0, 500)}`, { exitCode: out.exitCode });
+    }
+}
+export function parseGitHistory(stdout) {
+    return stdout
+        .split("\x1e")
+        .map((s) => s.trim())
+        .filter(Boolean)
+        .map((row) => {
+        const parts = row.split("\x1f");
+        return {
+            hash: parts[0] ?? "",
+            authorName: parts[1] ?? "",
+            authorEmail: parts[2] ?? "",
+            date: parts[3] ?? "",
+            subject: parts[4] ?? "",
+            body: parts[5] ?? "",
+        };
+    })
+        .filter((c) => c.hash !== "");
+}
+export function buildGitConfig() {
+    const defaults = {
+        sandboxRoot: "",
+        gitTimeoutMs: DEFAULT_GIT_TIMEOUT_MS,
+        gitMaxOutputBytes: DEFAULT_GIT_MAX_OUTPUT_BYTES,
+    };
+    const ctx = getExtensionContext();
+    return overrideWithConfig(defaults, ctx.config);
+}
+export async function ensureGhAvailable(args) {
+    const check = await runProcess({
+        bin: "gh",
+        cmdArgs: ["--version"],
+        cwd: pathResolve(args.cwd),
+        timeoutMs: args.timeoutMs,
+        maxOutputBytes: 1024 * 32,
+    }).catch((err) => {
+        throw createTaggedError("GIT_TOOL_MISSING", `GitHub CLI (gh) is required: ${err instanceof Error ? err.message : String(err)}`, {});
+    });
+    failOnNonZero("gh --version", check);
+}
+export function resolveCwd(repoPath) {
+    return pathResolve(repoPath);
+}
+//# sourceMappingURL=common.js.map