conatus 0.1.0

package/dist/types/task.js

@@ -0,0 +1,66 @@
+import { z } from "zod";
+import { ReversibilityEnum, VerdictEnum, TaskStatusEnum, DurationSchema, ObservationLayerEnum, } from "./core.js";
+// --- Success Criterion ---
+export const CriterionSchema = z.object({
+    description: z.string(),
+    verification_method: z.string(),
+    is_blocking: z.boolean().default(true),
+});
+// --- Scope Boundary ---
+export const ScopeBoundarySchema = z.object({
+    in_scope: z.array(z.string()),
+    out_of_scope: z.array(z.string()),
+    blast_radius: z.string(),
+});
+// --- Task ---
+export const TaskSchema = z.object({
+    id: z.string(),
+    goal_id: z.string(),
+    strategy_id: z.string().nullable().default(null),
+    target_dimensions: z.array(z.string()),
+    primary_dimension: z.string(),
+    work_description: z.string(),
+    rationale: z.string(),
+    approach: z.string(),
+    success_criteria: z.array(CriterionSchema),
+    scope_boundary: ScopeBoundarySchema,
+    constraints: z.array(z.string()),
+    plateau_until: z.string().nullable().default(null),
+    estimated_duration: DurationSchema.nullable().default(null),
+    consecutive_failure_count: z.number().default(0),
+    reversibility: ReversibilityEnum.default("unknown"),
+    intended_direction: z.enum(["increase", "decrease", "neutral"]).optional(),
+    // Task category — enumerated to enable stall detection comparisons
+    task_category: z
+        .enum(["normal", "knowledge_acquisition", "verification", "observation", "capability_acquisition"])
+        .default("normal"),
+    status: TaskStatusEnum.default("pending"),
+    started_at: z.string().nullable().default(null),
+    completed_at: z.string().nullable().default(null),
+    timeout_at: z.string().nullable().default(null),
+    heartbeat_at: z.string().datetime().nullable().default(null),
+    created_at: z.string(),
+});
+// --- Evidence ---
+export const EvidenceSchema = z.object({
+    layer: ObservationLayerEnum,
+    description: z.string(),
+    confidence: z.number().min(0).max(1),
+});
+// --- Dimension Update ---
+export const DimensionUpdateSchema = z.object({
+    dimension_name: z.string(),
+    previous_value: z.union([z.number(), z.string(), z.boolean(), z.null()]),
+    new_value: z.union([z.number(), z.string(), z.boolean(), z.null()]),
+    confidence: z.number().min(0).max(1),
+});
+// --- Verification Result ---
+export const VerificationResultSchema = z.object({
+    task_id: z.string(),
+    verdict: VerdictEnum,
+    confidence: z.number().min(0).max(1),
+    evidence: z.array(EvidenceSchema),
+    dimension_updates: z.array(DimensionUpdateSchema),
+    timestamp: z.string(),
+});
+//# 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;AACxB,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,cAAc,EACd,oBAAoB,GACrB,MAAM,WAAW,CAAC;AAEnB,4BAA4B;AAE5B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC/B,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACvC,CAAC,CAAC;AAGH,yBAAyB;AAEzB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;CACzB,CAAC,CAAC;AAGH,eAAe;AAEf,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAEhD,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACtC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;IAE7B,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IAEpB,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;IAC1C,cAAc,EAAE,mBAAmB;IACnC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAEhC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAClD,kBAAkB,EAAE,cAAc,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3D,yBAAyB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAChD,aAAa,EAAE,iBAAiB,CAAC,OAAO,CAAC,SAAS,CAAC;IACnD,kBAAkB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IAE1E,mEAAmE;IACnE,aAAa,EAAE,CAAC;SACb,IAAI,CAAC,CAAC,QAAQ,EAAE,uBAAuB,EAAE,cAAc,EAAE,aAAa,EAAE,wBAAwB,CAAC,CAAC;SAClG,OAAO,CAAC,QAAQ,CAAC;IAEpB,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC/C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACjD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC/C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAE5D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAGH,mBAAmB;AAEnB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACrC,CAAC,CAAC;AAGH,2BAA2B;AAE3B,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACxE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACnE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACrC,CAAC,CAAC;AAGH,8BAA8B;AAE9B,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;IACjC,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;IACjD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC"}

package/dist/types/trust.d.ts

