patchwork-os 0.2.0-alpha.0

package/dist/runLog.js

@@ -0,0 +1,143 @@
+import { appendFileSync, mkdirSync, readFileSync, statSync } from "node:fs";
+import path from "node:path";
+const MAX_OUTPUT_TAIL = 2_000;
+const DEFAULT_MEMORY_CAP = 500;
+export class RecipeRunLog {
+    opts;
+    runs = [];
+    seq = 0;
+    file;
+    memoryCap;
+    now;
+    constructor(opts) {
+        this.opts = opts;
+        this.file = path.join(opts.dir, "runs.jsonl");
+        this.memoryCap = opts.memoryCap ?? DEFAULT_MEMORY_CAP;
+        this.now = opts.now ?? Date.now;
+        try {
+            mkdirSync(opts.dir, { recursive: true });
+        }
+        catch (err) {
+            opts.logger?.warn?.(`[runlog] could not create ${opts.dir}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        this.loadExisting();
+    }
+    /**
+     * Parse triggerSource into `{trigger, recipeName}`. Returns null for non-recipe
+     * triggers (e.g. automation hooks like "onFileSave") so the caller can ignore them.
+     */
+    static parseTrigger(triggerSource) {
+        if (!triggerSource)
+            return null;
+        const m = /^(cron|webhook|recipe):(.+)$/.exec(triggerSource);
+        if (!m || !m[1] || !m[2])
+            return null;
+        return { trigger: m[1], recipeName: m[2] };
+    }
+    record(task) {
+        const parsed = RecipeRunLog.parseTrigger(task.triggerSource);
+        if (!parsed)
+            return null;
+        const status = task.status;
+        if (status !== "done" &&
+            status !== "error" &&
+            status !== "cancelled" &&
+            status !== "interrupted") {
+            return null;
+        }
+        const doneAt = task.doneAt ?? this.now();
+        const startedAt = task.startedAt;
+        const durationMs = doneAt - (startedAt ?? task.createdAt);
+        this.seq += 1;
+        const run = {
+            seq: this.seq,
+            taskId: task.id,
+            recipeName: parsed.recipeName,
+            trigger: parsed.trigger,
+            status,
+            createdAt: task.createdAt,
+            ...(startedAt !== undefined && { startedAt }),
+            doneAt,
+            ...(task.model !== undefined && { model: task.model }),
+            ...(task.output !== undefined && {
+                outputTail: task.output.slice(-MAX_OUTPUT_TAIL),
+            }),
+            ...(task.errorMessage !== undefined && {
+                errorMessage: task.errorMessage,
+            }),
+            durationMs,
+        };
+        this.runs.push(run);
+        if (this.runs.length > this.memoryCap) {
+            this.runs.splice(0, this.runs.length - this.memoryCap);
+        }
+        this.append(run);
+        return run;
+    }
+    query(q = {}) {
+        let out = this.runs;
+        if (q.trigger)
+            out = out.filter((r) => r.trigger === q.trigger);
+        if (q.status)
+            out = out.filter((r) => r.status === q.status);
+        if (q.recipe)
+            out = out.filter((r) => r.recipeName === q.recipe);
+        if (q.after !== undefined) {
+            const after = q.after;
+            out = out.filter((r) => r.seq > after);
+        }
+        // Newest first.
+        out = [...out].sort((a, b) => b.seq - a.seq);
+        const limit = Math.min(Math.max(q.limit ?? 100, 1), 500);
+        return out.slice(0, limit);
+    }
+    /** Test/inspection helper — current in-memory size. */
+    size() {
+        return this.runs.length;
+    }
+    append(run) {
+        try {
+            appendFileSync(this.file, `${JSON.stringify(run)}\n`, { mode: 0o600 });
+        }
+        catch (err) {
+            this.opts.logger?.warn?.(`[runlog] append failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    loadExisting() {
+        try {
+            statSync(this.file);
+        }
+        catch {
+            return;
+        }
+        let raw;
+        try {
+            raw = readFileSync(this.file, "utf-8");
+        }
+        catch (err) {
+            this.opts.logger?.warn?.(`[runlog] read failed: ${err instanceof Error ? err.message : String(err)}`);
+            return;
+        }
+        const lines = raw.split("\n");
+        for (const line of lines) {
+            if (!line)
+                continue;
+            try {
+                const parsed = JSON.parse(line);
+                if (typeof parsed.seq !== "number")
+                    continue;
+                // Seed in-memory ring from tail so dashboard has immediate history.
+                this.runs.push(parsed);
+                if (parsed.seq > this.seq)
+                    this.seq = parsed.seq;
+            }
+            catch {
+                // skip malformed line — never let one bad row break startup
+            }
+        }
+        if (this.runs.length > this.memoryCap) {
+            this.runs.splice(0, this.runs.length - this.memoryCap);
+        }
+    }
+}
+//# sourceMappingURL=runLog.js.map

package/dist/runLog.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,160 @@
+import { EventEmitter } from "node:events";
+import http from "node:http";
+import { WebSocket } from "ws";
+import type { Logger } from "./logger.js";
+import type { OAuthServer } from "./oauth.js";
+import type { ActivityListener } from "./activityTypes.js";
+import type { RecipeDraft } from "./recipesHttp.js";
+interface ServerEvents {
+    connection: [ws: WebSocket];
+    extension: [ws: WebSocket];
+}
+/**
+ * Return the CORS origin to reflect, or null if the origin is untrusted.
+ * Loopback origins are always allowed. Additional origins can be passed via
+ * --cors-origin (e.g. https://claude.ai for remote deployments).
+ */
+export declare function corsOrigin(requestOrigin: string | undefined, extraOrigins?: string[]): string | null;
+export interface SessionSummary {
+    id: string;
+    connectedAt: string;
+    openedFileCount: number;
+    pendingApprovals: number;
+}
+export declare class Server extends EventEmitter<ServerEvents> {
+    private authToken;
+    private logger;
+    private extraCorsOrigins;
+    private pingIntervalMs;
+    private httpServer;
+    private wss;
+    private pingInterval;
+    private lastClaudeConnectionTime;
+    private lastExtensionConnectionTime;
+    private startTime;
+    /** OAuth 2.0 Authorization Server — set via setOAuthServer() when running in remote mode */
+    private oauthServer;
+    private oauthIssuerUrl;
+    private sseSubscriberCount;
+    private static readonly MAX_SSE_SUBSCRIBERS;
+    /** Set by bridge to provide health data */
+    healthDataFn: (() => Record<string, unknown>) | null;
+    /** Set by bridge to provide Prometheus metrics */
+    metricsFn: (() => string) | null;
+    /** Set by bridge to provide rich status data */
+    statusFn: (() => Record<string, unknown>) | null;
+    /** Set by bridge to provide performance report data for /dashboard/data */
+    perfDataFn: (() => Record<string, unknown>) | null;
+    /** Set by bridge to provide readiness data (MCP handshake complete, tool count, extension) */
+    readyFn: (() => {
+        ready: boolean;
+        toolCount: number;
+        extensionConnected: boolean;
+    }) | null;
+    /** Set by bridge to provide task list data (sanitized — no raw prompts) */
+    tasksFn: (() => {
+        tasks: Record<string, unknown>[];
+    }) | null;
+    /** Patchwork: set by bridge to list installed recipes for the dashboard. */
+    recipesFn: (() => Record<string, unknown>) | null;
+    /** Patchwork: set by bridge to save a new recipe draft to disk. */
+    saveRecipeFn: ((draft: RecipeDraft) => {
+        ok: boolean;
+        path?: string;
+        error?: string;
+    }) | null;
+    /** Patchwork: set by bridge to query the recipe run audit log. */
+    runsFn: ((q: {
+        limit?: number;
+        trigger?: string;
+        status?: string;
+        recipe?: string;
+        after?: number;
+    }) => Record<string, unknown>[]) | null;
+    /** Patchwork: set by bridge to launch a named recipe via the orchestrator. */
+    runRecipeFn: ((name: string) => Promise<{
+        ok: boolean;
+        taskId?: string;
+        error?: string;
+    }>) | null;
+    /** Patchwork: admin-controlled managed settings path (highest rule precedence). */
+    managedSettingsPath: string | undefined;
+    /** Patchwork: live approval gate level — mutated by POST /settings, read by bridge per-session setup. */
+    approvalGate: "off" | "high" | "all";
+    /** Patchwork: outbound webhook URL for approval notifications (from dashboard.webhookUrl in config). */
+    approvalWebhookUrl: string | undefined;
+    /** Patchwork: approval decision audit callback wired to activityLog.recordEvent. */
+    onApprovalDecision: ((event: string, meta: Record<string, unknown>) => void) | undefined;
+    /** Patchwork: set by bridge to match + fire webhook-triggered recipes. */
+    webhookFn: ((path: string, payload: unknown) => Promise<{
+        ok: boolean;
+        taskId?: string;
+        name?: string;
+        error?: string;
+    }>) | null;
+    /** Set by bridge to handle MCP Streamable HTTP sessions (POST/GET/DELETE /mcp) */
+    httpMcpHandler: ((req: http.IncomingMessage, res: http.ServerResponse) => Promise<void>) | null;
+    /** Set by bridge to subscribe a caller to real-time activity events. Returns unsubscribe fn. */
+    streamFn: ((listener: ActivityListener) => () => void) | null;
+    /** Set to true via --no-dashboard to disable the /dashboard route. */
+    noDashboard: boolean;
+    /** Set by bridge to provide analytics report data (top tools, hooks, tasks) */
+    analyticsFn: ((windowHours?: number) => Promise<Record<string, unknown>>) | null;
+    /** Set by bridge to answer GET /activity — history of recent tool calls + lifecycle events. */
+    activityFn: ((last: number) => Record<string, unknown>[]) | null;
+    /** Set by bridge to answer GET /approvals/:callId — decision record + nearby session activity. */
+    approvalDetailFn: ((callId: string) => {
+        pending: Record<string, unknown> | null;
+        decision: Record<string, unknown> | null;
+        nearby: Record<string, unknown>[];
+    }) | null;
+    /** Set by bridge to answer GET /traces via ctxQueryTraces over persistent logs. */
+    tracesFn: ((query: {
+        traceType?: string;
+        key?: string;
+        q?: string;
+        tag?: string;
+        since?: number;
+        limit?: number;
+    }) => Promise<Record<string, unknown>>) | null;
+    /** Set by bridge to handle CC hook notify events via POST /notify */
+    notifyFn: ((event: string, args: Record<string, string>) => {
+        ok: boolean;
+        error?: string;
+    }) | null;
+    /** Patchwork: set by bridge to list active agent sessions for the dashboard. */
+    sessionsFn: (() => SessionSummary[]) | null;
+    /** Patchwork: set by bridge to answer GET /sessions/:id with per-session event stream + approvals. */
+    sessionDetailFn: ((id: string) => {
+        summary: SessionSummary | null;
+        lifecycle: Record<string, unknown>[];
+        tools: Record<string, unknown>[];
+        decisions: Record<string, unknown>[];
+        approvals: Record<string, unknown>[];
+    }) | null;
+    /** Set by bridge to handle POST /launch-quick-task — invokes launchQuickTask tool in-process. */
+    launchQuickTaskFn: ((presetId: string, source: string) => Promise<{
+        ok: boolean;
+        result?: unknown;
+        error?: string;
+        code?: string;
+    }>) | null;
+    /**
+     * Attach an OAuth 2.0 Authorization Server.
+     * When set, the bridge exposes:
+     *   GET  /.well-known/oauth-authorization-server
+     *   GET  /oauth/authorize
+     *   POST /oauth/token
+     *   POST /oauth/revoke
+     * Bearer tokens issued via the OAuth flow are accepted in addition to the
+     * static bridge token, enabling claude.ai's authenticated MCP server flow.
+     */
+    setOAuthServer(oauth: OAuthServer, issuerUrl: string): void;
+    /** Hosts accepted in the WebSocket upgrade Host header (DNS-rebinding guard). */
+    private readonly allowedHosts;
+    constructor(authToken: string, logger: Logger, extraCorsOrigins?: string[], pingIntervalMs?: number);
+    listen(port: number, bindAddress?: string): Promise<number>;
+    findAndListen(preferredPort: number | null, bindAddress?: string): Promise<number>;
+    close(): Promise<void>;
+}
+export {};