@shipeasy/openapi 1.6.0 → 2.1.0

package/dist/operations/ops.js

@@ -1,313 +0,0 @@
-// src/transport.ts
-var ApiError = class extends Error {
-  constructor(message, status) {
-    super(message);
-    this.status = status;
-    this.name = "ApiError";
-  }
-  status;
-};
-
-// src/operations/util.ts
-var num = (i, k) => i[k] === void 0 ? void 0 : i[k];
-var str = (i, k) => i[k] === void 0 ? void 0 : i[k];
-
-// src/operations/ops.ts
-var QUEUE = ["ops"];
-var ALERTS = ["ops", "alerts"];
-var TYPES = ["bug", "feature_request", "error", "alert"];
-var STATUSES = [
-  "open",
-  "triaged",
-  "in_progress",
-  "ready_for_qa",
-  "resolved",
-  "wont_fix"
-];
-var PRIORITIES = ["nice_to_have", "medium", "high", "critical"];
-var COMPARATORS = ["gt", "gte", "lt", "lte"];
-var SEVERITIES = ["danger", "warn", "info"];
-async function resolveSlackChannel(client, idOrName) {
-  const res = await client.ops.channels();
-  if (!res.connected)
-    throw new ApiError("No Slack connector \u2014 connect Slack in Settings \u2192 Notifications first.", 400);
-  const stripped = idOrName.replace(/^#/, "");
-  const byId = res.channels.find((c) => c.id === idOrName);
-  if (byId) return { id: byId.id, name: byId.name };
-  const byName = res.channels.filter((c) => c.name === stripped);
-  if (byName.length === 1) return { id: byName[0].id, name: byName[0].name };
-  if (byName.length > 1)
-    throw new ApiError(`Slack channel name '${stripped}' is ambiguous \u2014 pass a channel id`, 400);
-  throw new ApiError(`Slack channel '${idOrName}' not found (run 'ops alerts channels')`, 404);
-}
-var opsOperations = [
-  // ── unified queue ──────────────────────────────────────────────────────────
-  {
-    group: QUEUE,
-    name: "list",
-    mutates: false,
-    summary: "List the operational queue",
-    description: "List the unified queue \u2014 bugs, feature requests, and auto-filed error/alert tickets. Filter by `type`, `status`, or `priority`.",
-    params: [
-      { name: "type", type: "string", description: "Filter by type.", enum: [...TYPES, "all"] },
-      { name: "status", type: "string", description: "Filter by status.", enum: [...STATUSES, "all"] },
-      { name: "priority", type: "string", description: "Filter by priority.", enum: PRIORITIES },
-      { name: "limit", type: "number", description: "Max rows (default 200)." }
-    ],
-    examples: [
-      { note: "Open critical items only", run: "shipeasy ops list --priority critical" },
-      { note: "Just error tickets", run: "shipeasy ops list --type error" }
-    ],
-    run: async (client, i) => {
-      let items = await client.ops.list({
-        type: str(i, "type") ?? "all",
-        status: str(i, "status") ?? "open",
-        limit: num(i, "limit") ?? 200
-      });
-      const priority = str(i, "priority");
-      if (priority) items = items.filter((x) => x.priority === priority);
-      return items;
-    }
-  },
-  {
-    group: QUEUE,
-    name: "get",
-    mutates: false,
-    summary: "Show one queue item",
-    description: "Show one queue item by number (#7 \u2192 7) or id \u2014 any type.",
-    params: [{ name: "handle", type: "string", description: "Item number or id.", required: true, positional: true }],
-    examples: [{ note: "By queue number", run: "shipeasy ops get 7" }],
-    run: (client, i) => client.ops.get(i.handle)
-  },
-  {
-    group: QUEUE,
-    name: "create",
-    mutates: true,
-    summary: "File a bug or feature request",
-    description: "File an operational item \u2014 a bug report or feature request \u2014 against the bound project. Fires the project's connectors (GitHub issue, Slack). error/alert tickets are auto-filed and cannot be created here.",
-    params: [
-      { name: "type", type: "string", description: "Item type.", required: true, enum: ["bug", "feature_request"] },
-      { name: "title", type: "string", description: "One-line title.", required: true, positional: true },
-      { name: "body", type: "string", description: "Detailed description." },
-      { name: "priority", type: "string", description: "Priority.", enum: PRIORITIES },
-      { name: "stepsToReproduce", type: "string", description: "Repro steps (bugs)." },
-      { name: "pageUrl", type: "string", description: "Page URL the item relates to." }
-    ],
-    examples: [
-      { note: "File a bug", run: 'shipeasy ops create "Checkout 500s on Safari" --type bug' },
-      { note: "File a feature request", run: 'shipeasy ops create "Dark mode" --type feature_request --priority medium' }
-    ],
-    run: (client, i) => client.ops.create({
-      type: i.type,
-      title: i.title,
-      ...i.body ? { body: i.body } : {},
-      ...i.priority ? { priority: i.priority } : {},
-      ...i.stepsToReproduce ? { stepsToReproduce: i.stepsToReproduce } : {},
-      ...i.pageUrl ? { pageUrl: i.pageUrl } : {}
-    })
-  },
-  {
-    group: QUEUE,
-    name: "update",
-    mutates: true,
-    summary: "Update a queue item's status/priority",
-    description: "Flip a queue item's status (any type) and optionally its priority.",
-    params: [
-      { name: "handle", type: "string", description: "Item number or id.", required: true, positional: true },
-      { name: "status", type: "string", description: "New status.", enum: STATUSES },
-      { name: "priority", type: "string", description: "New priority.", enum: PRIORITIES }
-    ],
-    examples: [
-      { note: "Resolve item #7", run: "shipeasy ops update 7 --status resolved" },
-      { note: "Bump priority", run: "shipeasy ops update 7 --priority high" }
-    ],
-    run: (client, i) => {
-      const patch = {};
-      if (i.status !== void 0) patch.status = i.status;
-      if (i.priority !== void 0) patch.priority = i.priority;
-      if (!Object.keys(patch).length)
-        throw new ApiError("Nothing to update \u2014 pass status and/or priority.", 400);
-      return client.ops.update(i.handle, patch);
-    }
-  },
-  {
-    group: QUEUE,
-    name: "link-pr",
-    mutates: true,
-    summary: "Link the PR that fixed an item",
-    description: "Link the PR that fixed a queue item (any type). Records connector_data.github.pr. Pass `remove` to unlink.",
-    params: [
-      { name: "handle", type: "string", description: "Item number or id.", required: true, positional: true },
-      { name: "prNumber", type: "number", description: "PR number.", positional: true },
-      { name: "url", type: "string", description: "Explicit PR URL (required for error/alert tickets)." },
-      { name: "remove", type: "boolean", description: "Unlink the PR instead of setting one." }
-    ],
-    examples: [
-      { note: "Link the fixing PR", run: "shipeasy ops link-pr 7 42 --url https://github.com/acme/app/pull/42" }
-    ],
-    run: (client, i) => {
-      if (i.remove) return client.ops.linkPr(i.handle, { prNumber: null });
-      const prNumber = num(i, "prNumber");
-      if (prNumber === void 0 || !Number.isInteger(prNumber) || prNumber <= 0)
-        throw new ApiError("Pass a positive PR number (or --remove to unlink).", 400);
-      return client.ops.linkPr(i.handle, {
-        prNumber,
-        ...i.url ? { prUrl: i.url } : {}
-      });
-    }
-  },
-  {
-    group: QUEUE,
-    name: "notify",
-    mutates: true,
-    summary: "Raise a 'needs your attention' bell notification",
-    description: "Raise an attention bell notification (agent escalation, create-only). Idempotent on the dedupe key \u2014 pass `item` to derive `feedback:<n>`, or an explicit `key`.",
-    params: [
-      { name: "title", type: "string", description: "One-line headline of what's blocked.", required: true },
-      { name: "summary", type: "string", description: "One sentence: why it can't be fixed in code.", required: true },
-      { name: "steps", type: "json", description: "Steps the human should take, as a JSON array of strings." },
-      { name: "href", type: "string", description: "Dashboard-relative deep link." },
-      { name: "item", type: "string", description: "Queue item number this is about (sets dedupe key feedback:<n>)." },
-      { name: "key", type: "string", description: "Explicit dedupe key (overrides item)." }
-    ],
-    examples: [
-      { note: "Escalate a blocked item", run: `shipeasy ops notify --item 7 --title "Needs a DB migration" --summary "Fix requires a schema change I can't apply in code"` }
-    ],
-    run: (client, i) => {
-      const item = str(i, "item");
-      const dedupeKey = str(i, "key") ?? (item ? `feedback:${item.replace(/^#/, "")}` : void 0);
-      return client.ops.notify({
-        title: i.title,
-        summary: i.summary,
-        steps: i.steps ?? [],
-        ...i.href ? { href: i.href } : {},
-        ...dedupeKey ? { dedupeKey } : {}
-      });
-    }
-  },
-  // ── alert rules (ops alerts …) ───────────────────────────────────────────────
-  {
-    group: ALERTS,
-    name: "list",
-    mutates: false,
-    summary: "List alert rules",
-    description: "List the project's metric-threshold alert rules the analysis cron evaluates.",
-    params: [],
-    examples: [{ run: "shipeasy ops alerts list" }],
-    run: (client) => client.alertRules.list()
-  },
-  {
-    group: ALERTS,
-    name: "channels",
-    mutates: false,
-    summary: "List the project's Slack channels",
-    description: "List the project's Slack channels (for the `slackChannel` alert target).",
-    params: [],
-    examples: [{ run: "shipeasy ops alerts channels" }],
-    run: (client) => client.ops.channels()
-  },
-  {
-    group: ALERTS,
-    name: "create",
-    mutates: true,
-    summary: "Create an alert rule",
-    description: "Create a metric-threshold alert rule. The metric (and its aggregation) is fixed for the rule's life \u2014 delete + recreate to repoint it. Optionally target a Slack channel/email.",
-    params: [
-      { name: "name", type: "string", description: "Rule name.", required: true, positional: true },
-      { name: "metric", type: "string", description: "Metric to evaluate (id or name).", required: true },
-      { name: "comparator", type: "string", description: "Comparison operator.", required: true, enum: COMPARATORS },
-      { name: "threshold", type: "number", description: "Threshold the metric value is compared against.", required: true },
-      { name: "window", type: "number", description: "Lookback window in whole hours (1\u2013720). Defaults to 24." },
-      { name: "severity", type: "string", description: "Severity. Defaults to warn.", enum: SEVERITIES },
-      { name: "disabled", type: "boolean", description: "Create the rule disabled." },
-      { name: "slackChannel", type: "string", description: "Slack channel to post to (id or name)." },
-      { name: "email", type: "string", description: "Email address to notify." }
-    ],
-    examples: [
-      { note: "Alert when error rate exceeds 50 / 24h", run: "shipeasy ops alerts create high-error-rate --metric api-errors --comparator gt --threshold 50" },
-      { note: "Post to a Slack channel + email on-call", run: "shipeasy ops alerts create high-error-rate --metric api-errors --comparator gt --threshold 50 --slack-channel '#incidents' --email oncall@acme.com" }
-    ],
-    run: async (client, i) => {
-      const metric = await client.metrics.resolve(i.metric);
-      const slackChannel = str(i, "slackChannel");
-      const email = str(i, "email");
-      const notify = slackChannel || email ? {
-        slackChannel: slackChannel ? await resolveSlackChannel(client, slackChannel) : null,
-        email: email ?? null
-      } : void 0;
-      return client.alertRules.create({
-        name: i.name,
-        metricId: metric.id,
-        comparator: i.comparator,
-        threshold: num(i, "threshold"),
-        windowHours: num(i, "window") ?? 24,
-        severity: str(i, "severity") ?? "warn",
-        enabled: !i.disabled,
-        ...notify ? { notify } : {}
-      });
-    }
-  },
-  {
-    group: ALERTS,
-    name: "update",
-    mutates: true,
-    summary: "Update an alert rule",
-    description: "Update an alert rule's tunable knobs (by id, id-prefix, or unique name). The metric is immutable. Pass `clearTarget` to revert the rule's target to the project default.",
-    params: [
-      { name: "rule", type: "string", description: "Rule id, id-prefix, or name.", required: true, positional: true },
-      { name: "name", type: "string", description: "New human label." },
-      { name: "comparator", type: "string", description: "Comparison operator.", enum: COMPARATORS },
-      { name: "threshold", type: "number", description: "New threshold." },
-      { name: "window", type: "number", description: "New lookback window in whole hours (1\u2013720)." },
-      { name: "severity", type: "string", description: "New severity.", enum: SEVERITIES },
-      { name: "enabled", type: "boolean", description: "Enable/disable the rule." },
-      { name: "slackChannel", type: "string", description: "Set the Slack channel target (id or name)." },
-      { name: "email", type: "string", description: "Set the email target." },
-      { name: "clearTarget", type: "boolean", description: "Clear the target back to the project default." }
-    ],
-    examples: [
-      { note: "Raise the threshold", run: "shipeasy ops alerts update high-error-rate --threshold 100" },
-      { note: "Disable a rule", run: "shipeasy ops alerts update high-error-rate --enabled false" }
-    ],
-    run: async (client, i) => {
-      const rule = await client.alertRules.resolve(i.rule);
-      const patch = {};
-      if (i.name !== void 0) patch.name = i.name;
-      if (i.comparator !== void 0) patch.comparator = i.comparator;
-      if (i.threshold !== void 0) patch.threshold = num(i, "threshold");
-      if (i.window !== void 0) patch.windowHours = num(i, "window");
-      if (i.severity !== void 0) patch.severity = i.severity;
-      if (i.enabled !== void 0) patch.enabled = i.enabled;
-      const slackChannel = str(i, "slackChannel");
-      const email = str(i, "email");
-      if (i.clearTarget) {
-        patch.notify = { slackChannel: null, email: null };
-      } else if (slackChannel || email) {
-        patch.notify = {
-          slackChannel: slackChannel ? await resolveSlackChannel(client, slackChannel) : rule.notify?.slackChannel ?? null,
-          email: email ?? rule.notify?.email ?? null
-        };
-      }
-      if (!Object.keys(patch).length)
-        throw new ApiError("Nothing to update \u2014 pass at least one field to change.", 400);
-      return client.alertRules.update(rule.id, patch);
-    }
-  },
-  {
-    group: ALERTS,
-    name: "archive",
-    mutates: true,
-    summary: "Archive an alert rule",
-    description: "Archive (delete) an alert rule by id, id-prefix, or unique name.",
-    params: [{ name: "rule", type: "string", description: "Rule id, id-prefix, or name.", required: true, positional: true }],
-    examples: [{ run: "shipeasy ops alerts archive high-error-rate" }],
-    run: async (client, i) => {
-      const rule = await client.alertRules.resolve(i.rule);
-      await client.alertRules.delete(rule.id);
-      return { ok: true, archived: rule.name };
-    }
-  }
-];
-export {
-  opsOperations
-};

package/dist/operations/projects.d.ts

@@ -1,28 +0,0 @@
-import { Operation } from './types.js';
-import '../resources/index.js';
-import 'zod/v4/core';
-import 'zod';
-import '../resources/attributes.js';
-import '../transport.js';
-import '../resources/i18n.js';
-import '../resources/projects.js';
-import '../resources/ops.js';
-import '../resources/events.js';
-import '../resources/metrics.js';
-import '../resources/alert-rules.js';
-import '../schemas/alert-rules.js';
-import '../resources/killswitches.js';
-import '../schemas/killswitches.js';
-import '../schemas/pagination.js';
-import '../resources/universes.js';
-import '../schemas/universes.js';
-import '../resources/configs.js';
-import '../schemas/configs.js';
-import '../resources/experiments.js';
-import '../schemas/experiments.js';
-import '../resources/gates.js';
-import '../schemas/gates.js';
-
-declare const projectOperations: Operation[];
-
-export { projectOperations };

package/dist/operations/projects.js

@@ -1,36 +0,0 @@
-// src/operations/projects.ts
-var GROUP = ["projects"];
-var projectOperations = [
-  {
-    group: GROUP,
-    name: "current",
-    mutates: false,
-    summary: "Show the current project",
-    description: "Return the project the session resolves to (plan, status, enabled modules, billing). The server reads the project from the auth header \u2014 no id needed. Powers `whoami`.",
-    params: [],
-    examples: [{ run: "shipeasy projects current" }],
-    run: (client) => client.projects.current()
-  },
-  {
-    group: GROUP,
-    name: "upsert",
-    mutates: false,
-    summary: "Find-or-create a project by domain",
-    description: "Find-or-create a project by domain (idempotent), under the session's owner. Returns the project. The `.shipeasy` bind that records the result locally is a consumer side-effect layered on top of this op \u2014 it is not performed here.",
-    params: [
-      { name: "domain", type: "string", description: "Hostname-like project identifier (e.g. acme.com).", required: true },
-      { name: "name", type: "string", description: "Human-readable name (defaults to the domain on first create)." }
-    ],
-    examples: [
-      { note: "Find-or-create by domain", run: "shipeasy projects upsert --domain acme.com" },
-      { note: "Name it explicitly", run: 'shipeasy projects upsert --domain shouks.app --name "Shouks"' }
-    ],
-    run: (client, i) => client.projects.upsert({
-      domain: i.domain,
-      ...i.name ? { name: i.name } : {}
-    })
-  }
-];
-export {
-  projectOperations
-};

package/dist/operations/sdk-docs.d.ts

@@ -1,28 +0,0 @@
-import { Operation } from './types.js';
-import '../resources/index.js';
-import 'zod/v4/core';
-import 'zod';
-import '../resources/attributes.js';
-import '../transport.js';
-import '../resources/i18n.js';
-import '../resources/projects.js';
-import '../resources/ops.js';
-import '../resources/events.js';
-import '../resources/metrics.js';
-import '../resources/alert-rules.js';
-import '../schemas/alert-rules.js';
-import '../resources/killswitches.js';
-import '../schemas/killswitches.js';
-import '../schemas/pagination.js';
-import '../resources/universes.js';
-import '../schemas/universes.js';
-import '../resources/configs.js';
-import '../schemas/configs.js';
-import '../resources/experiments.js';
-import '../schemas/experiments.js';
-import '../resources/gates.js';
-import '../schemas/gates.js';
-
-declare const docsOperations: Operation[];
-
-export { docsOperations };

package/dist/operations/sdk-docs.js

@@ -1,160 +0,0 @@
-// src/transport.ts
-var ApiError = class extends Error {
-  constructor(message, status) {
-    super(message);
-    this.status = status;
-    this.name = "ApiError";
-  }
-  status;
-};
-
-// src/operations/util.ts
-var str = (i, k) => i[k] === void 0 ? void 0 : i[k];
-
-// src/operations/sdk-docs.ts
-var SDK_REPOS = {
-  typescript: { owner: "shipeasy-ai", repo: "sdk" },
-  javascript: { owner: "shipeasy-ai", repo: "sdk" },
-  node: { owner: "shipeasy-ai", repo: "sdk" },
-  ts: { owner: "shipeasy-ai", repo: "sdk" },
-  python: { owner: "shipeasy-ai", repo: "sdk-python" },
-  go: { owner: "shipeasy-ai", repo: "sdk-go" },
-  java: { owner: "shipeasy-ai", repo: "sdk-java" },
-  kotlin: { owner: "shipeasy-ai", repo: "sdk-kotlin" },
-  php: { owner: "shipeasy-ai", repo: "sdk-php" },
-  swift: { owner: "shipeasy-ai", repo: "sdk-swift" },
-  ruby: { owner: "shipeasy-ai", repo: "sdk-ruby" }
-};
-var SDK_ENUM = Object.keys(SDK_REPOS);
-var DEFAULT_MANIFEST = {
-  schemaVersion: 2,
-  sdk: "default",
-  placeholders: ["RESOURCE_NAME"],
-  skill: "skill/SKILL.md",
-  pages: { overview: "pages/overview.md", installation: "pages/installation.md" },
-  snippets: { release: { flags: "snippets/release/flags.md" } }
-};
-var DEFAULT_CONTENT = {
-  "pages/overview.md": "# Shipeasy SDK\n\nThis SDK has not published its `/docs/` folder yet. See https://docs.shipeasy.ai for the full reference.",
-  "pages/installation.md": "# Installation\n\nInstall the Shipeasy SDK for your language, then call `shipeasy({ serverKey })` (server) or `shipeasy({ clientKey })` (browser).",
-  "snippets/release/flags.md": "```\nconst on = await client.checkGate(user, '{{RESOURCE_NAME}}');\n```",
-  "skill/SKILL.md": "---\nname: shipeasy-sdk\ndescription: Use the Shipeasy SDK for flags, experiments, configs, and i18n.\n---\n\nThis SDK has not published a skill yet. See https://docs.shipeasy.ai."
-};
-function repoFor(sdk) {
-  const r = SDK_REPOS[sdk.toLowerCase()];
-  if (!r) throw new ApiError(`Unknown SDK '${sdk}'. One of: ${SDK_ENUM.join(", ")}`, 400);
-  return r;
-}
-function pagesBase(sdk) {
-  const { owner, repo } = repoFor(sdk);
-  return `https://${owner}.github.io/${repo}`;
-}
-async function fetchText(url) {
-  const res = await fetch(url);
-  if (!res.ok) return null;
-  return res.text();
-}
-async function loadManifest(sdk) {
-  const text = await fetchText(`${pagesBase(sdk)}/manifest.json`);
-  if (!text) return { manifest: DEFAULT_MANIFEST, fallback: true };
-  try {
-    return { manifest: JSON.parse(text), fallback: false };
-  } catch {
-    return { manifest: DEFAULT_MANIFEST, fallback: true };
-  }
-}
-function resolvePath(manifest, handle) {
-  if (handle.endsWith(".md")) return handle;
-  if (manifest.pages?.[handle]) return manifest.pages[handle];
-  if (handle.includes("/")) {
-    const [group, resource] = handle.split("/", 2);
-    const p = manifest.snippets?.[group]?.[resource];
-    if (p) return p;
-  }
-  throw new ApiError(
-    `Doc '${handle}' not found. Run 'docs list --sdk <lang>' to see available pages and snippets.`,
-    404
-  );
-}
-function substitute(body, manifest, i) {
-  let out = body;
-  for (const ph of manifest.placeholders ?? []) {
-    const value = str(i, ph) ?? (ph === "RESOURCE_NAME" ? str(i, "name") : void 0) ?? (ph === "FRAMEWORK" ? str(i, "framework") : void 0);
-    if (value !== void 0) out = out.replaceAll(`{{${ph}}}`, value);
-  }
-  return out;
-}
-var docsOperations = [
-  {
-    group: ["docs"],
-    name: "list",
-    mutates: false,
-    summary: "List an SDK's documentation tree",
-    description: "Fetch an SDK's `/docs/manifest.json` and return the doc tree \u2014 the feature-reference pages, the nested snippet groups, and whether an installable skill exists. The runtime 'explore' step before fetching a specific page or snippet.",
-    params: [{ name: "sdk", type: "string", description: "SDK language.", required: true, enum: SDK_ENUM }],
-    examples: [{ run: "shipeasy docs list --sdk python" }],
-    run: async (_client, i) => {
-      const { manifest, fallback } = await loadManifest(i.sdk);
-      return {
-        sdk: i.sdk,
-        fallback,
-        pages: Object.keys(manifest.pages ?? {}),
-        snippets: Object.fromEntries(
-          Object.entries(manifest.snippets ?? {}).map(([g, r]) => [g, Object.keys(r)])
-        ),
-        skill: Boolean(manifest.skill)
-      };
-    }
-  },
-  {
-    group: ["docs"],
-    name: "get",
-    mutates: false,
-    summary: "Fetch one SDK doc page or snippet",
-    description: "Fetch one feature-reference page (`flags`, `experiments`, \u2026) or nested snippet (`release/experiments`, `i18n/setup`, \u2026) from the SDK's published docs, substituting declared {{placeholders}} from caller args. Replaces the old `get_sdk_snippet`.",
-    params: [
-      { name: "sdk", type: "string", description: "SDK language.", required: true, enum: SDK_ENUM },
-      { name: "path", type: "string", description: "Page key or snippet 'group/resource'.", required: true, positional: true },
-      { name: "framework", type: "string", description: "Framework hint (substitutes {{FRAMEWORK}})." },
-      { name: "name", type: "string", description: "Resource name (substitutes {{RESOURCE_NAME}})." }
-    ],
-    examples: [
-      { note: "A feature page", run: "shipeasy docs get --sdk python experiments" },
-      { note: "A nested snippet, with a resource name", run: "shipeasy docs get --sdk typescript release/flags --name checkout_v2" }
-    ],
-    run: async (_client, i) => {
-      const sdk = i.sdk;
-      const { manifest, fallback } = await loadManifest(sdk);
-      const path = resolvePath(manifest, i.path);
-      const body = fallback ? DEFAULT_CONTENT[path] : await fetchText(`${pagesBase(sdk)}/${path}`) ?? void 0;
-      if (body === void 0) throw new ApiError(`Doc '${path}' could not be fetched for '${sdk}'.`, 404);
-      return { sdk, path, fallback, content: substitute(body, manifest, i) };
-    }
-  },
-  {
-    group: ["docs"],
-    name: "skill",
-    mutates: false,
-    summary: "Fetch an SDK's installable LLM skill",
-    description: "Fetch the SDK's `skill/SKILL.md` (YAML frontmatter intact) so an agent can install it verbatim into its skills directory. The CLI's `--install` writes it locally (a consumer fs side-effect layered on the fetch); the op itself just returns the bytes.",
-    params: [
-      { name: "sdk", type: "string", description: "SDK language.", required: true, enum: SDK_ENUM },
-      { name: "install", type: "boolean", description: "CLI only: write the skill to the local agent skills dir." }
-    ],
-    examples: [
-      { run: "shipeasy docs skill --sdk python" },
-      { note: "Install into the local skills dir", run: "shipeasy docs skill --sdk python --install true" }
-    ],
-    run: async (_client, i) => {
-      const sdk = i.sdk;
-      const { manifest, fallback } = await loadManifest(sdk);
-      const skillPath = manifest.skill ?? "skill/SKILL.md";
-      const content = fallback ? DEFAULT_CONTENT[skillPath] : await fetchText(`${pagesBase(sdk)}/${skillPath}`) ?? void 0;
-      if (content === void 0) throw new ApiError(`No skill published for '${sdk}'.`, 404);
-      return { sdk, skillPath, fallback, content };
-    }
-  }
-];
-export {
-  docsOperations
-};