@guckdev/sdk 0.1.0

package/README.md

@@ -0,0 +1,44 @@
+# Guck (JS SDK)
+
+Guck is a tiny, MCP-first telemetry store for AI debugging. This package
+includes the JS SDK.
+
+For full docs, see the repo README.
+
+## Install
+
+This package is intended to be used from the monorepo workspace.
+For the CLI (`guck ...`), use `@guckdev/cli`.
+
+## Quick start
+
+```sh
+guck init
+guck wrap --service debate-room --session room-123 -- pnpm run dev
+# in another terminal
+guck mcp
+```
+
+## Auto-capture stdout/stderr
+
+Enable auto-capture early in your app startup to patch `process.stdout` and
+`process.stderr` and emit Guck events:
+
+```ts
+import "@guckdev/sdk/auto";
+// or
+import { installAutoCapture } from "@guckdev/sdk";
+installAutoCapture();
+```
+
+Behavior: output is buffered by line and emitted as `stdout`/`stderr` events.
+
+Config toggles:
+
+```json
+{ "sdk": { "enabled": true, "capture_stdout": true, "capture_stderr": true } }
+```
+
+If you're using `guck wrap`, the CLI sets `GUCK_WRAPPED=1` and the SDK
+auto-capture intentionally skips to avoid double logging. Call the import or
+`installAutoCapture()` early so it wraps writes during startup.

package/dist/auto.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auto.d.ts.map

package/dist/auto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto.d.ts","sourceRoot":"","sources":["../src/auto.ts"],"names":[],"mappings":""}

package/dist/auto.js

@@ -0,0 +1,3 @@
+import { installAutoCapture } from "./sdk/auto.js";
+installAutoCapture();
+//# sourceMappingURL=auto.js.map

package/dist/auto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto.js","sourceRoot":"","sources":["../src/auto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,kBAAkB,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { emit } from "./sdk/emit.js";
+export { installAutoCapture } from "./sdk/auto.js";
+export type { GuckEvent, GuckLevel, GuckConfig } from "@guckdev/core";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { emit } from "./sdk/emit.js";
+export { installAutoCapture } from "./sdk/auto.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/sdk/auto.d.ts

@@ -0,0 +1,6 @@
+type StopHandle = {
+    stop: () => void;
+};
+export declare const installAutoCapture: () => StopHandle;
+export {};
+//# sourceMappingURL=auto.d.ts.map

package/dist/sdk/auto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto.d.ts","sourceRoot":"","sources":["../../src/sdk/auto.ts"],"names":[],"mappings":"AAGA,KAAK,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC;AAkEvC,eAAO,MAAM,kBAAkB,QAAO,UAiErC,CAAC"}

package/dist/sdk/auto.js

@@ -0,0 +1,97 @@
+import { emit } from "./emit.js";
+import { loadConfig } from "@guckdev/core";
+let installed = null;
+const shouldCapture = () => {
+    if (process.env.GUCK_WRAPPED === "1") {
+        return false;
+    }
+    const { config } = loadConfig();
+    if (!config.enabled) {
+        return false;
+    }
+    if (!config.sdk.enabled) {
+        return false;
+    }
+    return config.sdk.capture_stdout || config.sdk.capture_stderr;
+};
+const flushLine = (target, line) => {
+    if (!line.trim()) {
+        return;
+    }
+    void emit({
+        type: target.type,
+        level: target.level,
+        message: line,
+        source: { kind: target.type },
+    });
+};
+const installCaptureFor = (target, bufferRef) => {
+    const original = target.stream.write.bind(target.stream);
+    const patched = (chunk, encoding, cb) => {
+        const result = original(chunk, encoding, cb);
+        const resolvedEncoding = typeof encoding === "string" ? encoding : "utf8";
+        const text = Buffer.isBuffer(chunk)
+            ? chunk.toString(resolvedEncoding)
+            : String(chunk);
+        bufferRef.value += text;
+        const lines = bufferRef.value.split(/\r?\n/);
+        bufferRef.value = lines.pop() ?? "";
+        for (const line of lines) {
+            flushLine(target, line);
+        }
+        return result;
+    };
+    target.stream.write = patched;
+    return original;
+};
+export const installAutoCapture = () => {
+    if (installed) {
+        return installed;
+    }
+    if (!shouldCapture()) {
+        const noOp = { stop: () => { } };
+        installed = noOp;
+        return noOp;
+    }
+    const buffers = {
+        stdout: { value: "" },
+        stderr: { value: "" },
+    };
+    const originals = {};
+    const { config } = loadConfig();
+    if (config.sdk.capture_stdout) {
+        originals.stdout = installCaptureFor({ stream: process.stdout, type: "stdout", level: "info" }, buffers.stdout);
+    }
+    if (config.sdk.capture_stderr) {
+        originals.stderr = installCaptureFor({ stream: process.stderr, type: "stderr", level: "error" }, buffers.stderr);
+    }
+    const flush = () => {
+        if (config.sdk.capture_stdout && buffers.stdout.value.trim()) {
+            flushLine({ stream: process.stdout, type: "stdout", level: "info" }, buffers.stdout.value);
+            buffers.stdout.value = "";
+        }
+        if (config.sdk.capture_stderr && buffers.stderr.value.trim()) {
+            flushLine({ stream: process.stderr, type: "stderr", level: "error" }, buffers.stderr.value);
+            buffers.stderr.value = "";
+        }
+    };
+    const beforeExit = () => flush();
+    process.on("beforeExit", beforeExit);
+    process.on("exit", beforeExit);
+    const stop = () => {
+        flush();
+        if (originals.stdout) {
+            process.stdout.write = originals.stdout;
+        }
+        if (originals.stderr) {
+            process.stderr.write = originals.stderr;
+        }
+        process.off("beforeExit", beforeExit);
+        process.off("exit", beforeExit);
+        installed = null;
+    };
+    const handle = { stop };
+    installed = handle;
+    return handle;
+};
+//# sourceMappingURL=auto.js.map

