@thoughtflow/core 0.1.2

package/dist/quick/core-preset.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCoreTools = createCoreTools;
+const in_memory_adapter_1 = require("../storage/in-memory.adapter");
+const problem_tree_tool_1 = require("../tools/planning/problem-tree.tool");
+const adaptive_lookup_tool_1 = require("../tools/planning/adaptive-lookup.tool");
+const solve_complex_tool_1 = require("../tools/planning/solve-complex.tool");
+const comparative_analysis_tool_1 = require("../tools/neural/comparative-analysis.tool");
+function createCoreTools(config = {}) {
+    const storage = config.storage ?? new in_memory_adapter_1.InMemoryAdapter();
+    const codebaseKnowledge = config.codebaseKnowledge ?? [];
+    const lookupTool = new adaptive_lookup_tool_1.AdaptiveLookupTool({
+        storage,
+        codebaseKnowledge,
+        ...(config.adaptiveLookupConfig ?? {}),
+    });
+    const solveComplexTool = new solve_complex_tool_1.SolveComplexTool({
+        lookupTool,
+        storage: config.treeStorage,
+        ...(config.solveComplexConfig ?? {}),
+    });
+    const problemTreeTool = new problem_tree_tool_1.ProblemTreeTool({ storage: config.treeStorage });
+    const comparativeTool = new comparative_analysis_tool_1.ComparativeAnalysisTool(config.comparativeConfig ?? {});
+    const tools = [
+        problemTreeTool,
+        lookupTool,
+        solveComplexTool,
+        comparativeTool,
+    ];
+    return {
+        tools,
+        problemTreeTool,
+        lookupTool,
+        solveComplexTool,
+        comparativeTool,
+    };
+}
+//# sourceMappingURL=core-preset.js.map

package/dist/quick/core-preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-preset.js","sourceRoot":"","sources":["../../src/quick/core-preset.ts"],"names":[],"mappings":";;AA+BA,0CA+BC;AA7DD,oEAA+D;AAC/D,2EAAsE;AACtE,iFAAkG;AAClG,6EAA4F;AAC5F,yFAA+G;AA0B/G,SAAgB,eAAe,CAAC,SAA2B,EAAE;IAC3D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,IAAI,mCAAe,EAAkB,CAAC;IACxE,MAAM,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC;IAEzD,MAAM,UAAU,GAAG,IAAI,yCAAkB,CAAC;QACxC,OAAO;QACP,iBAAiB;QACjB,GAAG,CAAC,MAAM,CAAC,oBAAoB,IAAI,EAAE,CAAC;KACvC,CAAC,CAAC;IACH,MAAM,gBAAgB,GAAG,IAAI,qCAAgB,CAAC;QAC5C,UAAU;QACV,OAAO,EAAE,MAAM,CAAC,WAAW;QAC3B,GAAG,CAAC,MAAM,CAAC,kBAAkB,IAAI,EAAE,CAAC;KACrC,CAAC,CAAC;IACH,MAAM,eAAe,GAAG,IAAI,mCAAe,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7E,MAAM,eAAe,GAAG,IAAI,mDAAuB,CAAC,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAEpF,MAAM,KAAK,GAAuB;QAChC,eAAe;QACf,UAAU;QACV,gBAAgB;QAChB,eAAe;KAChB,CAAC;IAEF,OAAO;QACL,KAAK;QACL,eAAe;QACf,UAAU;QACV,gBAAgB;QAChB,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/dist/quick/demo-runtime-config.d.ts

