chore: prepare for Marketplace publication (#31)

Rename the action to plural `coder-agents-chat-action` (the product is
"Coder Agents", a chat in it is a "Coder Agents Chat") across
`action.yaml`, label keys, comment marker, source, tests, `package.json`,
`AGENTS.md`, README, and `dist/`. Branding `play` / `gray-dark`.

Switch chat-reuse on by default, scoped to `gh-target` + Coder user +
`GITHUB_WORKFLOW`. New `force-new-chat: true` opts out; mutually
exclusive with `existing-chat-id`. `idempotency-key` becomes an optional
sharding override. `ACTION_LABEL_KEYS` is the shared source of truth for
the reuse filter and the labels written on creation, with a derivation
invariant on `RESERVED_LABEL_KEYS`.

Honor `wait: complete` on the reuse follow-up path via a single
`runFollowUp` helper used by both the existing-chat-id path and the
reuse path, so the two cannot drift.

Rewrite the README for the Marketplace audience: Requirements,
Quickstart, Inputs/Outputs tables, How it works (identity, org, chat
reuse, wait mode, comment lifecycle), Recipes (issue triage, doc-check
service account, follow-up, force new, gate on `pull-request-url`),
Troubleshooting, Security model, Limitations, Versioning.

Followups:
- Repo rename `coder/create-agent-chat-action` -> `coder/agents-chat-action`.
- Marketplace metadata (repo description, homepage, topics).
- CODAGT-404: defensive sanitization of `GITHUB_WORKFLOW` against the
  256-byte chat-label value cap.

Generated by Coder Agents.

Author: mafredri

AGENTS.md

@@ -1,8 +1,8 @@
-# AGENTS.md - AI Agent Guide for create-agent-chat-action
+# AGENTS.md - AI Agent Guide for agents-chat-action
 
 ## Repository Overview
 
-**Purpose**: GitHub Action that creates and manages Coder Agent Chats for GitHub users with automated issue commenting support.
+**Purpose**: GitHub Action that creates and manages Coder Agents chats for GitHub users with automated issue commenting support.
 
 **Key Difference from create-task-action**: This action targets the Coder Agents Chat API (`/api/experimental/chats`) instead of the Tasks API. Agents purposefully does NOT expose template selection — it either auto-provisions a workspace or uses an existing one.
 
@@ -35,7 +35,9 @@ CoderAgentChatAction.run() (action.ts)
 ├─ Parse GitHub issue URL
 ├─ Check if existing-chat-id provided
 │  ├─ YES: Send message to existing chat
-│  └─ NO: Create new chat (Agents auto-provisions workspace)
+│  └─ NO: Look up existing chat by reuse labels (unless force-new-chat)
+│         ├─ Match: Send message to reused chat
+│         └─ No match: Create new chat (Agents auto-provisions workspace)
 └─ Comment on GitHub issue with chat URL
 ```
 

README.md

@@ -1,14 +1,14 @@
-name: "Coder Create Agent Chat"
-description: "Create a Coder Agent Chat for a GitHub user, with support for issue commenting"
+name: "Coder Agents Chat"
+description: "Run Coder agents from any GitHub workflow. Triage issues, review PRs, or follow up on an existing chat."
 author: "Coder Technologies Inc. <https://coder.com>"
 
 branding:
-  icon: message-circle
-  color: purple
+  icon: play
+  color: gray-dark
 
 inputs:
   chat-prompt:
-    description: "Prompt to send to the agent chat. Templated by the workflow before being passed in."
+    description: "Prompt to send to the agents chat. Templated by the workflow before being passed in."
     required: true
 
   coder-token:
@@ -48,7 +48,7 @@ inputs:
     required: false
 
   existing-chat-id:
-    description: "Existing chat ID to send a follow-up message to instead of creating a new chat."
+    description: "Existing chat ID to send a follow-up message to instead of creating a new chat. Mutually exclusive with force-new-chat."
     required: false
 
   comment-on-issue:
@@ -67,9 +67,14 @@ inputs:
     default: "600"
 
   idempotency-key:
-    description: "Optional key used to deduplicate chats. When set and existing-chat-id is unset, the action looks up the most recent non-archived chat scoped to this `gh-target` and resolved Coder user carrying this label and sends a follow-up message instead of creating a duplicate."
+    description: "Optional sharding key to narrow the default per-workflow scope. By default the action reuses the most recent non-archived chat scoped to `gh-target`, the resolved Coder user, and the workflow name. Set this to maintain multiple parallel chats on the same target/user/workflow (for example, one per matrix dimension)."
     required: false
 
+  force-new-chat:
+    description: "Always create a new chat instead of reusing the most recent matching chat. Mutually exclusive with existing-chat-id."
+    required: false
+    default: "false"
+
 outputs:
   coder-username:
     description: "The Coder username resolved from the GitHub user."

action.yaml

@@ -26955,11 +26955,13 @@ class CoderAPIError extends Error {
 }
 
 // src/sanitize-label-key.ts
-var RESERVED_LABEL_KEYS = new Set([
-  "coder-agent-chat-action",
-  "gh-target",
-  "coder-agent-chat-action-user"
-]);
+var ACTION_LABEL_KEYS = {
+  marker: "coder-agents-chat-action",
+  target: "gh-target",
+  user: "coder-agents-chat-action-user",
+  workflow: "coder-agents-chat-action-workflow"
+};
+var RESERVED_LABEL_KEYS = new Set(Object.values(ACTION_LABEL_KEYS));
 function sanitizeLabelKey(input) {
   const lowered = input.toLowerCase();
   const replaced = lowered.replace(/[^a-z0-9._/-]/g, "-");
@@ -26971,7 +26973,7 @@ function sanitizeLabelKey(input) {
 // src/comment.ts
 var core = __toESM(require_core(), 1);
 var GITHUB_URL_REGEX = /([^/]+)\/([^/]+)\/(?:issues|pull)\/(\d+)\/?(?:[?#].*)?$/;
-var COMMENT_MARKER_PREFIX = "<!-- coder-agent-chat-action:";
+var COMMENT_MARKER_PREFIX = "<!-- coder-agents-chat-action:";
 var COMMENT_MARKER_SUFFIX = " -->";
 function buildCommentMarker(key) {
   return `${COMMENT_MARKER_PREFIX}${key}${COMMENT_MARKER_SUFFIX}`;
@@ -27072,7 +27074,7 @@ function formatMicrosAsDollars(micros) {
 }
 function buildFailureCommentBody(detail, ctx) {
   const runPhase = isRunPhaseFailure(detail.kind, ctx);
-  const heading = runPhase ? "**Coder Agent Chat: failed**" : "**Coder Agent Chat: failed to start**";
+  const heading = runPhase ? "**Coder Agents Chat: failed**" : "**Coder Agents Chat: failed to start**";
   const lines = [heading, ""];
   const linkLine = ctx.chatUrl ? `View the chat in the Coder deployment: ${ctx.chatUrl}` : `View chats in the Coder deployment: ${ctx.chatsUrl}`;
   switch (detail.kind) {
@@ -27133,15 +27135,15 @@ function apiErrorPhrase(runPhase, ctx) {
 function buildSuccessCommentBody(ctx) {
   const lines = [];
   if (ctx.waitMode === "complete" && ctx.chatStatus === "waiting") {
-    lines.push("**Coder Agent Chat: agent finished or is awaiting input**");
+    lines.push("**Coder Agents Chat: agent finished or is awaiting input**");
   } else if (ctx.waitMode === "complete" && ctx.chatStatus !== undefined) {
-    lines.push(`**Coder Agent Chat: ${ctx.chatStatus}**`);
+    lines.push(`**Coder Agents Chat: ${ctx.chatStatus}**`);
   } else if (ctx.waitMode === "complete") {
-    lines.push("**Coder Agent Chat: complete**");
+    lines.push("**Coder Agents Chat: complete**");
   } else if (ctx.chatCreated) {
-    lines.push("**Coder Agent Chat: created**");
+    lines.push("**Coder Agents Chat: created**");
   } else {
-    lines.push("**Coder Agent Chat: message sent**");
+    lines.push("**Coder Agents Chat: message sent**");
   }
   lines.push("", `Chat: ${ctx.chatUrl}`);
   if (ctx.chatStatus !== undefined) {
@@ -27615,96 +27617,48 @@ class CoderAgentChatAction {
     if (this.inputs.existingChatId) {
       core2.info(`Sending message to existing chat: ${this.inputs.existingChatId}`);
       const chatId = ChatIdSchema.parse(this.inputs.existingChatId);
-      await this.coder.createChatMessage(chatId, {
-        content: [{ type: "text", text: this.inputs.chatPrompt }],
-        model_config_id: this.inputs.modelConfigId
-      });
-      core2.info("Message sent successfully");
-      const chatUrl2 = this.generateChatUrl(chatId);
-      let chat;
-      if (this.inputs.wait === "complete") {
-        core2.info(`Waiting for chat to reach terminal status (timeout: ${this.inputs.waitTimeoutSeconds}s)...`);
-        chat = await this.pollWithContext(chatId, { coderUsername, chatUrl: chatUrl2 }, { requireNonTerminalFirst: true });
-        core2.info(`Chat reached terminal status: ${chat.status}`);
-      } else {
-        try {
-          chat = await this.coder.getChat(chatId);
-          core2.info(`Chat status: ${chat.status}, title: ${chat.title}`);
-        } catch (error3) {
-          core2.warning(`Failed to fetch chat after sending message; outputs will be minimal: ${error3}`);
-        }
-      }
-      if (this.inputs.commentOnIssue) {
-        core2.info(`Commenting on issue ${githubOrg}/${githubRepo}#${githubIssueNumber}`);
-        await this.commentOnIssue({
-          chatUrl: chatUrl2,
-          owner: githubOrg,
-          repo: githubRepo,
-          issueNumber: githubIssueNumber,
-          chatCreated: false,
-          chat
-        });
-      }
-      if (chat) {
-        return this.buildOutputs(coderUsername, chat, false);
-      }
-      return {
+      return this.runFollowUp({
         coderUsername,
         chatId,
-        chatUrl: chatUrl2,
-        chatCreated: false
-      };
+        preMessageChat: undefined,
+        githubOrg,
+        githubRepo,
+        githubIssueNumber
+      });
     }
     const sanitizedKey = this.inputs.idempotencyKey ? sanitizeLabelKey(this.inputs.idempotencyKey) : undefined;
     if (sanitizedKey && RESERVED_LABEL_KEYS.has(sanitizedKey)) {
       throw new Error(`idempotency-key sanitizes to a reserved chat-label key ("${sanitizedKey}"). ` + `Reserved keys: ${[...RESERVED_LABEL_KEYS].join(", ")}. ` + "Choose a different idempotency-key value.");
     }
     const ghTarget = `${githubOrg}/${githubRepo}#${githubIssueNumber}`;
