@ai.ntellect/core 1.0.0 → 1.1.1

package/dist/types/agent.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentContextSchema = void 0;
+const zod_1 = require("zod");
+exports.AgentContextSchema = zod_1.z.object({
+    input: zod_1.z.object({
+        raw: zod_1.z.string(),
+        embedding: zod_1.z.array(zod_1.z.number()).optional(),
+    }),
+    cwd: zod_1.z.string().optional(),
+    actions: zod_1.z.array(zod_1.z.object({
+        name: zod_1.z.string(),
+        parameters: zod_1.z.array(zod_1.z.object({
+            name: zod_1.z.string(),
+            value: zod_1.z.any(),
+        })),
+        isExecuted: zod_1.z.boolean().optional(),
+        result: zod_1.z.any().optional(),
+    })),
+    knowledge: zod_1.z.string().optional(),
+    response: zod_1.z.string(),
+    executedActions: zod_1.z
+        .array(zod_1.z.object({
+        name: zod_1.z.string(),
+        result: zod_1.z.any(),
+        timestamp: zod_1.z.string(),
+    }))
+        .optional(),
+    iteration: zod_1.z.number().optional(),
+    progressed: zod_1.z.boolean().optional(),
+    messages: zod_1.z
+        .array(zod_1.z.object({
+        role: zod_1.z.enum(["user", "assistant"]),
+        content: zod_1.z.string(),
+    }))
+        .optional(),
+    toolResults: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+    scratchpad: zod_1.z.array(zod_1.z.object({
+        turn: zod_1.z.number(),
+        thought: zod_1.z.string(),
+        action: zod_1.z.string(),
+        observation: zod_1.z.string(),
+        timestamp: zod_1.z.string(),
+    })).optional().default([]),
+    memories: zod_1.z.array(zod_1.z.any()).optional().default([]),
+    entityState: zod_1.z.object({
+        currentTarget: zod_1.z.string().optional(),
+        lastEntityType: zod_1.z.string().nullable().optional(),
+        pendingResolutions: zod_1.z.array(zod_1.z.any()).optional(),
+        resolutionTrace: zod_1.z.array(zod_1.z.any()).optional(),
+        explored: zod_1.z.boolean().optional(),
+        handles: zod_1.z.record(zod_1.z.string(), zod_1.z.object({ id: zod_1.z.string(), label: zod_1.z.string(), path: zod_1.z.string(), category: zod_1.z.string() })).optional(),
+    }).optional(),
+    conversationState: zod_1.z.object({
+        currentGoal: zod_1.z.string(),
+        currentTarget: zod_1.z.string().nullable(),
+        lastResolvedEntity: zod_1.z.string().nullable(),
+        lastResolvedType: zod_1.z.string().nullable(),
+        pendingTask: zod_1.z.string().nullable(),
+        turnCount: zod_1.z.number(),
+        pendingIntent: zod_1.z.object({
+            action: zod_1.z.string().nullable(),
+            unresolvedEntity: zod_1.z.string().nullable(),
+            originalInput: zod_1.z.string(),
+            turn: zod_1.z.number(),
+            failed: zod_1.z.boolean(),
+        }).nullable(),
+    }).optional(),
+    explorationBudget: zod_1.z.object({
+        maxSteps: zod_1.z.number(),
+        maxExplorations: zod_1.z.number(),
+        maxToolCalls: zod_1.z.number(),
+        stepsUsed: zod_1.z.number(),
+        explorationsUsed: zod_1.z.number(),
+        toolCallsUsed: zod_1.z.number(),
+    }).optional(),
+});
+//# sourceMappingURL=agent.js.map

