@okrlinkhub/agent-factory 0.2.4 → 0.2.5

package/src/component/_generated/component.ts

@@ -288,15 +288,16 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         {
           agentKey: string;
           bridgeConfig?: {
+            appBaseUrlMapJsonSecretRef?: string;
             appKey?: string;
             baseUrl?: string;
             enabled: boolean;
-            appBaseUrlMapJsonSecretRef?: string;
             serviceId?: string;
             serviceKeySecretRef?: string;
           };
           clientMd?: string;
           enabled: boolean;
+          providerUserId?: string;
           secretsRef: Array<string>;
           skills: Array<string>;
           soulMd: string;
@@ -365,6 +366,67 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         },
         Name
       >;
+      createPushJobCustom: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          companyId: string;
+          consumerUserId: string;
+          enabled?: boolean;
+          nowMs?: number;
+          periodicity: "manual" | "daily" | "weekly" | "monthly";
+          schedule:
+            | { kind: "manual" }
+            | { kind: "daily"; time: string }
+            | { kind: "weekly"; time: string; weekday: number }
+            | { dayOfMonth: number | "last"; kind: "monthly"; time: string };
+          text: string;
+          timezone: string;
+          title: string;
+        },
+        string,
+        Name
+      >;
+      createPushJobFromTemplate: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          companyId: string;
+          consumerUserId: string;
+          enabled?: boolean;
+          nowMs?: number;
+          schedule?:
+            | { kind: "manual" }
+            | { kind: "daily"; time: string }
+            | { kind: "weekly"; time: string; weekday: number }
+            | { dayOfMonth: number | "last"; kind: "monthly"; time: string };
+          templateId: string;
+          timezone: string;
+        },
+        string,
+        Name
+      >;
+      createPushTemplate: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          actorUserId: string;
+          companyId: string;
+          enabled?: boolean;
+          nowMs?: number;
+          periodicity: "manual" | "daily" | "weekly" | "monthly";
+          suggestedTimes: Array<
+            | { kind: "daily"; time: string }
+            | { kind: "weekly"; time: string; weekday: number }
+            | { dayOfMonth: number | "last"; kind: "monthly"; time: string }
+          >;
+          templateKey: string;
+          text: string;
+          title: string;
+        },
+        string,
+        Name
+      >;
       deleteFlyVolume: FunctionReference<
         "action",
         "internal",
@@ -372,6 +434,27 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         { message: string; ok: boolean; status: number },
         Name
       >;
+      deletePushJob: FunctionReference<
+        "mutation",
+        "internal",
+        { jobId: string },
+        boolean,
+        Name
+      >;
+      deletePushTemplate: FunctionReference<
+        "mutation",
+        "internal",
+        { templateId: string },
+        boolean,
+        Name
+      >;
+      dispatchDuePushJobs: FunctionReference<
+        "mutation",
+        "internal",
+        { limit?: number; nowMs?: number },
+        { enqueued: number; failed: number; scanned: number; skipped: number },
+        Name
+      >;
       enqueue: FunctionReference<
         "mutation",
         "internal",
