tarsk 0.6.87 → 0.6.88

package/dist/bundled-skills/tarsk-jobs/scripts/job_kill.js

@@ -0,0 +1,45 @@
+/**
+ * job_kill — messaging in the Skill; owner-scoped kill via context.jobs (host).
+ */
+
+export const description =
+  "Stop a background job started with bash run_in_background, killing its process tree. A job " +
+  "that already settled has nothing left to kill unless it left a process behind holding its " +
+  "output pipes (a command that backgrounded a daemon); that tree is stopped too.";
+
+export const parameters = {
+  type: "object",
+  required: ["jobId"],
+  properties: {
+    jobId: {
+      type: "string",
+      description: "The job id bash returned when the command was started with run_in_background",
+    },
+  },
+};
+
+function textResult(text) {
+  return { content: [{ type: "text", text }], details: undefined };
+}
+
+function formatJobStatus(job) {
+  return job.exitCode === null ? job.status : `${job.status}, exit ${job.exitCode}`;
+}
+
+/** @param {Record<string, unknown>} args @param {import("../../../../src/tools/agent-runtime/types.js").AgentRuntime} context */
+export async function execute(args, context) {
+  const jobId = String(args.jobId ?? "");
+  const result = context.jobs.kill(jobId);
+  if (!result.ok) {
+    throw new Error(`Unknown job id: ${jobId}`);
+  }
+  if (result.outcome === "nothing_to_kill") {
+    return textResult(`Job ${jobId} had already settled (${result.status}); nothing to kill.`);
+  }
+  if (result.outcome === "stopped_leftover_tree") {
+    return textResult(
+      `Job ${jobId} had already settled (${formatJobStatus(result)}), but left a process running: stopped its tree.`,
+    );
+  }
+  return textResult(`Killed background job ${jobId}.`);
+}

package/dist/bundled-skills/tarsk-jobs/scripts/job_list.js

@@ -0,0 +1,64 @@
+/**
+ * job_list — formatting in the Skill; registry access via context.jobs (host).
+ */
+
+export const description =
+  "List the background jobs started in this session with bash run_in_background: each one's " +
+  "id, status, exit code, start time, and command. Use job_output to read a job's output and " +
+  "job_kill to stop one.";
+
+export const parameters = {
+  type: "object",
+  properties: {},
+};
+
+const JOB_ID_COLUMN_WIDTH = 14;
+const JOB_STATUS_COLUMN_WIDTH = 8;
+const JOB_EXIT_COLUMN_WIDTH = 8;
+const JOB_COMMAND_MAX_LENGTH = 60;
+
+function textResult(text) {
+  return { content: [{ type: "text", text }], details: undefined };
+}
+
+function formatCommand(command) {
+  const oneLine = String(command).replace(/\s+/g, " ").trim();
+  if (oneLine.length <= JOB_COMMAND_MAX_LENGTH) return oneLine;
+  return `${oneLine.slice(0, JOB_COMMAND_MAX_LENGTH - 1)}…`;
+}
+
+function formatJobLine(job) {
+  const exit = job.exitCode === null ? "-" : String(job.exitCode);
+  return [
+    job.id.padEnd(JOB_ID_COLUMN_WIDTH),
+    job.status.padEnd(JOB_STATUS_COLUMN_WIDTH),
+    `exit ${exit}`.padEnd(JOB_EXIT_COLUMN_WIDTH),
+    new Date(job.startedAt).toISOString(),
+    formatCommand(job.command),
+  ].join(" ");
+}
+
+/** @param {unknown} _args @param {import("../../../../src/tools/agent-runtime/types.js").AgentRuntime} context */
+export async function execute(_args, context) {
+  if (!context.jobs.available) {
+    return textResult(
+      "Background jobs are not available in this context. Run the command in the foreground.",
+    );
+  }
+  const jobs = context.jobs.list();
+  if (jobs.length === 0) {
+    return textResult("No background jobs.");
+  }
+  const header = [
+    "id".padEnd(JOB_ID_COLUMN_WIDTH),
+    "status".padEnd(JOB_STATUS_COLUMN_WIDTH),
+    "exit".padEnd(JOB_EXIT_COLUMN_WIDTH),
+    "startedAt",
+    "command",
+  ].join(" ");
+  return textResult(
+    [`${jobs.length} background job(s) in this session:`, header, ...jobs.map(formatJobLine)].join(
+      "\n",
+    ),
+  );
+}

package/dist/bundled-skills/tarsk-jobs/scripts/job_output.js

