@koda-sl/baker-cli 0.466.0 → 0.467.0

package/dist/mcp-QAZ4XLMN.js

@@ -0,0 +1,463 @@
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+import {
+  customMcpServerNameRequestSchema
+} from "./chunk-WXC3I4CT.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import {
+  getEnv
+} from "./chunk-QXDEZKAR.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// ../api/src/mcp-catalog.ts
+import { z } from "zod";
+var MCP_CATALOG_DEFAULT_LIMIT = 8;
+var MCP_CATALOG_DESCRIPTION_MAX = 160;
+var mcpCatalogRequestSchema = z.object({
+  search: z.string().trim().min(1, "Provide --search").max(100),
+  limit: z.coerce.number().int().min(1).max(20).default(MCP_CATALOG_DEFAULT_LIMIT)
+});
+var mcpCatalogConnectSchema = z.enum(["sign-in", "key"]);
+var mcpCatalogEntrySchema = z.object({
+  /** The toolkit slug — what request_connection `{ app }` takes. */
+  app: z.string(),
+  name: z.string(),
+  description: z.string().max(MCP_CATALOG_DESCRIPTION_MAX),
+  connect: mcpCatalogConnectSchema,
+  connected: z.boolean()
+});
+var mcpCatalogResponseSchema = z.object({
+  apps: z.array(mcpCatalogEntrySchema),
+  /** Baker's own connections this search matched — ask for these with `{ platform }`, never a managed copy. */
+  platforms: z.array(z.string()).optional()
+});
+
+// src/commands/mcp/index.ts
+import { defineCommand } from "citty";
+
+// src/commands/mcp/catalog.ts
+var PREFER_VENDOR_HINT = 'The vendor\'s own MCP server comes before any app here. If you have not yet, WebSearch "<vendor> MCP server" and WebFetch its official docs for the remote https address and how it signs in, then ask for it with request_connection `{ server: { name, url, auth, keyHeader } }`. Only when the vendor has none, ask for an app from this catalog with request_connection `{ app: "<slug>", reason }` \u2014 the user connects it in the chat and its tools load right after, in this same turn.';
+var ALREADY_CONNECTED_HINT = "An app marked connected is already reachable \u2014 use its mcp__composio_* tools; do not ask again.";
+var NO_MATCH_HINT = "Nothing in the catalog matches. WebSearch for the vendor's official remote MCP server (its docs, its developer site) before telling the user it can't be connected \u2014 if one exists, ask for it with request_connection `{ server }`. Only when the web shows no official remote server either, say plainly this tool can't be connected yet and offer a Task.";
+function firstPartyHint(platforms) {
+  const asks = platforms.map((p) => `request_connection \`{ platform: "${p}" }\``).join(" or ");
+  return `This is one of Baker's own connections \u2014 ask for it with ${asks}. It is the one Baker's commands, staging and publish work with, so never connect it as a catalog app or as an MCP server, even one the vendor publishes or the user names. If it is already connected, read it with its own baker command family instead.`;
+}
+function catalogHints(apps, { platforms = [] } = {}) {
+  if (platforms.length > 0) {
+    return [firstPartyHint(platforms)];
+  }
+  const hints = [PREFER_VENDOR_HINT];
+  if (apps.some((a) => a.connected)) {
+    hints.push(ALREADY_CONNECTED_HINT);
+  }
+  if (apps.length === 0) {
+    hints.push(NO_MATCH_HINT);
+  }
+  return hints;
+}
+
+// src/commands/mcp/platforms.ts
+function readsKey(label) {
+  const [first = "", ...rest] = label.split(" ");
+  return [first.toLowerCase(), ...rest].join("");
+}
+function platformEntry(platform) {
+  return {
+    platform: platform.label,
+    ...platform.account ? { account: platform.account } : {},
+    ...platform.readsLabel && platform.reads.length > 0 ? { [readsKey(platform.readsLabel)]: platform.reads } : {}
+  };
+}
+
+// src/commands/mcp/index.ts
+var SCOPES = ["user", "user_org", "company", "org"];
+function parseScope(raw) {
+  const scope = raw === void 0 ? "company" : String(raw);
+  if (!SCOPES.includes(scope)) {
+    throw new ApiError("VALIDATION_ERROR", `Invalid --scope "${scope}". Use user | user_org | company | org.`);
+  }
+  return scope;
+}
+function actingUserId() {
+  return getEnv().BAKER_ACTING_USER_ID;
+}
+function customEntry(server) {
+  const failed = server.health && !server.health.ok;
+  const problem = server.health?.message ?? "This server's address is not serving tools.";
+  return {
+    name: server.name,
+    scope: server.scope,
+    enabled: server.enabled,
+    ...failed && !server.health?.transient ? { usable: false, problem } : {},
+    ...failed && server.health?.transient ? { lastCheck: "failed", problem } : {},
+    ...failed && server.health?.suggestedUrl ? { suggestedAddress: server.health.suggestedUrl } : {}
+  };
+}
+var BROKEN_SERVER_HINT = "A server marked usable=false will NOT answer: its tools are absent from this turn. Say plainly that the tool is not working and relay `problem`; never claim its tools are loading, coming next message, or temporarily unavailable. `problem` names what a person has to fix \u2014 the address, the sign-in, or the key the server was added with \u2014 so pass on that fix and no other: never tell the user to reconnect a server whose `problem` is its address or its key. The user makes the fix in the dashboard (Brain \u2192 Integrations \u2192 More apps). If `suggestedAddress` is present, that is the address to use.";
+var LAST_CHECK_FAILED_HINT = "A server with lastCheck=failed was unreachable or erroring when it was last checked \u2014 that may already have passed, and its tools ARE loaded this turn. Try the tool; if it works, say nothing about the check. If it fails, report `problem` as what happened rather than guessing.";
+function parseHeaders(raw, rawArgs) {
+  const list = repeatedValues(rawArgs, "header", raw);
+  const headers = {};
+  for (const entry of list) {
+    const text = String(entry);
+    const sep = text.indexOf(":") >= 0 && (text.indexOf(":") < text.indexOf("=") || text.indexOf("=") < 0) ? ":" : "=";
+    const at = text.indexOf(sep);
+    if (at <= 0) {
+      throw new ApiError("VALIDATION_ERROR", `Invalid header "${text}". Use "Key: Value".`);
+    }
+    headers[text.slice(0, at).trim()] = text.slice(at + 1).trim();
+  }
+  return Object.keys(headers).length > 0 ? headers : void 0;
+}
+function fail(err) {
+  if (err instanceof ApiError) {
+    writeJson({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  writeJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+var PLATFORMS_HINT = "`platforms` are connected accounts you reach through `baker` commands (HubSpot, Google Ads, GA4, Search Console, Tag Manager, \u2026), NOT mcp__* tools \u2014 there is no tool to call for them. A platform listed here IS connected: never tell the user to connect it, and never conclude it is missing because it has no mcp__* entry. Read what it holds with its own command family (`baker hubspot \u2026`, `baker ads google \u2026`, `baker ga4 \u2026`, and so on).";
+registerSchema({
+  command: "mcp.connected",
+  description: "List everything this chat can reach: managed integrations (Attio, Slack, Gmail, Google Sheets, \u2026), custom MCP servers, and the platforms the company signed in to (HubSpot, Google Ads, GA4, Search Console, Tag Manager) which you read through their own `baker` commands. Start here when the user mentions an external tool or platform.",
+  args: {}
+});
+var connectedCommand = defineCommand({
+  meta: {
+    name: "connected",
+    description: `Everything this chat can reach \u2014 managed integrations, custom MCP servers, and connected platforms.
+
+Managed tools ride the composio servers (mcp__composio_<scope>__*); custom servers expose mcp__<name>__*.
+Platforms (HubSpot, Google Ads, GA4, \u2026) have no mcp__* tools at all \u2014 you read them with their own
+\`baker\` command family, and one listed here is connected and ready to use.
+A tool or platform the user names that is NOT listed anywhere here is simply not connected yet.`
+  },
+  run: async () => {
+    try {
+      const user = actingUserId();
+      const data = await apiGet("/api/mcp/connected", user ? { actingUserId: user } : void 0);
+      const managed = data.managed.map((c) => ({
+        toolkit: c.toolkitSlug,
+        scope: c.scope,
+        ...c.status !== "ACTIVE" ? { status: c.status } : {},
+        ...c.accountLabel ? { account: c.accountLabel } : {},
+        ...c.readOnly ? { readOnly: true } : {}
+      }));
+      const custom = data.custom.map(customEntry);
+      const platforms = (data.platforms ?? []).map(platformEntry);
+      const hints = [];
+      if (platforms.length > 0) {
+        hints.push(PLATFORMS_HINT);
+      }
+      if (data.custom.some((s) => s.health && !s.health.ok && !s.health.transient)) {
+        hints.push(BROKEN_SERVER_HINT);
+      }
+      if (data.custom.some((s) => s.health && !s.health.ok && s.health.transient)) {
+        hints.push(LAST_CHECK_FAILED_HINT);
+      }
+      if ([...data.managed, ...data.custom].some((e) => e.scope === "user" || e.scope === "user_org")) {
+        hints.push(
+          "user/user_org entries are personal: they belong to the current message sender and load only in their turns \u2014 other users in this chat won't have them."
+        );
+      }
+      hints.push(
+        "Not listed anywhere = not connected \u2014 connect it from the chat with request_connection, never by sending the user to the dashboard: a Baker platform (HubSpot, Google Ads, GA4, \u2026) \u2192 { platform }; anything else \u2192 the vendor's own MCP server FIRST: use the address the user gave you, or WebSearch '<vendor> MCP server' and WebFetch its official docs for the remote https address and how it signs in, then { server: { name, url, auth, keyHeader } }; only when the vendor has none \u2192 `baker mcp catalog --search <name>`, then { app }. Research before you ask the user anything. What they connect loads into this same turn."
+      );
+      writeJson({
+        ok: true,
+        data: { managed, custom, platforms },
+        hints
+      });
+    } catch (err) {
+      fail(err);
+    }
+  }
+});
+var catalogArgs = {
+  search: { type: "string", description: "App or vendor name, e.g. notion, clarity, pipedrive", required: true },
+  limit: { type: "string", description: "Max apps to return, 1-20 (default 8)", required: false }
+};
+registerSchema({
+  command: "mcp.catalog",
+  description: "Search the managed apps you can ask the user to connect when a vendor has no MCP server of its own. Each app says how the user connects it (sign-in | key) and whether this chat already reaches it. Example: baker mcp catalog --search notion",
+  args: catalogArgs
+});
+var catalogCommand = defineCommand({
+  meta: {
+    name: "catalog",
+    description: `Managed apps you can ask the user to connect when a vendor has no MCP server of its own.
+
+For a tool \`baker mcp connected\` does not list whose vendor has no official remote MCP server:
+  baker mcp catalog --search notion
+  baker mcp catalog --search "microsoft clarity" --limit 3
+
+Each app: app (slug for request_connection), name, description, connect (sign-in | key), connected.
+Prefer the vendor's own MCP server when it publishes one; a catalog app is the fallback.`
+  },
+  args: catalogArgs,
+  run: async ({ args }) => {
+    const parsed = mcpCatalogRequestSchema.safeParse({ search: args.search, limit: args.limit });
+    if (!parsed.success) {
+      writeJson({
+        ok: false,
+        error: { code: "VALIDATION_ERROR", message: parsed.error.issues[0]?.message ?? "Invalid arguments" }
+      });
+      process.exit(1);
+    }
+    try {
+      const user = actingUserId();
+      const data = await apiGet("/api/mcp/catalog", {
+        search: parsed.data.search,
+        limit: String(parsed.data.limit),
+        ...user ? { actingUserId: user } : {}
+      });
+      writeJson({
+        ok: true,
+        data: {
+          apps: data.apps,
+          ...data.platforms?.length ? { platforms: data.platforms } : {}
+        },
+        hints: catalogHints(data.apps, { platforms: data.platforms ?? [] })
+      });
+    } catch (err) {
+      fail(err);
+    }
+  }
+});
+registerSchema({
+  command: "mcp.list",
+  description: "List the custom MCP servers this company's chats see (org + company + your own user scope).",
+  args: {}
+});
+var listCommand = defineCommand({
+  meta: { name: "list", description: "List custom MCP servers visible to this company's chats." },
+  run: async () => {
+    try {
+      const user = actingUserId();
+      const data = await apiGet(
+        "/api/mcp/custom",
+        user ? { actingUserId: user } : void 0
+      );
+      writeJson({
+        ok: true,
+        // Detail view: the full row (address included) plus the usability verdict.
+        // `health` itself is folded into `usable`/`problem` by `customEntry`.
+        data: data.servers.map((server) => ({ ...server, health: void 0, ...customEntry(server) })),
+        ...data.servers.some((s) => s.health && !s.health.ok) ? {
+          hints: data.servers.some((s) => s.health && !s.health.ok && !s.health.transient) ? [BROKEN_SERVER_HINT] : [LAST_CHECK_FAILED_HINT]
+        } : {}
+      });
+    } catch (err) {
+      fail(err);
+    }
+  }
+});
+registerSchema({
+  command: "mcp.add",
+  description: "Register a custom MCP server. Tools appear as mcp__<name>__* on the next message. URL must be HTTPS. Scope: company (default, all chats) | org (org admin key) | user (only the current sender).",
+  args: {
+    name: { type: "string", description: "Server name \u2192 tools appear as mcp__<name>__*", required: true },
+    url: {
+      type: "string",
+      description: "Full HTTPS MCP endpoint (commonly ends in /mcp, not just the domain)",
+      required: true
+    },
+    scope: { type: "string", description: "user | user_org | company | org (default company)", required: false },
+    header: { type: "string", description: 'Auth header "Key: Value" (repeatable)', required: false }
+  }
+});
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: `Register a custom MCP server. Tools appear as mcp__<name>__* on the NEXT message.
+For a server the USER asks for, use request_connection { server } instead: they confirm who can use it,
+type any key into the card (never the chat), and its tools load in this same turn.
+
+Scope: company (default \u2014 every chat in the company) | org (all companies in the org; needs an admin key) | user (only the current message sender).
+
+Examples:
+  baker mcp add --name weather --url https://mcp.example.com/mcp
+  baker mcp add --name acme --url https://acme.dev/mcp --header "Authorization: Bearer sk-\u2026"
+  baker mcp add --name mine --url https://my.dev/mcp --scope user`
+  },
+  args: {
+    name: { type: "string", description: "Server name (mcp__<name>__*)", required: true },
+    url: {
+      type: "string",
+      description: "Full HTTPS MCP endpoint (commonly ends in /mcp, not just the domain)",
+      required: true
+    },
+    scope: { type: "string", description: "user | user_org | company | org (default company)", required: false },
+    header: { type: "string", description: 'Auth header "Key: Value" (repeatable)', required: false }
+  },
+  run: async ({ args, rawArgs }) => {
+    try {
+      const scope = parseScope(args.scope);
+      const user = actingUserId();
+      const headers = parseHeaders(args.header, rawArgs);
+      const data = await apiPost("/api/mcp/custom", {
+        name: args.name,
+        url: args.url,
+        scope,
+        ...user ? { actingUserId: user } : {},
+        ...headers ? { headers } : {}
+      });
+      writeJson({
+        ok: true,
+        data,
+        hints: [
+          "The address must be the full MCP endpoint (commonly ending in /mcp), not just the domain \u2014 a domain on its own usually answers sign-in and then serves no tools.",
+          "The address is checked in the background. Run `baker mcp connected` on the next message to confirm it serves tools before promising the user anything."
+        ]
+      });
+    } catch (err) {
+      fail(err);
+    }
+  }
+});
+registerSchema({
+  command: "mcp.remove",
+  description: "Remove a company custom MCP server by name.",
+  args: { name: { type: "string", description: "Server name to remove", required: true } }
+});
+var removeCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: `Remove a company custom MCP server by name.
+
+Example:
+  baker mcp remove --name weather`
+  },
+  args: { name: { type: "string", description: "Server name to remove", required: true } },
+  run: async ({ args }) => {
+    try {
+      const user = actingUserId();
+      const data = await apiPost("/api/mcp/custom/remove", {
+        name: args.name,
+        ...user ? { actingUserId: user } : {}
+      });
+      writeJson({ ok: true, data });
+    } catch (err) {
+      fail(err);
+    }
+  }
+});
+var serverNameArgs = {
+  name: { type: "string", description: "Custom server name, as `baker mcp list` shows it", required: true }
+};
+registerSchema({
+  command: "mcp.verify",
+  description: "Check a custom MCP server now (the dashboard's 'Check now') and store the result. Use after the user fixed its address or sign-in, or when its tools failed this turn.",
+  args: serverNameArgs
+});
+var verifyCommand = defineCommand({
+  meta: {
+    name: "verify",
+    description: `Check a custom MCP server now and store the result.
+
+Example:
+  baker mcp verify --name weather`
+  },
+  args: serverNameArgs,
+  run: async ({ args }) => {
+    const parsed = customMcpServerNameRequestSchema.safeParse({ name: args.name, actingUserId: actingUserId() });
+    if (!parsed.success) {
+      fail(new ApiError("VALIDATION_ERROR", parsed.error.issues[0]?.message ?? "Invalid arguments"));
+    }
+    try {
+      const data = await apiPost("/api/mcp/custom/verify", parsed.data);
+      writeJson({
+        ok: true,
+        data,
+        hints: [
+          data.ok ? "The server answers and serves tools. Its tools load on the next message." : data.transient ? LAST_CHECK_FAILED_HINT : BROKEN_SERVER_HINT
+        ]
+      });
+    } catch (err) {
+      fail(err);
+    }
+  }
+});
+registerSchema({
+  command: "mcp.disable",
+  description: "Switch a custom MCP server off so its tools stop loading; its address and sign-in are kept. Turning it back on is done by a person in the dashboard, never by the agent.",
+  args: serverNameArgs
+});
+var disableCommand = defineCommand({
+  meta: {
+    name: "disable",
+    description: `Switch a custom MCP server off (its tools stop loading). Only a person can turn it back on, in the dashboard.
+
+Example:
+  baker mcp disable --name weather`
+  },
+  args: serverNameArgs,
+  run: async ({ args }) => {
+    const parsed = customMcpServerNameRequestSchema.safeParse({ name: args.name, actingUserId: actingUserId() });
+    if (!parsed.success) {
+      fail(new ApiError("VALIDATION_ERROR", parsed.error.issues[0]?.message ?? "Invalid arguments"));
+    }
+    try {
+      const data = await apiPost("/api/mcp/custom/disable", parsed.data);
+      writeJson({
+        ok: true,
+        data,
+        hints: [
+          "Its tools stop loading from the next message, and this applies right away \u2014 publishing or discarding this chat does not undo it. Tell the user they can turn it back on in Brain \u2192 Integrations \u2192 More apps."
+        ]
+      });
+    } catch (err) {
+      fail(err);
+    }
+  }
+});
+var mcpCommand = defineCommand({
+  meta: {
+    name: "mcp",
+    description: `Third-party tools for this company \u2014 see what's connected, register custom HTTPS MCP endpoints.
+
+Tools from a registered server appear as mcp__<name>__* on the next message.
+Managed here are **company-scoped** servers; user- and org-scoped servers are managed in the dashboard.
+
+Start here:
+  baker mcp connected   # everything this chat can reach: managed integrations, custom servers, connected platforms
+  baker mcp catalog --search notion   # managed apps you can connect when a vendor has no MCP server of its own
+
+Examples:
+  baker mcp add --name weather --url https://mcp.example.com/mcp
+  baker mcp add --name acme --url https://acme.dev/mcp --header "Authorization: Bearer sk-\u2026"
+  baker mcp remove --name weather
+  baker mcp verify --name weather    # check it now after the user fixed it
+  baker mcp disable --name weather   # stop its tools loading (only a person turns it back on)
+Full guide: __tooling__/docs/tools/baker/mcp.md`
+  },
+  subCommands: {
+    connected: connectedCommand,
+    catalog: catalogCommand,
+    list: listCommand,
+    add: addCommand,
+    remove: removeCommand,
+    verify: verifyCommand,
+    disable: disableCommand
+  }
+});
+export {
+  mcpCommand
+};
+//# sourceMappingURL=mcp-QAZ4XLMN.js.map