package/dist/sdk/auto.js.map

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

package/dist/sdk/emit.d.ts

@@ -0,0 +1,3 @@
+import { GuckEvent } from "@guckdev/core";
+export declare const emit: (input: Partial<GuckEvent>) => Promise<void>;
+//# sourceMappingURL=emit.d.ts.map

package/dist/sdk/emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../src/sdk/emit.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,SAAS,EAKV,MAAM,eAAe,CAAC;AA6DvB,eAAO,MAAM,IAAI,UAAiB,QAAQ,SAAS,CAAC,KAAG,QAAQ,IAAI,CAQlE,CAAC"}

package/dist/sdk/emit.js

@@ -0,0 +1,56 @@
+import { randomUUID } from "node:crypto";
+import { appendEvent, loadConfig, redactEvent, resolveStoreDir, } from "@guckdev/core";
+let cached;
+const defaultRunId = process.env.GUCK_RUN_ID ?? randomUUID();
+const defaultSessionId = process.env.GUCK_SESSION_ID;
+const normalizeLevel = (level) => {
+    if (!level) {
+        return "info";
+    }
+    const lower = level.toLowerCase();
+    if (lower === "trace" ||
+        lower === "debug" ||
+        lower === "info" ||
+        lower === "warn" ||
+        lower === "error" ||
+        lower === "fatal") {
+        return lower;
+    }
+    return "info";
+};
+const toEvent = (input, defaults) => {
+    return {
+        id: input.id ?? randomUUID(),
+        ts: input.ts ?? new Date().toISOString(),
+        level: normalizeLevel(input.level),
+        type: input.type ?? "log",
+        service: input.service ?? defaults.service,
+        run_id: input.run_id ?? defaultRunId,
+        session_id: input.session_id ?? defaultSessionId,
+        message: input.message,
+        data: input.data,
+        tags: input.tags,
+        trace_id: input.trace_id,
+        span_id: input.span_id,
+        source: input.source ?? { kind: "sdk" },
+    };
+};
+const getCached = () => {
+    if (cached) {
+        return cached;
+    }
+    const loaded = loadConfig();
+    const storeDir = resolveStoreDir(loaded.config, loaded.rootDir);
+    cached = { storeDir, config: loaded.config };
+    return cached;
+};
+export const emit = async (input) => {
+    const { storeDir, config } = getCached();
+    if (!config.enabled) {
+        return;
+    }
+    const event = toEvent(input, { service: config.default_service });
+    const redacted = redactEvent(config, event);
+    await appendEvent(storeDir, redacted);
+};
+//# sourceMappingURL=emit.js.map

