@solidcommerce/mcp-server 2.0.0-alpha.0

package/dist/tools/contract.js

@@ -0,0 +1,101 @@
+// =============================================================================
+// src/tools/contract.ts
+// Wave: W6 — Shared tool contract.
+//
+// Streams A (foundation), B (tasks), and C (server core / dispatcher) all
+// agree on these types. A & B export ToolModule instances; C imports them and
+// exposes them over the MCP wire protocol.
+//
+// Why this exists: streams run in parallel via worktree-isolated sub-agents.
+// Pinning the interface here lets each stream work without blocking on the
+// others' implementation details.
+// =============================================================================
+/**
+ * Map a thrown SDK error into a structured ToolResult. Used by the
+ * dispatcher (Stream C) AND by task tools (Stream B) when they catch
+ * partial failures and want to fold them into the result.
+ *
+ * Accepts three input shapes:
+ *
+ *   1. A typed `ApiError` (or duck-typed equivalent) with camelCase fields
+ *      (`requiredScope`, `requestId`, `retryAfter`). This is what the SDK's
+ *      `unwrap()` / `mapErrorEnvelope()` produces.
+ *
+ *   2. The raw openapi-fetch `result.error` — the *parsed JSON body* of a
+ *      4xx/5xx response. Foundation tools call `client.raw.<METHOD>(...)`
+ *      directly and forward `result.error` here without going through
+ *      `unwrap()`. The body is shaped `{ error: { type, code, message,
+ *      required_scope, retry_after, request_id, ... } }` (snake_case wire
+ *      fields). We unwrap one layer if present.
+ *
+ *   3. Anything else (network-level errors, plain `Error`, etc.) — wrapped
+ *      as `type: "transport"` so the LLM doesn't try to interpret a
+ *      missing `required_scope`.
+ *
+ * Why the unwrap matters for W6 acceptance: §4 requires that scope-denied
+ * tool calls surface the `required_scope` field on the wire. Without the
+ * unwrap, foundation tools (which forward `result.error` from openapi-fetch)
+ * would emit `type: "transport"` and lose `required_scope` entirely. See
+ * test/e2e/inspector.test.ts and scripts/w6_smoke.sh probe A6.
+ */
+export function mapSdkErrorToToolResult(err) {
+    // Shape 2: openapi-fetch wrapped envelope. Detect by the presence of an
+    // `error` sub-object whose `type` is a string. We do this BEFORE the
+    // typed-ApiError path because an `ApiError` instance never has its own
+    // nested `.error` field.
+    if (err !== null &&
+        typeof err === "object" &&
+        "error" in err &&
+        err.error !== null &&
+        typeof err.error === "object") {
+        const envelope = err.error;
+        if (typeof envelope["type"] === "string") {
+            const structured = {
+                type: envelope["type"],
+                ...(typeof envelope["code"] === "string" ? { code: envelope["code"] } : {}),
+                ...(typeof envelope["required_scope"] === "string"
+                    ? { required_scope: envelope["required_scope"] }
+                    : {}),
+                ...(typeof envelope["retry_after"] === "number"
+                    ? { retry_after: envelope["retry_after"] }
+                    : {}),
+                ...(typeof envelope["request_id"] === "string"
+                    ? { request_id: envelope["request_id"] }
+                    : {}),
+                ...(typeof envelope["message"] === "string" ? { message: envelope["message"] } : {}),
+            };
+            return {
+                content: [{ type: "json", json: { error: structured } }],
+                isError: true,
+                structuredError: structured,
+            };
+        }
+    }
+    // Shape 1: typed ApiError (or duck-typed equivalent with camelCase fields).
+    // Soft duck-type: avoid an `instanceof` import cycle from "@solidcommerce/sdk".
+    const e = err;
+    if (e && typeof e === "object" && typeof e.type === "string") {
+        const structured = {
+            type: e.type,
+            ...(e.code ? { code: e.code } : {}),
+            ...(e.requiredScope ? { required_scope: e.requiredScope } : {}),
+            ...(e.retryAfter !== null && e.retryAfter !== undefined ? { retry_after: e.retryAfter } : {}),
+            ...(e.requestId ? { request_id: e.requestId } : {}),
+            ...(e.message ? { message: e.message } : {}),
+        };
+        return {
+            content: [{ type: "json", json: { error: structured } }],
+            isError: true,
+            structuredError: structured,
+        };
+    }
+    // Shape 3: anything else.
+    const message = err instanceof Error ? err.message : String(err);
+    const structured = { type: "transport", message };
+    return {
+        content: [{ type: "json", json: { error: structured } }],
+        isError: true,
+        structuredError: structured,
+    };
+}
+//# sourceMappingURL=contract.js.map

