@apify/actors-mcp-server 0.9.20-beta.1 → 0.9.20-beta.10

package/dist/utils/actor_details.js

@@ -1,12 +1,9 @@
-import { z } from 'zod';
-import { FAILURE_CATEGORY, HelperTools, TOOL_STATUS } from '../const.js';
 import { connectMCPClient } from '../mcp/client.js';
 import { filterSchemaProperties, shortenProperties } from '../tools/utils.js';
 import { getActorMcpUrlCached } from './actor.js';
 import { formatActorForWidget, formatActorToActorCard, formatActorToStructuredCard } from './actor_card.js';
 import { searchActorsByKeywords } from './actor_search.js';
 import { logHttpError } from './logging.js';
-import { buildMCPResponse } from './mcp.js';
 const ACTOR_DETAILS_PICTURE_SEARCH_LIMIT = 5;
 /**
  * Convert a type object to TypeScript-like string representation.
@@ -15,41 +12,22 @@ const ACTOR_DETAILS_PICTURE_SEARCH_LIMIT = 5;
  * Example:
  * Input:  { first_number: "number", tags: ["string"], user: { name: "string" } }
  * Output: "{ first_number: number, tags: string[], user: { name: string } }"
+ *
+ * Values that are not string / object / array are skipped (not rendered) at every nesting level.
  */
