@graph8/sdk 0.3.0 → 0.4.0

package/dist/index.mjs

@@ -323,18 +323,133 @@ var DEFAULT_API7 = "https://be.graph8.com";
 var createSequencesClient = (apiKey, apiUrl) => {
   const baseUrl = apiUrl || DEFAULT_API7;
   const headers = () => ({ "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` });
+  const toQuery = (params) => {
+    const qs = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+      if (v != null) qs.set(k, String(v));
+    }
+    const s = qs.toString();
+    return s ? `?${s}` : "";
+  };
+  async function list(pageOrParams, limit) {
+    let params;
+    if (typeof pageOrParams === "number") {
+      params = { page: pageOrParams, limit: limit ?? 50 };
+    } else {
+      params = pageOrParams ?? {};
+    }
+    const resp = await fetch(`${baseUrl}/api/v1/sequences${toQuery(params)}`, { headers: headers() });
+    const data = await resp.json();
+    return data.data || data;
+  }
   return {
-    async list(page = 1, limit = 50) {
-      const resp = await fetch(`${baseUrl}/api/v1/sequences?page=${page}&limit=${limit}`, { headers: headers() });
+    /** List sequences with pagination + optional status filter. */
+    list,
+    /** Get full sequence details by ID. */
+    async get(sequenceId) {
+      const resp = await fetch(`${baseUrl}/api/v1/sequences/${sequenceId}`, { headers: headers() });
       const data = await resp.json();
       return data.data || data;
     },
+    /** List contacts enrolled in a sequence. Filter by state (e.g. "active", "replied"). */
+    async contacts(sequenceId, params = {}) {
+      const resp = await fetch(
+        `${baseUrl}/api/v1/sequences/${sequenceId}/contacts${toQuery(params)}`,
+        { headers: headers() }
+      );
+      return resp.json();
+    },
+    /** Add contacts to a sequence (V2 queuing). Live or drafted sequences only. */
     async add(config) {
-      await fetch(`${baseUrl}/api/v1/sequences/${config.sequenceId}/contacts`, {
+      const resp = await fetch(`${baseUrl}/api/v1/sequences/${config.sequenceId}/contacts`, {
         method: "POST",
         headers: headers(),
         body: JSON.stringify({ contact_ids: config.contactIds, list_id: config.listId })
       });
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** Create a new sequence with optional steps + channels. */
+    async create(payload) {
+      const resp = await fetch(`${baseUrl}/api/v1/sequences`, {
+        method: "POST",
+        headers: headers(),
+        body: JSON.stringify(payload)
+      });
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** Update sequence metadata. Rejected (409) if sequence is in a transitional status. */
+    async update(sequenceId, fields) {
+      const resp = await fetch(`${baseUrl}/api/v1/sequences/${sequenceId}`, {
+        method: "PATCH",
+        headers: headers(),
+        body: JSON.stringify(fields)
+      });
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** Update a single step within a sequence. */
+    async updateStep(sequenceId, stepId, fields) {
+      const resp = await fetch(`${baseUrl}/api/v1/sequences/${sequenceId}/steps/${stepId}`, {
+        method: "PATCH",
+        headers: headers(),
+        body: JSON.stringify(fields)
+      });
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** Soft-delete (archive) a sequence. */
+    async delete(sequenceId) {
+      const resp = await fetch(`${baseUrl}/api/v1/sequences/${sequenceId}`, {
+        method: "DELETE",
+        headers: headers()
+      });
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** Run/start a DRAFTED sequence (V2 orchestration). */
+    async run(sequenceId) {
+      const resp = await fetch(`${baseUrl}/api/v1/sequences/${sequenceId}/run`, {
+        method: "POST",
+        headers: headers()
+      });
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** Pause a live sequence. */
+    async pause(sequenceId) {
+      const resp = await fetch(`${baseUrl}/api/v1/sequences/${sequenceId}/pause`, {
+        method: "POST",
+        headers: headers()
+      });
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** Resume a paused sequence. */
+    async resume(sequenceId) {
+      const resp = await fetch(`${baseUrl}/api/v1/sequences/${sequenceId}/resume`, {
+        method: "POST",
+        headers: headers()
+      });
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** Read-only sequence preview with all steps + channels (no enrollment). */
+    async preview(sequenceId) {
+      const resp = await fetch(`${baseUrl}/api/v1/sequences/${sequenceId}/preview`, {
+        headers: headers()
+      });
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** Comprehensive analytics for a sequence. */
+    async analytics(sequenceId) {
+      const resp = await fetch(`${baseUrl}/api/v1/sequences/${sequenceId}/analytics`, {
+        headers: headers()
+      });
+      const data = await resp.json();
+      return data.data || data;
     }
   };
 };
@@ -459,8 +574,116 @@ var createVoiceClient = (apiKey, apiUrl) => {
   const baseUrl = apiUrl || DEFAULT_API12;
   const headers = () => ({ "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` });
   const listeners = /* @__PURE__ */ new Map();
+  const toQuery = (params) => {
+    const qs = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+      if (v != null) qs.set(k, String(v));
+    }
+    const s = qs.toString();
+    return s ? `?${s}` : "";
+  };
+  const dialer = {
+    /** List parallel-dialer sessions with filters + pagination. */
+    async listSessions(params = {}) {
+      const resp = await fetch(
+        `${baseUrl}/api/v1/voice/dialer/sessions${toQuery(params)}`,
+        { headers: headers() }
+      );
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** Create a parallel-dialer session in PAUSED state. SDR opens UI to start dialing. */
+    async createSession(payload) {
+      const resp = await fetch(`${baseUrl}/api/v1/voice/dialer/sessions`, {
+        method: "POST",
+        headers: headers(),
+        body: JSON.stringify(payload)
+      });
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** Pause / resume / stop a dialer session via status flip. */
+    async updateSessionStatus(sessionId, status) {
+      const resp = await fetch(
+        `${baseUrl}/api/v1/voice/dialer/sessions/${sessionId}/status`,
+        {
+          method: "PATCH",
+          headers: headers(),
+          body: JSON.stringify({ status })
+        }
+      );
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /**
+     * Resume a PAUSED dialer session. Auto-fetches the next batch from the source list,
+     * filters already-called + phoneless rows, and forwards to voice's start-session.
+     * @param maxContacts 1-4 (voice caps parallel dialing at 4). Default 4.
+     */
+    async resumeSession(sessionId, maxContacts = 4) {
+      const resp = await fetch(
+        `${baseUrl}/api/v1/voice/dialer/sessions/${sessionId}/resume`,
+        {
+          method: "POST",
+          headers: headers(),
+          body: JSON.stringify({ max_contacts: maxContacts })
+        }
+      );
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** Aggregated dialer analytics (daily breakdown or total). */
+    async stats(params = {}) {
+      const resp = await fetch(
+        `${baseUrl}/api/v1/voice/dialer/stats${toQuery(params)}`,
+        { headers: headers() }
+      );
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** List dialer-eligible phone numbers with 7-day stats + daily limits. */
+    async numbers(userEmail) {
+      const params = userEmail ? { user_email: userEmail } : {};
+      const resp = await fetch(
+        `${baseUrl}/api/v1/voice/dialer/numbers${toQuery(params)}`,
+        { headers: headers() }
+      );
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** List missed inbound callbacks with caller / contact info. */
+    async missedCallbacks(limit = 50) {
+      const resp = await fetch(
+        `${baseUrl}/api/v1/voice/dialer/missed-callbacks${toQuery({ limit })}`,
+        { headers: headers() }
+      );
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** AI grading for a single dialer call (returns "pending" while in progress). */
+    async callGrading(roomName) {
+      const resp = await fetch(
+        `${baseUrl}/api/v1/voice/dialer/calls/${encodeURIComponent(roomName)}/grading`,
+        { headers: headers() }
+      );
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** List voice agents available for dialer sessions (capped at 100; no pagination). */
+    async agents(params = {}) {
+      const resp = await fetch(
+        `${baseUrl}/api/v1/voice/dialer/agents${toQuery(params)}`,
+        { headers: headers() }
+      );
+      const data = await resp.json();
+      return data.data || data;
+    }
+  };
   return {
-    /** Start an AI voice session. */
+    /**
+     * Start an AI voice session.
+     * @deprecated Preview surface — for parallel-dialer flows use `voice.dialer.createSession()`.
+     */
     async start(config) {
       const resp = await fetch(`${baseUrl}/api/v1/voice/sessions`, {
         method: "POST",
@@ -470,7 +693,10 @@ var createVoiceClient = (apiKey, apiUrl) => {
       const data = await resp.json();
       return data.data || data;
     },
-    /** Get call analysis for a completed session. */
+    /**
+     * Get call analysis for a completed session.
+     * @deprecated Preview surface — for dialer-call grading use `voice.dialer.callGrading(roomName)`.
+     */
     async analysis(sessionId) {
       const resp = await fetch(`${baseUrl}/api/v1/voice/sessions/${sessionId}/analysis`, { headers: headers() });
       const data = await resp.json();
@@ -480,7 +706,9 @@ var createVoiceClient = (apiKey, apiUrl) => {
     on(event, callback) {
       if (!listeners.has(event)) listeners.set(event, []);
       listeners.get(event).push(callback);
-    }
+    },
+    /** Parallel-dialer session control + analytics. */
+    dialer
   };
 };
 
@@ -1009,9 +1237,88 @@ var createDealsClient = (apiKey, apiUrl) => {
   };
 };
 
+// src/inbox.ts
+var DEFAULT_API22 = "https://be.graph8.com";
+var createInboxClient = (apiKey, apiUrl) => {
+  const baseUrl = apiUrl || DEFAULT_API22;
+  const headers = () => ({ "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` });
+  const toQuery = (params) => {
+    const qs = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+      if (v != null) qs.set(k, String(v));
+    }
+    const s = qs.toString();
+    return s ? `?${s}` : "";
+  };
+  return {
+    /** List inbox threads across email, SMS, and LinkedIn. */
+    async list(params = {}) {
+      const resp = await fetch(`${baseUrl}/api/v1/inbox${toQuery(params)}`, { headers: headers() });
+      return resp.json();
+    },
+    /** Get a single inbox thread. Defaults to email channel. */
+    async get(replyId, channel = "email") {
+      const resp = await fetch(
+        `${baseUrl}/api/v1/inbox/${replyId}${toQuery({ channel })}`,
+        { headers: headers() }
+      );
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** Assign a user to an inbox thread. */
+    async assign(replyId, assigneeEmail, channel = "email") {
+      const resp = await fetch(
+        `${baseUrl}/api/v1/inbox/${replyId}/assign${toQuery({ channel })}`,
+        {
+          method: "POST",
+          headers: headers(),
+          body: JSON.stringify({ assignee_email: assigneeEmail })
+        }
+      );
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** Attach tag IDs to an inbox thread. */
+    async tag(replyId, tagIds, channel = "email") {
+      const resp = await fetch(
+        `${baseUrl}/api/v1/inbox/${replyId}/tag${toQuery({ channel })}`,
+        {
+          method: "POST",
+          headers: headers(),
+          body: JSON.stringify({ tag_ids: tagIds })
+        }
+      );
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /**
+     * Generate an AI draft reply for a thread.
+     * Charges credits — server returns 402 if balance is insufficient.
+     */
+    async draft(replyId, channel = "email") {
+      const resp = await fetch(
+        `${baseUrl}/api/v1/inbox/${replyId}/draft${toQuery({ channel })}`,
+        { headers: headers() }
+      );
+      const data = await resp.json();
+      return data.data || data;
+    },
+    /** Send a reply through email, SMS, or LinkedIn. */
+    async send(replyId, payload) {
+      const resp = await fetch(`${baseUrl}/api/v1/inbox/${replyId}/send`, {
+        method: "POST",
+        headers: headers(),
+        body: JSON.stringify(payload)
+      });
+      const data = await resp.json();
+      return data.data || data;
+    }
+  };
+};
+
 // src/core.ts
 var DEFAULT_HOST = "https://t.graph8.com";
-var DEFAULT_API22 = "https://be.graph8.com";
+var DEFAULT_API23 = "https://be.graph8.com";
 var G8 = class {
   constructor() {
     /** @internal */
@@ -1060,6 +1367,8 @@ var G8 = class {
     this._fields = null;
     /** @internal */
     this._deals = null;
+    /** @internal */
+    this._inbox = null;
   }
   /**
    * Initialize the graph8 SDK. Must be called before any other method.
@@ -1074,7 +1383,7 @@ var G8 = class {
         debug: config.debug
       });
     }
-    const apiUrl = config.apiUrl || DEFAULT_API22;
+    const apiUrl = config.apiUrl || DEFAULT_API23;
     const writeKey = config.writeKey || "";
     const apiKey = config.apiKey || "";
     if (writeKey) {
@@ -1101,6 +1410,7 @@ var G8 = class {
       this._tasks = createTasksClient(apiKey, apiUrl);
       this._fields = createFieldsClient(apiKey, apiUrl);
       this._deals = createDealsClient(apiKey, apiUrl);
+      this._inbox = createInboxClient(apiKey, apiUrl);
       this._signals = createSignalsClient(apiKey, true, apiUrl);
     }
   }
@@ -1227,6 +1537,11 @@ var G8 = class {
     this._assertKey("deals");
     return this._deals;
   }
+  /** Multi-channel inbox — read + reply across email, SMS, LinkedIn (requires API key). */
+  get inbox() {
+    this._assertKey("inbox");
+    return this._inbox;
+  }
   /** Whether the SDK has been initialized. */
   get initialized() {
     return this.config !== null;