package/dist/sdk/emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../src/sdk/emit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,WAAW,EAGX,UAAU,EACV,WAAW,EACX,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,IAAI,MAKS,CAAC;AAEd,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,UAAU,EAAE,CAAC;AAC7D,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AAErD,MAAM,cAAc,GAAG,CAAC,KAAc,EAAa,EAAE;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,IACE,KAAK,KAAK,OAAO;QACjB,KAAK,KAAK,OAAO;QACjB,KAAK,KAAK,MAAM;QAChB,KAAK,KAAK,MAAM;QAChB,KAAK,KAAK,OAAO;QACjB,KAAK,KAAK,OAAO,EACjB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,CACd,KAAyB,EACzB,QAA6B,EAClB,EAAE;IACb,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,UAAU,EAAE;QAC5B,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACxC,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC;QAClC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK;QACzB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO;QAC1C,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,YAAY;QACpC,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,gBAAgB;QAChD,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE;KACxC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,GAAG,EAAE;IACrB,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAChE,MAAM,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,EAAE,KAAyB,EAAiB,EAAE;IACrE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC5C,MAAM,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACxC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@guckdev/sdk",
+  "version": "0.1.0",
+  "description": "Guck JS SDK",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./auto": {
+      "types": "./dist/auto.d.ts",
+      "import": "./dist/auto.js"
+    }
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "src",
+    "tsconfig.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "node scripts/ensure-deps.mjs && tsc -p tsconfig.json",
+    "build:watch": "tsc -p tsconfig.json --watch",
+    "test": "pnpm run build && node --test test/*.test.js",
+    "prepare": "pnpm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@guckdev/core": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "25.2.2"
+  }
+}

package/scripts/ensure-deps.mjs

@@ -0,0 +1,23 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+
+const dep = { name: "@guckdev/core", entry: "dist/index.js" };
+
+const npmExecPath = process.env.npm_execpath;
+const run = (cwd, args) => {
+  const cmd = npmExecPath ? process.execPath : "pnpm";
+  const cmdArgs = npmExecPath ? [npmExecPath, ...args] : args;
+  const result = spawnSync(cmd, cmdArgs, { cwd, stdio: "inherit" });
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
+  }
+};
+
+const depDir = path.join(process.cwd(), "node_modules", dep.name);
+if (existsSync(depDir)) {
+  const entryPath = path.join(depDir, dep.entry);
+  if (!existsSync(entryPath)) {
+    run(depDir, ["run", "build"]);
+  }
+}

package/src/auto.ts

@@ -0,0 +1,3 @@
+import { installAutoCapture } from "./sdk/auto.js";
+
+installAutoCapture();

package/src/index.ts

@@ -0,0 +1,3 @@
+export { emit } from "./sdk/emit.js";
+export { installAutoCapture } from "./sdk/auto.js";
+export type { GuckEvent, GuckLevel, GuckConfig } from "@guckdev/core";

package/src/sdk/auto.ts

