@cloudbase/agent-shared 1.0.1-alpha.7 → 1.0.1-alpha.9

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @cloudbase/agent-shared
 
+## 1.0.1-alpha.8
+
+### Patch Changes
+
+- alpha release 0.1.2-alpha.1
+  - Update all public packages to version 0.1.2-alpha.1
+  - Trigger automated alpha release workflow
+  - Includes latest features and improvements
+
+## 1.0.1-alpha.7
+
+### Patch Changes
+
+- alpha release 0.1.2-alpha.1
+  - Update all public packages to version 0.1.2-alpha.1
+  - Trigger automated alpha release workflow
+  - Includes latest features and improvements
+
 ## 1.0.1-alpha.6
 
 ### Patch Changes

package/dist/index.d.mts

@@ -2,6 +2,135 @@ import * as z from 'zod/v4';
 import * as z3 from 'zod/v3';
 import * as z4 from 'zod/v4/core';
 
+/**
+ * Logger interface
+ *
+ * This follows the "Bring Your Own Logger" (BYOL) pattern:
+ * - Users can inject their own logger (Pino, Winston, console, etc.)
+ * - All methods are optional - if a method exists, we use it; if not, we skip it
+ * - The interface is a "slot" for users to plug in their logger
+ *
+ * The signature supports two common calling conventions:
+ * 1. Printf style (Winston/Console): logger.info("Port %d", 8080)
+ * 2. Structured style (Pino): logger.info({ port: 8080 }, "Server started")
+ */
+/**
+ * Log method signature supporting both structured and printf-style logging.
+ *
+ * @example
+ * // Printf style
+ * logger.info("Hello %s", "world");
+ *
+ * // Structured style (Pino-compatible)
+ * logger.info({ userId: 123 }, "User logged in");
+ *
+ * // Simple message
+ * logger.info("Server started");
+ */
+interface LogFn {
+    (msg: string, ...args: unknown[]): void;
+    (obj: object, msg?: string, ...args: unknown[]): void;
+}
+/**
+ * Logger interface - a minimal "slot" for users to plug in their logger.
+ *
+ * All methods are optional. If a method exists on the user's logger, we use it;
+ * if not, we simply skip it. This allows maximum compatibility with any logger.
+ *
+ * Compatible with: Pino, Winston, Bunyan, console, or any custom logger.
+ *
+ * @example
+ * // Inject Pino
+ * import pino from 'pino';
+ * createExpressServer({ createAgent, logger: pino() });
+ *
+ * // Inject Winston
+ * import winston from 'winston';
+ * createExpressServer({ createAgent, logger: winston.createLogger() });
+ *
+ * // Inject console (for development)
+ * createExpressServer({ createAgent, logger: console });
+ */
+interface Logger {
+    /**
+     * Fatal level - system is unusable, immediate action required.
+     * Use for: unrecoverable errors, process about to crash.
+     */
+    fatal?: LogFn;
+    /**
+     * Error level - failures requiring attention.
+     * Use for: 5xx errors, unhandled exceptions, critical failures.
+     */
+    error?: LogFn;
+    /**
+     * Warn level - recoverable issues, deprecation notices.
+     * Use for: 4xx errors, missing config with fallback, retry attempts.
+     */
+    warn?: LogFn;
+    /**
+     * Info level - key lifecycle events (production default).
+     * Use for: server started, client connected, request completed.
+     */
+    info?: LogFn;
+    /**
+     * Debug level - diagnostic information for logic flow.
+     * Use for: request received, state changes, configuration loaded.
+     */
+    debug?: LogFn;
+    /**
+     * Trace level - extremely verbose, for library internals debugging.
+     * Use for: raw bytes, loop iterations, function entry/exit.
+     */
+    trace?: LogFn;
+    /**
+     * Creates a child logger with additional context.
+     * The child inherits all parent context and adds its own.
+     *
+     * @example
+     * const requestLogger = logger.child({ requestId: 'req-123' });
+     * requestLogger.info("Processing request"); // includes requestId in output
+     */
+    child?(bindings: Record<string, unknown>): Logger;
+}
+/**
+ * No-op logger implementation (Abstract Logging pattern).
+ *
+ * This is the default logger - it does nothing.
+ * This ensures:
+ * 1. The library is silent by default (respects user's console)
+ * 2. No performance overhead from console.log in production
+ * 3. No need for `if (logger)` checks throughout the code
+ *
+ * @example
+ * // Default: silent
+ * createExpressServer({ createAgent });
+ *
+ * // Development: see logs
+ * createExpressServer({ createAgent, logger: console });
+ *
+ * // Production: structured JSON logs
+ * import pino from 'pino';
+ * createExpressServer({ createAgent, logger: pino() });
+ */
+declare const noopLogger: Logger;
+/**
+ * Creates a console-based logger that wraps console methods.
+ * Useful for development when you want simple console output.
+ *
+ * Note: console.log is synchronous and blocking - avoid in high-throughput production.
+ *
+ * @example
+ * createExpressServer({ createAgent, logger: createConsoleLogger() });
+ */
+declare function createConsoleLogger(): Logger;
+
+/**
+ * Type guard to check if an error has a code property.
+ */
+declare function isErrorWithCode(error: unknown): error is Error & {
+    code: string;
+};
+
 type Schema = z3.ZodTypeAny | z4.$ZodType;
 type ZodInfer<T> = T extends z3.ZodTypeAny ? z3.infer<T> : z4.infer<T>;
 declare function isV4Schema(schema: Schema): schema is z4.$ZodType;
@@ -124,4 +253,4 @@ type AssistantMessage = z.infer<typeof assistantMessageSchema>;
 type Tool = z.infer<typeof toolSchema>;
 type SendMessageEvent = z.infer<typeof sendMessageEventSchema>;
 
-export { type AssistantMessage, type ClientMessage, type Schema, type SendMessageEvent, type SendMessageInput, type SystemMessage, type Tool, type ToolMessage, type UserMessage, type ZodInfer, assistantMessageSchema, clientMessageSchema, isV4Schema, sendMessageEventSchema, sendMessageInputSchema, systemMessageSchema, toolMessageSchema, toolSchema, userMessageSchema };
+export { type AssistantMessage, type ClientMessage, type LogFn, type Logger, type Schema, type SendMessageEvent, type SendMessageInput, type SystemMessage, type Tool, type ToolMessage, type UserMessage, type ZodInfer, assistantMessageSchema, clientMessageSchema, createConsoleLogger, isErrorWithCode, isV4Schema, noopLogger, sendMessageEventSchema, sendMessageInputSchema, systemMessageSchema, toolMessageSchema, toolSchema, userMessageSchema };

package/dist/index.d.ts

@@ -2,6 +2,135 @@ import * as z from 'zod/v4';
 import * as z3 from 'zod/v3';
 import * as z4 from 'zod/v4/core';
 
