@okrlinkhub/agent-factory 3.0.0 → 3.0.1

package/dist/component/messageTemplates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageTemplates.d.ts","sourceRoot":"","sources":["../../src/component/messageTemplates.ts"],"names":[],"mappings":"AAmFA,eAAO,MAAM,qBAAqB;;;;;;;kEA+BhC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;oBAoChC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;oBAWhC,CAAC;AAEH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;KAqCxC,CAAC"}

package/dist/component/messageTemplates.js

@@ -0,0 +1,177 @@
+import { v } from "convex/values";
+import { mutation, query } from "./_generated/server.js";
+const messageTemplateViewValidator = v.object({
+    _id: v.id("messageTemplates"),
+    templateKey: v.string(),
+    title: v.string(),
+    text: v.string(),
+    tags: v.array(v.string()),
+    usageCount: v.number(),
+    enabled: v.boolean(),
+    createdBy: v.string(),
+    updatedBy: v.string(),
+    createdAt: v.number(),
+    updatedAt: v.number(),
+});
+function normalizeTemplateKey(value) {
+    return value.trim().toLowerCase();
+}
+function buildTemplateKeyBase(title) {
+    const normalized = title
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return normalized || "message-template";
+}
+function normalizeTitle(value) {
+    return value.trim();
+}
+function normalizeText(value) {
+    return value.trim();
+}
+function normalizeTags(tags) {
+    return Array.from(new Set(tags
+        .map((tag) => tag.trim().toLowerCase())
+        .filter((tag) => tag.length > 0))).sort((left, right) => left.localeCompare(right));
+}
+function validateMessageTemplateFields(input) {
+    if (input.title !== undefined && input.title.length === 0) {
+        throw new Error("Template title is required");
+    }
+    if (input.text !== undefined && input.text.length === 0) {
+        throw new Error("Template text is required");
+    }
+}
+async function resolveUniqueTemplateKey(ctx, title, currentTemplateId) {
+    const baseKey = buildTemplateKeyBase(title);
+    let candidate = baseKey;
+    let suffix = 2;
+    while (true) {
+        const existing = await ctx.db
+            .query("messageTemplates")
+            .withIndex("by_templateKey", (q) => q.eq("templateKey", candidate))
+            .unique();
+        if (!existing || String(existing._id) === currentTemplateId) {
+            return candidate;
+        }
+        candidate = `${baseKey}-${suffix}`;
+        suffix += 1;
+    }
+}
+export const createMessageTemplate = mutation({
+    args: {
+        title: v.string(),
+        text: v.string(),
+        tags: v.array(v.string()),
+        enabled: v.optional(v.boolean()),
+        actorUserId: v.string(),
+        nowMs: v.optional(v.number()),
+    },
+    returns: v.id("messageTemplates"),
+    handler: async (ctx, args) => {
+        const title = normalizeTitle(args.title);
+        const text = normalizeText(args.text);
+        const tags = normalizeTags(args.tags);
+        validateMessageTemplateFields({ title, text });
+        const templateKey = normalizeTemplateKey(await resolveUniqueTemplateKey(ctx, title));
+        const nowMs = args.nowMs ?? Date.now();
+        return await ctx.db.insert("messageTemplates", {
+            templateKey,
+            title,
+            text,
+            tags,
+            usageCount: 0,
+            enabled: args.enabled ?? true,
+            createdBy: args.actorUserId,
+            updatedBy: args.actorUserId,
+            createdAt: nowMs,
+            updatedAt: nowMs,
+        });
+    },
+});
+export const updateMessageTemplate = mutation({
+    args: {
+        templateId: v.id("messageTemplates"),
+        title: v.optional(v.string()),
+        text: v.optional(v.string()),
+        tags: v.optional(v.array(v.string())),
+        enabled: v.optional(v.boolean()),
+        actorUserId: v.string(),
+        nowMs: v.optional(v.number()),
+    },
+    returns: v.boolean(),
+    handler: async (ctx, args) => {
+        const template = await ctx.db.get(args.templateId);
+        if (!template)
+            return false;
+        const title = args.title !== undefined ? normalizeTitle(args.title) : template.title;
+        const text = args.text !== undefined ? normalizeText(args.text) : template.text;
+        const tags = args.tags !== undefined ? normalizeTags(args.tags) : template.tags;
+        validateMessageTemplateFields({ title, text });
+        const templateKey = title !== template.title
+            ? normalizeTemplateKey(await resolveUniqueTemplateKey(ctx, title, String(template._id)))
+            : template.templateKey;
+        const nowMs = args.nowMs ?? Date.now();
+        await ctx.db.patch(template._id, {
+            templateKey,
+            title,
+            text,
+            tags,
+            enabled: args.enabled ?? template.enabled,
+            updatedBy: args.actorUserId,
+            updatedAt: nowMs,
+        });
+        return true;
+    },
+});
+export const deleteMessageTemplate = mutation({
+    args: {
+        templateId: v.id("messageTemplates"),
+    },
+    returns: v.boolean(),
+    handler: async (ctx, args) => {
+        const template = await ctx.db.get(args.templateId);
+        if (!template)
+            return false;
+        await ctx.db.delete(template._id);
+        return true;
+    },
+});
+export const listMessageTemplatesByCompany = query({
+    args: {
+        includeDisabled: v.optional(v.boolean()),
+        limit: v.optional(v.number()),
+    },
+    returns: v.array(messageTemplateViewValidator),
+    handler: async (ctx, args) => {
+        const includeDisabled = args.includeDisabled ?? false;
+        const limit = Math.max(1, Math.min(args.limit ?? 100, 200));
+        const rows = includeDisabled
+            ? await ctx.db.query("messageTemplates").take(limit)
+            : await ctx.db
+                .query("messageTemplates")
+                .withIndex("by_enabled", (q) => q.eq("enabled", true))
+                .take(limit);
+        rows.sort((left, right) => {
+            if (right.usageCount !== left.usageCount) {
+                return right.usageCount - left.usageCount;
+            }
+            return right.updatedAt - left.updatedAt;
+        });
+        return rows.map((row) => ({
+            _id: row._id,
+            templateKey: row.templateKey,
+            title: row.title,
+            text: row.text,
+            tags: row.tags,
+            usageCount: row.usageCount,
+            enabled: row.enabled,
+            createdBy: row.createdBy,
+            updatedBy: row.updatedBy,
+            createdAt: row.createdAt,
+            updatedAt: row.updatedAt,
+        }));
+    },
+});
+//# sourceMappingURL=messageTemplates.js.map

