@asyncify-hq/node 0.1.0 → 0.2.0

package/dist/index.cjs

@@ -65,7 +65,67 @@ var AsyncifyClient = class {
     list: () => this.request("GET", "/v1/workflows")
   };
   subscribers = {
-    upsert: (subscriber) => this.request("PUT", "/v1/subscribers", subscriber)
+    upsert: (subscriber) => this.request("PUT", "/v1/subscribers", subscriber),
+    /** Channel identities linked to this subscriber (telegram, email). */
+    identities: (subscriberId) => this.request("GET", `/v1/subscribers/${encodeURIComponent(subscriberId)}/identities`),
+    /** Drop a linked identity — future messages fall back to a channel-local one. */
+    unlink: (subscriberId, identity) => this.request(
+      "DELETE",
+      `/v1/subscribers/${encodeURIComponent(subscriberId)}/identities`,
+      identity
+    )
+  };
+  agents = {
+    /** Create an agent. The signing secret is returned EXACTLY ONCE — store it. */
+    create: (options) => this.request("POST", "/v1/agents", options),
+    list: () => this.request("GET", "/v1/agents"),
+    get: (identifier) => this.request("GET", `/v1/agents/${encodeURIComponent(identifier)}`),
+    /** Patch any subset; `autoResolveMinutes: null` switches the backstop off. */
+    update: (identifier, patch) => this.request(
+      "PATCH",
+      `/v1/agents/${encodeURIComponent(identifier)}`,
+      patch
+    ),
+    /** New signing secret, shown once; the old one stops working immediately. */
+    rotateSecret: (identifier) => this.request(
+      "POST",
+      `/v1/agents/${encodeURIComponent(identifier)}/rotate-secret`
+    ),
+    delete: (identifier) => this.request(
+      "DELETE",
+      `/v1/agents/${encodeURIComponent(identifier)}`
+    ),
+    /**
+     * Mint the single-use deep link (24h TTL) that merges a user's Telegram
+     * into this subscriber: generate it server-side for your LOGGED-IN user
+     * and hand them the returned t.me link. When they tap Start, their
+     * Telegram identity, history, and notifications unify with the
+     * subscriber — agent replies and triggers reach the real person.
+     */
+    linkToken: (agentIdentifier, subscriberId) => this.request(
+      "POST",
+      `/v1/agents/${encodeURIComponent(agentIdentifier)}/subscribers/${encodeURIComponent(subscriberId)}/link-token`
+    )
+  };
+  conversations = {
+    /** Conversations across your agents, newest first. */
+    list: (filters = {}) => {
+      const qs = new URLSearchParams();
+      if (filters.agent) qs.set("agent", filters.agent);
+      if (filters.status) qs.set("status", filters.status);
+      const suffix = qs.toString();
+      return this.request(
+        "GET",
+        `/v1/conversations${suffix ? `?${suffix}` : ""}`
+      );
+    },
+    /** Full transcript + metadata + LLM usage totals for one conversation. */
+    get: (id) => this.request("GET", `/v1/conversations/${encodeURIComponent(id)}`),
+    /** Close a conversation (a new message from the user reopens it). */
+    resolve: (id) => this.request(
+      "POST",
+      `/v1/conversations/${encodeURIComponent(id)}/resolve`
+    )
   };
   templates = {
     upsert: (template) => this.request("PUT", "/v1/templates", template),

package/dist/index.d.cts

@@ -56,6 +56,55 @@ interface WorkflowStep {
         statusIn: string[];
     };
 }
