@ttctl/mcp 0.0.0 → 0.1.0-rc.1

package/dist/tools/output-schemas.js

@@ -0,0 +1,130 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { z } from "zod";
+/**
+ * MCP `outputSchema` definitions for the top-10 write-capable tools
+ * (#226). Each schema mirrors the TypeScript return type from
+ * `@ttctl/core` so LLM clients reading the tool registry can validate
+ * the structured payload they receive.
+ *
+ * Each schema describes the SUCCESS-path payload only. Dry-run responses
+ * use the uniform `{ ok, dryRun, preview }` envelope advertised via the
+ * tool description (see `_shared.ts` § `dryRunResponse`) and intentionally
+ * carry NO `structuredContent` — the SDK skips `outputSchema` validation
+ * when `structuredContent` is absent (per `@modelcontextprotocol/sdk`
+ * `_validateOutput`), so dry-run paths bypass success-shape validation
+ * cleanly.
+ *
+ * The MCP SDK's `normalizeObjectSchema` accepts only ZodObject shapes for
+ * `outputSchema`; unions and discriminated unions are silently dropped.
+ * Therefore each schema below is a single `z.object()` describing the
+ * apply-path payload — sufficient for the AC ("LLM clients can validate
+ * tool output against the schema").
+ */
+/**
+ * Shape returned by `profile.basic.set()` on the apply path —
+ * mirrors `UpdateProfileResult` from `@ttctl/core`.
+ */
+export const profileBasicUpdateOutputSchema = z.object({
+    profile: z.object({
+        id: z.string(),
+        about: z.string().nullable(),
+        quote: z.string().nullable(),
+    }),
+    notice: z.string().nullable(),
+});
+/**
+ * Shape returned by `profile.basic.photoUpload()` — mirrors `PhotoUrl`
+ * from `@ttctl/core`.
+ */
+export const profileBasicPhotoUploadOutputSchema = z.object({
+    default: z.string().nullable(),
+    original: z.string().nullable(),
+    small: z.string().nullable(),
+    cropped: z
+        .object({
+        x: z.number(),
+        y: z.number(),
+        width: z.number(),
+        height: z.number(),
+    })
+        .nullable(),
+    isResolutionSatisfied: z.boolean(),
+});
+/**
+ * Shape returned by `profile.resume.upload()` — mirrors
+ * `UploadResumeResult` from `@ttctl/core`.
+ */
+export const profileResumeUploadOutputSchema = z.object({
+    success: z.boolean(),
+});
+/**
+ * Shape returned by `profile.education.add()` / `update()` — mirrors
+ * `Education` from `@ttctl/core`.
+ */
+export const profileEducationRowOutputSchema = z.object({
+    id: z.string(),
+    institution: z.string(),
+    degree: z.string(),
+    fieldOfStudy: z.string().nullable(),
+    location: z.string().nullable(),
+    title: z.string().nullable(),
+    yearFrom: z.number().nullable(),
+    yearTo: z.number().nullable(),
+    highlight: z.boolean(),
+});
+/**
+ * Shape returned by the `*_remove` tools' structured-content slot —
+ * `{ id, removed: true }`. The `text` content slot retains the
+ * human-readable confirmation; `structuredContent` exposes a typed
+ * acknowledgment.
+ */
+export const profileRowRemoveOutputSchema = z.object({
+    id: z.string(),
+    removed: z.literal(true),
+});
+/**
+ * Shape returned by `profile.employment.add()` / `update()` — mirrors
+ * `Employment` from `@ttctl/core`.
+ */
+export const profileEmploymentRowOutputSchema = z.object({
+    id: z.string(),
+    company: z.string(),
+    position: z.string(),
+    companyWebsite: z.string().nullable(),
+    noWebsite: z.boolean(),
+    startDate: z.number().nullable(),
+    endDate: z.number().nullable(),
+    experienceItems: z.array(z.string()).nullable(),
+    highlight: z.boolean(),
+    showViaToptal: z.boolean(),
+    toptalRelated: z.boolean(),
+});
+/**
+ * Shape returned by `profile.industries.update()` — mirrors
+ * `IndustryProfile` from `@ttctl/core`.
+ */
+export const profileIndustriesRowOutputSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    about: z.string().nullable(),
+    domainArea: z.string().nullable(),
+});
+/**
+ * Tool names (frozen) that the test suite asserts must carry a populated
+ * `outputSchema`. Adding a new write-capable tool: append its name here
+ * and define the schema above.
+ */
+export const TOOLS_WITH_OUTPUT_SCHEMA = [
+    "ttctl_profile_basic_update",
+    "ttctl_profile_basic_photo_upload",
+    "ttctl_profile_resume_upload",
+    "ttctl_profile_education_add",
+    "ttctl_profile_education_update",
+    "ttctl_profile_education_remove",
+    "ttctl_profile_employment_add",
+    "ttctl_profile_employment_update",
+    "ttctl_profile_employment_remove",
+    "ttctl_profile_industries_update",
+];
+//# sourceMappingURL=output-schemas.js.map

