tarsk 0.6.87 → 0.6.89

package/dist/bundled-skills/tarsk-execute-skill-script/scripts/execute_skill_script.js

@@ -0,0 +1,77 @@
+/**
+ * execute_skill_script — STDOUT/STDERR / miss copy in the Skill; host holds
+ * permission gate, sandbox, and spawn.
+ */
+
+export const description =
+  "Execute a script from an activated skill. Skills provide executable scripts in their scripts/ directory.";
+
+export const parameters = {
+  type: "object",
+  required: ["skillName", "scriptName"],
+  properties: {
+    skillName: {
+      description: "Name of the skill",
+      type: "string",
+    },
+    scriptName: {
+      description: "Name of the script to execute (without path)",
+      type: "string",
+    },
+    args: {
+      description: "Arguments to pass to the script",
+      type: "array",
+      items: {
+        type: "string",
+      },
+    },
+    timeout: {
+      description: "Timeout in seconds (default: 30)",
+      type: "number",
+    },
+  },
+};
+
+function formatOk(result) {
+  const parts = [];
+  if (result.stdout) {
+    parts.push(`STDOUT:\n${result.stdout}`);
+  }
+  if (result.stderr) {
+    parts.push(`STDERR:\n${result.stderr}`);
+  }
+  parts.push(`Exit code: ${result.exitCode}`);
+  return `${parts.join("\n")}\n`;
+}
+
+function formatError(result) {
+  switch (result.reason) {
+    case "skill_not_found":
+      return `Skill not found: ${result.skillName}. Available skills: ${result.available.join(", ")}`;
+    case "no_scripts":
+      return `Skill '${result.skillName}' has no scripts directory`;
+    case "invalid_path":
+      return `Invalid script path: ${result.scriptName}`;
+    case "script_not_found":
+      return result.available.length > 0
+        ? `Script '${result.scriptName}' not found in skill '${result.skillName}'. Available scripts: ${result.available.join(", ")}`
+        : `Script '${result.scriptName}' not found in skill '${result.skillName}'`;
+    case "cancelled":
+      return "Failed to execute script: Script execution cancelled";
+    case "timeout":
+      return `Failed to execute script: Script execution timed out after ${result.timeoutSeconds}s`;
+    case "execute_error":
+      return `Failed to execute script: ${result.message}`;
+    default:
+      return "Failed to execute script";
+  }
+}
+
+/** @param {Record<string, unknown>} args @param {import("../../../../src/tools/agent-runtime/types.js").AgentRuntime} context @param {{ signal?: AbortSignal, toolCallId?: string }} [options] */
+export async function execute(args, context, options) {
+  const result = await context.skillsCatalog.executeScript(args, options);
+  return {
+    content: [{ type: "text", text: result.ok ? formatOk(result) : formatError(result) }],
+    details: undefined,
+  };
+}

package/dist/bundled-skills/tarsk-fetch/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: tarsk-fetch
+description: >-
+  Tarsk Tool skill publishing: fetch.
+version: 2.0.0
+tools:
+  - fetch
+deferred-tools:
+  - fetch
+disable-model-invocation: true
+---
+
+# tarsk-fetch
+
+Publishes: fetch.
+
+Result JSON in `scripts/fetch.js`. Host `context.web.fetch` (allowlist + extract).
+Progress notices still emit from the host during the request.

package/dist/bundled-skills/tarsk-fetch/scripts/fetch.js

@@ -0,0 +1,38 @@
+/**
+ * fetch — progress/result JSON copy in the Skill; host holds allowlist + extract.
+ */
+
+export const description =
+  "Fetch public HTTP(S) URL; extract/summarize via prompt. Read-only—not for auth/private pages (use MCP/browser). Unknown domains need permission; docs sites pre-approved.";
+
+export const parameters = {
+  type: "object",
+  required: ["url", "prompt"],
+  properties: {
+    url: {
+      description: "HTTP(S) URL to fetch",
+      type: "string",
+    },
+    prompt: {
+      description: "What to extract or summarize",
+      type: "string",
+    },
+  },
+};
+
+/** @param {Record<string, unknown>} args @param {import("../../../../src/tools/agent-runtime/types.js").AgentRuntime} context @param {{ signal?: AbortSignal, onUpdate?: Function, toolCallId?: string }} [options] */
+export async function execute(args, context, options) {
+  const result = await context.web.fetch(args, options);
+  if (result.status === "aborted") {
+    return { content: [], details: undefined };
+  }
+  return {
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify({ ...result.details, result: result.result }),
+      },
+    ],
+    details: result.details,
+  };
+}