@@ -445,9 +528,9 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         null | {
           agentKey: string;
           bridgeRuntimeConfig: null | {
+            appBaseUrlMapJson: null | string;
             appKey: null | string;
             baseUrl: null | string;
-            appBaseUrlMapJson: null | string;
             serviceId: null | string;
             serviceKey: null | string;
             serviceKeySecretRef: null | string;
@@ -542,6 +625,72 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         { secretId: string; secretRef: string; version: number },
         Name
       >;
+      listPushDispatchesByJob: FunctionReference<
+        "query",
+        "internal",
+        { jobId: string; limit?: number },
+        Array<{
+          _id: string;
+          createdAt: number;
+          error: null | string;
+          runKey: string;
+          scheduledFor: number;
+          status: "enqueued" | "skipped" | "failed";
+        }>,
+        Name
+      >;
+      listPushJobsForUser: FunctionReference<
+        "query",
+        "internal",
+        { consumerUserId: string; includeDisabled?: boolean },
+        Array<{
+          _id: string;
+          agentKey: null | string;
+          companyId: string;
+          consumerUserId: string;
+          createdAt: number;
+          enabled: boolean;
+          lastRunAt: null | number;
+          lastRunKey: null | string;
+          nextRunAt: null | number;
+          periodicity: "manual" | "daily" | "weekly" | "monthly";
+          schedule:
+            | { kind: "manual" }
+            | { kind: "daily"; time: string }
+            | { kind: "weekly"; time: string; weekday: number }
+            | { dayOfMonth: number | "last"; kind: "monthly"; time: string };
+          sourceTemplateId: null | string;
+          text: string;
+          timezone: string;
+          title: string;
+          updatedAt: number;
+        }>,
+        Name
+      >;
+      listPushTemplatesByCompany: FunctionReference<
+        "query",
+        "internal",
+        { companyId: string; includeDisabled?: boolean },
+        Array<{
+          _id: string;
+          companyId: string;
+          createdAt: number;
+          createdBy: string;
+          enabled: boolean;
+          periodicity: "manual" | "daily" | "weekly" | "monthly";
+          suggestedTimes: Array<
+            | { kind: "daily"; time: string }
+            | { kind: "weekly"; time: string; weekday: number }
+            | { dayOfMonth: number | "last"; kind: "monthly"; time: string }
+          >;
+          templateKey: string;
+          text: string;
+          title: string;
+          updatedAt: number;
+          updatedBy: string;
+        }>,
+        Name
+      >;
       queueStats: FunctionReference<
         "query",
         "internal",
@@ -617,6 +766,78 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         }>,
         Name
       >;
+      sendBroadcastToAllActiveAgents: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          companyId: string;
+          nowMs?: number;
+          requestedBy: string;
+          text: string;
+          title: string;
+        },
+        {
+          broadcastId: string;
+          enqueued: number;
+          failed: number;
+          totalTargets: number;
+        },
+        Name
+      >;
+      setPushJobEnabled: FunctionReference<
+        "mutation",
+        "internal",
+        { enabled: boolean; jobId: string; nowMs?: number },
+        boolean,
+        Name
+      >;
+      triggerPushJobNow: FunctionReference<
+        "mutation",
+        "internal",
+        { jobId: string; nowMs?: number },
+        { enqueuedMessageId: string; runKey: string },
+        Name
+      >;
+      updatePushJob: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          enabled?: boolean;
+          jobId: string;
+          nowMs?: number;
+          periodicity?: "manual" | "daily" | "weekly" | "monthly";
+          schedule?:
+            | { kind: "manual" }
+            | { kind: "daily"; time: string }
+            | { kind: "weekly"; time: string; weekday: number }
+            | { dayOfMonth: number | "last"; kind: "monthly"; time: string };
+          text?: string;
+          timezone?: string;
+          title?: string;
+        },
+        boolean,
+        Name
+      >;
+      updatePushTemplate: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          actorUserId: string;
+          enabled?: boolean;
+          nowMs?: number;
+          periodicity?: "manual" | "daily" | "weekly" | "monthly";
+          suggestedTimes?: Array<
+            | { kind: "daily"; time: string }
+            | { kind: "weekly"; time: string; weekday: number }
+            | { dayOfMonth: number | "last"; kind: "monthly"; time: string }
+          >;
+          templateId: string;
+          text?: string;
+          title?: string;
+        },
+        boolean,
+        Name
+      >;
       workerStats: FunctionReference<
         "query",
         "internal",
@@ -647,6 +868,228 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         >;
       };
     };