package/dist/tools/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/tools/contract.ts"],"names":[],"mappings":"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"}

package/dist/tools/foundation/catalog_amazon_items_list.d.ts

@@ -0,0 +1,4 @@
+import { type ToolModule } from "../contract.js";
+declare const tool: ToolModule;
+export default tool;
+//# sourceMappingURL=catalog_amazon_items_list.d.ts.map

package/dist/tools/foundation/catalog_amazon_items_list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_amazon_items_list.d.ts","sourceRoot":"","sources":["../../../src/tools/foundation/catalog_amazon_items_list.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,gBAAgB,CAAC;AAuCxB,QAAA,MAAM,IAAI,EAAE,UAUX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tools/foundation/catalog_amazon_items_list.js

@@ -0,0 +1,47 @@
+// =============================================================================
+// AUTO-GENERATED — DO NOT EDIT BY HAND.
+// Regenerate via: npm run regen-foundation-tools
+// Source: vendor/openapi.snapshot.json (W4 frozen).
+// =============================================================================
+// Tier: tier1  HTTP: GET /v1/catalog/amazon/items
+import { z } from "zod";
+import { mapSdkErrorToToolResult, } from "../contract.js";
+const inputSchema = z.object({});
+async function handle(args, ctx) {
+    let parsed;
+    try {
+        parsed = inputSchema.parse(args);
+    }
+    catch (err) {
+        return mapSdkErrorToToolResult(err);
+    }
+    void parsed; // referenced below when the operation declares params/body.
+    try {
+        const raw = ctx.client.raw;
+        const fn = raw["GET"];
+        if (typeof fn !== "function") {
+            return mapSdkErrorToToolResult(new Error("SDK client missing method GET"));
+        }
+        const result = await fn("/v1/catalog/amazon/items", {});
+        if (result.error !== undefined && result.error !== null) {
+            return mapSdkErrorToToolResult(result.error);
+        }
+        return { content: [{ type: "json", json: result.data ?? null }] };
+    }
+    catch (err) {
+        return mapSdkErrorToToolResult(err);
+    }
+}
+const tool = {
+    name: "catalog_amazon_items_list",
+    kind: "foundation",
+    description: "Requires scope: catalog:amazon_items:read.",
+    required_scope: "catalog:amazon_items:read",
+    // HTTP verb → Claude UI annotation. GET → readOnlyHint; write verbs →
+    // destructiveHint. Enforced by test/tools/annotations.test.ts.
+    readOnlyHint: true,
+    inputSchema,
+    handle,
+};
+export default tool;
+//# sourceMappingURL=catalog_amazon_items_list.js.map

package/dist/tools/foundation/catalog_amazon_items_list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_amazon_items_list.js","sourceRoot":"","sources":["../../../src/tools/foundation/catalog_amazon_items_list.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wCAAwC;AACxC,iDAAiD;AACjD,oDAAoD;AACpD,gFAAgF;AAEhF,kDAAkD;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,uBAAuB,GAIxB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAIjC,KAAK,UAAU,MAAM,CAAC,IAAa,EAAE,GAAgB;IACnD,IAAI,MAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAS,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,MAAM,CAAC,CAAC,4DAA4D;IACzE,IAAI,CAAC;QAQH,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAyC,CAAC;QACjE,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QACtB,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC7B,OAAO,uBAAuB,CAC5B,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAC3C,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxD,OAAO,uBAAuB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;IACpE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,MAAM,IAAI,GAAe;IACvB,IAAI,EAAE,2BAA2B;IACjC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,4CAA4C;IACzD,cAAc,EAAE,2BAA2B;IAC3C,sEAAsE;IACtE,+DAA+D;IAC/D,YAAY,EAAE,IAAI;IAClB,WAAW;IACX,MAAM;CACP,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tools/foundation/catalog_attribute_filters_list.d.ts