package/dist/component/messageTemplates.js.map

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

package/dist/component/pushing.d.ts

@@ -2,11 +2,11 @@ import type { Id } from "./_generated/dataModel.js";
 export declare const createPushTemplate: import("convex/server").RegisteredMutation<"public", {
     nowMs?: number | undefined;
     enabled?: boolean | undefined;
-    companyId: string;
-    periodicity: "manual" | "daily" | "weekly" | "monthly";
+    actorUserId: string;
     text: string;
     title: string;
-    actorUserId: string;
+    companyId: string;
+    periodicity: "manual" | "daily" | "weekly" | "monthly";
     suggestedTimes: ({
         kind: "daily";
         time: string;
@@ -24,9 +24,9 @@ export declare const createPushTemplate: import("convex/server").RegisteredMutat
 export declare const updatePushTemplate: import("convex/server").RegisteredMutation<"public", {
     nowMs?: number | undefined;
     enabled?: boolean | undefined;
-    periodicity?: "manual" | "daily" | "weekly" | "monthly" | undefined;
     text?: string | undefined;
     title?: string | undefined;
+    periodicity?: "manual" | "daily" | "weekly" | "monthly" | undefined;
     suggestedTimes?: ({
         kind: "daily";
         time: string;
@@ -39,8 +39,8 @@ export declare const updatePushTemplate: import("convex/server").RegisteredMutat
         time: string;
         dayOfMonth: number | "last";
     })[] | undefined;
-    templateId: import("convex/values").GenericId<"messagePushTemplates">;
     actorUserId: string;
+    templateId: import("convex/values").GenericId<"messagePushTemplates">;
 }, Promise<boolean>>;
 export declare const deletePushTemplate: import("convex/server").RegisteredMutation<"public", {
     templateId: import("convex/values").GenericId<"messagePushTemplates">;
@@ -99,6 +99,8 @@ export declare const createPushJobCustom: import("convex/server").RegisteredMuta
     nowMs?: number | undefined;
     enabled?: boolean | undefined;
     consumerUserId: string;
+    text: string;
+    title: string;
     companyId: string;
     periodicity: "manual" | "daily" | "weekly" | "monthly";
     schedule: {
@@ -115,13 +117,13 @@ export declare const createPushJobCustom: import("convex/server").RegisteredMuta
         time: string;
         dayOfMonth: number | "last";
     };
-    text: string;
     timezone: string;
-    title: string;
 }, Promise<import("convex/values").GenericId<"messagePushJobs">>>;
 export declare const updatePushJob: import("convex/server").RegisteredMutation<"public", {
     nowMs?: number | undefined;
     enabled?: boolean | undefined;
+    text?: string | undefined;
+    title?: string | undefined;
     periodicity?: "manual" | "daily" | "weekly" | "monthly" | undefined;
     schedule?: {
         kind: "manual";
@@ -137,9 +139,7 @@ export declare const updatePushJob: import("convex/server").RegisteredMutation<"
         time: string;
         dayOfMonth: number | "last";
     } | undefined;
-    text?: string | undefined;
     timezone?: string | undefined;
-    title?: string | undefined;
     jobId: import("convex/values").GenericId<"messagePushJobs">;
 }, Promise<boolean>>;
 export declare const deletePushJob: import("convex/server").RegisteredMutation<"public", {
@@ -232,9 +232,9 @@ export declare const sendBroadcastToAllActiveAgents: import("convex/server").Reg
         volumePath: string;
         volumeSizeGb: number;
     } | undefined;
-    companyId: string;
     text: string;
     title: string;
+    companyId: string;
     requestedBy: string;
 }, Promise<{
     broadcastId: import("convex/values").GenericId<"messagePushBroadcasts">;
@@ -316,6 +316,8 @@ export declare const createPushJobCustomForAgent: import("convex/server").Regist
     enabled?: boolean | undefined;
     agentKey: string;
     consumerUserId: string;
+    text: string;
+    title: string;
     companyId: string;
     periodicity: "manual" | "daily" | "weekly" | "monthly";
     schedule: {
@@ -332,13 +334,13 @@ export declare const createPushJobCustomForAgent: import("convex/server").Regist
         time: string;
         dayOfMonth: number | "last";
     };
-    text: string;
     timezone: string;
-    title: string;
 }, Promise<import("convex/values").GenericId<"messagePushJobs">>>;
 export declare const updatePushJobForAgent: import("convex/server").RegisteredMutation<"public", {
     nowMs?: number | undefined;
     enabled?: boolean | undefined;
+    text?: string | undefined;
+    title?: string | undefined;
     periodicity?: "manual" | "daily" | "weekly" | "monthly" | undefined;
     schedule?: {
         kind: "manual";
@@ -354,9 +356,7 @@ export declare const updatePushJobForAgent: import("convex/server").RegisteredMu
         time: string;
         dayOfMonth: number | "last";
     } | undefined;
-    text?: string | undefined;
     timezone?: string | undefined;
-    title?: string | undefined;
     agentKey: string;
     consumerUserId: string;
     jobId: import("convex/values").GenericId<"messagePushJobs">;

package/dist/component/queue.d.ts

@@ -564,6 +564,26 @@ export declare const sendMessageToUserAgent: import("convex/server").RegisteredM
     consumerUserId: string;
     content: string;
 }, Promise<import("convex/values").GenericId<"messageQueue">>>;
+export declare const sendMessageTemplateToUserAgent: import("convex/server").RegisteredMutation<"public", {
+    metadata?: Record<string, string> | undefined;
+    nowMs?: number | undefined;
+    providerConfig?: {
+        appName: string;
+        kind: "fly" | "runpod" | "ecs";
+        organizationSlug: string;
+        image: string;
+        region: string;
+        volumeName: string;
+        volumePath: string;
+        volumeSizeGb: number;
+    } | undefined;
+    agentKey: string;
+    consumerUserId: string;
+    templateId: import("convex/values").GenericId<"messageTemplates">;
+}, Promise<{
+    messageId: import("convex/values").GenericId<"messageQueue">;
+    usageCount: number;
+}>>;
 export declare const listSnapshotsForConversation: import("convex/server").RegisteredQuery<"public", {
     nowMs?: number | undefined;
     limit?: number | undefined;

package/dist/component/queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/component/queue.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/component/queue.ts"],"names":[],"mappings":"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"}

package/dist/component/queue.js

@@ -1640,6 +1640,57 @@ export const sendMessageToUserAgent = mutation({
         });
     },
 });