+    pushing: {
+      createPushJobCustom: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          companyId: string;
+          consumerUserId: string;
+          enabled?: boolean;
+          nowMs?: number;
+          periodicity: "manual" | "daily" | "weekly" | "monthly";
+          schedule:
+            | { kind: "manual" }
+            | { kind: "daily"; time: string }
+            | { kind: "weekly"; time: string; weekday: number }
+            | { dayOfMonth: number | "last"; kind: "monthly"; time: string };
+          text: string;
+          timezone: string;
+          title: string;
+        },
+        string,
+        Name
+      >;
+      createPushJobFromTemplate: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          companyId: string;
+          consumerUserId: string;
+          enabled?: boolean;
+          nowMs?: number;
+          schedule?:
+            | { kind: "manual" }
+            | { kind: "daily"; time: string }
+            | { kind: "weekly"; time: string; weekday: number }
+            | { dayOfMonth: number | "last"; kind: "monthly"; time: string };
+          templateId: string;
+          timezone: string;
+        },
+        string,
+        Name
+      >;
+      createPushTemplate: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          actorUserId: string;
+          companyId: string;
+          enabled?: boolean;
+          nowMs?: number;
+          periodicity: "manual" | "daily" | "weekly" | "monthly";
+          suggestedTimes: Array<
+            | { kind: "daily"; time: string }
+            | { kind: "weekly"; time: string; weekday: number }
+            | { dayOfMonth: number | "last"; kind: "monthly"; time: string }
+          >;
+          templateKey: string;
+          text: string;
+          title: string;
+        },
+        string,
+        Name
+      >;
+      deletePushJob: FunctionReference<
+        "mutation",
+        "internal",
+        { jobId: string },
+        boolean,
+        Name
+      >;
+      deletePushTemplate: FunctionReference<
+        "mutation",
+        "internal",
+        { templateId: string },
+        boolean,
+        Name
+      >;
+      dispatchDuePushJobs: FunctionReference<
+        "mutation",
+        "internal",
+        { limit?: number; nowMs?: number },
+        { enqueued: number; failed: number; scanned: number; skipped: number },
+        Name
+      >;
+      listPushDispatchesByJob: FunctionReference<
+        "query",
+        "internal",
+        { jobId: string; limit?: number },
+        Array<{
+          _id: string;
+          createdAt: number;
+          error: null | string;
+          runKey: string;
+          scheduledFor: number;
+          status: "enqueued" | "skipped" | "failed";
+        }>,
+        Name
+      >;
+      listPushJobsForUser: FunctionReference<
+        "query",
+        "internal",
+        { consumerUserId: string; includeDisabled?: boolean },
+        Array<{
+          _id: string;
+          agentKey: null | string;
+          companyId: string;
+          consumerUserId: string;
+          createdAt: number;
+          enabled: boolean;
+          lastRunAt: null | number;
+          lastRunKey: null | string;
+          nextRunAt: null | number;
+          periodicity: "manual" | "daily" | "weekly" | "monthly";
+          schedule:
+            | { kind: "manual" }
+            | { kind: "daily"; time: string }
+            | { kind: "weekly"; time: string; weekday: number }
+            | { dayOfMonth: number | "last"; kind: "monthly"; time: string };
+          sourceTemplateId: null | string;
+          text: string;
+          timezone: string;
+          title: string;
+          updatedAt: number;
+        }>,
+        Name
+      >;
+      listPushTemplatesByCompany: FunctionReference<
+        "query",
+        "internal",
+        { companyId: string; includeDisabled?: boolean },
+        Array<{
+          _id: string;
+          companyId: string;
+          createdAt: number;
+          createdBy: string;
+          enabled: boolean;
+          periodicity: "manual" | "daily" | "weekly" | "monthly";
+          suggestedTimes: Array<
+            | { kind: "daily"; time: string }
+            | { kind: "weekly"; time: string; weekday: number }
+            | { dayOfMonth: number | "last"; kind: "monthly"; time: string }
+          >;
+          templateKey: string;
+          text: string;
+          title: string;
+          updatedAt: number;
+          updatedBy: string;
+        }>,
+        Name
+      >;
+      sendBroadcastToAllActiveAgents: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          companyId: string;
+          nowMs?: number;
+          requestedBy: string;
+          text: string;
+          title: string;
+        },
+        {
+          broadcastId: string;
+          enqueued: number;
+          failed: number;
+          totalTargets: number;
+        },
+        Name
+      >;
+      setPushJobEnabled: FunctionReference<
+        "mutation",
+        "internal",
+        { enabled: boolean; jobId: string; nowMs?: number },
+        boolean,
+        Name
+      >;
+      triggerPushJobNow: FunctionReference<
+        "mutation",
+        "internal",
+        { jobId: string; nowMs?: number },
+        { enqueuedMessageId: string; runKey: string },
+        Name
+      >;
+      updatePushJob: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          enabled?: boolean;
+          jobId: string;
+          nowMs?: number;
+          periodicity?: "manual" | "daily" | "weekly" | "monthly";
+          schedule?:
+            | { kind: "manual" }
+            | { kind: "daily"; time: string }
+            | { kind: "weekly"; time: string; weekday: number }
+            | { dayOfMonth: number | "last"; kind: "monthly"; time: string };
+          text?: string;
+          timezone?: string;
+          title?: string;
+        },
+        boolean,
+        Name
+      >;
+      updatePushTemplate: FunctionReference<
+        "mutation",
+        "internal",
+        {
+          actorUserId: string;
+          enabled?: boolean;
+          nowMs?: number;
+          periodicity?: "manual" | "daily" | "weekly" | "monthly";
+          suggestedTimes?: Array<
+            | { kind: "daily"; time: string }
+            | { kind: "weekly"; time: string; weekday: number }
+            | { dayOfMonth: number | "last"; kind: "monthly"; time: string }
+          >;
+          templateId: string;
+          text?: string;
+          title?: string;
+        },
+        boolean,
+        Name
+      >;
+    };
     queue: {
       appendConversationMessages: FunctionReference<
         "mutation",
@@ -808,9 +1251,9 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         null | {
           agentKey: string;
           bridgeRuntimeConfig: null | {
+            appBaseUrlMapJson: null | string;
             appKey: null | string;
             baseUrl: null | string;
-            appBaseUrlMapJson: null | string;
             serviceId: null | string;
             serviceKey: null | string;
             serviceKeySecretRef: null | string;
@@ -987,15 +1430,16 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
         {
           agentKey: string;
           bridgeConfig?: {
+            appBaseUrlMapJsonSecretRef?: string;
             appKey?: string;
             baseUrl?: string;
             enabled: boolean;
-            appBaseUrlMapJsonSecretRef?: string;
             serviceId?: string;
             serviceKeySecretRef?: string;
           };
           clientMd?: string;
           enabled: boolean;
+          providerUserId?: string;
           secretsRef: Array<string>;
           skills: Array<string>;
           soulMd: string;

package/src/component/lib.test.ts

@@ -456,4 +456,102 @@ describe("component lib", () => {
     expect(reconcile.spawned).toBe(0);
     expect(reconcile.terminated).toBe(0);
   });
+
+  test("push jobs should dispatch scheduled messages and log runs", async () => {
+    const t = initConvexTest();
+    await t.mutation(api.queue.upsertAgentProfile, {
+      agentKey: "push-agent",
+      version: "1.0.0",
+      soulMd: "# Soul",
+      clientMd: "# Client",
+      skills: [],
+      secretsRef: [],
+      enabled: true,
+    });
+    await t.mutation(api.lib.bindUserAgent, {
+      consumerUserId: "user-push-1",
+      agentKey: "push-agent",
+      source: "manual",
+      metadata: { companyId: "co-1" },
+    });
+
+    const baseMs = Date.UTC(2026, 0, 1, 7, 59, 0);
+    const jobId = await t.mutation((api.lib as any).createPushJobCustom, {
+      companyId: "co-1",
+      consumerUserId: "user-push-1",
+      title: "Daily check",
+      text: "Ping automatico",
+      periodicity: "daily",
+      timezone: "UTC",
+      schedule: {
+        kind: "daily",
+        time: "08:00",
+      },
+      nowMs: baseMs,
+    });
+
+    const dispatch = await t.mutation((api.lib as any).dispatchDuePushJobs, {
+      nowMs: baseMs + 6 * 60_000,
+      limit: 50,
+    });
+    expect(dispatch.enqueued).toBe(1);
+    expect(dispatch.failed).toBe(0);
+
+    const queueStats = await t.query(api.lib.queueStats, {});
+    expect(queueStats.queuedReady).toBe(1);
+
+    const jobDispatches = await t.query((api.lib as any).listPushDispatchesByJob, {
+      jobId,
+      limit: 10,
+    });
+    expect(jobDispatches.length).toBe(1);
+    expect(jobDispatches[0].status).toBe("enqueued");
+  });
+
+  test("admin broadcast should enqueue to all active company agents", async () => {
+    const t = initConvexTest();
+    await t.mutation(api.queue.upsertAgentProfile, {
+      agentKey: "broadcast-agent-a",
+      version: "1.0.0",
+      soulMd: "# Soul",
+      clientMd: "# Client",
+      skills: [],
+      secretsRef: [],
+      enabled: true,
+    });
+    await t.mutation(api.queue.upsertAgentProfile, {
+      agentKey: "broadcast-agent-b",
+      version: "1.0.0",
+      soulMd: "# Soul",
+      clientMd: "# Client",
+      skills: [],
+      secretsRef: [],
+      enabled: true,
+    });
+    await t.mutation(api.lib.bindUserAgent, {
+      consumerUserId: "company-user-a",
+      agentKey: "broadcast-agent-a",
+      source: "manual",
+      metadata: { companyId: "company-broadcast" },
+    });
+    await t.mutation(api.lib.bindUserAgent, {
+      consumerUserId: "company-user-b",
+      agentKey: "broadcast-agent-b",
+      source: "manual",
+      metadata: { companyId: "company-broadcast" },
+    });
+
+    const result = await t.mutation((api.lib as any).sendBroadcastToAllActiveAgents, {
+      companyId: "company-broadcast",
+      title: "Aggiornamento policy",
+      text: "Sincronizza le nuove istruzioni",
+      requestedBy: "admin-1",
+    });
+    expect(result.totalTargets).toBe(2);
+    expect(result.enqueued).toBe(2);
+    expect(result.failed).toBe(0);
+
+    const queueStats = await t.query(api.lib.queueStats, {});
+    expect(queueStats.queuedReady).toBe(2);
+  });
 });

package/src/component/lib.ts

@@ -34,3 +34,20 @@ export {
   consumePairingCode,
   getPairingCodeStatus,
 } from "./identity.js";
+
+export {
+  createPushTemplate,
+  updatePushTemplate,
+  deletePushTemplate,
+  listPushTemplatesByCompany,
+  createPushJobFromTemplate,
+  createPushJobCustom,
+  updatePushJob,
+  deletePushJob,
+  setPushJobEnabled,
+  listPushJobsForUser,
+  triggerPushJobNow,
+  dispatchDuePushJobs,
+  sendBroadcastToAllActiveAgents,
+  listPushDispatchesByJob,
+} from "./pushing.js";