@@ -0,0 +1,126 @@
+import { z } from "zod";
+export declare const TrustBalanceSchema: z.ZodObject<{
+    domain: z.ZodString;
+    balance: z.ZodDefault<z.ZodNumber>;
+    success_delta: z.ZodDefault<z.ZodNumber>;
+    failure_delta: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    domain: string;
+    balance: number;
+    success_delta: number;
+    failure_delta: number;
+}, {
+    domain: string;
+    balance?: number | undefined;
+    success_delta?: number | undefined;
+    failure_delta?: number | undefined;
+}>;
+export type TrustBalance = z.infer<typeof TrustBalanceSchema>;
+export declare const TrustOverrideLogEntrySchema: z.ZodObject<{
+    timestamp: z.ZodString;
+    override_type: z.ZodEnum<["trust_grant", "permanent_gate"]>;
+    domain: z.ZodString;
+    target_category: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    balance_before: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    balance_after: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    domain: string;
+    override_type: "trust_grant" | "permanent_gate";
+    target_category: string | null;
+    balance_before: number | null;
+    balance_after: number | null;
+}, {
+    timestamp: string;
+    domain: string;
+    override_type: "trust_grant" | "permanent_gate";
+    target_category?: string | null | undefined;
+    balance_before?: number | null | undefined;
+    balance_after?: number | null | undefined;
+}>;
+export type TrustOverrideLogEntry = z.infer<typeof TrustOverrideLogEntrySchema>;
+export declare const TrustStoreSchema: z.ZodObject<{
+    balances: z.ZodRecord<z.ZodString, z.ZodObject<{
+        domain: z.ZodString;
+        balance: z.ZodDefault<z.ZodNumber>;
+        success_delta: z.ZodDefault<z.ZodNumber>;
+        failure_delta: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        domain: string;
+        balance: number;
+        success_delta: number;
+        failure_delta: number;
+    }, {
+        domain: string;
+        balance?: number | undefined;
+        success_delta?: number | undefined;
+        failure_delta?: number | undefined;
+    }>>;
+    permanent_gates: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+    override_log: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        timestamp: z.ZodString;
+        override_type: z.ZodEnum<["trust_grant", "permanent_gate"]>;
+        domain: z.ZodString;
+        target_category: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        balance_before: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        balance_after: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        domain: string;
+        override_type: "trust_grant" | "permanent_gate";
+        target_category: string | null;
+        balance_before: number | null;
+        balance_after: number | null;
+    }, {
+        timestamp: string;
+        domain: string;
+        override_type: "trust_grant" | "permanent_gate";
+        target_category?: string | null | undefined;
+        balance_before?: number | null | undefined;
+        balance_after?: number | null | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    balances: Record<string, {
+        domain: string;
+        balance: number;
+        success_delta: number;
+        failure_delta: number;
+    }>;
+    permanent_gates: Record<string, string[]>;
+    override_log: {
+        timestamp: string;
+        domain: string;
+        override_type: "trust_grant" | "permanent_gate";
+        target_category: string | null;
+        balance_before: number | null;
+        balance_after: number | null;
+    }[];
+}, {
+    balances: Record<string, {
+        domain: string;
+        balance?: number | undefined;
+        success_delta?: number | undefined;
+        failure_delta?: number | undefined;
+    }>;
+    permanent_gates?: Record<string, string[]> | undefined;
+    override_log?: {
+        timestamp: string;
+        domain: string;
+        override_type: "trust_grant" | "permanent_gate";
+        target_category?: string | null | undefined;
+        balance_before?: number | null | undefined;
+        balance_after?: number | null | undefined;
+    }[] | undefined;
+}>;
+export type TrustStore = z.infer<typeof TrustStoreSchema>;
+export declare const ActionQuadrantEnum: z.ZodEnum<["autonomous", "execute_with_confirm", "observe_and_propose"]>;
+export type ActionQuadrant = z.infer<typeof ActionQuadrantEnum>;
+/** High trust threshold: trust_balance >= 20 */
+export declare const HIGH_TRUST_THRESHOLD = 20;
+/** High confidence threshold: confidence >= 0.50 */
+export declare const HIGH_CONFIDENCE_THRESHOLD = 0.5;
+/** Trust change on success */
+export declare const TRUST_SUCCESS_DELTA = 3;
+/** Trust change on failure */
+export declare const TRUST_FAILURE_DELTA = -10;
+//# sourceMappingURL=trust.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trust.d.ts","sourceRoot":"","sources":["../../src/types/trust.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;EAOtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAIhF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAI1D,eAAO,MAAM,kBAAkB,0EAI7B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEhE,gDAAgD;AAChD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,oDAAoD;AACpD,eAAO,MAAM,yBAAyB,MAAO,CAAC;AAE9C,8BAA8B;AAC9B,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,8BAA8B;AAC9B,eAAO,MAAM,mBAAmB,MAAM,CAAC"}