@@ -0,0 +1,99 @@
+/**
+ * DemoRuntimeConfig — shared utility for all demo and scenario scripts.
+ *
+ * Reads configuration from environment variables with sensible defaults so
+ * that individual demo files never need to hardcode host/model strings.
+ * Overrides passed to `loadDemoRuntimeConfig()` take the highest priority.
+ *
+ * Standard env vars:
+ *   OLLAMA_HOST or LLM_BASE_URL  — LLM host URL
+ *   LLM_MODEL                    — model name
+ *   DEMO_TIMEOUT_MS              — per-call timeout (default 120 000)
+ *   DEMO_MAX_ITERATIONS          — max iterations per sendPrompt (default 25)
+ *   DEMO_PROFILE                 — "smoke" | "e2e" | "showcase" | "playground"
+ *   DEMO_STRICTNESS              — "strict" | "balanced" | "permissive"
+ *   DEMO_DEBUG                   — "1" or "true" for verbose debug
+ *   DEMO_RUN_ID                  — custom run identifier for artifact tracking
+ *   DEMO_ROOT_DIR                — workspace root directory
+ *
+ * Standard exit codes (use these in all demo scripts):
+ *   0 — success
+ *   1 — functional failure (assertion, LLM, tool)
+ *   2 — infrastructure / preflight failure (no LLM server, bad config)
+ */
+export type DemoStrictness = "strict" | "balanced" | "permissive";
+export type DemoProfile = "smoke" | "e2e" | "showcase" | "playground";
+export interface DemoRuntimeConfig {
+    /** LLM host URL. Resolved from OLLAMA_HOST or LLM_BASE_URL. */
+    host: string;
+    /** Model name. Resolved from LLM_MODEL. */
+    model: string;
+    /** Per-call timeout in milliseconds. Resolved from DEMO_TIMEOUT_MS. Default: 120 000. */
+    timeoutMs: number;
+    /** Maximum iterations per sendPrompt call. Resolved from DEMO_MAX_ITERATIONS. Default: 25. */
+    maxIterations: number;
+    /** Demo quality profile. Resolved from DEMO_PROFILE. Default: "showcase". */
+    profile: DemoProfile;
+    /** Validation/gate strictness. Resolved from DEMO_STRICTNESS. Default: "balanced". */
+    strictness: DemoStrictness;
+    /** Enable verbose debug output. Resolved from DEMO_DEBUG. Default: false. */
+    debug: boolean;
+    /** Run identifier for artifact grouping. Auto-generated if not set via DEMO_RUN_ID. */
+    runId: string;
+    /** Optional workspace root directory. Resolved from DEMO_ROOT_DIR. */
+    rootDir?: string;
+}
+export type DemoRuntimeConfigOverrides = Partial<DemoRuntimeConfig>;
+/**
+ * Load demo runtime configuration from environment variables with optional
+ * field-level overrides.
+ *
+ * Priority: explicit override > environment variable > default.
+ *
+ * @example
+ * const cfg = loadDemoRuntimeConfig({ model: "llama3.2", profile: "smoke" });
+ * const conv = new Conversation({
+ *   host: cfg.host,
+ *   model: cfg.model,
+ *   maxIterationsPerRun: cfg.maxIterations,
+ *   debugLevel: cfg.debug ? "info" : "off",
+ * });
+ */
+export declare function loadDemoRuntimeConfig(overrides?: DemoRuntimeConfigOverrides): DemoRuntimeConfig;
+/**
+ * Quality gate thresholds per demo profile (Balanced default).
+ * Use these in CI and smoke scripts to enforce measurable exit criteria.
+ */
+export interface DemoQualityGates {
+    /** Maximum wall-clock milliseconds for the full demo. */
+    maxWallMs: number;
+    /** Minimum number of hard assertions required to pass. */
+    minHardAssertions: number;
+    /** Whether only exit codes 0 (pass) and 1 (fail) are allowed. */
+    strictExitCodes: boolean;
+    /** Whether a run manifest JSON artifact must be produced. */
+    requireManifest: boolean;
+}
+/** Return quality gate thresholds for the given demo profile. */
+export declare function getDemoQualityGates(profile: DemoProfile): DemoQualityGates;
+export interface DemoRunManifest {
+    runId: string;
+    profile: DemoProfile;
+    strictness: DemoStrictness;
+    model: string;
+    host: string;
+    startedAt: string;
+    finishedAt?: string;
+    durationMs?: number;
+    exitCode?: 0 | 1 | 2;
+    hardAssertionsPassed: number;
+    hardAssertionsFailed: number;
+    softWarnings: number;
+    toolCallsTotal: number;
+    toolCallsFailed: number;
+    artifacts: string[];
+    notes?: string;
+}
+/** Create an initial manifest with start timestamp. */
+export declare function createDemoRunManifest(cfg: DemoRuntimeConfig): DemoRunManifest;
+//# sourceMappingURL=demo-runtime-config.d.ts.map

