@bolt-foundry/gambit 0.8.1 → 0.8.5-rc.10

package/script/src/trace.js

@@ -51,6 +51,9 @@ function makeConsoleTracer() {
     const started = new Map();
     const now = () => performance.now();
     const fmtMs = (start) => start !== undefined ? ` elapsed_ms=${Math.round(now() - start)}` : "";
+    const fmtPermissions = (permissions) => permissions?.effective !== undefined
+        ? ` permissions=${JSON.stringify(permissions.effective)}`
+        : "";
     return (event) => {
         switch (event.type) {
             case "run.start":
@@ -59,7 +62,7 @@ function makeConsoleTracer() {
                     ? ` initialUserMessage=${JSON.stringify(event.initialUserMessage)}`
                     : ""}${event.input !== undefined
                     ? ` input=${JSON.stringify(event.input)}`
-                    : ""}`);
+                    : ""}${fmtPermissions(event.permissions)}`);
                 break;
             case "run.end": {
                 const start = started.get(event.runId);
@@ -73,7 +76,7 @@ function makeConsoleTracer() {
             }
             case "deck.start":
                 started.set(event.actionCallId, now());
-                logger.log(`[trace] deck.start runId=${event.runId} actionCallId=${event.actionCallId} deck=${event.deckPath}`);
+                logger.log(`[trace] deck.start runId=${event.runId} actionCallId=${event.actionCallId} deck=${event.deckPath}${fmtPermissions(event.permissions)}`);
                 break;
             case "deck.end": {
                 const start = started.get(event.actionCallId);
@@ -83,7 +86,7 @@ function makeConsoleTracer() {
             }
             case "action.start":
                 started.set(event.actionCallId, now());
-                logger.log(`[trace] action.start runId=${event.runId} actionCallId=${event.actionCallId} name=${event.name} path=${event.path}`);
+                logger.log(`[trace] action.start runId=${event.runId} actionCallId=${event.actionCallId} name=${event.name} path=${event.path}${fmtPermissions(event.permissions)}`);
                 break;
             case "action.end": {
                 const start = started.get(event.actionCallId);
@@ -98,10 +101,10 @@ function makeConsoleTracer() {
                 logger.log(`[trace] tool.result runId=${event.runId} actionCallId=${event.actionCallId} name=${event.name} result=${JSON.stringify(event.result)}`);
                 break;
             case "model.call":
-                logger.log(`[trace] model.call runId=${event.runId} actionCallId=${event.actionCallId} deck=${event.deckPath} model=${event.model ?? "(default)"} messages=${event.messageCount ?? event.messages.length} tools=${event.toolCount ?? event.tools?.length ?? 0} stream=${event.stream ?? false} stateMessages=${event.stateMessages ?? 0}`);
+                logger.log(`[trace] model.call runId=${event.runId} actionCallId=${event.actionCallId} deck=${event.deckPath} model=${event.model ?? "(default)"} messages=${event.messageCount ?? event.messages.length} tools=${event.toolCount ?? event.tools?.length ?? 0} stream=${event.stream ?? false} mode=${event.mode ?? "chat"} stateMessages=${event.stateMessages ?? 0}`);
                 break;
             case "model.result":
-                logger.log(`[trace] model.result runId=${event.runId} actionCallId=${event.actionCallId} deck=${event.deckPath} model=${event.model ?? "(default)"} finish=${event.finishReason} toolCalls=${event.toolCalls?.length ?? 0} stateMessages=${event.stateMessages ?? 0}`);
+                logger.log(`[trace] model.result runId=${event.runId} actionCallId=${event.actionCallId} deck=${event.deckPath} model=${event.model ?? "(default)"} finish=${event.finishReason} toolCalls=${event.toolCalls?.length ?? 0} mode=${event.mode ?? "chat"} stateMessages=${event.stateMessages ?? 0}`);
                 break;
             case "log": {
                 const meta = event.meta !== undefined

package/script/src/workspace.d.ts

@@ -0,0 +1,19 @@
+export type WorkspaceScaffold = {
+    id: string;
+    rootDir: string;
+    rootDeckPath: string;
+    createdAt: string;
+};
+export type WorkspaceRootScaffold = {
+    rootDir: string;
+    rootDeckPath: string;
+};
+type WorkspaceScaffoldOptions = {
+    baseDir: string;
+    id?: string;
+    now?: Date;
+};
+export declare function createWorkspaceScaffoldAtRoot(rootDir: string): Promise<WorkspaceRootScaffold>;
+export declare function createWorkspaceScaffold(opts: WorkspaceScaffoldOptions): Promise<WorkspaceScaffold>;
+export {};
+//# sourceMappingURL=workspace.d.ts.map

package/script/src/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/src/workspace.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,CAAC;AAyHF,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC,CA4BhC;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAkC5B"}

package/script/src/workspace.js

@@ -0,0 +1,199 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWorkspaceScaffoldAtRoot = createWorkspaceScaffoldAtRoot;
+exports.createWorkspaceScaffold = createWorkspaceScaffold;
+const dntShim = __importStar(require("../_dnt.shims.js"));
+const path = __importStar(require("../deps/jsr.io/@std/path/1.1.4/mod.js"));
+const mod_js_1 = require("../deps/jsr.io/@std/fs/1.0.23/mod.js");
+const ROOT_PROMPT = `+++
+label = "Workspace Root"
+description = "Starter root deck for this workspace."
+
+[modelParams]
+model = ["ollama/hf.co/LiquidAI/LFM2-1.2B-Tool-GGUF:latest", "openrouter/openai/gpt-5.1-chat"]
+
+[modelParams.reasoning]
+effort = "low"
+summary = "detailed"
+
+[[scenarios]]
+path = "./scenarios/default/PROMPT.md"
+label = "Default scenario"
+description = "Quick sanity check scenario."
+
+[[graders]]
+path = "./graders/default/PROMPT.md"
+label = "Default grader"
+description = "Simple grader to start."
++++
+
+You are the default deck for a new Gambit workspace.
+
+## Assistant Persona
+
+- You are a minimal placeholder deck used to bootstrap a blank workspace.
+- You keep responses short and avoid introducing product narrative.
+
+## User Persona
+
+- The user is in the Build tab and expects guidance on what to do next.
+
+## Behavior
+
+- If asked what to do, reply exactly: "Use the Build tab to draft your deck."
+- Keep all other responses brief, plain text, and focused on build guidance.
+`;
+const ROOT_INTENT = `# Workspace Intent
+
+## Purpose
+
+- Provide a starter workspace deck for the Build/Test/Grade loop.
+
+## Constraints
+
+- Keep the initial behavior simple and easy to replace.
+
+## Tradeoffs
+
+- Favor clarity over advanced functionality in the starter scaffold.
+`;
+const DEFAULT_SCENARIO_PROMPT = `+++
+label = "Default scenario"
+description = "Starter scenario for this workspace."
+contextSchema = "gambit://schemas/scenarios/plain_chat_input_optional.zod.ts"
+responseSchema = "gambit://schemas/scenarios/plain_chat_output.zod.ts"
+
+[modelParams]
+model = ["ollama/hf.co/LiquidAI/LFM2-1.2B-Tool-GGUF:latest", "openrouter/openai/gpt-5.1-chat"]
++++
+
+![scenario-participant](gambit://snippets/scenario-participant.md)
+
+You are a user testing the assistant.
+
+Conversation plan:
+
+1. Start by asking: "What can you help me with?"
+2. If the assistant replies, answer once with: "Thanks!"
+3. End the scenario by returning an empty response.
+
+Rules:
+
+- Keep replies short and plain text.
+- Do not include markdown or lists.
+- If the assistant says it is done, or ends the session, respond with an empty message.
+`;
+const DEFAULT_GRADER_PROMPT = `+++
+label = "Default grader"
+description = "Starter grader for this workspace."
+contextSchema = "gambit://schemas/graders/contexts/conversation.zod.ts"
+responseSchema = "gambit://schemas/graders/grader_output.zod.ts"
+
+[modelParams]
+model = ["ollama/hf.co/LiquidAI/LFM2-1.2B-Tool-GGUF:latest", "openrouter/openai/gpt-5.1-chat"]
++++
+
+You are grading the assistant's response for clarity and helpfulness.
+
+Score 1 if the assistant is clear and directly answers the user.
+Score 0 if the response is vague or unhelpful.
+
+Provide a short reason.
+`;
+const toStamp = (date) => date.toISOString().replace(/[:.]/g, "-");
+const generateWorkspaceId = (date) => `workspace-${toStamp(date)}-${crypto.randomUUID().slice(0, 8)}`;
+async function ensureDir(dir) {
+    await dntShim.Deno.mkdir(dir, { recursive: true });
+}
+async function writeFile(pathValue, contents) {
+    await dntShim.Deno.writeTextFile(pathValue, contents);
+}
+function ensureEmptyPath(pathValue) {
+    if ((0, mod_js_1.existsSync)(pathValue)) {
+        throw new Error(`Init target already exists: ${pathValue}`);
+    }
+}
+async function createWorkspaceScaffoldAtRoot(rootDir) {
+    const resolvedRoot = path.resolve(rootDir);
+    await ensureDir(resolvedRoot);
+    const rootDeckPath = path.join(resolvedRoot, "PROMPT.md");
+    const intentPath = path.join(resolvedRoot, "INTENT.md");
+    const scenariosDir = path.join(resolvedRoot, "scenarios", "default");
+    const gradersDir = path.join(resolvedRoot, "graders", "default");
+    const scenarioPromptPath = path.join(scenariosDir, "PROMPT.md");
+    const graderPromptPath = path.join(gradersDir, "PROMPT.md");
+    await ensureEmptyPath(rootDeckPath);
+    await ensureEmptyPath(intentPath);
+    await ensureEmptyPath(scenarioPromptPath);
+    await ensureEmptyPath(graderPromptPath);
+    await ensureDir(scenariosDir);
+    await ensureDir(gradersDir);
+    await writeFile(rootDeckPath, ROOT_PROMPT);
+    await writeFile(intentPath, ROOT_INTENT);
+    await writeFile(scenarioPromptPath, DEFAULT_SCENARIO_PROMPT);
+    await writeFile(graderPromptPath, DEFAULT_GRADER_PROMPT);
+    return {
+        rootDir: resolvedRoot,
+        rootDeckPath,
+    };
+}
+async function createWorkspaceScaffold(opts) {
+    const baseDir = path.resolve(opts.baseDir);
+    await ensureDir(baseDir);
+    const now = opts.now ?? new Date();
+    let workspaceId = opts.id ?? generateWorkspaceId(now);
+    let rootDir = path.join(baseDir, workspaceId);
+    if ((0, mod_js_1.existsSync)(rootDir)) {
+        workspaceId = generateWorkspaceId(new Date(now.getTime() + 1));
+        rootDir = path.join(baseDir, workspaceId);
+    }
+    const rootDeckPath = path.join(rootDir, "PROMPT.md");
+    const intentPath = path.join(rootDir, "INTENT.md");
+    const scenariosDir = path.join(rootDir, "scenarios", "default");
+    const gradersDir = path.join(rootDir, "graders", "default");
+    await ensureDir(scenariosDir);
+    await ensureDir(gradersDir);
+    await writeFile(rootDeckPath, ROOT_PROMPT);
+    await writeFile(intentPath, ROOT_INTENT);
+    await writeFile(path.join(scenariosDir, "PROMPT.md"), DEFAULT_SCENARIO_PROMPT);
+    await writeFile(path.join(gradersDir, "PROMPT.md"), DEFAULT_GRADER_PROMPT);
+    return {
+        id: workspaceId,
+        rootDir,
+        rootDeckPath,
+        createdAt: now.toISOString(),
+    };
+}

package/script/src/workspace_contract.d.ts

@@ -0,0 +1,78 @@
+export declare const WORKSPACE_STATE_SCHEMA_VERSION = "workspace-state.v1";
+export declare const WORKSPACE_ROUTE_BASE = "/workspaces";
+export declare const WORKSPACE_API_BASE = "/api/workspace";
+export declare const WORKSPACES_API_BASE = "/api/workspaces";
+export type WorkspaceRouteTab = "debug" | "build" | "test" | "grade";
+export declare const WORKSPACE_ROUTE_TABS: Array<WorkspaceRouteTab>;
+export type WorkspaceRoute = {
+    workspaceId: string | null;
+    tab: WorkspaceRouteTab;
+    isNew: boolean;
+    testRunId?: string;
+    gradeRunId?: string;
+};
+export type WorkspaceStreamEvent = {
+    type: "build.stream";
+    workspaceId: string;
+    role: "assistant" | "user";
+    chunk: string;
+    turn?: number;
+    ts?: number;
+} | {
+    type: "build.stream.end";
+    workspaceId: string;
+    role: "assistant" | "user";
+    turn?: number;
+    ts?: number;
+} | {
+    type: "test.stream";
+    workspaceId: string;
+    role: "assistant" | "user";
+    chunk: string;
+    turn?: number;
+    ts?: number;
+} | {
+    type: "test.stream.end";
+    workspaceId: string;
+    role: "assistant" | "user";
+    turn?: number;
+    ts?: number;
+} | {
+    type: "grade.session";
+    workspaceId: string;
+    runId?: string;
+    ts?: number;
+};
+export type WorkspaceReducerEvent = {
+    type: "workspace.loaded";
+    workspaceId: string;
+    state: unknown;
+} | {
+    type: "build.status";
+    workspaceId: string;
+    run: unknown;
+} | {
+    type: "test.status";
+    workspaceId: string;
+    run: unknown;
+} | {
+    type: "grade.status";
+    workspaceId: string;
+    run: unknown;
+} | WorkspaceStreamEvent;
+export type WorkspaceCreateResponse = {
+    workspaceId: string;
+    deckPath: string;
+    workspaceDir: string;
+    createdAt: string;
+    workspaceSchemaVersion: string;
+};
+export declare const buildWorkspacePath: (tab: WorkspaceRouteTab, workspaceId?: string | null, opts?: {
+    runId?: string;
+}) => string;
+export declare const parseWorkspaceRoute: (pathname: string) => WorkspaceRoute | null;
+export declare const WORKSPACE_ID_ALIASES: readonly ["workspaceId"];
+export declare const resolveWorkspaceIdFromRecord: (record: Record<string, unknown>) => string | undefined;
+export declare const resolveWorkspaceIdFromSearchParams: (params: URLSearchParams) => string | undefined;
+export declare const workspaceSchemaError: (workspaceId: string, foundVersion: string | null) => string;
+//# sourceMappingURL=workspace_contract.d.ts.map

package/script/src/workspace_contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace_contract.d.ts","sourceRoot":"","sources":["../../src/src/workspace_contract.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,8BAA8B,uBAAuB,CAAC;AAEnE,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAClD,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAErE,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,iBAAiB,CAKzD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,EAAE,iBAAiB,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAC5B;IACA,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GACC;IACA,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GACC;IACA,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GACC;IACA,IAAI,EAAE,iBAAiB,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GACC;IACA,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEJ,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAC3D,oBAAoB,CAAC;AAEzB,MAAM,MAAM,uBAAuB,GAAG;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,KAAK,iBAAiB,EACtB,cAAc,MAAM,GAAG,IAAI,EAC3B,OAAO;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KACxB,MAOF,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,UAAU,MAAM,KACf,cAAc,GAAG,IAsBnB,CAAC;AAEF,eAAO,MAAM,oBAAoB,0BAA2B,CAAC;AAa7D,eAAO,MAAM,4BAA4B,GACvC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,MAAM,GAAG,SAMX,CAAC;AAEF,eAAO,MAAM,kCAAkC,GAC7C,QAAQ,eAAe,KACtB,MAAM,GAAG,SAQX,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,aAAa,MAAM,EACnB,cAAc,MAAM,GAAG,IAAI,KAC1B,MAOF,CAAC"}

package/script/src/workspace_contract.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.workspaceSchemaError = exports.resolveWorkspaceIdFromSearchParams = exports.resolveWorkspaceIdFromRecord = exports.WORKSPACE_ID_ALIASES = exports.parseWorkspaceRoute = exports.buildWorkspacePath = exports.WORKSPACE_ROUTE_TABS = exports.WORKSPACES_API_BASE = exports.WORKSPACE_API_BASE = exports.WORKSPACE_ROUTE_BASE = exports.WORKSPACE_STATE_SCHEMA_VERSION = void 0;
+exports.WORKSPACE_STATE_SCHEMA_VERSION = "workspace-state.v1";
+exports.WORKSPACE_ROUTE_BASE = "/workspaces";
+exports.WORKSPACE_API_BASE = "/api/workspace";
+exports.WORKSPACES_API_BASE = "/api/workspaces";
+exports.WORKSPACE_ROUTE_TABS = [
+    "debug",
+    "build",
+    "test",
+    "grade",
+];
+const buildWorkspacePath = (tab, workspaceId, opts) => {
+    const encoded = workspaceId ? encodeURIComponent(workspaceId) : "new";
+    const base = `${exports.WORKSPACE_ROUTE_BASE}/${encoded}/${tab}`;
+    const runId = opts?.runId;
+    if (!runId)
+        return base;
+    if (tab !== "test" && tab !== "grade")
+        return base;
+    return `${base}/${encodeURIComponent(runId)}`;
+};
+exports.buildWorkspacePath = buildWorkspacePath;
+const parseWorkspaceRoute = (pathname) => {
+    const match = pathname.match(/^\/workspaces\/([^/]+)\/(debug|build|test|grade)(?:\/([^/]+))?$/);
+    if (!match)
+        return null;
+    const rawId = decodeURIComponent(match[1]);
+    const tab = match[2];
+    const runSegment = typeof match[3] === "string"
+        ? decodeURIComponent(match[3])
+        : undefined;
+    if (runSegment && tab !== "test" && tab !== "grade")
+        return null;
+    if (rawId === "new" && runSegment)
+        return null;
+    if (rawId === "new") {
+        return { workspaceId: null, tab, isNew: true };
+    }
+    return {
+        workspaceId: rawId,
+        tab,
+        isNew: false,
+        testRunId: tab === "test" ? runSegment : undefined,
+        gradeRunId: tab === "grade" ? runSegment : undefined,
+    };
+};
+exports.parseWorkspaceRoute = parseWorkspaceRoute;
+exports.WORKSPACE_ID_ALIASES = ["workspaceId"];
+const readString = (record, key) => {
+    const value = record[key];
+    return typeof value === "string" && value.trim().length > 0
+        ? value
+        : undefined;
+};
+const resolveWorkspaceIdFromRecord = (record) => {
+    for (const key of exports.WORKSPACE_ID_ALIASES) {
+        const value = readString(record, key);
+        if (value)
+            return value;
+    }
+    return undefined;
+};
+exports.resolveWorkspaceIdFromRecord = resolveWorkspaceIdFromRecord;
+const resolveWorkspaceIdFromSearchParams = (params) => {
+    for (const key of exports.WORKSPACE_ID_ALIASES) {
+        const value = params.get(key);
+        if (typeof value === "string" && value.trim().length > 0) {
+            return value;
+        }
+    }
+    return undefined;
+};
+exports.resolveWorkspaceIdFromSearchParams = resolveWorkspaceIdFromSearchParams;
+const workspaceSchemaError = (workspaceId, foundVersion) => {
+    const shown = foundVersion ? `"${foundVersion}"` : "missing";
+    return [
+        `Unsupported workspace state schema for "${workspaceId}" (found ${shown}).`,
+        `Expected "${exports.WORKSPACE_STATE_SCHEMA_VERSION}".`,
+        `Recreate this workspace with ${exports.WORKSPACE_API_BASE}/new.`,
+    ].join(" ");
+};
+exports.workspaceSchemaError = workspaceSchemaError;