@opengoat/core 2026.2.9 → 2026.2.13

package/dist/core/providers/image-input.d.ts

@@ -0,0 +1,16 @@
+import type { ProviderImageInput } from "./types.js";
+export interface ResolvedProviderImageInput {
+    name?: string;
+    mediaType: string;
+    base64Data: string;
+    sourcePath?: string;
+}
+export declare function resolveProviderImageInputs(params: {
+    providerId: string;
+    images?: ProviderImageInput[];
+    cwd?: string;
+    maxCount?: number;
+    maxBytesPerImage?: number;
+}): Promise<ResolvedProviderImageInput[]>;
+export declare function imageExtensionForMediaType(mediaType: string): string;
+export declare function renderImagePathContext(imagePaths: string[]): string;

package/dist/core/providers/image-input.js

@@ -0,0 +1,158 @@
+import { readFile, stat } from "node:fs/promises";
+import path from "node:path";
+import { ProviderRuntimeError } from "./errors.js";
+const DEFAULT_MAX_IMAGE_COUNT = 8;
+const DEFAULT_MAX_IMAGE_BYTES = 10 * 1024 * 1024;
+const IMAGE_EXTENSION_TO_MEDIA_TYPE = {
+    ".avif": "image/avif",
+    ".bmp": "image/bmp",
+    ".gif": "image/gif",
+    ".heic": "image/heic",
+    ".heif": "image/heif",
+    ".jpeg": "image/jpeg",
+    ".jpg": "image/jpeg",
+    ".png": "image/png",
+    ".svg": "image/svg+xml",
+    ".tif": "image/tiff",
+    ".tiff": "image/tiff",
+    ".webp": "image/webp"
+};
+const IMAGE_MEDIA_TYPE_TO_EXTENSION = {
+    "image/avif": "avif",
+    "image/bmp": "bmp",
+    "image/gif": "gif",
+    "image/heic": "heic",
+    "image/heif": "heif",
+    "image/jpeg": "jpg",
+    "image/png": "png",
+    "image/svg+xml": "svg",
+    "image/tiff": "tiff",
+    "image/webp": "webp"
+};
+export async function resolveProviderImageInputs(params) {
+    const images = params.images ?? [];
+    if (images.length === 0) {
+        return [];
+    }
+    const maxCount = params.maxCount ?? DEFAULT_MAX_IMAGE_COUNT;
+    if (images.length > maxCount) {
+        throw new ProviderRuntimeError(params.providerId, `too many images provided (${images.length}); the maximum is ${maxCount}`);
+    }
+    const resolved = [];
+    for (let index = 0; index < images.length; index += 1) {
+        const image = images[index];
+        if (!image || typeof image !== "object") {
+            throw new ProviderRuntimeError(params.providerId, `image #${index + 1} is invalid`);
+        }
+        const name = image.name?.trim() || undefined;
+        const explicitMediaType = normalizeMediaType(image.mediaType);
+        const inputPath = image.path?.trim();
+        const dataUrl = image.dataUrl?.trim();
+        if (!inputPath && !dataUrl) {
+            throw new ProviderRuntimeError(params.providerId, `image #${index + 1} must include either "path" or "dataUrl"`);
+        }
+        if (inputPath) {
+            const absolutePath = path.isAbsolute(inputPath)
+                ? inputPath
+                : path.resolve(params.cwd ?? process.cwd(), inputPath);
+            const fileStat = await stat(absolutePath).catch(() => null);
+            if (!fileStat || !fileStat.isFile()) {
+                throw new ProviderRuntimeError(params.providerId, `image #${index + 1} could not be found at ${absolutePath}`);
+            }
+            const maxBytesPerImage = params.maxBytesPerImage ?? DEFAULT_MAX_IMAGE_BYTES;
+            if (fileStat.size > maxBytesPerImage) {
+                throw new ProviderRuntimeError(params.providerId, `image #${index + 1} is too large (${fileStat.size} bytes); max allowed is ${maxBytesPerImage} bytes`);
+            }
+            const mediaType = explicitMediaType || inferMediaTypeFromPath(absolutePath);
+            if (!mediaType || !isImageMediaType(mediaType)) {
+                throw new ProviderRuntimeError(params.providerId, `image #${index + 1} has unsupported media type (${mediaType ?? "unknown"})`);
+            }
+            const fileBuffer = await readFile(absolutePath);
+            resolved.push({
+                name,
+                mediaType,
+                base64Data: fileBuffer.toString("base64"),
+                sourcePath: absolutePath
+            });
+            continue;
+        }
+        const parsedDataUrl = parseDataUrl(dataUrl);
+        if (!parsedDataUrl) {
+            throw new ProviderRuntimeError(params.providerId, `image #${index + 1} contains an invalid data URL`);
+        }
+        const mediaType = explicitMediaType || parsedDataUrl.mediaType;
+        if (!mediaType || !isImageMediaType(mediaType)) {
+            throw new ProviderRuntimeError(params.providerId, `image #${index + 1} has unsupported media type (${mediaType ?? "unknown"})`);
+        }
+        const imageBytes = Buffer.from(parsedDataUrl.base64Data, "base64");
+        const maxBytesPerImage = params.maxBytesPerImage ?? DEFAULT_MAX_IMAGE_BYTES;
+        if (imageBytes.byteLength > maxBytesPerImage) {
+            throw new ProviderRuntimeError(params.providerId, `image #${index + 1} is too large (${imageBytes.byteLength} bytes); max allowed is ${maxBytesPerImage} bytes`);
+        }
+        resolved.push({
+            name,
+            mediaType,
+            base64Data: imageBytes.toString("base64")
+        });
+    }
+    return resolved;
+}
+export function imageExtensionForMediaType(mediaType) {
+    return IMAGE_MEDIA_TYPE_TO_EXTENSION[mediaType.toLowerCase()] ?? "bin";
+}
+export function renderImagePathContext(imagePaths) {
+    if (imagePaths.length === 0) {
+        return "";
+    }
+    return [
+        "## Attached Images",
+        "The user attached image files you can inspect locally:",
+        ...imagePaths.map((imagePath, index) => `${index + 1}. ${imagePath}`)
+    ].join("\n");
+}
+function normalizeMediaType(value) {
+    const trimmed = value?.trim().toLowerCase();
+    return trimmed ? trimmed : undefined;
+}
+function inferMediaTypeFromPath(filePath) {
+    const extension = path.extname(filePath).toLowerCase();
+    return IMAGE_EXTENSION_TO_MEDIA_TYPE[extension];
+}
+function isImageMediaType(mediaType) {
+    return mediaType.toLowerCase().startsWith("image/");
+}
+function parseDataUrl(value) {
+    if (!value.startsWith("data:")) {
+        return null;
+    }
+    const commaIndex = value.indexOf(",");
+    if (commaIndex < 0) {
+        return null;
+    }
+    const header = value.slice(5, commaIndex).trim();
+    const payload = value.slice(commaIndex + 1).trim();
+    if (!payload) {
+        return null;
+    }
+    const headerParts = header.split(";").map((part) => part.trim()).filter(Boolean);
+    const mediaType = normalizeMediaType(headerParts[0]);
+    const isBase64 = headerParts.some((part) => part.toLowerCase() === "base64");
+    if (!isBase64) {
+        return null;
+    }
+    const compactPayload = payload.replace(/\s+/g, "");
+    if (!isLikelyBase64(compactPayload)) {
+        return null;
+    }
+    return {
+        mediaType,
+        base64Data: compactPayload
+    };
+}
+function isLikelyBase64(value) {
+    if (!value) {
+        return false;
+    }
+    return /^[a-zA-Z0-9+/]+=*$/.test(value);
+}
+//# sourceMappingURL=image-input.js.map

