@inkeep/agents-core 0.0.0-dev-20260407215434 → 0.0.0-dev-20260407230245

package/dist/utils/logger.d.ts

@@ -1,7 +1,7 @@
 import { Logger, LoggerOptions, TransportSingleOptions } from "pino";
 
 //#region src/utils/logger.d.ts
-
+declare function runWithLogContext<T>(bindings: Record<string, unknown>, fn: () => T): T;
 /**
  * Configuration options for PinoLogger
  */
@@ -10,6 +10,10 @@ interface PinoLoggerConfig {
   options?: LoggerOptions;
   /** Pino transport configuration */
   transportConfigs?: TransportSingleOptions[];
+  /** Pre-built pino instance (used internally by .with()) */
+  fromInstance?: Logger;
+  /** When true, disables ALS proxying (used by .with() for snapshot semantics) */
+  snapshot?: boolean;
 }
 /**
  * Pino logger implementation with transport customization support
@@ -19,6 +23,8 @@ declare class PinoLogger {
   private transportConfigs;
   private pinoInstance;
   private options;
+  private alsChildCache;
+  private isSnapshot;
   constructor(name: string, config?: PinoLoggerConfig);
   /**
    * Recreate the pino instance with current transports
@@ -44,9 +50,22 @@ declare class PinoLogger {
    * Get the underlying pino instance for advanced usage
    */
   getPinoInstance(): Logger;
+  private resolveInstance;
+  /**
+   * Creates a new PinoLogger with the given bindings baked in (snapshot semantics).
+   * Captures the current ALS context at call time. The returned logger does NOT
+   * pick up subsequent ALS context changes — use for class member loggers that
+   * are constructed once and reused within a request scope.
+   */
+  with(bindings: Record<string, unknown>): PinoLogger;
+  child(bindings: Record<string, unknown>): PinoLogger;
+  error(message: string): void;
   error(data: any, message: string): void;
+  warn(message: string): void;
   warn(data: any, message: string): void;
+  info(message: string): void;
   info(data: any, message: string): void;
+  debug(message: string): void;
   debug(data: any, message: string): void;
 }
 /**
@@ -83,4 +102,4 @@ declare const loggerFactory: LoggerFactory;
  */
 declare function getLogger(name: string): PinoLogger;
 //#endregion
-export { LoggerFactoryConfig, PinoLogger, PinoLoggerConfig, getLogger, loggerFactory };
+export { LoggerFactoryConfig, PinoLogger, PinoLoggerConfig, getLogger, loggerFactory, runWithLogContext };

package/dist/utils/logger.js

@@ -1,3 +1,4 @@
+import { AsyncLocalStorage } from "node:async_hooks";
 import pino from "pino";
 import pinoPretty from "pino-pretty";
 
@@ -13,15 +14,34 @@ function shouldColorize() {
 	if (process.env.NO_COLOR && process.env.NO_COLOR !== "") return false;
 	return process.stdout.isTTY ?? false;
 }
+const loggerStorage = new AsyncLocalStorage();
+function runWithLogContext(bindings, fn) {
+	const child = (loggerStorage.getStore() ?? basePinoInstance).child(bindings);
+	return loggerStorage.run(child, fn);
+}
+let basePinoInstance = pino({ level: "silent" });
+function setBasePinoInstance(instance) {
+	basePinoInstance = instance;
+}
 /**
 * Pino logger implementation with transport customization support
 */