package/dist/types/trust.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+// --- Trust Balance (per domain) ---
+export const TrustBalanceSchema = z.object({
+    domain: z.string(),
+    balance: z.number().min(-100).max(100).default(0),
+    success_delta: z.number().default(3),
+    failure_delta: z.number().default(-10),
+});
+// --- Trust Override Log Entry ---
+export const TrustOverrideLogEntrySchema = z.object({
+    timestamp: z.string(),
+    override_type: z.enum(["trust_grant", "permanent_gate"]),
+    domain: z.string(),
+    target_category: z.string().nullable().default(null),
+    balance_before: z.number().nullable().default(null),
+    balance_after: z.number().nullable().default(null),
+});
+// --- Trust Store (all domains) ---
+export const TrustStoreSchema = z.object({
+    balances: z.record(z.string(), TrustBalanceSchema),
+    permanent_gates: z.record(z.string(), z.array(z.string())).default({}),
+    override_log: z.array(TrustOverrideLogEntrySchema).default([]),
+});
+// --- Action Quadrant ---
+export const ActionQuadrantEnum = z.enum([
+    "autonomous", // high trust + high confidence
+    "execute_with_confirm", // high trust + low confidence OR low trust + high confidence
+    "observe_and_propose", // low trust + low confidence
+]);
+/** High trust threshold: trust_balance >= 20 */
+export const HIGH_TRUST_THRESHOLD = 20;
+/** High confidence threshold: confidence >= 0.50 */
+export const HIGH_CONFIDENCE_THRESHOLD = 0.50;
+/** Trust change on success */
+export const TRUST_SUCCESS_DELTA = 3;
+/** Trust change on failure */
+export const TRUST_FAILURE_DELTA = -10;
+//# sourceMappingURL=trust.js.map

package/dist/types/trust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trust.js","sourceRoot":"","sources":["../../src/types/trust.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qCAAqC;AAErC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACpC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;CACvC,CAAC,CAAC;AAGH,mCAAmC;AAEnC,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;IACxD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACpD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACnD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACnD,CAAC,CAAC;AAGH,oCAAoC;AAEpC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC;IAClD,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACtE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC/D,CAAC,CAAC;AAGH,0BAA0B;AAE1B,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACvC,YAAY,EAAY,+BAA+B;IACvD,sBAAsB,EAAE,6DAA6D;IACrF,qBAAqB,EAAG,6BAA6B;CACtD,CAAC,CAAC;AAGH,gDAAgD;AAChD,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC,oDAAoD;AACpD,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAE9C,8BAA8B;AAC9B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC,8BAA8B;AAC9B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,EAAE,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,17 @@
+export declare class LLMError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare class AdapterError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare class ValidationError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare class StateError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAEA,qBAAa,QAAS,SAAQ,KAAK;aACY,KAAK,CAAC,EAAE,OAAO;gBAAhD,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAI7D;AAED,qBAAa,YAAa,SAAQ,KAAK;aACQ,KAAK,CAAC,EAAE,OAAO;gBAAhD,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAI7D;AAED,qBAAa,eAAgB,SAAQ,KAAK;aACK,KAAK,CAAC,EAAE,OAAO;gBAAhD,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAI7D;AAED,qBAAa,UAAW,SAAQ,KAAK;aACU,KAAK,CAAC,EAAE,OAAO;gBAAhD,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAI7D"}

package/dist/utils/errors.js

@@ -0,0 +1,34 @@
+// ─── Custom Error Classes ───
+export class LLMError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'LLMError';
+    }
+}
+export class AdapterError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'AdapterError';
+    }
+}
+export class ValidationError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'ValidationError';
+    }
+}
+export class StateError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'StateError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,MAAM,OAAO,QAAS,SAAQ,KAAK;IACY;IAA7C,YAAY,OAAe,EAAkB,KAAe;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAU;QAE1D,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,KAAK;IACQ;IAA7C,YAAY,OAAe,EAAkB,KAAe;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAU;QAE1D,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACK;IAA7C,YAAY,OAAe,EAAkB,KAAe;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAU;QAE1D,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,KAAK;IACU;IAA7C,YAAY,OAAe,EAAkB,KAAe;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAU;QAE1D,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF"}

