@cargo-ai/cli 1.0.71 → 1.0.73

package/build/commands/orchestration/costTable.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Renders every credits-based action as a pricing table.
+ *
+ * The catalog is the only place pricing lives, and it moves — providers get
+ * added, actions get repriced, tiers get split. Anything that copies those
+ * numbers by hand goes stale silently, so the table is generated rather than
+ * maintained.
+ *
+ * Sourced from `orchestration action list` (without a limit), which spans
+ * connector and native actions in a single call. Natives are a small set but
+ * not a free one — `sendEmail` is 0.1, `modelAsk` 0.5, `fileSearch` 0.02/1k
+ * tokens — and a table built from connectors alone silently omits them while
+ * claiming to be complete.
+ */
+/**
+ * Shape returned by `orchestration action list` for each matching action.
+ */
+export type ListActionMatch = {
+    name: string;
+    description?: string;
+    score: number;
+    action: {
+        kind: string;
+        integrationSlug?: string;
+        actionSlug?: string;
+    };
+    integrationName?: string;
+    category?: string;
+    credits?: CreditsCost[];
+};
+export type CreditsCost = {
+    type?: string;
+    cost?: number;
+    unit?: string;
+    unitsCount?: number;
+    fixedCost?: number;
+    config?: {
+        jsonSchema?: JsonSchema;
+    };
+};
+type JsonSchema = {
+    type?: string;
+    const?: unknown;
+    enum?: unknown[];
+    minItems?: number;
+    maxItems?: number;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+};
+export type CatalogAction = {
+    name?: string;
+    description?: string;
+    credits?: {
+        costs?: CreditsCost[];
+    };
+};
+export type CatalogIntegration = {
+    slug: string;
+    name: string;
+    category?: string;
+    actions?: Record<string, CatalogAction>;
+};
+export type CostVariant = {
+    /** Config that selects this price, e.g. `model=gpt-5-nano`. */
+    when: string;
+    /** Rendered price, e.g. `0.4 + 0.006 / 1k token`. */
+    price: string;
+};
+export type CostRow = {
+    integrationSlug: string;
+    integrationName: string;
+    category: string | undefined;
+    actionSlug: string;
+    name: string | undefined;
+    description: string | undefined;
+    /** Cheapest and dearest per-unit price, in credits. */
+    minCost: number;
+    maxCost: number;
+    /**
+     * What one call at the cheapest config costs — per-unit price plus any flat
+     * component. The sort key, so a cheap-looking per-item rate with a base
+     * charge doesn't outrank a genuinely cheaper flat action.
+     */
+    sortCost: number;
+    /** Single price, or `min–max` when config picks between several. */
+    price: string;
+    /** Config fields that move the price; empty when there is only one. */
+    variesBy: string[];
+    variants: CostVariant[];
+};
+export type CostTableSummary = {
+    integrations: number;
+    integrationsWithActions: number;
+    actions: number;
+    creditsBasedActions: number;
+    freeActions: number;
+};
+/**
+ * Natives have no integration of their own. `native` cannot collide with a real
+ * integration slug, and it is what `kind` an action object needs to run one:
+ * `{"kind":"native","actionSlug":"sendEmail"}`.
+ */
+export declare const NATIVE_PROVIDER_SLUG = "native";
+export declare function asNativeCatalogIntegration(actions: Record<string, CatalogAction> | undefined): CatalogIntegration;
+/**
+ * Groups the flat action list returned by `orchestration action list` into the
+ * integration-grouped shape that `buildCostRows` and `summarize` expect.
+ */
+export declare function groupActionsByIntegration(actions: ListActionMatch[]): CatalogIntegration[];
+export declare function buildCostRows(integrations: CatalogIntegration[]): CostRow[];
+export declare function summarize(integrations: CatalogIntegration[]): CostTableSummary;
+export type RenderCostTableOptions = {
+    generatedAt: string;
+    filter?: {
+        category?: string;
+        integration?: string;
+    };
+};
+export declare function renderCostTable(rows: CostRow[], summary: CostTableSummary, opts: RenderCostTableOptions): string;
+export {};
+//# sourceMappingURL=costTable.d.ts.map

