@elevasis/sdk 1.48.0 → 1.49.0

package/dist/test-utils/index.d.ts

@@ -812,13 +812,52 @@ interface JsonSchema {
  * Universal interfaces for LLM interaction across all resource types
  */
 
+/**
+ * One piece of a multipart `LLMMessage.content`. Modeled close to OpenAI's shape (a single `url`
+ * field covers both a hosted URL and a `data:` base64 URL) rather than Anthropic's three-way
+ * `source` split, because OpenAI's shape is the one every provider's translation layer can derive
+ * the other from -- the Anthropic adapter is the side that branches on the `data:` prefix to
+ * recover the split its wire format wants (see `adapters/server/anthropic.ts`).
+ */
+type LLMContentPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    /**
+     * A `data:<mediaType>;base64,<data>` URL, or an `https://...` URL the provider fetches
+     * itself. Base64 is the recommended default: a hosted `url` means the PROVIDER fetches it
+     * at call time, so a signed org-storage URL must still be public and unexpired when the
+     * provider reaches it, an extra failure mode a caller must manage. Base64 removes that
+     * dependency at the cost of payload size -- Anthropic caps a single image at 10 MB.
+     */
+    url: string;
+    /** Overrides the media type parsed off a `data:` URL prefix. Required when `url` is a
+     *  hosted (non-`data:`) URL and the provider needs it -- Anthropic's `url` source infers
+     *  the type itself, but callers on a stricter provider should not assume that. */
+    mediaType?: string;
+    /** OpenAI-only hint for how much detail to preserve when downsampling. Ignored by
+     *  providers (Anthropic, OpenRouter-as-Anthropic) that do not read it. */
+    detail?: 'auto' | 'low' | 'high';
+};
 /**
  * Standard chat message format
  * Compatible with OpenAI, Anthropic, and other providers
  */
 interface LLMMessage {
     role: 'system' | 'user' | 'assistant';
-    content: string;
+    /**
+     * A plain string for the common unstructured case, or a parts array to attach an image
+     * alongside (or instead of) text -- see `LLMContentPart`. This is a WIDENING, not a
+     * replacement: every existing caller passing a bare string keeps compiling and behaving
+     * identically.
+     *
+     * Not every model/adapter can accept an `image` part -- `MockAdapter` throws
+     * `LLMUnsupportedContentError` rather than silently ignoring it, and a caller sending an image
+     * to a text-only integration should expect the same rather than a plausible-looking
+     * text-degraded response. See `llm/errors.ts`.
+     */
+    content: string | LLMContentPart[];
     /**
      * Marks this message as the end of a byte-stable prefix worth an Anthropic cache breakpoint,
      * beyond the one the system prompt already gets. Anthropic's rule is "everything up to and
@@ -1017,8 +1056,13 @@ interface LLMAdapter {
 
 /**
  * Supported Open AI models (direct SDK access)
+ *
+ * The GPT-5.6 tiers are three separate ids rather than the bare `gpt-5.6` alias. Upstream that
+ * alias routes to Sol, so registering it would put two keys with identical pricing in `MODEL_INFO`
+ * and hide which tier actually ran in `ai_calls`. Leaving it out means a caller who writes
+ * `'gpt-5.6'` is rejected by the dispatcher rather than silently billed at Sol rates.
  */
-type OpenAIModel = 'gpt-5' | 'gpt-5.4-mini' | 'gpt-5.4-nano';
+type OpenAIModel = 'gpt-5' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'gpt-5.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna';
 /**
  * Supported OpenRouter models (explicit union for type safety)
  */
@@ -1034,15 +1078,36 @@ type LLMModel = OpenAIModel | OpenRouterModel | AnthropicModel | 'mock';
  */
 declare const GPT5OptionsSchema: z.ZodObject<{
     reasoning_effort: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        high: "high";
         minimal: "minimal";
+        medium: "medium";
+    }>>;
+    verbosity: z.ZodOptional<z.ZodEnum<{
         low: "low";
+        high: "high";
         medium: "medium";
+    }>>;
+}, z.core.$strip>;
+/**
+ * GPT-5.6 model options schema
+ *
+ * NOT the GPT-5 enum. 5.6 removed `minimal` and added `none`, `xhigh`, and `max`, so reusing
+ * `GPT5OptionsSchema` would accept one value 5.6 rejects and reject three it accepts.
+ */
+declare const GPT56OptionsSchema: z.ZodObject<{
+    reasoning_effort: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        low: "low";
         high: "high";
+        medium: "medium";
+        xhigh: "xhigh";
+        max: "max";
     }>>;
     verbosity: z.ZodOptional<z.ZodEnum<{
         low: "low";
-        medium: "medium";
         high: "high";
+        medium: "medium";
     }>>;
 }, z.core.$strip>;
 /**
@@ -1064,10 +1129,11 @@ declare const AnthropicOptionsSchema: z.ZodObject<{}, z.core.$strict>;
  * Infer TypeScript types from schemas
  */
 type GPT5Options = z.infer<typeof GPT5OptionsSchema>;