@@ -0,0 +1,135 @@
+import { emit } from "./emit.js";
+import { GuckEvent, loadConfig } from "@guckdev/core";
+
+type StopHandle = { stop: () => void };
+
+type WriteTarget = {
+  stream: NodeJS.WriteStream;
+  type: "stdout" | "stderr";
+  level: GuckEvent["level"];
+};
+
+type WriteFn = typeof process.stdout.write;
+
+type CaptureState = {
+  stop: () => void;
+};
+
+let installed: CaptureState | null = null;
+
+const shouldCapture = (): boolean => {
+  if (process.env.GUCK_WRAPPED === "1") {
+    return false;
+  }
+  const { config } = loadConfig();
+  if (!config.enabled) {
+    return false;
+  }
+  if (!config.sdk.enabled) {
+    return false;
+  }
+  return config.sdk.capture_stdout || config.sdk.capture_stderr;
+};
+
+const flushLine = (target: WriteTarget, line: string): void => {
+  if (!line.trim()) {
+    return;
+  }
+  void emit({
+    type: target.type,
+    level: target.level,
+    message: line,
+    source: { kind: target.type },
+  });
+};
+
+const installCaptureFor = (
+  target: WriteTarget,
+  bufferRef: { value: string },
+): WriteFn => {
+  const original = target.stream.write.bind(target.stream);
+  const patched: WriteFn = (chunk: any, encoding?: any, cb?: any) => {
+    const result = original(chunk, encoding as any, cb as any);
+    const resolvedEncoding: BufferEncoding =
+      typeof encoding === "string" ? (encoding as BufferEncoding) : "utf8";
+    const text = Buffer.isBuffer(chunk)
+      ? chunk.toString(resolvedEncoding)
+      : String(chunk);
+    bufferRef.value += text;
+    const lines = bufferRef.value.split(/\r?\n/);
+    bufferRef.value = lines.pop() ?? "";
+    for (const line of lines) {
+      flushLine(target, line);
+    }
+    return result;
+  };
+  target.stream.write = patched as typeof target.stream.write;
+  return original;
+};
+
+export const installAutoCapture = (): StopHandle => {
+  if (installed) {
+    return installed;
+  }
+
+  if (!shouldCapture()) {
+    const noOp = { stop: () => {} };
+    installed = noOp;
+    return noOp;
+  }
+
+  const buffers = {
+    stdout: { value: "" },
+    stderr: { value: "" },
+  };
+
+  const originals: Partial<Record<"stdout" | "stderr", WriteFn>> = {};
+
+  const { config } = loadConfig();
+
+  if (config.sdk.capture_stdout) {
+    originals.stdout = installCaptureFor(
+      { stream: process.stdout, type: "stdout", level: "info" },
+      buffers.stdout,
+    );
+  }
+  if (config.sdk.capture_stderr) {
+    originals.stderr = installCaptureFor(
+      { stream: process.stderr, type: "stderr", level: "error" },
+      buffers.stderr,
+    );
+  }
+
+  const flush = () => {
+    if (config.sdk.capture_stdout && buffers.stdout.value.trim()) {
+      flushLine({ stream: process.stdout, type: "stdout", level: "info" }, buffers.stdout.value);
+      buffers.stdout.value = "";
+    }
+    if (config.sdk.capture_stderr && buffers.stderr.value.trim()) {
+      flushLine({ stream: process.stderr, type: "stderr", level: "error" }, buffers.stderr.value);
+      buffers.stderr.value = "";
+    }
+  };
+
+  const beforeExit = () => flush();
+
+  process.on("beforeExit", beforeExit);
+  process.on("exit", beforeExit);
+
+  const stop = () => {
+    flush();
+    if (originals.stdout) {
+      process.stdout.write = originals.stdout as typeof process.stdout.write;
+    }
+    if (originals.stderr) {
+      process.stderr.write = originals.stderr as typeof process.stderr.write;
+    }
+    process.off("beforeExit", beforeExit);
+    process.off("exit", beforeExit);
+    installed = null;
+  };
+
+  const handle = { stop };
+  installed = handle;
+  return handle;
+};

package/src/sdk/emit.ts

@@ -0,0 +1,78 @@
+import { randomUUID } from "node:crypto";
+import {
+  appendEvent,
+  GuckEvent,
+  GuckLevel,
+  loadConfig,
+  redactEvent,
+  resolveStoreDir,
+} from "@guckdev/core";
+
+let cached:
+  | {
+      storeDir: string;
+      config: ReturnType<typeof loadConfig>["config"];
+    }
+  | undefined;
+
+const defaultRunId = process.env.GUCK_RUN_ID ?? randomUUID();
+const defaultSessionId = process.env.GUCK_SESSION_ID;
+
+const normalizeLevel = (level?: string): GuckLevel => {
+  if (!level) {
+    return "info";
+  }
+  const lower = level.toLowerCase();
+  if (
+    lower === "trace" ||
+    lower === "debug" ||
+    lower === "info" ||
+    lower === "warn" ||
+    lower === "error" ||
+    lower === "fatal"
+  ) {
+    return lower;
+  }
+  return "info";
+};
+
+const toEvent = (
+  input: Partial<GuckEvent>,
+  defaults: { service: string },
+): GuckEvent => {
+  return {
+    id: input.id ?? randomUUID(),
+    ts: input.ts ?? new Date().toISOString(),
+    level: normalizeLevel(input.level),
+    type: input.type ?? "log",
+    service: input.service ?? defaults.service,
+    run_id: input.run_id ?? defaultRunId,
+    session_id: input.session_id ?? defaultSessionId,
+    message: input.message,
+    data: input.data,
+    tags: input.tags,
+    trace_id: input.trace_id,
+    span_id: input.span_id,
+    source: input.source ?? { kind: "sdk" },
+  };
+};
+
+const getCached = () => {
+  if (cached) {
+    return cached;
+  }
+  const loaded = loadConfig();
+  const storeDir = resolveStoreDir(loaded.config, loaded.rootDir);
+  cached = { storeDir, config: loaded.config };
+  return cached;
+};
+
+export const emit = async (input: Partial<GuckEvent>): Promise<void> => {
+  const { storeDir, config } = getCached();
+  if (!config.enabled) {
+    return;
+  }
+  const event = toEvent(input, { service: config.default_service });
+  const redacted = redactEvent(config, event);
+  await appendEvent(storeDir, redacted);
+};

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "rootDir": "src",
+    "outDir": "dist",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"]
+}