-var PinoLogger = class {
+var PinoLogger = class PinoLogger {
 	transportConfigs = [];
 	pinoInstance;
 	options;
+	alsChildCache = /* @__PURE__ */ new WeakMap();
+	isSnapshot;
 	constructor(name, config = {}) {
 		this.name = name;
+		if (config.fromInstance) {
+			this.pinoInstance = config.fromInstance;
+			this.options = {};
+			this.isSnapshot = config.snapshot ?? false;
+			if (!this.isSnapshot) setBasePinoInstance(this.pinoInstance);
+			return;
+		}
+		this.isSnapshot = false;
 		this.options = {
 			name: this.name,
 			level: process.env.LOG_LEVEL || (process.env.ENVIRONMENT === "test" ? "silent" : "info"),
@@ -51,12 +71,14 @@ var PinoLogger = class {
 			console.warn("Warning: pino-pretty failed, using standard JSON output:", error);
 			this.pinoInstance = pino(this.options);
 		}
+		setBasePinoInstance(this.pinoInstance);
 	}
 	/**
 	* Recreate the pino instance with current transports
 	*/
 	recreateInstance() {
 		if (this.pinoInstance && typeof this.pinoInstance.flush === "function") this.pinoInstance.flush();
+		this.alsChildCache = /* @__PURE__ */ new WeakMap();
 		if (this.transportConfigs.length === 0) try {
 			const prettyStream = pinoPretty({
 				colorize: shouldColorize(),
@@ -112,17 +134,47 @@ var PinoLogger = class {
 	getPinoInstance() {
 		return this.pinoInstance;
 	}
-	error(data, message) {
-		this.pinoInstance.error(data, message);
+	resolveInstance() {
+		if (this.isSnapshot) return this.pinoInstance;
+		const alsInstance = loggerStorage.getStore();
+		if (!alsInstance) return this.pinoInstance;
+		let cached = this.alsChildCache.get(alsInstance);
+		if (!cached) {
+			cached = alsInstance.child({ module: this.name });
+			this.alsChildCache.set(alsInstance, cached);
+		}
+		return cached;
+	}
+	/**
+	* Creates a new PinoLogger with the given bindings baked in (snapshot semantics).
+	* Captures the current ALS context at call time. The returned logger does NOT
+	* pick up subsequent ALS context changes — use for class member loggers that
+	* are constructed once and reused within a request scope.
+	*/
+	with(bindings) {
+		return new PinoLogger(this.name, {
+			fromInstance: this.resolveInstance().child(bindings),
+			snapshot: true
+		});
+	}
+	child(bindings) {
+		return this.with(bindings);
+	}
+	error(dataOrMessage, message) {
+		if (message === void 0) this.resolveInstance().error(dataOrMessage);
+		else this.resolveInstance().error(dataOrMessage, message);
 	}
-	warn(data, message) {
-		this.pinoInstance.warn(data, message);
+	warn(dataOrMessage, message) {
+		if (message === void 0) this.resolveInstance().warn(dataOrMessage);
+		else this.resolveInstance().warn(dataOrMessage, message);
 	}
-	info(data, message) {
-		this.pinoInstance.info(data, message);
+	info(dataOrMessage, message) {
+		if (message === void 0) this.resolveInstance().info(dataOrMessage);
+		else this.resolveInstance().info(dataOrMessage, message);
 	}
-	debug(data, message) {
-		this.pinoInstance.debug(data, message);
+	debug(dataOrMessage, message) {
+		if (message === void 0) this.resolveInstance().debug(dataOrMessage);
+		else this.resolveInstance().debug(dataOrMessage, message);
 	}
 };
 /**
@@ -171,4 +223,4 @@ function getLogger(name) {
 }
 
 //#endregion
-export { PinoLogger, getLogger, loggerFactory };
+export { PinoLogger, getLogger, loggerFactory, runWithLogContext };

package/dist/validation/schemas/skills.d.ts

@@ -1,5 +1,5 @@
 import { z } from "@hono/zod-openapi";
-import * as drizzle_orm_pg_core1479 from "drizzle-orm/pg-core";
+import * as drizzle_orm_pg_core2196 from "drizzle-orm/pg-core";
 import * as drizzle_zod369 from "drizzle-zod";
 
 //#region src/validation/schemas/skills.d.ts
@@ -28,7 +28,7 @@ declare const SkillFileContentInputSchema: z.ZodObject<{
   content: z.ZodString;
 }, z.core.$strip>;
 declare const SkillFileSelectSchema: drizzle_zod369.BuildSchema<"select", {
-  createdAt: drizzle_orm_pg_core1479.PgColumn<{
+  createdAt: drizzle_orm_pg_core2196.PgColumn<{
     name: "created_at";
     tableName: "skill_files";
     dataType: "string";
@@ -45,7 +45,7 @@ declare const SkillFileSelectSchema: drizzle_zod369.BuildSchema<"select", {
     identity: undefined;
     generated: undefined;
   }, {}, {}>;
-  updatedAt: drizzle_orm_pg_core1479.PgColumn<{
+  updatedAt: drizzle_orm_pg_core2196.PgColumn<{
     name: "updated_at";
     tableName: "skill_files";
     dataType: "string";
@@ -62,7 +62,7 @@ declare const SkillFileSelectSchema: drizzle_zod369.BuildSchema<"select", {
     identity: undefined;
     generated: undefined;
   }, {}, {}>;
-  skillId: drizzle_orm_pg_core1479.PgColumn<{
+  skillId: drizzle_orm_pg_core2196.PgColumn<{
     name: "skill_id";
     tableName: "skill_files";
     dataType: "string";
@@ -81,7 +81,7 @@ declare const SkillFileSelectSchema: drizzle_zod369.BuildSchema<"select", {
   }, {}, {
     length: 64;
   }>;
-  filePath: drizzle_orm_pg_core1479.PgColumn<{
+  filePath: drizzle_orm_pg_core2196.PgColumn<{
     name: "file_path";
     tableName: "skill_files";
     dataType: "string";
@@ -100,7 +100,7 @@ declare const SkillFileSelectSchema: drizzle_zod369.BuildSchema<"select", {
   }, {}, {
     length: 1024;
   }>;
-  content: drizzle_orm_pg_core1479.PgColumn<{
+  content: drizzle_orm_pg_core2196.PgColumn<{
     name: "content";
     tableName: "skill_files";
     dataType: "string";
@@ -117,7 +117,7 @@ declare const SkillFileSelectSchema: drizzle_zod369.BuildSchema<"select", {
     identity: undefined;
     generated: undefined;
   }, {}, {}>;
-  projectId: drizzle_orm_pg_core1479.PgColumn<{
+  projectId: drizzle_orm_pg_core2196.PgColumn<{
     name: "project_id";
     tableName: "skill_files";
     dataType: "string";
@@ -136,7 +136,7 @@ declare const SkillFileSelectSchema: drizzle_zod369.BuildSchema<"select", {
   }, {}, {
     length: 256;
   }>;
-  tenantId: drizzle_orm_pg_core1479.PgColumn<{
+  tenantId: drizzle_orm_pg_core2196.PgColumn<{
     name: "tenant_id";
     tableName: "skill_files";
     dataType: "string";
@@ -155,7 +155,7 @@ declare const SkillFileSelectSchema: drizzle_zod369.BuildSchema<"select", {
   }, {}, {
     length: 256;
   }>;
-  id: drizzle_orm_pg_core1479.PgColumn<{
+  id: drizzle_orm_pg_core2196.PgColumn<{
     name: "id";
     tableName: "skill_files";
     dataType: "string";
@@ -175,7 +175,7 @@ declare const SkillFileSelectSchema: drizzle_zod369.BuildSchema<"select", {
     length: 256;
   }>;
 }, drizzle_zod369.BuildRefine<{
-  createdAt: drizzle_orm_pg_core1479.PgColumn<{
+  createdAt: drizzle_orm_pg_core2196.PgColumn<{
     name: "created_at";
     tableName: "skill_files";
     dataType: "string";
@@ -192,7 +192,7 @@ declare const SkillFileSelectSchema: drizzle_zod369.BuildSchema<"select", {
     identity: undefined;
     generated: undefined;
   }, {}, {}>;
-  updatedAt: drizzle_orm_pg_core1479.PgColumn<{
+  updatedAt: drizzle_orm_pg_core2196.PgColumn<{
     name: "updated_at";
     tableName: "skill_files";
     dataType: "string";
@@ -209,7 +209,7 @@ declare const SkillFileSelectSchema: drizzle_zod369.BuildSchema<"select", {
     identity: undefined;
     generated: undefined;
   }, {}, {}>;
-  skillId: drizzle_orm_pg_core1479.PgColumn<{
+  skillId: drizzle_orm_pg_core2196.PgColumn<{
     name: "skill_id";
     tableName: "skill_files";
     dataType: "string";
@@ -228,7 +228,7 @@ declare const SkillFileSelectSchema: drizzle_zod369.BuildSchema<"select", {
   }, {}, {
     length: 64;
   }>;
-  filePath: drizzle_orm_pg_core1479.PgColumn<{
+  filePath: drizzle_orm_pg_core2196.PgColumn<{
     name: "file_path";
     tableName: "skill_files";
     dataType: "string";
@@ -247,7 +247,7 @@ declare const SkillFileSelectSchema: drizzle_zod369.BuildSchema<"select", {
   }, {}, {
     length: 1024;
   }>;
-  content: drizzle_orm_pg_core1479.PgColumn<{
+  content: drizzle_orm_pg_core2196.PgColumn<{
     name: "content";
     tableName: "skill_files";
     dataType: "string";
@@ -264,7 +264,7 @@ declare const SkillFileSelectSchema: drizzle_zod369.BuildSchema<"select", {
     identity: undefined;
     generated: undefined;
   }, {}, {}>;
-  projectId: drizzle_orm_pg_core1479.PgColumn<{
+  projectId: drizzle_orm_pg_core2196.PgColumn<{
     name: "project_id";
     tableName: "skill_files";
     dataType: "string";
@@ -283,7 +283,7 @@ declare const SkillFileSelectSchema: drizzle_zod369.BuildSchema<"select", {
   }, {}, {
     length: 256;
   }>;
-  tenantId: drizzle_orm_pg_core1479.PgColumn<{
+  tenantId: drizzle_orm_pg_core2196.PgColumn<{
     name: "tenant_id";
     tableName: "skill_files";
     dataType: "string";
@@ -302,7 +302,7 @@ declare const SkillFileSelectSchema: drizzle_zod369.BuildSchema<"select", {
   }, {}, {
     length: 256;
   }>;
-  id: drizzle_orm_pg_core1479.PgColumn<{
+  id: drizzle_orm_pg_core2196.PgColumn<{
     name: "id";
     tableName: "skill_files";
     dataType: "string";
@@ -336,9 +336,9 @@ declare const SkillFileInsertSchema: z.ZodObject<{
   in: {};
 }>;
 declare const SkillInsertSchema: z.ZodObject<{
+  metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
   name: z.ZodString;
   description: z.ZodString;
-  metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
   content: z.ZodString;
 }, {
   out: {};
@@ -351,12 +351,12 @@ declare const SkillUpdateSchema: z.ZodObject<{
   }, z.core.$strip>>;
 }, z.core.$strip>;
 declare const SkillApiSelectSchema: z.ZodObject<{
-  id: z.ZodString;
+  metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
   name: z.ZodString;
+  id: z.ZodString;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
   description: z.ZodString;
-  metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
   content: z.ZodString;
 }, z.core.$strip>;
 declare const SkillApiInsertSchema: z.ZodPipe<z.ZodPipe<z.ZodObject<{
@@ -413,8 +413,8 @@ declare const SkillFileApiSelectSchema: z.ZodObject<{
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
   content: z.ZodString;
-  skillId: z.ZodString;
   filePath: z.ZodString;
+  skillId: z.ZodString;
 }, z.core.$strip>;
 declare const SkillFileApiInsertSchema: z.ZodObject<{
   filePath: z.ZodString;
@@ -424,20 +424,20 @@ declare const SkillFileApiUpdateSchema: z.ZodObject<{
   content: z.ZodString;
 }, z.core.$strip>;
 declare const SkillWithFilesApiSelectSchema: z.ZodObject<{
-  id: z.ZodString;
+  metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
   name: z.ZodString;
+  id: z.ZodString;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
   description: z.ZodString;
-  metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
   content: z.ZodString;
   files: z.ZodArray<z.ZodObject<{
     id: z.ZodString;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     content: z.ZodString;
-    skillId: z.ZodString;
     filePath: z.ZodString;
+    skillId: z.ZodString;
   }, z.core.$strip>>;
 }, z.core.$strip>;
 declare const SubAgentSkillSelectSchema: z.ZodObject<{
@@ -489,17 +489,17 @@ declare const SubAgentSkillApiSelectSchema: z.ZodObject<{
   id: z.ZodString;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
-  skillId: z.ZodString;
+  subAgentId: z.ZodString;
   index: z.ZodInt;
   alwaysLoaded: z.ZodBoolean;
-  subAgentId: z.ZodString;
+  skillId: z.ZodString;
 }, z.core.$strip>;
 declare const SubAgentSkillApiInsertSchema: z.ZodObject<{
   agentId: z.ZodString;
-  skillId: z.ZodString;
+  subAgentId: z.ZodString;
   index: z.ZodInt;
   alwaysLoaded: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-  subAgentId: z.ZodString;
+  skillId: z.ZodString;
 }, {
   out: {};
   in: {};
@@ -508,18 +508,18 @@ declare const SubAgentSkillApiUpdateSchema: z.ZodObject<{
   id: z.ZodOptional<z.ZodOptional<z.ZodString>>;
   createdAt: z.ZodOptional<z.ZodOptional<z.ZodOptional<z.ZodString>>>;
   updatedAt: z.ZodOptional<z.ZodOptional<z.ZodOptional<z.ZodString>>>;
-  skillId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  subAgentId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
   index: z.ZodOptional<z.ZodOptional<z.ZodInt>>;
   alwaysLoaded: z.ZodOptional<z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>>;
-  subAgentId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+  skillId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>;
 declare const SubAgentSkillWithIndexSchema: z.ZodObject<{
-  id: z.ZodString;
+  metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
   name: z.ZodString;
+  id: z.ZodString;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
   description: z.ZodString;
-  metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
   content: z.ZodString;
   subAgentSkillId: z.ZodString;
   subAgentId: z.ZodString;
@@ -532,37 +532,37 @@ declare const SkillFileResponse: z.ZodObject<{
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     content: z.ZodString;
-    skillId: z.ZodString;
     filePath: z.ZodString;
+    skillId: z.ZodString;
   }, z.core.$strip>;
 }, z.core.$strip>;
 declare const SkillWithFilesResponse: z.ZodObject<{
   data: z.ZodObject<{
-    id: z.ZodString;
+    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
     name: z.ZodString;
+    id: z.ZodString;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     description: z.ZodString;
-    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
     content: z.ZodString;
     files: z.ZodArray<z.ZodObject<{
       id: z.ZodString;
       createdAt: z.ZodString;
       updatedAt: z.ZodString;
       content: z.ZodString;
-      skillId: z.ZodString;
       filePath: z.ZodString;
+      skillId: z.ZodString;
     }, z.core.$strip>>;
   }, z.core.$strip>;
 }, z.core.$strip>;
 declare const SkillListResponse: z.ZodObject<{
   data: z.ZodArray<z.ZodObject<{
-    id: z.ZodString;
+    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
     name: z.ZodString;
+    id: z.ZodString;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     description: z.ZodString;
-    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
     content: z.ZodString;
   }, z.core.$strip>>;
   pagination: z.ZodObject<{
@@ -577,20 +577,20 @@ declare const SubAgentSkillResponse: z.ZodObject<{
     id: z.ZodString;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
-    skillId: z.ZodString;
+    subAgentId: z.ZodString;
     index: z.ZodInt;
     alwaysLoaded: z.ZodBoolean;
-    subAgentId: z.ZodString;
+    skillId: z.ZodString;
   }, z.core.$strip>;
 }, z.core.$strip>;
 declare const SubAgentSkillWithIndexArrayResponse: z.ZodObject<{
   data: z.ZodArray<z.ZodObject<{
-    id: z.ZodString;
+    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
     name: z.ZodString;
+    id: z.ZodString;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     description: z.ZodString;
-    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
     content: z.ZodString;
     subAgentSkillId: z.ZodString;
     subAgentId: z.ZodString;