kernl 0.1.1

package/dist/env.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+/**
+ * Environment variable validation schema
+ *
+ * This ensures all environment variables are valid at startup.
+ * All variables are optional with sensible defaults.
+ */
+const envSchema = z.object({
+    // --- Logging ---
+    LOG_LEVEL: z
+        .enum(["trace", "debug", "info", "warn", "error", "fatal"])
+        .default("info"),
+    KERNL_LOG_MODEL_DATA: z
+        .enum(["true", "false"])
+        .optional()
+        .transform((val) => val === "true"),
+    KERNL_LOG_TOOL_DATA: z
+        .enum(["true", "false"])
+        .optional()
+        .transform((val) => val === "true"),
+});
+/**
+ * Validated and type-safe environment variables
+ *
+ * Use this throughout the library instead of process.env directly.
+ *
+ * @example
+ * import { env } from './env';
+ * console.log(env.LOG_LEVEL);
+ */
+export const env = envSchema.parse(process.env);

package/dist/error.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":""}

package/dist/error.js

@@ -0,0 +1 @@
+"use strict";

package/dist/guardrail.d.ts

@@ -0,0 +1,178 @@
+import { z, type ZodType } from "zod";
+import { LanguageModelResponse } from "@kernl/protocol";
+import { Agent } from "./agent";
+import { Context, UnknownContext } from "./context";
+import type { AgentResponseType } from "./types/agent";
+import type { TextResponse, ThreadEvent } from "./types/thread";
+/**
+ * Resolves the agent output type based on the response type.
+ * - If TResponse is "text" → output is string
+ * - If TResponse is a ZodType → output is the inferred type from that schema
+ */
+export type ResolvedAgentResponse<TResponse extends AgentResponseType> = TResponse extends TextResponse ? string : TResponse extends ZodType ? z.infer<TResponse> : never;
+/**
+ * The output of a guardrail function.
+ */
+export interface GuardrailFunctionOutput {
+    /**
+     * Whether the tripwire was triggered. If triggered, the agent's execution will be halted.
+     */
+    tripwireTriggered: boolean;
+    /**
+     * Optional information about the guardrail's output.
+     * For example, the guardrail could include information about the checks it performed and granular results.
+     */
+    outputInfo: any;
+}
+/**
+ * A guardrail that checks the input to the agent.
+ */
+export interface InputGuardrail {
+    /**
+     * The name of the guardrail.
+     */
+    name: string;
+    /**
+     * The function that performs the guardrail check
+     */
+    execute: InputGuardrailFunction;
+}
+/**
+ * The result of an input guardrail execution.
+ */
+export interface InputGuardrailResult {
+    /**
+     * The metadata of the guardrail.
+     */
+    guardrail: InputGuardrailMetadata;
+    /**
+     * The output of the guardrail.
+     */
+    output: GuardrailFunctionOutput;
+}
+/**
+ * Arguments for an input guardrail function.
+ */
+export interface InputGuardrailFunctionArgs<TContext = UnknownContext> {
+    /**
+     * The agent that is being run.
+     */
+    agent: Agent<any, any>;
+    /**
+     * The input to the agent.
+     */
+    input: string | ThreadEvent[];
+    /**
+     * The context of the agent run.
+     */
+    context: Context<TContext>;
+}
+/**
+ * The function that performs the actual input guardrail check and returns the decision on whether
+ * a guardrail was triggered.
+ */
+export type InputGuardrailFunction = (args: InputGuardrailFunctionArgs) => Promise<GuardrailFunctionOutput>;
+/**
+ * Metadata for an input guardrail.
+ */
+export interface InputGuardrailMetadata {
+    type: "input";
+    name: string;
+}
+/**
+ * Definition of an input guardrail. SDK users usually do not need to create this.
+ */
+export interface InputGuardrailDefinition extends InputGuardrailMetadata {
+    guardrailFunction: InputGuardrailFunction;
+    run(args: InputGuardrailFunctionArgs): Promise<InputGuardrailResult>;
+}
+/**
+ * Arguments for defining an input guardrail definition.
+ */
+export interface DefineInputGuardrailArgs {
+    name: string;
+    execute: InputGuardrailFunction;
+}
+/**
+ * Defines an input guardrail definition.
+ */
+export declare function defineInputGuardrail({ name, execute, }: DefineInputGuardrailArgs): InputGuardrailDefinition;
+/**
+ * Arguments for an output guardrail function.
+ */
+export interface OutputGuardrailFunctionArgs<TContext = UnknownContext, TResponse extends AgentResponseType = TextResponse> {
+    agent: Agent<any, any>;
+    agentOutput: ResolvedAgentResponse<TResponse>;
+    context: Context<TContext>;
+    /**
+     * Additional details about the agent output.
+     */
+    details?: {
+        /** Model response associated with the output if available. */
+        modelResponse?: LanguageModelResponse;
+    };
+}
+/**
+ * A function that takes an output guardrail function arguments and returns a `GuardrailFunctionOutput`.
+ */
+export type OutputGuardrailFunction<TResponse extends AgentResponseType = TextResponse> = (args: OutputGuardrailFunctionArgs<UnknownContext, TResponse>) => Promise<GuardrailFunctionOutput>;
+/**
+ * A guardrail that checks the output of the agent.
+ */
+export interface OutputGuardrail<TResponse extends AgentResponseType = TextResponse> {
+    /**
+     * The name of the guardrail.
+     */
+    name: string;
+    /**
+     * The function that performs the guardrail check.
+     */
+    execute: OutputGuardrailFunction<TResponse>;
+}
+/**
+ * Metadata for an output guardrail.
+ */
+export interface OutputGuardrailMetadata {
+    type: "output";
+    name: string;
+}
+/**
+ * The result of an output guardrail execution.
+ */
+export interface OutputGuardrailResult<TMeta = OutputGuardrailMetadata, TResponse extends AgentResponseType = TextResponse> {
+    /**
+     * The metadata of the guardrail.
+     */
+    guardrail: TMeta;
+    /**
+     * The output of the agent that ran.
+     */
+    agentOutput: ResolvedAgentResponse<TResponse>;
+    /**
+     * The agent that ran.
+     */
+    agent: Agent<UnknownContext, TResponse>;
+    /**
+     * The output of the guardrail.
+     */
+    output: GuardrailFunctionOutput;
+}
+/**
+ * Definition of an output guardrail.
+ */
+export interface OutputGuardrailDefinition<TMeta = OutputGuardrailMetadata, TResponse extends AgentResponseType = TextResponse> extends OutputGuardrailMetadata {
+    guardrailFunction: OutputGuardrailFunction<TResponse>;
+    run(args: OutputGuardrailFunctionArgs<UnknownContext, TResponse>): Promise<OutputGuardrailResult<TMeta, TResponse>>;
+}
+/**
+ * Arguments for defining an output guardrail definition.
+ */
+export interface DefineOutputGuardrailArgs<TResponse extends AgentResponseType = TextResponse> {
+    name: string;
+    execute: OutputGuardrailFunction<TResponse>;
+}
+/**
+ * Creates an output guardrail definition.
+ */
+export declare function defineOutputGuardrail<TResponse extends AgentResponseType = TextResponse>({ name, execute, }: DefineOutputGuardrailArgs<TResponse>): OutputGuardrailDefinition<OutputGuardrailMetadata, TResponse>;
+//# sourceMappingURL=guardrail.d.ts.map