@@ -0,0 +1,4 @@
+import { type ToolModule } from "../contract.js";
+declare const tool: ToolModule;
+export default tool;
+//# sourceMappingURL=catalog_attribute_filters_list.d.ts.map

package/dist/tools/foundation/catalog_attribute_filters_list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_attribute_filters_list.d.ts","sourceRoot":"","sources":["../../../src/tools/foundation/catalog_attribute_filters_list.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,gBAAgB,CAAC;AAuCxB,QAAA,MAAM,IAAI,EAAE,UAUX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tools/foundation/catalog_attribute_filters_list.js

@@ -0,0 +1,47 @@
+// =============================================================================
+// AUTO-GENERATED — DO NOT EDIT BY HAND.
+// Regenerate via: npm run regen-foundation-tools
+// Source: vendor/openapi.snapshot.json (W4 frozen).
+// =============================================================================
+// Tier: tier1  HTTP: GET /v1/catalog/attribute-filters
+import { z } from "zod";
+import { mapSdkErrorToToolResult, } from "../contract.js";
+const inputSchema = z.object({});
+async function handle(args, ctx) {
+    let parsed;
+    try {
+        parsed = inputSchema.parse(args);
+    }
+    catch (err) {
+        return mapSdkErrorToToolResult(err);
+    }
+    void parsed; // referenced below when the operation declares params/body.
+    try {
+        const raw = ctx.client.raw;
+        const fn = raw["GET"];
+        if (typeof fn !== "function") {
+            return mapSdkErrorToToolResult(new Error("SDK client missing method GET"));
+        }
+        const result = await fn("/v1/catalog/attribute-filters", {});
+        if (result.error !== undefined && result.error !== null) {
+            return mapSdkErrorToToolResult(result.error);
+        }
+        return { content: [{ type: "json", json: result.data ?? null }] };
+    }
+    catch (err) {
+        return mapSdkErrorToToolResult(err);
+    }
+}
+const tool = {
+    name: "catalog_attribute_filters_list",
+    kind: "foundation",
+    description: "Requires scope: catalog:attributes:read.",
+    required_scope: "catalog:attributes:read",
+    // HTTP verb → Claude UI annotation. GET → readOnlyHint; write verbs →
+    // destructiveHint. Enforced by test/tools/annotations.test.ts.
+    readOnlyHint: true,
+    inputSchema,
+    handle,
+};
+export default tool;
+//# sourceMappingURL=catalog_attribute_filters_list.js.map

package/dist/tools/foundation/catalog_attribute_filters_list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_attribute_filters_list.js","sourceRoot":"","sources":["../../../src/tools/foundation/catalog_attribute_filters_list.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wCAAwC;AACxC,iDAAiD;AACjD,oDAAoD;AACpD,gFAAgF;AAEhF,uDAAuD;AACvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,uBAAuB,GAIxB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAIjC,KAAK,UAAU,MAAM,CAAC,IAAa,EAAE,GAAgB;IACnD,IAAI,MAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAS,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,MAAM,CAAC,CAAC,4DAA4D;IACzE,IAAI,CAAC;QAQH,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAyC,CAAC;QACjE,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QACtB,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC7B,OAAO,uBAAuB,CAC5B,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAC3C,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAC;QAC7D,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxD,OAAO,uBAAuB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;IACpE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,MAAM,IAAI,GAAe;IACvB,IAAI,EAAE,gCAAgC;IACtC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,0CAA0C;IACvD,cAAc,EAAE,yBAAyB;IACzC,sEAAsE;IACtE,+DAA+D;IAC/D,YAAY,EAAE,IAAI;IAClB,WAAW;IACX,MAAM;CACP,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tools/foundation/catalog_attribute_tags_list.d.ts

@@ -0,0 +1,4 @@
+import { type ToolModule } from "../contract.js";
+declare const tool: ToolModule;
+export default tool;
+//# sourceMappingURL=catalog_attribute_tags_list.d.ts.map

package/dist/tools/foundation/catalog_attribute_tags_list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_attribute_tags_list.d.ts","sourceRoot":"","sources":["../../../src/tools/foundation/catalog_attribute_tags_list.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,gBAAgB,CAAC;AAuCxB,QAAA,MAAM,IAAI,EAAE,UAUX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tools/foundation/catalog_attribute_tags_list.js

