@graph8/sdk 0.358.0 → 0.362.0

package/dist/types/blocks/create.d.ts

@@ -8,7 +8,7 @@
  * block registry; writes only inside `<dir>`.
  */
 import { type AddIO, type PackageManager } from "./add";
-import { type Registry, type Stack } from "./registry";
+import { type Registry, type Stack, type StackNav } from "./registry";
 export declare const CREATE_USAGE = "Usage: npx @graph8/sdk create <stack> <dir> [options]\n\nScaffold a Next.js (App Router, TypeScript, Tailwind CSS v4) app for a stack and\ninstall the stack's blocks into it. Run `graph8-sdk list` to see the stacks.\n  --package-manager <npm|pnpm|yarn|bun>   default: the one running the command, else npm\n  --no-install      write the files and blocks, do not install dependencies\n  --dry-run         print what would be written, write and install nothing\n  --force           allow a non-empty <dir> (template files are overwritten, and graph8.json\n                    is reset: blocks you added to that app earlier are no longer recorded)\nThen: set G8_API_KEY in <dir>/.env.local and run `npx @graph8/sdk doctor --stack <stack>`.";
 export interface CreateOptions {
     stack: string;
@@ -40,6 +40,20 @@ interface OutFile {
 export declare function pageFileFor(navPath: string): string;
 /** Why this stack cannot be scaffolded, or null. */
 export declare function stackProblem(reg: Registry, stack: Stack): string | null;
+/** Absolute path of a nav entry's hand-written page template, or null when it uses the generic route page. */
+export declare function stackPageFile(reg: Registry, stack: Stack, n: StackNav): string | null;
+/** True when any nav entry uses `icon`, `group` or `description`. */
+export declare function navUsesExtras(stack: Stack): boolean;
+/**
+ * The three pieces of `lib/nav.ts`. A stack that uses none of the optional nav fields gets exactly the
+ * plain `{ label, path }[]` file it always did; otherwise a typed `NavItem[]` whose icons are real
+ * lucide-react imports (only the ones used).
+ */
+export declare function navParts(stack: Stack): {
+    navImports: string;
+    navType: string;
+    navJson: string;
+};
 export declare function planCreate(reg: Registry, stack: Stack, appName: string, pm: PackageManager, io: CreateIO): OutFile[];
 /** Run `create`. Returns the process exit code. */
 export declare function runCreate(opts: CreateOptions, reg: Registry, io: CreateIO, cwd: string): number;

package/dist/types/blocks/doctor.d.ts

@@ -7,11 +7,12 @@
  * never printed, not even in an error.
  */
 import { type Registry } from "./registry";
-export declare const DOCTOR_USAGE = "Usage: npx @graph8/sdk doctor [--stack <id>] [--blocks a,b] [--dir <path>]\n\nCheck that this project is ready for graph8 blocks:\n  - G8_API_KEY (env or .env.local) is valid\n  - the key's scopes cover the blocks you chose\n  - the organization's subscription is active\n  - a checklist of in-app setup each block needs\nWith no --stack/--blocks, the blocks recorded in graph8.json are checked.\nOptional G8_API_URL points at a non-default API. Exit code 0 when all checks\npass, 1 otherwise.";
+export declare const DOCTOR_USAGE = "Usage: npx @graph8/sdk doctor [--stack <id>] [--blocks a,b] [--dir <path>] [--strict]\n\nCheck that this project is ready for graph8 blocks:\n  - G8_API_KEY (env or .env.local) is valid\n  - the key's scopes cover the blocks you chose\n  - the organization's subscription is active\n  - a checklist of in-app setup each block needs\nWith --stack it also lists \"Flows\": block components that no page of the stack reaches\n(a warning; --strict makes them fail the run).\nWith no --stack/--blocks, the blocks recorded in graph8.json are checked.\nOptional G8_API_URL points at a non-default API. Exit code 0 when all checks\npass, 1 otherwise.";
 export interface DoctorOptions {
     stack?: string;
     blocks: string[];
     dir: string;
+    strict?: boolean;
 }
 export declare function parseDoctorArgs(argv: string[]): DoctorOptions;
 export interface DoctorIO {

package/dist/types/blocks/flows.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Flow reachability for `graph8-sdk doctor --stack <id>`.
+ *
+ * A generated app is only as useful as the components its pages reach. This walks
+ * the imports from every page the stack generates (the nav component, or a
+ * hand-written page template's imports), through the block sources, and reports the
+ * block components nothing reaches: a flow the block ships but the app never shows.
+ *
+ * Node only. Reads block sources and stack page templates; writes nothing.
+ */
+import { type Registry, type Stack } from "./registry";
+export interface UnreachedComponent {
+    block: string;
+    component: string;
+}
+/**
+ * Components of the stack's own blocks (the foundation's shared UI is exempt) that no
+ * generated page reaches, directly or through a Screen that imports them.
+ */
+export declare function unreachedComponents(reg: Registry, stack: Stack): UnreachedComponent[];

package/dist/types/blocks/registry.d.ts

@@ -75,6 +75,14 @@ export interface StackNav {
     component: string;
     /** JSON props the route passes to the component. */
     props?: Record<string, unknown>;
+    /** lucide-react export name shown beside the label in the sidebar. */
+    icon?: string;
+    /** Sidebar section label; entries with the same group sit together. */
+    group?: string;
+    /** One line about the screen (tooltips, a home grid). */
+    description?: string;
+    /** Hand-written page template, relative to `stacks/<stack-id>/` (`pages/*.tsx.tmpl`), used instead of the generic route page. */
+    page?: string;
 }
 export interface Stack {
     id: string;
@@ -84,10 +92,14 @@ export interface Stack {
     status: "available" | "planned";
     blocks: string[];
     nav: StackNav[];
+    /** A nav path that `/` redirects to (default: `/` itself when it is a nav entry, else the first entry). */
+    home?: string;
 }
 export interface Registry {
     blocks: Block[];
     stacks: Stack[];
+    /** Directory holding `<stack-id>.json` and `<stack-id>/pages/*`. Set by `loadRegistry`. */
+    stacksRoot?: string;
 }
 /**
  * Load every block under `<blocksRoot>` and every stack under the sibling
@@ -105,7 +117,10 @@ export declare function resolveWithDeps(reg: Registry, ids: string[]): Block[];
 export declare function searchBlocks(reg: Registry, text: string): Block[];
 /** Stacks matching the same way (id, title, summary). */
 export declare function searchStacks(reg: Registry, text: string): Stack[];
+/** Finished screens of a block: components named `<Something>Screen`. Customer agents should reach for these first. */
+export declare function screenNames(b: Block): string[];
 export declare function blockSummary(b: Block): {
+    screens?: string[] | undefined;
     id: string;
     title: string;
     summary: string;

package/dist/types/core.d.ts

@@ -888,6 +888,8 @@ declare class G8 {
             category?: string;
             limit?: number;
             include_content?: boolean;
+            include_intelligence?: boolean;
+            include_research?: boolean;
         }): Promise<{
             data: import("./studio").GlobalContextDocument[];
         }>;
@@ -899,8 +901,7 @@ declare class G8 {
         }>;
         personas(params?: {
             status?: string;
-            limit
-            /** @internal */ ? /** @internal */: number;
+            limit?: number;
         }): Promise<{
             data: import("./studio").Persona[];
         }>;

package/dist/types/react.d.ts

@@ -824,6 +824,8 @@ export declare const useG8: () => {
                 category?: string;
                 limit?: number;
                 include_content?: boolean;
+                include_intelligence?: boolean;
+                include_research?: boolean;
             }): Promise<{
                 data: import("./studio").GlobalContextDocument[];
             }>;

package/dist/types/studio.d.ts

@@ -6,6 +6,18 @@ export 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";
 }
 export interface Persona {
     id: string;
@@ -16,6 +28,20 @@ export 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;
 }
 export interface ICP {
     id: string;
@@ -29,6 +55,24 @@ export 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;
 }
 export interface IntelligenceData {
     id: string;
@@ -67,6 +111,10 @@ export 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[];
     }>;

package/dist/types/version.d.ts

@@ -5,6 +5,6 @@
  * both together (the version-parity gate already pins package.json, the
  * lockfile and the CHANGELOG to each other).
  */
-export declare const SDK_VERSION = "0.358.0";
+export declare const SDK_VERSION = "0.362.0";
 /** Value of the `X-G8-Client` header every SDK request carries (I-13). */
-export declare const SDK_CLIENT_ID = "js-sdk/0.358.0";
+export declare const SDK_CLIENT_ID = "js-sdk/0.362.0";

package/docs/api/adCampaigns.d.ts

@@ -425,10 +425,14 @@ export 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;
 }
 

package/docs/api/adCampaigns.md

@@ -324,8 +324,10 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `google_campaign_subtype` | `string \| null` | no |  |
 | `launched_at` | `string \| null` | no |  |
 | `objective` | `string \| null` | no |  |
+| `past_end_date` | `boolean \| null` | no | True when end_date is before today (UTC). Null when the campaign has no end date. |
 | `platform_campaign_id` | `string \| null` | no |  |
 | `start_date` | `string \| null` | no |  |
+| `status_note` | `string \| null` | no | 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. |
 
 **Example**
 
@@ -598,8 +600,10 @@ Other envelope fields: `pagination` (PaginationMeta).
 | `google_campaign_subtype` | `string \| null` | no |  |
 | `launched_at` | `string \| null` | no |  |
 | `objective` | `string \| null` | no |  |
+| `past_end_date` | `boolean \| null` | no | True when end_date is before today (UTC). Null when the campaign has no end date. |
 | `platform_campaign_id` | `string \| null` | no |  |
 | `start_date` | `string \| null` | no |  |
+| `status_note` | `string \| null` | no | 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. |
 
 **Example**
 

package/docs/api/gtmCampaigns.d.ts

@@ -529,6 +529,8 @@ export 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;
@@ -659,6 +661,8 @@ export interface developer_api__interfaces__v1__gtm_campaigns_router__CampaignUp
   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;
 }

package/docs/api/gtmCampaigns.md

@@ -816,6 +816,7 @@ Body fields (`CampaignFullPatchRequest`):
 | `body.name` | `string \| null` | no | max length 255 |
 | `body.primary_hook` | `string \| null` | no |  |
 | `body.sequence_steps` | `Array<SequenceStepRef> \| null` | no | If provided, replaces the sequence step ordering (same as PUT /sequence). |
+| `body.target_channels` | `Array<string> \| null` | no | Replace the campaign's channels (email, linkedin, phone, voice_ai, sms). Omit to leave them unchanged. Same as PATCH /campaigns/{id}. |
 | `body.target_persona` | `string \| null` | no | max length 200 |
 | `body.unlink_sequence_ids` | `Array<string> \| null` | no | 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. |
 
@@ -862,6 +863,7 @@ Body fields (`developer_api__interfaces__v1__gtm_campaigns_router__CampaignUpdat
 | `body.goal` | `string \| null` | no | Campaign goal max length 255 |
 | `body.name` | `string \| null` | no | Campaign name max length 255 |
 | `body.primary_hook` | `string \| null` | no | Primary hook text |
+| `body.target_channels` | `Array<string> \| null` | no | 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. |
 | `body.target_persona` | `string \| null` | no | Target persona max length 200 |
 
 **Returns** `ApiResponse_dict_`: the envelope `{ data: Record<string, unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.

package/docs/api/gtmContext.d.ts

@@ -399,10 +399,14 @@ export interface GtmContextOperations {
   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?: {

package/docs/api/gtmContext.md

@@ -915,21 +915,29 @@ const result = await g8.api.gtmContext.listActivities();
 List global context documents for the authenticated organization.
 
 Each row carries metadata (id, display_name, file_type, category,
-folder_path, status, priority, version, timestamps). When
-``include_content`` is True (the default) the document body is included at
-``content`` (sourced from ``meta_data.content``) so callers can read what a
-document actually says; pass ``include_content=false`` to omit the body for
-a cheaper listing. The default stays True for backwards compatibility — the
-MCP ``g8_gtm_get_global_context`` tool, the JS SDK ``studio.globalContext``
+folder_path, status, priority, version, timestamps), plus `wiki_category`
+(the group the Studio Wiki shows it under) and `workflow` (context,
+intelligence or research). When ``include_content`` is True (the default)
+the document body is included at ``content`` (sourced from
+``meta_data.content``) so callers can read what a document actually says;
+pass ``include_content=false`` to omit the body for a cheaper listing. The
+default stays True for backwards compatibility — the MCP
+``g8_gtm_get_global_context`` tool, the JS SDK ``studio.globalContext``
 client, and the ``g8://global-context`` resource surfaces have always relied
 on ``content`` being present.
 
+``include_intelligence`` / ``include_research`` add the Wiki's other two
+buckets so a caller can see every Wiki document in one call; ``limit``
+applies to each bucket.
+
 **Input**
 
 | Field | Type | Required | Description |
 |---|---|---|---|
-| `query.category` | `string \| null` | no | Filter by context category |
+| `query.category` | `string \| null` | no | 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. |
 | `query.include_content` | `boolean` | no | 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. default `true` |
+| `query.include_intelligence` | `boolean` | no | 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). default `false` |
+| `query.include_research` | `boolean` | no | 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). default `false` |
 | `query.limit` | `integer` | no | default `50` |
 
 **Returns** `ApiResponse_list_dict__`: the envelope `{ data: Array<Record<string, unknown>>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.

package/docs/api/integrations.d.ts

@@ -1549,7 +1549,7 @@ export interface IntegrationsOperations {
   };
 }
 
-// 64 schemas referenced above (the same as G8Contract.<Name>).
+// 65 schemas referenced above (the same as G8Contract.<Name>).
 
 /**
  * A list of ad-platform objects.
@@ -1653,14 +1653,19 @@ export interface BatchGetByEmailRequest {
  * 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.
  */
 export 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;
 }
@@ -2025,6 +2030,26 @@ export interface LeadUpdateRequest {
   website?: string | null;
 }
 
+/**
+ * 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.
+ */
+export 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;
+}
+
 /**
  * Add and/or remove contacts from one CRM list, in a single call.
  *

package/docs/api/integrations.md

@@ -268,6 +268,7 @@ Body fields (`ConfirmMigrationRequest`):
 | Field | Type | Required | Description |
 |---|---|---|---|
 | `body.field_mappings_override` | `Record<string, Array<Record<string, unknown>>> \| null` | no | Per entity type, the mappings to use instead of the discovered ones. Omit to accept what discovery proposed. |
+| `body.owner_decisions` | `Array<MigrationOwnerDecision> \| null` | no | 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. max items 500 |
 | `body.selected_list_ids` | `Array<string> \| null` | no | Import only these CRM lists. Omit to take every discovered list. |
 
 **Returns** `ApiResponse_ConnectionPayload_`: the envelope `{ data: ConnectionPayload, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
@@ -3789,3 +3790,16 @@ One provider-side custom field. `field_name` is the CRM's API name, not its labe
 |---|---|---|---|
 | `phone` | `string` | yes |  |
 | `phone_type` | `string \| null` | no |  |
+
+<a id="type-migrationownerdecision"></a>
+
+### `MigrationOwnerDecision`
+
+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.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `action` | `"invite" \| "assign" \| "unassigned" \| "match"` | yes | `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 owne… |
+| `sf_user_id` | `string` | yes | The owner's Salesforce user id, as discovery listed it in `owners`. min length 1, max length 64 |
+| `assign_to_team_member_id` | `string \| null` | no | `assign` and `match` only: the graph8 team member id who receives the records. max length 64 |
+| `invite_email` | `string \| null` | no | `invite` only: the address to invite. Omit to use the owner's Salesforce email. max length 320 |

package/docs/sdk-clients.md

@@ -3593,7 +3593,7 @@ Create a buyer persona manually (no AI generation). Requires title + website_url
 ### `g8.studio.globalContext`
 
 ```ts
-g8.studio.globalContext: (params?: { category?: string; limit?: number; include_content?: boolean; }) => Promise<{ data: GlobalContextDocument[]; }>
+g8.studio.globalContext: (params?: { category?: string; limit?: number; include_content?: boolean; include_intelligence?: boolean; include_research?: boolean; }) => Promise<{ data: GlobalContextDocument[]; }>
 ```
 
 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`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graph8/sdk",
-  "version": "0.358.0",
+  "version": "0.362.0",
   "description": "graph8 SDK - CRM, enrichment, sequences, campaigns, and tracking for B2B",
   "license": "MIT",
   "author": "graph8 <support@graph8.com> (https://graph8.com)",

package/stacks/stack.schema.json

@@ -13,6 +13,7 @@
     "summary": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[^\\n]+$" },
     "status": { "enum": ["available", "planned"], "default": "available", "description": "available: every block exists in blocks/, `create` can scaffold it, and CI checks every reference. planned: some blocks are still being built; CI skips the block references and `create` refuses with the missing blocks. Optional, default available." },
     "blocks": { "type": "array", "items": { "type": "string", "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$" }, "uniqueItems": true, "minItems": 1, "description": "Install order: every block's dependencies come earlier." },
+    "home": { "type": "string", "pattern": "^/[A-Za-z0-9/_\\-]*$", "description": "Optional nav path that `/` redirects to. Default: `/` when it is a nav entry, else the first entry." },
     "nav": {
       "type": "array",
       "items": {
@@ -24,7 +25,11 @@
           "path": { "type": "string", "pattern": "^/[A-Za-z0-9/_\\-]*$", "description": "A static route; it is a sidebar link, so no dynamic [segments]." },
           "block": { "type": "string", "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$" },
           "component": { "type": "string", "pattern": "^[A-Z][A-Za-z0-9]*$" },
-          "props": { "type": "object", "description": "Optional JSON props passed to the component on its route. For a component that needs input to render anything." }
+          "props": { "type": "object", "description": "Optional JSON props passed to the component on its route. For a component that needs input to render anything." },
+          "icon": { "type": "string", "pattern": "^[A-Z][A-Za-z0-9]*$", "description": "Optional lucide-react export name (for example Users) shown beside the label in the sidebar." },
+          "group": { "type": "string", "minLength": 1, "description": "Optional sidebar section label. Entries with the same group sit together." },
+          "description": { "type": "string", "minLength": 1, "description": "Optional one line about the screen." },
+          "page": { "type": "string", "pattern": "^pages/[A-Za-z0-9_\\-/]+\\.tsx\\.tmpl$", "description": "Optional hand-written page template, relative to stacks/<stack-id>/. `create` writes it as the route's page.tsx instead of the generic route page; {{stackId}}, {{block}}, {{blockDir}}, {{component}}, {{importPath}} and {{propsJson}} are available." }
         }
       }
     }