+/**
+ * Logger interface
+ *
+ * This follows the "Bring Your Own Logger" (BYOL) pattern:
+ * - Users can inject their own logger (Pino, Winston, console, etc.)
+ * - All methods are optional - if a method exists, we use it; if not, we skip it
+ * - The interface is a "slot" for users to plug in their logger
+ *
+ * The signature supports two common calling conventions:
+ * 1. Printf style (Winston/Console): logger.info("Port %d", 8080)
+ * 2. Structured style (Pino): logger.info({ port: 8080 }, "Server started")
+ */
+/**
+ * Log method signature supporting both structured and printf-style logging.
+ *
+ * @example
+ * // Printf style
+ * logger.info("Hello %s", "world");
+ *
+ * // Structured style (Pino-compatible)
+ * logger.info({ userId: 123 }, "User logged in");
+ *
+ * // Simple message
+ * logger.info("Server started");
+ */
+interface LogFn {
+    (msg: string, ...args: unknown[]): void;
+    (obj: object, msg?: string, ...args: unknown[]): void;
+}
+/**
+ * Logger interface - a minimal "slot" for users to plug in their logger.
+ *
+ * All methods are optional. If a method exists on the user's logger, we use it;
+ * if not, we simply skip it. This allows maximum compatibility with any logger.
+ *
+ * Compatible with: Pino, Winston, Bunyan, console, or any custom logger.
+ *
+ * @example
+ * // Inject Pino
+ * import pino from 'pino';
+ * createExpressServer({ createAgent, logger: pino() });
+ *
+ * // Inject Winston
+ * import winston from 'winston';
+ * createExpressServer({ createAgent, logger: winston.createLogger() });
+ *
+ * // Inject console (for development)
+ * createExpressServer({ createAgent, logger: console });
+ */
+interface Logger {
+    /**
+     * Fatal level - system is unusable, immediate action required.
+     * Use for: unrecoverable errors, process about to crash.
+     */
+    fatal?: LogFn;
+    /**
+     * Error level - failures requiring attention.
+     * Use for: 5xx errors, unhandled exceptions, critical failures.
+     */
+    error?: LogFn;
+    /**
+     * Warn level - recoverable issues, deprecation notices.
+     * Use for: 4xx errors, missing config with fallback, retry attempts.
+     */
+    warn?: LogFn;
+    /**
+     * Info level - key lifecycle events (production default).
+     * Use for: server started, client connected, request completed.
+     */
+    info?: LogFn;
+    /**
+     * Debug level - diagnostic information for logic flow.
+     * Use for: request received, state changes, configuration loaded.
+     */
+    debug?: LogFn;
+    /**
+     * Trace level - extremely verbose, for library internals debugging.
+     * Use for: raw bytes, loop iterations, function entry/exit.
+     */
+    trace?: LogFn;
+    /**
+     * Creates a child logger with additional context.
+     * The child inherits all parent context and adds its own.
+     *
+     * @example
+     * const requestLogger = logger.child({ requestId: 'req-123' });
+     * requestLogger.info("Processing request"); // includes requestId in output
+     */
+    child?(bindings: Record<string, unknown>): Logger;
+}
+/**
+ * No-op logger implementation (Abstract Logging pattern).
+ *
+ * This is the default logger - it does nothing.
+ * This ensures:
+ * 1. The library is silent by default (respects user's console)
+ * 2. No performance overhead from console.log in production
+ * 3. No need for `if (logger)` checks throughout the code
+ *
+ * @example
+ * // Default: silent
+ * createExpressServer({ createAgent });
+ *
+ * // Development: see logs
+ * createExpressServer({ createAgent, logger: console });
+ *
+ * // Production: structured JSON logs
+ * import pino from 'pino';
+ * createExpressServer({ createAgent, logger: pino() });
+ */
+declare const noopLogger: Logger;
+/**
+ * Creates a console-based logger that wraps console methods.
+ * Useful for development when you want simple console output.
+ *
+ * Note: console.log is synchronous and blocking - avoid in high-throughput production.
+ *
+ * @example
+ * createExpressServer({ createAgent, logger: createConsoleLogger() });
+ */
+declare function createConsoleLogger(): Logger;
+
+/**
+ * Type guard to check if an error has a code property.
+ */
+declare function isErrorWithCode(error: unknown): error is Error & {
+    code: string;
+};
+
 type Schema = z3.ZodTypeAny | z4.$ZodType;
 type ZodInfer<T> = T extends z3.ZodTypeAny ? z3.infer<T> : z4.infer<T>;
 declare function isV4Schema(schema: Schema): schema is z4.$ZodType;
@@ -124,4 +253,4 @@ type AssistantMessage = z.infer<typeof assistantMessageSchema>;
 type Tool = z.infer<typeof toolSchema>;
 type SendMessageEvent = z.infer<typeof sendMessageEventSchema>;
 
-export { type AssistantMessage, type ClientMessage, type Schema, type SendMessageEvent, type SendMessageInput, type SystemMessage, type Tool, type ToolMessage, type UserMessage, type ZodInfer, assistantMessageSchema, clientMessageSchema, isV4Schema, sendMessageEventSchema, sendMessageInputSchema, systemMessageSchema, toolMessageSchema, toolSchema, userMessageSchema };
+export { type AssistantMessage, type ClientMessage, type LogFn, type Logger, type Schema, type SendMessageEvent, type SendMessageInput, type SystemMessage, type Tool, type ToolMessage, type UserMessage, type ZodInfer, assistantMessageSchema, clientMessageSchema, createConsoleLogger, isErrorWithCode, isV4Schema, noopLogger, sendMessageEventSchema, sendMessageInputSchema, systemMessageSchema, toolMessageSchema, toolSchema, userMessageSchema };

package/dist/index.js

