@shipeasy/openapi 1.6.0 → 2.1.0

package/dist/client.d.ts

@@ -0,0 +1 @@
+export { i as Client, k as Config, m as ConfigureOptions, L as CreateClientConfig, gL as Options, hf as RequestResult, kx as approveEvent, ky as client, kz as configure, kA as createAlertRule, kB as createAttribute, kC as createClient, kD as createClientConfig, kE as createConfig, kF as createConnector, kG as createEvent, kH as createExperiment, kI as createGate, kJ as createGateTemplate, kK as createI18nDraft, kL as createI18nProfile, kM as createKey, kN as createKillswitch, kO as createMetric, kP as createOpsItem, kQ as createTriggerConnector, kR as createUniverse, kS as deleteAlertRule, kT as deleteAttribute, kU as deleteConfig, kV as deleteConnector, kW as deleteEvent, kX as deleteExperiment, kY as deleteGate, kZ as deleteGateTemplate, k_ as deleteKillswitch, k$ as deleteMetric, l0 as deleteUniverse, l1 as disableGate, l2 as discardConfigDraft, l3 as enableGate, l4 as fileErrorTicket, l5 as fireConnector, l6 as getAttribute, l7 as getConfig, l8 as getConnector, l9 as getCurrentProject, la as getError, lb as getErrorSeries, lc as getEvent, ld as getExperiment, le as getExperimentResults, lf as getExperimentTimeseries, lg as getGateTemplate, lh as getKillswitch, li as getMetric, lj as getOpsItem, lk as linkPrToOpsItem, ll as listAlertRules, lm as listAttributes, ln as listConfigActivity, lo as listConfigs, lp as listConnectors, lq as listErrors, lr as listEvents, ls as listExperiments, lt as listGateTemplates, lu as listGates, lv as listI18nDrafts, lw as listI18nKeys, lx as listI18nProfiles, ly as listKeys, lz as listKillswitches, lA as listMetrics, lB as listOpsItems, lC as listSlackChannels, lD as listUniverses, lE as notifyOps, lF as publishConfigDraft, lG as publishI18nProfile, lH as pushI18nKeys, lI as reanalyzeExperiment, lJ as revokeKey, lK as saveConfigDraft, lL as searchResources, lM as setExperimentMetrics, lN as setExperimentStatus, lO as setI18nLabel, lP as setKillswitchSwitch, lQ as setKillswitchValue, lR as testConnector, lS as unsetKillswitchSwitch, lT as updateAlertRule, lU as updateAttribute, lV as updateConfig, lW as updateConfigSchema, lX as updateConnector, lY as updateErrorStatus, lZ as updateEvent, l_ as updateExperiment, l$ as updateGate, m0 as updateGateTemplate, m1 as updateI18nDraft, m2 as updateI18nKey, m3 as updateKillswitch, m4 as updateMetric, m5 as updateOpsItem, m6 as updateProject, m7 as updateTriggerConnector, m8 as updateUniverse, m9 as upsertProject } from './client-pVkoo3Bf.js';

package/dist/client.js

