cognitive-core 0.0.2 → 0.1.0

package/dist/types/task.d.ts

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+/**
+ * Verification specification for validating task outcomes
+ */
+export declare const VerificationSpecSchema: z.ZodObject<{
+    type: z.ZodEnum<["exact_match", "fuzzy_match", "function", "llm"]>;
+    expected: z.ZodOptional<z.ZodUnknown>;
+    tolerance: z.ZodOptional<z.ZodNumber>;
+    verifier_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "function" | "exact_match" | "fuzzy_match" | "llm";
+    expected?: unknown;
+    tolerance?: number | undefined;
+    verifier_id?: string | undefined;
+}, {
+    type: "function" | "exact_match" | "fuzzy_match" | "llm";
+    expected?: unknown;
+    tolerance?: number | undefined;
+    verifier_id?: string | undefined;
+}>;
+export type VerificationSpec = z.infer<typeof VerificationSpecSchema>;
+/**
+ * Task - The fundamental unit of work
+ * Represents what an agent needs to accomplish
+ */
+export declare const TaskSchema: z.ZodObject<{
+    id: z.ZodString;
+    domain: z.ZodString;
+    description: z.ZodString;
+    context: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    verification: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["exact_match", "fuzzy_match", "function", "llm"]>;
+        expected: z.ZodOptional<z.ZodUnknown>;
+        tolerance: z.ZodOptional<z.ZodNumber>;
+        verifier_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "function" | "exact_match" | "fuzzy_match" | "llm";
+        expected?: unknown;
+        tolerance?: number | undefined;
+        verifier_id?: string | undefined;
+    }, {
+        type: "function" | "exact_match" | "fuzzy_match" | "llm";
+        expected?: unknown;
+        tolerance?: number | undefined;
+        verifier_id?: string | undefined;
+    }>>;
+    embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    createdAt: z.ZodDefault<z.ZodDate>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    domain: string;
+    description: string;
+    context: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    verification?: {
+        type: "function" | "exact_match" | "fuzzy_match" | "llm";
+        expected?: unknown;
+        tolerance?: number | undefined;
+        verifier_id?: string | undefined;
+    } | undefined;
+    embedding?: number[] | undefined;
+}, {
+    id: string;
+    domain: string;
+    description: string;
+    context?: Record<string, unknown> | undefined;
+    verification?: {
+        type: "function" | "exact_match" | "fuzzy_match" | "llm";
+        expected?: unknown;
+        tolerance?: number | undefined;
+        verifier_id?: string | undefined;
+    } | undefined;
+    embedding?: number[] | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    createdAt?: Date | undefined;
+}>;
+export type Task = z.infer<typeof TaskSchema>;
+/**
+ * Create a new task with defaults
+ */
+export declare function createTask(params: {
+    id?: string;
+    domain: string;
+    description: string;
+    context?: Record<string, unknown>;
+    verification?: VerificationSpec;
+    metadata?: Record<string, unknown>;
+}): Task;
+//# sourceMappingURL=task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/types/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;EAKjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASrB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,IAAI,CAUP"}

package/dist/types/task.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+/**
+ * Verification specification for validating task outcomes
+ */
+export const VerificationSpecSchema = z.object({
+    type: z.enum(['exact_match', 'fuzzy_match', 'function', 'llm']),
+    expected: z.unknown().optional(),
+    tolerance: z.number().optional(),
+    verifier_id: z.string().optional(),
+});
+/**
+ * Task - The fundamental unit of work
+ * Represents what an agent needs to accomplish
+ */
+export const TaskSchema = z.object({
+    id: z.string(),
+    domain: z.string(), // e.g., 'arc', 'swe', 'code', 'reasoning'
+    description: z.string(),
+    context: z.record(z.unknown()).default({}),
+    verification: VerificationSpecSchema.optional(),
+    embedding: z.array(z.number()).optional(),
+    metadata: z.record(z.unknown()).default({}),
+    createdAt: z.date().default(() => new Date()),
+});
+/**
+ * Create a new task with defaults
+ */
+export function createTask(params) {
+    return TaskSchema.parse({
+        id: params.id ?? crypto.randomUUID(),
+        domain: params.domain,
+        description: params.description,
+        context: params.context ?? {},
+        verification: params.verification,
+        metadata: params.metadata ?? {},
+        createdAt: new Date(),
+    });
+}
+//# sourceMappingURL=task.js.map