+/** An agent as the API returns it — secrets (signing, LLM key) never included. */
+interface Agent {
+    identifier: string;
+    name: string;
+    description: string | null;
+    runtime: 'bridge' | 'managed';
+    bridgeUrl: string | null;
+    model: string | null;
+    systemPrompt: string | null;
+    llmBaseUrl: string | null;
+    maxTokens: number | null;
+    autoResolveMinutes: number | null;
+    hasLlmKey: boolean;
+    status: 'active' | 'disabled';
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateAgentOptions {
+    identifier: string;
+    name: string;
+    description?: string;
+    /** 'bridge' (default): we POST turns to your bridgeUrl. 'managed': we run the LLM. */
+    runtime?: 'bridge' | 'managed';
+    bridgeUrl?: string;
+    model?: string;
+    systemPrompt?: string;
+    /** Managed reply cap, 256–8192 (default 1024). */
+    maxTokens?: number;
+    /** Auto-resolve conversations idle this many minutes, 1–43200 (default: never). */
+    autoResolveMinutes?: number;
+    /** Managed runtime: the LLM key (stored encrypted, write-only) + optional compat base URL. */
+    llm?: {
+        apiKey?: string;
+        baseUrl?: string;
+    };
+}
+interface ConversationSummary {
+    id: string;
+    agent: {
+        identifier: string;
+        name: string;
+    };
+    subscriberId: string;
+    channel: string;
+    status: 'active' | 'resolved';
+    messageCount: number;
+    lastMessagePreview: string | null;
+    lastMessageAt: string;
+}
 declare class AsyncifyError extends Error {
     readonly status: number;
     constructor(status: number, message: string);
@@ -98,6 +147,101 @@ declare class AsyncifyClient {
             id: string;
             subscriberId: string;
         }>;
+        /** Channel identities linked to this subscriber (telegram, email). */
+        identities: (subscriberId: string) => Promise<{
+            identities: Array<{
+                channel: string;
+                externalKey: string;
+                linkedAt: string;
+            }>;
+        }>;
+        /** Drop a linked identity — future messages fall back to a channel-local one. */
+        unlink: (subscriberId: string, identity: {
+            channel: "telegram" | "email";
+            externalKey: string;
+        }) => Promise<{
+            deleted: boolean;
+        }>;
+    };
+    readonly agents: {
+        /** Create an agent. The signing secret is returned EXACTLY ONCE — store it. */
+        create: (options: CreateAgentOptions) => Promise<{
+            agent: Agent;
+            signingSecret: string;
+        }>;
+        list: () => Promise<{
+            agents: Agent[];
+        }>;
+        get: (identifier: string) => Promise<{
+            agent: Agent;
+        }>;
+        /** Patch any subset; `autoResolveMinutes: null` switches the backstop off. */
+        update: (identifier: string, patch: Partial<Omit<CreateAgentOptions, "identifier" | "autoResolveMinutes">> & {
+            status?: "active" | "disabled";
+            autoResolveMinutes?: number | null;
+        }) => Promise<{
+            agent: Agent;
+        }>;
+        /** New signing secret, shown once; the old one stops working immediately. */
+        rotateSecret: (identifier: string) => Promise<{
+            signingSecret: string;
+        }>;
+        delete: (identifier: string) => Promise<{
+            deleted: boolean;
+        }>;
+        /**
+         * Mint the single-use deep link (24h TTL) that merges a user's Telegram
+         * into this subscriber: generate it server-side for your LOGGED-IN user
+         * and hand them the returned t.me link. When they tap Start, their
+         * Telegram identity, history, and notifications unify with the
+         * subscriber — agent replies and triggers reach the real person.
+         */
+        linkToken: (agentIdentifier: string, subscriberId: string) => Promise<{
+            token: string;
+            deepLink: string;
+            expiresAt: string;
+        }>;
+    };
+    readonly conversations: {
+        /** Conversations across your agents, newest first. */
+        list: (filters?: {
+            agent?: string;
+            status?: "active" | "resolved";
+        }) => Promise<{
+            conversations: ConversationSummary[];
+        }>;
+        /** Full transcript + metadata + LLM usage totals for one conversation. */
+        get: (id: string) => Promise<{
+            conversation: {
+                id: string;
+                channel: string;
+                status: "active" | "resolved";
+                metadata: Record<string, unknown>;
+                summary: string | null;
+                messageCount: number;
+                createdAt: string;
+            };
+            messages: Array<{
+                id: string;
+                role: "user" | "agent" | "system";
+                content: string;
+                createdAt: string;
+                buttons?: Array<{
+                    id: string;
+                    label: string;
+                }>;
+                clicked?: boolean;
+            }>;
+            usage: {
+                inputTokens: number;
+                outputTokens: number;
+                modelCalls: number;
+            };
+        }>;
+        /** Close a conversation (a new message from the user reopens it). */
+        resolve: (id: string) => Promise<{
+            status: string;
+        }>;
     };
     readonly templates: {
         upsert: (template: {
@@ -154,4 +298,4 @@ declare class AsyncifyClient {
     }>;
 }
 
-export { AsyncifyClient, type AsyncifyClientOptions, AsyncifyError, type Priority, type Recipient, type TriggerOptions, type TriggerRecipient, type TriggerResult, type WorkflowStep };
+export { type Agent, AsyncifyClient, type AsyncifyClientOptions, AsyncifyError, type ConversationSummary, type CreateAgentOptions, type Priority, type Recipient, type TriggerOptions, type TriggerRecipient, type TriggerResult, type WorkflowStep };

package/dist/index.d.ts

@@ -56,6 +56,55 @@ interface WorkflowStep {
         statusIn: string[];
     };
 }
+/** An agent as the API returns it — secrets (signing, LLM key) never included. */
+interface Agent {
+    identifier: string;
+    name: string;
+    description: string | null;
+    runtime: 'bridge' | 'managed';
+    bridgeUrl: string | null;
+    model: string | null;
+    systemPrompt: string | null;
+    llmBaseUrl: string | null;
+    maxTokens: number | null;
+    autoResolveMinutes: number | null;
+    hasLlmKey: boolean;
+    status: 'active' | 'disabled';
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateAgentOptions {
+    identifier: string;
+    name: string;
+    description?: string;
+    /** 'bridge' (default): we POST turns to your bridgeUrl. 'managed': we run the LLM. */
+    runtime?: 'bridge' | 'managed';
+    bridgeUrl?: string;
+    model?: string;
+    systemPrompt?: string;
+    /** Managed reply cap, 256–8192 (default 1024). */
+    maxTokens?: number;
+    /** Auto-resolve conversations idle this many minutes, 1–43200 (default: never). */
+    autoResolveMinutes?: number;
+    /** Managed runtime: the LLM key (stored encrypted, write-only) + optional compat base URL. */
+    llm?: {
+        apiKey?: string;
+        baseUrl?: string;
+    };
+}
+interface ConversationSummary {
+    id: string;
+    agent: {
+        identifier: string;
+        name: string;
+    };
+    subscriberId: string;
+    channel: string;
+    status: 'active' | 'resolved';
+    messageCount: number;
+    lastMessagePreview: string | null;
+    lastMessageAt: string;
+}
 declare class AsyncifyError extends Error {
     readonly status: number;
     constructor(status: number, message: string);
@@ -98,6 +147,101 @@ declare class AsyncifyClient {
             id: string;
             subscriberId: string;
         }>;
+        /** Channel identities linked to this subscriber (telegram, email). */
+        identities: (subscriberId: string) => Promise<{
+            identities: Array<{
+                channel: string;
+                externalKey: string;
+                linkedAt: string;
+            }>;
+        }>;
+        /** Drop a linked identity — future messages fall back to a channel-local one. */
+        unlink: (subscriberId: string, identity: {
+            channel: "telegram" | "email";
+            externalKey: string;
+        }) => Promise<{
+            deleted: boolean;
+        }>;
+    };
+    readonly agents: {
+        /** Create an agent. The signing secret is returned EXACTLY ONCE — store it. */
+        create: (options: CreateAgentOptions) => Promise<{
+            agent: Agent;
+            signingSecret: string;
+        }>;
+        list: () => Promise<{
+            agents: Agent[];
+        }>;
+        get: (identifier: string) => Promise<{
+            agent: Agent;
+        }>;
+        /** Patch any subset; `autoResolveMinutes: null` switches the backstop off. */
+        update: (identifier: string, patch: Partial<Omit<CreateAgentOptions, "identifier" | "autoResolveMinutes">> & {
+            status?: "active" | "disabled";
+            autoResolveMinutes?: number | null;
+        }) => Promise<{
+            agent: Agent;
+        }>;
+        /** New signing secret, shown once; the old one stops working immediately. */
+        rotateSecret: (identifier: string) => Promise<{
+            signingSecret: string;
+        }>;
+        delete: (identifier: string) => Promise<{
+            deleted: boolean;
+        }>;
+        /**
+         * Mint the single-use deep link (24h TTL) that merges a user's Telegram
+         * into this subscriber: generate it server-side for your LOGGED-IN user
+         * and hand them the returned t.me link. When they tap Start, their
+         * Telegram identity, history, and notifications unify with the
+         * subscriber — agent replies and triggers reach the real person.
+         */
+        linkToken: (agentIdentifier: string, subscriberId: string) => Promise<{
+            token: string;
+            deepLink: string;
+            expiresAt: string;
+        }>;
+    };
+    readonly conversations: {
+        /** Conversations across your agents, newest first. */
+        list: (filters?: {
+            agent?: string;
+            status?: "active" | "resolved";
+        }) => Promise<{
+            conversations: ConversationSummary[];
+        }>;
+        /** Full transcript + metadata + LLM usage totals for one conversation. */
+        get: (id: string) => Promise<{
+            conversation: {
+                id: string;
+                channel: string;
+                status: "active" | "resolved";
+                metadata: Record<string, unknown>;
+                summary: string | null;
+                messageCount: number;
+                createdAt: string;
+            };
+            messages: Array<{
+                id: string;
+                role: "user" | "agent" | "system";
+                content: string;
+                createdAt: string;
+                buttons?: Array<{
+                    id: string;
+                    label: string;
+                }>;
+                clicked?: boolean;
+            }>;
+            usage: {
+                inputTokens: number;
+                outputTokens: number;
+                modelCalls: number;
+            };
+        }>;
+        /** Close a conversation (a new message from the user reopens it). */
+        resolve: (id: string) => Promise<{
+            status: string;
+        }>;
     };
     readonly templates: {
         upsert: (template: {
@@ -154,4 +298,4 @@ declare class AsyncifyClient {
     }>;
 }
 
-export { AsyncifyClient, type AsyncifyClientOptions, AsyncifyError, type Priority, type Recipient, type TriggerOptions, type TriggerRecipient, type TriggerResult, type WorkflowStep };
+export { type Agent, AsyncifyClient, type AsyncifyClientOptions, AsyncifyError, type ConversationSummary, type CreateAgentOptions, type Priority, type Recipient, type TriggerOptions, type TriggerRecipient, type TriggerResult, type WorkflowStep };

package/dist/index.js

@@ -40,7 +40,67 @@ var AsyncifyClient = class {
     list: () => this.request("GET", "/v1/workflows")
   };
   subscribers = {
-    upsert: (subscriber) => this.request("PUT", "/v1/subscribers", subscriber)
+    upsert: (subscriber) => this.request("PUT", "/v1/subscribers", subscriber),
+    /** Channel identities linked to this subscriber (telegram, email). */
+    identities: (subscriberId) => this.request("GET", `/v1/subscribers/${encodeURIComponent(subscriberId)}/identities`),
+    /** Drop a linked identity — future messages fall back to a channel-local one. */
+    unlink: (subscriberId, identity) => this.request(
+      "DELETE",
+      `/v1/subscribers/${encodeURIComponent(subscriberId)}/identities`,
+      identity
+    )
+  };
+  agents = {
+    /** Create an agent. The signing secret is returned EXACTLY ONCE — store it. */
+    create: (options) => this.request("POST", "/v1/agents", options),
+    list: () => this.request("GET", "/v1/agents"),
+    get: (identifier) => this.request("GET", `/v1/agents/${encodeURIComponent(identifier)}`),
+    /** Patch any subset; `autoResolveMinutes: null` switches the backstop off. */
+    update: (identifier, patch) => this.request(
+      "PATCH",
+      `/v1/agents/${encodeURIComponent(identifier)}`,
+      patch
+    ),
+    /** New signing secret, shown once; the old one stops working immediately. */
+    rotateSecret: (identifier) => this.request(
+      "POST",
+      `/v1/agents/${encodeURIComponent(identifier)}/rotate-secret`
+    ),
+    delete: (identifier) => this.request(
+      "DELETE",
+      `/v1/agents/${encodeURIComponent(identifier)}`
+    ),
+    /**
+     * Mint the single-use deep link (24h TTL) that merges a user's Telegram
+     * into this subscriber: generate it server-side for your LOGGED-IN user
+     * and hand them the returned t.me link. When they tap Start, their
+     * Telegram identity, history, and notifications unify with the
+     * subscriber — agent replies and triggers reach the real person.
+     */
+    linkToken: (agentIdentifier, subscriberId) => this.request(
+      "POST",
+      `/v1/agents/${encodeURIComponent(agentIdentifier)}/subscribers/${encodeURIComponent(subscriberId)}/link-token`
+    )
+  };
+  conversations = {
+    /** Conversations across your agents, newest first. */
+    list: (filters = {}) => {
+      const qs = new URLSearchParams();
+      if (filters.agent) qs.set("agent", filters.agent);
+      if (filters.status) qs.set("status", filters.status);
+      const suffix = qs.toString();
+      return this.request(
+        "GET",
+        `/v1/conversations${suffix ? `?${suffix}` : ""}`
+      );
+    },
+    /** Full transcript + metadata + LLM usage totals for one conversation. */
+    get: (id) => this.request("GET", `/v1/conversations/${encodeURIComponent(id)}`),
+    /** Close a conversation (a new message from the user reopens it). */
+    resolve: (id) => this.request(
+      "POST",
+      `/v1/conversations/${encodeURIComponent(id)}/resolve`
+    )
   };
   templates = {
     upsert: (template) => this.request("PUT", "/v1/templates", template),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asyncify-hq/node",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Server-side SDK for Asyncify — multi-channel notification infrastructure (email, SMS, push, in-app)",
   "keywords": ["notifications", "email", "sms", "push", "in-app", "asyncify", "notification-infrastructure"],
   "homepage": "https://asyncify.org",