atom-lite 0.0.0-stage → 0.4.1

package/dist/runtime/locks.js

@@ -0,0 +1,180 @@
+import { resolve } from "node:path";
+import { realpathSync, existsSync } from "node:fs";
+function canonical(key) {
+    let cursor = key;
+    while (!existsSync(cursor)) {
+        const parent = resolve(cursor, "..");
+        if (parent === cursor)
+            break;
+        cursor = parent;
+    }
+    if (existsSync(cursor)) {
+        try {
+            const real = realpathSync(cursor);
+            return real + key.slice(cursor.length);
+        }
+        catch {
+            // fall through
+        }
+    }
+    return key;
+}
+class RWLock {
+    readers = 0;
+    writer = false;
+    barriers = 0;
+    queue = [];
+    acquire(mode, signal) {
+        const key = ""; // unused; lock instance is per-resource
+        return new Promise((resolve, reject) => {
+            const waiter = { mode, resolve, reject, signal };
+            const tryAcquire = () => {
+                if (signal?.aborted)
+                    return false;
+                if (mode === "read") {
+                    if (!this.writer && this.barriers === 0 && this.queue.length === 0) {
+                        this.readers++;
+                        waiter.resolve(() => {
+                            this.readers--;
+                            this.drain();
+                        });
+                        return true;
+                    }
+                }
+                else if (mode === "write") {
+                    if (this.readers === 0 && !this.writer && this.barriers === 0) {
+                        this.writer = true;
+                        waiter.resolve(() => {
+                            this.writer = false;
+                            this.drain();
+                        });
+                        return true;
+                    }
+                }
+                else {
+                    // Barriers are shared with other barriers but exclusive with all
+                    // file reads and writes.
+                    if (this.readers === 0 && !this.writer && this.queue.length === 0) {
+                        this.barriers++;
+                        waiter.resolve(() => {
+                            this.barriers--;
+                            this.drain();
+                        });
+                        return true;
+                    }
+                }
+                return false;
+            };
+            if (tryAcquire())
+                return;
+            this.queue.push(waiter);
+            if (signal) {
+                const onAbort = () => {
+                    const idx = this.queue.indexOf(waiter);
+                    if (idx >= 0)
+                        this.queue.splice(idx, 1);
+                    reject(new Error("USER_CANCELLED"));
+                };
+                signal.addEventListener("abort", onAbort, { once: true });
+            }
+        });
+    }
+    drain() {
+        // Process waiters in FIFO order; allow consecutive readers.
+        let progressed = true;
+        while (progressed && this.queue.length > 0) {
+            progressed = false;
+            // Find next runnable waiter.
+            const idx = this.queue.findIndex((w) => {
+                if (w.signal?.aborted)
+                    return true;
+                if (w.mode === "read") {
+                    return !this.writer && this.barriers === 0;
+                }
+                if (w.mode === "write") {
+                    return this.readers === 0 && !this.writer && this.barriers === 0;
+                }
+                return this.readers === 0 && !this.writer;
+            });
+            if (idx < 0)
+                break;
+            const w = this.queue.splice(idx, 1)[0];
+            if (w.signal?.aborted) {
+                w.reject(new Error("USER_CANCELLED"));
+                progressed = true;
+                continue;
+            }
+            if (w.mode === "read") {
+                this.readers++;
+                w.resolve(() => {
+                    this.readers--;
+                    this.drain();
+                });
+            }
+            else if (w.mode === "write") {
+                this.writer = true;
+                w.resolve(() => {
+                    this.writer = false;
+                    this.drain();
+                });
+            }
+            else {
+                this.barriers++;
+                w.resolve(() => {
+                    this.barriers--;
+                    this.drain();
+                });
+            }
+            progressed = true;
+            // If a writer just acquired, stop allowing more readers this round.
+            if (w.mode === "write")
+                break;
+        }
+    }
+}
+export class LockManager {
+    locks = new Map();
+    global = new RWLock();
+    canonicalCache = new Map();
+    canonicalKey(key) {
+        const cached = this.canonicalCache.get(key);
+        if (cached !== undefined)
+            return cached;
+        const k = canonical(key);
+        this.canonicalCache.set(key, k);
+        return k;
+    }
+    getLock(key) {
+        const k = this.canonicalKey(key);
+        let l = this.locks.get(k);
+        if (!l) {
+            l = new RWLock();
+            this.locks.set(k, l);
+        }
+        return l;
+    }
+    async acquireRead(key, signal) {
+        const g = await this.global.acquire("read", signal);
+        const f = await this.getLock(key).acquire("read", signal);
+        return () => {
+            f();
+            g();
+        };
+    }
+    async acquireWrite(key, signal) {
+        const g = await this.global.acquire("read", signal);
+        const f = await this.getLock(key).acquire("write", signal);
+        return () => {
+            f();
+            g();
+        };
+    }
+    async acquireGlobal(signal) {
+        return this.global.acquire("write", signal);
+    }
+    /** Shared barrier used by parallel bash calls: exclusive with file ops. */
+    async acquireGlobalBarrier(signal) {
+        return this.global.acquire("barrier", signal);
+    }
+}
+//# sourceMappingURL=locks.js.map

