@graph8/sdk 0.358.0 → 0.361.0

package/dist/react.d.mts

@@ -403,6 +403,18 @@ interface GlobalContextDocument {
     metadata: Record<string, unknown> | null;
     created_at: string | null;
     updated_at: string | null;
+    /** Fields the endpoint actually returns (the ones above predate them). */
+    display_name?: string | null;
+    file_type?: string | null;
+    folder_path?: string | null;
+    status?: string | null;
+    priority?: number | null;
+    version?: string | number | null;
+    /** The group the Studio Wiki shows the document under (TAM / ICP / Persona
+     * Research are stored as market/audience but shown under "targeting"). */
+    wiki_category?: string;
+    /** Which Wiki bucket the row came from. */
+    workflow?: "context" | "intelligence" | "research";
 }
 interface Persona {
     id: string;
@@ -413,6 +425,20 @@ interface Persona {
     goals: string[];
     channels: string[];
     created_at: string | null;
+    /** Fields GET /personas actually returns (cb_personas columns). The persona's
+     * name is `title`, its "why" is `why_target`, its signals are `key_signals`. */
+    title?: string | null;
+    why_target?: string | null;
+    key_signals?: unknown[];
+    campaign_approach?: string | null;
+    recommended_goal?: string | null;
+    expected_receptivity?: string | null;
+    confidence?: string | null;
+    confidence_score?: number | null;
+    priority?: number | null;
+    pinned?: boolean | null;
+    source?: string | null;
+    updated_at?: string | null;
 }
 interface ICP {
     id: string;
@@ -426,6 +452,24 @@ interface ICP {
     revenue_max: number | null;
     countries: string[] | null;
     created_at: string | null;
+    /** Fields GET /icps actually returns (cb_icps columns). Industries and
+     * company sizes live in `firmographics.industries` / `firmographics.company_sizes`. */
+    firmographics?: {
+        industries?: string[];
+        company_sizes?: string[];
+        revenue_ranges?: string[];
+        geographies?: string[];
+        [key: string]: unknown;
+    };
+    tech_stack?: Record<string, unknown>;
+    buying_signals?: unknown[];
+    fit_score?: number | null;
+    opportunity_score?: number | null;
+    readiness_score?: number | null;
+    total_score?: number | null;
+    pinned?: boolean | null;
+    priority?: number | null;
+    updated_at?: string | null;
 }
 interface IntelligenceData {
     id: string;
@@ -464,6 +508,10 @@ declare const createStudioClient: (apiKey: string, apiUrl?: string) => {
         category?: string;
         limit?: number;
         include_content?: boolean;
+        /** Also list the Wiki's Intelligence documents (metadata only). */
+        include_intelligence?: boolean;
+        /** Also list the Wiki's Research reports. */
+        include_research?: boolean;
     }): Promise<{
         data: GlobalContextDocument[];
     }>;
@@ -3312,10 +3360,14 @@ interface AdCampaignResponse {
     launched_at?: string | null;
     name: string;
     objective?: string | null;
+    /** True when end_date is before today (UTC). Null when the campaign has no end date. */
+    past_end_date?: boolean | null;
     platform: string;
     platform_campaign_id?: string | null;
     start_date?: string | null;
     status: string;
+    /** Plain-language note when the stored status cannot be taken at face value, e.g. the end date has passed but the status still says pending. Null otherwise. */
+    status_note?: string | null;
     sync_config_id: number;
 }
 /**
@@ -8029,6 +8081,8 @@ interface CampaignFullPatchRequest {
     primary_hook?: string | null;
     /** If provided, replaces the sequence step ordering (same as PUT /sequence). */
     sequence_steps?: Array<SequenceStepRef> | null;
+    /** Replace the campaign's channels (email, linkedin, phone, voice_ai, sms). Omit to leave them unchanged. Same as PATCH /campaigns/{id}. */
+    target_channels?: Array<string> | null;
     target_persona?: string | null;
     /** Sequence IDs to UNLINK from this campaign. DELETEs ONLY rows where status='linked'. Launch-audit rows (status='pushed'/'superseded'/'failed') are never touched — those are an immutable historical record. */
     unlink_sequence_ids?: Array<string> | null;
@@ -9003,14 +9057,19 @@ interface ConfirmBookingRequest {
  * This is the irreversible half: records begin landing in graph8 and a
  * migration cannot be un-run, only cancelled part-way.
  *
- * Both fields are OPTIONAL and omitting them accepts the discovery as
+ * Every field is OPTIONAL and omitting them accepts the discovery as
  * proposed - which is the point of previewing it first. Send
- * `field_mappings_override` to change where a CRM field lands, or
- * `selected_list_ids` to import only some lists.
+ * `field_mappings_override` to change where a CRM field lands,
+ * `selected_list_ids` to import only some lists, or `owner_decisions` to say
+ * what happens to the records of Salesforce owners who are not in graph8.
+ * A Salesforce discovery with an `unmatched` owner needs a decision for that
+ * owner: without one the confirm is refused with 422.
  */
 interface ConfirmMigrationRequest {
     /** Per entity type, the mappings to use instead of the discovered ones. Omit to accept what discovery proposed. */
     field_mappings_override?: Record<string, Array<Record<string, unknown>>> | null;
+    /** Salesforce only: one decision per record owner who is not a graph8 member (at most 500). Required for every owner whose `match.status` is `unmatched`; optional `assign` for a `placeholder` owner. `match` moves every record the owner has; `assign` moves only their open deals and open tasks. */
+    owner_decisions?: Array<MigrationOwnerDecision> | null;
     /** Import only these CRM lists. Omit to take every discovered list. */
     selected_list_ids?: Array<string> | null;
 }
@@ -16951,6 +17010,25 @@ interface MergeRecordRequest {
 interface MessageSendRequest {
     text: string;
 }
+/**
+ * What happens to the records of one Salesforce record owner who is not a graph8 member.
+ *
+ * Discovery lists every record owner in the status's `owners`, each with a
+ * `match.status`. An owner whose status is `unmatched` needs a decision, or
+ * the confirm is refused with 422. An owner whose status is `placeholder`
+ * (inactive in Salesforce, a rep who left) may only be assigned; without a
+ * decision their records stay on the placeholder, as history.
+ */
+interface MigrationOwnerDecision {
+    /** `invite`: invite the owner to graph8 by email; their records are held for the invited address and become theirs when they first sign in. Invites go out in a member's name, so an API key's confirm with an `invite` decision is refused with 403. `assign`: move only their OPEN deals and OPEN tasks to the graph8 member `assign_to_team_member_id`; contacts, companies and closed records stay on the owner's placeholder. `match`: this Salesforce user IS the graph8 member `assign_to_team_member_id`; EVERY record they own moves to that member. `unassigned`: import their records with no owner. */
+    action: "invite" | "assign" | "unassigned" | "match";
+    /** `assign` and `match` only: the graph8 team member id who receives the records. */
+    assign_to_team_member_id?: string | null;
+    /** `invite` only: the address to invite. Omit to use the owner's Salesforce email. */
+    invite_email?: string | null;
+    /** The owner's Salesforce user id, as discovery listed it in `owners`. */
+    sf_user_id: string;
+}
 /**
  * Mine conversations for content ideas. SPENDS CREDIT, per conversation.
  *
@@ -27550,6 +27628,8 @@ interface developer_api__interfaces__v1__gtm_campaigns_router__CampaignUpdateReq
     name?: string | null;
     /** Primary hook text */
     primary_hook?: string | null;
+    /** Replace the campaign's channels, e.g. ['email','linkedin']. Accepted values: email, linkedin, phone, voice_ai, sms. Omit to leave them unchanged. Existing documents and steps are not deleted. */
+    target_channels?: Array<string> | null;
     /** Target persona */
     target_persona?: string | null;
 }
@@ -61024,10 +61104,14 @@ interface ApiOperationMap {
     list_global_context_documents_global_context_documents_get: {
         input: {
             query?: {
-                /** Filter by context category */
+                /** Filter by context category: brand, audience, messaging, market, offer, targeting, data (case-insensitive). `targeting` matches the Studio Wiki's Targeting group (TAM / ICP / Persona Research). An unknown category that matches no document returns 422 listing the valid categories. */
                 category?: string | null;
                 /** Include each document's body text at `content` (read from meta_data.content). Default True preserves historical behavior (this endpoint has always returned content); pass false for a lighter metadata-only listing. */
                 include_content?: boolean;
+                /** Also list the Wiki's Intelligence documents (website scrape, competitor discovery, organic keywords, brand news, ...) with `workflow`='intelligence' and category 'data'. Metadata only: read a body with GET /intelligence-data ?data_type=<file_type>&include_content=true. Default false (historical shape). */
+                include_intelligence?: boolean;
+                /** Also list the Wiki's Research reports with `workflow`='research' and category 'data'; `content` carries the report markdown when include_content is true. Default false (historical shape). */
+                include_research?: boolean;
                 limit?: number;
             };
             headers?: {
@@ -94246,6 +94330,8 @@ declare const useG8: () => {
                 category?: string;
                 limit?: number;
                 include_content?: boolean;
+                include_intelligence?: boolean;
+                include_research?: boolean;
             }): Promise<{
                 data: GlobalContextDocument[];
             }>;

package/dist/react.d.ts

@@ -403,6 +403,18 @@ interface GlobalContextDocument {
     metadata: Record<string, unknown> | null;
     created_at: string | null;
     updated_at: string | null;
+    /** Fields the endpoint actually returns (the ones above predate them). */
+    display_name?: string | null;
+    file_type?: string | null;
+    folder_path?: string | null;
+    status?: string | null;
+    priority?: number | null;
+    version?: string | number | null;
+    /** The group the Studio Wiki shows the document under (TAM / ICP / Persona
+     * Research are stored as market/audience but shown under "targeting"). */
+    wiki_category?: string;
+    /** Which Wiki bucket the row came from. */
+    workflow?: "context" | "intelligence" | "research";
 }
 interface Persona {
     id: string;
@@ -413,6 +425,20 @@ interface Persona {
     goals: string[];
     channels: string[];
     created_at: string | null;
+    /** Fields GET /personas actually returns (cb_personas columns). The persona's
+     * name is `title`, its "why" is `why_target`, its signals are `key_signals`. */
+    title?: string | null;
+    why_target?: string | null;
+    key_signals?: unknown[];
+    campaign_approach?: string | null;
+    recommended_goal?: string | null;
+    expected_receptivity?: string | null;
+    confidence?: string | null;
+    confidence_score?: number | null;
+    priority?: number | null;
+    pinned?: boolean | null;
+    source?: string | null;
+    updated_at?: string | null;
 }
 interface ICP {
     id: string;
@@ -426,6 +452,24 @@ interface ICP {
     revenue_max: number | null;
     countries: string[] | null;
     created_at: string | null;
+    /** Fields GET /icps actually returns (cb_icps columns). Industries and
+     * company sizes live in `firmographics.industries` / `firmographics.company_sizes`. */
+    firmographics?: {
+        industries?: string[];
+        company_sizes?: string[];
+        revenue_ranges?: string[];
+        geographies?: string[];
+        [key: string]: unknown;
+    };
+    tech_stack?: Record<string, unknown>;
+    buying_signals?: unknown[];
+    fit_score?: number | null;
+    opportunity_score?: number | null;
+    readiness_score?: number | null;
+    total_score?: number | null;
+    pinned?: boolean | null;
+    priority?: number | null;
+    updated_at?: string | null;
 }
 interface IntelligenceData {
     id: string;
@@ -464,6 +508,10 @@ declare const createStudioClient: (apiKey: string, apiUrl?: string) => {
         category?: string;
         limit?: number;
         include_content?: boolean;
+        /** Also list the Wiki's Intelligence documents (metadata only). */
+        include_intelligence?: boolean;
+        /** Also list the Wiki's Research reports. */
+        include_research?: boolean;
     }): Promise<{
         data: GlobalContextDocument[];
     }>;
@@ -3312,10 +3360,14 @@ interface AdCampaignResponse {
     launched_at?: string | null;
     name: string;
     objective?: string | null;
+    /** True when end_date is before today (UTC). Null when the campaign has no end date. */
+    past_end_date?: boolean | null;
     platform: string;
     platform_campaign_id?: string | null;
     start_date?: string | null;
     status: string;
+    /** Plain-language note when the stored status cannot be taken at face value, e.g. the end date has passed but the status still says pending. Null otherwise. */
+    status_note?: string | null;
     sync_config_id: number;
 }
 /**
@@ -8029,6 +8081,8 @@ interface CampaignFullPatchRequest {
     primary_hook?: string | null;
     /** If provided, replaces the sequence step ordering (same as PUT /sequence). */
     sequence_steps?: Array<SequenceStepRef> | null;
+    /** Replace the campaign's channels (email, linkedin, phone, voice_ai, sms). Omit to leave them unchanged. Same as PATCH /campaigns/{id}. */
+    target_channels?: Array<string> | null;
     target_persona?: string | null;
     /** Sequence IDs to UNLINK from this campaign. DELETEs ONLY rows where status='linked'. Launch-audit rows (status='pushed'/'superseded'/'failed') are never touched — those are an immutable historical record. */
     unlink_sequence_ids?: Array<string> | null;
@@ -9003,14 +9057,19 @@ interface ConfirmBookingRequest {
  * This is the irreversible half: records begin landing in graph8 and a
  * migration cannot be un-run, only cancelled part-way.
  *
- * Both fields are OPTIONAL and omitting them accepts the discovery as
+ * Every field is OPTIONAL and omitting them accepts the discovery as
  * proposed - which is the point of previewing it first. Send
- * `field_mappings_override` to change where a CRM field lands, or
- * `selected_list_ids` to import only some lists.
+ * `field_mappings_override` to change where a CRM field lands,
+ * `selected_list_ids` to import only some lists, or `owner_decisions` to say
+ * what happens to the records of Salesforce owners who are not in graph8.
+ * A Salesforce discovery with an `unmatched` owner needs a decision for that
+ * owner: without one the confirm is refused with 422.
  */
 interface ConfirmMigrationRequest {
     /** Per entity type, the mappings to use instead of the discovered ones. Omit to accept what discovery proposed. */
     field_mappings_override?: Record<string, Array<Record<string, unknown>>> | null;
+    /** Salesforce only: one decision per record owner who is not a graph8 member (at most 500). Required for every owner whose `match.status` is `unmatched`; optional `assign` for a `placeholder` owner. `match` moves every record the owner has; `assign` moves only their open deals and open tasks. */
+    owner_decisions?: Array<MigrationOwnerDecision> | null;
     /** Import only these CRM lists. Omit to take every discovered list. */
     selected_list_ids?: Array<string> | null;
 }
@@ -16951,6 +17010,25 @@ interface MergeRecordRequest {
 interface MessageSendRequest {
     text: string;
 }
+/**
+ * What happens to the records of one Salesforce record owner who is not a graph8 member.
+ *
+ * Discovery lists every record owner in the status's `owners`, each with a
+ * `match.status`. An owner whose status is `unmatched` needs a decision, or
+ * the confirm is refused with 422. An owner whose status is `placeholder`
+ * (inactive in Salesforce, a rep who left) may only be assigned; without a
+ * decision their records stay on the placeholder, as history.
+ */
+interface MigrationOwnerDecision {
+    /** `invite`: invite the owner to graph8 by email; their records are held for the invited address and become theirs when they first sign in. Invites go out in a member's name, so an API key's confirm with an `invite` decision is refused with 403. `assign`: move only their OPEN deals and OPEN tasks to the graph8 member `assign_to_team_member_id`; contacts, companies and closed records stay on the owner's placeholder. `match`: this Salesforce user IS the graph8 member `assign_to_team_member_id`; EVERY record they own moves to that member. `unassigned`: import their records with no owner. */
+    action: "invite" | "assign" | "unassigned" | "match";
+    /** `assign` and `match` only: the graph8 team member id who receives the records. */
+    assign_to_team_member_id?: string | null;
+    /** `invite` only: the address to invite. Omit to use the owner's Salesforce email. */
+    invite_email?: string | null;
+    /** The owner's Salesforce user id, as discovery listed it in `owners`. */
+    sf_user_id: string;
+}
 /**
  * Mine conversations for content ideas. SPENDS CREDIT, per conversation.
  *
@@ -27550,6 +27628,8 @@ interface developer_api__interfaces__v1__gtm_campaigns_router__CampaignUpdateReq
     name?: string | null;
     /** Primary hook text */
     primary_hook?: string | null;
+    /** Replace the campaign's channels, e.g. ['email','linkedin']. Accepted values: email, linkedin, phone, voice_ai, sms. Omit to leave them unchanged. Existing documents and steps are not deleted. */
+    target_channels?: Array<string> | null;
     /** Target persona */
     target_persona?: string | null;
 }
@@ -61024,10 +61104,14 @@ interface ApiOperationMap {
     list_global_context_documents_global_context_documents_get: {
         input: {
             query?: {
-                /** Filter by context category */
+                /** Filter by context category: brand, audience, messaging, market, offer, targeting, data (case-insensitive). `targeting` matches the Studio Wiki's Targeting group (TAM / ICP / Persona Research). An unknown category that matches no document returns 422 listing the valid categories. */
                 category?: string | null;
                 /** Include each document's body text at `content` (read from meta_data.content). Default True preserves historical behavior (this endpoint has always returned content); pass false for a lighter metadata-only listing. */
                 include_content?: boolean;
+                /** Also list the Wiki's Intelligence documents (website scrape, competitor discovery, organic keywords, brand news, ...) with `workflow`='intelligence' and category 'data'. Metadata only: read a body with GET /intelligence-data ?data_type=<file_type>&include_content=true. Default false (historical shape). */
+                include_intelligence?: boolean;
+                /** Also list the Wiki's Research reports with `workflow`='research' and category 'data'; `content` carries the report markdown when include_content is true. Default false (historical shape). */
+                include_research?: boolean;
                 limit?: number;
             };
             headers?: {
@@ -94246,6 +94330,8 @@ declare const useG8: () => {
                 category?: string;
                 limit?: number;
                 include_content?: boolean;
+                include_intelligence?: boolean;
+                include_research?: boolean;
             }): Promise<{
                 data: GlobalContextDocument[];
             }>;

package/dist/react.js

@@ -981,7 +981,7 @@ var EXTERNAL_ROUTES = {
 };
 
 // src/version.ts
-var SDK_VERSION = "0.358.0";
+var SDK_VERSION = "0.361.0";
 var SDK_CLIENT_ID = `js-sdk/${SDK_VERSION}`;
 
 // src/http.ts