@@ -0,0 +1,47 @@
+// =============================================================================
+// AUTO-GENERATED — DO NOT EDIT BY HAND.
+// Regenerate via: npm run regen-foundation-tools
+// Source: vendor/openapi.snapshot.json (W4 frozen).
+// =============================================================================
+// Tier: tier1  HTTP: GET /v1/catalog/attribute-tags
+import { z } from "zod";
+import { mapSdkErrorToToolResult, } from "../contract.js";
+const inputSchema = z.object({});
+async function handle(args, ctx) {
+    let parsed;
+    try {
+        parsed = inputSchema.parse(args);
+    }
+    catch (err) {
+        return mapSdkErrorToToolResult(err);
+    }
+    void parsed; // referenced below when the operation declares params/body.
+    try {
+        const raw = ctx.client.raw;
+        const fn = raw["GET"];
+        if (typeof fn !== "function") {
+            return mapSdkErrorToToolResult(new Error("SDK client missing method GET"));
+        }
+        const result = await fn("/v1/catalog/attribute-tags", {});
+        if (result.error !== undefined && result.error !== null) {
+            return mapSdkErrorToToolResult(result.error);
+        }
+        return { content: [{ type: "json", json: result.data ?? null }] };
+    }
+    catch (err) {
+        return mapSdkErrorToToolResult(err);
+    }
+}
+const tool = {
+    name: "catalog_attribute_tags_list",
+    kind: "foundation",
+    description: "Requires scope: catalog:attributes:read.",
+    required_scope: "catalog:attributes:read",
+    // HTTP verb → Claude UI annotation. GET → readOnlyHint; write verbs →
+    // destructiveHint. Enforced by test/tools/annotations.test.ts.
+    readOnlyHint: true,
+    inputSchema,
+    handle,
+};
+export default tool;
+//# sourceMappingURL=catalog_attribute_tags_list.js.map

package/dist/tools/foundation/catalog_attribute_tags_list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_attribute_tags_list.js","sourceRoot":"","sources":["../../../src/tools/foundation/catalog_attribute_tags_list.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wCAAwC;AACxC,iDAAiD;AACjD,oDAAoD;AACpD,gFAAgF;AAEhF,oDAAoD;AACpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,uBAAuB,GAIxB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAIjC,KAAK,UAAU,MAAM,CAAC,IAAa,EAAE,GAAgB;IACnD,IAAI,MAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAS,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,MAAM,CAAC,CAAC,4DAA4D;IACzE,IAAI,CAAC;QAQH,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAyC,CAAC;QACjE,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QACtB,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC7B,OAAO,uBAAuB,CAC5B,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAC3C,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxD,OAAO,uBAAuB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;IACpE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,MAAM,IAAI,GAAe;IACvB,IAAI,EAAE,6BAA6B;IACnC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,0CAA0C;IACvD,cAAc,EAAE,yBAAyB;IACzC,sEAAsE;IACtE,+DAA+D;IAC/D,YAAY,EAAE,IAAI;IAClB,WAAW;IACX,MAAM;CACP,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tools/foundation/catalog_attributes_list.d.ts

@@ -0,0 +1,4 @@
+import { type ToolModule } from "../contract.js";
+declare const tool: ToolModule;
+export default tool;
+//# sourceMappingURL=catalog_attributes_list.d.ts.map

package/dist/tools/foundation/catalog_attributes_list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_attributes_list.d.ts","sourceRoot":"","sources":["../../../src/tools/foundation/catalog_attributes_list.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,gBAAgB,CAAC;AAiDxB,QAAA,MAAM,IAAI,EAAE,UAUX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tools/foundation/catalog_attributes_list.js

