@okrlinkhub/agent-factory 0.2.1 → 0.2.2

package/dist/component/schema.d.ts

@@ -1,19 +1,19 @@
 declare const _default: import("convex/server").SchemaDefinition<{
     agentProfiles: import("convex/server").TableDefinition<import("convex/values").VObject<{
-        clientMd?: string | undefined;
         bridgeConfig?: {
-            baseUrl?: string | undefined;
             serviceId?: string | undefined;
+            baseUrl?: string | undefined;
             appKey?: string | undefined;
             serviceKeySecretRef?: string | undefined;
             enabled: boolean;
         } | undefined;
+        clientMd?: string | undefined;
         agentKey: string;
-        version: string;
-        soulMd: string;
-        skills: string[];
-        secretsRef: string[];
         enabled: boolean;
+        secretsRef: string[];
+        skills: string[];
+        soulMd: string;
+        version: string;
     }, {
         agentKey: import("convex/values").VString<string, "required">;
         version: import("convex/values").VString<string, "required">;
@@ -22,8 +22,8 @@ declare const _default: import("convex/server").SchemaDefinition<{
         skills: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
         secretsRef: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
         bridgeConfig: import("convex/values").VObject<{
-            baseUrl?: string | undefined;
             serviceId?: string | undefined;
+            baseUrl?: string | undefined;
             appKey?: string | undefined;
             serviceKeySecretRef?: string | undefined;
             enabled: boolean;
@@ -33,16 +33,16 @@ declare const _default: import("convex/server").SchemaDefinition<{
             serviceId: import("convex/values").VString<string | undefined, "optional">;
             appKey: import("convex/values").VString<string | undefined, "optional">;
             serviceKeySecretRef: import("convex/values").VString<string | undefined, "optional">;
-        }, "optional", "enabled" | "baseUrl" | "serviceId" | "appKey" | "serviceKeySecretRef">;
+        }, "optional", "serviceId" | "baseUrl" | "appKey" | "enabled" | "serviceKeySecretRef">;
         enabled: import("convex/values").VBoolean<boolean, "required">;
-    }, "required", "agentKey" | "version" | "soulMd" | "clientMd" | "skills" | "secretsRef" | "bridgeConfig" | "enabled" | "bridgeConfig.enabled" | "bridgeConfig.baseUrl" | "bridgeConfig.serviceId" | "bridgeConfig.appKey" | "bridgeConfig.serviceKeySecretRef">, {
+    }, "required", "agentKey" | "bridgeConfig" | "clientMd" | "enabled" | "secretsRef" | "skills" | "soulMd" | "version" | "bridgeConfig.serviceId" | "bridgeConfig.baseUrl" | "bridgeConfig.appKey" | "bridgeConfig.enabled" | "bridgeConfig.serviceKeySecretRef">, {
         by_agentKey: ["agentKey", "_creationTime"];
         by_enabled: ["enabled", "_creationTime"];
     }, {}, {}>;
     conversations: import("convex/server").TableDefinition<import("convex/values").VObject<{
         processingLock?: {
-            leaseId: string;
             workerId: string;
+            leaseId: string;
             leaseExpiresAt: number;
             heartbeatAt: number;
             claimedMessageId: import("convex/values").GenericId<"messageQueue">;
@@ -55,9 +55,9 @@ declare const _default: import("convex/server").SchemaDefinition<{
             at: number;
         }[];
         pendingToolCalls: {
+            status: "pending" | "running" | "done" | "failed";
             toolName: string;
             callId: string;
-            status: "pending" | "running" | "done" | "failed";
         }[];
     }, {
         conversationId: import("convex/values").VString<string, "required">;
@@ -76,21 +76,21 @@ declare const _default: import("convex/server").SchemaDefinition<{
             at: import("convex/values").VFloat64<number, "required">;
         }, "required", "role" | "content" | "at">, "required">;
         pendingToolCalls: import("convex/values").VArray<{
+            status: "pending" | "running" | "done" | "failed";
             toolName: string;
             callId: string;
-            status: "pending" | "running" | "done" | "failed";
         }[], import("convex/values").VObject<{
+            status: "pending" | "running" | "done" | "failed";
             toolName: string;
             callId: string;
-            status: "pending" | "running" | "done" | "failed";
         }, {
             toolName: import("convex/values").VString<string, "required">;
             callId: import("convex/values").VString<string, "required">;
             status: import("convex/values").VUnion<"pending" | "running" | "done" | "failed", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"running", "required">, import("convex/values").VLiteral<"done", "required">, import("convex/values").VLiteral<"failed", "required">], "required", never>;
-        }, "required", "toolName" | "callId" | "status">, "required">;
+        }, "required", "status" | "toolName" | "callId">, "required">;
         processingLock: import("convex/values").VObject<{
-            leaseId: string;
             workerId: string;
+            leaseId: string;
             leaseExpiresAt: number;
             heartbeatAt: number;
             claimedMessageId: import("convex/values").GenericId<"messageQueue">;
@@ -100,8 +100,8 @@ declare const _default: import("convex/server").SchemaDefinition<{
             leaseExpiresAt: import("convex/values").VFloat64<number, "required">;
             heartbeatAt: import("convex/values").VFloat64<number, "required">;
             claimedMessageId: import("convex/values").VId<import("convex/values").GenericId<"messageQueue">, "required">;
-        }, "optional", "leaseId" | "workerId" | "leaseExpiresAt" | "heartbeatAt" | "claimedMessageId">;
-    }, "required", "agentKey" | "conversationId" | "contextHistory" | "pendingToolCalls" | "processingLock" | "processingLock.leaseId" | "processingLock.workerId" | "processingLock.leaseExpiresAt" | "processingLock.heartbeatAt" | "processingLock.claimedMessageId">, {
+        }, "optional", "workerId" | "leaseId" | "leaseExpiresAt" | "heartbeatAt" | "claimedMessageId">;
+    }, "required", "agentKey" | "conversationId" | "contextHistory" | "pendingToolCalls" | "processingLock" | "processingLock.workerId" | "processingLock.leaseId" | "processingLock.leaseExpiresAt" | "processingLock.heartbeatAt" | "processingLock.claimedMessageId">, {
         by_conversationId: ["conversationId", "_creationTime"];
         by_agentKey: ["agentKey", "_creationTime"];
     }, {}, {}>;
@@ -112,13 +112,14 @@ declare const _default: import("convex/server").SchemaDefinition<{
         lastError?: string | undefined;
         nextRetryAt?: number | undefined;
         deadLetteredAt?: number | undefined;
+        status: "done" | "failed" | "queued" | "processing" | "dead_letter";
         agentKey: string;
         conversationId: string;
-        status: "done" | "failed" | "queued" | "processing" | "dead_letter";
+        maxAttempts: number;
         payload: {
+            metadata?: Record<string, string> | undefined;
             externalMessageId?: string | undefined;
             rawUpdateJson?: string | undefined;
-            metadata?: Record<string, string> | undefined;
             provider: string;
             providerUserId: string;
             messageText: string;
@@ -126,14 +127,13 @@ declare const _default: import("convex/server").SchemaDefinition<{
         priority: number;
         scheduledFor: number;
         attempts: number;
-        maxAttempts: number;
     }, {
         conversationId: import("convex/values").VString<string, "required">;
         agentKey: import("convex/values").VString<string, "required">;
         payload: import("convex/values").VObject<{
+            metadata?: Record<string, string> | undefined;
             externalMessageId?: string | undefined;
             rawUpdateJson?: string | undefined;
-            metadata?: Record<string, string> | undefined;
             provider: string;
             providerUserId: string;
             messageText: string;
@@ -144,7 +144,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
             externalMessageId: import("convex/values").VString<string | undefined, "optional">;
             rawUpdateJson: import("convex/values").VString<string | undefined, "optional">;
             metadata: import("convex/values").VRecord<Record<string, string> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VString<string, "required">, "optional", string>;
-        }, "required", "provider" | "providerUserId" | "messageText" | "externalMessageId" | "rawUpdateJson" | "metadata" | `metadata.${string}`>;
+        }, "required", "metadata" | "provider" | "providerUserId" | "messageText" | "externalMessageId" | "rawUpdateJson" | `metadata.${string}`>;
         status: import("convex/values").VUnion<"done" | "failed" | "queued" | "processing" | "dead_letter", [import("convex/values").VLiteral<"queued", "required">, import("convex/values").VLiteral<"processing", "required">, import("convex/values").VLiteral<"done", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"dead_letter", "required">], "required", never>;
         priority: import("convex/values").VFloat64<number, "required">;
         scheduledFor: import("convex/values").VFloat64<number, "required">;
@@ -156,7 +156,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         lastError: import("convex/values").VString<string | undefined, "optional">;
         nextRetryAt: import("convex/values").VFloat64<number | undefined, "optional">;
         deadLetteredAt: import("convex/values").VFloat64<number | undefined, "optional">;
-    }, "required", "agentKey" | "conversationId" | "status" | "leaseId" | "leaseExpiresAt" | "payload" | "priority" | "scheduledFor" | "claimedBy" | "attempts" | "maxAttempts" | "lastError" | "nextRetryAt" | "deadLetteredAt" | "payload.provider" | "payload.providerUserId" | "payload.messageText" | "payload.externalMessageId" | "payload.rawUpdateJson" | "payload.metadata" | `payload.metadata.${string}`>, {
+    }, "required", "status" | "agentKey" | "conversationId" | "leaseId" | "maxAttempts" | "payload" | "priority" | "scheduledFor" | "leaseExpiresAt" | "claimedBy" | "attempts" | "lastError" | "nextRetryAt" | "deadLetteredAt" | "payload.metadata" | "payload.provider" | "payload.providerUserId" | "payload.messageText" | "payload.externalMessageId" | "payload.rawUpdateJson" | `payload.metadata.${string}`>, {
         by_status_and_scheduledFor: ["status", "scheduledFor", "_creationTime"];
         by_status_and_priority_and_scheduledFor: ["status", "priority", "scheduledFor", "_creationTime"];
         by_status_and_leaseExpiresAt: ["status", "leaseExpiresAt", "_creationTime"];
@@ -176,8 +176,8 @@ declare const _default: import("convex/server").SchemaDefinition<{
         lastSnapshotId?: import("convex/values").GenericId<"dataSnapshots"> | undefined;
         status: "active" | "stopped";
         workerId: string;
-        heartbeatAt: number;
         provider: string;
+        heartbeatAt: number;
         load: number;
         capabilities: string[];
     }, {
@@ -191,7 +191,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
             appName: import("convex/values").VString<string, "required">;
             machineId: import("convex/values").VString<string, "required">;
             region: import("convex/values").VString<string | undefined, "optional">;
-        }, "optional", "appName" | "machineId" | "region">;
+        }, "optional", "appName" | "region" | "machineId">;
         status: import("convex/values").VUnion<"active" | "stopped", [import("convex/values").VLiteral<"active", "required">, import("convex/values").VLiteral<"stopped", "required">], "required", never>;
         load: import("convex/values").VFloat64<number, "required">;
         heartbeatAt: import("convex/values").VFloat64<number, "required">;
@@ -200,24 +200,24 @@ declare const _default: import("convex/server").SchemaDefinition<{
         stoppedAt: import("convex/values").VFloat64<number | undefined, "optional">;
         lastSnapshotId: import("convex/values").VId<import("convex/values").GenericId<"dataSnapshots"> | undefined, "optional">;
         capabilities: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
-    }, "required", "status" | "workerId" | "heartbeatAt" | "provider" | "machineRef" | "load" | "lastClaimAt" | "scheduledShutdownAt" | "stoppedAt" | "lastSnapshotId" | "capabilities" | "machineRef.appName" | "machineRef.machineId" | "machineRef.region">, {
+    }, "required", "status" | "workerId" | "provider" | "heartbeatAt" | "machineRef" | "load" | "lastClaimAt" | "scheduledShutdownAt" | "stoppedAt" | "lastSnapshotId" | "capabilities" | "machineRef.appName" | "machineRef.region" | "machineRef.machineId">, {
         by_workerId: ["workerId", "_creationTime"];
         by_status: ["status", "_creationTime"];
         by_heartbeatAt: ["heartbeatAt", "_creationTime"];
         by_scheduledShutdownAt: ["scheduledShutdownAt", "_creationTime"];
     }, {}, {}>;
     dataSnapshots: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        error?: string | undefined;
         conversationId?: string | undefined;
-        archiveFileId?: import("convex/values").GenericId<"_storage"> | undefined;
         sha256?: string | undefined;
         sizeBytes?: number | undefined;
-        error?: string | undefined;
+        archiveFileId?: import("convex/values").GenericId<"_storage"> | undefined;
         completedAt?: number | undefined;
+        status: "expired" | "failed" | "uploading" | "ready";
         agentKey: string;
-        status: "failed" | "uploading" | "ready" | "expired";
-        workerId: string;
         workspaceId: string;
-        reason: "drain" | "signal" | "manual";
+        workerId: string;
+        reason: "manual" | "drain" | "signal";
         formatVersion: number;
         createdAt: number;
         expiresAt: number;
@@ -226,17 +226,17 @@ declare const _default: import("convex/server").SchemaDefinition<{
         agentKey: import("convex/values").VString<string, "required">;
         workerId: import("convex/values").VString<string, "required">;
         conversationId: import("convex/values").VString<string | undefined, "optional">;
-        reason: import("convex/values").VUnion<"drain" | "signal" | "manual", [import("convex/values").VLiteral<"drain", "required">, import("convex/values").VLiteral<"signal", "required">, import("convex/values").VLiteral<"manual", "required">], "required", never>;
+        reason: import("convex/values").VUnion<"manual" | "drain" | "signal", [import("convex/values").VLiteral<"drain", "required">, import("convex/values").VLiteral<"signal", "required">, import("convex/values").VLiteral<"manual", "required">], "required", never>;
         formatVersion: import("convex/values").VFloat64<number, "required">;
         archiveFileId: import("convex/values").VId<import("convex/values").GenericId<"_storage"> | undefined, "optional">;
         sha256: import("convex/values").VString<string | undefined, "optional">;
         sizeBytes: import("convex/values").VFloat64<number | undefined, "optional">;
-        status: import("convex/values").VUnion<"failed" | "uploading" | "ready" | "expired", [import("convex/values").VLiteral<"uploading", "required">, import("convex/values").VLiteral<"ready", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"expired", "required">], "required", never>;
+        status: import("convex/values").VUnion<"expired" | "failed" | "uploading" | "ready", [import("convex/values").VLiteral<"uploading", "required">, import("convex/values").VLiteral<"ready", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"expired", "required">], "required", never>;
         error: import("convex/values").VString<string | undefined, "optional">;
         createdAt: import("convex/values").VFloat64<number, "required">;
         completedAt: import("convex/values").VFloat64<number | undefined, "optional">;
         expiresAt: import("convex/values").VFloat64<number, "required">;
-    }, "required", "agentKey" | "conversationId" | "status" | "workerId" | "workspaceId" | "reason" | "formatVersion" | "archiveFileId" | "sha256" | "sizeBytes" | "error" | "createdAt" | "completedAt" | "expiresAt">, {
+    }, "required", "error" | "status" | "agentKey" | "conversationId" | "workspaceId" | "workerId" | "sha256" | "sizeBytes" | "reason" | "formatVersion" | "archiveFileId" | "createdAt" | "completedAt" | "expiresAt">, {
         by_workerId_and_createdAt: ["workerId", "createdAt", "_creationTime"];
         by_workspaceId_and_agentKey_and_createdAt: ["workspaceId", "agentKey", "createdAt", "_creationTime"];
         by_conversationId_and_createdAt: ["conversationId", "createdAt", "_creationTime"];
@@ -245,9 +245,9 @@ declare const _default: import("convex/server").SchemaDefinition<{
     secrets: import("convex/server").TableDefinition<import("convex/values").VObject<{
         metadata?: Record<string, string> | undefined;
         rotatedFrom?: number | undefined;
-        version: number;
         active: boolean;
         secretRef: string;
+        version: number;
         encryptedValue: string;
         keyId: string;
         algorithm: string;
@@ -260,18 +260,18 @@ declare const _default: import("convex/server").SchemaDefinition<{
         active: import("convex/values").VBoolean<boolean, "required">;
         rotatedFrom: import("convex/values").VFloat64<number | undefined, "optional">;
         metadata: import("convex/values").VRecord<Record<string, string> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VString<string, "required">, "optional", string>;
-    }, "required", "version" | "metadata" | `metadata.${string}` | "active" | "secretRef" | "encryptedValue" | "keyId" | "algorithm" | "rotatedFrom">, {
+    }, "required", "active" | "metadata" | "secretRef" | "version" | `metadata.${string}` | "encryptedValue" | "keyId" | "algorithm" | "rotatedFrom">, {
         by_secretRef: ["secretRef", "_creationTime"];
         by_secretRef_and_active: ["secretRef", "active", "_creationTime"];
         by_active: ["active", "_creationTime"];
     }, {}, {}>;
     identityBindings: import("convex/server").TableDefinition<import("convex/values").VObject<{
         metadata?: Record<string, string> | undefined;
-        telegramUserId?: string | undefined;
         telegramChatId?: string | undefined;
+        telegramUserId?: string | undefined;
         revokedAt?: number | undefined;
-        agentKey: string;
         status: "active" | "revoked";
+        agentKey: string;
         consumerUserId: string;
         source: "manual" | "telegram_pairing" | "api";
         boundAt: number;
@@ -285,33 +285,33 @@ declare const _default: import("convex/server").SchemaDefinition<{
         metadata: import("convex/values").VRecord<Record<string, string> | undefined, import("convex/values").VString<string, "required">, import("convex/values").VString<string, "required">, "optional", string>;
         boundAt: import("convex/values").VFloat64<number, "required">;
         revokedAt: import("convex/values").VFloat64<number | undefined, "optional">;
-    }, "required", "agentKey" | "status" | "metadata" | `metadata.${string}` | "consumerUserId" | "source" | "telegramUserId" | "telegramChatId" | "boundAt" | "revokedAt">, {
+    }, "required", "status" | "agentKey" | "consumerUserId" | "metadata" | "source" | "telegramChatId" | "telegramUserId" | `metadata.${string}` | "boundAt" | "revokedAt">, {
         by_consumerUserId_and_status: ["consumerUserId", "status", "_creationTime"];
         by_telegramUserId_and_status: ["telegramUserId", "status", "_creationTime"];
         by_telegramChatId_and_status: ["telegramChatId", "status", "_creationTime"];
         by_agentKey_and_status: ["agentKey", "status", "_creationTime"];
     }, {}, {}>;
     pairingCodes: import("convex/server").TableDefinition<import("convex/values").VObject<{
-        telegramUserId?: string | undefined;
         telegramChatId?: string | undefined;
+        telegramUserId?: string | undefined;
         usedAt?: number | undefined;
+        status: "pending" | "used" | "expired";
         agentKey: string;
-        status: "pending" | "expired" | "used";
-        createdAt: number;
-        expiresAt: number;
         consumerUserId: string;
         code: string;
+        createdAt: number;
+        expiresAt: number;
     }, {
         code: import("convex/values").VString<string, "required">;
         consumerUserId: import("convex/values").VString<string, "required">;
         agentKey: import("convex/values").VString<string, "required">;
-        status: import("convex/values").VUnion<"pending" | "expired" | "used", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"used", "required">, import("convex/values").VLiteral<"expired", "required">], "required", never>;
+        status: import("convex/values").VUnion<"pending" | "used" | "expired", [import("convex/values").VLiteral<"pending", "required">, import("convex/values").VLiteral<"used", "required">, import("convex/values").VLiteral<"expired", "required">], "required", never>;
         createdAt: import("convex/values").VFloat64<number, "required">;
         expiresAt: import("convex/values").VFloat64<number, "required">;
         usedAt: import("convex/values").VFloat64<number | undefined, "optional">;
         telegramUserId: import("convex/values").VString<string | undefined, "optional">;
         telegramChatId: import("convex/values").VString<string | undefined, "optional">;
-    }, "required", "agentKey" | "status" | "createdAt" | "expiresAt" | "consumerUserId" | "telegramUserId" | "telegramChatId" | "code" | "usedAt">, {
+    }, "required", "status" | "agentKey" | "consumerUserId" | "telegramChatId" | "telegramUserId" | "code" | "createdAt" | "expiresAt" | "usedAt">, {
         by_code: ["code", "_creationTime"];
         by_consumerUserId_and_status: ["consumerUserId", "status", "_creationTime"];
         by_expiresAt: ["expiresAt", "_creationTime"];

package/package.json

@@ -9,7 +9,7 @@
   "bugs": {
     "url": "https://github.com/okrlinkhub/agent-factory/issues"
   },
-  "version": "0.2.1",
+  "version": "0.2.2",
   "license": "Apache-2.0",
   "keywords": [
     "convex",

package/src/client/index.ts

@@ -7,7 +7,11 @@ import {
 import type { Auth, HttpRouter } from "convex/server";
 import { v } from "convex/values";
 import type { ComponentApi } from "../component/_generated/component.js";
-import { scalingPolicyValidator } from "../component/config.js";
+import {
+  providerConfigValidator,
+  scalingPolicyValidator,
+  type ProviderConfig,
+} from "../component/config.js";
 export {
   bridgeFunctionKeyFromToolName,
   executeBridgeFunction,
@@ -32,6 +36,7 @@ export function exposeApi(
             agentKey?: string;
           },
     ) => Promise<string>;
+    providerConfig?: ProviderConfig;
   },
 ) {
   return {
@@ -53,6 +58,7 @@ export function exposeApi(
         rawUpdateJson: v.optional(v.string()),
         metadata: v.optional(v.record(v.string(), v.string())),
         priority: v.optional(v.number()),
+        providerConfig: v.optional(providerConfigValidator),
       },
       handler: async (ctx, args) => {
         await options.auth(ctx, {
@@ -72,6 +78,7 @@ export function exposeApi(
             metadata: args.metadata,
           },
           priority: args.priority,
+          providerConfig: args.providerConfig ?? options.providerConfig,
         });
       },
     }),
@@ -302,6 +309,7 @@ export function exposeApi(
           convexUrl: args.convexUrl,
           workspaceId: args.workspaceId,
           scalingPolicy: args.scalingPolicy,
+          providerConfig: options.providerConfig,
         });
       },
     }),
@@ -313,6 +321,7 @@ export function exposeApi(
         await options.auth(ctx, { type: "read" });
         return await ctx.runAction((component.lib as any).checkIdleShutdowns, {
           flyApiToken: args.flyApiToken,
+          providerConfig: options.providerConfig,
         });
       },
     }),
