@witqq/agent-sdk 0.6.0 → 0.7.0

package/dist/chat/storage.js

@@ -0,0 +1,236 @@
+import { existsSync, readdirSync, unlinkSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+
+// src/chat/storage.ts
+
+// src/errors.ts
+var AgentSDKError = class extends Error {
+  /** @internal Marker for cross-bundle identity checks */
+  _agentSDKError = true;
+  constructor(message, options) {
+    super(message, options);
+    this.name = "AgentSDKError";
+  }
+  /** Check if an error is an AgentSDKError (works across bundled copies) */
+  static is(error) {
+    return error instanceof Error && "_agentSDKError" in error && error._agentSDKError === true;
+  }
+};
+
+// src/chat/storage.ts
+var StorageError = class extends AgentSDKError {
+  /** Machine-readable error code */
+  code;
+  constructor(message, code) {
+    super(message);
+    this.name = "StorageError";
+    this.code = code;
+  }
+};
+var InMemoryStorage = class {
+  data = /* @__PURE__ */ new Map();
+  /** @inheritdoc */
+  async get(key) {
+    const item = this.data.get(key);
+    return item !== void 0 ? structuredClone(item) : null;
+  }
+  /** @inheritdoc */
+  async list(options) {
+    let items = Array.from(this.data.values()).map((item) => structuredClone(item));
+    if (options?.filter) {
+      items = items.filter(options.filter);
+    }
+    if (options?.sort) {
+      items.sort(options.sort);
+    }
+    if (options?.offset !== void 0) {
+      items = items.slice(options.offset);
+    }
+    if (options?.limit !== void 0) {
+      items = items.slice(0, options.limit);
+    }
+    return items;
+  }
+  /** @inheritdoc */
+  async create(key, item) {
+    if (this.data.has(key)) {
+      throw new StorageError(
+        `Item with key "${key}" already exists`,
+        "DUPLICATE_KEY"
+      );
+    }
+    this.data.set(key, structuredClone(item));
+  }
+  /** @inheritdoc */
+  async update(key, item) {
+    if (!this.data.has(key)) {
+      throw new StorageError(
+        `Item with key "${key}" not found`,
+        "NOT_FOUND"
+      );
+    }
+    this.data.set(key, structuredClone(item));
+  }
+  /** @inheritdoc */
+  async delete(key) {
+    if (!this.data.has(key)) {
+      throw new StorageError(
+        `Item with key "${key}" not found`,
+        "NOT_FOUND"
+      );
+    }
+    this.data.delete(key);
+  }
+  /** @inheritdoc */
+  async has(key) {
+    return this.data.has(key);
+  }
+  /** @inheritdoc */
+  async count() {
+    return this.data.size;
+  }
+  /** @inheritdoc */
+  async clear() {
+    this.data.clear();
+  }
+};
+var FileStorage = class {
+  directory;
+  extension;
+  constructor(options) {
+    this.directory = options.directory;
+    this.extension = options.extension ?? ".json";
+    this.ensureDirectory();
+  }
+  /** @inheritdoc */
+  async get(key) {
+    const filePath = this.keyToPath(key);
+    if (!existsSync(filePath)) {
+      return null;
+    }
+    return this.readFile(filePath);
+  }
+  /** @inheritdoc */
+  async list(options) {
+    this.ensureDirectory();
+    const files = readdirSync(this.directory).filter(
+      (f) => f.endsWith(this.extension)
+    );
+    let items = [];
+    for (const file of files) {
+      const item = this.readFile(join(this.directory, file));
+      items.push(item);
+    }
+    if (options?.filter) {
+      items = items.filter(options.filter);
+    }
+    if (options?.sort) {
+      items.sort(options.sort);
+    }
+    if (options?.offset !== void 0) {
+      items = items.slice(options.offset);
+    }
+    if (options?.limit !== void 0) {
+      items = items.slice(0, options.limit);
+    }
+    return items;
+  }
+  /** @inheritdoc */
+  async create(key, item) {
+    const filePath = this.keyToPath(key);
+    if (existsSync(filePath)) {
+      throw new StorageError(
+        `Item with key "${key}" already exists`,
+        "DUPLICATE_KEY"
+      );
+    }
+    this.writeFile(filePath, item);
+  }
+  /** @inheritdoc */
+  async update(key, item) {
+    const filePath = this.keyToPath(key);
+    if (!existsSync(filePath)) {
+      throw new StorageError(
+        `Item with key "${key}" not found`,
+        "NOT_FOUND"
+      );
+    }
+    this.writeFile(filePath, item);
+  }
+  /** @inheritdoc */
+  async delete(key) {
+    const filePath = this.keyToPath(key);
+    if (!existsSync(filePath)) {
+      throw new StorageError(
+        `Item with key "${key}" not found`,
+        "NOT_FOUND"
+      );
+    }
+    unlinkSync(filePath);
+  }
+  /** @inheritdoc */
+  async has(key) {
+    return existsSync(this.keyToPath(key));
+  }
+  /** @inheritdoc */
+  async count() {
+    this.ensureDirectory();
+    return readdirSync(this.directory).filter(
+      (f) => f.endsWith(this.extension)
+    ).length;
+  }
+  /** @inheritdoc */
+  async clear() {
+    this.ensureDirectory();
+    const files = readdirSync(this.directory).filter(
+      (f) => f.endsWith(this.extension)
+    );
+    for (const file of files) {
+      unlinkSync(join(this.directory, file));
+    }
+  }
+  keyToPath(key) {
+    const safeKey = key.replace(
+      /[^a-zA-Z0-9_-]/g,
+      (c) => "%" + c.charCodeAt(0).toString(16).padStart(2, "0")
+    );
+    return join(this.directory, `${safeKey}${this.extension}`);
+  }
+  ensureDirectory() {
+    if (!existsSync(this.directory)) {
+      mkdirSync(this.directory, { recursive: true });
+    }
+  }
+  readFile(filePath) {
+    try {
+      const content = readFileSync(filePath, "utf-8");
+      return JSON.parse(content);
+    } catch (error) {
+      if (error instanceof SyntaxError) {
+        throw new StorageError(
+          `Failed to parse file: ${filePath}`,
+          "SERIALIZATION_ERROR"
+        );
+      }
+      throw new StorageError(
+        `Failed to read file: ${filePath}`,
+        "IO_ERROR"
+      );
+    }
+  }
+  writeFile(filePath, item) {
+    try {
+      const content = JSON.stringify(item, null, 2);
+      writeFileSync(filePath, content, "utf-8");
+    } catch {
+      throw new StorageError(
+        `Failed to write file: ${filePath}`,
+        "IO_ERROR"
+      );
+    }
+  }
+};
+
+export { FileStorage, InMemoryStorage, StorageError };
+//# sourceMappingURL=storage.js.map
+//# sourceMappingURL=storage.js.map

package/dist/chat/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors.ts","../../src/chat/storage.ts"],"names":[],"mappings":";;;;;;AAIO,IAAM,aAAA,GAAN,cAA4B,KAAA,CAAM;AAAA;AAAA,EAE9B,cAAA,GAAiB,IAAA;AAAA,EAE1B,WAAA,CAAY,SAAiB,OAAA,EAAwB;AACnD,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA;AACtB,IAAA,IAAA,CAAK,IAAA,GAAO,eAAA;AAAA,EACd;AAAA;AAAA,EAGA,OAAO,GAAG,KAAA,EAAwC;AAChD,IAAA,OACE,KAAA,YAAiB,KAAA,IACjB,gBAAA,IAAoB,KAAA,IACnB,MAAwB,cAAA,KAAmB,IAAA;AAAA,EAEhD;AACF,CAAA;;;ACOO,IAAM,YAAA,GAAN,cAA2B,aAAA,CAAc;AAAA;AAAA,EAErC,IAAA;AAAA,EAET,WAAA,CAAY,SAAiB,IAAA,EAAwB;AACnD,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,cAAA;AACZ,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AACF;AAgHO,IAAM,kBAAN,MAAuD;AAAA,EAC3C,IAAA,uBAAW,GAAA,EAAe;AAAA;AAAA,EAG3C,MAAM,IAAI,GAAA,EAAgC;AACxC,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,GAAG,CAAA;AAC9B,IAAA,OAAO,IAAA,KAAS,MAAA,GAAY,eAAA,CAAgB,IAAI,CAAA,GAAI,IAAA;AAAA,EACtD;AAAA;AAAA,EAGA,MAAM,KAAK,OAAA,EAAwC;AACjD,IAAA,IAAI,KAAA,GAAQ,KAAA,CAAM,IAAA,CAAK,IAAA,CAAK,IAAA,CAAK,MAAA,EAAQ,CAAA,CAAE,GAAA,CAAI,CAAC,IAAA,KAAS,eAAA,CAAgB,IAAI,CAAC,CAAA;AAE9E,IAAA,IAAI,SAAS,MAAA,EAAQ;AACnB,MAAA,KAAA,GAAQ,KAAA,CAAM,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA;AAAA,IACrC;AACA,IAAA,IAAI,SAAS,IAAA,EAAM;AACjB,MAAA,KAAA,CAAM,IAAA,CAAK,QAAQ,IAAI,CAAA;AAAA,IACzB;AACA,IAAA,IAAI,OAAA,EAAS,WAAW,MAAA,EAAW;AACjC,MAAA,KAAA,GAAQ,KAAA,CAAM,KAAA,CAAM,OAAA,CAAQ,MAAM,CAAA;AAAA,IACpC;AACA,IAAA,IAAI,OAAA,EAAS,UAAU,MAAA,EAAW;AAChC,MAAA,KAAA,GAAQ,KAAA,CAAM,KAAA,CAAM,CAAA,EAAG,OAAA,CAAQ,KAAK,CAAA;AAAA,IACtC;AAEA,IAAA,OAAO,KAAA;AAAA,EACT;AAAA;AAAA,EAGA,MAAM,MAAA,CAAO,GAAA,EAAa,IAAA,EAAwB;AAChD,IAAA,IAAI,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,GAAG,CAAA,EAAG;AACtB,MAAA,MAAM,IAAI,YAAA;AAAA,QACR,kBAAkB,GAAG,CAAA,gBAAA,CAAA;AAAA,QACrB;AAAA,OACF;AAAA,IACF;AACA,IAAA,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,GAAA,EAAK,eAAA,CAAgB,IAAI,CAAC,CAAA;AAAA,EAC1C;AAAA;AAAA,EAGA,MAAM,MAAA,CAAO,GAAA,EAAa,IAAA,EAAwB;AAChD,IAAA,IAAI,CAAC,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,GAAG,CAAA,EAAG;AACvB,MAAA,MAAM,IAAI,YAAA;AAAA,QACR,kBAAkB,GAAG,CAAA,WAAA,CAAA;AAAA,QACrB;AAAA,OACF;AAAA,IACF;AACA,IAAA,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,GAAA,EAAK,eAAA,CAAgB,IAAI,CAAC,CAAA;AAAA,EAC1C;AAAA;AAAA,EAGA,MAAM,OAAO,GAAA,EAA4B;AACvC,IAAA,IAAI,CAAC,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,GAAG,CAAA,EAAG;AACvB,MAAA,MAAM,IAAI,YAAA;AAAA,QACR,kBAAkB,GAAG,CAAA,WAAA,CAAA;AAAA,QACrB;AAAA,OACF;AAAA,IACF;AACA,IAAA,IAAA,CAAK,IAAA,CAAK,OAAO,GAAG,CAAA;AAAA,EACtB;AAAA;AAAA,EAGA,MAAM,IAAI,GAAA,EAA+B;AACvC,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,GAAG,CAAA;AAAA,EAC1B;AAAA;AAAA,EAGA,MAAM,KAAA,GAAyB;AAC7B,IAAA,OAAO,KAAK,IAAA,CAAK,IAAA;AAAA,EACnB;AAAA;AAAA,EAGA,MAAM,KAAA,GAAuB;AAC3B,IAAA,IAAA,CAAK,KAAK,KAAA,EAAM;AAAA,EAClB;AACF;AA6BO,IAAM,cAAN,MAAmD;AAAA,EACvC,SAAA;AAAA,EACA,SAAA;AAAA,EAEjB,YAAY,OAAA,EAA6B;AACvC,IAAA,IAAA,CAAK,YAAY,OAAA,CAAQ,SAAA;AACzB,IAAA,IAAA,CAAK,SAAA,GAAY,QAAQ,SAAA,IAAa,OAAA;AACtC,IAAA,IAAA,CAAK,eAAA,EAAgB;AAAA,EACvB;AAAA;AAAA,EAGA,MAAM,IAAI,GAAA,EAAgC;AACxC,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,SAAA,CAAU,GAAG,CAAA;AACnC,IAAA,IAAI,CAAC,UAAA,CAAW,QAAQ,CAAA,EAAG;AACzB,MAAA,OAAO,IAAA;AAAA,IACT;AACA,IAAA,OAAO,IAAA,CAAK,SAAS,QAAQ,CAAA;AAAA,EAC/B;AAAA;AAAA,EAGA,MAAM,KAAK,OAAA,EAAwC;AACjD,IAAA,IAAA,CAAK,eAAA,EAAgB;AACrB,IAAA,MAAM,KAAA,GAAQ,WAAA,CAAY,IAAA,CAAK,SAAS,CAAA,CAAE,MAAA;AAAA,MAAO,CAAC,CAAA,KAChD,CAAA,CAAE,QAAA,CAAS,KAAK,SAAS;AAAA,KAC3B;AAEA,IAAA,IAAI,QAAa,EAAC;AAClB,IAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,MAAA,MAAM,OAAO,IAAA,CAAK,QAAA,CAAS,KAAK,IAAA,CAAK,SAAA,EAAW,IAAI,CAAC,CAAA;AACrD,MAAA,KAAA,CAAM,KAAK,IAAI,CAAA;AAAA,IACjB;AAEA,IAAA,IAAI,SAAS,MAAA,EAAQ;AACnB,MAAA,KAAA,GAAQ,KAAA,CAAM,MAAA,CAAO,OAAA,CAAQ,MAAM,CAAA;AAAA,IACrC;AACA,IAAA,IAAI,SAAS,IAAA,EAAM;AACjB,MAAA,KAAA,CAAM,IAAA,CAAK,QAAQ,IAAI,CAAA;AAAA,IACzB;AACA,IAAA,IAAI,OAAA,EAAS,WAAW,MAAA,EAAW;AACjC,MAAA,KAAA,GAAQ,KAAA,CAAM,KAAA,CAAM,OAAA,CAAQ,MAAM,CAAA;AAAA,IACpC;AACA,IAAA,IAAI,OAAA,EAAS,UAAU,MAAA,EAAW;AAChC,MAAA,KAAA,GAAQ,KAAA,CAAM,KAAA,CAAM,CAAA,EAAG,OAAA,CAAQ,KAAK,CAAA;AAAA,IACtC;AAEA,IAAA,OAAO,KAAA;AAAA,EACT;AAAA;AAAA,EAGA,MAAM,MAAA,CAAO,GAAA,EAAa,IAAA,EAAwB;AAChD,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,SAAA,CAAU,GAAG,CAAA;AACnC,IAAA,IAAI,UAAA,CAAW,QAAQ,CAAA,EAAG;AACxB,MAAA,MAAM,IAAI,YAAA;AAAA,QACR,kBAAkB,GAAG,CAAA,gBAAA,CAAA;AAAA,QACrB;AAAA,OACF;AAAA,IACF;AACA,IAAA,IAAA,CAAK,SAAA,CAAU,UAAU,IAAI,CAAA;AAAA,EAC/B;AAAA;AAAA,EAGA,MAAM,MAAA,CAAO,GAAA,EAAa,IAAA,EAAwB;AAChD,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,SAAA,CAAU,GAAG,CAAA;AACnC,IAAA,IAAI,CAAC,UAAA,CAAW,QAAQ,CAAA,EAAG;AACzB,MAAA,MAAM,IAAI,YAAA;AAAA,QACR,kBAAkB,GAAG,CAAA,WAAA,CAAA;AAAA,QACrB;AAAA,OACF;AAAA,IACF;AACA,IAAA,IAAA,CAAK,SAAA,CAAU,UAAU,IAAI,CAAA;AAAA,EAC/B;AAAA;AAAA,EAGA,MAAM,OAAO,GAAA,EAA4B;AACvC,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,SAAA,CAAU,GAAG,CAAA;AACnC,IAAA,IAAI,CAAC,UAAA,CAAW,QAAQ,CAAA,EAAG;AACzB,MAAA,MAAM,IAAI,YAAA;AAAA,QACR,kBAAkB,GAAG,CAAA,WAAA,CAAA;AAAA,QACrB;AAAA,OACF;AAAA,IACF;AACA,IAAA,UAAA,CAAW,QAAQ,CAAA;AAAA,EACrB;AAAA;AAAA,EAGA,MAAM,IAAI,GAAA,EAA+B;AACvC,IAAA,OAAO,UAAA,CAAW,IAAA,CAAK,SAAA,CAAU,GAAG,CAAC,CAAA;AAAA,EACvC;AAAA;AAAA,EAGA,MAAM,KAAA,GAAyB;AAC7B,IAAA,IAAA,CAAK,eAAA,EAAgB;AACrB,IAAA,OAAO,WAAA,CAAY,IAAA,CAAK,SAAS,CAAA,CAAE,MAAA;AAAA,MAAO,CAAC,CAAA,KACzC,CAAA,CAAE,QAAA,CAAS,KAAK,SAAS;AAAA,KAC3B,CAAE,MAAA;AAAA,EACJ;AAAA;AAAA,EAGA,MAAM,KAAA,GAAuB;AAC3B,IAAA,IAAA,CAAK,eAAA,EAAgB;AACrB,IAAA,MAAM,KAAA,GAAQ,WAAA,CAAY,IAAA,CAAK,SAAS,CAAA,CAAE,MAAA;AAAA,MAAO,CAAC,CAAA,KAChD,CAAA,CAAE,QAAA,CAAS,KAAK,SAAS;AAAA,KAC3B;AACA,IAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,MAAA,UAAA,CAAW,IAAA,CAAK,IAAA,CAAK,SAAA,EAAW,IAAI,CAAC,CAAA;AAAA,IACvC;AAAA,EACF;AAAA,EAEQ,UAAU,GAAA,EAAqB;AACrC,IAAA,MAAM,UAAU,GAAA,CAAI,OAAA;AAAA,MAAQ,iBAAA;AAAA,MAAmB,CAAC,CAAA,KAC9C,GAAA,GAAM,CAAA,CAAE,UAAA,CAAW,CAAC,CAAA,CAAE,QAAA,CAAS,EAAE,CAAA,CAAE,QAAA,CAAS,CAAA,EAAG,GAAG;AAAA,KACpD;AACA,IAAA,OAAO,IAAA,CAAK,KAAK,SAAA,EAAW,CAAA,EAAG,OAAO,CAAA,EAAG,IAAA,CAAK,SAAS,CAAA,CAAE,CAAA;AAAA,EAC3D;AAAA,EAEQ,eAAA,GAAwB;AAC9B,IAAA,IAAI,CAAC,UAAA,CAAW,IAAA,CAAK,SAAS,CAAA,EAAG;AAC/B,MAAA,SAAA,CAAU,IAAA,CAAK,SAAA,EAAW,EAAE,SAAA,EAAW,MAAM,CAAA;AAAA,IAC/C;AAAA,EACF;AAAA,EAEQ,SAAS,QAAA,EAAqB;AACpC,IAAA,IAAI;AACF,MAAA,MAAM,OAAA,GAAU,YAAA,CAAa,QAAA,EAAU,OAAO,CAAA;AAC9C,MAAA,OAAO,IAAA,CAAK,MAAM,OAAO,CAAA;AAAA,IAC3B,SAAS,KAAA,EAAO;AACd,MAAA,IAAI,iBAAiB,WAAA,EAAa;AAChC,QAAA,MAAM,IAAI,YAAA;AAAA,UACR,yBAAyB,QAAQ,CAAA,CAAA;AAAA,UACjC;AAAA,SACF;AAAA,MACF;AACA,MAAA,MAAM,IAAI,YAAA;AAAA,QACR,wBAAwB,QAAQ,CAAA,CAAA;AAAA,QAChC;AAAA,OACF;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,SAAA,CAAU,UAAkB,IAAA,EAAe;AACjD,IAAA,IAAI;AACF,MAAA,MAAM,OAAA,GAAU,IAAA,CAAK,SAAA,CAAU,IAAA,EAAM,MAAM,CAAC,CAAA;AAC5C,MAAA,aAAA,CAAc,QAAA,EAAU,SAAS,OAAO,CAAA;AAAA,IAC1C,CAAA,CAAA,MAAQ;AACN,MAAA,MAAM,IAAI,YAAA;AAAA,QACR,yBAAyB,QAAQ,CAAA,CAAA;AAAA,QACjC;AAAA,OACF;AAAA,IACF;AAAA,EACF;AACF","file":"storage.js","sourcesContent":["/** Base error class for agent-sdk.\n *\n * Use `AgentSDKError.is(err)` for reliable cross-module `instanceof` checks\n * (works across separately bundled entry points where `instanceof` may fail). */\nexport class AgentSDKError extends Error {\n  /** @internal Marker for cross-bundle identity checks */\n  readonly _agentSDKError = true as const;\n\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = \"AgentSDKError\";\n  }\n\n  /** Check if an error is an AgentSDKError (works across bundled copies) */\n  static is(error: unknown): error is AgentSDKError {\n    return (\n      error instanceof Error &&\n      \"_agentSDKError\" in error &&\n      (error as AgentSDKError)._agentSDKError === true\n    );\n  }\n}\n\n/** Thrown when agent.run() is called while already running (M8 re-entrancy guard) */\nexport class ReentrancyError extends AgentSDKError {\n  constructor() {\n    super(\"Agent is already running. Await the current run before starting another.\");\n    this.name = \"ReentrancyError\";\n  }\n}\n\n/** Thrown when an operation is attempted on a disposed agent/service */\nexport class DisposedError extends AgentSDKError {\n  constructor(entity: string) {\n    super(`${entity} has been disposed and cannot be used.`);\n    this.name = \"DisposedError\";\n  }\n}\n\n/** Thrown when a backend is not found in the registry */\nexport class BackendNotFoundError extends AgentSDKError {\n  constructor(backend: string) {\n    super(\n      `Unknown backend: \"${backend}\". ` +\n      `Built-in: copilot, claude, vercel-ai. ` +\n      `Custom: use registerBackend() first.`,\n    );\n    this.name = \"BackendNotFoundError\";\n  }\n}\n\n/** Thrown when a backend is already registered */\nexport class BackendAlreadyRegisteredError extends AgentSDKError {\n  constructor(backend: string) {\n    super(`Backend \"${backend}\" is already registered. Use a different name or unregister first.`);\n    this.name = \"BackendAlreadyRegisteredError\";\n  }\n}\n\n/** Thrown when subprocess management fails */\nexport class SubprocessError extends AgentSDKError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = \"SubprocessError\";\n  }\n}\n\n/** Thrown when a required peer dependency is not installed */\nexport class DependencyError extends AgentSDKError {\n  public readonly packageName: string;\n\n  constructor(packageName: string) {\n    super(`${packageName} is not installed. Install it: npm install ${packageName}`);\n    this.name = \"DependencyError\";\n    this.packageName = packageName;\n  }\n}\n\n/** Thrown when an agent run is aborted */\nexport class AbortError extends AgentSDKError {\n  constructor() {\n    super(\"Agent run was aborted.\");\n    this.name = \"AbortError\";\n  }\n}\n\n/** Thrown when a tool execution fails */\nexport class ToolExecutionError extends AgentSDKError {\n  public readonly toolName: string;\n\n  constructor(toolName: string, message: string, options?: ErrorOptions) {\n    super(`Tool \"${toolName}\" failed: ${message}`, options);\n    this.name = \"ToolExecutionError\";\n    this.toolName = toolName;\n  }\n}\n\n/** Thrown when structured output parsing fails */\nexport class StructuredOutputError extends AgentSDKError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(`Structured output error: ${message}`, options);\n    this.name = \"StructuredOutputError\";\n  }\n}\n","/**\n * @witqq/agent-sdk/chat/storage\n *\n * Generic storage adapter layer with pluggable backends.\n * Provides CRUD operations for any data type via `IStorageAdapter<T>`.\n * Implementations: `InMemoryStorage` (Map-based) and `FileStorage` (JSON files).\n */\n\nimport { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { AgentSDKError } from \"../errors.js\";\n\n// ─── Storage Errors ────────────────────────────────────────────\n\n/**\n * Error thrown by storage operations.\n *\n * @example\n * ```typescript\n * try {\n *   await store.get(\"missing-id\");\n * } catch (e) {\n *   if (e instanceof StorageError && e.code === \"NOT_FOUND\") {\n *     // handle missing item\n *   }\n * }\n * ```\n */\nexport class StorageError extends AgentSDKError {\n  /** Machine-readable error code */\n  readonly code: StorageErrorCode;\n\n  constructor(message: string, code: StorageErrorCode) {\n    super(message);\n    this.name = \"StorageError\";\n    this.code = code;\n  }\n}\n\n/** Possible storage error codes */\nexport type StorageErrorCode =\n  | \"NOT_FOUND\"\n  | \"DUPLICATE_KEY\"\n  | \"IO_ERROR\"\n  | \"SERIALIZATION_ERROR\";\n\n// ─── Storage Adapter Interface ─────────────────────────────────\n\n/**\n * Options for listing stored items.\n *\n * @typeParam T - The type of stored items\n */\nexport interface ListOptions<T> {\n  /** Filter predicate — return `true` to include the item */\n  filter?: (item: T) => boolean;\n  /** Sort comparator — standard Array.sort semantics */\n  sort?: (a: T, b: T) => number;\n  /** Maximum number of items to return */\n  limit?: number;\n  /** Number of items to skip (for pagination) */\n  offset?: number;\n}\n\n/**\n * Generic storage adapter for CRUD operations on any data type.\n * Items are identified by a string key.\n *\n * @typeParam T - The type of stored items\n *\n * @example\n * ```typescript\n * const store: IStorageAdapter<{ name: string }> = new InMemoryStorage();\n * await store.create(\"key1\", { name: \"Alice\" });\n * const item = await store.get(\"key1\"); // { name: \"Alice\" }\n * ```\n */\nexport interface IStorageAdapter<T> {\n  /**\n   * Retrieve an item by key.\n   * @param key - Unique identifier\n   * @returns The item, or `null` if not found\n   */\n  get(key: string): Promise<T | null>;\n\n  /**\n   * List items with optional filtering, sorting, and pagination.\n   * @param options - Filter, sort, limit, offset options\n   * @returns Array of matching items\n   */\n  list(options?: ListOptions<T>): Promise<T[]>;\n\n  /**\n   * Create a new item. Throws `StorageError` with code `DUPLICATE_KEY` if key exists.\n   * @param key - Unique identifier\n   * @param item - Data to store\n   */\n  create(key: string, item: T): Promise<void>;\n\n  /**\n   * Update an existing item. Throws `StorageError` with code `NOT_FOUND` if key missing.\n   * @param key - Unique identifier\n   * @param item - Updated data\n   */\n  update(key: string, item: T): Promise<void>;\n\n  /**\n   * Delete an item by key. Throws `StorageError` with code `NOT_FOUND` if key missing.\n   * @param key - Unique identifier\n   */\n  delete(key: string): Promise<void>;\n\n  /**\n   * Check whether a key exists.\n   * @param key - Unique identifier\n   * @returns `true` if key exists\n   */\n  has(key: string): Promise<boolean>;\n\n  /**\n   * Return the number of stored items.\n   * @returns Count of items\n   */\n  count(): Promise<number>;\n\n  /**\n   * Remove all items from storage.\n   */\n  clear(): Promise<void>;\n}\n\n// ─── InMemoryStorage ───────────────────────────────────────────\n\n/**\n * In-memory storage adapter backed by a `Map`.\n * Suitable for development, testing, and short-lived processes.\n * Data is lost when the process exits.\n *\n * @typeParam T - The type of stored items\n *\n * @example\n * ```typescript\n * const store = new InMemoryStorage<{ name: string }>();\n * await store.create(\"k1\", { name: \"Alice\" });\n * await store.create(\"k2\", { name: \"Bob\" });\n * const items = await store.list({ filter: i => i.name.startsWith(\"A\") });\n * // [{ name: \"Alice\" }]\n * ```\n */\nexport class InMemoryStorage<T> implements IStorageAdapter<T> {\n  private readonly data = new Map<string, T>();\n\n  /** @inheritdoc */\n  async get(key: string): Promise<T | null> {\n    const item = this.data.get(key);\n    return item !== undefined ? structuredClone(item) : null;\n  }\n\n  /** @inheritdoc */\n  async list(options?: ListOptions<T>): Promise<T[]> {\n    let items = Array.from(this.data.values()).map((item) => structuredClone(item));\n\n    if (options?.filter) {\n      items = items.filter(options.filter);\n    }\n    if (options?.sort) {\n      items.sort(options.sort);\n    }\n    if (options?.offset !== undefined) {\n      items = items.slice(options.offset);\n    }\n    if (options?.limit !== undefined) {\n      items = items.slice(0, options.limit);\n    }\n\n    return items;\n  }\n\n  /** @inheritdoc */\n  async create(key: string, item: T): Promise<void> {\n    if (this.data.has(key)) {\n      throw new StorageError(\n        `Item with key \"${key}\" already exists`,\n        \"DUPLICATE_KEY\",\n      );\n    }\n    this.data.set(key, structuredClone(item));\n  }\n\n  /** @inheritdoc */\n  async update(key: string, item: T): Promise<void> {\n    if (!this.data.has(key)) {\n      throw new StorageError(\n        `Item with key \"${key}\" not found`,\n        \"NOT_FOUND\",\n      );\n    }\n    this.data.set(key, structuredClone(item));\n  }\n\n  /** @inheritdoc */\n  async delete(key: string): Promise<void> {\n    if (!this.data.has(key)) {\n      throw new StorageError(\n        `Item with key \"${key}\" not found`,\n        \"NOT_FOUND\",\n      );\n    }\n    this.data.delete(key);\n  }\n\n  /** @inheritdoc */\n  async has(key: string): Promise<boolean> {\n    return this.data.has(key);\n  }\n\n  /** @inheritdoc */\n  async count(): Promise<number> {\n    return this.data.size;\n  }\n\n  /** @inheritdoc */\n  async clear(): Promise<void> {\n    this.data.clear();\n  }\n}\n\n// ─── FileStorage ───────────────────────────────────────────────\n\n/**\n * Options for configuring `FileStorage`.\n */\nexport interface FileStorageOptions {\n  /** Directory path where JSON files are stored */\n  directory: string;\n  /** File extension (default: `.json`) */\n  extension?: string;\n}\n\n/**\n * File-based storage adapter that persists each item as a JSON file.\n * Suitable for local applications, CLI tools, and development.\n * Creates the storage directory if it doesn't exist.\n *\n * @typeParam T - The type of stored items (must be JSON-serializable)\n *\n * @example\n * ```typescript\n * const store = new FileStorage<ChatSession>({\n *   directory: \"./data/sessions\",\n * });\n * await store.create(\"session-1\", mySession);\n * ```\n */\nexport class FileStorage<T> implements IStorageAdapter<T> {\n  private readonly directory: string;\n  private readonly extension: string;\n\n  constructor(options: FileStorageOptions) {\n    this.directory = options.directory;\n    this.extension = options.extension ?? \".json\";\n    this.ensureDirectory();\n  }\n\n  /** @inheritdoc */\n  async get(key: string): Promise<T | null> {\n    const filePath = this.keyToPath(key);\n    if (!existsSync(filePath)) {\n      return null;\n    }\n    return this.readFile(filePath);\n  }\n\n  /** @inheritdoc */\n  async list(options?: ListOptions<T>): Promise<T[]> {\n    this.ensureDirectory();\n    const files = readdirSync(this.directory).filter((f) =>\n      f.endsWith(this.extension),\n    );\n\n    let items: T[] = [];\n    for (const file of files) {\n      const item = this.readFile(join(this.directory, file));\n      items.push(item);\n    }\n\n    if (options?.filter) {\n      items = items.filter(options.filter);\n    }\n    if (options?.sort) {\n      items.sort(options.sort);\n    }\n    if (options?.offset !== undefined) {\n      items = items.slice(options.offset);\n    }\n    if (options?.limit !== undefined) {\n      items = items.slice(0, options.limit);\n    }\n\n    return items;\n  }\n\n  /** @inheritdoc */\n  async create(key: string, item: T): Promise<void> {\n    const filePath = this.keyToPath(key);\n    if (existsSync(filePath)) {\n      throw new StorageError(\n        `Item with key \"${key}\" already exists`,\n        \"DUPLICATE_KEY\",\n      );\n    }\n    this.writeFile(filePath, item);\n  }\n\n  /** @inheritdoc */\n  async update(key: string, item: T): Promise<void> {\n    const filePath = this.keyToPath(key);\n    if (!existsSync(filePath)) {\n      throw new StorageError(\n        `Item with key \"${key}\" not found`,\n        \"NOT_FOUND\",\n      );\n    }\n    this.writeFile(filePath, item);\n  }\n\n  /** @inheritdoc */\n  async delete(key: string): Promise<void> {\n    const filePath = this.keyToPath(key);\n    if (!existsSync(filePath)) {\n      throw new StorageError(\n        `Item with key \"${key}\" not found`,\n        \"NOT_FOUND\",\n      );\n    }\n    unlinkSync(filePath);\n  }\n\n  /** @inheritdoc */\n  async has(key: string): Promise<boolean> {\n    return existsSync(this.keyToPath(key));\n  }\n\n  /** @inheritdoc */\n  async count(): Promise<number> {\n    this.ensureDirectory();\n    return readdirSync(this.directory).filter((f) =>\n      f.endsWith(this.extension),\n    ).length;\n  }\n\n  /** @inheritdoc */\n  async clear(): Promise<void> {\n    this.ensureDirectory();\n    const files = readdirSync(this.directory).filter((f) =>\n      f.endsWith(this.extension),\n    );\n    for (const file of files) {\n      unlinkSync(join(this.directory, file));\n    }\n  }\n\n  private keyToPath(key: string): string {\n    const safeKey = key.replace(/[^a-zA-Z0-9_-]/g, (c) =>\n      \"%\" + c.charCodeAt(0).toString(16).padStart(2, \"0\"),\n    );\n    return join(this.directory, `${safeKey}${this.extension}`);\n  }\n\n  private ensureDirectory(): void {\n    if (!existsSync(this.directory)) {\n      mkdirSync(this.directory, { recursive: true });\n    }\n  }\n\n  private readFile(filePath: string): T {\n    try {\n      const content = readFileSync(filePath, \"utf-8\");\n      return JSON.parse(content) as T;\n    } catch (error) {\n      if (error instanceof SyntaxError) {\n        throw new StorageError(\n          `Failed to parse file: ${filePath}`,\n          \"SERIALIZATION_ERROR\",\n        );\n      }\n      throw new StorageError(\n        `Failed to read file: ${filePath}`,\n        \"IO_ERROR\",\n      );\n    }\n  }\n\n  private writeFile(filePath: string, item: T): void {\n    try {\n      const content = JSON.stringify(item, null, 2);\n      writeFileSync(filePath, content, \"utf-8\");\n    } catch {\n      throw new StorageError(\n        `Failed to write file: ${filePath}`,\n        \"IO_ERROR\",\n      );\n    }\n  }\n}\n"]}

