@veewo/claw 0.2.2 → 0.2.4

package/dist/session-daemon.js

@@ -0,0 +1,363 @@
+import { randomBytes, randomUUID } from "node:crypto";
+import fs from "node:fs";
+import net from "node:net";
+import path from "node:path";
+import { SESSION_PROTOCOL_VERSION, } from "@veewo/claw-client";
+import { ClawError, recoverProjectFocusTransitions, releaseCurrentPlanFocus, resolveProjectContext, writeJsonFileAtomic, } from "@veewo/claw-core";
+import { ClawCommandService } from "./command-service.js";
+import { RegistryFocusSessionStore, SessionRegistryV2, createSessionIdentity, ensurePrivateDirectory, sessionFocusKey, } from "./session-registry-v2.js";
+const MAX_PROTOCOL_LINE_BYTES = 1024 * 1024;
+const SESSION_PASSTHROUGH_ERRORS = new Set([
+    "SESSION_NOT_FOUND",
+    "SESSION_EXPIRED",
+    "SESSION_IDENTITY_INVALID",
+    "CURRENT_PLAN_REQUIRED",
+    "PLAN_NOT_FOUND",
+    "PLAN_NOT_RESUMABLE",
+    "PLAN_FOCUS_CONFLICT",
+    "PLAN_TRANSITION_CONFLICT",
+    "FOCUS_RECOVERY_CONFLICT",
+    "SESSION_OPERATION_UNSUPPORTED",
+]);
+export async function startSessionDaemon(options) {
+    const registry = new SessionRegistryV2(options?.runtimeRoot);
+    ensurePrivateDirectory(path.join(registry.runtimeRoot, "daemon"));
+    const releaseStartLock = acquireStartLock(registry.runtimeRoot);
+    registry.recover();
+    const focusStore = new RegistryFocusSessionStore(registry);
+    const service = new ClawCommandService(registry);
+    const token = randomBytes(32).toString("hex");
+    const activeSessions = new Map();
+    const connections = new Set();
+    const server = net.createServer();
+    let idleTimer;
+    let closing = false;
+    const cleanupExpiredSessions = async () => {
+        const live = new Set(activeSessions.keys());
+        for (const expired of registry.listExpiredRecords(new Date(), live)) {
+            if (expired.record.currentPlan) {
+                const identity = createSessionIdentity(expired.record.agentSessionId, expired.record.canonicalWorkdir);
+                try {
+                    const project = resolveProjectContext(identity.canonicalWorkdir);
+                    await releaseCurrentPlanFocus({
+                        project,
+                        sessionKey: sessionFocusKey(identity),
+                        kind: "expire",
+                        sessionStore: focusStore,
+                    });
+                }
+                catch (error) {
+                    if (error instanceof ClawError)
+                        continue;
+                    throw error;
+                }
+            }
+            registry.removeReleasedExpired(expired.sessionKeyHash);
+        }
+    };
+    const scheduleIdle = () => {
+        if (idleTimer)
+            clearTimeout(idleTimer);
+        if (connections.size > 0)
+            return;
+        const idleTtlMs = options?.idleTtlMs
+            ?? Number(process.env.CLAW_SESSION_DAEMON_IDLE_TTL_MS ?? 300_000);
+        if (!Number.isFinite(idleTtlMs) || idleTtlMs <= 0)
+            return;
+        idleTimer = setTimeout(() => {
+            void close();
+        }, idleTtlMs);
+        idleTimer.unref();
+    };
+    const detach = async (connection) => {
+        if (!connection.sessionKeyHash)
+            return;
+        if (activeSessions.get(connection.sessionKeyHash) === connection) {
+            activeSessions.delete(connection.sessionKeyHash);
+            try {
+                await registry.close(connection.sessionKeyHash);
+            }
+            catch {
+                // Socket teardown must not be blocked by retained-state diagnostics.
+            }
+        }
+        connection.sessionHandle = undefined;
+        connection.sessionKeyHash = undefined;
+    };
+    const close = async () => {
+        if (closing)
+            return;
+        closing = true;
+        if (idleTimer)
+            clearTimeout(idleTimer);
+        await Promise.all([...connections].map((connection) => detach(connection)));
+        for (const connection of connections)
+            connection.socket.destroy();
+        await new Promise((resolve) => server.close(() => resolve()));
+        removeOwnedState(registry.runtimeRoot, token);
+    };
+    server.on("connection", (socket) => {
+        socket.setEncoding("utf-8");
+        const connection = {
+            socket,
+            buffer: "",
+            chain: Promise.resolve(),
+        };
+        connections.add(connection);
+        if (idleTimer)
+            clearTimeout(idleTimer);
+        socket.on("data", (chunk) => {
+            connection.buffer += String(chunk);
+            if (Buffer.byteLength(connection.buffer, "utf-8") > MAX_PROTOCOL_LINE_BYTES) {
+                socket.destroy(new Error("Session protocol frame exceeds the 1 MiB limit."));
+                return;
+            }
+            while (true) {
+                const lineEnd = connection.buffer.indexOf("\n");
+                if (lineEnd < 0)
+                    break;
+                const line = connection.buffer.slice(0, lineEnd).trim();
+                connection.buffer = connection.buffer.slice(lineEnd + 1);
+                if (!line)
+                    continue;
+                connection.chain = connection.chain.then(async () => {
+                    const response = await handleLine(line, connection);
+                    if (!socket.destroyed)
+                        socket.write(`${JSON.stringify(response)}\n`);
+                    if (response.ok
+                        && JSON.parse(line).operation === "session.close"
+                        && !socket.destroyed) {
+                        socket.end();
+                    }
+                }).catch(() => {
+                    socket.destroy();
+                });
+            }
+        });
+        socket.on("close", () => {
+            connections.delete(connection);
+            void detach(connection).finally(scheduleIdle);
+        });
+        socket.on("error", () => {
+            // close owns retained state cleanup.
+        });
+    });
+    const handleLine = async (line, connection) => {
+        let request;
+        try {
+            request = JSON.parse(line);
+        }
+        catch {
+            return errorResponse("", "SESSION_PROTOCOL_INVALID", "Invalid JSONL request.");
+        }
+        if (request.protocolVersion !== SESSION_PROTOCOL_VERSION) {
+            return errorResponse(request.requestId, "SESSION_PROTOCOL_UNSUPPORTED", "Unsupported session protocol version.");
+        }
+        if (request.token !== token) {
+            return errorResponse(request.requestId, "SESSION_AUTH_FAILED", "Invalid session daemon token.");
+        }
+        try {
+            if (request.operation === "session.open") {
+                await cleanupExpiredSessions();
+                await detach(connection);
+                const identity = createSessionIdentity(request.input.agentSessionId, request.input.workdir);
+                const active = activeSessions.get(identity.sessionKeyHash);
+                if (active && active !== connection) {
+                    throw new ClawError("PLAN_TRANSITION_CONFLICT", "SESSION_BUSY", {
+                        code: "SESSION_BUSY",
+                        sessionKeyHash: identity.sessionKeyHash,
+                    });
+                }
+                const opened = await registry.open(request.input.agentSessionId, request.input.workdir, request.input.client);
+                connection.sessionHandle = randomUUID();
+                connection.sessionKeyHash = identity.sessionKeyHash;
+                connection.agentSessionId = identity.agentSessionId;
+                connection.canonicalWorkdir = identity.canonicalWorkdir;
+                connection.focusKey = sessionFocusKey(identity);
+                connection.host = request.input.client.host;
+                activeSessions.set(identity.sessionKeyHash, connection);
+                try {
+                    const project = resolveProjectContext(identity.canonicalWorkdir);
+                    await recoverProjectFocusTransitions({ project, sessionStore: focusStore });
+                }
+                catch (error) {
+                    if (error instanceof ClawError && error.code === "FOCUS_RECOVERY_CONFLICT")
+                        throw error;
+                }
+                const currentPlan = !opened.created && opened.record.currentPlan
+                    ? (await service.execute({
+                        cwd: identity.canonicalWorkdir,
+                        agentSessionId: identity.agentSessionId,
+                        sessionKey: sessionFocusKey(identity),
+                        host: request.input.client.host,
+                        mode: "session",
+                    }, {
+                        operation: "plan.show",
+                        input: { simple: true },
+                    })).output
+                    : undefined;
+                return successResponse(request.requestId, {
+                    sessionHandle: connection.sessionHandle,
+                    session: opened.record,
+                    ...(currentPlan ? { currentPlan } : {}),
+                });
+            }
+            assertAttached(request, connection);
+            if (request.operation === "session.status") {
+                return successResponse(request.requestId, {
+                    session: registry.read(connection.sessionKeyHash),
+                    daemon: {
+                        schemaVersion: state.schemaVersion,
+                        protocolVersion: state.protocolVersion,
+                        pid: state.pid,
+                        host: state.host,
+                        port: state.port,
+                        startedAt: state.startedAt,
+                    },
+                });
+            }
+            if (request.operation === "session.close") {
+                const closed = await registry.close(connection.sessionKeyHash);
+                activeSessions.delete(connection.sessionKeyHash);
+                connection.sessionKeyHash = undefined;
+                return successResponse(request.requestId, { session: closed });
+            }
+            const result = await service.execute({
+                cwd: connection.canonicalWorkdir,
+                agentSessionId: connection.agentSessionId,
+                sessionKey: connection.focusKey,
+                host: connection.host,
+                mode: "session",
+            }, request.input);
+            await registry.touch(connection.sessionKeyHash);
+            return successResponse(request.requestId, {
+                schemaVersion: 1,
+                output: result.output,
+                ...(result.hostActions?.length ? { hostActions: result.hostActions } : {}),
+                ...(result.postCommitEffects?.length ? { postCommitEffects: result.postCommitEffects } : {}),
+                ...(result.knowledgeDispatch ? { knowledgeDispatch: result.knowledgeDispatch } : {}),
+            });
+        }
+        catch (error) {
+            if (error instanceof ClawError) {
+                const code = error.details?.code === "SESSION_BUSY"
+                    ? "SESSION_BUSY"
+                    : SESSION_PASSTHROUGH_ERRORS.has(error.code)
+                        ? error.code
+                        : "SESSION_COMMAND_FAILED";
+                return errorResponse(request.requestId, code, error.message, {
+                    ...(error.details ?? {}),
+                    ...(code === "SESSION_COMMAND_FAILED" ? { coreCode: error.code } : {}),
+                });
+            }
+            return errorResponse(request.requestId, "SESSION_INTERNAL_ERROR", error instanceof Error ? error.message : String(error));
+        }
+    };
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(0, "127.0.0.1", () => {
+            server.off("error", reject);
+            resolve();
+        });
+    });
+    const address = server.address();
+    if (!address || typeof address === "string") {
+        throw new Error("Session daemon failed to bind a loopback TCP port.");
+    }
+    const state = {
+        schemaVersion: 1,
+        protocolVersion: SESSION_PROTOCOL_VERSION,
+        pid: process.pid,
+        host: "127.0.0.1",
+        port: address.port,
+        token,
+        startedAt: new Date().toISOString(),
+    };
+    const statePath = path.join(registry.runtimeRoot, "daemon", "state.json");
+    writeJsonFileAtomic(statePath, state);
+    try {
+        fs.chmodSync(statePath, 0o600);
+    }
+    catch {
+        // Windows ACLs are inherited from the user runtime directory.
+    }
+    releaseStartLock();
+    scheduleIdle();
+    return { state, close };
+}
+function assertAttached(request, connection) {
+    if (!connection.sessionHandle || request.sessionHandle !== connection.sessionHandle) {
+        throw new ClawError("PLAN_TRANSITION_CONFLICT", "Invalid or closed session handle.", {
+            code: "SESSION_HANDLE_INVALID",
+        });
+    }
+}
+function successResponse(requestId, output) {
+    return { ok: true, requestId, output };
+}
+function errorResponse(requestId, code, message, details) {
+    return {
+        ok: false,
+        requestId,
+        error: {
+            code,
+            message,
+            retryable: code === "SESSION_BUSY",
+            outcome: "known",
+            ...(details ? { details } : {}),
+        },
+    };
+}
+function acquireStartLock(runtimeRoot) {
+    const lockPath = path.join(runtimeRoot, "daemon", "start.lock");
+    fs.mkdirSync(path.dirname(lockPath), { recursive: true });
+    try {
+        fs.writeFileSync(lockPath, JSON.stringify({ pid: process.pid }), { flag: "wx" });
+    }
+    catch (error) {
+        if (error.code !== "EEXIST")
+            throw error;
+        try {
+            const owner = JSON.parse(fs.readFileSync(lockPath, "utf-8"));
+            if (owner.pid && isProcessAlive(owner.pid)) {
+                throw new Error("Another session daemon is starting.");
+            }
+            fs.unlinkSync(lockPath);
+            fs.writeFileSync(lockPath, JSON.stringify({ pid: process.pid }), { flag: "wx" });
+        }
+        catch (nested) {
+            throw nested;
+        }
+    }
+    return () => {
+        try {
+            const owner = JSON.parse(fs.readFileSync(lockPath, "utf-8"));
+            if (owner.pid === process.pid)
+                fs.unlinkSync(lockPath);
+        }
+        catch {
+            // Already released.
+        }
+    };
+}
+function removeOwnedState(runtimeRoot, token) {
+    const statePath = path.join(runtimeRoot, "daemon", "state.json");
+    try {
+        const state = JSON.parse(fs.readFileSync(statePath, "utf-8"));
+        if (state.token === token)
+            fs.unlinkSync(statePath);
+    }
+    catch {
+        // Discovery state is already absent or belongs to a replacement daemon.
+    }
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === "EPERM";
+    }
+}
+//# sourceMappingURL=session-daemon.js.map