@@ -0,0 +1,66 @@
+/**
+ * job_output — formatting in the Skill; owner-scoped read via context.jobs.
+ */
+
+export const description =
+  "Read the retained output of a background job started with bash run_in_background. Returns " +
+  "what the job has produced so far — at once, not when the job finishes — so call it again " +
+  "later to see what is new; never `sleep` between reads. Pass offsetLines to page further " +
+  "back instead of the tail. Reports the job's status and the next offset while more output " +
+  "remains.";
+
+export const parameters = {
+  type: "object",
+  required: ["jobId"],
+  properties: {
+    jobId: {
+      type: "string",
+      description: "The job id bash returned when the command was started with run_in_background",
+    },
+    offsetLines: {
+      type: "number",
+      description: "0-based line to start from. Omitted returns the tail of the retained output.",
+    },
+    limitLines: {
+      type: "number",
+      description: "Maximum lines to return (default 200).",
+    },
+  },
+};
+
+function textResult(text) {
+  return { content: [{ type: "text", text }], details: undefined };
+}
+
+function formatJobStatus(job) {
+  return job.exitCode === null ? job.status : `${job.status}, exit ${job.exitCode}`;
+}
+
+/** @param {Record<string, unknown>} args @param {import("../../../../src/tools/agent-runtime/types.js").AgentRuntime} context */
+export async function execute(args, context) {
+  const jobId = String(args.jobId ?? "");
+  const page = context.jobs.readOutput(jobId, {
+    offsetLines: typeof args.offsetLines === "number" ? args.offsetLines : undefined,
+    limitLines: typeof args.limitLines === "number" ? args.limitLines : undefined,
+  });
+  if (!page) {
+    return textResult(`Unknown job id: ${jobId}`);
+  }
+  const firstLine = (page.nextOffset ?? page.totalLines) - page.lines.length;
+  const parts = [
+    `Job ${page.job.id} (${formatJobStatus(page.job)}): ${page.totalLines} retained line(s)`,
+  ];
+  if (page.totalLines > 0) {
+    parts.push(`Lines ${firstLine}-${page.totalLines - 1} of ${page.totalLines}:`);
+  }
+  parts.push(page.lines.length > 0 ? page.lines.join("\n") : "(no output yet)");
+  if (page.truncatedBytes) {
+    parts.push("[Earlier output was dropped as the job's output exceeded the retained tail]");
+  }
+  if (page.nextOffset !== undefined) {
+    parts.push(
+      `[More output: call job_output with jobId=${page.job.id} offsetLines=${page.nextOffset}]`,
+    );
+  }
+  return textResult(parts.join("\n"));
+}

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

@@ -0,0 +1,17 @@
+---
+name: tarsk-notes
+description: >-
+  Project notes storage for the agent. Publishes the notes Tool for durable
+  decisions, constraints, and state across context windows.
+version: 2.0.0
+tools:
+  - notes
+deferred-tools:
+  - notes
+disable-model-invocation: true
+---
+
+# Notes
+
+Publishes the `notes` Tool. Implementation: `scripts/notes.js`. Before editing,
+read the `tarsk-agent` Skill (packaging + `context` API).

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

@@ -0,0 +1,86 @@
+/**
+ * notes Tool — durable project notes via the Agent runtime.
+ */
+
+export const description =
+  "Store durable project notes that survive fresh context windows. Record decisions, constraints, discoveries, and current state that must remain available later. Operations: list note metadata; read a named note in pages using offset; write or replace a note (empty content clears it); append an atomic newline-terminated record; search note names and bounded content excerpts. Keep notes concise, factual, and current.";
+
+export const parameters = {
+  type: "object",
+  properties: {
+    op: {
+      type: "string",
+      enum: ["list", "read", "write", "append", "search"],
+    },
+    name: {
+      type: "string",
+      description: "Note name for read, write, or append",
+    },
+    content: {
+      type: "string",
+      description: "Content for write or append",
+    },
+    query: {
+      type: "string",
+      description: "Text to find for search",
+    },
+    offset: {
+      type: "integer",
+      minimum: 0,
+      description: "Character offset for read",
+    },
+  },
+  required: ["op"],
+};
+
+function textResult(text) {
+  return {
+    content: [{ type: "text", text }],
+    details: undefined,
+  };
+}
+
+function requireValue(value, field) {
+  if (!value?.trim()) {
+    throw new Error(`${field} is required for this operation`);
+  }
+  return value;
+}
+
+/** @param {Record<string, unknown>} args @param {import("../../../../src/tools/agent-runtime/types.js").AgentRuntime} context */
+export async function execute(args, context) {
+  if (!context.projectId) {
+    return textResult("Context notes are unavailable because the project is not resolved.");
+  }
+
+  switch (args.op) {
+    case "list": {
+      const notes = await context.notes.list();
+      return textResult(JSON.stringify(notes));
+    }
+    case "read": {
+      const note = await context.notes.read(requireValue(args.name, "name"), args.offset ?? 0);
+      if (!note) {
+        return textResult("Note not found.");
+      }
+      return textResult(JSON.stringify(note));
+    }
+    case "write": {
+      const note = await context.notes.write(requireValue(args.name, "name"), args.content ?? "");
+      return textResult(note ? JSON.stringify(note) : "Note cleared.");
+    }
+    case "append": {
+      const note = await context.notes.append(
+        requireValue(args.name, "name"),
+        requireValue(args.content, "content"),
+      );
+      return textResult(JSON.stringify(note));
+    }
+    case "search": {
+      const notes = await context.notes.search(requireValue(args.query, "query"));
+      return textResult(JSON.stringify(notes));
+    }
+    default:
+      throw new Error(`Unknown notes op: ${String(args.op)}`);
+  }
+}

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