package/dist/runtime/locks.js.map

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

package/dist/runtime/scheduler.d.ts

@@ -0,0 +1,7 @@
+import type { ToolCall } from "../types.js";
+import type { Tool, ToolContext } from "../tools/types.js";
+import type { ToolResult } from "../tools/types.js";
+import { LockManager, type Release } from "./locks.js";
+export declare function executeToolBatch(calls: ToolCall[], toolMap: Map<string, Tool>, ctx: ToolContext, maxParallel: number, signal: AbortSignal, lockManager?: LockManager, bashConcurrency?: "serial" | "parallel"): Promise<ToolResult[]>;
+export { LockManager };
+export type { Release };

package/dist/runtime/scheduler.js

@@ -0,0 +1,110 @@
+import { resolve } from "node:path";
+import { LockManager } from "./locks.js";
+function resourceKey(call, workspace) {
+    const args = call.arguments ?? {};
+    if (call.name === "bash")
+        return "__bash__";
+    const p = args.path ?? args.cwd ?? "";
+    const key = String(p);
+    return key === "" ? "" : resolve(workspace, key);
+}
+function isMutation(call) {
+    return call.name === "write" || call.name === "edit";
+}
+function isBash(call) {
+    return call.name === "bash";
+}
+function isRemote(call) {
+    return call.name.startsWith("mcp__");
+}
+export async function executeToolBatch(calls, toolMap, ctx, maxParallel, signal, lockManager, bashConcurrency = "serial") {
+    const lm = lockManager ?? new LockManager();
+    const n = calls.length;
+    const results = new Array(n);
+    const acquire = async (call) => {
+        if (isBash(call)) {
+            return bashConcurrency === "parallel"
+                ? lm.acquireGlobalBarrier(signal)
+                : lm.acquireGlobal(signal);
+        }
+        if (call.name === "webfetch" || call.name === "websearch") {
+            // No file lock; network-only. Return a no-op release.
+            return () => { };
+        }
+        if (isRemote(call)) {
+            // MCP tools own their side effects; Atom-lite cannot infer file paths.
+            return () => { };
+        }
+        const key = resourceKey(call, ctx.workspace);
+        if (key === "")
+            return () => { };
+        if (isMutation(call))
+            return lm.acquireWrite(key, signal);
+        return lm.acquireRead(key, signal);
+    };
+    // Concurrency pool
+    let active = 0;
+    const queue = [];
+    function acquireSlot() {
+        return new Promise((resolve) => {
+            if (active < maxParallel) {
+                active++;
+                resolve();
+            }
+            else {
+                queue.push(resolve);
+            }
+        });
+    }
+    function releaseSlot() {
+        if (queue.length > 0) {
+            const next = queue.shift();
+            next();
+        }
+        else {
+            active--;
+        }
+    }
+    const tasks = calls.map((call, i) => {
+        return (async () => {
+            if (signal.aborted) {
+                results[i] = { toolCallId: call.id, name: call.name, content: "USER_CANCELLED", isError: true };
+                return;
+            }
+            let release;
+            await acquireSlot();
+            try {
+                release = await acquire(call);
+                if (signal.aborted) {
+                    results[i] = { toolCallId: call.id, name: call.name, content: "USER_CANCELLED", isError: true };
+                    return;
+                }
+                const tool = toolMap.get(call.name);
+                if (!tool) {
+                    results[i] = { toolCallId: call.id, name: call.name, content: `TOOL_NOT_FOUND: ${call.name}`, isError: true };
+                }
+                else {
+                    const r = await tool.execute(call, ctx);
+                    results[i] = r;
+                }
+            }
+            catch (err) {
+                results[i] = {
+                    toolCallId: call.id,
+                    name: call.name,
+                    content: `COMMAND_FAILED: ${err instanceof Error ? err.message : String(err)}`,
+                    isError: true,
+                };
+            }
+            finally {
+                if (release)
+                    release();
+                releaseSlot();
+            }
+        })();
+    });
+    await Promise.all(tasks);
+    return results;
+}
+export { LockManager };
+//# sourceMappingURL=scheduler.js.map