@@ -0,0 +1,57 @@
+// =============================================================================
+// AUTO-GENERATED — DO NOT EDIT BY HAND.
+// Regenerate via: npm run regen-foundation-tools
+// Source: vendor/openapi.snapshot.json (W4 frozen).
+// =============================================================================
+// Tier: tier1  HTTP: GET /v1/catalog/attributes
+import { z } from "zod";
+import { mapSdkErrorToToolResult, } from "../contract.js";
+const inputSchema = z.object({
+    query: z.object({
+        limit: z.number().int().optional(),
+        starting_after: z.string().optional()
+    }).optional()
+});
+async function handle(args, ctx) {
+    let parsed;
+    try {
+        parsed = inputSchema.parse(args);
+    }
+    catch (err) {
+        return mapSdkErrorToToolResult(err);
+    }
+    void parsed; // referenced below when the operation declares params/body.
+    try {
+        const requestParams = {
+            query: parsed.query,
+        };
+        const raw = ctx.client.raw;
+        const fn = raw["GET"];
+        if (typeof fn !== "function") {
+            return mapSdkErrorToToolResult(new Error("SDK client missing method GET"));
+        }
+        const result = await fn("/v1/catalog/attributes", {
+            params: requestParams,
+        });
+        if (result.error !== undefined && result.error !== null) {
+            return mapSdkErrorToToolResult(result.error);
+        }
+        return { content: [{ type: "json", json: result.data ?? null }] };
+    }
+    catch (err) {
+        return mapSdkErrorToToolResult(err);
+    }
+}
+const tool = {
+    name: "catalog_attributes_list",
+    kind: "foundation",
+    description: "Requires scope: catalog:attributes:read.",
+    required_scope: "catalog:attributes:read",
+    // HTTP verb → Claude UI annotation. GET → readOnlyHint; write verbs →
+    // destructiveHint. Enforced by test/tools/annotations.test.ts.
+    readOnlyHint: true,
+    inputSchema,
+    handle,
+};
+export default tool;
+//# sourceMappingURL=catalog_attributes_list.js.map

package/dist/tools/foundation/catalog_attributes_list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_attributes_list.js","sourceRoot":"","sources":["../../../src/tools/foundation/catalog_attributes_list.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wCAAwC;AACxC,iDAAiD;AACjD,oDAAoD;AACpD,gFAAgF;AAEhF,gDAAgD;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,uBAAuB,GAIxB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;QAClC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACtC,CAAC,CAAC,QAAQ,EAAE;CACZ,CAAC,CAAC;AAIH,KAAK,UAAU,MAAM,CAAC,IAAa,EAAE,GAAgB;IACnD,IAAI,MAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAS,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,MAAM,CAAC,CAAC,4DAA4D;IACzE,IAAI,CAAC;QACL,MAAM,aAAa,GAAG;YACpB,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC;QAQA,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAyC,CAAC;QACjE,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QACtB,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC7B,OAAO,uBAAuB,CAC5B,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAC3C,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,wBAAwB,EAAE;YAClD,MAAM,EAAE,aAAa;SACtB,CAAC,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxD,OAAO,uBAAuB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;IACpE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,MAAM,IAAI,GAAe;IACvB,IAAI,EAAE,yBAAyB;IAC/B,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,0CAA0C;IACvD,cAAc,EAAE,yBAAyB;IACzC,sEAAsE;IACtE,+DAA+D;IAC/D,YAAY,EAAE,IAAI;IAClB,WAAW;IACX,MAAM;CACP,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tools/foundation/catalog_column_views_default_list.d.ts

@@ -0,0 +1,4 @@
+import { type ToolModule } from "../contract.js";
+declare const tool: ToolModule;
+export default tool;
+//# sourceMappingURL=catalog_column_views_default_list.d.ts.map

package/dist/tools/foundation/catalog_column_views_default_list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_column_views_default_list.d.ts","sourceRoot":"","sources":["../../../src/tools/foundation/catalog_column_views_default_list.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,gBAAgB,CAAC;AAuCxB,QAAA,MAAM,IAAI,EAAE,UAUX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tools/foundation/catalog_column_views_default_list.js

