@okrlinkhub/agent-factory 0.2.12 → 0.2.14

package/src/component/_generated/component.ts

@@ -260,6 +260,23 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         },
         Name
       >;
+      clearDeprecatedAgentProfileFields: FunctionReference<
+        "mutation",
+        "internal",
+        { dryRun?: boolean },
+        {
+          clearedClientMd: number;
+          clearedProviderUserId: number;
+          clearedSkills: number;
+          clearedSoulMd: number;
+          dryRun: boolean;
+          scanned: number;
+          unchanged: number;
+          updated: number;
+          updatedAgentKeys: Array<string>;
+        },
+        Name
+      >;
       complete: FunctionReference<
         "mutation",
         "internal",
@@ -299,8 +316,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
           enabled: boolean;
           providerUserId?: string;
           secretsRef: Array<string>;
-          skills: Array<string>;
-          soulMd: string;
+          skills?: Array<string>;
+          soulMd?: string;
           version: string;
         },
         string,
@@ -704,6 +721,13 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         }>,
         Name
       >;
+      messageRuntimeConfig: FunctionReference<
+        "query",
+        "internal",
+        {},
+        null | { systemPrompt?: string },
+        Name
+      >;
       providerRuntimeConfig: FunctionReference<
         "query",
         "internal",
@@ -823,6 +847,13 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         },
         Name
       >;
+      setMessageRuntimeConfig: FunctionReference<
+        "mutation",
+        "internal",
+        { messageConfig: { systemPrompt?: string }; nowMs?: number },
+        null,
+        Name
+      >;
       setProviderRuntimeConfig: FunctionReference<
         "mutation",
         "internal",
@@ -1242,6 +1273,23 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         },
         Name
       >;
+      clearDeprecatedAgentProfileFields: FunctionReference<
+        "mutation",
+        "internal",
+        { dryRun?: boolean },
+        {
+          clearedClientMd: number;
+          clearedProviderUserId: number;
+          clearedSkills: number;
+          clearedSoulMd: number;
+          dryRun: boolean;
+          scanned: number;
+          unchanged: number;
+          updated: number;
+          updatedAgentKeys: Array<string>;
+        },
+        Name
+      >;
       completeJob: FunctionReference<
         "mutation",
         "internal",
@@ -1264,6 +1312,44 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         boolean,
         Name
       >;
+      deleteGlobalSkill: FunctionReference<
+        "mutation",
+        "internal",
+        { slug: string },
+        {
+          deleted: boolean;
+          deletedReleases: number;
+          deletedVersions: number;
+          slug: string;
+        },
+        Name
+      >;
+      deployGlobalSkill: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          actor?: string;
+          description?: string;
+          displayName?: string;
+          entryPoint?: string;
+          moduleFormat?: "esm" | "cjs";
+          nowMs?: number;
+          releaseChannel?: "stable" | "canary";
+          slug: string;
+          sourceJs: string;
+          version: string;
+        },
+        {
+          releaseChannel: "stable" | "canary";
+          releaseId: string;
+          sha256: string;
+          skillId: string;
+          slug: string;
+          version: string;
+          versionId: string;
+        },
+        Name
+      >;
       enqueueMessage: FunctionReference<
         "mutation",
         "internal",
@@ -1441,6 +1527,30 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         { shouldStop: boolean },
         Name
       >;
+      getWorkerGlobalSkillsManifest: FunctionReference<
+        "query",
+        "internal",
+        {
+          releaseChannel?: "stable" | "canary";
+          workerId?: string;
+          workspaceId?: string;
+        },
+        {
+          generatedAt: number;
+          manifestVersion: string;
+          releaseChannel: "stable" | "canary";
+          skills: Array<{
+            entryPoint: string;
+            moduleFormat: "esm" | "cjs";
+            sha256: string;
+            slug: string;
+            sourceJs: string;
+            version: string;
+          }>;
+          workspaceId: string;
+        },
+        Name
+      >;
       getWorkerStats: FunctionReference<
         "query",
         "internal",
@@ -1489,6 +1599,34 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         { secretId: string; secretRef: string; version: number },
         Name
       >;
+      listGlobalSkills: FunctionReference<
+        "query",
+        "internal",
+        {
+          limit?: number;
+          releaseChannel?: "stable" | "canary";
+          status?: "active" | "disabled";
+        },
+        Array<{
+          activeRelease: null | {
+            activatedAt: number;
+            entryPoint: string;
+            moduleFormat: "esm" | "cjs";
+            releaseChannel: "stable" | "canary";
+            releaseId: string;
+            sha256: string;
+            version: string;
+            versionId: string;
+          };
+          description?: string;
+          displayName: string;
+          skillId: string;
+          slug: string;
+          status: "active" | "disabled";
+          updatedAt: number;
+        }>,
+        Name
+      >;
       listJobsByStatus: FunctionReference<
         "query",
         "internal",
