@clawpify/skills 1.0.4 → 1.0.5

package/dist/index.js

@@ -6,7 +6,7 @@ class ShopifyClient {
   constructor(config) {
     this.storeUrl = config.storeUrl.replace(/^https?:\/\//, "").replace(/\/$/, "");
     this.accessToken = config.accessToken;
-    this.apiVersion = config.apiVersion ?? "2026-01";
+    this.apiVersion = config.apiVersion ?? "2026-04";
   }
   async graphql(query, variables) {
     const url = `https://${this.storeUrl}/admin/api/${this.apiVersion}/graphql.json`;
@@ -89,6 +89,7 @@ async function createAuthenticatedConfig() {
 
 // 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.",
@@ -107,79 +108,384 @@ 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;
+  }
+}
+
+// src/memory.ts
+class InMemoryStore {
+  store = new Map;
+  async save(sessionId, history) {
+    this.store.set(sessionId, structuredClone(history));
+  }
+  async load(sessionId) {
+    const data = this.store.get(sessionId);
+    return data ? structuredClone(data) : [];
+  }
+  async clear(sessionId) {
+    this.store.delete(sessionId);
   }
 }
 
@@ -220,5 +526,7 @@ export {
   createShopifyClient,
   createAuthenticatedConfig,
   ShopifyClient,
-  ShopifyAgent
+  ShopifyAgent,
+  InMemoryStore,
+  DEFAULT_SYSTEM_INSTRUCTION
 };

package/dist/mcp-server.js

@@ -8,7 +8,7 @@ class ShopifyClient {
   constructor(config) {
     this.storeUrl = config.storeUrl.replace(/^https?:\/\//, "").replace(/\/$/, "");
     this.accessToken = config.accessToken;
-    this.apiVersion = config.apiVersion ?? "2026-01";
+    this.apiVersion = config.apiVersion ?? "2026-04";
   }
   async graphql(query, variables) {
     const url = `https://${this.storeUrl}/admin/api/${this.apiVersion}/graphql.json`;

package/dist/memory.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Interface for persisting conversation history across sessions.
+ * Implement this interface to plug in any storage backend (Redis, SQLite, etc.).
+ *
+ * History is stored as raw MessageParam arrays — the same type the agent
+ * accepts and returns — so round-tripping is lossless.
+ */
+export interface MemoryStore {
+    /** Save conversation history for a session. */
+    save(sessionId: string, history: any[]): Promise<void>;
+    /** Load conversation history for a session. Returns empty array if not found. */
+    load(sessionId: string): Promise<any[]>;
+    /** Clear conversation history for a session. */
+    clear(sessionId: string): Promise<void>;
+}
+/**
+ * Simple in-memory implementation of MemoryStore.
+ * Data is lost when the process restarts — use for dev/testing only.
+ */
+export declare class InMemoryStore implements MemoryStore {
+    private store;
+    save(sessionId: string, history: any[]): Promise<void>;
+    load(sessionId: string): Promise<any[]>;
+    clear(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD,iFAAiF;IACjF,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAExC,gDAAgD;IAChD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,qBAAa,aAAc,YAAW,WAAW;IAC/C,OAAO,CAAC,KAAK,CAA4B;IAEnC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAKvC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9C"}

package/dist/memory.js

@@ -0,0 +1,17 @@
+// src/memory.ts
+class InMemoryStore {
+  store = new Map;
+  async save(sessionId, history) {
+    this.store.set(sessionId, structuredClone(history));
+  }
+  async load(sessionId) {
+    const data = this.store.get(sessionId);
+    return data ? structuredClone(data) : [];
+  }
+  async clear(sessionId) {
+    this.store.delete(sessionId);
+  }
+}
+export {
+  InMemoryStore
+};

package/dist/shopify.d.ts

@@ -3,7 +3,7 @@ export interface ShopifyClientConfig {
     storeUrl: string;
     /** Admin API access token */
     accessToken: string;
-    /** API version (defaults to "2026-01") */
+    /** API version (defaults to "2026-04") */
     apiVersion?: string;
 }
 export interface GraphQLResponse<T = any> {

package/dist/shopify.js

@@ -6,7 +6,7 @@ class ShopifyClient {
   constructor(config) {
     this.storeUrl = config.storeUrl.replace(/^https?:\/\//, "").replace(/\/$/, "");
     this.accessToken = config.accessToken;
-    this.apiVersion = config.apiVersion ?? "2026-01";
+    this.apiVersion = config.apiVersion ?? "2026-04";
   }
   async graphql(query, variables) {
     const url = `https://${this.storeUrl}/admin/api/${this.apiVersion}/graphql.json`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawpify/skills",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Shopify Agent SDK — query and manage Shopify stores via GraphQL Admin API with AI agents and MCP",
   "type": "module",
   "main": "./dist/index.js",
@@ -35,6 +35,12 @@
       "bun": "./src/skills.ts",
       "import": "./dist/skills.js",
       "default": "./dist/skills.js"
+    },
+    "./memory": {
+      "types": "./dist/memory.d.ts",
+      "bun": "./src/memory.ts",
+      "import": "./dist/memory.js",
+      "default": "./dist/memory.js"
     }
   },
   "bin": {
@@ -46,7 +52,7 @@
     "clawpify"
   ],
   "scripts": {
-    "build": "rm -rf dist && bun build ./src/index.ts ./src/agent.ts ./src/shopify.ts ./src/auth.ts ./src/skills.ts ./src/mcp-server.ts --outdir ./dist --target node --format esm --external @anthropic-ai/sdk --external @modelcontextprotocol/sdk && tsc -p tsconfig.build.json",
+    "build": "rm -rf dist && bun build ./src/index.ts ./src/agent.ts ./src/shopify.ts ./src/auth.ts ./src/skills.ts ./src/memory.ts ./src/mcp-server.ts --outdir ./dist --target node --format esm --external @anthropic-ai/sdk --external @modelcontextprotocol/sdk && tsc -p tsconfig.build.json",
     "prepublishOnly": "bun run build",
     "start": "bun run examples/server.ts"
   },