package/dist/types/agent.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,343 @@
+import { EventEmitter } from "events";
+import { ZodSchema } from "zod";
+import { IEventEmitter } from "../interfaces";
+/**
+ * Represents the input structure for creating a memory entry.
+ * @typedef {Object} CreateMemoryInput
+ * @property {string} content - The text content to store.
+ * @property {string} roomId - The room identifier.
+ * @property {string} [id] - Optional stable id.
+ * @property {Record<string, any>} [metadata] - Optional metadata.
+ * @property {number[]} [embedding] - Optional vector embedding.
+ * @property {number} [ttl] - Time-to-live in seconds (optional).
+ */
+export interface CreateMemoryInput {
+    id?: string;
+    content: string;
+    metadata?: Record<string, any>;
+    embedding?: number[];
+    roomId: string;
+    ttl?: number;
+    type?: string;
+}
+/**
+ * Represents a stored memory entry.
+ * @typedef {Object} BaseMemoryType
+ * @property {string} id - Unique identifier of the memory entry.
+ * @property {string} content - Stored text content.
+ * @property {number[] | null} embedding - Vector representation of the data.
+ * @property {string} roomId - The associated room ID.
+ * @property {Date} createdAt - Creation date.
+ */
+export interface BaseMemoryType {
+    id: string;
+    content: string;
+    metadata?: Record<string, any>;
+    embedding?: number[];
+    roomId: string;
+    createdAt: Date;
+}
+/**
+ * Type for scheduled request entries
+ * @typedef {Object} ScheduledRequest
+ */
+export type ScheduledRequest = {
+    /** Unique identifier for the scheduled request */
+    id: string;
+    /** The original request string */
+    originalRequest: string;
+    /** The cron expression for scheduling */
+    cronExpression: string;
+    /** Whether the request is recurring */
+    isRecurring: boolean;
+    /** The creation date */
+    createdAt: Date;
+};
+/**
+ * Utility type for extracting schema type from Zod schema
+ * @template T - Zod schema type
+ */
+export type SchemaType<T> = T extends ZodSchema<infer U> ? U : never;
+/**
+ * Type for graph context based on schema
+ * @template T - Schema type
+ */
+export type GraphContext<T extends ZodSchema> = {
+    [key: string]: any;
+};
+/**
+ * Configuration for event handling strategies in nodes
+ * @typedef {Object} EventStrategy
+ * @property {"single" | "all" | "correlate"} type - The type of event handling strategy
+ * - single: Waits for any single event from the specified events
+ * - all: Waits for all specified events to occur
+ * - correlate: Uses a correlation function to match related events
+ * @property {(events: any[]) => boolean} [correlation] - Optional correlation function for "correlate" strategy
+ */
+export type EventStrategy = {
+    type: "single" | "all" | "correlate";
+    correlation?: (events: any[]) => boolean;
+};
+/**
+ * Configuration for event handling in nodes
+ * @typedef {Object} EventConfig
+ * @property {string[]} events - Array of event names to wait for
+ * @property {number} [timeout] - Optional timeout in milliseconds
+ * @property {EventStrategy} strategy - Strategy for handling multiple events
+ * @property {(events: any[]) => Promise<void>} [onSuccess] - Optional callback when events are successfully received
+ * @property {() => Promise<void>} [onTimeout] - Optional callback when event waiting times out
+ * @example
+ * ```typescript
+ * const eventConfig: EventConfig = {
+ *   events: ["payment.received", "order.validated"],
+ *   timeout: 5000,
+ *   strategy: {
+ *     type: "correlate",
+ *     correlation: (events) => events.every(e => e.transactionId === events[0].transactionId)
+ *   },
+ *   onSuccess: async (events) => {
+ *     console.log("Correlated events received:", events);
+ *   },
+ *   onTimeout: async () => {
+ *     console.log("Event waiting timed out");
+ *   }
+ * };
+ * ```
+ */
+export type EventConfig = {
+    events: string[];
+    timeout?: number;
+    strategy: EventStrategy;
+    onSuccess?: (events: any[]) => Promise<void>;
+    onTimeout?: () => Promise<void>;
+};
+/**
+ * Represents an event in the graph system
+ * @template T - Schema type for context validation
+ * @property {string} type - The type/name of the event
+ * @property {any} [payload] - Optional payload data
+ * @property {number} timestamp - Unix timestamp of when the event occurred
+ * @example
+ * ```typescript
+ * const event: GraphEvent<MySchema> = {
+ *   type: "payment.received",
+ *   payload: {
+ *     transactionId: "tx123",
+ *     amount: 100,
+ *     currency: "USD"
+ *   },
+ *   timestamp: Date.now()
+ * };
+ * ```
+ */
+export type GraphEvent<T extends ZodSchema> = {
+    type: string;
+    payload?: any;
+    timestamp: number;
+};
+/**
+ * Configuration for waiting on multiple events
+ * @template T - Schema type for context validation
+ * @property {string[]} events - Array of event names to wait for
+ * @property {number} [timeout] - Optional timeout in milliseconds
+ * @property {"all" | "any" | "race"} strategy - Strategy for handling multiple events
+ * @property {(context: GraphContext<T>) => Promise<void>} [onSuccess] - Optional success callback
+ * @example
+ * ```typescript
+ * const config: WaitForEvents<MySchema> = {
+ *   events: ["event1", "event2"],
+ *   timeout: 5000,
+ *   strategy: "all",
+ *   onSuccess: async (context) => {
+ *     console.log("All events received");
+ *   }
+ * };
+ * ```
+ */
+export type WaitForEvents<T extends ZodSchema> = {
+    events: string[];
+    timeout?: number;
+    strategy: "all" | "any" | "race";
+    onSuccess?: <T extends ZodSchema>(context: GraphContext<T>) => Promise<void>;
+};
+/**
+ * Interface representing a node in the graph
+ * @interface
+ * @template T - Schema type
+ * @template P - Parameters type
+ */
+export interface GraphNodeConfig<T extends ZodSchema, P = any> {
+    /** Name of the node */
+    name: string;
+    /** Description of the node */
+    description?: string;
+    /** Schema for node inputs */
+    params?: P extends void ? never : ZodSchema<P>;
+    /** Execute function for the node */
+    execute: (context: GraphContext<T>, tools?: {
+        eventEmitter: IEventEmitter;
+    }) => Promise<void>;
+    /** Optional condition for node execution */
+    condition?: (context: GraphContext<T>, params?: P) => boolean;
+    /** Array of next node names or objects with conditions */
+    next?: Array<string | {
+        node: string;
+        condition: (context: GraphContext<T>) => boolean;
+    }> | string | ((context: GraphContext<T>) => string[]);
+    /** Array of event names that trigger this node */
+    events?: string[];
+    /** Event handling configuration */
+    when?: EventConfig;
+    /** Retry configuration */
+    retry?: {
+        maxAttempts: number;
+        delay: number;
+        onRetryFailed?: (error: Error, context: GraphContext<T>) => Promise<void>;
+        continueOnFailed?: boolean;
+    };
+    /** Error handler function */
+    onError?: (error: Error) => void;
+    agent?: string;
+}
+/**
+ * Interface for graph definition
+ * @interface
+ * @template T - Schema type
+ */
+export type GraphConfig<T extends ZodSchema> = {
+    /** Name of the graph */
+    name: string;
+    /** Schema for validation */
+    schema: T;
+    /** Initial context */
+    context: SchemaType<T>;
+    /** Array of nodes in the graph */
+    nodes: GraphNodeConfig<T, any>[];
+    /** Global error handler */
+    onError?: (error: Error, context: GraphContext<T>) => void;
+    /** Entry node name */
+    entryNode?: string;
+    /** Event emitter instance */
+    eventEmitter?: IEventEmitter | EventEmitter;
+    /** Array of events */
+    events?: string[];
+};
+/**
+ * Type for graph execution result
+ * @template T - Schema type
+ */
+export type GraphExecutionResult<T extends ZodSchema> = {
+    graphName: string;
+    nodeName: string;
+    context: GraphContext<T>;
+};
+/**
+ * Configuration type for Meilisearch
+ * @typedef {Object} MeilisearchConfig
+ */
+export type MeilisearchConfig = {
+    /** Meilisearch host URL */
+    host: string;
+    /** API key for authentication */
+    apiKey: string;
+    /** Array of searchable attributes */
+    searchableAttributes?: string[];
+    /** Array of sortable attributes */
+    sortableAttributes?: string[];
+};
+/**
+ * Settings type for Meilisearch
+ * @typedef {Object} MeilisearchSettings
+ */
+export type MeilisearchSettings = {
+    /** Array of searchable attributes */
+    searchableAttributes?: string[];
+    /** Array of sortable attributes */
+    sortableAttributes?: string[];
+};
+/**
+ * Configuration interface for NLP Engine
+ * @interface NLPConfig
+ * @property {any} [corpus] - Training corpus data
+ * @property {Record<string, any>} [responses] - Response templates
+ * @property {Record<string, any>} [entities] - Entity definitions
+ * @property {string} [language] - Language code (default: 'en')
+ * @property {number} [threshold] - Entity recognition threshold (default: 0.5)
+ * @property {string} [path] - Path to save/load model
+ */
+export type NLPConfig = {
+    corpus?: any;
+    responses?: Record<string, any>;
+    entities?: Record<string, any>;
+    language?: string;
+    threshold?: number;
+    path?: string;
+};
+/**
+ * Type definition for action handlers
+ * @callback ActionHandler
+ * @param {any} data - Input data for the action
+ * @returns {Promise<any>} Result of the action
+ */
+export type ActionHandler = (data: any) => Promise<any>;
+/**
+ * Options for the observer
+ * @typedef {Object} ObserverOptions
+ * @property {number} [debounce] - Debounce time in milliseconds
+ * @property {number} [delay] - Delay time in milliseconds
+ * @property {boolean} [stream] - Whether to stream the response
+ * @property {(string | number)[]} [properties] - Properties to observe
+ */
+export type ObserverOptions = {
+    debounce?: number;
+    delay?: number;
+    stream?: boolean;
+    properties?: (string | number)[];
+    onStreamLetter?: (data: {
+        letter: string;
+        property: string;
+    }) => void;
+    onStreamComplete?: () => void;
+};
+/**
+ * Checkpoint metadata for tracking execution state
+ */
+export type CheckpointMetadata = {
+    createdAt: number;
+    interrupted?: boolean;
+    awaitingApproval?: boolean;
+    rejected?: boolean;
+    error?: string;
+};
+/**
+ * Configuration for checkpoint behavior during execution
+ */
+export type CheckpointConfig = {
+    saveEveryNode?: boolean;
+    saveOnComplete?: boolean;
+    checkpointId?: string;
+    breakpoints?: string[];
+    runId?: string;
+    initialContext?: Record<string, any>;
+};
+/**
+ * Result of a human-in-the-loop approval
+ */
+export type ApprovalResult = {
+    action: "approved" | "rejected";
+    contextModifications?: Record<string, any>;
+};
+/**
+ * Represents a saved execution state of a graph
+ */
+export type Checkpoint<T extends ZodSchema = any> = {
+    id: string;
+    graphName: string;
+    runId?: string;
+    nodeName: string;
+    nextNodes: string[];
+    context: Record<string, any>;
+    metadata: CheckpointMetadata;
+};
+export type { ParallelConfig, Send, SendFunction, Command, ReducerFunction, StateReducer, WorkerConfig, ParallelNodeConfig, } from "../execution/types.parallel";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":""}