package/dist/runtime/scheduler.js.map

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

package/dist/security/paths.d.ts

@@ -0,0 +1 @@
+export declare function isWithinWorkspace(workspace: string, target: string): boolean;

package/dist/security/paths.js

@@ -0,0 +1,35 @@
+import { resolve, relative, isAbsolute, dirname } from "node:path";
+import { realpathSync, existsSync } from "node:fs";
+export function isWithinWorkspace(workspace, target) {
+    const ws = resolve(workspace);
+    const wsReal = existsSync(ws) ? safeRealpath(ws) : ws;
+    const resolvedTarget = resolve(ws, target);
+    // Resolve symlinks for the target or, if it does not exist yet, for the
+    // nearest existing ancestor, so symlinked parent directories are caught.
+    let realTarget = resolvedTarget;
+    let cursor = resolvedTarget;
+    while (!existsSync(cursor) && cursor !== ws && cursor !== dirname(cursor)) {
+        cursor = dirname(cursor);
+    }
+    if (existsSync(cursor)) {
+        try {
+            const realCursor = realpathSync(cursor);
+            const suffix = resolvedTarget.slice(cursor.length);
+            realTarget = realCursor + suffix;
+        }
+        catch {
+            // fall back to lexical
+        }
+    }
+    const rel = relative(wsReal, realTarget);
+    return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
+}
+function safeRealpath(p) {
+    try {
+        return realpathSync(p);
+    }
+    catch {
+        return p;
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/security/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/security/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEnD,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,MAAc;IACjE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,MAAM,cAAc,GAAG,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAE3C,wEAAwE;IACxE,yEAAyE;IACzE,IAAI,UAAU,GAAG,cAAc,CAAC;IAChC,IAAI,MAAM,GAAG,cAAc,CAAC;IAC5B,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1E,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACnD,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,uBAAuB;QACzB,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACzC,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/security/process.d.ts

@@ -0,0 +1 @@
+export declare function defaultShell(): string;

package/dist/security/process.js

@@ -0,0 +1,8 @@
+// Process policy helpers (full implementation in later tickets).
+export function defaultShell() {
+    if (process.platform === "win32") {
+        return process.env.ComSpec ?? "cmd.exe";
+    }
+    return process.env.SHELL ?? "/bin/sh";
+}
+//# sourceMappingURL=process.js.map

package/dist/security/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/security/process.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,UAAU,YAAY;IAC1B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,SAAS,CAAC;AACxC,CAAC"}

package/dist/security/redaction.d.ts

@@ -0,0 +1 @@
+export declare function redactSecrets(text: string): string;

package/dist/security/redaction.js

@@ -0,0 +1,4 @@
+export function redactSecrets(text) {
+    return text.replace(/((?:api[_-]?key|token|secret|password|authorization)\s*[:=]\s*)\S+/gi, "$1[REDACTED]");
+}
+//# sourceMappingURL=redaction.js.map

package/dist/security/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../src/security/redaction.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,OAAO,CACjB,sEAAsE,EACtE,cAAc,CACf,CAAC;AACJ,CAAC"}

package/dist/sessions/events.d.ts

@@ -0,0 +1,30 @@
+import type { Message } from "../types.js";
+export interface SessionEvent {
+    type: string;
+    timestamp: string;
+    sessionId: string;
+    seq: number;
+    [key: string]: unknown;
+}
+export interface SessionSummary {
+    id: string;
+    workspace: string;
+    provider: string;
+    createdAt?: string;
+    updatedAt?: string;
+    eventCount?: number;
+    filePath?: string;
+    /** Derived title: first user message or the latest session_renamed title. */
+    title?: string;
+    /** Number of retained user, assistant, and tool messages. */
+    messageCount?: number;
+    /** Combined title/content/workspace haystack used by session search. */
+    searchText?: string;
+    /** Matching excerpt, populated by searchSessions. */
+    snippet?: string;
+}
+export declare function contentPartsText(content: unknown): string;
+export declare function nowIso(): string;
+export declare function messageToEvent(message: Message, sessionId: string, seq: number): SessionEvent;
+export declare function eventToMessage(event: SessionEvent): Message | null;
+export declare function isMessage(value: unknown): value is Message;

package/dist/sessions/events.js

@@ -0,0 +1,92 @@
+export function contentPartsText(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .map((part) => (part?.type === "text" ? String(part.text ?? "") : ""))
+        .join("");
+}
+export function nowIso() {
+    return new Date().toISOString();
+}
+export function messageToEvent(message, sessionId, seq) {
+    const timestamp = nowIso();
+    if (message.role === "user") {
+        const text = contentPartsText(message.content);
+        return {
+            type: "user_message",
+            timestamp,
+            sessionId,
+            seq,
+            content: text,
+            message,
+        };
+    }
+    if (message.role === "assistant") {
+        const text = contentPartsText(message.content ?? []);
+        return {
+            type: "assistant_message",
+            timestamp,
+            sessionId,
+            seq,
+            content: text,
+            message,
+            toolCalls: message.toolCalls,
+        };
+    }
+    if (message.role === "tool") {
+        return {
+            type: "tool_result",
+            timestamp,
+            sessionId,
+            seq,
+            toolCallId: message.toolCallId,
+            name: message.name,
+            content: message.content,
+        };
+    }
+    return { type: "assistant_message", timestamp, sessionId, seq, message };
+}
+export function eventToMessage(event) {
+    if (event.type === "user_message") {
+        if (event.message && typeof event.message === "object") {
+            return event.message;
+        }
+        return {
+            role: "user",
+            content: [{ type: "text", text: String(event.content ?? "") }],
+        };
+    }
+    if (event.type === "assistant_message") {
+        if (event.message && typeof event.message === "object") {
+            return event.message;
+        }
+        const toolCalls = Array.isArray(event.toolCalls)
+            ? event.toolCalls
+            : undefined;
+        return {
+            role: "assistant",
+            content: event.content
+                ? [{ type: "text", text: String(event.content) }]
+                : undefined,
+            toolCalls,
+        };
+    }
+    if (event.type === "tool_result") {
+        return {
+            role: "tool",
+            toolCallId: String(event.toolCallId ?? ""),
+            name: String(event.name ?? ""),
+            content: String(event.content ?? ""),
+        };
+    }
+    return null;
+}
+export function isMessage(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const r = value.role;
+    return r === "system" || r === "user" || r === "assistant" || r === "tool";
+}
+//# sourceMappingURL=events.js.map

package/dist/sessions/events.js.map

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

package/dist/sessions/history.d.ts

@@ -0,0 +1,18 @@
+import type { Message } from "../types.js";
+import type { SessionEvent } from "./events.js";
+/**
+ * Render retained messages for the restored transcript. System messages are
+ * omitted: they are prompt scaffolding, not conversation history.
+ */
+export declare function sessionHistoryLines(messages: Message[]): string[];
+export interface SessionSelection {
+    provider?: string;
+    model?: string;
+}
+/** Provider/model last selected inside a session, newest event wins. */
+export declare function sessionSelectionFromEvents(events: SessionEvent[]): SessionSelection;
+/**
+ * A short offer to switch provider/model when a resumed session differs from
+ * the currently active one.
+ */
+export declare function providerSwitchNotice(current: SessionSelection, saved: SessionSelection): string | undefined;

package/dist/sessions/history.js

@@ -0,0 +1,76 @@
+import { contentPartsText } from "./events.js";
+function contentText(content) {
+    return contentPartsText(content);
+}
+/**
+ * Render retained messages for the restored transcript. System messages are
+ * omitted: they are prompt scaffolding, not conversation history.
+ */
+export function sessionHistoryLines(messages) {
+    const lines = [];
+    for (const message of messages) {
+        if (message.role === "system")
+            continue;
+        if (message.role === "user") {
+            const text = contentText(message.content).trim();
+            if (text)
+                lines.push(`> ${text}`);
+            continue;
+        }
+        if (message.role === "assistant") {
+            const text = contentText(message.content).trim();
+            if (text)
+                lines.push(text);
+            for (const call of message.toolCalls ?? []) {
+                const args = JSON.stringify(call.arguments ?? {});
+                lines.push(`⚙ ${call.name} ${args}`);
+            }
+            continue;
+        }
+        if (message.role === "tool") {
+            const text = message.content.trim();
+            if (text)
+                lines.push(`[${message.name}] ${text}`);
+        }
+    }
+    return lines;
+}
+/** Provider/model last selected inside a session, newest event wins. */
+export function sessionSelectionFromEvents(events) {
+    let provider;
+    let model;
+    for (const event of events) {
+        if (event.type === "session_started") {
+            provider = typeof event.provider === "string" ? event.provider : provider;
+        }
+        else if (event.type === "provider_selected" ||
+            event.type === "model_switched") {
+            provider =
+                typeof event.provider === "string" ? event.provider : provider;
+            model = typeof event.model === "string" ? event.model : model;
+        }
+    }
+    return { provider, model };
+}
+/**
+ * A short offer to switch provider/model when a resumed session differs from
+ * the currently active one.
+ */
+export function providerSwitchNotice(current, saved) {
+    const savedLabel = saved.provider
+        ? `${saved.provider}${saved.model ? `/${saved.model}` : ""}`
+        : saved.model;
+    const currentLabel = current.provider
+        ? `${current.provider}${current.model ? `/${current.model}` : ""}`
+        : current.model;
+    if (!savedLabel || !currentLabel)
+        return undefined;
+    if (saved.provider && current.provider && saved.provider !== current.provider) {
+        return `this session used ${savedLabel}; current provider is ${currentLabel}. Run /model or /provider to switch.`;
+    }
+    if (saved.model && current.model && saved.model !== current.model) {
+        return `this session used ${savedLabel}; current model is ${currentLabel}. Run /model to switch.`;
+    }
+    return undefined;
+}
+//# sourceMappingURL=history.js.map

package/dist/sessions/history.js.map

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

package/dist/sessions/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./store.js";
+export * from "./events.js";
+export * from "./recovery.js";
+export * from "./search.js";
+export * from "./history.js";

package/dist/sessions/index.js

@@ -0,0 +1,6 @@
+export * from "./store.js";
+export * from "./events.js";
+export * from "./recovery.js";
+export * from "./search.js";
+export * from "./history.js";
+//# sourceMappingURL=index.js.map

package/dist/sessions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sessions/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/sessions/recovery.d.ts

@@ -0,0 +1,6 @@
+import type { SessionEvent } from "./events.js";
+export declare function parseJsonlEvents(filePath: string): SessionEvent[];
+export declare function recoverTail(filePath: string): {
+    events: SessionEvent[];
+    dropped: number;
+};