deepclause-sdk 0.0.88 → 0.1.0

package/dist/repl/backend.d.ts

@@ -0,0 +1,290 @@
+/**
+ * Backend resolution for the REPL (M5).
+ *
+ * `env` uses the SDK's provider/API-key backend (unchanged). `pi` reuses pi's
+ * own model registry and credential store so the REPL runs against the model
+ * configured in pi, without asking for API keys or writing provider env vars.
+ *
+ * The pi packages are optional peers and loaded with a dynamic import only when
+ * the pi backend is selected.
+ */
+import type { LLMBackend } from '../types.js';
+export type BackendKind = 'env' | 'pi';
+export interface PiBackendConfig {
+    kind?: BackendKind;
+    agentDir?: string;
+    modelsPath?: string | null;
+    authPath?: string | null;
+    model?: string;
+    /** Requested thinking level for reasoning models (see `ThinkingLevel`). */
+    thinkingLevel?: string;
+}
+export interface ResolvedBackendPaths {
+    agentDir: string;
+    modelsPath: string;
+    authPath: string;
+    model?: string;
+}
+/** Minimal structural view of pi's ModelRegistry used by the adapter. */
+export interface PiModelLike {
+    provider: string;
+    id: string;
+    api?: string;
+    /** Whether the model accepts a thinking/reasoning level. */
+    reasoning?: boolean;
+    /** Model context window in tokens. */
+    contextWindow?: number;
+    /** Maximum output tokens. */
+    maxTokens?: number;
+    /** Maps pi thinking levels to provider values; `null` marks a level unsupported. */
+    thinkingLevelMap?: Partial<Record<ThinkingLevel, string | null>>;
+}
+/** pi's thinking levels, in ascending effort order. */
+export type ThinkingLevel = 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+export declare const THINKING_LEVELS: readonly ThinkingLevel[];
+/** Levels a model accepts: reasoning models expose all but explicitly-unsupported ones. */
+export declare function supportedThinkingLevels(model: PiModelLike): ThinkingLevel[];
+/**
+ * Validate a requested thinking level against the model. Returns the level to
+ * pass through (or `undefined` for the provider default) plus a warning when a
+ * request had to be dropped.
+ */
+export declare function resolveThinkingLevel(model: PiModelLike, requested?: string): {
+    level?: ThinkingLevel;
+    supported: ThinkingLevel[];
+    warning?: string;
+};
+export interface PiCompletionRequest {
+    systemPrompt?: string;
+    messages: unknown[];
+    tools?: unknown[];
+}
+export interface PiCompletionResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    } | {
+        type: 'toolCall';
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+    }>;
+    usage: {
+        input: number;
+        output: number;
+        totalTokens: number;
+        cacheRead?: number;
+        cacheWrite?: number;
+        reasoning?: number;
+    };
+    stopReason: 'stop' | 'toolUse' | 'length' | 'error' | 'aborted';
+    errorMessage?: string;
+}
+export interface PiStreamEventLike {
+    type: string;
+    delta?: string;
+}
+export interface PiStreamLike extends AsyncIterable<PiStreamEventLike> {
+    result(): Promise<PiCompletionResult>;
+}
+export interface PiRegistryLike {
+    getAvailable(): PiModelLike[];
+    find?(provider: string, modelId: string): PiModelLike | undefined;
+    hasConfiguredAuth(model: PiModelLike): boolean;
+    complete(model: PiModelLike, context: PiCompletionRequest, options: unknown): Promise<PiCompletionResult>;
+    /** Streaming API; when present, `complete` forwards text/thinking deltas. */
+    streamSimple?(model: PiModelLike, context: PiCompletionRequest, options: unknown): PiStreamLike;
+}
+/** Resolve pi's agent dir, models.json, and auth.json paths. */
+export declare function resolvePiPaths(config: PiBackendConfig, defaults: {
+    agentDir: string;
+}): ResolvedBackendPaths;
+/** Select the pi model to use, honoring an explicit provider/model request. */
+export declare function selectPiModel(registry: PiRegistryLike, requested?: string): PiModelLike;
+/**
+ * Wrap a pi registry + model as an SDK `LLMBackend`. Reused by the extension
+ * embedding, which passes its live registry.
+ *
+ * `thinkingLevel` is forwarded to the provider only for reasoning models and
+ * non-`off` levels, so provider defaults are preserved for every other model.
+ */
+export declare function createPiAdapter(registry: PiRegistryLike, model: PiModelLike, maxTokens?: number, thinkingLevel?: string): {
+    backend: LLMBackend;
+    modelId: string;
+    provider: string;
+    contextWindow?: number;
+    maxTokens: number;
+    reasoning: boolean;
+    thinkingLevel?: ThinkingLevel;
+    supportedThinkingLevels: ThinkingLevel[];
+    warning?: string;
+};
+export interface CreatePiBackendOptions extends PiBackendConfig {
+    maxTokens?: number;
+    /** Injected registry (used by tests and by a pi embedding). */
+    modelRegistry?: PiRegistryLike;
+}
+/** Structural view of pi's runtime used for setup/catalog/auth operations. */
+export interface PiRuntimeLike {
+    getProviders(): Array<{
+        id: string;
+        name?: string;
+        auth?: {
+            apiKey?: unknown;
+            oauth?: {
+                isSubscription?: boolean;
+            };
+        };
+    }>;
+    getProvider(providerId: string): {
+        id: string;
+        name?: string;
+        auth?: {
+            apiKey?: unknown;
+            oauth?: {
+                isSubscription?: boolean;
+            };
+        };
+    } | undefined;
+    getModels(providerId?: string): PiModelLike[];
+    hasConfiguredAuth(providerId: string): boolean;
+    getProviderAuthStatus(providerId: string): {
+        configured: boolean;
+        label?: string;
+        source?: string;
+    };
+    isUsingOAuth(providerId: string): boolean;
+    listCredentials(options?: unknown): Promise<Array<{
+        providerId: string;
+        type: string;
+    }>>;
+    login(providerId: string, type: string, interaction: unknown, options?: unknown): Promise<unknown>;
+    logout(providerId: string, options?: unknown): Promise<void>;
+}
+export interface PiProviderInfo {
+    id: string;
+    name: string;
+    apiKey: boolean;
+    oauth: boolean;
+    configured: boolean;
+    source?: string;
+    label?: string;
+}
+export interface PiModelInfo {
+    provider: string;
+    id: string;
+    name: string;
+    reasoning: boolean;
+    contextWindow?: number;
+    maxTokens?: number;
+    /** Thinking levels the model accepts (empty/undefined for non-reasoning). */
+    supportedThinkingLevels?: ThinkingLevel[];
+}
+/** Build the catalog `PiModelInfo` (with reasoning levels) from a raw model. */
+export declare function toPiModelInfo(model: PiModelLike & {
+    name?: string;
+}): PiModelInfo;
+export interface PiAuthPromptLike {
+    signal?: AbortSignal;
+    type: 'text' | 'secret' | 'select' | 'manual_code';
+    message: string;
+    placeholder?: string;
+    options?: ReadonlyArray<{
+        id: string;
+        label: string;
+        description?: string;
+    }>;
+}
+export interface PiAuthEventLike {
+    type: 'info' | 'auth_url' | 'device_code' | 'progress';
+    message?: string;
+    url?: string;
+    instructions?: string;
+    userCode?: string;
+    verificationUri?: string;
+    links?: ReadonlyArray<{
+        url: string;
+        label?: string;
+    }>;
+}
+export interface PiAuthInteractionLike {
+    signal?: AbortSignal;
+    prompt(prompt: PiAuthPromptLike): Promise<string>;
+    notify(event: PiAuthEventLike): void;
+}
+/** List providers from a pi runtime with auth capability/status. */
+export declare function listPiProviders(runtime: PiRuntimeLike): PiProviderInfo[];
+/** List chat models from a pi runtime, optionally filtered by provider. */
+export declare function listPiModels(runtime: PiRuntimeLike, providerId?: string): PiModelInfo[];
+/** A pi runtime handle: the model registry plus catalog/auth operations. */
+export interface PiRuntimeHandle {
+    registry: PiRegistryLike;
+    runtime: PiRuntimeLike;
+    listProviders(): PiProviderInfo[];
+    listModels(providerId?: string): PiModelInfo[];
+    hasAuth(providerId: string): boolean;
+    isUsingOAuth(providerId: string): boolean;
+    listCredentials(): Promise<Array<{
+        providerId: string;
+        type: string;
+    }>>;
+    login(providerId: string, interaction: PiAuthInteractionLike, type?: 'api_key' | 'oauth'): Promise<void>;
+    logout(providerId: string): Promise<void>;
+}
+/** Whether the pi dependency resolves (it is a required dependency of the SDK). */
+export declare function isPiPackageAvailable(): boolean;
+/**
+ * Open a pi runtime using an existing install's credential store and model
+ * catalog. This is the setup entry point used by `set-backend pi`; it does not
+ * require the pi CLI or a pre-existing pi session.
+ */
+export declare function openPiRuntime(options?: CreatePiBackendOptions): Promise<PiRuntimeHandle>;
+/** Resolved pi backend plus the model capabilities the UI/config needs. */
+export interface PiBackendInfo {
+    backend: LLMBackend;
+    modelId: string;
+    provider: string;
+    contextWindow?: number;
+    maxTokens: number;
+    reasoning: boolean;
+    thinkingLevel?: ThinkingLevel;
+    supportedThinkingLevels: ThinkingLevel[];
+    /** Set when a requested thinking level was unsupported and dropped. */
+    warning?: string;
+}
+/**
+ * Build an `LLMBackend` from pi's credential store. Throws a clear error when
+ * the pi packages are not installed.
+ */
+export declare function createPiBackend(options?: CreatePiBackendOptions): Promise<PiBackendInfo>;
+export interface ResolveBackendOptions {
+    kind?: BackendKind;
+    model?: string;
+    provider?: string;
+    maxTokens?: number;
+    agentDir?: string;
+    modelsPath?: string | null;
+    authPath?: string | null;
+    thinkingLevel?: string;
+}
+export interface ResolvedBackend {
+    kind: BackendKind;
+    /** Injected backend for pi; undefined for env (the runner builds it). */
+    llmBackend?: LLMBackend;
+    provider: string;
+    /** Bare model id. */
+    model: string;
+    /** `provider/model` (pi) or bare id (env), for display/persistence. */
+    modelId: string;
+    /** pi model capabilities (undefined for env). */
+    contextWindow?: number;
+    reasoning?: boolean;
+    thinkingLevel?: ThinkingLevel;
+}
+/**
+ * Resolve the shared pi/env model backend used by both `deepclause run` and the
+ * REPL. `pi` (the default) returns an injected `LLMBackend`; `env` returns the
+ * provider/model so the runner builds the SDK provider backend.
+ */
+export declare function resolveLlmBackend(options?: ResolveBackendOptions): Promise<ResolvedBackend>;
+//# sourceMappingURL=backend.d.ts.map