@@ -0,0 +1,47 @@
+// =============================================================================
+// AUTO-GENERATED — DO NOT EDIT BY HAND.
+// Regenerate via: npm run regen-foundation-tools
+// Source: vendor/openapi.snapshot.json (W4 frozen).
+// =============================================================================
+// Tier: tier1  HTTP: GET /v1/catalog/column-views/default
+import { z } from "zod";
+import { mapSdkErrorToToolResult, } from "../contract.js";
+const inputSchema = z.object({});
+async function handle(args, ctx) {
+    let parsed;
+    try {
+        parsed = inputSchema.parse(args);
+    }
+    catch (err) {
+        return mapSdkErrorToToolResult(err);
+    }
+    void parsed; // referenced below when the operation declares params/body.
+    try {
+        const raw = ctx.client.raw;
+        const fn = raw["GET"];
+        if (typeof fn !== "function") {
+            return mapSdkErrorToToolResult(new Error("SDK client missing method GET"));
+        }
+        const result = await fn("/v1/catalog/column-views/default", {});
+        if (result.error !== undefined && result.error !== null) {
+            return mapSdkErrorToToolResult(result.error);
+        }
+        return { content: [{ type: "json", json: result.data ?? null }] };
+    }
+    catch (err) {
+        return mapSdkErrorToToolResult(err);
+    }
+}
+const tool = {
+    name: "catalog_column_views_default_list",
+    kind: "foundation",
+    description: "Requires scope: catalog:column_views:read.",
+    required_scope: "catalog:column_views:read",
+    // HTTP verb → Claude UI annotation. GET → readOnlyHint; write verbs →
+    // destructiveHint. Enforced by test/tools/annotations.test.ts.
+    readOnlyHint: true,
+    inputSchema,
+    handle,
+};
+export default tool;
+//# sourceMappingURL=catalog_column_views_default_list.js.map

package/dist/tools/foundation/catalog_column_views_default_list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_column_views_default_list.js","sourceRoot":"","sources":["../../../src/tools/foundation/catalog_column_views_default_list.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wCAAwC;AACxC,iDAAiD;AACjD,oDAAoD;AACpD,gFAAgF;AAEhF,0DAA0D;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,uBAAuB,GAIxB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAIjC,KAAK,UAAU,MAAM,CAAC,IAAa,EAAE,GAAgB;IACnD,IAAI,MAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAS,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,MAAM,CAAC,CAAC,4DAA4D;IACzE,IAAI,CAAC;QAQH,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAyC,CAAC;QACjE,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QACtB,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC7B,OAAO,uBAAuB,CAC5B,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAC3C,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,kCAAkC,EAAE,EAAE,CAAC,CAAC;QAChE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxD,OAAO,uBAAuB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;IACpE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,MAAM,IAAI,GAAe;IACvB,IAAI,EAAE,mCAAmC;IACzC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,4CAA4C;IACzD,cAAc,EAAE,2BAA2B;IAC3C,sEAAsE;IACtE,+DAA+D;IAC/D,YAAY,EAAE,IAAI;IAClB,WAAW;IACX,MAAM;CACP,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tools/foundation/catalog_column_views_list.d.ts

@@ -0,0 +1,4 @@
+import { type ToolModule } from "../contract.js";
+declare const tool: ToolModule;
+export default tool;
+//# sourceMappingURL=catalog_column_views_list.d.ts.map

package/dist/tools/foundation/catalog_column_views_list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_column_views_list.d.ts","sourceRoot":"","sources":["../../../src/tools/foundation/catalog_column_views_list.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,gBAAgB,CAAC;AAuCxB,QAAA,MAAM,IAAI,EAAE,UAUX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tools/foundation/catalog_column_views_list.js

@@ -0,0 +1,47 @@
+// =============================================================================
+// AUTO-GENERATED — DO NOT EDIT BY HAND.
+// Regenerate via: npm run regen-foundation-tools
+// Source: vendor/openapi.snapshot.json (W4 frozen).
+// =============================================================================
+// Tier: tier1  HTTP: GET /v1/catalog/column-views
+import { z } from "zod";
+import { mapSdkErrorToToolResult, } from "../contract.js";
+const inputSchema = z.object({});
+async function handle(args, ctx) {
+    let parsed;
+    try {
+        parsed = inputSchema.parse(args);
+    }
+    catch (err) {
+        return mapSdkErrorToToolResult(err);
+    }
+    void parsed; // referenced below when the operation declares params/body.
+    try {
+        const raw = ctx.client.raw;
+        const fn = raw["GET"];
+        if (typeof fn !== "function") {
+            return mapSdkErrorToToolResult(new Error("SDK client missing method GET"));
+        }
+        const result = await fn("/v1/catalog/column-views", {});
+        if (result.error !== undefined && result.error !== null) {
+            return mapSdkErrorToToolResult(result.error);
+        }
+        return { content: [{ type: "json", json: result.data ?? null }] };
+    }
+    catch (err) {
+        return mapSdkErrorToToolResult(err);
+    }
+}
+const tool = {
+    name: "catalog_column_views_list",
+    kind: "foundation",
+    description: "Requires scope: catalog:column_views:read.",
+    required_scope: "catalog:column_views:read",
+    // HTTP verb → Claude UI annotation. GET → readOnlyHint; write verbs →
+    // destructiveHint. Enforced by test/tools/annotations.test.ts.
+    readOnlyHint: true,
+    inputSchema,
+    handle,
+};
+export default tool;
+//# sourceMappingURL=catalog_column_views_list.js.map