@@ -0,0 +1,215 @@
+import {
+  approveEvent,
+  client,
+  configure,
+  createAlertRule,
+  createAttribute,
+  createClient,
+  createConfig,
+  createConfig2,
+  createConnector,
+  createEvent,
+  createExperiment,
+  createGate,
+  createGateTemplate,
+  createI18nDraft,
+  createI18nProfile,
+  createKey,
+  createKillswitch,
+  createMetric,
+  createOpsItem,
+  createTriggerConnector,
+  createUniverse,
+  deleteAlertRule,
+  deleteAttribute,
+  deleteConfig,
+  deleteConnector,
+  deleteEvent,
+  deleteExperiment,
+  deleteGate,
+  deleteGateTemplate,
+  deleteKillswitch,
+  deleteMetric,
+  deleteUniverse,
+  disableGate,
+  discardConfigDraft,
+  enableGate,
+  fileErrorTicket,
+  fireConnector,
+  getAttribute,
+  getConfig,
+  getConnector,
+  getCurrentProject,
+  getError,
+  getErrorSeries,
+  getEvent,
+  getExperiment,
+  getExperimentResults,
+  getExperimentTimeseries,
+  getGateTemplate,
+  getKillswitch,
+  getMetric,
+  getOpsItem,
+  linkPrToOpsItem,
+  listAlertRules,
+  listAttributes,
+  listConfigActivity,
+  listConfigs,
+  listConnectors,
+  listErrors,
+  listEvents,
+  listExperiments,
+  listGateTemplates,
+  listGates,
+  listI18nDrafts,
+  listI18nKeys,
+  listI18nProfiles,
+  listKeys,
+  listKillswitches,
+  listMetrics,
+  listOpsItems,
+  listSlackChannels,
+  listUniverses,
+  notifyOps,
+  publishConfigDraft,
+  publishI18nProfile,
+  pushI18nKeys,
+  reanalyzeExperiment,
+  revokeKey,
+  saveConfigDraft,
+  searchResources,
+  setExperimentMetrics,
+  setExperimentStatus,
+  setI18nLabel,
+  setKillswitchSwitch,
+  setKillswitchValue,
+  testConnector,
+  unsetKillswitchSwitch,
+  updateAlertRule,
+  updateAttribute,
+  updateConfig,
+  updateConfigSchema,
+  updateConnector,
+  updateErrorStatus,
+  updateEvent,
+  updateExperiment,
+  updateGate,
+  updateGateTemplate,
+  updateI18nDraft,
+  updateI18nKey,
+  updateKillswitch,
+  updateMetric,
+  updateOpsItem,
+  updateProject,
+  updateTriggerConnector,
+  updateUniverse,
+  upsertProject
+} from "./chunk-EPLLHLZN.js";
+export {
+  approveEvent,
+  client,
+  configure,
+  createAlertRule,
+  createAttribute,
+  createClient,
+  createConfig as createClientConfig,
+  createConfig2 as createConfig,
+  createConnector,
+  createEvent,
+  createExperiment,
+  createGate,
+  createGateTemplate,
+  createI18nDraft,
+  createI18nProfile,
+  createKey,
+  createKillswitch,
+  createMetric,
+  createOpsItem,
+  createTriggerConnector,
+  createUniverse,
+  deleteAlertRule,
+  deleteAttribute,
+  deleteConfig,
+  deleteConnector,
+  deleteEvent,
+  deleteExperiment,
+  deleteGate,
+  deleteGateTemplate,
+  deleteKillswitch,
+  deleteMetric,
+  deleteUniverse,
+  disableGate,
+  discardConfigDraft,
+  enableGate,
+  fileErrorTicket,
+  fireConnector,
+  getAttribute,
+  getConfig,
+  getConnector,
+  getCurrentProject,
+  getError,
+  getErrorSeries,
+  getEvent,
+  getExperiment,
+  getExperimentResults,
+  getExperimentTimeseries,
+  getGateTemplate,
+  getKillswitch,
+  getMetric,
+  getOpsItem,
+  linkPrToOpsItem,
+  listAlertRules,
+  listAttributes,
+  listConfigActivity,
+  listConfigs,
+  listConnectors,
+  listErrors,
+  listEvents,
+  listExperiments,
+  listGateTemplates,
+  listGates,
+  listI18nDrafts,
+  listI18nKeys,
+  listI18nProfiles,
+  listKeys,
+  listKillswitches,
+  listMetrics,
+  listOpsItems,
+  listSlackChannels,
+  listUniverses,
+  notifyOps,
+  publishConfigDraft,
+  publishI18nProfile,
+  pushI18nKeys,
+  reanalyzeExperiment,
+  revokeKey,
+  saveConfigDraft,
+  searchResources,
+  setExperimentMetrics,
+  setExperimentStatus,
+  setI18nLabel,
+  setKillswitchSwitch,
+  setKillswitchValue,
+  testConnector,
+  unsetKillswitchSwitch,
+  updateAlertRule,
+  updateAttribute,
+  updateConfig,
+  updateConfigSchema,
+  updateConnector,
+  updateErrorStatus,
+  updateEvent,
+  updateExperiment,
+  updateGate,
+  updateGateTemplate,
+  updateI18nDraft,
+  updateI18nKey,
+  updateKillswitch,
+  updateMetric,
+  updateOpsItem,
+  updateProject,
+  updateTriggerConnector,
+  updateUniverse,
+  upsertProject
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/custom.d.ts

@@ -0,0 +1,64 @@
+/**
+ * The custom-operations registry — hand-written operations that are NOT admin
+ * API endpoints (so they can't be generated from the spec): the metric-DSL
+ * grammar (pure) and the SDK-docs fetcher (outbound `fetch` to GitHub Pages).
+ *
+ * It mirrors the old operations registry in spirit, but is deliberately tiny and
+ * framework-agnostic: each `CustomOp` carries its command path, params, and a
+ * self-contained `run`. Both consumers project it with a thin adapter — the CLI
+ * (`commands/custom.ts`) and, later, the MCP server — so the surface stays in
+ * sync across them. `run` never touches the filesystem, so it's worker-safe.
+ */
+type CustomParamType = "string" | "number" | "boolean";
+interface CustomParam {
+    name: string;
+    type: CustomParamType;
+    description?: string;
+    required?: boolean;
+    /** Render as a positional CLI argument (vs a `--flag`). */
+    positional?: boolean;
+    enum?: string[];
+}
+interface CustomOp {
+    /** Command path, e.g. `["docs"]` → `shipeasy docs <name>`, `["metrics"]` → `metrics <name>`. */
+    group: string[];
+    /** Verb. */
+    name: string;
+    summary: string;
+    description?: string;
+    params: CustomParam[];
+    examples?: {
+        note?: string;
+        run: string;
+    }[];
+    /** Self-contained handler. `args` are the coerced param values. */
+    run: (args: Record<string, unknown>) => Promise<unknown> | unknown;
+}
+/** Thrown by a custom op for a user-facing error with an HTTP-ish status. */
+declare class CustomOpError extends Error {
+    status: number;
+    constructor(message: string, status?: number);
+}
+declare const opId: (op: CustomOp) => string;
+
+/**
+ * The Shipeasy metric query DSL grammar — printed by `shipeasy metrics grammar`
+ * / the `metrics_grammar` MCP tool.
+ *
+ * This is the one-stop reference for both humans and AI agents that need to
+ * author a `metrics create --query "..."` string. It is intentionally
+ * self-contained: the formal grammar (precise, for machine parsing), a full
+ * aggregation reference (semantics + value-label rules + experiment behaviour),
+ * the selector/filter/group-by rules, hard constraints, and glossed examples.
+ * Keep it in sync with the parser (`cli/src/query-dsl/parse.ts`) and the IR
+ * (`cli/src/query-dsl/ir.ts`) — they are the source of truth for semantics.
+ */
+declare const METRIC_GRAMMAR = "SHIPEASY METRIC QUERY DSL\n=========================\n\nA metric is ONE aggregation over ONE event stream. This DSL is the string you\npass to `metrics create --query \"...\"` (equivalently the typed `query_ir`).\nThere is no arithmetic, no formulas across events, no subqueries \u2014 one event\nselector, one aggregation, an optional group-by.\n\n\nGRAMMAR (BNF)\n-------------\n  Query         := AggFunc \"(\" Selector (\",\" Identifier)? \")\" GroupBy?\n  AggFunc       := \"count_users\" | \"count\" | \"sum\" | \"avg\" | \"min\" | \"max\"\n                 | \"unique\" | \"p50\" | \"p75\" | \"p90\" | \"p95\" | \"p99\" | \"p999\"\n                 | \"retention_\" <N> \"d\"                       (N = 1..90)\n  Selector      := Identifier (\"{\" Filter (\",\" Filter)* \",\"? \"}\")?\n  Filter        := Identifier MatchOp StringLiteral\n  MatchOp       := \"=\" | \"!=\" | \"=~\" | \"!~\"\n  GroupBy       := (\"by\" | \"without\") \"(\" Identifier (\",\" Identifier)* \",\"? \")\"\n  StringLiteral := double-quoted; \\\" is a literal quote, \\\\ is a backslash\n  Identifier    := [A-Za-z_][A-Za-z0-9_]*                     (case-sensitive)\n\n  The trailing Identifier after the selector \u2014 \"(\" Selector \",\" Identifier \")\" \u2014\n  is the VALUE LABEL: the numeric event label the aggregation reduces. Whether it\n  is required, optional, or forbidden depends on the aggregation (see below).\n\n\nAGGREGATIONS\n------------\n  Function        Value label   Meaning                         In experiments\n  --------------  ------------  ------------------------------  ---------------\n  count_users     forbidden     distinct users who fired it     exact\n  count           forbidden     number of events (rows)         exact\n  sum(e, v)       required      \u03A3 of numeric label v            exact\n  avg(e, v)       required      mean of label v                 exact\n  retention_Nd(e) forbidden     % of users who returned         exact\n                                within N days (N = 1..90)\n  min(e, v)       required      minimum of label v              approx \u2192 avg *\n  max(e, v)       required      maximum of label v              approx \u2192 avg *\n  unique(e, v)    required      distinct values of label v      approx \u2192 avg *\n  p50 \u2026 p999(e,v) required      quantile of v (50/75/90/        approx \u2192 avg *\n                                95/99/99.9th percentile)\n\n  * Display-only aggregations. The experiment t-test needs a per-user mean and\n    variance, so min/max/unique/quantile are computed exactly on dashboards but\n    collapse to a per-user `avg` when used as an experiment metric. If you need\n    an exact experiment metric, pick count_users / count / sum / avg / retention.\n\n  \"count\" is the DSL spelling of the internal count_events (one per matching\n  row); \"count_users\" is unique-by-user. Getting these two confused is the most\n  common mistake \u2014 count double-counts a user who fired the event twice.\n\n\nSELECTOR & FILTERS\n------------------\n  The selector is the event name plus an optional `{ ... }` filter set that\n  narrows which events count. Each filter compares an event LABEL to a quoted\n  string:\n\n    =   equal            !=   not equal\n    =~  regex match      !~   regex NOT match\n\n  - Values are ALWAYS double-quoted strings, even for numeric labels \u2014 they are\n    coerced on the server (`amount=~\"^1[0-9]$\"`, `status=\"200\"`).\n  - Multiple filters are AND-ed: `{country=\"US\", tier!=\"free\"}`.\n  - Every filter label AND the value label must be a label DECLARED on the source\n    event. Undeclared labels are a validation error, not a silent no-match.\n\n\nGROUP-BY\n--------\n  Splits the result into one series per label combination.\n    by (a, b)       one series per distinct (a, b) \u2014 keep only these labels\n    without (a, b)  group by all declared labels EXCEPT a, b\n\n  NOTE: group-by is a DASHBOARD-only feature. In an experiment the group-by is\n  ignored \u2014 a per-user reducer is applied across the whole arm instead.\n\n\nNOT SUPPORTED (will fail to parse)\n----------------------------------\n  - arithmetic / ratios / formulas: `count(a) / count(b)`\n  - more than one event per query\n  - arbitrary quantiles (only the fixed p50/p75/p90/p95/p99/p999)\n  - unquoted or numeric filter values: `{status=200}`  \u2192 must be `\"200\"`\n  - trailing tokens after the query\n\n\nEXAMPLES  (query  \u2014  what it measures)\n--------------------------------------\n  count_users(checkout_completed)\n      distinct users who completed checkout.\n\n  count(add_to_cart{country=\"US\"})\n      number of US add-to-cart events (a user can count many times).\n\n  sum(purchase{country=\"US\"}, amount)\n      total purchase amount from US purchase events.\n\n  avg(req_dur{tier!=\"free\"}, ms) without (region)\n      mean request duration for non-free tiers, one series per region-excluded\n      label combination.\n\n  p99(req_dur{route=~\"/api/.*\"}, ms) by (route, status)\n      99th-percentile latency of /api/* requests, split by route and status.\n\n  unique(login{method=\"sso\"}, device_id)\n      distinct SSO devices seen (display-only; an experiment would use per-user avg).\n\n  retention_7d(session_start)\n      share of users who started a new session within 7 days.\n";
+
+/**
+ * Every custom (non-spec) operation, in surface order. The CLI and MCP each
+ * project this with a thin adapter so the sugar commands stay in sync.
+ */
+declare const customOperations: CustomOp[];
+
+export { type CustomOp, CustomOpError, type CustomParam, type CustomParamType, METRIC_GRAMMAR, customOperations, opId };

package/dist/custom.js

@@ -0,0 +1,292 @@
+// src/custom/grammar.ts
+var METRIC_GRAMMAR = `SHIPEASY METRIC QUERY DSL
+=========================
+
+A metric is ONE aggregation over ONE event stream. This DSL is the string you
+pass to \`metrics create --query "..."\` (equivalently the typed \`query_ir\`).
+There is no arithmetic, no formulas across events, no subqueries \u2014 one event
+selector, one aggregation, an optional group-by.
+
+
+GRAMMAR (BNF)
+-------------
+  Query         := AggFunc "(" Selector ("," Identifier)? ")" GroupBy?
+  AggFunc       := "count_users" | "count" | "sum" | "avg" | "min" | "max"
+                 | "unique" | "p50" | "p75" | "p90" | "p95" | "p99" | "p999"
+                 | "retention_" <N> "d"                       (N = 1..90)
+  Selector      := Identifier ("{" Filter ("," Filter)* ","? "}")?
+  Filter        := Identifier MatchOp StringLiteral
+  MatchOp       := "=" | "!=" | "=~" | "!~"
+  GroupBy       := ("by" | "without") "(" Identifier ("," Identifier)* ","? ")"
+  StringLiteral := double-quoted; \\" is a literal quote, \\\\ is a backslash
+  Identifier    := [A-Za-z_][A-Za-z0-9_]*                     (case-sensitive)
+
+  The trailing Identifier after the selector \u2014 "(" Selector "," Identifier ")" \u2014
+  is the VALUE LABEL: the numeric event label the aggregation reduces. Whether it
+  is required, optional, or forbidden depends on the aggregation (see below).
+
+
+AGGREGATIONS
+------------
+  Function        Value label   Meaning                         In experiments
+  --------------  ------------  ------------------------------  ---------------
+  count_users     forbidden     distinct users who fired it     exact
+  count           forbidden     number of events (rows)         exact
+  sum(e, v)       required      \u03A3 of numeric label v            exact
+  avg(e, v)       required      mean of label v                 exact
+  retention_Nd(e) forbidden     % of users who returned         exact
+                                within N days (N = 1..90)
+  min(e, v)       required      minimum of label v              approx \u2192 avg *
+  max(e, v)       required      maximum of label v              approx \u2192 avg *
+  unique(e, v)    required      distinct values of label v      approx \u2192 avg *
+  p50 \u2026 p999(e,v) required      quantile of v (50/75/90/        approx \u2192 avg *
+                                95/99/99.9th percentile)
+
+  * Display-only aggregations. The experiment t-test needs a per-user mean and
+    variance, so min/max/unique/quantile are computed exactly on dashboards but
+    collapse to a per-user \`avg\` when used as an experiment metric. If you need
+    an exact experiment metric, pick count_users / count / sum / avg / retention.
+
+  "count" is the DSL spelling of the internal count_events (one per matching
+  row); "count_users" is unique-by-user. Getting these two confused is the most
+  common mistake \u2014 count double-counts a user who fired the event twice.
+
+
+SELECTOR & FILTERS
+------------------
+  The selector is the event name plus an optional \`{ ... }\` filter set that
+  narrows which events count. Each filter compares an event LABEL to a quoted
+  string:
+
+    =   equal            !=   not equal
+    =~  regex match      !~   regex NOT match
+
+  - Values are ALWAYS double-quoted strings, even for numeric labels \u2014 they are
+    coerced on the server (\`amount=~"^1[0-9]$"\`, \`status="200"\`).
+  - Multiple filters are AND-ed: \`{country="US", tier!="free"}\`.
+  - Every filter label AND the value label must be a label DECLARED on the source
+    event. Undeclared labels are a validation error, not a silent no-match.
+
+
+GROUP-BY
+--------
+  Splits the result into one series per label combination.
+    by (a, b)       one series per distinct (a, b) \u2014 keep only these labels
+    without (a, b)  group by all declared labels EXCEPT a, b
+
+  NOTE: group-by is a DASHBOARD-only feature. In an experiment the group-by is
+  ignored \u2014 a per-user reducer is applied across the whole arm instead.
+
+
+NOT SUPPORTED (will fail to parse)
+----------------------------------
+  - arithmetic / ratios / formulas: \`count(a) / count(b)\`
+  - more than one event per query
+  - arbitrary quantiles (only the fixed p50/p75/p90/p95/p99/p999)
+  - unquoted or numeric filter values: \`{status=200}\`  \u2192 must be \`"200"\`
+  - trailing tokens after the query
+
+
+EXAMPLES  (query  \u2014  what it measures)
+--------------------------------------
+  count_users(checkout_completed)
+      distinct users who completed checkout.
+
+  count(add_to_cart{country="US"})
+      number of US add-to-cart events (a user can count many times).
+
+  sum(purchase{country="US"}, amount)
+      total purchase amount from US purchase events.
+
+  avg(req_dur{tier!="free"}, ms) without (region)
+      mean request duration for non-free tiers, one series per region-excluded
+      label combination.
+
+  p99(req_dur{route=~"/api/.*"}, ms) by (route, status)
+      99th-percentile latency of /api/* requests, split by route and status.
+
+  unique(login{method="sso"}, device_id)
+      distinct SSO devices seen (display-only; an experiment would use per-user avg).
+
+  retention_7d(session_start)
+      share of users who started a new session within 7 days.
+`;
+var grammarOp = {
+  group: ["metrics"],
+  name: "grammar",
+  summary: "Print the metric query DSL grammar",
+  description: "Print the full metric query DSL reference \u2014 grammar, aggregation semantics, filter/group-by rules, and glossed examples \u2014 used to author `metrics create --query`.",
+  params: [],
+  examples: [{ run: "shipeasy metrics grammar" }],
+  run: () => ({ grammar: METRIC_GRAMMAR })
+};
+
+// src/custom/types.ts
+var CustomOpError = class extends Error {
+  constructor(message, status = 400) {
+    super(message);
+    this.status = status;
+    this.name = "CustomOpError";
+  }
+  status;
+};
+var opId = (op) => [...op.group, op.name].join(".");
+
+// src/custom/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 requireSdk(sdk) {
+  const s = typeof sdk === "string" ? sdk.trim() : "";
+  if (!s)
+    throw new CustomOpError(
+      `No SDK given and none recorded in .shipeasy. Pass --sdk <lang> (one of: ${SDK_ENUM.join(", ")}), or run \`shipeasy detect\` in the project to record its sdk.`,
+      400
+    );
+  return s;
+}
+function repoFor(sdk) {
+  const r = SDK_REPOS[sdk.toLowerCase()];
+  if (!r) throw new CustomOpError(`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 CustomOpError(
+    `Doc '${handle}' not found. Run 'docs list --sdk <lang>' to see available pages and snippets.`,
+    404
+  );
+}
+function substitute(body, manifest, args) {
+  let out = body;
+  for (const ph of manifest.placeholders ?? []) {
+    const value = args[ph] ?? (ph === "RESOURCE_NAME" ? args.name : void 0) ?? (ph === "FRAMEWORK" ? args.framework : void 0);
+    if (value !== void 0) out = out.replaceAll(`{{${ph}}}`, value);
+  }
+  return out;
+}
+var docsOps = [
+  {
+    group: ["docs"],
+    name: "list",
+    summary: "List an SDK's documentation tree",
+    description: "Fetch an SDK's `/docs/manifest.json` and return the doc tree \u2014 feature pages, nested snippet groups, and whether an installable skill exists.",
+    params: [{ name: "sdk", type: "string", description: "SDK language. Defaults to the `sdk` recorded in the nearest `.shipeasy` when omitted.", required: false, enum: SDK_ENUM }],
+    examples: [{ run: "shipeasy docs list --sdk python" }],
+    run: async (args) => {
+      const sdk = requireSdk(args.sdk);
+      const { manifest, fallback } = await loadManifest(sdk);
+      return {
+        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",
+    summary: "Fetch one SDK doc page or snippet",
+    description: "Fetch one feature page (`flags`, `experiments`, \u2026) or nested snippet (`release/experiments`, \u2026), substituting declared {{placeholders}} from caller args.",
+    params: [
+      { name: "sdk", type: "string", description: "SDK language. Defaults to the `sdk` recorded in the nearest `.shipeasy` when omitted.", required: false, 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", run: "shipeasy docs get --sdk typescript release/flags --name checkout_v2" }
+    ],
+    run: async (args) => {
+      const sdk = requireSdk(args.sdk);
+      const { manifest, fallback } = await loadManifest(sdk);
+      const path = resolvePath(manifest, args.path);
+      const body = fallback ? DEFAULT_CONTENT[path] : await fetchText(`${pagesBase(sdk)}/${path}`) ?? void 0;
+      if (body === void 0) throw new CustomOpError(`Doc '${path}' could not be fetched for '${sdk}'.`, 404);
+      return { sdk, path, fallback, content: substitute(body, manifest, args) };
+    }
+  },
+  {
+    group: ["docs"],
+    name: "skill",
+    summary: "Fetch an SDK's installable LLM skill",
+    description: "Fetch the SDK's `skill/SKILL.md` (frontmatter intact) so an agent can install it verbatim. The CLI `--install` writes it locally (a consumer fs side-effect).",
+    params: [
+      { name: "sdk", type: "string", description: "SDK language. Defaults to the `sdk` recorded in the nearest `.shipeasy` when omitted.", required: false, 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" }],
+    run: async (args) => {
+      const sdk = requireSdk(args.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 CustomOpError(`No skill published for '${sdk}'.`, 404);
+      return { sdk, skillPath, fallback, content };
+    }
+  }
+];
+
+// src/custom/index.ts
+var customOperations = [grammarOp, ...docsOps];
+export {
+  CustomOpError,
+  METRIC_GRAMMAR,
+  customOperations,
+  opId
+};
+//# sourceMappingURL=custom.js.map

package/dist/custom.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/custom/grammar.ts","../src/custom/types.ts","../src/custom/docs.ts","../src/custom/index.ts"],"sourcesContent":["import type { CustomOp } from \"./types.js\";\n\n/**\n * The Shipeasy metric query DSL grammar — printed by `shipeasy metrics grammar`\n * / the `metrics_grammar` MCP tool.\n *\n * This is the one-stop reference for both humans and AI agents that need to\n * author a `metrics create --query \"...\"` string. It is intentionally\n * self-contained: the formal grammar (precise, for machine parsing), a full\n * aggregation reference (semantics + value-label rules + experiment behaviour),\n * the selector/filter/group-by rules, hard constraints, and glossed examples.\n * Keep it in sync with the parser (`cli/src/query-dsl/parse.ts`) and the IR\n * (`cli/src/query-dsl/ir.ts`) — they are the source of truth for semantics.\n */\nexport const METRIC_GRAMMAR = `SHIPEASY METRIC QUERY DSL\n=========================\n\nA metric is ONE aggregation over ONE event stream. This DSL is the string you\npass to \\`metrics create --query \"...\"\\` (equivalently the typed \\`query_ir\\`).\nThere is no arithmetic, no formulas across events, no subqueries — one event\nselector, one aggregation, an optional group-by.\n\n\nGRAMMAR (BNF)\n-------------\n  Query         := AggFunc \"(\" Selector (\",\" Identifier)? \")\" GroupBy?\n  AggFunc       := \"count_users\" | \"count\" | \"sum\" | \"avg\" | \"min\" | \"max\"\n                 | \"unique\" | \"p50\" | \"p75\" | \"p90\" | \"p95\" | \"p99\" | \"p999\"\n                 | \"retention_\" <N> \"d\"                       (N = 1..90)\n  Selector      := Identifier (\"{\" Filter (\",\" Filter)* \",\"? \"}\")?\n  Filter        := Identifier MatchOp StringLiteral\n  MatchOp       := \"=\" | \"!=\" | \"=~\" | \"!~\"\n  GroupBy       := (\"by\" | \"without\") \"(\" Identifier (\",\" Identifier)* \",\"? \")\"\n  StringLiteral := double-quoted; \\\\\" is a literal quote, \\\\\\\\ is a backslash\n  Identifier    := [A-Za-z_][A-Za-z0-9_]*                     (case-sensitive)\n\n  The trailing Identifier after the selector — \"(\" Selector \",\" Identifier \")\" —\n  is the VALUE LABEL: the numeric event label the aggregation reduces. Whether it\n  is required, optional, or forbidden depends on the aggregation (see below).\n\n\nAGGREGATIONS\n------------\n  Function        Value label   Meaning                         In experiments\n  --------------  ------------  ------------------------------  ---------------\n  count_users     forbidden     distinct users who fired it     exact\n  count           forbidden     number of events (rows)         exact\n  sum(e, v)       required      Σ of numeric label v            exact\n  avg(e, v)       required      mean of label v                 exact\n  retention_Nd(e) forbidden     % of users who returned         exact\n                                within N days (N = 1..90)\n  min(e, v)       required      minimum of label v              approx → avg *\n  max(e, v)       required      maximum of label v              approx → avg *\n  unique(e, v)    required      distinct values of label v      approx → avg *\n  p50 … p999(e,v) required      quantile of v (50/75/90/        approx → avg *\n                                95/99/99.9th percentile)\n\n  * Display-only aggregations. The experiment t-test needs a per-user mean and\n    variance, so min/max/unique/quantile are computed exactly on dashboards but\n    collapse to a per-user \\`avg\\` when used as an experiment metric. If you need\n    an exact experiment metric, pick count_users / count / sum / avg / retention.\n\n  \"count\" is the DSL spelling of the internal count_events (one per matching\n  row); \"count_users\" is unique-by-user. Getting these two confused is the most\n  common mistake — count double-counts a user who fired the event twice.\n\n\nSELECTOR & FILTERS\n------------------\n  The selector is the event name plus an optional \\`{ ... }\\` filter set that\n  narrows which events count. Each filter compares an event LABEL to a quoted\n  string:\n\n    =   equal            !=   not equal\n    =~  regex match      !~   regex NOT match\n\n  - Values are ALWAYS double-quoted strings, even for numeric labels — they are\n    coerced on the server (\\`amount=~\"^1[0-9]$\"\\`, \\`status=\"200\"\\`).\n  - Multiple filters are AND-ed: \\`{country=\"US\", tier!=\"free\"}\\`.\n  - Every filter label AND the value label must be a label DECLARED on the source\n    event. Undeclared labels are a validation error, not a silent no-match.\n\n\nGROUP-BY\n--------\n  Splits the result into one series per label combination.\n    by (a, b)       one series per distinct (a, b) — keep only these labels\n    without (a, b)  group by all declared labels EXCEPT a, b\n\n  NOTE: group-by is a DASHBOARD-only feature. In an experiment the group-by is\n  ignored — a per-user reducer is applied across the whole arm instead.\n\n\nNOT SUPPORTED (will fail to parse)\n----------------------------------\n  - arithmetic / ratios / formulas: \\`count(a) / count(b)\\`\n  - more than one event per query\n  - arbitrary quantiles (only the fixed p50/p75/p90/p95/p99/p999)\n  - unquoted or numeric filter values: \\`{status=200}\\`  → must be \\`\"200\"\\`\n  - trailing tokens after the query\n\n\nEXAMPLES  (query  —  what it measures)\n--------------------------------------\n  count_users(checkout_completed)\n      distinct users who completed checkout.\n\n  count(add_to_cart{country=\"US\"})\n      number of US add-to-cart events (a user can count many times).\n\n  sum(purchase{country=\"US\"}, amount)\n      total purchase amount from US purchase events.\n\n  avg(req_dur{tier!=\"free\"}, ms) without (region)\n      mean request duration for non-free tiers, one series per region-excluded\n      label combination.\n\n  p99(req_dur{route=~\"/api/.*\"}, ms) by (route, status)\n      99th-percentile latency of /api/* requests, split by route and status.\n\n  unique(login{method=\"sso\"}, device_id)\n      distinct SSO devices seen (display-only; an experiment would use per-user avg).\n\n  retention_7d(session_start)\n      share of users who started a new session within 7 days.\n`;\n\nexport const grammarOp: CustomOp = {\n  group: [\"metrics\"],\n  name: \"grammar\",\n  summary: \"Print the metric query DSL grammar\",\n  description:\n    \"Print the full metric query DSL reference — grammar, aggregation semantics, \" +\n    \"filter/group-by rules, and glossed examples — used to author `metrics create --query`.\",\n  params: [],\n  examples: [{ run: \"shipeasy metrics grammar\" }],\n  run: () => ({ grammar: METRIC_GRAMMAR }),\n};\n","/**\n * The custom-operations registry — hand-written operations that are NOT admin\n * API endpoints (so they can't be generated from the spec): the metric-DSL\n * grammar (pure) and the SDK-docs fetcher (outbound `fetch` to GitHub Pages).\n *\n * It mirrors the old operations registry in spirit, but is deliberately tiny and\n * framework-agnostic: each `CustomOp` carries its command path, params, and a\n * self-contained `run`. Both consumers project it with a thin adapter — the CLI\n * (`commands/custom.ts`) and, later, the MCP server — so the surface stays in\n * sync across them. `run` never touches the filesystem, so it's worker-safe.\n */\nexport type CustomParamType = \"string\" | \"number\" | \"boolean\";\n\nexport interface CustomParam {\n  name: string;\n  type: CustomParamType;\n  description?: string;\n  required?: boolean;\n  /** Render as a positional CLI argument (vs a `--flag`). */\n  positional?: boolean;\n  enum?: string[];\n}\n\nexport interface CustomOp {\n  /** Command path, e.g. `[\"docs\"]` → `shipeasy docs <name>`, `[\"metrics\"]` → `metrics <name>`. */\n  group: string[];\n  /** Verb. */\n  name: string;\n  summary: string;\n  description?: string;\n  params: CustomParam[];\n  examples?: { note?: string; run: string }[];\n  /** Self-contained handler. `args` are the coerced param values. */\n  run: (args: Record<string, unknown>) => Promise<unknown> | unknown;\n}\n\n/** Thrown by a custom op for a user-facing error with an HTTP-ish status. */\nexport class CustomOpError extends Error {\n  constructor(\n    message: string,\n    public status = 400,\n  ) {\n    super(message);\n    this.name = \"CustomOpError\";\n  }\n}\n\nexport const opId = (op: CustomOp): string => [...op.group, op.name].join(\".\");\n","import { type CustomOp, CustomOpError } from \"./types.js\";\n\n/**\n * SDK-docs operations — `docs list/get/skill`. A generic fetcher over each SDK\n * repo's `/docs/` folder published to plain GitHub Pages (latest only, no\n * backend, no version arg). The `run`s do outbound `fetch` (worker-safe — not\n * the fs/AST boundary) and fall back to a built-in default doc set for repos\n * that haven't adopted the doc standard yet.\n */\nconst SDK_REPOS: Record<string, { owner: string; repo: string }> = {\n  typescript: { owner: \"shipeasy-ai\", repo: \"sdk\" },\n  javascript: { owner: \"shipeasy-ai\", repo: \"sdk\" },\n  node: { owner: \"shipeasy-ai\", repo: \"sdk\" },\n  ts: { owner: \"shipeasy-ai\", repo: \"sdk\" },\n  python: { owner: \"shipeasy-ai\", repo: \"sdk-python\" },\n  go: { owner: \"shipeasy-ai\", repo: \"sdk-go\" },\n  java: { owner: \"shipeasy-ai\", repo: \"sdk-java\" },\n  kotlin: { owner: \"shipeasy-ai\", repo: \"sdk-kotlin\" },\n  php: { owner: \"shipeasy-ai\", repo: \"sdk-php\" },\n  swift: { owner: \"shipeasy-ai\", repo: \"sdk-swift\" },\n  ruby: { owner: \"shipeasy-ai\", repo: \"sdk-ruby\" },\n};\nconst SDK_ENUM = Object.keys(SDK_REPOS);\n\ninterface DocManifest {\n  schemaVersion: number;\n  sdk: string;\n  placeholders?: string[];\n  skill?: string;\n  pages?: Record<string, string>;\n  snippets?: Record<string, Record<string, string>>;\n}\n\nconst DEFAULT_MANIFEST: DocManifest = {\n  schemaVersion: 2,\n  sdk: \"default\",\n  placeholders: [\"RESOURCE_NAME\"],\n  skill: \"skill/SKILL.md\",\n  pages: { overview: \"pages/overview.md\", installation: \"pages/installation.md\" },\n  snippets: { release: { flags: \"snippets/release/flags.md\" } },\n};\nconst DEFAULT_CONTENT: Record<string, string> = {\n  \"pages/overview.md\":\n    \"# Shipeasy SDK\\n\\nThis SDK has not published its `/docs/` folder yet. See https://docs.shipeasy.ai for the full reference.\",\n  \"pages/installation.md\":\n    \"# Installation\\n\\nInstall the Shipeasy SDK for your language, then call `shipeasy({ serverKey })` (server) or `shipeasy({ clientKey })` (browser).\",\n  \"snippets/release/flags.md\": \"```\\nconst on = await client.checkGate(user, '{{RESOURCE_NAME}}');\\n```\",\n  \"skill/SKILL.md\":\n    \"---\\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.\",\n};\n\n/**\n * Resolve the caller-supplied `sdk`. The adapters (CLI/MCP) default it from the\n * nearest `.shipeasy` before we get here, so an empty value means neither a flag\n * nor a bound project supplied one — surface that explicitly.\n */\nfunction requireSdk(sdk: unknown): string {\n  const s = typeof sdk === \"string\" ? sdk.trim() : \"\";\n  if (!s)\n    throw new CustomOpError(\n      `No SDK given and none recorded in .shipeasy. Pass --sdk <lang> (one of: ${SDK_ENUM.join(\", \")}), ` +\n        `or run \\`shipeasy detect\\` in the project to record its sdk.`,\n      400,\n    );\n  return s;\n}\nfunction repoFor(sdk: string): { owner: string; repo: string } {\n  const r = SDK_REPOS[sdk.toLowerCase()];\n  if (!r) throw new CustomOpError(`Unknown SDK '${sdk}'. One of: ${SDK_ENUM.join(\", \")}`, 400);\n  return r;\n}\nfunction pagesBase(sdk: string): string {\n  const { owner, repo } = repoFor(sdk);\n  return `https://${owner}.github.io/${repo}`;\n}\nasync function fetchText(url: string): Promise<string | null> {\n  const res = await fetch(url);\n  if (!res.ok) return null;\n  return res.text();\n}\nasync function loadManifest(sdk: string): Promise<{ manifest: DocManifest; fallback: boolean }> {\n  const text = await fetchText(`${pagesBase(sdk)}/manifest.json`);\n  if (!text) return { manifest: DEFAULT_MANIFEST, fallback: true };\n  try {\n    return { manifest: JSON.parse(text) as DocManifest, fallback: false };\n  } catch {\n    return { manifest: DEFAULT_MANIFEST, fallback: true };\n  }\n}\nfunction resolvePath(manifest: DocManifest, handle: string): string {\n  if (handle.endsWith(\".md\")) return handle;\n  if (manifest.pages?.[handle]) return manifest.pages[handle];\n  if (handle.includes(\"/\")) {\n    const [group, resource] = handle.split(\"/\", 2);\n    const p = manifest.snippets?.[group]?.[resource];\n    if (p) return p;\n  }\n  throw new CustomOpError(\n    `Doc '${handle}' not found. Run 'docs list --sdk <lang>' to see available pages and snippets.`,\n    404,\n  );\n}\nfunction substitute(body: string, manifest: DocManifest, args: Record<string, unknown>): string {\n  let out = body;\n  for (const ph of manifest.placeholders ?? []) {\n    const value =\n      (args[ph] as string | undefined) ??\n      (ph === \"RESOURCE_NAME\" ? (args.name as string | undefined) : undefined) ??\n      (ph === \"FRAMEWORK\" ? (args.framework as string | undefined) : undefined);\n    if (value !== undefined) out = out.replaceAll(`{{${ph}}}`, value);\n  }\n  return out;\n}\n\nexport const docsOps: CustomOp[] = [\n  {\n    group: [\"docs\"],\n    name: \"list\",\n    summary: \"List an SDK's documentation tree\",\n    description:\n      \"Fetch an SDK's `/docs/manifest.json` and return the doc tree — feature pages, nested snippet groups, and whether an installable skill exists.\",\n    params: [{ name: \"sdk\", type: \"string\", description: \"SDK language. Defaults to the `sdk` recorded in the nearest `.shipeasy` when omitted.\", required: false, enum: SDK_ENUM }],\n    examples: [{ run: \"shipeasy docs list --sdk python\" }],\n    run: async (args) => {\n      const sdk = requireSdk(args.sdk);\n      const { manifest, fallback } = await loadManifest(sdk);\n      return {\n        sdk,\n        fallback,\n        pages: Object.keys(manifest.pages ?? {}),\n        snippets: Object.fromEntries(\n          Object.entries(manifest.snippets ?? {}).map(([g, r]) => [g, Object.keys(r)]),\n        ),\n        skill: Boolean(manifest.skill),\n      };\n    },\n  },\n  {\n    group: [\"docs\"],\n    name: \"get\",\n    summary: \"Fetch one SDK doc page or snippet\",\n    description:\n      \"Fetch one feature page (`flags`, `experiments`, …) or nested snippet (`release/experiments`, …), substituting declared {{placeholders}} from caller args.\",\n    params: [\n      { name: \"sdk\", type: \"string\", description: \"SDK language. Defaults to the `sdk` recorded in the nearest `.shipeasy` when omitted.\", required: false, enum: SDK_ENUM },\n      { name: \"path\", type: \"string\", description: \"Page key or snippet 'group/resource'.\", required: true, positional: true },\n      { name: \"framework\", type: \"string\", description: \"Framework hint (substitutes {{FRAMEWORK}}).\" },\n      { name: \"name\", type: \"string\", description: \"Resource name (substitutes {{RESOURCE_NAME}}).\" },\n    ],\n    examples: [\n      { note: \"A feature page\", run: \"shipeasy docs get --sdk python experiments\" },\n      { note: \"A nested snippet\", run: \"shipeasy docs get --sdk typescript release/flags --name checkout_v2\" },\n    ],\n    run: async (args) => {\n      const sdk = requireSdk(args.sdk);\n      const { manifest, fallback } = await loadManifest(sdk);\n      const path = resolvePath(manifest, args.path as string);\n      const body = fallback ? DEFAULT_CONTENT[path] : ((await fetchText(`${pagesBase(sdk)}/${path}`)) ?? undefined);\n      if (body === undefined) throw new CustomOpError(`Doc '${path}' could not be fetched for '${sdk}'.`, 404);\n      return { sdk, path, fallback, content: substitute(body, manifest, args) };\n    },\n  },\n  {\n    group: [\"docs\"],\n    name: \"skill\",\n    summary: \"Fetch an SDK's installable LLM skill\",\n    description:\n      \"Fetch the SDK's `skill/SKILL.md` (frontmatter intact) so an agent can install it verbatim. The CLI `--install` writes it locally (a consumer fs side-effect).\",\n    params: [\n      { name: \"sdk\", type: \"string\", description: \"SDK language. Defaults to the `sdk` recorded in the nearest `.shipeasy` when omitted.\", required: false, enum: SDK_ENUM },\n      { name: \"install\", type: \"boolean\", description: \"CLI only: write the skill to the local agent skills dir.\" },\n    ],\n    examples: [{ run: \"shipeasy docs skill --sdk python\" }],\n    run: async (args) => {\n      const sdk = requireSdk(args.sdk);\n      const { manifest, fallback } = await loadManifest(sdk);\n      const skillPath = manifest.skill ?? \"skill/SKILL.md\";\n      const content = fallback ? DEFAULT_CONTENT[skillPath] : ((await fetchText(`${pagesBase(sdk)}/${skillPath}`)) ?? undefined);\n      if (content === undefined) throw new CustomOpError(`No skill published for '${sdk}'.`, 404);\n      return { sdk, skillPath, fallback, content };\n    },\n  },\n];\n","import { grammarOp } from \"./grammar.js\";\nimport { docsOps } from \"./docs.js\";\nimport type { CustomOp } from \"./types.js\";\n\nexport type { CustomOp, CustomParam, CustomParamType } from \"./types.js\";\nexport { CustomOpError, opId } from \"./types.js\";\nexport { METRIC_GRAMMAR } from \"./grammar.js\";\n\n/**\n * Every custom (non-spec) operation, in surface order. The CLI and MCP each\n * project this with a thin adapter so the sugar commands stay in sync.\n */\nexport const customOperations: CustomOp[] = [grammarOp, ...docsOps];\n"],"mappings":"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","names":[]}