+type GPT56Options = z.infer<typeof GPT56OptionsSchema>;
 type MockOptions = Record<string, never>;
 type OpenRouterOptions = z.infer<typeof OpenRouterOptionsSchema>;
 type AnthropicOptions = z.infer<typeof AnthropicOptionsSchema>;
-type ModelSpecificOptions = GPT5Options | MockOptions | OpenRouterOptions | AnthropicOptions;
+type ModelSpecificOptions = GPT5Options | GPT56Options | MockOptions | OpenRouterOptions | AnthropicOptions;
 /**
  * Model configuration for LLM execution
  * Belongs in resource definition (AgentDefinition, WorkflowDefinition, etc.)
@@ -3044,6 +3110,63 @@ type Database = {
                     }
                 ];
             };
+            content_item_source_assets: {
+                Row: {
+                    alt_text: string | null;
+                    content_item_id: string;
+                    created_at: string;
+                    crop: Json | null;
+                    derivative_crop: Json | null;
+                    derivative_path: string | null;
+                    derivative_rendered_at: string | null;
+                    id: string;
+                    organization_id: string;
+                    position: number;
+                    source_asset_id: string;
+                };
+                Insert: {
+                    alt_text?: string | null;
+                    content_item_id: string;
+                    created_at?: string;
+                    crop?: Json | null;
+                    derivative_crop?: Json | null;
+                    derivative_path?: string | null;
+                    derivative_rendered_at?: string | null;
+                    id?: string;
+                    organization_id: string;
+                    position: number;
+                    source_asset_id: string;
+                };
+                Update: {
+                    alt_text?: string | null;
+                    content_item_id?: string;
+                    created_at?: string;
+                    crop?: Json | null;
+                    derivative_crop?: Json | null;
+                    derivative_path?: string | null;
+                    derivative_rendered_at?: string | null;
+                    id?: string;
+                    organization_id?: string;
+                    position?: number;
+                    source_asset_id?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "content_item_source_assets_asset_fkey";
+                        columns: ["source_asset_id", "organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "content_source_assets";
+                        referencedColumns: ["id", "organization_id"];
+                    },
+                    {
+                        foreignKeyName: "content_item_source_assets_item_fkey";
+                        columns: ["content_item_id", "organization_id"];
+                        isOneToOne: false;
+                        referencedRelation: "content_items";
+                        referencedColumns: ["id", "organization_id"];
+                    }
+                ];
+            };
             content_items: {
                 Row: {
                     body: string | null;
@@ -4799,6 +4922,25 @@ type Database = {
                 };
                 Returns: Json;
             };
+            activate_deployment_atomic: {
+                Args: {
+                    p_deployment_id: string;
+                    p_organization_id: string;
+                };
+                Returns: {
+                    created_at: string;
+                    deployment_version: string | null;
+                    error_message: string | null;
+                    id: string;
+                    organization_id: string;
+                    pid: number | null;
+                    port: number | null;
+                    sdk_version: string;
+                    status: string;
+                    tarball_path: string | null;
+                    updated_at: string;
+                };
+            };
             append_deal_activity: {
                 Args: {
                     p_activity: Json;
@@ -6398,7 +6540,9 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
         properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         storage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$loose>>>>;
+        rowSchema: z.ZodOptional<z.ZodString>;
+        stateCatalogId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>>;
     linkTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -6409,7 +6553,7 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         to: z.ZodString;
         cardinality: z.ZodOptional<z.ZodString>;
         via: z.ZodOptional<z.ZodString>;
-    }, z.core.$loose>>>>;
+    }, z.core.$strict>>>>;
     actionTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -6419,7 +6563,11 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         actsOn: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
         input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         effects: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-    }, z.core.$loose>>>>;
+        resourceId: z.ZodOptional<z.ZodString>;
+        invocations: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+        lifecycle: z.ZodOptional<z.ZodString>;
+        legacyActionId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>>;
     catalogTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -6429,7 +6577,10 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         kind: z.ZodOptional<z.ZodString>;
         appliesTo: z.ZodOptional<z.ZodString>;
         entries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$loose>>>>;
+        legacyCatalogKey: z.ZodOptional<z.ZodString>;
+        legacyPipelineKey: z.ZodOptional<z.ZodString>;
+        legacyEntityKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>>;
     eventTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -6437,7 +6588,7 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         ownerSystemId: z.ZodOptional<z.ZodString>;
         aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
         payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$loose>>>>;
+    }, z.core.$strict>>>>;
     interfaceTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -6445,7 +6596,7 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         ownerSystemId: z.ZodOptional<z.ZodString>;
         aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
         properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$loose>>>>;
+    }, z.core.$strict>>>>;
     valueTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -6453,7 +6604,7 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         ownerSystemId: z.ZodOptional<z.ZodString>;
         aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
         primitive: z.ZodOptional<z.ZodString>;
-    }, z.core.$loose>>>>;
+    }, z.core.$strict>>>>;
     sharedProperties: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -6463,7 +6614,7 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         valueType: z.ZodOptional<z.ZodString>;
         searchable: z.ZodOptional<z.ZodBoolean>;
         pii: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$loose>>>>;
+    }, z.core.$strict>>>>;
     groups: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -6471,7 +6622,7 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         ownerSystemId: z.ZodOptional<z.ZodString>;
         aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
         members: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
-    }, z.core.$loose>>>>;
+    }, z.core.$strict>>>>;
     endpoints: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
@@ -6479,7 +6630,7 @@ declare const OntologyScopeSchema: z.ZodDefault<z.ZodObject<{
         ownerSystemId: z.ZodOptional<z.ZodString>;
         aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
         route: z.ZodOptional<z.ZodString>;
-    }, z.core.$loose>>>>;
+    }, z.core.$strict>>>>;
 }, z.core.$strict>>;
 type OntologyScope = z.infer<typeof OntologyScopeSchema>;
 
@@ -7045,7 +7196,9 @@ declare const OrganizationModelSchema: z.ZodObject<{
             aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
             properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             storage: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$loose>>>>;
+            rowSchema: z.ZodOptional<z.ZodString>;
+            stateCatalogId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>>;
         linkTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -7056,7 +7209,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             to: z.ZodString;
             cardinality: z.ZodOptional<z.ZodString>;
             via: z.ZodOptional<z.ZodString>;
-        }, z.core.$loose>>>>;
+        }, z.core.$strict>>>>;
         actionTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -7066,7 +7219,11 @@ declare const OrganizationModelSchema: z.ZodObject<{
             actsOn: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
             input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             effects: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-        }, z.core.$loose>>>>;
+            resourceId: z.ZodOptional<z.ZodString>;
+            invocations: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+            lifecycle: z.ZodOptional<z.ZodString>;
+            legacyActionId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>>;
         catalogTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -7076,7 +7233,10 @@ declare const OrganizationModelSchema: z.ZodObject<{
             kind: z.ZodOptional<z.ZodString>;
             appliesTo: z.ZodOptional<z.ZodString>;
             entries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$loose>>>>;
+            legacyCatalogKey: z.ZodOptional<z.ZodString>;
+            legacyPipelineKey: z.ZodOptional<z.ZodString>;
+            legacyEntityKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>>>;
         eventTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -7084,7 +7244,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             ownerSystemId: z.ZodOptional<z.ZodString>;
             aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
             payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$loose>>>>;
+        }, z.core.$strict>>>>;
         interfaceTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -7092,7 +7252,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             ownerSystemId: z.ZodOptional<z.ZodString>;
             aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
             properties: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$loose>>>>;
+        }, z.core.$strict>>>>;
         valueTypes: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -7100,7 +7260,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             ownerSystemId: z.ZodOptional<z.ZodString>;
             aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
             primitive: z.ZodOptional<z.ZodString>;
-        }, z.core.$loose>>>>;
+        }, z.core.$strict>>>>;
         sharedProperties: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -7110,7 +7270,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             valueType: z.ZodOptional<z.ZodString>;
             searchable: z.ZodOptional<z.ZodBoolean>;
             pii: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$loose>>>>;
+        }, z.core.$strict>>>>;
         groups: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -7118,7 +7278,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             ownerSystemId: z.ZodOptional<z.ZodString>;
             aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
             members: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
-        }, z.core.$loose>>>>;
+        }, z.core.$strict>>>>;
         endpoints: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             id: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
@@ -7126,7 +7286,7 @@ declare const OrganizationModelSchema: z.ZodObject<{
             ownerSystemId: z.ZodOptional<z.ZodString>;
             aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
             route: z.ZodOptional<z.ZodString>;
-        }, z.core.$loose>>>>;
+        }, z.core.$strict>>>>;
     }, z.core.$strict>>>;
     resources: z.ZodDefault<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
         id: z.ZodString;
@@ -8143,6 +8303,166 @@ interface CreateFolderResult {
         path_display: string;
     } | null;
 }
+/**
+ * List folder parameters
+ *
+ * Pass `cursor` (from a previous result) to fetch only what changed since
+ * that cursor -- Dropbox's incremental-sync mechanism, not an optional
+ * convenience.
+ */
+interface ListFolderParams {
+    path?: string;
+    recursive?: boolean;
+    cursor?: string;
+}
+/**
+ * A single file or folder entry returned by listFolder
+ */
+interface DropboxListFolderEntry {
+    '.tag': 'file' | 'folder' | 'deleted';
+    id: string;
+    name: string;
+    path_lower?: string;
+    path_display?: string;
+    size?: number;
+    content_hash?: string;
+}
+/**
+ * List folder result
+ */
+interface ListFolderResult {
+    entries: DropboxListFolderEntry[];
+    cursor: string;
+    has_more: boolean;
+}
+/**
+ * Get metadata parameters
+ */
+interface GetMetadataParams {
+    id: string;
+}
+/**
+ * Photo/video-specific metadata
+ */
+interface DropboxMediaMetadata {
+    '.tag': 'photo' | 'video';
+    dimensions?: {
+        height: number;
+        width: number;
+    };
+    time_taken?: string;
+}
+/**
+ * Wrapper around media metadata, matching Dropbox's tagged-union response shape
+ */
+interface DropboxMediaInfo {
+    '.tag': 'metadata' | 'absent';
+    metadata?: DropboxMediaMetadata;
+}
+/**
+ * Get metadata result
+ */
+interface GetMetadataResult {
+    id: string;
+    name: string;
+    path_lower?: string;
+    path_display?: string;
+    size?: number;
+    content_hash?: string;
+    media_info?: DropboxMediaInfo;
+}
+/**
+ * Get temporary link parameters
+ */
+interface GetTemporaryLinkParams {
+    id: string;
+}
+/**
+ * Get temporary link result (valid four hours, never persist)
+ */
+interface GetTemporaryLinkResult {
+    link: string;
+    metadata: {
+        id: string;
+        name: string;
+        path_lower?: string;
+        path_display?: string;
+    };
+}
+/**
+ * Create shared link parameters
+ */
+interface CreateSharedLinkParams {
+    id: string;
+}
+/**
+ * Create shared link result (url is always the raw, bytes-inline form)
+ */
+interface CreateSharedLinkResult {
+    url: string;
+    id: string;
+    name: string;
+}
+/**
+ * Download parameters
+ */
+interface DownloadParams {
+    id: string;
+}
+/**
+ * Download result (Uint8Array for browser safety)
+ */
+interface DownloadResult {
+    content: Uint8Array;
+    contentType: string;
+    name: string;
+}
+type DropboxThumbnailFormat = 'jpeg' | 'png';
+type DropboxThumbnailSize = 'w32h32' | 'w64h64' | 'w128h128' | 'w256h256' | 'w480h320' | 'w640h480' | 'w960h640' | 'w1024h768' | 'w2048h1536';
+/**
+ * Get thumbnail parameters
+ */
+interface GetThumbnailParams {
+    id: string;
+    format?: DropboxThumbnailFormat;
+    size?: DropboxThumbnailSize;
+}
+/**
+ * Get thumbnail result (Uint8Array for browser safety)
+ *
+ * `available: false` is a normal result, not an error -- Dropbox does not
+ * convert every file type (e.g. HEIC) or files over 20MB.
+ */
+interface GetThumbnailResult {
+    available: boolean;
+    content?: Uint8Array;
+    contentType?: string;
+}
+/**
+ * Get thumbnail batch parameters
+ *
+ * Dropbox caps this at 25 ids per request.
+ */
+interface GetThumbnailBatchParams {
+    ids: string[];
+    format?: DropboxThumbnailFormat;
+    size?: DropboxThumbnailSize;
+}
+/**
+ * A single entry in a batch thumbnail result (Uint8Array for browser safety)
+ */
+interface ThumbnailBatchEntry {
+    id: string;
+    available: boolean;
+    content?: Uint8Array;
+    contentType?: string;
+}
+/**
+ * Get thumbnail batch result
+ */
+interface GetThumbnailBatchResult {
+    entries: ThumbnailBatchEntry[];
+}
 
 /**
  * Shared Gmail param/result types (browser-safe)
@@ -9598,6 +9918,78 @@ declare const ContentDistributionStatusSchema: z.ZodString;
  * schema validates JSON-object shape and size only, not field membership.
  */
 declare const ContentPayloadEnvelopeSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+/** Request-side crop: `.strict()`, the same mass-assignment guard every request schema in this file uses. */
