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

package/esm/src/durable_streams.js

@@ -128,5 +128,30 @@ export async function handleDurableStreamRequest(request) {
     });
 }
 function formatSseEvent(event) {
-    return `id: ${event.offset}\ndata: ${JSON.stringify(event)}\n\n`;
+    const payload = normalizeSsePayload(event.data);
+    const type = payload.type;
+    return `id: ${event.offset}\nevent: ${type}\ndata: ${JSON.stringify(payload)}\n\n`;
+}
+function normalizeSsePayload(value) {
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+        const record = value;
+        const rawType = typeof record.type === "string"
+            ? record.type.trim()
+            : "gambit.event";
+        const type = sanitizeSseEventType(rawType);
+        return {
+            ...record,
+            type,
+        };
+    }
+    return {
+        type: "gambit.event",
+        value,
+    };
+}
+function sanitizeSseEventType(value) {
+    if (!value)
+        return "gambit.event";
+    const normalized = value.replace(/[^A-Za-z0-9_.-]/g, "_");
+    return normalized.length > 0 ? normalized : "gambit.event";
 }

package/esm/src/model_matchers.d.ts

@@ -0,0 +1,10 @@
+import type { ProviderKey } from "./providers/router.js";
+export type ProviderMatchers = {
+    isUnprefixedModel: (model: string) => boolean;
+    matchesOpenRouter: (model: string) => boolean;
+    matchesOllama: (model: string) => boolean;
+    matchesGoogle: (model: string) => boolean;
+    matchesCodex: (model: string) => boolean;
+};
+export declare function createProviderMatchers(effectiveFallbackProvider: ProviderKey | null): ProviderMatchers;
+//# sourceMappingURL=model_matchers.d.ts.map

package/esm/src/model_matchers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model_matchers.d.ts","sourceRoot":"","sources":["../../src/src/model_matchers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AASzD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;CAC1C,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,yBAAyB,EAAE,WAAW,GAAG,IAAI,GAC5C,gBAAgB,CAyBlB"}

package/esm/src/model_matchers.js

@@ -0,0 +1,26 @@
+import { GOOGLE_PREFIX } from "./providers/google.js";
+import { OLLAMA_PREFIX } from "./providers/ollama.js";
+import { OPENROUTER_PREFIX } from "./providers/openrouter.js";
+import { CODEX_PREFIX } from "./providers/codex.js";
+const LEGACY_CODEX_PREFIX = "codex/";
+const CODEX_PROVIDER_ALIAS = "codex-cli";
+export function createProviderMatchers(effectiveFallbackProvider) {
+    const isUnprefixedModel = (model) => model.trim() !== CODEX_PROVIDER_ALIAS &&
+        !model.startsWith(OPENROUTER_PREFIX) &&
+        !model.startsWith(OLLAMA_PREFIX) &&
+        !model.startsWith(GOOGLE_PREFIX) &&
+        !model.startsWith(CODEX_PREFIX) &&
+        !model.startsWith(LEGACY_CODEX_PREFIX);
+    return {
+        isUnprefixedModel,
+        matchesOpenRouter: (model) => model.startsWith(OPENROUTER_PREFIX) ||
+            (isUnprefixedModel(model) && effectiveFallbackProvider === "openrouter"),
+        matchesOllama: (model) => model.startsWith(OLLAMA_PREFIX) ||
+            (isUnprefixedModel(model) && effectiveFallbackProvider === "ollama"),
+        matchesGoogle: (model) => model.startsWith(GOOGLE_PREFIX) ||
+            (isUnprefixedModel(model) && effectiveFallbackProvider === "google"),
+        matchesCodex: (model) => model.trim() === CODEX_PROVIDER_ALIAS ||
+            model.startsWith(CODEX_PREFIX) ||
+            (isUnprefixedModel(model) && effectiveFallbackProvider === "codex-cli"),
+    };
+}

package/esm/src/openai_compat.d.ts