package/dist/tools/output-schemas.js.map

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

package/dist/tools/payments.d.ts

@@ -0,0 +1,36 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "./_shared.js";
+/**
+ * Register the `ttctl_payments_*` MCP tools (#149). 7 tools across 3
+ * sub-namespaces:
+ *
+ *   - `ttctl_payments_payouts_list`
+ *   - `ttctl_payments_payouts_show`
+ *   - `ttctl_payments_methods_list`
+ *   - `ttctl_payments_methods_show`
+ *   - `ttctl_payments_rate_show`
+ *   - `ttctl_payments_rate_questions`
+ *   - `ttctl_payments_rate_change`
+ *
+ * Each tool maps 1:1 to a CLI leaf. The `<id>` argument is the
+ * `TalentPayment.id` for payouts, `PaymentOption.id` for methods.
+ *
+ * **Scope refinements** (per #149 comment 4441685270, post-investigation):
+ *   - Original `rate-change list` (no list endpoint exists) → replaced
+ *     with `rate_show` (unified projection) + `rate_questions`
+ *     (form discovery).
+ *   - Original `rate-change request` (2 of 5 mutation inputs) →
+ *     replaced with full `rate_change` (kind, rate, optional
+ *     engagement, comment, answers[]).
+ *
+ * **Dry-run path** (issue #165): every tool accepts `dryRun?: boolean`.
+ * Read-only tools build the preview at the MCP layer via
+ * `buildMcpDryRunPreview`; `rate_change` passes through to the
+ * core's `dryRun` option (mutation supports it natively).
+ *
+ * **Per CLAUDE.md schema/contract validation rule**: every payment
+ * operation is hand-authored (no codegen types) → mandatory live E2E
+ * coverage before merge. See `packages/e2e/src/3*-payments-*.e2e.test.ts`.
+ */
+export declare function registerPaymentsTools(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=payments.d.ts.map

package/dist/tools/payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../../src/tools/payments.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,OAAO,EAAyC,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AASnG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CA0S3F"}

package/dist/tools/payments.js

@@ -0,0 +1,373 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { payments } from "@ttctl/core";
+import { z } from "zod";
+import { ttctlErrorToToolResponseOrNull } from "../errors.js";
+import { buildMcpDryRunPreview, dryRunResponse } from "./_shared.js";
+const DRY_RUN_FIELD = z
+    .boolean()
+    .optional()
+    .describe("Preview the request without executing. Returns `{ ok: true, dryRun: true, preview }` with operationName + variables + redacted bearer header. Default: false.");
+/**
+ * Register the `ttctl_payments_*` MCP tools (#149). 7 tools across 3
+ * sub-namespaces:
+ *
+ *   - `ttctl_payments_payouts_list`
+ *   - `ttctl_payments_payouts_show`
+ *   - `ttctl_payments_methods_list`
+ *   - `ttctl_payments_methods_show`
+ *   - `ttctl_payments_rate_show`
+ *   - `ttctl_payments_rate_questions`
+ *   - `ttctl_payments_rate_change`
+ *
+ * Each tool maps 1:1 to a CLI leaf. The `<id>` argument is the
+ * `TalentPayment.id` for payouts, `PaymentOption.id` for methods.
+ *
+ * **Scope refinements** (per #149 comment 4441685270, post-investigation):
+ *   - Original `rate-change list` (no list endpoint exists) → replaced
+ *     with `rate_show` (unified projection) + `rate_questions`
+ *     (form discovery).
+ *   - Original `rate-change request` (2 of 5 mutation inputs) →
+ *     replaced with full `rate_change` (kind, rate, optional
+ *     engagement, comment, answers[]).
+ *
+ * **Dry-run path** (issue #165): every tool accepts `dryRun?: boolean`.
+ * Read-only tools build the preview at the MCP layer via
+ * `buildMcpDryRunPreview`; `rate_change` passes through to the
+ * core's `dryRun` option (mutation supports it natively).
+ *
+ * **Per CLAUDE.md schema/contract validation rule**: every payment
+ * operation is hand-authored (no codegen types) → mandatory live E2E
+ * coverage before merge. See `packages/e2e/src/3*-payments-*.e2e.test.ts`.
+ */
+export function registerPaymentsTools(server, ctx) {
+    server.registerTool("ttctl_payments_payouts_list", {
+        title: "List historical payouts",
+        description: [
+            "List the signed-in user's historical Toptal payouts.",
+            "A payout is a `TalentPayment` record carrying the billing-cycle amount,",
+            "status (PAID / DUE / OUTSTANDING / OVERDUE / ON_HOLD / DISPUTED), and",
+            "memorandum adjustments.",
+            "",
+            "Optional `fromDate` / `toDate` (YYYY-MM-DD, inclusive) filter by",
+            "`createdOn`. The server returns at most 20 records per call.",
+            "",
+            "Example user prompts:",
+            '  - "Show me my recent Toptal payouts."',
+            '  - "List payouts from January 2026."',
+        ].join("\n"),
+        inputSchema: {
+            fromDate: z.string().optional().describe("Filter lower bound (YYYY-MM-DD, inclusive)"),
+            toDate: z.string().optional().describe("Filter upper bound (YYYY-MM-DD, inclusive)"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        const opts = {};
+        if (args.fromDate !== undefined)
+            opts.fromDate = args.fromDate;
+        if (args.toDate !== undefined)
+            opts.toDate = args.toDate;
+        if (args.dryRun === true) {
+            const hasFilter = opts.fromDate !== undefined || opts.toDate !== undefined;
+            const variables = {
+                filters: hasFilter ? { createdOn: { from: opts.fromDate ?? null, to: opts.toDate ?? null } } : null,
+            };
+            return dryRunResponse(buildMcpDryRunPreview("Payments", "mobile-gateway", variables, auth.token));
+        }
+        try {
+            const result = await payments.payouts.list(auth.token, opts);
+            return successResponse(result);
+        }
+        catch (err) {
+            return mapPaymentsError(err);
+        }
+    });
+    server.registerTool("ttctl_payments_payouts_show", {
+        title: "Show one payout",
+        description: [
+            "Fetch one payout's full detail by `TalentPayment.id` (the row id from",
+            "`ttctl_payments_payouts_list`).",
+            "",
+            "Example user prompts:",
+            '  - "Show payout pmt_xyz."',
+            '  - "What is the amount of my Toptal payout pmt_abc?"',
+        ].join("\n"),
+        inputSchema: {
+            id: z.string().describe("Payout id (TalentPayment.id from `payments_payouts_list`)"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("Payment", "mobile-gateway", { id: args.id }, auth.token));
+        }
+        try {
+            const item = await payments.payouts.show(auth.token, args.id);
+            return successResponse(item);
+        }
+        catch (err) {
+            return mapPaymentsError(err);
+        }
+    });
+    server.registerTool("ttctl_payments_methods_list", {
+        title: "List configured payment methods",
+        description: [
+            "List the talent's configured Toptal payment methods (Payoneer / wire /",
+            "Toptal Payments / etc.). The preferred method is marked",
+            "`preferredOption: true`.",
+            "",
+            "Read-only — adding / removing / changing preferred method is out of scope",
+            "for v1 (the Toptal admin flow lives in the web portal).",
+            "",
+            "Example user prompts:",
+            '  - "What payment methods are configured on my Toptal account?"',
+            '  - "Which is my preferred Toptal payment method?"',
+        ].join("\n"),
+        inputSchema: { dryRun: DRY_RUN_FIELD },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("PaymentOptions", "mobile-gateway", {}, auth.token));
+        }
+        try {
+            const items = await payments.methods.list(auth.token);
+            return successResponse(items);
+        }
+        catch (err) {
+            return mapPaymentsError(err);
+        }
+    });
+    server.registerTool("ttctl_payments_methods_show", {
+        title: "Show one payment method",
+        description: [
+            "Fetch one payment method's detail by id. No per-id wire op exists; the",
+            "tool fetches the full list and filters locally.",
+            "",
+            "Dry-run note: the underlying preview is for `PaymentOptions` (the list",
+            "query), since the per-method filter is a client-side operation.",
+        ].join("\n"),
+        inputSchema: {
+            id: z.string().describe("Payment method id (PaymentOption.id from `payments_methods_list`)"),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("PaymentOptions", "mobile-gateway", {}, auth.token));
+        }
+        try {
+            const item = await payments.methods.show(auth.token, args.id);
+            return successResponse(item);
+        }
+        catch (err) {
+            return mapPaymentsError(err);
+        }
+    });
+    server.registerTool("ttctl_payments_rate_show", {
+        title: "Show current rate + rate-change status",
+        description: [
+            "Show the talent's current default hourly rate, market insight",
+            "(competitiveness, recommended rate), validation rules (min rate, rate",
+            "step), and the most-recent or in-flight rate-change request.",
+            "",
+            "Unified projection — issues 2 parallel queries (`LastRateChangeRequest`",
+            "+ `RateChangeFormDetails`) and composes the result.",
+            "",
+            "Example user prompts:",
+            '  - "What is my current Toptal rate?"',
+            '  - "Show me the status of my rate-change request."',
+            '  - "What is the minimum hourly rate I can request?"',
+        ].join("\n"),
+        inputSchema: { dryRun: DRY_RUN_FIELD },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            // 2 parallel queries — surface both previews.
+            const previews = [
+                buildMcpDryRunPreview("LastRateChangeRequest", "mobile-gateway", {}, auth.token),
+                buildMcpDryRunPreview("RateChangeFormDetails", "mobile-gateway", {}, auth.token),
+            ];
+            return {
+                content: [{ type: "text", text: JSON.stringify({ ok: true, dryRun: true, previews }, null, 2) }],
+            };
+        }
+        try {
+            const proj = await payments.rate.show(auth.token);
+            return successResponse(proj);
+        }
+        catch (err) {
+            return mapPaymentsError(err);
+        }
+    });
+    server.registerTool("ttctl_payments_rate_questions", {
+        title: "List rate-change form questions",
+        description: [
+            "List the form questions the user must answer when submitting a",
+            "rate-change request. Discovery sub-command — call this BEFORE",
+            "`ttctl_payments_rate_change` to learn the required `answers[]` shape.",
+            "",
+            "Each question returns `{id, kind: 'RADIO'|'TEXT', label, options[]}`.",
+            "`RADIO` kind: pick `value` from `options[].label`. `TEXT` kind: free-text.",
+            "An option may set `commentRequired: true` — when chosen, pass an",
+            "accompanying answer comment.",
+            "",
+            "Example user prompts:",
+            '  - "What questions do I need to answer for a Toptal rate change?"',
+        ].join("\n"),
+        inputSchema: { dryRun: DRY_RUN_FIELD },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        if (args.dryRun === true) {
+            return dryRunResponse(buildMcpDryRunPreview("RateChangeRequestQuestions", "mobile-gateway", {}, auth.token));
+        }
+        try {
+            const items = await payments.rate.questions(auth.token);
+            return successResponse(items);
+        }
+        catch (err) {
+            return mapPaymentsError(err);
+        }
+    });
+    server.registerTool("ttctl_payments_rate_change", {
+        title: "Submit a rate-change request",
+        description: [
+            "Submit a rate-change request on the talent's Toptal account.",
+            "",
+            "Required:",
+            "  - `kind`: one of `current-engagement`, `future-engagements`,",
+            "    `consultation`.",
+            "  - `desiredRate`: target hourly rate as a decimal string (e.g.",
+            '    `"95.0"`).',
+            "  - `answers`: array of `{questionId, value, comment?}` — fetch the",
+            "    catalog via `ttctl_payments_rate_questions` and answer each.",
+            "",
+            "Conditional:",
+            "  - `engagementId`: REQUIRED for `kind: current-engagement`; rejected",
+            "    for the other two kinds (those are account-wide).",
+            "",
+            "Optional:",
+            "  - `talentComment`: free-text comment attached to the request.",
+            "",
+            "**This is a write operation**: it submits a rate-change request to",
+            "Toptal's compliance flow. The request enters a PENDING / CLAIMED",
+            "lifecycle; the server reviews and may approve, modify, or reject.",
+            "Confirm with the user before invoking.",
+            "",
+            "Example user prompts:",
+            '  - "Submit a rate-change request to $95/hr on engagement act_xyz."',
+            '  - "Raise my default Toptal rate to $100/hr."',
+        ].join("\n"),
+        inputSchema: {
+            kind: z
+                .enum([...payments.RATE_CHANGE_KINDS])
+                .describe("Rate-change kind: current-engagement / future-engagements / consultation"),
+            desiredRate: z.string().describe('Target hourly rate as a decimal string (e.g. "95.0")'),
+            engagementId: z
+                .string()
+                .optional()
+                .describe("Engagement id (required for kind=current-engagement; rejected otherwise)"),
+            talentComment: z.string().optional().describe("Optional free-text comment attached to the request"),
+            answers: z
+                .array(z.object({
+                questionId: z.string(),
+                value: z.string(),
+                comment: z.string().optional(),
+            }))
+                .describe("Answers to the form questions returned by `ttctl_payments_rate_questions`. Each entry: {questionId, value, comment?}."),
+            dryRun: DRY_RUN_FIELD,
+        },
+    }, async (args) => {
+        const auth = await ctx.resolveToolAuth();
+        if (!auth.ok)
+            return auth.response;
+        try {
+            const opts = {
+                kind: args.kind,
+                desiredRate: args.desiredRate,
+                answers: args.answers.map((a) => {
+                    const entry = { questionId: a.questionId, value: a.value };
+                    if (a.comment !== undefined)
+                        entry.comment = a.comment;
+                    return entry;
+                }),
+            };
+            if (args.engagementId !== undefined)
+                opts.engagementId = args.engagementId;
+            if (args.talentComment !== undefined)
+                opts.talentComment = args.talentComment;
+            const outcome = await payments.rate.change(auth.token, opts, { dryRun: args.dryRun ?? false });
+            if (outcome.kind === "preview")
+                return dryRunResponse(outcome.preview);
+            return successResponse({
+                result: outcome.result,
+                notice: outcome.notice,
+            });
+        }
+        catch (err) {
+            return mapPaymentsError(err);
+        }
+    });
+}
+function successResponse(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+function mapPaymentsError(err) {
+    const typed = ttctlErrorToToolResponseOrNull(err);
+    if (typed !== null)
+        return typed;
+    if (err instanceof payments.PaymentsError) {
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: [`Error: ${err.message}`, "", recoveryForCode(err.code), "", `(Code: ${err.code})`].join("\n"),
+                },
+            ],
+        };
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        isError: true,
+        content: [
+            {
+                type: "text",
+                text: [
+                    `Error: payments request failed: ${message}`,
+                    "",
+                    "Recovery: Retry; if the failure persists, file an issue.",
+                    "",
+                    "(Code: UNKNOWN)",
+                ].join("\n"),
+            },
+        ],
+    };
+}
+function recoveryForCode(code) {
+    switch (code) {
+        case "NOT_FOUND":
+            return "Recovery: Verify the id (use `ttctl_payments_payouts_list` or `ttctl_payments_methods_list` to discover ids).";
+        case "MISSING_INPUT":
+            return "Recovery: Adjust the input per the description and re-run.";
+        case "MUTATION_ERROR":
+            return "Recovery: The mutation was rejected by the server (often: rate below minRate, missing answers, ineligibility). Check the message above; try `ttctl_payments_rate_questions` for the form catalog.";
+        default:
+            return "Recovery: Adjust the tool input or retry; see the code below.";
+    }
+}
+//# sourceMappingURL=payments.js.map

