kernl 0.2.1 → 0.6.0

package/dist/lib/serde/thread.js

@@ -1,172 +0,0 @@
-"use strict";
-// import { z } from "zod";
-// import * as events from "../../types/thread";
-// /**
-//  * Utilities and schemas for serializing the run-state so that it can be paused / resumed later.
-//  *
-//  * (TODO): should be able to define this as a codec for the ThreadState schema
-//  */
-// /**
-//  * The schema version of the serialized run state. This is used to ensure that the serialized
-//  * run state is compatible with the current version of the SDK.
-//  * If anything in this schema changes, the version will have to be incremented.
-//  */
-// export const CURRENT_SCHEMA_VERSION = "1.0" as const;
-// const $schemaVersion = z.literal(CURRENT_SCHEMA_VERSION);
-// const serializedAgentSchema = z.object({
-//   id: z.string(),
-//   name: z.string().optional(),
-// });
-// const serializedSpanBase = z.object({
-//   object: z.literal("trace.span"),
-//   id: z.string(),
-//   trace_id: z.string(),
-//   parent_id: z.string().nullable(),
-//   started_at: z.string().nullable(),
-//   ended_at: z.string().nullable(),
-//   error: z
-//     .object({
-//       message: z.string(),
-//       data: z.record(z.string(), z.any()).optional(),
-//     })
-//     .nullable(),
-//   span_data: z.record(z.string(), z.any()),
-// });
-// type SerializedSpanType = z.infer<typeof serializedSpanBase> & {
-//   previous_span?: SerializedSpanType;
-// };
-// const SerializedSpan: z.ZodType<SerializedSpanType> = serializedSpanBase.extend(
-//   {
-//     previous_span: z.lazy(() => SerializedSpan).optional(),
-//   },
-// );
-// const usageSchema = z.object({
-//   requests: z.number(),
-//   inputTokens: z.number(),
-//   outputTokens: z.number(),
-//   totalTokens: z.number(),
-// });
-// const modelResponseSchema = z.object({
-//   usage: usageSchema,
-//   events: z.array(events.ThreadEvent),
-//   responseId: z.string().optional(),
-//   providerData: z.record(z.string(), z.any()).optional(),
-// });
-// const itemSchema = z.discriminatedUnion("kind", [
-//   z.object({
-//     kind: z.literal("message"),
-//     rawItem: events.AssistantMessage,
-//     agent: serializedAgentSchema,
-//   }),
-//   z.object({
-//     kind: z.literal("tool-call"),
-//     // rawItem: events.ToolCall.or(events.HostedToolCall),
-//     rawItem: events.ToolCall,
-//     agent: serializedAgentSchema,
-//   }),
-//   z.object({
-//     kind: z.literal("tool-result"),
-//     rawItem: events.ToolResultEvent,
-//     agent: serializedAgentSchema,
-//     output: z.string(),
-//   }),
-//   z.object({
-//     kind: z.literal("reasoning"),
-//     rawItem: events.Reasoning,
-//     agent: serializedAgentSchema,
-//   }),
-// ]);
-// const serializedTraceSchema = z.object({
-//   object: z.literal("trace"),
-//   id: z.string(),
-//   workflow_name: z.string(),
-//   group_id: z.string().nullable(),
-//   metadata: z.record(z.string(), z.any()),
-// });
-// const serializedProcessedResponseSchema = z.object({
-//   newItems: z.array(itemSchema),
-//   toolsUsed: z.array(z.string()),
-//   functions: z.array(
-//     z.object({
-//       toolCall: z.any(),
-//       tool: z.any(),
-//     }),
-//   ),
-//   mcpApprovalRequests: z
-//     .array(
-//       z.object({
-//         requestItem: z.object({
-//           // protocol.HostedToolCallItem
-//           rawItem: z.object({
-//             type: z.literal("hosted_tool_call"),
-//             name: z.string(),
-//             arguments: z.string().optional(),
-//             status: z.string().optional(),
-//             output: z.string().optional(),
-//             // this always exists but marked as optional for early version compatibility; when releasing 1.0, we can remove the nullable and optional
-//             providerData: z.record(z.string(), z.any()).nullable().optional(),
-//           }),
-//         }),
-//         // HostedMCPTool
-//         mcpTool: z.object({
-//           type: z.literal("hosted_tool"),
-//           name: z.literal("hosted_mcp"),
-//           providerData: z.record(z.string(), z.any()),
-//         }),
-//       }),
-//     )
-//     .optional(),
-// });
-// const guardrailFunctionOutputSchema = z.object({
-//   tripwireTriggered: z.boolean(),
-//   outputInfo: z.any(),
-// });
-// const inputGuardrailResultSchema = z.object({
-//   guardrail: z.object({
-//     type: z.literal("input"),
-//     name: z.string(),
-//   }),
-//   output: guardrailFunctionOutputSchema,
-// });
-// const outputGuardrailResultSchema = z.object({
-//   guardrail: z.object({
-//     type: z.literal("output"),
-//     name: z.string(),
-//   }),
-//   agentOutput: z.any(),
-//   agent: serializedAgentSchema,
-//   output: guardrailFunctionOutputSchema,
-// });
-// // (TODO): define z.codec
-// export const SerializedThread = z.object({
-//   $schemaVersion,
-//   currentTurn: z.number(),
-//   currentAgent: serializedAgentSchema, // (TODO): in our case we probably don't need to serialize the whole agent - an ID would suffice
-//   originalInput: z.string().or(z.array(events.ThreadEvent)),
-//   modelResponses: z.array(modelResponseSchema),
-//   context: z.object({
-//     usage: usageSchema, // (TODO): move to stats
-//     // (TODO): belongs elsewhere
-//     approvals: z.record(
-//       z.string(),
-//       z.object({
-//         approved: z.array(z.string()).or(z.boolean()),
-//         rejected: z.array(z.string()).or(z.boolean()),
-//       }),
-//     ),
-//     context: z.record(z.string(), z.any()),
-//   }),
-//   toolUseTracker: z.record(z.string(), z.array(z.string())),
-//   maxTurns: z.number(),
-//   currentAgentSpan: SerializedSpan.nullable().optional(),
-//   noActiveAgentRun: z.boolean(),
-//   inputGuardrailResults: z.array(inputGuardrailResultSchema),
-//   outputGuardrailResults: z.array(outputGuardrailResultSchema),
-//   // (TODO): currentStep: nextStepSchema.optional(),
-//   lastModelResponse: modelResponseSchema.optional(),
-//   generatedItems: z.array(itemSchema),
-//   lastProcessedResponse: serializedProcessedResponseSchema.optional(),
-//   currentTurnPersistedItemCount: z.number().int().min(0).optional(),
-//   trace: serializedTraceSchema.nullable(),
-// });
-// export type SerializedThread = z.infer<typeof SerializedThread>;

