@integrity-labs/agt-cli 0.27.8-test.9 → 0.27.9-test.11

package/dist/mcp/index.js

@@ -21061,8 +21061,11 @@ var DeliveryTargetSchema = external_exports.union([
     channel_id: external_exports.string().optional(),
     chat_id: external_exports.string().optional(),
     conversation_id: external_exports.string().optional(),
-    service_url: external_exports.string().optional()
-  }).describe("Post to a Slack channel, Telegram chat, or Microsoft Teams conversation. Provide channel_id for Slack, chat_id for Telegram, or conversation_id + service_url for Teams."),
+    service_url: external_exports.string().optional(),
+    thread_ts: external_exports.string().nullable().optional().describe(
+      `Slack only (ENG-6038). The originating thread's thread_ts when the user asked for the result back in the thread the request came from ("report back here" inside a thread) \u2014 take it from the inbound message's <channel> envelope. Pass null to mean 'top-level on purpose' (e.g. the user said "post it to the channel" \u2014 null also suppresses server-side thread auto-injection on one-time tasks). Omit only when the request didn't come from a thread.`
+    )
+  }).describe("Post to a Slack channel, Telegram chat, or Microsoft Teams conversation. Provide channel_id for Slack, chat_id for Telegram, or conversation_id + service_url for Teams. For Slack, thread_ts optionally threads the delivery under the originating conversation."),
   external_exports.object({
     kind: external_exports.literal("dm"),
     person_id: external_exports.string().uuid(),
@@ -21076,6 +21079,7 @@ var DeliveryTargetSchema = external_exports.union([
 ]);
 var AGT_HOST = process.env.AGT_HOST;
 var AGT_API_KEY = process.env.AGT_API_KEY;
+var AGT_AGENT_SESSION_TOKEN = process.env.AGT_AGENT_SESSION_TOKEN;
 var AGT_AGENT_ID = process.env.AGT_AGENT_ID;
 var AGT_AGENT_CODE_NAME = process.env.AGT_AGENT_CODE_NAME;
 var AGT_APP_URL = (process.env.AGT_APP_URL?.trim() || "https://app.augmented.team").replace(/\/+$/, "");
@@ -21086,9 +21090,9 @@ function readRunId() {
 }
 var AGT_RUN_ID = readRunId();
 var AGT_TOKEN = process.env.AGT_TOKEN ?? "";
-if (!AGT_HOST || !AGT_AGENT_ID || !AGT_TOKEN && !AGT_API_KEY) {
+if (!AGT_HOST || !AGT_AGENT_ID || !AGT_TOKEN && !AGT_API_KEY && !AGT_AGENT_SESSION_TOKEN) {
   console.error(
-    "augmented-mcp: Missing required env vars. Need AGT_HOST, AGT_AGENT_ID, and AGT_TOKEN or AGT_API_KEY"
+    "augmented-mcp: Missing required env vars. Need AGT_HOST, AGT_AGENT_ID, and one of AGT_AGENT_SESSION_TOKEN, AGT_TOKEN, or AGT_API_KEY"
   );
   process.exit(1);
 }
@@ -21110,6 +21114,9 @@ async function refreshToken() {
   return AGT_TOKEN;
 }
 async function getToken() {
+  if (AGT_AGENT_SESSION_TOKEN) {
+    return AGT_AGENT_SESSION_TOKEN;
+  }
   if (AGT_API_KEY && (!AGT_TOKEN || Date.now() > tokenExpiresAt - 5 * 6e4)) {
     if (!exchangeInFlight) {
       exchangeInFlight = refreshToken().finally(() => {
@@ -21141,13 +21148,18 @@ async function apiPost(path, body, retried = false, timeoutMs = 15e3) {
       body: JSON.stringify(body),
       signal: controller.signal
     });
-    if (res.status === 401 && AGT_API_KEY && !retried) {
+    if (res.status === 401 && AGT_API_KEY && !AGT_AGENT_SESSION_TOKEN && !retried) {
       clearTimeout(timeout);
       tokenExpiresAt = 0;
       return apiPost(path, body, true, timeoutMs);
     }
     if (!res.ok) {
       const text = await res.text().catch(() => res.statusText);
+      if (res.status === 401 && AGT_AGENT_SESSION_TOKEN) {
+        throw new Error(
+          `API ${path} returned 401: agent-session rejected (expired or revoked). Re-run \`agt impersonate connect\` to mint a fresh session. (${text})`
+        );
+      }
       throw new Error(`API ${path} returned ${res.status}: ${text}`);
     }
     return await res.json();
@@ -21177,7 +21189,7 @@ server.tool(
     }
     const grouped = groupByStatus(data.items);
     const lines = [];
-    for (const status of ["in_progress", "todo", "backlog", "done"]) {
+    for (const status of ["in_progress", "todo", "backlog", "done", "failed"]) {
       const items = grouped[status];
       if (!items?.length) continue;
       lines.push(`
@@ -21236,11 +21248,11 @@ server.tool(
 );
 server.tool(
   "kanban_move",
-  "Move a kanban item to a different status column.",
+  'Move a kanban item to a different status column. Use status="failed" to mark a task that was attempted but could not complete (matches the hosted kanban_move enum).',
   {
     id: external_exports.string().optional().describe("Item UUID (preferred)"),
     title: external_exports.string().optional().describe("Item title for fuzzy match (if no id)"),
-    status: external_exports.enum(["backlog", "todo", "in_progress", "done"]).describe("Target status"),
+    status: external_exports.enum(["backlog", "todo", "in_progress", "done", "failed"]).describe('Target status. "failed" closes the row as a failed attempt; there is no "cancelled" status \u2014 close no-longer-needed work via kanban_done with an explanatory result.'),
     notes: external_exports.string().optional().describe("Progress notes")
   },
   async (params) => {
@@ -21728,7 +21740,7 @@ server.tool(
     prompt: external_exports.string().describe("What to do when the task fires"),
     delivery_channel: external_exports.string().optional().describe('Channel platform to deliver results to (e.g. "slack", "telegram"). Default: "slack" if available.'),
     delivery_to: DeliveryTargetSchema.optional().describe(
-      "Where the task output should be delivered. Structured object: either { kind: 'channel', provider, channel_id? | chat_id? } to post to a Slack channel / Telegram chat, or { kind: 'dm', person_id, follow_reports_to, medium } to DM a person. For 'reply to the channel this request came from', pass the incoming message's channel_id. For 'DM my manager', use follow_reports_to=true with the agent's current reports_to person_id. Legacy string forms ('channel:<id>', 'chat:<id>', 'slack_user:<id>') are rejected server-side \u2014 use the structured form."
+      "Where the task output should be delivered. Structured object: either { kind: 'channel', provider, channel_id? | chat_id? } to post to a Slack channel / Telegram chat, or { kind: 'dm', person_id, follow_reports_to, medium } to DM a person. For 'reply to the channel this request came from', pass the incoming message's channel_id. For 'report back HERE' said inside a Slack thread, also pass thread_ts from the inbound envelope so the result lands in that thread; if the user wants the channel top-level despite asking from a thread, pass thread_ts: null. For 'DM my manager', use follow_reports_to=true with the agent's current reports_to person_id. Legacy string forms ('channel:<id>', 'chat:<id>', 'slack_user:<id>') are rejected server-side \u2014 use the structured form."
     ),
     delivery_mode: external_exports.enum(["announce", "none"]).optional().describe('Delivery mode: "announce" sends output to delivery_channel, "none" suppresses. Default: "announce".')
   },
@@ -21801,7 +21813,7 @@ server.tool(
       'Where results are delivered (e.g. "slack", "telegram", "email")'
     ),
     delivery_to: DeliveryTargetSchema.optional().describe(
-      "Structured delivery target (see schedule_create description for shape). Pass null-equivalent by omitting the field; pass a new structured target to change routing."
+      "Structured delivery target (see schedule_create description for shape). Pass null-equivalent by omitting the field; pass a new structured target to change routing. delivery_to is replaced wholesale: to STOP a task threading into a Slack conversation ('post it to the channel instead'), pass the channel target again WITHOUT thread_ts; to start threading, include thread_ts."
     ),
     enabled: external_exports.boolean().optional().describe(
       "Set to false to pause the schedule without deleting it"
@@ -22243,7 +22255,8 @@ function statusLabel(status) {
     backlog: "Backlog",
     todo: "To Do",
     in_progress: "In Progress",
-    done: "Done"
+    done: "Done",
+    failed: "Failed"
   };
   return labels[status] ?? status;
 }
@@ -22317,9 +22330,13 @@ var LOCAL_TOOL_NAMES = /* @__PURE__ */ new Set([
   "dashboards_request_refresh",
   "dashboards_pending_refreshes",
   "dashboards_persist_widget",
+  "artefacts_list",
+  "artefacts_get",
+  "artefacts_get_source_chunk",
+  // ADR-0017 Projects container (the reclaimed projects_* namespace — read-only
+  // in v1; no projects_get_source_chunk, a project is a container not a document).
   "projects_list",
-  "projects_get",
-  "projects_get_source_chunk"
+  "projects_get"
 ]);
 async function registerForwardedApiTools() {
   const apiTools = await discoverApiTools();
@@ -22353,76 +22370,135 @@ async function registerForwardedApiTools() {
   }
   return { registered, skipped };
 }
-server.tool(
-  "projects_list",
-  "List artefacts (websites, slide decks, mockups) this agent has previously published. Call this BEFORE re-publishing to find and modify existing work instead of creating duplicates.",
-  {
-    publisher: external_exports.string().optional().describe('Filter by publisher (e.g. "here-now")'),
-    kind: external_exports.enum(["mockup", "deck", "site", "app", "other"]).optional().describe("Filter by artefact kind"),
-    limit: external_exports.number().int().min(1).max(100).optional().describe("Maximum projects to return (default 50, max 100)")
-  },
-  async (params) => {
-    const data = await apiPost("/host/my-published-projects", {
+async function listPublishedArtefactsText(params) {
+  const data = await apiPost(
+    "/host/my-published-artefacts",
+    {
       agent_id: AGT_AGENT_ID,
       publisher: params.publisher,
       kind: params.kind,
       limit: params.limit
-    });
-    if (!data.projects.length) {
-      return { content: [{ type: "text", text: "No published projects yet." }] };
     }
-    const lines = data.projects.map((p) => {
-      const title = p.title ?? "(untitled)";
-      const expires = p.expires_at ? ` expires ${p.expires_at}` : "";
-      return `- [${p.kind}] ${title} \u2014 ${p.live_url} (id: ${p.id}, ${p.mode}, published ${p.published_at}${expires})`;
-    });
-    return { content: [{ type: "text", text: lines.join("\n") }] };
-  }
+  );
+  if (!data.artefacts.length) {
+    return "No published artefacts yet.";
+  }
+  return data.artefacts.map((p) => {
+    const title = p.title ?? "(untitled)";
+    const expires = p.expires_at ? ` expires ${p.expires_at}` : "";
+    return `- [${p.kind}] ${title} \u2014 ${p.live_url} (id: ${p.id}, ${p.mode}, published ${p.published_at}${expires})`;
+  }).join("\n");
+}
+async function getPublishedArtefactText(artefactId) {
+  const data = await apiPost(`/host/published-artefact/${encodeURIComponent(artefactId)}`, {
+    agent_id: AGT_AGENT_ID
+  });
+  const p = data.artefact;
+  return [
+    `Artefact: ${p.title ?? "(untitled)"} [${p.kind}]`,
+    `Publisher: ${p.publisher} (${p.mode})`,
+    `Live URL: ${p.live_url}`,
+    p.claim_url ? `Claim URL: ${p.claim_url}` : null,
+    `Published: ${p.published_at}`,
+    p.expires_at ? `Expires: ${p.expires_at}` : null,
+    `Last modified: ${p.last_modified_at}`,
+    p.has_source_html ? `Source HTML: ${p.source_html_length} bytes (call artefacts_get_source_chunk to fetch)` : "(source HTML not preserved for this artefact)"
+  ].filter((s) => s !== null).join("\n");
+}
+async function getPublishedArtefactSourceChunkText(artefactId, offset, limit) {
+  const data = await apiPost(`/host/published-artefact/${encodeURIComponent(artefactId)}/source-chunk`, {
+    agent_id: AGT_AGENT_ID,
+    offset,
+    limit
+  });
+  const trailer = data.end_of_content ? "\n\n---\n(end of source)" : `
+
+---
+(more \u2014 next offset: ${data.offset + data.length}, total: ${data.total_length} bytes)`;
+  return data.chunk + trailer;
+}
+var artefactListSchema = {
+  publisher: external_exports.string().optional().describe('Filter by publisher (e.g. "here-now")'),
+  kind: external_exports.enum(["mockup", "deck", "site", "app", "other"]).optional().describe("Filter by artefact kind"),
+  limit: external_exports.number().int().min(1).max(100).optional().describe("Maximum artefacts to return (default 50, max 100)")
+};
+server.tool(
+  "artefacts_list",
+  "List artefacts (websites, slide decks, mockups) this agent has previously published. Call this BEFORE re-publishing to find and modify existing work instead of creating duplicates.",
+  artefactListSchema,
+  async (params) => ({
+    content: [{ type: "text", text: await listPublishedArtefactsText(params) }]
+  })
 );
 server.tool(
-  "projects_get",
-  "Fetch metadata for a single published project. Returns the project record without the source HTML \u2014 call projects_get_source_chunk to retrieve the HTML in chunks when you need to modify it.",
+  "artefacts_get",
+  "Fetch metadata for a single published artefact. Returns the artefact record without the source HTML \u2014 call artefacts_get_source_chunk to retrieve the HTML in chunks when you need to modify it.",
   {
-    project_id: external_exports.string().uuid().describe("The project id returned by projects_list")
+    artefact_id: external_exports.string().uuid().describe("The artefact id returned by artefacts_list")
   },
-  async (params) => {
-    const data = await apiPost(`/host/published-project/${encodeURIComponent(params.project_id)}`, {
-      agent_id: AGT_AGENT_ID
-    });
-    const p = data.project;
-    const header = [
-      `Project: ${p.title ?? "(untitled)"} [${p.kind}]`,
-      `Publisher: ${p.publisher} (${p.mode})`,
-      `Live URL: ${p.live_url}`,
-      p.claim_url ? `Claim URL: ${p.claim_url}` : null,
-      `Published: ${p.published_at}`,
-      p.expires_at ? `Expires: ${p.expires_at}` : null,
-      `Last modified: ${p.last_modified_at}`,
-      p.has_source_html ? `Source HTML: ${p.source_html_length} bytes (call projects_get_source_chunk to fetch)` : "(source HTML not preserved for this project)"
-    ].filter((s) => s !== null).join("\n");
-    return { content: [{ type: "text", text: header }] };
-  }
+  async (params) => ({
+    content: [{ type: "text", text: await getPublishedArtefactText(params.artefact_id) }]
+  })
 );
 server.tool(
-  "projects_get_source_chunk",
-  "Fetch a chunk of source HTML for a published project. Use this to assemble the HTML for modification when projects_get reports a non-zero source_html_length.",
+  "artefacts_get_source_chunk",
+  "Fetch a chunk of source HTML for a published artefact. Use this to assemble the HTML for modification when artefacts_get reports a non-zero source_html_length.",
   {
-    project_id: external_exports.string().uuid().describe("The project id returned by projects_list"),
+    artefact_id: external_exports.string().uuid().describe("The artefact id returned by artefacts_list"),
     offset: external_exports.number().int().min(0).describe("Byte offset into the source HTML to start from"),
     limit: external_exports.number().int().min(1).max(65536).optional().describe("Max bytes to return (default 32KB, max 64KB)")
   },
-  async (params) => {
-    const data = await apiPost(`/host/published-project/${encodeURIComponent(params.project_id)}/source-chunk`, {
-      agent_id: AGT_AGENT_ID,
-      offset: params.offset,
-      limit: params.limit
-    });
-    const trailer = data.end_of_content ? "\n\n---\n(end of source)" : `
-
----
-(more \u2014 next offset: ${data.offset + data.length}, total: ${data.total_length} bytes)`;
-    return { content: [{ type: "text", text: data.chunk + trailer }] };
+  async (params) => ({
+    content: [
+      { type: "text", text: await getPublishedArtefactSourceChunkText(params.artefact_id, params.offset, params.limit) }
+    ]
+  })
+);
+async function listProjectsText(params) {
+  const data = await apiPost("/host/my-projects", {
+    agent_id: AGT_AGENT_ID,
+    status: params.status,
+    limit: params.limit
+  });
+  if (!data.projects.length) {
+    return "No projects yet. Projects are created by a human in the console; ask one to create a project to group your work under.";
   }
+  return data.projects.map((p) => `- ${p.name} [${p.status}] (id: ${p.id}, created ${p.created_at})`).join("\n");
+}
+async function getProjectText(projectId) {
+  const data = await apiPost(
+    `/host/project/${encodeURIComponent(projectId)}`,
+    { agent_id: AGT_AGENT_ID }
+  );
+  const p = data.project;
+  return [
+    `Project: ${p.name} [${p.status}]`,
+    `Id: ${p.id}`,
+    p.linear_project_id ? `Linear project: ${p.linear_project_id}` : null,
+    `Created: ${p.created_at}`,
+    `Last updated: ${p.updated_at}`
+  ].filter((s) => s !== null).join("\n");
+}
+server.tool(
+  "projects_list",
+  "List the projects belonging to this agent's team. A project is a container that groups related tasks and published artefacts across agents under one unit of work. Read-only: projects are created by humans in the console.",
+  {
+    status: external_exports.enum(["active", "archived"]).optional().describe("Filter by project status"),
+    limit: external_exports.number().int().min(1).max(100).optional().describe("Maximum projects to return (default 50, max 100)")
+  },
+  async (params) => ({
+    content: [{ type: "text", text: await listProjectsText(params) }]
+  })
+);
+server.tool(
+  "projects_get",
+  "Fetch a single project (a team-scoped container) by id, including its name, status, and optional Linear link.",
+  {
+    project_id: external_exports.string().uuid().describe("The project id returned by projects_list")
+  },
+  async (params) => ({
+    content: [{ type: "text", text: await getProjectText(params.project_id) }]
+  })
 );
 async function main() {
   try {