@farazirfan/costar-server-executor 1.0.0

package/dist/infra/session-cost-usage.js

@@ -0,0 +1,191 @@
+import fs from "node:fs";
+import path from "node:path";
+import readline from "node:readline";
+import { normalizeUsage } from "../agents/usage.js";
+import { resolveSessionFilePath, resolveSessionTranscriptsDirForAgent, } from "../config/sessions/paths.js";
+import { estimateUsageCost, resolveModelCostConfig } from "../utils/usage-format.js";
+const emptyTotals = () => ({
+    input: 0,
+    output: 0,
+    cacheRead: 0,
+    cacheWrite: 0,
+    totalTokens: 0,
+    totalCost: 0,
+    missingCostEntries: 0,
+});
+const toFiniteNumber = (value) => {
+    if (typeof value !== "number")
+        return undefined;
+    if (!Number.isFinite(value))
+        return undefined;
+    return value;
+};
+const extractCostTotal = (usageRaw) => {
+    if (!usageRaw || typeof usageRaw !== "object")
+        return undefined;
+    const record = usageRaw;
+    const cost = record.cost;
+    const total = toFiniteNumber(cost?.total);
+    if (total === undefined)
+        return undefined;
+    if (total < 0)
+        return undefined;
+    return total;
+};
+const parseTimestamp = (entry) => {
+    const raw = entry.timestamp;
+    if (typeof raw === "string") {
+        const parsed = new Date(raw);
+        if (!Number.isNaN(parsed.valueOf()))
+            return parsed;
+    }
+    const message = entry.message;
+    const messageTimestamp = toFiniteNumber(message?.timestamp);
+    if (messageTimestamp !== undefined) {
+        const parsed = new Date(messageTimestamp);
+        if (!Number.isNaN(parsed.valueOf()))
+            return parsed;
+    }
+    return undefined;
+};
+const parseUsageEntry = (entry) => {
+    const message = entry.message;
+    const role = message?.role;
+    if (role !== "assistant")
+        return null;
+    const usageRaw = message?.usage ?? entry.usage;
+    const usage = normalizeUsage(usageRaw);
+    if (!usage)
+        return null;
+    const provider = (typeof message?.provider === "string" ? message?.provider : undefined) ??
+        (typeof entry.provider === "string" ? entry.provider : undefined);
+    const model = (typeof message?.model === "string" ? message?.model : undefined) ??
+        (typeof entry.model === "string" ? entry.model : undefined);
+    return {
+        usage,
+        costTotal: extractCostTotal(usageRaw),
+        provider,
+        model,
+        timestamp: parseTimestamp(entry),
+    };
+};
+const formatDayKey = (date) => date.toLocaleDateString("en-CA", { timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone });
+const applyUsageTotals = (totals, usage) => {
+    totals.input += usage.input ?? 0;
+    totals.output += usage.output ?? 0;
+    totals.cacheRead += usage.cacheRead ?? 0;
+    totals.cacheWrite += usage.cacheWrite ?? 0;
+    const totalTokens = usage.total ??
+        (usage.input ?? 0) + (usage.output ?? 0) + (usage.cacheRead ?? 0) + (usage.cacheWrite ?? 0);
+    totals.totalTokens += totalTokens;
+};
+const applyCostTotal = (totals, costTotal) => {
+    if (costTotal === undefined) {
+        totals.missingCostEntries += 1;
+        return;
+    }
+    totals.totalCost += costTotal;
+};
+async function scanUsageFile(params) {
+    const fileStream = fs.createReadStream(params.filePath, { encoding: "utf-8" });
+    const rl = readline.createInterface({ input: fileStream, crlfDelay: Infinity });
+    for await (const line of rl) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            const entry = parseUsageEntry(parsed);
+            if (!entry)
+                continue;
+            if (entry.costTotal === undefined) {
+                const cost = resolveModelCostConfig({
+                    provider: entry.provider,
+                    model: entry.model,
+                    config: params.config,
+                });
+                entry.costTotal = estimateUsageCost({ usage: entry.usage, cost });
+            }
+            params.onEntry(entry);
+        }
+        catch {
+            // Ignore malformed lines
+        }
+    }
+}
+export async function loadCostUsageSummary(params) {
+    const days = Math.max(1, Math.floor(params?.days ?? 30));
+    const now = new Date();
+    const since = new Date(now);
+    since.setDate(since.getDate() - (days - 1));
+    const sinceTime = since.getTime();
+    const dailyMap = new Map();
+    const totals = emptyTotals();
+    const sessionsDir = resolveSessionTranscriptsDirForAgent(params?.agentId);
+    const entries = await fs.promises.readdir(sessionsDir, { withFileTypes: true }).catch(() => []);
+    const files = (await Promise.all(entries
+        .filter((entry) => entry.isFile() && entry.name.endsWith(".jsonl"))
+        .map(async (entry) => {
+        const filePath = path.join(sessionsDir, entry.name);
+        const stats = await fs.promises.stat(filePath).catch(() => null);
+        if (!stats)
+            return null;
+        if (stats.mtimeMs < sinceTime)
+            return null;
+        return filePath;
+    }))).filter((filePath) => Boolean(filePath));
+    for (const filePath of files) {
+        await scanUsageFile({
+            filePath,
+            config: params?.config,
+            onEntry: (entry) => {
+                const ts = entry.timestamp?.getTime();
+                if (!ts || ts < sinceTime)
+                    return;
+                const dayKey = formatDayKey(entry.timestamp ?? now);
+                const bucket = dailyMap.get(dayKey) ?? emptyTotals();
+                applyUsageTotals(bucket, entry.usage);
+                applyCostTotal(bucket, entry.costTotal);
+                dailyMap.set(dayKey, bucket);
+                applyUsageTotals(totals, entry.usage);
+                applyCostTotal(totals, entry.costTotal);
+            },
+        });
+    }
+    const daily = Array.from(dailyMap.entries())
+        .map(([date, bucket]) => ({ date, ...bucket }))
+        .sort((a, b) => a.date.localeCompare(b.date));
+    return {
+        updatedAt: Date.now(),
+        days,
+        daily,
+        totals,
+    };
+}
+export async function loadSessionCostSummary(params) {
+    const sessionFile = params.sessionFile ??
+        (params.sessionId ? resolveSessionFilePath(params.sessionId, params.sessionEntry) : undefined);
+    if (!sessionFile || !fs.existsSync(sessionFile))
+        return null;
+    const totals = emptyTotals();
+    let lastActivity;
+    await scanUsageFile({
+        filePath: sessionFile,
+        config: params.config,
+        onEntry: (entry) => {
+            applyUsageTotals(totals, entry.usage);
+            applyCostTotal(totals, entry.costTotal);
+            const ts = entry.timestamp?.getTime();
+            if (ts && (!lastActivity || ts > lastActivity)) {
+                lastActivity = ts;
+            }
+        },
+    });
+    return {
+        sessionId: params.sessionId,
+        sessionFile,
+        lastActivity,
+        ...totals,
+    };
+}
+//# sourceMappingURL=session-cost-usage.js.map