package/dist/types/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/types/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IAC/D,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,0CAA0C;IAC9D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1C,YAAY,EAAE,sBAAsB,CAAC,QAAQ,EAAE;IAC/C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;CAC9C,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAO1B;IACC,OAAO,UAAU,CAAC,KAAK,CAAC;QACtB,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE;QACpC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;QAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;QAC/B,SAAS,EAAE,IAAI,IAAI,EAAE;KACtB,CAAC,CAAC;AACL,CAAC"}

package/dist/types/trajectory.d.ts

@@ -0,0 +1,221 @@
+import { z } from 'zod';
+import { type Task } from './task.js';
+import { type Step } from './step.js';
+import { type Outcome } from './outcome.js';
+/**
+ * Trajectory - A complete record of an agent's task-solving attempt
+ * The atomic unit of learning in Atlas
+ */
+export declare const TrajectorySchema: z.ZodObject<{
+    /** Unique trajectory identifier */
+    id: z.ZodString;
+    /** The task being solved */
+    task: z.ZodObject<{
+        id: z.ZodString;
+        domain: z.ZodString;
+        description: z.ZodString;
+        context: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        verification: z.ZodOptional<z.ZodObject<{
+            type: z.ZodEnum<["exact_match", "fuzzy_match", "function", "llm"]>;
+            expected: z.ZodOptional<z.ZodUnknown>;
+            tolerance: z.ZodOptional<z.ZodNumber>;
+            verifier_id: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "function" | "exact_match" | "fuzzy_match" | "llm";
+            expected?: unknown;
+            tolerance?: number | undefined;
+            verifier_id?: string | undefined;
+        }, {
+            type: "function" | "exact_match" | "fuzzy_match" | "llm";
+            expected?: unknown;
+            tolerance?: number | undefined;
+            verifier_id?: string | undefined;
+        }>>;
+        embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        createdAt: z.ZodDefault<z.ZodDate>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        domain: string;
+        description: string;
+        context: Record<string, unknown>;
+        metadata: Record<string, unknown>;
+        createdAt: Date;
+        verification?: {
+            type: "function" | "exact_match" | "fuzzy_match" | "llm";
+            expected?: unknown;
+            tolerance?: number | undefined;
+            verifier_id?: string | undefined;
+        } | undefined;
+        embedding?: number[] | undefined;
+    }, {
+        id: string;
+        domain: string;
+        description: string;
+        context?: Record<string, unknown> | undefined;
+        verification?: {
+            type: "function" | "exact_match" | "fuzzy_match" | "llm";
+            expected?: unknown;
+            tolerance?: number | undefined;
+            verifier_id?: string | undefined;
+        } | undefined;
+        embedding?: number[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        createdAt?: Date | undefined;
+    }>;
+    /** Sequence of steps taken */
+    steps: z.ZodArray<z.ZodObject<{
+        thought: z.ZodOptional<z.ZodString>;
+        action: z.ZodString;
+        observation: z.ZodString;
+        timestamp: z.ZodDefault<z.ZodDate>;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        attributionScore: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        metadata: Record<string, unknown>;
+        action: string;
+        observation: string;
+        timestamp: Date;
+        thought?: string | undefined;
+        attributionScore?: number | undefined;
+    }, {
+        action: string;
+        observation: string;
+        metadata?: Record<string, unknown> | undefined;
+        thought?: string | undefined;
+        timestamp?: Date | undefined;
+        attributionScore?: number | undefined;
+    }>, "many">;
+    /** Final outcome */
+    outcome: z.ZodObject<{
+        success: z.ZodBoolean;
+        partialScore: z.ZodDefault<z.ZodNumber>;
+        errorInfo: z.ZodOptional<z.ZodString>;
+        verificationDetails: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        solution: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        partialScore: number;
+        verificationDetails: Record<string, unknown>;
+        errorInfo?: string | undefined;
+        solution?: unknown;
+    }, {
+        success: boolean;
+        partialScore?: number | undefined;
+        errorInfo?: string | undefined;
+        verificationDetails?: Record<string, unknown> | undefined;
+        solution?: unknown;
+    }>;
+    /** Identifier of the agent that produced this trajectory */
+    agentId: z.ZodString;
+    /** When the trajectory was created */
+    timestamp: z.ZodDefault<z.ZodDate>;
+    /** Number of LLM API calls made */
+    llmCalls: z.ZodDefault<z.ZodNumber>;
+    /** Total tokens used */
+    totalTokens: z.ZodDefault<z.ZodNumber>;
+    /** Wall clock time in seconds */
+    wallTimeSeconds: z.ZodDefault<z.ZodNumber>;
+    /** Additional metadata */
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    metadata: Record<string, unknown>;
+    timestamp: Date;
+    task: {
+        id: string;
+        domain: string;
+        description: string;
+        context: Record<string, unknown>;
+        metadata: Record<string, unknown>;
+        createdAt: Date;
+        verification?: {
+            type: "function" | "exact_match" | "fuzzy_match" | "llm";
+            expected?: unknown;
+            tolerance?: number | undefined;
+            verifier_id?: string | undefined;
+        } | undefined;
+        embedding?: number[] | undefined;
+    };
+    steps: {
+        metadata: Record<string, unknown>;
+        action: string;
+        observation: string;
+        timestamp: Date;
+        thought?: string | undefined;
+        attributionScore?: number | undefined;
+    }[];
+    outcome: {
+        success: boolean;
+        partialScore: number;
+        verificationDetails: Record<string, unknown>;
+        errorInfo?: string | undefined;
+        solution?: unknown;
+    };
+    agentId: string;
+    llmCalls: number;
+    totalTokens: number;
+    wallTimeSeconds: number;
+}, {
+    id: string;
+    task: {
+        id: string;
+        domain: string;
+        description: string;
+        context?: Record<string, unknown> | undefined;
+        verification?: {
+            type: "function" | "exact_match" | "fuzzy_match" | "llm";
+            expected?: unknown;
+            tolerance?: number | undefined;
+            verifier_id?: string | undefined;
+        } | undefined;
+        embedding?: number[] | undefined;
+        metadata?: Record<string, unknown> | undefined;
+        createdAt?: Date | undefined;
+    };
+    steps: {
+        action: string;
+        observation: string;
+        metadata?: Record<string, unknown> | undefined;
+        thought?: string | undefined;
+        timestamp?: Date | undefined;
+        attributionScore?: number | undefined;
+    }[];
+    outcome: {
+        success: boolean;
+        partialScore?: number | undefined;
+        errorInfo?: string | undefined;
+        verificationDetails?: Record<string, unknown> | undefined;
+        solution?: unknown;
+    };
+    agentId: string;
+    metadata?: Record<string, unknown> | undefined;
+    timestamp?: Date | undefined;
+    llmCalls?: number | undefined;
+    totalTokens?: number | undefined;
+    wallTimeSeconds?: number | undefined;
+}>;
+export type Trajectory = z.infer<typeof TrajectorySchema>;
+/**
+ * Create a new trajectory
+ */
+export declare function createTrajectory(params: {
+    id?: string;
+    task: Task;
+    steps: Step[];
+    outcome: Outcome;
+    agentId: string;
+    llmCalls?: number;
+    totalTokens?: number;
+    wallTimeSeconds?: number;
+    metadata?: Record<string, unknown>;
+}): Trajectory;
+/**
+ * Check if trajectory was successful
+ */
+export declare function isSuccessful(trajectory: Trajectory): boolean;
+/**
+ * Get key steps (those with high attribution scores)
+ */
+export declare function getKeySteps(trajectory: Trajectory, threshold?: number): Step[];
+//# sourceMappingURL=trajectory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../../src/types/trajectory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,gBAAgB;IAC3B,mCAAmC;;IAEnC,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE5B,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;IAE9B,oBAAoB;;;;;;;;;;;;;;;;;;;;IAEpB,4DAA4D;;IAE5D,sCAAsC;;IAEtC,mCAAmC;;IAEnC,wBAAwB;;IAExB,iCAAiC;;IAEjC,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE1B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,UAAU,CAab;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,UAAU,EACtB,SAAS,SAAO,GACf,IAAI,EAAE,CAIR"}

package/dist/types/trajectory.js

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import { TaskSchema } from './task.js';
+import { StepSchema } from './step.js';
+import { OutcomeSchema } from './outcome.js';
+/**
+ * Trajectory - A complete record of an agent's task-solving attempt
+ * The atomic unit of learning in Atlas
+ */
+export const TrajectorySchema = z.object({
+    /** Unique trajectory identifier */
+    id: z.string(),
+    /** The task being solved */
+    task: TaskSchema,
+    /** Sequence of steps taken */
+    steps: z.array(StepSchema),
+    /** Final outcome */
+    outcome: OutcomeSchema,
+    /** Identifier of the agent that produced this trajectory */
+    agentId: z.string(),
+    /** When the trajectory was created */
+    timestamp: z.date().default(() => new Date()),
+    /** Number of LLM API calls made */
+    llmCalls: z.number().default(0),
+    /** Total tokens used */
+    totalTokens: z.number().default(0),
+    /** Wall clock time in seconds */
+    wallTimeSeconds: z.number().default(0),
+    /** Additional metadata */
+    metadata: z.record(z.unknown()).default({}),
+});
+/**
+ * Create a new trajectory
+ */
+export function createTrajectory(params) {
+    return TrajectorySchema.parse({
+        id: params.id ?? crypto.randomUUID(),
+        task: params.task,
+        steps: params.steps,
+        outcome: params.outcome,
+        agentId: params.agentId,
+        timestamp: new Date(),
+        llmCalls: params.llmCalls ?? 0,
+        totalTokens: params.totalTokens ?? 0,
+        wallTimeSeconds: params.wallTimeSeconds ?? 0,
+        metadata: params.metadata ?? {},
+    });
+}
+/**
+ * Check if trajectory was successful
+ */
+export function isSuccessful(trajectory) {
+    return trajectory.outcome.success;
+}
+/**
+ * Get key steps (those with high attribution scores)
+ */
+export function getKeySteps(trajectory, threshold = 0.15) {
+    return trajectory.steps.filter((step) => (step.attributionScore ?? 0) >= threshold);
+}
+//# sourceMappingURL=trajectory.js.map

package/dist/types/trajectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.js","sourceRoot":"","sources":["../../src/types/trajectory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAa,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,UAAU,EAAa,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,aAAa,EAAgB,MAAM,cAAc,CAAC;AAE3D;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,mCAAmC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,4BAA4B;IAC5B,IAAI,EAAE,UAAU;IAChB,8BAA8B;IAC9B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IAC1B,oBAAoB;IACpB,OAAO,EAAE,aAAa;IACtB,4DAA4D;IAC5D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,sCAAsC;IACtC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;IAC7C,mCAAmC;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/B,wBAAwB;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAClC,iCAAiC;IACjC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACtC,0BAA0B;IAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC5C,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAUhC;IACC,OAAO,gBAAgB,CAAC,KAAK,CAAC;QAC5B,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE;QACpC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC;QAC9B,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,CAAC;QACpC,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,CAAC;QAC5C,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;KAChC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,UAAsB;IACjD,OAAO,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,UAAsB,EACtB,SAAS,GAAG,IAAI;IAEhB,OAAO,UAAU,CAAC,KAAK,CAAC,MAAM,CAC5B,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC,IAAI,SAAS,CACpD,CAAC;AACJ,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export { cosineSimilarity, jaccardSimilarity, textSimilarity, ngramSimilarity, tokenize, findTopK, } from './similarity.js';
+export { ensureDir, saveJson, loadJson, listFiles, exists, JsonStore, saveIndex, loadIndex, type StorageOptions, } from './storage.js';
+export { ValidationError, validateString, validateOptionalString, validateNumber, validateOptionalNumber, validateArray, validateVector, validateTaskInput, validateTrajectoryStepCount, validateMCPArgs, TaskInputSchema, MCPSearchPlaybooksSchema, MCPGetPlaybookDetailsSchema, MCPGetPlaybooksByDomainSchema, type TaskInput, } from './validation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,SAAS,EACT,SAAS,EACT,SAAS,EACT,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,EAC7B,KAAK,SAAS,GACf,MAAM,iBAAiB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,4 @@
+export { cosineSimilarity, jaccardSimilarity, textSimilarity, ngramSimilarity, tokenize, findTopK, } from './similarity.js';
+export { ensureDir, saveJson, loadJson, listFiles, exists, JsonStore, saveIndex, loadIndex, } from './storage.js';
+export { ValidationError, validateString, validateOptionalString, validateNumber, validateOptionalNumber, validateArray, validateVector, validateTaskInput, validateTrajectoryStepCount, validateMCPArgs, TaskInputSchema, MCPSearchPlaybooksSchema, MCPGetPlaybookDetailsSchema, MCPGetPlaybooksByDomainSchema, } from './validation.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,SAAS,EACT,SAAS,EACT,SAAS,GAEV,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,GAE9B,MAAM,iBAAiB,CAAC"}

package/dist/utils/similarity.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Similarity utilities for comparing embeddings and text
+ */
+/**
+ * Compute cosine similarity between two vectors
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+/**
+ * Compute Jaccard similarity between two sets of words
+ */
+export declare function jaccardSimilarity(a: string, b: string): number;
+/**
+ * Simple tokenization for text similarity
+ */
+export declare function tokenize(text: string): string[];
+/**
+ * Compute n-gram overlap similarity
+ */
+export declare function ngramSimilarity(a: string, b: string, n?: number): number;
+/**
+ * Combined text similarity using multiple methods
+ */
+export declare function textSimilarity(a: string, b: string): number;
+/**
+ * Find top-k most similar items
+ */
+export declare function findTopK<T>(query: number[] | string, items: T[], getVector: (item: T) => number[] | string | undefined, k: number): Array<{
+    item: T;
+    score: number;
+}>;
+//# sourceMappingURL=similarity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.d.ts","sourceRoot":"","sources":["../../src/utils/similarity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAuBjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAY9D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAM/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,SAAI,GACJ,MAAM,CAcR;AAgBD;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EACxB,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,EACrD,CAAC,EAAE,MAAM,GACR,KAAK,CAAC;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAsBnC"}

package/dist/utils/similarity.js

@@ -0,0 +1,107 @@
+/**
+ * Similarity utilities for comparing embeddings and text
+ */
+/**
+ * Compute cosine similarity between two vectors
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error('Vectors must have the same length');
+    }
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    normA = Math.sqrt(normA);
+    normB = Math.sqrt(normB);
+    if (normA === 0 || normB === 0) {
+        return 0;
+    }
+    return dotProduct / (normA * normB);
+}
+/**
+ * Compute Jaccard similarity between two sets of words
+ */
+export function jaccardSimilarity(a, b) {
+    const setA = new Set(tokenize(a));
+    const setB = new Set(tokenize(b));
+    const intersection = new Set([...setA].filter((x) => setB.has(x)));
+    const union = new Set([...setA, ...setB]);
+    if (union.size === 0) {
+        return 0;
+    }
+    return intersection.size / union.size;
+}
+/**
+ * Simple tokenization for text similarity
+ */
+export function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^\w\s]/g, ' ')
+        .split(/\s+/)
+        .filter((token) => token.length > 0);
+}
+/**
+ * Compute n-gram overlap similarity
+ */
+export function ngramSimilarity(a, b, n = 3) {
+    const ngramsA = getNgrams(a, n);
+    const ngramsB = getNgrams(b, n);
+    const intersection = new Set([...ngramsA].filter((x) => ngramsB.has(x)));
+    const union = new Set([...ngramsA, ...ngramsB]);
+    if (union.size === 0) {
+        return 0;
+    }
+    return intersection.size / union.size;
+}
+/**
+ * Get character n-grams from text
+ */
+function getNgrams(text, n) {
+    const ngrams = new Set();
+    const normalized = text.toLowerCase();
+    for (let i = 0; i <= normalized.length - n; i++) {
+        ngrams.add(normalized.slice(i, i + n));
+    }
+    return ngrams;
+}
+/**
+ * Combined text similarity using multiple methods
+ */
+export function textSimilarity(a, b) {
+    const jaccard = jaccardSimilarity(a, b);
+    const ngram = ngramSimilarity(a, b);
+    // Weighted average
+    return jaccard * 0.6 + ngram * 0.4;
+}
+/**
+ * Find top-k most similar items
+ */
+export function findTopK(query, items, getVector, k) {
+    const scored = items
+        .map((item) => {
+        const vector = getVector(item);
+        if (!vector) {
+            return { item, score: 0 };
+        }
+        let score;
+        if (typeof query === 'string' && typeof vector === 'string') {
+            score = textSimilarity(query, vector);
+        }
+        else if (Array.isArray(query) && Array.isArray(vector)) {
+            score = cosineSimilarity(query, vector);
+        }
+        else {
+            score = 0;
+        }
+        return { item, score };
+    })
+        .sort((a, b) => b.score - a.score);
+    return scored.slice(0, k);
+}
+//# sourceMappingURL=similarity.js.map

package/dist/utils/similarity.js.map

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