package/dist/mcp-QAZ4XLMN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../api/src/mcp-catalog.ts","../src/commands/mcp/index.ts","../src/commands/mcp/catalog.ts","../src/commands/mcp/platforms.ts"],"sourcesContent":["/**\n * Contract for `GET /api/mcp/catalog` — searching the managed-app catalog the\n * sandbox agent can ask the user to connect when a vendor publishes no MCP\n * server of its own.\n *\n * `connect` mirrors `ToolkitConnectMode` in `convex/composio/types.ts`, folded\n * to what the user will be asked for: a sign-in or a key. Apps that need no\n * sign-in are left out — Composio refuses to connect them.\n */\nimport { z } from \"zod\";\n\nexport const MCP_CATALOG_DEFAULT_LIMIT = 8;\nexport const MCP_CATALOG_DESCRIPTION_MAX = 160;\n\nexport const mcpCatalogRequestSchema = z.object({\n  search: z.string().trim().min(1, \"Provide --search\").max(100),\n  limit: z.coerce.number().int().min(1).max(20).default(MCP_CATALOG_DEFAULT_LIMIT),\n});\nexport type McpCatalogRequest = z.infer<typeof mcpCatalogRequestSchema>;\n\nexport const mcpCatalogConnectSchema = z.enum([\"sign-in\", \"key\"]);\nexport type McpCatalogConnect = z.infer<typeof mcpCatalogConnectSchema>;\n\nexport const mcpCatalogEntrySchema = z.object({\n  /** The toolkit slug — what request_connection `{ app }` takes. */\n  app: z.string(),\n  name: z.string(),\n  description: z.string().max(MCP_CATALOG_DESCRIPTION_MAX),\n  connect: mcpCatalogConnectSchema,\n  connected: z.boolean(),\n});\nexport type McpCatalogEntry = z.infer<typeof mcpCatalogEntrySchema>;\n\nexport const mcpCatalogResponseSchema = z.object({\n  apps: z.array(mcpCatalogEntrySchema),\n  /** Baker's own connections this search matched — ask for these with `{ platform }`, never a managed copy. */\n  platforms: z.array(z.string()).optional(),\n});\nexport type McpCatalogResponse = z.infer<typeof mcpCatalogResponseSchema>;\n","import {\n  type CustomMcpDisableResponse,\n  type CustomMcpVerifyResponse,\n  customMcpServerNameRequestSchema,\n} from \"@baker/api\";\nimport { type McpCatalogResponse, mcpCatalogRequestSchema } from \"@baker/api/mcp-catalog\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiGet, apiPost } from \"../../client.ts\";\nimport { getEnv } from \"../../env.ts\";\nimport { repeatedValues } from \"../../lib/repeatedFlags.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { catalogHints } from \"./catalog.ts\";\nimport { type ConnectedPlatform, platformEntry } from \"./platforms.ts\";\n\nconst SCOPES = [\"user\", \"user_org\", \"company\", \"org\"] as const;\ntype Scope = (typeof SCOPES)[number];\n\nfunction parseScope(raw: unknown): Scope {\n  const scope = raw === undefined ? \"company\" : String(raw);\n  if (!(SCOPES as readonly string[]).includes(scope)) {\n    throw new ApiError(\"VALIDATION_ERROR\", `Invalid --scope \"${scope}\". Use user | user_org | company | org.`);\n  }\n  return scope as Scope;\n}\n\n/** The turn's message sender, injected by the bridge — required only for user scope. */\nfunction actingUserId(): string | undefined {\n  return getEnv().BAKER_ACTING_USER_ID;\n}\n\ntype CustomMcpServer = {\n  _id: string;\n  scope: \"user\" | \"user_org\" | \"company\" | \"org\";\n  name: string;\n  url: string;\n  headerKeys: string[];\n  enabled: boolean;\n  /** Absent until the address has been checked; `ok: false` means it serves no tools. */\n  health?: { ok: boolean; message?: string; suggestedUrl?: string; transient?: boolean; checkedAt: number };\n  createdAt: number;\n};\n\n/**\n * What to report for one custom server. `problem` is the whole point: a server can\n * be signed in, enabled and still serve nothing (wrong address), and reporting it\n * as plain \"connected\" is how an agent ends up promising tools it does not have.\n * A `transient` failure is reported separately — the tool may well answer, so\n * declaring it broken would be its own kind of lie.\n */\nfunction customEntry(server: CustomMcpServer): Record<string, unknown> {\n  const failed = server.health && !server.health.ok;\n  const problem = server.health?.message ?? \"This server's address is not serving tools.\";\n  return {\n    name: server.name,\n    scope: server.scope,\n    enabled: server.enabled,\n    ...(failed && !server.health?.transient ? { usable: false, problem } : {}),\n    ...(failed && server.health?.transient ? { lastCheck: \"failed\", problem } : {}),\n    ...(failed && server.health?.suggestedUrl ? { suggestedAddress: server.health.suggestedUrl } : {}),\n  };\n}\n\n/** The hint an unusable server earns — the agent must not offer its tools or invent a reason. */\nconst BROKEN_SERVER_HINT =\n  \"A server marked usable=false will NOT answer: its tools are absent from this turn. Say plainly that the tool is not working and relay `problem`; never claim its tools are loading, coming next message, or temporarily unavailable. `problem` names what a person has to fix — the address, the sign-in, or the key the server was added with — so pass on that fix and no other: never tell the user to reconnect a server whose `problem` is its address or its key. The user makes the fix in the dashboard (Brain → Integrations → More apps). If `suggestedAddress` is present, that is the address to use.\";\n\n/** The hint for a server whose last check failed for a reason that may already have passed. */\nconst LAST_CHECK_FAILED_HINT =\n  \"A server with lastCheck=failed was unreachable or erroring when it was last checked — that may already have passed, and its tools ARE loaded this turn. Try the tool; if it works, say nothing about the check. If it fails, report `problem` as what happened rather than guessing.\";\n\n/** Turn repeated `--header \"K: V\"` (or `K=V`) flags into a headers record. */\n/** `--header` is repeatable, so its values come off the command line — citty keeps only the last. */\nfunction parseHeaders(raw: unknown, rawArgs?: readonly string[]): Record<string, string> | undefined {\n  const list = repeatedValues(rawArgs, \"header\", raw);\n  const headers: Record<string, string> = {};\n  for (const entry of list) {\n    const text = String(entry);\n    const sep = text.indexOf(\":\") >= 0 && (text.indexOf(\":\") < text.indexOf(\"=\") || text.indexOf(\"=\") < 0) ? \":\" : \"=\";\n    const at = text.indexOf(sep);\n    if (at <= 0) {\n      throw new ApiError(\"VALIDATION_ERROR\", `Invalid header \"${text}\". Use \"Key: Value\".`);\n    }\n    headers[text.slice(0, at).trim()] = text.slice(at + 1).trim();\n  }\n  return Object.keys(headers).length > 0 ? headers : undefined;\n}\n\nfunction fail(err: unknown): never {\n  if (err instanceof ApiError) {\n    writeJson({ ok: false, error: { code: err.code, message: err.message } });\n    process.exit(1);\n  }\n  writeJson({ ok: false, error: { code: \"NETWORK_ERROR\", message: \"Unexpected error\" } });\n  process.exit(1);\n}\n\ntype ManagedConnection = {\n  toolkitSlug: string;\n  scope: \"user\" | \"user_org\" | \"company\" | \"org\";\n  status: string;\n  accountLabel: string | null;\n  readOnly: boolean;\n};\n\ntype ConnectedResponse = {\n  managed: ManagedConnection[];\n  custom: CustomMcpServer[];\n  platforms: ConnectedPlatform[];\n};\n\n/** The one thing an agent must not do with this list: infer a platform's state from the MCP half. */\nconst PLATFORMS_HINT =\n  \"`platforms` are connected accounts you reach through `baker` commands (HubSpot, Google Ads, GA4, Search Console, Tag Manager, …), NOT mcp__* tools — there is no tool to call for them. A platform listed here IS connected: never tell the user to connect it, and never conclude it is missing because it has no mcp__* entry. Read what it holds with its own command family (`baker hubspot …`, `baker ads google …`, `baker ga4 …`, and so on).\";\n\nregisterSchema({\n  command: \"mcp.connected\",\n  description:\n    \"List everything this chat can reach: managed integrations (Attio, Slack, Gmail, Google Sheets, …), custom MCP servers, and the platforms the company signed in to (HubSpot, Google Ads, GA4, Search Console, Tag Manager) which you read through their own `baker` commands. Start here when the user mentions an external tool or platform.\",\n  args: {},\n});\n\nconst connectedCommand = defineCommand({\n  meta: {\n    name: \"connected\",\n    description: `Everything this chat can reach — managed integrations, custom MCP servers, and connected platforms.\n\nManaged tools ride the composio servers (mcp__composio_<scope>__*); custom servers expose mcp__<name>__*.\nPlatforms (HubSpot, Google Ads, GA4, …) have no mcp__* tools at all — you read them with their own\n\\`baker\\` command family, and one listed here is connected and ready to use.\nA tool or platform the user names that is NOT listed anywhere here is simply not connected yet.`,\n  },\n  run: async () => {\n    try {\n      const user = actingUserId();\n      const data = await apiGet<ConnectedResponse>(\"/api/mcp/connected\", user ? { actingUserId: user } : undefined);\n      const managed = data.managed.map((c) => ({\n        toolkit: c.toolkitSlug,\n        scope: c.scope,\n        ...(c.status !== \"ACTIVE\" ? { status: c.status } : {}),\n        ...(c.accountLabel ? { account: c.accountLabel } : {}),\n        ...(c.readOnly ? { readOnly: true } : {}),\n      }));\n      const custom = data.custom.map(customEntry);\n      const platforms = (data.platforms ?? []).map(platformEntry);\n      const hints: string[] = [];\n      if (platforms.length > 0) {\n        hints.push(PLATFORMS_HINT);\n      }\n      if (data.custom.some((s) => s.health && !s.health.ok && !s.health.transient)) {\n        hints.push(BROKEN_SERVER_HINT);\n      }\n      if (data.custom.some((s) => s.health && !s.health.ok && s.health.transient)) {\n        hints.push(LAST_CHECK_FAILED_HINT);\n      }\n      if ([...data.managed, ...data.custom].some((e) => e.scope === \"user\" || e.scope === \"user_org\")) {\n        hints.push(\n          \"user/user_org entries are personal: they belong to the current message sender and load only in their turns — other users in this chat won't have them.\",\n        );\n      }\n      hints.push(\n        \"Not listed anywhere = not connected — connect it from the chat with request_connection, never by sending the user to the dashboard: a Baker platform (HubSpot, Google Ads, GA4, …) → { platform }; anything else → the vendor's own MCP server FIRST: use the address the user gave you, or WebSearch '<vendor> MCP server' and WebFetch its official docs for the remote https address and how it signs in, then { server: { name, url, auth, keyHeader } }; only when the vendor has none → `baker mcp catalog --search <name>`, then { app }. Research before you ask the user anything. What they connect loads into this same turn.\",\n      );\n      writeJson({\n        ok: true,\n        data: { managed, custom, platforms },\n        hints,\n      });\n    } catch (err) {\n      fail(err);\n    }\n  },\n});\n\nconst catalogArgs = {\n  search: { type: \"string\", description: \"App or vendor name, e.g. notion, clarity, pipedrive\", required: true },\n  limit: { type: \"string\", description: \"Max apps to return, 1-20 (default 8)\", required: false },\n} as const;\n\nregisterSchema({\n  command: \"mcp.catalog\",\n  description:\n    \"Search the managed apps you can ask the user to connect when a vendor has no MCP server of its own. Each app says how the user connects it (sign-in | key) and whether this chat already reaches it. Example: baker mcp catalog --search notion\",\n  args: catalogArgs,\n});\n\nconst catalogCommand = defineCommand({\n  meta: {\n    name: \"catalog\",\n    description: `Managed apps you can ask the user to connect when a vendor has no MCP server of its own.\n\nFor a tool \\`baker mcp connected\\` does not list whose vendor has no official remote MCP server:\n  baker mcp catalog --search notion\n  baker mcp catalog --search \"microsoft clarity\" --limit 3\n\nEach app: app (slug for request_connection), name, description, connect (sign-in | key), connected.\nPrefer the vendor's own MCP server when it publishes one; a catalog app is the fallback.`,\n  },\n  args: catalogArgs,\n  run: async ({ args }) => {\n    const parsed = mcpCatalogRequestSchema.safeParse({ search: args.search, limit: args.limit });\n    if (!parsed.success) {\n      writeJson({\n        ok: false,\n        error: { code: \"VALIDATION_ERROR\", message: parsed.error.issues[0]?.message ?? \"Invalid arguments\" },\n      });\n      process.exit(1);\n    }\n    try {\n      const user = actingUserId();\n      const data = await apiGet<McpCatalogResponse>(\"/api/mcp/catalog\", {\n        search: parsed.data.search,\n        limit: String(parsed.data.limit),\n        ...(user ? { actingUserId: user } : {}),\n      });\n      writeJson({\n        ok: true,\n        data: {\n          apps: data.apps,\n          ...(data.platforms?.length ? { platforms: data.platforms } : {}),\n        },\n        hints: catalogHints(data.apps, { platforms: data.platforms ?? [] }),\n      });\n    } catch (err) {\n      fail(err);\n    }\n  },\n});\n\nregisterSchema({\n  command: \"mcp.list\",\n  description: \"List the custom MCP servers this company's chats see (org + company + your own user scope).\",\n  args: {},\n});\n\nconst listCommand = defineCommand({\n  meta: { name: \"list\", description: \"List custom MCP servers visible to this company's chats.\" },\n  run: async () => {\n    try {\n      const user = actingUserId();\n      const data = await apiGet<{ servers: CustomMcpServer[] }>(\n        \"/api/mcp/custom\",\n        user ? { actingUserId: user } : undefined,\n      );\n      writeJson({\n        ok: true,\n        // Detail view: the full row (address included) plus the usability verdict.\n        // `health` itself is folded into `usable`/`problem` by `customEntry`.\n        data: data.servers.map((server) => ({ ...server, health: undefined, ...customEntry(server) })),\n        ...(data.servers.some((s) => s.health && !s.health.ok)\n          ? {\n              hints: data.servers.some((s) => s.health && !s.health.ok && !s.health.transient)\n                ? [BROKEN_SERVER_HINT]\n                : [LAST_CHECK_FAILED_HINT],\n            }\n          : {}),\n      });\n    } catch (err) {\n      fail(err);\n    }\n  },\n});\n\nregisterSchema({\n  command: \"mcp.add\",\n  description:\n    \"Register a custom MCP server. Tools appear as mcp__<name>__* on the next message. URL must be HTTPS. Scope: company (default, all chats) | org (org admin key) | user (only the current sender).\",\n  args: {\n    name: { type: \"string\", description: \"Server name → tools appear as mcp__<name>__*\", required: true },\n    url: {\n      type: \"string\",\n      description: \"Full HTTPS MCP endpoint (commonly ends in /mcp, not just the domain)\",\n      required: true,\n    },\n    scope: { type: \"string\", description: \"user | user_org | company | org (default company)\", required: false },\n    header: { type: \"string\", description: 'Auth header \"Key: Value\" (repeatable)', required: false },\n  },\n});\n\nconst addCommand = defineCommand({\n  meta: {\n    name: \"add\",\n    description: `Register a custom MCP server. Tools appear as mcp__<name>__* on the NEXT message.\nFor a server the USER asks for, use request_connection { server } instead: they confirm who can use it,\ntype any key into the card (never the chat), and its tools load in this same turn.\n\nScope: company (default — every chat in the company) | org (all companies in the org; needs an admin key) | user (only the current message sender).\n\nExamples:\n  baker mcp add --name weather --url https://mcp.example.com/mcp\n  baker mcp add --name acme --url https://acme.dev/mcp --header \"Authorization: Bearer sk-…\"\n  baker mcp add --name mine --url https://my.dev/mcp --scope user`,\n  },\n  args: {\n    name: { type: \"string\", description: \"Server name (mcp__<name>__*)\", required: true },\n    url: {\n      type: \"string\",\n      description: \"Full HTTPS MCP endpoint (commonly ends in /mcp, not just the domain)\",\n      required: true,\n    },\n    scope: { type: \"string\", description: \"user | user_org | company | org (default company)\", required: false },\n    header: { type: \"string\", description: 'Auth header \"Key: Value\" (repeatable)', required: false },\n  },\n  run: async ({ args, rawArgs }) => {\n    try {\n      const scope = parseScope(args.scope);\n      const user = actingUserId();\n      const headers = parseHeaders(args.header, rawArgs);\n      const data = await apiPost<{ name: string }>(\"/api/mcp/custom\", {\n        name: args.name as string,\n        url: args.url as string,\n        scope,\n        ...(user ? { actingUserId: user } : {}),\n        ...(headers ? { headers } : {}),\n      });\n      writeJson({\n        ok: true,\n        data,\n        hints: [\n          \"The address must be the full MCP endpoint (commonly ending in /mcp), not just the domain — a domain on its own usually answers sign-in and then serves no tools.\",\n          \"The address is checked in the background. Run `baker mcp connected` on the next message to confirm it serves tools before promising the user anything.\",\n        ],\n      });\n    } catch (err) {\n      fail(err);\n    }\n  },\n});\n\nregisterSchema({\n  command: \"mcp.remove\",\n  description: \"Remove a company custom MCP server by name.\",\n  args: { name: { type: \"string\", description: \"Server name to remove\", required: true } },\n});\n\nconst removeCommand = defineCommand({\n  meta: {\n    name: \"remove\",\n    description: `Remove a company custom MCP server by name.\n\nExample:\n  baker mcp remove --name weather`,\n  },\n  args: { name: { type: \"string\", description: \"Server name to remove\", required: true } },\n  run: async ({ args }) => {\n    try {\n      const user = actingUserId();\n      const data = await apiPost<{ removed: boolean }>(\"/api/mcp/custom/remove\", {\n        name: args.name as string,\n        ...(user ? { actingUserId: user } : {}),\n      });\n      writeJson({ ok: true, data });\n    } catch (err) {\n      fail(err);\n    }\n  },\n});\n\nconst serverNameArgs = {\n  name: { type: \"string\", description: \"Custom server name, as `baker mcp list` shows it\", required: true },\n} as const;\n\nregisterSchema({\n  command: \"mcp.verify\",\n  description:\n    \"Check a custom MCP server now (the dashboard's 'Check now') and store the result. Use after the user fixed its address or sign-in, or when its tools failed this turn.\",\n  args: serverNameArgs,\n});\n\nconst verifyCommand = defineCommand({\n  meta: {\n    name: \"verify\",\n    description: `Check a custom MCP server now and store the result.\n\nExample:\n  baker mcp verify --name weather`,\n  },\n  args: serverNameArgs,\n  run: async ({ args }) => {\n    const parsed = customMcpServerNameRequestSchema.safeParse({ name: args.name, actingUserId: actingUserId() });\n    if (!parsed.success) {\n      fail(new ApiError(\"VALIDATION_ERROR\", parsed.error.issues[0]?.message ?? \"Invalid arguments\"));\n    }\n    try {\n      const data = await apiPost<CustomMcpVerifyResponse>(\"/api/mcp/custom/verify\", parsed.data);\n      writeJson({\n        ok: true,\n        data,\n        hints: [\n          data.ok\n            ? \"The server answers and serves tools. Its tools load on the next message.\"\n            : data.transient\n              ? LAST_CHECK_FAILED_HINT\n              : BROKEN_SERVER_HINT,\n        ],\n      });\n    } catch (err) {\n      fail(err);\n    }\n  },\n});\n\nregisterSchema({\n  command: \"mcp.disable\",\n  description:\n    \"Switch a custom MCP server off so its tools stop loading; its address and sign-in are kept. Turning it back on is done by a person in the dashboard, never by the agent.\",\n  args: serverNameArgs,\n});\n\nconst disableCommand = defineCommand({\n  meta: {\n    name: \"disable\",\n    description: `Switch a custom MCP server off (its tools stop loading). Only a person can turn it back on, in the dashboard.\n\nExample:\n  baker mcp disable --name weather`,\n  },\n  args: serverNameArgs,\n  run: async ({ args }) => {\n    const parsed = customMcpServerNameRequestSchema.safeParse({ name: args.name, actingUserId: actingUserId() });\n    if (!parsed.success) {\n      fail(new ApiError(\"VALIDATION_ERROR\", parsed.error.issues[0]?.message ?? \"Invalid arguments\"));\n    }\n    try {\n      const data = await apiPost<CustomMcpDisableResponse>(\"/api/mcp/custom/disable\", parsed.data);\n      writeJson({\n        ok: true,\n        data,\n        hints: [\n          \"Its tools stop loading from the next message, and this applies right away — publishing or discarding this chat does not undo it. Tell the user they can turn it back on in Brain → Integrations → More apps.\",\n        ],\n      });\n    } catch (err) {\n      fail(err);\n    }\n  },\n});\n\nexport const mcpCommand = defineCommand({\n  meta: {\n    name: \"mcp\",\n    description: `Third-party tools for this company — see what's connected, register custom HTTPS MCP endpoints.\n\nTools from a registered server appear as mcp__<name>__* on the next message.\nManaged here are **company-scoped** servers; user- and org-scoped servers are managed in the dashboard.\n\nStart here:\n  baker mcp connected   # everything this chat can reach: managed integrations, custom servers, connected platforms\n  baker mcp catalog --search notion   # managed apps you can connect when a vendor has no MCP server of its own\n\nExamples:\n  baker mcp add --name weather --url https://mcp.example.com/mcp\n  baker mcp add --name acme --url https://acme.dev/mcp --header \"Authorization: Bearer sk-…\"\n  baker mcp remove --name weather\n  baker mcp verify --name weather    # check it now after the user fixed it\n  baker mcp disable --name weather   # stop its tools loading (only a person turns it back on)\nFull guide: __tooling__/docs/tools/baker/mcp.md`,\n  },\n  subCommands: {\n    connected: connectedCommand,\n    catalog: catalogCommand,\n    list: listCommand,\n    add: addCommand,\n    remove: removeCommand,\n    verify: verifyCommand,\n    disable: disableCommand,\n  },\n});\n","/**\n * What `baker mcp catalog` tells the agent to do next with the managed apps it\n * found — the fallback when a vendor publishes no MCP server of its own.\n */\nimport type { McpCatalogEntry } from \"@baker/api/mcp-catalog\";\n\nconst PREFER_VENDOR_HINT =\n  'The vendor\\'s own MCP server comes before any app here. If you have not yet, WebSearch \"<vendor> MCP server\" and WebFetch its official docs for the remote https address and how it signs in, then ask for it with request_connection `{ server: { name, url, auth, keyHeader } }`. Only when the vendor has none, ask for an app from this catalog with request_connection `{ app: \"<slug>\", reason }` — the user connects it in the chat and its tools load right after, in this same turn.';\n\nconst ALREADY_CONNECTED_HINT =\n  \"An app marked connected is already reachable — use its mcp__composio_* tools; do not ask again.\";\n\nconst NO_MATCH_HINT =\n  \"Nothing in the catalog matches. WebSearch for the vendor's official remote MCP server (its docs, its developer site) before telling the user it can't be connected — if one exists, ask for it with request_connection `{ server }`. Only when the web shows no official remote server either, say plainly this tool can't be connected yet and offer a Task.\";\n\n/** Baker's own connection always wins over a catalog app or anyone's MCP server for the same tool. */\nfunction firstPartyHint(platforms: readonly string[]): string {\n  const asks = platforms.map((p) => `request_connection \\`{ platform: \"${p}\" }\\``).join(\" or \");\n  return `This is one of Baker's own connections — ask for it with ${asks}. It is the one Baker's commands, staging and publish work with, so never connect it as a catalog app or as an MCP server, even one the vendor publishes or the user names. If it is already connected, read it with its own baker command family instead.`;\n}\n\n/** What the agent should do next with a catalog answer. */\nexport function catalogHints(\n  apps: readonly McpCatalogEntry[],\n  { platforms = [] }: { platforms?: readonly string[] } = {},\n): string[] {\n  if (platforms.length > 0) {\n    return [firstPartyHint(platforms)];\n  }\n  const hints = [PREFER_VENDOR_HINT];\n  if (apps.some((a) => a.connected)) {\n    hints.push(ALREADY_CONNECTED_HINT);\n  }\n  if (apps.length === 0) {\n    hints.push(NO_MATCH_HINT);\n  }\n  return hints;\n}\n","/**\n * How a connected platform reads back to the agent.\n *\n * A platform (HubSpot, Google Ads, GA4, …) is an account the company signed in\n * to, reached through its own `baker` command family rather than an `mcp__*`\n * tool. It rides `mcp connected` because that is the one answer to \"what can\n * this chat reach\" — and because an agent that only saw the tool half had no\n * way to tell a working HubSpot connection from a missing one.\n */\n\nexport interface ConnectedPlatform {\n  type: string;\n  label: string;\n  account: string | null;\n  reads: string[];\n  readsLabel: string | null;\n}\n\n/** \"Ad Accounts\" -> `adAccounts`, \"Properties\" -> `properties`. */\nfunction readsKey(label: string): string {\n  const [first = \"\", ...rest] = label.split(\" \");\n  return [first.toLowerCase(), ...rest].join(\"\");\n}\n\n/**\n * One platform as the agent sees it. The resources are keyed by the platform's\n * own word for them — `properties` for GA4, `containers` for Tag Manager,\n * `adAccounts` for the ad platforms — so what the agent reads back matches what\n * the user sees in the dashboard.\n */\nexport function platformEntry(platform: ConnectedPlatform): Record<string, unknown> {\n  return {\n    platform: platform.label,\n    ...(platform.account ? { account: platform.account } : {}),\n    ...(platform.readsLabel && platform.reads.length > 0 ? { [readsKey(platform.readsLabel)]: platform.reads } : {}),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AASA,SAAS,SAAS;AAEX,IAAM,4BAA4B;AAClC,IAAM,8BAA8B;AAEpC,IAAM,0BAA0B,EAAE,OAAO;AAAA,EAC9C,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,GAAG,kBAAkB,EAAE,IAAI,GAAG;AAAA,EAC5D,OAAO,EAAE,OAAO,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,yBAAyB;AACjF,CAAC;AAGM,IAAM,0BAA0B,EAAE,KAAK,CAAC,WAAW,KAAK,CAAC;AAGzD,IAAM,wBAAwB,EAAE,OAAO;AAAA;AAAA,EAE5C,KAAK,EAAE,OAAO;AAAA,EACd,MAAM,EAAE,OAAO;AAAA,EACf,aAAa,EAAE,OAAO,EAAE,IAAI,2BAA2B;AAAA,EACvD,SAAS;AAAA,EACT,WAAW,EAAE,QAAQ;AACvB,CAAC;AAGM,IAAM,2BAA2B,EAAE,OAAO;AAAA,EAC/C,MAAM,EAAE,MAAM,qBAAqB;AAAA;AAAA,EAEnC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS;AAC1C,CAAC;;;AC/BD,SAAS,qBAAqB;;;ACA9B,IAAM,qBACJ;AAEF,IAAM,yBACJ;AAEF,IAAM,gBACJ;AAGF,SAAS,eAAe,WAAsC;AAC5D,QAAM,OAAO,UAAU,IAAI,CAAC,MAAM,qCAAqC,CAAC,OAAO,EAAE,KAAK,MAAM;AAC5F,SAAO,iEAA4D,IAAI;AACzE;AAGO,SAAS,aACd,MACA,EAAE,YAAY,CAAC,EAAE,IAAuC,CAAC,GAC/C;AACV,MAAI,UAAU,SAAS,GAAG;AACxB,WAAO,CAAC,eAAe,SAAS,CAAC;AAAA,EACnC;AACA,QAAM,QAAQ,CAAC,kBAAkB;AACjC,MAAI,KAAK,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG;AACjC,UAAM,KAAK,sBAAsB;AAAA,EACnC;AACA,MAAI,KAAK,WAAW,GAAG;AACrB,UAAM,KAAK,aAAa;AAAA,EAC1B;AACA,SAAO;AACT;;;AClBA,SAAS,SAAS,OAAuB;AACvC,QAAM,CAAC,QAAQ,IAAI,GAAG,IAAI,IAAI,MAAM,MAAM,GAAG;AAC7C,SAAO,CAAC,MAAM,YAAY,GAAG,GAAG,IAAI,EAAE,KAAK,EAAE;AAC/C;AAQO,SAAS,cAAc,UAAsD;AAClF,SAAO;AAAA,IACL,UAAU,SAAS;AAAA,IACnB,GAAI,SAAS,UAAU,EAAE,SAAS,SAAS,QAAQ,IAAI,CAAC;AAAA,IACxD,GAAI,SAAS,cAAc,SAAS,MAAM,SAAS,IAAI,EAAE,CAAC,SAAS,SAAS,UAAU,CAAC,GAAG,SAAS,MAAM,IAAI,CAAC;AAAA,EAChH;AACF;;;AFrBA,IAAM,SAAS,CAAC,QAAQ,YAAY,WAAW,KAAK;AAGpD,SAAS,WAAW,KAAqB;AACvC,QAAM,QAAQ,QAAQ,SAAY,YAAY,OAAO,GAAG;AACxD,MAAI,CAAE,OAA6B,SAAS,KAAK,GAAG;AAClD,UAAM,IAAI,SAAS,oBAAoB,oBAAoB,KAAK,yCAAyC;AAAA,EAC3G;AACA,SAAO;AACT;AAGA,SAAS,eAAmC;AAC1C,SAAO,OAAO,EAAE;AAClB;AAqBA,SAAS,YAAY,QAAkD;AACrE,QAAM,SAAS,OAAO,UAAU,CAAC,OAAO,OAAO;AAC/C,QAAM,UAAU,OAAO,QAAQ,WAAW;AAC1C,SAAO;AAAA,IACL,MAAM,OAAO;AAAA,IACb,OAAO,OAAO;AAAA,IACd,SAAS,OAAO;AAAA,IAChB,GAAI,UAAU,CAAC,OAAO,QAAQ,YAAY,EAAE,QAAQ,OAAO,QAAQ,IAAI,CAAC;AAAA,IACxE,GAAI,UAAU,OAAO,QAAQ,YAAY,EAAE,WAAW,UAAU,QAAQ,IAAI,CAAC;AAAA,IAC7E,GAAI,UAAU,OAAO,QAAQ,eAAe,EAAE,kBAAkB,OAAO,OAAO,aAAa,IAAI,CAAC;AAAA,EAClG;AACF;AAGA,IAAM,qBACJ;AAGF,IAAM,yBACJ;AAIF,SAAS,aAAa,KAAc,SAAiE;AACnG,QAAM,OAAO,eAAe,SAAS,UAAU,GAAG;AAClD,QAAM,UAAkC,CAAC;AACzC,aAAW,SAAS,MAAM;AACxB,UAAM,OAAO,OAAO,KAAK;AACzB,UAAM,MAAM,KAAK,QAAQ,GAAG,KAAK,MAAM,KAAK,QAAQ,GAAG,IAAI,KAAK,QAAQ,GAAG,KAAK,KAAK,QAAQ,GAAG,IAAI,KAAK,MAAM;AAC/G,UAAM,KAAK,KAAK,QAAQ,GAAG;AAC3B,QAAI,MAAM,GAAG;AACX,YAAM,IAAI,SAAS,oBAAoB,mBAAmB,IAAI,sBAAsB;AAAA,IACtF;AACA,YAAQ,KAAK,MAAM,GAAG,EAAE,EAAE,KAAK,CAAC,IAAI,KAAK,MAAM,KAAK,CAAC,EAAE,KAAK;AAAA,EAC9D;AACA,SAAO,OAAO,KAAK,OAAO,EAAE,SAAS,IAAI,UAAU;AACrD;AAEA,SAAS,KAAK,KAAqB;AACjC,MAAI,eAAe,UAAU;AAC3B,cAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;AACxE,YAAQ,KAAK,CAAC;AAAA,EAChB;AACA,YAAU,EAAE,IAAI,OAAO,OAAO,EAAE,MAAM,iBAAiB,SAAS,mBAAmB,EAAE,CAAC;AACtF,UAAQ,KAAK,CAAC;AAChB;AAiBA,IAAM,iBACJ;AAEF,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM,CAAC;AACT,CAAC;AAED,IAAM,mBAAmB,cAAc;AAAA,EACrC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMf;AAAA,EACA,KAAK,YAAY;AACf,QAAI;AACF,YAAM,OAAO,aAAa;AAC1B,YAAM,OAAO,MAAM,OAA0B,sBAAsB,OAAO,EAAE,cAAc,KAAK,IAAI,MAAS;AAC5G,YAAM,UAAU,KAAK,QAAQ,IAAI,CAAC,OAAO;AAAA,QACvC,SAAS,EAAE;AAAA,QACX,OAAO,EAAE;AAAA,QACT,GAAI,EAAE,WAAW,WAAW,EAAE,QAAQ,EAAE,OAAO,IAAI,CAAC;AAAA,QACpD,GAAI,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,IAAI,CAAC;AAAA,QACpD,GAAI,EAAE,WAAW,EAAE,UAAU,KAAK,IAAI,CAAC;AAAA,MACzC,EAAE;AACF,YAAM,SAAS,KAAK,OAAO,IAAI,WAAW;AAC1C,YAAM,aAAa,KAAK,aAAa,CAAC,GAAG,IAAI,aAAa;AAC1D,YAAM,QAAkB,CAAC;AACzB,UAAI,UAAU,SAAS,GAAG;AACxB,cAAM,KAAK,cAAc;AAAA,MAC3B;AACA,UAAI,KAAK,OAAO,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,MAAM,CAAC,EAAE,OAAO,SAAS,GAAG;AAC5E,cAAM,KAAK,kBAAkB;AAAA,MAC/B;AACA,UAAI,KAAK,OAAO,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,MAAM,EAAE,OAAO,SAAS,GAAG;AAC3E,cAAM,KAAK,sBAAsB;AAAA,MACnC;AACA,UAAI,CAAC,GAAG,KAAK,SAAS,GAAG,KAAK,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,UAAU,EAAE,UAAU,UAAU,GAAG;AAC/F,cAAM;AAAA,UACJ;AAAA,QACF;AAAA,MACF;AACA,YAAM;AAAA,QACJ;AAAA,MACF;AACA,gBAAU;AAAA,QACR,IAAI;AAAA,QACJ,MAAM,EAAE,SAAS,QAAQ,UAAU;AAAA,QACnC;AAAA,MACF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,WAAK,GAAG;AAAA,IACV;AAAA,EACF;AACF,CAAC;AAED,IAAM,cAAc;AAAA,EAClB,QAAQ,EAAE,MAAM,UAAU,aAAa,uDAAuD,UAAU,KAAK;AAAA,EAC7G,OAAO,EAAE,MAAM,UAAU,aAAa,wCAAwC,UAAU,MAAM;AAChG;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AACR,CAAC;AAED,IAAM,iBAAiB,cAAc;AAAA,EACnC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQf;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,SAAS,wBAAwB,UAAU,EAAE,QAAQ,KAAK,QAAQ,OAAO,KAAK,MAAM,CAAC;AAC3F,QAAI,CAAC,OAAO,SAAS;AACnB,gBAAU;AAAA,QACR,IAAI;AAAA,QACJ,OAAO,EAAE,MAAM,oBAAoB,SAAS,OAAO,MAAM,OAAO,CAAC,GAAG,WAAW,oBAAoB;AAAA,MACrG,CAAC;AACD,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,QAAI;AACF,YAAM,OAAO,aAAa;AAC1B,YAAM,OAAO,MAAM,OAA2B,oBAAoB;AAAA,QAChE,QAAQ,OAAO,KAAK;AAAA,QACpB,OAAO,OAAO,OAAO,KAAK,KAAK;AAAA,QAC/B,GAAI,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AAAA,MACvC,CAAC;AACD,gBAAU;AAAA,QACR,IAAI;AAAA,QACJ,MAAM;AAAA,UACJ,MAAM,KAAK;AAAA,UACX,GAAI,KAAK,WAAW,SAAS,EAAE,WAAW,KAAK,UAAU,IAAI,CAAC;AAAA,QAChE;AAAA,QACA,OAAO,aAAa,KAAK,MAAM,EAAE,WAAW,KAAK,aAAa,CAAC,EAAE,CAAC;AAAA,MACpE,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,WAAK,GAAG;AAAA,IACV;AAAA,EACF;AACF,CAAC;AAED,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM,CAAC;AACT,CAAC;AAED,IAAM,cAAc,cAAc;AAAA,EAChC,MAAM,EAAE,MAAM,QAAQ,aAAa,2DAA2D;AAAA,EAC9F,KAAK,YAAY;AACf,QAAI;AACF,YAAM,OAAO,aAAa;AAC1B,YAAM,OAAO,MAAM;AAAA,QACjB;AAAA,QACA,OAAO,EAAE,cAAc,KAAK,IAAI;AAAA,MAClC;AACA,gBAAU;AAAA,QACR,IAAI;AAAA;AAAA;AAAA,QAGJ,MAAM,KAAK,QAAQ,IAAI,CAAC,YAAY,EAAE,GAAG,QAAQ,QAAQ,QAAW,GAAG,YAAY,MAAM,EAAE,EAAE;AAAA,QAC7F,GAAI,KAAK,QAAQ,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,IACjD;AAAA,UACE,OAAO,KAAK,QAAQ,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,MAAM,CAAC,EAAE,OAAO,SAAS,IAC3E,CAAC,kBAAkB,IACnB,CAAC,sBAAsB;AAAA,QAC7B,IACA,CAAC;AAAA,MACP,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,WAAK,GAAG;AAAA,IACV;AAAA,EACF;AACF,CAAC;AAED,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,MAAM,EAAE,MAAM,UAAU,aAAa,qDAAgD,UAAU,KAAK;AAAA,IACpG,KAAK;AAAA,MACH,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,OAAO,EAAE,MAAM,UAAU,aAAa,qDAAqD,UAAU,MAAM;AAAA,IAC3G,QAAQ,EAAE,MAAM,UAAU,aAAa,yCAAyC,UAAU,MAAM;AAAA,EAClG;AACF,CAAC;AAED,IAAM,aAAa,cAAc;AAAA,EAC/B,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUf;AAAA,EACA,MAAM;AAAA,IACJ,MAAM,EAAE,MAAM,UAAU,aAAa,gCAAgC,UAAU,KAAK;AAAA,IACpF,KAAK;AAAA,MACH,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,OAAO,EAAE,MAAM,UAAU,aAAa,qDAAqD,UAAU,MAAM;AAAA,IAC3G,QAAQ,EAAE,MAAM,UAAU,aAAa,yCAAyC,UAAU,MAAM;AAAA,EAClG;AAAA,EACA,KAAK,OAAO,EAAE,MAAM,QAAQ,MAAM;AAChC,QAAI;AACF,YAAM,QAAQ,WAAW,KAAK,KAAK;AACnC,YAAM,OAAO,aAAa;AAC1B,YAAM,UAAU,aAAa,KAAK,QAAQ,OAAO;AACjD,YAAM,OAAO,MAAM,QAA0B,mBAAmB;AAAA,QAC9D,MAAM,KAAK;AAAA,QACX,KAAK,KAAK;AAAA,QACV;AAAA,QACA,GAAI,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AAAA,QACrC,GAAI,UAAU,EAAE,QAAQ,IAAI,CAAC;AAAA,MAC/B,CAAC;AACD,gBAAU;AAAA,QACR,IAAI;AAAA,QACJ;AAAA,QACA,OAAO;AAAA,UACL;AAAA,UACA;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,WAAK,GAAG;AAAA,IACV;AAAA,EACF;AACF,CAAC;AAED,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aAAa;AAAA,EACb,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,aAAa,yBAAyB,UAAU,KAAK,EAAE;AACzF,CAAC;AAED,IAAM,gBAAgB,cAAc;AAAA,EAClC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,aAAa,yBAAyB,UAAU,KAAK,EAAE;AAAA,EACvF,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,OAAO,aAAa;AAC1B,YAAM,OAAO,MAAM,QAA8B,0BAA0B;AAAA,QACzE,MAAM,KAAK;AAAA,QACX,GAAI,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AAAA,MACvC,CAAC;AACD,gBAAU,EAAE,IAAI,MAAM,KAAK,CAAC;AAAA,IAC9B,SAAS,KAAK;AACZ,WAAK,GAAG;AAAA,IACV;AAAA,EACF;AACF,CAAC;AAED,IAAM,iBAAiB;AAAA,EACrB,MAAM,EAAE,MAAM,UAAU,aAAa,oDAAoD,UAAU,KAAK;AAC1G;AAEA,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AACR,CAAC;AAED,IAAM,gBAAgB,cAAc;AAAA,EAClC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,SAAS,iCAAiC,UAAU,EAAE,MAAM,KAAK,MAAM,cAAc,aAAa,EAAE,CAAC;AAC3G,QAAI,CAAC,OAAO,SAAS;AACnB,WAAK,IAAI,SAAS,oBAAoB,OAAO,MAAM,OAAO,CAAC,GAAG,WAAW,mBAAmB,CAAC;AAAA,IAC/F;AACA,QAAI;AACF,YAAM,OAAO,MAAM,QAAiC,0BAA0B,OAAO,IAAI;AACzF,gBAAU;AAAA,QACR,IAAI;AAAA,QACJ;AAAA,QACA,OAAO;AAAA,UACL,KAAK,KACD,6EACA,KAAK,YACH,yBACA;AAAA,QACR;AAAA,MACF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,WAAK,GAAG;AAAA,IACV;AAAA,EACF;AACF,CAAC;AAED,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AACR,CAAC;AAED,IAAM,iBAAiB,cAAc;AAAA,EACnC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA,EAIf;AAAA,EACA,MAAM;AAAA,EACN,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,SAAS,iCAAiC,UAAU,EAAE,MAAM,KAAK,MAAM,cAAc,aAAa,EAAE,CAAC;AAC3G,QAAI,CAAC,OAAO,SAAS;AACnB,WAAK,IAAI,SAAS,oBAAoB,OAAO,MAAM,OAAO,CAAC,GAAG,WAAW,mBAAmB,CAAC;AAAA,IAC/F;AACA,QAAI;AACF,YAAM,OAAO,MAAM,QAAkC,2BAA2B,OAAO,IAAI;AAC3F,gBAAU;AAAA,QACR,IAAI;AAAA,QACJ;AAAA,QACA,OAAO;AAAA,UACL;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,WAAK,GAAG;AAAA,IACV;AAAA,EACF;AACF,CAAC;AAEM,IAAM,aAAa,cAAc;AAAA,EACtC,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBf;AAAA,EACA,aAAa;AAAA,IACX,WAAW;AAAA,IACX,SAAS;AAAA,IACT,MAAM;AAAA,IACN,KAAK;AAAA,IACL,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,SAAS;AAAA,EACX;AACF,CAAC;","names":[]}

