@grackle-ai/server 0.0.2

package/dist/transcript.js

@@ -0,0 +1,51 @@
+import { readLog } from "./log-writer.js";
+import { writeFileSync, mkdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+function renderEntry(entry) {
+    switch (entry.type) {
+        case "system":
+            return `> _${entry.content}_\n`;
+        case "text":
+            return `${entry.content}\n`;
+        case "tool_use": {
+            try {
+                const parsed = JSON.parse(entry.content);
+                return `\`\`\`\n${parsed.tool}: ${JSON.stringify(parsed.args, null, 2)}\n\`\`\`\n`;
+            }
+            catch {
+                return `\`\`\`\n${entry.content}\n\`\`\`\n`;
+            }
+        }
+        case "tool_result":
+            return `<details>\n<summary>Tool output</summary>\n\n\`\`\`\n${entry.content}\n\`\`\`\n</details>\n`;
+        case "error":
+            return `**Error:** ${entry.content}\n`;
+        case "status":
+            return `---\n*Status: ${entry.content}*\n`;
+        default:
+            return `${entry.content}\n`;
+    }
+}
+/** Generate a Markdown transcript from a session's JSONL log. */
+export function generateTranscript(logPath) {
+    const entries = readLog(logPath);
+    if (entries.length === 0)
+        return "*(empty session)*\n";
+    const lines = [];
+    lines.push(`# Session Transcript\n`);
+    lines.push(`*Started: ${entries[0].timestamp}*\n`);
+    for (const entry of entries) {
+        lines.push(renderEntry(entry));
+    }
+    const last = entries[entries.length - 1];
+    lines.push(`\n*Ended: ${last.timestamp}*\n`);
+    return lines.join("\n");
+}
+/** Generate and write a Markdown transcript file alongside the session log. */
+export function writeTranscript(logPath) {
+    const md = generateTranscript(logPath);
+    const transcriptPath = join(logPath, "transcript.md");
+    mkdirSync(dirname(transcriptPath), { recursive: true });
+    writeFileSync(transcriptPath, md, "utf8");
+}
+//# sourceMappingURL=transcript.js.map

package/dist/transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.js","sourceRoot":"","sources":["../src/transcript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAiB,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,SAAS,WAAW,CAAC,KAAe;IAClC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,MAAM,KAAK,CAAC,OAAO,KAAK,CAAC;QAClC,KAAK,MAAM;YACT,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC;QAC9B,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACzC,OAAO,WAAW,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC;YACrF,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,WAAW,KAAK,CAAC,OAAO,YAAY,CAAC;YAC9C,CAAC;QACH,CAAC;QACD,KAAK,aAAa;YAChB,OAAO,wDAAwD,KAAK,CAAC,OAAO,wBAAwB,CAAC;QACvG,KAAK,OAAO;YACV,OAAO,cAAc,KAAK,CAAC,OAAO,IAAI,CAAC;QACzC,KAAK,QAAQ;YACX,OAAO,iBAAiB,KAAK,CAAC,OAAO,KAAK,CAAC;QAC7C;YACE,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC;IAChC,CAAC;AACH,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,qBAAqB,CAAC;IAEvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC;IAEnD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,KAAK,CAAC,CAAC;IAE7C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACtD,SAAS,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,aAAa,CAAC,cAAc,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC"}

package/dist/utils/exec.d.ts

@@ -0,0 +1,17 @@
+/** Trimmed stdout/stderr from a child process execution. */
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+}
+/**
+ * Execute a command as a child process and return its trimmed output.
+ * @param cmd - Executable name or path.
+ * @param args - Arguments to pass to the executable.
+ * @param opts - Optional timeout, cwd, and env overrides.
+ */
+export declare function exec(cmd: string, args: string[], opts?: {
+    timeout?: number;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<ExecResult>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/utils/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/utils/exec.ts"],"names":[],"mappings":"AAQA,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAsB,IAAI,CACxB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,GACjE,OAAO,CAAC,UAAU,CAAC,CAQrB"}

package/dist/utils/exec.js

@@ -0,0 +1,21 @@
+import { execFile as _execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(_execFile);
+const DEFAULT_EXEC_TIMEOUT_MS = 60_000;
+const EXEC_MAX_BUFFER_BYTES = 10 * 1024 * 1024;
+/**
+ * Execute a command as a child process and return its trimmed output.
+ * @param cmd - Executable name or path.
+ * @param args - Arguments to pass to the executable.
+ * @param opts - Optional timeout, cwd, and env overrides.
+ */
+export async function exec(cmd, args, opts) {
+    const { stdout, stderr } = await execFileAsync(cmd, args, {
+        timeout: opts?.timeout ?? DEFAULT_EXEC_TIMEOUT_MS,
+        cwd: opts?.cwd,
+        env: opts?.env ?? process.env,
+        maxBuffer: EXEC_MAX_BUFFER_BYTES,
+    });
+    return { stdout: stdout.trim(), stderr: stderr.trim() };
+}
+//# sourceMappingURL=exec.js.map

package/dist/utils/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/utils/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAmC,SAAS,CAAC,SAAS,CAAC,CAAC;AAE3E,MAAM,uBAAuB,GAAW,MAAM,CAAC;AAC/C,MAAM,qBAAqB,GAAW,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAQvD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,GAAW,EACX,IAAc,EACd,IAAkE;IAElE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE;QACxD,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,uBAAuB;QACjD,GAAG,EAAE,IAAI,EAAE,GAAG;QACd,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG;QAC7B,SAAS,EAAE,qBAAqB;KACjC,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;AAC1D,CAAC"}

package/dist/utils/ports.d.ts

@@ -0,0 +1,3 @@
+/** Find and return an available TCP port by briefly binding to port 0. */
+export declare function findFreePort(): Promise<number>;
+//# sourceMappingURL=ports.d.ts.map

package/dist/utils/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/utils/ports.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,wBAAgB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAc9C"}

package/dist/utils/ports.js

@@ -0,0 +1,19 @@
+import { createServer } from "node:net";
+/** Find and return an available TCP port by briefly binding to port 0. */
+export function findFreePort() {
+    return new Promise((resolve, reject) => {
+        const server = createServer();
+        server.listen(0, () => {
+            const addr = server.address();
+            if (addr && typeof addr === "object") {
+                const port = addr.port;
+                server.close(() => resolve(port));
+            }
+            else {
+                server.close(() => reject(new Error("Failed to get port")));
+            }
+        });
+        server.on("error", reject);
+    });
+}
+//# sourceMappingURL=ports.js.map

package/dist/utils/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/utils/ports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,0EAA0E;AAC1E,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE;YACpB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YAC9B,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;gBACvB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/sleep.d.ts

@@ -0,0 +1,3 @@
+/** Return a promise that resolves after the specified number of milliseconds. */
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

package/dist/utils/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/utils/sleep.js

@@ -0,0 +1,5 @@
+/** Return a promise that resolves after the specified number of milliseconds. */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=sleep.js.map

package/dist/utils/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/ws-bridge.d.ts

@@ -0,0 +1,10 @@
+import { WebSocketServer } from "ws";
+import type { Server as HttpServer } from "node:http";
+/** Broadcast a message to all connected WS clients. */
+export declare function broadcast(msg: {
+    type: string;
+    payload?: Record<string, unknown>;
+}): void;
+/** Create a WebSocket server on top of an HTTP server that bridges JSON messages to gRPC operations. */
+export declare function createWsBridge(httpServer: HttpServer, verifyApiKey: (token: string) => boolean): WebSocketServer;
+//# sourceMappingURL=ws-bridge.d.ts.map

package/dist/ws-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-bridge.d.ts","sourceRoot":"","sources":["../src/ws-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAa,MAAM,IAAI,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AAoCtD,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,GAAG,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,IAAI,CAQxF;AAED,wGAAwG;AACxG,wBAAgB,cAAc,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,eAAe,CAuChH"}