@@ -343,6 +352,7 @@ export function exposeApi(
         const reconcile = await ctx.runAction(component.lib.reconcileWorkers, {
           workspaceId: args.workspaceId,
           scalingPolicy: args.scalingPolicy,
+          providerConfig: options.providerConfig,
         });
         return {
           released,
@@ -463,12 +473,14 @@ export function registerRoutes(
     resolveAgentKeyFromBinding = true,
     fallbackAgentKey = "default",
     requireBindingForTelegram = false,
+    providerConfig,
   }: {
     pathPrefix?: string;
     resolveAgentKey?: (update: unknown) => string;
     resolveAgentKeyFromBinding?: boolean;
     fallbackAgentKey?: string;
     requireBindingForTelegram?: boolean;
+    providerConfig?: ProviderConfig;
   } = {},
 ) {
   http.route({
@@ -636,6 +648,7 @@ export function registerRoutes(
           rawUpdateJson: JSON.stringify(update),
           metadata,
         },
+        providerConfig,
       });
       return new Response(JSON.stringify({ ok: true }), {
         status: 202,

package/src/component/_generated/component.ts

@@ -378,6 +378,16 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
             rawUpdateJson?: string;
           };
           priority?: number;
+          providerConfig?: {
+            appName: string;
+            image: string;
+            kind: "fly" | "runpod" | "ecs";
+            organizationSlug: string;
+            region: string;
+            volumeName: string;
+            volumePath: string;
+            volumeSizeGb: number;
+          };
           scheduledFor?: number;
         },
         string,
@@ -689,6 +699,16 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
             rawUpdateJson?: string;
           };
           priority?: number;
+          providerConfig?: {
+            appName: string;
+            image: string;
+            kind: "fly" | "runpod" | "ecs";
+            organizationSlug: string;
+            region: string;
+            volumeName: string;
+            volumePath: string;
+            volumeSizeGb: number;
+          };
           scheduledFor?: number;
         },
         string,