@@ -0,0 +1,18 @@
+---
+name: tarsk-projects
+description: >-
+  Tarsk Tool skill publishing: projects.
+version: 2.0.0
+tools:
+  - projects
+deferred-tools:
+  - projects
+disable-model-invocation: true
+---
+
+# tarsk-projects
+
+Publishes: projects.
+
+Error copy and JSON wrapping live in `scripts/projects.js`. Host
+`context.projects.query` returns structured data (DB / cross-project managers).

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

@@ -0,0 +1,54 @@
+/**
+ * projects — model copy / JSON wrap in the Skill; host returns structured data.
+ */
+
+export const description =
+  "List Projects (agents)\n  (Threads, git status, processing, Conversation ids, hasLaunchModel, url).\n   Always returns immediately. Pass projectId alone to filter; \n   pass projectId+threadId+conversationId together to read a Conversation snapshot.\n   Each Conversation includes url, a tarsk://chat deep link. Present it to the\n   human as a markdown link (not inline code) so they can open that chat.";
+
+export const parameters = {
+  type: "object",
+  properties: {
+    includeConversationHistory: {
+      description: "When true, list every Conversation on each Thread; default is Current only",
+      type: "boolean",
+    },
+    projectId: {
+      description:
+        "Alone (or with includeConversationHistory): filter the list to this Local Project. With threadId+conversationId: fetch that Conversation's current status and replies.",
+      type: "string",
+    },
+    threadId: {
+      description: "With projectId + conversationId, fetch Conversation replies",
+      type: "string",
+    },
+    conversationId: {
+      description: "With projectId + threadId, fetch Conversation replies",
+      type: "string",
+    },
+    waitMs: {
+      description: "Ignored. Get Projects always returns immediately. Do not pass this.",
+      type: "number",
+    },
+  },
+};
+
+const INCOMPLETE_IDS =
+  "Error: to fetch a Conversation after prompt_project, pass projectId, threadId, and conversationId together (copy the three ids from the prompt_project result). To list or filter projects, pass projectId alone (optional includeConversationHistory) without threadId/conversationId.";
+
+/** @param {Record<string, unknown>} args @param {import("../../../../src/tools/agent-runtime/types.js").AgentRuntime} context */
+export async function execute(args, context) {
+  try {
+    const data = await context.projects.query(args);
+    return {
+      content: [{ type: "text", text: JSON.stringify(data) }],
+      details: undefined,
+    };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const text = message === "INCOMPLETE_CONVERSATION_IDS" ? INCOMPLETE_IDS : `Error: ${message}`;
+    return {
+      content: [{ type: "text", text }],
+      details: undefined,
+    };
+  }
+}

package/dist/bundled-skills/tarsk-prompt-project/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: tarsk-prompt-project
+description: >-
+  Tarsk Tool skill publishing: prompt_project.
+version: 2.0.0
+tools:
+  - prompt_project
+deferred-tools:
+  - prompt_project
+disable-model-invocation: true
+---
+
+# tarsk-prompt-project
+
+Publishes: prompt_project.
+
+JSON / error formatting in `scripts/prompt_project.js`. Host
+`context.projects.launch` runs cross-project delivery.

package/dist/bundled-skills/tarsk-prompt-project/scripts/prompt_project.js