package/dist/utils/generate-action-schema.d.ts

@@ -0,0 +1,4 @@
+import { GraphFlow } from "../execution/index";
+export declare const generateActionSchema: (graphs: GraphFlow<any>[]) => string;
+export declare const getSchemaString: (schema: any) => string;
+//# sourceMappingURL=generate-action-schema.d.ts.map

package/dist/utils/generate-action-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-action-schema.d.ts","sourceRoot":"","sources":["../../utils/generate-action-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,eAAO,MAAM,oBAAoB,WAAY,SAAS,CAAC,GAAG,CAAC,EAAE,WAU5D,CAAC;AAGF,eAAO,MAAM,eAAe,WAAY,GAAG,KAAG,MA8B7C,CAAC"}

package/dist/utils/generate-action-schema.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSchemaString = exports.generateActionSchema = void 0;
+const zod_1 = require("zod");
+const generateActionSchema = (graphs) => {
+    return graphs
+        .map((graph) => {
+        const rootNode = Array.from(graph.nodes.values())[0];
+        const schemaStr = rootNode.params
+            ? (0, exports.getSchemaString)(rootNode.params)
+            : "No parameters";
+        return `Workflow: ${graph.name}\nParameters: ${schemaStr}`;
+    })
+        .join("\n\n");
+};
+exports.generateActionSchema = generateActionSchema;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const getSchemaString = (schema) => {
+    if (schema instanceof zod_1.z.ZodObject) {
+        const entries = Object.entries(schema.shape);
+        const fields = entries.map(([key, value]) => {
+            var _a;
+            const description = (_a = value._def) === null || _a === void 0 ? void 0 : _a.description;
+            const schemaStr = (0, exports.getSchemaString)(value);
+            return description
+                ? `${key}: ${schemaStr} // ${description}`
+                : `${key}: ${schemaStr}`;
+        });
+        return `z.object({${fields.join(", ")}})`;
+    }
+    if (schema instanceof zod_1.z.ZodArray) {
+        return `z.array(${(0, exports.getSchemaString)(schema.element)})`;
+    }
+    if (schema instanceof zod_1.z.ZodString) {
+        return "z.string()";
+    }
+    if (schema instanceof zod_1.z.ZodNumber) {
+        return "z.number()";
+    }
+    if (schema instanceof zod_1.z.ZodBoolean) {
+        return "z.boolean()";
+    }
+    return `z.unknown()`;
+};
+exports.getSchemaString = getSchemaString;
+//# sourceMappingURL=generate-action-schema.js.map

