@opengoat/core 2026.2.9

package/dist/core/providers/cli-provider.js.map

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

package/dist/core/providers/command-executor.d.ts

@@ -0,0 +1,12 @@
+import type { ProviderExecutionResult } from "./types.js";
+interface ExecuteCommandOptions {
+    command: string;
+    args: string[];
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    abortSignal?: AbortSignal;
+    onStdout?: (chunk: string) => void;
+    onStderr?: (chunk: string) => void;
+}
+export declare function executeCommand(options: ExecuteCommandOptions): Promise<ProviderExecutionResult>;
+export {};

package/dist/core/providers/command-executor.js

@@ -0,0 +1,76 @@
+import { spawn } from "node:child_process";
+export function executeCommand(options) {
+    return new Promise((resolve, reject) => {
+        if (options.abortSignal?.aborted) {
+            reject(createAbortError());
+            return;
+        }
+        const child = spawn(options.command, options.args, {
+            cwd: options.cwd,
+            env: options.env,
+            stdio: ["ignore", "pipe", "pipe"]
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (chunk) => {
+            const text = chunk.toString();
+            stdout += text;
+            options.onStdout?.(text);
+        });
+        child.stderr.on("data", (chunk) => {
+            const text = chunk.toString();
+            stderr += text;
+            options.onStderr?.(text);
+        });
+        let settled = false;
+        const finishWithError = (error) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            cleanup();
+            reject(error);
+        };
+        const finishWithResult = (code) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            cleanup();
+            resolve({
+                code: code ?? 1,
+                stdout,
+                stderr
+            });
+        };
+        const cleanup = () => {
+            options.abortSignal?.removeEventListener("abort", handleAbort);
+        };
+        const handleAbort = () => {
+            terminateProcess(child);
+            finishWithError(createAbortError());
+        };
+        options.abortSignal?.addEventListener("abort", handleAbort, { once: true });
+        child.on("error", (error) => finishWithError(error instanceof Error ? error : new Error(String(error))));
+        child.on("close", (code) => {
+            finishWithResult(code);
+        });
+    });
+}
+function terminateProcess(child) {
+    if (child.killed) {
+        return;
+    }
+    try {
+        child.kill("SIGTERM");
+    }
+    catch {
+        // ignore termination errors
+    }
+}
+function createAbortError() {
+    const error = new Error("Command execution aborted.");
+    error.name = "AbortError";
+    return error;
+}
+//# sourceMappingURL=command-executor.js.map

package/dist/core/providers/command-executor.js.map

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

package/dist/core/providers/errors.d.ts

@@ -0,0 +1,30 @@
+export declare class OpenGoatProviderError extends Error {
+    constructor(message: string);
+}
+export declare class ProviderNotFoundError extends OpenGoatProviderError {
+    constructor(providerId: string, availableProviderIds: string[]);
+}
+export declare class UnsupportedProviderOptionError extends OpenGoatProviderError {
+    constructor(providerId: string, optionName: string);
+}
+export declare class UnsupportedProviderActionError extends OpenGoatProviderError {
+    constructor(providerId: string, action: string);
+}
+export declare class ProviderCommandNotFoundError extends OpenGoatProviderError {
+    constructor(providerId: string, command: string);
+}
+export declare class ProviderAuthenticationError extends OpenGoatProviderError {
+    constructor(providerId: string, message: string);
+}
+export declare class ProviderRuntimeError extends OpenGoatProviderError {
+    constructor(providerId: string, message: string);
+}
+export declare class AgentConfigNotFoundError extends OpenGoatProviderError {
+    constructor(agentId: string);
+}
+export declare class InvalidAgentConfigError extends OpenGoatProviderError {
+    constructor(agentId: string, configPath: string, message?: string);
+}
+export declare class InvalidProviderConfigError extends OpenGoatProviderError {
+    constructor(providerId: string, configPath: string, message?: string);
+}

package/dist/core/providers/errors.js