package/dist/core/providers/image-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-input.js","sourceRoot":"","sources":["../../../src/core/providers/image-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGnD,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAClC,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD,MAAM,6BAA6B,GAA2B;IAC5D,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;CACtB,CAAC;AAEF,MAAM,6BAA6B,GAA2B;IAC5D,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,MAAM;IACpB,YAAY,EAAE,MAAM;IACpB,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,KAAK;IAClB,eAAe,EAAE,KAAK;IACtB,YAAY,EAAE,MAAM;IACpB,YAAY,EAAE,MAAM;CACrB,CAAC;AASF,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,MAMhD;IACC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;IACnC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,uBAAuB,CAAC;IAC5D,IAAI,MAAM,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,oBAAoB,CAC5B,MAAM,CAAC,UAAU,EACjB,6BAA6B,MAAM,CAAC,MAAM,qBAAqB,QAAQ,EAAE,CAC1E,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAiC,EAAE,CAAC;IAClD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,MAAM,IAAI,oBAAoB,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,KAAK,GAAG,CAAC,aAAa,CAAC,CAAC;QACtF,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;QAC7C,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC9D,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;QAEtC,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,IAAI,oBAAoB,CAC5B,MAAM,CAAC,UAAU,EACjB,UAAU,KAAK,GAAG,CAAC,0CAA0C,CAC9D,CAAC;QACJ,CAAC;QAED,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;gBAC7C,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;YACzD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YAC5D,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;gBACpC,MAAM,IAAI,oBAAoB,CAC5B,MAAM,CAAC,UAAU,EACjB,UAAU,KAAK,GAAG,CAAC,0BAA0B,YAAY,EAAE,CAC5D,CAAC;YACJ,CAAC;YAED,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI,uBAAuB,CAAC;YAC5E,IAAI,QAAQ,CAAC,IAAI,GAAG,gBAAgB,EAAE,CAAC;gBACrC,MAAM,IAAI,oBAAoB,CAC5B,MAAM,CAAC,UAAU,EACjB,UAAU,KAAK,GAAG,CAAC,kBAAkB,QAAQ,CAAC,IAAI,2BAA2B,gBAAgB,QAAQ,CACtG,CAAC;YACJ,CAAC;YAED,MAAM,SAAS,GAAG,iBAAiB,IAAI,sBAAsB,CAAC,YAAY,CAAC,CAAC;YAC5E,IAAI,CAAC,SAAS,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC/C,MAAM,IAAI,oBAAoB,CAC5B,MAAM,CAAC,UAAU,EACjB,UAAU,KAAK,GAAG,CAAC,gCAAgC,SAAS,IAAI,SAAS,GAAG,CAC7E,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC;YAChD,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,SAAS;gBACT,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACzC,UAAU,EAAE,YAAY;aACzB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,aAAa,GAAG,YAAY,CAAC,OAAiB,CAAC,CAAC;QACtD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,oBAAoB,CAC5B,MAAM,CAAC,UAAU,EACjB,UAAU,KAAK,GAAG,CAAC,+BAA+B,CACnD,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,iBAAiB,IAAI,aAAa,CAAC,SAAS,CAAC;QAC/D,IAAI,CAAC,SAAS,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,oBAAoB,CAC5B,MAAM,CAAC,UAAU,EACjB,UAAU,KAAK,GAAG,CAAC,gCAAgC,SAAS,IAAI,SAAS,GAAG,CAC7E,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACnE,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI,uBAAuB,CAAC;QAC5E,IAAI,UAAU,CAAC,UAAU,GAAG,gBAAgB,EAAE,CAAC;YAC7C,MAAM,IAAI,oBAAoB,CAC5B,MAAM,CAAC,UAAU,EACjB,UAAU,KAAK,GAAG,CAAC,kBAAkB,UAAU,CAAC,UAAU,2BAA2B,gBAAgB,QAAQ,CAC9G,CAAC;QACJ,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI;YACJ,SAAS;YACT,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;SAC1C,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,SAAiB;IAC1D,OAAO,6BAA6B,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,IAAI,KAAK,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAoB;IACzD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO;QACL,oBAAoB;QACpB,wDAAwD;QACxD,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;KACtE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAyB;IACnD,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACvC,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAgB;IAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACvD,OAAO,6BAA6B,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiB;IACzC,OAAO,SAAS,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjF,MAAM,SAAS,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,CAAC;IAC7E,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,SAAS;QACT,UAAU,EAAE,cAAc;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC"}

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