package/build/commands/orchestration/costTable.d.ts.map

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

package/build/commands/orchestration/costTable.js

@@ -0,0 +1,363 @@
+/**
+ * Renders every credits-based action as a pricing table.
+ *
+ * The catalog is the only place pricing lives, and it moves — providers get
+ * added, actions get repriced, tiers get split. Anything that copies those
+ * numbers by hand goes stale silently, so the table is generated rather than
+ * maintained.
+ *
+ * Sourced from `orchestration action list` (without a limit), which spans
+ * connector and native actions in a single call. Natives are a small set but
+ * not a free one — `sendEmail` is 0.1, `modelAsk` 0.5, `fileSearch` 0.02/1k
+ * tokens — and a table built from connectors alone silently omits them while
+ * claiming to be complete.
+ */
+const DESCRIPTION_MAX_LENGTH = 120;
+/**
+ * Natives have no integration of their own. `native` cannot collide with a real
+ * integration slug, and it is what `kind` an action object needs to run one:
+ * `{"kind":"native","actionSlug":"sendEmail"}`.
+ */
+export const NATIVE_PROVIDER_SLUG = "native";
+export function asNativeCatalogIntegration(actions) {
+    return {
+        slug: NATIVE_PROVIDER_SLUG,
+        name: "Cargo native",
+        category: "platform",
+        actions: actions ?? {},
+    };
+}
+/**
+ * Groups the flat action list returned by `orchestration action list` into the
+ * integration-grouped shape that `buildCostRows` and `summarize` expect.
+ */
+export function groupActionsByIntegration(actions) {
+    const integrationMap = new Map();
+    for (const match of actions) {
+        const actionKind = match.action.kind;
+        const actionSlug = match.action.actionSlug;
+        if (actionSlug === undefined) {
+            continue;
+        }
+        let slug;
+        let name;
+        let category;
+        if (actionKind === "native") {
+            slug = NATIVE_PROVIDER_SLUG;
+            name = "Cargo native";
+            category = "platform";
+        }
+        else if (actionKind === "connector") {
+            slug =
+                match.action.integrationSlug !== undefined
+                    ? match.action.integrationSlug
+                    : "";
+            name = match.integrationName !== undefined ? match.integrationName : slug;
+            category = match.category;
+        }
+        else {
+            continue;
+        }
+        let integration = integrationMap.get(slug);
+        if (integration === undefined) {
+            integration = { slug, name, category, actions: {} };
+            integrationMap.set(slug, integration);
+        }
+        if (integration.actions === undefined) {
+            integration.actions = {};
+        }
+        integration.actions[actionSlug] = {
+            name: match.name,
+            description: match.description,
+            credits: match.credits !== undefined ? { costs: match.credits } : undefined,
+        };
+    }
+    return Array.from(integrationMap.values());
+}
+export function buildCostRows(integrations) {
+    const rows = [];
+    for (const integration of integrations) {
+        for (const [actionSlug, action] of Object.entries(integration.actions ?? {})) {
+            const costs = action.credits?.costs;
+            const [first] = costs ?? [];
+            if (costs === undefined || first === undefined) {
+                continue;
+            }
+            const amounts = costs.map((cost) => cost.cost ?? 0);
+            const effective = costs.map((cost) => (cost.cost ?? 0) + (cost.fixedCost ?? 0));
+            const variants = costs.map((cost) => ({
+                when: describeSelector(cost.config?.jsonSchema),
+                price: renderPrice(cost),
+            }));
+            const minCost = Math.min(...amounts);
+            const maxCost = Math.max(...amounts);
+            rows.push({
+                integrationSlug: integration.slug,
+                integrationName: integration.name,
+                category: integration.category,
+                actionSlug,
+                name: action.name,
+                description: truncate(action.description),
+                minCost,
+                maxCost,
+                sortCost: Math.min(...effective),
+                price: costs.length === 1
+                    ? renderPrice(first)
+                    : renderRange(costs, minCost, maxCost),
+                variesBy: costs.length === 1 ? [] : selectorFields(costs),
+                variants: costs.length === 1 ? [] : variants,
+            });
+        }
+    }
+    return rows.sort((a, b) => a.sortCost - b.sortCost ||
+        a.maxCost - b.maxCost ||
+        a.integrationSlug.localeCompare(b.integrationSlug) ||
+        a.actionSlug.localeCompare(b.actionSlug));
+}
+export function summarize(integrations) {
+    let actions = 0;
+    let creditsBasedActions = 0;
+    let integrationsWithActions = 0;
+    for (const integration of integrations) {
+        const entries = Object.values(integration.actions ?? {});
+        // The native pseudo-integration is a carrier for platform actions, not a
+        // 139th integration. Its actions count; it does not.
+        const isNative = integration.slug === NATIVE_PROVIDER_SLUG;
+        if (entries.length > 0 && isNative === false) {
+            integrationsWithActions += 1;
+        }
+        actions += entries.length;
+        for (const action of entries) {
+            if ((action.credits?.costs ?? []).length > 0) {
+                creditsBasedActions += 1;
+            }
+        }
+    }
+    return {
+        integrations: integrations.filter((integration) => {
+            return integration.slug !== NATIVE_PROVIDER_SLUG;
+        }).length,
+        integrationsWithActions,
+        actions,
+        creditsBasedActions,
+        freeActions: actions - creditsBasedActions,
+    };
+}
+export function renderCostTable(rows, summary, opts) {
+    const lines = [];
+    const filter = opts.filter;
+    const isFiltered = filter !== undefined &&
+        (filter.category !== undefined || filter.integration !== undefined);
+    lines.push("# Credits cost table");
+    lines.push("");
+    if (isFiltered) {
+        const filterDesc = filter.category !== undefined && filter.integration !== undefined
+            ? `category \`${filter.category}\` and integration \`${filter.integration}\``
+            : filter.category !== undefined
+                ? `category \`${filter.category}\``
+                : `integration \`${filter.integration}\``;
+        lines.push(`Filtered by ${filterDesc}: ${String(summary.creditsBasedActions)} credits-based actions ` +
+            `out of ${String(summary.actions)} total across ${String(summary.integrationsWithActions)} of ` +
+            `${String(summary.integrations)} integrations, sorted by cost. ` +
+            `The other ${String(summary.freeActions)} actions in this subset cost no credits. ` +
+            "Run without filters for the full catalog, including Cargo's native actions.");
+    }
+    else {
+        lines.push(`Every credits-based action Cargo can run — ${String(summary.creditsBasedActions)} of the ` +
+            `${String(summary.actions)} actions exposed by ${String(summary.integrationsWithActions)} of the catalog's ` +
+            `${String(summary.integrations)} integrations, plus Cargo's own native actions — sorted by cost. The other ${String(summary.freeActions)} actions ` +
+            "(CRM writes, sequencer pushes, Slack sends, …) cost no credits; list them with " +
+            "`cargo-ai connection integration get <slug>`.");
+    }
+    lines.push("");
+    if (isFiltered === false) {
+        lines.push("Rows whose provider is `native` are Cargo's own platform actions, run as " +
+            '`{"kind":"native","actionSlug":"<action>"}` with no integration; every other row ' +
+            'runs as `{"kind":"connector","integrationSlug":"<provider>","actionSlug":"<action>"}`.');
+        lines.push("");
+    }
+    lines.push("**Auto-generated. Do not edit by hand** — regenerate with " +
+        "`cargo-ai orchestration action cost-table --raw > cargo-gtm/references/credits-cost-table.md`.");
+    lines.push("");
+    lines.push(`Generated: ${opts.generatedAt}`);
+    lines.push("");
+    lines.push("| Cost | Provider | Category | Action | Description |");
+    lines.push("|---|---|---|---|---|");
+    for (const row of rows) {
+        lines.push(`| ${row.price} | \`${row.integrationSlug}\` | ${row.category ?? "—"} | ` +
+            `\`${row.actionSlug}\` | ${escapeCell(row.description ?? "")} |`);
+    }
+    const variable = rows.filter((row) => row.variants.length > 0);
+    if (variable.length > 0) {
+        lines.push("");
+        lines.push("## Actions whose price depends on config");
+        lines.push("");
+        lines.push("These bill differently depending on how the node is configured, so the range above is not a quote. " +
+            "Pick the row that matches the config you are about to run.");
+        lines.push("");
+        for (const row of variable) {
+            lines.push(`### \`${row.integrationSlug}.${row.actionSlug}\` — varies by ${row.variesBy
+                .map((field) => `\`${field}\``)
+                .join(", ")}`);
+            lines.push("");
+            lines.push("| Config | Cost |");
+            lines.push("|---|---|");
+            for (const variant of dedupeVariants(row.variants)) {
+                lines.push(`| ${escapeCell(variant.when)} | ${variant.price} |`);
+            }
+            lines.push("");
+        }
+    }
+    return `${lines.join("\n").trimEnd()}\n`;
+}
+/**
+ * One cost entry as a price expression.
+ *
+ * `fixed` bills per call, `unit` bills per unit consumed, and `package` bills
+ * per block of units on top of a flat call cost — an LLM step that charges a
+ * base plus a rate per 1k tokens is the common case.
+ */
+function renderPrice(cost) {
+    const amount = formatAmount(cost.cost ?? 0);
+    if (cost.type === "unit") {
+        const metered = cost.unit === undefined ? amount : `${amount} / ${cost.unit}`;
+        // A per-item rate can sit on top of a flat charge per call — dropping that
+        // base is how a 0.175 + 0.025/item search gets quoted as 0.025.
+        return cost.fixedCost === undefined || cost.fixedCost === 0
+            ? metered
+            : `${formatAmount(cost.fixedCost)} + ${metered}`;
+    }
+    if (cost.type === "package") {
+        const block = formatUnits(cost.unitsCount, cost.unit);
+        const metered = block === undefined ? amount : `${amount} / ${block}`;
+        return cost.fixedCost === undefined || cost.fixedCost === 0
+            ? metered
+            : `${formatAmount(cost.fixedCost)} + ${metered}`;
+    }
+    return amount;
+}
+function renderRange(costs, minCost, maxCost) {
+    const range = minCost === maxCost
+        ? formatAmount(minCost)
+        : `${formatAmount(minCost)}–${formatAmount(maxCost)}`;
+    const first = costs[0];
+    const unit = first !== undefined ? first.unit : undefined;
+    const unitsCount = first !== undefined ? first.unitsCount : undefined;
+    const packageBlock = formatUnits(unitsCount, unit);
+    const metered = costs.some((cost) => cost.type === "package")
+        ? packageBlock !== undefined
+            ? `${range} / ${packageBlock}`
+            : range
+        : costs.every((cost) => cost.type === "unit") && unit !== undefined
+            ? `${range} / ${unit}`
+            : range;
+    const hasBase = costs.some((cost) => cost.fixedCost !== undefined && cost.fixedCost !== 0);
+    return hasBase ? `${metered} + base` : metered;
+}
+/**
+ * The config fields a cost entry keys off, as dotted paths — the answer to
+ * "what do I change to land on a different price".
+ */
+function selectorPaths(schema, prefix = "") {
+    if (schema?.properties === undefined) {
+        return [];
+    }
+    const paths = [];
+    for (const [key, property] of Object.entries(schema.properties)) {
+        const path = prefix === "" ? key : `${prefix}.${key}`;
+        const nested = selectorPaths(property, path);
+        if (nested.length > 0) {
+            paths.push(...nested);
+        }
+        else {
+            paths.push(path);
+        }
+    }
+    return paths;
+}
+function selectorFields(costs) {
+    const fields = new Set();
+    for (const cost of costs) {
+        for (const path of selectorPaths(cost.config?.jsonSchema)) {
+            fields.add(path);
+        }
+    }
+    return [...fields];
+}
+/** A cost entry's selector as `field=value` pairs, e.g. `model=gpt-5-nano`. */
+function describeSelector(schema) {
+    const pairs = selectorPairs(schema);
+    return pairs.length === 0 ? "any config" : pairs.join(", ");
+}
+function selectorPairs(schema, prefix = "") {
+    if (schema?.properties === undefined) {
+        return [];
+    }
+    const pairs = [];
+    for (const [key, property] of Object.entries(schema.properties)) {
+        const path = prefix === "" ? key : `${prefix}.${key}`;
+        const nested = selectorPairs(property, path);
+        if (nested.length > 0) {
+            pairs.push(...nested);
+            continue;
+        }
+        pairs.push(`${path}${describeConstraint(property)}`);
+    }
+    return pairs;
+}
+function describeConstraint(schema) {
+    if (schema.const !== undefined) {
+        return `=${String(schema.const)}`;
+    }
+    if (schema.enum !== undefined) {
+        return `∈ ${schema.enum.map((value) => String(value)).join("|")}`;
+    }
+    if (schema.maxItems === 0) {
+        return " empty";
+    }
+    if (schema.minItems !== undefined && schema.minItems > 0) {
+        return " set";
+    }
+    return " (any)";
+}
+/**
+ * Catalogs sometimes carry the same price twice under selectors that differ
+ * only in a field the reader cannot act on; collapsing them keeps the variant
+ * table readable.
+ */
+function dedupeVariants(variants) {
+    const seen = new Set();
+    const kept = [];
+    for (const variant of variants) {
+        const key = `${variant.when}|${variant.price}`;
+        if (seen.has(key) === true) {
+            continue;
+        }
+        seen.add(key);
+        kept.push(variant);
+    }
+    return kept;
+}
+function formatUnits(unitsCount, unit) {
+    if (unit === undefined) {
+        return undefined;
+    }
+    if (unitsCount === undefined || unitsCount === 1) {
+        return unit;
+    }
+    return unitsCount % 1000 === 0
+        ? `${String(unitsCount / 1000)}k ${unit}`
+        : `${String(unitsCount)} ${unit}`;
+}
+function formatAmount(value) {
+    return String(Number(value.toFixed(6)));
+}
+function truncate(value) {
+    if (value === undefined || value.length <= DESCRIPTION_MAX_LENGTH) {
+        return value;
+    }
+    return `${value.slice(0, DESCRIPTION_MAX_LENGTH).trimEnd()}…`;
+}
+function escapeCell(value) {
+    return value.replace(/\r?\n/g, " ").replace(/\|/g, "\\|");
+}

package/build/commands/start/brief.d.ts

@@ -0,0 +1,107 @@
+import { CDK_SKILL, type CodingAgent } from "@cargo-ai/cdk/cli";
+/**
+ * Where the agent is being opened, which decides what it is told to do.
+ *
+ * Three cases, because the right first move is different in each: outside a
+ * project there is nothing to read and the work starts with a conversation;
+ * inside a CDK repo the workspace is already declared in files worth reading
+ * before touching; and inside one carrying a cookbook, that cookbook's own
+ * procedure is the authority and re-deriving intent is the wrong move.
+ *
+ * Naming the same skill in all three, which is what this used to do, sent an
+ * agent into a repo full of answers and told it to start asking questions.
+ */
+export type ProjectContext = {
+    kind: "none";
+} | {
+    kind: "cdk";
+    root: string;
+    companyContextPath: string | undefined;
+} | {
+    kind: "cookbook";
+    root: string;
+    companyContextPath: string | undefined;
+    cookbooks: readonly string[];
+};
+export type StartFacts = {
+    workspace: {
+        uuid: string;
+        name: string;
+    };
+    /** Whether the Cargo skills bundle is already installed for a coding agent. */
+    skillsInstalled: boolean;
+};
+/**
+ * The command group "Explore in the CLI" opens the palette on. The action
+ * catalog is the shortest path from a menu to something real: search one, run
+ * one, see a result.
+ */
+export declare const EXPLORE_PATH: readonly string[];
+/**
+ * The skill a handoff loads before the agent's first turn. `cargo` routes; the
+ * other two own their task outright.
+ *
+ * This type is the one place the whole story lives, because everything about
+ * the handoff depends on getting it right, and it has been got wrong twice.
+ *
+ * A skill reaches the agent by two paths at once: the launch passes it as a
+ * `/<skill>` command, which only Claude Code expands, and the brief names it in
+ * prose, which is all every other agent has. So the two must agree. The first
+ * version of the demo brief described its *outcome* instead of naming a skill
+ * and let the router choose; the router picked `cargo-gtm`, the general
+ * sourcing surface, and the agent spent four of its eight minutes rediscovering
+ * action names and dumping integration JSON to find a config schema. The
+ * second version named `cargo-quickstart` in the launch but left the brief
+ * saying "load `cargo`", which put every non-Claude agent back through the
+ * router and made the demo ask for two different skills in two steps.
+ *
+ * Hence a union rather than `string`: a mistyped or mismatched skill name is
+ * not something the CLI can notice at runtime, and the symptom is slow rather
+ * than broken, which is the kind of bug that survives.
+ */
+export type HandoffSkill = "cargo" | typeof CDK_SKILL | "cargo-quickstart";
+export declare const ROUTER_SKILL: HandoffSkill;
+export declare const DEMO_SKILL: HandoffSkill;
+export { CDK_SKILL };
+export type Destination = {
+    kind: "agent";
+    agent: CodingAgent;
+} | {
+    kind: "code";
+} | {
+    kind: "cli";
+} | {
+    kind: "demo";
+} | {
+    kind: "none";
+};
+/**
+ * `--continue <where>` as a destination. Agents are named the way a person
+ * refers to them ("cursor"), not the way they are installed ("cursor-agent"),
+ * and one that is not on this machine is a usage error rather than a silent
+ * fallback to something else.
+ */
+export declare function parseDestination(value: string, agents: readonly CodingAgent[]): Destination | undefined;
+/**
+ * The brief a coding agent is opened with. An agent launched in a bare
+ * directory has to rediscover the workspace, the skills and the cost rules;
+ * this is the whole reason the handoff beats telling someone to open Claude
+ * Code themselves.
+ *
+ * What it says depends on `project` — see `ProjectContext` for why all three
+ * cases need different words rather than one brief and a different skill name.
+ */
+export declare function buildBrief(facts: StartFacts, skill: HandoffSkill, project?: ProjectContext): string;
+/**
+ * The brief behind the guided demo.
+ *
+ * It names `cargo-quickstart` rather than describing the demo, because that
+ * skill *is* this demo — a persona, ~25 leads, a cost receipt, then saving the
+ * pull as a play. Describing the outcome instead is what cost the first version
+ * half its runtime (see `HandoffSkill`), so this brief spends its length on
+ * pointing at the procedure and forbidding the detour.
+ */
+export declare function buildDemoBrief(facts: StartFacts, icp: string | undefined): string;
+/** The block printed when nobody wanted a handoff. */
+export declare function formatStartNextSteps(facts: StartFacts): string;
+//# sourceMappingURL=brief.d.ts.map

package/build/commands/start/brief.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief.d.ts","sourceRoot":"","sources":["../../../src/commands/start/brief.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,SAAS,EACT,KAAK,WAAW,EAEjB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACrE;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B,CAAC;AAEN,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,+EAA+E;IAC/E,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAAgC,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,OAAO,SAAS,GAAG,kBAAkB,CAAC;AAE3E,eAAO,MAAM,YAAY,EAAE,YAAsB,CAAC;AAClD,eAAO,MAAM,UAAU,EAAE,YAAiC,CAAC;AAE3D,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,WAAW,EAAE,GAC7B,WAAW,GAAG,SAAS,CA8BzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,cAAiC,GACzC,MAAM,CAaR;AAyED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,MAAM,CA+BR;AAED,sDAAsD;AACtD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAgB9D"}