+declare const ContentAssetCropInputSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strict>;
+declare const ContentItemSourceAssetResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    organizationId: z.ZodString;
+    contentItemId: z.ZodString;
+    sourceAssetId: z.ZodString;
+    position: z.ZodNumber;
+    crop: z.ZodNullable<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    altText: z.ZodNullable<z.ZodString>;
+    derivativePath: z.ZodNullable<z.ZodString>;
+    derivativeCrop: z.ZodNullable<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    derivativeRenderedAt: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+declare const ContentItemSourceAssetListResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        organizationId: z.ZodString;
+        contentItemId: z.ZodString;
+        sourceAssetId: z.ZodString;
+        position: z.ZodNumber;
+        crop: z.ZodNullable<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+        altText: z.ZodNullable<z.ZodString>;
+        derivativePath: z.ZodNullable<z.ZodString>;
+        derivativeCrop: z.ZodNullable<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+        derivativeRenderedAt: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * One membership as a caller supplies it. Two callers share it:
+ * `CreateContentItemRequestSchema.sourceAssets` (the ordered set a carousel is
+ * created with, in one transaction) and the body of the `addItemSourceAsset`
+ * write, whose `itemId` arrives as a path param rather than in the body.
+ */
+declare const ContentItemSourceAssetInputSchema: z.ZodObject<{
+    sourceAssetId: z.ZodString;
+    position: z.ZodNumber;
+    crop: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strict>>>;
+    altText: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
 declare const ContentItemResponseSchema: z.ZodObject<{
     id: z.ZodString;
     organizationId: z.ZodString;
@@ -9609,6 +10001,29 @@ declare const ContentItemResponseSchema: z.ZodObject<{
     pipelineId: z.ZodNullable<z.ZodString>;
     clientId: z.ZodNullable<z.ZodString>;
     sourceAssetId: z.ZodNullable<z.ZodString>;
+    sourceAssets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        organizationId: z.ZodString;
+        contentItemId: z.ZodString;
+        sourceAssetId: z.ZodString;
+        position: z.ZodNumber;
+        crop: z.ZodNullable<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+        altText: z.ZodNullable<z.ZodString>;
+        derivativePath: z.ZodNullable<z.ZodString>;
+        derivativeCrop: z.ZodNullable<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+        derivativeRenderedAt: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>>;
     processingState: z.ZodRecord<z.ZodString, z.ZodObject<{
         status: z.ZodEnum<{
             error: "error";
@@ -9643,6 +10058,29 @@ declare const ContentItemListResponseSchema: z.ZodObject<{
         pipelineId: z.ZodNullable<z.ZodString>;
         clientId: z.ZodNullable<z.ZodString>;
         sourceAssetId: z.ZodNullable<z.ZodString>;
+        sourceAssets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            organizationId: z.ZodString;
+            contentItemId: z.ZodString;
+            sourceAssetId: z.ZodString;
+            position: z.ZodNumber;
+            crop: z.ZodNullable<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strip>>;
+            altText: z.ZodNullable<z.ZodString>;
+            derivativePath: z.ZodNullable<z.ZodString>;
+            derivativeCrop: z.ZodNullable<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strip>>;
+            derivativeRenderedAt: z.ZodNullable<z.ZodString>;
+            createdAt: z.ZodString;
+        }, z.core.$strip>>>;
         processingState: z.ZodRecord<z.ZodString, z.ZodObject<{
             status: z.ZodEnum<{
                 error: "error";
@@ -9733,6 +10171,31 @@ declare const ContentSourceAssetResponseSchema: z.ZodObject<{
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
 }, z.core.$strip>;
+/**
+ * One entry in a distribution's `media_urls`.
+ *
+ * Two kinds genuinely coexist: an object in a Supabase storage bucket, and a
+ * URL that is already fetchable. Both used to be stored as bare strings, so
+ * every reader had to classify an entry by looking for a URI scheme — the same
+ * guess, re-derived in each consumer, wrong the moment a storage key contains
+ * a colon. The entry names its own kind instead.
+ *
+ * A `storage` entry carries its own `bucket` so a reader does not hardcode one;
+ * the bucket is private, so the path is signed at read time rather than stored
+ * as a URL that expires.
+ *
+ * This is deliberately NOT `z.union([z.string(), ...])`. Accepting both shapes
+ * would relocate the heuristic rather than remove it, so existing rows are
+ * migrated instead (`content-distribution-media-entries.sql`).
+ */
+declare const ContentMediaEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"storage">;
+    bucket: z.ZodString;
+    path: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"url">;
+    url: z.ZodString;
+}, z.core.$strict>], "kind">;
 declare const ContentDistributionResponseSchema: z.ZodObject<{
     id: z.ZodString;
     organizationId: z.ZodString;
@@ -9743,7 +10206,14 @@ declare const ContentDistributionResponseSchema: z.ZodObject<{
     adaptedBody: z.ZodNullable<z.ZodString>;
     platformContent: z.ZodNullable<z.ZodUnknown>;
     checklist: z.ZodNullable<z.ZodUnknown>;
-    mediaUrls: z.ZodArray<z.ZodUnknown>;
+    mediaUrls: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"storage">;
+        bucket: z.ZodString;
+        path: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"url">;
+        url: z.ZodString;
+    }, z.core.$strict>], "kind">>;
     processingState: z.ZodRecord<z.ZodString, z.ZodObject<{
         status: z.ZodEnum<{
             error: "error";
@@ -9774,11 +10244,16 @@ type ContentDistributionPlatform = z.infer<typeof ContentDistributionPlatformSch
 type ContentDistributionFormat = z.infer<typeof ContentDistributionFormatSchema>;
 type ContentDistributionStatus = z.infer<typeof ContentDistributionStatusSchema>;
 type ContentPayloadEnvelope = z.infer<typeof ContentPayloadEnvelopeSchema>;
+type ContentAssetCropInput = z.infer<typeof ContentAssetCropInputSchema>;
+type ContentItemSourceAssetResponse = z.infer<typeof ContentItemSourceAssetResponseSchema>;
+type ContentItemSourceAssetListResponse = z.infer<typeof ContentItemSourceAssetListResponseSchema>;
+type ContentItemSourceAssetInput = z.infer<typeof ContentItemSourceAssetInputSchema>;
 type ContentItemResponse = z.infer<typeof ContentItemResponseSchema>;
 type ContentItemListResponse = z.infer<typeof ContentItemListResponseSchema>;
 type ContentItemAttemptResponse = z.infer<typeof ContentItemAttemptResponseSchema>;
 type ContentItemAttemptListResponse = z.infer<typeof ContentItemAttemptListResponseSchema>;
 type ContentSourceAssetResponse = z.infer<typeof ContentSourceAssetResponseSchema>;
+type ContentMediaEntry = z.infer<typeof ContentMediaEntrySchema>;
 type ContentDistributionResponse = z.infer<typeof ContentDistributionResponseSchema>;
 
 /**
@@ -10212,6 +10687,34 @@ type DropboxToolMap = {
         params: CreateFolderParams;
         result: CreateFolderResult;
     };
+    listFolder: {
+        params: ListFolderParams;
+        result: ListFolderResult;
+    };
+    getMetadata: {
+        params: GetMetadataParams;
+        result: GetMetadataResult;
+    };
+    getTemporaryLink: {
+        params: GetTemporaryLinkParams;
+        result: GetTemporaryLinkResult;
+    };
+    createSharedLink: {
+        params: CreateSharedLinkParams;
+        result: CreateSharedLinkResult;
+    };
+    download: {
+        params: DownloadParams;
+        result: DownloadResult;
+    };
+    getThumbnail: {
+        params: GetThumbnailParams;
+        result: GetThumbnailResult;
+    };
+    getThumbnailBatch: {
+        params: GetThumbnailBatchParams;
+        result: GetThumbnailBatchResult;
+    };
 };
 type SignatureApiToolMap = {
     createEnvelope: {
@@ -10739,7 +11242,15 @@ type ArtifactsToolMap = {
     };
 };
 type ContentToolMap = {
-    /** Insert a new `content_items` row -- a producer's entry point for a new piece. */
+    /**
+     * Insert a new `content_items` row -- a producer's entry point for a new piece.
+     *
+     * `sourceAssets` is the ordered membership a carousel is created with, in
+     * ONE transaction (Open Decision 11, 2026-08-17 -- hybrid). Index is not
+     * position: each entry names its own `position`, and 0 is the cover. Every
+     * later membership mutation is one of the four dedicated methods below --
+     * `updateItem` never touches membership.
+     */
     createItem: {
         params: {
             title: string;
@@ -10750,6 +11261,7 @@ type ContentToolMap = {
             pipelineId?: ContentPipelineId | null;
             clientId?: string | null;
             sourceAssetId?: string | null;
+            sourceAssets?: ContentItemSourceAssetInput[];
         };
         result: ContentItemResponse;
     };
@@ -10775,6 +11287,13 @@ type ContentToolMap = {
     /**
      * Update an item's mutable fields as it advances through the pipeline.
      * Does NOT accept a `processingState` field -- see Decision 4 above.
+     *
+     * STANDING CONVENTION -- Open Decision 11 (enforced by omission): there is no
+     * `sourceAssets` field here and there must not be one. A wholesale-replace
+     * array would force every partial item update to say something about the
+     * asset list, and once omission means "leave alone" there is no way to clear
+     * membership at all. The four methods below own every membership mutation
+     * after creation.
      */
     updateItem: {
         params: {
@@ -10789,6 +11308,72 @@ type ContentToolMap = {
         };
         result: ContentItemResponse;
     };
+    /**
+     * Link one source asset into an item at a given slide position (0 is the
+     * cover). `organizationId` is never a parameter here or on the three methods
+     * below: both foreign keys on `content_item_source_assets` are COMPOSITE
+     * against `(id, organization_id)`, so the database refuses a cross-org link
+     * structurally rather than by convention.
+     *
+     * There is deliberately no `listItemSourceAssets` method -- membership comes
+     * back on `getItem` / `listItems` as `ContentItemResponse.sourceAssets`.
+     */
+    addItemSourceAsset: {
+        params: {
+            itemId: string;
+            sourceAssetId: string;
+            /** Slide order, 0 is the cover. Unique within the item. */
+            position: number;
+            /** Per-MEMBERSHIP crop box in normalized fractions -- the same photo crops differently per item. */
+            crop?: ContentAssetCropInput | null;
+            altText?: string | null;
+        };
+        result: ContentItemSourceAssetResponse;
+    };
+    /**
+     * Unlink one source asset from an item. The asset row itself is untouched --
+     * `content_item_source_assets.source_asset_id` is `ON DELETE RESTRICT`
+     * precisely so a used asset cannot vanish out from under a published post.
+     */
+    removeItemSourceAsset: {
+        params: {
+            itemId: string;
+            sourceAssetId: string;
+        };
+        result: void;
+    };
+    /**
+     * Reorder an item's slides. `orderedAssetIds` is the item's COMPLETE
+     * membership in its new order -- index becomes `position`, so index 0 is the
+     * new cover, and a list that does not name exactly the current membership is
+     * rejected.
+     *
+     * `UNIQUE (content_item_id, position)` is DEFERRABLE INITIALLY DEFERRED, so
+     * this is plain per-row updates inside one transaction. An implementation
+     * that shuffles through a temporary offset is a sign the deferrable
+     * constraint was not used.
+     */
+    reorderItemSourceAssets: {
+        params: {
+            itemId: string;
+            orderedAssetIds: string[];
+        };
+        result: ContentItemSourceAssetListResponse;
+    };
+    /**
+     * Patch one membership's per-slide attributes. `position` is not here --
+     * moving a slide is `reorderItemSourceAssets` -- and neither is
+     * `sourceAssetId`: swapping the asset is a remove plus an add.
+     */
+    updateItemSourceAsset: {
+        params: {
+            itemId: string;
+            sourceAssetId: string;
+            crop?: ContentAssetCropInput | null;
+            altText?: string | null;
+        };
+        result: ContentItemSourceAssetResponse;
+    };
     /**
      * Record a pipeline-step attempt against an item. `attemptNumber` is
      * assigned server-side inside the write (Decision 6) -- never
@@ -10881,6 +11466,30 @@ type ContentToolMap = {
         };
         result: ContentSourceAssetResponse;
     };
+    /**
+     * Fetch a single distribution by id, org-scoped -- lets a producer read back
+     * a distribution it just wrote before writing to it again, the idempotency
+     * check `createDistribution`/`updateDistribution` alone cannot provide.
+     */
+    getDistribution: {
+        params: {
+            distributionId: string;
+        };
+        result: ContentDistributionResponse | null;
+    };
+    /** Query distributions -- e.g. a producer checking what's already been created for an item. */
+    listDistributions: {
+        params: {
+            contentItemId?: string;
+            platform?: ContentDistributionPlatform;
+            status?: ContentDistributionStatus;
+            limit?: number;
+            offset?: number;
+        };
+        result: {
+            data: ContentDistributionResponse[];
+        };
+    };
     /** Insert a `content_distributions` row for one platform/format target. */
     createDistribution: {
         params: {
@@ -10891,7 +11500,7 @@ type ContentToolMap = {
             adaptedBody?: string | null;
             platformContent?: unknown;
             checklist?: unknown;
-            mediaUrls?: unknown[];
+            mediaUrls?: ContentMediaEntry[];
         };
         result: ContentDistributionResponse;
     };
@@ -10903,7 +11512,7 @@ type ContentToolMap = {
             adaptedBody?: string | null;
             platformContent?: unknown;
             checklist?: unknown;
-            mediaUrls?: unknown[];
+            mediaUrls?: ContentMediaEntry[];
             publishMethod?: string | null;
             publishedAt?: string | null;
             platformPostId?: string | null;
@@ -11975,14 +12584,18 @@ interface DeploymentSpec {
 type LLMProvider = 'openai' | 'anthropic' | 'openrouter';
 /**
  * SDK LLM generate params.
- * Extends LLMGenerateRequest with required provider/model for worker→platform dispatch.
- * Provider and model must always be specified explicitly — no implicit fallback.
+ *
+ * `provider` and `model` are optional, and omitting them is a real choice rather than a shorthand:
+ * the platform then resolves the pair from the resource's own `modelConfig`, and failing that from
+ * the `DEFAULT_LLM_MODEL` environment variable. A call that names a model always wins, so a
+ * resource that states its model keeps stating it. Supply both or neither — a half-supplied pair is
+ * rejected, because pairing an explicit provider with a defaulted model silently mismatches them.
  */
 interface SDKLLMGenerateParams extends Omit<LLMGenerateRequest, 'signal'> {
-    /** LLM provider */
-    provider: LLMProvider;
-    /** Model identifier — must be a supported LLMModel */
-    model: LLMModel;
+    /** LLM provider. Omit to inherit the resource's `modelConfig`, then the platform default. */
+    provider?: LLMProvider;
+    /** Model identifier — must be a supported LLMModel. Omit to inherit alongside `provider`. */
+    model?: LLMModel;
 }
 
 /**