package/dist/bundled-skills/tarsk-find/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: tarsk-find
+description: >-
+  Tarsk Tool skill publishing: find.
+version: 2.0.0
+tools:
+  - find
+disable-model-invocation: true
+---
+
+# tarsk-find
+
+Publishes: find.
+
+Formatting lives in `scripts/find.js`. Secure glob (cwd check, home denial,
+ignore list) is `context.fs.glob`; listing compression is `context.util`.

package/dist/bundled-skills/tarsk-find/scripts/find.js

@@ -0,0 +1,78 @@
+/**
+ * find — formatting in the Skill; secure glob via context.fs (host).
+ */
+
+export const description =
+  "Find files by path glob (not file contents; use grep for text). Paths are relative to the search dir. Read the file directly when its path is known. `dir/{a,b}.tsx` is shallow — use `**/` for nested. Grouped as `dir/: file1, file2`. Truncated to 1000 results / 50KB.";
+
+export const parameters = {
+  type: "object",
+  required: ["pattern"],
+  properties: {
+    pattern: {
+      description: "Glob pattern, e.g. '*.ts' or '**/*.json'",
+      type: "string",
+    },
+    path: {
+      description: "Directory to search (default: current directory)",
+      type: "string",
+    },
+    limit: {
+      description: "Maximum results (default: 1000)",
+      type: "number",
+    },
+  },
+};
+
+/** @param {Record<string, unknown>} args @param {import("../../../../src/tools/agent-runtime/types.js").AgentRuntime} context @param {{ signal?: AbortSignal }} [options] */
+export async function execute(args, context, options) {
+  const pattern = String(args.pattern ?? "");
+  const searchDir = typeof args.path === "string" ? args.path : undefined;
+  const limit = typeof args.limit === "number" ? args.limit : undefined;
+
+  const result = await context.util.withAbort(options?.signal, async function runFind() {
+    return context.fs.glob(pattern, {
+      path: searchDir,
+      limit,
+      signal: options?.signal,
+    });
+  });
+
+  if (result.paths.length === 0) {
+    return {
+      content: [{ type: "text", text: "No files found matching pattern" }],
+      details: undefined,
+    };
+  }
+
+  const compressed = context.util.compressFindPaths(result.paths);
+  const truncation = context.util.truncateHead(compressed.text, {
+    maxLines: Number.MAX_SAFE_INTEGER,
+  });
+  let resultOutput = truncation.content;
+  const details = {};
+  const notices = [];
+
+  if (compressed.applied) {
+    resultOutput = `${compressed.banner}\n${resultOutput}`;
+  }
+
+  if (result.resultLimitReached) {
+    notices.push(
+      `${result.limit} results limit reached. Use limit=${result.limit * 2} for more, or refine pattern`,
+    );
+    details.resultLimitReached = result.limit;
+  }
+  if (truncation.truncated) {
+    notices.push(`${context.util.formatSize(context.util.maxBytes)} limit reached`);
+    details.truncation = truncation;
+  }
+  if (notices.length > 0) {
+    resultOutput += `\n\n[${notices.join(". ")}]`;
+  }
+
+  return {
+    content: [{ type: "text", text: resultOutput }],
+    details: Object.keys(details).length > 0 ? details : undefined,
+  };
+}

package/dist/bundled-skills/tarsk-find-images/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: tarsk-find-images
+description: >-
+  Tarsk Tool skill publishing: find_images.
+version: 2.0.0
+tools:
+  - find_images
+deferred-tools:
+  - find_images
+disable-model-invocation: true
+---
+
+# tarsk-find-images
+
+Publishes: find_images.
+
+Success/error copy in `scripts/find_images.js`. Host
+`context.images.searchAndSave` (network + cwd-safe save).

package/dist/bundled-skills/tarsk-find-images/scripts/find_images.js