+export const sendMessageTemplateToUserAgent = mutation({
+    args: {
+        consumerUserId: v.string(),
+        agentKey: v.string(),
+        templateId: v.id("messageTemplates"),
+        metadata: v.optional(v.record(v.string(), v.string())),
+        nowMs: v.optional(v.number()),
+        providerConfig: v.optional(providerConfigValidator),
+    },
+    returns: v.object({
+        messageId: v.id("messageQueue"),
+        usageCount: v.number(),
+    }),
+    handler: async (ctx, args) => {
+        const template = await ctx.db.get(args.templateId);
+        if (!template || !template.enabled) {
+            throw new Error("Message template not found");
+        }
+        const nowMs = args.nowMs ?? Date.now();
+        const target = await resolveConversationTargetForUserAgent(ctx, args.consumerUserId, args.agentKey, true);
+        const providerUserId = target.telegramUserId ?? target.telegramChatId ?? args.consumerUserId;
+        const usageCount = template.usageCount + 1;
+        const messageId = await enqueueMessageRecord(ctx, {
+            conversationId: target.conversationId,
+            agentKey: args.agentKey,
+            payload: {
+                provider: target.provider,
+                providerUserId,
+                messageText: template.text,
+                metadata: {
+                    ...(args.metadata ?? {}),
+                    consumerUserId: args.consumerUserId,
+                    source: "message_template",
+                    templateId: String(template._id),
+                    templateKey: template.templateKey,
+                    ...(target.telegramChatId ? { telegramChatId: target.telegramChatId } : {}),
+                    ...(target.telegramUserId ? { telegramUserId: target.telegramUserId } : {}),
+                },
+            },
+            scheduledFor: nowMs,
+            providerConfig: args.providerConfig,
+        });
+        await ctx.db.patch(template._id, {
+            usageCount,
+        });
+        return {
+            messageId,
+            usageCount,
+        };
+    },
+});
 export const listSnapshotsForConversation = query({
     args: {
         conversationId: v.string(),