-    if (sanitizedKey) {
-      const follow = await this.findIdempotentMatch(sanitizedKey, ghTarget, resolvedUser.id);
+    const workflow = process.env.GITHUB_WORKFLOW || undefined;
+    if (this.inputs.forceNewChat) {
+      core2.info("force-new-chat=true: skipping chat-reuse lookup");
+    } else {
+      const follow = await this.findReuseMatch(ghTarget, resolvedUser.id, workflow, sanitizedKey);
       if (follow) {
-        core2.info(`Reusing existing chat by idempotency label: ${follow.id}`);
-        await this.coder.createChatMessage(follow.id, {
-          content: [{ type: "text", text: this.inputs.chatPrompt }],
-          model_config_id: this.inputs.modelConfigId
+        core2.info(`Reusing existing chat: ${follow.id}`);
+        return this.runFollowUp({
+          coderUsername,
+          chatId: follow.id,
+          preMessageChat: follow,
+          githubOrg,
+          githubRepo,
+          githubIssueNumber
         });
-        core2.info("Message sent successfully");
-        const chatUrl2 = this.generateChatUrl(follow.id);
-        let refreshed = follow;
-        try {
-          const fetched = await this.coder.getChat(follow.id);
-          core2.info(`Chat status: ${fetched.status}, title: ${fetched.title}`);
-          refreshed = fetched;
-        } catch (error3) {
-          core2.warning(`Failed to fetch chat after sending message; outputs reflect pre-message state: ${error3}`);
-        }
-        if (this.inputs.commentOnIssue) {
-          core2.info(`Commenting on issue ${githubOrg}/${githubRepo}#${githubIssueNumber}`);
-          await this.commentOnIssue({
-            chatUrl: chatUrl2,
-            owner: githubOrg,
-            repo: githubRepo,
-            issueNumber: githubIssueNumber,
-            chatCreated: false,
-            chat: refreshed
-          });
-        }
-        return this.buildOutputs(coderUsername, refreshed, false);
       }
     }
-    core2.info("Creating new agent chat...");
+    core2.info("Creating new agents chat...");
     const organizationID = await this.resolveOrganizationID(coderUsername, resolvedUser);
     const req = {
       organization_id: organizationID,
       content: [{ type: "text", text: this.inputs.chatPrompt }],
       workspace_id: this.inputs.workspaceId,
-      model_config_id: this.inputs.modelConfigId
+      model_config_id: this.inputs.modelConfigId,
+      labels: this.buildChatLabels(ghTarget, resolvedUser.id, workflow, sanitizedKey)
     };
-    if (sanitizedKey) {
-      req.labels = this.buildIdempotencyLabels(sanitizedKey, ghTarget, resolvedUser.id);
-    }
     const createdChat = await this.coder.createChat(req);
-    core2.info(`Agent chat created successfully (id: ${createdChat.id}, status: ${createdChat.status})`);
+    core2.info(`Agents chat created successfully (id: ${createdChat.id}, status: ${createdChat.status})`);
     const chatUrl = this.generateChatUrl(createdChat.id);
     core2.info(`Chat URL: ${chatUrl}`);
     let finalChat = createdChat;
@@ -27732,19 +27686,77 @@ class CoderAgentChatAction {
     }
     return this.buildOutputs(coderUsername, finalChat, true);
   }
-  async findIdempotentMatch(sanitizedKey, ghTarget, coderUserId) {
-    const keyLabel = `${sanitizedKey}:true`;
-    const targetLabel = `gh-target:${ghTarget}`;
-    const userLabel = `coder-agent-chat-action-user:${coderUserId}`;
+  async runFollowUp(args) {
+    const {
+      coderUsername,
+      chatId,
+      preMessageChat,
+      githubOrg,
+      githubRepo,
+      githubIssueNumber
+    } = args;
+    await this.coder.createChatMessage(chatId, {
+      content: [{ type: "text", text: this.inputs.chatPrompt }],
+      model_config_id: this.inputs.modelConfigId
+    });
+    core2.info("Message sent successfully");
+    const chatUrl = this.generateChatUrl(chatId);
+    let chat = preMessageChat;
+    if (this.inputs.wait === "complete") {
+      core2.info(`Waiting for chat to reach terminal status (timeout: ${this.inputs.waitTimeoutSeconds}s)...`);
+      chat = await this.pollWithContext(chatId, { coderUsername, chatUrl }, { requireNonTerminalFirst: true });
+      core2.info(`Chat reached terminal status: ${chat.status}`);
+    } else {
+      try {
+        const fetched = await this.coder.getChat(chatId);
+        core2.info(`Chat status: ${fetched.status}, title: ${fetched.title}`);
+        chat = fetched;
+      } catch (error3) {
+        core2.warning(preMessageChat ? `Failed to fetch chat after sending message; outputs reflect pre-message state: ${error3}` : `Failed to fetch chat after sending message; outputs will be minimal: ${error3}`);
+      }
+    }
+    if (this.inputs.commentOnIssue) {
+      core2.info(`Commenting on issue ${githubOrg}/${githubRepo}#${githubIssueNumber}`);
+      await this.commentOnIssue({
+        chatUrl,
+        owner: githubOrg,
+        repo: githubRepo,
+        issueNumber: githubIssueNumber,
+        chatCreated: false,
+        chat
+      });
+    }
+    if (chat) {
+      return this.buildOutputs(coderUsername, chat, false);
+    }
+    return {
+      coderUsername,
+      chatId,
+      chatUrl,
+      chatCreated: false
+    };
+  }
+  async findReuseMatch(ghTarget, coderUserId, workflow, sanitizedKey) {
+    const labels = [
+      `${ACTION_LABEL_KEYS.marker}:true`,
+      `${ACTION_LABEL_KEYS.target}:${ghTarget}`,
+      `${ACTION_LABEL_KEYS.user}:${coderUserId}`
+    ];
+    if (workflow) {
+      labels.push(`${ACTION_LABEL_KEYS.workflow}:${workflow}`);
+    }
+    if (sanitizedKey) {
+      labels.push(`${sanitizedKey}:true`);
+    }
     let chats;
     try {
       chats = await this.coder.listChats({
-        label: [keyLabel, targetLabel, userLabel],
+        label: labels,
         archived: false
       });
     } catch (err) {
       const inner = err instanceof Error ? err.message : String(err);
-      throw new Error(`Failed to look up chats by idempotency labels [${keyLabel}, ${targetLabel}, ${userLabel}]: ${inner}`, { cause: err });
+      throw new Error(`Failed to look up chats by reuse labels [${labels.join(", ")}]: ${inner}`, { cause: err });
     }
     const live = chats.filter((chat) => chat.archived !== true);
     if (live.length === 0) {
@@ -27759,20 +27771,25 @@ class CoderAgentChatAction {
     });
     if (live.length > 1) {
       const ignored = live.slice(1).map((c) => c.id).join(", ");
-      core2.warning(`Multiple non-archived chats matched idempotency-key=${this.inputs.idempotencyKey} for ${ghTarget}. ` + `Reusing the most recent (${live[0].id}) and ignoring: ${ignored}. ` + "Concurrent triggers can race; subsequent runs converge on the " + "most recent match.");
+      core2.warning(`Multiple non-archived chats matched reuse scope for ${ghTarget}. ` + `Reusing the most recent (${live[0].id}) and ignoring: ${ignored}. ` + "Concurrent triggers can race; subsequent runs converge on the " + "most recent match.");
     }
     return live[0];
   }
-  buildIdempotencyLabels(sanitizedKey, ghTarget, coderUserId) {
-    if (RESERVED_LABEL_KEYS.has(sanitizedKey)) {
+  buildChatLabels(ghTarget, coderUserId, workflow, sanitizedKey) {
+    if (sanitizedKey && RESERVED_LABEL_KEYS.has(sanitizedKey)) {
       throw new Error(`idempotency-key sanitizes to a reserved chat-label key ("${sanitizedKey}"). ` + `Reserved keys: ${[...RESERVED_LABEL_KEYS].join(", ")}. ` + "Choose a different idempotency-key value.");
     }
     const labels = {
-      "coder-agent-chat-action": "true",
-      "gh-target": ghTarget,
-      "coder-agent-chat-action-user": coderUserId
+      [ACTION_LABEL_KEYS.marker]: "true",
+      [ACTION_LABEL_KEYS.target]: ghTarget,
+      [ACTION_LABEL_KEYS.user]: coderUserId
     };
-    labels[sanitizedKey] = "true";
+    if (workflow) {
+      labels[ACTION_LABEL_KEYS.workflow] = workflow;
+    }
+    if (sanitizedKey) {
+      labels[sanitizedKey] = "true";
+    }
     return labels;
   }
 }
@@ -27843,11 +27860,15 @@ var ActionInputsObjectSchema = exports_external.object({
   commentOnIssue: exports_external.boolean().default(true),
   wait: exports_external.enum(["none", "complete"]).default("none"),
   waitTimeoutSeconds: exports_external.coerce.number().int().positive().default(DEFAULT_WAIT_TIMEOUT_SECONDS),
-  idempotencyKey: exports_external.string().min(1).optional()
+  idempotencyKey: exports_external.string().min(1).optional(),
+  forceNewChat: exports_external.boolean().default(false)
 });
 var ActionInputsSchema = ActionInputsObjectSchema.refine((data) => !(data.githubUserID !== undefined && data.coderUsername !== undefined), {
   message: "Cannot set both github-user-id and coder-username; choose one.",
   path: ["coderUsername"]
+}).refine((data) => !(data.existingChatId !== undefined && data.forceNewChat === true), {
+  message: "Cannot set both existing-chat-id and force-new-chat; choose one.",
+  path: ["forceNewChat"]
 });
 var ChatErrorKindSchema2 = exports_external.enum([
   "spend_exceeded",
@@ -27904,7 +27925,8 @@ async function main() {
       commentOnIssue: core4.getBooleanInput("comment-on-issue"),
       wait: core4.getInput("wait") || undefined,
       waitTimeoutSeconds: core4.getInput("wait-timeout-seconds") || undefined,
-      idempotencyKey: core4.getInput("idempotency-key") || undefined
+      idempotencyKey: core4.getInput("idempotency-key") || undefined,
+      forceNewChat: core4.getBooleanInput("force-new-chat")
     });
     core4.debug("Inputs validated successfully");
     core4.debug(`Coder URL: ${inputs.coderURL}`);

dist/index.js

@@ -1,7 +1,7 @@
 {
-	"name": "coder-agent-chat-action",
+	"name": "coder-agents-chat-action",
 	"version": "1.0.0",
-	"description": "GitHub Action to create and manage Coder Agent Chats",
+	"description": "GitHub Action to create and manage Coder Agents chats",
 	"main": "dist/index.js",
 	"scripts": {
 		"build": "bun build src/index.ts --outfile dist/index.js --target node --format cjs",