@runeya/runeya 2.0.145 → 2.0.146

package/chunk-6IBPK6UE.js

@@ -0,0 +1,1063 @@
+import {
+  BUILTIN_VARIABLES,
+  BootstrapCommandSchema,
+  DockerConfigSchema,
+  HealthCheckSchema,
+  RestartStrategySchema,
+  ServiceCommandSchema,
+  ServiceConfigSchema,
+  ServiceShortcutSchema,
+  maskLogSourceSecrets
+} from "./chunk-MZSDTA4A.js";
+
+// ../../packages/ai-capabilities/src/trpc-caller.ts
+async function callTrpc(baseUrl, route, method, input, authToken, fetchImpl = fetch) {
+  const headers = {
+    "Content-Type": "application/json",
+    "Authorization": `Bearer ${authToken}`
+  };
+  const url = method === "GET" && input ? `${baseUrl}/api/trpc/${route}?input=${encodeURIComponent(JSON.stringify(input))}` : `${baseUrl}/api/trpc/${route}`;
+  const res = await fetchImpl(url, {
+    method,
+    headers,
+    ...method === "POST" ? { body: JSON.stringify(input ?? {}) } : {},
+    signal: AbortSignal.timeout(15e3)
+  });
+  const json = await res.json();
+  if (json["error"]) throw new Error(JSON.stringify(json["error"]));
+  const result = json["result"];
+  return result?.["data"] ?? result ?? json;
+}
+async function runCapability(cap, baseUrl, params, authToken, fetchImpl = fetch) {
+  const result = await callTrpc(baseUrl, cap.route, cap.method, cap.buildInput(params), authToken, fetchImpl);
+  return cap.transformOutput ? cap.transformOutput(result) : result;
+}
+
+// ../../packages/ai-capabilities/src/capabilities.ts
+import { z } from "zod";
+function toList(raw) {
+  if (!raw) return [];
+  const text = raw.trim();
+  if (text.startsWith("[")) {
+    try {
+      const parsed = JSON.parse(text);
+      if (Array.isArray(parsed)) return parsed.map((v) => String(v).trim()).filter(Boolean);
+    } catch {
+    }
+  }
+  return text.split(",").map((v) => v.trim().replace(/^["'[]+|["'\]]+$/g, "")).filter(Boolean);
+}
+function clearable(raw, parse, key) {
+  if (raw === void 0) return {};
+  const text = String(raw).trim();
+  if (!text || text === "null") return { [key]: null };
+  return { [key]: parse(text) };
+}
+function gitTarget(p) {
+  return {
+    ...p.serviceId ? { serviceId: p.serviceId } : {},
+    ...p.projectId ? { projectId: p.projectId } : {},
+    ...p.agentId ? { agentId: p.agentId } : {},
+    ...p.orgId ? { orgId: p.orgId } : {}
+  };
+}
+var toBool = (raw) => raw.trim().toLowerCase() === "true";
+var newId = () => globalThis.crypto.randomUUID();
+function listItem(raw) {
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return raw;
+  }
+}
+function parseTyped(name, schema, raw) {
+  if (raw === void 0) return void 0;
+  let result = raw.trim() === "null" ? schema.safeParse(null) : schema.safeParse(raw);
+  if (!result.success && raw.trim() === "null") result = schema.safeParse(raw);
+  if (!result.success) {
+    const text = raw.trim();
+    const json = listItem(text);
+    if (json !== text) result = schema.safeParse(json);
+    if (!result.success && !/^[[{]/.test(text)) {
+      const list = schema.safeParse(toList(text).map(listItem));
+      if (list.success) result = list;
+    }
+  }
+  if (!result.success) throw new Error(`${name}: ${z.prettifyError(result.error)}`);
+  return result.data;
+}
+function withIds(items) {
+  return items.map((item) => ({ ...item, id: item.id || newId() }));
+}
+var optionalId = (schema) => schema.extend({ id: z.string().min(1).max(64).optional() });
+var DockerConfigInput = DockerConfigSchema.extend({
+  bootstrapCommands: z.array(optionalId(BootstrapCommandSchema)).max(20).default([])
+}).refine((c) => !!c.image !== !!c.dockerfile, {
+  message: 'dockerConfig needs exactly one of "image" (an image to pull) or "dockerfile" (a Dockerfile to build)'
+});
+var SERVICE_FIELDS = [
+  { name: "description", description: "What the service is, in a sentence" },
+  { name: "agentId", description: "The agent that runs it, from list_agents. Omit to inherit from the environment.", clearable: true },
+  { name: "cwd", description: `Working directory, RELATIVE to the project root (e.g. "apps/web", or omit for the root). The project is synced between machines and lives in a different folder on each: Runeya resolves a relative cwd against each machine's own project folder, while an absolute path (/home/you/\u2026) breaks on every other machine. Use an absolute path only for something outside the project, written with ~ or an environment variable ($NAME) rather than a literal home directory.`, clearable: true },
+  { name: "command", description: 'Shortcut for a single command line (e.g. "npm run dev"). Replaces every existing command. Use commands for several.' },
+  { name: "commands", description: 'The processes of the service. They all start AT THE SAME TIME, in parallel, and the service runs while they run \u2014 not one after another. Use several for processes that live side by side (a web server and a worker). Steps that must follow each other (build, then install, then launch) go in ONE command chained with &&. A one-off action the user triggers by hand (build, deploy, read logs) is a shortcut, not a command. Each command runs in the service cwd, or its own "cwd", relative to the project root. No absolute paths of this machine: the service is synced to other machines. Replaces every existing command. "id" is generated when omitted; "shell" runs the line through a shell (default true).', schema: z.array(optionalId(ServiceCommandSchema)).max(50) },
+  { name: "ports", description: "Ports the service listens on. Declare them: they become {{service.PORT}}, {{service.URL}} and {{services.<slug>.URL}} for the other services, which environment variables should reference instead of repeating the numbers.", schema: ServiceConfigSchema.shape.ports.unwrap().unwrap() },
+  { name: "groups", description: "Groups the service belongs to. Replaces the current ones.", schema: ServiceConfigSchema.shape.groups.unwrap().unwrap() },
+  { name: "url", description: "URL where the service is reached" },
+  { name: "localUrls", description: 'Local domain names routed to a port of the service (e.g. {"url":"api.localhost.dev","port":3000})', schema: ServiceConfigSchema.shape.localUrls.unwrap().unwrap() },
+  { name: "openapiUrl", description: "URL of its OpenAPI document" },
+  { name: "docsPath", description: "Where its markdown docs live, relative to cwd or absolute. Defaults to cwd." },
+  { name: "git", description: 'Its git repository: "remote" URL and "home" page', schema: ServiceConfigSchema.shape.git.unwrap(), clearable: true },
+  { name: "meta", description: "Free key/value metadata (strings)", schema: ServiceConfigSchema.shape.meta.unwrap(), clearable: true },
+  { name: "runner", description: '"native" runs the commands on the machine; "docker" runs the service in a container and then needs dockerConfig', schema: ServiceConfigSchema.shape.runner.unwrap().unwrap() },
+  { name: "dockerConfig", description: 'With runner "docker": the container. Exactly one of "image" (pull) or "dockerfile" (inline Dockerfile, built with "buildContext", "buildArgs", "targetStage"). Ports and volumes use Docker syntax ("8080:80", "./data:/data"); host paths in volumes relative to the service directory, never an absolute path of this machine. "useNativeCommand" runs the service commands inside the container instead of its CMD ("nativeCommandMode": one shared container or one per command). "bootstrapCommands" run once when the container starts. Replaces the whole Docker configuration: read it first with get_service to keep what you do not change.', schema: DockerConfigInput },
+  { name: "healthCheck", description: 'How to tell the service is ready: an HTTP "path" to call, or a "command" that must succeed', schema: HealthCheckSchema, clearable: true },
+  { name: "autoRestart", description: "Restart the service when it crashes", schema: z.boolean() },
+  { name: "restartStrategy", description: "When to restart it", schema: RestartStrategySchema.unwrap() },
+  { name: "maxRestarts", description: "Give up after this many restarts", schema: ServiceConfigSchema.shape.maxRestarts.unwrap() },
+  { name: "restartBackoffMs", description: "Delay before a restart, in milliseconds", schema: ServiceConfigSchema.shape.restartBackoffMs.unwrap().unwrap() },
+  { name: "clearLogsOnStart", description: "Clear the logs each time the service starts", schema: z.boolean() },
+  { name: "shortcuts", description: 'One-click actions shown on the service, run on demand and independently of the running commands (build, deploy, migrate, read logs). Same path rules as commands: relative to the project root, never an absolute path of this machine. Replaces the current ones. "id" is generated when omitted.', schema: z.array(optionalId(ServiceShortcutSchema)).max(50) },
+  { name: "parserIds", description: "Log parsers applied to its output, by id", schema: ServiceConfigSchema.shape.parserIds.unwrap() },
+  { name: "logSources", description: 'Extra log sources beyond the console output (files, databases\u2026). Replaces the current ones. Credentials (mongo connectionString, mysql password) read as "***": send "***" back to keep the stored value, or the real value to change it.', schema: ServiceConfigSchema.shape.logSources.unwrap().unwrap() }
+];
+function serviceParams(clearable2) {
+  return SERVICE_FIELDS.map((f) => {
+    const nullable = clearable2 && f.clearable;
+    const base = f.schema ?? (nullable ? z.string() : void 0);
+    return {
+      name: f.name,
+      description: nullable ? `${f.description} null clears it.` : f.description,
+      required: false,
+      ...base ? { schema: nullable ? base.nullable() : base } : {}
+    };
+  });
+}
+function serviceFields(p, params) {
+  const out = {};
+  for (const param of params) {
+    if (p[param.name] === void 0 || param.name === "command") continue;
+    out[param.name] = param.schema ? parseTyped(param.name, param.schema, p[param.name]) : p[param.name];
+  }
+  if (p.command !== void 0 && p.commands === void 0) out["commands"] = [{ label: "", command: p.command, shell: true }];
+  if (Array.isArray(out["commands"])) out["commands"] = withIds(out["commands"]);
+  if (Array.isArray(out["shortcuts"])) out["shortcuts"] = withIds(out["shortcuts"]);
+  const docker = out["dockerConfig"];
+  if (docker?.bootstrapCommands) out["dockerConfig"] = { ...docker, bootstrapCommands: withIds(docker.bootstrapCommands) };
+  return out;
+}
+function maskServices(result) {
+  if (Array.isArray(result)) return result.map(maskServices);
+  if (result && typeof result === "object" && Array.isArray(result.logSources)) {
+    const service = result;
+    return { ...service, logSources: maskLogSourceSecrets(service.logSources) };
+  }
+  return result;
+}
+var refs = (scope) => BUILTIN_VARIABLES.filter((b) => b.scope === scope).map((b) => `{{${b.name}}}`).join(", ");
+var BUILTINS_HELP = `Built-in references Runeya fills itself \u2014 filled when the service is deployed, from the service that receives the variable: ${refs("server")}, the numbered {{service.PORT_2}} / {{service.URL_2}}\u2026 for its other ports, and {{services.<slug>.PORT}}, .URL, .BASE_URL, .NAME, .ID for a sibling service of the project (slug = its name in lowercase-dashes). Filled on the machine when the service starts: ${refs("agent")}.`;
+var CREATE_SERVICE_PARAMS = serviceParams(false);
+var UPDATE_SERVICE_PARAMS = serviceParams(true);
+var RUNEYA_CAPABILITIES = [
+  {
+    name: "list_services",
+    transformOutput: maskServices,
+    description: "List services, with the serviceId and agentId to use in other calls. Pass the projectId your context names to stay on the project the user is looking at, or another one from list_projects to look elsewhere. Called with no project, this can answer for every project of every organization on the machine \u2014 far more than the interface shows.",
+    route: "service.list",
+    method: "GET",
+    params: [
+      { name: "projectId", description: "Restrict to this project, from list_projects. Omit to list every service on the machine.", required: false },
+      { name: "orgId", description: "With projectId: its organization, needed only when the same project id exists in several. Alone: list the services of this whole organization.", required: false }
+    ],
+    // `orgId` seul est une portée à part entière, que `service.list` sait filtrer :
+    // l'omettre rendait toute la machine.
+    buildInput: (p) => {
+      if (p.projectId) return { projectId: p.projectId, ...p.orgId ? { orgId: p.orgId } : {} };
+      return p.orgId ? { orgId: p.orgId } : void 0;
+    }
+  },
+  {
+    name: "get_service_status",
+    description: "Get the current status (running, stopped, etc.) of a service. A service that has never been started on this agent has no process yet, and this answers 404 Process not found \u2014 that means STOPPED, not forbidden and not missing. Start it, or read its configuration with get_service.",
+    route: "process.get",
+    method: "GET",
+    params: [
+      { name: "serviceId", description: "The service ID", required: true },
+      { name: "agentId", description: "The agent ID hosting this service", required: true }
+    ],
+    buildInput: (p) => ({ agentId: p.agentId, id: p.serviceId })
+  },
+  {
+    name: "get_logs",
+    description: "Get the recent buffered logs for a service.",
+    route: "process.logs",
+    method: "GET",
+    params: [
+      { name: "serviceId", description: "The service ID", required: true },
+      { name: "agentId", description: "The agent ID hosting this service", required: true }
+    ],
+    buildInput: (p) => ({ agentId: p.agentId, processId: p.serviceId })
+  },
+  {
+    name: "start_service",
+    description: "Start a service on an agent.",
+    route: "process.start",
+    method: "POST",
+    params: [
+      { name: "serviceId", description: "The service ID to start", required: true },
+      { name: "agentId", description: "The agent ID hosting this service", required: true }
+    ],
+    buildInput: (p) => ({ agentId: p.agentId, processId: p.serviceId }),
+    destructive: true
+  },
+  {
+    name: "stop_service",
+    description: "Stop a running service on an agent.",
+    route: "process.stop",
+    method: "POST",
+    params: [
+      { name: "serviceId", description: "The service ID to stop", required: true },
+      { name: "agentId", description: "The agent ID hosting this service", required: true }
+    ],
+    buildInput: (p) => ({ agentId: p.agentId, processId: p.serviceId }),
+    destructive: true
+  },
+  {
+    name: "restart_service",
+    description: "Restart a service on an agent (stop \u2192 redeploy \u2192 start).",
+    route: "process.restart",
+    method: "POST",
+    params: [
+      { name: "serviceId", description: "The service ID to restart", required: true },
+      { name: "agentId", description: "The agent ID hosting this service", required: true }
+    ],
+    buildInput: (p) => ({ agentId: p.agentId, processId: p.serviceId }),
+    destructive: true
+  },
+  // ─── Utility ─────────────────────────────────────────────────────────────
+  {
+    name: "wait",
+    description: "Wait for a given number of milliseconds before continuing.",
+    route: "utility.wait",
+    method: "POST",
+    params: [
+      { name: "ms", description: "Number of MILLISECONDS to wait. Convert from seconds: 1s=1000, 10s=10000, 1min=60000. Max 300000.", required: true }
+    ],
+    buildInput: (p) => ({ ms: Number(p.ms) }),
+    usageHint: '"wait 5s" \u2192 wait(ms=5000), "pause 10 seconds" \u2192 wait(ms=10000), "attends 3 secondes" \u2192 wait(ms=3000). Always convert to milliseconds.'
+  },
+  // ─── Kanban ───────────────────────────────────────────────────────────────
+  {
+    name: "kanban_list_boards",
+    description: "List the kanban boards of the organization. Returns the organizationId actually queried, the boardId to use in the other kanban tools, plus column and card counts. Cards themselves are not included \u2014 use kanban_get_board for those. An empty list means that organization really has no board: a failure to reach the cloud is reported as an error instead, never as an empty list.",
+    route: "kanban.listBoards",
+    method: "GET",
+    params: [
+      { name: "includeArchived", description: 'Set to "true" to include archived boards. Default: false.', required: false },
+      { name: "organizationId", description: "Which organization to read. Optional: needed only when the account belongs to several and the error message asks for it.", required: false }
+    ],
+    buildInput: (p) => ({
+      includeArchived: p.includeArchived === "true",
+      ...p.organizationId ? { organizationId: p.organizationId } : {}
+    })
+  },
+  {
+    name: "kanban_get_board",
+    description: "Read one kanban board: its columns, and the cards in each (id, title, markdown body, assignees, comment count, and attachment metadata \u2014 use kanban_download_attachment to fetch the bytes of a file). Use the exact column names it returns when moving or adding a card.",
+    route: "kanban.getBoard",
+    method: "GET",
+    params: [
+      { name: "boardId", description: "The kanban board ID, from kanban_list_boards", required: true }
+    ],
+    buildInput: (p) => ({ boardId: p.boardId })
+  },
+  {
+    name: "kanban_get_card_comments",
+    description: "Read the comment thread of one kanban card, newest last: who wrote each comment (ai or user, with the person's name), when, its text, and its attachments. The comments in your task context are a snapshot taken when the task started \u2014 call this to see anything written since, whenever someone tells you a comment was added or kanban_get_board reports a higher commentCount than you have.",
+    route: "kanban.getCardComments",
+    method: "GET",
+    params: [
+      { name: "boardId", description: "The kanban board ID", required: true },
+      { name: "cardId", description: "The card ID whose comments to read", required: true },
+      { name: "limit", description: "How many of the most recent comments to return (1-200). Default: 50.", required: false }
+    ],
+    buildInput: (p) => ({
+      boardId: p.boardId,
+      cardId: p.cardId,
+      ...p.limit ? { limit: Number(p.limit) } : {}
+    }),
+    usageHint: '"le support a ajout\xE9 un commentaire" / "regarde les nouveaux commentaires" \u2192 kanban_get_card_comments(boardId, cardId). Never answer from the snapshot in your context when fresh comments are mentioned.'
+  },
+  {
+    name: "kanban_search_cards",
+    description: 'Search kanban cards by free text, matched against their title, body, comments and the support conversations they follow (title, messages, internal notes, and the names of message authors) \u2014 accent- and case-insensitive. Archived cards are included. Searches every board of the organization unless boardId narrows it down. createdBy narrows to the cards someone created ("les cartes cr\xE9\xE9es par Isabelle"), alone or with a query.',
+    route: "kanban.searchCards",
+    method: "GET",
+    params: [
+      { name: "query", description: "Text to look for in card titles, bodies, comments and followed conversations. Optional when createdBy is given.", required: false },
+      { name: "createdBy", description: "Only cards created by this author: a user id, or a name (accent- and case-insensitive, partial match).", required: false },
+      { name: "boardId", description: "Restrict the search to this board. Omit to search all boards.", required: false },
+      { name: "limit", description: "Maximum number of cards to return (1-100). Default: 25.", required: false },
+      { name: "organizationId", description: "Which organization to search. Optional: needed only when the account belongs to several and the error message asks for it.", required: false }
+    ],
+    buildInput: (p) => ({
+      ...p.query ? { query: p.query } : {},
+      ...p.createdBy ? { createdBy: p.createdBy } : {},
+      ...p.boardId ? { boardId: p.boardId } : {},
+      ...p.limit ? { limit: Number(p.limit) } : {},
+      ...p.organizationId ? { organizationId: p.organizationId } : {}
+    })
+  },
+  {
+    name: "kanban_download_attachment",
+    description: "Download a kanban card attachment (image, PDF, any file) onto this machine and return its local path, so it can be opened with file-reading tools. Attachment ids come from the card context, from kanban_get_board, or from kanban_get_card_comments \u2014 a file attached to a comment downloads exactly like one attached to the card.",
+    route: "kanban.downloadAttachment",
+    method: "POST",
+    params: [
+      { name: "attachmentId", description: "The attachment ID, as listed on the card", required: true },
+      { name: "boardId", description: "The board the attachment comes from. Pass it whenever you know it: on a machine linked to several cloud accounts, it is what says which one holds the file.", required: false },
+      { name: "organizationId", description: "Which organization the attachment belongs to. Optional: needed only when neither the board id is known nor the machine has a single account.", required: false }
+    ],
+    buildInput: (p) => ({
+      attachmentId: p.attachmentId,
+      ...p.boardId ? { boardId: p.boardId } : {},
+      ...p.organizationId ? { orgId: p.organizationId } : {}
+    })
+  },
+  {
+    name: "kanban_move_card",
+    description: "Move a kanban card to another column. Use the exact column name.",
+    route: "kanban.moveCard",
+    method: "POST",
+    params: [
+      { name: "boardId", description: "The kanban board ID", required: true },
+      { name: "cardId", description: "The card ID to move", required: true },
+      { name: "targetColumn", description: "Exact name of the target column", required: true }
+    ],
+    buildInput: (p) => ({ boardId: p.boardId, cardId: p.cardId, targetColumn: p.targetColumn })
+  },
+  {
+    name: "kanban_add_comment",
+    description: "Add a comment to a kanban card.",
+    route: "kanban.addComment",
+    method: "POST",
+    params: [
+      { name: "boardId", description: "The kanban board ID", required: true },
+      { name: "cardId", description: "The card ID", required: true },
+      { name: "comment", description: "The comment text (markdown supported)", required: true }
+    ],
+    buildInput: (p) => ({ boardId: p.boardId, cardId: p.cardId, comment: p.comment })
+  },
+  {
+    name: "kanban_get_card_conversations",
+    description: "Read the customer support conversations (Intercom\u2026) linked to one kanban card: for each, its title, provider, state (open/resolved), link, the opening message and the thread of messages (author name, customer or team, internal note or not, date, text, attached files \u2014 fetch their bytes with kanban_download_attachment), plus the other cards following the same conversation. These messages are NOT comments of the card \u2014 read them here.",
+    route: "kanban.getCardConversations",
+    method: "GET",
+    params: [
+      { name: "boardId", description: "The kanban board ID", required: true },
+      { name: "cardId", description: "The card ID whose conversations to read", required: true },
+      { name: "limit", description: "How many of the most recent messages to return per conversation (1-500). Default: 100.", required: false }
+    ],
+    buildInput: (p) => ({
+      boardId: p.boardId,
+      cardId: p.cardId,
+      ...p.limit ? { limit: Number(p.limit) } : {}
+    }),
+    usageHint: `"regarde la conversation Intercom de la carte" / "qu'a dit le client" \u2192 kanban_get_card_conversations(boardId, cardId).`
+  },
+  {
+    name: "kanban_search_conversations",
+    description: "Search customer support conversations (Intercom\u2026) at the providers connected to the board's organization, by words of the conversation title, or by conversation number or URL. Read-only at the provider. Each result gives connectionId and externalId (needed to link it), title, state, a preview and the cards already following it.",
+    route: "kanban.searchConversations",
+    method: "GET",
+    params: [
+      { name: "boardId", description: "Any kanban board ID of the organization to search in", required: true },
+      { name: "query", description: "Words of the conversation title, a conversation number, or a conversation URL", required: true }
+    ],
+    buildInput: (p) => ({ boardId: p.boardId, query: p.query })
+  },
+  {
+    name: "kanban_link_conversation",
+    description: "Link a customer support conversation found with kanban_search_conversations to a kanban card. Its whole thread is imported and new messages keep arriving on the card. A conversation can be linked to several cards. Nothing is written at the provider.",
+    route: "kanban.linkConversation",
+    method: "POST",
+    params: [
+      { name: "boardId", description: "The kanban board ID of the card", required: true },
+      { name: "cardId", description: "The card to link the conversation to", required: true },
+      { name: "connectionId", description: "The connectionId of the search result", required: true },
+      { name: "externalId", description: "The externalId of the search result", required: true }
+    ],
+    buildInput: (p) => ({ boardId: p.boardId, cardId: p.cardId, connectionId: p.connectionId, externalId: p.externalId })
+  },
+  {
+    name: "kanban_get_card_links",
+    description: "Read the filiation of a board: which card depends on which. Returns one entry per link (child card \u2194 parent card), plus the title, board, column, assignees and comment count of any linked card living on another board. Use it when a card context says it has a parent or sub-cards and you need their ids to read them.",
+    route: "kanban.getCardLinks",
+    method: "GET",
+    params: [
+      { name: "boardId", description: "The kanban board ID whose links to read", required: true }
+    ],
+    buildInput: (p) => ({ boardId: p.boardId })
+  },
+  {
+    name: "kanban_set_card_parent",
+    description: "Link a kanban card to a parent card, or detach it. The parent is the card the other one depends on \u2014 an epic and its tasks, a bug and its follow-ups. A card has at most one parent, and setting a new one replaces it. Omit parentCardId to detach. kanban_get_board reports the current filiation as parentCardId / childCardIds on each card.",
+    route: "kanban.setCardParent",
+    method: "POST",
+    params: [
+      { name: "boardId", description: "The kanban board ID of the card being linked", required: true },
+      { name: "cardId", description: "The card that depends on the parent (the child)", required: true },
+      { name: "parentCardId", description: "The parent card ID. Omit to detach the card from its parent.", required: false },
+      { name: "parentBoardId", description: "The parent's board, when it lives on another board of the same organization. Defaults to boardId.", required: false }
+    ],
+    buildInput: (p) => ({
+      boardId: p.boardId,
+      cardId: p.cardId,
+      ...p.parentCardId ? { parentCardId: p.parentCardId } : {},
+      ...p.parentBoardId ? { parentBoardId: p.parentBoardId } : {}
+    })
+  },
+  {
+    name: "kanban_place_card",
+    description: "Place an existing kanban card on another board of the same organization, without copying it \u2014 a reference. The card stays on its origin board; the target board gives it a column of its own. Editing, commenting, archiving or deleting the card from either board acts on the same card; moving it on the target board only moves the reference. Use it to show an issue from an issue list on a team kanban, for instance.",
+    route: "kanban.placeCard",
+    method: "POST",
+    params: [
+      { name: "boardId", description: "The board to place the card on (not its own board)", required: true },
+      { name: "cardId", description: "The card to place", required: true },
+      { name: "column", description: "The column on that board: its ID or its title", required: true }
+    ],
+    buildInput: (p) => ({ boardId: p.boardId, cardId: p.cardId, column: p.column })
+  },
+  {
+    name: "kanban_remove_card_placement",
+    description: "Remove a card from a board where it was placed as a reference. The card itself is untouched and stays on its origin board.",
+    route: "kanban.unplaceCard",
+    method: "POST",
+    params: [
+      { name: "boardId", description: "The board the reference is on", required: true },
+      { name: "cardId", description: "The card to remove from that board", required: true }
+    ],
+    buildInput: (p) => ({ boardId: p.boardId, cardId: p.cardId })
+  },
+  {
+    name: "kanban_get_card_placements",
+    description: "List where a kanban card is: its origin board (home: true), then every board it is placed on as a reference, with the column on each. kanban_get_board flags a referenced card with an `origin` field naming its origin board.",
+    route: "kanban.getCardPlacements",
+    method: "GET",
+    params: [
+      { name: "boardId", description: "Any board the card is on", required: true },
+      { name: "cardId", description: "The card", required: true }
+    ],
+    buildInput: (p) => ({ boardId: p.boardId, cardId: p.cardId })
+  },
+  {
+    name: "kanban_add_card",
+    description: "Add a new card to a kanban column.",
+    route: "kanban.addCard",
+    method: "POST",
+    params: [
+      { name: "boardId", description: "The kanban board ID", required: true },
+      { name: "column", description: "Exact name of the target column", required: true },
+      { name: "title", description: "Card title", required: true },
+      { name: "content", description: "Card content in markdown", required: false }
+    ],
+    buildInput: (p) => ({ boardId: p.boardId, column: p.column, title: p.title, content: p.content })
+  },
+  {
+    name: "kanban_get_card",
+    description: "Read one kanban card by id, including archived ones. Cheaper than fetching the whole board, and the only way to read a card that has been archived.",
+    route: "kanban.getCard",
+    method: "GET",
+    params: [
+      { name: "boardId", description: "The kanban board ID", required: true },
+      { name: "cardId", description: "The card ID", required: true }
+    ],
+    buildInput: (p) => ({ boardId: p.boardId, cardId: p.cardId })
+  },
+  {
+    name: "kanban_get_card_context",
+    description: "Load the working context of a kanban card: the card, the board's columns, the team's guidelines for the board and the expected ending (move the card if needed, then comment). Call it first when the user asks you to work on a card, then follow it. It is the context a session started from the card in Runeya receives.",
+    route: "kanban.cardContext",
+    method: "GET",
+    params: [
+      { name: "boardId", description: "The kanban board ID", required: true },
+      { name: "cardId", description: "The card ID", required: true },
+      { name: "projectId", description: "The project the work happens in, named in the context. Optional.", required: false },
+      { name: "orgId", description: "Its organization. Optional.", required: false }
+    ],
+    buildInput: (p) => ({
+      boardId: p.boardId,
+      cardId: p.cardId,
+      ...p.projectId ? { projectId: p.projectId } : {},
+      ...p.orgId ? { orgId: p.orgId } : {}
+    })
+  },
+  {
+    name: "kanban_update_card",
+    description: "Update an existing kanban card. Only the fields you pass are changed; passing null to priority, color or deadline clears it. Prefer this over creating a second card when something needs correcting.",
+    route: "kanban.updateCard",
+    method: "POST",
+    params: [
+      { name: "boardId", description: "The kanban board ID", required: true },
+      { name: "cardId", description: "The card ID", required: true },
+      { name: "title", description: "New title", required: false },
+      { name: "content", description: "New card content, in markdown", required: false },
+      { name: "priority", description: "Priority from 1 to 10, or null to clear it", required: false },
+      { name: "color", description: "Card colour, or null to clear it", required: false },
+      { name: "groups", description: "Labels, as a list of strings. Replaces the current ones.", required: false },
+      { name: "deadline", description: "Due date as YYYY-MM-DD, or null to clear it", required: false },
+      { name: "assignees", description: "User ids to assign, as a list. Replaces the current ones; use kanban_list_members to find the ids.", required: false }
+    ],
+    buildInput: (p) => ({
+      boardId: p.boardId,
+      cardId: p.cardId,
+      ...p.title !== void 0 ? { title: p.title } : {},
+      ...p.content !== void 0 ? { content: p.content } : {},
+      // Tout arrive en chaîne : un modèle n'écrit pas des nombres, des listes
+      // ni des `null` typés. `clearable` distingue « efface » de « ne touche
+      // pas » — sans quoi vider une couleur serait impossible à exprimer, et
+      // changer un titre risquerait de vider le reste.
+      ...clearable(p.priority, (v) => Number(v), "priority"),
+      ...clearable(p.color, (v) => v, "color"),
+      ...clearable(p.deadline, (v) => v, "deadline"),
+      ...p.groups !== void 0 ? { groups: toList(p.groups) } : {},
+      ...p.assignees !== void 0 ? { assignees: toList(p.assignees) } : {}
+    })
+  },
+  {
+    name: "kanban_set_card_archived",
+    description: "Archive a kanban card (it leaves the board but is not deleted) or bring it back. An unarchived card returns to the column it left.",
+    route: "kanban.setCardArchived",
+    method: "POST",
+    params: [
+      { name: "boardId", description: "The kanban board ID", required: true },
+      { name: "cardId", description: "The card ID", required: true },
+      { name: "archived", description: "true to archive, false to bring the card back", required: true }
+    ],
+    buildInput: (p) => ({ boardId: p.boardId, cardId: p.cardId, archived: p.archived === "true" })
+  },
+  {
+    name: "kanban_list_members",
+    description: "List the people of the organization who can be assigned to a card, with their ids. Needed before assigning anyone with kanban_update_card.",
+    route: "kanban.listMembers",
+    method: "GET",
+    params: [
+      { name: "organizationId", description: "Which organization. Optional: needed only when the account belongs to several and the error message asks for it.", required: false }
+    ],
+    buildInput: (p) => p.organizationId ? { organizationId: p.organizationId } : {}
+  },
+  // ─── Lecture seule ───────────────────────────────────────────────────────
+  //
+  // Tout ce qui se consulte sans rien changer. Les écritures s'ajoutent au cas
+  // par cas : aujourd'hui les services et leurs variables, plus bas.
+  //
+  // Volontairement absentes, et à ne pas ajouter sans y regarder à deux fois,
+  // parce qu'elles rendent un secret : `environment.list` / `get` / `resolve` /
+  // `resolveFlat` (un `Environment` porte ses variables, valeurs comprises),
+  // `apiKeys.list` / `reveal`, `setup.getEncryptionKeyHex` et `getOrgKeys`
+  // (clés de chiffrement), `settings.get` et `settings.listAIProviders` (clés
+  // de fournisseurs d'IA — `settings.getPaths` et `getNetwork`, eux, ne
+  // rendent que des chemins et une adresse, d'où leur présence ci-dessous),
+  // `cloudAuth.session`, `agent.getPassthroughEnv`. Un agent n'a pas besoin de
+  // ces valeurs pour travailler, et ce qu'il lit finit dans une transcription.
+  //
+  // La seule exception est `service.getEnv` (`get_service_env` ci-dessous),
+  // et elle n'en est une que parce qu'elle filtre : les variables publiques, et
+  // les seuls secrets que leur auteur a partagés avec les IA (`isSharedWithAi`
+  // — « Lisible par l'IA », ou l'injection, qui vaut la lecture). Un secret non
+  // partagé n'y apparaît pas, pas même par son nom.
+  {
+    name: "list_processes",
+    description: "List every process across all agents with its current state (running, stopped, exit code, uptime). Use this to see the whole machine at once, rather than calling get_service_status service by service. An agent only learns about a service when it is first started, so this lists what is deployed, not what is configured: an empty list means nothing has been started, not that you cannot see them \u2014 list_services shows what exists.",
+    route: "process.list",
+    method: "GET",
+    params: [],
+    buildInput: () => void 0
+  },
+  {
+    name: "get_service",
+    transformOutput: maskServices,
+    description: "Read the full configuration of one service: its commands, ports, groups, runner, log sources and restart policy. list_services gives the ids.",
+    route: "service.get",
+    method: "GET",
+    params: [
+      { name: "serviceId", description: "The service ID", required: true }
+    ],
+    buildInput: (p) => ({ id: p.serviceId })
+  },
+  {
+    name: "get_service_env",
+    description: 'Read the environment variables a service runs with, and the project\'s variable inventory. `env` lists every key the service receives; a value reads "***" when it is a secret whose author did not share it with AI (sharing = ticking "AI read", or injecting it into the agents\' environment, which grants reading too). `envSecrets` says which keys are secret, `hiddenKeys` which ones are masked. A masked key is set on the service: never treat it as missing, never suggest adding it, and never pass "***" as a value \u2014 ask the user for it. `variables` describes every variable of the project \u2014 which environment defines it and its scope, its description, its flags, whether this machine overrides it, and `inService: false` for the ones this service does not receive. Use it to say where a variable must be changed instead of guessing. On an overridden variable, `sharedValue` is what the machine-local override replaces (the team\'s value, masked as "***" when unreadable); no other value appears there. This is the resolver: the values are what the service would receive \u2014 inheritance, {{environment.KEY}} references, this machine\'s overrides and server built-ins applied; agent built-ins stay as written until the service starts. Use it to check a variable you just composed. `unresolvedReferences` lists references nothing will fill (a typo, a variable that does not exist): fix them.',
+    route: "service.getEnv",
+    method: "GET",
+    params: [
+      { name: "serviceId", description: "The service ID", required: true },
+      { name: "environmentId", description: "A global environment of the project to resolve in instead of the active one, without activating it (from list_environments). Omit for the active one.", required: false }
+    ],
+    buildInput: (p) => ({ id: p.serviceId, ...p.environmentId ? { environmentId: p.environmentId } : {} })
+  },
+  // ─── Écrire un service et ses variables ────────────────────────────────────
+  //
+  // Les variables s'écrivent à l'aveugle (`environment.setVariableBlind`) : une
+  // IA remplace la valeur d'un secret sans la lire, et ne peut ni le rendre
+  // public, ni le partager avec les IA. La règle tient côté serveur, dans la
+  // route ; ces outils ne passent jamais par une route qui renvoie des valeurs
+  // (`upsertVariable`, `removeVariable`, `update` rendent l'environnement entier).
+  {
+    name: "create_service",
+    transformOutput: maskServices,
+    description: "Create a service, native or Docker, in a project: it joins the project and gets its environments in the same call. Pass the projectId your context names. Projects are synced between machines, so write paths relative to the project root and put machine-specific values (a device serial, a local token) in environment variables, referenced as $NAME in commands \u2014 see the cwd, commands and shortcuts parameters. Then set its variables with set_environment_variable.",
+    route: "service.create",
+    method: "POST",
+    params: [
+      { name: "name", description: "The service name", required: true },
+      { name: "projectId", description: "The project it joins: the one your context names, or another from list_projects. Without it, the service belongs to no project.", required: false },
+      { name: "orgId", description: "Its organization. Needed only when the same project id exists in several.", required: false },
+      ...CREATE_SERVICE_PARAMS
+    ],
+    buildInput: (p) => {
+      const fields = serviceFields(p, CREATE_SERVICE_PARAMS);
+      if (fields["runner"] === "docker" && !fields["dockerConfig"]) {
+        throw new Error('dockerConfig: required with runner "docker" \u2014 give an "image" or a "dockerfile"');
+      }
+      return {
+        name: p.name,
+        ...fields,
+        ...p.projectId ? { projectId: p.projectId } : {},
+        ...p.orgId ? { orgId: p.orgId } : {}
+      };
+    }
+  },
+  {
+    name: "add_service_to_project",
+    description: "Add an existing service to a project, and create its environments \u2014 one for each of the project's environments, where its own variables go. Not needed after create_service, which already does it; calling it again changes nothing.",
+    route: "project.addService",
+    method: "POST",
+    params: [
+      { name: "projectId", description: "The project ID, from list_projects", required: true },
+      { name: "serviceId", description: "The service ID", required: true },
+      { name: "orgId", description: "Its organization. Needed only when the same project id exists in several.", required: false }
+    ],
+    buildInput: (p) => ({ projectId: p.projectId, serviceId: p.serviceId, ...p.orgId ? { orgId: p.orgId } : {} })
+  },
+  {
+    name: "update_service",
+    transformOutput: maskServices,
+    description: "Change any part of a service configuration \u2014 commands, ports, health check, restart policy, shortcuts, log sources, whether it runs natively or in Docker (runner, dockerConfig)\u2026 Only the fields you pass change; a list or an object you pass replaces the current one whole. Read the service first with get_service.",
+    route: "service.update",
+    method: "POST",
+    params: [
+      { name: "serviceId", description: "The service ID", required: true },
+      { name: "name", description: "New name", required: false },
+      { name: "orgId", description: "Move the service to this organization vault. Leave unset unless asked.", required: false, schema: z.string().max(128).nullable() },
+      ...UPDATE_SERVICE_PARAMS
+    ],
+    buildInput: (p) => ({
+      id: p.serviceId,
+      ...p.name ? { name: p.name } : {},
+      ...p.orgId !== void 0 ? { orgId: parseTyped("orgId", z.string().max(128).nullable(), p.orgId) } : {},
+      ...serviceFields(p, UPDATE_SERVICE_PARAMS)
+    })
+  },
+  {
+    name: "list_environments",
+    description: "List the environments of a project, with no value: each one's id, name and scope (global = shared by the whole project, service = one service's own variables), which global environment is active, which service a service environment belongs to and which global environment activates it, its parents (it inherits their variables), `isolated` when a service environment does not inherit from its global one, and the variables it defines with their flags. Empty environments are listed too \u2014 a service you just created has one per global environment, where its own variables go. Use it to find the environmentId before set_environment_variable.",
+    route: "environment.listForAi",
+    method: "GET",
+    params: [
+      { name: "projectId", description: "The project ID: the one your context names, or another from list_projects", required: true },
+      { name: "orgId", description: "Its organization. Needed only when the same project id exists in several.", required: false }
+    ],
+    buildInput: (p) => ({ projectId: p.projectId, ...p.orgId ? { orgId: p.orgId } : {} })
+  },
+  {
+    name: "resolve_environment",
+    description: "Resolve one environment alone \u2014 its variables with those inherited from its parents and this machine's overrides \u2014 as an AI may read it: secrets not shared with AI read \"***\". Built-in references ({{service.*}}, {{services.*}}, {{agent.*}}\u2026) are NOT filled, since they depend on the service that receives the variable; use get_service_env for a service's final values. `unresolvedReferences` lists references nothing will fill: a misspelled {{environment.KEY}}, or a name that is no built-in.",
+    route: "environment.resolveForAi",
+    method: "GET",
+    params: [
+      { name: "environmentId", description: "The environment, from list_environments", required: true }
+    ],
+    buildInput: (p) => ({ environmentId: p.environmentId })
+  },
+  {
+    name: "set_environment_variable",
+    description: `Create or change an environment variable, by name, in one environment \u2014 global or service, same rules for both. Find the environmentId with list_environments. Where it belongs: a value shared by several services (a database host, an API base URL) goes ONCE in the active global environment; services inherit it. A value only one service needs goes in that service's environment (scope service, activated by the active global one), where it also overrides a global variable of the same name. Never hardcode what Runeya already knows: a service's own port is {{service.PORT}}, its own URL {{service.URL}}, another service's address {{services.<slug>.URL}} \u2014 a copied "3210" or "http://localhost:3211" breaks as soon as a port changes or the project runs on another machine. If the port a variable needs is not declared on its service, declare it there (update_service, ports) instead of writing the number. When a written value contains a port or URL of a project service, the response lists \`suggestions\`: rewrite the value with those references. Compose instead of copying: a value can reference another variable of the resolved environment as {{environment.KEY}} (e.g. "postgres://{{environment.DB_USER}}@{{environment.DB_HOST}}:5432"). ${BUILTINS_HELP} After writing, check the result with get_service_env (a service, optionally in another global environment) or resolve_environment (an environment alone). References are substituted in one pass: a reference to a variable whose own value is only a reference may stay unexpanded, so point at the variable that holds the actual value. $NAME is not a reference here: it only expands inside a shell command. pre and post are concatenated around the value, each resolved separately. You can replace a secret's value without reading it, and create a variable as secret. You cannot make a secret public nor make it readable by AI: that stays the user's decision. Never pass "***" as a value. The response never contains the value.`,
+    route: "environment.setVariableBlind",
+    method: "POST",
+    params: [
+      { name: "environmentId", description: "The environment that holds the variable, from list_environments", required: true },
+      { name: "key", description: "The variable name, e.g. DATABASE_URL", required: true },
+      { name: "value", description: "The new value, possibly with {{environment.KEY}} references. Omit to leave it unchanged.", required: false },
+      { name: "pre", description: 'Text put before the value (e.g. "https://"). Omit to leave it unchanged.', required: false },
+      { name: "post", description: 'Text put after the value (e.g. "/api"). Omit to leave it unchanged.', required: false },
+      { name: "isSecret", description: '"true" to store it as a secret. On an existing public variable, makes it secret.', required: false },
+      { name: "description", description: "What the variable is for, in markdown", required: false }
+    ],
+    buildInput: (p) => ({
+      environmentId: p.environmentId,
+      key: p.key,
+      ...p.value !== void 0 ? { value: p.value } : {},
+      ...p.pre !== void 0 ? { pre: p.pre } : {},
+      ...p.post !== void 0 ? { post: p.post } : {},
+      ...p.isSecret !== void 0 ? { isSecret: toBool(p.isSecret) } : {},
+      ...p.description !== void 0 ? { description: p.description } : {}
+    })
+  },
+  {
+    name: "set_environment_inheritance",
+    description: "Switch whether a service environment inherits the variables of the global environment that activates it (the default), or is isolated from it and receives only its own variables. list_environments shows this as `isolated`. Isolating a service is unusual: it loses every shared variable of the project. Do it only when the user asks, and never to work around a variable \u2014 override it in the service environment instead.",
+    route: "environment.setInheritanceBlind",
+    method: "POST",
+    params: [
+      { name: "environmentId", description: "A service environment (scope service), from list_environments", required: true },
+      { name: "inherit", description: '"true" to inherit from the global environment, "false" to isolate', required: true, schema: z.boolean() }
+    ],
+    buildInput: (p) => ({ environmentId: p.environmentId, inherit: toBool(p.inherit ?? "true") })
+  },
+  {
+    name: "remove_environment_variable",
+    description: "Delete an environment variable, by name, from one environment. Its value is lost.",
+    route: "environment.removeVariableBlind",
+    method: "POST",
+    params: [
+      { name: "environmentId", description: "The environment that holds the variable", required: true },
+      { name: "key", description: "The variable name", required: true }
+    ],
+    buildInput: (p) => ({ environmentId: p.environmentId, key: p.key }),
+    destructive: true
+  },
+  {
+    name: "get_service_metrics",
+    description: "Read the CPU and memory currently used by a running service.",
+    route: "process.metrics",
+    method: "GET",
+    params: [
+      { name: "serviceId", description: "The service ID", required: true },
+      { name: "agentId", description: "The agent ID hosting this service", required: true }
+    ],
+    buildInput: (p) => ({ agentId: p.agentId, processId: p.serviceId })
+  },
+  {
+    name: "list_agents",
+    description: "List the agents connected to this Runeya, with their status and whether they run on this machine. Passphrases are never returned.",
+    route: "agent.list",
+    method: "GET",
+    params: [],
+    buildInput: () => void 0
+  },
+  {
+    name: "list_projects",
+    description: "List the projects known to this Runeya, with their ids and the services they hold.",
+    route: "project.list",
+    method: "GET",
+    params: [],
+    buildInput: () => void 0
+  },
+  {
+    name: "get_project",
+    description: "Read one project: its services, its active environment, its organization.",
+    route: "project.get",
+    method: "GET",
+    params: [
+      { name: "projectId", description: "The project ID, from list_projects", required: true },
+      { name: "orgId", description: "Its organization. Needed only when the same project id exists in several.", required: false }
+    ],
+    buildInput: (p) => ({ id: p.projectId, ...p.orgId ? { orgId: p.orgId } : {} })
+  },
+  {
+    name: "list_project_paths",
+    description: "Where each project lives on this machine. Use it to find the directory to work in before reading or editing files.",
+    route: "project.localPaths",
+    method: "GET",
+    params: [],
+    buildInput: () => void 0
+  },
+  {
+    name: "git_status",
+    description: "Read the git working tree of a service or a project: staged, modified and untracked files, current branch, ahead/behind counts.",
+    route: "git.status",
+    method: "GET",
+    params: [
+      { name: "serviceId", description: "Target the repository of this service", required: false },
+      { name: "projectId", description: "Target the repository of this project, when no service is given", required: false },
+      { name: "agentId", description: "The agent hosting the repository", required: false },
+      { name: "orgId", description: "Its organization, when a project id alone is ambiguous", required: false }
+    ],
+    buildInput: (p) => gitTarget(p)
+  },
+  {
+    name: "git_log",
+    description: "Read the recent commits of a service or project repository: hash, author, date, message.",
+    route: "git.log",
+    method: "GET",
+    params: [
+      { name: "serviceId", description: "Target the repository of this service", required: false },
+      { name: "projectId", description: "Target the repository of this project, when no service is given", required: false },
+      { name: "agentId", description: "The agent hosting the repository", required: false },
+      { name: "orgId", description: "Its organization, when a project id alone is ambiguous", required: false },
+      { name: "limit", description: "How many commits to return (1-200). Default: 50.", required: false }
+    ],
+    buildInput: (p) => ({ ...gitTarget(p), ...p.limit ? { limit: Number(p.limit) } : {} })
+  },
+  {
+    name: "git_branches",
+    description: "List the local and remote branches of a service or project repository.",
+    route: "git.branches",
+    method: "GET",
+    params: [
+      { name: "serviceId", description: "Target the repository of this service", required: false },
+      { name: "projectId", description: "Target the repository of this project, when no service is given", required: false },
+      { name: "agentId", description: "The agent hosting the repository", required: false },
+      { name: "orgId", description: "Its organization, when a project id alone is ambiguous", required: false }
+    ],
+    buildInput: (p) => gitTarget(p)
+  },
+  {
+    name: "git_diff",
+    description: "Read the diff of a service or project repository \u2014 everything, or one file. Use it to see what changed before describing or reviewing it.",
+    route: "git.diff",
+    method: "GET",
+    params: [
+      { name: "serviceId", description: "Target the repository of this service", required: false },
+      { name: "projectId", description: "Target the repository of this project, when no service is given", required: false },
+      { name: "agentId", description: "The agent hosting the repository", required: false },
+      { name: "orgId", description: "Its organization, when a project id alone is ambiguous", required: false },
+      { name: "path", description: "Restrict the diff to this file path", required: false },
+      { name: "staged", description: 'Set to "true" to read the staged diff instead of the working tree', required: false },
+      { name: "untracked", description: 'Set to "true" to include untracked files', required: false }
+    ],
+    buildInput: (p) => ({
+      ...gitTarget(p),
+      ...p.path ? { path: p.path } : {},
+      ...p.staged !== void 0 ? { staged: p.staged === "true" } : {},
+      ...p.untracked !== void 0 ? { untracked: p.untracked === "true" } : {}
+    })
+  },
+  {
+    name: "list_docs",
+    description: "List the markdown documentation files of a scope, as a tree. Pair it with read_doc to answer from the project's own docs rather than from guesswork.",
+    route: "wiki.list",
+    method: "GET",
+    params: [
+      { name: "scope", description: `"global" for this Runeya, or "service:<serviceId>" for one service's repository`, required: true }
+    ],
+    buildInput: (p) => ({ scope: p.scope })
+  },
+  {
+    name: "read_doc",
+    description: "Read one markdown documentation file. Paths come from list_docs; only .md and .markdown can be read.",
+    route: "wiki.read",
+    method: "GET",
+    params: [
+      { name: "scope", description: `"global" for this Runeya, or "service:<serviceId>" for one service's repository`, required: true },
+      { name: "path", description: "Relative path of the file, as returned by list_docs", required: true }
+    ],
+    buildInput: (p) => ({ scope: p.scope, path: p.path })
+  },
+  {
+    name: "get_server_logs",
+    description: "Read Runeya's own recent log entries. Use it to explain why Runeya itself misbehaved \u2014 not to read a service's output, which is get_logs.",
+    route: "diagnostics.recentLogs",
+    method: "GET",
+    params: [
+      { name: "limit", description: "How many entries to return (1-2000). Default: 500.", required: false }
+    ],
+    buildInput: (p) => p.limit ? { limit: Number(p.limit) } : void 0
+  },
+  {
+    name: "get_kanban_queue_state",
+    description: "Read the state of the kanban task queue: what is running, what is waiting. Use it before queuing work, or to explain why a card has not started.",
+    route: "kanbanQueue.getState",
+    method: "GET",
+    params: [],
+    buildInput: () => void 0
+  },
+  {
+    name: "export_project",
+    description: "Read a project and every service it holds in one call, with secrets stripped out. Cheaper and safer than calling get_service for each service \u2014 prefer it whenever you need the whole picture of a project.",
+    route: "project.export",
+    method: "GET",
+    params: [
+      { name: "projectId", description: "The project ID, from list_projects", required: true },
+      { name: "orgId", description: "Its organization. Needed only when the same project id exists in several.", required: false }
+    ],
+    buildInput: (p) => ({ id: p.projectId, ...p.orgId ? { orgId: p.orgId } : {} })
+  },
+  {
+    name: "git_remotes",
+    description: "List the git remotes of a service or project repository, with their URLs.",
+    route: "git.remotes",
+    method: "GET",
+    params: [
+      { name: "serviceId", description: "Target the repository of this service", required: false },
+      { name: "projectId", description: "Target the repository of this project, when no service is given", required: false },
+      { name: "agentId", description: "The agent hosting the repository", required: false },
+      { name: "orgId", description: "Its organization, when a project id alone is ambiguous", required: false }
+    ],
+    buildInput: (p) => gitTarget(p)
+  },
+  {
+    name: "git_stash_list",
+    description: "List the stashes of a service or project repository. Useful before assuming work was lost: it may simply be stashed.",
+    route: "git.stashList",
+    method: "GET",
+    params: [
+      { name: "serviceId", description: "Target the repository of this service", required: false },
+      { name: "projectId", description: "Target the repository of this project, when no service is given", required: false },
+      { name: "agentId", description: "The agent hosting the repository", required: false },
+      { name: "orgId", description: "Its organization, when a project id alone is ambiguous", required: false }
+    ],
+    buildInput: (p) => gitTarget(p)
+  },
+  {
+    name: "get_runeya_version",
+    description: "Read the version of Runeya running here, the latest published one, and whether this install is up to date. Use it before blaming a bug on the code: the machine may simply be behind.",
+    route: "health.versionInfo",
+    method: "GET",
+    params: [],
+    buildInput: () => void 0
+  },
+  {
+    name: "get_runeya_paths",
+    description: "Read where Runeya keeps its things on this machine: its launch directory, its data directory, and the machine-wide directory holding cloud projects.",
+    route: "settings.getPaths",
+    method: "GET",
+    params: [],
+    buildInput: () => void 0
+  },
+  {
+    name: "get_network_info",
+    description: "Read where this Runeya listens (host and port) and whether it is reachable from the local network, with the URLs to use. Use it to give someone a working link instead of guessing one.",
+    route: "settings.getNetwork",
+    method: "GET",
+    params: [],
+    buildInput: () => void 0
+  },
+  {
+    name: "list_runeya_instances",
+    description: "List every Runeya answering on this machine, this one included, with its port and directory. Use it when a port is taken or when two instances seem to disagree.",
+    route: "diagnostics.instances",
+    method: "GET",
+    params: [],
+    buildInput: () => void 0
+  },
+  {
+    name: "get_cloud_status",
+    description: "Say whether this Runeya is linked to a cloud account, and to which cloud. A kanban tool failing for lack of a cloud link is explained here.",
+    route: "cloudAuth.status",
+    method: "GET",
+    params: [],
+    buildInput: () => void 0
+  }
+];
+
+// ../../packages/ai-capabilities/src/adapters/json-schema.ts
+import { z as z2 } from "zod";
+function paramJsonSchema(param) {
+  if (!param.schema) return { type: "string", description: param.description };
+  const { $schema: _ignored, ...schema } = z2.toJSONSchema(param.schema, { io: "input", unrepresentable: "any" });
+  return { ...schema, description: param.description };
+}
+
+// ../../packages/ai-capabilities/src/adapters/anthropic.ts
+function buildAnthropicTools(capabilities) {
+  return capabilities.map((cap) => ({
+    name: cap.name,
+    description: cap.description,
+    input_schema: {
+      type: "object",
+      properties: Object.fromEntries(
+        cap.params.map((p) => [p.name, paramJsonSchema(p)])
+      ),
+      required: cap.params.filter((p) => p.required).map((p) => p.name)
+    }
+  }));
+}
+
+// ../../packages/ai-capabilities/src/adapters/openai.ts
+function buildOpenAITools(capabilities) {
+  return capabilities.map((cap) => ({
+    type: "function",
+    function: {
+      name: cap.name,
+      description: cap.description,
+      parameters: {
+        type: "object",
+        properties: Object.fromEntries(
+          cap.params.map((p) => [p.name, paramJsonSchema(p)])
+        ),
+        required: cap.params.filter((p) => p.required).map((p) => p.name)
+      }
+    }
+  }));
+}
+
+// ../../packages/ai-capabilities/src/adapters/prompt.ts
+function buildToolSafetyInstruction(capabilities) {
+  const destructive = capabilities.filter((c) => c.destructive).map((c) => c.name);
+  const withHints = capabilities.filter((c) => c.usageHint);
+  const lines = ["## Tool use safety rules"];
+  if (destructive.length > 0) {
+    lines.push(`CRITICAL: Never call ${destructive.join(", ")} unless the user has EXPLICITLY and UNAMBIGUOUSLY requested it.`);
+    lines.push(`- Only call destructive tools (${destructive.join(", ")}) when the user explicitly uses action words for a specific service.`);
+  }
+  if (withHints.length > 0) {
+    lines.push("");
+    lines.push("## Tool usage hints");
+    for (const cap of withHints) {
+      lines.push(`- ${cap.usageHint}`);
+    }
+  }
+  return lines.join("\n");
+}
+
+// ../../packages/ai-capabilities/src/adapters/mcp.ts
+import { z as z3 } from "zod";
+function buildMcpShape(cap) {
+  const shape = {};
+  for (const param of cap.params) {
+    const base = (param.schema ?? z3.string()).describe(param.description);
+    shape[param.name] = param.required ? base : base.optional();
+  }
+  shape["authToken"] = z3.string().describe("Bearer token for authentication").optional();
+  return shape;
+}
+function toRawParams(input, cap) {
+  const typed = new Set(cap?.params.filter((p) => p.schema).map((p) => p.name));
+  return Object.fromEntries(Object.entries(input).map(([k, v]) => [
+    k,
+    v === null && typed.has(k) ? "null" : v == null ? void 0 : typeof v === "object" ? JSON.stringify(v) : String(v)
+  ]));
+}
+
+// ../../packages/ai-capabilities/src/project-anchor.ts
+function applyProjectAnchor(cap, params, anchor) {
+  const accepts = (name) => cap.params.some((p) => p.name === name);
+  const anchored = { ...params };
+  const mayAnchorOrg = !params["projectId"] || params["projectId"] === anchor.projectId;
+  if (anchor.projectId && accepts("projectId") && !anchored["projectId"]) {
+    anchored["projectId"] = anchor.projectId;
+  }
+  if (mayAnchorOrg && anchor.orgId && !anchored["orgId"] && accepts("orgId")) {
+    anchored["orgId"] = anchor.orgId;
+  }
+  if (mayAnchorOrg && anchor.orgId && !anchored["organizationId"] && accepts("organizationId")) {
+    anchored["organizationId"] = anchor.orgId;
+  }
+  return anchored;
+}
+
+export {
+  RUNEYA_CAPABILITIES,
+  buildAnthropicTools,
+  buildOpenAITools,
+  buildToolSafetyInstruction,
+  buildMcpShape,
+  toRawParams,
+  callTrpc,
+  runCapability,
+  applyProjectAnchor
+};
+//# sourceMappingURL=chunk-6IBPK6UE.js.map