package/dist/guardrail.d.ts.map

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

package/dist/guardrail.js

@@ -0,0 +1,34 @@
+/**
+ * Defines an input guardrail definition.
+ */
+export function defineInputGuardrail({ name, execute, }) {
+    return {
+        type: "input",
+        name,
+        guardrailFunction: execute,
+        async run(args) {
+            return {
+                guardrail: { type: "input", name },
+                output: await execute(args),
+            };
+        },
+    };
+}
+/**
+ * Creates an output guardrail definition.
+ */
+export function defineOutputGuardrail({ name, execute, }) {
+    return {
+        type: "output",
+        name,
+        guardrailFunction: execute,
+        async run(args) {
+            return {
+                guardrail: { type: "output", name },
+                agent: args.agent,
+                agentOutput: args.agentOutput,
+                output: await execute(args),
+            };
+        },
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { Kernl } from "./kernl";
+export { Agent } from "./agent";
+export type { Context } from "./context";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { Kernl } from "./kernl";
+export { Agent } from "./agent";

package/dist/kernel.d.ts

@@ -0,0 +1,7 @@
+import type { Agent } from './agent';
+export declare class Kernel {
+    private agents;
+    constructor();
+    register(agent: Agent): void;
+}
+//# sourceMappingURL=kernel.d.ts.map

package/dist/kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../src/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAiC;;IAI/C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;CAG7B"}

package/dist/kernel.js

@@ -0,0 +1,7 @@
+export class Kernel {
+    agents = new Map();
+    constructor() { }
+    register(agent) {
+        // TODO: Implement agent registration
+    }
+}

package/dist/kernl.d.ts

@@ -0,0 +1,18 @@
+import { Agent } from "./agent";
+import { UnknownContext } from "./context";
+import { KernlHooks } from "./lifecycle";
+import type { AgentResponseType } from "./types/agent";
+/**
+ * Central coordinator for the entire application.
+ *
+ * Orchestrates agent execution, including guardrails, tool calls, session persistence, and
+ * tracing.
+ */
+export declare class Kernl extends KernlHooks<UnknownContext, AgentResponseType> {
+    private agents;
+    /**
+     * Registers a new agent with the kernl instance.
+     */
+    register(agent: Agent): void;
+}
+//# sourceMappingURL=kernl.d.ts.map

package/dist/kernl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernl.d.ts","sourceRoot":"","sources":["../src/kernl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;GAKG;AACH,qBAAa,KAAM,SAAQ,UAAU,CAAC,cAAc,EAAE,iBAAiB,CAAC;IACtE,OAAO,CAAC,MAAM,CAAiC;IAE/C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;CAG7B"}

package/dist/kernl.js

@@ -0,0 +1,16 @@
+import { KernlHooks } from "./lifecycle";
+/**
+ * Central coordinator for the entire application.
+ *
+ * Orchestrates agent execution, including guardrails, tool calls, session persistence, and
+ * tracing.
+ */
+export class Kernl extends KernlHooks {
+    agents = new Map();
+    /**
+     * Registers a new agent with the kernl instance.
+     */
+    register(agent) {
+        // TODO: Implement agent registration
+    }
+}

package/dist/lib/env.d.ts

@@ -0,0 +1,43 @@
+import { z } from "zod";
+/**
+ * Environment variable validation schema
+ *
+ * This ensures all environment variables are valid at startup.
+ * All variables are optional with sensible defaults.
+ */
+declare const envSchema: z.ZodObject<{
+    LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        trace: "trace";
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+        fatal: "fatal";
+    }>>;
+    KERNL_LOG_MODEL_DATA: z.ZodPipe<z.ZodOptional<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>>, z.ZodTransform<boolean, "true" | "false" | undefined>>;
+    KERNL_LOG_TOOL_DATA: z.ZodPipe<z.ZodOptional<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>>, z.ZodTransform<boolean, "true" | "false" | undefined>>;
+}, z.core.$strip>;
+/**
+ * Validated and type-safe environment variables
+ *
+ * @example
+ * import { env } from '../env';
+ * console.log(env.LOG_LEVEL);
+ */
+export declare const env: {
+    LOG_LEVEL: "error" | "trace" | "debug" | "info" | "warn" | "fatal";
+    KERNL_LOG_MODEL_DATA: boolean;
+    KERNL_LOG_TOOL_DATA: boolean;
+};
+/**
+ * Type of the validated environment variables
+ */
+export type Env = z.infer<typeof envSchema>;
+export {};
+//# sourceMappingURL=env.d.ts.map

package/dist/lib/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/lib/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AACH,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;iBAab,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,GAAG;;;;CAA+B,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/dist/lib/env.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+/**
+ * Environment variable validation schema
+ *
+ * This ensures all environment variables are valid at startup.
+ * All variables are optional with sensible defaults.
+ */
+const envSchema = z.object({
+    // --- Logging ---
+    LOG_LEVEL: z
+        .enum(["trace", "debug", "info", "warn", "error", "fatal"])
+        .default("info"),
+    KERNL_LOG_MODEL_DATA: z
+        .enum(["true", "false"])
+        .optional()
+        .transform((val) => val === "true"),
+    KERNL_LOG_TOOL_DATA: z
+        .enum(["true", "false"])
+        .optional()
+        .transform((val) => val === "true"),
+});
+/**
+ * Validated and type-safe environment variables
+ *
+ * @example
+ * import { env } from '../env';
+ * console.log(env.LOG_LEVEL);
+ */
+export const env = envSchema.parse(process.env);

package/dist/lib/error.d.ts

@@ -0,0 +1,88 @@
+import { InputGuardrailResult, OutputGuardrailMetadata, OutputGuardrailResult } from "../guardrail";
+type SerializedThread = any;
+import { AgentResponseType } from "../types/agent";
+import { TextResponse } from "../types/thread";
+/**
+ * Abstract base class for all `kernl` errors
+ * Requires subclasses to implement JSON serialization
+ */
+export declare abstract class BaseError extends Error {
+    constructor(message: string);
+    /**
+     * Convert error to JSON representation
+     * Must be implemented by subclasses
+     */
+    abstract toJSON(): Record<string, any>;
+}
+/**
+ * Runtime error with trace ID for debugging
+ */
+export declare class RuntimeError extends BaseError {
+    readonly traceId: string;
+    constructor(message: string, traceId?: string);
+    toJSON(): Record<string, any>;
+}
+/**
+ * Base class for all errors thrown by the library.
+ */
+export declare abstract class AgentError extends RuntimeError {
+    thread?: SerializedThread;
+    constructor(message: string, state?: SerializedThread, traceId?: string);
+    toJSON(): Record<string, any>;
+}
+/**
+ * System error thrown when the library encounters an error that is not caused by the user's
+ * misconfiguration.
+ */
+export declare class SystemError extends RuntimeError {
+}
+/**
+ * Thrown due to user misconfiguration
+ *
+ * This error indicates that the library was not configured correctly by the user.
+ * Common causes include invalid configuration options, missing required fields,
+ * or incompatible configuration combinations.
+ */
+export declare class MisconfiguredError extends BaseError {
+    toJSON(): Record<string, any>;
+}
+/**
+ * Error thrown when the maximum number of turns is exceeded.
+ */
+export declare class MaxTurnsExceededError extends AgentError {
+}
+/**
+ * Error thrown when a model behavior is unexpected.
+ */
+export declare class ModelBehaviorError extends AgentError {
+}
+/**
+ * Error thrown when a guardrail execution fails.
+ */
+export declare class GuardrailExecutionError extends AgentError {
+    error: Error;
+    constructor(message: string, error: Error, thread?: SerializedThread);
+}
+/**
+ * Error thrown when a tool call fails.
+ */
+export declare class ToolCallError extends AgentError {
+    error: Error;
+    constructor(message: string, error: Error, thread?: SerializedThread);
+}
+/**
+ * Error thrown when an input guardrail tripwire is triggered.
+ */
+export declare class InputGuardrailTripwireTriggered extends AgentError {
+    result: InputGuardrailResult;
+    constructor(message: string, result: InputGuardrailResult, thread?: SerializedThread);
+}
+/**
+ * Error thrown when an output guardrail tripwire is triggered.
+ */
+export declare class OutputGuardrailTripwireTriggered<TMeta extends OutputGuardrailMetadata, TOutputType extends AgentResponseType = TextResponse> extends AgentError {
+    result: OutputGuardrailResult<TMeta, TOutputType>;
+    constructor(message: string, result: OutputGuardrailResult<TMeta, TOutputType>, thread?: SerializedThread);
+}
+export {};
+//# sourceMappingURL=error.d.ts.map

package/dist/lib/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/lib/error.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AAKrB,KAAK,gBAAgB,GAAG,GAAG,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;GAGG;AACH,8BAAsB,SAAU,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;IAK3B;;;OAGG;IACH,QAAQ,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CACvC;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,SAAS;IACzC,SAAgB,OAAO,EAAE,MAAM,CAAC;gBAEpB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAK7C,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAQ9B;AAED;;GAEG;AACH,8BAAsB,UAAW,SAAQ,YAAY;IACnD,MAAM,CAAC,EAAE,gBAAgB,CAAC;gBAEd,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,MAAM;IAK9D,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAMvC;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,YAAY;CAAG;AAEhD;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAO9B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;CAAG;AAExD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;CAAG;AAErD;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,UAAU;IACrD,KAAK,EAAE,KAAK,CAAC;gBACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,gBAAgB;CAIrE;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,KAAK,EAAE,KAAK,CAAC;gBACD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,gBAAgB;CAIrE;AAED;;GAEG;AACH,qBAAa,+BAAgC,SAAQ,UAAU;IAC7D,MAAM,EAAE,oBAAoB,CAAC;gBAE3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,oBAAoB,EAC5B,MAAM,CAAC,EAAE,gBAAgB;CAK5B;AAED;;GAEG;AACH,qBAAa,gCAAgC,CAC3C,KAAK,SAAS,uBAAuB,EACrC,WAAW,SAAS,iBAAiB,GAAG,YAAY,CACpD,SAAQ,UAAU;IAClB,MAAM,EAAE,qBAAqB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;gBAEhD,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,qBAAqB,CAAC,KAAK,EAAE,WAAW,CAAC,EACjD,MAAM,CAAC,EAAE,gBAAgB;CAK5B"}

package/dist/lib/error.js

@@ -0,0 +1,117 @@
+import { randomID } from "@kernl/shared/lib";
+/**
+ * Abstract base class for all `kernl` errors
+ * Requires subclasses to implement JSON serialization
+ */
+export class BaseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = this.constructor.name;
+    }
+}
+/**
+ * Runtime error with trace ID for debugging
+ */
+export class RuntimeError extends BaseError {
+    traceId;
+    constructor(message, traceId) {
+        super(message);
+        this.traceId = traceId || randomID();
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            traceId: this.traceId,
+            stack: this.stack,
+        };
+    }
+}
+/**
+ * Base class for all errors thrown by the library.
+ */
+export class AgentError extends RuntimeError {
+    thread;
+    constructor(message, state, traceId) {
+        super(message, traceId);
+        this.thread = state;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            thread: this.thread,
+        };
+    }
+}
+/**
+ * System error thrown when the library encounters an error that is not caused by the user's
+ * misconfiguration.
+ */
+export class SystemError extends RuntimeError {
+}
+/**
+ * Thrown due to user misconfiguration
+ *
+ * This error indicates that the library was not configured correctly by the user.
+ * Common causes include invalid configuration options, missing required fields,
+ * or incompatible configuration combinations.
+ */
+export class MisconfiguredError extends BaseError {
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            stack: this.stack,
+        };
+    }
+}
+/**
+ * Error thrown when the maximum number of turns is exceeded.
+ */
+export class MaxTurnsExceededError extends AgentError {
+}
+/**
+ * Error thrown when a model behavior is unexpected.
+ */
+export class ModelBehaviorError extends AgentError {
+}
+/**
+ * Error thrown when a guardrail execution fails.
+ */
+export class GuardrailExecutionError extends AgentError {
+    error;
+    constructor(message, error, thread) {
+        super(message, thread);
+        this.error = error;
+    }
+}
+/**
+ * Error thrown when a tool call fails.
+ */
+export class ToolCallError extends AgentError {
+    error;
+    constructor(message, error, thread) {
+        super(message, thread);
+        this.error = error;
+    }
+}
+/**
+ * Error thrown when an input guardrail tripwire is triggered.
+ */
+export class InputGuardrailTripwireTriggered extends AgentError {
+    result;
+    constructor(message, result, thread) {
+        super(message, thread);
+        this.result = result;
+    }
+}
+/**
+ * Error thrown when an output guardrail tripwire is triggered.
+ */
+export class OutputGuardrailTripwireTriggered extends AgentError {
+    result;
+    constructor(message, result, thread) {
+        super(message, thread);
+        this.result = result;
+    }
+}