package/dist/utils/json-io.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+/**
+ * Write data to a JSON file atomically (write to .tmp, then rename).
+ * Creates parent directories as needed.
+ */
+export declare function writeJsonFileAtomic(filePath: string, data: unknown): Promise<void>;
+/**
+ * Read and parse a JSON file asynchronously.
+ * Returns null on ENOENT or invalid JSON (does not throw).
+ */
+export declare function readJsonFileOrNull<T = unknown>(filePath: string): Promise<T | null>;
+/**
+ * Read, parse, and validate a JSON file against a Zod schema.
+ * Returns null on ENOENT, invalid JSON, or schema validation failure (does not throw).
+ */
+export declare function readJsonFileWithSchema<T>(filePath: string, schema: z.ZodType<T>): Promise<T | null>;
+/**
+ * Read and parse a JSON file asynchronously.
+ * Throws if the file does not exist or contains invalid JSON.
+ * @deprecated Prefer readJsonFileOrNull
+ */
+export declare function readJsonFile<T>(filePath: string): Promise<T>;
+/**
+ * Write data to a JSON file asynchronously with 2-space indent.
+ * @deprecated Prefer writeJsonFileAtomic
+ */
+export declare function writeJsonFile(filePath: string, data: unknown): Promise<void>;
+//# sourceMappingURL=json-io.d.ts.map

package/dist/utils/json-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-io.d.ts","sourceRoot":"","sources":["../../src/utils/json-io.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAcxF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAOzF;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAKnB;AAKD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAGlE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF"}

package/dist/utils/json-io.js