package/dist/errors-BDLbNu9w.d.cts

@@ -0,0 +1,13 @@
+/** Base error class for agent-sdk.
+ *
+ * Use `AgentSDKError.is(err)` for reliable cross-module `instanceof` checks
+ * (works across separately bundled entry points where `instanceof` may fail). */
+declare class AgentSDKError extends Error {
+    /** @internal Marker for cross-bundle identity checks */
+    readonly _agentSDKError: true;
+    constructor(message: string, options?: ErrorOptions);
+    /** Check if an error is an AgentSDKError (works across bundled copies) */
+    static is(error: unknown): error is AgentSDKError;
+}
+
+export { AgentSDKError as A };

package/dist/errors-BDLbNu9w.d.ts

@@ -0,0 +1,13 @@
+/** Base error class for agent-sdk.
+ *
+ * Use `AgentSDKError.is(err)` for reliable cross-module `instanceof` checks
+ * (works across separately bundled entry points where `instanceof` may fail). */
+declare class AgentSDKError extends Error {
+    /** @internal Marker for cross-bundle identity checks */
+    readonly _agentSDKError: true;
+    constructor(message: string, options?: ErrorOptions);
+    /** Check if an error is an AgentSDKError (works across bundled copies) */
+    static is(error: unknown): error is AgentSDKError;
+}
+
+export { AgentSDKError as A };

