@clawpify/skills 1.0.3 → 1.0.5

package/dist/agent.d.ts

@@ -1,18 +1,148 @@
 import Anthropic from "@anthropic-ai/sdk";
 import { ShopifyClient } from "./shopify";
+import type { MemoryStore } from "./memory";
+/** Accumulated token usage and estimated cost for a single chat() call. */
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationInputTokens: number;
+    cacheReadInputTokens: number;
+    /** Estimated USD cost based on the configured pricing. */
+    totalCost: number;
+}
+/** Per-model pricing in USD per million tokens. */
+export interface ModelPricing {
+    inputPerMillion: number;
+    outputPerMillion: number;
+    cacheWritePerMillion: number;
+    cacheReadPerMillion: number;
+}
+/** A user-provided tool + handler that extends the agent's capabilities. */
+export interface AgentPlugin {
+    tool: Anthropic.Tool;
+    handler: (input: Record<string, any>) => Promise<string>;
+}
+/** Lifecycle hooks for observability and custom behavior. */
+export interface AgentHooks {
+    /** Fires before a chat request is processed. */
+    onRequest?: (message: string, history: Anthropic.MessageParam[]) => void | Promise<void>;
+    /** Fires before each Anthropic API call (including retries in the loop). */
+    onApiCall?: (params: {
+        model: string;
+        messages: Anthropic.MessageParam[];
+        tools: Anthropic.Tool[];
+    }) => void | Promise<void>;
+    /** Fires before a tool handler is executed. */
+    onToolCall?: (toolName: string, input: Record<string, any>) => void | Promise<void>;
+    /** Fires after a tool handler returns. */
+    onToolResult?: (toolName: string, result: string, isError: boolean) => void | Promise<void>;
+    /** Fires after the final text response is assembled. */
+    onResponse?: (response: string, usage: TokenUsage) => void | Promise<void>;
+    /** Fires when an error is caught during the chat loop. */
+    onError?: (error: Error) => void | Promise<void>;
+}
+/** Extended thinking configuration. */
+export interface ThinkingConfig {
+    /** Token budget for thinking. Must be >= 1024. */
+    budgetTokens: number;
+}
+/** Full configuration accepted by the ShopifyAgent constructor. */
+export interface AgentConfig {
+    shopify: ShopifyClient;
+    skillContent: string;
+    model?: string;
+    /** Override the default system instruction sent to the model. */
+    systemInstruction?: string;
+    /** Override default Claude Sonnet pricing. */
+    pricing?: ModelPricing;
+    /** Register plugins at construction time. */
+    plugins?: AgentPlugin[];
+    /** Lifecycle hooks for observability. */
+    hooks?: AgentHooks;
+    /** Enable extended thinking so the model plans before executing. */
+    thinking?: ThinkingConfig;
+    /** Maximum tool-use loop iterations before the agent stops. Defaults to 20. */
+    maxIterations?: number;
+    /** Persistent memory store for conversation history across sessions. */
+    memory?: MemoryStore;
+}
+/** Return value of a single chat() invocation. */
+export interface ChatResult {
+    response: string;
+    history: Anthropic.MessageParam[];
+    usage: TokenUsage;
+    /** Concatenated thinking text when extended thinking is enabled. */
+    thinking?: string;
+    /** Number of tool-use loop iterations used in this call. */
+    iterationsUsed: number;
+}
+/** Events yielded by chatStream(). */
+export type StreamEvent = {
+    type: "thinking";
+    text: string;
+} | {
+    type: "text";
+    text: string;
+} | {
+    type: "tool_call";
+    name: string;
+    input: Record<string, any>;
+} | {
+    type: "tool_result";
+    name: string;
+    result: string;
+    isError: boolean;
+} | {
+    type: "done";
+    response: string;
+    thinking?: string;
+    usage: TokenUsage;
+    iterationsUsed: number;
+    history: Anthropic.MessageParam[];
+};
+export declare const DEFAULT_SYSTEM_INSTRUCTION = "You're Clawpify. You help run a Shopify store. The merchant texts you to get stuff done";
 export declare class ShopifyAgent {
     private anthropic;
     private shopify;
     private skillContent;
+    private systemInstruction;
     private model;
-    constructor(config: {
-        shopify: ShopifyClient;
-        skillContent: string;
-        model?: string;
-    });
-    chat(userMessage: string, conversationHistory?: Anthropic.MessageParam[]): Promise<{
-        response: string;
-        history: Anthropic.MessageParam[];
-    }>;
+    private pricing;
+    private plugins;
+    private hooks;
+    private thinkingConfig;
+    private maxIterations;
+    private memory;
+    constructor(config: AgentConfig);
+    /** Register a plugin at runtime. Throws if a tool with the same name already exists. */
+    registerPlugin(plugin: AgentPlugin): void;
+    /** Build the system prompt array with prompt caching. */
+    private buildSystemPrompt;
+    /** Build the tools list with cache_control on the last tool. */
+    private buildTools;
+    /** Compute max_tokens accounting for thinking budget. */
+    private getMaxTokens;
+    /** Build optional thinking param for the API call. */
+    private getThinkingParam;
+    /** Execute a single tool call by name. Returns content and error flag. */
+    private executeTool;
+    /** Process all tool_use blocks from a response, returning tool results. */
+    private processToolCalls;
+    /**
+     * Send a message and get a complete response (non-streaming).
+     * Runs the agentic tool-use loop until the model produces a final text response.
+     */
+    chat(userMessage: string, conversationHistory?: Anthropic.MessageParam[]): Promise<ChatResult>;
+    /**
+     * Send a message and stream the response as typed events.
+     * Same agentic loop as chat() but yields incremental text/thinking deltas.
+     */
+    chatStream(userMessage: string, conversationHistory?: Anthropic.MessageParam[]): AsyncGenerator<StreamEvent>;
+    /**
+     * Chat with automatic session memory.
+     * Loads conversation history from the memory store, runs chat(), and saves
+     * the updated history back. Requires a MemoryStore to be configured.
+     */
+    chatWithMemory(sessionId: string, userMessage: string): Promise<ChatResult>;
 }
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAsB1C,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,KAAK,CAAS;gBAEV,MAAM,EAAE;QAClB,OAAO,EAAE,aAAa,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;IAOK,IAAI,CACR,WAAW,EAAE,MAAM,EACnB,mBAAmB,GAAE,SAAS,CAAC,YAAY,EAAO,GACjD,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,SAAS,CAAC,YAAY,EAAE,CAAA;KAAE,CAAC;CAyFpE"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}