@@ -1,16 +1,10 @@
-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 type { AgentRuntimeProfile, OpenClawGatewayConfig, ProviderStoredConfig } from "./application/provider.service.js";
 export { loadProviderModules } from "./loader.js";
 export type { ProviderModule } from "./provider-module.js";
 export type { ProviderOnboardingEnvField, ProviderOnboardingSpec } from "./provider-module.js";

package/dist/core/providers/index.js

@@ -1,27 +1,14 @@
 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

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAwB,MAAM,eAAe,CAAC;AAEvE,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,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;AAMpE,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.js

@@ -1,99 +1,5 @@
-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";
+    registry.register(openclawProviderModule.id, openclawProviderModule.create, openclawProviderModule);
 }
 //# sourceMappingURL=loader.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/core/providers/loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/core/providers/loader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,IAAI,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEzF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,QAA0B;IAClE,QAAQ,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,EAAE,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;AACtG,CAAC"}

package/dist/core/providers/providers/openclaw/provider.js

@@ -1,6 +1,8 @@
 import { BaseCliProvider } from "../../cli-provider.js";
 import { attachProviderSessionId } from "../../provider-session.js";
-import { delimiter } from "node:path";
+import { randomUUID } from "node:crypto";
+import { homedir } from "node:os";
+import { delimiter, dirname, join } from "node:path";
 export class OpenClawProvider extends BaseCliProvider {
     constructor() {
         super({
@@ -20,36 +22,18 @@ export class OpenClawProvider extends BaseCliProvider {
         });
     }
     buildInvocationArgs(options) {
-        const args = ["agent"];
-        if (options.agent) {
-            args.push(options.agent);
-        }
-        if (options.providerSessionId?.trim()) {
-            args.push("--session-id", options.providerSessionId.trim());
-        }
-        if (options.model) {
-            args.push("--model", options.model);
+        const runtime = resolveGatewayInvocationRuntime(options.env);
+        const sessionKey = buildOpenClawSessionKey(options.agent, options.providerSessionId);
+        const args = [...runtime.globalArgs, "gateway", "call", "agent"];
+        if (runtime.gatewayUrl && runtime.gatewayToken) {
+            args.push("--url", runtime.gatewayUrl, "--token", runtime.gatewayToken);
         }
         args.push(...(options.passthroughArgs ?? []));
-        args.push("--message", options.message);
-        // Inject extra arguments from env if present
-        const extraArgs = options.env?.OPENCLAW_ARGUMENTS?.trim();
-        if (extraArgs) {
-            // Simple splitting by space - for more complex cases user should use shell script wrapper
-            // or we might need a proper argv parser, but this suffices for simple flags like --remote
-            args.push(...extraArgs.split(" ").filter((arg) => arg.trim().length > 0));
-        }
+        args.push("--expect-final", "--json", "--timeout", "630000", "--params", JSON.stringify(buildGatewayAgentParams(options, sessionKey)));
         return args;
     }
     prepareExecutionEnv(env) {
-        if (process.platform !== "darwin") {
-            return env;
-        }
-        const preferredNodePaths = [
-            "/opt/homebrew/bin",
-            "/opt/homebrew/opt/node@22/bin",
-            "/usr/local/opt/node@22/bin",
-        ];
+        const preferredNodePaths = resolvePreferredCommandPaths(env);
         const mergedPath = dedupePathEntries([
             ...preferredNodePaths,
             ...(env.PATH?.split(delimiter) ?? []),
@@ -62,9 +46,15 @@ export class OpenClawProvider extends BaseCliProvider {
     buildAuthInvocationArgs(options) {
         const passthrough = options.passthroughArgs ?? [];
         if (passthrough.length > 0) {
-            return ["models", "auth", "login", ...passthrough];
+            return [
+                ...resolveOpenClawArguments(options.env),
+                "models",
+                "auth",
+                "login",
+                ...passthrough,
+            ];
         }
-        return ["onboard"];
+        return [...resolveOpenClawArguments(options.env), "onboard"];
     }
     buildCreateAgentInvocationArgs(options) {
         const args = [
@@ -81,16 +71,181 @@ export class OpenClawProvider extends BaseCliProvider {
         if (model) {
             args.push("--model", model);
         }
-        return args;
+        return [...resolveOpenClawArguments(options.env), ...args];
     }
     buildDeleteAgentInvocationArgs(options) {
-        return ["agents", "delete", options.agentId, "--force"];
+        return [
+            ...resolveOpenClawArguments(options.env),
+            "agents",
+            "delete",
+            options.agentId,
+            "--force",
+        ];
     }
     async invoke(options) {
-        const sessionId = options.providerSessionId?.trim();
+        const sessionKey = buildOpenClawSessionKey(options.agent, options.providerSessionId);
         const result = await super.invoke(options);
-        return attachProviderSessionId(result, sessionId);
+        const parsed = parseGatewayAgentResponse(result.stdout);
+        const normalizedStdout = parsed?.assistantText || result.stdout;
+        return attachProviderSessionId({
+            ...result,
+            stdout: normalizedStdout,
+        }, sessionKey ?? parsed?.providerSessionId);
+    }
+}
+function buildOpenClawSessionKey(agentId, providerSessionId) {
+    const raw = providerSessionId?.trim();
+    if (!raw) {
+        return undefined;
+    }
+    if (raw.includes(":")) {
+        return raw.toLowerCase();
     }
+    return `agent:${normalizeSessionSegment(agentId) || "main"}:${normalizeSessionSegment(raw) || "main"}`;
+}
+function buildGatewayAgentParams(options, sessionKey) {
+    const idempotencyKey = options.idempotencyKey?.trim() || randomUUID().toLowerCase();
+    const params = {
+        message: options.message,
+        idempotencyKey,
+    };
+    const agentId = options.agent?.trim();
+    if (agentId) {
+        params.agentId = agentId;
+    }
+    const model = options.model?.trim();
+    if (model) {
+        params.model = model;
+    }
+    const providerSessionId = options.providerSessionId?.trim();
+    if (providerSessionId) {
+        params.sessionId = providerSessionId;
+    }
+    if (sessionKey) {
+        params.sessionKey = sessionKey;
+    }
+    return params;
+}
+function resolveOpenClawArguments(env) {
+    const raw = env?.OPENCLAW_ARGUMENTS?.trim();
+    if (!raw) {
+        return [];
+    }
+    return raw
+        .split(" ")
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0);
+}
+function resolveGatewayInvocationRuntime(env) {
+    const parsed = tokenizeArguments(env?.OPENCLAW_ARGUMENTS);
+    let gatewayUrl = env?.OPENCLAW_GATEWAY_URL?.trim();
+    let gatewayToken = env?.OPENCLAW_GATEWAY_PASSWORD?.trim();
+    const globalArgs = [];
+    for (let index = 0; index < parsed.length; index += 1) {
+        const token = parsed[index]?.trim();
+        if (!token) {
+            continue;
+        }
+        if (token === "--remote") {
+            const next = parsed[index + 1]?.trim();
+            if (next && !next.startsWith("--")) {
+                if (!gatewayUrl) {
+                    gatewayUrl = next;
+                }
+                index += 1;
+            }
+            continue;
+        }
+        if (token === "--token") {
+            const next = parsed[index + 1]?.trim();
+            if (next && !next.startsWith("--")) {
+                if (!gatewayToken) {
+                    gatewayToken = next;
+                }
+                index += 1;
+            }
+            continue;
+        }
+        globalArgs.push(token);
+    }
+    return {
+        globalArgs,
+        gatewayUrl,
+        gatewayToken,
+    };
+}
+function tokenizeArguments(raw) {
+    const value = raw?.trim();
+    if (!value) {
+        return [];
+    }
+    return value
+        .split(" ")
+        .map((part) => part.trim())
+        .filter((part) => part.length > 0);
+}
+function normalizeSessionSegment(value) {
+    const normalized = (value ?? "")
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9:-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return normalized;
+}
+function parseGatewayAgentResponse(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== "object") {
+        return null;
+    }
+    const record = parsed;
+    const lines = [];
+    for (const payload of record.result?.payloads ?? []) {
+        const text = typeof payload?.text === "string" ? payload.text.trim() : "";
+        if (text) {
+            lines.push(text);
+        }
+        for (const mediaUrl of normalizeMediaUrls(payload?.mediaUrl, payload?.mediaUrls)) {
+            lines.push(`MEDIA:${mediaUrl}`);
+        }
+    }
+    return {
+        assistantText: lines.join("\n\n").trim(),
+        providerSessionId: typeof record.result?.meta?.agentMeta?.sessionId === "string"
+            ? record.result.meta.agentMeta.sessionId.trim() || undefined
+            : undefined,
+    };
+}
+function normalizeMediaUrls(mediaUrl, mediaUrls) {
+    const urls = [];
+    if (typeof mediaUrl === "string") {
+        const normalized = mediaUrl.trim();
+        if (normalized) {
+            urls.push(normalized);
+        }
+    }
+    if (!Array.isArray(mediaUrls)) {
+        return urls;
+    }
+    for (const entry of mediaUrls) {
+        if (typeof entry !== "string") {
+            continue;
+        }
+        const normalized = entry.trim();
+        if (normalized) {
+            urls.push(normalized);
+        }
+    }
+    return urls;
 }
 function dedupePathEntries(entries) {
     const seen = new Set();
@@ -105,4 +260,30 @@ function dedupePathEntries(entries) {
     }
     return result;
 }
+function resolvePreferredCommandPaths(env) {
+    const homeDir = homedir();
+    const preferredPaths = [
+        dirname(process.execPath),
+        join(homeDir, ".npm-global", "bin"),
+        join(homeDir, ".npm", "bin"),
+        join(homeDir, ".local", "bin"),
+        join(homeDir, ".volta", "bin"),
+        join(homeDir, ".fnm", "current", "bin"),
+        join(homeDir, ".asdf", "shims"),
+        join(homeDir, "bin"),
+    ];
+    const npmPrefixCandidates = dedupePathEntries([
+        env.npm_config_prefix ?? "",
+        env.NPM_CONFIG_PREFIX ?? "",
+        process.env.npm_config_prefix ?? "",
+        process.env.NPM_CONFIG_PREFIX ?? "",
+    ]);
+    for (const prefix of npmPrefixCandidates) {
+        preferredPaths.push(join(prefix, "bin"));
+    }
+    if (process.platform === "darwin") {
+        preferredPaths.push("/opt/homebrew/bin", "/opt/homebrew/opt/node@22/bin", "/usr/local/opt/node@22/bin");
+    }
+    return preferredPaths;
+}
 //# sourceMappingURL=provider.js.map