package/dist/utils/generate-action-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-action-schema.js","sourceRoot":"","sources":["../../utils/generate-action-schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAGjB,MAAM,oBAAoB,GAAG,CAAC,MAAwB,EAAE,EAAE;IAC/D,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM;YAC/B,CAAC,CAAC,IAAA,uBAAe,EAAC,QAAQ,CAAC,MAAM,CAAC;YAClC,CAAC,CAAC,eAAe,CAAC;QACpB,OAAO,aAAa,KAAK,CAAC,IAAI,iBAAiB,SAAS,EAAE,CAAC;IAC7D,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC,CAAC;AAVW,QAAA,oBAAoB,wBAU/B;AAEF,8DAA8D;AACvD,MAAM,eAAe,GAAG,CAAC,MAAW,EAAU,EAAE;IACrD,IAAI,MAAM,YAAY,OAAC,CAAC,SAAS,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;;YAC1C,MAAM,WAAW,GAAG,MAAC,KAAa,CAAC,IAAI,0CAAE,WAAW,CAAC;YACrD,MAAM,SAAS,GAAG,IAAA,uBAAe,EAAC,KAAK,CAAC,CAAC;YACzC,OAAO,WAAW;gBAChB,CAAC,CAAC,GAAG,GAAG,KAAK,SAAS,OAAO,WAAW,EAAE;gBAC1C,CAAC,CAAC,GAAG,GAAG,KAAK,SAAS,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,OAAO,aAAa,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAC5C,CAAC;IAED,IAAI,MAAM,YAAY,OAAC,CAAC,QAAQ,EAAE,CAAC;QACjC,OAAO,WAAW,IAAA,uBAAe,EAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;IACvD,CAAC;IAED,IAAI,MAAM,YAAY,OAAC,CAAC,SAAS,EAAE,CAAC;QAClC,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,MAAM,YAAY,OAAC,CAAC,SAAS,EAAE,CAAC;QAClC,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,MAAM,YAAY,OAAC,CAAC,UAAU,EAAE,CAAC;QACnC,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC,CAAC;AA9BW,QAAA,eAAe,mBA8B1B"}