@@ -0,0 +1,58 @@
+/**
+ * prompt_project — JSON / error copy in the Skill; host launches only.
+ */
+
+export const description =
+  "Send a prompt to another Project (an agent with its own skills & tools).\n   Deliver the prompt and start the target agent without waiting. A later Cross-project reply is delivered to this Conversation when the target’s first turn ends. Origin wake is on by default (this agent runs after the reply); set wake=false for fire-and-forget.\n   Omit threadId to continue the Cross-project route for this Conversation and the target Project: the Thread this Conversation already prompts on that Project, or a new Thread (new branch) when there is none. New Chat resets the route. Pass freshThread: true to deliberately start a new Thread and move the route to it, or pass an explicit threadId to pin one (it also updates the route).\n   Returns ids, url, createdThread, createdConversation, and isProcessing. The conversationId uniquely identifies this launch.";
+
+export const parameters = {
+  type: "object",
+  required: ["projectId", "prompt"],
+  properties: {
+    projectId: {
+      description: "Target Local Project id (not the Current Project)",
+      type: "string",
+    },
+    prompt: {
+      description: "User message to send in a new Conversation on the target Thread",
+      type: "string",
+    },
+    threadId: {
+      description:
+        "Existing Thread id to pin this launch to; also updates the Cross-project route. Omit to continue the route: the Thread this Conversation already prompts on the Project, or a new Thread when there is none.",
+      type: "string",
+    },
+    freshThread: {
+      description:
+        "Deliberately start a NEW Thread on the Project and move this Conversation's route to it, even though a route already exists. Omit threadId when using this.",
+      type: "boolean",
+    },
+    wake: {
+      description:
+        "When true (default), delivering the Cross-project reply starts an Origin wake turn. Set false for fire-and-forget: the human still sees the reply, the origin agent does not run.",
+      type: "boolean",
+    },
+    label: {
+      description:
+        "Optional readable name for this launch so sibling launches to the same Project are easy to tell apart. The target Conversation id is still the correlator.",
+      type: "string",
+    },
+  },
+};
+
+/** @param {Record<string, unknown>} args @param {import("../../../../src/tools/agent-runtime/types.js").AgentRuntime} context */
+export async function execute(args, context) {
+  try {
+    const data = await context.projects.launch(args);
+    return {
+      content: [{ type: "text", text: JSON.stringify(data) }],
+      details: undefined,
+    };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+      content: [{ type: "text", text: `Error: ${message}` }],
+      details: undefined,
+    };
+  }
+}

package/dist/bundled-skills/tarsk-propose-branch/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: tarsk-propose-branch
+description: >-
+  Tarsk Tool skill publishing: propose_branch.
+version: 2.0.0
+tools:
+  - propose_branch
+disable-model-invocation: true
+---
+
+# tarsk-propose-branch
+
+Publishes: propose_branch.
+
+Execute logic lives entirely in `scripts/propose_branch.js` (no host API).
+The Slack bridge reads `details.summary` / `details.fixPrompt` from the result.

package/dist/bundled-skills/tarsk-propose-branch/scripts/propose_branch.js

@@ -0,0 +1,45 @@
+/**
+ * propose_branch — logic entirely in the Skill (Slack bridge reads details).
+ */
+
+export const description =
+  "Propose creating an isolated git branch so code can be changed. Use when the user wants a fix or edit that requires write tools. Do not claim you can edit files yourself — call this tool, then wait for their Create branch / Keep chatting choice in Slack.";
+
+export const parameters = {
+  type: "object",
+  required: ["summary", "fixPrompt"],
+  properties: {
+    summary: {
+      description:
+        "Short Slack-facing explanation of the change you want to make (1–3 sentences). Shown with the Create branch confirmation.",
+      type: "string",
+    },
+    fixPrompt: {
+      description:
+        "The full prompt that should run on the new isolated branch after the user confirms Create branch. Include enough detail to implement the fix without the plan-chat transcript.",
+      type: "string",
+    },
+  },
+};
+
+/** @param {Record<string, unknown>} args */
+export async function execute(args) {
+  const summary = String(args.summary ?? "");
+  const fixPrompt = String(args.fixPrompt ?? "");
+  return {
+    content: [
+      {
+        type: "text",
+        text: [
+          "Confirmation posted to Slack (Create branch / Keep chatting).",
+          "Do not attempt edits. End your turn and wait — if they confirm, a separate full-tools turn will run the fix prompt on a new branch.",
+          `Summary: ${summary}`,
+        ].join("\n"),
+      },
+    ],
+    details: {
+      summary,
+      fixPrompt,
+    },
+  };
+}

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

@@ -0,0 +1,17 @@
+---
+name: tarsk-read
+description: >-
+  Tarsk Tool skill publishing: read.
+version: 3.1.2
+tools:
+  - read
+disable-model-invocation: true
+---
+
+# tarsk-read
+
+Publishes: read.
+
+Listing / footnote / unchanged copy in `scripts/read.js`. Host
+`context.fs.read` returns structured data (cwd checks, image/pdf gates,
+unchanged-cache). Selection (`select`) returns `{ status: "raw" }`.