package/dist/media-2SWDJDA6.js

@@ -0,0 +1,15 @@
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/media.ts
+import { defineCommand } from "citty";
+var metaMediaCommand = defineCommand({
+  meta: {
+    name: "media",
+    description: "Stage Baker library media uploads to Meta so creatives can reference them. Subcommand: upload. Publishes an ad-image hash or video id a creative binds via --image-ref/--video-ref."
+  },
+  subCommands: { upload: () => import("./write-commands-5TJ3LQ5F.js").then((m) => m.mediaUploadCommand) }
+});
+export {
+  metaMediaCommand
+};
+//# sourceMappingURL=media-2SWDJDA6.js.map

package/dist/media-O5L7GO72.js

@@ -0,0 +1,89 @@
+import {
+  parseXApiError
+} from "./chunk-M6UNISGO.js";
+import {
+  resolveXAccountId
+} from "./chunk-H7JOVRHO.js";
+import {
+  cacheGet,
+  cacheSet,
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-LHNL6JM2.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-KB5XJHQX.js";
+import "./chunk-YONSWWCF.js";
+import "./chunk-QXDEZKAR.js";
+import {
+  registerSchema
+} from "./chunk-4DM6OAQ6.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/media.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.x.media",
+  description: "List media assets in the X Ads media library (images, GIFs, videos). Filter by media-type (IMAGE, GIF, VIDEO).",
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "media-type": { type: "string", description: "IMAGE | GIF | VIDEO", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  }
+});
+var mediaCommand = defineCommand({
+  meta: {
+    name: "media",
+    description: `List media assets in the X Ads media library.
+
+Examples:
+  baker ads x media --account-id 18ce53xyz
+  baker ads x media --account-id 18ce53xyz --media-type VIDEO`
+  },
+  args: {
+    "account-id": { type: "string", description: "X Ads account ID", required: false },
+    "media-type": { type: "string", description: "IMAGE | GIF | VIDEO", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false },
+    output: { type: "string", description: "Format: json|csv|md", required: false, default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = await resolveXAccountId(args);
+    const useCache = !args["no-cache"];
+    const cacheKey = `media:${accountId}:${args["media-type"] ?? "ALL"}`;
+    if (useCache) {
+      const cached = cacheGet("x-account-data", cacheKey);
+      if (cached) {
+        writeAdsJson({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      const params = { "account-id": accountId };
+      if (args["media-type"]) params["media-type"] = args["media-type"];
+      if (!useCache) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/x/media-library", params);
+      if (useCache) {
+        cacheSet("x-account-data", cacheKey, data, 6 * 60 * 60 * 1e3);
+      }
+      const format = args.output || "json";
+      if (format !== "json") {
+        writeAdsOutput(data, format);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseXApiError(err.message, accountId));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  mediaCommand
+};
+//# sourceMappingURL=media-O5L7GO72.js.map