package/dist/lib/serde/tool.d.ts

@@ -1,36 +0,0 @@
-import type { ToolInputParameters } from "../../tool/types";
-/**
- * Serialized function tool for model requests
- */
-export type SerializedFunctionTool = {
-    /**
-     * The type of the tool.
-     */
-    type: "function";
-    /**
-     * The name of the tool.
-     */
-    name?: string;
-    /**
-     * The description of the tool that helps the model to understand when to use the tool
-     */
-    description: string;
-    /**
-     * A JSON schema describing the parameters of the tool.
-     */
-    parameters: ToolInputParameters;
-};
-/**
- * Serialized hosted tool for model requests
- */
-export type SerializedHostedTool = {
-    type: "hosted-tool";
-    id: string;
-    name?: string;
-    providerData?: Record<string, any>;
-};
-/**
- * Union of all serialized tool types
- */
-export type SerializedTool = SerializedFunctionTool | SerializedHostedTool;
-//# sourceMappingURL=tool.d.ts.map

package/dist/lib/serde/tool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/lib/serde/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,EAAE,mBAAmB,CAAC;CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,sBAAsB,GAAG,oBAAoB,CAAC"}

package/dist/lib/utils.d.ts

@@ -1,19 +0,0 @@
-/**
- * Async version of Array.filter() that works with async predicates.
- * Runs all predicates in parallel and filters based on results.
- */
-export declare function filter<T>(array: T[], predicate: (item: T) => Promise<boolean>): Promise<T[]>;
-/**
- * Generate an ISO 8601 timestamp of the current time.
- * @returns An ISO 8601 timestamp.
- */
-export declare function timeISO(): string;
-/**
- * Generate a random ID with the specified number of bytes.
- * @param bytes - Number of bytes to generate (e.g., 8 for 64-bit, 16 for 128-bit)
- * @returns A hex string representation of the random bytes
- */
-export declare function randomID(bytes?: number): string;
-export type SafeExecuteResult<T> = [Error | unknown | null, T | null];
-export declare function safeExecute<T>(fn: () => T): Promise<SafeExecuteResult<T>>;
-//# sourceMappingURL=utils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAC5B,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GACvC,OAAO,CAAC,CAAC,EAAE,CAAC,CAGd;AAED;;;GAGG;AACH,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,GAAE,MAAW,GAAG,MAAM,CAanD;AAED,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,OAAO,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;AAEtE,wBAAsB,WAAW,CAAC,CAAC,EACjC,EAAE,EAAE,MAAM,CAAC,GACV,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAM/B"}