@@ -32,7 +32,10 @@ var index_exports = {};
 __export(index_exports, {
   assistantMessageSchema: () => assistantMessageSchema,
   clientMessageSchema: () => clientMessageSchema,
+  createConsoleLogger: () => createConsoleLogger,
+  isErrorWithCode: () => isErrorWithCode,
   isV4Schema: () => isV4Schema,
+  noopLogger: () => noopLogger,
   sendMessageEventSchema: () => sendMessageEventSchema,
   sendMessageInputSchema: () => sendMessageInputSchema,
   systemMessageSchema: () => systemMessageSchema,
@@ -42,6 +45,65 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 var z = __toESM(require("zod/v4"));
+
+// src/logger.ts
+var noop = (_msgOrObj, ..._args) => {
+};
+var noopLogger = {
+  fatal: noop,
+  error: noop,
+  warn: noop,
+  info: noop,
+  debug: noop,
+  trace: noop,
+  child: () => noopLogger
+};
+function createConsoleLogger() {
+  return createChildConsoleLogger({});
+}
+function createChildConsoleLogger(bindings) {
+  const hasBindings = Object.keys(bindings).length > 0;
+  function createLogMethod(level) {
+    const consoleMethod = level === "fatal" ? "error" : level === "trace" ? "debug" : level;
+    const consoleFn = console[consoleMethod] || console.log;
+    const prefix = `[${level.toUpperCase()}]`;
+    return (msgOrObj, ...args) => {
+      if (typeof msgOrObj === "string") {
+        if (hasBindings) {
+          consoleFn(prefix, bindings, msgOrObj, ...args);
+        } else {
+          consoleFn(prefix, msgOrObj, ...args);
+        }
+      } else {
+        const [msg, ...restArgs] = args;
+        const mergedObj = hasBindings ? { ...bindings, ...msgOrObj } : msgOrObj;
+        if (msg) {
+          consoleFn(prefix, mergedObj, msg, ...restArgs);
+        } else {
+          consoleFn(prefix, mergedObj);
+        }
+      }
+    };
+  }
+  return {
+    fatal: createLogMethod("fatal"),
+    error: createLogMethod("error"),
+    warn: createLogMethod("warn"),
+    info: createLogMethod("info"),
+    debug: createLogMethod("debug"),
+    trace: createLogMethod("trace"),
+    child: (newBindings) => {
+      return createChildConsoleLogger({ ...bindings, ...newBindings });
+    }
+  };
+}
+
+// src/errors.ts
+function isErrorWithCode(error) {
+  return error instanceof Error && "code" in error && typeof error.code === "string";
+}
+
+// src/index.ts
 function isV4Schema(schema) {
   return "_zod" in schema;
 }
@@ -127,7 +189,10 @@ var sendMessageEventSchema = z.union([
 0 && (module.exports = {
   assistantMessageSchema,
   clientMessageSchema,
+  createConsoleLogger,
+  isErrorWithCode,
   isV4Schema,
+  noopLogger,
   sendMessageEventSchema,
   sendMessageInputSchema,
   systemMessageSchema,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import * as z from \"zod/v4\";\nimport * as z3 from \"zod/v3\";\nimport * as z4 from \"zod/v4/core\";\n\n// https://zod.dev/library-authors#how-to-support-zod-3-and-zod-4-simultaneously\nexport type Schema = z3.ZodTypeAny | z4.$ZodType;\nexport type ZodInfer<T> = T extends z3.ZodTypeAny ? z3.infer<T> : z4.infer<T>;\nexport function isV4Schema(schema: Schema): schema is z4.$ZodType {\n  return \"_zod\" in schema;\n}\n\nexport const systemMessageSchema = z.object({\n  role: z.literal(\"system\"),\n  content: z.string(),\n});\n\nexport const userMessageSchema = z.object({\n  role: z.literal(\"user\"),\n  content: z.string(),\n});\n\nexport const toolMessageSchema = z.object({\n  role: z.literal(\"tool\"),\n  content: z.string(),\n  toolCallId: z.string(),\n});\n\nexport const assistantMessageSchema = z.object({\n  role: z.literal(\"assistant\"),\n  content: z.string().optional(),\n  toolCalls: z\n    .array(\n      z.object({\n        id: z.string(),\n        type: z.literal(\"function\"),\n        function: z.object({\n          name: z.string(),\n          arguments: z.string(),\n        }),\n      })\n    )\n    .optional(),\n});\n\nexport const clientMessageSchema = z.union([\n  systemMessageSchema,\n  userMessageSchema,\n  toolMessageSchema,\n  assistantMessageSchema,\n]);\n\nexport const toolSchema = z.object({\n  name: z.string(),\n  description: z.string(),\n  parameters: z.any(),\n});\n\nexport const sendMessageInputSchema = z.object({\n  conversationId: z.string(),\n  messages: z.array(clientMessageSchema).optional(),\n  resume: z\n    .object({\n      interruptId: z.string(),\n      payload: z.any(),\n    })\n    .optional(),\n  tools: z.array(toolSchema).optional(),\n});\n\nexport const sendMessageEventSchema = z.union([\n  z.object({\n    type: z.literal(\"text\"),\n    content: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"tool-call-start\"),\n    toolCallId: z.string(),\n    toolCallName: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"tool-call-args\"),\n    toolCallId: z.string(),\n    delta: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"tool-call-end\"),\n    toolCallId: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"tool-result\"),\n    toolCallId: z.string(),\n    result: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"interrupt\"),\n    id: z.string(),\n    reason: z.string(),\n    payload: z.any(),\n  }),\n]);\n\nexport type SendMessageInput = z.infer<typeof sendMessageInputSchema>;\nexport type ClientMessage = z.infer<typeof clientMessageSchema>;\nexport type SystemMessage = z.infer<typeof systemMessageSchema>;\nexport type UserMessage = z.infer<typeof userMessageSchema>;\nexport type ToolMessage = z.infer<typeof toolMessageSchema>;\nexport type AssistantMessage = z.infer<typeof assistantMessageSchema>;\nexport type Tool = z.infer<typeof toolSchema>;\nexport type SendMessageEvent = z.infer<typeof sendMessageEventSchema>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAAmB;AAOZ,SAAS,WAAW,QAAuC;AAChE,SAAO,UAAU;AACnB;AAEO,IAAM,sBAAwB,SAAO;AAAA,EAC1C,MAAQ,UAAQ,QAAQ;AAAA,EACxB,SAAW,SAAO;AACpB,CAAC;AAEM,IAAM,oBAAsB,SAAO;AAAA,EACxC,MAAQ,UAAQ,MAAM;AAAA,EACtB,SAAW,SAAO;AACpB,CAAC;AAEM,IAAM,oBAAsB,SAAO;AAAA,EACxC,MAAQ,UAAQ,MAAM;AAAA,EACtB,SAAW,SAAO;AAAA,EAClB,YAAc,SAAO;AACvB,CAAC;AAEM,IAAM,yBAA2B,SAAO;AAAA,EAC7C,MAAQ,UAAQ,WAAW;AAAA,EAC3B,SAAW,SAAO,EAAE,SAAS;AAAA,EAC7B,WACG;AAAA,IACG,SAAO;AAAA,MACP,IAAM,SAAO;AAAA,MACb,MAAQ,UAAQ,UAAU;AAAA,MAC1B,UAAY,SAAO;AAAA,QACjB,MAAQ,SAAO;AAAA,QACf,WAAa,SAAO;AAAA,MACtB,CAAC;AAAA,IACH,CAAC;AAAA,EACH,EACC,SAAS;AACd,CAAC;AAEM,IAAM,sBAAwB,QAAM;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,IAAM,aAAe,SAAO;AAAA,EACjC,MAAQ,SAAO;AAAA,EACf,aAAe,SAAO;AAAA,EACtB,YAAc,MAAI;AACpB,CAAC;AAEM,IAAM,yBAA2B,SAAO;AAAA,EAC7C,gBAAkB,SAAO;AAAA,EACzB,UAAY,QAAM,mBAAmB,EAAE,SAAS;AAAA,EAChD,QACG,SAAO;AAAA,IACN,aAAe,SAAO;AAAA,IACtB,SAAW,MAAI;AAAA,EACjB,CAAC,EACA,SAAS;AAAA,EACZ,OAAS,QAAM,UAAU,EAAE,SAAS;AACtC,CAAC;AAEM,IAAM,yBAA2B,QAAM;AAAA,EAC1C,SAAO;AAAA,IACP,MAAQ,UAAQ,MAAM;AAAA,IACtB,SAAW,SAAO;AAAA,EACpB,CAAC;AAAA,EACC,SAAO;AAAA,IACP,MAAQ,UAAQ,iBAAiB;AAAA,IACjC,YAAc,SAAO;AAAA,IACrB,cAAgB,SAAO;AAAA,EACzB,CAAC;AAAA,EACC,SAAO;AAAA,IACP,MAAQ,UAAQ,gBAAgB;AAAA,IAChC,YAAc,SAAO;AAAA,IACrB,OAAS,SAAO;AAAA,EAClB,CAAC;AAAA,EACC,SAAO;AAAA,IACP,MAAQ,UAAQ,eAAe;AAAA,IAC/B,YAAc,SAAO;AAAA,EACvB,CAAC;AAAA,EACC,SAAO;AAAA,IACP,MAAQ,UAAQ,aAAa;AAAA,IAC7B,YAAc,SAAO;AAAA,IACrB,QAAU,SAAO;AAAA,EACnB,CAAC;AAAA,EACC,SAAO;AAAA,IACP,MAAQ,UAAQ,WAAW;AAAA,IAC3B,IAAM,SAAO;AAAA,IACb,QAAU,SAAO;AAAA,IACjB,SAAW,MAAI;AAAA,EACjB,CAAC;AACH,CAAC;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/logger.ts","../src/errors.ts"],"sourcesContent":["import * as z from \"zod/v4\";\nimport * as z3 from \"zod/v3\";\nimport * as z4 from \"zod/v4/core\";\n\n// Logger exports\nexport { type Logger, type LogFn, noopLogger, createConsoleLogger } from \"./logger\";\n\n// Error handling exports\nexport { isErrorWithCode } from \"./errors\";\n\n// https://zod.dev/library-authors#how-to-support-zod-3-and-zod-4-simultaneously\nexport type Schema = z3.ZodTypeAny | z4.$ZodType;\nexport type ZodInfer<T> = T extends z3.ZodTypeAny ? z3.infer<T> : z4.infer<T>;\nexport function isV4Schema(schema: Schema): schema is z4.$ZodType {\n  return \"_zod\" in schema;\n}\n\nexport const systemMessageSchema = z.object({\n  role: z.literal(\"system\"),\n  content: z.string(),\n});\n\nexport const userMessageSchema = z.object({\n  role: z.literal(\"user\"),\n  content: z.string(),\n});\n\nexport const toolMessageSchema = z.object({\n  role: z.literal(\"tool\"),\n  content: z.string(),\n  toolCallId: z.string(),\n});\n\nexport const assistantMessageSchema = z.object({\n  role: z.literal(\"assistant\"),\n  content: z.string().optional(),\n  toolCalls: z\n    .array(\n      z.object({\n        id: z.string(),\n        type: z.literal(\"function\"),\n        function: z.object({\n          name: z.string(),\n          arguments: z.string(),\n        }),\n      })\n    )\n    .optional(),\n});\n\nexport const clientMessageSchema = z.union([\n  systemMessageSchema,\n  userMessageSchema,\n  toolMessageSchema,\n  assistantMessageSchema,\n]);\n\nexport const toolSchema = z.object({\n  name: z.string(),\n  description: z.string(),\n  parameters: z.any(),\n});\n\nexport const sendMessageInputSchema = z.object({\n  conversationId: z.string(),\n  messages: z.array(clientMessageSchema).optional(),\n  resume: z\n    .object({\n      interruptId: z.string(),\n      payload: z.any(),\n    })\n    .optional(),\n  tools: z.array(toolSchema).optional(),\n});\n\nexport const sendMessageEventSchema = z.union([\n  z.object({\n    type: z.literal(\"text\"),\n    content: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"tool-call-start\"),\n    toolCallId: z.string(),\n    toolCallName: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"tool-call-args\"),\n    toolCallId: z.string(),\n    delta: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"tool-call-end\"),\n    toolCallId: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"tool-result\"),\n    toolCallId: z.string(),\n    result: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"interrupt\"),\n    id: z.string(),\n    reason: z.string(),\n    payload: z.any(),\n  }),\n]);\n\nexport type SendMessageInput = z.infer<typeof sendMessageInputSchema>;\nexport type ClientMessage = z.infer<typeof clientMessageSchema>;\nexport type SystemMessage = z.infer<typeof systemMessageSchema>;\nexport type UserMessage = z.infer<typeof userMessageSchema>;\nexport type ToolMessage = z.infer<typeof toolMessageSchema>;\nexport type AssistantMessage = z.infer<typeof assistantMessageSchema>;\nexport type Tool = z.infer<typeof toolSchema>;\nexport type SendMessageEvent = z.infer<typeof sendMessageEventSchema>;\n","/**\n * Logger interface\n *\n * This follows the \"Bring Your Own Logger\" (BYOL) pattern:\n * - Users can inject their own logger (Pino, Winston, console, etc.)\n * - All methods are optional - if a method exists, we use it; if not, we skip it\n * - The interface is a \"slot\" for users to plug in their logger\n *\n * The signature supports two common calling conventions:\n * 1. Printf style (Winston/Console): logger.info(\"Port %d\", 8080)\n * 2. Structured style (Pino): logger.info({ port: 8080 }, \"Server started\")\n */\n\n/**\n * Log method signature supporting both structured and printf-style logging.\n *\n * @example\n * // Printf style\n * logger.info(\"Hello %s\", \"world\");\n *\n * // Structured style (Pino-compatible)\n * logger.info({ userId: 123 }, \"User logged in\");\n *\n * // Simple message\n * logger.info(\"Server started\");\n */\nexport interface LogFn {\n  // Printf style: message with format args\n  (msg: string, ...args: unknown[]): void;\n  // Structured style: object with optional message and format args\n  (obj: object, msg?: string, ...args: unknown[]): void;\n}\n\n/**\n * Logger interface - a minimal \"slot\" for users to plug in their logger.\n *\n * All methods are optional. If a method exists on the user's logger, we use it;\n * if not, we simply skip it. This allows maximum compatibility with any logger.\n *\n * Compatible with: Pino, Winston, Bunyan, console, or any custom logger.\n *\n * @example\n * // Inject Pino\n * import pino from 'pino';\n * createExpressServer({ createAgent, logger: pino() });\n *\n * // Inject Winston\n * import winston from 'winston';\n * createExpressServer({ createAgent, logger: winston.createLogger() });\n *\n * // Inject console (for development)\n * createExpressServer({ createAgent, logger: console });\n */\nexport interface Logger {\n  /**\n   * Fatal level - system is unusable, immediate action required.\n   * Use for: unrecoverable errors, process about to crash.\n   */\n  fatal?: LogFn;\n\n  /**\n   * Error level - failures requiring attention.\n   * Use for: 5xx errors, unhandled exceptions, critical failures.\n   */\n  error?: LogFn;\n\n  /**\n   * Warn level - recoverable issues, deprecation notices.\n   * Use for: 4xx errors, missing config with fallback, retry attempts.\n   */\n  warn?: LogFn;\n\n  /**\n   * Info level - key lifecycle events (production default).\n   * Use for: server started, client connected, request completed.\n   */\n  info?: LogFn;\n\n  /**\n   * Debug level - diagnostic information for logic flow.\n   * Use for: request received, state changes, configuration loaded.\n   */\n  debug?: LogFn;\n\n  /**\n   * Trace level - extremely verbose, for library internals debugging.\n   * Use for: raw bytes, loop iterations, function entry/exit.\n   */\n  trace?: LogFn;\n\n  /**\n   * Creates a child logger with additional context.\n   * The child inherits all parent context and adds its own.\n   *\n   * @example\n   * const requestLogger = logger.child({ requestId: 'req-123' });\n   * requestLogger.info(\"Processing request\"); // includes requestId in output\n   */\n  child?(bindings: Record<string, unknown>): Logger;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nconst noop: LogFn = (_msgOrObj: unknown, ..._args: unknown[]) => {};\n\n/**\n * No-op logger implementation (Abstract Logging pattern).\n *\n * This is the default logger - it does nothing.\n * This ensures:\n * 1. The library is silent by default (respects user's console)\n * 2. No performance overhead from console.log in production\n * 3. No need for `if (logger)` checks throughout the code\n *\n * @example\n * // Default: silent\n * createExpressServer({ createAgent });\n *\n * // Development: see logs\n * createExpressServer({ createAgent, logger: console });\n *\n * // Production: structured JSON logs\n * import pino from 'pino';\n * createExpressServer({ createAgent, logger: pino() });\n */\nexport const noopLogger: Logger = {\n  fatal: noop,\n  error: noop,\n  warn: noop,\n  info: noop,\n  debug: noop,\n  trace: noop,\n  child: () => noopLogger,\n};\n\n/**\n * Creates a console-based logger that wraps console methods.\n * Useful for development when you want simple console output.\n *\n * Note: console.log is synchronous and blocking - avoid in high-throughput production.\n *\n * @example\n * createExpressServer({ createAgent, logger: createConsoleLogger() });\n */\nexport function createConsoleLogger(): Logger {\n  return createChildConsoleLogger({});\n}\n\nfunction createChildConsoleLogger(bindings: Record<string, unknown>): Logger {\n  const hasBindings = Object.keys(bindings).length > 0;\n\n  function createLogMethod(\n    level: \"fatal\" | \"error\" | \"warn\" | \"info\" | \"debug\" | \"trace\"\n  ): LogFn {\n    // Map fatal to error, trace to debug for console\n    const consoleMethod =\n      level === \"fatal\"\n        ? \"error\"\n        : level === \"trace\"\n          ? \"debug\"\n          : level;\n    const consoleFn = console[consoleMethod] || console.log;\n    const prefix = `[${level.toUpperCase()}]`;\n\n    return (msgOrObj: unknown, ...args: unknown[]) => {\n      if (typeof msgOrObj === \"string\") {\n        // Printf style: logger.info(\"Hello %s\", \"world\")\n        if (hasBindings) {\n          consoleFn(prefix, bindings, msgOrObj, ...args);\n        } else {\n          consoleFn(prefix, msgOrObj, ...args);\n        }\n      } else {\n        // Structured style: logger.info({ userId: 1 }, \"User logged in\")\n        const [msg, ...restArgs] = args;\n        const mergedObj = hasBindings\n          ? { ...bindings, ...(msgOrObj as object) }\n          : msgOrObj;\n        if (msg) {\n          consoleFn(prefix, mergedObj, msg, ...restArgs);\n        } else {\n          consoleFn(prefix, mergedObj);\n        }\n      }\n    };\n  }\n\n  return {\n    fatal: createLogMethod(\"fatal\"),\n    error: createLogMethod(\"error\"),\n    warn: createLogMethod(\"warn\"),\n    info: createLogMethod(\"info\"),\n    debug: createLogMethod(\"debug\"),\n    trace: createLogMethod(\"trace\"),\n    child: (newBindings: Record<string, unknown>) => {\n      return createChildConsoleLogger({ ...bindings, ...newBindings });\n    },\n  };\n}\n\n","/**\n * Type guard to check if an error has a code property.\n */\nexport function isErrorWithCode(\n  error: unknown\n): error is Error & { code: string } {\n  return (\n    error instanceof Error &&\n    \"code\" in error &&\n    typeof error.code === \"string\"\n  );\n}\n\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAAmB;;;ACsGnB,IAAM,OAAc,CAAC,cAAuB,UAAqB;AAAC;AAsB3D,IAAM,aAAqB;AAAA,EAChC,OAAO;AAAA,EACP,OAAO;AAAA,EACP,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO,MAAM;AACf;AAWO,SAAS,sBAA8B;AAC5C,SAAO,yBAAyB,CAAC,CAAC;AACpC;AAEA,SAAS,yBAAyB,UAA2C;AAC3E,QAAM,cAAc,OAAO,KAAK,QAAQ,EAAE,SAAS;AAEnD,WAAS,gBACP,OACO;AAEP,UAAM,gBACJ,UAAU,UACN,UACA,UAAU,UACR,UACA;AACR,UAAM,YAAY,QAAQ,aAAa,KAAK,QAAQ;AACpD,UAAM,SAAS,IAAI,MAAM,YAAY,CAAC;AAEtC,WAAO,CAAC,aAAsB,SAAoB;AAChD,UAAI,OAAO,aAAa,UAAU;AAEhC,YAAI,aAAa;AACf,oBAAU,QAAQ,UAAU,UAAU,GAAG,IAAI;AAAA,QAC/C,OAAO;AACL,oBAAU,QAAQ,UAAU,GAAG,IAAI;AAAA,QACrC;AAAA,MACF,OAAO;AAEL,cAAM,CAAC,KAAK,GAAG,QAAQ,IAAI;AAC3B,cAAM,YAAY,cACd,EAAE,GAAG,UAAU,GAAI,SAAoB,IACvC;AACJ,YAAI,KAAK;AACP,oBAAU,QAAQ,WAAW,KAAK,GAAG,QAAQ;AAAA,QAC/C,OAAO;AACL,oBAAU,QAAQ,SAAS;AAAA,QAC7B;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,gBAAgB,OAAO;AAAA,IAC9B,OAAO,gBAAgB,OAAO;AAAA,IAC9B,MAAM,gBAAgB,MAAM;AAAA,IAC5B,MAAM,gBAAgB,MAAM;AAAA,IAC5B,OAAO,gBAAgB,OAAO;AAAA,IAC9B,OAAO,gBAAgB,OAAO;AAAA,IAC9B,OAAO,CAAC,gBAAyC;AAC/C,aAAO,yBAAyB,EAAE,GAAG,UAAU,GAAG,YAAY,CAAC;AAAA,IACjE;AAAA,EACF;AACF;;;AClMO,SAAS,gBACd,OACmC;AACnC,SACE,iBAAiB,SACjB,UAAU,SACV,OAAO,MAAM,SAAS;AAE1B;;;AFEO,SAAS,WAAW,QAAuC;AAChE,SAAO,UAAU;AACnB;AAEO,IAAM,sBAAwB,SAAO;AAAA,EAC1C,MAAQ,UAAQ,QAAQ;AAAA,EACxB,SAAW,SAAO;AACpB,CAAC;AAEM,IAAM,oBAAsB,SAAO;AAAA,EACxC,MAAQ,UAAQ,MAAM;AAAA,EACtB,SAAW,SAAO;AACpB,CAAC;AAEM,IAAM,oBAAsB,SAAO;AAAA,EACxC,MAAQ,UAAQ,MAAM;AAAA,EACtB,SAAW,SAAO;AAAA,EAClB,YAAc,SAAO;AACvB,CAAC;AAEM,IAAM,yBAA2B,SAAO;AAAA,EAC7C,MAAQ,UAAQ,WAAW;AAAA,EAC3B,SAAW,SAAO,EAAE,SAAS;AAAA,EAC7B,WACG;AAAA,IACG,SAAO;AAAA,MACP,IAAM,SAAO;AAAA,MACb,MAAQ,UAAQ,UAAU;AAAA,MAC1B,UAAY,SAAO;AAAA,QACjB,MAAQ,SAAO;AAAA,QACf,WAAa,SAAO;AAAA,MACtB,CAAC;AAAA,IACH,CAAC;AAAA,EACH,EACC,SAAS;AACd,CAAC;AAEM,IAAM,sBAAwB,QAAM;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,IAAM,aAAe,SAAO;AAAA,EACjC,MAAQ,SAAO;AAAA,EACf,aAAe,SAAO;AAAA,EACtB,YAAc,MAAI;AACpB,CAAC;AAEM,IAAM,yBAA2B,SAAO;AAAA,EAC7C,gBAAkB,SAAO;AAAA,EACzB,UAAY,QAAM,mBAAmB,EAAE,SAAS;AAAA,EAChD,QACG,SAAO;AAAA,IACN,aAAe,SAAO;AAAA,IACtB,SAAW,MAAI;AAAA,EACjB,CAAC,EACA,SAAS;AAAA,EACZ,OAAS,QAAM,UAAU,EAAE,SAAS;AACtC,CAAC;AAEM,IAAM,yBAA2B,QAAM;AAAA,EAC1C,SAAO;AAAA,IACP,MAAQ,UAAQ,MAAM;AAAA,IACtB,SAAW,SAAO;AAAA,EACpB,CAAC;AAAA,EACC,SAAO;AAAA,IACP,MAAQ,UAAQ,iBAAiB;AAAA,IACjC,YAAc,SAAO;AAAA,IACrB,cAAgB,SAAO;AAAA,EACzB,CAAC;AAAA,EACC,SAAO;AAAA,IACP,MAAQ,UAAQ,gBAAgB;AAAA,IAChC,YAAc,SAAO;AAAA,IACrB,OAAS,SAAO;AAAA,EAClB,CAAC;AAAA,EACC,SAAO;AAAA,IACP,MAAQ,UAAQ,eAAe;AAAA,IAC/B,YAAc,SAAO;AAAA,EACvB,CAAC;AAAA,EACC,SAAO;AAAA,IACP,MAAQ,UAAQ,aAAa;AAAA,IAC7B,YAAc,SAAO;AAAA,IACrB,QAAU,SAAO;AAAA,EACnB,CAAC;AAAA,EACC,SAAO;AAAA,IACP,MAAQ,UAAQ,WAAW;AAAA,IAC3B,IAAM,SAAO;AAAA,IACb,QAAU,SAAO;AAAA,IACjB,SAAW,MAAI;AAAA,EACjB,CAAC;AACH,CAAC;","names":[]}

package/dist/index.mjs

@@ -1,5 +1,64 @@
 // src/index.ts
 import * as z from "zod/v4";
+
+// src/logger.ts
+var noop = (_msgOrObj, ..._args) => {
+};
+var noopLogger = {
+  fatal: noop,
+  error: noop,
+  warn: noop,
+  info: noop,
+  debug: noop,
+  trace: noop,
+  child: () => noopLogger
+};
+function createConsoleLogger() {
+  return createChildConsoleLogger({});
+}
+function createChildConsoleLogger(bindings) {
+  const hasBindings = Object.keys(bindings).length > 0;
+  function createLogMethod(level) {
+    const consoleMethod = level === "fatal" ? "error" : level === "trace" ? "debug" : level;
+    const consoleFn = console[consoleMethod] || console.log;
+    const prefix = `[${level.toUpperCase()}]`;
+    return (msgOrObj, ...args) => {
+      if (typeof msgOrObj === "string") {
+        if (hasBindings) {
+          consoleFn(prefix, bindings, msgOrObj, ...args);
+        } else {
+          consoleFn(prefix, msgOrObj, ...args);
+        }
+      } else {
+        const [msg, ...restArgs] = args;
+        const mergedObj = hasBindings ? { ...bindings, ...msgOrObj } : msgOrObj;
+        if (msg) {
+          consoleFn(prefix, mergedObj, msg, ...restArgs);
+        } else {
+          consoleFn(prefix, mergedObj);
+        }
+      }
+    };
+  }
+  return {
+    fatal: createLogMethod("fatal"),
+    error: createLogMethod("error"),
+    warn: createLogMethod("warn"),
+    info: createLogMethod("info"),
+    debug: createLogMethod("debug"),
+    trace: createLogMethod("trace"),
+    child: (newBindings) => {
+      return createChildConsoleLogger({ ...bindings, ...newBindings });
+    }
+  };
+}
+
+// src/errors.ts
+function isErrorWithCode(error) {
+  return error instanceof Error && "code" in error && typeof error.code === "string";
+}
+
+// src/index.ts
 function isV4Schema(schema) {
   return "_zod" in schema;
 }
@@ -84,7 +143,10 @@ var sendMessageEventSchema = z.union([
 export {
   assistantMessageSchema,
   clientMessageSchema,
+  createConsoleLogger,
+  isErrorWithCode,
   isV4Schema,
+  noopLogger,
   sendMessageEventSchema,
   sendMessageInputSchema,
   systemMessageSchema,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import * as z from \"zod/v4\";\nimport * as z3 from \"zod/v3\";\nimport * as z4 from \"zod/v4/core\";\n\n// https://zod.dev/library-authors#how-to-support-zod-3-and-zod-4-simultaneously\nexport type Schema = z3.ZodTypeAny | z4.$ZodType;\nexport type ZodInfer<T> = T extends z3.ZodTypeAny ? z3.infer<T> : z4.infer<T>;\nexport function isV4Schema(schema: Schema): schema is z4.$ZodType {\n  return \"_zod\" in schema;\n}\n\nexport const systemMessageSchema = z.object({\n  role: z.literal(\"system\"),\n  content: z.string(),\n});\n\nexport const userMessageSchema = z.object({\n  role: z.literal(\"user\"),\n  content: z.string(),\n});\n\nexport const toolMessageSchema = z.object({\n  role: z.literal(\"tool\"),\n  content: z.string(),\n  toolCallId: z.string(),\n});\n\nexport const assistantMessageSchema = z.object({\n  role: z.literal(\"assistant\"),\n  content: z.string().optional(),\n  toolCalls: z\n    .array(\n      z.object({\n        id: z.string(),\n        type: z.literal(\"function\"),\n        function: z.object({\n          name: z.string(),\n          arguments: z.string(),\n        }),\n      })\n    )\n    .optional(),\n});\n\nexport const clientMessageSchema = z.union([\n  systemMessageSchema,\n  userMessageSchema,\n  toolMessageSchema,\n  assistantMessageSchema,\n]);\n\nexport const toolSchema = z.object({\n  name: z.string(),\n  description: z.string(),\n  parameters: z.any(),\n});\n\nexport const sendMessageInputSchema = z.object({\n  conversationId: z.string(),\n  messages: z.array(clientMessageSchema).optional(),\n  resume: z\n    .object({\n      interruptId: z.string(),\n      payload: z.any(),\n    })\n    .optional(),\n  tools: z.array(toolSchema).optional(),\n});\n\nexport const sendMessageEventSchema = z.union([\n  z.object({\n    type: z.literal(\"text\"),\n    content: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"tool-call-start\"),\n    toolCallId: z.string(),\n    toolCallName: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"tool-call-args\"),\n    toolCallId: z.string(),\n    delta: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"tool-call-end\"),\n    toolCallId: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"tool-result\"),\n    toolCallId: z.string(),\n    result: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"interrupt\"),\n    id: z.string(),\n    reason: z.string(),\n    payload: z.any(),\n  }),\n]);\n\nexport type SendMessageInput = z.infer<typeof sendMessageInputSchema>;\nexport type ClientMessage = z.infer<typeof clientMessageSchema>;\nexport type SystemMessage = z.infer<typeof systemMessageSchema>;\nexport type UserMessage = z.infer<typeof userMessageSchema>;\nexport type ToolMessage = z.infer<typeof toolMessageSchema>;\nexport type AssistantMessage = z.infer<typeof assistantMessageSchema>;\nexport type Tool = z.infer<typeof toolSchema>;\nexport type SendMessageEvent = z.infer<typeof sendMessageEventSchema>;\n"],"mappings":";AAAA,YAAY,OAAO;AAOZ,SAAS,WAAW,QAAuC;AAChE,SAAO,UAAU;AACnB;AAEO,IAAM,sBAAwB,SAAO;AAAA,EAC1C,MAAQ,UAAQ,QAAQ;AAAA,EACxB,SAAW,SAAO;AACpB,CAAC;AAEM,IAAM,oBAAsB,SAAO;AAAA,EACxC,MAAQ,UAAQ,MAAM;AAAA,EACtB,SAAW,SAAO;AACpB,CAAC;AAEM,IAAM,oBAAsB,SAAO;AAAA,EACxC,MAAQ,UAAQ,MAAM;AAAA,EACtB,SAAW,SAAO;AAAA,EAClB,YAAc,SAAO;AACvB,CAAC;AAEM,IAAM,yBAA2B,SAAO;AAAA,EAC7C,MAAQ,UAAQ,WAAW;AAAA,EAC3B,SAAW,SAAO,EAAE,SAAS;AAAA,EAC7B,WACG;AAAA,IACG,SAAO;AAAA,MACP,IAAM,SAAO;AAAA,MACb,MAAQ,UAAQ,UAAU;AAAA,MAC1B,UAAY,SAAO;AAAA,QACjB,MAAQ,SAAO;AAAA,QACf,WAAa,SAAO;AAAA,MACtB,CAAC;AAAA,IACH,CAAC;AAAA,EACH,EACC,SAAS;AACd,CAAC;AAEM,IAAM,sBAAwB,QAAM;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,IAAM,aAAe,SAAO;AAAA,EACjC,MAAQ,SAAO;AAAA,EACf,aAAe,SAAO;AAAA,EACtB,YAAc,MAAI;AACpB,CAAC;AAEM,IAAM,yBAA2B,SAAO;AAAA,EAC7C,gBAAkB,SAAO;AAAA,EACzB,UAAY,QAAM,mBAAmB,EAAE,SAAS;AAAA,EAChD,QACG,SAAO;AAAA,IACN,aAAe,SAAO;AAAA,IACtB,SAAW,MAAI;AAAA,EACjB,CAAC,EACA,SAAS;AAAA,EACZ,OAAS,QAAM,UAAU,EAAE,SAAS;AACtC,CAAC;AAEM,IAAM,yBAA2B,QAAM;AAAA,EAC1C,SAAO;AAAA,IACP,MAAQ,UAAQ,MAAM;AAAA,IACtB,SAAW,SAAO;AAAA,EACpB,CAAC;AAAA,EACC,SAAO;AAAA,IACP,MAAQ,UAAQ,iBAAiB;AAAA,IACjC,YAAc,SAAO;AAAA,IACrB,cAAgB,SAAO;AAAA,EACzB,CAAC;AAAA,EACC,SAAO;AAAA,IACP,MAAQ,UAAQ,gBAAgB;AAAA,IAChC,YAAc,SAAO;AAAA,IACrB,OAAS,SAAO;AAAA,EAClB,CAAC;AAAA,EACC,SAAO;AAAA,IACP,MAAQ,UAAQ,eAAe;AAAA,IAC/B,YAAc,SAAO;AAAA,EACvB,CAAC;AAAA,EACC,SAAO;AAAA,IACP,MAAQ,UAAQ,aAAa;AAAA,IAC7B,YAAc,SAAO;AAAA,IACrB,QAAU,SAAO;AAAA,EACnB,CAAC;AAAA,EACC,SAAO;AAAA,IACP,MAAQ,UAAQ,WAAW;AAAA,IAC3B,IAAM,SAAO;AAAA,IACb,QAAU,SAAO;AAAA,IACjB,SAAW,MAAI;AAAA,EACjB,CAAC;AACH,CAAC;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/logger.ts","../src/errors.ts"],"sourcesContent":["import * as z from \"zod/v4\";\nimport * as z3 from \"zod/v3\";\nimport * as z4 from \"zod/v4/core\";\n\n// Logger exports\nexport { type Logger, type LogFn, noopLogger, createConsoleLogger } from \"./logger\";\n\n// Error handling exports\nexport { isErrorWithCode } from \"./errors\";\n\n// https://zod.dev/library-authors#how-to-support-zod-3-and-zod-4-simultaneously\nexport type Schema = z3.ZodTypeAny | z4.$ZodType;\nexport type ZodInfer<T> = T extends z3.ZodTypeAny ? z3.infer<T> : z4.infer<T>;\nexport function isV4Schema(schema: Schema): schema is z4.$ZodType {\n  return \"_zod\" in schema;\n}\n\nexport const systemMessageSchema = z.object({\n  role: z.literal(\"system\"),\n  content: z.string(),\n});\n\nexport const userMessageSchema = z.object({\n  role: z.literal(\"user\"),\n  content: z.string(),\n});\n\nexport const toolMessageSchema = z.object({\n  role: z.literal(\"tool\"),\n  content: z.string(),\n  toolCallId: z.string(),\n});\n\nexport const assistantMessageSchema = z.object({\n  role: z.literal(\"assistant\"),\n  content: z.string().optional(),\n  toolCalls: z\n    .array(\n      z.object({\n        id: z.string(),\n        type: z.literal(\"function\"),\n        function: z.object({\n          name: z.string(),\n          arguments: z.string(),\n        }),\n      })\n    )\n    .optional(),\n});\n\nexport const clientMessageSchema = z.union([\n  systemMessageSchema,\n  userMessageSchema,\n  toolMessageSchema,\n  assistantMessageSchema,\n]);\n\nexport const toolSchema = z.object({\n  name: z.string(),\n  description: z.string(),\n  parameters: z.any(),\n});\n\nexport const sendMessageInputSchema = z.object({\n  conversationId: z.string(),\n  messages: z.array(clientMessageSchema).optional(),\n  resume: z\n    .object({\n      interruptId: z.string(),\n      payload: z.any(),\n    })\n    .optional(),\n  tools: z.array(toolSchema).optional(),\n});\n\nexport const sendMessageEventSchema = z.union([\n  z.object({\n    type: z.literal(\"text\"),\n    content: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"tool-call-start\"),\n    toolCallId: z.string(),\n    toolCallName: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"tool-call-args\"),\n    toolCallId: z.string(),\n    delta: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"tool-call-end\"),\n    toolCallId: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"tool-result\"),\n    toolCallId: z.string(),\n    result: z.string(),\n  }),\n  z.object({\n    type: z.literal(\"interrupt\"),\n    id: z.string(),\n    reason: z.string(),\n    payload: z.any(),\n  }),\n]);\n\nexport type SendMessageInput = z.infer<typeof sendMessageInputSchema>;\nexport type ClientMessage = z.infer<typeof clientMessageSchema>;\nexport type SystemMessage = z.infer<typeof systemMessageSchema>;\nexport type UserMessage = z.infer<typeof userMessageSchema>;\nexport type ToolMessage = z.infer<typeof toolMessageSchema>;\nexport type AssistantMessage = z.infer<typeof assistantMessageSchema>;\nexport type Tool = z.infer<typeof toolSchema>;\nexport type SendMessageEvent = z.infer<typeof sendMessageEventSchema>;\n","/**\n * Logger interface\n *\n * This follows the \"Bring Your Own Logger\" (BYOL) pattern:\n * - Users can inject their own logger (Pino, Winston, console, etc.)\n * - All methods are optional - if a method exists, we use it; if not, we skip it\n * - The interface is a \"slot\" for users to plug in their logger\n *\n * The signature supports two common calling conventions:\n * 1. Printf style (Winston/Console): logger.info(\"Port %d\", 8080)\n * 2. Structured style (Pino): logger.info({ port: 8080 }, \"Server started\")\n */\n\n/**\n * Log method signature supporting both structured and printf-style logging.\n *\n * @example\n * // Printf style\n * logger.info(\"Hello %s\", \"world\");\n *\n * // Structured style (Pino-compatible)\n * logger.info({ userId: 123 }, \"User logged in\");\n *\n * // Simple message\n * logger.info(\"Server started\");\n */\nexport interface LogFn {\n  // Printf style: message with format args\n  (msg: string, ...args: unknown[]): void;\n  // Structured style: object with optional message and format args\n  (obj: object, msg?: string, ...args: unknown[]): void;\n}\n\n/**\n * Logger interface - a minimal \"slot\" for users to plug in their logger.\n *\n * All methods are optional. If a method exists on the user's logger, we use it;\n * if not, we simply skip it. This allows maximum compatibility with any logger.\n *\n * Compatible with: Pino, Winston, Bunyan, console, or any custom logger.\n *\n * @example\n * // Inject Pino\n * import pino from 'pino';\n * createExpressServer({ createAgent, logger: pino() });\n *\n * // Inject Winston\n * import winston from 'winston';\n * createExpressServer({ createAgent, logger: winston.createLogger() });\n *\n * // Inject console (for development)\n * createExpressServer({ createAgent, logger: console });\n */\nexport interface Logger {\n  /**\n   * Fatal level - system is unusable, immediate action required.\n   * Use for: unrecoverable errors, process about to crash.\n   */\n  fatal?: LogFn;\n\n  /**\n   * Error level - failures requiring attention.\n   * Use for: 5xx errors, unhandled exceptions, critical failures.\n   */\n  error?: LogFn;\n\n  /**\n   * Warn level - recoverable issues, deprecation notices.\n   * Use for: 4xx errors, missing config with fallback, retry attempts.\n   */\n  warn?: LogFn;\n\n  /**\n   * Info level - key lifecycle events (production default).\n   * Use for: server started, client connected, request completed.\n   */\n  info?: LogFn;\n\n  /**\n   * Debug level - diagnostic information for logic flow.\n   * Use for: request received, state changes, configuration loaded.\n   */\n  debug?: LogFn;\n\n  /**\n   * Trace level - extremely verbose, for library internals debugging.\n   * Use for: raw bytes, loop iterations, function entry/exit.\n   */\n  trace?: LogFn;\n\n  /**\n   * Creates a child logger with additional context.\n   * The child inherits all parent context and adds its own.\n   *\n   * @example\n   * const requestLogger = logger.child({ requestId: 'req-123' });\n   * requestLogger.info(\"Processing request\"); // includes requestId in output\n   */\n  child?(bindings: Record<string, unknown>): Logger;\n}\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nconst noop: LogFn = (_msgOrObj: unknown, ..._args: unknown[]) => {};\n\n/**\n * No-op logger implementation (Abstract Logging pattern).\n *\n * This is the default logger - it does nothing.\n * This ensures:\n * 1. The library is silent by default (respects user's console)\n * 2. No performance overhead from console.log in production\n * 3. No need for `if (logger)` checks throughout the code\n *\n * @example\n * // Default: silent\n * createExpressServer({ createAgent });\n *\n * // Development: see logs\n * createExpressServer({ createAgent, logger: console });\n *\n * // Production: structured JSON logs\n * import pino from 'pino';\n * createExpressServer({ createAgent, logger: pino() });\n */\nexport const noopLogger: Logger = {\n  fatal: noop,\n  error: noop,\n  warn: noop,\n  info: noop,\n  debug: noop,\n  trace: noop,\n  child: () => noopLogger,\n};\n\n/**\n * Creates a console-based logger that wraps console methods.\n * Useful for development when you want simple console output.\n *\n * Note: console.log is synchronous and blocking - avoid in high-throughput production.\n *\n * @example\n * createExpressServer({ createAgent, logger: createConsoleLogger() });\n */\nexport function createConsoleLogger(): Logger {\n  return createChildConsoleLogger({});\n}\n\nfunction createChildConsoleLogger(bindings: Record<string, unknown>): Logger {\n  const hasBindings = Object.keys(bindings).length > 0;\n\n  function createLogMethod(\n    level: \"fatal\" | \"error\" | \"warn\" | \"info\" | \"debug\" | \"trace\"\n  ): LogFn {\n    // Map fatal to error, trace to debug for console\n    const consoleMethod =\n      level === \"fatal\"\n        ? \"error\"\n        : level === \"trace\"\n          ? \"debug\"\n          : level;\n    const consoleFn = console[consoleMethod] || console.log;\n    const prefix = `[${level.toUpperCase()}]`;\n\n    return (msgOrObj: unknown, ...args: unknown[]) => {\n      if (typeof msgOrObj === \"string\") {\n        // Printf style: logger.info(\"Hello %s\", \"world\")\n        if (hasBindings) {\n          consoleFn(prefix, bindings, msgOrObj, ...args);\n        } else {\n          consoleFn(prefix, msgOrObj, ...args);\n        }\n      } else {\n        // Structured style: logger.info({ userId: 1 }, \"User logged in\")\n        const [msg, ...restArgs] = args;\n        const mergedObj = hasBindings\n          ? { ...bindings, ...(msgOrObj as object) }\n          : msgOrObj;\n        if (msg) {\n          consoleFn(prefix, mergedObj, msg, ...restArgs);\n        } else {\n          consoleFn(prefix, mergedObj);\n        }\n      }\n    };\n  }\n\n  return {\n    fatal: createLogMethod(\"fatal\"),\n    error: createLogMethod(\"error\"),\n    warn: createLogMethod(\"warn\"),\n    info: createLogMethod(\"info\"),\n    debug: createLogMethod(\"debug\"),\n    trace: createLogMethod(\"trace\"),\n    child: (newBindings: Record<string, unknown>) => {\n      return createChildConsoleLogger({ ...bindings, ...newBindings });\n    },\n  };\n}\n\n","/**\n * Type guard to check if an error has a code property.\n */\nexport function isErrorWithCode(\n  error: unknown\n): error is Error & { code: string } {\n  return (\n    error instanceof Error &&\n    \"code\" in error &&\n    typeof error.code === \"string\"\n  );\n}\n\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudbase/agent-shared",
-  "version": "1.0.1-alpha.7",
+  "version": "1.0.1-alpha.9",
   "description": "",
   "files": [
     "dist/",