@veewo/claw-core 0.1.12

package/README.md

@@ -0,0 +1,7 @@
+# @veewo/claw-core
+
+Core library for `.claw` project context, plan lifecycle, search, truth ingestion, and task retention.
+
+Repository:
+
+- [claw-kit](https://github.com/chanyuenpang/claw-kit)

package/dist/src/completion-hooks.d.ts

@@ -0,0 +1,6 @@
+import type { PlanCompletionHooks, PlanDocument, TaskContext } from "./types.js";
+export declare function buildCompletionHooks(params: {
+    task: TaskContext;
+    planPath: string;
+    plan: PlanDocument;
+}): PlanCompletionHooks;

package/dist/src/completion-hooks.js

@@ -0,0 +1,64 @@
+import path from "node:path";
+export function buildCompletionHooks(params) {
+    const { task, planPath, plan } = params;
+    const truthCandidate = {
+        projectId: task.project.projectId,
+        taskName: task.taskName,
+        planPath,
+        planTitle: plan.title,
+        goalText: plan.goal.text,
+        planStatus: plan.status,
+        ...(plan.summary ? { summary: plan.summary } : {}),
+        ...(plan.rules ? { rules: plan.rules } : {}),
+        ...(plan.references ? { references: plan.references } : {}),
+        ...(plan.retrospective ? { retrospective: plan.retrospective } : {}),
+        ...(plan.keyDecisions ? { keyDecisions: plan.keyDecisions } : {}),
+        suggestedTruthPaths: buildSuggestedTruthPaths(planPath, plan),
+    };
+    const adrCandidate = {
+        projectId: task.project.projectId,
+        taskName: task.taskName,
+        planPath,
+        planTitle: plan.title,
+        planStatus: plan.status,
+        keyDecisions: plan.keyDecisions ?? [],
+        shouldWriteAdr: (plan.keyDecisions?.length ?? 0) > 0,
+        reason: (plan.keyDecisions?.length ?? 0) > 0
+            ? "Plan completed with keyDecisions that may represent durable architecture or workflow decisions."
+            : "No explicit keyDecisions were present on the completed plan.",
+    };
+    return {
+        truthCandidate,
+        adrCandidate,
+        ...(plan.parentPlan && plan.parentTaskId !== undefined
+            ? {
+                subplanClosureCandidate: {
+                    taskName: task.taskName,
+                    parentPlan: plan.parentPlan,
+                    parentTaskId: plan.parentTaskId,
+                },
+            }
+            : {}),
+    };
+}
+function buildSuggestedTruthPaths(planPath, plan) {
+    const suggestions = new Set(["SUMMARY.md"]);
+    if (plan.taskType?.trim()) {
+        suggestions.add(`features/${slugify(plan.taskType)}.md`);
+    }
+    else {
+        suggestions.add(`features/${slugify(plan.title)}.md`);
+    }
+    const planFileName = path.basename(planPath, path.extname(planPath));
+    suggestions.add(`plans/${slugify(planFileName)}.md`);
+    return [...suggestions];
+}
+function slugify(input) {
+    return input
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^[.-]+|[.-]+$/g, "");
+}
+//# sourceMappingURL=completion-hooks.js.map

package/dist/src/completion-hooks.js.map

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

package/dist/src/context.d.ts

@@ -0,0 +1,7 @@
+import type { ProjectContext, ResolvedContext, TaskContext } from "./types.js";
+export declare function resolveProjectContext(cwd: string): ProjectContext;
+export declare function resolveTaskContext(project: ProjectContext, taskName: string): TaskContext;
+export declare function resolveContext(cwd: string, taskName?: string): ResolvedContext;
+export declare function ensureTaskMeta(project: ProjectContext, taskName: string, description?: string): TaskContext;
+export declare function saveTaskMeta(task: TaskContext): void;
+export declare function resolveTaskName(taskName: string): string;

package/dist/src/context.js