@@ -0,0 +1,74 @@
+import { resolveEffectivePermissions } from "@bolt-foundry/gambit-core";
+import type { Guardrails, ModelMessage, ModelProvider, PermissionDeclarationInput, PermissionTrace, ToolDefinition } from "@bolt-foundry/gambit-core";
+export declare const logger: Console;
+export type ChatCompletionsRequest = {
+    model: string;
+    messages: Array<{
+        role: "system" | "user" | "assistant" | "tool";
+        content: string | null | Array<string | {
+            text?: string;
+            type?: string;
+        }>;
+        name?: string;
+        tool_call_id?: string;
+        tool_calls?: ModelMessage["tool_calls"];
+    }>;
+    tools?: Array<ToolDefinition>;
+    stream?: boolean;
+    temperature?: number;
+    top_p?: number;
+    frequency_penalty?: number;
+    presence_penalty?: number;
+    max_tokens?: number;
+    [key: string]: unknown;
+};
+export type ChatCompletionsResponse = {
+    id: string;
+    object: "chat.completion";
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: ModelMessage;
+        finish_reason: "stop" | "tool_calls" | "length";
+        logprobs: null;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+    /**
+     * Non-OpenAI extension field containing the full transcript and metadata.
+     * Most clients will ignore unknown fields.
+     */
+    gambit?: {
+        deckPath: string;
+        messages: Array<ModelMessage>;
+        runId: string;
+    };
+};
+export declare function chatCompletionsWithDeck(args: {
+    deckPath: string;
+    request: ChatCompletionsRequest;
+    modelProvider: ModelProvider;
+    /**
+     * When true (default), Gambit will execute tool calls that match deck actions.
+     * Any other tool calls are returned to the caller as normal OpenAI tool calls.
+     */
+    executeDeckTools?: boolean;
+    guardrails?: Partial<Guardrails>;
+    defaultModel?: string;
+    onStreamText?: (chunk: string) => void;
+    workspacePermissions?: PermissionDeclarationInput;
+    workspacePermissionsBaseDir?: string;
+    sessionPermissions?: PermissionDeclarationInput;
+    sessionPermissionsBaseDir?: string;
+    parentPermissions?: ReturnType<typeof resolveEffectivePermissions>["effective"];
+    workerSandbox?: boolean;
+    trace?: (event: {
+        type: string;
+        permissions?: PermissionTrace;
+    }) => void;
+}): Promise<ChatCompletionsResponse>;
+//# sourceMappingURL=openai_compat.d.ts.map

package/esm/src/openai_compat.d.ts.map

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

package/esm/src/openai_compat.js