package/src/component/config.ts

@@ -59,7 +59,7 @@ export type AgentFactoryConfig = {
 };
 
 export const DEFAULT_WORKER_IMAGE =
-  "registry.fly.io/agent-factory-workers:deployment-01KJ1MDGR3KQV025S7SZXJTZDH";
+  "";
 export const DEFAULT_WORKER_VOLUME_NAME = "openclaw_data";
 export const DEFAULT_WORKER_VOLUME_PATH = "/data";
 export const DEFAULT_WORKER_RUNTIME_ENV: Record<string, string> = {
@@ -172,11 +172,11 @@ export const DEFAULT_CONFIG: AgentFactoryConfig = {
   },
   provider: {
     kind: "fly",
-    appName: "agent-factory-workers",
-    organizationSlug: "personal",
+    appName: "",
+    organizationSlug: "",
     image: DEFAULT_WORKER_IMAGE,
-    region: "iad",
-    volumeName: DEFAULT_WORKER_VOLUME_NAME,
+    region: "",
+    volumeName: "",
     volumePath: DEFAULT_WORKER_VOLUME_PATH,
     volumeSizeGb: 10,
   },

package/src/component/lib.test.ts

@@ -4,6 +4,17 @@ import { afterEach, beforeEach, describe, expect, test, vi } from "vitest";
 import { api, internal } from "./_generated/api.js";
 import { initConvexTest } from "./setup.test.js";
 
+const TEST_PROVIDER_CONFIG = {
+  kind: "fly" as const,
+  appName: "agent-factory-workers-test",
+  organizationSlug: "personal",
+  image: "registry.fly.io/agent-factory-workers-test:test-image",
+  region: "iad",
+  volumeName: "openclaw_data_test",
+  volumePath: "/data",
+  volumeSizeGb: 10,
+};
+
 describe("component lib", () => {
   beforeEach(async () => {
     vi.useFakeTimers();
@@ -361,6 +372,7 @@ describe("component lib", () => {
         idleTimeoutMs: 300_000,
         reconcileIntervalMs: 15_000,
       },
+      providerConfig: TEST_PROVIDER_CONFIG,
     });
     expect(reconcile.activeWorkers).toBe(3);
     expect(reconcile.spawned).toBe(0);
@@ -433,16 +445,7 @@ describe("component lib", () => {
         idleTimeoutMs: 300_000,
         reconcileIntervalMs: 15_000,
       },
-      providerConfig: {
-        kind: "fly",
-        appName: "agent-factory-workers",
-        organizationSlug: "personal",
-        image: "registry.fly.io/agent-factory-workers:test-image",
-        region: "iad",
-        volumeName: "",
-        volumePath: "",
-        volumeSizeGb: 10,
-      },
+      providerConfig: TEST_PROVIDER_CONFIG,
     });
     expect(reconcile.activeWorkers).toBe(3);
     expect(reconcile.spawned).toBe(0);

package/src/component/queue.ts

@@ -6,7 +6,7 @@ import {
   mutation,
   query,
 } from "./_generated/server.js";
-import { computeRetryDelayMs, DEFAULT_CONFIG } from "./config.js";
+import { computeRetryDelayMs, DEFAULT_CONFIG, providerConfigValidator } from "./config.js";
 
 const queueStatusValidator = v.union(
   v.literal("queued"),
@@ -79,6 +79,7 @@ export const enqueueMessage = mutation({
     scheduledFor: v.optional(v.number()),
     maxAttempts: v.optional(v.number()),
     nowMs: v.optional(v.number()),
+    providerConfig: v.optional(providerConfigValidator),
   },
   returns: v.id("messageQueue"),
   handler: async (ctx, args) => {
@@ -125,6 +126,7 @@ export const enqueueMessage = mutation({
     try {
       await ctx.scheduler.runAfter(0, (internal.scheduler as any).reconcileWorkerPoolFromEnqueue, {
         workspaceId: "default",
+        providerConfig: args.providerConfig,
       });
     } catch (error) {
       console.warn(

package/src/component/scheduler.ts

@@ -99,7 +99,7 @@ async function runReconcileWorkerPool(
 ) {
   const nowMs = args.nowMs ?? Date.now();
   const scaling = args.scalingPolicy ?? DEFAULT_CONFIG.scaling;
-  const providerConfig = args.providerConfig ?? DEFAULT_CONFIG.provider;
+  const providerConfig = ensureProviderConfig(args.providerConfig ?? DEFAULT_CONFIG.provider);
   const flyApiToken =
     args.flyApiToken ??
     (await ctx.runQuery(internal.queue.getActiveSecretPlaintext, {
@@ -304,7 +304,7 @@ async function runEnforceIdleShutdowns(
   },
 ) {
   const nowMs = args.nowMs ?? Date.now();
-  const providerConfig = args.providerConfig ?? DEFAULT_CONFIG.provider;
+  const providerConfig = ensureProviderConfig(args.providerConfig ?? DEFAULT_CONFIG.provider);
   const flyApiToken =
     args.flyApiToken ??
     (await ctx.runQuery(internal.queue.getActiveSecretPlaintext, {
@@ -431,6 +431,27 @@ function resolveProvider(kind: string, flyApiToken: string): WorkerProvider {
   }
 }
 
+function ensureProviderConfig(providerConfig: typeof DEFAULT_CONFIG.provider) {
+  const requiredFields: Array<
+    "appName" | "organizationSlug" | "image" | "region" | "volumeName" | "volumePath"
+  > = [
+    "appName",
+    "organizationSlug",
+    "image",
+    "region",
+    "volumeName",
+    "volumePath",
+  ];
+  for (const field of requiredFields) {
+    if (!providerConfig[field]?.trim()) {
+      throw new Error(
+        `Missing providerConfig.${field}. Pass providerConfig explicitly when starting/reconciling workers.`,
+      );
+    }
+  }
+  return providerConfig;
+}
+
 function clamp(value: number, min: number, max: number): number {
   return Math.max(min, Math.min(max, value));
 }