package/dist/tools/foundation/catalog_column_views_list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_column_views_list.js","sourceRoot":"","sources":["../../../src/tools/foundation/catalog_column_views_list.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wCAAwC;AACxC,iDAAiD;AACjD,oDAAoD;AACpD,gFAAgF;AAEhF,kDAAkD;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,uBAAuB,GAIxB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAIjC,KAAK,UAAU,MAAM,CAAC,IAAa,EAAE,GAAgB;IACnD,IAAI,MAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAS,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,MAAM,CAAC,CAAC,4DAA4D;IACzE,IAAI,CAAC;QAQH,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAyC,CAAC;QACjE,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QACtB,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC7B,OAAO,uBAAuB,CAC5B,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAC3C,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxD,OAAO,uBAAuB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;IACpE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,MAAM,IAAI,GAAe;IACvB,IAAI,EAAE,2BAA2B;IACjC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,4CAA4C;IACzD,cAAc,EAAE,2BAA2B;IAC3C,sEAAsE;IACtE,+DAA+D;IAC/D,YAAY,EAAE,IAAI;IAClB,WAAW;IACX,MAAM;CACP,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tools/foundation/catalog_ebay_categories_list.d.ts

@@ -0,0 +1,4 @@
+import { type ToolModule } from "../contract.js";
+declare const tool: ToolModule;
+export default tool;
+//# sourceMappingURL=catalog_ebay_categories_list.d.ts.map

package/dist/tools/foundation/catalog_ebay_categories_list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_ebay_categories_list.d.ts","sourceRoot":"","sources":["../../../src/tools/foundation/catalog_ebay_categories_list.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,gBAAgB,CAAC;AAgDxB,QAAA,MAAM,IAAI,EAAE,UAUX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tools/foundation/catalog_ebay_categories_list.js

@@ -0,0 +1,56 @@
+// =============================================================================
+// AUTO-GENERATED — DO NOT EDIT BY HAND.
+// Regenerate via: npm run regen-foundation-tools
+// Source: vendor/openapi.snapshot.json (W4 frozen).
+// =============================================================================
+// Tier: tier1  HTTP: GET /v1/catalog/ebay-categories
+import { z } from "zod";
+import { mapSdkErrorToToolResult, } from "../contract.js";
+const inputSchema = z.object({
+    query: z.object({
+        parent_category_id: z.number().int().optional()
+    }).optional()
+});
+async function handle(args, ctx) {
+    let parsed;
+    try {
+        parsed = inputSchema.parse(args);
+    }
+    catch (err) {
+        return mapSdkErrorToToolResult(err);
+    }
+    void parsed; // referenced below when the operation declares params/body.
+    try {
+        const requestParams = {
+            query: parsed.query,
+        };
+        const raw = ctx.client.raw;
+        const fn = raw["GET"];
+        if (typeof fn !== "function") {
+            return mapSdkErrorToToolResult(new Error("SDK client missing method GET"));
+        }
+        const result = await fn("/v1/catalog/ebay-categories", {
+            params: requestParams,
+        });
+        if (result.error !== undefined && result.error !== null) {
+            return mapSdkErrorToToolResult(result.error);
+        }
+        return { content: [{ type: "json", json: result.data ?? null }] };
+    }
+    catch (err) {
+        return mapSdkErrorToToolResult(err);
+    }
+}
+const tool = {
+    name: "catalog_ebay_categories_list",
+    kind: "foundation",
+    description: "Requires scope: catalog:ebay_listings:read.",
+    required_scope: "catalog:ebay_listings:read",
+    // HTTP verb → Claude UI annotation. GET → readOnlyHint; write verbs →
+    // destructiveHint. Enforced by test/tools/annotations.test.ts.
+    readOnlyHint: true,
+    inputSchema,
+    handle,
+};
+export default tool;
+//# sourceMappingURL=catalog_ebay_categories_list.js.map