@@ -0,0 +1,78 @@
+/**
+ * find_images — success/error copy in the Skill; host searches + saves.
+ */
+
+export const description =
+  "Find a stock image matching a search query. Returns a URL served by the Tarsk API and optionally saves the image to a file. " +
+  "Use this when the user needs an image and the user has not requested it be generated.";
+
+export const parameters = {
+  type: "object",
+  required: ["query"],
+  properties: {
+    query: {
+      description: "Image search query, e.g. 'sunset over mountains'",
+      type: "string",
+    },
+    size: {
+      description:
+        "Image size variant: original, large2x, large, medium (default), small, portrait, landscape, tiny",
+      type: "string",
+    },
+    save_to_file: {
+      description:
+        "File path relative to the project root to save the image to (e.g. 'assets/hero.jpg'). " +
+        "Parent directories are created automatically. " +
+        "If omitted the image is saved under .tarsk/tmp-images/.",
+      type: "string",
+    },
+  },
+};
+
+/** @param {Record<string, unknown>} args @param {import("../../../../src/tools/agent-runtime/types.js").AgentRuntime} context @param {{ signal?: AbortSignal }} [options] */
+export async function execute(args, context, options) {
+  const result = await context.images.searchAndSave(args, options);
+  if (!result.ok) {
+    if (result.reason === "aborted") {
+      return { content: [], details: undefined };
+    }
+    if (result.reason === "search_failed") {
+      return {
+        content: [{ type: "text", text: `Image search failed: ${result.message}` }],
+        details: undefined,
+      };
+    }
+    if (result.reason === "no_cwd") {
+      return {
+        content: [
+          {
+            type: "text",
+            text: "Image search succeeded but no project directory is available to save the image.",
+          },
+        ],
+        details: undefined,
+      };
+    }
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Image was found but failed to save to "${result.message}"`,
+        },
+      ],
+      details: undefined,
+    };
+  }
+
+  const payload = {
+    contentType: result.contentType,
+    savedPath: result.savedPath,
+    sizeInBytes: result.sizeInBytes,
+  };
+  if (result.imageUrl) payload.imageUrl = result.imageUrl;
+
+  return {
+    content: [{ type: "text", text: JSON.stringify(payload) }],
+    details: result.imageUrl ? { imageUrl: result.imageUrl } : undefined,
+  };
+}

package/dist/bundled-skills/tarsk-generate-image/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: tarsk-generate-image
+description: >-
+  Tarsk Tool skill publishing: generate_image.
+version: 2.0.0
+tools:
+  - generate_image
+deferred-tools:
+  - generate_image
+disable-model-invocation: true
+---
+
+# tarsk-generate-image
+
+Publishes: generate_image.
+
+Success/error copy in `scripts/generate_image.js`. Host
+`context.images.generate` (API keys + cwd-safe save).

package/dist/bundled-skills/tarsk-generate-image/scripts/generate_image.js

@@ -0,0 +1,55 @@
+/**
+ * generate_image — success/error copy in the Skill; host holds credentials + save.
+ */
+
+export const description =
+  "Generate an image from a text prompt. Returns a URL or base64 data for the generated image. Use this when the user asks you to create, draw, design, or generate an image. Use the save_to_file parameter to save the image directly to a file in the project (e.g. 'assets/hero.png').";
+
+export const parameters = {
+  type: "object",
+  required: ["prompt", "save_to_file"],
+  properties: {
+    prompt: {
+      description: "Image description",
+      type: "string",
+    },
+    model: {
+      description:
+        "Image model name or ID to use (e.g. 'dall-e-3', 'gpt-image-1', 'google/gemini-2.5-flash-image'). If omitted the first enabled image model is used.",
+      type: "string",
+    },
+    save_to_file: {
+      description:
+        "File path (relative to the project root) to save the generated image to, e.g. 'assets/logo.png' or 'docs/diagram.png'. The file and any parent directories will be created automatically. The image is also returned as data so it can be displayed.",
+      type: "string",
+    },
+  },
+};
+
+function stripImageBytes(payload) {
+  const next = { ...payload };
+  delete next.imageData;
+  delete next.image_data;
+  if (typeof next.imageUrl === "string" && next.imageUrl.startsWith("data:")) {
+    delete next.imageUrl;
+  }
+  return next;
+}
+
+/** @param {Record<string, unknown>} args @param {import("../../../../src/tools/agent-runtime/types.js").AgentRuntime} context @param {{ signal?: AbortSignal }} [options] */
+export async function execute(args, context, options) {
+  const result = await context.images.generate(args, options);
+  if (!result.ok) {
+    if (result.reason === "aborted") {
+      return { content: [], details: undefined };
+    }
+    return {
+      content: [{ type: "text", text: result.message }],
+      details: result.details,
+    };
+  }
+  return {
+    content: [{ type: "text", text: JSON.stringify(stripImageBytes(result.payload)) }],
+    details: result.details,
+  };
+}

package/dist/bundled-skills/tarsk-get-observation/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: tarsk-get-observation
+description: >-
+  Tarsk Tool skill publishing: get_observation.
+version: 2.0.2
+tools:
+  - get_observation
+disable-model-invocation: true
+---
+
+# tarsk-get-observation
+
+Publishes: get_observation.
+
+Paging, JSON-path selection, miss/continuation copy, and batching live in
+`scripts/get_observation.js` (edit to tune tokens / turn guidance).
+
+Host (`context.observations`): `resolveId`, `fetch`, `recordRetrieved`, `limits`
+— DB and telemetry only.