package/dist/utils/header-builder.d.ts

@@ -0,0 +1,12 @@
+type HeaderValue = string | string[] | undefined;
+export declare class LLMHeaderBuilder {
+    private headers;
+    private _result;
+    constructor();
+    addHeader(key: string, value: HeaderValue): LLMHeaderBuilder;
+    valueOf(): string;
+    toString(): string;
+    static create(): LLMHeaderBuilder;
+}
+export {};
+//# sourceMappingURL=header-builder.d.ts.map

package/dist/utils/header-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-builder.d.ts","sourceRoot":"","sources":["../../utils/header-builder.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;AAEjD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,OAAO,CAAS;;IAOxB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,gBAAgB;IAiB5D,OAAO,IAAI,MAAM;IAIjB,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,MAAM,IAAI,gBAAgB;CAGlC"}

package/dist/utils/header-builder.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMHeaderBuilder = void 0;
+class LLMHeaderBuilder {
+    constructor() {
+        this.headers = new Map();
+        this._result = "";
+    }
+    addHeader(key, value) {
+        if (Array.isArray(value)) {
+            this.headers.set(key, value.join("\n"));
+        }
+        else {
+            this.headers.set(key, value);
+        }
+        // Build result immediately
+        this._result = Array.from(this.headers.entries())
+            .filter(([_, value]) => value !== undefined)
+            .map(([key, value]) => `# ${key}: ${value}`)
+            .join("\n")
+            .trim();
+        return this;
+    }
+    valueOf() {
+        return this._result;
+    }
+    toString() {
+        return this._result;
+    }
+    static create() {
+        return new LLMHeaderBuilder();
+    }
+}
+exports.LLMHeaderBuilder = LLMHeaderBuilder;
+//# sourceMappingURL=header-builder.js.map

