@koda-sl/baker-cli 0.512.0 → 0.514.0-dev.555f7007e

package/dist/credentials-AYV5YQE4.js

@@ -0,0 +1,290 @@
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+import {
+  failApi,
+  failValidation
+} from "./chunk-SAAXU7QR.js";
+import "./chunk-NZ34KM46.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import {
+  getPublicSuffix,
+  parse
+} from "./chunk-MUS2UTWU.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// ../api/src/credentials/contract.ts
+import { z } from "zod";
+
+// ../api/src/credentials/hosts.ts
+function normaliseHost(host) {
+  return host.trim().toLowerCase().replace(/\.$/, "");
+}
+function asciiHost(host) {
+  if (!/[\u0080-\u{10FFFF}]/u.test(host) || /[/?#@:\\%[\]\s]/.test(host)) return host;
+  const url = `http://${host}`;
+  return URL.canParse(url) ? new URL(url).hostname : host;
+}
+function validateHostPattern(raw) {
+  const typed = normaliseHost(raw);
+  const wildcard = typed.startsWith("*.");
+  const host = asciiHost(wildcard ? typed.slice(2) : typed);
+  const pattern = wildcard ? `*.${host}` : host;
+  if (host === "" || host.includes("*")) {
+    return { ok: false, reason: "Use a website address like api.example.com or *.example.com." };
+  }
+  const parsed = parse(host);
+  if (parsed.isIp || host.startsWith("[")) {
+    return { ok: false, reason: "Use a website address, not an IP address." };
+  }
+  if (parsed.hostname !== host || parsed.domain === null) {
+    return { ok: false, reason: "Use only the website address, like api.example.com." };
+  }
+  if (wildcard && !wildcardSafe(host)) {
+    return { ok: false, reason: `*.${host} would allow any website. Name the company's own address.` };
+  }
+  return { ok: true, pattern };
+}
+var OPEN_HOSTING_DOMAINS = ["amazonaws.com", "cloudfront.net", "googleapis.com", "on.aws"];
+var WITH_PRIVATE = { allowPrivateDomains: true };
+function wildcardSafe(host) {
+  if (OPEN_HOSTING_DOMAINS.some((domain) => host === domain || host.endsWith(`.${domain}`))) return false;
+  const suffix = getPublicSuffix(host, WITH_PRIVATE);
+  return suffix !== host && getPublicSuffix(`zz.${host}`, WITH_PRIVATE) === suffix;
+}
+
+// ../api/src/credentials/placeholder.ts
+var CREDENTIAL_NAME_PATTERN = "[a-z0-9][a-z0-9_-]{0,63}";
+var CREDENTIAL_NAME_RE = new RegExp(`^${CREDENTIAL_NAME_PATTERN}$`);
+var PLACEHOLDER_SOURCE = `\\{\\{credential:(${CREDENTIAL_NAME_PATTERN})\\}\\}`;
+var WHOLE_PLACEHOLDER_RE = new RegExp(`^${PLACEHOLDER_SOURCE}$`);
+
+// ../api/src/credentials/contract.ts
+var MAX_CREDENTIAL_VALUE_LENGTH = 16384;
+var MAX_CREDENTIAL_HOSTS = 20;
+var credentialNameSchema = z.string().regex(new RegExp(`^${CREDENTIAL_NAME_PATTERN}$`), "Use lowercase letters, digits, - and _ (max 64).");
+var credentialHostsSchema = z.array(z.string()).max(MAX_CREDENTIAL_HOSTS).transform((hosts, ctx) => {
+  const patterns = [];
+  for (const host of hosts) {
+    const result = validateHostPattern(host);
+    if (result.ok) patterns.push(result.pattern);
+    else ctx.addIssue({ code: "custom", message: `${host}: ${result.reason}` });
+  }
+  return [...new Set(patterns)];
+});
+var credentialSourceSchema = z.enum(["user", "agent", "chat-detected", "requested"]);
+var credentialSummarySchema = z.object({
+  name: z.string(),
+  label: z.string(),
+  placeholder: z.string(),
+  allowedHosts: z.array(z.string()),
+  source: credentialSourceSchema,
+  lastUsedAt: z.number().nullable()
+});
+var credentialsListResponseSchema = z.object({ credentials: z.array(credentialSummarySchema) });
+var credentialsPutRequestSchema = z.object({
+  name: credentialNameSchema,
+  label: z.string().trim().min(1).max(80).optional(),
+  value: z.string().min(1).max(MAX_CREDENTIAL_VALUE_LENGTH),
+  allowedHosts: credentialHostsSchema
+});
+var credentialsPutResponseSchema = z.object({
+  name: z.string(),
+  placeholder: z.string(),
+  replaced: z.boolean()
+});
+var credentialsDeleteRequestSchema = z.object({ name: credentialNameSchema });
+var credentialsDeleteResponseSchema = z.object({ name: z.string(), deleted: z.literal(true) });
+var brokerResolveResponseSchema = z.object({
+  credentials: z.array(z.object({ name: z.string(), value: z.string(), allowedHosts: z.array(z.string()) }))
+});
+var brokerUsageRequestSchema = z.object({
+  uses: z.array(z.object({ name: credentialNameSchema, host: z.string().max(253) })).max(100)
+});
+
+// src/commands/credentials/index.ts
+import { defineCommand } from "citty";
+var DOC = "__tooling__/docs/tools/baker/credentials.md";
+var STDIN_ONLY = 'The value is read from stdin only, never from the command line (argv is visible to other processes and lands in logs). Pipe it: printf %s "$VALUE" | baker credentials put <name> --host <host>. For a credential the user owns, call request_credential instead.';
+registerSchema({
+  command: "credentials.list",
+  description: "Start here: the credentials (API keys, tokens, passwords) this company stored, by name \u2014 never their values. Write the `placeholder` ({{credential:NAME}}) into an HTTPS request (curl header, URL, SDK config, JSON body) and the sandbox proxy sends the real value, only to the credential's allowedHosts. Nothing listed? Ask the user with the request_credential tool. Compact by default; --full adds source and lastUsedAt.",
+  args: {
+    full: { type: "boolean", description: "Add source and lastUsedAt per credential", required: false, default: false }
+  }
+});
+registerSchema({
+  command: "credentials.put",
+  description: `Store a credential YOU created on the user's behalf (e.g. a key you just generated through an API), so later requests can use {{credential:NAME}}. Example: printf %s "$KEY" | baker credentials put stripe-key --host api.stripe.com --label "Stripe key". The value comes from stdin ONLY. For a credential the user owns, call request_credential instead \u2014 never ask for it in chat. Replacing is allowed only for credentials the agent created.`,
+  args: {
+    name: { type: "positional", description: "Lowercase name: letters, digits, - and _ (max 64)", required: true },
+    host: {
+      type: "string",
+      description: "Website the value may be sent to (repeatable, or comma-separated): api.stripe.com, acme-store.myshopify.com",
+      required: true
+    },
+    label: { type: "string", description: "Human-readable label shown in Settings \u2192 Credentials", required: false }
+  }
+});
+registerSchema({
+  command: "credentials.delete",
+  description: "Delete a credential the agent created (e.g. a key it rotated out). Credentials the user added can only be removed by the user, in Settings \u2192 Credentials.",
+  args: {
+    name: { type: "positional", description: "Credential name", required: true }
+  }
+});
+async function readPipedValue() {
+  const stdin = process.stdin;
+  if (stdin.isTTY) return "";
+  const chunks = [];
+  for await (const chunk of stdin) {
+    chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+  }
+  return Buffer.concat(chunks).toString("utf8").replace(/\r?\n$/, "");
+}
+function parseName(raw) {
+  const parsed = credentialNameSchema.safeParse(raw);
+  if (!parsed.success) {
+    failValidation(`Invalid credential name "${String(raw)}": use lowercase letters, digits, - and _ (max 64).`);
+  }
+  return parsed.data;
+}
+function parseHosts(rawArgs, parsed) {
+  const hosts = repeatedValues(rawArgs, "host", parsed).flatMap((value) => value.split(",")).map((host) => host.trim()).filter((host) => host !== "");
+  if (hosts.length === 0) {
+    failValidation("Name at least one website the value may be sent to: --host api.example.com (repeatable).");
+  }
+  const result = credentialHostsSchema.safeParse(hosts);
+  if (!result.success) {
+    failValidation(`Invalid --host: ${result.error.issues.map((issue) => issue.message).join("; ")}`);
+  }
+  return result.data;
+}
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "Start here: stored credentials by name with their {{credential:NAME}} placeholder and allowed websites. Never shows values."
+  },
+  args: {
+    full: { type: "boolean", description: "Add source and lastUsedAt", required: false, default: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const response = await apiPost("/api/credentials/list", {});
+      const credentials = response.data.credentials.map(
+        (credential) => args.full ? credential : {
+          name: credential.name,
+          placeholder: credential.placeholder,
+          allowedHosts: credential.allowedHosts,
+          label: credential.label
+        }
+      );
+      writeJson({
+        ok: true,
+        data: { credentials },
+        meta: { count: credentials.length },
+        ...credentials.length === 0 ? {
+          hints: [
+            "No credentials stored. When the task needs one the user owns, call the request_credential tool (label, reason, allowedHosts) \u2014 never ask them to paste it in chat."
+          ]
+        } : {}
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var putCommand = defineCommand({
+  meta: {
+    name: "put",
+    description: `Store a credential you created on the user's behalf; the value is read from stdin only.
+Start here: printf %s "$KEY" | baker credentials put stripe-key --host api.stripe.com
+For a credential the user owns, call request_credential instead.`
+  },
+  args: {
+    name: { type: "positional", description: "Lowercase name: letters, digits, - and _ (max 64)", required: true },
+    host: {
+      type: "string",
+      description: "Website the value may be sent to (repeatable, or comma-separated)",
+      required: false
+    },
+    label: { type: "string", description: "Label shown in Settings \u2192 Credentials", required: false },
+    value: {
+      type: "string",
+      description: "Refused \u2014 never put a value on the command line. Pipe it on stdin.",
+      required: false
+    }
+  },
+  run: async ({ args, rawArgs }) => {
+    if (args.value !== void 0 || args._.length > 1) {
+      failValidation(STDIN_ONLY);
+    }
+    const name = parseName(args.name);
+    const allowedHosts = parseHosts(rawArgs, args.host);
+    const value = await readPipedValue();
+    if (value === "") {
+      failValidation(`Nothing was piped on stdin. ${STDIN_ONLY}`);
+    }
+    if (value.length > MAX_CREDENTIAL_VALUE_LENGTH) {
+      failValidation(`The value is longer than ${MAX_CREDENTIAL_VALUE_LENGTH} characters.`);
+    }
+    const body = { name, value, allowedHosts, ...args.label ? { label: args.label } : {} };
+    try {
+      const response = await apiPost("/api/credentials/put", body);
+      writeJson({
+        ok: true,
+        data: { name: response.data.name, placeholder: response.data.placeholder },
+        hints: [
+          `Use ${response.data.placeholder} in the request; the value is sent only to: ${allowedHosts.join(", ")}.`,
+          "Never echo, print or write the value anywhere \u2014 unset the shell variable that held it."
+        ]
+      });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var deleteCommand = defineCommand({
+  meta: {
+    name: "delete",
+    description: "Delete a credential the agent created. User-added credentials are removed by the user in Settings \u2192 Credentials."
+  },
+  args: {
+    name: { type: "positional", description: "Credential name", required: true }
+  },
+  run: async ({ args }) => {
+    const name = parseName(args.name);
+    try {
+      const response = await apiPost("/api/credentials/delete", { name });
+      writeJson({ ok: true, data: response.data });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+var credentialsCommand = defineCommand({
+  meta: {
+    name: "credentials",
+    description: `Credentials (API keys, tokens, passwords) by name: write {{credential:NAME}} in an HTTPS request and the value is sent only to the websites it is bound to. You never see values.
+Full guide: ${DOC}`
+  },
+  subCommands: { list: listCommand, put: putCommand, delete: deleteCommand }
+});
+export {
+  credentialsCommand
+};
+//# sourceMappingURL=credentials-AYV5YQE4.js.map

package/dist/credentials-AYV5YQE4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../api/src/credentials/contract.ts","../../api/src/credentials/hosts.ts","../../api/src/credentials/placeholder.ts","../src/commands/credentials/index.ts"],"sourcesContent":["/**\n * Contract for `/api/credentials` (`baker credentials`) and the sandbox\n * broker's `/api/runtime/credentials/resolve`. Only the broker route ever\n * carries a value back; every agent-facing shape is metadata.\n */\nimport { z } from \"zod\";\nimport { validateHostPattern } from \"./hosts\";\nimport { CREDENTIAL_NAME_PATTERN } from \"./placeholder\";\n\nexport const MAX_CREDENTIAL_VALUE_LENGTH = 16_384;\nexport const MAX_CREDENTIAL_HOSTS = 20;\n\nexport const credentialNameSchema = z\n  .string()\n  .regex(new RegExp(`^${CREDENTIAL_NAME_PATTERN}$`), \"Use lowercase letters, digits, - and _ (max 64).\");\n\nexport const credentialHostsSchema = z\n  .array(z.string())\n  .max(MAX_CREDENTIAL_HOSTS)\n  .transform((hosts, ctx) => {\n    const patterns: string[] = [];\n    for (const host of hosts) {\n      const result = validateHostPattern(host);\n      if (result.ok) patterns.push(result.pattern);\n      else ctx.addIssue({ code: \"custom\", message: `${host}: ${result.reason}` });\n    }\n    return [...new Set(patterns)];\n  });\n\nexport const credentialSourceSchema = z.enum([\"user\", \"agent\", \"chat-detected\", \"requested\"]);\nexport type CredentialSource = z.infer<typeof credentialSourceSchema>;\n\nexport const credentialSummarySchema = z.object({\n  name: z.string(),\n  label: z.string(),\n  placeholder: z.string(),\n  allowedHosts: z.array(z.string()),\n  source: credentialSourceSchema,\n  lastUsedAt: z.number().nullable(),\n});\nexport type CredentialSummary = z.infer<typeof credentialSummarySchema>;\n\nexport const credentialsListResponseSchema = z.object({ credentials: z.array(credentialSummarySchema) });\nexport type CredentialsListResponse = z.infer<typeof credentialsListResponseSchema>;\n\nexport const credentialsPutRequestSchema = z.object({\n  name: credentialNameSchema,\n  label: z.string().trim().min(1).max(80).optional(),\n  value: z.string().min(1).max(MAX_CREDENTIAL_VALUE_LENGTH),\n  allowedHosts: credentialHostsSchema,\n});\nexport type CredentialsPutRequest = z.input<typeof credentialsPutRequestSchema>;\n\nexport const credentialsPutResponseSchema = z.object({\n  name: z.string(),\n  placeholder: z.string(),\n  replaced: z.boolean(),\n});\nexport type CredentialsPutResponse = z.infer<typeof credentialsPutResponseSchema>;\n\nexport const credentialsDeleteRequestSchema = z.object({ name: credentialNameSchema });\nexport type CredentialsDeleteRequest = z.infer<typeof credentialsDeleteRequestSchema>;\n\nexport const credentialsDeleteResponseSchema = z.object({ name: z.string(), deleted: z.literal(true) });\nexport type CredentialsDeleteResponse = z.infer<typeof credentialsDeleteResponseSchema>;\n\nexport const brokerResolveResponseSchema = z.object({\n  credentials: z.array(z.object({ name: z.string(), value: z.string(), allowedHosts: z.array(z.string()) })),\n});\nexport type BrokerResolveResponse = z.infer<typeof brokerResolveResponseSchema>;\n\nexport const brokerUsageRequestSchema = z.object({\n  uses: z.array(z.object({ name: credentialNameSchema, host: z.string().max(253) })).max(100),\n});\nexport type BrokerUsageRequest = z.infer<typeof brokerUsageRequestSchema>;\n","/**\n * Where a credential may be sent. The sandbox proxy only substitutes a\n * credential into a request whose host one of its patterns allows, so a\n * prompt-injected agent cannot post the value to a host it controls.\n */\nimport { getPublicSuffix, parse } from \"tldts\";\n\nexport type HostPatternResult = { ok: true; pattern: string } | { ok: false; reason: string };\n\nfunction normaliseHost(host: string): string {\n  return host.trim().toLowerCase().replace(/\\.$/, \"\");\n}\n\n/** An international name (`bücher.de`) in the ASCII form a request carries (`xn--bcher-kva.de`); unchanged when it is not a host. */\nfunction asciiHost(host: string): string {\n  // Only a bare name is converted: the URL parser would silently drop a path or a `user@` the person typed.\n  if (!/[\\u0080-\\u{10FFFF}]/u.test(host) || /[/?#@:\\\\%[\\]\\s]/.test(host)) return host;\n  const url = `http://${host}`;\n  return URL.canParse(url) ? new URL(url).hostname : host;\n}\n\nexport function validateHostPattern(raw: string): HostPatternResult {\n  const typed = normaliseHost(raw);\n  const wildcard = typed.startsWith(\"*.\");\n  const host = asciiHost(wildcard ? typed.slice(2) : typed);\n  const pattern = wildcard ? `*.${host}` : host;\n  if (host === \"\" || host.includes(\"*\")) {\n    return { ok: false, reason: \"Use a website address like api.example.com or *.example.com.\" };\n  }\n  const parsed = parse(host);\n  if (parsed.isIp || host.startsWith(\"[\")) {\n    return { ok: false, reason: \"Use a website address, not an IP address.\" };\n  }\n  if (parsed.hostname !== host || parsed.domain === null) {\n    return { ok: false, reason: \"Use only the website address, like api.example.com.\" };\n  }\n  if (wildcard && !wildcardSafe(host)) {\n    return { ok: false, reason: `*.${host} would allow any website. Name the company's own address.` };\n  }\n  return { ok: true, pattern };\n}\n\n/**\n * Cloud hosts where anyone can own a subdomain and read the headers it is\n * sent, which the Public Suffix List does not list as a suffix: API Gateway\n * and Lambda URLs under amazonaws.com, and a Cloud Storage bucket at\n * `<bucket>.storage.googleapis.com`, and AWS's newer `on.aws`, whose Lambda\n * URLs sit two labels below it where the check below does not look.\n */\nconst OPEN_HOSTING_DOMAINS = [\"amazonaws.com\", \"cloudfront.net\", \"googleapis.com\", \"on.aws\"];\n\nconst WITH_PRIVATE = { allowPrivateDomains: true };\n\n/**\n * Whether `*.host` names one owner's sites. A public suffix (ICANN `com`, or\n * a private one such as `vercel.app`) is shared by everyone who can sign up,\n * and so is a base with one just below it (`run.app`, whose Cloud Run services\n * live under `a.run.app`).\n */\nfunction wildcardSafe(host: string): boolean {\n  if (OPEN_HOSTING_DOMAINS.some((domain) => host === domain || host.endsWith(`.${domain}`))) return false;\n  const suffix = getPublicSuffix(host, WITH_PRIVATE);\n  return suffix !== host && getPublicSuffix(`zz.${host}`, WITH_PRIVATE) === suffix;\n}\n\nexport function hostAllowed(host: string, patterns: readonly string[]): boolean {\n  const target = normaliseHost(host);\n  return patterns.some((raw) => {\n    const pattern = normaliseHost(raw);\n    return pattern.startsWith(\"*.\") ? target.endsWith(pattern.slice(1)) : target === pattern;\n  });\n}\n","/**\n * The one grammar an agent, a chat message and the sandbox proxy share for\n * \"the stored credential called NAME\": `{{credential:NAME}}`. The value never\n * appears in text; the proxy swaps the placeholder in on the way out.\n */\n\nexport const CREDENTIAL_NAME_PATTERN = \"[a-z0-9][a-z0-9_-]{0,63}\";\nconst CREDENTIAL_NAME_RE = new RegExp(`^${CREDENTIAL_NAME_PATTERN}$`);\nconst PLACEHOLDER_SOURCE = `\\\\{\\\\{credential:(${CREDENTIAL_NAME_PATTERN})\\\\}\\\\}`;\n\nexport type CredentialPlaceholder = { name: string; start: number; end: number };\n\nexport function isCredentialName(name: string): boolean {\n  return CREDENTIAL_NAME_RE.test(name);\n}\n\nexport function renderPlaceholder(name: string): string {\n  return `{{credential:${name}}}`;\n}\n\nexport function parsePlaceholders(text: string): CredentialPlaceholder[] {\n  return [...text.matchAll(new RegExp(PLACEHOLDER_SOURCE, \"g\"))].map((match) => ({\n    name: match[1] ?? \"\",\n    start: match.index,\n    end: match.index + match[0].length,\n  }));\n}\n\nconst WHOLE_PLACEHOLDER_RE = new RegExp(`^${PLACEHOLDER_SOURCE}$`);\n\n/** The credential a value stands for when the whole value is one placeholder, as a tag's secret field holds it. */\nexport function credentialNamedBy(value: string): string | null {\n  return WHOLE_PLACEHOLDER_RE.exec(value.trim())?.[1] ?? null;\n}\n\n/** A readable label (\"Meta access token\") as a placeholder name (\"meta-access-token\"). */\nexport function slugifyCredentialName(label: string): string {\n  const slug = label\n    .normalize(\"NFKD\")\n    .replace(/[̀-ͯ]/g, \"\")\n    .toLowerCase()\n    .replace(/[^a-z0-9_-]+/g, \"-\")\n    .replace(/-{2,}/g, \"-\")\n    .replace(/^[-_]+|[-_]+$/g, \"\")\n    .slice(0, 64)\n    .replace(/[-_]+$/g, \"\");\n  return slug === \"\" ? \"credential\" : slug;\n}\n","import type {\n  CredentialsDeleteResponse,\n  CredentialsListResponse,\n  CredentialsPutRequest,\n  CredentialsPutResponse,\n} from \"@baker/api/credentials\";\nimport { credentialHostsSchema, credentialNameSchema, MAX_CREDENTIAL_VALUE_LENGTH } from \"@baker/api/credentials\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../client.ts\";\nimport { repeatedValues } from \"../../lib/repeatedFlags.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { failApi, failValidation } from \"../actions/shared.ts\";\n\n/** The backend's success envelope around a contract response. */\ntype Ok<T> = { ok: true; data: T };\n\nconst DOC = \"__tooling__/docs/tools/baker/credentials.md\";\n\nconst STDIN_ONLY =\n  'The value is read from stdin only, never from the command line (argv is visible to other processes and lands in logs). Pipe it: printf %s \"$VALUE\" | baker credentials put <name> --host <host>. For a credential the user owns, call request_credential instead.';\n\nregisterSchema({\n  command: \"credentials.list\",\n  description:\n    \"Start here: the credentials (API keys, tokens, passwords) this company stored, by name — never their values. Write the `placeholder` ({{credential:NAME}}) into an HTTPS request (curl header, URL, SDK config, JSON body) and the sandbox proxy sends the real value, only to the credential's allowedHosts. Nothing listed? Ask the user with the request_credential tool. Compact by default; --full adds source and lastUsedAt.\",\n  args: {\n    full: { type: \"boolean\", description: \"Add source and lastUsedAt per credential\", required: false, default: false },\n  },\n});\n\nregisterSchema({\n  command: \"credentials.put\",\n  description:\n    'Store a credential YOU created on the user\\'s behalf (e.g. a key you just generated through an API), so later requests can use {{credential:NAME}}. Example: printf %s \"$KEY\" | baker credentials put stripe-key --host api.stripe.com --label \"Stripe key\". The value comes from stdin ONLY. For a credential the user owns, call request_credential instead — never ask for it in chat. Replacing is allowed only for credentials the agent created.',\n  args: {\n    name: { type: \"positional\", description: \"Lowercase name: letters, digits, - and _ (max 64)\", required: true },\n    host: {\n      type: \"string\",\n      description:\n        \"Website the value may be sent to (repeatable, or comma-separated): api.stripe.com, acme-store.myshopify.com\",\n      required: true,\n    },\n    label: { type: \"string\", description: \"Human-readable label shown in Settings → Credentials\", required: false },\n  },\n});\n\nregisterSchema({\n  command: \"credentials.delete\",\n  description:\n    \"Delete a credential the agent created (e.g. a key it rotated out). Credentials the user added can only be removed by the user, in Settings → Credentials.\",\n  args: {\n    name: { type: \"positional\", description: \"Credential name\", required: true },\n  },\n});\n\n/** Everything piped on stdin, with one trailing newline trimmed (what `echo` adds). */\nasync function readPipedValue(): Promise<string> {\n  const stdin = process.stdin;\n  if (stdin.isTTY) return \"\";\n  const chunks: Buffer[] = [];\n  for await (const chunk of stdin) {\n    chunks.push(typeof chunk === \"string\" ? Buffer.from(chunk) : chunk);\n  }\n  return Buffer.concat(chunks)\n    .toString(\"utf8\")\n    .replace(/\\r?\\n$/, \"\");\n}\n\nfunction parseName(raw: unknown): string {\n  const parsed = credentialNameSchema.safeParse(raw);\n  if (!parsed.success) {\n    failValidation(`Invalid credential name \"${String(raw)}\": use lowercase letters, digits, - and _ (max 64).`);\n  }\n  return parsed.data;\n}\n\nfunction parseHosts(rawArgs: readonly string[], parsed: unknown): string[] {\n  const hosts = repeatedValues(rawArgs, \"host\", parsed)\n    .flatMap((value) => value.split(\",\"))\n    .map((host) => host.trim())\n    .filter((host) => host !== \"\");\n  if (hosts.length === 0) {\n    failValidation(\"Name at least one website the value may be sent to: --host api.example.com (repeatable).\");\n  }\n  const result = credentialHostsSchema.safeParse(hosts);\n  if (!result.success) {\n    failValidation(`Invalid --host: ${result.error.issues.map((issue) => issue.message).join(\"; \")}`);\n  }\n  return result.data;\n}\n\nconst listCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description:\n      \"Start here: stored credentials by name with their {{credential:NAME}} placeholder and allowed websites. Never shows values.\",\n  },\n  args: {\n    full: { type: \"boolean\", description: \"Add source and lastUsedAt\", required: false, default: false },\n  },\n  run: async ({ args }) => {\n    try {\n      const response = await apiPost<Ok<CredentialsListResponse>>(\"/api/credentials/list\", {});\n      const credentials = response.data.credentials.map((credential) =>\n        args.full\n          ? credential\n          : {\n              name: credential.name,\n              placeholder: credential.placeholder,\n              allowedHosts: credential.allowedHosts,\n              label: credential.label,\n            },\n      );\n      writeJson({\n        ok: true,\n        data: { credentials },\n        meta: { count: credentials.length },\n        ...(credentials.length === 0\n          ? {\n              hints: [\n                \"No credentials stored. When the task needs one the user owns, call the request_credential tool (label, reason, allowedHosts) — never ask them to paste it in chat.\",\n              ],\n            }\n          : {}),\n      });\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n\nconst putCommand = defineCommand({\n  meta: {\n    name: \"put\",\n    description: `Store a credential you created on the user's behalf; the value is read from stdin only.\nStart here: printf %s \"$KEY\" | baker credentials put stripe-key --host api.stripe.com\nFor a credential the user owns, call request_credential instead.`,\n  },\n  args: {\n    name: { type: \"positional\", description: \"Lowercase name: letters, digits, - and _ (max 64)\", required: true },\n    host: {\n      type: \"string\",\n      description: \"Website the value may be sent to (repeatable, or comma-separated)\",\n      required: false,\n    },\n    label: { type: \"string\", description: \"Label shown in Settings → Credentials\", required: false },\n    value: {\n      type: \"string\",\n      description: \"Refused — never put a value on the command line. Pipe it on stdin.\",\n      required: false,\n    },\n  },\n  run: async ({ args, rawArgs }) => {\n    if (args.value !== undefined || args._.length > 1) {\n      failValidation(STDIN_ONLY);\n    }\n    const name = parseName(args.name);\n    const allowedHosts = parseHosts(rawArgs, args.host);\n    const value = await readPipedValue();\n    if (value === \"\") {\n      failValidation(`Nothing was piped on stdin. ${STDIN_ONLY}`);\n    }\n    if (value.length > MAX_CREDENTIAL_VALUE_LENGTH) {\n      failValidation(`The value is longer than ${MAX_CREDENTIAL_VALUE_LENGTH} characters.`);\n    }\n    const body: CredentialsPutRequest = { name, value, allowedHosts, ...(args.label ? { label: args.label } : {}) };\n    try {\n      const response = await apiPost<Ok<CredentialsPutResponse>>(\"/api/credentials/put\", body);\n      writeJson({\n        ok: true,\n        data: { name: response.data.name, placeholder: response.data.placeholder },\n        hints: [\n          `Use ${response.data.placeholder} in the request; the value is sent only to: ${allowedHosts.join(\", \")}.`,\n          \"Never echo, print or write the value anywhere — unset the shell variable that held it.\",\n        ],\n      });\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n\nconst deleteCommand = defineCommand({\n  meta: {\n    name: \"delete\",\n    description:\n      \"Delete a credential the agent created. User-added credentials are removed by the user in Settings → Credentials.\",\n  },\n  args: {\n    name: { type: \"positional\", description: \"Credential name\", required: true },\n  },\n  run: async ({ args }) => {\n    const name = parseName(args.name);\n    try {\n      const response = await apiPost<Ok<CredentialsDeleteResponse>>(\"/api/credentials/delete\", { name });\n      writeJson({ ok: true, data: response.data });\n    } catch (err) {\n      failApi(err);\n    }\n  },\n});\n\nexport const credentialsCommand = defineCommand({\n  meta: {\n    name: \"credentials\",\n    description: `Credentials (API keys, tokens, passwords) by name: write {{credential:NAME}} in an HTTPS request and the value is sent only to the websites it is bound to. You never see values.\nFull guide: ${DOC}`,\n  },\n  subCommands: { list: listCommand, put: putCommand, delete: deleteCommand },\n});\n"],"mappings":"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","names":[]}