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

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();
@@ -21165,7 +21177,7 @@ var server = new McpServer({
   version: "0.1.0"
 });
 server.tool(
-  "kanban.list",
+  "kanban_list",
   "List kanban board items for this agent. Returns active items and recently completed items (last 7 days).",
   {},
   async () => {
@@ -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(`
@@ -21194,7 +21206,7 @@ server.tool(
   }
 );
 server.tool(
-  "kanban.add",
+  "kanban_add",
   "Add a new item to the kanban board.",
   {
     title: external_exports.string().describe("Item title (max 200 chars)"),
@@ -21235,12 +21247,12 @@ server.tool(
   }
 );
 server.tool(
-  "kanban.move",
-  "Move a kanban item to a different status column.",
+  "kanban_move",
+  '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) => {
@@ -21273,7 +21285,7 @@ server.tool(
   }
 );
 server.tool(
-  "kanban.update",
+  "kanban_update",
   "Update notes or result on a kanban item without changing its status.",
   {
     id: external_exports.string().optional().describe("Item UUID (preferred)"),
@@ -21324,7 +21336,7 @@ server.tool(
   }
 );
 server.tool(
-  "kanban.progress",
+  "kanban_progress",
   "Report what you're doing RIGHT NOW on a kanban item. Overwrites a single live status line (the Step row on the Slack progress card the requester is watching) \u2014 not a log. Call it at the start of each phase of a long task (ideally ~every minute) so the requester can watch the work move. Each call also renews the task heartbeat. Pass an empty step to clear it.",
   {
     id: external_exports.string().optional().describe("Item UUID (preferred)"),
@@ -21362,7 +21374,7 @@ server.tool(
   }
 );
 server.tool(
-  "kanban.done",
+  "kanban_done",
   "Mark a kanban item as done with an optional result.",
   {
     id: external_exports.string().optional().describe("Item UUID (preferred)"),
@@ -21401,7 +21413,7 @@ server.tool(
   }
 );
 server.tool(
-  "status.standup",
+  "status_standup",
   "Submit a daily standup update with yesterday, today, and blockers.",
   {
     yesterday: external_exports.string().describe("What was accomplished yesterday/last session"),
@@ -21434,7 +21446,7 @@ server.tool(
   }
 );
 server.tool(
-  "status.update",
+  "status_update",
   "Report current task progress or status update.",
   {
     current_tasks: external_exports.string().describe("Summary of what you are currently working on")
@@ -21461,7 +21473,7 @@ server.tool(
   }
 );
 server.tool(
-  "drift.report",
+  "drift_report",
   "Report configuration drift detected in local agent files (CHARTER.md, TOOLS.md, etc.). Compares local file hashes against API-side versions and reports any differences.",
   {
     drifted_files: external_exports.array(external_exports.string()).describe('List of filenames that have drifted from provisioned state (e.g. ["CHARTER.md", "TOOLS.md"])'),
@@ -21484,7 +21496,7 @@ server.tool(
   }
 );
 server.tool(
-  "token.refresh",
+  "token_refresh",
   "Get a working OAuth access token for an integration. Returns the current cached token when it is still valid (the server-side cron rotates tokens every ~15 minutes) and forces a refresh only when the cached token is expiring or missing. Pass `integration_id` to force-refresh a specific integration after a 401/TokenExpired from the provider.",
   {
     integration_id: external_exports.string().optional().describe("Specific integration UUID to force-refresh (use after a 401 from the provider). If omitted, returns current tokens for all OAuth integrations, refreshing any that are within ~10 minutes of expiry.")
@@ -21578,7 +21590,7 @@ async function runAcpxCommand(args, cwd) {
   });
 }
 server.tool(
-  "acpx.prompt",
+  "acpx_prompt",
   "Send a prompt to a coding agent (claude, codex, openclaw) via ACP. Uses persistent sessions scoped to the working directory.",
   {
     agent: external_exports.enum(["claude", "codex", "openclaw"]).describe("Coding agent to use"),
@@ -21603,7 +21615,7 @@ server.tool(
   }
 );
 server.tool(
-  "acpx.exec",
+  "acpx_exec",
   "Run a one-shot task on a coding agent. Does not reuse sessions \u2014 fire and forget.",
   {
     agent: external_exports.enum(["claude", "codex", "openclaw"]).describe("Coding agent to use"),
@@ -21622,7 +21634,7 @@ server.tool(
   }
 );
 server.tool(
-  "acpx.spawn",
+  "acpx_spawn",
   "Ensure an ACP session exists for a coding agent. Creates one if needed, reuses existing.",
   {
     agent: external_exports.enum(["claude", "codex", "openclaw"]).describe("Coding agent to use"),
@@ -21642,7 +21654,7 @@ server.tool(
   }
 );
 server.tool(
-  "acpx.cancel",
+  "acpx_cancel",
   "Send a cooperative cancel to the running ACP session. Does not destroy state.",
   {
     agent: external_exports.enum(["claude", "codex", "openclaw"]).describe("Coding agent to cancel"),
@@ -21662,7 +21674,7 @@ server.tool(
   }
 );
 server.tool(
-  "acpx.status",
+  "acpx_status",
   "Check the status of the current ACP session (running, idle, dead).",
   {
     agent: external_exports.enum(["claude", "codex", "openclaw"]).describe("Coding agent to check"),
@@ -21676,7 +21688,7 @@ server.tool(
   }
 );
 server.tool(
-  "acpx.close",
+  "acpx_close",
   "Soft-close an ACP session. Terminates the process but preserves history.",
   {
     agent: external_exports.enum(["claude", "codex", "openclaw"]).describe("Coding agent session to close"),
@@ -21696,7 +21708,7 @@ server.tool(
   }
 );
 server.tool(
-  "schedule.list",
+  "schedule_list",
   "List your scheduled tasks (cron jobs, reminders, recurring work).",
   {},
   async () => {
@@ -21716,7 +21728,7 @@ server.tool(
   }
 );
 server.tool(
-  "schedule.create",
+  "schedule_create",
   "Create a new scheduled task. Supports cron expressions, intervals (every), and one-time reminders (at).",
   {
     name: external_exports.string().describe('Display name for the task (e.g. "Daily standup", "Check emails")'),
@@ -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".')
   },
@@ -21752,10 +21764,10 @@ server.tool(
   }
 );
 server.tool(
-  "schedule.delete",
+  "schedule_delete",
   "Delete a scheduled task by ID.",
   {
-    task_id: external_exports.string().describe("The task ID to delete (from schedule.list)")
+    task_id: external_exports.string().describe("The task ID to delete (from schedule_list)")
   },
   async (params) => {
     await apiPost("/host/schedules/delete", {
@@ -21768,12 +21780,17 @@ server.tool(
   }
 );
 server.tool(
-  "schedule.update",
+  "schedule_update",
   // Lead with user phrasings the agent should match against, then explain
   // the two modes. Order matters for tool selection.
-  'Update an existing scheduled task. USE THIS TOOL when the user says: "change the schedule for X", "run the daily report at 10am instead of 9am", "pause the standup schedule", "move the weekly digest to Mondays", "make this report more concise", "add a section about X to the daily summary", "tell the Y schedule to also cover Z", "post these to the Customer Success channel from now on". Two modes: (1) DIRECT FIELD UPDATES \u2014 set cron_expression/interval/timezone/delivery_channel/delivery_to/enabled/name/prompt to change those values directly. (2) LLM DESCRIPTION REWRITE \u2014 pass description_feedback to have the platform rewrite the task prompt based on natural-language feedback (e.g. "make this more concise" or "add a section about the team backlog"). Default for LLM rewrites is preview-then-apply: call once to get the proposed rewrite, show the diff to the user, call again with auto_apply=true on confirmation. Direct field updates apply immediately. The two modes are mutually exclusive \u2014 one request is EITHER a field update OR a description rewrite.\n\nIMPORTANT \u2014 `delivery_to` requires a Slack channel ID (e.g. `C0123ABC456`), NOT a human channel name. If the user references a channel by its name ("the Customer Success channel"), call `mcp__slack__slack.list_channels` first with `query: "customer success"` to get the matching `id`, then pass that id as `delivery_to` here. Do not guess channel ids.',
+  // CR PR #1601: field names + delivery_to shape brought into line with the
+  // actual zod schema below. The prior copy referenced `cron_expression` /
+  // `interval` (which the schema doesn't accept) and described
+  // `delivery_to` as a raw channel ID (it's a structured DeliveryTargetSchema
+  // object). Agents reading the old wording were producing invalid calls.
+  'Update an existing scheduled task. USE THIS TOOL when the user says: "change the schedule for X", "run the daily report at 10am instead of 9am", "pause the standup schedule", "move the weekly digest to Mondays", "make this report more concise", "add a section about X to the daily summary", "tell the Y schedule to also cover Z", "post these to the Customer Success channel from now on". Two modes: (1) DIRECT FIELD UPDATES \u2014 set schedule_expr/schedule_every/schedule_at/timezone/delivery_channel/delivery_to/enabled/name/prompt to change those values directly (pair the expression field with the matching schedule_kind: cron/every/at). (2) LLM DESCRIPTION REWRITE \u2014 pass description_feedback to have the platform rewrite the task prompt based on natural-language feedback (e.g. "make this more concise" or "add a section about the team backlog"). Default for LLM rewrites is preview-then-apply: call once to get the proposed rewrite, show the diff to the user, call again with auto_apply=true on confirmation. Direct field updates apply immediately. The two modes are mutually exclusive \u2014 one request is EITHER a field update OR a description rewrite.\n\nIMPORTANT \u2014 `delivery_to` is a structured target object, not a human channel name. If the user references a Slack channel by name ("the Customer Success channel"), call `mcp__slack__slack.list_channels` first with `query: "customer success"` to get the matching `id`, then pass `delivery_to: { kind: "channel", provider: "slack", channel_id: "<id>" }`. Do not guess channel ids.',
   {
-    task_id: external_exports.string().describe("The task ID to update (from schedule.list)"),
+    task_id: external_exports.string().describe("The task ID to update (from schedule_list)"),
     // Direct-field mode
     name: external_exports.string().optional().describe("New task display name"),
     schedule_kind: external_exports.enum(["cron", "every", "at"]).optional().describe(
@@ -21796,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"
@@ -21833,7 +21850,7 @@ server.tool(
       if (!data.applied) {
         lines.push("");
         lines.push("---");
-        lines.push("Show this diff to the user. If they confirm, call `schedule.update` again with the same `task_id` and `description_feedback` plus `auto_apply: true` to commit the change.");
+        lines.push("Show this diff to the user. If they confirm, call `schedule_update` again with the same `task_id` and `description_feedback` plus `auto_apply: true` to commit the change.");
       }
       return { content: [{ type: "text", text: lines.join("\n") }] };
     }
@@ -21846,8 +21863,8 @@ server.tool(
   }
 );
 server.tool(
-  "knowledge.list",
-  "List team knowledge entries (ids, titles, source types). Use before knowledge.add to check if a fact is already saved, or before knowledge.update/delete to find the target id. Returns metadata only \u2014 fetch the full content via the webapp if you need to read an entry back.",
+  "knowledge_list",
+  "List team knowledge entries (ids, titles, source types). Use before knowledge_add to check if a fact is already saved, or before knowledge_update/delete to find the target id. Returns metadata only \u2014 fetch the full content via the webapp if you need to read an entry back.",
   {},
   async () => {
     const data = await apiPost("/host/my-knowledge", {
@@ -21864,8 +21881,8 @@ server.tool(
   }
 );
 server.tool(
-  "knowledge.add",
-  "Save a new durable fact or learning to the team knowledge base. Use when the user explicitly asks you to save/remember something, or when you discover information that will be useful on future runs (e.g. a tenant id, an API key name, a company policy). Do NOT use for tasks (use kanban.add) or trivial one-off answers. Returns the new entry id so you can target it with knowledge.update / knowledge.delete.",
+  "knowledge_add",
+  "Save a new durable fact or learning to the team knowledge base. Use when the user explicitly asks you to save/remember something, or when you discover information that will be useful on future runs (e.g. a tenant id, an API key name, a company policy). Do NOT use for tasks (use kanban_add) or trivial one-off answers. Returns the new entry id so you can target it with knowledge_update / knowledge_delete.",
   {
     title: external_exports.string().describe("Short title summarising the entry (max 200 chars)"),
     content: external_exports.string().describe("The knowledge content \u2014 the actual fact, learning, or reference material"),
@@ -21903,10 +21920,10 @@ server.tool(
   }
 );
 server.tool(
-  "knowledge.update",
-  "Edit an existing knowledge entry by id. Use to correct a saved fact or refine its wording. Only the fields you pass are changed; others are left alone. Call knowledge.list first if you need to find the target id.",
+  "knowledge_update",
+  "Edit an existing knowledge entry by id. Use to correct a saved fact or refine its wording. Only the fields you pass are changed; others are left alone. Call knowledge_list first if you need to find the target id.",
   {
-    id: external_exports.string().describe("Knowledge entry id (uuid) \u2014 from knowledge.list or knowledge.add"),
+    id: external_exports.string().describe("Knowledge entry id (uuid) \u2014 from knowledge_list or knowledge_add"),
     title: external_exports.string().optional().describe("New title (max 200 chars). Regenerates the slug."),
     content: external_exports.string().optional().describe("Replacement content for the entry"),
     is_active: external_exports.boolean().optional().describe("Set false to soft-disable without deleting")
@@ -21914,7 +21931,7 @@ server.tool(
   async (params) => {
     if (params.title === void 0 && params.content === void 0 && params.is_active === void 0) {
       return {
-        content: [{ type: "text", text: "Error: knowledge.update needs at least one of title, content, or is_active." }],
+        content: [{ type: "text", text: "Error: knowledge_update needs at least one of title, content, or is_active." }],
         isError: true
       };
     }
@@ -21940,8 +21957,8 @@ server.tool(
   }
 );
 server.tool(
-  "knowledge.delete",
-  "Remove a knowledge entry permanently. Prefer knowledge.update with is_active=false for temporary hides; use delete only when the fact was wrong or no longer applies.",
+  "knowledge_delete",
+  "Remove a knowledge entry permanently. Prefer knowledge_update with is_active=false for temporary hides; use delete only when the fact was wrong or no longer applies.",
   {
     id: external_exports.string().describe("Knowledge entry id (uuid) to delete")
   },
@@ -21961,8 +21978,8 @@ server.tool(
   }
 );
 server.tool(
-  "plugin.list",
-  `List the plugins currently installed on this agent, with their current typed context values and a preview of any freeform overrides. Use this when the user asks "what plugins do I have?", "show me the plugins", "what is the Coding plugin configured with?", or before calling plugin.improve to see what fields exist and what they're set to.`,
+  "plugin_list",
+  `List the plugins currently installed on this agent, with their current typed context values and a preview of any freeform overrides. Use this when the user asks "what plugins do I have?", "show me the plugins", "what is the Coding plugin configured with?", or before calling plugin_improve to see what fields exist and what they're set to.`,
   {},
   async () => {
     const data = await apiPost("/host/list-plugins", {
@@ -21994,12 +22011,12 @@ server.tool(
       }
       lines.push("");
     }
-    lines.push("To update any plugin's behavior, use the `plugin.improve` tool with the user's feedback.");
+    lines.push("To update any plugin's behavior, use the `plugin_improve` tool with the user's feedback.");
     return { content: [{ type: "text", text: lines.join("\n") }] };
   }
 );
 server.tool(
-  "plugin.improve",
+  "plugin_improve",
   // Description leads with the user phrasings the agent should match against,
   // then explains the safety rule. Order matters — Claude\'s tool selection
   // weights the first line of a description heavily.
@@ -22055,7 +22072,7 @@ server.tool(
     if (!data.applied) {
       lines.push("");
       lines.push("---");
-      lines.push("Show this diff to the user. If they confirm, call `plugin.improve` again with `auto_apply: true` and the same arguments to apply.");
+      lines.push("Show this diff to the user. If they confirm, call `plugin_improve` again with `auto_apply: true` and the same arguments to apply.");
     } else {
       lines.push("");
       lines.push("Update applied. The manager will re-render the plugin's SKILL.md files on the next refresh cycle.");
@@ -22073,7 +22090,7 @@ var WidgetDefSchema = external_exports.object({
   refresh_cron: external_exports.string().optional().describe('Optional per-widget cron override (e.g. "0 6 * * *" for 6am daily).')
 });
 server.tool(
-  "dashboards.list",
+  "dashboards_list",
   'List dashboards visible to your team. Use to answer "what dashboards exist", "show me the dashboards I built", or before authoring a new one to avoid duplicating an existing slug.',
   {
     status: external_exports.enum(["draft", "active", "archived"]).optional().describe("Filter by status. Defaults to 'active'.")
@@ -22095,8 +22112,8 @@ ${lines.join("\n")}` }] };
   }
 );
 server.tool(
-  "dashboards.show",
-  "Get full metadata for one dashboard by slug \u2014 title, description, scope, status, widget list, last refresh per widget. Use when investigating a specific dashboard or before editing it via dashboards.upsert.",
+  "dashboards_show",
+  "Get full metadata for one dashboard by slug \u2014 title, description, scope, status, widget list, last refresh per widget. Use when investigating a specific dashboard or before editing it via dashboards_upsert.",
   {
     slug: external_exports.string().describe("Dashboard slug, e.g. 'finance-overview'.")
   },
@@ -22128,7 +22145,7 @@ URL: ${url}` : "",
   }
 );
 server.tool(
-  "dashboards.upsert",
+  "dashboards_upsert",
   // The description leads with the user phrasings the agent should match
   // against AND the explicit forbidden alternatives. Tool selection weights
   // the first sentence heavily, so we burn it on the right behavior.
@@ -22168,8 +22185,8 @@ URL: ${url}
   }
 );
 server.tool(
-  "dashboards.request_refresh",
-  "Mark widgets on a dashboard as needing refresh. Use this when authoring a new dashboard (to populate the first snapshot) or when you want widgets to update on the next dashboards.pending_refreshes call. Pass widget_id to flag just one widget; omit to flag every widget.",
+  "dashboards_request_refresh",
+  "Mark widgets on a dashboard as needing refresh. Use this when authoring a new dashboard (to populate the first snapshot) or when you want widgets to update on the next dashboards_pending_refreshes call. Pass widget_id to flag just one widget; omit to flag every widget.",
   {
     slug: external_exports.string(),
     widget_id: external_exports.string().optional().describe("Optional. Omit to flag all widgets on the dashboard."),
@@ -22189,8 +22206,8 @@ server.tool(
   }
 );
 server.tool(
-  "dashboards.pending_refreshes",
-  "Return widgets that need refresh \u2014 by default ONLY those flagged pending (user clicked \u21BB in the iframe, or someone called request_refresh). Pass slug=<dashboard slug> to instead get every widget on that dashboard so you can proactively refresh after authoring or when the user asks 'update the X dashboard'. Pass include_all=true with no slug to get every flagged-or-not widget across all your dashboards. Each entry: {slug, widget_id, kind, prompt, schema, requested_at}. Loop over them, read the prompt, gather data with your other tools, match the schema, and call dashboards.persist_widget for each.",
+  "dashboards_pending_refreshes",
+  "Return widgets that need refresh \u2014 by default ONLY those flagged pending (user clicked \u21BB in the iframe, or someone called request_refresh). Pass slug=<dashboard slug> to instead get every widget on that dashboard so you can proactively refresh after authoring or when the user asks 'update the X dashboard'. Pass include_all=true with no slug to get every flagged-or-not widget across all your dashboards. Each entry: {slug, widget_id, kind, prompt, schema, requested_at}. Loop over them, read the prompt, gather data with your other tools, match the schema, and call dashboards_persist_widget for each.",
   {
     slug: external_exports.string().optional().describe("Restrict to one dashboard by slug. When set, returns every widget on that dashboard \u2014 flagged or not \u2014 so you can refresh the whole thing without calling request_refresh first."),
     include_all: external_exports.boolean().optional().describe("When true (and no slug), returns every widget on every dashboard you own \u2014 flagged or not. Use sparingly; one refresh = one LLM call.")
@@ -22209,7 +22226,7 @@ server.tool(
   }
 );
 server.tool(
-  "dashboards.persist_widget",
+  "dashboards_persist_widget",
   "Persist refreshed data for one widget. The platform validates `data` against the widget's stored JSON Schema server-side \u2014 invalid output is rejected. Call this once per widget after gathering data with your tools.",
   {
     slug: external_exports.string(),
@@ -22238,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;
 }
@@ -22279,32 +22297,50 @@ async function forwardToolCall(toolName, args) {
     FORWARD_TOOL_CALL_TIMEOUT_MS
   );
 }
+var LOCAL_TOOL_NAMES = /* @__PURE__ */ new Set([
+  "kanban_list",
+  "kanban_add",
+  "kanban_move",
+  "kanban_update",
+  "kanban_progress",
+  "kanban_done",
+  "status_standup",
+  "status_update",
+  "drift_report",
+  "token_refresh",
+  "acpx_prompt",
+  "acpx_exec",
+  "acpx_spawn",
+  "acpx_cancel",
+  "acpx_status",
+  "acpx_close",
+  "schedule_list",
+  "schedule_create",
+  "schedule_delete",
+  "schedule_update",
+  "knowledge_list",
+  "knowledge_add",
+  "knowledge_update",
+  "knowledge_delete",
+  "plugin_list",
+  "plugin_improve",
+  "dashboards_list",
+  "dashboards_show",
+  "dashboards_upsert",
+  "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"
+]);
 async function registerForwardedApiTools() {
   const apiTools = await discoverApiTools();
-  const localToolNames = /* @__PURE__ */ new Set([
-    "kanban.list",
-    "kanban.add",
-    "kanban.move",
-    "kanban.update",
-    "kanban.progress",
-    "kanban.done",
-    "status.standup",
-    "status.update",
-    "drift.report",
-    "token.refresh",
-    "acpx.prompt",
-    "acpx.exec",
-    "acpx.spawn",
-    "acpx.cancel",
-    "knowledge.list",
-    "knowledge.search",
-    "knowledge.read",
-    "knowledge.add",
-    "knowledge.update",
-    "knowledge.delete",
-    "plugin.list",
-    "plugin.improve"
-  ]);
+  const localToolNames = LOCAL_TOOL_NAMES;
   let registered = 0;
   let skipped = 0;
   for (const tool of apiTools) {
@@ -22334,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. "agt-live")'),
+  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 {