@cursor/july 0.1.109 → 0.1.112

package/dist/extensions/cursor-cloud-agents/lib/fleet.js

@@ -77,7 +77,7 @@ export function listFleet(ctx_1) {
         const entries = fleet.success ? fleet.data : [];
         return scope === "all"
             ? entries
-            : entries.filter((entry) => entry.sessionId === ctx.session.id);
+            : entries.filter(entry => entry.sessionId === ctx.session.id);
     });
 }
 function fleetKey(principal) {

package/dist/extensions/cursor-cloud-agents/lib/repos.js

@@ -8,7 +8,7 @@
 import { parsePrUrl } from "../../../internal/scm/pr-url.js";
 export function launchRepos(target, cloud) {
     var _a, _b;
-    var _c, _d, _e, _f, _g;
+    var _c, _d, _e, _f, _g, _h;
     if (target.repo === undefined &&
         target.ref === undefined &&
         target.prUrl === undefined) {
@@ -30,7 +30,7 @@ export function launchRepos(target, cloud) {
     if (prRepo !== undefined && repoKey(prRepo) !== repoKey(url)) {
         throw new Error(`prUrl ${target.prUrl} is not a pull request of ${url}.`);
     }
-    const allowlisted = (_b = cloud.repos) === null || _b === void 0 ? void 0 : _b.some((configured) => repoKey(configured.url) === repoKey(url));
+    const allowlisted = (_b = cloud.repos) === null || _b === void 0 ? void 0 : _b.some(configured => repoKey(configured.url) === repoKey(url));
     if (allowlisted !== true) {
         throw new Error(cloud.repos === undefined
             ? `Configure cloud.repos before launching against a model-chosen repository (${url}).`
@@ -39,12 +39,12 @@ export function launchRepos(target, cloud) {
     // Keep the matching allowlist entry's branch / PR defaults when the model
     // only names the repository (handoff always passes `repo`). An explicit
     // `ref` clears an inherited `prUrl` so branch and PR targets do not mix.
-    const match = configured.find((configuredRepo) => repoKey(configuredRepo.url) === repoKey(url));
+    const match = configured.find(configuredRepo => repoKey(configuredRepo.url) === repoKey(url));
     return [
         {
-            url,
-            startingRef: (_f = target.ref) !== null && _f !== void 0 ? _f : match === null || match === void 0 ? void 0 : match.startingRef,
-            prUrl: (_g = target.prUrl) !== null && _g !== void 0 ? _g : (target.ref !== undefined ? undefined : match === null || match === void 0 ? void 0 : match.prUrl),
+            url: (_f = match === null || match === void 0 ? void 0 : match.url) !== null && _f !== void 0 ? _f : url,
+            startingRef: (_g = target.ref) !== null && _g !== void 0 ? _g : match === null || match === void 0 ? void 0 : match.startingRef,
+            prUrl: (_h = target.prUrl) !== null && _h !== void 0 ? _h : (target.ref !== undefined ? undefined : match === null || match === void 0 ? void 0 : match.prUrl),
         },
     ];
 }

package/dist/extensions/cursor-cloud-agents/lib/transcript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/transcript.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAEvE;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,MAAM,GAAG,SAAS,CAMpB"}
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-cloud-agents/lib/transcript.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAEvE;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,iBAAiB,EAAE,GAC5B,MAAM,GAAG,SAAS,CAKpB"}

package/dist/extensions/cursor-cloud-agents/lib/transcript.js

@@ -4,12 +4,12 @@ export function transcriptPath(agentId) {
     return `cloud-agent-transcripts/${agentId}.jsonl`;
 }
 export function transcriptLines(messages) {
-    return messages.map((message) => JSON.stringify(message));
+    return messages.map(message => JSON.stringify(message));
 }
 /** The text of the last assistant message, the agent's report. */
 export function lastAssistantText(messages) {
     var _a;
     return (_a = messages
         .toReversed()
-        .find((message) => message.role === "assistant" && message.text !== undefined)) === null || _a === void 0 ? void 0 : _a.text;
+        .find(message => message.role === "assistant" && message.text !== undefined)) === null || _a === void 0 ? void 0 : _a.text;
 }

package/dist/extensions/cursor-cloud-agents/skills/handoff.md

@@ -16,17 +16,13 @@ The result carries `agentId` (`bc-...`) and a `url`. Report both in full. Never
 
 ## Look an agent up by id
 
-Call `get` with the `agent_id`. It returns the agent's `status` (`creating`, `running`, `finished`, `error`, or `expired`), its `branch` and pull request `prUrl` once pushed, the `changes` it made so far (files and lines), a `summary` when one exists, and an `error` when it failed. A run takes minutes: check when asked or when you need the result, not in a tight loop. The final report itself comes from `dump`.
+Call `get` with the `agent_id`. It returns the agent's `status` (`creating`, `running`, `finished`, `error`, `expired`, or `unknown`), its `branch` and pull request `prUrl` once pushed, change counts, a `summary` when one exists, and an `error` when it failed. A run takes minutes: check when asked or when you need the result, not in a tight loop. The final report itself comes from `dump`.
 
 ## Read what it did
 
-To read the report or understand what was done, call `dump` with the `agent_id`. It writes the agent's whole conversation, every run, to `cloud-agent-transcripts/<agent_id>.jsonl` in your workspace and returns the absolute `path` plus the `finalMessage`. Each line is one JSON message with `role` (`user` or `assistant`) and, for assistant lines, `text`, `thinking`, and `toolCalls` (tool `name`, `args`, `content`, `error`). Read it with your file and shell tools, using the returned path:
+To read the report or understand what was done, call `dump` with the `agent_id`. Once a transcript exists, it writes the agent's whole conversation to `cloud-agent-transcripts/<agent_id>.jsonl` in your workspace and returns the absolute `path` plus `finalMessage`. Before any transcript exists, either value may be absent; wait for output instead of inventing a report.
 
-- `tail -n 1 <path>` gives the final report.
-- `grep '"toolCalls"' <path>` shows the commands and edits it made.
-- `grep '"role":"user"' <path>` shows every prompt it received, including replies.
-
-Use `dump` before summarizing an agent's work for a person, and to understand a failure before replying with a fix.
+Use `finalMessage` as the agent's report. Read the returned transcript path when you need its prompts, reasoning, or tool calls, then inspect the resulting branch or pull request before claiming exact code changes. The transcript is evidence of what the agent did, not a canonical diff.
 
 ## Reply
 

package/dist/extensions/cursor-cloud-agents/tools/list.js

@@ -28,7 +28,7 @@ const list = defineTool({
                 sessionId: ctx.session.id,
                 agents: fleet
                     .slice(0, input.limit)
-                    .map((entry) => (Object.assign(Object.assign({}, entry), { url: agentUrl(entry.agentId) }))),
+                    .map(entry => (Object.assign(Object.assign({}, entry), { url: agentUrl(entry.agentId) }))),
             };
         });
     },

package/dist/extensions/improve/extension.d.ts

@@ -3,7 +3,9 @@
  * repository, so changing how it behaves is a change to that source: a
  * one-off Cursor cloud agent does the coding on a branch and opens a pull
  * request, the agent that mounted this writes the brief and reports the
- * pull request, and the tree it runs from is never edited.
+ * pull request. Durable behavior changes only after review, merge, and
+ * deployment. A cloud-runtime turn may edit its ephemeral checkout while
+ * preparing the pull request.
  *
  * ```ts
  * // agent/extensions/improve.ts

package/dist/extensions/improve/extension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/extensions/improve/extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,+FAA+F;IAC/F,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,uGAAuG;IACvG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gGAAgG;IAChG,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,yGAAyG;IACzG,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,QAAA,MAAM,OAAO,EAAE,SAAS,CAAC,aAAa,EAAE,cAAc,CAgBpD,CAAC;eAEY,OAAO"}
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/extensions/improve/extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,+FAA+F;IAC/F,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,uGAAuG;IACvG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gGAAgG;IAChG,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,yGAAyG;IACzG,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,QAAA,MAAM,OAAO,EAAE,SAAS,CAAC,aAAa,EAAE,cAAc,CAgBpD,CAAC;eAEY,OAAO"}

package/dist/extensions/improve/extension.js

@@ -3,7 +3,9 @@
  * repository, so changing how it behaves is a change to that source: a
  * one-off Cursor cloud agent does the coding on a branch and opens a pull
  * request, the agent that mounted this writes the brief and reports the
- * pull request, and the tree it runs from is never edited.
+ * pull request. Durable behavior changes only after review, merge, and
+ * deployment. A cloud-runtime turn may edit its ephemeral checkout while
+ * preparing the pull request.
  *
  * ```ts
  * // agent/extensions/improve.ts
@@ -27,7 +29,7 @@ import { defineExtension } from "../../extensions.js";
 const line = z.string().trim().min(1);
 const improve = defineExtension({
     root: import.meta.dirname,
-    description: "Change your own source through a one-off cloud agent and a pull request, never the running tree.",
+    description: "Propose changes to your own source through a branch and pull request; durable behavior changes after review and deployment.",
     config: z.object({
         repo: z.string().url(),
         path: z

package/dist/extensions/improve/skills/yourself.js

@@ -3,7 +3,7 @@ import extension from "../extension.js";
 const { repo, path, ref, notes, deploy } = extension.config;
 const treeNotes = notes.length === 0
     ? ""
-    : `\nAbout this tree in particular; copy these into the brief verbatim:\n\n${notes.map((note) => `- ${note}`).join("\n")}\n`;
+    : `\nAbout this tree in particular; copy these into the brief verbatim:\n\n${notes.map(note => `- ${note}`).join("\n")}\n`;
 const yourself = defineSkill({
     description: "Change your own source (instructions, skills, tools, channels, connections, model, deployment) through a one-off Cursor cloud agent and a pull request. Use whenever the ask is about how you yourself behave, including adding or editing a skill, so the change lands in the repository instead of the tree you happen to be running from.",
     markdown: `# Improve yourself
@@ -23,7 +23,7 @@ Under \`${path}/agent/\`:
 ${treeNotes}
 ## The change is made on a clean checkout
 
-Never edit the tree you run from: it is a deployed copy of \`${path}\`, and nothing changed there lasts. The change is made on a clean checkout of ${repo} at \`${ref}\`. When your own turn runs on a cloud VM with that repository checked out, that VM is the checkout: branch there. Otherwise hand the coding to a one-off Cursor cloud agent through the cloud agents extension, with \`launch\` under its mount namespace, \`repo\` set to ${repo}, and \`starting_ref\` to \`${ref}\`. One agent per change; steer it with \`reply\` rather than launching another.
+Durable source changes happen on a branch from a clean checkout of ${repo} at \`${ref}\`, never by mutating a deployed local-runtime copy. When your own turn runs on a cloud VM with that repository checked out, its ephemeral tree is the checkout: branch there. Otherwise hand the coding to a one-off Cursor cloud agent through the cloud agents extension, with \`launch\` under its mount namespace, \`repo\` set to ${repo}, and \`starting_ref\` to \`${ref}\`. One agent per change; steer it with \`reply\` instead of launching another.
 
 ## The brief
 

package/dist/extensions/slack-communication/extension.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tools and voice so an agent can own Slack outbound in agentic mode.
+ *
+ * ```ts
+ * // agent/extensions/slack.ts
+ * import slackCommunication from "@cursor/july/extensions/slack-communication";
+ *
+ * export default slackCommunication();
+ * // export default slackCommunication({ tone: "Lead with the merge decision." });
+ * ```
+ *
+ * Pair with `slackChannel({ reply: { mode: "agentic" } })`. The channel
+ * acks the parent (`reply.ack`, default `eyes`) and paints the status
+ * chip from turn hooks and `actions.requested` (not model `set-status`).
+ * It watches `post-update`,
+ * `post-file`, `post-card`, `react`, `edit-message`, and
+ * `delete-message` (bare or `<namespace>__<name>`) and renders them
+ * through the channel Slack client. The tools do not call Slack.
+ * `post-update` returns a ts for edit and delete.
+ */
+import type { Extension } from "../../types.js";
+export interface SlackCommunicationOptions {
+    /** Extra voice, appended to `slack-voice`. */
+    tone?: string;
+}
+declare const slackCommunication: Extension<SlackCommunicationOptions, SlackCommunicationOptions | undefined>;
+export default slackCommunication;
+//# sourceMappingURL=extension.d.ts.map

package/dist/extensions/slack-communication/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/extensions/slack-communication/extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,yBAAyB;IACxC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,QAAA,MAAM,kBAAkB,EAAE,SAAS,CACjC,yBAAyB,EACzB,yBAAyB,GAAG,SAAS,CAUrC,CAAC;eAEY,kBAAkB"}

package/dist/extensions/slack-communication/extension.js

@@ -0,0 +1,32 @@
+/**
+ * Tools and voice so an agent can own Slack outbound in agentic mode.
+ *
+ * ```ts
+ * // agent/extensions/slack.ts
+ * import slackCommunication from "@cursor/july/extensions/slack-communication";
+ *
+ * export default slackCommunication();
+ * // export default slackCommunication({ tone: "Lead with the merge decision." });
+ * ```
+ *
+ * Pair with `slackChannel({ reply: { mode: "agentic" } })`. The channel
+ * acks the parent (`reply.ack`, default `eyes`) and paints the status
+ * chip from turn hooks and `actions.requested` (not model `set-status`).
+ * It watches `post-update`,
+ * `post-file`, `post-card`, `react`, `edit-message`, and
+ * `delete-message` (bare or `<namespace>__<name>`) and renders them
+ * through the channel Slack client. The tools do not call Slack.
+ * `post-update` returns a ts for edit and delete.
+ */
+import { z } from "zod";
+import { defineExtension } from "../../extensions.js";
+const slackCommunication = defineExtension({
+    root: import.meta.dirname,
+    description: "Tools and voice so an agent can own Slack outbound when the channel is agentic.",
+    config: z
+        .object({
+        tone: z.string().trim().min(1).optional(),
+    })
+        .default({}),
+});
+export default slackCommunication;

package/dist/extensions/slack-communication/skills/slack-voice.d.ts

@@ -0,0 +1,5 @@
+import type { SkillDefinition } from "../../../types.js";
+export declare const DEFAULT_VOICE: string;
+declare const slackVoice: SkillDefinition;
+export default slackVoice;
+//# sourceMappingURL=slack-voice.d.ts.map

package/dist/extensions/slack-communication/skills/slack-voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-voice.d.ts","sourceRoot":"","sources":["../../../../src/extensions/slack-communication/skills/slack-voice.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,eAAO,MAAM,aAAa,EAAE,MA0C3B,CAAC;AAGF,QAAA,MAAM,UAAU,EAAE,eAMhB,CAAC;eAEY,UAAU"}

package/dist/extensions/slack-communication/skills/slack-voice.js

@@ -0,0 +1,54 @@
+import { prompt } from "../../../prompt.js";
+import { defineSkill } from "../../../skills.js";
+import extension from "../extension.js";
+export const DEFAULT_VOICE = prompt `
+  # Slack voice
+
+  You own this thread. Humans only see what you post through the Slack tools.
+
+  Lead with the result. Write complete sentences. Do not narrate every tool call.
+
+  The channel acks the parent and paints thinking on the status chip. Do not react to ack. Do not set-status for thinking.
+
+  If the turn will take more than a glance, a one-line post-update is the first tool, before investigation.
+
+  A multi-step investigate also posts the dead-end or widen and the breakthrough. Open plus a late dump is not enough. Tools stay off the thread. The channel paints them on the chip.
+
+  ## post-update
+
+  A new message in the thread. Mid-turn: when the picture changed and a reader should know. Final: a new message. Do not rewrite a previous line. The result includes ts. Pass that ts to edit-message or delete-message.
+
+  ## post-card
+
+  A collapsible task card (id, title, details, status). Same id updates in place. That is progress. Do not use it as the reply.
+
+  ## post-file
+
+  Attach a workspace file to the reply. Evidence, not text you could have written.
+
+  ## react
+
+  Emoji on a message ts. Omit ts to react to the thread root. Later reactions for a real reason. The channel already acked.
+
+  ## set-status
+
+  The channel owns the thinking chip. Do not write thinking here.
+
+  ## edit-message
+
+  Correct a fact already posted (wrong number, wrong link). ts is the one post-update returned. Not a narrative rewrite.
+
+  ## delete-message
+
+  A message this turn just posted that is wrong (duplicate, secret, wrong thread). ts is the one post-update returned. Short reason. Never delete to clean up progress. Never delete someone else's message.
+
+  Do not also write the reply as assistant text. The channel ignores that in agentic mode.
+`;
+const tone = extension.config.tone;
+const slackVoice = defineSkill({
+    description: "How to write Slack updates in this thread.",
+    markdown: tone === undefined || tone === ""
+        ? DEFAULT_VOICE
+        : `${DEFAULT_VOICE}\n\n${tone}`,
+});
+export default slackVoice;

package/dist/extensions/slack-communication/tools/delete-message.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../../../types.js";
+declare const deleteMessage: ToolDefinition;
+export default deleteMessage;
+//# sourceMappingURL=delete-message.d.ts.map

package/dist/extensions/slack-communication/tools/delete-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-message.d.ts","sourceRoot":"","sources":["../../../../src/extensions/slack-communication/tools/delete-message.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,QAAA,MAAM,aAAa,EAAE,cAqBnB,CAAC;eAEY,aAAa"}

package/dist/extensions/slack-communication/tools/delete-message.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { has } from "../../../channels/slack/agentic-posted.js";
+import { MAX_REASON_CHARS } from "../../../channels/slack/agentic-signals.js";
+import { defineTool } from "../../../tools.js";
+const INVALID_ARGUMENTS_MESSAGE = "delete-message needs a ts this turn posted and a short reason.";
+const FOREIGN_TS = "ts is not a message this turn posted";
+const deleteMessage = defineTool({
+    description: [
+        "Delete a message this turn just posted that is wrong (duplicate, secret, wrong thread).",
+        "ts is the one post-update returned. Never someone else's message.",
+        "Never delete to clean up progress.",
+        "The channel watching this turn deletes it.",
+    ].join(" "),
+    inputSchema: z.object({
+        ts: z.string().trim().min(1, INVALID_ARGUMENTS_MESSAGE),
+        reason: z
+            .string()
+            .trim()
+            .min(1, INVALID_ARGUMENTS_MESSAGE)
+            .max(MAX_REASON_CHARS, INVALID_ARGUMENTS_MESSAGE),
+    }),
+    execute: ({ ts, reason }, ctx) => {
+        if (!has(ctx.session.id, ts)) {
+            return FOREIGN_TS;
+        }
+        return { ts, reason };
+    },
+});
+export default deleteMessage;

package/dist/extensions/slack-communication/tools/edit-message.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../../../types.js";
+declare const editMessage: ToolDefinition;
+export default editMessage;
+//# sourceMappingURL=edit-message.d.ts.map

package/dist/extensions/slack-communication/tools/edit-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-message.d.ts","sourceRoot":"","sources":["../../../../src/extensions/slack-communication/tools/edit-message.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,QAAA,MAAM,WAAW,EAAE,cA6BjB,CAAC;eAEY,WAAW"}

package/dist/extensions/slack-communication/tools/edit-message.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { has } from "../../../channels/slack/agentic-posted.js";
+import { MAX_UPDATE_CHARS } from "../../../channels/slack/agentic-signals.js";
+import { defineTool } from "../../../tools.js";
+const INVALID_ARGUMENTS_MESSAGE = "edit-message needs a ts this turn posted and a non-empty message.";
+const FOREIGN_TS = "ts is not a message this turn posted";
+const editMessage = defineTool({
+    description: [
+        "Correct a fact on a message this turn already posted (wrong number, wrong link).",
+        "ts is the one post-update returned. Not a rewrite of the reply.",
+        "The channel watching this turn applies the edit.",
+    ].join(" "),
+    inputSchema: z.object({
+        ts: z.string().trim().min(1, INVALID_ARGUMENTS_MESSAGE),
+        message: z
+            .string({
+            required_error: INVALID_ARGUMENTS_MESSAGE,
+            invalid_type_error: INVALID_ARGUMENTS_MESSAGE,
+        })
+            .min(1, INVALID_ARGUMENTS_MESSAGE)
+            .superRefine((message, ctx) => {
+            if (message.length > MAX_UPDATE_CHARS) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: `size (${message.length}) is more than ${MAX_UPDATE_CHARS}-character limit. drop what the reader would not act on and try again`,
+                });
+            }
+        }),
+    }),
+    execute: ({ ts, message }, ctx) => {
+        if (!has(ctx.session.id, ts)) {
+            return FOREIGN_TS;
+        }
+        return { ts, message };
+    },
+});
+export default editMessage;

package/dist/extensions/slack-communication/tools/post-card.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../../../types.js";
+declare const postCard: ToolDefinition;
+export default postCard;
+//# sourceMappingURL=post-card.d.ts.map

package/dist/extensions/slack-communication/tools/post-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-card.d.ts","sourceRoot":"","sources":["../../../../src/extensions/slack-communication/tools/post-card.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,QAAA,MAAM,QAAQ,EAAE,cAqBd,CAAC;eAEY,QAAQ"}

package/dist/extensions/slack-communication/tools/post-card.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { defineTool } from "../../../tools.js";
+const postCard = defineTool({
+    description: [
+        "Publish or update a collapsible task card in the thread.",
+        "Same id updates the same card. That is progress.",
+        "status is pending, in_progress, complete, or error.",
+        "Use a card for work that should stay on screen and change.",
+        "Do not use it as the reply; that is post-update.",
+        "The tool records nothing. The channel watching this turn renders the card.",
+    ].join(" "),
+    inputSchema: z.object({
+        id: z.string().trim().min(1),
+        title: z.string().trim().min(1),
+        status: z.enum(["pending", "in_progress", "complete", "error"]),
+        details: z.string().trim().min(1).optional(),
+    }),
+    execute: ({ id, title, status, details }) => ({
+        id,
+        title,
+        status,
+        details,
+    }),
+});
+export default postCard;

package/dist/extensions/slack-communication/tools/post-file.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../../../types.js";
+declare const postFile: ToolDefinition;
+export default postFile;
+//# sourceMappingURL=post-file.d.ts.map

package/dist/extensions/slack-communication/tools/post-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-file.d.ts","sourceRoot":"","sources":["../../../../src/extensions/slack-communication/tools/post-file.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA6BxD,QAAA,MAAM,QAAQ,EAAE,cAiDd,CAAC;eAEY,QAAQ"}

package/dist/extensions/slack-communication/tools/post-file.js

@@ -0,0 +1,76 @@
+import { realpathSync, statSync } from "node:fs";
+import { basename, extname, isAbsolute, sep } from "node:path";
+import { z } from "zod";
+import { defineTool } from "../../../tools.js";
+const ALLOWED = new Set([
+    ".png",
+    ".jpg",
+    ".jpeg",
+    ".gif",
+    ".webp",
+    ".svg",
+    ".pdf",
+    ".html",
+    ".txt",
+    ".log",
+    ".json",
+    ".csv",
+    ".md",
+    ".mp4",
+    ".mov",
+    ".webm",
+]);
+const MAX_BYTES = 50 * 1024 * 1024;
+function human(bytes) {
+    return bytes < 1024 * 1024
+        ? `${Math.round(bytes / 1024)} KB`
+        : `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+const postFile = defineTool({
+    description: [
+        "Attach a file to the final reply.",
+        "Nothing is posted when you call this: the file is staged, and everything",
+        "staged is uploaded once, after the reply.",
+        "Use it for evidence worth keeping, not for text you could write in the reply.",
+    ].join(" "),
+    inputSchema: z.object({
+        path: z
+            .string()
+            .min(1)
+            .describe("Absolute path to the file. Relative paths are rejected: this runs on the host, not in the agent shell."),
+    }),
+    execute: ({ path }, ctx) => {
+        if (!isAbsolute(path)) {
+            return `Refused: "${path}" is not absolute. Give the full path.`;
+        }
+        let realPath;
+        try {
+            realPath = realpathSync(path);
+        }
+        catch (_a) {
+            return `No such file: ${path}`;
+        }
+        const workspaceRoot = realpathSync(ctx.workspaceDir);
+        if (realPath !== workspaceRoot &&
+            !realPath.startsWith(`${workspaceRoot}${sep}`)) {
+            return `Refused: ${path} is outside ${ctx.workspaceDir}. Copy it into your workspace first.`;
+        }
+        const extension = extname(realPath).toLowerCase();
+        if (!ALLOWED.has(extension)) {
+            return `Refused: ${extension || "no extension"} is not a type Slack renders. Allowed: ${[...ALLOWED].join(", ")}.`;
+        }
+        const info = statSync(realPath);
+        if (!info.isFile()) {
+            return `Refused: ${path} is not a file.`;
+        }
+        if (info.size > MAX_BYTES) {
+            return `Refused: ${human(info.size)} is over the ${human(MAX_BYTES)} upload cap.`;
+        }
+        return {
+            path: realPath,
+            name: basename(realPath),
+            workspace: workspaceRoot,
+        };
+    },
+});
+export default postFile;

package/dist/extensions/slack-communication/tools/post-update.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../../../types.js";
+declare const postUpdate: ToolDefinition;
+export default postUpdate;
+//# sourceMappingURL=post-update.d.ts.map

package/dist/extensions/slack-communication/tools/post-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-update.d.ts","sourceRoot":"","sources":["../../../../src/extensions/slack-communication/tools/post-update.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKxD,QAAA,MAAM,UAAU,EAAE,cA6BhB,CAAC;eAEY,UAAU"}

package/dist/extensions/slack-communication/tools/post-update.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import { reserve } from "../../../channels/slack/agentic-posted.js";
+import { MAX_UPDATE_CHARS } from "../../../channels/slack/agentic-signals.js";
+import { defineTool } from "../../../tools.js";
+const INVALID_ARGUMENTS_MESSAGE = "post-update needs a non-empty message string.";
+const postUpdate = defineTool({
+    description: [
+        "Post a new message in this thread.",
+        "Mid-turn: when the picture changed and a reader should know.",
+        "Final: a new message. Do not rewrite a previous line.",
+        "If the turn will take more than a glance, call this first.",
+        "The result includes ts. Pass that ts to edit-message or delete-message.",
+        "The channel watching this turn posts the message.",
+    ].join(" "),
+    inputSchema: z.object({
+        message: z
+            .string({
+            required_error: INVALID_ARGUMENTS_MESSAGE,
+            invalid_type_error: INVALID_ARGUMENTS_MESSAGE,
+        })
+            .min(1, INVALID_ARGUMENTS_MESSAGE)
+            .superRefine((message, ctx) => {
+            if (message.length > MAX_UPDATE_CHARS) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: `size (${message.length}) is more than ${MAX_UPDATE_CHARS}-character limit. drop what the reader would not act on and move receipts into a post-file attachment, rather than compressing the sentences you keep, and try again`,
+                });
+            }
+        }),
+    }),
+    execute: ({ message }, ctx) => ({
+        message,
+        ts: reserve(ctx.session.id),
+    }),
+});
+export default postUpdate;

package/dist/extensions/slack-communication/tools/react.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../../../types.js";
+declare const react: ToolDefinition;
+export default react;
+//# sourceMappingURL=react.d.ts.map

package/dist/extensions/slack-communication/tools/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../../src/extensions/slack-communication/tools/react.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,QAAA,MAAM,KAAK,EAAE,cAyBX,CAAC;eAEY,KAAK"}

package/dist/extensions/slack-communication/tools/react.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { emojiName } from "../../../channels/slack/agentic-signals.js";
+import { defineTool } from "../../../tools.js";
+const react = defineTool({
+    description: [
+        "Add an emoji reaction to a message in this thread.",
+        "emoji is a Slack name without a leading colon, or :name:.",
+        "ts is the message timestamp. Omit it to react to the thread root.",
+        "The tool records nothing. The channel watching this turn adds the reaction.",
+    ].join(" "),
+    inputSchema: z.object({
+        emoji: z
+            .string()
+            .trim()
+            .min(1)
+            .refine(value => emojiName(value) !== undefined, "emoji must be a Slack reaction name"),
+        ts: z.string().trim().min(1).optional(),
+    }),
+    execute: ({ emoji, ts }) => {
+        const name = emojiName(emoji);
+        if (name === undefined) {
+            return "emoji must be a Slack reaction name";
+        }
+        return { emoji: name, ts };
+    },
+});
+export default react;

package/dist/extensions/slack-communication/tools/set-status.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "../../../types.js";
+declare const setStatus: ToolDefinition;
+export default setStatus;
+//# sourceMappingURL=set-status.d.ts.map

package/dist/extensions/slack-communication/tools/set-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-status.d.ts","sourceRoot":"","sources":["../../../../src/extensions/slack-communication/tools/set-status.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,QAAA,MAAM,SAAS,EAAE,cAaf,CAAC;eAEY,SAAS"}

package/dist/extensions/slack-communication/tools/set-status.js

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import { SLACK_STATUS_MAX_LEN } from "../../../channels/slack/constants.js";
+import { defineTool } from "../../../tools.js";
+const setStatus = defineTool({
+    description: [
+        "Set the status line under this thread (assistant.threads.setStatus).",
+        "That is the subtitle chip, not a message.",
+        `Keep it under ${String(SLACK_STATUS_MAX_LEN)} characters.`,
+        "Pass an empty string to clear it.",
+        "The channel paints thinking on this chip from the turn. Do not use this for thinking.",
+        "The tool records nothing. The channel watching this turn writes the chip.",
+    ].join(" "),
+    inputSchema: z.object({
+        status: z.string().max(SLACK_STATUS_MAX_LEN),
+    }),
+    execute: ({ status }) => ({ status }),
+});
+export default setStatus;