@@ -0,0 +1,171 @@
+import fs from "node:fs";
+import path from "node:path";
+import { ClawError } from "./errors.js";
+import { readJsonFile, withFileLock } from "./io.js";
+import { ensureInsideDir, findProjectRoot, isValidTaskName, normalizePlanFile, normalizeTaskName } from "./paths.js";
+export function resolveProjectContext(cwd) {
+    const projectRoot = findProjectRoot(cwd);
+    if (!projectRoot) {
+        throw new ClawError("CLAW_DIR_NOT_FOUND", `No .claw directory was found from ${cwd}.`, { cwd });
+    }
+    const clawDir = path.join(projectRoot, ".claw");
+    const projectJsonPath = path.join(clawDir, "project.json");
+    const projectConfig = fs.existsSync(projectJsonPath) ? readProjectConfig(projectJsonPath) : null;
+    const projectId = deriveProjectId(projectRoot, projectConfig);
+    return {
+        projectRoot,
+        clawDir,
+        projectJsonPath,
+        truthDir: path.join(clawDir, "truth"),
+        tasksDir: path.join(clawDir, "tasks"),
+        projectId,
+        ...(projectConfig?.name ? { projectName: projectConfig.name } : {}),
+        projectConfig,
+    };
+}
+export function resolveTaskContext(project, taskName) {
+    const resolvedTaskName = resolveTaskName(taskName);
+    const taskDir = path.join(project.tasksDir, resolvedTaskName);
+    const metaPath = path.join(taskDir, "meta.json");
+    if (!fs.existsSync(metaPath)) {
+        throw new ClawError("TASK_NOT_FOUND", `Task "${resolvedTaskName}" does not exist.`, { taskName: resolvedTaskName });
+    }
+    const meta = readJsonFile(metaPath);
+    const activePlan = normalizePlanFile(typeof meta.activePlan === "string" ? meta.activePlan : "plan.json");
+    const activePlanPath = ensureInsideDir(taskDir, activePlan);
+    if (!activePlanPath) {
+        throw new ClawError("ACTIVE_PLAN_INVALID", `Task "${resolvedTaskName}" has an invalid activePlan.`, {
+            taskName: resolvedTaskName,
+            activePlan,
+        });
+    }
+    if (!fs.existsSync(activePlanPath)) {
+        throw new ClawError("ACTIVE_PLAN_MISSING", `Task "${resolvedTaskName}" points to a missing active plan file.`, {
+            taskName: resolvedTaskName,
+            activePlan,
+        });
+    }
+    return {
+        project,
+        taskName: resolvedTaskName,
+        taskDir,
+        metaPath,
+        meta,
+        activePlan,
+        activePlanPath,
+    };
+}
+export function resolveContext(cwd, taskName) {
+    const project = resolveProjectContext(cwd);
+    return {
+        project,
+        ...(taskName ? { task: resolveTaskContext(project, taskName) } : {}),
+    };
+}
+export function ensureTaskMeta(project, taskName, description) {
+    const resolvedTaskName = resolveTaskName(taskName);
+    const taskDir = path.join(project.tasksDir, resolvedTaskName);
+    const metaPath = path.join(taskDir, "meta.json");
+    const now = new Date().toISOString();
+    let meta;
+    const createdTask = !fs.existsSync(metaPath);
+    if (!createdTask) {
+        meta = readJsonFile(metaPath);
+        meta.updatedAt = now;
+        if (description && !meta.description) {
+            meta.description = description;
+        }
+    }
+    else {
+        meta = {
+            name: resolvedTaskName,
+            description: description ?? "",
+            projectId: project.projectId,
+            createdAt: now,
+            updatedAt: now,
+            subagents: [],
+            status: "active",
+            activePlan: "plan.json",
+        };
+    }
+    fs.mkdirSync(taskDir, { recursive: true });
+    withFileLock(metaPath, () => {
+        fs.writeFileSync(metaPath, `${JSON.stringify(meta, null, 2)}\n`, "utf-8");
+    });
+    const task = {
+        project,
+        taskName: resolvedTaskName,
+        taskDir,
+        metaPath,
+        meta,
+        activePlan: normalizePlanFile(meta.activePlan),
+        activePlanPath: path.join(taskDir, normalizePlanFile(meta.activePlan)),
+    };
+    if (createdTask) {
+        task.meta.createdAt = now;
+    }
+    return task;
+}
+export function saveTaskMeta(task) {
+    task.meta.updatedAt = new Date().toISOString();
+    withFileLock(task.metaPath, () => {
+        fs.writeFileSync(task.metaPath, `${JSON.stringify(task.meta, null, 2)}\n`, "utf-8");
+    });
+}
+export function resolveTaskName(taskName) {
+    const normalized = normalizeTaskName(taskName);
+    if (!normalized || !isValidTaskName(normalized)) {
+        throw new ClawError("TASK_NAME_INVALID", `Invalid task name "${taskName}".`, { taskName });
+    }
+    return normalized;
+}
+function readProjectConfig(projectJsonPath) {
+    try {
+        return normalizeProjectConfig(readJsonFile(projectJsonPath));
+    }
+    catch (error) {
+        throw new ClawError("PROJECT_CONFIG_INVALID", "Failed to parse .claw/project.json.", {
+            path: projectJsonPath,
+            cause: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+function normalizeProjectConfig(projectConfig) {
+    const { autoAchieveTask: _autoAchieveTask, ...rest } = projectConfig;
+    return {
+        ...rest,
+        maxTasksToKeep: Number.isInteger(projectConfig.maxTasksToKeep) && projectConfig.maxTasksToKeep >= 1
+            ? projectConfig.maxTasksToKeep
+            : 99,
+        externalTruthSkill: normalizeOptionalSkill(projectConfig.externalTruthSkill),
+        externalAdrSkill: normalizeOptionalSkill(projectConfig.externalAdrSkill),
+        contextPaths: [...(projectConfig.contextPaths ?? [])],
+        memory: {
+            externalDocPaths: [...(projectConfig.memory?.externalDocPaths ?? [])],
+        },
+        gitnexus: {
+            enabled: projectConfig.gitnexus?.enabled ?? false,
+        },
+    };
+}
+function deriveProjectId(projectRoot, projectConfig) {
+    const candidates = [projectConfig?.id, projectConfig?.name, path.basename(projectRoot)];
+    for (const candidate of candidates) {
+        if (!candidate) {
+            continue;
+        }
+        const normalized = normalizeTaskName(candidate);
+        if (normalized) {
+            return normalized;
+        }
+    }
+    throw new ClawError("PROJECT_ROOT_NOT_FOUND", "Unable to derive a project id.", { projectRoot });
+}
+function normalizeOptionalSkill(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed ? trimmed : null;
+}
+//# sourceMappingURL=context.js.map

package/dist/src/context.js.map

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

package/dist/src/errors.d.ts

@@ -0,0 +1,6 @@
+export type ClawErrorCode = "PROJECT_ROOT_NOT_FOUND" | "CLAW_DIR_NOT_FOUND" | "PROJECT_ALREADY_INITIALIZED" | "PROJECT_CONFIG_INVALID" | "TASK_NOT_FOUND" | "TASK_NAME_INVALID" | "ACTIVE_PLAN_INVALID" | "ACTIVE_PLAN_MISSING" | "PLAN_NOT_FOUND" | "PLAN_STATUS_INVALID" | "PLAN_STATUS_NOT_SETTABLE" | "PLAN_STATUS_TRANSITION_FORBIDDEN" | "PLAN_STATUS_REOPEN_REQUIRED" | "TASK_STATUS_FORBIDDEN_IN_NON_ACTIVE_PLAN" | "PLAN_WRITE_CONFLICT" | "RETROSPECTIVE_REQUIRED" | "MEMORY_QUERY_REQUIRED" | "GITNEXUS_REFRESH_FAILED" | "TRUTH_TARGET_INVALID" | "INPUT_REQUIRED";
+export declare class ClawError extends Error {
+    readonly code: ClawErrorCode;
+    readonly details: Record<string, unknown> | undefined;
+    constructor(code: ClawErrorCode, message: string, details?: Record<string, unknown>);
+}

package/dist/src/errors.js

@@ -0,0 +1,11 @@
+export class ClawError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = "ClawError";
+        this.code = code;
+        this.details = details;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAsBA,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,IAAI,CAAgB;IACpB,OAAO,CAAsC;IAEtD,YAAY,IAAmB,EAAE,OAAe,EAAE,OAAiC;QACjF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF"}

package/dist/src/index.d.ts

@@ -0,0 +1,15 @@
+export * from "./context.js";
+export * from "./completion-hooks.js";
+export * from "./errors.js";
+export * from "./init.js";
+export * from "./memory.js";
+export * from "./plan-events.js";
+export * from "./project-check.js";
+export * from "./requirements-gate.js";
+export * from "./plan.js";
+export * from "./plan-view.js";
+export * from "./switch-task.js";
+export * from "./task-retention.js";
+export * from "./truth.js";
+export * from "./types.js";
+export * from "./workflow-guidance.js";

package/dist/src/index.js

@@ -0,0 +1,16 @@
+export * from "./context.js";
+export * from "./completion-hooks.js";
+export * from "./errors.js";
+export * from "./init.js";
+export * from "./memory.js";
+export * from "./plan-events.js";
+export * from "./project-check.js";
+export * from "./requirements-gate.js";
+export * from "./plan.js";
+export * from "./plan-view.js";
+export * from "./switch-task.js";
+export * from "./task-retention.js";
+export * from "./truth.js";
+export * from "./types.js";
+export * from "./workflow-guidance.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC"}

package/dist/src/init.d.ts

@@ -0,0 +1,22 @@
+export type InitProjectInput = {
+    cwd: string;
+    projectId?: string;
+    projectName?: string;
+    maxTasksToKeep?: number;
+    externalTruthSkill?: string | null;
+    externalAdrSkill?: string | null;
+    contextPaths?: string[];
+    externalDocPaths?: string[];
+    gitnexusEnabled?: boolean;
+    force?: boolean;
+};
+export type InitProjectResult = {
+    projectRoot: string;
+    clawDir: string;
+    projectJsonPath: string;
+    created: boolean;
+    projectId: string;
+    projectName: string;
+    createdPaths: string[];
+};
+export declare function initProject(input: InitProjectInput): InitProjectResult;

package/dist/src/init.js

@@ -0,0 +1,91 @@
+import fs from "node:fs";
+import path from "node:path";
+import { ClawError } from "./errors.js";
+import { normalizeTaskName } from "./paths.js";
+export function initProject(input) {
+    const projectRoot = path.resolve(input.cwd);
+    const clawDir = path.join(projectRoot, ".claw");
+    const projectJsonPath = path.join(clawDir, "project.json");
+    const memoryPath = path.join(clawDir, "memory.md");
+    const truthSummaryPath = path.join(clawDir, "truth", "SUMMARY.md");
+    const tasksDir = path.join(clawDir, "tasks");
+    const knowledgeDir = path.join(clawDir, ".knowledge");
+    const createdPaths = [];
+    const exists = fs.existsSync(clawDir);
+    if (exists && !input.force) {
+        throw new ClawError("PROJECT_ALREADY_INITIALIZED", `Project already contains .claw at ${clawDir}.`, {
+            clawDir,
+        });
+    }
+    const projectName = input.projectName?.trim() || path.basename(projectRoot);
+    const projectId = normalizeProjectId(input.projectId ?? projectName, projectRoot);
+    const maxTasksToKeep = input.maxTasksToKeep ?? 99;
+    validateMaxTasksToKeep(maxTasksToKeep, projectRoot);
+    const projectConfig = {
+        id: projectId,
+        name: projectName,
+        maxTasksToKeep,
+        externalTruthSkill: normalizeOptionalSkill(input.externalTruthSkill),
+        externalAdrSkill: normalizeOptionalSkill(input.externalAdrSkill),
+        contextPaths: [...(input.contextPaths ?? [])],
+        memory: {
+            externalDocPaths: [...(input.externalDocPaths ?? [])],
+        },
+        gitnexus: {
+            enabled: input.gitnexusEnabled ?? false,
+        },
+    };
+    ensureDir(clawDir, createdPaths);
+    ensureDir(path.dirname(truthSummaryPath), createdPaths);
+    ensureDir(tasksDir, createdPaths);
+    ensureDir(knowledgeDir, createdPaths);
+    writeFile(projectJsonPath, `${JSON.stringify(projectConfig, null, 2)}\n`, createdPaths);
+    writeFile(memoryPath, `# Project Memory\n\n- Project initialized for claw-kit.\n- Use \`claw plan write\` to establish the first task scope.\n`, createdPaths);
+    writeFile(truthSummaryPath, `# ${projectName} Truth Summary\n\n- Project initialized for claw-kit.\n- No durable truth has been recorded yet.\n`, createdPaths);
+    return {
+        projectRoot,
+        clawDir,
+        projectJsonPath,
+        created: !exists,
+        projectId,
+        projectName,
+        createdPaths,
+    };
+}
+function normalizeProjectId(candidate, projectRoot) {
+    const normalized = normalizeTaskName(candidate).toLowerCase();
+    if (!normalized) {
+        throw new ClawError("PROJECT_ROOT_NOT_FOUND", "Unable to derive a project id for claw init.", {
+            projectRoot,
+            candidate,
+        });
+    }
+    return normalized;
+}
+function validateMaxTasksToKeep(value, projectRoot) {
+    if (!Number.isInteger(value) || value < 1) {
+        throw new ClawError("PROJECT_CONFIG_INVALID", "maxTasksToKeep must be an integer greater than or equal to 1.", {
+            projectRoot,
+            value,
+        });
+    }
+}
+function normalizeOptionalSkill(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed ? trimmed : null;
+}
+function ensureDir(dirPath, createdPaths) {
+    if (fs.existsSync(dirPath)) {
+        return;
+    }
+    fs.mkdirSync(dirPath, { recursive: true });
+    createdPaths.push(dirPath);
+}
+function writeFile(filePath, content, createdPaths) {
+    fs.writeFileSync(filePath, content, "utf-8");
+    createdPaths.push(filePath);
+}
+//# sourceMappingURL=init.js.map

package/dist/src/init.js.map

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

package/dist/src/io.d.ts

@@ -0,0 +1,6 @@
+export declare function readJsonFile<T>(filePath: string): T;
+export declare function writeJsonFile(filePath: string, value: unknown): void;
+export declare function readTextFile(filePath: string): string;
+export declare function writeTextFile(filePath: string, content: string): void;
+export declare function stripBom(content: string): string;
+export declare function withFileLock<T>(targetPath: string, action: () => T): T;

package/dist/src/io.js

@@ -0,0 +1,47 @@
+import fs from "node:fs";
+import path from "node:path";
+import { ClawError } from "./errors.js";
+export function readJsonFile(filePath) {
+    return JSON.parse(stripBom(fs.readFileSync(filePath, "utf-8")));
+}
+export function writeJsonFile(filePath, value) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf-8");
+}
+export function readTextFile(filePath) {
+    return stripBom(fs.readFileSync(filePath, "utf-8"));
+}
+export function writeTextFile(filePath, content) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, content, "utf-8");
+}
+export function stripBom(content) {
+    return content.charCodeAt(0) === 0xfeff ? content.slice(1) : content;
+}
+export function withFileLock(targetPath, action) {
+    const lockPath = `${targetPath}.lock`;
+    fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+    let lockFd;
+    try {
+        lockFd = fs.openSync(lockPath, "wx");
+    }
+    catch (error) {
+        const code = error && typeof error === "object" && "code" in error ? String(error.code) : "";
+        if (code === "EEXIST") {
+            throw new ClawError("PLAN_WRITE_CONFLICT", `Concurrent write detected for "${targetPath}". Retry after the other plan operation completes.`, { targetPath, lockPath });
+        }
+        throw error;
+    }
+    try {
+        return action();
+    }
+    finally {
+        if (lockFd !== undefined) {
+            fs.closeSync(lockFd);
+        }
+        if (fs.existsSync(lockPath)) {
+            fs.unlinkSync(lockPath);
+        }
+    }
+}
+//# sourceMappingURL=io.js.map

package/dist/src/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,UAAU,YAAY,CAAI,QAAgB;IAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAM,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,KAAc;IAC5D,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,QAAQ,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,OAAe;IAC7D,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,UAAkB,EAAE,MAAe;IACjE,MAAM,QAAQ,GAAG,GAAG,UAAU,OAAO,CAAC;IACtC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,IAAI,MAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,CAAE,KAA4B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrH,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,SAAS,CACjB,qBAAqB,EACrB,kCAAkC,UAAU,oDAAoD,EAChG,EAAE,UAAU,EAAE,QAAQ,EAAE,CACzB,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC;IAClB,CAAC;YAAS,CAAC;QACT,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/memory.d.ts

@@ -0,0 +1,4 @@
+import type { MemoryGetInput, MemoryGetResult, MemoryIndexInput, MemoryIndexResult, MemorySearchInput, MemorySearchResult } from "./types.js";
+export declare function buildMemoryIndex(input: MemoryIndexInput): MemoryIndexResult;
+export declare function searchMemory(input: MemorySearchInput): MemorySearchResult;
+export declare function getMemory(input: MemoryGetInput): MemoryGetResult;