@@ -0,0 +1,329 @@
+import * as dntShim from "../_dnt.shims.js";
+import * as path from "../deps/jsr.io/@std/path/1.1.4/mod.js";
+import { assertZodSchema, DEFAULT_GUARDRAILS, loadDeck, RESERVED_TOOL_PREFIX, resolveEffectivePermissions, runDeck, toJsonSchema, } from "@bolt-foundry/gambit-core";
+export const logger = console;
+function randomId(prefix) {
+    const suffix = crypto.randomUUID().replace(/-/g, "").slice(0, 24);
+    return `${prefix}-${suffix}`;
+}
+function normalizeContent(content) {
+    if (content === null)
+        return null;
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return String(content);
+    return content
+        .map((c) => (typeof c === "string" ? c : (c.text ?? "")))
+        .join("");
+}
+function normalizeMessages(input) {
+    return input.map((m) => ({
+        role: m.role,
+        content: normalizeContent(m.content),
+        name: m.name,
+        tool_call_id: m.tool_call_id,
+        tool_calls: m.tool_calls && m.tool_calls.length > 0
+            ? m.tool_calls
+            : undefined,
+    }));
+}
+function providerParamsFromRequest(req) {
+    const out = {};
+    if (req.temperature !== undefined)
+        out.temperature = req.temperature;
+    if (req.top_p !== undefined)
+        out.top_p = req.top_p;
+    if (req.frequency_penalty !== undefined) {
+        out.frequency_penalty = req.frequency_penalty;
+    }
+    if (req.presence_penalty !== undefined) {
+        out.presence_penalty = req.presence_penalty;
+    }
+    if (req.max_tokens !== undefined)
+        out.max_tokens = req.max_tokens;
+    return Object.keys(out).length ? out : undefined;
+}
+function mergeToolDefs(gambitTools, externalTools) {
+    if (!externalTools?.length)
+        return gambitTools;
+    return [...gambitTools, ...externalTools];
+}
+function toolName(tool) {
+    return tool.function?.name ?? "";
+}
+function resolveContextSchema(deck) {
+    return deck.contextSchema ?? deck.inputSchema;
+}
+function resolveResponseSchema(deck) {
+    return deck.responseSchema ?? deck.outputSchema;
+}
+function assertNoToolNameCollisions(args) {
+    if (!args.externalTools?.length)
+        return;
+    const gambit = new Set(args.gambitTools.map(toolName));
+    for (const t of args.externalTools) {
+        const name = toolName(t);
+        if (!name)
+            continue;
+        if (name.startsWith(RESERVED_TOOL_PREFIX)) {
+            throw new Error(`External tool name ${name} is reserved (prefix ${RESERVED_TOOL_PREFIX})`);
+        }
+        if (gambit.has(name)) {
+            throw new Error(`Tool name collision for ${name} between Gambit deck actions and external tools`);
+        }
+    }
+}
+async function buildGambitActionTools(deck) {
+    const tools = [];
+    const toolNameSet = new Set();
+    const actionPathByName = new Map();
+    for (const action of deck.actionDecks) {
+        const child = await loadDeck(action.path, deck.path);
+        const contextSchema = resolveContextSchema(child);
+        const responseSchema = resolveResponseSchema(child);
+        if (!contextSchema || !responseSchema) {
+            throw new Error(`Deck ${child.path} must declare contextSchema and responseSchema (non-root)`);
+        }
+        assertZodSchema(contextSchema, "contextSchema");
+        assertZodSchema(responseSchema, "responseSchema");
+        const params = toJsonSchema(contextSchema);
+        tools.push({
+            type: "function",
+            function: {
+                name: action.name,
+                description: action.description,
+                parameters: params,
+            },
+        });
+        toolNameSet.add(action.name);
+        actionPathByName.set(action.name, action.path);
+    }
+    return { tools, toolNameSet, actionPathByName };
+}
+function deckSystemPrompt(deck) {
+    const parts = [];
+    const prompt = deck.body ?? deck.prompt;
+    if (prompt)
+        parts.push(prompt.trim());
+    for (const card of deck.cards) {
+        if (card.body)
+            parts.push(card.body.trim());
+    }
+    return parts.join("\n\n").trim();
+}
+function shouldPrependDeckSystem(messages, systemPrompt) {
+    if (!systemPrompt)
+        return false;
+    if (!messages.length)
+        return true;
+    const hasExact = messages.some((m) => m.role === "system" && m.content === systemPrompt);
+    return !hasExact;
+}
+function warnIfSystemMismatch(args) {
+    if (!args.systemPrompt)
+        return;
+    const existing = args.provided.find((m) => m.role === "system");
+    if (!existing)
+        return;
+    if (existing.content === args.systemPrompt)
+        return;
+    logger.warn(`[gambit] chatCompletionsWithDeck: request includes a system message that does not match the deck prompt (${args.deckPath})`);
+}
+function toolResultContent(result) {
+    if (typeof result === "string")
+        return result;
+    try {
+        return JSON.stringify(result);
+    }
+    catch {
+        return String(result);
+    }
+}
+function normalizeError(err) {
+    return { message: err instanceof Error ? err.message : String(err) };
+}
+export async function chatCompletionsWithDeck(args) {
+    const executeDeckTools = args.executeDeckTools ?? true;
+    const guardrails = { ...DEFAULT_GUARDRAILS, ...args.guardrails };
+    const runId = randomId("run");
+    const deck = await loadDeck(args.deckPath);
+    const rootPermissions = resolveEffectivePermissions({
+        baseDir: path.dirname(deck.path),
+        parent: args.parentPermissions,
+        workspace: args.workspacePermissions
+            ? {
+                baseDir: args.workspacePermissionsBaseDir ?? path.dirname(deck.path),
+                permissions: args.workspacePermissions,
+            }
+            : undefined,
+        declaration: deck.permissions
+            ? {
+                baseDir: path.dirname(deck.path),
+                permissions: deck.permissions,
+            }
+            : undefined,
+        session: args.sessionPermissions
+            ? {
+                baseDir: args.sessionPermissionsBaseDir ?? dntShim.Deno.cwd(),
+                permissions: args.sessionPermissions,
+            }
+            : undefined,
+    });
+    args.trace?.({
+        type: "openai_compat.permissions",
+        permissions: rootPermissions.trace,
+    });
+    const systemPrompt = deckSystemPrompt(deck);
+    const providedMessages = normalizeMessages(args.request.messages);
+    const messages = [];
+    warnIfSystemMismatch({
+        provided: providedMessages,
+        systemPrompt,
+        deckPath: deck.path,
+    });
+    if (shouldPrependDeckSystem(providedMessages, systemPrompt)) {
+        messages.push({ role: "system", content: systemPrompt });
+    }
+    messages.push(...providedMessages);
+    const gambit = await buildGambitActionTools(deck);
+    assertNoToolNameCollisions({
+        gambitTools: gambit.tools,
+        externalTools: args.request.tools,
+    });
+    const tools = mergeToolDefs(gambit.tools, args.request.tools);
+    const start = performance.now();
+    let passes = 0;
+    while (passes < guardrails.maxPasses) {
+        passes++;
+        if (performance.now() - start > guardrails.timeoutMs) {
+            throw new Error("Timeout exceeded");
+        }
+        const model = args.request.model ?? args.defaultModel ??
+            (() => {
+                throw new Error("No model provided");
+            })();
+        const result = await args.modelProvider.chat({
+            model,
+            messages,
+            tools: tools.length ? tools : undefined,
+            stream: Boolean(args.request.stream),
+            deckPath: deck.path,
+            onStreamText: args.onStreamText,
+            params: providerParamsFromRequest(args.request),
+        });
+        messages.push(result.message);
+        if (result.toolCalls && result.toolCalls.length > 0) {
+            const gambitCalls = result.toolCalls.filter((c) => gambit.toolNameSet.has(c.name));
+            const externalCalls = result.toolCalls.filter((c) => !gambit.toolNameSet.has(c.name));
+            if (!executeDeckTools || externalCalls.length > 0) {
+                return {
+                    id: randomId("chatcmpl"),
+                    object: "chat.completion",
+                    created: Math.floor(Date.now() / 1000),
+                    model,
+                    choices: [{
+                            index: 0,
+                            message: result.message,
+                            finish_reason: "tool_calls",
+                            logprobs: null,
+                        }],
+                    usage: result.usage
+                        ? {
+                            prompt_tokens: result.usage.promptTokens,
+                            completion_tokens: result.usage.completionTokens,
+                            total_tokens: result.usage.totalTokens,
+                        }
+                        : undefined,
+                    gambit: { deckPath: deck.path, messages, runId },
+                };
+            }
+            // Execute only deck-defined tool calls.
+            for (const call of gambitCalls) {
+                const actionPath = gambit.actionPathByName.get(call.name);
+                if (!actionPath)
+                    continue;
+                try {
+                    const actionRef = deck.actionDecks.find((entry) => entry.name === call.name);
+                    const actionPermissions = resolveEffectivePermissions({
+                        baseDir: path.dirname(deck.path),
+                        parent: rootPermissions.effective,
+                        reference: actionRef?.permissions
+                            ? {
+                                baseDir: path.dirname(deck.path),
+                                permissions: actionRef.permissions,
+                            }
+                            : undefined,
+                    });
+                    args.trace?.({
+                        type: "openai_compat.action.permissions",
+                        permissions: actionPermissions.trace,
+                    });
+                    const childResult = await runDeck({
+                        path: actionPath,
+                        input: call.args,
+                        modelProvider: args.modelProvider,
+                        isRoot: false,
+                        guardrails,
+                        depth: 1,
+                        parentActionCallId: call.id,
+                        runId,
+                        defaultModel: model,
+                        modelOverride: undefined,
+                        trace: undefined,
+                        stream: Boolean(args.request.stream),
+                        onStreamText: args.onStreamText,
+                        inputProvided: true,
+                        parentPermissions: rootPermissions.effective,
+                        referencePermissions: actionRef?.permissions,
+                        referencePermissionsBaseDir: path.dirname(deck.path),
+                        workspacePermissions: args.workspacePermissions,
+                        workspacePermissionsBaseDir: args.workspacePermissionsBaseDir,
+                        sessionPermissions: args.sessionPermissions,
+                        sessionPermissionsBaseDir: args.sessionPermissionsBaseDir,
+                        workerSandbox: args.workerSandbox,
+                    });
+                    messages.push({
+                        role: "tool",
+                        name: call.name,
+                        tool_call_id: call.id,
+                        content: toolResultContent(childResult),
+                    });
+                }
+                catch (err) {
+                    messages.push({
+                        role: "tool",
+                        name: call.name,
+                        tool_call_id: call.id,
+                        content: JSON.stringify({ error: normalizeError(err) }),
+                    });
+                }
+            }
+            continue;
+        }
+        if (result.finishReason === "tool_calls") {
+            throw new Error("Model requested tool_calls but provided none");
+        }
+        return {
+            id: randomId("chatcmpl"),
+            object: "chat.completion",
+            created: Math.floor(Date.now() / 1000),
+            model,
+            choices: [{
+                    index: 0,
+                    message: result.message,
+                    finish_reason: result.finishReason,
+                    logprobs: null,
+                }],
+            usage: result.usage
+                ? {
+                    prompt_tokens: result.usage.promptTokens,
+                    completion_tokens: result.usage.completionTokens,
+                    total_tokens: result.usage.totalTokens,
+                }
+                : undefined,
+            gambit: { deckPath: deck.path, messages, runId },
+        };
+    }
+    throw new Error("Max passes exceeded without completing");
+}