@@ -0,0 +1,52 @@
+export class OpenGoatProviderError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = this.constructor.name;
+    }
+}
+export class ProviderNotFoundError extends OpenGoatProviderError {
+    constructor(providerId, availableProviderIds) {
+        super(`Unknown provider "${providerId}". Available providers: ${availableProviderIds.join(", ")}.`);
+    }
+}
+export class UnsupportedProviderOptionError extends OpenGoatProviderError {
+    constructor(providerId, optionName) {
+        super(`Provider "${providerId}" does not support ${optionName}.`);
+    }
+}
+export class UnsupportedProviderActionError extends OpenGoatProviderError {
+    constructor(providerId, action) {
+        super(`Provider "${providerId}" does not support action "${action}".`);
+    }
+}
+export class ProviderCommandNotFoundError extends OpenGoatProviderError {
+    constructor(providerId, command) {
+        super(`Provider "${providerId}" command "${command}" was not found or not executable.`);
+    }
+}
+export class ProviderAuthenticationError extends OpenGoatProviderError {
+    constructor(providerId, message) {
+        super(`Provider "${providerId}" authentication error: ${message}`);
+    }
+}
+export class ProviderRuntimeError extends OpenGoatProviderError {
+    constructor(providerId, message) {
+        super(`Provider "${providerId}" runtime error: ${message}`);
+    }
+}
+export class AgentConfigNotFoundError extends OpenGoatProviderError {
+    constructor(agentId) {
+        super(`Agent "${agentId}" was not found. Create it first with: opengoat agent create \"${agentId}\"`);
+    }
+}
+export class InvalidAgentConfigError extends OpenGoatProviderError {
+    constructor(agentId, configPath, message = "invalid JSON") {
+        super(`Agent "${agentId}" has an invalid config at ${configPath}: ${message}.`);
+    }
+}
+export class InvalidProviderConfigError extends OpenGoatProviderError {
+    constructor(providerId, configPath, message = "invalid JSON") {
+        super(`Provider "${providerId}" has an invalid config at ${configPath}: ${message}.`);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/providers/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/providers/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAmB,OAAe;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,qBAAqB;IAC9D,YAAmB,UAAkB,EAAE,oBAA8B;QACnE,KAAK,CACH,qBAAqB,UAAU,2BAA2B,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7F,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,8BAA+B,SAAQ,qBAAqB;IACvE,YAAmB,UAAkB,EAAE,UAAkB;QACvD,KAAK,CAAC,aAAa,UAAU,sBAAsB,UAAU,GAAG,CAAC,CAAC;IACpE,CAAC;CACF;AAED,MAAM,OAAO,8BAA+B,SAAQ,qBAAqB;IACvE,YAAmB,UAAkB,EAAE,MAAc;QACnD,KAAK,CAAC,aAAa,UAAU,8BAA8B,MAAM,IAAI,CAAC,CAAC;IACzE,CAAC;CACF;AAED,MAAM,OAAO,4BAA6B,SAAQ,qBAAqB;IACrE,YAAmB,UAAkB,EAAE,OAAe;QACpD,KAAK,CACH,aAAa,UAAU,cAAc,OAAO,oCAAoC,CACjF,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,2BAA4B,SAAQ,qBAAqB;IACpE,YAAmB,UAAkB,EAAE,OAAe;QACpD,KAAK,CAAC,aAAa,UAAU,2BAA2B,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,qBAAqB;IAC7D,YAAmB,UAAkB,EAAE,OAAe;QACpD,KAAK,CAAC,aAAa,UAAU,oBAAoB,OAAO,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,qBAAqB;IACjE,YAAmB,OAAe;QAChC,KAAK,CACH,UAAU,OAAO,kEAAkE,OAAO,IAAI,CAC/F,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,qBAAqB;IAChE,YAAmB,OAAe,EAAE,UAAkB,EAAE,OAAO,GAAG,cAAc;QAC9E,KAAK,CAAC,UAAU,OAAO,8BAA8B,UAAU,KAAK,OAAO,GAAG,CAAC,CAAC;IAClF,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,qBAAqB;IACnE,YAAmB,UAAkB,EAAE,UAAkB,EAAE,OAAO,GAAG,cAAc;QACjF,KAAK,CAAC,aAAa,UAAU,8BAA8B,UAAU,KAAK,OAAO,GAAG,CAAC,CAAC;IACxF,CAAC;CACF"}

package/dist/core/providers/index.d.ts

@@ -0,0 +1,18 @@
+import type { ProviderSummary } from "./types.js";
+import { ProviderRegistry } from "./registry.js";
+export declare const DEFAULT_PROVIDER_ID = "codex";
+export declare function createDefaultProviderRegistry(): Promise<ProviderRegistry>;
+export declare function registerBuiltinProviders(registry: ProviderRegistry): Promise<void>;
+export declare function listProviderSummaries(registry: ProviderRegistry): ProviderSummary[];
+export { ProviderRegistry, type ProviderFactory } from "./registry.js";
+export { BaseProvider } from "./base-provider.js";
+export { BaseCliProvider, type BaseCliProviderConfig } from "./cli-provider.js";
+export { ProviderService } from "./application/provider.service.js";
+export type { AgentRuntimeProfile, ProviderStoredConfig } from "./application/provider.service.js";
+export { buildProviderFamilies, filterProvidersForOnboarding, isDefaultOnboardingAgent, resolveOnboardingProviderSetupUrl, selectProvidersForOnboarding, sortProvidersForOnboarding } from "./onboarding.js";
+export type { ProviderOnboardingFamily } from "./onboarding.js";
+export { loadProviderModules } from "./loader.js";
+export type { ProviderModule } from "./provider-module.js";
+export type { ProviderOnboardingEnvField, ProviderOnboardingSpec } from "./provider-module.js";
+export type { Provider, ProviderAuthOptions, ProviderCreateAgentOptions, ProviderDeleteAgentOptions, ProviderCapabilities, ProviderExecutionResult, ProviderInvocationLifecycleEvent, ProviderInvocationLifecycleHooks, ProviderInvokeOptions, ProviderInvokeRuntimeContext, ProviderKind, ProviderSummary, AgentProviderBinding } from "./types.js";
+export { AgentConfigNotFoundError, InvalidAgentConfigError, InvalidProviderConfigError, OpenGoatProviderError, ProviderAuthenticationError, ProviderCommandNotFoundError, ProviderNotFoundError, ProviderRuntimeError, UnsupportedProviderActionError, UnsupportedProviderOptionError } from "./errors.js";

package/dist/core/providers/index.js

@@ -0,0 +1,27 @@
+import { loadProviderModules } from "./loader.js";
+import { ProviderRegistry } from "./registry.js";
+export const DEFAULT_PROVIDER_ID = "codex";
+export async function createDefaultProviderRegistry() {
+    const registry = new ProviderRegistry();
+    await loadProviderModules(registry);
+    return registry;
+}
+export async function registerBuiltinProviders(registry) {
+    await loadProviderModules(registry);
+}
+export function listProviderSummaries(registry) {
+    return registry.listProviders().map((provider) => ({
+        id: provider.id,
+        displayName: provider.displayName,
+        kind: provider.kind,
+        capabilities: provider.capabilities
+    }));
+}
+export { ProviderRegistry } from "./registry.js";
+export { BaseProvider } from "./base-provider.js";
+export { BaseCliProvider } from "./cli-provider.js";
+export { ProviderService } from "./application/provider.service.js";
+export { buildProviderFamilies, filterProvidersForOnboarding, isDefaultOnboardingAgent, resolveOnboardingProviderSetupUrl, selectProvidersForOnboarding, sortProvidersForOnboarding } from "./onboarding.js";
+export { loadProviderModules } from "./loader.js";
+export { AgentConfigNotFoundError, InvalidAgentConfigError, InvalidProviderConfigError, OpenGoatProviderError, ProviderAuthenticationError, ProviderCommandNotFoundError, ProviderNotFoundError, ProviderRuntimeError, UnsupportedProviderActionError, UnsupportedProviderOptionError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/core/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/providers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAwB,MAAM,eAAe,CAAC;AAEvE,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,6BAA6B;IACjD,MAAM,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACxC,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,QAA0B;IACvE,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAA0B;IAC9D,OAAO,QAAQ,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACjD,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,YAAY,EAAE,QAAQ,CAAC,YAAY;KACpC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAwB,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAA8B,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,wBAAwB,EACxB,iCAAiC,EACjC,4BAA4B,EAC5B,0BAA0B,EAC3B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAkBlD,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,2BAA2B,EAC3B,4BAA4B,EAC5B,qBAAqB,EACrB,oBAAoB,EACpB,8BAA8B,EAC9B,8BAA8B,EAC/B,MAAM,aAAa,CAAC"}

package/dist/core/providers/loader.d.ts

@@ -0,0 +1,2 @@
+import type { ProviderRegistry } from "./registry.js";
+export declare function loadProviderModules(registry: ProviderRegistry): Promise<void>;

package/dist/core/providers/loader.js

@@ -0,0 +1,99 @@
+import { access, readdir } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { providerModule as claudeProviderModule } from "./providers/claude/index.js";
+import { providerModule as codexProviderModule } from "./providers/codex/index.js";
+import { providerModule as cursorProviderModule } from "./providers/cursor/index.js";
+import { providerModule as geminiProviderModule } from "./providers/gemini/index.js";
+import { providerModule as grokProviderModule } from "./providers/grok/index.js";
+import { providerModule as openaiProviderModule } from "./providers/openai/index.js";
+import { providerModule as openclawProviderModule } from "./providers/openclaw/index.js";
+import { providerModules as extendedHttpProviderModules } from "./providers/extended-http/index.js";
+import { providerModule as opencodeProviderModule } from "./providers/opencode/index.js";
+import { providerModule as openrouterProviderModule } from "./providers/openrouter/index.js";
+const providersRootDir = path.join(path.dirname(fileURLToPath(import.meta.url)), "providers");
+const staticProviderModules = [
+    claudeProviderModule,
+    codexProviderModule,
+    cursorProviderModule,
+    geminiProviderModule,
+    grokProviderModule,
+    openaiProviderModule,
+    openclawProviderModule,
+    opencodeProviderModule,
+    openrouterProviderModule,
+    ...extendedHttpProviderModules
+];
+export async function loadProviderModules(registry) {
+    let loadedCount = 0;
+    let providersDirMissing = false;
+    try {
+        const entries = await readdir(providersRootDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory()) {
+                continue;
+            }
+            const providerDir = path.join(providersRootDir, entry.name);
+            const modulePath = await resolveModulePath(providerDir);
+            if (!modulePath) {
+                continue;
+            }
+            const imported = (await import(pathToFileURL(modulePath).href));
+            loadedCount += registerProviderModules(registry, resolveProviderModules(imported));
+        }
+    }
+    catch (error) {
+        if (!isMissingProvidersDirError(error)) {
+            throw error;
+        }
+        providersDirMissing = true;
+    }
+    if (providersDirMissing || loadedCount === 0) {
+        registerProviderModules(registry, staticProviderModules);
+    }
+}
+function resolveProviderModules(imported) {
+    if (Array.isArray(imported.providerModules) && imported.providerModules.length > 0) {
+        return imported.providerModules;
+    }
+    if (imported.providerModule) {
+        return [imported.providerModule];
+    }
+    return [];
+}
+function registerProviderModules(registry, providerModules) {
+    if (providerModules.length === 0) {
+        return 0;
+    }
+    for (const providerModule of providerModules) {
+        registry.register(providerModule.id, providerModule.create, providerModule);
+    }
+    return providerModules.length;
+}
+async function resolveModulePath(providerDir) {
+    const candidates = ["index.js", "index.ts"];
+    for (const candidate of candidates) {
+        const fullPath = path.join(providerDir, candidate);
+        if (await exists(fullPath)) {
+            return fullPath;
+        }
+    }
+    return null;
+}
+async function exists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isMissingProvidersDirError(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    const withCode = error;
+    return withCode.code === "ENOENT";
+}
+//# sourceMappingURL=loader.js.map

package/dist/core/providers/loader.js.map

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

package/dist/core/providers/onboarding.d.ts

@@ -0,0 +1,13 @@
+import type { ProviderSummary } from "./types.js";
+export interface ProviderOnboardingFamily {
+    id: string;
+    label: string;
+    hint?: string;
+    providerIds: string[];
+}
+export declare function isDefaultOnboardingAgent(agentId: string): boolean;
+export declare function filterProvidersForOnboarding(agentId: string, providers: ProviderSummary[]): ProviderSummary[];
+export declare function sortProvidersForOnboarding(providers: ProviderSummary[]): ProviderSummary[];
+export declare function selectProvidersForOnboarding(agentId: string, providers: ProviderSummary[]): ProviderSummary[];
+export declare function buildProviderFamilies(providers: ProviderSummary[]): ProviderOnboardingFamily[];
+export declare function resolveOnboardingProviderSetupUrl(providerId: string): string | undefined;

package/dist/core/providers/onboarding.js

@@ -0,0 +1,149 @@
+import { DEFAULT_AGENT_ID } from "../domain/agent-id.js";
+const ONBOARDING_PROVIDER_ORDER = [
+    "openai",
+    "anthropic",
+    "grok",
+    "openrouter",
+    "google",
+    "gemini",
+    "amazon-bedrock",
+    "azure-openai-responses",
+    "groq",
+    "mistral",
+    "moonshot",
+    "ollama",
+    "claude",
+    "codex",
+    "cursor",
+    "opencode",
+    "openclaw"
+];
+const providerPriorityById = new Map(ONBOARDING_PROVIDER_ORDER.map((id, index) => [id, index]));
+const ORGANIZED_PROVIDER_FAMILIES = [
+    { id: "openai", label: "OpenAI", providerIds: ["openai", "openai-codex", "azure-openai-responses"] },
+    { id: "anthropic", label: "Anthropic", providerIds: ["anthropic"] },
+    { id: "minimax", label: "MiniMax", providerIds: ["minimax", "minimax-cn", "minimax-portal"] },
+    { id: "moonshot", label: "Moonshot AI (Kimi)", providerIds: ["moonshot", "kimi-coding"] },
+    {
+        id: "google",
+        label: "Google",
+        providerIds: ["google", "google-antigravity", "google-gemini-cli", "google-vertex"]
+    },
+    { id: "openrouter", label: "OpenRouter", providerIds: ["openrouter"] },
+    { id: "qwen", label: "Qwen", hint: "OAuth", providerIds: ["qwen-portal"] },
+    { id: "zai", label: "Z.AI (GLM)", providerIds: ["zai"] },
+    { id: "copilot", label: "Copilot", providerIds: ["github-copilot", "copilot-proxy"] },
+    { id: "vercel", label: "Vercel AI Gateway", providerIds: ["vercel-ai-gateway"] },
+    { id: "opencode", label: "OpenCode Zen", providerIds: ["opencode-zen"] },
+    { id: "xiaomi", label: "Xiaomi", providerIds: ["xiaomi"] },
+    { id: "synthetic", label: "Synthetic", providerIds: ["synthetic"] },
+    { id: "venice", label: "Venice AI", providerIds: ["venice"] },
+    { id: "cloudflare", label: "Cloudflare AI Gateway", providerIds: ["cloudflare-ai-gateway"] },
+    { id: "groq", label: "Groq", providerIds: ["groq"] },
+    { id: "mistral", label: "Mistral", providerIds: ["mistral"] },
+    { id: "qianfan", label: "Qianfan", providerIds: ["qianfan"] },
+    { id: "bedrock", label: "Amazon Bedrock", providerIds: ["amazon-bedrock"] },
+    { id: "cerebras", label: "Cerebras", providerIds: ["cerebras"] },
+    { id: "chutes", label: "Chutes", providerIds: ["chutes"] },
+    { id: "huggingface", label: "Hugging Face", providerIds: ["huggingface"] },
+    { id: "ollama", label: "Ollama", providerIds: ["ollama"] },
+    { id: "cli-tools", label: "Local CLI tools", providerIds: ["claude", "codex", "cursor", "gemini", "opencode", "openclaw"] }
+];
+const PROVIDER_SETUP_URLS = {
+    openai: "https://platform.openai.com/api-keys",
+    "openai-codex": "https://platform.openai.com",
+    anthropic: "https://console.anthropic.com/settings/keys",
+    google: "https://aistudio.google.com/app/apikey",
+    "google-antigravity": "https://github.com/openclaw/google-antigravity-auth",
+    "google-gemini-cli": "https://github.com/openclaw/google-gemini-cli-auth",
+    grok: "https://console.x.ai",
+    groq: "https://console.groq.com/keys",
+    openrouter: "https://openrouter.ai/keys",
+    moonshot: "https://platform.moonshot.ai",
+    "kimi-coding": "https://platform.moonshot.ai",
+    mistral: "https://console.mistral.ai/api-keys",
+    cerebras: "https://cloud.cerebras.ai/platform",
+    chutes: "https://chutes.ai/docs/sign-in-with-chutes/overview",
+    huggingface: "https://huggingface.co/settings/tokens",
+    minimax: "https://platform.minimax.io",
+    "minimax-cn": "https://platform.minimax.io",
+    "minimax-portal": "https://platform.minimax.io",
+    "qwen-portal": "https://chat.qwen.ai",
+    zai: "https://bigmodel.cn",
+    qianfan: "https://cloud.baidu.com/product/wenxinworkshop",
+    "vercel-ai-gateway": "https://vercel.com/dashboard/ai-gateway",
+    "cloudflare-ai-gateway": "https://dash.cloudflare.com",
+    "github-copilot": "https://github.com/features/copilot",
+    "copilot-proxy": "https://github.com/openclaw/copilot-proxy",
+    venice: "https://venice.ai",
+    synthetic: "https://synthetic.new",
+    xiaomi: "https://platform.xiaomi.com"
+};
+export function isDefaultOnboardingAgent(agentId) {
+    return agentId.trim().toLowerCase() === DEFAULT_AGENT_ID;
+}
+export function filterProvidersForOnboarding(agentId, providers) {
+    if (!isDefaultOnboardingAgent(agentId)) {
+        return providers;
+    }
+    return providers.filter((provider) => provider.kind === "http");
+}
+export function sortProvidersForOnboarding(providers) {
+    return providers.slice().sort((left, right) => {
+        if (left.kind !== right.kind) {
+            return left.kind === "http" ? -1 : 1;
+        }
+        const leftPriority = providerPriorityById.get(left.id) ?? Number.MAX_SAFE_INTEGER;
+        const rightPriority = providerPriorityById.get(right.id) ?? Number.MAX_SAFE_INTEGER;
+        if (leftPriority !== rightPriority) {
+            return leftPriority - rightPriority;
+        }
+        const byName = left.displayName.localeCompare(right.displayName);
+        if (byName !== 0) {
+            return byName;
+        }
+        return left.id.localeCompare(right.id);
+    });
+}
+export function selectProvidersForOnboarding(agentId, providers) {
+    return sortProvidersForOnboarding(filterProvidersForOnboarding(agentId, providers));
+}
+export function buildProviderFamilies(providers) {
+    const providerById = new Map(providers.map((provider) => [provider.id, provider]));
+    const families = [];
+    const usedProviderIds = new Set();
+    for (const family of ORGANIZED_PROVIDER_FAMILIES) {
+        const presentIds = family.providerIds.filter((id) => providerById.has(id));
+        if (presentIds.length === 0) {
+            continue;
+        }
+        presentIds.forEach((id) => usedProviderIds.add(id));
+        families.push({
+            id: family.id,
+            label: family.label,
+            ...(family.hint ? { hint: family.hint } : {}),
+            providerIds: presentIds
+        });
+    }
+    const leftovers = providers
+        .filter((provider) => !usedProviderIds.has(provider.id))
+        .sort((left, right) => {
+        const byName = left.displayName.localeCompare(right.displayName);
+        if (byName !== 0) {
+            return byName;
+        }
+        return left.id.localeCompare(right.id);
+    });
+    for (const provider of leftovers) {
+        families.push({
+            id: `provider:${provider.id}`,
+            label: provider.displayName,
+            providerIds: [provider.id]
+        });
+    }
+    return families;
+}
+export function resolveOnboardingProviderSetupUrl(providerId) {
+    return PROVIDER_SETUP_URLS[providerId];
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/core/providers/onboarding.js.map

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

package/dist/core/providers/provider-module.d.ts

@@ -0,0 +1,19 @@
+import type { Provider } from "./types.js";
+export interface ProviderOnboardingEnvField {
+    key: string;
+    description: string;
+    required?: boolean;
+    secret?: boolean;
+}
+export interface ProviderOnboardingSpec {
+    env?: ProviderOnboardingEnvField[];
+    auth?: {
+        supported: boolean;
+        description: string;
+    };
+}
+export interface ProviderModule {
+    id: string;
+    create: () => Provider;
+    onboarding?: ProviderOnboardingSpec;
+}

package/dist/core/providers/provider-module.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider-module.js.map

package/dist/core/providers/provider-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-module.js","sourceRoot":"","sources":["../../../src/core/providers/provider-module.ts"],"names":[],"mappings":""}

package/dist/core/providers/provider-session.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderExecutionResult } from "./types.js";
+export declare function attachProviderSessionId(result: ProviderExecutionResult, fallbackProviderSessionId?: string): ProviderExecutionResult;
+export declare function extractProviderSessionId(raw: string): string | undefined;

package/dist/core/providers/provider-session.js

@@ -0,0 +1,44 @@
+const SESSION_ID_PATTERNS = [
+    /"sessionID"\s*:\s*"([^"\s]+)"/i,
+    /"sessionId"\s*:\s*"([^"\s]+)"/i,
+    /"chatId"\s*:\s*"([^"\s]+)"/i,
+    /\bsession(?:\s+id)?\s*[:=]\s*([a-z0-9][a-z0-9._-]{5,})\b/i,
+    /\bchat(?:\s+id)?\s*[:=]\s*([a-z0-9][a-z0-9._-]{5,})\b/i
+];
+const UUID_PATTERN = /\b[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}\b/i;
+export function attachProviderSessionId(result, fallbackProviderSessionId) {
+    const explicit = fallbackProviderSessionId?.trim();
+    if (explicit) {
+        return {
+            ...result,
+            providerSessionId: explicit
+        };
+    }
+    const discovered = extractProviderSessionId([result.stdout, result.stderr].join("\n"));
+    if (!discovered) {
+        return result;
+    }
+    return {
+        ...result,
+        providerSessionId: discovered
+    };
+}
+export function extractProviderSessionId(raw) {
+    const input = raw.trim();
+    if (!input) {
+        return undefined;
+    }
+    for (const pattern of SESSION_ID_PATTERNS) {
+        const match = pattern.exec(input);
+        const candidate = match?.[1]?.trim();
+        if (candidate) {
+            return candidate;
+        }
+    }
+    const uuid = UUID_PATTERN.exec(input)?.[0]?.trim();
+    if (uuid) {
+        return uuid;
+    }
+    return undefined;
+}
+//# sourceMappingURL=provider-session.js.map

package/dist/core/providers/provider-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-session.js","sourceRoot":"","sources":["../../../src/core/providers/provider-session.ts"],"names":[],"mappings":"AAEA,MAAM,mBAAmB,GAAa;IACpC,gCAAgC;IAChC,gCAAgC;IAChC,6BAA6B;IAC7B,2DAA2D;IAC3D,wDAAwD;CACzD,CAAC;AAEF,MAAM,YAAY,GAAG,8EAA8E,CAAC;AAEpG,MAAM,UAAU,uBAAuB,CACrC,MAA+B,EAC/B,yBAAkC;IAElC,MAAM,QAAQ,GAAG,yBAAyB,EAAE,IAAI,EAAE,CAAC;IACnD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;YACL,GAAG,MAAM;YACT,iBAAiB,EAAE,QAAQ;SAC5B,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,wBAAwB,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACvF,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,iBAAiB,EAAE,UAAU;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,mBAAmB,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACrC,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IACnD,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/core/providers/providers/claude/index.d.ts

@@ -0,0 +1,4 @@
+import type { ProviderModule } from "../../provider-module.js";
+import { ClaudeProvider } from "./provider.js";
+export declare const providerModule: ProviderModule;
+export { ClaudeProvider };