@graph8/sdk 0.13.1 → 0.15.0

package/dist/index.d.mts

@@ -1550,6 +1550,8 @@ declare const createInboxClient: (apiKey: string, apiUrl?: string) => {
 };
 
 interface Deal {
+    /** Canonical CRM revision returned by a conditional update. */
+    revision?: number | null;
     id: string | null;
     name: string | null;
     description: string | null;
@@ -1614,6 +1616,8 @@ interface DealCreateParams {
     allow_duplicate?: boolean;
 }
 interface DealUpdateParams {
+    /** Require this current CRM revision; a stale edit returns HTTP 409. */
+    expected_revision?: number;
     name?: string;
     description?: string;
     amount?: number;
@@ -1739,6 +1743,7 @@ declare const createDealsClient: (apiKey: string, apiUrl?: string) => {
     }>;
 };
 
+type CustomObjectIcon = "box" | "briefcase" | "building" | "calendar" | "flag" | "folder" | "globe" | "heart" | "layers" | "package" | "target" | "users";
 /** A custom object type in your workspace — a record type you define. */
 interface CustomObject {
     /** Stable API slug, e.g. `invoices`. */
@@ -1748,6 +1753,28 @@ interface CustomObject {
     /** True for object types graph8 ships; system objects cannot be deleted. */
     is_system: boolean;
     is_archived: boolean;
+    /** Presentation settings may be absent on older servers. */
+    description?: string | null;
+    icon?: string | null;
+    display_attribute_slug?: string | null;
+}
+/** Native schema creation requires objects:manage and current Admin access. */
+interface CreateCustomObject {
+    slug: string;
+    singular_noun: string;
+    plural_noun: string;
+    description?: string | null;
+    icon?: CustomObjectIcon | null;
+}
+/** Omitted labels/state are preserved. The API slug is immutable. */
+interface UpdateCustomObject {
+    singular_noun?: string;
+    plural_noun?: string;
+    is_archived?: boolean;
+    /** Omit to preserve; null clears the setting. */
+    description?: string | null;
+    icon?: CustomObjectIcon | null;
+    display_attribute_slug?: string | null;
 }
 /**
  * One attribute on a custom object, and the rules its values must satisfy.
@@ -1760,6 +1787,15 @@ interface CustomObject {
  */
 interface CustomObjectAttribute {
     slug: string;
+    /** Customer-facing label. Display metadata is absent on older servers. */
+    title?: string;
+    description?: string | null;
+    /** Display order; ties are ordered by slug. */
+    sort_order?: number;
+    /** Protected system field rather than a customer-defined field. */
+    is_system?: boolean;
+    /** Archive state; absent on older servers. */
+    is_archived?: boolean;
     attribute_type: string;
     is_required: boolean;
     /** No two ACTIVE records may hold the same value. A collision returns 409. */
@@ -1772,6 +1808,24 @@ interface CustomObjectAttribute {
     /** Type-specific configuration, e.g. the allowed options for a `select`. */
     config: Record<string, unknown>;
 }
+/** Schema creation requires objects:manage and current Admin access. */
+interface CreateCustomObjectAttribute {
+    slug: string;
+    title: string;
+    attribute_type: "text" | "number" | "currency" | "date" | "timestamp" | "checkbox" | "select" | "status" | "email_address" | "phone_number" | "domain" | "location" | "personal_name" | "record_reference" | "rating" | "actor_reference";
+    description?: string | null;
+    is_required?: boolean;
+    is_unique?: boolean;
+    is_multiselect?: boolean;
+    is_default_value_enabled?: boolean;
+    default_value?: unknown;
+    config?: Record<string, unknown>;
+    sort_order?: number;
+}
+/** Omitted fields are preserved; explicit null can clear the configured default. */
+type UpdateCustomObjectAttribute = Partial<Omit<CreateCustomObjectAttribute, "slug" | "attribute_type">> & {
+    is_archived?: boolean;
+};
 /** One record, with its currently active attribute values. */
 interface CustomObjectRecord {
     id: string;
@@ -1802,6 +1856,29 @@ interface CustomObjectHistory {
     record_id: string;
     entries: CustomObjectHistoryEntry[];
 }
+interface CustomObjectMutation {
+    id: string;
+    action: "created" | "updated" | "archived" | "restored";
+    occurred_at: string;
+    revision: number;
+    actor_id: string | null;
+    actor_type: "user" | "api" | "app" | "integration" | "system";
+    source: string;
+    app_id: string | null;
+    changes: Record<string, {
+        before_present: boolean;
+        before: unknown;
+        after_present: boolean;
+        after: unknown;
+    }>;
+    was_archived: boolean;
+    is_archived: boolean;
+}
+interface CustomObjectMutations {
+    record_id: string;
+    entries: CustomObjectMutation[];
+    next_cursor: string | null;
+}
 interface ListRecordsParams {
     page?: number;
     /** 1-200, default 50. */
@@ -1866,16 +1943,33 @@ interface ObjectPagination {
  */
 declare const createObjectsClient: (apiKey: string, apiUrl?: string) => {
     /** List the custom object types in your workspace. */
-    list(): Promise<{
+    list(params?: {
+        include_archived?: boolean;
+    }): Promise<{
         data: CustomObject[];
     }>;
+    /** Create a native custom object. Requires objects:manage and Admin access. */
+    create(input: CreateCustomObject): Promise<CustomObject>;
+    /** Rename, archive or restore an object while preserving its slug and data. */
+    update(objectSlug: string, input: UpdateCustomObject): Promise<CustomObject>;
+    /** Archive the object without deleting records; restore with update({ is_archived: false }). */
+    archive(objectSlug: string): Promise<CustomObject>;
     /** Fetch one object type by slug. */
     get(objectSlug: string): Promise<CustomObject>;
     /** The object's attributes — the schema its records must satisfy. */
-    listAttributes(objectSlug: string): Promise<{
+    listAttributes(objectSlug: string, params?: {
+        include_archived?: boolean;
+    }): Promise<{
         data: CustomObjectAttribute[];
     }>;
-    /** Paginated records with their current values. Archived records are excluded. */
+    /** Create a field using the same schema rules as the customer UI. */
+    createAttribute(objectSlug: string, input: CreateCustomObjectAttribute): Promise<CustomObjectAttribute>;
+    /** Edit or restore a field; its type and slug are immutable. */
+    updateAttribute(objectSlug: string, attributeSlug: string, input: UpdateCustomObjectAttribute): Promise<CustomObjectAttribute>;
+    /** Archive without deleting values; restore with updateAttribute({ is_archived: false }). */
+    archiveAttribute(objectSlug: string, attributeSlug: string): Promise<CustomObjectAttribute>;
+    /** Paginated custom records or canonical deals with current values and revisions.
+     * Deal totals and related references respect current record access. */
     listRecords(objectSlug: string, params?: ListRecordsParams): Promise<{
         data: CustomObjectRecord[];
         pagination?: ObjectPagination;
@@ -1886,18 +1980,28 @@ declare const createObjectsClient: (apiKey: string, apiUrl?: string) => {
      * unique attribute is a 409.
      */
     createRecord(objectSlug: string, values: Record<string, unknown>): Promise<CustomObjectRecord>;
-    /** Fetch one record with its currently active values. */
+    /** Match a unique single-value key, creating or updating while preserving omitted fields. */
+    upsertRecord(objectSlug: string, matchingAttribute: string, values: Record<string, unknown>, options?: {
+        expectedRevision?: number;
+    }): Promise<CustomObjectRecord>;
+    /** Fetch one custom record, canonical contact/company, or deal by its stable graph8 ID.
+     * Deals retain their UUIDs and expose company, primary-contact and contact_ids references only
+     * when permitted. Generic deal mutations are not yet supported.
+     */
     getRecord(objectSlug: string, recordId: string): Promise<CustomObjectRecord>;
     /**
      * Update a record. PARTIAL: only the attributes you send are touched, so
      * required attributes you omit are left alone rather than reported missing.
      * Sending an explicit `null` CLEARS that attribute.
      *
-     * Values are versioned rather than overwritten, so the previous value stays
-     * readable through `history`.
+     * Custom values retain generations through `history`. Canonical contacts and
+     * companies require expectedRevision from a fresh read and expose recorded
+     * mutations through `changes`. They do not yet support appendValues/removeValues.
      */
     updateRecord(objectSlug: string, recordId: string, values: Record<string, unknown>, options?: {
         expectedRevision?: number;
+        appendValues?: Record<string, unknown[]>;
+        removeValues?: Record<string, unknown[]>;
     }): Promise<CustomObjectRecord>;
     /**
      * Archive a record. It leaves listings, stays readable by id, and keeps its
@@ -1911,6 +2015,284 @@ declare const createObjectsClient: (apiKey: string, apiUrl?: string) => {
      * null is the value currently in force.
      */
     history(objectSlug: string, recordId: string, limit?: number): Promise<CustomObjectHistory>;
+    /** Recorded custom-record or canonical contact/company mutations. Pass next_cursor to continue.
+     * Canonical history respects current access/privacy; archived records and older
+     * unrecorded writes are not reconstructed. Store unavailability returns 503.
+     */
+    changes(objectSlug: string, recordId: string, options?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<CustomObjectMutations>;
+};
+
+/**
+ * Hosted app platform — deployments, domains, secrets, source and logs (M9 J14).
+ *
+ * WHAT WAS MISSING. `apps.ts` covered creating an app and reading its installs,
+ * usage and limit. Everything that actually SHIPS one -- binding a source,
+ * queueing a deployment, promoting it, attaching a hostname, reading why a build
+ * failed -- had no client at all. That is why the build portal is read-only: not
+ * because the routes are absent, but because nothing typed reached them.
+ *
+ * EVERY RESPONSE ON THIS SURFACE IS WRAPPED as `{data, pagination}`, and
+ * `pagination` is always null here -- none of these routes paginate. The helpers
+ * below unwrap `data` so callers work with the record, except where the list IS
+ * the answer.
+ *
+ * DELIBERATELY ABSENT, and each for a reason:
+ *
+ *   * `POST /apps/{id}/deployments/{id}/status` -- authenticated with the build
+ *     CONTROLLER credential, not a builder's API key. An SDK method for it would
+ *     imply a customer can move their own deployment through the state machine.
+ *   * `GET /app-platform/tls-authorize` -- Caddy's on-demand-TLS ask hook. Public,
+ *     unauthenticated, returns a bare 200 or 404 with no body. It is edge
+ *     plumbing, not a customer API.
+ */
+/** The six frozen values. Not widened to `string`: a client that switches on the
+ *  status should get a compile error when a new state is added. */
+type DeploymentStatus = "queued" | "building" | "promoting" | "deployed" | "failed" | "rolled_back";
+type DomainVerificationStatus = "pending" | "verified" | "failed" | "revoked";
+type SourceProvider = "github" | "gitlab" | "bitbucket";
+type SchemaVersionStatus = "draft" | "published" | "deprecated";
+interface Deployment {
+    deployment_id: string;
+    app_id: string;
+    /** One of `DeploymentStatus`. Typed as the union, but the server sends a plain
+     *  string -- treat an unrecognised value as forward compatibility, not an error. */
+    status: DeploymentStatus;
+    source_ref: string | null;
+    image_digest: string | null;
+    schema_version_id: string | null;
+    /** Sanitized at the WRITE. One line. The detail is in `logs()`. */
+    last_error_sanitized: string | null;
+    created_at: string | null;
+    deployed_at: string | null;
+    build_started_at: string | null;
+    build_finished_at: string | null;
+    /** Measured `building` -> `promoting`, NOT to `deployed`: `deployed` is reached
+     *  after traffic is taken, so measuring to it would count the promotion too. */
+    build_seconds: number | null;
+}
+interface CreateDeploymentParams {
+    /** A COMMIT-ish, never a branch name. A branch moves, so a deployment recorded
+     *  against one cannot answer "what is running right now" a week later. The
+     *  server enforces length only -- this convention is the caller's to keep. */
+    source_ref: string;
+    /** Pins the custom-object schema this build expects, so a rollback restores the
+     *  matching schema and not merely the matching image. */
+    schema_version_id?: string;
+}
+interface AppDomain {
+    domain_id: string;
+    app_id: string;
+    /** The canonical normalized form -- lowercased, trailing dot stripped, IDNA
+     *  encoded. NOT what you submitted. */
+    hostname: string;
+    status: DomainVerificationStatus;
+    verification_token: string | null;
+    created_at: string | null;
+    verified_at: string | null;
+}
+interface DomainVerificationInstructions {
+    domain: AppDomain;
+    record_type: "TXT";
+    record_name: string;
+    record_value: string;
+}
+interface AppSecretMetadata {
+    secret_key: string;
+    /** A POINTER into your secret manager, never the secret. graph8 has no column
+     *  for a value and cannot grow one. */
+    provider_ref: string | null;
+    created_at: string | null;
+    rotated_at: string | null;
+}
+interface AppSourceParams {
+    repo_url: string;
+    provider: SourceProvider;
+    default_branch?: string;
+    credential_ref?: string;
+}
+interface SchemaVersion {
+    schema_version_id: string;
+    app_id: string;
+    version: number;
+    digest: string;
+    status: SchemaVersionStatus;
+    manifest: Record<string, unknown>;
+    created_at: string | null;
+    published_at: string | null;
+    deprecated_at: string | null;
+}
+interface ContainerLog {
+    pod: string;
+    container: string;
+    /** `init` steps run to completion before the pod's containers start. A build is
+     *  four init steps (fetch, scan-source, build, scan-image) then one container
+     *  (push), so this is how you tell which step you are looking at. */
+    kind: "init" | "container";
+    text: string;
+    /** The tail hit the per-container byte cap. Earlier output exists and was not
+     *  returned. */
+    truncated: boolean;
+}
+interface AppLogs {
+    app_id: string;
+    /** Set for build logs; null for the running app's logs. */
+    deployment_id: string | null;
+    namespace: string;
+    tail_lines: number;
+    /**
+     * Always true, and it means only that graph8's credential patterns ran.
+     * It is NOT a claim the output is safe to publish: these are your own build and
+     * application logs, and an application can print a secret in a shape no pattern
+     * matches.
+     */
+    redacted: boolean;
+    containers: ContainerLog[];
+}
+/** Lines per container. The server refuses anything outside 1-2000 with a 422
+ *  rather than clamping, so the bound is worth knowing before you send it. */
+declare const MIN_TAIL_LINES = 1;
+declare const MAX_TAIL_LINES = 2000;
+declare const createAppPlatformClient: (apiKey: string, apiUrl?: string) => {
+    /**
+     * Bind the repository an app builds from.
+     *
+     * `repo_url` must be fetchable -- `https://`, `ssh://` or `git@`, with no
+     * whitespace. A `file://` or bare path is refused with 422, because a build
+     * that can read the builder's filesystem is a build that can read ours.
+     *
+     * `credential_ref` is a POINTER into your secret manager, not a token.
+     */
+    setSource(appId: string, params: AppSourceParams): Promise<Record<string, unknown>>;
+    /** Unbind the source. Returns the full app with every source field null. */
+    clearSource(appId: string): Promise<Record<string, unknown>>;
+    /** Every deployment for this app, newest first. Never 404s for an app with none. */
+    listDeployments(appId: string): Promise<{
+        data: Deployment[];
+    }>;
+    /**
+     * Queue a deployment. Returns `201` with `status: "queued"` -- nothing builds
+     * as a side effect of this call; the build controller picks it up.
+     *
+     * NOT idempotent: two identical calls create two deployments.
+     */
+    deploy(appId: string, params: CreateDeploymentParams): Promise<Deployment>;
+    /** Fetch one deployment. The polling endpoint for a build loop. */
+    getDeployment(appId: string, deploymentId: string): Promise<Deployment>;
+    /**
+     * The deployment currently serving traffic, or `null`.
+     *
+     * `null` is a real answer with a 200, not a 404: "this app has never shipped"
+     * is information, while a 404 would read as "no such app".
+     */
+    activeDeployment(appId: string): Promise<Deployment | null>;
+    /**
+     * Promote a built deployment to serve traffic. Anything it displaces moves to
+     * `rolled_back` in the same transaction, so there is never a moment with two
+     * live deployments.
+     *
+     * `409` when the state machine forbids it -- a deployment cannot become
+     * `deployed` without having been built, and a `failed` one cannot be revived.
+     * A retry is a new deployment, not a resurrection.
+     */
+    promote(appId: string, deploymentId: string, imageDigest: string): Promise<Deployment>;
+    /** Roll back a deployment that is currently serving. Only a `deployed` one may be. */
+    rollback(appId: string, deploymentId: string): Promise<Deployment>;
+    /**
+     * Why a build failed. Returns every step of the build pod in the order
+     * Kubernetes runs them; a step that has not started yet is omitted rather
+     * than returned empty.
+     *
+     * An empty `containers` list is not an error -- build pods are reaped an hour
+     * after they finish, so logs for an older deployment are genuinely gone.
+     * `last_error_sanitized` on the deployment is what survives.
+     *
+     * `503` means graph8 could not reach the cluster, which is deliberately
+     * different from an empty `200`: one means we could not look, the other means
+     * your build produced no output.
+     */
+    deploymentLogs(appId: string, deploymentId: string, tailLines?: number): Promise<AppLogs>;
+    /**
+     * What the running app is printing. The app's own pods only -- the per-app
+     * egress proxy shares the namespace and is deliberately excluded.
+     *
+     * Empty until a deployment reaches `deployed`.
+     */
+    logs(appId: string, tailLines?: number): Promise<AppLogs>;
+    /** Every hostname claimed for this app, whatever its verification state. */
+    listDomains(appId: string): Promise<{
+        data: AppDomain[];
+    }>;
+    /**
+     * Claim a hostname and get the TXT record that proves you own it.
+     *
+     * Returns `201`, and the domain is NESTED at `data.domain` -- this is the one
+     * route on the surface whose payload is not the record itself. Hostnames are
+     * globally unique, so a host another app holds is refused.
+     */
+    claimDomain(appId: string, hostname: string): Promise<DomainVerificationInstructions>;
+    /**
+     * Check DNS for the TXT record and advance the domain to `verified`.
+     *
+     * Idempotent: verifying an already-verified domain re-checks and stays
+     * verified, so it is safe to re-run after a DNS change. Send no body -- the
+     * record in DNS is the payload.
+     */
+    verifyDomain(appId: string, hostname: string): Promise<AppDomain>;
+    /**
+     * Release a claimed hostname.
+     *
+     * A HARD delete. Hostnames are globally unique, so a row left behind in any
+     * status keeps the host burned for every other builder. Releasing one you
+     * already released is a `404`, because after the first call the claim
+     * genuinely does not exist.
+     *
+     * Returns the NORMALIZED hostname, which may differ from what you passed.
+     */
+    releaseDomain(appId: string, hostname: string): Promise<{
+        hostname: string;
+        released: boolean;
+    }>;
+    /**
+     * Which secrets this app declares, and when each was last rotated.
+     *
+     * NEVER returns a value. graph8 stores a POINTER into your secret manager and
+     * has no column for the secret itself.
+     */
+    listSecrets(appId: string): Promise<{
+        data: AppSecretMetadata[];
+    }>;
+    /**
+     * Declare a secret, or rotate the pointer to it.
+     *
+     * `providerRef` is a REFERENCE, and the server rejects anything that looks
+     * like a credential -- a value starting `bearer `, `sk-`, `ghp_`, `xox` and
+     * friends is a 422. That refusal is the feature: it catches the mistake of
+     * pasting the secret where its address belongs.
+     */
+    putSecret(appId: string, secretKey: string, providerRef?: string): Promise<AppSecretMetadata>;
+    /** Undeclare a secret. A key the app never declared is a 404, so a typo is
+     *  never reported as a successful removal. */
+    deleteSecret(appId: string, secretKey: string): Promise<{
+        secret_key: string;
+        removed: boolean;
+    }>;
+    /**
+     * Publish a custom-object schema version. Returns `201`.
+     *
+     * Takes only the `objects` list, not a whole `graph8.app.yaml`: the rest of
+     * that file is app metadata the control plane already holds, and accepting it
+     * here would create a second place for it to disagree.
+     */
+    publishSchemaVersion(appId: string, objects: unknown[]): Promise<{
+        version: SchemaVersion;
+    }>;
+    /** Every schema version this app has published. Empty array, never 404. */
+    listSchemaVersions(appId: string): Promise<{
+        data: SchemaVersion[];
+    }>;
 };
 
 /**
@@ -2515,7 +2897,7 @@ declare const createContactsClient: (apiKey: string, apiUrl?: string) => {
  * adds events. ``WebhookEvent`` also accepts any string so a newly-added
  * backend event never breaks a client that hasn't upgraded.
  */
-declare const KNOWN_WEBHOOK_EVENTS: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "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.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"];
+declare const KNOWN_WEBHOOK_EVENTS: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "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"];
 type WebhookEvent = (typeof KNOWN_WEBHOOK_EVENTS)[number] | (string & {});
 /** The decoded body graph8 delivers to a webhook endpoint. */
 interface WebhookEventPayload {
@@ -2523,7 +2905,7 @@ interface WebhookEventPayload {
     timestamp: string;
     data: Record<string, unknown>;
     org_id: string;
-    /** Stable per-delivery id (present once the backend adds it; for consumer dedup). */
+    /** Stable event ID for consumer deduplication; delivery ID is in X-Studio-Delivery-Id. */
     id?: string;
 }
 interface ConstructEventOptions {
@@ -2574,7 +2956,7 @@ 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.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.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"];
+    knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "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"];
     /** 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;
 };
@@ -3508,6 +3890,7 @@ declare class G8 {
     /** @internal */ _tasks: ReturnType<typeof createTasksClient> | null;
     /** @internal */ _fields: ReturnType<typeof createFieldsClient> | null;
     /** @internal */ _apps: ReturnType<typeof createAppsClient> | null;
+    /** @internal */ _appPlatform: ReturnType<typeof createAppPlatformClient> | null;
     /** @internal */ _objects: ReturnType<typeof createObjectsClient> | null;
     /** @internal */ _deals: ReturnType<typeof createDealsClient> | null;
     /** @internal */ _inbox: ReturnType<typeof createInboxClient> | null;
@@ -3666,7 +4049,7 @@ declare class G8 {
             }>;
             listCallsForSdr(userEmail: string, extra?: {
                 limit?: number;
-                date_from?: string;
+                date_from? /** Audiences — sync audience lists to ad platforms (Meta, LinkedIn, Google, X) (requires API key). */: string;
                 date_to?: string;
             }): Promise<{
                 data: Array<Record<string, unknown>>;
@@ -3676,7 +4059,7 @@ declare class G8 {
     /** Webhook event listeners (requires API key). */
     get webhooks(): {
         baseUrl: string;
-        knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "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.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"];
+        knownEvents: readonly ["campaign.created", "campaign.updated", "campaign.deleted", "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"];
         constructEvent(payload: string, signature: string, timestamp: string | number, secret: string, opts?: ConstructEventOptions): WebhookEventPayload;
     };
     /** Contacts CRUD (requires API key). */
@@ -3807,27 +4190,91 @@ declare class G8 {
         usage(appId: string, period?: string): Promise<AppUsageSummary>;
         getLimit(appId: string): Promise<AppLimit | null>;
     };
+    /**
+     * Ship a hosted app: bind a source, deploy, promote, attach a hostname, read
+     * build logs (requires API key). PREVIEW.
+     *
+     * Separate from `apps` on purpose. `apps` is the app's IDENTITY -- create it,
+     * see who installed it, what it cost. This is its LIFECYCLE, and the two have
+     * different blast radii: a mistake here takes a customer's app down.
+     */
+    get appPlatform(): {
+        setSource(appId: string, params: AppSourceParams): Promise<Record<string, unknown>>;
+        clearSource(appId: string): Promise<Record<string, unknown>>;
+        listDeployments(appId: string): Promise<{
+            data: Deployment[];
+        }>;
+        deploy(appId: string, params: CreateDeploymentParams): Promise<Deployment>;
+        getDeployment(appId: string, deploymentId: string): Promise<Deployment>;
+        activeDeployment(appId: string): Promise<Deployment | null>;
+        promote(appId: string, deploymentId: string, imageDigest: string): Promise<Deployment>;
+        rollback(appId: string, deploymentId: string): Promise<Deployment>;
+        deploymentLogs(appId: string, deploymentId: string, tailLines?: number): Promise<AppLogs>;
+        logs(appId: string, tailLines?: number): Promise<AppLogs>;
+        listDomains(appId: string): Promise<{
+            data: AppDomain[];
+        }>;
+        claimDomain(appId: string, hostname: string): Promise<DomainVerificationInstructions>;
+        verifyDomain(appId: string, hostname: string): Promise<AppDomain>;
+        releaseDomain(appId: string, hostname: string): Promise<{
+            hostname: string;
+            released: boolean;
+        }>;
+        listSecrets(appId: string): Promise<{
+            data: AppSecretMetadata[];
+        }>;
+        putSecret(appId: string, secretKey: string, providerRef?: string): Promise<AppSecretMetadata>;
+        deleteSecret(appId: string, secretKey: string): Promise<{
+            secret_key: string;
+            removed: boolean;
+        }>;
+        publishSchemaVersion(appId: string, objects: unknown[]): Promise<{
+            version: SchemaVersion;
+        }>;
+        listSchemaVersions(appId: string): Promise<{
+            data: SchemaVersion[];
+        }>;
+    };
     /** Custom object types, their schema, and their records (requires API key). PREVIEW. */
     get objects(): {
-        list(): Promise<{
+        list(params?: {
+            include_archived?: boolean;
+        }): Promise<{
             data: CustomObject[];
         }>;
+        create(input: CreateCustomObject): Promise<CustomObject>;
+        update(objectSlug: string, input: UpdateCustomObject): Promise<CustomObject>;
+        archive(objectSlug: string): Promise<CustomObject>;
         get(objectSlug: string): Promise<CustomObject>;
-        listAttributes(objectSlug: string): Promise<{
+        listAttributes(objectSlug: string, params?: {
+            include_archived?: boolean;
+        }): Promise<{
             data: CustomObjectAttribute[];
         }>;
+        createAttribute(objectSlug: string, input: CreateCustomObjectAttribute): Promise<CustomObjectAttribute>;
+        updateAttribute(objectSlug: string, attributeSlug: string, input: UpdateCustomObjectAttribute): Promise<CustomObjectAttribute>;
+        archiveAttribute(objectSlug: string, attributeSlug: string): Promise<CustomObjectAttribute>;
         listRecords(objectSlug: string, params?: ListRecordsParams): Promise<{
             data: CustomObjectRecord[];
             pagination?: ObjectPagination;
         }>;
         createRecord(objectSlug: string, values: Record<string, unknown>): Promise<CustomObjectRecord>;
+        upsertRecord(objectSlug: string, matchingAttribute: string, values: Record<string, unknown>, options?: {
+            expectedRevision?: number;
+        }): Promise<CustomObjectRecord>;
         getRecord(objectSlug: string, recordId: string): Promise<CustomObjectRecord>;
         updateRecord(objectSlug: string, recordId: string, values: Record<string, unknown>, options?: {
             expectedRevision?: number;
+            appendValues?: Record<string, unknown[]>;
+            removeValues?: Record<string, unknown[]>;
         }): Promise<CustomObjectRecord>;
         archiveRecord(objectSlug: string, recordId: string): Promise<CustomObjectRecord>;
         restoreRecord(objectSlug: string, recordId: string): Promise<CustomObjectRecord>;
         history(objectSlug: string, recordId: string, limit?: number): Promise<CustomObjectHistory>;
+        changes(objectSlug: string, recordId: string, options?: {
+            limit?: number;
+            cursor?: string;
+        }): Promise<CustomObjectMutations>;
     };
     /** Deals and pipelines (requires API key). */
     get deals(): {
@@ -4124,7 +4571,8 @@ declare class G8 {
         }>;
         keywordContacts(keywordId: string, params?: {
             limit?: number;
-            date_from?: string;
+            date_from
+            /** @internal */ ? /** @internal */: string;
             date_to?: string;
         }): Promise<{
             data: IntentContact[];
@@ -4198,7 +4646,7 @@ declare class G8 {
         }>;
         researchReports(params?: {
             category?: string;
-            limit?: number;
+            limit? /** @internal */: number;
         }): Promise<{
             data: ResearchReport[];
         }>;
@@ -4218,7 +4666,8 @@ declare class G8 {
             description?: string;
             firmographics?: Record<string, unknown>;
             tech_stack?: Record<string, unknown>;
-            buying_signals?: unknown[];
+            buying_signals
+            /** @internal */ ? /** @internal */: unknown[];
             estimated_market_size?: number;
         }): Promise<{
             data: ICP;
@@ -4234,7 +4683,10 @@ declare class G8 {
             why_target?: string;
             key_signals?: unknown[];
             expected_receptivity?: string;
-            campaign_approach?: string;
+            campaign_approach? /**
+             * Initialize the graph8 SDK. Must be called before any other method.
+             * Safe to call on the server (SSR) - becomes a no-op for tracking.
+             */: string;
             recommended_goal?: string;
             source?: string;
         }): Promise<{
@@ -4646,4 +5098,4 @@ interface Graph8ServiceClient {
  */
 declare function createGraph8ServiceClient(config: Graph8ServiceClientConfig): Graph8ServiceClient;
 
-export { type AddToSequenceConfig, type AgencyClient, type AgencyInfo, type App, type AppCreateParams, type AppInstallation, type AppLimit, type AppRequest, type AppRequestOptions, type AppStatus, type AppTokenResponse, type AppUsageSummary, type AudienceSync, type AudienceSyncCreateParams, type AudienceSyncError, type AudienceSyncMode, type AudienceSyncPlatform, type AudienceSyncRun, type AudienceSyncUpdateParams, type Booking, type BookingRequest, type CalendarConfig, type CallGradingResult, type Campaign, type CampaignCreateConfig, type CampaignLaunchExecution, type CampaignLaunchResult, type ChatConfig, type Company, type CompanyColumn, type CompanyColumnCreateParams, type CompanyContact, type CompanyEnrichment, type CompanyListParams, type CompanyUpdateParams, type ConstructEventOptions, type Contact, type ContactColumn, type ContactColumnCreateParams, type ContactCreateParams, type ContactDeal, type ContactList, type ContactListParams, type ContactUpdateParams, type CopilotConfig, type CreatedField, type CustomObject, type CustomObjectAttribute, type CustomObjectHistory, type CustomObjectHistoryEntry, type CustomObjectRecord, DEFAULT_APP_API, type Deal, type DealCreateParams, type DealListParams, type DealUpdateParams, type DialerAgentSummary, type DialerAgentsListParams, type DialerAgentsListResult, type DialerNumberInfo, type DialerNumbersListResult, type DialerReportFilters, type DialerReportMetric, type DialerSessionCreateParams, type DialerSessionCreateResult, type DialerSessionResumeResult, type DialerSessionStatus, type DialerSessionStatusUpdateResult, type DialerSessionSummary, type DialerSessionsListParams, type DialerSessionsListResult, type DialerStatsParams, type DialerStatsResult, type EmailVerification, type EnrichLookupResult, type EvidenceKey, type Field, type FieldCreateParams, type FieldDeleteParams, type G8Config, G8Error, type G8PrivacyConfig, type GlobalContextDocument, type Graph8AppClient, type Graph8AppClientConfig, type Graph8ServiceClient, type Graph8ServiceClientConfig, type ICP, type IdentifyProperties, type InboxAssignResult, type InboxAssignee, type InboxChannel, type InboxContact, type InboxDraft, type InboxListParams, type InboxMessage, type InboxSendParams, type InboxSendResult, type InboxTag, type InboxTagResult, type InboxThread, type InstallStatus, type IntelligenceData, type IntentCompany, type IntentContact, type IntentKeyword, type IntentPage, type IntentSignals, type IntentStats, type IntentVisitor, KNOWN_WEBHOOK_EVENTS, type ListContact, type ListRecordsParams, type MarketplaceHiring, type MarketplaceOffer, type MarketplaceProfile, type MeetingAnalysis, type MeetingAttendee, type MeetingDetail, type MeetingListParams, type MeetingSummary, type MeetingTranscriptLine, type MissedCallback, type MissedCallbacksResult, type NodeTypeSchema, type Note, type ObjectPagination, type PaginatedResponse, type PaginationMeta$1 as PaginationMeta, type PersonEnrichment, type Persona, type Pipeline, type PipelineStage, type PipelineSuggestion, type QuotableProduct, type QuoteCreateParams, type QuoteDetail, type QuoteLineItem, type QuoteListParams, type QuoteSendParams, type QuoteSettings, type QuoteStatus, type QuoteSummary, type QuoteUpdateParams, type RequestOptions, type ResearchReport, type SearchCompanyItem, type SearchCondition, type SearchContactItem, type SearchFilter, type SearchOperator, type SearchParams, type SearchResults, type SearchSaveParams, type SearchSaveResult, type Sequence, type SequenceActionResult, type SequenceAnalytics, type SequenceChannelConfig, type SequenceContactItem, type SequenceContactsParams, type SequenceCreateParams, type SequenceCreateResult, type SequenceDetail, type SequenceKind, type SequenceListItem, type SequenceListParams, type SequencePreview, type SequencePreviewChannel, type SequencePreviewStep, type SequenceStepConfig, type SequenceStepInputType, type SequenceStepType, type SequenceStepUpdateParams, type SequenceUpdateParams, type SetFieldValueParams, type Skill, type SkillCreateAPIParams, type SkillCreateLLMParams, type SkillInputField, type SkillListParams, type SkillTemplate, type SkillType, type SkillUpdateAPIParams, type SkillUpdateLLMParams, type Snippet, type StageCreateParams, type StagePipeline, type StagePipelineCreateParams, type StagePipelineStage, type StagePipelineUpdateParams, type StageUpdateParams, type Task, type TaskCreateParams, type TaskListParams, type TaskUpdateParams, type TimeSlot, type TokenManager, type TrackProperties, type VisitorCompany, type VisitorScore, type VoicePagination, type WebhookEvent, type WebhookEventPayload, WebhookSignatureError, type Workflow, type WorkflowConfig, type WorkflowConnection, type WorkflowCreateParams, type WorkflowExecution, type WorkflowListParams, type WorkflowNode, type WorkflowUpdateParams, backoffDelayMs, constructEvent, createAppRequester, createGraph8AppClient, createGraph8ServiceClient, createTokenManager, exchangeBrowserToken, exchangeServiceToken, g8, isRetryableStatus, paginate, parseRetryAfter, request };
+export { type AddToSequenceConfig, type AgencyClient, type AgencyInfo, type App, type AppCreateParams, type AppDomain, type AppInstallation, type AppLimit, type AppLogs, type AppRequest, type AppRequestOptions, type AppSecretMetadata, type AppSourceParams, type AppStatus, type AppTokenResponse, type AppUsageSummary, type AudienceSync, type AudienceSyncCreateParams, type AudienceSyncError, type AudienceSyncMode, type AudienceSyncPlatform, type AudienceSyncRun, type AudienceSyncUpdateParams, type Booking, type BookingRequest, type CalendarConfig, type CallGradingResult, type Campaign, type CampaignCreateConfig, type CampaignLaunchExecution, type CampaignLaunchResult, type ChatConfig, type Company, type CompanyColumn, type CompanyColumnCreateParams, type CompanyContact, type CompanyEnrichment, type CompanyListParams, type CompanyUpdateParams, type ConstructEventOptions, type Contact, type ContactColumn, type ContactColumnCreateParams, type ContactCreateParams, type ContactDeal, type ContactList, type ContactListParams, type ContactUpdateParams, type ContainerLog, type CopilotConfig, type CreateCustomObject, type CreateCustomObjectAttribute, type CreateDeploymentParams, type CreatedField, type CustomObject, type CustomObjectAttribute, type CustomObjectHistory, type CustomObjectHistoryEntry, type CustomObjectIcon, type CustomObjectMutation, type CustomObjectMutations, type CustomObjectRecord, DEFAULT_APP_API, type Deal, type DealCreateParams, type DealListParams, type DealUpdateParams, type Deployment, type DeploymentStatus, type DialerAgentSummary, type DialerAgentsListParams, type DialerAgentsListResult, type DialerNumberInfo, type DialerNumbersListResult, type DialerReportFilters, type DialerReportMetric, type DialerSessionCreateParams, type DialerSessionCreateResult, type DialerSessionResumeResult, type DialerSessionStatus, type DialerSessionStatusUpdateResult, type DialerSessionSummary, type DialerSessionsListParams, type DialerSessionsListResult, type DialerStatsParams, type DialerStatsResult, type DomainVerificationInstructions, type DomainVerificationStatus, type EmailVerification, type EnrichLookupResult, type EvidenceKey, type Field, type FieldCreateParams, type FieldDeleteParams, type G8Config, G8Error, type G8PrivacyConfig, type GlobalContextDocument, type Graph8AppClient, type Graph8AppClientConfig, type Graph8ServiceClient, type Graph8ServiceClientConfig, type ICP, type IdentifyProperties, type InboxAssignResult, type InboxAssignee, type InboxChannel, type InboxContact, type InboxDraft, type InboxListParams, type InboxMessage, type InboxSendParams, type InboxSendResult, type InboxTag, type InboxTagResult, type InboxThread, type InstallStatus, type IntelligenceData, type IntentCompany, type IntentContact, type IntentKeyword, type IntentPage, type IntentSignals, type IntentStats, type IntentVisitor, KNOWN_WEBHOOK_EVENTS, type ListContact, type ListRecordsParams, MAX_TAIL_LINES, MIN_TAIL_LINES, type MarketplaceHiring, type MarketplaceOffer, type MarketplaceProfile, type MeetingAnalysis, type MeetingAttendee, type MeetingDetail, type MeetingListParams, type MeetingSummary, type MeetingTranscriptLine, type MissedCallback, type MissedCallbacksResult, type NodeTypeSchema, type Note, type ObjectPagination, type PaginatedResponse, type PaginationMeta$1 as PaginationMeta, type PersonEnrichment, type Persona, type Pipeline, type PipelineStage, type PipelineSuggestion, type QuotableProduct, type QuoteCreateParams, type QuoteDetail, type QuoteLineItem, type QuoteListParams, type QuoteSendParams, type QuoteSettings, type QuoteStatus, type QuoteSummary, type QuoteUpdateParams, type RequestOptions, type ResearchReport, type SchemaVersion, type SchemaVersionStatus, type SearchCompanyItem, type SearchCondition, type SearchContactItem, type SearchFilter, type SearchOperator, type SearchParams, type SearchResults, type SearchSaveParams, type SearchSaveResult, type Sequence, type SequenceActionResult, type SequenceAnalytics, type SequenceChannelConfig, type SequenceContactItem, type SequenceContactsParams, type SequenceCreateParams, type SequenceCreateResult, type SequenceDetail, type SequenceKind, type SequenceListItem, type SequenceListParams, type SequencePreview, type SequencePreviewChannel, type SequencePreviewStep, type SequenceStepConfig, type SequenceStepInputType, type SequenceStepType, type SequenceStepUpdateParams, type SequenceUpdateParams, type SetFieldValueParams, type Skill, type SkillCreateAPIParams, type SkillCreateLLMParams, type SkillInputField, type SkillListParams, type SkillTemplate, type SkillType, type SkillUpdateAPIParams, type SkillUpdateLLMParams, type Snippet, type SourceProvider, type StageCreateParams, type StagePipeline, type StagePipelineCreateParams, type StagePipelineStage, type StagePipelineUpdateParams, type StageUpdateParams, type Task, type TaskCreateParams, type TaskListParams, type TaskUpdateParams, type TimeSlot, type TokenManager, type TrackProperties, type UpdateCustomObject, type UpdateCustomObjectAttribute, type VisitorCompany, type VisitorScore, type VoicePagination, type WebhookEvent, type WebhookEventPayload, WebhookSignatureError, type Workflow, type WorkflowConfig, type WorkflowConnection, type WorkflowCreateParams, type WorkflowExecution, type WorkflowListParams, type WorkflowNode, type WorkflowUpdateParams, backoffDelayMs, constructEvent, createAppPlatformClient, createAppRequester, createGraph8AppClient, createGraph8ServiceClient, createTokenManager, exchangeBrowserToken, exchangeServiceToken, g8, isRetryableStatus, paginate, parseRetryAfter, request };