package/dist/tools/foundation/catalog_ebay_categories_list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_ebay_categories_list.js","sourceRoot":"","sources":["../../../src/tools/foundation/catalog_ebay_categories_list.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wCAAwC;AACxC,iDAAiD;AACjD,oDAAoD;AACpD,gFAAgF;AAEhF,qDAAqD;AACrD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,uBAAuB,GAIxB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;KAChD,CAAC,CAAC,QAAQ,EAAE;CACZ,CAAC,CAAC;AAIH,KAAK,UAAU,MAAM,CAAC,IAAa,EAAE,GAAgB;IACnD,IAAI,MAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAS,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,KAAK,MAAM,CAAC,CAAC,4DAA4D;IACzE,IAAI,CAAC;QACL,MAAM,aAAa,GAAG;YACpB,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC;QAQA,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,GAAyC,CAAC;QACjE,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QACtB,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC7B,OAAO,uBAAuB,CAC5B,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAC3C,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,6BAA6B,EAAE;YACvD,MAAM,EAAE,aAAa;SACtB,CAAC,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACxD,OAAO,uBAAuB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;IACpE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,uBAAuB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,MAAM,IAAI,GAAe;IACvB,IAAI,EAAE,8BAA8B;IACpC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,6CAA6C;IAC1D,cAAc,EAAE,4BAA4B;IAC5C,sEAAsE;IACtE,+DAA+D;IAC/D,YAAY,EAAE,IAAI;IAClB,WAAW;IACX,MAAM;CACP,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tools/foundation/catalog_ebay_category_specifics_list.d.ts

@@ -0,0 +1,4 @@
+import { type ToolModule } from "../contract.js";
+declare const tool: ToolModule;
+export default tool;
+//# sourceMappingURL=catalog_ebay_category_specifics_list.d.ts.map

package/dist/tools/foundation/catalog_ebay_category_specifics_list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_ebay_category_specifics_list.d.ts","sourceRoot":"","sources":["../../../src/tools/foundation/catalog_ebay_category_specifics_list.ts"],"names":[],"mappings":"AASA,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,gBAAgB,CAAC;AAgDxB,QAAA,MAAM,IAAI,EAAE,UAUX,CAAC;AAEF,eAAe,IAAI,CAAC"}

package/dist/tools/foundation/catalog_ebay_category_specifics_list.js

@@ -0,0 +1,56 @@
+// =============================================================================
+// AUTO-GENERATED — DO NOT EDIT BY HAND.
+// Regenerate via: npm run regen-foundation-tools
+// Source: vendor/openapi.snapshot.json (W4 frozen).
+// =============================================================================
+// Tier: tier1  HTTP: GET /v1/catalog/ebay-category-specifics
+import { z } from "zod";
+import { mapSdkErrorToToolResult, } from "../contract.js";
+const inputSchema = z.object({
+    query: z.object({
+        category_id: z.number().int().optional()
+    }).optional()
+});
+async function handle(args, ctx) {
+    let parsed;
+    try {
+        parsed = inputSchema.parse(args);
+    }
+    catch (err) {
+        return mapSdkErrorToToolResult(err);
+    }
+    void parsed; // referenced below when the operation declares params/body.
+    try {
+        const requestParams = {
+            query: parsed.query,
+        };
+        const raw = ctx.client.raw;
+        const fn = raw["GET"];
+        if (typeof fn !== "function") {
+            return mapSdkErrorToToolResult(new Error("SDK client missing method GET"));
+        }
+        const result = await fn("/v1/catalog/ebay-category-specifics", {
+            params: requestParams,
+        });
+        if (result.error !== undefined && result.error !== null) {
+            return mapSdkErrorToToolResult(result.error);
+        }
+        return { content: [{ type: "json", json: result.data ?? null }] };
+    }
+    catch (err) {
+        return mapSdkErrorToToolResult(err);
+    }
+}
+const tool = {
+    name: "catalog_ebay_category_specifics_list",
+    kind: "foundation",
+    description: "Requires scope: catalog:ebay_attributes:read.",
+    required_scope: "catalog:ebay_attributes:read",
+    // HTTP verb → Claude UI annotation. GET → readOnlyHint; write verbs →
+    // destructiveHint. Enforced by test/tools/annotations.test.ts.
+    readOnlyHint: true,
+    inputSchema,
+    handle,
+};
+export default tool;
+//# sourceMappingURL=catalog_ebay_category_specifics_list.js.map