@@ -0,0 +1,71 @@
+// ─── JSON IO Utilities ───
+//
+// Shared helpers for reading and writing JSON files.
+// Async versions (writeJsonFileAtomic, readJsonFileOrNull, readJsonFileWithSchema)
+// are preferred over the legacy sync-style async functions below.
+import * as fsp from "node:fs/promises";
+import { dirname } from "node:path";
+/**
+ * Write data to a JSON file atomically (write to .tmp, then rename).
+ * Creates parent directories as needed.
+ */
+export async function writeJsonFileAtomic(filePath, data) {
+    await fsp.mkdir(dirname(filePath), { recursive: true });
+    const tmpPath = filePath + ".tmp";
+    try {
+        await fsp.writeFile(tmpPath, JSON.stringify(data, null, 2), "utf-8");
+        await fsp.rename(tmpPath, filePath);
+    }
+    catch (err) {
+        try {
+            await fsp.unlink(tmpPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        throw err;
+    }
+}
+/**
+ * Read and parse a JSON file asynchronously.
+ * Returns null on ENOENT or invalid JSON (does not throw).
+ */
+export async function readJsonFileOrNull(filePath) {
+    try {
+        const content = await fsp.readFile(filePath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read, parse, and validate a JSON file against a Zod schema.
+ * Returns null on ENOENT, invalid JSON, or schema validation failure (does not throw).
+ */
+export async function readJsonFileWithSchema(filePath, schema) {
+    const raw = await readJsonFileOrNull(filePath);
+    if (raw === null)
+        return null;
+    const result = schema.safeParse(raw);
+    return result.success ? result.data : null;
+}
+// ─── Legacy helpers (async, kept for backward compatibility) ───
+// Prefer the atomic/null-safe versions above for new code.
+/**
+ * Read and parse a JSON file asynchronously.
+ * Throws if the file does not exist or contains invalid JSON.
+ * @deprecated Prefer readJsonFileOrNull
+ */
+export async function readJsonFile(filePath) {
+    const content = await fsp.readFile(filePath, "utf-8");
+    return JSON.parse(content);
+}
+/**
+ * Write data to a JSON file asynchronously with 2-space indent.
+ * @deprecated Prefer writeJsonFileAtomic
+ */
+export async function writeJsonFile(filePath, data) {
+    await fsp.writeFile(filePath, JSON.stringify(data, null, 2), "utf-8");
+}
+//# sourceMappingURL=json-io.js.map

package/dist/utils/json-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-io.js","sourceRoot":"","sources":["../../src/utils/json-io.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,qDAAqD;AACrD,mFAAmF;AACnF,kEAAkE;AAElE,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAAgB,EAAE,IAAa;IACvE,MAAM,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACrE,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAc,QAAgB;IACpE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAgB,EAChB,MAAoB;IAEpB,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,kEAAkE;AAClE,2DAA2D;AAE3D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,QAAgB;IACpD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB,EAAE,IAAa;IACjE,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Returns the Conatus base directory.
+ * Defaults to ~/.conatus; can be overridden via CONATUS_HOME env var.
+ */
+export declare function getMotivaDirPath(): string;
+export declare function getGoalsDir(base?: string): string;
+export declare function getEventsDir(base?: string): string;
+export declare function getArchiveDir(base?: string): string;
+export declare function getPluginsDir(base?: string): string;
+export declare function getLogsDir(base?: string): string;
+export declare function getDatasourcesDir(base?: string): string;
+export declare function getScheduleDir(base?: string): string;
+export declare function getReportsDir(base?: string): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/utils/paths.js

@@ -0,0 +1,38 @@
+// ─── Conatus Path Utilities ───
+//
+// Centralizes ~/.conatus path construction.
+// CONATUS_HOME env var overrides the default ~/.conatus location.
+import * as os from "node:os";
+import * as path from "node:path";
+/**
+ * Returns the Conatus base directory.
+ * Defaults to ~/.conatus; can be overridden via CONATUS_HOME env var.
+ */
+export function getMotivaDirPath() {
+    return process.env["CONATUS_HOME"] ?? path.join(os.homedir(), ".conatus");
+}
+export function getGoalsDir(base) {
+    return path.join(base ?? getMotivaDirPath(), "goals");
+}
+export function getEventsDir(base) {
+    return path.join(base ?? getMotivaDirPath(), "events");
+}
+export function getArchiveDir(base) {
+    return path.join(base ?? getMotivaDirPath(), "archive");
+}
+export function getPluginsDir(base) {
+    return path.join(base ?? getMotivaDirPath(), "plugins");
+}
+export function getLogsDir(base) {
+    return path.join(base ?? getMotivaDirPath(), "logs");
+}
+export function getDatasourcesDir(base) {
+    return path.join(base ?? getMotivaDirPath(), "datasources");
+}
+export function getScheduleDir(base) {
+    return path.join(base ?? getMotivaDirPath(), "schedule");
+}
+export function getReportsDir(base) {
+    return path.join(base ?? getMotivaDirPath(), "reports");
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,EAAE;AACF,4CAA4C;AAC5C,kEAAkE;AAElE,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,gBAAgB,EAAE,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,gBAAgB,EAAE,EAAE,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,gBAAgB,EAAE,EAAE,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,gBAAgB,EAAE,EAAE,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,gBAAgB,EAAE,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,gBAAgB,EAAE,EAAE,aAAa,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,gBAAgB,EAAE,EAAE,UAAU,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,gBAAgB,EAAE,EAAE,SAAS,CAAC,CAAC;AAC1D,CAAC"}

package/dist/utils/sleep.d.ts

@@ -0,0 +1,2 @@
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/utils/sleep.js

@@ -0,0 +1,4 @@
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=sleep.js.map

package/dist/utils/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/vector-index.d.ts

@@ -0,0 +1,39 @@
+import type { IEmbeddingClient } from "./embedding-client.js";
+import type { EmbeddingEntry, VectorSearchResult } from "./types/embedding.js";
+export declare class VectorIndex {
+    private readonly indexPath;
+    private readonly embeddingClient;
+    private readonly entries;
+    constructor(indexPath: string, embeddingClient: IEmbeddingClient);
+    /**
+     * Embed text and add an entry to the index.
+     */
+    add(id: string, text: string, metadata?: Record<string, unknown>): Promise<EmbeddingEntry>;
+    /**
+     * Embed a query string and search for the most similar entries.
+     */
+    search(query: string, topK?: number, threshold?: number): Promise<VectorSearchResult[]>;
+    /**
+     * Search using a pre-computed vector.
+     */
+    searchByVector(queryVector: number[], topK?: number, threshold?: number): VectorSearchResult[];
+    /**
+     * Remove an entry by id. Returns true if removed, false if not found.
+     */
+    remove(id: string): boolean;
+    /**
+     * Return the number of entries in the index.
+     */
+    get size(): number;
+    /**
+     * Retrieve a single entry by id.
+     */
+    getEntry(id: string): EmbeddingEntry | undefined;
+    /**
+     * Remove all entries from the index and persist.
+     */
+    clear(): void;
+    private _load;
+    private _save;
+}
+//# sourceMappingURL=vector-index.d.ts.map

package/dist/vector-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-index.d.ts","sourceRoot":"","sources":["../src/vector-index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAI/E,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAJlC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;gBAG/C,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,gBAAgB;IAKpD;;OAEG;IACG,GAAG,CACP,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,OAAO,CAAC,cAAc,CAAC;IAe1B;;OAEG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAU,EAChB,SAAS,GAAE,MAAY,GACtB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAKhC;;OAEG;IACH,cAAc,CACZ,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,GAAE,MAAU,EAChB,SAAS,GAAE,MAAY,GACtB,kBAAkB,EAAE;IAmBvB;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAS3B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIhD;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,KAAK;IAcb,OAAO,CAAC,KAAK;CASd"}

package/dist/vector-index.js

@@ -0,0 +1,111 @@
+import * as fs from "fs";
+import * as path from "path";
+import { EmbeddingEntrySchema } from "./types/embedding.js";
+import { cosineSimilarity } from "./embedding-client.js";
+export class VectorIndex {
+    indexPath;
+    embeddingClient;
+    entries = new Map();
+    constructor(indexPath, embeddingClient) {
+        this.indexPath = indexPath;
+        this.embeddingClient = embeddingClient;
+        this._load();
+    }
+    /**
+     * Embed text and add an entry to the index.
+     */
+    async add(id, text, metadata = {}) {
+        const vector = await this.embeddingClient.embed(text);
+        const entry = EmbeddingEntrySchema.parse({
+            id,
+            text,
+            vector,
+            model: "embedding",
+            created_at: new Date().toISOString(),
+            metadata,
+        });
+        this.entries.set(id, entry);
+        this._save();
+        return entry;
+    }
+    /**
+     * Embed a query string and search for the most similar entries.
+     */
+    async search(query, topK = 5, threshold = 0.0) {
+        const queryVector = await this.embeddingClient.embed(query);
+        return this.searchByVector(queryVector, topK, threshold);
+    }
+    /**
+     * Search using a pre-computed vector.
+     */
+    searchByVector(queryVector, topK = 5, threshold = 0.0) {
+        const results = [];
+        for (const entry of this.entries.values()) {
+            const similarity = cosineSimilarity(queryVector, entry.vector);
+            if (similarity >= threshold) {
+                results.push({
+                    id: entry.id,
+                    text: entry.text,
+                    similarity,
+                    metadata: entry.metadata,
+                });
+            }
+        }
+        results.sort((a, b) => b.similarity - a.similarity);
+        return results.slice(0, topK);
+    }
+    /**
+     * Remove an entry by id. Returns true if removed, false if not found.
+     */
+    remove(id) {
+        const existed = this.entries.has(id);
+        if (existed) {
+            this.entries.delete(id);
+            this._save();
+        }
+        return existed;
+    }
+    /**
+     * Return the number of entries in the index.
+     */
+    get size() {
+        return this.entries.size;
+    }
+    /**
+     * Retrieve a single entry by id.
+     */
+    getEntry(id) {
+        return this.entries.get(id);
+    }
+    /**
+     * Remove all entries from the index and persist.
+     */
+    clear() {
+        this.entries.clear();
+        this._save();
+    }
+    _load() {
+        if (!fs.existsSync(this.indexPath))
+            return;
+        try {
+            const raw = fs.readFileSync(this.indexPath, "utf-8");
+            const parsed = JSON.parse(raw);
+            for (const item of parsed) {
+                const entry = EmbeddingEntrySchema.parse(item);
+                this.entries.set(entry.id, entry);
+            }
+        }
+        catch {
+            // Corrupt or empty file — start fresh
+        }
+    }
+    _save() {
+        const dir = path.dirname(this.indexPath);
+        fs.mkdirSync(dir, { recursive: true });
+        const data = JSON.stringify(Array.from(this.entries.values()), null, 2);
+        const tmpPath = `${this.indexPath}.tmp`;
+        fs.writeFileSync(tmpPath, data, "utf-8");
+        fs.renameSync(tmpPath, this.indexPath);
+    }
+}
+//# sourceMappingURL=vector-index.js.map