package/dist/in-process-transport-C2oPTYs6.d.ts

@@ -0,0 +1,223 @@
+import { ChatSession, SendMessageOptions, ChatEvent, ChatMessage } from './chat/core.js';
+import { I as IAgentService, b as IAgent, c as AgentConfig, M as Message, d as ModelInfo, C as CopilotBackendOptions, a as ClaudeBackendOptions, V as VercelAIBackendOptions } from './types-CqvUAYxt.js';
+import { I as IBackendAdapter, B as BackendAdapterOptions } from './types-DLZzlJxt.js';
+import { I as IChatTransport } from './transport-D1OaUgRk.js';
+
+/**
+ * @witqq/agent-sdk/chat/backends/base
+ *
+ * Abstract base class for backend adapters. Provides shared lifecycle
+ * management, event bridge via adaptAgentEvents(), and tool forwarding.
+ */
+
+/**
+ * Abstract base for backend adapters.
+ * Subclasses implement createService() and override resume behavior.
+ */
+declare abstract class BaseBackendAdapter implements IBackendAdapter {
+    readonly name: string;
+    protected _agentService: IAgentService;
+    protected _agent: IAgent | null;
+    protected _disposed: boolean;
+    protected readonly _agentConfig: AgentConfig;
+    private readonly _ownsService;
+    constructor(name: string, options: BackendAdapterOptions);
+    /** Subclasses create their specific IAgentService */
+    protected abstract createService(): IAgentService;
+    get agentService(): IAgentService;
+    abstract get backendSessionId(): string | null;
+    abstract canResume(): boolean;
+    abstract resume(session: ChatSession, backendSessionId: string, options?: SendMessageOptions): AsyncIterable<ChatEvent>;
+    sendMessage(session: ChatSession, message: string, options?: SendMessageOptions): Promise<ChatMessage>;
+    streamMessage(session: ChatSession, message: string, options?: SendMessageOptions): AsyncIterable<ChatEvent>;
+    /**
+     * Shared streaming helper: bridges agent events to chat events.
+     * Used by both streamMessage() and resume() to avoid duplication.
+     */
+    protected streamAgentEvents(agent: IAgent, messages: Message[], options?: SendMessageOptions): AsyncIterable<ChatEvent>;
+    listModels(): Promise<ModelInfo[]>;
+    validate(): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+    dispose(): Promise<void>;
+    /** Get or create an agent, applying model override from options */
+    protected getOrCreateAgent(options?: SendMessageOptions): IAgent;
+    /** Subclasses capture backend session ID from agent after streaming */
+    protected abstract captureSessionId(agent: IAgent): void;
+    protected assertNotDisposed(): void;
+}
+
+/**
+ * @witqq/agent-sdk/chat/backends/copilot
+ *
+ * CopilotChatAdapter wraps CopilotAgentService for chat use.
+ * Supports persistent session mode for canResume/resume.
+ */
+
+/** Options for creating a CopilotChatAdapter */
+interface CopilotChatAdapterOptions extends BackendAdapterOptions {
+    /** Copilot backend options (cliPath, token, etc.) */
+    copilotOptions?: CopilotBackendOptions;
+}
+/**
+ * Backend adapter for GitHub Copilot CLI.
+ * Uses persistent session mode for session resume via CLI session ID.
+ */
+declare class CopilotChatAdapter extends BaseBackendAdapter {
+    private _backendSessionId;
+    private readonly _copilotOptions?;
+    constructor(options: CopilotChatAdapterOptions);
+    protected createService(): IAgentService;
+    get backendSessionId(): string | null;
+    canResume(): boolean;
+    resume(session: ChatSession, backendSessionId: string, options?: SendMessageOptions): AsyncIterable<ChatEvent>;
+    protected captureSessionId(agent: IAgent): void;
+}
+
+/**
+ * @witqq/agent-sdk/chat/backends/claude
+ *
+ * ClaudeChatAdapter wraps ClaudeAgentService for chat use.
+ * Supports persistent session mode with Claude's session_id for resume.
+ */
+
+/** Options for creating a ClaudeChatAdapter */
+interface ClaudeChatAdapterOptions extends BackendAdapterOptions {
+    /** Claude backend options (cliPath, model, etc.) */
+    claudeOptions?: ClaudeBackendOptions;
+}
+/**
+ * Backend adapter for Claude CLI.
+ * Uses persistent session mode for session resume via Claude's session_id.
+ */
+declare class ClaudeChatAdapter extends BaseBackendAdapter {
+    private _backendSessionId;
+    private readonly _claudeOptions?;
+    constructor(options: ClaudeChatAdapterOptions);
+    protected createService(): IAgentService;
+    get backendSessionId(): string | null;
+    canResume(): boolean;
+    resume(session: ChatSession, backendSessionId: string, options?: SendMessageOptions): AsyncIterable<ChatEvent>;
+    protected captureSessionId(agent: IAgent): void;
+}
+
+/**
+ * @witqq/agent-sdk/chat/backends/vercel-ai
+ *
+ * VercelAIChatAdapter wraps VercelAIAgentService for chat use.
+ * Stateless adapter — canResume() always returns false.
+ * Each streamMessage/sendMessage creates a fresh agent (per-call session mode).
+ */
+
+/** Options for creating a VercelAIChatAdapter */
+interface VercelAIChatAdapterOptions extends BackendAdapterOptions {
+    /** Vercel AI backend options (baseURL, apiKey, provider, etc.) */
+    vercelOptions?: VercelAIBackendOptions;
+}
+/**
+ * Backend adapter for Vercel AI SDK (API-based).
+ * Stateless — each call creates a fresh agent. Does not support resume.
+ */
+declare class VercelAIChatAdapter extends BaseBackendAdapter {
+    private readonly _vercelOptions?;
+    constructor(options: VercelAIChatAdapterOptions);
+    protected createService(): IAgentService;
+    get backendSessionId(): string | null;
+    canResume(): boolean;
+    resume(_session: ChatSession, _backendSessionId: string, _options?: SendMessageOptions): AsyncIterable<ChatEvent>;
+    protected captureSessionId(_agent: IAgent): void;
+}
+
+/**
+ * @witqq/agent-sdk - WebSocket Chat Transport
+ *
+ * IChatTransport implementation over WebSocket connections.
+ * Accepts a WebSocket-like abstraction compatible with `ws`, native WebSocket, etc.
+ */
+
+/** Ready states matching the WebSocket spec (ws, browser, Deno, Bun) */
+declare const WS_READY_STATE: {
+    readonly CONNECTING: 0;
+    readonly OPEN: 1;
+    readonly CLOSING: 2;
+    readonly CLOSED: 3;
+};
+/**
+ * Minimal WebSocket interface compatible with `ws`, browser WebSocket, Deno, Bun.
+ * Only the methods/properties used by WsChatTransport.
+ */
+interface WebSocketLike {
+    readonly readyState: number;
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    addEventListener(type: "close", listener: () => void): void;
+    addEventListener(type: "error", listener: (err: unknown) => void): void;
+}
+/** Configuration options for WsChatTransport */
+interface WsTransportOptions {
+    /** Heartbeat interval in ms. 0 or undefined disables heartbeat. */
+    heartbeatMs?: number;
+    /** Custom JSON serializer (defaults to JSON.stringify) */
+    serialize?: (event: ChatEvent) => string;
+}
+/**
+ * WebSocket transport for ChatEvent streaming.
+ * Sends events as JSON messages over a WebSocket connection.
+ */
+declare class WsChatTransport implements IChatTransport {
+    private readonly ws;
+    private readonly serialize;
+    private _open;
+    private _heartbeatTimer;
+    constructor(ws: WebSocketLike, options?: WsTransportOptions);
+    get isOpen(): boolean;
+    send(event: ChatEvent): void;
+    close(): void;
+    error(err: Error): void;
+    private _cleanup;
+    private _clearHeartbeat;
+}
+
+/**
+ * @witqq/agent-sdk - In-Process Chat Transport
+ *
+ * IChatTransport implementation for zero-network communication.
+ * Events are pushed into an internal buffer and consumed via async iteration.
+ * Useful for testing, embedded runtimes, CLI tools, and in-process communication.
+ */
+
+/**
+ * In-process transport for ChatEvent streaming.
+ * Producer pushes events via IChatTransport.send(), consumer reads via async iteration.
+ *
+ * @example
+ * ```ts
+ * const transport = new InProcessChatTransport();
+ *
+ * // Consumer side (async iteration)
+ * (async () => {
+ *   for await (const event of transport) {
+ *     console.log("Received:", event);
+ *   }
+ * })();
+ *
+ * // Producer side (via streamToTransport or manual)
+ * transport.send({ type: "message:start", messageId, role: "assistant" });
+ * transport.send({ type: "message:delta", messageId, text: "Hello" });
+ * transport.close();
+ * ```
+ */
+declare class InProcessChatTransport implements IChatTransport {
+    private _open;
+    private _buffer;
+    private _resolve;
+    private _error;
+    get isOpen(): boolean;
+    send(event: ChatEvent): void;
+    close(): void;
+    error(err: Error): void;
+    [Symbol.asyncIterator](): AsyncIterator<ChatEvent>;
+}
+
+export { BaseBackendAdapter as B, ClaudeChatAdapter as C, InProcessChatTransport as I, VercelAIChatAdapter as V, WsChatTransport as W, CopilotChatAdapter as a, type ClaudeChatAdapterOptions as b, type CopilotChatAdapterOptions as c, type VercelAIChatAdapterOptions as d, WS_READY_STATE as e, type WebSocketLike as f, type WsTransportOptions as g };