@farazirfan/costar-server-executor 1.0.0

package/dist/tools/process-registry.js

@@ -0,0 +1,185 @@
+/**
+ * CoStar Server Executor - Process Registry
+ * Based on OpenClaw's bash-process-registry.ts
+ *
+ * Tracks running and finished SHELL COMMAND sessions
+ * Used by exec and process tools to manage background processes
+ */
+import { createSessionSlug as createSessionSlugId } from "./session-slug.js";
+const DEFAULT_JOB_TTL_MS = 30 * 60 * 1000; // 30 minutes
+const MIN_JOB_TTL_MS = 60 * 1000; // 1 minute
+const MAX_JOB_TTL_MS = 3 * 60 * 60 * 1000; // 3 hours
+const DEFAULT_PENDING_OUTPUT_CHARS = 30_000;
+function clampTtl(value) {
+    if (!value || Number.isNaN(value))
+        return DEFAULT_JOB_TTL_MS;
+    return Math.min(Math.max(value, MIN_JOB_TTL_MS), MAX_JOB_TTL_MS);
+}
+let jobTtlMs = clampTtl(Number.parseInt(process.env.PI_BASH_JOB_TTL_MS ?? "", 10));
+const runningSessions = new Map();
+const finishedSessions = new Map();
+let sweeper = null;
+function isSessionIdTaken(id) {
+    return runningSessions.has(id) || finishedSessions.has(id);
+}
+export function createSessionSlug() {
+    return createSessionSlugId(isSessionIdTaken);
+}
+export function addSession(session) {
+    runningSessions.set(session.id, session);
+    startSweeper();
+}
+export function getSession(id) {
+    return runningSessions.get(id);
+}
+export function getFinishedSession(id) {
+    return finishedSessions.get(id);
+}
+export function deleteSession(id) {
+    runningSessions.delete(id);
+    finishedSessions.delete(id);
+}
+export function appendOutput(session, stream, chunk) {
+    session.pendingStdout ??= [];
+    session.pendingStderr ??= [];
+    session.pendingStdoutChars ??= sumPendingChars(session.pendingStdout);
+    session.pendingStderrChars ??= sumPendingChars(session.pendingStderr);
+    const buffer = stream === "stdout" ? session.pendingStdout : session.pendingStderr;
+    const bufferChars = stream === "stdout" ? session.pendingStdoutChars : session.pendingStderrChars;
+    const pendingCap = Math.min(session.pendingMaxOutputChars ?? DEFAULT_PENDING_OUTPUT_CHARS, session.maxOutputChars);
+    buffer.push(chunk);
+    let pendingChars = bufferChars + chunk.length;
+    if (pendingChars > pendingCap) {
+        session.truncated = true;
+        pendingChars = capPendingBuffer(buffer, pendingChars, pendingCap);
+    }
+    if (stream === "stdout") {
+        session.pendingStdoutChars = pendingChars;
+    }
+    else {
+        session.pendingStderrChars = pendingChars;
+    }
+    session.totalOutputChars += chunk.length;
+    const aggregated = trimWithCap(session.aggregated + chunk, session.maxOutputChars);
+    session.truncated =
+        session.truncated || aggregated.length < session.aggregated.length + chunk.length;
+    session.aggregated = aggregated;
+    session.tail = tail(session.aggregated, 2000);
+}
+export function drainSession(session) {
+    const stdout = session.pendingStdout.join("");
+    const stderr = session.pendingStderr.join("");
+    session.pendingStdout = [];
+    session.pendingStderr = [];
+    session.pendingStdoutChars = 0;
+    session.pendingStderrChars = 0;
+    return { stdout, stderr };
+}
+export function markExited(session, exitCode, exitSignal, status) {
+    session.exited = true;
+    session.exitCode = exitCode;
+    session.exitSignal = exitSignal;
+    session.tail = tail(session.aggregated, 2000);
+    moveToFinished(session, status);
+}
+export function markBackgrounded(session) {
+    session.backgrounded = true;
+}
+function moveToFinished(session, status) {
+    runningSessions.delete(session.id);
+    if (!session.backgrounded)
+        return;
+    finishedSessions.set(session.id, {
+        id: session.id,
+        command: session.command,
+        scopeKey: session.scopeKey,
+        startedAt: session.startedAt,
+        endedAt: Date.now(),
+        cwd: session.cwd,
+        status,
+        exitCode: session.exitCode,
+        exitSignal: session.exitSignal,
+        aggregated: session.aggregated,
+        tail: session.tail,
+        truncated: session.truncated,
+        totalOutputChars: session.totalOutputChars,
+    });
+}
+export function tail(text, max = 2000) {
+    if (text.length <= max)
+        return text;
+    return text.slice(text.length - max);
+}
+function sumPendingChars(buffer) {
+    let total = 0;
+    for (const chunk of buffer)
+        total += chunk.length;
+    return total;
+}
+function capPendingBuffer(buffer, pendingChars, cap) {
+    if (pendingChars <= cap)
+        return pendingChars;
+    const last = buffer.at(-1);
+    if (last && last.length >= cap) {
+        buffer.length = 0;
+        buffer.push(last.slice(last.length - cap));
+        return cap;
+    }
+    while (buffer.length && pendingChars - buffer[0].length >= cap) {
+        pendingChars -= buffer[0].length;
+        buffer.shift();
+    }
+    if (buffer.length && pendingChars > cap) {
+        const overflow = pendingChars - cap;
+        buffer[0] = buffer[0].slice(overflow);
+        pendingChars = cap;
+    }
+    return pendingChars;
+}
+export function trimWithCap(text, max) {
+    if (text.length <= max)
+        return text;
+    return text.slice(text.length - max);
+}
+export function listRunningSessions() {
+    return Array.from(runningSessions.values()).filter((s) => s.backgrounded);
+}
+export function listFinishedSessions() {
+    return Array.from(finishedSessions.values());
+}
+export function clearFinished() {
+    finishedSessions.clear();
+}
+export function resetProcessRegistryForTests() {
+    runningSessions.clear();
+    finishedSessions.clear();
+    stopSweeper();
+}
+export function setJobTtlMs(value) {
+    if (value === undefined || Number.isNaN(value))
+        return;
+    jobTtlMs = clampTtl(value);
+    stopSweeper();
+    startSweeper();
+}
+function pruneFinishedSessions() {
+    const cutoff = Date.now() - jobTtlMs;
+    for (const [id, session] of finishedSessions.entries()) {
+        if (session.endedAt < cutoff) {
+            finishedSessions.delete(id);
+        }
+    }
+}
+function startSweeper() {
+    if (sweeper)
+        return;
+    sweeper = setInterval(pruneFinishedSessions, Math.max(30_000, jobTtlMs / 6));
+    sweeper.unref?.();
+}
+function stopSweeper() {
+    if (!sweeper)
+        return;
+    clearInterval(sweeper);
+    sweeper = null;
+}
+//# sourceMappingURL=process-registry.js.map

package/dist/tools/process-registry.js.map

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

package/dist/tools/process.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CoStar Server Executor - Process Tool
+ * Based on OpenClaw's bash-tools.process.ts
+ *
+ * Manages running exec sessions with all actions:
+ * - list: Show all running/finished sessions
+ * - poll: Get latest output from a session
+ * - log: Get full output with offset/limit
+ * - write: Write data to stdin
+ * - send-keys: Send keyboard input (escape sequences, modifiers)
+ * - submit: Send Enter/CR
+ * - paste: Paste text with optional bracketed paste mode
+ * - kill: Kill a running session
+ * - clear: Remove a finished session
+ * - remove: Kill (if running) and remove a session
+ */
+import type { AnyAgentTool } from "../types/tool.js";
+export type ProcessToolDefaults = {
+    cleanupMs?: number;
+    scopeKey?: string;
+};
+export declare function createProcessTool(defaults?: ProcessToolDefaults): AnyAgentTool;
+export declare const processTool: AnyAgentTool;
+//# sourceMappingURL=process.d.ts.map

package/dist/tools/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/tools/process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAsBrD,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAkBF,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,YAAY,CA4lB9E;AAED,eAAO,MAAM,WAAW,cAAsB,CAAC"}