@jstn-sdk/rcs 0.1.0

package/dist/exec/followup.js

@@ -0,0 +1,349 @@
+import { randomUUID } from "crypto";
+import { existsSync, readFileSync } from "fs";
+import { appendFile, mkdir, readFile, rename, rm, stat, writeFile } from "fs/promises";
+import { dirname, join } from "path";
+import { isSessionStateUsable, readUsableSessionState } from "../hooks/session.js";
+const QUEUE_FILE = "exec-followups.json";
+const SESSION_ID_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;
+const QUEUE_LOCK_STALE_MS = 30_000;
+const QUEUE_LOCK_RETRY_MS = 10;
+const QUEUE_LOCK_MAX_WAIT_MS = 5_000;
+function stateDir(cwd) {
+    return join(cwd, ".rcs", "state");
+}
+function sessionQueuePath(cwd, sessionId) {
+    return join(stateDir(cwd), "sessions", sessionId, QUEUE_FILE);
+}
+function sessionQueueLockPath(queuePath) {
+    return `${queuePath}.lock`;
+}
+function auditLogPath(cwd, nowIso) {
+    return join(cwd, ".rcs", "logs", `exec-followups-${nowIso.slice(0, 10)}.jsonl`);
+}
+function safeTimestampForPath(nowIso) {
+    return nowIso.replace(/[^0-9A-Za-z_-]/g, "-");
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+async function sleep(ms) {
+    await new Promise((resolve) => setTimeout(resolve, ms));
+}
+function normalizeSessionId(sessionId) {
+    const normalized = sessionId.trim();
+    if (!SESSION_ID_PATTERN.test(normalized)) {
+        throw new Error("invalid_session_id");
+    }
+    return normalized;
+}
+function normalizePrompt(prompt) {
+    const normalized = prompt.trim();
+    if (!normalized)
+        throw new Error("missing_prompt");
+    return normalized;
+}
+function normalizeActor(actor) {
+    const normalized = (actor || process.env.USER || process.env.USERNAME || "unknown").trim();
+    return normalized || "unknown";
+}
+async function appendAudit(cwd, event, nowIso) {
+    const path = auditLogPath(cwd, nowIso);
+    await mkdir(dirname(path), { recursive: true });
+    await appendFile(path, JSON.stringify({ ...event, timestamp: nowIso }) + "\n");
+}
+async function quarantineCorruptQueue(path, sessionId, options) {
+    const quarantinePath = `${path}.corrupt-${safeTimestampForPath(options.nowIso)}`;
+    let quarantined = false;
+    try {
+        await rename(path, quarantinePath);
+        quarantined = true;
+    }
+    catch (error) {
+        if (error.code !== "ENOENT") {
+            await appendAudit(options.cwd, {
+                event: "exec_followup_queue_corrupt_quarantine_failed",
+                session_id: sessionId,
+                queue_path: path,
+                quarantine_path: quarantinePath,
+                error: errorMessage(error),
+                parse_error: errorMessage(options.error),
+            }, options.nowIso);
+        }
+    }
+    await appendAudit(options.cwd, {
+        event: "exec_followup_queue_corrupt_recovered",
+        session_id: sessionId,
+        queue_path: path,
+        ...(quarantined ? { quarantine_path: quarantinePath } : {}),
+        error: errorMessage(options.error),
+    }, options.nowIso);
+    const recovered = { version: 1, session_id: sessionId, records: [] };
+    await writeQueue(path, recovered);
+    return recovered;
+}
+async function readQueue(path, sessionId, options) {
+    if (!existsSync(path)) {
+        return { version: 1, session_id: sessionId, records: [] };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(path, "utf-8"));
+    }
+    catch (error) {
+        if (options?.recoverCorrupt) {
+            return await quarantineCorruptQueue(path, sessionId, {
+                cwd: options.cwd,
+                nowIso: options.nowIso,
+                error,
+            });
+        }
+        throw error;
+    }
+    const records = Array.isArray(parsed.records) ? parsed.records : [];
+    return {
+        version: 1,
+        session_id: typeof parsed.session_id === "string" && parsed.session_id.trim()
+            ? parsed.session_id.trim()
+            : sessionId,
+        records: records.filter((record) => (typeof record === "object"
+            && record !== null
+            && typeof record.id === "string"
+            && typeof record.session_id === "string"
+            && typeof record.actor === "string"
+            && typeof record.prompt === "string"
+            && typeof record.created_at === "string")),
+    };
+}
+async function writeQueue(path, queue) {
+    await mkdir(dirname(path), { recursive: true });
+    const tempPath = `${path}.${process.pid}.${randomUUID()}.tmp`;
+    await writeFile(tempPath, JSON.stringify(queue, null, 2) + "\n");
+    await rename(tempPath, path);
+}
+async function withQueueLock(queuePath, operation) {
+    await mkdir(dirname(queuePath), { recursive: true });
+    const lockPath = sessionQueueLockPath(queuePath);
+    const start = Date.now();
+    while (true) {
+        try {
+            await mkdir(lockPath);
+            await writeFile(join(lockPath, "owner.json"), JSON.stringify({
+                pid: process.pid,
+                acquired_at: new Date().toISOString(),
+            }, null, 2));
+            try {
+                return await operation();
+            }
+            finally {
+                await rm(lockPath, { recursive: true, force: true });
+            }
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+            try {
+                const lockStat = await stat(lockPath);
+                if (Date.now() - lockStat.mtimeMs > QUEUE_LOCK_STALE_MS) {
+                    await rm(lockPath, { recursive: true, force: true });
+                    continue;
+                }
+            }
+            catch (statError) {
+                if (statError.code === "ENOENT")
+                    continue;
+                throw statError;
+            }
+            if (Date.now() - start > QUEUE_LOCK_MAX_WAIT_MS) {
+                throw new Error("exec_followup_queue_lock_timeout");
+            }
+            await sleep(QUEUE_LOCK_RETRY_MS);
+        }
+    }
+}
+export async function injectExecFollowup(options) {
+    const sessionId = normalizeSessionId(options.sessionId);
+    const prompt = normalizePrompt(options.prompt);
+    const actor = normalizeActor(options.actor);
+    const nowIso = options.nowIso ?? new Date().toISOString();
+    const active = await readUsableSessionState(options.cwd);
+    if (!active || !isSessionStateUsable(active, options.cwd)) {
+        throw new Error("job_not_input_accepting:no_active_exec_session");
+    }
+    if (active.session_id !== sessionId && active.native_session_id !== sessionId) {
+        throw new Error(`job_not_input_accepting:session_mismatch:${active.session_id}`);
+    }
+    const canonicalSessionId = active.session_id;
+    const queuePath = sessionQueuePath(options.cwd, canonicalSessionId);
+    const queued = {
+        id: randomUUID(),
+        session_id: canonicalSessionId,
+        actor,
+        prompt,
+        created_at: nowIso,
+    };
+    await withQueueLock(queuePath, async () => {
+        const queue = await readQueue(queuePath, canonicalSessionId, {
+            cwd: options.cwd,
+            nowIso,
+            recoverCorrupt: true,
+        });
+        queue.session_id = canonicalSessionId;
+        queue.records.push(queued);
+        await writeQueue(queuePath, queue);
+    });
+    await appendAudit(options.cwd, {
+        event: "exec_followup_queued",
+        followup_id: queued.id,
+        session_id: canonicalSessionId,
+        actor,
+        prompt,
+    }, nowIso);
+    return { queued, queuePath };
+}
+export async function readPendingExecFollowups(cwd, sessionId) {
+    const canonicalSessionId = normalizeSessionId(sessionId);
+    const queuePath = sessionQueuePath(cwd, canonicalSessionId);
+    const queue = await readQueue(queuePath, canonicalSessionId, {
+        cwd,
+        nowIso: new Date().toISOString(),
+        recoverCorrupt: true,
+    });
+    return {
+        queuePath,
+        pending: queue.records.filter((record) => !record.delivered_at),
+    };
+}
+export async function markExecFollowupsDelivered(cwd, sessionId, followupIds, options = {}) {
+    const canonicalSessionId = normalizeSessionId(sessionId);
+    const nowIso = options.nowIso ?? new Date().toISOString();
+    const queuePath = sessionQueuePath(cwd, canonicalSessionId);
+    await withQueueLock(queuePath, async () => {
+        const queue = await readQueue(queuePath, canonicalSessionId, {
+            cwd,
+            nowIso,
+            recoverCorrupt: true,
+        });
+        const ids = new Set(followupIds);
+        let changed = false;
+        for (const record of queue.records) {
+            if (!ids.has(record.id) || record.delivered_at)
+                continue;
+            record.delivered_at = nowIso;
+            record.delivery_event = options.deliveryEvent ?? "stop-hook";
+            changed = true;
+            await appendAudit(cwd, {
+                event: "exec_followup_delivered",
+                followup_id: record.id,
+                session_id: canonicalSessionId,
+                actor: record.actor,
+                delivery_event: record.delivery_event,
+            }, nowIso);
+        }
+        if (changed)
+            await writeQueue(queuePath, queue);
+    });
+}
+export async function buildExecFollowupStopOutput(cwd, sessionId) {
+    const normalizedSessionId = typeof sessionId === "string" ? sessionId.trim() : "";
+    if (!normalizedSessionId)
+        return null;
+    const { pending } = await readPendingExecFollowups(cwd, normalizedSessionId);
+    if (pending.length === 0)
+        return null;
+    const ids = pending.map((record) => record.id);
+    await markExecFollowupsDelivered(cwd, normalizedSessionId, ids, {
+        deliveryEvent: "stop-hook",
+    });
+    const rendered = pending.map((record, index) => (`Follow-up ${index + 1} (${record.id}) from ${record.actor} at ${record.created_at}:\n${record.prompt}`)).join("\n\n");
+    const systemMessage = `RCS exec has ${pending.length} queued follow-up instruction${pending.length === 1 ? "" : "s"} for this non-interactive job. ` +
+        "Treat them as the newest user instructions, continue the same run, and include the follow-up id(s) in your final audit summary.\n\n" +
+        rendered;
+    return {
+        decision: "block",
+        reason: `exec_followup_pending:${ids.join(",")}`,
+        systemMessage,
+    };
+}
+export function formatInjectExecFollowupSuccess(result) {
+    return [
+        `Queued exec follow-up ${result.queued.id} for session ${result.queued.session_id}.`,
+        `Queue: ${result.queuePath}`,
+        "Delivery: next Stop hook checkpoint; no tmux pane input was sent.",
+    ].join("\n");
+}
+export function parseExecInjectArgs(args) {
+    const [, sessionIdRaw, ...rest] = args;
+    const sessionId = sessionIdRaw?.trim();
+    if (!sessionId)
+        throw new Error("Usage: rcs exec inject <session-id> --prompt <text> [--actor <name>] [--json]");
+    let prompt = "";
+    let actor;
+    let json = false;
+    for (let i = 0; i < rest.length; i += 1) {
+        const arg = rest[i];
+        if (arg === "--json") {
+            json = true;
+        }
+        else if (arg === "--prompt") {
+            const value = rest[i + 1];
+            if (!value)
+                throw new Error("Missing value after --prompt");
+            prompt = value;
+            i += 1;
+        }
+        else if (arg.startsWith("--prompt=")) {
+            prompt = arg.slice("--prompt=".length);
+        }
+        else if (arg === "--prompt-file") {
+            const value = rest[i + 1];
+            if (!value)
+                throw new Error("Missing path after --prompt-file");
+            prompt = readFileSyncForCli(value);
+            i += 1;
+        }
+        else if (arg.startsWith("--prompt-file=")) {
+            prompt = readFileSyncForCli(arg.slice("--prompt-file=".length));
+        }
+        else if (arg === "--actor") {
+            const value = rest[i + 1];
+            if (!value)
+                throw new Error("Missing value after --actor");
+            actor = value;
+            i += 1;
+        }
+        else if (arg.startsWith("--actor=")) {
+            actor = arg.slice("--actor=".length);
+        }
+        else if (!arg.startsWith("-") && !prompt) {
+            prompt = [arg, ...rest.slice(i + 1)].join(" ");
+            break;
+        }
+        else {
+            throw new Error(`Unknown exec inject argument: ${arg}`);
+        }
+    }
+    return { sessionId, prompt, actor, json };
+}
+function readFileSyncForCli(path) {
+    return readFileSync(path, "utf-8");
+}
+export async function execInjectCommand(args, cwd = process.cwd()) {
+    const parsed = parseExecInjectArgs(args);
+    const result = await injectExecFollowup({
+        cwd,
+        sessionId: parsed.sessionId,
+        prompt: parsed.prompt,
+        actor: parsed.actor,
+    });
+    if (parsed.json) {
+        console.log(JSON.stringify({
+            ok: true,
+            queued: result.queued,
+            queue_path: result.queuePath,
+        }, null, 2));
+    }
+    else {
+        console.log(formatInjectExecFollowupSuccess(result));
+    }
+}
+//# sourceMappingURL=followup.js.map

package/dist/exec/followup.js.map

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

package/dist/hooks/__tests__/agents-overlay.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tests for AGENTS.md Runtime Overlay
+ *
+ * Covers: overlay generation, apply/strip roundtrip, idempotency,
+ * size cap enforcement, and graceful handling of missing state.
+ */
+export {};
+//# sourceMappingURL=agents-overlay.test.d.ts.map

package/dist/hooks/__tests__/agents-overlay.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-overlay.test.d.ts","sourceRoot":"","sources":["../../../src/hooks/__tests__/agents-overlay.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}