dsclaw 0.1.0 → 0.1.1

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import pLimit from 'p-limit';
 import { Job } from 'bullmq';
 
 /**
- * Structured error classification for DropClaw.
+ * Structured error classification for DSClaw.
  * Every error flowing through the system must have a category
  * so upstream layers (agents, channels) know how to react.
  */
@@ -25,7 +25,7 @@ interface StructuredError {
     details?: Record<string, unknown>;
     cause?: Error;
 }
-declare class DropClawError extends Error {
+declare class DSClawError extends Error {
     readonly category: ErrorCategory;
     readonly code: string;
     readonly retryable: boolean;
@@ -101,9 +101,9 @@ declare const ConfigSchema: z.ZodObject<{
     port: z.ZodDefault<z.ZodNumber>;
     telegramBotToken: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-type DropClawConfig = z.infer<typeof ConfigSchema>;
-declare function loadConfig(path?: string): DropClawConfig;
-declare function saveConfig(config: DropClawConfig): void;
+type DSClawConfig = z.infer<typeof ConfigSchema>;
+declare function loadConfig(path?: string): DSClawConfig;
+declare function saveConfig(config: DSClawConfig): void;
 
 /**
  * User session state machine + encrypted credential storage.
@@ -126,7 +126,7 @@ declare function deleteSession(userId: string): void;
 declare function isOnboarding(state: SessionState): boolean;
 
 /**
- * DropClaw Gateway — central orchestrator.
+ * DSClaw Gateway — central orchestrator.
  *
  * Flow:
  *   1. User opens web chat (or sends Telegram message)
@@ -138,7 +138,7 @@ declare function isOnboarding(state: SessionState): boolean;
  * Telegram is optional (requires bot token in config).
  */
 
-declare class DropClawGateway {
+declare class DSClawGateway {
     private config;
     private channels;
     private webChannel;
@@ -146,9 +146,10 @@ declare class DropClawGateway {
     private agents;
     private dsersClients;
     private running;
-    constructor(config: DropClawConfig);
+    constructor(config: DSClawConfig);
     start(): Promise<void>;
     private handleMessage;
+    private handleWebConnect;
     private handleOnboarding;
     private onboardWelcome;
     private onboardEmail;
@@ -222,11 +223,13 @@ interface ChannelAdapter {
  * Supports streaming for Claude-like token-by-token output.
  */
 
+type ConnectHandler = (userId: string) => void;
 declare class WebChatServer implements ChannelAdapter {
     readonly name = "web";
     private server;
     private wss;
     private handler;
+    private connectHandler;
     private connections;
     private _connected;
     private port;
@@ -235,6 +238,7 @@ declare class WebChatServer implements ChannelAdapter {
     disconnect(): Promise<void>;
     reconnect(): Promise<void>;
     onMessage(handler: MessageHandler): void;
+    onConnect(handler: ConnectHandler): void;
     send(targetUserId: string, message: OutboundMessage): Promise<void>;
     sendCard(targetUserId: string, card: ActionCard): Promise<void>;
     deleteMessage(): Promise<void>;
@@ -288,7 +292,7 @@ declare class DSersClient {
 
 /**
  * Core DSers domain types extracted from the OpenAPI spec.
- * Covers the essential entities for the DropClaw workflow.
+ * Covers the essential entities for the DSClaw workflow.
  */
 interface DSersStore {
     id: string;
@@ -425,7 +429,7 @@ interface MemoryProvider {
 }
 
 /**
- * DropClaw Core Agent — unified prototype agent using Vercel AI SDK.
+ * DSClaw Core Agent — unified prototype agent using Vercel AI SDK.
  * Created per-user with their own DSers client and LLM config.
  * System prompt targets zero-technical-ability dropshipping users.
  */
@@ -436,9 +440,9 @@ interface LLMConfig {
     model: string;
 }
 declare function getDefaultModel(provider: string): string;
-declare class DropClawCoreAgent implements AgentBase {
-    readonly id = "dropclaw-core";
-    readonly name = "DropClaw Core Agent";
+declare class DSClawCoreAgent implements AgentBase {
+    readonly id = "dsclaw-core";
+    readonly name = "DSClaw Core Agent";
     private dsers;
     private memory;
     private llm;
@@ -675,7 +679,7 @@ interface RuleEngine {
 
 /**
  * OpenClaw plugin manifest and version compatibility.
- * DropClaw registers as an OpenClaw plugin via Plugin SDK
+ * DSClaw registers as an OpenClaw plugin via Plugin SDK
  * when running inside an OpenClaw gateway.
  */
 interface PluginManifest {
@@ -689,7 +693,7 @@ interface PluginManifest {
     providers: string[];
     skills: string[];
 }
-declare const DROPCLAW_MANIFEST: PluginManifest;
+declare const DSCLAW_MANIFEST: PluginManifest;
 
 /**
  * Version compatibility check against OpenClaw runtime.
@@ -697,11 +701,11 @@ declare const DROPCLAW_MANIFEST: PluginManifest;
  */
 interface CompatEntry {
     openclawVersion: string;
-    dropclawVersion: string;
+    dsclawVersion: string;
     status: "tested" | "untested" | "incompatible";
     notes?: string;
 }
 declare const COMPAT_MATRIX: CompatEntry[];
 declare function checkCompatibility(openclawVersion: string): CompatEntry | null;
 
-export { type ActionCard, type AgentBase, type AgentContext, type AgentResponse, type AgentTool, BullMQJobManager, COMPAT_MATRIX, type ChannelAdapter, ConfigSchema, DROPCLAW_MANIFEST, DSersClient, type DSersClientConfig, type DSersOrder, type DSersProduct, type DSersStore, type DSersVariant, type DropClawConfig, DropClawCoreAgent, DropClawError, DropClawGateway, ErrorCategory, FileMemoryProvider, type JobManager, type JobPayload, type JobStatus, type LLMConfig, type Memory, type MemoryFilter, type MemoryMeta, type MemoryProvider, type NormalizedMessage, type OutboundMessage, type PushResult, type RetryOptions, type Rule, type RuleEngine, type RuleEvaluationResult, type SessionState, type StructuredError, TelegramAdapter, type UserSessionData, WebChatServer, acquireUserLock, auditFilePath, checkCompatibility, checkInboundLimit, createCircuitBreaker, createDSersConfig, createLogger, debounceUser, degradationMessage, deleteSession, getAllBreakerStatus, getDefaultModel, getDegradationStatus, getOutboundLimiter, getTraceContext, getTraceId, idempotencyKey, isDegraded, isOnboarding, loadConfig, loadSession, markDegraded, markRecovered, parseRetryAfter, runWithTrace, saveConfig, saveSession, sleep, withRetry, writeAuditLog };
+export { type ActionCard, type AgentBase, type AgentContext, type AgentResponse, type AgentTool, BullMQJobManager, COMPAT_MATRIX, type ChannelAdapter, ConfigSchema, DSCLAW_MANIFEST, type DSClawConfig, DSClawCoreAgent, DSClawError, DSClawGateway, DSersClient, type DSersClientConfig, type DSersOrder, type DSersProduct, type DSersStore, type DSersVariant, ErrorCategory, FileMemoryProvider, type JobManager, type JobPayload, type JobStatus, type LLMConfig, type Memory, type MemoryFilter, type MemoryMeta, type MemoryProvider, type NormalizedMessage, type OutboundMessage, type PushResult, type RetryOptions, type Rule, type RuleEngine, type RuleEvaluationResult, type SessionState, type StructuredError, TelegramAdapter, type UserSessionData, WebChatServer, acquireUserLock, auditFilePath, checkCompatibility, checkInboundLimit, createCircuitBreaker, createDSersConfig, createLogger, debounceUser, degradationMessage, deleteSession, getAllBreakerStatus, getDefaultModel, getDegradationStatus, getOutboundLimiter, getTraceContext, getTraceId, idempotencyKey, isDegraded, isOnboarding, loadConfig, loadSession, markDegraded, markRecovered, parseRetryAfter, runWithTrace, saveConfig, saveSession, sleep, withRetry, writeAuditLog };

package/dist/index.js

@@ -20670,14 +20670,14 @@ var ErrorCategory = {
   FATAL: "FATAL",
   DEGRADED: "DEGRADED"
 };
-var DropClawError = class extends Error {
+var DSClawError = class extends Error {
   category;
   code;
   retryable;
   details;
   constructor(opts) {
     super(opts.message);
-    this.name = "DropClawError";
+    this.name = "DSClawError";
     this.category = opts.category;
     this.code = opts.code;
     this.retryable = opts.retryable;
@@ -20768,7 +20768,7 @@ import { join } from "path";
 import { homedir } from "os";
 import { z } from "zod";
 var log = createLogger("config");
-var CONFIG_DIR = join(homedir(), ".dropclaw");
+var CONFIG_DIR = join(homedir(), ".dsclaw");
 var CONFIG_PATH = join(CONFIG_DIR, "config.json");
 var ConfigSchema = z.object({
   port: z.number().default(3e3),
@@ -20847,7 +20847,7 @@ var log2 = createLogger("user-session");
 var ALG = "aes-256-gcm";
 var IV_LEN = 12;
 var TAG_LEN = 16;
-var KEY_SEED = "dropclaw-v1";
+var KEY_SEED = "dsclaw-v1";
 var SESSIONS_DIR = join3(CONFIG_DIR, "sessions");
 function deriveKey() {
   let user = "";
@@ -20960,7 +20960,7 @@ var DSersAuth = class {
   }
   async login() {
     if (!this.config.email || !this.config.password) {
-      throw new DropClawError({
+      throw new DSClawError({
         category: ErrorCategory.NEEDS_HUMAN,
         code: "DSERS_NO_CREDENTIALS",
         message: "DSers email and password not configured.",
@@ -20981,7 +20981,7 @@ var DSersAuth = class {
     );
     if (!resp.ok) {
       const body = await resp.text();
-      throw new DropClawError({
+      throw new DSClawError({
         category: resp.status === 401 || resp.status === 403 ? ErrorCategory.NEEDS_HUMAN : ErrorCategory.RETRYABLE,
         code: `DSERS_LOGIN_${resp.status}`,
         message: `DSers login failed (HTTP ${resp.status}): ${body.slice(0, 200)}`,
@@ -20991,7 +20991,7 @@ var DSersAuth = class {
     const data = await resp.json();
     const inner = data["data"];
     if (!inner?.["sessionId"]) {
-      throw new DropClawError({
+      throw new DSClawError({
         category: ErrorCategory.NEEDS_HUMAN,
         code: "DSERS_LOGIN_NO_SESSION",
         message: "DSers login succeeded but no session returned.",
@@ -21173,7 +21173,7 @@ var DSersClient = class {
       }
       if (resp.status >= 400) {
         const category = classifyHttpError(resp.status, bodyText);
-        throw new DropClawError({
+        throw new DSClawError({
           category,
           code: `DSERS_API_${resp.status}`,
           message: `DSers API ${method} ${path3} returned ${resp.status}: ${bodyText.slice(0, 300)}`,
@@ -21280,7 +21280,7 @@ function getDefaultModel(provider) {
       return "gpt-4o";
   }
 }
-var SYSTEM_PROMPT = `You are DropClaw, a friendly AI assistant that manages dropshipping stores through DSers.
+var SYSTEM_PROMPT = `You are DSClaw, a friendly AI assistant that manages dropshipping stores through DSers.
 Your user has ZERO technical background \u2014 they are a small business owner or solo entrepreneur.
 
 COMMUNICATION RULES:
@@ -21306,9 +21306,9 @@ GUIDELINES:
 - For bulk operations, show a preview and ask for confirmation
 - Use simple summaries: "You have 15 products waiting to be pushed" instead of raw JSON
 - If the user seems confused, offer guided suggestions like "Would you like me to show your stores first?"`;
-var DropClawCoreAgent = class {
-  id = "dropclaw-core";
-  name = "DropClaw Core Agent";
+var DSClawCoreAgent = class {
+  id = "dsclaw-core";
+  name = "DSClaw Core Agent";
   dsers;
   memory;
   llm;
@@ -21620,6 +21620,7 @@ var WebChatServer = class {
   server = null;
   wss = null;
   handler = null;
+  connectHandler = null;
   connections = /* @__PURE__ */ new Map();
   _connected = false;
   port = 3e3;
@@ -21653,6 +21654,13 @@ var WebChatServer = class {
       this.wsSend(ws, { type: "session", userId: clientId });
       this.connections.set(clientId, ws);
       log7.info({ userId: clientId }, "Web client connected");
+      if (this.connectHandler) {
+        try {
+          this.connectHandler(clientId);
+        } catch (err) {
+          log7.error({ error: err, userId: clientId }, "Connect handler failed");
+        }
+      }
       ws.on("message", async (raw) => {
         try {
           const msg = JSON.parse(raw.toString());
@@ -21715,6 +21723,9 @@ var WebChatServer = class {
   onMessage(handler) {
     this.handler = handler;
   }
+  onConnect(handler) {
+    this.connectHandler = handler;
+  }
   async send(targetUserId, message) {
     if (message.card) {
       await this.sendCard(targetUserId, message.card);
@@ -22054,7 +22065,7 @@ function degradationMessage(service) {
 var log11 = createLogger("gateway");
 var sessionHistories = /* @__PURE__ */ new Map();
 var MAX_HISTORY = 20;
-var DropClawGateway = class {
+var DSClawGateway = class {
   config;
   channels = [];
   webChannel = null;
@@ -22067,9 +22078,10 @@ var DropClawGateway = class {
     this.memory = new FileMemoryProvider();
   }
   async start() {
-    log11.info("Starting DropClaw Gateway...");
+    log11.info("Starting DSClaw Gateway...");
     const web = new WebChatServer();
     web.onMessage((msg) => this.handleMessage(web, msg));
+    web.onConnect((userId) => this.handleWebConnect(web, userId));
     await web.connect({ port: this.config.port });
     this.webChannel = web;
     this.channels.push(web);
@@ -22086,7 +22098,7 @@ var DropClawGateway = class {
       }
     }
     this.running = true;
-    log11.info("DropClaw Gateway started");
+    log11.info("DSClaw Gateway started");
   }
   async handleMessage(channel, message) {
     await runWithTrace(
@@ -22126,6 +22138,15 @@ var DropClawGateway = class {
       }
     );
   }
+  // ─── Auto-welcome on WebSocket connect ──────────────────────────
+  handleWebConnect(channel, userId) {
+    const session = loadSession(userId);
+    if (session.state === "new") {
+      this.onboardWelcome(channel, userId, session).catch((err) => {
+        log11.error({ error: err, userId }, "Auto-welcome failed");
+      });
+    }
+  }
   // ─── Onboarding State Machine ─────────────────────────────────────
   async handleOnboarding(channel, message, session) {
     const userId = message.userId;
@@ -22149,7 +22170,7 @@ var DropClawGateway = class {
     }
   }
   async onboardWelcome(channel, userId, session) {
-    const welcome = "Welcome to *DropClaw*! I'm your AI assistant for dropshipping.\n\nI can help you:\n- Import products from AliExpress, Temu, 1688\n- Push products to your Shopify/WooCommerce store\n- Check inventory, pricing rules, and orders\n- ...all through this chat!\n\nLet's get you set up. It takes about 1 minute.\n\n*Step 1/3:* What is your DSers account email?";
+    const welcome = "Welcome to *DSClaw*! I'm your AI assistant for dropshipping.\n\nI can help you:\n- Import products from AliExpress, Temu, 1688\n- Push products to your Shopify/WooCommerce store\n- Check inventory, pricing rules, and orders\n- ...all through this chat!\n\nLet's get you set up. It takes about 1 minute.\n\n*Step 1/3:* What is your DSers account email?";
     await channel.send(userId, { text: welcome });
     session.state = "onboard_dsers_email";
     saveSession(userId, session);
@@ -22201,11 +22222,11 @@ var DropClawGateway = class {
       await channel.send(userId, {
         card: {
           title: "DSers Connected!",
-          summary: "Your DSers account is verified.\n\n*Step 3/3:* Choose your AI provider.\nThis powers my intelligence. You can get a free API key from any provider.",
+          summary: "Your DSers account is verified.\n\n*Step 3/3:* Choose your AI provider and paste your API key.\nYou only need a key \u2014 DSClaw handles everything else.\n\nGet a free key here:\n- **OpenAI**: [platform.openai.com/api-keys](https://platform.openai.com/api-keys)\n- **Anthropic**: [console.anthropic.com/settings/keys](https://console.anthropic.com/settings/keys)\n- **Google** (recommended, free tier): [aistudio.google.com/apikey](https://aistudio.google.com/apikey)",
           actions: [
             { label: "OpenAI (GPT-4o)", callbackData: "llm:openai" },
             { label: "Anthropic (Claude)", callbackData: "llm:anthropic" },
-            { label: "Google (Gemini)", callbackData: "llm:google" }
+            { label: "Google (Gemini) \u2605", callbackData: "llm:google" }
           ]
         }
       });
@@ -22236,11 +22257,11 @@ var DropClawGateway = class {
       await channel.send(userId, {
         card: {
           title: "Choose AI Provider",
-          summary: "Please select your AI provider first:",
+          summary: "Please select your AI provider first.\n\nGet a free key:\n- **OpenAI**: [platform.openai.com/api-keys](https://platform.openai.com/api-keys)\n- **Anthropic**: [console.anthropic.com/settings/keys](https://console.anthropic.com/settings/keys)\n- **Google** (recommended): [aistudio.google.com/apikey](https://aistudio.google.com/apikey)",
           actions: [
             { label: "OpenAI (GPT-4o)", callbackData: "llm:openai" },
             { label: "Anthropic (Claude)", callbackData: "llm:anthropic" },
-            { label: "Google (Gemini)", callbackData: "llm:google" }
+            { label: "Google (Gemini) \u2605", callbackData: "llm:google" }
           ]
         }
       });
@@ -22265,7 +22286,7 @@ var DropClawGateway = class {
     session.state = "ready";
     saveSession(userId, session);
     await channel.send(userId, {
-      text: `All set! DropClaw is ready.
+      text: `All set! DSClaw is ready.
 
 Try these:
 - "Show me my stores"
@@ -22399,17 +22420,17 @@ Just type naturally \u2014 I understand everyday language!`
       apiKey: session.llmApiKey,
       model: session.llmModel ?? getDefaultModel(session.llmProvider)
     };
-    agent = new DropClawCoreAgent(dsersClient, this.memory, llm);
+    agent = new DSClawCoreAgent(dsersClient, this.memory, llm);
     this.agents.set(userId, agent);
     return agent;
   }
   async stop() {
-    log11.info("Stopping DropClaw Gateway...");
+    log11.info("Stopping DSClaw Gateway...");
     for (const ch of this.channels) {
       await ch.disconnect();
     }
     this.running = false;
-    log11.info("DropClaw Gateway stopped");
+    log11.info("DSClaw Gateway stopped");
   }
   isRunning() {
     return this.running;
@@ -22489,7 +22510,7 @@ var DEFAULT_OPTIONS = {
   retryableCategories: ["RETRYABLE"]
 };
 function isRetryable(error, categories) {
-  if (error instanceof DropClawError) {
+  if (error instanceof DSClawError) {
     return categories.includes(error.category);
   }
   return false;
@@ -39920,7 +39941,7 @@ var ClientType;
 // src/queue/manager.ts
 var import_ioredis3 = __toESM(require_built3(), 1);
 var log14 = createLogger("queue");
-var QUEUE_PREFIX = "dropclaw";
+var QUEUE_PREFIX = "dsclaw";
 var BullMQJobManager = class {
   highQueue;
   lowQueue;
@@ -40053,9 +40074,9 @@ var BullMQJobManager = class {
 };
 
 // src/plugins/manifest.ts
-var DROPCLAW_MANIFEST = {
-  id: "dropclaw",
-  name: "DropClaw",
+var DSCLAW_MANIFEST = {
+  id: "dsclaw",
+  name: "DSClaw",
   description: "DSers dropshipping integration for OpenClaw \u2014 product import, order management, logistics tracking via AI agents.",
   version: "0.1.0",
   configSchema: {
@@ -40078,7 +40099,7 @@ var log15 = createLogger("compat");
 var COMPAT_MATRIX = [
   {
     openclawVersion: "2026.3.12",
-    dropclawVersion: "0.1.0",
+    dsclawVersion: "0.1.0",
     status: "tested",
     notes: "Initial release, aligned with stability patch"
   }
@@ -40106,11 +40127,11 @@ export {
   BullMQJobManager,
   COMPAT_MATRIX,
   ConfigSchema,
-  DROPCLAW_MANIFEST,
+  DSCLAW_MANIFEST,
+  DSClawCoreAgent,
+  DSClawError,
+  DSClawGateway,
   DSersClient,
-  DropClawCoreAgent,
-  DropClawError,
-  DropClawGateway,
   ErrorCategory,
   FileMemoryProvider,
   TelegramAdapter,