@graph8/sdk 0.5.0 → 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[];
     }>;
@@ -1376,6 +1379,14 @@ interface Task {
     created_by: string | null;
     created_at: string | null;
     updated_at: string | null;
+    /** Parent task UUID when this row is a subtask, else null. One level deep. */
+    parent_task_id?: string | null;
+    /** Sort position within the parent's subtasks. 0 when not a subtask. */
+    subtask_sort_order?: number | null;
+    /** Number of subtasks under this task (top-level rows only). */
+    subtask_count?: number | null;
+    /** Subset of subtask_count whose status is "completed". */
+    completed_subtask_count?: number | null;
 }
 interface TaskCreateParams {
     title: string;
@@ -1385,6 +1396,16 @@ interface TaskCreateParams {
     assignee_id?: string;
     /** 0=none, 1=urgent, 2=high, 3=normal, 4=low */
     priority?: number;
+    /**
+     * When set, the new task is created as a subtask of this parent. Parent
+     * must exist and must not itself be a subtask (subtasks are one level
+     * deep).
+     */
+    parent_task_id?: string;
+    /**
+     * Sort position within the parent's subtasks. Omit to append at the end.
+     */
+    subtask_sort_order?: number;
 }
 interface TaskUpdateParams {
     title?: string;
@@ -1394,6 +1415,14 @@ interface TaskUpdateParams {
     /** "open" | "completed" */
     status?: string;
     priority?: number;
+    /**
+     * Re-parent this task into a subtask of the given parent. Parent must
+     * exist, must not itself be a subtask, and a task that already has
+     * subtasks of its own cannot be demoted into a subtask.
+     */
+    parent_task_id?: string;
+    /** Reorder within the parent's subtasks. Can be sent alone. */
+    subtask_sort_order?: number;
 }
 interface TaskListParams {
     /** "open" | "completed" */
@@ -2187,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;
@@ -2200,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;
 }
@@ -2244,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;
@@ -2255,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;
@@ -3320,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[];
     }>;
@@ -1376,6 +1379,14 @@ interface Task {
     created_by: string | null;
     created_at: string | null;
     updated_at: string | null;
+    /** Parent task UUID when this row is a subtask, else null. One level deep. */
+    parent_task_id?: string | null;
+    /** Sort position within the parent's subtasks. 0 when not a subtask. */
+    subtask_sort_order?: number | null;
+    /** Number of subtasks under this task (top-level rows only). */
+    subtask_count?: number | null;
+    /** Subset of subtask_count whose status is "completed". */
+    completed_subtask_count?: number | null;
 }
 interface TaskCreateParams {
     title: string;
@@ -1385,6 +1396,16 @@ interface TaskCreateParams {
     assignee_id?: string;
     /** 0=none, 1=urgent, 2=high, 3=normal, 4=low */
     priority?: number;
+    /**
+     * When set, the new task is created as a subtask of this parent. Parent
+     * must exist and must not itself be a subtask (subtasks are one level
+     * deep).
+     */
+    parent_task_id?: string;
+    /**
+     * Sort position within the parent's subtasks. Omit to append at the end.
+     */
+    subtask_sort_order?: number;
 }
 interface TaskUpdateParams {
     title?: string;
@@ -1394,6 +1415,14 @@ interface TaskUpdateParams {
     /** "open" | "completed" */
     status?: string;
     priority?: number;
+    /**
+     * Re-parent this task into a subtask of the given parent. Parent must
+     * exist, must not itself be a subtask, and a task that already has
+     * subtasks of its own cannot be demoted into a subtask.
+     */
+    parent_task_id?: string;
+    /** Reorder within the parent's subtasks. Can be sent alone. */
+    subtask_sort_order?: number;
 }
 interface TaskListParams {
     /** "open" | "completed" */
@@ -2187,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;
@@ -2200,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;
 }
@@ -2244,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;
@@ -2255,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;
@@ -3320,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);
     },