package/dist/repl/backend.d.ts.map

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

package/dist/repl/backend.js

@@ -0,0 +1,370 @@
+/**
+ * Backend resolution for the REPL (M5).
+ *
+ * `env` uses the SDK's provider/API-key backend (unchanged). `pi` reuses pi's
+ * own model registry and credential store so the REPL runs against the model
+ * configured in pi, without asking for API keys or writing provider env vars.
+ *
+ * The pi packages are optional peers and loaded with a dynamic import only when
+ * the pi backend is selected.
+ */
+import * as path from 'path';
+export const THINKING_LEVELS = ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'];
+/** Levels a model accepts: reasoning models expose all but explicitly-unsupported ones. */
+export function supportedThinkingLevels(model) {
+    if (!model.reasoning) {
+        return ['off'];
+    }
+    return THINKING_LEVELS.filter((level) => model.thinkingLevelMap?.[level] !== null);
+}
+/**
+ * Validate a requested thinking level against the model. Returns the level to
+ * pass through (or `undefined` for the provider default) plus a warning when a
+ * request had to be dropped.
+ */
+export function resolveThinkingLevel(model, requested) {
+    const supported = supportedThinkingLevels(model);
+    if (!requested) {
+        return { level: undefined, supported };
+    }
+    if (THINKING_LEVELS.includes(requested) && supported.includes(requested)) {
+        return { level: requested, supported };
+    }
+    return {
+        level: undefined,
+        supported,
+        warning: `thinking level '${requested}' is not supported by ${model.provider}/${model.id}; using the provider default`,
+    };
+}
+/** Resolve pi's agent dir, models.json, and auth.json paths. */
+export function resolvePiPaths(config, defaults) {
+    const agentDir = config.agentDir ?? defaults.agentDir;
+    return {
+        agentDir,
+        modelsPath: config.modelsPath ?? path.join(agentDir, 'models.json'),
+        authPath: config.authPath ?? path.join(agentDir, 'auth.json'),
+        model: config.model,
+    };
+}
+function modelLabel(model) {
+    return `${model.provider}/${model.id}`;
+}
+/** Select the pi model to use, honoring an explicit provider/model request. */
+export function selectPiModel(registry, requested) {
+    const available = registry.getAvailable();
+    if (available.length === 0) {
+        throw new Error('pi has no configured models; run pi or `deepclause set-backend env`');
+    }
+    if (requested) {
+        const normalized = requested.replace(':', '/');
+        const [provider, ...rest] = normalized.split('/');
+        const modelId = rest.join('/');
+        if (modelId && registry.find) {
+            const found = registry.find(provider, modelId);
+            if (found)
+                return found;
+        }
+        const byId = available.find((model) => model.id === requested || modelLabel(model) === requested);
+        if (byId)
+            return byId;
+        throw new Error(`pi model not found: ${requested}`);
+    }
+    return available[0];
+}
+function emptyUsage() {
+    return { input: 0, output: 0, totalTokens: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0 };
+}
+function toPiMessages(messages, model) {
+    return messages
+        .filter((message) => message.role !== 'system')
+        .map((message) => {
+        if (message.role === 'assistant' && message.providerData) {
+            return message.providerData;
+        }
+        if (message.role === 'user') {
+            // Attach resolved media as pi image content blocks alongside the text.
+            const content = message.media && message.media.length > 0
+                ? [
+                    ...(message.content ? [{ type: 'text', text: message.content }] : []),
+                    ...message.media.map((media) => ({
+                        type: 'image',
+                        data: media.data,
+                        mimeType: media.mimeType,
+                    })),
+                ]
+                : message.content;
+            return { role: 'user', content, timestamp: Date.now() };
+        }
+        if (message.role === 'tool') {
+            return {
+                role: 'toolResult',
+                toolCallId: message.toolCallId ?? 'unknown',
+                toolName: message.toolName ?? 'unknown',
+                content: [{ type: 'text', text: message.content }],
+                isError: false,
+                timestamp: Date.now(),
+            };
+        }
+        return {
+            role: 'assistant',
+            content: [
+                ...(message.content ? [{ type: 'text', text: message.content }] : []),
+                ...(message.toolCalls ?? []).map((call) => ({
+                    type: 'toolCall',
+                    id: call.id,
+                    name: call.name,
+                    arguments: call.arguments,
+                })),
+            ],
+            api: model.api,
+            provider: model.provider,
+            model: model.id,
+            usage: emptyUsage(),
+            stopReason: message.toolCalls?.length ? 'toolUse' : 'stop',
+            timestamp: Date.now(),
+        };
+    });
+}
+/**
+ * Wrap a pi registry + model as an SDK `LLMBackend`. Reused by the extension
+ * embedding, which passes its live registry.
+ *
+ * `thinkingLevel` is forwarded to the provider only for reasoning models and
+ * non-`off` levels, so provider defaults are preserved for every other model.
+ */
+export function createPiAdapter(registry, model, maxTokens = 65536, thinkingLevel) {
+    if (!registry.hasConfiguredAuth(model)) {
+        throw new Error(`pi has no configured authentication for ${modelLabel(model)}`);
+    }
+    const resolved = resolveThinkingLevel(model, thinkingLevel);
+    const backend = {
+        async complete(request) {
+            const systemPrompt = request.messages
+                .filter((message) => message.role === 'system')
+                .map((message) => message.content)
+                .join('\n\n');
+            const context = {
+                systemPrompt: systemPrompt || undefined,
+                messages: toPiMessages(request.messages, model),
+                tools: request.tools?.map((tool) => ({
+                    name: tool.name,
+                    description: tool.description,
+                    parameters: tool.parameters,
+                })),
+            };
+            const options = {
+                signal: request.signal,
+                maxTokens: request.maxTokens ?? maxTokens,
+                cacheRetention: 'none',
+            };
+            if (model.reasoning && resolved.level && resolved.level !== 'off') {
+                // pi's `SimpleStreamOptions` enables thinking with `reasoning` (a
+                // ThinkingLevel), not `thinkingLevel`.
+                options.reasoning = resolved.level;
+            }
+            let response;
+            if (registry.streamSimple) {
+                // Stream text/thinking deltas as they arrive; the final message carries
+                // the full text, tool calls, and usage.
+                const stream = registry.streamSimple(model, context, options);
+                for await (const event of stream) {
+                    if (event.type === 'text_delta') {
+                        if (event.delta)
+                            request.onText?.(event.delta);
+                    }
+                    else if (event.type === 'thinking_delta') {
+                        if (event.delta)
+                            request.onReasoning?.(event.delta);
+                    }
+                }
+                response = await stream.result();
+            }
+            else {
+                response = await registry.complete(model, context, options);
+                const streamedText = response.content
+                    .filter((content) => content.type === 'text')
+                    .map((content) => content.text)
+                    .join('');
+                if (streamedText)
+                    request.onText?.(streamedText);
+            }
+            if (response.stopReason === 'error' || response.stopReason === 'aborted') {
+                throw new Error(response.errorMessage || `pi model request ${response.stopReason}`);
+            }
+            const text = response.content
+                .filter((content) => content.type === 'text')
+                .map((content) => content.text)
+                .join('');
+            return {
+                text,
+                toolCalls: response.content
+                    .filter((content) => content.type === 'toolCall')
+                    .map((call) => ({ id: call.id, name: call.name, arguments: call.arguments })),
+                usage: {
+                    inputTokens: response.usage.input,
+                    outputTokens: response.usage.output,
+                    totalTokens: response.usage.totalTokens,
+                    cacheReadTokens: response.usage.cacheRead || undefined,
+                    cacheWriteTokens: response.usage.cacheWrite || undefined,
+                    reasoningTokens: response.usage.reasoning || undefined,
+                },
+                finishReason: response.stopReason === 'toolUse'
+                    ? 'tool_use'
+                    : response.stopReason === 'length'
+                        ? 'length'
+                        : 'stop',
+                providerData: response,
+            };
+        },
+    };
+    return {
+        backend,
+        modelId: modelLabel(model),
+        provider: model.provider,
+        contextWindow: model.contextWindow,
+        maxTokens,
+        reasoning: Boolean(model.reasoning),
+        thinkingLevel: resolved.level,
+        supportedThinkingLevels: resolved.supported,
+        warning: resolved.warning,
+    };
+}
+const PI_PACKAGE_NAME = '@earendil-works/pi-coding-agent';
+/**
+ * Import the pi coding agent. It is a regular dependency of this SDK, so the
+ * bare specifier always resolves; a globally installed `pi` is deliberately
+ * not consulted, which keeps the version deterministic.
+ */
+async function importPiModule() {
+    try {
+        return (await import(PI_PACKAGE_NAME));
+    }
+    catch {
+        throw new Error(`Backend 'pi' requires ${PI_PACKAGE_NAME} (a dependency of this SDK). `
+            + 'Reinstall dependencies, or run `deepclause set-backend env` to use the SDK provider/API-key backend.');
+    }
+}
+/** Build the catalog `PiModelInfo` (with reasoning levels) from a raw model. */
+export function toPiModelInfo(model) {
+    return {
+        provider: model.provider,
+        id: model.id,
+        name: model.name ?? model.id,
+        reasoning: Boolean(model.reasoning),
+        contextWindow: model.contextWindow,
+        maxTokens: model.maxTokens,
+        supportedThinkingLevels: supportedThinkingLevels(model),
+    };
+}
+/** List providers from a pi runtime with auth capability/status. */
+export function listPiProviders(runtime) {
+    return runtime.getProviders().map((provider) => {
+        const status = runtime.getProviderAuthStatus(provider.id);
+        return {
+            id: provider.id,
+            name: provider.name ?? provider.id,
+            apiKey: Boolean(provider.auth?.apiKey),
+            oauth: Boolean(provider.auth?.oauth),
+            configured: status?.configured ?? runtime.hasConfiguredAuth(provider.id),
+            source: status?.source,
+            label: status?.label,
+        };
+    });
+}
+/** List chat models from a pi runtime, optionally filtered by provider. */
+export function listPiModels(runtime, providerId) {
+    return runtime.getModels(providerId).map((model) => toPiModelInfo(model));
+}
+/** Whether the pi dependency resolves (it is a required dependency of the SDK). */
+export function isPiPackageAvailable() {
+    try {
+        const resolve = import.meta.resolve;
+        return typeof resolve === 'function' && Boolean(resolve(PI_PACKAGE_NAME));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Open a pi runtime using an existing install's credential store and model
+ * catalog. This is the setup entry point used by `set-backend pi`; it does not
+ * require the pi CLI or a pre-existing pi session.
+ */
+export async function openPiRuntime(options = {}) {
+    const pi = await importPiModule();
+    const paths = resolvePiPaths(options, { agentDir: pi.getAgentDir() });
+    const runtime = (await pi.ModelRuntime.create({
+        authPath: paths.authPath,
+        modelsPath: paths.modelsPath,
+        allowModelNetwork: false,
+    }));
+    const registry = options.modelRegistry ?? new pi.ModelRegistry(runtime);
+    return {
+        registry,
+        runtime,
+        listProviders: () => listPiProviders(runtime),
+        listModels: (providerId) => listPiModels(runtime, providerId),
+        hasAuth: (providerId) => runtime.hasConfiguredAuth(providerId),
+        isUsingOAuth: (providerId) => runtime.isUsingOAuth(providerId),
+        listCredentials: async () => (await runtime.listCredentials()) ?? [],
+        login: async (providerId, interaction, type) => {
+            const authType = type ?? 'api_key';
+            await runtime.login(providerId, authType, interaction, {});
+        },
+        logout: async (providerId) => {
+            await runtime.logout(providerId);
+        },
+    };
+}
+/**
+ * Build an `LLMBackend` from pi's credential store. Throws a clear error when
+ * the pi packages are not installed.
+ */
+export async function createPiBackend(options = {}) {
+    let registry = options.modelRegistry;
+    let requested = options.model;
+    if (!registry) {
+        const pi = await importPiModule();
+        const paths = resolvePiPaths(options, { agentDir: pi.getAgentDir() });
+        requested = requested ?? paths.model;
+        const runtime = await pi.ModelRuntime.create({
+            authPath: paths.authPath,
+            modelsPath: paths.modelsPath,
+            allowModelNetwork: false,
+        });
+        registry = new pi.ModelRegistry(runtime);
+    }
+    const model = selectPiModel(registry, requested);
+    return createPiAdapter(registry, model, options.maxTokens, options.thinkingLevel);
+}
+/**
+ * Resolve the shared pi/env model backend used by both `deepclause run` and the
+ * REPL. `pi` (the default) returns an injected `LLMBackend`; `env` returns the
+ * provider/model so the runner builds the SDK provider backend.
+ */
+export async function resolveLlmBackend(options = {}) {
+    const kind = options.kind ?? 'pi';
+    if (kind === 'pi') {
+        const pi = await createPiBackend({
+            agentDir: options.agentDir,
+            modelsPath: options.modelsPath ?? undefined,
+            authPath: options.authPath ?? undefined,
+            model: options.model,
+            maxTokens: options.maxTokens,
+            thinkingLevel: options.thinkingLevel,
+        });
+        return {
+            kind: 'pi',
+            llmBackend: pi.backend,
+            provider: pi.provider,
+            model: pi.modelId.split('/').slice(1).join('/') || pi.modelId,
+            modelId: pi.modelId,
+            contextWindow: pi.contextWindow,
+            reasoning: pi.reasoning,
+            thinkingLevel: pi.thinkingLevel,
+        };
+    }
+    const model = options.model ?? 'gpt-4o';
+    return { kind: 'env', provider: options.provider ?? 'openai', model, modelId: model };
+}
+//# sourceMappingURL=backend.js.map