@gpt-platform/client 0.10.0 → 0.10.1

package/dist/index.d.ts

@@ -606,7 +606,7 @@ declare class BrowserApiKeyError extends Error {
 }
 
 /** SDK version — updated automatically by mix update.sdks */
-declare const SDK_VERSION = "0.10.0";
+declare const SDK_VERSION = "0.10.1";
 /** Default API version sent in every request — updated automatically by mix update.sdks */
 declare const DEFAULT_API_VERSION = "2026-03-23";
 
@@ -12305,6 +12305,317 @@ interface CompletionEstimate {
     blockers: string[];
 }
 
+/** Attributes accepted by `POST /social/accounts` (create action). */
+interface SocialAccountCreateAttributes {
+    platform: string;
+    platform_user_id?: string;
+    display_name?: string;
+    avatar_url?: string;
+    account_type?: string;
+    is_active?: boolean;
+    posting_enabled?: boolean;
+    metadata?: Record<string, unknown>;
+}
+/** Attributes accepted by `PATCH /social/accounts/:id` (update action). */
+interface SocialAccountUpdateAttributes {
+    display_name?: string;
+    avatar_url?: string;
+    metadata?: Record<string, unknown>;
+    last_verified_at?: string;
+}
+/** Attributes accepted by `POST /social/posts` (create action). */
+interface SocialPostCreateAttributes {
+    platform: string;
+    content: string;
+    media_urls?: string[];
+    hashtags?: string[];
+    link_url?: string;
+    link_metadata?: Record<string, unknown>;
+    max_retries?: number;
+    social_account_id: string;
+    social_campaign_id?: string;
+}
+/** Attributes accepted by `PATCH /social/posts/:id` (update action). */
+interface SocialPostUpdateAttributes {
+    content?: string;
+    media_urls?: string[];
+    hashtags?: string[];
+    link_url?: string;
+    link_metadata?: Record<string, unknown>;
+    platform_metadata?: Record<string, unknown>;
+}
+/** Attributes accepted by `POST /social/campaigns` (create action). */
+interface SocialCampaignCreateAttributes {
+    /** Required. Campaign name. */
+    name: string;
+    /** Content brief that the AI will use to generate master copy. */
+    content_brief?: string;
+    /** Target platforms, e.g. ["twitter", "linkedin", "instagram"]. */
+    target_platforms?: string[];
+    /** Media URLs to include in generated posts. */
+    media_urls?: string[];
+    /** SEO keywords for content optimization. */
+    seo_keywords?: string[];
+    /** Optional brand identity UUID for tone/style guidance. */
+    brand_identity_id?: string;
+}
+/** Attributes accepted by `PATCH /social/campaigns/:id` (update action). */
+interface SocialCampaignUpdateAttributes {
+    name?: string;
+    content_brief?: string;
+    target_platforms?: string[];
+    media_urls?: string[];
+    seo_keywords?: string[];
+    brand_identity_id?: string;
+}
+/**
+ * Social media management namespace — accounts, posts, metrics, and campaigns.
+ *
+ * Covers the full social publishing lifecycle: connect accounts, create and
+ * schedule posts, collect engagement metrics, and run AI-powered social campaigns.
+ *
+ * @example
+ * ```typescript
+ * const client = new GptClient({ apiKey: 'sk_app_...' });
+ *
+ * // List connected accounts
+ * const accounts = await client.social.accounts.listByWorkspace('ws_abc');
+ *
+ * // Create and schedule a post
+ * const post = await client.social.posts.create({ ... });
+ * await client.social.posts.schedule(post.id, '2026-03-10T12:00:00Z');
+ *
+ * // Get latest metrics
+ * const metrics = await client.social.metrics.latestForPost(post.id);
+ * ```
+ */
+declare function createSocialNamespace(rb: RequestBuilder): {
+    /** Social account management — connect, enable/disable, and deactivate accounts. */
+    accounts: {
+        /** List social accounts for a workspace. */
+        listByWorkspace: (workspaceId: string, options?: RequestOptions) => Promise<unknown>;
+        /** List social accounts by platform (e.g. "twitter", "instagram"). */
+        listByPlatform: (platform: string, options?: RequestOptions) => Promise<unknown>;
+        /** Get a single social account by ID. */
+        get: (id: string, options?: RequestOptions) => Promise<unknown>;
+        /** Connect a new social account. */
+        create: (attributes: SocialAccountCreateAttributes, options?: RequestOptions) => Promise<unknown>;
+        /** Update a social account. */
+        update: (id: string, attributes: SocialAccountUpdateAttributes, options?: RequestOptions) => Promise<unknown>;
+        /** Delete a social account. */
+        delete: (id: string, options?: RequestOptions) => Promise<unknown>;
+        /** Enable posting on an account. */
+        enablePosting: (id: string, options?: RequestOptions) => Promise<unknown>;
+        /** Disable posting on an account. */
+        disablePosting: (id: string, options?: RequestOptions) => Promise<unknown>;
+        /** Deactivate (disconnect) an account. */
+        deactivate: (id: string, options?: RequestOptions) => Promise<unknown>;
+    };
+    /** Social post management — create, schedule, publish, cancel, and retry posts. */
+    posts: {
+        /** Create a new social post draft. */
+        create: (attributes: SocialPostCreateAttributes, options?: RequestOptions) => Promise<unknown>;
+        /** Get a single post by ID. */
+        get: (id: string, options?: RequestOptions) => Promise<unknown>;
+        /** Update a draft post. */
+        update: (id: string, attributes: SocialPostUpdateAttributes, options?: RequestOptions) => Promise<unknown>;
+        /** Delete a post. */
+        delete: (id: string, options?: RequestOptions) => Promise<unknown>;
+        /** Schedule a post for future publishing. */
+        schedule: (id: string, scheduledAt: string, options?: RequestOptions) => Promise<unknown>;
+        /** Publish a post immediately. */
+        publishNow: (id: string, options?: RequestOptions) => Promise<unknown>;
+        /** Cancel a scheduled or draft post. */
+        cancel: (id: string, options?: RequestOptions) => Promise<unknown>;
+        /** Retry a failed post. */
+        retry: (id: string, options?: RequestOptions) => Promise<unknown>;
+        /** Update SEO metadata on a post. */
+        updateSeo: (id: string, attributes: {
+            seo_score?: number;
+            seo_analysis?: Record<string, unknown>;
+        }, options?: RequestOptions) => Promise<unknown>;
+        /** List scheduled posts. */
+        listScheduled: (options?: RequestOptions) => Promise<unknown>;
+        /** List posts by account. */
+        listByAccount: (socialAccountId: string, options?: RequestOptions) => Promise<unknown>;
+        /** List posts by campaign. */
+        listByCampaign: (socialCampaignId: string, options?: RequestOptions) => Promise<unknown>;
+        /** List all posts for a workspace. */
+        listByWorkspace: (workspaceId: string, options?: RequestOptions) => Promise<unknown>;
+    };
+    /** Post engagement metrics — impressions, reach, likes, comments, and more. */
+    metrics: {
+        /** Get a single metric record by ID. */
+        get: (id: string, options?: RequestOptions) => Promise<unknown>;
+        /** List all metrics for a post. */
+        listByPost: (socialPostId: string, options?: RequestOptions) => Promise<unknown>;
+        /** Get the latest metric per collection window for a post. */
+        latestForPost: (socialPostId: string, options?: RequestOptions) => Promise<unknown>;
+        /** Aggregate metrics across all posts for a social account. */
+        byAccount: (socialAccountId: string, options?: RequestOptions) => Promise<unknown>;
+        /** Aggregate metrics across all posts in a social campaign. */
+        byCampaign: (socialCampaignId: string, options?: RequestOptions) => Promise<unknown>;
+    };
+    /** AI-powered social campaigns — generate master copy and adapt for platforms. */
+    campaigns: {
+        /** List all social campaigns. */
+        list: (options?: RequestOptions) => Promise<unknown>;
+        /** Get a single campaign by ID. */
+        get: (id: string, options?: RequestOptions) => Promise<unknown>;
+        /**
+         * Create a new social campaign.
+         * Workspace is resolved from the authenticated user's context — do NOT
+         * pass `workspace_id` in attributes.
+         */
+        create: (attributes: SocialCampaignCreateAttributes, options?: RequestOptions) => Promise<unknown>;
+        /** Update a campaign. */
+        update: (id: string, attributes: SocialCampaignUpdateAttributes, options?: RequestOptions) => Promise<unknown>;
+        /** Delete a campaign. */
+        delete: (id: string, options?: RequestOptions) => Promise<unknown>;
+        /** Schedule a campaign for a future date. */
+        schedule: (id: string, scheduledAt: string, options?: RequestOptions) => Promise<unknown>;
+        /** Cancel a campaign. */
+        cancel: (id: string, options?: RequestOptions) => Promise<unknown>;
+        /** Generate AI master copy from the campaign's content brief. */
+        generateMasterCopy: (id: string, workspaceId: string, options?: RequestOptions) => Promise<unknown>;
+        /** Adapt master copy for target platforms and create SocialPost drafts. */
+        adaptForPlatforms: (id: string, workspaceId: string, socialAccountId: string, options?: RequestOptions) => Promise<unknown>;
+    };
+    /** Trending content discovery — snapshots, items, and watch alerts. */
+    trending: {
+        /**
+         * Get a trending snapshot by ID.
+         * @param id - Snapshot UUID
+         * @returns TrendingSnapshot with metadata (query, enrichment level, item count)
+         * @example
+         * ```typescript
+         * const snapshot = await client.social.trending.get('snap_abc');
+         * ```
+         */
+        get: (id: string, options?: RequestOptions) => Promise<unknown>;
+        /**
+         * List trending snapshots for a workspace.
+         * @param workspaceId - Workspace UUID
+         * @returns Array of TrendingSnapshot records
+         * @example
+         * ```typescript
+         * const snapshots = await client.social.trending.listByWorkspace('ws_abc');
+         * ```
+         */
+        listByWorkspace: (workspaceId: string, options?: RequestOptions) => Promise<unknown>;
+        /**
+         * Create a trending snapshot (trigger on-demand collection).
+         * @param attributes - Snapshot attributes (workspace_id, enrichment_level, etc.)
+         * @returns Created TrendingSnapshot
+         * @example
+         * ```typescript
+         * const snapshot = await client.social.trending.create({
+         *   workspace_id: 'ws_abc',
+         *   enrichment_level: 'scored',
+         *   fetched_at: new Date().toISOString(),
+         * });
+         * ```
+         */
+        create: (attributes: {
+            workspace_id: string;
+            enrichment_level?: "raw" | "scored" | "summarized" | "full";
+            query?: string;
+            source_breakdown?: Record<string, unknown>;
+            item_count?: number;
+            fetched_at?: string;
+        }, options?: RequestOptions) => Promise<unknown>;
+        /** Delete a trending snapshot by ID. */
+        delete: (id: string, options?: RequestOptions) => Promise<unknown>;
+        /**
+         * List trending snapshots within a date range.
+         * @param from - Start date (ISO 8601 string)
+         * @param to - End date (ISO 8601 string)
+         * @returns Array of TrendingSnapshot records in the range
+         * @example
+         * ```typescript
+         * const snapshots = await client.social.trending.listByDateRange(
+         *   '2026-03-01T00:00:00Z',
+         *   '2026-03-21T23:59:59Z',
+         * );
+         * ```
+         */
+        listByDateRange: (from: string, to: string, options?: RequestOptions) => Promise<unknown>;
+        /** Trending snapshot items — individual content pieces within a snapshot. */
+        items: {
+            /** Get a single trending item by ID. */
+            get: (id: string, options?: RequestOptions) => Promise<unknown>;
+            /**
+             * List trending items for a snapshot.
+             * @param snapshotId - Parent snapshot UUID
+             * @returns Array of TrendingSnapshotItem records
+             * @example
+             * ```typescript
+             * const items = await client.social.trending.items.listBySnapshot('snap_abc');
+             * ```
+             */
+            listBySnapshot: (snapshotId: string, options?: RequestOptions) => Promise<unknown>;
+        };
+    };
+    /** Trending watch alerts — monitor topics and get notified on matches. */
+    watches: {
+        /**
+         * Get a trending watch by ID.
+         * @param id - Watch UUID
+         * @returns TrendingWatch with conditions and notification config
+         */
+        get: (id: string, options?: RequestOptions) => Promise<unknown>;
+        /**
+         * List trending watches for a workspace.
+         * @param workspaceId - Workspace UUID
+         * @returns Array of TrendingWatch records
+         * @example
+         * ```typescript
+         * const watches = await client.social.watches.listByWorkspace('ws_abc');
+         * ```
+         */
+        listByWorkspace: (workspaceId: string, options?: RequestOptions) => Promise<unknown>;
+        /**
+         * Create a new trending watch alert.
+         * @param attributes - Watch attributes (name, query, conditions, notification_config)
+         * @returns Created TrendingWatch
+         * @example
+         * ```typescript
+         * const watch = await client.social.watches.create({
+         *   workspace_id: 'ws_abc',
+         *   name: 'AI Industry News',
+         *   query: 'artificial intelligence',
+         *   conditions: { min_score: 0.7 },
+         *   notification_config: { channel: 'webhook', url: 'https://...' },
+         * });
+         * ```
+         */
+        create: (attributes: {
+            workspace_id: string;
+            name: string;
+            query: string;
+            sources?: string[];
+            conditions?: Record<string, unknown>;
+            notification_config?: Record<string, unknown>;
+            enabled?: boolean;
+        }, options?: RequestOptions) => Promise<unknown>;
+        /**
+         * Update a trending watch.
+         * @param id - Watch UUID
+         * @param attributes - Fields to update (name, query, conditions, enabled, etc.)
+         */
+        update: (id: string, attributes: {
+            name?: string;
+            query?: string;
+            sources?: string[];
+            conditions?: Record<string, unknown>;
+            notification_config?: Record<string, unknown>;
+            enabled?: boolean;
+        }, options?: RequestOptions) => Promise<unknown>;
+        /** Delete a trending watch by ID. */
+        delete: (id: string, options?: RequestOptions) => Promise<unknown>;
+    };
+};
+
 /** Attributes accepted when creating a new ingestion claim. */
 type CreateWatcherClaimAttributes = {
     document_id: string;
@@ -24824,6 +25135,11 @@ interface UpdateClientResourceAssignmentAttributes {
 interface TriggerPipelineResponse {
     execution_id: string | null;
 }
+/** Options for triggering a pipeline on a clinical session. */
+interface TriggerPipelineOptions {
+    /** Slug of a specific pipeline to trigger. Defaults to "post-session-documentation". */
+    pipeline_slug?: string;
+}
 interface PatientAdherenceGoals {
     total: number;
     completed: number;
@@ -25224,18 +25540,27 @@ declare function createClinicalNamespace(rb: RequestBuilder): {
          *
          * @param sessionId - Session UUID
          * @param workspaceId - Workspace UUID
+         * @param triggerOptions - Optional pipeline targeting (pipeline_slug)
          * @param options - Request options
          * @returns {@link TriggerPipelineResponse} with execution_id (may be null if pipeline not configured)
          *
          * @example
          * ```typescript
+         * // Default pipeline (post-session-documentation)
          * const { execution_id } = await client.clinical.sessions.triggerPipeline(
          *   'sess_xyz',
          *   'ws_123',
          * );
+         *
+         * // Specific pipeline by slug
+         * const { execution_id: eid } = await client.clinical.sessions.triggerPipeline(
+         *   'sess_xyz',
+         *   'ws_123',
+         *   { pipeline_slug: 'chartless-quick-goals-update' },
+         * );
          * ```
          */
-        triggerPipeline: (sessionId: string, workspaceId: string, options?: RequestOptions) => Promise<TriggerPipelineResponse>;
+        triggerPipeline: (sessionId: string, workspaceId: string, triggerOptions?: TriggerPipelineOptions, options?: RequestOptions) => Promise<TriggerPipelineResponse>;
     };
     /**
      * Manage clinical notes (SOAP notes, progress notes, AI-generated summaries).
@@ -28387,23 +28712,26 @@ declare class GptClient extends BaseClient {
             listByWorkspace: (workspaceId: string, options?: RequestOptions) => Promise<unknown>;
             listByPlatform: (platform: string, options?: RequestOptions) => Promise<unknown>;
             get: (id: string, options?: RequestOptions) => Promise<unknown>;
-            create: (attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
-            update: (id: string, attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
+            create: (attributes: SocialAccountCreateAttributes, options?: RequestOptions) => Promise<unknown>;
+            update: (id: string, attributes: SocialAccountUpdateAttributes, options?: RequestOptions) => Promise<unknown>;
             delete: (id: string, options?: RequestOptions) => Promise<unknown>;
             enablePosting: (id: string, options?: RequestOptions) => Promise<unknown>;
             disablePosting: (id: string, options?: RequestOptions) => Promise<unknown>;
             deactivate: (id: string, options?: RequestOptions) => Promise<unknown>;
         };
         posts: {
-            create: (attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
+            create: (attributes: SocialPostCreateAttributes, options?: RequestOptions) => Promise<unknown>;
             get: (id: string, options?: RequestOptions) => Promise<unknown>;
-            update: (id: string, attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
+            update: (id: string, attributes: SocialPostUpdateAttributes, options?: RequestOptions) => Promise<unknown>;
             delete: (id: string, options?: RequestOptions) => Promise<unknown>;
             schedule: (id: string, scheduledAt: string, options?: RequestOptions) => Promise<unknown>;
             publishNow: (id: string, options?: RequestOptions) => Promise<unknown>;
             cancel: (id: string, options?: RequestOptions) => Promise<unknown>;
             retry: (id: string, options?: RequestOptions) => Promise<unknown>;
-            updateSeo: (id: string, attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
+            updateSeo: (id: string, attributes: {
+                seo_score?: number;
+                seo_analysis?: Record<string, unknown>;
+            }, options?: RequestOptions) => Promise<unknown>;
             listScheduled: (options?: RequestOptions) => Promise<unknown>;
             listByAccount: (socialAccountId: string, options?: RequestOptions) => Promise<unknown>;
             listByCampaign: (socialCampaignId: string, options?: RequestOptions) => Promise<unknown>;
@@ -28419,8 +28747,8 @@ declare class GptClient extends BaseClient {
         campaigns: {
             list: (options?: RequestOptions) => Promise<unknown>;
             get: (id: string, options?: RequestOptions) => Promise<unknown>;
-            create: (attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
-            update: (id: string, attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
+            create: (attributes: SocialCampaignCreateAttributes, options?: RequestOptions) => Promise<unknown>;
+            update: (id: string, attributes: SocialCampaignUpdateAttributes, options?: RequestOptions) => Promise<unknown>;
             delete: (id: string, options?: RequestOptions) => Promise<unknown>;
             schedule: (id: string, scheduledAt: string, options?: RequestOptions) => Promise<unknown>;
             cancel: (id: string, options?: RequestOptions) => Promise<unknown>;
@@ -28430,7 +28758,14 @@ declare class GptClient extends BaseClient {
         trending: {
             get: (id: string, options?: RequestOptions) => Promise<unknown>;
             listByWorkspace: (workspaceId: string, options?: RequestOptions) => Promise<unknown>;
-            create: (attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
+            create: (attributes: {
+                workspace_id: string;
+                enrichment_level?: "raw" | "scored" | "summarized" | "full";
+                query?: string;
+                source_breakdown?: Record<string, unknown>;
+                item_count?: number;
+                fetched_at?: string;
+            }, options?: RequestOptions) => Promise<unknown>;
             delete: (id: string, options?: RequestOptions) => Promise<unknown>;
             listByDateRange: (from: string, to: string, options?: RequestOptions) => Promise<unknown>;
             items: {
@@ -28441,8 +28776,23 @@ declare class GptClient extends BaseClient {
         watches: {
             get: (id: string, options?: RequestOptions) => Promise<unknown>;
             listByWorkspace: (workspaceId: string, options?: RequestOptions) => Promise<unknown>;
-            create: (attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
-            update: (id: string, attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
+            create: (attributes: {
+                workspace_id: string;
+                name: string;
+                query: string;
+                sources?: string[];
+                conditions?: Record<string, unknown>;
+                notification_config?: Record<string, unknown>;
+                enabled?: boolean;
+            }, options?: RequestOptions) => Promise<unknown>;
+            update: (id: string, attributes: {
+                name?: string;
+                query?: string;
+                sources?: string[];
+                conditions?: Record<string, unknown>;
+                notification_config?: Record<string, unknown>;
+                enabled?: boolean;
+            }, options?: RequestOptions) => Promise<unknown>;
             delete: (id: string, options?: RequestOptions) => Promise<unknown>;
         };
     };
@@ -28753,225 +29103,6 @@ declare class Webhooks {
     static safeVerify(payload: string, signatureHeader: string, secret: string, options?: WebhookVerifyOptions): Promise<boolean>;
 }
 
-/**
- * Social media management namespace — accounts, posts, metrics, and campaigns.
- *
- * Covers the full social publishing lifecycle: connect accounts, create and
- * schedule posts, collect engagement metrics, and run AI-powered social campaigns.
- *
- * @example
- * ```typescript
- * const client = new GptClient({ apiKey: 'sk_app_...' });
- *
- * // List connected accounts
- * const accounts = await client.social.accounts.listByWorkspace('ws_abc');
- *
- * // Create and schedule a post
- * const post = await client.social.posts.create({ ... });
- * await client.social.posts.schedule(post.id, '2026-03-10T12:00:00Z');
- *
- * // Get latest metrics
- * const metrics = await client.social.metrics.latestForPost(post.id);
- * ```
- */
-declare function createSocialNamespace(rb: RequestBuilder): {
-    /** Social account management — connect, enable/disable, and deactivate accounts. */
-    accounts: {
-        /** List social accounts for a workspace. */
-        listByWorkspace: (workspaceId: string, options?: RequestOptions) => Promise<unknown>;
-        /** List social accounts by platform (e.g. "twitter", "instagram"). */
-        listByPlatform: (platform: string, options?: RequestOptions) => Promise<unknown>;
-        /** Get a single social account by ID. */
-        get: (id: string, options?: RequestOptions) => Promise<unknown>;
-        /** Connect a new social account. */
-        create: (attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
-        /** Update a social account. */
-        update: (id: string, attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
-        /** Delete a social account. */
-        delete: (id: string, options?: RequestOptions) => Promise<unknown>;
-        /** Enable posting on an account. */
-        enablePosting: (id: string, options?: RequestOptions) => Promise<unknown>;
-        /** Disable posting on an account. */
-        disablePosting: (id: string, options?: RequestOptions) => Promise<unknown>;
-        /** Deactivate (disconnect) an account. */
-        deactivate: (id: string, options?: RequestOptions) => Promise<unknown>;
-    };
-    /** Social post management — create, schedule, publish, cancel, and retry posts. */
-    posts: {
-        /** Create a new social post draft. */
-        create: (attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
-        /** Get a single post by ID. */
-        get: (id: string, options?: RequestOptions) => Promise<unknown>;
-        /** Update a draft post. */
-        update: (id: string, attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
-        /** Delete a post. */
-        delete: (id: string, options?: RequestOptions) => Promise<unknown>;
-        /** Schedule a post for future publishing. */
-        schedule: (id: string, scheduledAt: string, options?: RequestOptions) => Promise<unknown>;
-        /** Publish a post immediately. */
-        publishNow: (id: string, options?: RequestOptions) => Promise<unknown>;
-        /** Cancel a scheduled or draft post. */
-        cancel: (id: string, options?: RequestOptions) => Promise<unknown>;
-        /** Retry a failed post. */
-        retry: (id: string, options?: RequestOptions) => Promise<unknown>;
-        /** Update SEO metadata on a post. */
-        updateSeo: (id: string, attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
-        /** List scheduled posts. */
-        listScheduled: (options?: RequestOptions) => Promise<unknown>;
-        /** List posts by account. */
-        listByAccount: (socialAccountId: string, options?: RequestOptions) => Promise<unknown>;
-        /** List posts by campaign. */
-        listByCampaign: (socialCampaignId: string, options?: RequestOptions) => Promise<unknown>;
-        /** List all posts for a workspace. */
-        listByWorkspace: (workspaceId: string, options?: RequestOptions) => Promise<unknown>;
-    };
-    /** Post engagement metrics — impressions, reach, likes, comments, and more. */
-    metrics: {
-        /** Get a single metric record by ID. */
-        get: (id: string, options?: RequestOptions) => Promise<unknown>;
-        /** List all metrics for a post. */
-        listByPost: (socialPostId: string, options?: RequestOptions) => Promise<unknown>;
-        /** Get the latest metric per collection window for a post. */
-        latestForPost: (socialPostId: string, options?: RequestOptions) => Promise<unknown>;
-        /** Aggregate metrics across all posts for a social account. */
-        byAccount: (socialAccountId: string, options?: RequestOptions) => Promise<unknown>;
-        /** Aggregate metrics across all posts in a social campaign. */
-        byCampaign: (socialCampaignId: string, options?: RequestOptions) => Promise<unknown>;
-    };
-    /** AI-powered social campaigns — generate master copy and adapt for platforms. */
-    campaigns: {
-        /** List all social campaigns. */
-        list: (options?: RequestOptions) => Promise<unknown>;
-        /** Get a single campaign by ID. */
-        get: (id: string, options?: RequestOptions) => Promise<unknown>;
-        /** Create a new social campaign. */
-        create: (attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
-        /** Update a campaign. */
-        update: (id: string, attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
-        /** Delete a campaign. */
-        delete: (id: string, options?: RequestOptions) => Promise<unknown>;
-        /** Schedule a campaign for a future date. */
-        schedule: (id: string, scheduledAt: string, options?: RequestOptions) => Promise<unknown>;
-        /** Cancel a campaign. */
-        cancel: (id: string, options?: RequestOptions) => Promise<unknown>;
-        /** Generate AI master copy from the campaign's content brief. */
-        generateMasterCopy: (id: string, workspaceId: string, options?: RequestOptions) => Promise<unknown>;
-        /** Adapt master copy for target platforms and create SocialPost drafts. */
-        adaptForPlatforms: (id: string, workspaceId: string, socialAccountId: string, options?: RequestOptions) => Promise<unknown>;
-    };
-    /** Trending content discovery — snapshots, items, and watch alerts. */
-    trending: {
-        /**
-         * Get a trending snapshot by ID.
-         * @param id - Snapshot UUID
-         * @returns TrendingSnapshot with metadata (query, enrichment level, item count)
-         * @example
-         * ```typescript
-         * const snapshot = await client.social.trending.get('snap_abc');
-         * ```
-         */
-        get: (id: string, options?: RequestOptions) => Promise<unknown>;
-        /**
-         * List trending snapshots for a workspace.
-         * @param workspaceId - Workspace UUID
-         * @returns Array of TrendingSnapshot records
-         * @example
-         * ```typescript
-         * const snapshots = await client.social.trending.listByWorkspace('ws_abc');
-         * ```
-         */
-        listByWorkspace: (workspaceId: string, options?: RequestOptions) => Promise<unknown>;
-        /**
-         * Create a trending snapshot (trigger on-demand collection).
-         * @param attributes - Snapshot attributes (workspace_id, enrichment_level, etc.)
-         * @returns Created TrendingSnapshot
-         * @example
-         * ```typescript
-         * const snapshot = await client.social.trending.create({
-         *   workspace_id: 'ws_abc',
-         *   enrichment_level: 'scored',
-         *   fetched_at: new Date().toISOString(),
-         * });
-         * ```
-         */
-        create: (attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
-        /** Delete a trending snapshot by ID. */
-        delete: (id: string, options?: RequestOptions) => Promise<unknown>;
-        /**
-         * List trending snapshots within a date range.
-         * @param from - Start date (ISO 8601 string)
-         * @param to - End date (ISO 8601 string)
-         * @returns Array of TrendingSnapshot records in the range
-         * @example
-         * ```typescript
-         * const snapshots = await client.social.trending.listByDateRange(
-         *   '2026-03-01T00:00:00Z',
-         *   '2026-03-21T23:59:59Z',
-         * );
-         * ```
-         */
-        listByDateRange: (from: string, to: string, options?: RequestOptions) => Promise<unknown>;
-        /** Trending snapshot items — individual content pieces within a snapshot. */
-        items: {
-            /** Get a single trending item by ID. */
-            get: (id: string, options?: RequestOptions) => Promise<unknown>;
-            /**
-             * List trending items for a snapshot.
-             * @param snapshotId - Parent snapshot UUID
-             * @returns Array of TrendingSnapshotItem records
-             * @example
-             * ```typescript
-             * const items = await client.social.trending.items.listBySnapshot('snap_abc');
-             * ```
-             */
-            listBySnapshot: (snapshotId: string, options?: RequestOptions) => Promise<unknown>;
-        };
-    };
-    /** Trending watch alerts — monitor topics and get notified on matches. */
-    watches: {
-        /**
-         * Get a trending watch by ID.
-         * @param id - Watch UUID
-         * @returns TrendingWatch with conditions and notification config
-         */
-        get: (id: string, options?: RequestOptions) => Promise<unknown>;
-        /**
-         * List trending watches for a workspace.
-         * @param workspaceId - Workspace UUID
-         * @returns Array of TrendingWatch records
-         * @example
-         * ```typescript
-         * const watches = await client.social.watches.listByWorkspace('ws_abc');
-         * ```
-         */
-        listByWorkspace: (workspaceId: string, options?: RequestOptions) => Promise<unknown>;
-        /**
-         * Create a new trending watch alert.
-         * @param attributes - Watch attributes (name, query, conditions, notification_config)
-         * @returns Created TrendingWatch
-         * @example
-         * ```typescript
-         * const watch = await client.social.watches.create({
-         *   workspace_id: 'ws_abc',
-         *   name: 'AI Industry News',
-         *   query: 'artificial intelligence',
-         *   conditions: { min_score: 0.7 },
-         *   notification_config: { channel: 'webhook', url: 'https://...' },
-         * });
-         * ```
-         */
-        create: (attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
-        /**
-         * Update a trending watch.
-         * @param id - Watch UUID
-         * @param attributes - Fields to update (name, query, conditions, enabled, etc.)
-         */
-        update: (id: string, attributes: Record<string, unknown>, options?: RequestOptions) => Promise<unknown>;
-        /** Delete a trending watch by ID. */
-        delete: (id: string, options?: RequestOptions) => Promise<unknown>;
-    };
-};
-
 /**
  * Creates the memory namespace for structured document section navigation.
  *