package/esm/src/project_config.d.ts

@@ -0,0 +1,47 @@
+import type { PermissionDeclarationInput } from "@bolt-foundry/gambit-core";
+export type WorkspaceConfig = {
+    decks?: string;
+    actions?: string;
+    graders?: string;
+    tests?: string;
+    schemas?: string;
+    permissions?: PermissionDeclarationInput;
+};
+export type ModelAliasConfig = {
+    model?: string | Array<string>;
+    description?: string;
+    params?: Record<string, unknown>;
+};
+export type GambitConfig = {
+    workspace?: WorkspaceConfig;
+    execution?: {
+        workerSandbox?: boolean;
+        worker_sandbox?: boolean;
+        legacyExec?: boolean;
+        legacy_exec?: boolean;
+    };
+    models?: {
+        aliases?: Record<string, ModelAliasConfig>;
+    };
+    providers?: {
+        fallback?: string;
+    };
+};
+export type LoadedProjectConfig = {
+    root: string;
+    path: string;
+    config: GambitConfig;
+};
+export declare function loadProjectConfig(startPath?: string): Promise<LoadedProjectConfig | null>;
+export type ModelAliasResolution = {
+    model?: string | Array<string>;
+    params?: Record<string, unknown>;
+    alias?: string;
+    applied: boolean;
+    missingAlias?: boolean;
+};
+export type ModelAliasResolver = (model?: string) => ModelAliasResolution;
+export declare function createModelAliasResolver(config?: GambitConfig | null): ModelAliasResolver;
+export declare function resolveWorkspacePermissions(config?: GambitConfig | null): PermissionDeclarationInput | undefined;
+export declare function resolveWorkerSandboxSetting(config?: GambitConfig | null): boolean | undefined;
+//# sourceMappingURL=project_config.d.ts.map