package/dist/quick/demo-runtime-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-runtime-config.d.ts","sourceRoot":"","sources":["../../src/quick/demo-runtime-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;AAClE,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU,GAAG,YAAY,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,yFAAyF;IACzF,SAAS,EAAE,MAAM,CAAC;IAClB,8FAA8F;IAC9F,aAAa,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,OAAO,EAAE,WAAW,CAAC;IACrB,sFAAsF;IACtF,UAAU,EAAE,cAAc,CAAC;IAC3B,6EAA6E;IAC7E,KAAK,EAAE,OAAO,CAAC;IACf,uFAAuF;IACvF,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,0BAA0B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEpE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,GAAE,0BAA+B,GAAG,iBAAiB,CA8CnG;AAID;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,eAAe,EAAE,OAAO,CAAC;IACzB,6DAA6D;IAC7D,eAAe,EAAE,OAAO,CAAC;CAC1B;AASD,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,gBAAgB,CAE1E;AAID,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,cAAc,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,uDAAuD;AACvD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,iBAAiB,GAAG,eAAe,CAe7E"}

package/dist/quick/demo-runtime-config.js

@@ -0,0 +1,115 @@
+"use strict";
+/**
+ * DemoRuntimeConfig — shared utility for all demo and scenario scripts.
+ *
+ * Reads configuration from environment variables with sensible defaults so
+ * that individual demo files never need to hardcode host/model strings.
+ * Overrides passed to `loadDemoRuntimeConfig()` take the highest priority.
+ *
+ * Standard env vars:
+ *   OLLAMA_HOST or LLM_BASE_URL  — LLM host URL
+ *   LLM_MODEL                    — model name
+ *   DEMO_TIMEOUT_MS              — per-call timeout (default 120 000)
+ *   DEMO_MAX_ITERATIONS          — max iterations per sendPrompt (default 25)
+ *   DEMO_PROFILE                 — "smoke" | "e2e" | "showcase" | "playground"
+ *   DEMO_STRICTNESS              — "strict" | "balanced" | "permissive"
+ *   DEMO_DEBUG                   — "1" or "true" for verbose debug
+ *   DEMO_RUN_ID                  — custom run identifier for artifact tracking
+ *   DEMO_ROOT_DIR                — workspace root directory
+ *
+ * Standard exit codes (use these in all demo scripts):
+ *   0 — success
+ *   1 — functional failure (assertion, LLM, tool)
+ *   2 — infrastructure / preflight failure (no LLM server, bad config)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadDemoRuntimeConfig = loadDemoRuntimeConfig;
+exports.getDemoQualityGates = getDemoQualityGates;
+exports.createDemoRunManifest = createDemoRunManifest;
+/**
+ * Load demo runtime configuration from environment variables with optional
+ * field-level overrides.
+ *
+ * Priority: explicit override > environment variable > default.
+ *
+ * @example
+ * const cfg = loadDemoRuntimeConfig({ model: "llama3.2", profile: "smoke" });
+ * const conv = new Conversation({
+ *   host: cfg.host,
+ *   model: cfg.model,
+ *   maxIterationsPerRun: cfg.maxIterations,
+ *   debugLevel: cfg.debug ? "info" : "off",
+ * });
+ */
+function loadDemoRuntimeConfig(overrides = {}) {
+    const host = overrides.host ??
+        process.env["OLLAMA_HOST"] ??
+        process.env["LLM_BASE_URL"] ??
+        "http://localhost:11434";
+    const model = overrides.model ??
+        process.env["LLM_MODEL"] ??
+        "llama3.2";
+    const timeoutMs = overrides.timeoutMs ??
+        parsePositiveInt(process.env["DEMO_TIMEOUT_MS"]) ??
+        120_000;
+    const maxIterations = overrides.maxIterations ??
+        parsePositiveInt(process.env["DEMO_MAX_ITERATIONS"]) ??
+        25;
+    const profile = overrides.profile ??
+        parseProfile(process.env["DEMO_PROFILE"]) ??
+        "showcase";
+    const strictness = overrides.strictness ??
+        parseStrictness(process.env["DEMO_STRICTNESS"]) ??
+        "balanced";
+    const debug = overrides.debug ??
+        (process.env["DEMO_DEBUG"] === "1" || process.env["DEMO_DEBUG"] === "true");
+    const runId = overrides.runId ??
+        process.env["DEMO_RUN_ID"] ??
+        `demo-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    const rootDir = overrides.rootDir ??
+        process.env["DEMO_ROOT_DIR"];
+    return { host, model, timeoutMs, maxIterations, profile, strictness, debug, runId, rootDir };
+}
+const GATE_PROFILES = {
+    smoke: { maxWallMs: 2 * 60_000, minHardAssertions: 3, strictExitCodes: true, requireManifest: true },
+    e2e: { maxWallMs: 10 * 60_000, minHardAssertions: 3, strictExitCodes: true, requireManifest: true },
+    showcase: { maxWallMs: 15 * 60_000, minHardAssertions: 1, strictExitCodes: false, requireManifest: false },
+    playground: { maxWallMs: 30 * 60_000, minHardAssertions: 0, strictExitCodes: false, requireManifest: false },
+};
+/** Return quality gate thresholds for the given demo profile. */
+function getDemoQualityGates(profile) {
+    return GATE_PROFILES[profile];
+}
+/** Create an initial manifest with start timestamp. */
+function createDemoRunManifest(cfg) {
+    return {
+        runId: cfg.runId,
+        profile: cfg.profile,
+        strictness: cfg.strictness,
+        model: cfg.model,
+        host: cfg.host,
+        startedAt: new Date().toISOString(),
+        hardAssertionsPassed: 0,
+        hardAssertionsFailed: 0,
+        softWarnings: 0,
+        toolCallsTotal: 0,
+        toolCallsFailed: 0,
+        artifacts: [],
+    };
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function parsePositiveInt(value) {
+    if (!value)
+        return undefined;
+    const n = parseInt(value, 10);
+    return Number.isFinite(n) && n > 0 ? n : undefined;
+}
+function parseProfile(value) {
+    const valid = ["smoke", "e2e", "showcase", "playground"];
+    return valid.includes(value) ? value : undefined;
+}
+function parseStrictness(value) {
+    const valid = ["strict", "balanced", "permissive"];
+    return valid.includes(value) ? value : undefined;
+}
+//# sourceMappingURL=demo-runtime-config.js.map

package/dist/quick/demo-runtime-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-runtime-config.js","sourceRoot":"","sources":["../../src/quick/demo-runtime-config.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;AA2CH,sDA8CC;AA2BD,kDAEC;AAwBD,sDAeC;AAjID;;;;;;;;;;;;;;GAcG;AACH,SAAgB,qBAAqB,CAAC,YAAwC,EAAE;IAC9E,MAAM,IAAI,GACR,SAAS,CAAC,IAAI;QACd,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAC3B,wBAAwB,CAAC;IAE3B,MAAM,KAAK,GACT,SAAS,CAAC,KAAK;QACf,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QACxB,UAAU,CAAC;IAEb,MAAM,SAAS,GACb,SAAS,CAAC,SAAS;QACnB,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAChD,OAAO,CAAC;IAEV,MAAM,aAAa,GACjB,SAAS,CAAC,aAAa;QACvB,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACpD,EAAE,CAAC;IAEL,MAAM,OAAO,GACX,SAAS,CAAC,OAAO;QACjB,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACzC,UAAU,CAAC;IAEb,MAAM,UAAU,GACd,SAAS,CAAC,UAAU;QACpB,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/C,UAAU,CAAC;IAEb,MAAM,KAAK,GACT,SAAS,CAAC,KAAK;QACf,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,MAAM,CAAC,CAAC;IAE9E,MAAM,KAAK,GACT,SAAS,CAAC,KAAK;QACf,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QAC1B,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAEjE,MAAM,OAAO,GACX,SAAS,CAAC,OAAO;QACjB,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAE/B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC/F,CAAC;AAmBD,MAAM,aAAa,GAA0C;IAC3D,KAAK,EAAO,EAAE,SAAS,EAAG,CAAC,GAAG,MAAM,EAAE,iBAAiB,EAAE,CAAC,EAAE,eAAe,EAAE,IAAI,EAAG,eAAe,EAAE,IAAI,EAAG;IAC5G,GAAG,EAAS,EAAE,SAAS,EAAE,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,CAAC,EAAE,eAAe,EAAE,IAAI,EAAG,eAAe,EAAE,IAAI,EAAG;IAC5G,QAAQ,EAAI,EAAE,SAAS,EAAE,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE;IAC5G,UAAU,EAAE,EAAE,SAAS,EAAE,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE;CAC7G,CAAC;AAEF,iEAAiE;AACjE,SAAgB,mBAAmB,CAAC,OAAoB;IACtD,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAuBD,uDAAuD;AACvD,SAAgB,qBAAqB,CAAC,GAAsB;IAC1D,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,oBAAoB,EAAE,CAAC;QACvB,oBAAoB,EAAE,CAAC;QACvB,YAAY,EAAE,CAAC;QACf,cAAc,EAAE,CAAC;QACjB,eAAe,EAAE,CAAC;QAClB,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF,SAAS,gBAAgB,CAAC,KAAyB;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC;AAED,SAAS,YAAY,CAAC,KAAyB;IAC7C,MAAM,KAAK,GAA2B,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;IACjF,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAoB,CAAC,CAAC,CAAC,CAAE,KAAqB,CAAC,CAAC,CAAC,SAAS,CAAC;AACnF,CAAC;AAED,SAAS,eAAe,CAAC,KAAyB;IAChD,MAAM,KAAK,GAA8B,CAAC,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;IAC9E,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAuB,CAAC,CAAC,CAAC,CAAE,KAAwB,CAAC,CAAC,CAAC,SAAS,CAAC;AACzF,CAAC"}

package/dist/skills/skill-loader.class.d.ts

@@ -0,0 +1,10 @@
+import { SkillDefinition } from "../contracts";
+export declare class SkillLoader {
+    private readonly skillsDir;
+    constructor(skillsDir: string);
+    loadAll(): SkillDefinition[];
+    loadByNames(names: string[]): SkillDefinition[];
+    private loadOne;
+    private parseMetadata;
+}
+//# sourceMappingURL=skill-loader.class.d.ts.map

package/dist/skills/skill-loader.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.class.d.ts","sourceRoot":"","sources":["../../src/skills/skill-loader.class.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM;IAE9C,OAAO,IAAI,eAAe,EAAE;IAK5B,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,eAAe,EAAE;IAM/C,OAAO,CAAC,OAAO;IA0Bf,OAAO,CAAC,aAAa;CAWtB"}

package/dist/skills/skill-loader.class.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillLoader = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+class SkillLoader {
+    skillsDir;
+    constructor(skillsDir) {
+        this.skillsDir = skillsDir;
+    }
+    loadAll() {
+        const files = (0, node_fs_1.readdirSync)(this.skillsDir).filter((name) => name.endsWith(".md"));
+        return files.map((file) => this.loadOne(file));
+    }
+    loadByNames(names) {
+        const available = this.loadAll();
+        const wanted = new Set(names);
+        return available.filter((skill) => wanted.has(skill.name));
+    }
+    loadOne(fileName) {
+        const fullPath = (0, node_path_1.resolve)(this.skillsDir, fileName);
+        const text = (0, node_fs_1.readFileSync)(fullPath, "utf-8");
+        const lines = text.split("\n");
+        if (lines[0]?.trim() === "---") {
+            const end = lines.findIndex((line, index) => index > 0 && line.trim() === "---");
+            if (end > 0) {
+                const metaRaw = lines.slice(1, end);
+                const content = lines.slice(end + 1).join("\n").trim();
+                const metadata = this.parseMetadata(metaRaw);
+                return {
+                    name: metadata.name ?? fileName.replace(/\.md$/, ""),
+                    description: metadata.description,
+                    tags: metadata.tags ? metadata.tags.split(",").map((v) => v.trim()).filter(Boolean) : undefined,
+                    content
+                };
+            }
+        }
+        return {
+            name: fileName.replace(/\.md$/, ""),
+            content: text.trim()
+        };
+    }
+    parseMetadata(lines) {
+        const out = {};
+        for (const line of lines) {
+            const [key, ...rest] = line.split(":");
+            if (!key || rest.length === 0) {
+                continue;
+            }
+            out[key.trim()] = rest.join(":").trim();
+        }
+        return out;
+    }
+}
+exports.SkillLoader = SkillLoader;
+//# sourceMappingURL=skill-loader.class.js.map

package/dist/skills/skill-loader.class.js.map

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

package/dist/storage/in-memory.adapter.d.ts

@@ -0,0 +1,33 @@
+import { IStorageAdapter, StorageListOptions, StorageSearchOptions } from "../contracts/storage.types";
+/**
+ * InMemoryAdapter<T>
+ *
+ * Default storage implementation — zero dependencies, zero configuration.
+ * Data lives in a Map and is lost when the process exits.
+ *
+ * Supports:
+ *  - Full CRUD
+ *  - list() with filter, orderBy, limit, offset
+ *  - search() with full-text query (content + title), tags AND match,
+ *    category, sessionId, date range, limit, offset
+ *  - count() with optional filter
+ *
+ * To persist data, replace this with your own adapter implementing IStorageAdapter.
+ */
+export declare class InMemoryAdapter<T extends {
+    id: string;
+}> implements IStorageAdapter<T> {
+    protected readonly store: Map<string, T>;
+    create(item: Omit<T, "id">): Promise<T>;
+    read(id: string): Promise<T | null>;
+    update(id: string, patch: Partial<T>): Promise<T>;
+    delete(id: string): Promise<void>;
+    list(options?: StorageListOptions<T>): Promise<T[]>;
+    search(options: StorageSearchOptions): Promise<T[]>;
+    count(filter?: Partial<T>): Promise<number>;
+    initialize(): Promise<void>;
+    dispose(): Promise<void>;
+    /** Expose raw store size — useful for tests. */
+    get size(): number;
+}
+//# sourceMappingURL=in-memory.adapter.d.ts.map

package/dist/storage/in-memory.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.adapter.d.ts","sourceRoot":"","sources":["../../src/storage/in-memory.adapter.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CACnD,YAAW,eAAe,CAAC,CAAC,CAAC;IAE7B,SAAS,CAAC,QAAQ,CAAC,KAAK,iBAAwB;IAI1C,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAOvC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAInC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAajD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjC,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAmCnD,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IA8DnD,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,gDAAgD;IAChD,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/storage/in-memory.adapter.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryAdapter = void 0;
+const crypto_1 = require("crypto");
+/**
+ * InMemoryAdapter<T>
+ *
+ * Default storage implementation — zero dependencies, zero configuration.
+ * Data lives in a Map and is lost when the process exits.
+ *
+ * Supports:
+ *  - Full CRUD
+ *  - list() with filter, orderBy, limit, offset
+ *  - search() with full-text query (content + title), tags AND match,
+ *    category, sessionId, date range, limit, offset
+ *  - count() with optional filter
+ *
+ * To persist data, replace this with your own adapter implementing IStorageAdapter.
+ */
+class InMemoryAdapter {
+    store = new Map();
+    // ── CRUD ────────────────────────────────────────────────────────────────
+    async create(item) {
+        const id = (0, crypto_1.randomUUID)();
+        const entry = { ...item, id };
+        this.store.set(id, entry);
+        return { ...entry };
+    }
+    async read(id) {
+        return this.store.get(id) ?? null;
+    }
+    async update(id, patch) {
+        const existing = this.store.get(id);
+        if (!existing) {
+            throw new Error(`InMemoryAdapter: item '${id}' not found`);
+        }
+        if (patch && "id" in patch) {
+            // id is immutable — silently ignore
+        }
+        const updated = { ...existing, ...patch, id };
+        this.store.set(id, updated);
+        return { ...updated };
+    }
+    async delete(id) {
+        this.store.delete(id);
+    }
+    // ── Query ────────────────────────────────────────────────────────────────
+    async list(options) {
+        let result = Array.from(this.store.values());
+        if (options?.filter) {
+            const filter = options.filter;
+            result = result.filter((item) => Object.keys(filter).every((key) => filter[key] === undefined || item[key] === filter[key]));
+        }
+        if (options?.orderBy) {
+            const key = options.orderBy;
+            const dir = options.order === "desc" ? -1 : 1;
+            result = result.sort((a, b) => {
+                const av = a[key];
+                const bv = b[key];
+                if (av === bv)
+                    return 0;
+                if (av == null)
+                    return dir;
+                if (bv == null)
+                    return -dir;
+                return av < bv ? -dir : dir;
+            });
+        }
+        if (options?.offset !== undefined) {
+            result = result.slice(options.offset);
+        }
+        if (options?.limit !== undefined) {
+            result = result.slice(0, options.limit);
+        }
+        return result;
+    }
+    async search(options) {
+        let result = Array.from(this.store.values());
+        const item = result[0];
+        // Full-text: matches `content` or `title` fields if they exist
+        if (options.query) {
+            const q = options.query.toLowerCase();
+            result = result.filter((entry) => {
+                const e = entry;
+                const content = typeof e["content"] === "string" ? e["content"].toLowerCase() : "";
+                const title = typeof e["title"] === "string" ? e["title"].toLowerCase() : "";
+                return content.includes(q) || title.includes(q);
+            });
+        }
+        // Tags: AND match — entry must have ALL requested tags
+        if (options.tags && options.tags.length > 0) {
+            const required = options.tags;
+            result = result.filter((entry) => {
+                const e = entry;
+                const entryTags = Array.isArray(e["tags"]) ? e["tags"] : [];
+                return required.every((tag) => entryTags.includes(tag));
+            });
+        }
+        // Category filter
+        if (options.category !== undefined) {
+            result = result.filter((entry) => {
+                const e = entry;
+                return e["category"] === options.category;
+            });
+        }
+        // Session filter
+        if (options.sessionId !== undefined) {
+            result = result.filter((entry) => {
+                const e = entry;
+                return e["sessionId"] === options.sessionId;
+            });
+        }
+        if (options.from || options.to) {
+            result = result.filter((entry) => {
+                const e = entry;
+                const ts = typeof e["createdAt"] === "string" ? new Date(e["createdAt"]).getTime() : 0;
+                if (isNaN(ts))
+                    return false;
+                if (options.from && ts < options.from.getTime())
+                    return false;
+                if (options.to && ts > options.to.getTime())
+                    return false;
+                return true;
+            });
+        }
+        if (options.offset !== undefined) {
+            result = result.slice(options.offset);
+        }
+        if (options.limit !== undefined) {
+            result = result.slice(0, options.limit);
+        }
+        return result;
+    }
+    async count(filter) {
+        if (!filter)
+            return this.store.size;
+        const entries = await this.list({ filter });
+        return entries.length;
+    }
+    // ── Lifecycle ────────────────────────────────────────────────────────────
+    async initialize() {
+        // no-op for in-memory
+    }
+    async dispose() {
+        this.store.clear();
+    }
+    /** Expose raw store size — useful for tests. */
+    get size() {
+        return this.store.size;
+    }
+}
+exports.InMemoryAdapter = InMemoryAdapter;
+//# sourceMappingURL=in-memory.adapter.js.map

package/dist/storage/in-memory.adapter.js.map

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

package/dist/storage/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./in-memory.adapter";
+export * from "./json-file.adapter";
+export * from "./vector/index";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./in-memory.adapter"), exports);
+__exportStar(require("./json-file.adapter"), exports);
+__exportStar(require("./vector/index"), exports);
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,sDAAoC;AACpC,iDAA+B"}

package/dist/storage/json-file.adapter.d.ts

@@ -0,0 +1,38 @@
+import { IStorageAdapter, StorageListOptions, StorageSearchOptions } from "../contracts/storage.types";
+export interface JsonFileAdapterOptions {
+    filePath: string;
+    prettyPrint?: boolean;
+}
+/**
+ * JsonFileAdapter<T>
+ *
+ * Persistent storage backed by a single JSON file.
+ * - Atomic writes: temp file + rename
+ * - Full CRUD + list/search/count parity with InMemoryAdapter
+ * - Lazy initialization on first operation
+ */
+export declare class JsonFileAdapter<T extends {
+    id: string;
+}> implements IStorageAdapter<T> {
+    private readonly filePath;
+    private readonly prettyPrint;
+    private readonly store;
+    private initialized;
+    private initPromise;
+    private writeQueue;
+    constructor(options: JsonFileAdapterOptions);
+    create(item: Omit<T, "id">): Promise<T>;
+    read(id: string): Promise<T | null>;
+    update(id: string, patch: Partial<T>): Promise<T>;
+    delete(id: string): Promise<void>;
+    list(options?: StorageListOptions<T>): Promise<T[]>;
+    search(options: StorageSearchOptions): Promise<T[]>;
+    count(filter?: Partial<T>): Promise<number>;
+    initialize(): Promise<void>;
+    dispose(): Promise<void>;
+    private ensureInitialized;
+    private loadFromDisk;
+    private enqueuePersist;
+    private persist;
+}
+//# sourceMappingURL=json-file.adapter.d.ts.map

package/dist/storage/json-file.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-file.adapter.d.ts","sourceRoot":"","sources":["../../src/storage/json-file.adapter.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AAOpC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CACnD,YAAW,eAAe,CAAC,CAAC,CAAC;IAE7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAE9C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,UAAU,CAAoC;gBAE1C,OAAO,EAAE,sBAAsB;IAOrC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASvC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKnC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAejD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjC,IAAI,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAqCnD,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IA2DnD,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAW3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAMhB,iBAAiB;YAMjB,YAAY;YAmCZ,cAAc;YAMd,OAAO;CActB"}