package/dist/session-daemon.js.map

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

package/dist/session-registry-v2.d.ts

@@ -0,0 +1,66 @@
+import { type FocusSessionRecord, type FocusSessionStore, type PlanRef } from "@veewo/claw-core";
+export declare const SESSION_RECORD_TTL_MS: number;
+export type SessionClientInfo = {
+    kind: "terminal" | "node" | "adapter";
+    host?: string;
+};
+export type SessionRecordV2 = {
+    schemaVersion: 2;
+    agentSessionId: string;
+    canonicalWorkdir: string;
+    state: "live" | "disconnected";
+    currentPlan?: PlanRef;
+    createdAt: string;
+    updatedAt: string;
+    lastConnectedAt: string;
+    expiresAt: string;
+    lastClient?: SessionClientInfo;
+};
+export type SessionIdentityV2 = {
+    agentSessionId: string;
+    canonicalWorkdir: string;
+    sessionKeyHash: string;
+};
+export declare function resolveSessionDaemonRuntimeRoot(env?: NodeJS.ProcessEnv): string;
+export declare function canonicalizeSessionWorkdir(workdir: string): string;
+export declare function createSessionIdentity(agentSessionId: string, workdir: string): SessionIdentityV2;
+export declare function sessionFocusKey(identity: Pick<SessionIdentityV2, "canonicalWorkdir" | "agentSessionId">): string;
+export declare class SessionRegistryV2 {
+    readonly runtimeRoot: string;
+    constructor(runtimeRoot?: string);
+    open(agentSessionId: string, workdir: string, client: SessionClientInfo, now?: Date): Promise<{
+        identity: SessionIdentityV2;
+        record: SessionRecordV2;
+        created: boolean;
+    }>;
+    close(sessionKeyHash: string, now?: Date): Promise<SessionRecordV2>;
+    touch(sessionKeyHash: string, now?: Date): Promise<SessionRecordV2>;
+    read(sessionKeyHash: string): SessionRecordV2;
+    write(sessionKeyHash: string, record: SessionRecordV2): void;
+    recover(now?: Date): {
+        normalized: string[];
+        removed: string[];
+    };
+    cleanupExpired(now?: Date, liveSessionKeys?: Set<string>): string[];
+    listExpiredRecords(now?: Date, liveSessionKeys?: Set<string>): Array<{
+        sessionKeyHash: string;
+        record: SessionRecordV2;
+    }>;
+    removeExpired(sessionKeyHash: string, now?: Date): boolean;
+    removeReleasedExpired(sessionKeyHash: string): boolean;
+    recordPath(sessionKeyHash: string): string;
+    commandQueuePath(sessionKeyHash: string): string;
+    sessionDirectory(sessionKeyHash: string): string;
+    private listSessionKeys;
+    private removeSessionDirectory;
+}
+export declare function ensurePrivateDirectory(directory: string): void;
+export declare class RegistryFocusSessionStore implements FocusSessionStore {
+    readonly registry: SessionRegistryV2;
+    constructor(registry: SessionRegistryV2);
+    read(sessionKeyHash: string): FocusSessionRecord;
+    buildPersistedRecord(sessionKeyHash: string, focus: FocusSessionRecord): unknown;
+    writePersistedAtomic(sessionKeyHash: string, persistedRecord: unknown): void;
+    queuePath(sessionKeyHash: string): string;
+    resourcePath(sessionKeyHash: string): string;
+}