@graph8/sdk 0.5.1 → 0.5.3

package/dist/react.d.mts

@@ -135,10 +135,13 @@ interface ResearchReport {
  *   GET /api/v1/research-reports
  */
 declare const createStudioClient: (apiKey: string, apiUrl?: string) => {
-    /** Org-level Studio documents (brand_brief, value_props, messaging_house, etc.). */
+    /** Org-level Studio documents (brand_brief, value_props, messaging_house, etc.).
+     * `include_content` defaults to true server-side, so each document includes
+     * its `content` body unless you explicitly pass `include_content: false`. */
     globalContext(params?: {
         category?: string;
         limit?: number;
+        include_content?: boolean;
     }): Promise<{
         data: GlobalContextDocument[];
     }>;
@@ -2213,6 +2216,8 @@ interface SequenceListParams {
     limit?: number;
     /** Filter by sequence status (e.g. "live", "draft", "paused"). */
     status?: string;
+    /** Filter by sequence kind ("cold_outbound" or "nurture"). Omit to list all kinds. */
+    sequence_kind?: SequenceKind;
 }
 interface SequenceDetail {
     id: string;
@@ -2226,6 +2231,10 @@ interface SequenceDetail {
     wait_for_new_contacts: boolean;
     paused_at: string | null;
     resumed_at: string | null;
+    /** Sequence kind. Immutable after creation. "cold_outbound" (default) or "nurture". */
+    sequence_kind?: string | null;
+    /** Pinned mailbox for nurture sequences; null for cold_outbound. Immutable. */
+    pinned_mailbox_id?: number | null;
     created_at: string | null;
     updated_at: string | null;
 }
@@ -2270,6 +2279,13 @@ interface SequenceChannelConfig {
     channel_type: string;
     channel_data?: Record<string, unknown>;
 }
+/**
+ * Sequence kind. A "nurture" is an ordinary sequence with `sequence_kind:
+ * "nurture"` — same step types as cold outreach, but pinned to a single mailbox
+ * with a higher daily email cap. There is no separate nurture client; create one
+ * via `sequences.create({ sequence_kind: "nurture", pinned_mailbox_id })`.
+ */
+type SequenceKind = "cold_outbound" | "nurture";
 interface SequenceCreateParams {
     name: string;
     user_email: string;
@@ -2281,6 +2297,18 @@ interface SequenceCreateParams {
     steps?: SequenceStepConfig[];
     channels?: SequenceChannelConfig[];
     campaign_id?: string;
+    /**
+     * Sequence kind. Defaults to "cold_outbound" server-side. Immutable after
+     * creation. "nurture" requires `pinned_mailbox_id` and is gated by the
+     * ENABLE_NURTURE feature flag.
+     */
+    sequence_kind?: SequenceKind;
+    /**
+     * Mailbox to pin for a nurture sequence. Required when
+     * `sequence_kind: "nurture"`; all email channels must use this mailbox.
+     * Ignored for cold_outbound sequences.
+     */
+    pinned_mailbox_id?: number;
 }
 interface SequenceCreateResult {
     id: string;
@@ -3346,6 +3374,7 @@ declare const useG8: () => {
             globalContext(params?: {
                 category?: string;
                 limit?: number;
+                include_content?: boolean;
             }): Promise<{
                 data: GlobalContextDocument[];
             }>;

package/dist/react.d.ts

@@ -135,10 +135,13 @@ interface ResearchReport {
  *   GET /api/v1/research-reports
  */
 declare const createStudioClient: (apiKey: string, apiUrl?: string) => {
-    /** Org-level Studio documents (brand_brief, value_props, messaging_house, etc.). */
+    /** Org-level Studio documents (brand_brief, value_props, messaging_house, etc.).
+     * `include_content` defaults to true server-side, so each document includes
+     * its `content` body unless you explicitly pass `include_content: false`. */
     globalContext(params?: {
         category?: string;
         limit?: number;
+        include_content?: boolean;
     }): Promise<{
         data: GlobalContextDocument[];
     }>;
@@ -2213,6 +2216,8 @@ interface SequenceListParams {
     limit?: number;
     /** Filter by sequence status (e.g. "live", "draft", "paused"). */
     status?: string;
+    /** Filter by sequence kind ("cold_outbound" or "nurture"). Omit to list all kinds. */
+    sequence_kind?: SequenceKind;
 }
 interface SequenceDetail {
     id: string;
@@ -2226,6 +2231,10 @@ interface SequenceDetail {
     wait_for_new_contacts: boolean;
     paused_at: string | null;
     resumed_at: string | null;
+    /** Sequence kind. Immutable after creation. "cold_outbound" (default) or "nurture". */
+    sequence_kind?: string | null;
+    /** Pinned mailbox for nurture sequences; null for cold_outbound. Immutable. */
+    pinned_mailbox_id?: number | null;
     created_at: string | null;
     updated_at: string | null;
 }
@@ -2270,6 +2279,13 @@ interface SequenceChannelConfig {
     channel_type: string;
     channel_data?: Record<string, unknown>;
 }
+/**
+ * Sequence kind. A "nurture" is an ordinary sequence with `sequence_kind:
+ * "nurture"` — same step types as cold outreach, but pinned to a single mailbox
+ * with a higher daily email cap. There is no separate nurture client; create one
+ * via `sequences.create({ sequence_kind: "nurture", pinned_mailbox_id })`.
+ */
+type SequenceKind = "cold_outbound" | "nurture";
 interface SequenceCreateParams {
     name: string;
     user_email: string;
@@ -2281,6 +2297,18 @@ interface SequenceCreateParams {
     steps?: SequenceStepConfig[];
     channels?: SequenceChannelConfig[];
     campaign_id?: string;
+    /**
+     * Sequence kind. Defaults to "cold_outbound" server-side. Immutable after
+     * creation. "nurture" requires `pinned_mailbox_id` and is gated by the
+     * ENABLE_NURTURE feature flag.
+     */
+    sequence_kind?: SequenceKind;
+    /**
+     * Mailbox to pin for a nurture sequence. Required when
+     * `sequence_kind: "nurture"`; all email channels must use this mailbox.
+     * Ignored for cold_outbound sequences.
+     */
+    pinned_mailbox_id?: number;
 }
 interface SequenceCreateResult {
     id: string;
@@ -3346,6 +3374,7 @@ declare const useG8: () => {
             globalContext(params?: {
                 category?: string;
                 limit?: number;
+                include_content?: boolean;
             }): Promise<{
                 data: GlobalContextDocument[];
             }>;

package/dist/react.js

@@ -1994,7 +1994,9 @@ var createStudioClient = (apiKey, apiUrl) => {
     return resp.json();
   };
   return {
-    /** Org-level Studio documents (brand_brief, value_props, messaging_house, etc.). */
+    /** Org-level Studio documents (brand_brief, value_props, messaging_house, etc.).
+     * `include_content` defaults to true server-side, so each document includes
+     * its `content` body unless you explicitly pass `include_content: false`. */
     async globalContext(params = {}) {
       return get("/global-context/documents", params);
     },