package/dist/lib/utils.js

@@ -1,41 +0,0 @@
-/**
- * Async version of Array.filter() that works with async predicates.
- * Runs all predicates in parallel and filters based on results.
- */
-export async function filter(array, predicate) {
-    const results = await Promise.all(array.map(predicate));
-    return array.filter((_, index) => results[index]);
-}
-/**
- * Generate an ISO 8601 timestamp of the current time.
- * @returns An ISO 8601 timestamp.
- */
-export function timeISO() {
-    return new Date().toISOString();
-}
-/**
- * Generate a random ID with the specified number of bytes.
- * @param bytes - Number of bytes to generate (e.g., 8 for 64-bit, 16 for 128-bit)
- * @returns A hex string representation of the random bytes
- */
-export function randomID(bytes = 12) {
-    const byteArray = new Uint8Array(bytes);
-    if (typeof crypto !== "undefined" && crypto.getRandomValues) {
-        crypto.getRandomValues(byteArray);
-    }
-    else {
-        // Fallback for environments without crypto.getRandomValues
-        for (let i = 0; i < bytes; i++) {
-            byteArray[i] = Math.floor(Math.random() * 256);
-        }
-    }
-    return Array.from(byteArray, (byte) => byte.toString(16).padStart(2, "0")).join("");
-}
-export async function safeExecute(fn) {
-    try {
-        return [null, await fn()];
-    }
-    catch (error) {
-        return [error, null];
-    }
-}

package/dist/logger.d.ts

@@ -1,36 +0,0 @@
-/**
- * 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/logger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAsBA;;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,QAA0B,CAAC;AAE9C,eAAe,MAAM,CAAC"}

package/dist/logger.js

@@ -1,43 +0,0 @@
-import pino from "pino";
-import { env } from "./env";
-/**
- * By default we don't log LLM inputs/outputs, to prevent exposing sensitive data.
- * Set KERNL_LOG_MODEL_DATA=true to enable.
- */
-const dontLogModelData = !env.KERNL_LOG_MODEL_DATA;
-/**
- * By default we don't log tool inputs/outputs, to prevent exposing sensitive data.
- * Set KERNL_LOG_TOOL_DATA=true to enable.
- */
-const dontLogToolData = !env.KERNL_LOG_TOOL_DATA;
-/**
- * Base pino logger instance
- */
-const base = pino({
-    level: env.LOG_LEVEL,
-});
-/**
- * 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 function getLogger(namespace = "kernl") {
-    const child = base.child({ namespace });
-    return {
-        namespace,
-        trace: child.trace.bind(child),
-        debug: child.debug.bind(child),
-        info: child.info.bind(child),
-        warn: child.warn.bind(child),
-        error: child.error.bind(child),
-        fatal: child.fatal.bind(child),
-        dontLogModelData,
-        dontLogToolData,
-    };
-}
-/**
- * Default logger instance for the core library.
- */
-export const logger = getLogger("kernl:core");
-export default logger;