package/dist/utils/header-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-builder.js","sourceRoot":"","sources":["../../utils/header-builder.ts"],"names":[],"mappings":";;;AAEA,MAAa,gBAAgB;IAI3B;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,KAAkB;QACvC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;QAED,2BAA2B;QAC3B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;aAC9C,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;aAC3C,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,KAAK,EAAE,CAAC;aAC3C,IAAI,CAAC,IAAI,CAAC;aACV,IAAI,EAAE,CAAC;QAEV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,gBAAgB,EAAE,CAAC;IAChC,CAAC;CACF;AArCD,4CAqCC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,27 @@
+import pino from 'pino';
+/**
+ * Shared Pino logger for the CortexFlow runtime.
+ *
+ * Pretty-prints in development with `HH:MM:ss Z` timestamps.
+ * Use `logger.child({ sessionId, traceId })` inside every session scope so log
+ * lines can be correlated across a full orchestration trace.
+ *
+ * @example
+ * ```ts
+ * import logger from '../utils/logger';
+ *
+ * const log = logger.child({ sessionId: 'abc', traceId: 'trace_123' });
+ * log.info({ intent: 'FETCH_MAILS' }, 'Intent classified');
+ * log.warn({ confidence: 0.4 }, 'Low confidence — requesting clarification');
+ * ```
+ */
+declare const logger: pino.Logger<never, boolean>;
+/**
+ * Creates a child logger pre-bound with session and trace identifiers.
+ *
+ * @param sessionId - Stable session ID returned by `CortexFlowOrchestrator.startSession()`.
+ * @param traceId - Correlation ID propagated through all token data and log entries.
+ */
+export declare const createLogger: (sessionId?: string, traceId?: string) => pino.Logger<never, boolean>;
+export default logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,MAAM,6BASV,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,YAAY,eAAgB,MAAM,YAAY,MAAM,gCAEhE,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLogger = void 0;
+const pino_1 = __importDefault(require("pino"));
+/**
+ * Shared Pino logger for the CortexFlow runtime.
+ *
+ * Pretty-prints in development with `HH:MM:ss Z` timestamps.
+ * Use `logger.child({ sessionId, traceId })` inside every session scope so log
+ * lines can be correlated across a full orchestration trace.
+ *
+ * @example
+ * ```ts
+ * import logger from '../utils/logger';
+ *
+ * const log = logger.child({ sessionId: 'abc', traceId: 'trace_123' });
+ * log.info({ intent: 'FETCH_MAILS' }, 'Intent classified');
+ * log.warn({ confidence: 0.4 }, 'Low confidence — requesting clarification');
+ * ```
+ */
+const logger = (0, pino_1.default)({
+    transport: {
+        target: 'pino-pretty',
+        options: {
+            colorize: true,
+            translateTime: 'HH:MM:ss Z',
+            ignore: 'pid,hostname',
+        },
+    },
+});
+/**
+ * Creates a child logger pre-bound with session and trace identifiers.
+ *
+ * @param sessionId - Stable session ID returned by `CortexFlowOrchestrator.startSession()`.
+ * @param traceId - Correlation ID propagated through all token data and log entries.
+ */
+const createLogger = (sessionId, traceId) => {
+    return logger.child({ sessionId, traceId });
+};
+exports.createLogger = createLogger;
+exports.default = logger;
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../utils/logger.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AAExB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,GAAG,IAAA,cAAI,EAAC;IAClB,SAAS,EAAE;QACT,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE;YACP,QAAQ,EAAE,IAAI;YACd,aAAa,EAAE,YAAY;YAC3B,MAAM,EAAE,cAAc;SACvB;KACF;CACF,CAAC,CAAC;AAEH;;;;;GAKG;AACI,MAAM,YAAY,GAAG,CAAC,SAAkB,EAAE,OAAgB,EAAE,EAAE;IACnE,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;AAC9C,CAAC,CAAC;AAFW,QAAA,YAAY,gBAEvB;AAEF,kBAAe,MAAM,CAAC"}