package/dist/tools/payments.js.map

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

package/dist/tools/profile/certifications.d.ts

@@ -0,0 +1,18 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ToolRegistrationContext } from "../_shared.js";
+/**
+ * Register the five `profile.certifications.*` MCP tools on `server`.
+ *
+ * MCP tool names use ONLY the canonical `certifications` form — the CLI
+ * alias `certs` (per #72) is CLI-only and never appears in the MCP
+ * catalog.
+ *
+ * Dry-run path (issue #165): every tool accepts `dryRun?: boolean`. When
+ * `dryRun: true`, returns `{ ok: true, dryRun: true, preview }` via
+ * MCP-layer preview building. `show` previews `GET_CERTIFICATION` (the
+ * apply path lists then filters client-side; no per-id selector exists).
+ * `profileId` carries `DRY_RUN_PROFILE_ID_PLACEHOLDER` where the apply
+ * path resolves it via a sibling profile read.
+ */
+export declare function registerCertificationsTools(server: McpServer, ctx: ToolRegistrationContext): void;
+//# sourceMappingURL=certifications.d.ts.map

package/dist/tools/profile/certifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"certifications.d.ts","sourceRoot":"","sources":["../../../src/tools/profile/certifications.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,EAAyC,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAUpG;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,uBAAuB,GAAG,IAAI,CAuNjG"}