package/dist/agent.js

@@ -1,5 +1,6 @@
 // src/agent.ts
 import Anthropic from "@anthropic-ai/sdk";
+var DEFAULT_SYSTEM_INSTRUCTION = "You're Clawpify. You help run a Shopify store. The merchant texts you to get stuff done";
 var SHOPIFY_GRAPHQL_TOOL = {
   name: "shopify_graphql",
   description: "Execute a GraphQL query against the Shopify Admin API. Use this to interact with products, orders, customers, inventory, and other Shopify resources.",
@@ -18,82 +19,372 @@ var SHOPIFY_GRAPHQL_TOOL = {
     required: ["query"]
   }
 };
+var DEFAULT_PRICING = {
+  inputPerMillion: 3,
+  outputPerMillion: 15,
+  cacheWritePerMillion: 3.75,
+  cacheReadPerMillion: 0.3
+};
+var DEFAULT_MAX_ITERATIONS = 20;
+async function safeHook(hook, ...args) {
+  if (!hook)
+    return;
+  try {
+    await hook(...args);
+  } catch {}
+}
+function computeCost(usage, pricing) {
+  return usage.inputTokens * pricing.inputPerMillion / 1e6 + usage.outputTokens * pricing.outputPerMillion / 1e6 + usage.cacheCreationInputTokens * pricing.cacheWritePerMillion / 1e6 + usage.cacheReadInputTokens * pricing.cacheReadPerMillion / 1e6;
+}
+function emptyUsage() {
+  return {
+    inputTokens: 0,
+    outputTokens: 0,
+    cacheCreationInputTokens: 0,
+    cacheReadInputTokens: 0,
+    totalCost: 0
+  };
+}
+function accumulateUsage(total, raw, pricing) {
+  total.inputTokens += raw.input_tokens;
+  total.outputTokens += raw.output_tokens;
+  total.cacheCreationInputTokens += raw.cache_creation_input_tokens ?? 0;
+  total.cacheReadInputTokens += raw.cache_read_input_tokens ?? 0;
+  total.totalCost = computeCost(total, pricing);
+}
+function extractContent(response) {
+  let text = "";
+  let thinking = "";
+  for (const block of response.content) {
+    if (block.type === "text") {
+      text += (text ? `
+` : "") + block.text;
+    } else if (block.type === "thinking") {
+      thinking += (thinking ? `
+` : "") + block.thinking;
+    }
+  }
+  return { text, thinking };
+}
 
 class ShopifyAgent {
   anthropic;
   shopify;
   skillContent;
+  systemInstruction;
   model;
+  pricing;
+  plugins = new Map;
+  hooks;
+  thinkingConfig;
+  maxIterations;
+  memory;
   constructor(config) {
     this.anthropic = new Anthropic;
     this.shopify = config.shopify;
     this.skillContent = config.skillContent;
+    this.systemInstruction = config.systemInstruction ?? DEFAULT_SYSTEM_INSTRUCTION;
     this.model = config.model ?? "claude-sonnet-4-5";
+    this.pricing = config.pricing ?? DEFAULT_PRICING;
+    this.hooks = config.hooks ?? {};
+    this.thinkingConfig = config.thinking;
+    this.maxIterations = config.maxIterations ?? DEFAULT_MAX_ITERATIONS;
+    this.memory = config.memory;
+    if (config.plugins) {
+      for (const plugin of config.plugins) {
+        this.registerPlugin(plugin);
+      }
+    }
+  }
+  registerPlugin(plugin) {
+    const name = plugin.tool.name;
+    if (name === "shopify_graphql") {
+      throw new Error(`Cannot register plugin with reserved tool name "shopify_graphql"`);
+    }
+    if (this.plugins.has(name)) {
+      throw new Error(`Plugin with tool name "${name}" is already registered`);
+    }
+    this.plugins.set(name, plugin);
+  }
+  buildSystemPrompt() {
+    return [
+      { type: "text", text: this.systemInstruction },
+      {
+        type: "text",
+        text: this.skillContent,
+        cache_control: { type: "ephemeral" }
+      }
+    ];
+  }
+  buildTools() {
+    const allTools = [
+      SHOPIFY_GRAPHQL_TOOL,
+      ...[...this.plugins.values()].map((p) => p.tool)
+    ];
+    if (allTools.length > 0) {
+      const last = allTools[allTools.length - 1];
+      allTools[allTools.length - 1] = Object.assign({}, last, {
+        cache_control: { type: "ephemeral" }
+      });
+    }
+    return allTools;
+  }
+  getMaxTokens() {
+    return this.thinkingConfig ? this.thinkingConfig.budgetTokens + 4096 : 4096;
+  }
+  getThinkingParam() {
+    if (!this.thinkingConfig)
+      return {};
+    return {
+      thinking: {
+        type: "enabled",
+        budget_tokens: this.thinkingConfig.budgetTokens
+      }
+    };
+  }
+  async executeTool(name, input) {
+    await safeHook(this.hooks.onToolCall, name, input);
+    if (name === "shopify_graphql") {
+      try {
+        const result = await this.shopify.graphql(input.query, input.variables);
+        const content2 = JSON.stringify(result, null, 2);
+        await safeHook(this.hooks.onToolResult, name, content2, false);
+        return { content: content2, isError: false };
+      } catch (error) {
+        const content2 = `Error: ${error instanceof Error ? error.message : String(error)}`;
+        await safeHook(this.hooks.onToolResult, name, content2, true);
+        return { content: content2, isError: true };
+      }
+    }
+    if (this.plugins.has(name)) {
+      const plugin = this.plugins.get(name);
+      try {
+        const content2 = await plugin.handler(input);
+        await safeHook(this.hooks.onToolResult, name, content2, false);
+        return { content: content2, isError: false };
+      } catch (error) {
+        const content2 = `Error: ${error instanceof Error ? error.message : String(error)}`;
+        await safeHook(this.hooks.onToolResult, name, content2, true);
+        return { content: content2, isError: true };
+      }
+    }
+    const content = `Error: Unknown tool "${name}"`;
+    await safeHook(this.hooks.onToolResult, name, content, true);
+    return { content, isError: true };
+  }
+  async processToolCalls(response) {
+    const toolUseBlocks = response.content.filter((block) => block.type === "tool_use");
+    const toolResults = [];
+    for (const toolUse of toolUseBlocks) {
+      const input = toolUse.input;
+      const { content, isError } = await this.executeTool(toolUse.name, input);
+      toolResults.push({
+        type: "tool_result",
+        tool_use_id: toolUse.id,
+        content,
+        ...isError ? { is_error: true } : {}
+      });
+    }
+    return toolResults;
   }
   async chat(userMessage, conversationHistory = []) {
-    const systemPrompt = `You are a helpful Shopify assistant that can query and manage a Shopify store using the GraphQL Admin API.
-
-${this.skillContent}
-
-When the user asks about products, orders, customers, or any Shopify data, use the shopify_graphql tool to fetch or modify the data. Always explain what you're doing and present results clearly.`;
+    const usage = emptyUsage();
+    let iterationsUsed = 0;
+    let allThinking = "";
+    const systemPrompt = this.buildSystemPrompt();
+    const allTools = this.buildTools();
+    const maxTokens = this.getMaxTokens();
+    const thinkingParam = this.getThinkingParam();
     const messages = [
       ...conversationHistory,
       { role: "user", content: userMessage }
     ];
-    let response = await this.anthropic.messages.create({
-      model: this.model,
-      max_tokens: 4096,
-      system: systemPrompt,
-      tools: [SHOPIFY_GRAPHQL_TOOL],
-      messages
-    });
-    const assistantMessages = [];
-    while (response.stop_reason === "tool_use") {
-      const toolUseBlocks = response.content.filter((block) => block.type === "tool_use");
-      assistantMessages.push(...response.content);
-      const toolResults = [];
-      for (const toolUse of toolUseBlocks) {
-        if (toolUse.name === "shopify_graphql") {
-          const input = toolUse.input;
-          try {
-            const result = await this.shopify.graphql(input.query, input.variables);
-            toolResults.push({
+    await safeHook(this.hooks.onRequest, userMessage, conversationHistory);
+    try {
+      await safeHook(this.hooks.onApiCall, {
+        model: this.model,
+        messages,
+        tools: allTools
+      });
+      let response = await this.anthropic.messages.create({
+        model: this.model,
+        max_tokens: maxTokens,
+        system: systemPrompt,
+        tools: allTools,
+        messages,
+        ...thinkingParam
+      });
+      accumulateUsage(usage, response.usage, this.pricing);
+      const firstContent = extractContent(response);
+      if (firstContent.thinking)
+        allThinking += firstContent.thinking;
+      while (response.stop_reason === "tool_use") {
+        iterationsUsed++;
+        if (iterationsUsed > this.maxIterations) {
+          const err = new Error(`Agent exceeded maximum iterations (${this.maxIterations})`);
+          await safeHook(this.hooks.onError, err);
+          break;
+        }
+        messages.push({
+          role: "assistant",
+          content: response.content
+        });
+        const toolResults = await this.processToolCalls(response);
+        messages.push({ role: "user", content: toolResults });
+        await safeHook(this.hooks.onApiCall, {
+          model: this.model,
+          messages,
+          tools: allTools
+        });
+        response = await this.anthropic.messages.create({
+          model: this.model,
+          max_tokens: maxTokens,
+          system: systemPrompt,
+          tools: allTools,
+          messages,
+          ...thinkingParam
+        });
+        accumulateUsage(usage, response.usage, this.pricing);
+        const loopContent = extractContent(response);
+        if (loopContent.thinking) {
+          allThinking += (allThinking ? `
+` : "") + loopContent.thinking;
+        }
+      }
+      const { text: finalResponse } = extractContent(response);
+      const updatedHistory = [
+        ...messages,
+        { role: "assistant", content: response.content }
+      ];
+      await safeHook(this.hooks.onResponse, finalResponse, usage);
+      return {
+        response: finalResponse,
+        history: updatedHistory,
+        usage,
+        thinking: allThinking || undefined,
+        iterationsUsed
+      };
+    } catch (error) {
+      const err = error instanceof Error ? error : new Error(String(error));
+      await safeHook(this.hooks.onError, err);
+      throw err;
+    }
+  }
+  async* chatStream(userMessage, conversationHistory = []) {
+    const usage = emptyUsage();
+    let iterationsUsed = 0;
+    let allThinking = "";
+    let finalResponse = "";
+    const systemPrompt = this.buildSystemPrompt();
+    const allTools = this.buildTools();
+    const maxTokens = this.getMaxTokens();
+    const thinkingParam = this.getThinkingParam();
+    const messages = [
+      ...conversationHistory,
+      { role: "user", content: userMessage }
+    ];
+    await safeHook(this.hooks.onRequest, userMessage, conversationHistory);
+    try {
+      let stopReason = null;
+      do {
+        await safeHook(this.hooks.onApiCall, {
+          model: this.model,
+          messages,
+          tools: allTools
+        });
+        const stream = this.anthropic.messages.stream({
+          model: this.model,
+          max_tokens: maxTokens,
+          system: systemPrompt,
+          tools: allTools,
+          messages,
+          ...thinkingParam
+        });
+        for await (const event of stream) {
+          if (event.type === "content_block_delta") {
+            const delta = event.delta;
+            if (delta.type === "text_delta") {
+              yield { type: "text", text: delta.text };
+            } else if (delta.type === "thinking_delta") {
+              yield { type: "thinking", text: delta.thinking };
+            }
+          }
+        }
+        const response = await stream.finalMessage();
+        accumulateUsage(usage, response.usage, this.pricing);
+        stopReason = response.stop_reason;
+        const content = extractContent(response);
+        if (content.thinking) {
+          allThinking += (allThinking ? `
+` : "") + content.thinking;
+        }
+        if (content.text) {
+          finalResponse = content.text;
+        }
+        if (stopReason === "tool_use") {
+          iterationsUsed++;
+          if (iterationsUsed > this.maxIterations) {
+            const err = new Error(`Agent exceeded maximum iterations (${this.maxIterations})`);
+            await safeHook(this.hooks.onError, err);
+            break;
+          }
+          messages.push({
+            role: "assistant",
+            content: response.content
+          });
+          const toolUseBlocks = response.content.filter((block) => block.type === "tool_use");
+          const toolResults = [];
+          for (const toolUse of toolUseBlocks) {
+            const input = toolUse.input;
+            yield { type: "tool_call", name: toolUse.name, input };
+            const result = await this.executeTool(toolUse.name, input);
+            yield {
               type: "tool_result",
-              tool_use_id: toolUse.id,
-              content: JSON.stringify(result, null, 2)
-            });
-          } catch (error) {
+              name: toolUse.name,
+              result: result.content,
+              isError: result.isError
+            };
             toolResults.push({
               type: "tool_result",
               tool_use_id: toolUse.id,
-              content: `Error: ${error instanceof Error ? error.message : String(error)}`,
-              is_error: true
+              content: result.content,
+              ...result.isError ? { is_error: true } : {}
             });
           }
+          messages.push({ role: "user", content: toolResults });
+        } else {
+          messages.push({
+            role: "assistant",
+            content: response.content
+          });
         }
-      }
-      messages.push({ role: "assistant", content: assistantMessages.slice() });
-      messages.push({ role: "user", content: toolResults });
-      assistantMessages.length = 0;
-      response = await this.anthropic.messages.create({
-        model: this.model,
-        max_tokens: 4096,
-        system: systemPrompt,
-        tools: [SHOPIFY_GRAPHQL_TOOL],
-        messages
-      });
+      } while (stopReason === "tool_use");
+      await safeHook(this.hooks.onResponse, finalResponse, usage);
+      yield {
+        type: "done",
+        response: finalResponse,
+        thinking: allThinking || undefined,
+        usage,
+        iterationsUsed,
+        history: messages
+      };
+    } catch (error) {
+      const err = error instanceof Error ? error : new Error(String(error));
+      await safeHook(this.hooks.onError, err);
+      throw err;
     }
-    const textBlocks = response.content.filter((block) => block.type === "text");
-    const finalResponse = textBlocks.map((b) => b.text).join(`
-`);
-    const updatedHistory = [
-      ...messages,
-      { role: "assistant", content: response.content }
-    ];
-    return { response: finalResponse, history: updatedHistory };
+  }
+  async chatWithMemory(sessionId, userMessage) {
+    if (!this.memory) {
+      throw new Error("chatWithMemory requires a MemoryStore. Pass `memory` in AgentConfig.");
+    }
+    const history = await this.memory.load(sessionId);
+    const result = await this.chat(userMessage, history);
+    await this.memory.save(sessionId, result.history);
+    return result;
   }
 }
 export {
-  ShopifyAgent
+  ShopifyAgent,
+  DEFAULT_SYSTEM_INSTRUCTION
 };
-

package/dist/auth.js

@@ -54,4 +54,3 @@ export {
   getAccessToken,
   createAuthenticatedConfig
 };
-

package/dist/index.d.ts

@@ -35,7 +35,10 @@
  */
 export { ShopifyClient, createShopifyClient } from "./shopify";
 export { createAuthenticatedConfig, getAccessToken, type AccessTokenResponse, type ClientCredentialsConfig, } from "./auth";
-export { ShopifyAgent } from "./agent";
+export { ShopifyAgent, DEFAULT_SYSTEM_INSTRUCTION } from "./agent";
+export type { AgentConfig, AgentHooks, AgentPlugin, ChatResult, ModelPricing, StreamEvent, ThinkingConfig, TokenUsage, } from "./agent";
+export { InMemoryStore } from "./memory";
+export type { MemoryStore } from "./memory";
 export { loadSkills } from "./skills";
 export type { ShopifyClientConfig, GraphQLResponse } from "./shopify";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAG/D,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAG/D,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAE,YAAY,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AACnE,YAAY,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}