package/dist/infra/session-cost-usage.js.map

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

package/dist/infra/shell-env.d.ts

@@ -0,0 +1,34 @@
+import { execFileSync } from "node:child_process";
+export type ShellEnvFallbackResult = {
+    ok: true;
+    applied: string[];
+    skippedReason?: never;
+} | {
+    ok: true;
+    applied: [];
+    skippedReason: "already-has-keys" | "disabled";
+} | {
+    ok: false;
+    error: string;
+    applied: [];
+};
+export type ShellEnvFallbackOptions = {
+    enabled: boolean;
+    env: NodeJS.ProcessEnv;
+    expectedKeys: string[];
+    logger?: Pick<typeof console, "warn">;
+    timeoutMs?: number;
+    exec?: typeof execFileSync;
+};
+export declare function loadShellEnvFallback(opts: ShellEnvFallbackOptions): ShellEnvFallbackResult;
+export declare function shouldEnableShellEnvFallback(env: NodeJS.ProcessEnv): boolean;
+export declare function shouldDeferShellEnvFallback(env: NodeJS.ProcessEnv): boolean;
+export declare function resolveShellEnvFallbackTimeoutMs(env: NodeJS.ProcessEnv): number;
+export declare function getShellPathFromLoginShell(opts: {
+    env: NodeJS.ProcessEnv;
+    timeoutMs?: number;
+    exec?: typeof execFileSync;
+}): string | null;
+export declare function resetShellPathCacheForTests(): void;
+export declare function getShellEnvAppliedKeys(): string[];
+//# sourceMappingURL=shell-env.d.ts.map

