@vetala/vetala 0.1.0-beta

package/dist/src/session-store.js

@@ -0,0 +1,318 @@
+import crypto from "node:crypto";
+import path from "node:path";
+import { appendFile, readFile, readdir, writeFile } from "node:fs/promises";
+import { ensureAppPaths } from "./xdg.js";
+const EMPTY_APPROVALS = {
+    sessionActionKeys: [],
+    outOfTreeRoots: [],
+    webAccess: false
+};
+export class SessionStore {
+    async createSession(workspaceRoot, model) {
+        const paths = await ensureAppPaths();
+        const id = createSessionId();
+        const createdAt = new Date().toISOString();
+        const state = {
+            id,
+            workspaceRoot,
+            model,
+            createdAt,
+            updatedAt: createdAt,
+            approvals: structuredClone(EMPTY_APPROVALS),
+            messages: [],
+            referencedFiles: [],
+            readFiles: [],
+            pinnedSkills: []
+        };
+        const record = {
+            type: "meta",
+            id,
+            workspaceRoot,
+            model,
+            createdAt
+        };
+        await appendFile(this.sessionPath(paths.sessionsDir, id), `${JSON.stringify(record)}\n`, "utf8");
+        await this.updateLatestWorkspace(workspaceRoot, id);
+        return state;
+    }
+    async loadSession(sessionId) {
+        const paths = await ensureAppPaths();
+        const sessionPath = this.sessionPath(paths.sessionsDir, sessionId);
+        const raw = await readFile(sessionPath, "utf8");
+        const lines = raw.split("\n").filter(Boolean);
+        let state;
+        for (const line of lines) {
+            const record = JSON.parse(line);
+            switch (record.type) {
+                case "meta":
+                    state = {
+                        id: record.id,
+                        workspaceRoot: record.workspaceRoot,
+                        model: record.model,
+                        createdAt: record.createdAt,
+                        updatedAt: record.createdAt,
+                        approvals: structuredClone(EMPTY_APPROVALS),
+                        messages: [],
+                        referencedFiles: [],
+                        readFiles: [],
+                        pinnedSkills: []
+                    };
+                    break;
+                case "message":
+                    ensureState(state, sessionId);
+                    state.messages.push(record.message);
+                    state.updatedAt = record.timestamp;
+                    break;
+                case "approval":
+                    ensureState(state, sessionId);
+                    applyApproval(state, record.approval);
+                    state.updatedAt = record.approval.timestamp;
+                    break;
+                case "reference":
+                    ensureState(state, sessionId);
+                    if (!state.referencedFiles.includes(record.path)) {
+                        state.referencedFiles.push(record.path);
+                    }
+                    state.updatedAt = record.timestamp;
+                    break;
+                case "read":
+                    ensureState(state, sessionId);
+                    if (!state.readFiles.includes(record.path)) {
+                        state.readFiles.push(record.path);
+                    }
+                    if (!state.referencedFiles.includes(record.path)) {
+                        state.referencedFiles.push(record.path);
+                    }
+                    state.updatedAt = record.timestamp;
+                    break;
+                case "model":
+                    ensureState(state, sessionId);
+                    state.model = record.model;
+                    state.updatedAt = record.timestamp;
+                    break;
+                case "skill":
+                    ensureState(state, sessionId);
+                    applySkillRecord(state, record);
+                    state.updatedAt = record.timestamp;
+                    break;
+                default:
+                    exhaustive(record);
+            }
+        }
+        if (!state) {
+            throw new Error(`Session ${sessionId} is missing a meta record.`);
+        }
+        return state;
+    }
+    async loadLatestForWorkspace(workspaceRoot) {
+        const latest = await this.readLatestWorkspaceMap();
+        const sessionId = latest[workspaceRoot];
+        if (!sessionId) {
+            return null;
+        }
+        try {
+            return await this.loadSession(sessionId);
+        }
+        catch (error) {
+            if (isMissingFile(error)) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async listSessions() {
+        const paths = await ensureAppPaths();
+        const entries = await readdir(paths.sessionsDir, { withFileTypes: true });
+        const ids = entries
+            .filter((entry) => entry.isFile() && entry.name.endsWith(".jsonl"))
+            .map((entry) => entry.name.replace(/\.jsonl$/, ""));
+        const sessions = await Promise.all(ids.map((id) => this.loadSession(id)));
+        return sessions
+            .map((session) => ({
+            id: session.id,
+            workspaceRoot: session.workspaceRoot,
+            model: session.model,
+            createdAt: session.createdAt,
+            updatedAt: session.updatedAt
+        }))
+            .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+    }
+    async appendMessage(session, message) {
+        const paths = await ensureAppPaths();
+        const record = {
+            type: "message",
+            timestamp: message.timestamp,
+            message
+        };
+        session.messages.push(message);
+        session.updatedAt = message.timestamp;
+        await appendFile(this.sessionPath(paths.sessionsDir, session.id), `${JSON.stringify(record)}\n`, "utf8");
+        await this.updateLatestWorkspace(session.workspaceRoot, session.id);
+    }
+    async appendApproval(session, approval) {
+        const paths = await ensureAppPaths();
+        const record = {
+            type: "approval",
+            approval
+        };
+        applyApproval(session, approval);
+        session.updatedAt = approval.timestamp;
+        await appendFile(this.sessionPath(paths.sessionsDir, session.id), `${JSON.stringify(record)}\n`, "utf8");
+    }
+    async appendReference(session, targetPath) {
+        if (session.referencedFiles.includes(targetPath)) {
+            return;
+        }
+        const paths = await ensureAppPaths();
+        const timestamp = new Date().toISOString();
+        const record = {
+            type: "reference",
+            path: targetPath,
+            timestamp
+        };
+        session.referencedFiles.push(targetPath);
+        session.updatedAt = timestamp;
+        await appendFile(this.sessionPath(paths.sessionsDir, session.id), `${JSON.stringify(record)}\n`, "utf8");
+    }
+    async appendReadFile(session, targetPath) {
+        if (session.readFiles.includes(targetPath)) {
+            return;
+        }
+        const paths = await ensureAppPaths();
+        const timestamp = new Date().toISOString();
+        const record = {
+            type: "read",
+            path: targetPath,
+            timestamp
+        };
+        session.readFiles.push(targetPath);
+        if (!session.referencedFiles.includes(targetPath)) {
+            session.referencedFiles.push(targetPath);
+        }
+        session.updatedAt = timestamp;
+        await appendFile(this.sessionPath(paths.sessionsDir, session.id), `${JSON.stringify(record)}\n`, "utf8");
+        await this.updateLatestWorkspace(session.workspaceRoot, session.id);
+    }
+    async updateModel(session, model) {
+        const paths = await ensureAppPaths();
+        const timestamp = new Date().toISOString();
+        const record = {
+            type: "model",
+            model,
+            timestamp
+        };
+        session.model = model;
+        session.updatedAt = timestamp;
+        await appendFile(this.sessionPath(paths.sessionsDir, session.id), `${JSON.stringify(record)}\n`, "utf8");
+    }
+    async pinSkill(session, skillName) {
+        if (session.pinnedSkills.includes(skillName)) {
+            return;
+        }
+        await this.appendSkillRecord(session, {
+            type: "skill",
+            action: "pin",
+            skillName,
+            timestamp: new Date().toISOString()
+        });
+    }
+    async unpinSkill(session, skillName) {
+        if (!session.pinnedSkills.includes(skillName)) {
+            return;
+        }
+        await this.appendSkillRecord(session, {
+            type: "skill",
+            action: "unpin",
+            skillName,
+            timestamp: new Date().toISOString()
+        });
+    }
+    async clearPinnedSkills(session) {
+        if (session.pinnedSkills.length === 0) {
+            return;
+        }
+        await this.appendSkillRecord(session, {
+            type: "skill",
+            action: "clear",
+            timestamp: new Date().toISOString()
+        });
+    }
+    async readLatestWorkspaceMap() {
+        const paths = await ensureAppPaths();
+        try {
+            const raw = await readFile(paths.latestWorkspaceFile, "utf8");
+            return JSON.parse(raw);
+        }
+        catch (error) {
+            if (isMissingFile(error)) {
+                return {};
+            }
+            throw error;
+        }
+    }
+    async updateLatestWorkspace(workspaceRoot, sessionId) {
+        const paths = await ensureAppPaths();
+        const latest = await this.readLatestWorkspaceMap();
+        latest[workspaceRoot] = sessionId;
+        await writeFile(paths.latestWorkspaceFile, `${JSON.stringify(latest, null, 2)}\n`, "utf8");
+    }
+    async appendSkillRecord(session, record) {
+        const paths = await ensureAppPaths();
+        applySkillRecord(session, record);
+        session.updatedAt = record.timestamp;
+        await appendFile(this.sessionPath(paths.sessionsDir, session.id), `${JSON.stringify(record)}\n`, "utf8");
+        await this.updateLatestWorkspace(session.workspaceRoot, session.id);
+    }
+    sessionPath(sessionsDir, sessionId) {
+        return path.join(sessionsDir, `${sessionId}.jsonl`);
+    }
+}
+function applyApproval(state, approval) {
+    if (approval.kind === "web_access") {
+        state.approvals.webAccess = true;
+        return;
+    }
+    if (approval.kind === "path_access") {
+        if (!state.approvals.outOfTreeRoots.includes(approval.key)) {
+            state.approvals.outOfTreeRoots.push(approval.key);
+        }
+        return;
+    }
+    if (!state.approvals.sessionActionKeys.includes(approval.key)) {
+        state.approvals.sessionActionKeys.push(approval.key);
+    }
+}
+function applySkillRecord(state, record) {
+    switch (record.action) {
+        case "pin":
+            if (record.skillName && !state.pinnedSkills.includes(record.skillName)) {
+                state.pinnedSkills.push(record.skillName);
+            }
+            break;
+        case "unpin":
+            if (record.skillName) {
+                state.pinnedSkills = state.pinnedSkills.filter((name) => name !== record.skillName);
+            }
+            break;
+        case "clear":
+            state.pinnedSkills = [];
+            break;
+        default:
+            exhaustive(record.action);
+    }
+}
+function createSessionId() {
+    return crypto.randomUUID();
+}
+function ensureState(state, sessionId) {
+    if (!state) {
+        throw new Error(`Session ${sessionId} is missing a meta record before other records.`);
+    }
+}
+function exhaustive(_) {
+    throw new Error("Unexpected session record.");
+}
+function isMissingFile(error) {
+    return error !== null && typeof error === "object" && "code" in error && error.code === "ENOENT";
+}
+//# sourceMappingURL=session-store.js.map

package/dist/src/session-store.js.map

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

package/dist/src/skills/runtime.d.ts

@@ -0,0 +1,26 @@
+import { SessionStore } from "../session-store.js";
+import type { SessionState } from "../types.js";
+import type { LoadedSkillSummary, ReadSkillFileResult, SkillCatalogEntry, SkillToolApi } from "./types.js";
+interface SkillRuntimeOptions {
+    getSession: () => SessionState;
+    sessionStore: SessionStore;
+}
+export declare class SkillRuntime implements SkillToolApi {
+    private readonly options;
+    private cachedRoot;
+    private cachedSkills;
+    constructor(options: SkillRuntimeOptions);
+    listSkills(): Promise<SkillCatalogEntry[]>;
+    loadSkill(name: string): Promise<LoadedSkillSummary>;
+    readSkillFile(name: string, relativePath?: string): Promise<ReadSkillFileResult>;
+    pinSkill(name: string): Promise<SkillCatalogEntry>;
+    unpinSkill(name: string): Promise<SkillCatalogEntry>;
+    clearPinnedSkills(): Promise<number>;
+    pinnedSkills(): Promise<SkillCatalogEntry[]>;
+    inventoryPrompt(): Promise<string>;
+    pinnedPrompt(): Promise<string | null>;
+    private ensureCatalog;
+    private requireSkill;
+    private resolveSkillRoot;
+}
+export {};

package/dist/src/skills/runtime.js

@@ -0,0 +1,317 @@
+import path from "node:path";
+import { access, readFile, readdir } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+const MAX_FILE_LIST = 24;
+const MAX_LOAD_BODY_CHARS = 4_000;
+const MAX_READ_CHARS = 12_000;
+const MAX_HEADINGS = 8;
+const MAX_LINKS = 12;
+const MAX_PINNED_PROMPT_CHARS = 2_200;
+export class SkillRuntime {
+    options;
+    cachedRoot = null;
+    cachedSkills = [];
+    constructor(options) {
+        this.options = options;
+    }
+    async listSkills() {
+        return [...await this.ensureCatalog()];
+    }
+    async loadSkill(name) {
+        const skill = await this.requireSkill(name);
+        const raw = await readFile(skill.entryPath, "utf8");
+        const body = stripFrontmatter(raw).trim();
+        const headings = extractHeadings(body);
+        const linkedFiles = extractLinkedFiles(body);
+        const excerpt = body.length > MAX_LOAD_BODY_CHARS
+            ? `${body.slice(0, MAX_LOAD_BODY_CHARS - 3).trimEnd()}...`
+            : body;
+        const overviewLines = [
+            `Skill: ${skill.name}`,
+            `Description: ${skill.description || "(none)"}`,
+            `Entry: ${skill.entryPath}`
+        ];
+        if (headings.length > 0) {
+            overviewLines.push(`Headings: ${headings.join(" | ")}`);
+        }
+        if (linkedFiles.length > 0) {
+            overviewLines.push(`Linked files: ${linkedFiles.join(", ")}`);
+        }
+        if (skill.availableFiles.length > 0) {
+            overviewLines.push(`Available files: ${formatList(skill.availableFiles, 8)}`);
+        }
+        if (excerpt) {
+            overviewLines.push("", excerpt);
+        }
+        return {
+            ...skill,
+            headings,
+            linkedFiles,
+            overview: overviewLines.join("\n")
+        };
+    }
+    async readSkillFile(name, relativePath = "SKILL.md") {
+        const skill = await this.requireSkill(name);
+        const targetPath = resolveSkillPath(skill.rootPath, relativePath);
+        const buffer = await readFile(targetPath);
+        if (buffer.includes(0)) {
+            throw new Error(`Skill file is binary and cannot be read as text: ${relativePath}`);
+        }
+        const content = buffer.toString("utf8");
+        return {
+            path: targetPath,
+            content: content.length > MAX_READ_CHARS
+                ? `${content.slice(0, MAX_READ_CHARS - 3).trimEnd()}...`
+                : content
+        };
+    }
+    async pinSkill(name) {
+        const skill = await this.requireSkill(name);
+        await this.options.sessionStore.pinSkill(this.options.getSession(), skill.name);
+        return skill;
+    }
+    async unpinSkill(name) {
+        const skill = await this.requireSkill(name);
+        await this.options.sessionStore.unpinSkill(this.options.getSession(), skill.name);
+        return skill;
+    }
+    async clearPinnedSkills() {
+        const pinnedCount = this.options.getSession().pinnedSkills.length;
+        await this.options.sessionStore.clearPinnedSkills(this.options.getSession());
+        return pinnedCount;
+    }
+    async pinnedSkills() {
+        const pinned = new Set(this.options.getSession().pinnedSkills);
+        const catalog = await this.ensureCatalog();
+        return catalog.filter((skill) => pinned.has(skill.name));
+    }
+    async inventoryPrompt() {
+        const skills = await this.ensureCatalog();
+        if (skills.length === 0) {
+            return "No local skills are available in the skill/ directory.";
+        }
+        return [
+            "Local skills are available through the skill tool. Use `skill` when a request matches one of these domains:",
+            ...skills.map((skill) => `- ${skill.name}: ${shorten(skill.description, 160)}`)
+        ].join("\n");
+    }
+    async pinnedPrompt() {
+        const skills = await this.pinnedSkills();
+        if (skills.length === 0) {
+            return null;
+        }
+        const lines = ["Pinned skills remain active across context compaction:"];
+        for (const skill of skills) {
+            const loaded = await this.loadSkill(skill.name);
+            lines.push(`- ${skill.name}: ${shorten(skill.description, 160)}`);
+            if (loaded.headings.length > 0) {
+                lines.push(`  sections: ${formatList(loaded.headings, 4)}`);
+            }
+            if (loaded.linkedFiles.length > 0) {
+                lines.push(`  files: ${formatList(loaded.linkedFiles, 4)}`);
+            }
+            if (lines.join("\n").length > MAX_PINNED_PROMPT_CHARS) {
+                break;
+            }
+        }
+        return lines.join("\n");
+    }
+    async ensureCatalog() {
+        const root = await this.resolveSkillRoot();
+        if (!root) {
+            this.cachedRoot = null;
+            this.cachedSkills = [];
+            return this.cachedSkills;
+        }
+        if (this.cachedRoot === root) {
+            return this.cachedSkills;
+        }
+        const entries = await readdir(root, { withFileTypes: true });
+        const skills = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory() || entry.name.startsWith(".")) {
+                continue;
+            }
+            const skillRoot = path.join(root, entry.name);
+            const entryPath = path.join(skillRoot, "SKILL.md");
+            if (!await exists(entryPath)) {
+                continue;
+            }
+            const raw = await readFile(entryPath, "utf8");
+            const frontmatter = parseFrontmatter(raw);
+            skills.push({
+                name: frontmatter.name || entry.name,
+                description: frontmatter.description || "",
+                rootPath: skillRoot,
+                entryPath,
+                availableFiles: await listSkillFiles(skillRoot)
+            });
+        }
+        skills.sort((left, right) => left.name.localeCompare(right.name));
+        this.cachedRoot = root;
+        this.cachedSkills = skills;
+        return this.cachedSkills;
+    }
+    async requireSkill(name) {
+        const normalized = name.trim();
+        if (!normalized) {
+            throw new Error("Skill name is required.");
+        }
+        const skills = await this.ensureCatalog();
+        const match = skills.find((skill) => skill.name === normalized);
+        if (!match) {
+            throw new Error(`Unknown skill: ${normalized}`);
+        }
+        return match;
+    }
+    async resolveSkillRoot() {
+        const envRoot = process.env.VETALA_SKILL_ROOT?.trim() || process.env.TATTVA_SKILL_ROOT?.trim();
+        if (envRoot) {
+            return await existsDirectory(path.resolve(envRoot)) ? path.resolve(envRoot) : null;
+        }
+        const workspaceRoot = this.options.getSession().workspaceRoot;
+        const workspaceSkillRoot = path.join(workspaceRoot, "skill");
+        if (await existsDirectory(workspaceSkillRoot)) {
+            return workspaceSkillRoot;
+        }
+        return findBundledSkillRoot();
+    }
+}
+async function listSkillFiles(skillRoot) {
+    const files = [];
+    await walkFiles(skillRoot, skillRoot, files);
+    files.sort((left, right) => left.localeCompare(right));
+    return files.slice(0, MAX_FILE_LIST);
+}
+async function walkFiles(root, current, output) {
+    const entries = await readdir(current, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.name.startsWith(".")) {
+            continue;
+        }
+        const target = path.join(current, entry.name);
+        if (entry.isDirectory()) {
+            await walkFiles(root, target, output);
+            continue;
+        }
+        output.push(path.relative(root, target).split(path.sep).join("/"));
+    }
+}
+function parseFrontmatter(raw) {
+    const match = raw.match(FRONTMATTER_RE);
+    if (!match) {
+        return { name: "", description: "" };
+    }
+    const values = new Map();
+    let currentKey = null;
+    for (const line of (match[1] ?? "").split(/\r?\n/)) {
+        const kv = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+        if (kv) {
+            const [, key = "", rawValue = ""] = kv;
+            currentKey = key || null;
+            if (!currentKey) {
+                continue;
+            }
+            values.set(currentKey, stripQuotes(rawValue.trim()));
+            continue;
+        }
+        if (currentKey && /^\s+/.test(line)) {
+            const currentValue = values.get(currentKey) ?? "";
+            const nextPart = stripQuotes(line.trim());
+            values.set(currentKey, currentValue ? `${currentValue} ${nextPart}` : nextPart);
+            continue;
+        }
+        currentKey = null;
+    }
+    return {
+        name: values.get("name") ?? "",
+        description: values.get("description") ?? ""
+    };
+}
+function stripFrontmatter(raw) {
+    return raw.replace(FRONTMATTER_RE, "");
+}
+function extractHeadings(body) {
+    return body
+        .split(/\r?\n/)
+        .map((line) => line.match(/^##+\s+(.*)$/)?.[1]?.trim() ?? null)
+        .filter((value) => Boolean(value))
+        .slice(0, MAX_HEADINGS);
+}
+function extractLinkedFiles(body) {
+    const links = new Set();
+    const re = /\[[^\]]+\]\(([^)]+)\)/g;
+    let match;
+    while ((match = re.exec(body)) !== null) {
+        const target = match[1]?.trim();
+        if (!target || target.startsWith("http://") || target.startsWith("https://") || target.startsWith("#")) {
+            continue;
+        }
+        links.add(target);
+        if (links.size >= MAX_LINKS) {
+            break;
+        }
+    }
+    return [...links];
+}
+function resolveSkillPath(skillRoot, relativePath) {
+    const normalized = relativePath.trim() || "SKILL.md";
+    if (path.isAbsolute(normalized)) {
+        throw new Error("Skill paths must be relative to the skill root.");
+    }
+    const resolved = path.resolve(skillRoot, normalized);
+    const rootWithSep = skillRoot.endsWith(path.sep) ? skillRoot : `${skillRoot}${path.sep}`;
+    if (resolved !== skillRoot && !resolved.startsWith(rootWithSep)) {
+        throw new Error(`Skill path escapes the skill root: ${relativePath}`);
+    }
+    return resolved;
+}
+async function findBundledSkillRoot() {
+    let current = path.dirname(fileURLToPath(import.meta.url));
+    while (true) {
+        const candidate = path.join(current, "skill");
+        if (await existsDirectory(candidate)) {
+            return candidate;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+async function exists(targetPath) {
+    try {
+        await access(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function existsDirectory(targetPath) {
+    try {
+        const entries = await readdir(targetPath);
+        return Array.isArray(entries);
+    }
+    catch {
+        return false;
+    }
+}
+function shorten(value, maxLength) {
+    const compact = value.replace(/\s+/g, " ").trim();
+    if (!compact) {
+        return "(no description)";
+    }
+    return compact.length > maxLength ? `${compact.slice(0, maxLength - 3)}...` : compact;
+}
+function formatList(values, limit) {
+    const visible = values.slice(0, limit);
+    const extra = values.length - visible.length;
+    return `${visible.join(", ")}${extra > 0 ? `, and ${extra} more` : ""}`;
+}
+function stripQuotes(value) {
+    return value.replace(/^['"]|['"]$/g, "");
+}
+//# sourceMappingURL=runtime.js.map