@graph8/sdk 0.303.0 → 0.357.0

package/dist/types/agentSetup.d.ts

@@ -26,15 +26,15 @@ export declare const ALL_TARGETS: readonly AgentTarget[];
 export declare const MARKER_START = "<!-- graph8-sdk:start (managed by `npx @graph8/sdk init-agent`; edits inside are overwritten) -->";
 export declare const MARKER_END = "<!-- graph8-sdk:end -->";
 /** The rules every agent gets, whatever file they land in. */
-export declare function coreInstructions(): string;
-export declare function claudeSkill(): string;
-export declare function cursorRule(): string;
-export declare function agentsMdSection(): string;
+export declare function coreInstructions(catalog?: string): string;
+export declare function claudeSkill(catalog?: string): string;
+export declare function cursorRule(catalog?: string): string;
+export declare function agentsMdSection(catalog?: string): string;
 /**
  * Insert or replace the managed section in an existing AGENTS.md, leaving
  * everything outside the markers byte-for-byte unchanged.
  */
-export declare function upsertAgentsMd(existing: string | null): string;
+export declare function upsertAgentsMd(existing: string | null, catalog?: string): string;
 export interface PlannedWrite {
     target: AgentTarget;
     path: string;
@@ -48,7 +48,7 @@ export interface PlannedWrite {
  * current content (or null when it does not exist); paths are relative to the
  * project root.
  */
-export declare function planAgentSetup(targets: readonly AgentTarget[], read: (path: string) => string | null): PlannedWrite[];
+export declare function planAgentSetup(targets: readonly AgentTarget[], read: (path: string) => string | null, catalog?: string): PlannedWrite[];
 export interface InitAgentOptions {
     targets: AgentTarget[];
     dryRun: boolean;

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

@@ -0,0 +1,53 @@
+/**
+ * `graph8-sdk add <block>[/<Component>]`: copy a block's source into the user's
+ * app (shadcn style: the code becomes theirs), resolve its dependencies, wire
+ * the Next proxy route, install missing peer dependencies and record what was
+ * installed in `graph8.json`.
+ *
+ * Never overwrites a file that differs from the template unless `--force`;
+ * prints a diff summary instead. Re-running is a no-op.
+ */
+import { type Block, type Registry } from "./registry";
+export declare const ADD_USAGE = "Usage: npx @graph8/sdk add <block>[/<Component>] [options]\n\nCopy a graph8 block (components, hooks, recipes) into your app. The block's\ndependencies (always including `foundation`) are added first.\n  --dir <path>      project root (default: current directory)\n  --target <path>   where to copy, relative to --dir (default: components/g8)\n  --dry-run         print what would change, write and install nothing\n  --force           overwrite files that differ from the template\n  --no-install      do not install missing peer dependencies\nExisting files are never overwritten without --force. Installed blocks are\nrecorded in graph8.json so re-runs do nothing.";
+export interface AddOptions {
+    spec: string;
+    dir: string;
+    target?: string;
+    dryRun: boolean;
+    force: boolean;
+    install: boolean;
+}
+export declare function parseAddArgs(argv: string[]): AddOptions;
+export type PackageManager = "pnpm" | "yarn" | "bun" | "npm";
+export declare function detectPackageManager(root: string): PackageManager;
+export declare function installCommand(pm: PackageManager, packages: string[]): {
+    cmd: string;
+    args: string[];
+};
+export interface AddIO {
+    out: (line: string) => void;
+    err: (line: string) => void;
+    /** Run a command in `cwd`; returns the exit code. */
+    spawn: (cmd: string, args: string[], cwd: string) => number;
+}
+/** Where a file at `rel` (inside the block dir) lands, relative to the block's install dir. */
+export declare function installedRel(rel: string): string | null;
+interface RewriteCtx {
+    reg: Registry;
+    targetAbs: string;
+    /** Block the file belongs to (for relative imports), if any. */
+    block?: Block;
+    srcFile?: string;
+    /** Absolute directory the rewritten file will live in. */
+    destDir: string;
+}
+/**
+ * Make a copied file self-contained: `@/g8/<block>/<path>` becomes a relative
+ * path to where that file was installed, and a relative import that crossed the
+ * source layout (components are flattened) is recomputed.
+ */
+export declare function rewriteImports(content: string, ctx: RewriteCtx): string;
+export declare function diffSummary(before: string, after: string): string;
+/** Run `add`. Returns the process exit code. */
+export declare function runAdd(opts: AddOptions, reg: Registry, io: AddIO, cwd: string): number;
+export {};

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

@@ -0,0 +1,46 @@
+/**
+ * `graph8-sdk create <stack> <dir>`: scaffold a Next.js app (App Router,
+ * TypeScript, Tailwind v4) from the in-package template, wire the stack's
+ * screens into a sidebar, install the stack's blocks through the SAME code path
+ * as `graph8-sdk add`, then install dependencies.
+ *
+ * Node only. Reads `templates/next-app/**` (shipped in the package) and the
+ * block registry; writes only inside `<dir>`.
+ */
+import { type AddIO, type PackageManager } from "./add";
+import { type Registry, type Stack } 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;
+    dir: string;
+    packageManager?: PackageManager;
+    install: boolean;
+    dryRun: boolean;
+    force: boolean;
+}
+export declare function parseCreateArgs(argv: string[]): CreateOptions;
+export interface CreateIO extends AddIO {
+    /** Directory holding `next-app/` (the package's `templates/`). */
+    templatesRoot: string;
+    /** The package's own package.json (for the UI kit's peer dependencies). */
+    sdkPackageJson?: string;
+    /** npm_config_user_agent, to default the package manager. */
+    userAgent?: string;
+}
+export declare function packageManagerFromUserAgent(ua: string | undefined): PackageManager;
+/** A valid npm package name from a directory name. */
+export declare function appNameFor(dir: string): string;
+/** Replace `{{key}}`; a placeholder with no value is a template bug, not something to ship. */
+export declare function render(template: string, vars: Record<string, string>): string;
+interface OutFile {
+    rel: string;
+    content: string;
+}
+/** Route file for a nav path: `/` -> app/page.tsx, `/a/b` -> app/a/b/page.tsx. */
+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;
+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;
+export {};

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

@@ -0,0 +1,26 @@
+/**
+ * `graph8-sdk doctor`: is this project ready to run the chosen blocks?
+ *
+ * Calls the real Developer API with the project's key (`/me` and
+ * `/usage/subscription`), compares the key's scopes with what the blocks need,
+ * and prints the blocks' in-app prerequisites as a human checklist. The key is
+ * 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 interface DoctorOptions {
+    stack?: string;
+    blocks: string[];
+    dir: string;
+}
+export declare function parseDoctorArgs(argv: string[]): DoctorOptions;
+export interface DoctorIO {
+    out: (line: string) => void;
+    err: (line: string) => void;
+    env: Record<string, string | undefined>;
+    fetch?: typeof fetch;
+}
+/** Same rules as the server's `key_has_scope`. */
+export declare function scopeGranted(granted: string[], required: string): boolean;
+/** Run doctor. Returns the exit code: 0 when every check passes. */
+export declare function runDoctor(opts: DoctorOptions, reg: Registry, io: DoctorIO, cwd: string): Promise<number>;

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

@@ -0,0 +1,134 @@
+/**
+ * Block and stack registry for the `graph8-sdk` CLI.
+ *
+ * Blocks ship INSIDE the npm package at `blocks/<dir>/block.json` and stacks at
+ * `stacks/<id>.json` (siblings of `dist/`). The CLI reads them from disk at run
+ * time, so it works the same against the real package and against test
+ * fixtures: only the root directory changes.
+ *
+ * Node only. Pure of side effects except reading files.
+ */
+export interface BlockComponent {
+    name: string;
+    file: string;
+    purpose?: string;
+    operations?: string[];
+    tiers?: string[];
+}
+export interface BlockHook {
+    name: string;
+    file: string;
+    purpose?: string;
+    operations?: string[];
+}
+export interface BlockServerFile {
+    file: string;
+    purpose?: string;
+    /** Where the file installs. `g8/<path>` means inside the block's install dir; anything else is project-root relative. */
+    target?: string;
+}
+export interface BlockRecipe {
+    file: string;
+    title?: string;
+    when?: string;
+}
+export interface BlockPrerequisite {
+    id: string;
+    description: string;
+    where: "app" | "api";
+    verify?: string;
+}
+export interface BlockManifest {
+    id: string;
+    title: string;
+    summary: string;
+    features: string[];
+    dependsOn: string[];
+    operations: string[];
+    components: BlockComponent[];
+    hooks: BlockHook[];
+    lib: {
+        file: string;
+        purpose?: string;
+    }[];
+    server: BlockServerFile[];
+    recipes: BlockRecipe[];
+    prerequisites: BlockPrerequisite[];
+    scopes: string[];
+    defaults: {
+        decision: string;
+        default: string;
+        askHuman?: boolean;
+    }[];
+    peerDependencies: Record<string, string>;
+}
+export interface Block extends BlockManifest {
+    /** Directory name under `blocks/` (`_foundation` for the `foundation` block). */
+    dir: string;
+    /** Absolute path of the block directory. */
+    root: string;
+}
+export interface StackNav {
+    label: string;
+    path: string;
+    block: string;
+    component: string;
+    /** JSON props the route passes to the component. */
+    props?: Record<string, unknown>;
+}
+export interface Stack {
+    id: string;
+    title: string;
+    summary: string;
+    /** As declared in the manifest (default `available`). Use `stackStatus` for the effective status. */
+    status: "available" | "planned";
+    blocks: string[];
+    nav: StackNav[];
+}
+export interface Registry {
+    blocks: Block[];
+    stacks: Stack[];
+}
+/**
+ * Load every block under `<blocksRoot>` and every stack under the sibling
+ * `stacks/` directory. A missing directory is an empty registry, not an error:
+ * an older package without blocks must still run `init-agent`.
+ */
+export declare function loadRegistry(blocksRoot: string): Registry;
+export declare function findBlock(reg: Registry, id: string): Block | undefined;
+/**
+ * The block plus everything it depends on, dependencies first (so `foundation`
+ * comes before anything that needs it). Throws on an unknown id or a cycle.
+ */
+export declare function resolveWithDeps(reg: Registry, ids: string[]): Block[];
+/** Blocks whose id, title, summary, features or component names contain `text`. */
+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[];
+export declare function blockSummary(b: Block): {
+    id: string;
+    title: string;
+    summary: string;
+    dependsOn: string[];
+    components: string[];
+};
+/**
+ * Effective status of a stack. A stack is creatable only when every block it
+ * names exists in this package; `missing` lists the ones that do not yet (they
+ * are being built in other releases), whatever the manifest declares.
+ */
+export declare function stackStatus(reg: Registry, s: Stack): {
+    status: "available" | "planned";
+    missing: string[];
+};
+export interface StackSummary {
+    id: string;
+    title: string;
+    summary: string;
+    blocks: string[];
+    status?: "available" | "planned";
+    missingBlocks?: string[];
+}
+export declare function stackSummary(s: Stack, reg?: Registry): StackSummary;
+/** One-line catalog for `init-agent`, or undefined when the package ships no blocks. */
+export declare function catalogSection(reg: Registry): string | undefined;

package/dist/types/cli.d.ts

@@ -2,6 +2,8 @@
  * The `@graph8/sdk` command line (the package's `bin`), run with npx:
  *
  *   npx @graph8/sdk init-agent [--claude] [--codex] [--cursor] [--dry-run]
+ *   npx @graph8/sdk list | search <text> | add <block>[/<Component>] | doctor
+ *   npx @graph8/sdk create <stack> <dir>
  *
  * Node only. Built as a separate entry (dist/cli.js), so nothing here reaches
  * the browser bundle or the package's main exports.
@@ -10,5 +12,19 @@ export interface CliIO {
     cwd: string;
     out: (line: string) => void;
     err: (line: string) => void;
+    /** Directory holding `block.json` folders. Default: $G8_BLOCKS_DIR, else the package's own `blocks/`. */
+    blocksRoot?: string;
+    /** Directory holding `next-app/`. Default: $G8_TEMPLATES_DIR, else the package's own `templates/`. */
+    templatesRoot?: string;
+    /** npm_config_user_agent for `create`'s package-manager default. Default: process.env. */
+    userAgent?: string;
+    /** Run a command, return its exit code. Default: spawnSync with inherited stdio. */
+    spawn?: (cmd: string, args: string[], cwd: string) => number;
+    /** Environment for `doctor`. Default: process.env. */
+    env?: Record<string, string | undefined>;
+    /** fetch for `doctor`. Default: global fetch. */
+    fetch?: typeof fetch;
 }
 export declare function runCli(argv: string[], io: CliIO): number;
+/** Like `runCli`, plus the commands that talk to the network (`doctor`). */
+export declare function runCliAsync(argv: string[], io: CliIO): Promise<number>;

package/dist/types/core.d.ts

@@ -241,7 +241,7 @@ declare class G8 {
     /** Webhook event listeners (requires API key). */
     get webhooks(): {
         baseUrl: string;
-        knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.restored", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.call_connected", "engagement.call_graded", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled", "deal.won", "crm.record.created", "crm.record.updated", "crm.record.archived", "crm.record.restored", "sequence.contact_enrolled", "sequence.contact_removed", "sequence.step_completed", "sequence.step_failed", "engagement.contact_unsubscribed", "engagement.sms_delivered", "engagement.sms_failed", "engagement.whatsapp_delivered", "engagement.whatsapp_failed", "engagement.call_started", "engagement.call_completed", "engagement.call_disposition_set", "engagement.voicemail_detected", "engagement.voicemail_left", "engagement.email_clicked", "engagement.link_clicked", "engagement.call_recording_ready", "meeting.no_show", "voice_ai.call_started", "voice_ai.call_completed", "voice_ai.voicemail_left", "deal.created", "deal.updated", "deal.stage_changed", "deal.deleted", "quote.created", "quote.updated", "quote.sent", "quote.resent", "quote.resend_failed", "quote.link_generated", "quote.viewed", "quote.accepted", "quote.declined", "quote.expired", "quote.voided", "quote.superseded", "quote.archived", "quote.unarchived", "quote.payment_received", "quote.payment_failed", "quote.subscription_canceled", "quote.provisioned", "form.submitted", "visitor.identified", "intent.signal", "task.created", "task.updated", "task.completed", "task.deleted", "enrichment.job_completed", "enrichment.job_failed", "workflow.execution_completed", "workflow.execution_failed"];
+        knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.restored", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.call_connected", "engagement.call_graded", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled", "deal.won", "crm.record.created", "crm.record.updated", "crm.record.archived", "crm.record.restored", "sequence.contact_enrolled", "sequence.contact_removed", "sequence.step_completed", "sequence.step_failed", "engagement.contact_unsubscribed", "engagement.sms_delivered", "engagement.sms_failed", "engagement.whatsapp_delivered", "engagement.whatsapp_failed", "engagement.call_started", "engagement.call_completed", "engagement.call_disposition_set", "engagement.voicemail_detected", "engagement.voicemail_left", "engagement.email_clicked", "engagement.link_clicked", "engagement.call_recording_ready", "meeting.no_show", "voice_ai.call_started", "voice_ai.call_completed", "voice_ai.voicemail_left", "deal.created", "deal.updated", "deal.stage_changed", "deal.deleted", "quote.created", "quote.updated", "quote.sent", "quote.resent", "quote.resend_failed", "quote.link_generated", "quote.viewed", "quote.accepted", "quote.declined", "quote.expired", "quote.voided", "quote.superseded", "quote.archived", "quote.unarchived", "quote.payment_received", "quote.payment_failed", "quote.subscription_canceled", "quote.provisioned", "quote.approval_requested", "quote.approved", "quote.rejected", "quote.forwarded_for_signature", "quote.forwarded_for_payment", "quote.signer_change_requested", "quote.signer_change_approved", "quote.signer_change_rejected", "form.submitted", "visitor.identified", "intent.signal", "task.created", "task.updated", "task.completed", "task.deleted", "enrichment.job_completed", "enrichment.job_failed", "workflow.execution_completed", "workflow.execution_failed"];
         constructEvent(payload: string, signature: string, timestamp: string | number, secret: string, opts?: import("./webhooks").ConstructEventOptions): import("./webhooks").WebhookEventPayload;
     };
     /** Contacts CRUD (requires API key). */

package/dist/types/crypto-browser.d.ts

@@ -0,0 +1,2 @@
+export declare function createHmac(..._args: unknown[]): never;
+export declare function timingSafeEqual(..._args: unknown[]): never;

package/dist/types/crypto-node.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The webhook verifier's crypto, behind a local module so the `browser` build
+ * can swap it for `./crypto-browser` (see tsup.config.ts). Node builds use the
+ * real `node:crypto`, unchanged.
+ */
+export { createHmac, timingSafeEqual } from "node:crypto";

package/dist/types/react.d.ts

@@ -216,7 +216,7 @@ export declare const useG8: () => {
         };
         get webhooks(): {
             baseUrl: string;
-            knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.restored", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.call_connected", "engagement.call_graded", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled", "deal.won", "crm.record.created", "crm.record.updated", "crm.record.archived", "crm.record.restored", "sequence.contact_enrolled", "sequence.contact_removed", "sequence.step_completed", "sequence.step_failed", "engagement.contact_unsubscribed", "engagement.sms_delivered", "engagement.sms_failed", "engagement.whatsapp_delivered", "engagement.whatsapp_failed", "engagement.call_started", "engagement.call_completed", "engagement.call_disposition_set", "engagement.voicemail_detected", "engagement.voicemail_left", "engagement.email_clicked", "engagement.link_clicked", "engagement.call_recording_ready", "meeting.no_show", "voice_ai.call_started", "voice_ai.call_completed", "voice_ai.voicemail_left", "deal.created", "deal.updated", "deal.stage_changed", "deal.deleted", "quote.created", "quote.updated", "quote.sent", "quote.resent", "quote.resend_failed", "quote.link_generated", "quote.viewed", "quote.accepted", "quote.declined", "quote.expired", "quote.voided", "quote.superseded", "quote.archived", "quote.unarchived", "quote.payment_received", "quote.payment_failed", "quote.subscription_canceled", "quote.provisioned", "form.submitted", "visitor.identified", "intent.signal", "task.created", "task.updated", "task.completed", "task.deleted", "enrichment.job_completed", "enrichment.job_failed", "workflow.execution_completed", "workflow.execution_failed"];
+            knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.restored", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.call_connected", "engagement.call_graded", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled", "deal.won", "crm.record.created", "crm.record.updated", "crm.record.archived", "crm.record.restored", "sequence.contact_enrolled", "sequence.contact_removed", "sequence.step_completed", "sequence.step_failed", "engagement.contact_unsubscribed", "engagement.sms_delivered", "engagement.sms_failed", "engagement.whatsapp_delivered", "engagement.whatsapp_failed", "engagement.call_started", "engagement.call_completed", "engagement.call_disposition_set", "engagement.voicemail_detected", "engagement.voicemail_left", "engagement.email_clicked", "engagement.link_clicked", "engagement.call_recording_ready", "meeting.no_show", "voice_ai.call_started", "voice_ai.call_completed", "voice_ai.voicemail_left", "deal.created", "deal.updated", "deal.stage_changed", "deal.deleted", "quote.created", "quote.updated", "quote.sent", "quote.resent", "quote.resend_failed", "quote.link_generated", "quote.viewed", "quote.accepted", "quote.declined", "quote.expired", "quote.voided", "quote.superseded", "quote.archived", "quote.unarchived", "quote.payment_received", "quote.payment_failed", "quote.subscription_canceled", "quote.provisioned", "quote.approval_requested", "quote.approved", "quote.rejected", "quote.forwarded_for_signature", "quote.forwarded_for_payment", "quote.signer_change_requested", "quote.signer_change_approved", "quote.signer_change_rejected", "form.submitted", "visitor.identified", "intent.signal", "task.created", "task.updated", "task.completed", "task.deleted", "enrichment.job_completed", "enrichment.job_failed", "workflow.execution_completed", "workflow.execution_failed"];
             constructEvent(payload: string, signature: string, timestamp: string | number, secret: string, opts?: import("./webhooks").ConstructEventOptions): import("./webhooks").WebhookEventPayload;
         };
         get contacts(): {

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.303.0";
+export declare const SDK_VERSION = "0.357.0";
 /** Value of the `X-G8-Client` header every SDK request carries (I-13). */
-export declare const SDK_CLIENT_ID = "js-sdk/0.303.0";
+export declare const SDK_CLIENT_ID = "js-sdk/0.357.0";

package/dist/types/webhooks.d.ts

@@ -6,7 +6,7 @@
  * adds events. ``WebhookEvent`` also accepts any string so a newly-added
  * backend event never breaks a client that hasn't upgraded.
  */
-export declare const KNOWN_WEBHOOK_EVENTS: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.restored", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.call_connected", "engagement.call_graded", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled", "deal.won", "crm.record.created", "crm.record.updated", "crm.record.archived", "crm.record.restored", "sequence.contact_enrolled", "sequence.contact_removed", "sequence.step_completed", "sequence.step_failed", "engagement.contact_unsubscribed", "engagement.sms_delivered", "engagement.sms_failed", "engagement.whatsapp_delivered", "engagement.whatsapp_failed", "engagement.call_started", "engagement.call_completed", "engagement.call_disposition_set", "engagement.voicemail_detected", "engagement.voicemail_left", "engagement.email_clicked", "engagement.link_clicked", "engagement.call_recording_ready", "meeting.no_show", "voice_ai.call_started", "voice_ai.call_completed", "voice_ai.voicemail_left", "deal.created", "deal.updated", "deal.stage_changed", "deal.deleted", "quote.created", "quote.updated", "quote.sent", "quote.resent", "quote.resend_failed", "quote.link_generated", "quote.viewed", "quote.accepted", "quote.declined", "quote.expired", "quote.voided", "quote.superseded", "quote.archived", "quote.unarchived", "quote.payment_received", "quote.payment_failed", "quote.subscription_canceled", "quote.provisioned", "form.submitted", "visitor.identified", "intent.signal", "task.created", "task.updated", "task.completed", "task.deleted", "enrichment.job_completed", "enrichment.job_failed", "workflow.execution_completed", "workflow.execution_failed"];
+export declare const KNOWN_WEBHOOK_EVENTS: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.restored", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.call_connected", "engagement.call_graded", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled", "deal.won", "crm.record.created", "crm.record.updated", "crm.record.archived", "crm.record.restored", "sequence.contact_enrolled", "sequence.contact_removed", "sequence.step_completed", "sequence.step_failed", "engagement.contact_unsubscribed", "engagement.sms_delivered", "engagement.sms_failed", "engagement.whatsapp_delivered", "engagement.whatsapp_failed", "engagement.call_started", "engagement.call_completed", "engagement.call_disposition_set", "engagement.voicemail_detected", "engagement.voicemail_left", "engagement.email_clicked", "engagement.link_clicked", "engagement.call_recording_ready", "meeting.no_show", "voice_ai.call_started", "voice_ai.call_completed", "voice_ai.voicemail_left", "deal.created", "deal.updated", "deal.stage_changed", "deal.deleted", "quote.created", "quote.updated", "quote.sent", "quote.resent", "quote.resend_failed", "quote.link_generated", "quote.viewed", "quote.accepted", "quote.declined", "quote.expired", "quote.voided", "quote.superseded", "quote.archived", "quote.unarchived", "quote.payment_received", "quote.payment_failed", "quote.subscription_canceled", "quote.provisioned", "quote.approval_requested", "quote.approved", "quote.rejected", "quote.forwarded_for_signature", "quote.forwarded_for_payment", "quote.signer_change_requested", "quote.signer_change_approved", "quote.signer_change_rejected", "form.submitted", "visitor.identified", "intent.signal", "task.created", "task.updated", "task.completed", "task.deleted", "enrichment.job_completed", "enrichment.job_failed", "workflow.execution_completed", "workflow.execution_failed"];
 export type WebhookEvent = (typeof KNOWN_WEBHOOK_EVENTS)[number] | (string & {});
 /** The decoded body graph8 delivers to a webhook endpoint. */
 export interface WebhookEventPayload {
@@ -65,7 +65,7 @@ export declare const createWebhooksClient: (_apiKey: string, apiUrl?: string) =>
     /** Base URL the webhook subscription API lives under. */
     baseUrl: string;
     /** Known event types (for autocomplete / validation). */
-    knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.restored", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.call_connected", "engagement.call_graded", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled", "deal.won", "crm.record.created", "crm.record.updated", "crm.record.archived", "crm.record.restored", "sequence.contact_enrolled", "sequence.contact_removed", "sequence.step_completed", "sequence.step_failed", "engagement.contact_unsubscribed", "engagement.sms_delivered", "engagement.sms_failed", "engagement.whatsapp_delivered", "engagement.whatsapp_failed", "engagement.call_started", "engagement.call_completed", "engagement.call_disposition_set", "engagement.voicemail_detected", "engagement.voicemail_left", "engagement.email_clicked", "engagement.link_clicked", "engagement.call_recording_ready", "meeting.no_show", "voice_ai.call_started", "voice_ai.call_completed", "voice_ai.voicemail_left", "deal.created", "deal.updated", "deal.stage_changed", "deal.deleted", "quote.created", "quote.updated", "quote.sent", "quote.resent", "quote.resend_failed", "quote.link_generated", "quote.viewed", "quote.accepted", "quote.declined", "quote.expired", "quote.voided", "quote.superseded", "quote.archived", "quote.unarchived", "quote.payment_received", "quote.payment_failed", "quote.subscription_canceled", "quote.provisioned", "form.submitted", "visitor.identified", "intent.signal", "task.created", "task.updated", "task.completed", "task.deleted", "enrichment.job_completed", "enrichment.job_failed", "workflow.execution_completed", "workflow.execution_failed"];
+    knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "campaign.restored", "campaign.launched", "campaign.paused", "campaign.completed", "campaign.status_changed", "campaign.content_ready", "document.generated", "document.failed", "intelligence.completed", "intelligence.failed", "company.enriched", "company_intelligence.completed", "audience.ready", "audience.failed", "sequence.draft_created", "sequence.started", "sequence.paused", "sequence.completed", "engagement.email_sent", "engagement.email_replied", "engagement.email_bounced", "engagement.email_skipped", "engagement.call_dispatched", "engagement.call_connected", "engagement.call_graded", "engagement.sms_sent", "engagement.sms_replied", "engagement.whatsapp_sent", "engagement.linkedin_connection_sent", "engagement.linkedin_message_sent", "engagement.linkedin_inmail_sent", "engagement.linkedin_reply_received", "engagement.linkedin_connection_accepted", "meeting.booked", "meeting.cancelled", "meeting.rescheduled", "deal.won", "crm.record.created", "crm.record.updated", "crm.record.archived", "crm.record.restored", "sequence.contact_enrolled", "sequence.contact_removed", "sequence.step_completed", "sequence.step_failed", "engagement.contact_unsubscribed", "engagement.sms_delivered", "engagement.sms_failed", "engagement.whatsapp_delivered", "engagement.whatsapp_failed", "engagement.call_started", "engagement.call_completed", "engagement.call_disposition_set", "engagement.voicemail_detected", "engagement.voicemail_left", "engagement.email_clicked", "engagement.link_clicked", "engagement.call_recording_ready", "meeting.no_show", "voice_ai.call_started", "voice_ai.call_completed", "voice_ai.voicemail_left", "deal.created", "deal.updated", "deal.stage_changed", "deal.deleted", "quote.created", "quote.updated", "quote.sent", "quote.resent", "quote.resend_failed", "quote.link_generated", "quote.viewed", "quote.accepted", "quote.declined", "quote.expired", "quote.voided", "quote.superseded", "quote.archived", "quote.unarchived", "quote.payment_received", "quote.payment_failed", "quote.subscription_canceled", "quote.provisioned", "quote.approval_requested", "quote.approved", "quote.rejected", "quote.forwarded_for_signature", "quote.forwarded_for_payment", "quote.signer_change_requested", "quote.signer_change_approved", "quote.signer_change_rejected", "form.submitted", "visitor.identified", "intent.signal", "task.created", "task.updated", "task.completed", "task.deleted", "enrichment.job_completed", "enrichment.job_failed", "workflow.execution_completed", "workflow.execution_failed"];
     /** Verify an incoming webhook's HMAC signature and return the parsed event. */
     constructEvent(payload: string, signature: string, timestamp: string | number, secret: string, opts?: ConstructEventOptions): WebhookEventPayload;
 };

package/dist/ui/index.d.mts

@@ -0,0 +1,54 @@
+export { cn } from './lib/utils.mjs';
+export { composeRefs, useComposedRefs } from './lib/compose-refs.mjs';
+export { MOBILE_BREAKPOINT, useIsMobile } from './lib/use-mobile.mjs';
+export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger } from './primitives/alert-dialog.mjs';
+export { Avatar, AvatarFallback, AvatarImage } from './primitives/avatar.mjs';
+export { Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator } from './primitives/breadcrumb.mjs';
+export { Button, ButtonProps, buttonVariants } from './primitives/button.mjs';
+export { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from './primitives/card.mjs';
+export { Carousel, CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, useCarousel } from './primitives/carousel.mjs';
+export { ChartConfig, ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent } from './primitives/chart.mjs';
+export { Collapsible, CollapsibleContent, CollapsibleTrigger } from './primitives/collapsible.mjs';
+export { ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger } from './primitives/context-menu.mjs';
+export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, VisuallyHidden } from './primitives/dialog.mjs';
+export { Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger } from './primitives/drawer.mjs';
+export { Input } from './primitives/input.mjs';
+export { Item, ItemActions, ItemContent, ItemDescription, ItemFooter, ItemGroup, ItemHeader, ItemMedia, ItemSeparator, ItemTitle } from './primitives/item.mjs';
+export { Kbd } from './primitives/kbd.mjs';
+export { Label } from './primitives/label.mjs';
+export { ResizableHandle, ResizablePanel, ResizablePanelGroup } from './primitives/resizable.mjs';
+export { SaveStatus, SaveStatusProps, SaveStatusValue } from './primitives/save-status.mjs';
+export { Separator } from './primitives/separator.mjs';
+export { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger } from './primitives/sheet.mjs';
+export { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, useSidebar } from './primitives/sidebar.mjs';
+export { Skeleton } from './primitives/skeleton.mjs';
+export { Slider } from './primitives/slider.mjs';
+export { Root as Sortable, Content as SortableContent, Item as SortableItem, ItemHandle as SortableItemHandle, Overlay as SortableOverlay } from './primitives/sortable.mjs';
+export { Switch } from './primitives/switch.mjs';
+export { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow } from './primitives/table.mjs';
+export { Tabs, TabsContent, TabsList, TabsTrigger } from './primitives/tabs.mjs';
+export { Textarea } from './primitives/textarea.mjs';
+export { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from './primitives/tooltip.mjs';
+import 'clsx';
+import 'react';
+import '@radix-ui/react-dialog';
+import '@radix-ui/react-avatar';
+import 'class-variance-authority/types';
+import 'class-variance-authority';
+import 'recharts/types/util/payload/getUniqPayload';
+import 'recharts/types/component/Tooltip';
+import 'recharts/types/util/types';
+import 'recharts/types/component/DefaultTooltipContent';
+import 'recharts';
+import '@radix-ui/react-collapsible';
+import '@radix-ui/react-context-menu';
+import 'vaul';
+import '@radix-ui/react-label';
+import 'react-resizable-panels';
+import '@radix-ui/react-separator';
+import '@radix-ui/react-slider';
+import '@dnd-kit/core';
+import '@dnd-kit/sortable';
+import '@radix-ui/react-switch';
+import '@radix-ui/react-tabs';
+import '@radix-ui/react-tooltip';

package/dist/ui/index.d.ts

@@ -0,0 +1,54 @@
+export { cn } from './lib/utils.js';
+export { composeRefs, useComposedRefs } from './lib/compose-refs.js';
+export { MOBILE_BREAKPOINT, useIsMobile } from './lib/use-mobile.js';
+export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger } from './primitives/alert-dialog.js';
+export { Avatar, AvatarFallback, AvatarImage } from './primitives/avatar.js';
+export { Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator } from './primitives/breadcrumb.js';
+export { Button, ButtonProps, buttonVariants } from './primitives/button.js';
+export { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from './primitives/card.js';
+export { Carousel, CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, useCarousel } from './primitives/carousel.js';
+export { ChartConfig, ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent } from './primitives/chart.js';
+export { Collapsible, CollapsibleContent, CollapsibleTrigger } from './primitives/collapsible.js';
+export { ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger } from './primitives/context-menu.js';
+export { Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, VisuallyHidden } from './primitives/dialog.js';
+export { Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger } from './primitives/drawer.js';
+export { Input } from './primitives/input.js';
+export { Item, ItemActions, ItemContent, ItemDescription, ItemFooter, ItemGroup, ItemHeader, ItemMedia, ItemSeparator, ItemTitle } from './primitives/item.js';
+export { Kbd } from './primitives/kbd.js';
+export { Label } from './primitives/label.js';
+export { ResizableHandle, ResizablePanel, ResizablePanelGroup } from './primitives/resizable.js';
+export { SaveStatus, SaveStatusProps, SaveStatusValue } from './primitives/save-status.js';
+export { Separator } from './primitives/separator.js';
+export { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger } from './primitives/sheet.js';
+export { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, useSidebar } from './primitives/sidebar.js';
+export { Skeleton } from './primitives/skeleton.js';
+export { Slider } from './primitives/slider.js';
+export { Root as Sortable, Content as SortableContent, Item as SortableItem, ItemHandle as SortableItemHandle, Overlay as SortableOverlay } from './primitives/sortable.js';
+export { Switch } from './primitives/switch.js';
+export { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow } from './primitives/table.js';
+export { Tabs, TabsContent, TabsList, TabsTrigger } from './primitives/tabs.js';
+export { Textarea } from './primitives/textarea.js';
+export { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from './primitives/tooltip.js';
+import 'clsx';
+import 'react';
+import '@radix-ui/react-dialog';
+import '@radix-ui/react-avatar';
+import 'class-variance-authority/types';
+import 'class-variance-authority';
+import 'recharts/types/util/payload/getUniqPayload';
+import 'recharts/types/component/Tooltip';
+import 'recharts/types/util/types';
+import 'recharts/types/component/DefaultTooltipContent';
+import 'recharts';
+import '@radix-ui/react-collapsible';
+import '@radix-ui/react-context-menu';
+import 'vaul';
+import '@radix-ui/react-label';
+import 'react-resizable-panels';
+import '@radix-ui/react-separator';
+import '@radix-ui/react-slider';
+import '@dnd-kit/core';
+import '@dnd-kit/sortable';
+import '@radix-ui/react-switch';
+import '@radix-ui/react-tabs';
+import '@radix-ui/react-tooltip';