package/dist/mcp/__tests__/fixtures/echo-server.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=echo-server.d.ts.map

package/dist/mcp/__tests__/fixtures/echo-server.d.ts.map

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

package/dist/mcp/__tests__/fixtures/echo-server.js

@@ -1,92 +0,0 @@
-#!/usr/bin/env node
-/**
- * Simple echo/string manipulation server for testing MCP stdio transport.
- *
- * Provides deterministic string transformations.
- */
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-const server = new Server({
-    name: "echo-server",
-    version: "1.0.0",
-}, {
-    capabilities: {
-        tools: {},
-    },
-});
-// List available tools
-server.setRequestHandler("tools/list", async () => ({
-    tools: [
-        {
-            name: "echo",
-            description: "Echo back the input text",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    text: { type: "string", description: "Text to echo" },
-                },
-                required: ["text"],
-            },
-        },
-        {
-            name: "uppercase",
-            description: "Convert text to uppercase",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    text: { type: "string", description: "Text to convert" },
-                },
-                required: ["text"],
-            },
-        },
-        {
-            name: "reverse",
-            description: "Reverse the text",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    text: { type: "string", description: "Text to reverse" },
-                },
-                required: ["text"],
-            },
-        },
-    ],
-}));
-// Handle tool calls
-server.setRequestHandler("tools/call", async (request) => {
-    const { name, arguments: args } = request.params;
-    switch (name) {
-        case "echo":
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: args.text,
-                    },
-                ],
-            };
-        case "uppercase":
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: args.text.toUpperCase(),
-                    },
-                ],
-            };
-        case "reverse":
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: args.text.split("").reverse().join(""),
-                    },
-                ],
-            };
-        default:
-            throw new Error(`Unknown tool: ${name}`);
-    }
-});
-// Start the server
-const transport = new StdioServerTransport();
-await server.connect(transport);

package/dist/mcp/__tests__/fixtures/math-server.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=math-server.d.ts.map

package/dist/mcp/__tests__/fixtures/math-server.d.ts.map

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

package/dist/mcp/__tests__/fixtures/math-server.js

@@ -1,98 +0,0 @@
-#!/usr/bin/env node
-/**
- * Simple deterministic math server for testing MCP stdio transport.
- *
- * Provides basic arithmetic operations with predictable results.
- */
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-const server = new Server({
-    name: "math-server",
-    version: "1.0.0",
-}, {
-    capabilities: {
-        tools: {},
-    },
-});
-// List available tools
-server.setRequestHandler("tools/list", async () => ({
-    tools: [
-        {
-            name: "add",
-            description: "Add two numbers",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    a: { type: "number", description: "First number" },
-                    b: { type: "number", description: "Second number" },
-                },
-                required: ["a", "b"],
-            },
-        },
-        {
-            name: "multiply",
-            description: "Multiply two numbers",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    a: { type: "number", description: "First number" },
-                    b: { type: "number", description: "Second number" },
-                },
-                required: ["a", "b"],
-            },
-        },
-        {
-            name: "divide",
-            description: "Divide two numbers",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    a: { type: "number", description: "Numerator" },
-                    b: { type: "number", description: "Denominator" },
-                },
-                required: ["a", "b"],
-            },
-        },
-    ],
-}));
-// Handle tool calls
-server.setRequestHandler("tools/call", async (request) => {
-    const { name, arguments: args } = request.params;
-    switch (name) {
-        case "add":
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: String(args.a + args.b),
-                    },
-                ],
-            };
-        case "multiply":
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: String(args.a * args.b),
-                    },
-                ],
-            };
-        case "divide":
-            if (args.b === 0) {
-                throw new Error("Division by zero");
-            }
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: String(args.a / args.b),
-                    },
-                ],
-            };
-        default:
-            throw new Error(`Unknown tool: ${name}`);
-    }
-});
-// Start the server
-const transport = new StdioServerTransport();
-await server.connect(transport);

package/dist/mcp/__tests__/fixtures/test-server.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=test-server.d.ts.map

package/dist/mcp/__tests__/fixtures/test-server.d.ts.map

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