package/esm/src/project_config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project_config.d.ts","sourceRoot":"","sources":["../../src/src/project_config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAE5E,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,0BAA0B,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,SAAS,CAAC,EAAE;QACV,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;KAC5C,CAAC;IACF,SAAS,CAAC,EAAE;QACV,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAsCF,wBAAsB,iBAAiB,CACrC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAiBrC;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,oBAAoB,CAAC;AAE1E,wBAAgB,wBAAwB,CACtC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,GAC3B,kBAAkB,CA8CpB;AAED,wBAAgB,2BAA2B,CACzC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,GAC3B,0BAA0B,GAAG,SAAS,CAIxC;AAOD,wBAAgB,2BAA2B,CACzC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,GAC3B,OAAO,GAAG,SAAS,CAsBrB"}

package/esm/src/project_config.js

@@ -0,0 +1,134 @@
+import * as dntShim from "../_dnt.shims.js";
+import { parse as parseToml } from "../deps/jsr.io/@std/toml/1.0.11/mod.js";
+import * as path from "../deps/jsr.io/@std/path/1.1.4/mod.js";
+const CONFIG_FILENAME = "gambit.toml";
+const configCache = new Map();
+function isPlainObject(value) {
+    return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function resolveStartDir(target) {
+    if (!target)
+        return dntShim.Deno.cwd();
+    const resolved = path.resolve(target);
+    try {
+        const info = dntShim.Deno.statSync(resolved);
+        if (info.isDirectory)
+            return resolved;
+        return path.dirname(resolved);
+    }
+    catch {
+        return path.dirname(resolved);
+    }
+}
+function findConfigPath(startDir) {
+    let current = startDir;
+    while (true) {
+        const candidate = path.join(current, CONFIG_FILENAME);
+        try {
+            const info = dntShim.Deno.statSync(candidate);
+            if (info.isFile)
+                return candidate;
+        }
+        catch {
+            // ignore and continue walking up the tree
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return null;
+}
+export async function loadProjectConfig(startPath) {
+    const startDir = resolveStartDir(startPath);
+    const configPath = findConfigPath(startDir);
+    if (!configPath)
+        return null;
+    const cached = configCache.get(configPath);
+    if (cached !== undefined) {
+        return cached;
+    }
+    const text = await dntShim.Deno.readTextFile(configPath);
+    const parsed = parseToml(text);
+    const loaded = {
+        root: path.dirname(configPath),
+        path: configPath,
+        config: parsed ?? {},
+    };
+    configCache.set(configPath, loaded);
+    return loaded;
+}
+export function createModelAliasResolver(config) {
+    const resolved = new Map();
+    const aliases = config?.models?.aliases;
+    if (isPlainObject(aliases)) {
+        for (const [name, raw] of Object.entries(aliases)) {
+            if (!isPlainObject(raw))
+                continue;
+            let model;
+            if (typeof raw.model === "string") {
+                const trimmed = raw.model.trim();
+                if (trimmed)
+                    model = trimmed;
+            }
+            else if (Array.isArray(raw.model)) {
+                const entries = raw.model
+                    .map((entry) => (typeof entry === "string" ? entry.trim() : ""))
+                    .filter(Boolean);
+                if (entries.length > 0)
+                    model = entries;
+            }
+            if (!model)
+                continue;
+            const params = isPlainObject(raw.params)
+                ? structuredClone(raw.params)
+                : undefined;
+            resolved.set(name, { model, params });
+        }
+    }
+    const hasAliases = resolved.size > 0;
+    return (model) => {
+        if (!model) {
+            return { model, applied: false };
+        }
+        const entry = resolved.get(model);
+        if (entry) {
+            return {
+                model: entry.model,
+                params: entry.params ? structuredClone(entry.params) : undefined,
+                alias: model,
+                applied: true,
+            };
+        }
+        const missingAlias = hasAliases && !model.includes("/");
+        return { model, applied: false, missingAlias };
+    };
+}
+export function resolveWorkspacePermissions(config) {
+    const raw = config?.workspace?.permissions;
+    if (!isPlainObject(raw))
+        return undefined;
+    return raw;
+}
+function resolveBooleanField(value) {
+    if (typeof value === "boolean")
+        return value;
+    return undefined;
+}
+export function resolveWorkerSandboxSetting(config) {
+    const execution = config?.execution;
+    if (!isPlainObject(execution))
+        return undefined;
+    const workerSandbox = resolveBooleanField(execution.workerSandbox ?? execution.worker_sandbox);
+    const legacyExec = resolveBooleanField(execution.legacyExec ?? execution.legacy_exec);
+    if (workerSandbox !== undefined && legacyExec !== undefined) {
+        if (workerSandbox === legacyExec) {
+            throw new Error("gambit.toml execution config is conflicting: worker_sandbox and legacy_exec must be opposites when both are set.");
+        }
+    }
+    if (workerSandbox !== undefined)
+        return workerSandbox;
+    if (legacyExec !== undefined)
+        return !legacyExec;
+    return undefined;
+}