@minicor/mcp-server 4.1.0 → 4.3.0

package/README.md

@@ -270,7 +270,7 @@ After all steps pass individually:
 
 Then close the loop at the job level:
 
-- Point the job's workflow step at the finished `workflowId` (`update_job variant=draft`). If the workflow was edited in Dev Mode, `dev_mode_publish` first - jobs execute published workflows, not Dev Mode branches.
+- Point the job's workflow step at the finished `workflowId` (`update_job variant=draft`). If the workflow was edited in Dev Mode, `dev_mode_publish` first - jobs execute published workflows, not drafts.
 - `run_tests variant=draft` - the test cases from Phase 3 are the pass/fail verdict for the build
 - On a red case, `resolve_job_state` / `inspect_job_execution` locate the failing step; replay just that slice with `run_job` (`fromStepId` + `seedExecutionId`) or drop back into the workflow, fix, re-run
 - When the suite is green, `publish_job` puts it live at `/m/:slug/:path`
@@ -345,7 +345,7 @@ You work **backwards from the job's test cases**. The job's test suite is the ma
                       seedExecutionId=<failed execution>  (seeds ctx so mid-graph starts
                       resolve earlier steps' values).
    5b. Workflow-level (microscope) - the failing step's workflowId -> dev_mode_load,
-                      fix/run the branch's flow steps with dev_mode_run,
+                      fix/run the draft's flow steps (dev_mode_run needs vmId),
                       dev_mode_publish - jobs execute PUBLISHED workflows.
 6. PUBLISH          - when run_tests variant=draft is green, publish_job promotes the draft;
                       runtime traffic at /m/:slug serves it immediately.
@@ -686,6 +686,19 @@ Jobs/middleware base resolution (precedence: **proxy > direct > default**):
 | `MIDDLEWARE_SERVICE_URL_US`       | Direct middleware-service base for US (overrides the generic one)   | unset                  |
 | `MIDDLEWARE_SERVICE_URL_CA`       | Direct middleware-service base for CA (overrides the generic one)   | unset                  |
 | `EXPERIMENTAL_USE_CODE_MODE`      | Expose the experimental single `codemode` tool surface              | unset (standard tools) |
+| `SEEER_SERVICE_PROXY_BASE`        | Override the frontend origin fronting the video-tool proxy (auth = user bearer, like the agents/stitchy proxies) | derived from API base  |
+| `SEEER_SERVICE_PROXY_PREFIX`      | video-tool proxy path prefix                                         | `/api/video-tool`      |
+| `SEEER_SERVICE_URL`               | Direct video-tool service URL (bypasses the frontend proxy)          | unset                  |
+| `SEEER_SERVICE_TOKEN`             | App token for direct mode (sent as X-API-Key)                        | unset                  |
+| `SEEER_SERVICE_ID_TOKEN`          | Static Google identity token for IAM-gated Cloud Run (local testing) | unset                  |
+| `SEEER_SERVICE_USE_GCP_IDENTITY`  | Set to 1 to mint identity tokens from the GCP metadata server        | unset                  |
+
+The video-tool (seeer) service needs **no configuration** against the standard
+Laminar backends: the frontend proxy origin is derived from the region's API
+base (`api.laminar.run` → `app.laminar.run`, `ca.api.laminar.run` →
+`ca.app.laminar.run`). The env vars above only override this for dev/local
+setups (a localhost backend has no derivable frontend, so set
+`SEEER_SERVICE_PROXY_BASE` or `SEEER_SERVICE_URL` there).
 
 When none are set, Jobs calls the region's public middleware-service Cloud Run directly. To route through the frontend (once it deploys an `/api/middleware/[...path]` proxy), set `MIDDLEWARE_SERVICE_PROXY_BASE` (or the per-region variants).
 

package/dist/__tests__/recording-frames.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from "vitest";
-import { computeSampleTimestamps, buildScaleFilter, runCommand, } from "../recording-frames.js";
+import { computeSampleTimestamps, computeRangeTimestamps, buildScaleFilter, buildCropFilter, cacheKeyForUrl, runCommand, } from "../recording-frames.js";
 describe("computeSampleTimestamps", () => {
     it("returns evenly-spaced, centered timestamps within the duration", () => {
         expect(computeSampleTimestamps(10, 4)).toEqual([1.25, 3.75, 6.25, 8.75]);
@@ -22,6 +22,47 @@ describe("computeSampleTimestamps", () => {
         expect(computeSampleTimestamps(Number.NaN, 4)).toEqual([]);
     });
 });
+describe("computeRangeTimestamps", () => {
+    it("samples the window at the requested fps, inclusive of both ends", () => {
+        expect(computeRangeTimestamps(10, 14, 1, 16)).toEqual([10, 11, 12, 13, 14]);
+    });
+    it("falls back to even spacing when fps would exceed maxFrames", () => {
+        const ts = computeRangeTimestamps(0, 30, 2, 4);
+        expect(ts).toHaveLength(4);
+        expect(ts[0]).toBe(0);
+        expect(ts[3]).toBe(30);
+    });
+    it("returns a single frame for a zero-ish span with n=1", () => {
+        expect(computeRangeTimestamps(5, 5.4, 1, 16)).toEqual([5]);
+    });
+    it("returns empty for invalid input", () => {
+        expect(computeRangeTimestamps(10, 5, 1, 16)).toEqual([]);
+        expect(computeRangeTimestamps(0, 10, 0, 16)).toEqual([]);
+        expect(computeRangeTimestamps(0, 10, 1, 0)).toEqual([]);
+        expect(computeRangeTimestamps(Number.NaN, 10, 1, 16)).toEqual([]);
+    });
+});
+describe("buildCropFilter", () => {
+    it("builds a crop for the region with padding", () => {
+        expect(buildCropFilter({ x: 100, y: 50, width: 200, height: 100, pad: 10 })).toBe("crop=220:120:90:40");
+    });
+    it("clamps to video bounds", () => {
+        expect(buildCropFilter({ x: -20, y: -20, width: 3000, height: 2000 }, 2560, 1440)).toBe("crop=2560:1440:0:0");
+    });
+    it("returns null when the region is entirely outside the video", () => {
+        expect(buildCropFilter({ x: 5000, y: 5000, width: 100, height: 100 }, 2560, 1440)).toBeNull();
+    });
+});
+describe("cacheKeyForUrl", () => {
+    it("ignores the SAS query so re-minted URLs share a cache entry", () => {
+        const a = cacheKeyForUrl("https://acct.blob.core.windows.net/replay/rpa_1_2.mp4?sig=abc&se=2026");
+        const b = cacheKeyForUrl("https://acct.blob.core.windows.net/replay/rpa_1_2.mp4?sig=zzz&se=2027");
+        expect(a).toBe(b);
+    });
+    it("differs for different blobs", () => {
+        expect(cacheKeyForUrl("https://acct.blob.core.windows.net/replay/rpa_1_2.mp4")).not.toBe(cacheKeyForUrl("https://acct.blob.core.windows.net/replay/rpa_1_3.mp4"));
+    });
+});
 describe("runCommand", () => {
     it("resolves on a zero exit code", async () => {
         const result = await runCommand(process.execPath, ["-e", "process.stdout.write('hi')"], 10_000);

package/dist/__tests__/recording-frames.test.js.map

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

package/dist/__tests__/seeer-client.test.d.ts

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

package/dist/__tests__/seeer-client.test.d.ts.map

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

package/dist/__tests__/seeer-client.test.js

@@ -0,0 +1,57 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { deriveSeeerProxyBase, seeerAvailable, seeerProxyBase, } from "../seeer-client.js";
+const ENV_KEYS = ["SEEER_SERVICE_PROXY_BASE", "SEEER_SERVICE_URL"];
+const savedEnv = {};
+beforeEach(() => {
+    for (const key of ENV_KEYS) {
+        savedEnv[key] = process.env[key];
+        delete process.env[key];
+    }
+});
+afterEach(() => {
+    for (const key of ENV_KEYS) {
+        if (savedEnv[key] === undefined)
+            delete process.env[key];
+        else
+            process.env[key] = savedEnv[key];
+    }
+});
+describe("deriveSeeerProxyBase", () => {
+    it("maps the US API base to the US frontend origin", () => {
+        expect(deriveSeeerProxyBase("https://api.laminar.run")).toBe("https://app.laminar.run");
+    });
+    it("maps the CA API base to the CA frontend origin", () => {
+        expect(deriveSeeerProxyBase("https://ca.api.laminar.run")).toBe("https://ca.app.laminar.run");
+    });
+    it("is domain-agnostic (api.X -> app.X)", () => {
+        expect(deriveSeeerProxyBase("https://api.minicor.com")).toBe("https://app.minicor.com");
+    });
+    it("returns undefined for hosts without an api. label", () => {
+        expect(deriveSeeerProxyBase("http://localhost:3001")).toBeUndefined();
+        expect(deriveSeeerProxyBase("https://backend.example.com")).toBeUndefined();
+    });
+    it("returns undefined for missing or invalid input", () => {
+        expect(deriveSeeerProxyBase(undefined)).toBeUndefined();
+        expect(deriveSeeerProxyBase("not a url")).toBeUndefined();
+    });
+});
+describe("seeerProxyBase precedence", () => {
+    it("prefers the explicit proxy override over derivation", () => {
+        process.env.SEEER_SERVICE_PROXY_BASE = "https://staging.laminar.run/";
+        expect(seeerProxyBase("https://api.laminar.run")).toBe("https://staging.laminar.run");
+    });
+    it("yields to an explicit direct URL (no proxy) so direct mode wins", () => {
+        process.env.SEEER_SERVICE_URL = "https://video-tool.example.run.app";
+        expect(seeerProxyBase("https://api.laminar.run")).toBeUndefined();
+        expect(seeerAvailable("https://api.laminar.run")).toBe(true);
+    });
+    it("derives from the API base when nothing is configured", () => {
+        expect(seeerProxyBase("https://api.laminar.run")).toBe("https://app.laminar.run");
+        expect(seeerAvailable("https://api.laminar.run")).toBe(true);
+    });
+    it("is unavailable when nothing is configured and no derivation is possible", () => {
+        expect(seeerAvailable("http://localhost:3001")).toBe(false);
+        expect(seeerAvailable(undefined)).toBe(false);
+    });
+});
+//# sourceMappingURL=seeer-client.test.js.map

package/dist/__tests__/seeer-client.test.js.map

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

package/dist/index.js

@@ -153,7 +153,7 @@ async function unsetStoredApiBase(region) {
 }
 const codeModeEnabled = shouldUseCodeMode();
 const instructions = buildInstructions(true);
-const server = new McpServer({ name: SERVER_NAME, version: "4.0.0" }, {
+const server = new McpServer({ name: SERVER_NAME, version: "4.2.0" }, {
     instructions: codeModeEnabled
         ? buildCodeModeInstructions(instructions, { sessionLifecycle: true })
         : instructions,

package/dist/lib.js

@@ -60,7 +60,7 @@ export async function createMinicorServer(transport, opts = {}) {
     const localTools = opts.localTools ?? true;
     const codeModeEnabled = opts.codeMode ?? shouldUseCodeMode();
     const instructions = buildInstructions(localTools);
-    const server = new McpServer({ name: SERVER_NAME, version: "4.0.0" }, {
+    const server = new McpServer({ name: SERVER_NAME, version: "4.2.0" }, {
         instructions: codeModeEnabled
             ? buildCodeModeInstructions(instructions, {
                 sessionLifecycle: localTools,

package/dist/recording-frames.d.ts

@@ -1,12 +1,22 @@
 /**
- * Extracts sampled still frames from a recording (MP4) so that a vision-capable
- * model can visually verify or debug an execution.
+ * Extracts still frames from a recording (MP4) so that a vision-capable model
+ * can visually verify or debug an execution.
  *
  * The recording endpoints return a signed URL to an MP4. A model cannot "watch"
- * a video URL, so this module downloads the video and uses ffmpeg to sample a
- * handful of frames, returned as base64 JPEGs. ffmpeg (and ideally ffprobe) must
- * be available on the MCP host; when they are missing we throw a clear error so
- * the caller can fall back to handing the raw URL to a human.
+ * a video URL, so this module downloads the video and uses ffmpeg to extract
+ * frames, returned as base64 JPEGs. Supports:
+ *   - evenly-spaced sampling across the whole video (default)
+ *   - exact timestamps ("show me t=41.5s")
+ *   - dense sampling of a time range ("what happened between t=30s and t=45s")
+ *   - region cropping at the recording's native resolution ("zoom in here")
+ *
+ * Downloads are cached under ~/.minicor/cache/recordings keyed on the blob
+ * identity (URL minus the SAS query), so successive calls against the same
+ * recording skip the download entirely.
+ *
+ * ffmpeg (and ideally ffprobe) must be available on the MCP host; when they are
+ * missing we throw a clear error so the caller can fall back to handing the raw
+ * URL to a human.
  */
 export interface ExtractedFrame {
     /** Human-readable label, e.g. "t=12.3s" or "frame 2". */
@@ -16,15 +26,49 @@ export interface ExtractedFrame {
     /** Base64-encoded JPEG (no data: prefix). */
     base64: string;
 }
+export interface FrameRegion {
+    /** Left edge in native video pixels. */
+    x: number;
+    /** Top edge in native video pixels. */
+    y: number;
+    width: number;
+    height: number;
+    /** Extra context padding around the region, in pixels. Default 0. */
+    pad?: number;
+}
+export interface FrameRange {
+    /** Window start in seconds. */
+    start: number;
+    /** Window end in seconds. */
+    end: number;
+    /** Sampling rate within the window. Default 1 fps. */
+    fps?: number;
+}
 export interface ExtractFramesOptions {
-    /** Number of evenly-spaced frames to sample. Default 4. */
+    /**
+     * Number of evenly-spaced frames to sample. Default 4. Ignored when
+     * `timestamps` or `range` is provided.
+     */
     count?: number;
+    /** Exact timestamps (seconds) to extract. Takes precedence over `range`/`count`. */
+    timestamps?: number[];
+    /** Dense sampling of a time window. Takes precedence over `count`. */
+    range?: FrameRange;
+    /** Safety cap on total frames for timestamps/range modes. Default 16. */
+    maxFrames?: number;
+    /**
+     * Crop to this region at the recording's NATIVE resolution before any
+     * scaling — the way to keep small on-screen text readable.
+     */
+    region?: FrameRegion;
     /**
      * Optional max output width in px. When omitted (the default) frames keep the
      * recording's ORIGINAL resolution — important for reading fine on-screen detail.
      * Only set this if you explicitly want to trade resolution for smaller frames.
      */
     maxWidth?: number;
+    /** Use the on-disk download cache. Default true. */
+    cache?: boolean;
     /** Max bytes to download before aborting. Default 200 MB. */
     maxBytes?: number;
     /** Overall download timeout in ms. Default 60s. */
@@ -39,11 +83,22 @@ export interface ExtractFramesOptions {
  * avoid black/blank frames at the very start and end.
  */
 export declare function computeSampleTimestamps(durationSeconds: number, count: number): number[];
+/**
+ * Computes timestamps for dense sampling of a [start, end] window at `fps`,
+ * capped at `maxFrames` (falling back to even spacing across the window when
+ * the requested rate would exceed the cap).
+ */
+export declare function computeRangeTimestamps(start: number, end: number, fps: number, maxFrames: number): number[];
 /**
  * Builds an ffmpeg scale filter that caps width while preserving aspect ratio.
  * Returns null when no cap is requested, so frames keep their original resolution.
  */
 export declare function buildScaleFilter(maxWidth?: number): string | null;
+/**
+ * Builds an ffmpeg crop filter for a region (with optional padding), clamped to
+ * the video bounds when they are known. Returns null for degenerate regions.
+ */
+export declare function buildCropFilter(region: FrameRegion, videoWidth?: number | null, videoHeight?: number | null): string | null;
 export interface CommandResult {
     code: number | null;
     stdout: string;
@@ -51,8 +106,26 @@ export interface CommandResult {
 }
 export declare function runCommand(command: string, args: string[], timeoutMs: number): Promise<CommandResult>;
 /**
- * Downloads the recording at `url` and returns sampled JPEG frames.
- * Throws with a clear message when ffmpeg is unavailable.
+ * Stable cache key for a recording URL: the blob identity without the SAS
+ * query, so re-minted signed URLs for the same blob hit the same cache entry.
+ */
+export declare function cacheKeyForUrl(url: string): string;
+/**
+ * Returns a local path to the recording, downloading it if not already cached.
+ * The returned file must NOT be deleted by the caller (it is shared).
+ */
+export declare function getCachedRecording(url: string, opts: {
+    maxBytes: number;
+    downloadTimeoutMs: number;
+}): Promise<string>;
+export interface VideoInfo {
+    durationSeconds: number | null;
+    width: number | null;
+    height: number | null;
+}
+/**
+ * Downloads the recording at `url` (via the shared cache) and returns extracted
+ * JPEG frames. Throws with a clear message when ffmpeg is unavailable.
  */
 export declare function extractFramesFromUrl(url: string, options?: ExtractFramesOptions): Promise<ExtractedFrame[]>;
 //# sourceMappingURL=recording-frames.d.ts.map

package/dist/recording-frames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recording-frames.d.ts","sourceRoot":"","sources":["../src/recording-frames.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAWD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CASxF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKjE;AAID,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CA4CxB;AAqHD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,cAAc,EAAE,CAAC,CAuF3B"}
+{"version":3,"file":"recording-frames.d.ts","sourceRoot":"","sources":["../src/recording-frames.ts"],"names":[],"mappings":"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"}