-function typeObjectToString(obj) {
-    const pairs = [];
-    for (const [key, value] of Object.entries(obj)) {
-        if (Array.isArray(value)) {
-            // Array type
-            const itemType = typeValueToString(value[0]);
-            pairs.push(`${key}: ${itemType}[]`);
-        }
-        else if (typeof value === 'object' && value !== null) {
-            // Nested object type
-            const nestedStr = typeObjectToString(value);
-            pairs.push(`${key}: ${nestedStr}`);
-        }
-        else if (typeof value === 'string') {
-            // Primitive type
-            pairs.push(`${key}: ${value}`);
-        }
-    }
+export function typeObjectToString(obj) {
+    const pairs = Object.entries(obj)
+        .filter(([, v]) => Array.isArray(v) || (v !== null && typeof v === 'object') || typeof v === 'string')
+        .map(([k, v]) => `${k}: ${typeValueToString(v)}`);
     return `{ ${pairs.join(', ')} }`;
 }
-/**
- * Convert a single type value to string.
- */
 function typeValueToString(value) {
-    if (Array.isArray(value)) {
-        const itemType = typeValueToString(value[0]);
-        return `${itemType}[]`;
-    }
-    if (typeof value === 'object' && value !== null) {
+    if (Array.isArray(value))
+        return `${typeValueToString(value[0])}[]`;
+    if (value !== null && typeof value === 'object')
         return typeObjectToString(value);
-    }
-    if (typeof value === 'string') {
+    if (typeof value === 'string')
         return value;
-    }
     return 'unknown';
 }
 /**
@@ -65,13 +43,14 @@ export function resolveReadmeContent(details) {
 }
 export async function fetchActorDetails(apifyClient, actorName, cardOptions) {
     try {
+        // Use only the actor name part (after '/') for better keyword search relevance —
+        // "apify/instagram-scraper" returns unrelated results, while "instagram-scraper" finds the correct actor.
+        const actorSlug = actorName.split('/').pop() || actorName;
+        const actor = apifyClient.actor(actorName);
         const [actorInfo, buildInfo, storeActors] = await Promise.all([
-            apifyClient.actor(actorName).get(),
-            apifyClient.actor(actorName).defaultBuild().then(async (build) => build.get()),
-            // Fetch from store to get the processed pictureUrl (with resizing parameters).
-            // Use only the actor name part (after '/') for better keyword search relevance —
-            // searching "apify/instagram-scraper" returns unrelated results, while "instagram-scraper" finds the correct actor.
-            searchActorsByKeywords(actorName.split('/').pop() || actorName, apifyClient.token || '', ACTOR_DETAILS_PICTURE_SEARCH_LIMIT).catch(() => []),
+            actor.get(),
+            actor.defaultBuild().then(async (build) => build.get()),
+            searchActorsByKeywords(actorSlug, apifyClient.token || '', ACTOR_DETAILS_PICTURE_SEARCH_LIMIT).catch(() => []),
         ]);
         if (!actorInfo || !buildInfo || !buildInfo.actorDefinition)
             return null;
@@ -102,92 +81,21 @@ export async function fetchActorDetails(apifyClient, actorName, cardOptions) {
     }
 }
 /**
- * Process actor details for response formatting.
- * Formats README with link, builds text content, and creates structured content.
- * @param details - Raw actor details from fetchActorDetails
- * @returns Processed actor details with formatted content
+ * Build the widget actor-details payload for the openai variant.
+ * Returns the Actor URL and the structured `actorDetails` object.
  */
-export function processActorDetailsForResponse(details) {
+export function buildActorDetailsForWidget(details, userTier) {
     const actorUrl = `https://apify.com/${details.actorInfo.username}/${details.actorInfo.name}`;
-    // Add link to README title
     const formattedReadme = details.readme.replace(/^# /, `# [README](${actorUrl}/readme): `);
-    const texts = [
-        `# Actor information\n${details.actorCard}`,
-        formattedReadme,
-    ];
-    // Include input schema if it has properties
-    const hasInputSchema = details.inputSchema.properties && Object.keys(details.inputSchema.properties).length !== 0;
-    if (hasInputSchema) {
-        texts.push(`# [Input schema](${actorUrl}/input)\n\`\`\`json\n${JSON.stringify(details.inputSchema)}\n\`\`\``);
-    }
-    const structuredContent = {
+    return {
+        actorUrl,
         actorDetails: {
-            actorInfo: formatActorForWidget(details.actorInfo),
+            actorInfo: formatActorForWidget(details.actorInfo, userTier),
             actorCard: details.actorCard,
             readme: formattedReadme,
             inputSchema: details.inputSchema,
         },
     };
-    return {
-        actorUrl,
-        texts,
-        structuredContent,
-        formattedReadme,
-    };
-}
-/**
- * Shared schema for actor details output options.
- * Used by both public and internal fetch-actor-details tools.
- *
- * Behavior:
- * - If output is undefined or empty object: use defaults (all true except mcpTools and outputSchema)
- * - If any property is explicitly set: only include sections with explicit true values
- */
-export const actorDetailsOutputOptionsSchema = z.object({
-    description: z.boolean().optional().describe('Include Actor description text only.'),
-    stats: z.boolean().optional().describe('Include usage statistics (users, runs, success rate).'),
-    pricing: z.boolean().optional().describe('Include pricing model and costs.'),
-    rating: z.boolean().optional().describe('Include user rating (out of 5 stars).'),
-    metadata: z.boolean().optional().describe('Include developer, categories, last modified date, and deprecation status.'),
-    inputSchema: z.boolean().optional().describe('Include required input parameters schema.'),
-    readme: z.boolean().optional().describe('Include Actor README documentation (summary when available, full otherwise).'),
-    outputSchema: z.boolean().optional().describe('Include inferred output schema from recent successful runs (TypeScript type).'),
-    mcpTools: z.boolean().optional().describe('List available tools (only for MCP server Actors).'),
-});
-export const actorDetailsOutputDefaults = {
-    description: true,
-    stats: true,
-    pricing: true,
-    rating: true,
-    metadata: true,
-    inputSchema: true,
-    readme: true,
-    outputSchema: false,
-    mcpTools: false,
-};
-/**
- * Resolve output options with smart defaults.
- * If output is undefined/empty, returns defaults.
- * If any property is explicitly set, undefined properties are treated as false.
- */
-export function resolveOutputOptions(output) {
-    // Check if output has any explicit true/false values
-    const hasExplicitOptions = output && Object.values(output).some((v) => v !== undefined);
-    if (!hasExplicitOptions) {
-        return actorDetailsOutputDefaults;
-    }
-    // Return output with undefined treated as false (explicit true required)
-    return {
-        description: (output === null || output === void 0 ? void 0 : output.description) === true,
-        stats: (output === null || output === void 0 ? void 0 : output.stats) === true,
-        pricing: (output === null || output === void 0 ? void 0 : output.pricing) === true,
-        rating: (output === null || output === void 0 ? void 0 : output.rating) === true,
-        metadata: (output === null || output === void 0 ? void 0 : output.metadata) === true,
-        inputSchema: (output === null || output === void 0 ? void 0 : output.inputSchema) === true,
-        readme: (output === null || output === void 0 ? void 0 : output.readme) === true,
-        outputSchema: (output === null || output === void 0 ? void 0 : output.outputSchema) === true,
-        mcpTools: (output === null || output === void 0 ? void 0 : output.mcpTools) === true,
-    };
 }
 /**
  * Gets MCP tools information for an Actor.
@@ -211,9 +119,22 @@ export async function getMcpToolsMessage(actorName, apifyClient, apifyToken, pay
     try {
         const toolsResponse = await client.listTools();
         const mcpToolsInfo = toolsResponse.tools
-            .map((tool) => `**${tool.name}**\n${tool.description || 'No description'}\nInput schema:\n\`\`\`json\n${JSON.stringify(tool.inputSchema)}\n\`\`\``)
+            .map((tool) => [
+            `**${tool.name}**`,
+            tool.description || 'No description',
+            'Input schema:',
+            '```json',
+            JSON.stringify(tool.inputSchema),
+            '```',
+        ].join('\n'))
             .join('\n\n');
-        return `# Available MCP Tools\nThis Actor is an MCP server with ${toolsResponse.tools.length} tools.\nTo call a tool, use: "${actorName}:{toolName}"\n\n${mcpToolsInfo}`;
+        return [
+            '# Available MCP Tools',
+            `This Actor is an MCP server with ${toolsResponse.tools.length} tools.`,
+            `To call a tool, use: "${actorName}:{toolName}"`,
+            '',
+            mcpToolsInfo,
+        ].join('\n');
     }
     catch (error) {
         logHttpError(error, `Failed to list MCP tools for Actor '${actorName}'`, { actorName });
@@ -226,6 +147,7 @@ export async function getMcpToolsMessage(actorName, apifyClient, apifyToken, pay
 /**
  * Build card options from resolved output flags.
  * Maps boolean output flags to card rendering options (explicit true required).
+ * Caller adds `userTier` if needed — this helper stays focused on flags.
  */
 export function buildCardOptions(output) {
     return {
@@ -236,67 +158,4 @@ export function buildCardOptions(output) {
         includeMetadata: output.metadata,
     };
 }
-/**
- * Build error response for when actor is not found.
- */
-export function buildActorNotFoundResponse(actorName) {
-    return buildMCPResponse({
-        texts: [`Actor information for '${actorName}' was not found.
-Please verify Actor ID or name format and ensure that the Actor exists.
-You can search for available Actors using the tool: ${HelperTools.STORE_SEARCH}.`],
-        isError: true,
-        telemetry: { toolStatus: TOOL_STATUS.SOFT_FAIL, failureCategory: FAILURE_CATEGORY.INVALID_INPUT },
-    });
-}
-/**
- * Build text and structured response for actor details.
- * Handles all resolved output options: description, stats, readme, inputSchema, outputSchema, mcpTools.
- * All output properties should be boolean (resolved via resolveOutputOptions).
- */
-export async function buildActorDetailsTextResponse(options) {
-    const { actorName, details, output, cardOptions, apifyClient, apifyToken, actorOutputSchema, paymentProvider, mcpSessionId } = options;
-    const actorUrl = `https://apify.com/${details.actorInfo.username}/${details.actorInfo.name}`;
-    const texts = [];
-    // Build actor card only if any card section is requested
-    const needsCard = cardOptions.includeDescription
-        || cardOptions.includeStats
-        || cardOptions.includePricing
-        || cardOptions.includeRating
-        || cardOptions.includeMetadata;
-    if (needsCard) {
-        texts.push(`# Actor information\n${details.actorCard}`);
-    }
-    // Add README content if requested (prefer readmeSummary, fall back to full readme)
-    const resolvedReadme = output.readme ? resolveReadmeContent(details) : undefined;
-    if (resolvedReadme) {
-        texts.push(`${resolvedReadme.heading}\n${resolvedReadme.content}`);
-    }
-    // Add input schema if requested
-    if (output.inputSchema) {
-        texts.push(`# [Input schema](${actorUrl}/input)\n\`\`\`json\n${JSON.stringify(details.inputSchema)}\n\`\`\``);
-    }
-    // Add output schema if requested
-    if (output.outputSchema) {
-        if (actorOutputSchema && Object.keys(actorOutputSchema).length > 0) {
-            const typeString = typeObjectToString(actorOutputSchema);
-            texts.push(`# Output Schema (TypeScript)\nInferred from recent successful runs:\n\`\`\`typescript\ntype ActorOutput = ${typeString}\n\`\`\``);
-        }
-        else {
-            texts.push(`# Output Schema\nNo output schema available. The Actor may not have recent successful runs, or the output structure could not be determined.`);
-        }
-    }
-    // Handle MCP tools
-    if (output.mcpTools) {
-        const message = await getMcpToolsMessage(actorName, apifyClient, apifyToken, paymentProvider, mcpSessionId);
-        texts.push(message);
-    }
-    // Build structured content
-    const structuredContent = {
-        actorInfo: needsCard ? details.actorCardStructured : undefined,
-        readme: resolvedReadme === null || resolvedReadme === void 0 ? void 0 : resolvedReadme.content,
-        inputSchema: output.inputSchema ? details.inputSchema : undefined,
-        outputSchema: output.outputSchema ? (actorOutputSchema !== null && actorOutputSchema !== void 0 ? actorOutputSchema : {}) : undefined,
-    };
-    return { texts, structuredContent };
-}
 //# sourceMappingURL=actor_details.js.map

package/dist/utils/actor_details.js.map

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

package/dist/utils/pricing_info.d.ts

@@ -1,8 +1,58 @@
+/**
+ * Pricing output contract for Actor cards.
+ *
+ * Text callers:
+ * - `pricingInfoToString`: complete mode for `fetch-actor-details`
+ * - `pricingInfoToSimplifiedString`: simplified mode for `search-actors`
+ *
+ * Structured callers:
+ * - `pricingInfoToStructured`: complete mode
+ * - `pricingInfoToSimplifiedStructured`: simplified mode
+ *
+ * Structured output shape is mostly the same in both modes:
+ * {
+ *   model: string,
+ *   userTier?: PricingTier,
+ *   pricePerUnit?: number,
+ *   unitName?: string,
+ *   trialMinutes?: number,
+ *   tieredPricing?: [{ tier: string, pricePerUnit: number }],
+ *   events?: [{
+ *     title: string,
+ *     description?: string,
+ *     priceUsd?: number,
+ *     tieredPricing?: [{ tier: string, priceUsd: number }],
+ *   }],
+ *   pricingNote?: string,
+ *   eventDescriptionsOmitted?: boolean,
+ *   eventDescriptionsNote?: string,
+ * }
+ *
+ * Complete mode keeps full tier matrices and never sets `pricingNote`.
+ *
+ * Simplified mode picks a single tier from each tiered map
+ * (requested tier -> FREE -> first entry) and emits `pricingNote` only when
+ * the Actor actually has multiple tiers *and* they resolve consistently. The
+ * note is omitted for single-tier Actors (the note's "higher tiers may offer
+ * lower prices" promise is vacuous) and when PAY_PER_EVENT events resolve
+ * to different tiers (no truthful single label).
+ *
+ * Simplified `PAY_PER_EVENT` also trims long event lists:
+ * - `events.length <= 5`: keep event descriptions
+ * - `events.length > 5`: omit event descriptions and set
+ *   `eventDescriptionsOmitted` / `eventDescriptionsNote`
+ *
+ * Single-tier buckets stay as 1-element `tieredPricing` arrays in both modes.
+ * `FREE` or `null` input returns the free text / structured shape.
+ *
+ * Full examples and contract details are documented inline in this module.
+ */
 import type { ActorRunPricingInfo, PricePerEventActorPricingInfo as PricePerEventActorPricingInfoOutdated } from 'apify-client';
 export type TieredEventPrice = {
     tieredEventPriceUsd: number;
 };
-export type PricingTier = 'FREE' | 'BRONZE' | 'SILVER' | 'GOLD' | 'PLATINUM' | 'DIAMOND';
+export declare const PRICING_TIERS: readonly ["FREE", "BRONZE", "SILVER", "GOLD", "PLATINUM", "DIAMOND"];
+export type PricingTier = typeof PRICING_TIERS[number];
 export type ActorChargeEvent = {
     eventTitle: string;
     eventDescription?: string;
@@ -19,16 +69,20 @@ type PricePerEventActorPricingInfo = PricePerEventActorPricingInfoOutdated & {
         actorChargeEvents: Record<string, ActorChargeEvent>;
     };
 };
-export type PricingInfo = ActorRunPricingInfo & {
+export type PricingInfo = (ActorRunPricingInfo & {
     tieredPricing?: TieredPricing;
-} | PricePerEventActorPricingInfo;
+}) | PricePerEventActorPricingInfo;
 /**
- * Custom type to transform raw API pricing data into a clean, client-friendly format
- * that matches the style of the unstructured text output instead of using the raw API format.
+ * Public structured pricing contract returned by actor cards.
+ *
+ * `tieredPricing` and event-level `tieredPricing` always use arrays.
+ * The difference between modes is array length:
+ * - complete mode: full tier matrix
+ * - simplified mode: 1 resolved tier
  */
 export type StructuredPricingInfo = {
     model: string;
-    isFree: boolean;
+    userTier?: PricingTier;
     pricePerUnit?: number;
     unitName?: string;
     trialMinutes?: number;
@@ -38,28 +92,25 @@ export type StructuredPricingInfo = {
     }[];
     events?: {
         title: string;
-        description: string;
+        description?: string;
         priceUsd?: number;
         tieredPricing?: {
             tier: string;
             priceUsd: number;
         }[];
     }[];
+    pricingNote?: string;
+    eventDescriptionsOmitted?: boolean;
+    eventDescriptionsNote?: string;
 };
-/**
- * Returns the most recent valid pricing information from a list of pricing infos,
- * based on the provided current date.
- *
- * Filters out pricing infos that have a `startedAt` date in the future or missing,
- * then sorts the remaining infos by `startedAt` in descending order (most recent first).
- * Returns the most recent valid pricing info, or `null` if none are valid.
- */
 export declare function getCurrentPricingInfo(pricingInfos: PricingInfo[], now: Date): PricingInfo | null;
+/** Complete text contract used by `fetch-actor-details`. */
 export declare function pricingInfoToString(pricingInfo: PricingInfo | null): string;
-/**
- * Transform and normalize API response to match unstructured text output format
- * instead of just dumping raw API data - ensures consistency across structured & unstructured modes.
- */
-export declare function pricingInfoToStructured(pricingInfo: PricingInfo | null): StructuredPricingInfo;
+/** Complete structured contract used by `fetch-actor-details`. */
+export declare function pricingInfoToStructured(pricingInfo: PricingInfo | null, userTier: PricingTier): StructuredPricingInfo;
+/** Simplified text contract used by `search-actors`. */
+export declare function pricingInfoToSimplifiedString(pricingInfo: PricingInfo | null, userTier: PricingTier): string;
+/** Simplified structured contract used by `search-actors`. */
+export declare function pricingInfoToSimplifiedStructured(pricingInfo: PricingInfo | null, userTier: PricingTier): StructuredPricingInfo;
 export {};
 //# sourceMappingURL=pricing_info.d.ts.map

package/dist/utils/pricing_info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pricing_info.d.ts","sourceRoot":"","sources":["../../src/utils/pricing_info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,mBAAmB,EACnB,6BAA6B,IAAI,qCAAqC,EACzE,MAAM,cAAc,CAAC;AAItB,MAAM,MAAM,gBAAgB,GAAG;IAC3B,mBAAmB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AAEzF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IACxB,CAAC,IAAI,EAAE,MAAM,GAAG;QACZ,qBAAqB,EAAE,MAAM,CAAC;KACjC,CAAC;CACL,CAAC;AAEF,KAAK,6BAA6B,GAAG,qCAAqC,GAAG;IACzE,eAAe,EAAE;QACb,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;KACvD,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,mBAAmB,GAAG;IAC5C,aAAa,CAAC,EAAE,aAAa,CAAC;CACjC,GAAG,6BAA6B,CAAC;AAElC;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACxB,EAAE,CAAC;IACJ,MAAM,CAAC,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC;SACpB,EAAE,CAAC;KACP,EAAE,CAAC;CACP,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,IAAI,GAAG,WAAW,GAAG,IAAI,CAmBhG;AA4CD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,GAAG,MAAM,CAgC3E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,GAAG,qBAAqB,CAoD9F"}
+{"version":3,"file":"pricing_info.d.ts","sourceRoot":"","sources":["../../src/utils/pricing_info.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,OAAO,KAAK,EACR,mBAAmB,EACnB,6BAA6B,IAAI,qCAAqC,EACzE,MAAM,cAAc,CAAC;AAItB,MAAM,MAAM,gBAAgB,GAAG;IAC3B,mBAAmB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,aAAa,sEAAuE,CAAC;AAClG,MAAM,MAAM,WAAW,GAAG,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAEvD,MAAM,MAAM,gBAAgB,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IACxB,CAAC,IAAI,EAAE,MAAM,GAAG;QACZ,qBAAqB,EAAE,MAAM,CAAC;KACjC,CAAC;CACL,CAAC;AAEF,KAAK,6BAA6B,GAAG,qCAAqC,GAAG;IACzE,eAAe,EAAE;QACb,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;KACvD,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,mBAAmB,GAAG;IAC7C,aAAa,CAAC,EAAE,aAAa,CAAC;CACjC,CAAC,GAAG,6BAA6B,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACxB,EAAE,CAAC;IACJ,MAAM,CAAC,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC;SACpB,EAAE,CAAC;KACP,EAAE,CAAC;IACJ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAClC,CAAC;AAgFF,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,IAAI,GAAG,WAAW,GAAG,IAAI,CAahG;AAED,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,GAAG,MAAM,CAa3E;AA+DD,kEAAkE;AAClE,wBAAgB,uBAAuB,CACnC,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,QAAQ,EAAE,WAAW,GACtB,qBAAqB,CAcvB;AA2CD,wDAAwD;AACxD,wBAAgB,6BAA6B,CACzC,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,QAAQ,EAAE,WAAW,GACtB,MAAM,CAaR;AA+DD,8DAA8D;AAC9D,wBAAgB,iCAAiC,CAC7C,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,QAAQ,EAAE,WAAW,GACtB,qBAAqB,CAWvB"}