@@ -1510,6 +1648,13 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         }>,
         Name
       >;
+      messageRuntimeConfig: FunctionReference<
+        "query",
+        "internal",
+        {},
+        null | { systemPrompt?: string },
+        Name
+      >;
       prepareDataSnapshotUpload: FunctionReference<
         "mutation",
         "internal",
@@ -1547,6 +1692,25 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         { requeued: number; unlocked: number },
         Name
       >;
+      setGlobalSkillStatus: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          actor?: string;
+          nowMs?: number;
+          slug: string;
+          status: "active" | "disabled";
+        },
+        { slug: string; status: "active" | "disabled"; updated: boolean },
+        Name
+      >;
+      setMessageRuntimeConfig: FunctionReference<
+        "mutation",
+        "internal",
+        { messageConfig: { systemPrompt?: string }; nowMs?: number },
+        null,
+        Name
+      >;
       setProviderRuntimeConfig: FunctionReference<
         "mutation",
         "internal",
@@ -1583,8 +1747,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
           enabled: boolean;
           providerUserId?: string;
           secretsRef: Array<string>;
-          skills: Array<string>;
-          soulMd: string;
+          skills?: Array<string>;
+          soulMd?: string;
           version: string;
         },
         string,

package/src/component/config.ts

@@ -77,6 +77,11 @@ export const DEFAULT_WORKER_RUNTIME_ENV: Record<string, string> = {
   OPENCLAW_GATEWAY_READY_TIMEOUT_MS: "60000",
   OPENCLAW_GATEWAY_READY_POLL_MS: "500",
   OPENCLAW_GATEWAY_READY_REQUIRED: "true",
+  SKILLS_BOOTSTRAP_MODE: "db_manifest",
+  SKILLS_BOOTSTRAP_REQUIRED: "false",
+  SKILLS_BOOTSTRAP_TIMEOUT_MS: "15000",
+  SKILLS_RELEASE_CHANNEL: "stable",
+  OPENCLAW_SKILLS_DIR: "/data/workspace/skills",
 };
 
 export const queuePolicyValidator = v.object({

package/src/component/lib.test.ts

@@ -52,6 +52,181 @@ describe("component lib", () => {
     expect(claimed?.conversationId).toBe("telegram:chat:1");
   });
 
+  test("minimal agent profile should work when payload provides providerUserId", async () => {
+    const t = initConvexTest();
+    await t.mutation(api.queue.upsertAgentProfile, {
+      agentKey: "minimal-agent",
+      version: "1.0.0",
+      secretsRef: [],
+      enabled: true,
+    });
+
+    const messageId = await t.mutation(api.lib.enqueue, {
+      conversationId: "telegram:chat:minimal",
+      agentKey: "minimal-agent",
+      payload: {
+        provider: "telegram",
+        providerUserId: "u-minimal-1",
+        messageText: "hello",
+      },
+    });
+
+    const claim = await t.mutation(api.lib.claim, {
+      workerId: "worker-minimal-1",
+    });
+    expect(claim?.messageId).toBe(messageId);
+    expect(claim?.payload.providerUserId).toBe("u-minimal-1");
+
+    const bundle = await t.query(api.lib.getHydrationBundle, {
+      messageId,
+      workspaceId: "default",
+    });
+    expect(bundle).not.toBeNull();
+    expect(bundle?.payload.providerUserId).toBe("u-minimal-1");
+    expect(bundle?.bridgeRuntimeConfig).toBeNull();
+  });
+
+  test("enqueue should append global system prompt to queued message", async () => {
+    const t = initConvexTest();
+    await t.mutation(api.queue.upsertAgentProfile, {
+      agentKey: "system-prompt-agent",
+      version: "1.0.0",
+      secretsRef: [],
+      enabled: true,
+    });
+    await t.mutation(api.lib.setMessageRuntimeConfig, {
+      messageConfig: {
+        systemPrompt: "  Rispondi sempre con un breve riassunto finale.  ",
+      },
+    });
+
+    const storedMessageConfig = await t.query(api.lib.messageRuntimeConfig, {});
+    expect(storedMessageConfig).toEqual({
+      systemPrompt: "Rispondi sempre con un breve riassunto finale.",
+    });
+
+    const messageId = await t.mutation(api.lib.enqueue, {
+      conversationId: "telegram:chat:system-prompt",
+      agentKey: "system-prompt-agent",
+      payload: {
+        provider: "telegram",
+        providerUserId: "u-system-prompt-1",
+        messageText: "Come va?",
+      },
+    });
+
+    const claim = await t.mutation(api.lib.claim, {
+      workerId: "worker-system-prompt-1",
+    });
+    expect(claim?.messageId).toBe(messageId);
+    expect(claim?.payload.messageText).toBe(
+      "Come va?\n\nRispondi sempre con un breve riassunto finale.",
+    );
+  });
+
+  test("blank global system prompt should not modify queued messages", async () => {
+    const t = initConvexTest();
+    await t.mutation(api.queue.upsertAgentProfile, {
+      agentKey: "blank-system-prompt-agent",
+      version: "1.0.0",
+      secretsRef: [],
+      enabled: true,
+    });
+    await t.mutation(api.lib.setMessageRuntimeConfig, {
+      messageConfig: {
+        systemPrompt: "   ",
+      },
+    });
+
+    const storedMessageConfig = await t.query(api.lib.messageRuntimeConfig, {});
+    expect(storedMessageConfig).toBeNull();
+
+    const messageId = await t.mutation(api.lib.enqueue, {
+      conversationId: "telegram:chat:blank-system-prompt",
+      agentKey: "blank-system-prompt-agent",
+      payload: {
+        provider: "telegram",
+        providerUserId: "u-blank-system-prompt-1",
+        messageText: "hello",
+      },
+    });
+
+    const claim = await t.mutation(api.lib.claim, {
+      workerId: "worker-blank-system-prompt-1",
+    });
+    expect(claim?.messageId).toBe(messageId);
+    expect(claim?.payload.messageText).toBe("hello");
+  });
+
+  test("enqueue should fail when providerUserId is blank in both profile and payload", async () => {
+    const t = initConvexTest();
+    await t.mutation(api.queue.upsertAgentProfile, {
+      agentKey: "missing-provider-user-agent",
+      version: "1.0.0",
+      providerUserId: "   ",
+      secretsRef: [],
+      enabled: true,
+    });
+
+    await expect(
+      t.mutation(api.queue.enqueueMessage, {
+        conversationId: "telegram:chat:missing-provider-user",
+        agentKey: "missing-provider-user-agent",
+        payload: {
+          provider: "telegram",
+          providerUserId: "   ",
+          messageText: "hello",
+        },
+      }),
+    ).rejects.toThrow("providerUserId is required but missing");
+  });
+
+  test("clearDeprecatedAgentProfileFields should remove deprecated profile fields", async () => {
+    const t = initConvexTest();
+    await t.mutation(api.queue.upsertAgentProfile, {
+      agentKey: "cleanup-agent",
+      version: "1.0.0",
+      providerUserId: "legacy-user-1",
+      soulMd: "# Legacy Soul",
+      clientMd: "# Legacy Client",
+      skills: ["agent-bridge"],
+      secretsRef: [],
+      enabled: true,
+    });
+    await t.mutation(api.queue.upsertAgentProfile, {
+      agentKey: "already-clean-agent",
+      version: "1.0.0",
+      secretsRef: [],
+      enabled: true,
+    });
+
+    const dryRun = await t.mutation((api.lib as any).clearDeprecatedAgentProfileFields, {
+      dryRun: true,
+    });
+    expect(dryRun.dryRun).toBe(true);
+    expect(dryRun.scanned).toBe(2);
+    expect(dryRun.updated).toBe(1);
+    expect(dryRun.unchanged).toBe(1);
+    expect(dryRun.clearedProviderUserId).toBe(1);
+    expect(dryRun.clearedSoulMd).toBe(1);
+    expect(dryRun.clearedClientMd).toBe(1);
+    expect(dryRun.clearedSkills).toBe(1);
+    expect(dryRun.updatedAgentKeys).toEqual(["cleanup-agent"]);
+
+    const cleanup = await t.mutation((api.lib as any).clearDeprecatedAgentProfileFields, {});
+    expect(cleanup.dryRun).toBe(false);
+    expect(cleanup.updated).toBe(1);
+    expect(cleanup.updatedAgentKeys).toEqual(["cleanup-agent"]);
+
+    const secondPass = await t.mutation((api.lib as any).clearDeprecatedAgentProfileFields, {});
+    expect(secondPass.updated).toBe(0);
+    expect(secondPass.unchanged).toBe(2);
+    expect(secondPass.clearedProviderUserId).toBe(0);
+    expect(secondPass.clearedSoulMd).toBe(0);
+    expect(secondPass.clearedClientMd).toBe(0);
+    expect(secondPass.clearedSkills).toBe(0);
+  });
+
   test("identity binding should resolve, rebind and revoke", async () => {
     const t = initConvexTest();
     await t.mutation(api.queue.upsertAgentProfile, {

package/src/component/lib.ts

@@ -1,9 +1,12 @@
 export {
   upsertAgentProfile as configureAgent,
+  clearDeprecatedAgentProfileFields,
   importPlaintextSecret as importSecret,
   getSecretsStatus as secretStatus,
   providerRuntimeConfig,
   setProviderRuntimeConfig,
+  messageRuntimeConfig,
+  setMessageRuntimeConfig,
   enqueueMessage as enqueue,
   releaseStuckJobs,
   appendConversationMessages,