@okrlinkhub/agent-factory 0.2.11 → 0.2.12

package/dist/client/index.d.ts

@@ -0,0 +1,516 @@
+import type { Auth, HttpRouter } from "convex/server";
+import type { ComponentApi } from "../component/_generated/component.js";
+import { type ProviderConfig } from "../component/config.js";
+export { bridgeFunctionKeyFromToolName, executeBridgeFunction, isBridgeToolName, maybeExecuteBridgeToolCall, resolveBridgeRuntimeConfig, type BridgeExecutionResult, type HydratedBridgeRuntimeConfig, type ResolvedBridgeRuntimeConfig, } from "./bridge.js";
+export declare function exposeApi(component: ComponentApi, options: {
+    auth: (ctx: {
+        auth: Auth;
+    }, operation: {
+        type: "read";
+    } | {
+        type: "write";
+        conversationId?: string;
+        agentKey?: string;
+    }) => Promise<string>;
+    providerConfig?: ProviderConfig;
+}): {
+    queueStats: import("convex/server").RegisteredQuery<"public", {}, Promise<{
+        deadLetter: number;
+        processing: number;
+        queuedReady: number;
+    }>>;
+    getProviderRuntimeConfig: import("convex/server").RegisteredQuery<"public", {}, Promise<any>>;
+    setProviderRuntimeConfig: import("convex/server").RegisteredMutation<"public", {
+        providerConfig: {
+            appName: string;
+            kind: "fly" | "runpod" | "ecs";
+            organizationSlug: string;
+            image: string;
+            region: string;
+            volumeName: string;
+            volumePath: string;
+            volumeSizeGb: number;
+        };
+    }, Promise<null>>;
+    enqueue: import("convex/server").RegisteredMutation<"public", {
+        metadata?: Record<string, string> | undefined;
+        providerConfig?: {
+            appName: string;
+            kind: "fly" | "runpod" | "ecs";
+            organizationSlug: string;
+            image: string;
+            region: string;
+            volumeName: string;
+            volumePath: string;
+            volumeSizeGb: number;
+        } | undefined;
+        priority?: number | undefined;
+        externalMessageId?: string | undefined;
+        rawUpdateJson?: string | undefined;
+        agentKey: string;
+        conversationId: string;
+        providerUserId: string;
+        provider: string;
+        messageText: string;
+    }, Promise<string>>;
+    workerStats: import("convex/server").RegisteredQuery<"public", {}, Promise<{
+        activeCount: number;
+        idleCount: number;
+        workers: Array<{
+            appName: null | string;
+            heartbeatAt: number;
+            load: number;
+            machineId: null | string;
+            status: "active" | "stopped";
+            workerId: string;
+        }>;
+    }>>;
+    workerClaim: import("convex/server").RegisteredMutation<"public", {
+        conversationId?: string | undefined;
+        workerId: string;
+    }, Promise<{
+        agentKey: string;
+        conversationId: string;
+        leaseExpiresAt: number;
+        leaseId: string;
+        messageId: string;
+        payload: {
+            externalMessageId?: string;
+            messageText: string;
+            metadata?: Record<string, string>;
+            provider: string;
+            providerUserId: string;
+            rawUpdateJson?: string;
+        };
+    } | null>>;
+    workerHeartbeat: import("convex/server").RegisteredMutation<"public", {
+        messageId: string;
+        workerId: string;
+        leaseId: string;
+    }, Promise<boolean>>;
+    workerComplete: import("convex/server").RegisteredMutation<"public", {
+        messageId: string;
+        workerId: string;
+        leaseId: string;
+    }, Promise<boolean>>;
+    workerFail: import("convex/server").RegisteredMutation<"public", {
+        messageId: string;
+        workerId: string;
+        leaseId: string;
+        errorMessage: string;
+    }, Promise<{
+        deadLettered: boolean;
+        nextScheduledFor: null | number;
+        requeued: boolean;
+    }>>;
+    workerHydrationBundle: import("convex/server").RegisteredQuery<"public", {
+        workspaceId: string;
+        messageId: string;
+    }, Promise<{
+        agentKey: string;
+        bridgeRuntimeConfig: null | {
+            appBaseUrlMapJson: null | string;
+            appKey: null | string;
+            baseUrl: null | string;
+            serviceId: null | string;
+            serviceKey: null | string;
+            serviceKeySecretRef: null | string;
+        };
+        conversationId: string;
+        conversationState: {
+            contextHistory: Array<{
+                at: number;
+                content: string;
+                role: "system" | "user" | "assistant" | "tool";
+            }>;
+            pendingToolCalls: Array<{
+                callId: string;
+                status: "pending" | "running" | "done" | "failed";
+                toolName: string;
+            }>;
+        };
+        messageId: string;
+        payload: {
+            externalMessageId?: string;
+            messageText: string;
+            metadata?: Record<string, string>;
+            provider: string;
+            providerUserId: string;
+            rawUpdateJson?: string;
+        };
+        telegramBotToken: null | string;
+    } | null>>;
+    workerConversationHasQueued: import("convex/server").RegisteredQuery<"public", {
+        conversationId: string;
+    }, Promise<boolean>>;
+    workerAppendConversationMessages: import("convex/server").RegisteredMutation<"public", {
+        workspaceId?: string | undefined;
+        conversationId: string;
+        messages: {
+            at?: number | undefined;
+            role: "system" | "user" | "assistant" | "tool";
+            content: string;
+        }[];
+    }, Promise<{
+        messageCount: number;
+        updated: boolean;
+    }>>;
+    workerControlState: import("convex/server").RegisteredQuery<"public", {
+        workerId: string;
+    }, Promise<any>>;
+    workerPrepareSnapshotUpload: import("convex/server").RegisteredMutation<"public", {
+        conversationId?: string | undefined;
+        agentKey: string;
+        workspaceId: string;
+        workerId: string;
+        reason: "manual" | "drain" | "signal";
+    }, Promise<any>>;
+    workerFinalizeSnapshotUpload: import("convex/server").RegisteredMutation<"public", {
+        workerId: string;
+        storageId: string;
+        snapshotId: string;
+        sha256: string;
+        sizeBytes: number;
+    }, Promise<any>>;
+    workerFailSnapshotUpload: import("convex/server").RegisteredMutation<"public", {
+        error: string;
+        workerId: string;
+        snapshotId: string;
+    }, Promise<any>>;
+    workerLatestSnapshotForRestore: import("convex/server").RegisteredQuery<"public", {
+        conversationId?: string | undefined;
+        agentKey: string;
+        workspaceId: string;
+    }, Promise<any>>;
+    workerGenerateMediaUploadUrl: import("convex/server").RegisteredMutation<"public", {}, Promise<any>>;
+    workerGetStorageFileUrl: import("convex/server").RegisteredQuery<"public", {
+        storageId: string;
+    }, Promise<any>>;
+    workerAttachMessageMetadata: import("convex/server").RegisteredMutation<"public", {
+        metadata: Record<string, string>;
+        messageId: string;
+    }, Promise<any>>;
+    seedDefaultAgent: import("convex/server").RegisteredMutation<"public", {}, Promise<string>>;
+    importSecret: import("convex/server").RegisteredMutation<"public", {
+        metadata?: Record<string, string> | undefined;
+        secretRef: string;
+        plaintextValue: string;
+    }, Promise<{
+        secretId: string;
+        secretRef: string;
+        version: number;
+    }>>;
+    secretStatus: import("convex/server").RegisteredQuery<"public", {
+        secretRefs: string[];
+    }, Promise<{
+        hasActive: boolean;
+        secretRef: string;
+        version: null | number;
+    }[]>>;
+    startWorkers: import("convex/server").RegisteredAction<"public", {
+        workspaceId?: string | undefined;
+        flyApiToken?: string | undefined;
+        convexUrl?: string | undefined;
+        scalingPolicy?: {
+            maxWorkers: number;
+            queuePerWorkerTarget: number;
+            spawnStep: number;
+            idleTimeoutMs: number;
+            reconcileIntervalMs: number;
+        } | undefined;
+    }, Promise<{
+        activeWorkers: number;
+        spawned: number;
+        terminated: number;
+    }>>;
+    checkIdleShutdowns: import("convex/server").RegisteredAction<"public", {
+        flyApiToken?: string | undefined;
+    }, Promise<any>>;
+    deleteFlyVolume: import("convex/server").RegisteredAction<"public", {
+        flyApiToken?: string | undefined;
+        appName: string;
+        volumeId: string;
+    }, Promise<any>>;
+    recoverQueue: import("convex/server").RegisteredAction<"public", {
+        nowMs?: number | undefined;
+        workspaceId?: string | undefined;
+        scalingPolicy?: {
+            maxWorkers: number;
+            queuePerWorkerTarget: number;
+            spawnStep: number;
+            idleTimeoutMs: number;
+            reconcileIntervalMs: number;
+        } | undefined;
+        releaseLimit?: number | undefined;
+    }, Promise<{
+        released: {
+            requeued: number;
+            unlocked: number;
+        };
+        reconcile: {
+            activeWorkers: number;
+            spawned: number;
+            terminated: number;
+        };
+    }>>;
+    bindUserAgent: import("convex/server").RegisteredMutation<"public", {
+        metadata?: Record<string, string> | undefined;
+        source?: "manual" | "telegram_pairing" | "api" | undefined;
+        telegramChatId?: string | undefined;
+        telegramUserId?: string | undefined;
+        agentKey: string;
+        consumerUserId: string;
+    }, Promise<{
+        agentKey: string;
+        boundAt: number;
+        consumerUserId: string;
+        metadata: null | Record<string, string>;
+        revokedAt: null | number;
+        source: "manual" | "telegram_pairing" | "api";
+        status: "active" | "revoked";
+        telegramChatId: null | string;
+        telegramUserId: null | string;
+    }>>;
+    revokeUserAgentBinding: import("convex/server").RegisteredMutation<"public", {
+        consumerUserId: string;
+    }, Promise<{
+        revoked: number;
+    }>>;
+    myAgentKey: import("convex/server").RegisteredQuery<"public", {
+        consumerUserId?: string | undefined;
+    }, Promise<{
+        agentKey: null | string;
+        consumerUserId: string;
+    }>>;
+    getUserAgentBinding: import("convex/server").RegisteredQuery<"public", {
+        consumerUserId: string;
+    }, Promise<{
+        agentKey: string;
+        boundAt: number;
+        consumerUserId: string;
+        metadata: null | Record<string, string>;
+        revokedAt: null | number;
+        source: "manual" | "telegram_pairing" | "api";
+        status: "active" | "revoked";
+        telegramChatId: null | string;
+        telegramUserId: null | string;
+    } | null>>;
+    resolveAgentForTelegram: import("convex/server").RegisteredQuery<"public", {
+        telegramChatId?: string | undefined;
+        telegramUserId?: string | undefined;
+    }, Promise<{
+        agentKey: null | string;
+        consumerUserId: null | string;
+    }>>;
+    createPairingCode: import("convex/server").RegisteredMutation<"public", {
+        ttlMs?: number | undefined;
+        agentKey: string;
+        consumerUserId: string;
+    }, Promise<{
+        agentKey: string;
+        code: string;
+        consumerUserId: string;
+        createdAt: number;
+        expiresAt: number;
+        status: "pending" | "used" | "expired";
+        telegramChatId: null | string;
+        telegramUserId: null | string;
+        usedAt: null | number;
+    }>>;
+    consumePairingCode: import("convex/server").RegisteredMutation<"public", {
+        telegramChatId: string;
+        telegramUserId: string;
+        code: string;
+    }, Promise<{
+        agentKey: string;
+        code: string;
+        consumerUserId: string;
+        createdAt: number;
+        expiresAt: number;
+        status: "pending" | "used" | "expired";
+        telegramChatId: null | string;
+        telegramUserId: null | string;
+        usedAt: null | number;
+    }>>;
+    getPairingCodeStatus: import("convex/server").RegisteredQuery<"public", {
+        code: string;
+    }, Promise<{
+        agentKey: string;
+        code: string;
+        consumerUserId: string;
+        createdAt: number;
+        expiresAt: number;
+        status: "pending" | "used" | "expired";
+        telegramChatId: null | string;
+        telegramUserId: null | string;
+        usedAt: null | number;
+    } | null>>;
+    configureTelegramWebhook: import("convex/server").RegisteredAction<"public", {
+        secretRef?: string | undefined;
+        convexSiteUrl: string;
+    }, Promise<{
+        currentUrl: null | string;
+        description: string;
+        isReady: boolean;
+        lastErrorDate: null | number;
+        lastErrorMessage: null | string;
+        ok: boolean;
+        pendingUpdateCount: number;
+        webhookUrl: string;
+    }>>;
+    createPushTemplate: import("convex/server").RegisteredMutation<"public", {
+        enabled?: boolean | undefined;
+        companyId: string;
+        periodicity: "manual" | "daily" | "weekly" | "monthly";
+        text: string;
+        title: string;
+        actorUserId: string;
+        suggestedTimes: ({
+            kind: "daily";
+            time: string;
+        } | {
+            kind: "weekly";
+            time: string;
+            weekday: number;
+        } | {
+            kind: "monthly";
+            time: string;
+            dayOfMonth: number | "last";
+        })[];
+        templateKey: string;
+    }, Promise<any>>;
+    updatePushTemplate: import("convex/server").RegisteredMutation<"public", {
+        enabled?: boolean | undefined;
+        periodicity?: "manual" | "daily" | "weekly" | "monthly" | undefined;
+        text?: string | undefined;
+        title?: string | undefined;
+        suggestedTimes?: ({
+            kind: "daily";
+            time: string;
+        } | {
+            kind: "weekly";
+            time: string;
+            weekday: number;
+        } | {
+            kind: "monthly";
+            time: string;
+            dayOfMonth: number | "last";
+        })[] | undefined;
+        templateId: string;
+        actorUserId: string;
+    }, Promise<any>>;
+    deletePushTemplate: import("convex/server").RegisteredMutation<"public", {
+        templateId: string;
+    }, Promise<any>>;
+    listPushTemplatesByCompany: import("convex/server").RegisteredQuery<"public", {
+        includeDisabled?: boolean | undefined;
+        companyId: string;
+    }, Promise<any>>;
+    createPushJobFromTemplate: import("convex/server").RegisteredMutation<"public", {
+        enabled?: boolean | undefined;
+        schedule?: {
+            kind: "manual";
+        } | {
+            kind: "daily";
+            time: string;
+        } | {
+            kind: "weekly";
+            time: string;
+            weekday: number;
+        } | {
+            kind: "monthly";
+            time: string;
+            dayOfMonth: number | "last";
+        } | undefined;
+        consumerUserId: string;
+        companyId: string;
+        timezone: string;
+        templateId: string;
+    }, Promise<any>>;
+    createPushJobCustom: import("convex/server").RegisteredMutation<"public", {
+        enabled?: boolean | undefined;
+        consumerUserId: string;
+        companyId: string;
+        periodicity: "manual" | "daily" | "weekly" | "monthly";
+        schedule: {
+            kind: "manual";
+        } | {
+            kind: "daily";
+            time: string;
+        } | {
+            kind: "weekly";
+            time: string;
+            weekday: number;
+        } | {
+            kind: "monthly";
+            time: string;
+            dayOfMonth: number | "last";
+        };
+        text: string;
+        timezone: string;
+        title: string;
+    }, Promise<any>>;
+    updatePushJob: import("convex/server").RegisteredMutation<"public", {
+        enabled?: boolean | undefined;
+        periodicity?: "manual" | "daily" | "weekly" | "monthly" | undefined;
+        schedule?: {
+            kind: "manual";
+        } | {
+            kind: "daily";
+            time: string;
+        } | {
+            kind: "weekly";
+            time: string;
+            weekday: number;
+        } | {
+            kind: "monthly";
+            time: string;
+            dayOfMonth: number | "last";
+        } | undefined;
+        text?: string | undefined;
+        timezone?: string | undefined;
+        title?: string | undefined;
+        jobId: string;
+    }, Promise<any>>;
+    deletePushJob: import("convex/server").RegisteredMutation<"public", {
+        jobId: string;
+    }, Promise<any>>;
+    setPushJobEnabled: import("convex/server").RegisteredMutation<"public", {
+        enabled: boolean;
+        jobId: string;
+    }, Promise<any>>;
+    listPushJobsForUser: import("convex/server").RegisteredQuery<"public", {
+        includeDisabled?: boolean | undefined;
+        consumerUserId: string;
+    }, Promise<any>>;
+    triggerPushJobNow: import("convex/server").RegisteredMutation<"public", {
+        jobId: string;
+    }, Promise<any>>;
+    dispatchDuePushJobs: import("convex/server").RegisteredMutation<"public", {
+        nowMs?: number | undefined;
+        limit?: number | undefined;
+    }, Promise<any>>;
+    sendBroadcastToAllActiveAgents: import("convex/server").RegisteredMutation<"public", {
+        companyId: string;
+        text: string;
+        title: string;
+        requestedBy: string;
+    }, Promise<any>>;
+    listPushDispatchesByJob: import("convex/server").RegisteredQuery<"public", {
+        limit?: number | undefined;
+        jobId: string;
+    }, Promise<any>>;
+};
+/**
+ * Register a Telegram webhook ingress route.
+ * The route only enqueues jobs in Convex and does not process messages.
+ */
+export declare function registerRoutes(http: HttpRouter, component: ComponentApi, { pathPrefix, resolveAgentKey, resolveAgentKeyFromBinding, fallbackAgentKey, requireBindingForTelegram, providerConfig, }?: {
+    pathPrefix?: string;
+    resolveAgentKey?: (update: unknown) => string;
+    resolveAgentKeyFromBinding?: boolean;
+    fallbackAgentKey?: string;
+    requireBindingForTelegram?: boolean;
+    providerConfig?: ProviderConfig;
+}): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AA6ChC,OAAO,EACL,6BAA6B,EAC7B,qBAAqB,EACrB,gBAAgB,EAChB,0BAA0B,EAC1B,0BAA0B,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,GACjC,MAAM,aAAa,CAAC;AAErB,wBAAgB,SAAS,CACvB,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE;IACP,IAAI,EAAE,CACJ,GAAG,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,EACnB,SAAS,EACL;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAChB;QACE,IAAI,EAAE,OAAO,CAAC;QACd,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,KACF,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAszBwoK,CAAC;;oBAA+D,CAAC;;;yBAAqH,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAyxH,CAAC;;oBAA+D,CAAC;;;yBAAqH,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA5MjxS;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,YAAY,EACvB,EACE,UAA6B,EAC7B,eAAe,EACf,0BAAiC,EACjC,gBAA4B,EAC5B,yBAAiC,EACjC,cAAc,GACf,GAAE;IACD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC;IAC9C,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC5B,QA+KP"}