package/dist/lib/logger.d.ts

@@ -0,0 +1,36 @@
+/**
+ * A logger instance with namespace support and sensitive data flags.
+ */
+export type Logger = {
+    /**
+     * The namespace used for the logger.
+     */
+    namespace: string;
+    trace: (message: any, ...args: any[]) => void;
+    debug: (message: any, ...args: any[]) => void;
+    info: (message: any, ...args: any[]) => void;
+    warn: (message: any, ...args: any[]) => void;
+    error: (message: any, ...args: any[]) => void;
+    fatal: (message: any, ...args: any[]) => void;
+    /**
+     * Whether to log model data.
+     */
+    dontLogModelData: boolean;
+    /**
+     * Whether to log tool data.
+     */
+    dontLogToolData: boolean;
+};
+/**
+ * Get a logger for a given namespace.
+ *
+ * @param namespace - the namespace to use for the logger (e.g., 'kernl:core', 'kernl:agent').
+ * @returns A logger object with all pino log levels and sensitive data flags.
+ */
+export declare function getLogger(namespace?: string): Logger;
+/**
+ * Default logger instance for the core library.
+ */
+export declare const logger: Logger;
+export default logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/lib/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAuBA;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC9C,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC9C,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC7C,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC7C,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC9C,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAE9C;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,GAAE,MAAgB,GAAG,MAAM,CAc7D;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,QAAqB,CAAC;AAEzC,eAAe,MAAM,CAAC"}