@fllf/agent-sdk 0.1.1 → 0.1.3

package/dist/tools/executor.js

@@ -1,14 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ToolExecutor = void 0;
+const content_1 = require("../messages/content");
 const observability_1 = require("../observability");
+const errors_1 = require("../errors");
 const base_1 = require("./base");
 class ToolExecutor {
     registry;
     trace;
-    constructor(registry, trace) {
+    options;
+    constructor(registry, trace, options = {}) {
         this.registry = registry;
         this.trace = trace;
+        this.options = options;
     }
     async execute(toolCall) {
         const startedAt = Date.now();
@@ -16,6 +20,8 @@ class ToolExecutor {
             type: 'tool:start',
             runId: this.trace?.runId ?? 'standalone',
             timestamp: new Date(),
+            spanId: this.trace?.spanId,
+            parentSpanId: this.trace?.parentSpanId,
             agentName: this.trace?.agentName,
             sessionId: this.trace?.sessionId,
             toolName: toolCall.name,
@@ -23,59 +29,121 @@ class ToolExecutor {
         });
         const tool = this.registry.get(toolCall.name);
         if (!tool) {
+            const error = new errors_1.ToolNotFoundError(toolCall.name);
             await (0, observability_1.emitRuntimeEvent)(this.trace?.observer, {
                 type: 'tool:error',
                 runId: this.trace?.runId ?? 'standalone',
                 timestamp: new Date(),
+                spanId: this.trace?.spanId,
+                parentSpanId: this.trace?.parentSpanId,
                 durationMs: Date.now() - startedAt,
                 agentName: this.trace?.agentName,
                 sessionId: this.trace?.sessionId,
                 toolName: toolCall.name,
                 toolCallId: toolCall.id,
-                error: {
-                    name: 'ToolNotFoundError',
-                    message: `Tool "${toolCall.name}" is not registered.`,
-                },
+                error: (0, observability_1.toObservedError)(error),
             });
-            return `Tool "${toolCall.name}" is not registered.`;
+            if (this.options.errorMode === 'throw') {
+                throw error;
+            }
+            return this.toErrorOutcome(toolCall, this.describeUnknownTool(toolCall.name));
         }
         try {
-            const result = await tool.execute(toolCall.arguments);
-            const output = String(result);
+            const result = await tool.execute(toolCall.arguments, this.createRunContext());
+            const output = tool.serializeResult(result);
             await (0, observability_1.emitRuntimeEvent)(this.trace?.observer, {
                 type: 'tool:end',
                 runId: this.trace?.runId ?? 'standalone',
                 timestamp: new Date(),
+                spanId: this.trace?.spanId,
+                parentSpanId: this.trace?.parentSpanId,
                 durationMs: Date.now() - startedAt,
                 agentName: this.trace?.agentName,
                 sessionId: this.trace?.sessionId,
                 toolName: toolCall.name,
                 toolCallId: toolCall.id,
-                outputLength: output.length,
+                outputLength: (0, content_1.contentToText)(output).length,
             });
-            return output;
+            return {
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: output,
+                isError: false,
+            };
         }
         catch (error) {
+            const toolError = normalizeToolError(toolCall.name, error);
             await (0, observability_1.emitRuntimeEvent)(this.trace?.observer, {
                 type: 'tool:error',
                 runId: this.trace?.runId ?? 'standalone',
                 timestamp: new Date(),
+                spanId: this.trace?.spanId,
+                parentSpanId: this.trace?.parentSpanId,
                 durationMs: Date.now() - startedAt,
                 agentName: this.trace?.agentName,
                 sessionId: this.trace?.sessionId,
                 toolName: toolCall.name,
                 toolCallId: toolCall.id,
-                error: (0, observability_1.toObservedError)(error),
+                error: (0, observability_1.toObservedError)(toolError),
             });
-            if (error instanceof base_1.ToolValidationError) {
-                return formatValidationError(error);
+            if (this.resolveErrorMode(toolError.toolName ?? toolCall.name) === 'throw') {
+                throw toolError;
             }
-            const message = error instanceof Error ? error.message : String(error);
-            return `Tool "${toolCall.name}" failed: ${message}`;
+            if (toolError instanceof base_1.ToolValidationError) {
+                return this.toErrorOutcome(toolCall, formatValidationError(toolError));
+            }
+            return this.toErrorOutcome(toolCall, toolError.message);
         }
     }
+    /**
+     * 并发执行一批 tool call，返回顺序与输入一致。
+     * errorMode 为 throw 时任何一个失败都会让整批 reject。
+     */
+    async executeMany(toolCalls) {
+        return Promise.all(toolCalls.map((toolCall) => this.execute(toolCall)));
+    }
+    toErrorOutcome(toolCall, message) {
+        return {
+            toolCallId: toolCall.id,
+            toolName: toolCall.name,
+            content: message,
+            isError: true,
+        };
+    }
+    describeUnknownTool(toolName) {
+        const availableTools = this.registry.list().map((tool) => tool.name);
+        const availableHint = availableTools.length > 0
+            ? `Available tools: ${availableTools.join(', ')}.`
+            : 'No tools are registered.';
+        return `Tool "${toolName}" is not registered. ${availableHint}`;
+    }
+    createRunContext() {
+        const context = {
+            runId: this.trace?.runId ?? 'standalone',
+        };
+        if (this.trace?.agentName !== undefined) {
+            context.agentName = this.trace.agentName;
+        }
+        if (this.trace?.sessionId !== undefined) {
+            context.sessionId = this.trace.sessionId;
+        }
+        if (this.options.metadata !== undefined) {
+            context.metadata = this.options.metadata;
+        }
+        if (this.options.signal !== undefined) {
+            context.signal = this.options.signal;
+        }
+        return context;
+    }
+    resolveErrorMode(toolName) {
+        const tool = toolName ? this.registry.get(toolName) : undefined;
+        return this.options.errorMode ?? tool?.errorMode ?? 'return_to_model';
+    }
 }
 exports.ToolExecutor = ToolExecutor;
+function normalizeToolError(toolName, error) {
+    return error instanceof errors_1.ToolError ? error : new errors_1.ToolExecutionError(toolName, error);
+}
 function formatValidationError(error) {
     const details = error.issues.map((issue) => {
         const path = issue.path.length > 0 ? issue.path.join('.') : '<root>';

package/dist/tools/executor.js.map

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

package/dist/tools/index.d.ts

@@ -5,5 +5,7 @@ export { AdvancedSearchTool } from './builtin/advancedSearchTool';
 export { RagSearchTool, formatRetrievedChunks } from './builtin/ragSearchTool';
 export type { AdvancedSearchToolLogger, AdvancedSearchToolOptions, } from './builtin/advancedSearchTool';
 export type { RagSearchToolInput, RagSearchToolOptions, } from './builtin/ragSearchTool';
-export type { ToolInput, ToolInputSchema, ToolOptions } from './base';
+export type { ToolRegisterOptions, ToolRegistryDuplicatePolicy, ToolRegistryOptions, } from './registry';
+export type { ToolErrorMode, ToolInput, ToolInputSchema, ToolOptions, ToolPermissionChecker, ToolRunContext, } from './base';
+export type { ToolCallOutcome, ToolExecutorOptions } from './executor';
 //# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,YAAY,EACR,wBAAwB,EACxB,yBAAyB,GAC5B,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACR,kBAAkB,EAClB,oBAAoB,GACvB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,YAAY,EACR,wBAAwB,EACxB,yBAAyB,GAC5B,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACR,kBAAkB,EAClB,oBAAoB,GACvB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACR,mBAAmB,EACnB,2BAA2B,EAC3B,mBAAmB,GACtB,MAAM,YAAY,CAAC;AACpB,YAAY,EACR,aAAa,EACb,SAAS,EACT,eAAe,EACf,WAAW,EACX,qBAAqB,EACrB,cAAc,GACjB,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/tools/registry.d.ts

@@ -1,12 +1,24 @@
-import type { ChatToolSchema } from '../llm/types';
+import type { ChatToolSchema, ToolDefinition } from '../llm/types';
 import { Tool } from './base';
+export type ToolRegistryDuplicatePolicy = 'throw' | 'replace';
+export interface ToolRegistryOptions {
+    duplicatePolicy?: ToolRegistryDuplicatePolicy;
+}
+export interface ToolRegisterOptions {
+    replace?: boolean;
+}
 export declare class ToolRegistry {
     private readonly tools;
-    constructor(initialTools?: Tool[]);
-    register(tool: Tool): void;
+    private readonly duplicatePolicy;
+    constructor(initialTools?: Tool[], options?: ToolRegistryOptions);
+    register(tool: Tool, options?: ToolRegisterOptions): void;
     get(name: string): Tool | undefined;
     has(name: string): boolean;
     list(): Tool[];
+    toToolSchemas(): ToolDefinition[];
+    /**
+     * @deprecated 请使用 toToolSchemas()；此方法返回 OpenAI 专有形状。
+     */
     toOpenAISchemas(): ChatToolSchema[];
     /**
      * 这个描述主要用于非 function-calling 模型，或调试 prompt 时查看工具清单。

package/dist/tools/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;gBAErC,YAAY,GAAE,IAAI,EAAO;IAMrC,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,IAAI,IAAI,EAAE;IAId,eAAe,IAAI,cAAc,EAAE;IAInC;;OAEG;IACH,mBAAmB,IAAI,MAAM;CAOhC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,MAAM,MAAM,2BAA2B,GAAG,OAAO,GAAG,SAAS,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAChC,eAAe,CAAC,EAAE,2BAA2B,CAAC;CACjD;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA8B;gBAElD,YAAY,GAAE,IAAI,EAAO,EAAE,OAAO,GAAE,mBAAwB;IAQxE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,mBAAwB,GAAG,IAAI;IAe7D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,IAAI,IAAI,EAAE;IAId,aAAa,IAAI,cAAc,EAAE;IAIjC;;OAEG;IACH,eAAe,IAAI,cAAc,EAAE;IAInC;;OAEG;IACH,mBAAmB,IAAI,MAAM;CAOhC"}

package/dist/tools/registry.js

@@ -1,14 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ToolRegistry = void 0;
+const errors_1 = require("../errors");
 class ToolRegistry {
     tools = new Map();
-    constructor(initialTools = []) {
+    duplicatePolicy;
+    constructor(initialTools = [], options = {}) {
+        this.duplicatePolicy = options.duplicatePolicy ?? 'throw';
         for (const tool of initialTools) {
             this.register(tool);
         }
     }
-    register(tool) {
+    register(tool, options = {}) {
+        const shouldReplace = options.replace ?? this.duplicatePolicy === 'replace';
+        if (this.tools.has(tool.name) && !shouldReplace) {
+            throw new errors_1.ToolConfigurationError(`Tool "${tool.name}" is already registered.`, {
+                code: 'duplicate_tool_name',
+                toolName: tool.name,
+                metadata: {
+                    toolName: tool.name,
+                },
+            });
+        }
         this.tools.set(tool.name, tool);
     }
     get(name) {
@@ -20,6 +33,12 @@ class ToolRegistry {
     list() {
         return [...this.tools.values()];
     }
+    toToolSchemas() {
+        return this.list().map((tool) => tool.toToolSchema());
+    }
+    /**
+     * @deprecated 请使用 toToolSchemas()；此方法返回 OpenAI 专有形状。
+     */
     toOpenAISchemas() {
         return this.list().map((tool) => tool.toOpenAISchema());
     }

package/dist/tools/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":";;;AAGA,MAAa,YAAY;IACJ,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IAEjD,YAAY,eAAuB,EAAE;QACjC,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,IAAU;QACf,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,IAAI;QACA,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,eAAe;QACX,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,mBAAmB;QACf,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAChC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,CAClD,CAAC;QAEF,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACxE,CAAC;CACJ;AAvCD,oCAuCC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":";;;AACA,sCAAmD;AAanD,MAAa,YAAY;IACJ,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IAChC,eAAe,CAA8B;IAE9D,YAAY,eAAuB,EAAE,EAAE,UAA+B,EAAE;QACpE,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC;QAE1D,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,IAAU,EAAE,UAA+B,EAAE;QAClD,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,CAAC;QAC5E,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YAC9C,MAAM,IAAI,+BAAsB,CAAC,SAAS,IAAI,CAAC,IAAI,0BAA0B,EAAE;gBAC3E,IAAI,EAAE,qBAAqB;gBAC3B,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,QAAQ,EAAE;oBACN,QAAQ,EAAE,IAAI,CAAC,IAAI;iBACtB;aACJ,CAAC,CAAC;QACP,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,IAAI;QACA,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,aAAa;QACT,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,eAAe;QACX,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,mBAAmB;QACf,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAChC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,CAClD,CAAC;QAEF,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACxE,CAAC;CACJ;AA5DD,oCA4DC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fllf/agent-sdk",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "A composable TypeScript Agent runtime foundation.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -8,11 +8,56 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./agent": {
+      "types": "./dist/agent/index.d.ts",
+      "default": "./dist/agent/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "default": "./dist/config/index.js"
+    },
+    "./executors": {
+      "types": "./dist/executors/index.d.ts",
+      "default": "./dist/executors/index.js"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "default": "./dist/errors.js"
+    },
+    "./history": {
+      "types": "./dist/history/index.d.ts",
+      "default": "./dist/history/index.js"
+    },
+    "./llm": {
+      "types": "./dist/llm/index.d.ts",
+      "default": "./dist/llm/index.js"
+    },
+    "./messages": {
+      "types": "./dist/messages/index.d.ts",
+      "default": "./dist/messages/index.js"
+    },
+    "./observability": {
+      "types": "./dist/observability/index.d.ts",
+      "default": "./dist/observability/index.js"
+    },
+    "./rag": {
+      "types": "./dist/rag/index.d.ts",
+      "default": "./dist/rag/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "default": "./dist/testing/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "default": "./dist/tools/index.js"
     }
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "publishConfig": {
     "access": "public",
@@ -22,15 +67,24 @@
     "build": "tsc -p tsconfig.build.json",
     "typecheck": "tsc --noEmit",
     "test": "tsx --test test/**/*.test.ts",
-    "prepublishOnly": "npm run typecheck && npm test && npm run build",
+    "test:exports": "node -e \"for (const p of ['agent','config','executors','errors','history','llm','messages','observability','rag','testing','tools']) { const m = require('@fllf/agent-sdk/' + p); if (!m || Object.keys(m).length === 0) throw new Error('empty export: ' + p); } const root = require('@fllf/agent-sdk'); if (!root.Agent) throw new Error('missing root export');\"",
+    "pack:dry-run": "npm pack --dry-run",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build && npm run test:exports",
     "example:simple-chat": "tsx examples/simple-chat.ts",
+    "example:streaming-chat": "tsx examples/streaming-chat.ts",
     "example:tool-calling": "tsx examples/tool-calling.ts",
-    "example:local-ollama": "tsx examples/local-ollama.ts"
+    "example:tool-error-policy": "tsx examples/tool-error-policy.ts",
+    "example:local-ollama": "tsx examples/local-ollama.ts",
+    "example:custom-provider": "tsx examples/custom-provider.ts",
+    "example:custom-history-store": "tsx examples/custom-history-store.ts",
+    "example:custom-executor": "tsx examples/custom-executor.ts",
+    "example:custom-observer": "tsx examples/custom-observer.ts"
   },
   "keywords": [],
   "author": "",
   "license": "ISC",
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.110.0",
     "openai": "^6.42.0",
     "zod": "^4.4.3"
   },