package/dist/infra/shell-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-env.d.ts","sourceRoot":"","sources":["../../src/infra/shell-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA6BlD,MAAM,MAAM,sBAAsB,GAC9B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,aAAa,CAAC,EAAE,KAAK,CAAA;CAAE,GACtD;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,EAAE,CAAC;IAAC,aAAa,EAAE,kBAAkB,GAAG,UAAU,CAAA;CAAE,GACzE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,EAAE,CAAA;CAAE,CAAC;AAE9C,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,OAAO,EAAE,MAAM,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,YAAY,CAAC;CAC5B,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,uBAAuB,GAAG,sBAAsB,CAmD1F;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAE5E;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAE3E;AAED,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAM/E;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,YAAY,CAAC;CAC5B,GAAG,MAAM,GAAG,IAAI,CAgChB;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAED,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAEjD"}

package/dist/infra/shell-env.js

@@ -0,0 +1,126 @@
+import { execFileSync } from "node:child_process";
+import { isTruthyEnvValue } from "./env.js";
+const DEFAULT_TIMEOUT_MS = 15_000;
+const DEFAULT_MAX_BUFFER_BYTES = 2 * 1024 * 1024;
+let lastAppliedKeys = [];
+let cachedShellPath;
+function resolveShell(env) {
+    const shell = env.SHELL?.trim();
+    return shell && shell.length > 0 ? shell : "/bin/sh";
+}
+function parseShellEnv(stdout) {
+    const shellEnv = new Map();
+    const parts = stdout.toString("utf8").split("\0");
+    for (const part of parts) {
+        if (!part)
+            continue;
+        const eq = part.indexOf("=");
+        if (eq <= 0)
+            continue;
+        const key = part.slice(0, eq);
+        const value = part.slice(eq + 1);
+        if (!key)
+            continue;
+        shellEnv.set(key, value);
+    }
+    return shellEnv;
+}
+export function loadShellEnvFallback(opts) {
+    const logger = opts.logger ?? console;
+    const exec = opts.exec ?? execFileSync;
+    if (!opts.enabled) {
+        lastAppliedKeys = [];
+        return { ok: true, applied: [], skippedReason: "disabled" };
+    }
+    const hasAnyKey = opts.expectedKeys.some((key) => Boolean(opts.env[key]?.trim()));
+    if (hasAnyKey) {
+        lastAppliedKeys = [];
+        return { ok: true, applied: [], skippedReason: "already-has-keys" };
+    }
+    const timeoutMs = typeof opts.timeoutMs === "number" && Number.isFinite(opts.timeoutMs)
+        ? Math.max(0, opts.timeoutMs)
+        : DEFAULT_TIMEOUT_MS;
+    const shell = resolveShell(opts.env);
+    let stdout;
+    try {
+        stdout = exec(shell, ["-l", "-c", "env -0"], {
+            encoding: "buffer",
+            timeout: timeoutMs,
+            maxBuffer: DEFAULT_MAX_BUFFER_BYTES,
+            env: opts.env,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        logger.warn(`[openclaw] shell env fallback failed: ${msg}`);
+        lastAppliedKeys = [];
+        return { ok: false, error: msg, applied: [] };
+    }
+    const shellEnv = parseShellEnv(stdout);
+    const applied = [];
+    for (const key of opts.expectedKeys) {
+        if (opts.env[key]?.trim())
+            continue;
+        const value = shellEnv.get(key);
+        if (!value?.trim())
+            continue;
+        opts.env[key] = value;
+        applied.push(key);
+    }
+    lastAppliedKeys = applied;
+    return { ok: true, applied };
+}
+export function shouldEnableShellEnvFallback(env) {
+    return isTruthyEnvValue(env.OPENCLAW_LOAD_SHELL_ENV);
+}
+export function shouldDeferShellEnvFallback(env) {
+    return isTruthyEnvValue(env.OPENCLAW_DEFER_SHELL_ENV_FALLBACK);
+}
+export function resolveShellEnvFallbackTimeoutMs(env) {
+    const raw = env.OPENCLAW_SHELL_ENV_TIMEOUT_MS?.trim();
+    if (!raw)
+        return DEFAULT_TIMEOUT_MS;
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed))
+        return DEFAULT_TIMEOUT_MS;
+    return Math.max(0, parsed);
+}
+export function getShellPathFromLoginShell(opts) {
+    if (cachedShellPath !== undefined)
+        return cachedShellPath;
+    if (process.platform === "win32") {
+        cachedShellPath = null;
+        return cachedShellPath;
+    }
+    const exec = opts.exec ?? execFileSync;
+    const timeoutMs = typeof opts.timeoutMs === "number" && Number.isFinite(opts.timeoutMs)
+        ? Math.max(0, opts.timeoutMs)
+        : DEFAULT_TIMEOUT_MS;
+    const shell = resolveShell(opts.env);
+    let stdout;
+    try {
+        stdout = exec(shell, ["-l", "-c", "env -0"], {
+            encoding: "buffer",
+            timeout: timeoutMs,
+            maxBuffer: DEFAULT_MAX_BUFFER_BYTES,
+            env: opts.env,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+    }
+    catch {
+        cachedShellPath = null;
+        return cachedShellPath;
+    }
+    const shellEnv = parseShellEnv(stdout);
+    const shellPath = shellEnv.get("PATH")?.trim();
+    cachedShellPath = shellPath && shellPath.length > 0 ? shellPath : null;
+    return cachedShellPath;
+}
+export function resetShellPathCacheForTests() {
+    cachedShellPath = undefined;
+}
+export function getShellEnvAppliedKeys() {
+    return [...lastAppliedKeys];
+}
+//# sourceMappingURL=shell-env.js.map

package/dist/infra/shell-env.js.map

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

package/dist/infra/skills-remote.d.ts

@@ -0,0 +1,25 @@
+import type { SkillEligibilityContext } from "../agents/skills.js";
+import type { OpenClawConfig } from "../config/config.js";
+import type { NodeRegistry } from "../gateway/node-registry.js";
+export declare function setSkillsRemoteRegistry(registry: NodeRegistry | null): void;
+export declare function primeRemoteSkillsCache(): Promise<void>;
+export declare function recordRemoteNodeInfo(node: {
+    nodeId: string;
+    displayName?: string;
+    platform?: string;
+    deviceFamily?: string;
+    commands?: string[];
+    remoteIp?: string;
+}): void;
+export declare function recordRemoteNodeBins(nodeId: string, bins: string[]): void;
+export declare function refreshRemoteNodeBins(params: {
+    nodeId: string;
+    platform?: string;
+    deviceFamily?: string;
+    commands?: string[];
+    cfg: OpenClawConfig;
+    timeoutMs?: number;
+}): Promise<void>;
+export declare function getRemoteSkillEligibility(): SkillEligibilityContext["remote"] | undefined;
+export declare function refreshRemoteBinsForConnectedNodes(cfg: OpenClawConfig): Promise<void>;
+//# sourceMappingURL=skills-remote.d.ts.map

package/dist/infra/skills-remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-remote.d.ts","sourceRoot":"","sources":["../../src/infra/skills-remote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAc,MAAM,qBAAqB,CAAC;AAG/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AA0GhE,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,QAEpE;AAED,wBAAsB,sBAAsB,kBAwB3C;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,QAEA;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAElE;AAoED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,cAAc,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,iBAmDA;AAED,wBAAgB,yBAAyB,IAAI,uBAAuB,CAAC,QAAQ,CAAC,GAAG,SAAS,CAoBzF;AAED,wBAAsB,kCAAkC,CAAC,GAAG,EAAE,cAAc,iBAY3E"}