@mindstudio-ai/agent 0.1.82 → 0.1.83

package/dist/index.d.ts

@@ -1292,6 +1292,195 @@ interface Db {
     batch(...queries: PromiseLike<unknown>[]): Promise<unknown[]>;
 }
 
+/**
+ * Access level of a file store. `private` (the default) → reads are signed /
+ * session-authorized; `public` → CDN-served (public serving ships later).
+ */
+type FileAccess = 'public' | 'private';
+/** Options for {@link Store.put}. */
+interface PutOptions {
+    /**
+     * Object key within the store (nested paths allowed, e.g. `reports/q1.pdf`).
+     * Omit to auto-generate a UUID key (with `filename`'s extension, if given).
+     */
+    key?: string;
+    /** MIME type stored on the object and returned on read. */
+    contentType?: string;
+    /** Original filename — used only to derive an extension when `key` is omitted. */
+    filename?: string;
+    /**
+     * When true (and no explicit `key`), derive the key from a content hash
+     * (`<sha256>.<ext>`) instead of a random UUID — immutable + idempotent, so
+     * re-uploading identical bytes yields the same key/URL. Ideal for public
+     * assets baked into source.
+     */
+    contentAddressed?: boolean;
+}
+/** Options for {@link Store.list}. */
+interface ListOptions {
+    /** Restrict to keys under this prefix (relative to the store). */
+    prefix?: string;
+    /** Pagination cursor from a previous page. */
+    cursor?: string;
+    /** Max objects per page. */
+    limit?: number;
+}
+/** A stored object plus a ready-to-use URL. */
+interface StoredFile {
+    store: string;
+    key: string;
+    access: FileAccess;
+    size?: number;
+    contentType?: string;
+    updatedAt?: string;
+    /**
+     * Stable, on-domain URL for the app's own frontend — drop straight into
+     * `<img src>`, `fetch`, or `<a download>`. Relative (resolves against the
+     * app's origin); a same-origin logged-in request authorizes automatically
+     * via the app session, so there's nothing to await.
+     */
+    url: string;
+    /**
+     * Mint an ABSOLUTE, signed share URL that works with **no** active session —
+     * email it, or embed it on another site. Expires (default 24h). Private
+     * stores only.
+     */
+    shareUrl(options?: {
+        expiresIn?: number;
+    }): Promise<string>;
+}
+/**
+ * A token for a client-direct upload, from {@link Store.createUploadToken}.
+ * Return it from a backend method and pass it straight to the frontend's
+ * `platform.upload(token, file)` — the browser then POSTs the file directly to
+ * storage (no bytes through the platform).
+ */
+interface UploadToken {
+    /** The object key the upload will land at (within the store). */
+    key: string;
+    /** The stable on-domain URL the file will be readable at once uploaded. */
+    url: string;
+    /** @internal The scoped presigned POST the frontend submits to. */
+    upload: {
+        url: string;
+        fields: Record<string, string>;
+    };
+}
+/** @internal Per-store upload policy carried from `defineStore`. */
+interface StorePolicy {
+    maxSize?: number;
+    contentTypes?: string[];
+}
+/** @internal Transport: `POST /_internal/v2/files/<op>` with the hook token. */
+type FilesTransport = (op: string, body: unknown) => Promise<any>;
+/**
+ * A typed handle to one named file store. Lazy — nothing executes until a
+ * method is awaited, so it's safe to `defineStore()` at module scope and import
+ * the handle into route handlers (same ergonomics as `db.defineTable`).
+ */
+declare class Store {
+    private readonly _store;
+    private readonly _access;
+    private readonly _call;
+    private readonly _policy;
+    constructor(_store: string, _access: FileAccess, _call: FilesTransport, _policy?: StorePolicy);
+    /** The store's access level. */
+    get access(): FileAccess;
+    /** Store bytes. Returns a {@link StoredFile} with a ready-to-use `url`. */
+    put(content: Buffer | Uint8Array | string, options?: PutOptions): Promise<StoredFile>;
+    /** Read an object's bytes (backend / trusted context). */
+    get(key: string): Promise<Buffer>;
+    /** Metadata without downloading. Rejects if the object doesn't exist. */
+    head(key: string): Promise<StoredFile>;
+    /** Whether an object exists. */
+    exists(key: string): Promise<boolean>;
+    /** List objects in the store (optionally under `prefix`), one page at a time. */
+    list(options?: ListOptions): Promise<{
+        files: StoredFile[];
+        cursor?: string;
+    }>;
+    /** Delete an object. No-op if it doesn't exist. */
+    delete(key: string): Promise<void>;
+    /**
+     * Mint an {@link UploadToken} for a **client-direct** upload — the browser
+     * POSTs the file straight to storage, so the bytes never pass through the
+     * platform. Return the token from a backend method and hand it to the
+     * frontend's `platform.upload(token, file)`. Works for private + public stores.
+     *
+     * Enforced at upload time by the presigned POST: a max size (this call's
+     * `maxSize`, else the store's, else the platform default) and — when
+     * `contentType` is set — an exact content-type match. When the store declares
+     * `contentTypes`, `contentType` must be one of them.
+     *
+     * @example
+     * ```ts
+     * // backend method
+     * export async function getUploadSlot(input: { contentType: string }) {
+     *   return Uploads.createUploadToken({ contentType: input.contentType, maxSize: 50 * 1024 * 1024 });
+     * }
+     * ```
+     */
+    createUploadToken(options?: {
+        key?: string;
+        contentType?: string;
+        filename?: string;
+        maxSize?: number;
+        expiresIn?: number;
+    }): Promise<UploadToken>;
+    private _toFile;
+}
+
+/**
+ * The `files` namespace — typed, private-by-default file storage for MindStudio
+ * apps. The twin of `db`: define a store at module scope, import the handle into
+ * route handlers.
+ *
+ * ```ts
+ * // files/uploads.ts
+ * import { files } from '@mindstudio-ai/agent';
+ * export const Uploads = files.defineStore('uploads');               // private
+ * export const Assets  = files.defineStore('assets', { access: 'public' });
+ *
+ * // routes/upload.ts
+ * import { Uploads } from '../files/uploads';
+ * const f = await Uploads.put(buffer, { contentType, filename });
+ * return { url: f.url };            // drop into <img src> / <a download>
+ * ```
+ *
+ * `file.url` is a stable, on-domain URL a logged-in user's browser can load
+ * directly. For a link that works without a session (email, cross-site embed),
+ * use `await file.shareUrl({ expiresIn })`.
+ */
+
+/** Options for `files.defineStore()`. */
+interface DefineStoreOptions {
+    /**
+     * Access level. **Defaults to `'private'`** (signed / session-authorized
+     * reads). `'public'` marks the store CDN-served (public serving ships in a
+     * later phase). Pinned at define-time — no `put()` can change it.
+     */
+    access?: FileAccess;
+    /**
+     * Max upload size in bytes for client-direct uploads (the default for
+     * `createUploadToken`; enforced by the presigned POST). Overridable per call;
+     * capped at the platform ceiling.
+     */
+    maxSize?: number;
+    /**
+     * Allowed content types for client-direct uploads. When set,
+     * `createUploadToken({ contentType })` must pass one of these.
+     */
+    contentTypes?: string[];
+}
+/** The `files` namespace object. */
+interface Files {
+    /**
+     * Define a typed file store. Lazy — nothing executes until you await a method
+     * on the returned {@link Store}, so it's safe to call at module scope.
+     */
+    defineStore(name: string, options?: DefineStoreOptions): Store;
+}
+
 /**
  * Types for the task agent runtime.
  *
@@ -1444,6 +1633,8 @@ declare class MindStudioAgent$1 {
     private _auth;
     /** @internal Cached Db namespace instance, created during context hydration. */
     private _db;
+    /** @internal Cached Files namespace instance (lazy; no context hydration needed). */
+    private _files;
     /** @internal Auth type — 'internal' for CALLBACK_TOKEN (managed mode), 'apiKey' otherwise. */
     private _authType;
     /** @internal Usage source sent on step executions (from MINDSTUDIO_REQUEST_SOURCE).
@@ -1710,6 +1901,24 @@ declare class MindStudioAgent$1 {
      * - `ai.databases`: [{ id, name, tables[] }]
      */
     private _trySandboxHydration;
+    /**
+     * The `files` namespace — typed, private-by-default file storage (the twin of
+     * `db`). No context hydration needed: the hook token identifies the app
+     * server-side and stores are code-defined (access travels per call).
+     *
+     * @example
+     * ```ts
+     * const Uploads = agent.files.defineStore('uploads');
+     * const f = await Uploads.put(buffer, { contentType: 'image/png' });
+     * return { url: f.url };
+     * ```
+     */
+    get files(): Files;
+    /**
+     * @internal Transport for the `files` namespace — POST /_internal/v2/files/<op>
+     * with the raw hook token (mirrors `_executeDbBatch`).
+     */
+    private _filesRequest;
     /**
      * @internal Execute a batch of SQL queries against a managed database.
      * Used as the `executeBatch` callback for Table/Query instances.
@@ -5010,7 +5219,11 @@ interface SendEmailStepInput {
     subject: string;
     /** Email body content (plain text, markdown, HTML, or a CDN URL to an HTML file) */
     body: string;
-    /** Direct recipient email address(es). On the shared Remy sender these must be verified app users or members of the app's org; unrestricted when the app sends from a domain it owns. */
+    /**
+   * Direct recipient email address(es). On the shared Remy sender these must be verified app users or members of the app's org; unrestricted when the app sends from a domain it owns.
+   *
+   * Optional, but only because recipients can come from elsewhere: omit it and supply `cc`/`bcc` for a hidden-list send (the To: header is then addressed to the app's own sender), or omit all three and recipients resolve from an OAuth connection. Naming nobody at all is an error.
+   */
     to?: string | string[];
     /** Additional visible (Cc) recipient(s); same recipient rules as `to`. */
     cc?: string | string[];
@@ -8193,6 +8406,9 @@ interface StepMethods {
      * - Use the "to" field to send to one or more specific recipient email addresses directly. Allowed recipients depend on the sender: when the app sends from a domain it owns (a verified custom domain or its <slug>.madewithremy.com subdomain) any recipient is allowed; when it falls back to the shared Remy address, recipients must be verified app users or members of the app's organization. (v1 apps cannot use a direct "to" — they must resolve recipients via a connection.)
      * - Alternatively, recipient email addresses can be resolved from OAuth connections configured by the app creator via connectionId. The user running the workflow does not specify the recipient directly.
      * - Use "cc" and "bcc" to add visible / hidden recipients (a string or an array). They are subject to the same recipient rules as "to".
+     * - "to" is optional only in the sense that recipients can come from elsewhere — omit it and supply "cc"/"bcc" for a hidden-list send, or omit all three and recipients are resolved from an OAuth connection. Naming nobody at all is an error.
+     * - Bcc-only sends are supported: with no "to" or "cc", the To: header is addressed to the app's own sender address (the standard "undisclosed recipients" pattern) so recipients can't see each other. The returned "recipients" reflects that auto-filled address.
+     * - Every recipient counts toward the app's daily outbound cap, including cc and bcc.
      * - The sender defaults automatically: v2 apps send from the app's own identity — its verified custom domain if set, else its platform subdomain (noreply@<slug>.madewithremy.com), else the default Remy address.
      * - Optionally set "from" to a custom handle, but ONLY if the app has a custom domain or subdomain: a bare handle ("support" → support@<app-domain>), a full "support@your-domain.com", or "Name <support@your-domain.com>". The domain must be one the app owns, or the step fails.
      * - If the body is a URL to a hosted HTML file on the CDN, the HTML is fetched and used as the email body.
@@ -8959,6 +9175,23 @@ declare const auth: AuthContext;
  * ```
  */
 declare const db: Db;
+/**
+ * Top-level `files` namespace bound to the default singleton.
+ *
+ * Private-by-default file storage — the twin of `db`. Use
+ * `files.defineStore(name)` at module scope, then `.put/.get/.list/.delete`.
+ * `file.url` is a stable on-domain URL for the app frontend; `file.shareUrl()`
+ * mints a signed link that works without a session.
+ *
+ * @example
+ * ```ts
+ * import { files } from '@mindstudio-ai/agent';
+ *
+ * const Uploads = files.defineStore('uploads');
+ * const f = await Uploads.put(buffer, { contentType: 'application/pdf' });
+ * ```
+ */
+declare const files: Files;
 /**
  * Top-level `stream` function bound to the default singleton.
  *
@@ -9022,4 +9255,4 @@ declare const prerender: {
     }>;
 };
 
-export { type Accessor, type ActiveCampaignAddNoteStepInput, type ActiveCampaignAddNoteStepOutput, type ActiveCampaignCreateContactStepInput, type ActiveCampaignCreateContactStepOutput, type AddSubtitlesToVideoStepInput, type AddSubtitlesToVideoStepOutput, type AgentInfo, type AgentOptions, type AirtableCreateUpdateRecordStepInput, type AirtableCreateUpdateRecordStepOutput, type AirtableDeleteRecordStepInput, type AirtableDeleteRecordStepOutput, type AirtableGetRecordStepInput, type AirtableGetRecordStepOutput, type AirtableGetTableRecordsStepInput, type AirtableGetTableRecordsStepOutput, type AnalyzeImageStepInput, type AnalyzeImageStepOutput, type AnalyzeVideoStepInput, type AnalyzeVideoStepOutput, type AppAuthContext, type AppContextResult, type AppDatabase, type AppDatabaseColumnSchema, type AppDatabaseTable, type AppRoleAssignment, AuthContext, type AuthTableConfig, type BatchStepInput, type BatchStepResult, type CaptureThumbnailStepInput, type CaptureThumbnailStepOutput, type CheckAppRoleStepInput, type CheckAppRoleStepOutput, type CodaCreateUpdatePageStepInput, type CodaCreateUpdatePageStepOutput, type CodaCreateUpdateRowStepInput, type CodaCreateUpdateRowStepOutput, type CodaFindRowStepInput, type CodaFindRowStepOutput, type CodaGetPageStepInput, type CodaGetPageStepOutput, type CodaGetTableRowsStepInput, type CodaGetTableRowsStepOutput, type Connection, type ConnectorActionDetail, type ConnectorService, type ConvertPdfToImagesStepInput, type ConvertPdfToImagesStepOutput, type CreateDataSourceStepInput, type CreateDataSourceStepOutput, type CreateGmailDraftStepInput, type CreateGmailDraftStepOutput, type CreateGoogleCalendarEventStepInput, type CreateGoogleCalendarEventStepOutput, type CreateGoogleDocStepInput, type CreateGoogleDocStepOutput, type CreateGoogleSheetStepInput, type CreateGoogleSheetStepOutput, type Db, type DefineTableOptions, type DeleteDataSourceDocumentStepInput, type DeleteDataSourceDocumentStepOutput, type DeleteDataSourceStepInput, type DeleteDataSourceStepOutput, type DeleteGmailEmailStepInput, type DeleteGmailEmailStepOutput, type DeleteGoogleCalendarEventStepInput, type DeleteGoogleCalendarEventStepOutput, type DeleteGoogleSheetRowsStepInput, type DeleteGoogleSheetRowsStepOutput, type DetectChangesStepInput, type DetectChangesStepOutput, type DetectPIIStepInput, type DetectPIIStepOutput, type DiscordEditMessageStepInput, type DiscordEditMessageStepOutput, type DiscordSendFollowUpStepInput, type DiscordSendFollowUpStepOutput, type DiscordSendMessageStepInput, type DiscordSendMessageStepOutput, type DownloadVideoStepInput, type DownloadVideoStepOutput, type EnhanceImageGenerationPromptStepInput, type EnhanceImageGenerationPromptStepOutput, type EnhanceVideoGenerationPromptStepInput, type EnhanceVideoGenerationPromptStepOutput, type EnrichPersonStepInput, type EnrichPersonStepOutput, type ExecuteStepBatchOptions, type ExecuteStepBatchResult, type ExtractAudioFromVideoStepInput, type ExtractAudioFromVideoStepOutput, type ExtractTextStepInput, type ExtractTextStepOutput, type FetchDataSourceDocumentStepInput, type FetchDataSourceDocumentStepOutput, type FetchGoogleDocStepInput, type FetchGoogleDocStepOutput, type FetchGoogleSheetStepInput, type FetchGoogleSheetStepOutput, type FetchSlackChannelHistoryStepInput, type FetchSlackChannelHistoryStepOutput, type FetchYoutubeCaptionsStepInput, type FetchYoutubeCaptionsStepOutput, type FetchYoutubeChannelStepInput, type FetchYoutubeChannelStepOutput, type FetchYoutubeCommentsStepInput, type FetchYoutubeCommentsStepOutput, type FetchYoutubeVideoStepInput, type FetchYoutubeVideoStepOutput, type Generate3dModelStepInput, type Generate3dModelStepOutput, type GenerateAssetStepInput, type GenerateAssetStepOutput, type GenerateChartStepInput, type GenerateChartStepOutput, type GenerateImageStepInput, type GenerateImageStepOutput, type GenerateLipsyncStepInput, type GenerateLipsyncStepOutput, type GenerateMusicStepInput, type GenerateMusicStepOutput, type GeneratePdfStepInput, type GeneratePdfStepOutput, type GenerateStaticVideoFromImageStepInput, type GenerateStaticVideoFromImageStepOutput, type GenerateTextStepInput, type GenerateTextStepOutput, type GenerateVideoStepInput, type GenerateVideoStepOutput, type GetGmailAttachmentsStepInput, type GetGmailAttachmentsStepOutput, type GetGmailDraftStepInput, type GetGmailDraftStepOutput, type GetGmailEmailStepInput, type GetGmailEmailStepOutput, type GetGmailUnreadCountStepInput, type GetGmailUnreadCountStepOutput, type GetGoogleCalendarEventStepInput, type GetGoogleCalendarEventStepOutput, type GetGoogleDriveFileStepInput, type GetGoogleDriveFileStepOutput, type GetGoogleSheetInfoStepInput, type GetGoogleSheetInfoStepOutput, type GetMediaMetadataStepInput, type GetMediaMetadataStepOutput, type HubspotCreateCompanyStepInput, type HubspotCreateCompanyStepOutput, type HubspotCreateContactStepInput, type HubspotCreateContactStepOutput, type HubspotGetCompanyStepInput, type HubspotGetCompanyStepOutput, type HubspotGetContactStepInput, type HubspotGetContactStepOutput, type HunterApiCompanyEnrichmentStepInput, type HunterApiCompanyEnrichmentStepOutput, type HunterApiDomainSearchStepInput, type HunterApiDomainSearchStepOutput, type HunterApiEmailFinderStepInput, type HunterApiEmailFinderStepOutput, type HunterApiEmailVerificationStepInput, type HunterApiEmailVerificationStepOutput, type HunterApiPersonEnrichmentStepInput, type HunterApiPersonEnrichmentStepOutput, type ImageFaceSwapStepInput, type ImageFaceSwapStepOutput, type ImageRemoveWatermarkStepInput, type ImageRemoveWatermarkStepOutput, type InsertVideoClipsStepInput, type InsertVideoClipsStepOutput, type ListAgentsResult, type ListDataSourcesStepInput, type ListDataSourcesStepOutput, type ListGmailDraftsStepInput, type ListGmailDraftsStepOutput, type ListGmailLabelsStepInput, type ListGmailLabelsStepOutput, type ListGoogleCalendarEventsStepInput, type ListGoogleCalendarEventsStepOutput, type ListGoogleDriveFilesStepInput, type ListGoogleDriveFilesStepOutput, type ListRecentGmailEmailsStepInput, type ListRecentGmailEmailsStepOutput, type LogicStepInput, type LogicStepOutput, type MakeDotComRunScenarioStepInput, type MakeDotComRunScenarioStepOutput, type MergeAudioStepInput, type MergeAudioStepOutput, type MergeVideosStepInput, type MergeVideosStepOutput, type MeshyAnimateStepInput, type MeshyAnimateStepOutput, type MeshyImageTo3dStepInput, type MeshyImageTo3dStepOutput, type MeshyRemeshStepInput, type MeshyRemeshStepOutput, type MeshyRigStepInput, type MeshyRigStepOutput, type MeshyTextTo3dStepInput, type MeshyTextTo3dStepOutput, type MeshyTextureStepInput, type MeshyTextureStepOutput, MindStudioAgent, MindStudioError, type MindStudioModel, type MindStudioModelSummary, type MixAudioIntoVideoStepInput, type MixAudioIntoVideoStepOutput, type ModelType, type MonacoSnippet, type MonacoSnippetField, type MonacoSnippetFieldType, type MuteVideoStepInput, type MuteVideoStepOutput, type N8nRunNodeStepInput, type N8nRunNodeStepOutput, type NotionCreatePageStepInput, type NotionCreatePageStepOutput, type NotionUpdatePageStepInput, type NotionUpdatePageStepOutput, type PackagedWorkflow, type PackagedWorkflowInput, type PackagedWorkflowSignature, type ParticlePodcastsFindMentionsStepInput, type ParticlePodcastsFindMentionsStepOutput, type ParticlePodcastsGetEpisodeStepInput, type ParticlePodcastsGetEpisodeStepOutput, type ParticlePodcastsGetEpisodeTranscriptStepInput, type ParticlePodcastsGetEpisodeTranscriptStepOutput, type ParticlePodcastsSearchCompaniesStepInput, type ParticlePodcastsSearchCompaniesStepOutput, type ParticlePodcastsSearchDialogueStepInput, type ParticlePodcastsSearchDialogueStepOutput, type ParticlePodcastsSearchPodcastsStepInput, type ParticlePodcastsSearchPodcastsStepOutput, type PeopleSearchStepInput, type PeopleSearchStepOutput, type PostToLinkedInStepInput, type PostToLinkedInStepOutput, type PostToSlackChannelStepInput, type PostToSlackChannelStepOutput, type PostToXStepInput, type PostToXStepOutput, type PostToZapierStepInput, type PostToZapierStepOutput, type Predicate, type PushInput, Query, type QueryAppDatabaseStepInput, type QueryAppDatabaseStepOutput, type QueryDataSourceStepInput, type QueryDataSourceStepOutput, type QueryExternalDatabaseStepInput, type QueryExternalDatabaseStepOutput, type RedactPIIStepInput, type RedactPIIStepOutput, type RemoveBackgroundFromImageStepInput, type RemoveBackgroundFromImageStepOutput, type ReplyToGmailEmailStepInput, type ReplyToGmailEmailStepOutput, type ReportIssueInput, type ReportedIssue, type RequestContext, type ResizeVideoStepInput, type ResizeVideoStepOutput, type ResolvedUser, Roles, type RunAgentOptions, type RunAgentResult, type RunFromConnectorRegistryStepInput, type RunFromConnectorRegistryStepOutput, type RunPackagedWorkflowStepInput, type RunPackagedWorkflowStepOutput, type RunTaskOptions, type RunTaskResult, type ScrapeLinkedInCompanyStepInput, type ScrapeLinkedInCompanyStepOutput, type ScrapeLinkedInProfileStepInput, type ScrapeLinkedInProfileStepOutput, type ScrapeUrlStepInput, type ScrapeUrlStepOutput, type ScrapeXPostStepInput, type ScrapeXPostStepOutput, type ScrapeXProfileStepInput, type ScrapeXProfileStepOutput, type ScreenshotUrlStepInput, type ScreenshotUrlStepOutput, type SearchGmailEmailsStepInput, type SearchGmailEmailsStepOutput, type SearchGoogleCalendarEventsStepInput, type SearchGoogleCalendarEventsStepOutput, type SearchGoogleDriveStepInput, type SearchGoogleDriveStepOutput, type SearchGoogleImagesStepInput, type SearchGoogleImagesStepOutput, type SearchGoogleNewsStepInput, type SearchGoogleNewsStepOutput, type SearchGoogleStepInput, type SearchGoogleStepOutput, type SearchGoogleTrendsStepInput, type SearchGoogleTrendsStepOutput, type SearchPerplexityStepInput, type SearchPerplexityStepOutput, type SearchXPostsStepInput, type SearchXPostsStepOutput, type SearchYoutubeStepInput, type SearchYoutubeStepOutput, type SearchYoutubeTrendsStepInput, type SearchYoutubeTrendsStepOutput, type SendEmailStepInput, type SendEmailStepOutput, type SendGmailDraftStepInput, type SendGmailDraftStepOutput, type SendGmailMessageStepInput, type SendGmailMessageStepOutput, type SendSMSStepInput, type SendSMSStepOutput, type SendSlackDirectMessageStepInput, type SendSlackDirectMessageStepOutput, type SetGmailReadStatusStepInput, type SetGmailReadStatusStepOutput, type SetRunTitleStepInput, type SetRunTitleStepOutput, type SetVariableStepInput, type SetVariableStepOutput, type StepCostEstimateEntry, type StepExecutionMeta, type StepExecutionOptions, type StepExecutionResult, type StepInputMap, type StepLogEvent, type StepMetadata, type StepMethods, type StepName, type StepOutputMap, type SystemFields, Table, type TaskEvent, type TaskToolCall, type TaskToolConfig, type TaskUsage, type TelegramEditMessageStepInput, type TelegramEditMessageStepOutput, type TelegramReplyToMessageStepInput, type TelegramReplyToMessageStepOutput, type TelegramSendAudioStepInput, type TelegramSendAudioStepOutput, type TelegramSendFileStepInput, type TelegramSendFileStepOutput, type TelegramSendImageStepInput, type TelegramSendImageStepOutput, type TelegramSendMessageStepInput, type TelegramSendMessageStepOutput, type TelegramSendVideoStepInput, type TelegramSendVideoStepOutput, type TelegramSetTypingStepInput, type TelegramSetTypingStepOutput, type TextToSpeechStepInput, type TextToSpeechStepOutput, type TranscribeAudioStepInput, type TranscribeAudioStepOutput, type TrimMediaStepInput, type TrimMediaStepOutput, type UpdateGmailLabelsStepInput, type UpdateGmailLabelsStepOutput, type UpdateGoogleCalendarEventStepInput, type UpdateGoogleCalendarEventStepOutput, type UpdateGoogleDocStepInput, type UpdateGoogleDocStepOutput, type UpdateGoogleSheetStepInput, type UpdateGoogleSheetStepOutput, type UpdateInput, type UploadDataSourceDocumentStepInput, type UploadDataSourceDocumentStepOutput, type UploadFileResult, type UpscaleImageStepInput, type UpscaleImageStepOutput, type UpscaleVideoStepInput, type UpscaleVideoStepOutput, type User, type UserInfoResult, type UserMessageStepInput, type UserMessageStepOutput, type VideoFaceSwapStepInput, type VideoFaceSwapStepOutput, type VideoRemoveBackgroundStepInput, type VideoRemoveBackgroundStepOutput, type VideoRemoveWatermarkStepInput, type VideoRemoveWatermarkStepOutput, type WatermarkImageStepInput, type WatermarkImageStepOutput, type WatermarkVideoStepInput, type WatermarkVideoStepOutput, type YouDotComFinanceResearchStepInput, type YouDotComFinanceResearchStepOutput, type YouDotComGetPageContentStepInput, type YouDotComGetPageContentStepOutput, type YouDotComLiveNewsStepInput, type YouDotComLiveNewsStepOutput, type YouDotComWebResearchStepInput, type YouDotComWebResearchStepOutput, type YouDotComWebSearchStepInput, type YouDotComWebSearchStepOutput, auth, blockTypeAliases, db, mindstudio as default, getRequestContext, mindstudio, monacoSnippets, prerender, reportIssue, resolveUser, runWithContext, stepMetadata, stream };
+export { type Accessor, type ActiveCampaignAddNoteStepInput, type ActiveCampaignAddNoteStepOutput, type ActiveCampaignCreateContactStepInput, type ActiveCampaignCreateContactStepOutput, type AddSubtitlesToVideoStepInput, type AddSubtitlesToVideoStepOutput, type AgentInfo, type AgentOptions, type AirtableCreateUpdateRecordStepInput, type AirtableCreateUpdateRecordStepOutput, type AirtableDeleteRecordStepInput, type AirtableDeleteRecordStepOutput, type AirtableGetRecordStepInput, type AirtableGetRecordStepOutput, type AirtableGetTableRecordsStepInput, type AirtableGetTableRecordsStepOutput, type AnalyzeImageStepInput, type AnalyzeImageStepOutput, type AnalyzeVideoStepInput, type AnalyzeVideoStepOutput, type AppAuthContext, type AppContextResult, type AppDatabase, type AppDatabaseColumnSchema, type AppDatabaseTable, type AppRoleAssignment, AuthContext, type AuthTableConfig, type BatchStepInput, type BatchStepResult, type CaptureThumbnailStepInput, type CaptureThumbnailStepOutput, type CheckAppRoleStepInput, type CheckAppRoleStepOutput, type CodaCreateUpdatePageStepInput, type CodaCreateUpdatePageStepOutput, type CodaCreateUpdateRowStepInput, type CodaCreateUpdateRowStepOutput, type CodaFindRowStepInput, type CodaFindRowStepOutput, type CodaGetPageStepInput, type CodaGetPageStepOutput, type CodaGetTableRowsStepInput, type CodaGetTableRowsStepOutput, type Connection, type ConnectorActionDetail, type ConnectorService, type ConvertPdfToImagesStepInput, type ConvertPdfToImagesStepOutput, type CreateDataSourceStepInput, type CreateDataSourceStepOutput, type CreateGmailDraftStepInput, type CreateGmailDraftStepOutput, type CreateGoogleCalendarEventStepInput, type CreateGoogleCalendarEventStepOutput, type CreateGoogleDocStepInput, type CreateGoogleDocStepOutput, type CreateGoogleSheetStepInput, type CreateGoogleSheetStepOutput, type Db, type DefineStoreOptions, type DefineTableOptions, type DeleteDataSourceDocumentStepInput, type DeleteDataSourceDocumentStepOutput, type DeleteDataSourceStepInput, type DeleteDataSourceStepOutput, type DeleteGmailEmailStepInput, type DeleteGmailEmailStepOutput, type DeleteGoogleCalendarEventStepInput, type DeleteGoogleCalendarEventStepOutput, type DeleteGoogleSheetRowsStepInput, type DeleteGoogleSheetRowsStepOutput, type DetectChangesStepInput, type DetectChangesStepOutput, type DetectPIIStepInput, type DetectPIIStepOutput, type DiscordEditMessageStepInput, type DiscordEditMessageStepOutput, type DiscordSendFollowUpStepInput, type DiscordSendFollowUpStepOutput, type DiscordSendMessageStepInput, type DiscordSendMessageStepOutput, type DownloadVideoStepInput, type DownloadVideoStepOutput, type EnhanceImageGenerationPromptStepInput, type EnhanceImageGenerationPromptStepOutput, type EnhanceVideoGenerationPromptStepInput, type EnhanceVideoGenerationPromptStepOutput, type EnrichPersonStepInput, type EnrichPersonStepOutput, type ExecuteStepBatchOptions, type ExecuteStepBatchResult, type ExtractAudioFromVideoStepInput, type ExtractAudioFromVideoStepOutput, type ExtractTextStepInput, type ExtractTextStepOutput, type FetchDataSourceDocumentStepInput, type FetchDataSourceDocumentStepOutput, type FetchGoogleDocStepInput, type FetchGoogleDocStepOutput, type FetchGoogleSheetStepInput, type FetchGoogleSheetStepOutput, type FetchSlackChannelHistoryStepInput, type FetchSlackChannelHistoryStepOutput, type FetchYoutubeCaptionsStepInput, type FetchYoutubeCaptionsStepOutput, type FetchYoutubeChannelStepInput, type FetchYoutubeChannelStepOutput, type FetchYoutubeCommentsStepInput, type FetchYoutubeCommentsStepOutput, type FetchYoutubeVideoStepInput, type FetchYoutubeVideoStepOutput, type FileAccess, type Files, type Generate3dModelStepInput, type Generate3dModelStepOutput, type GenerateAssetStepInput, type GenerateAssetStepOutput, type GenerateChartStepInput, type GenerateChartStepOutput, type GenerateImageStepInput, type GenerateImageStepOutput, type GenerateLipsyncStepInput, type GenerateLipsyncStepOutput, type GenerateMusicStepInput, type GenerateMusicStepOutput, type GeneratePdfStepInput, type GeneratePdfStepOutput, type GenerateStaticVideoFromImageStepInput, type GenerateStaticVideoFromImageStepOutput, type GenerateTextStepInput, type GenerateTextStepOutput, type GenerateVideoStepInput, type GenerateVideoStepOutput, type GetGmailAttachmentsStepInput, type GetGmailAttachmentsStepOutput, type GetGmailDraftStepInput, type GetGmailDraftStepOutput, type GetGmailEmailStepInput, type GetGmailEmailStepOutput, type GetGmailUnreadCountStepInput, type GetGmailUnreadCountStepOutput, type GetGoogleCalendarEventStepInput, type GetGoogleCalendarEventStepOutput, type GetGoogleDriveFileStepInput, type GetGoogleDriveFileStepOutput, type GetGoogleSheetInfoStepInput, type GetGoogleSheetInfoStepOutput, type GetMediaMetadataStepInput, type GetMediaMetadataStepOutput, type HubspotCreateCompanyStepInput, type HubspotCreateCompanyStepOutput, type HubspotCreateContactStepInput, type HubspotCreateContactStepOutput, type HubspotGetCompanyStepInput, type HubspotGetCompanyStepOutput, type HubspotGetContactStepInput, type HubspotGetContactStepOutput, type HunterApiCompanyEnrichmentStepInput, type HunterApiCompanyEnrichmentStepOutput, type HunterApiDomainSearchStepInput, type HunterApiDomainSearchStepOutput, type HunterApiEmailFinderStepInput, type HunterApiEmailFinderStepOutput, type HunterApiEmailVerificationStepInput, type HunterApiEmailVerificationStepOutput, type HunterApiPersonEnrichmentStepInput, type HunterApiPersonEnrichmentStepOutput, type ImageFaceSwapStepInput, type ImageFaceSwapStepOutput, type ImageRemoveWatermarkStepInput, type ImageRemoveWatermarkStepOutput, type InsertVideoClipsStepInput, type InsertVideoClipsStepOutput, type ListAgentsResult, type ListDataSourcesStepInput, type ListDataSourcesStepOutput, type ListGmailDraftsStepInput, type ListGmailDraftsStepOutput, type ListGmailLabelsStepInput, type ListGmailLabelsStepOutput, type ListGoogleCalendarEventsStepInput, type ListGoogleCalendarEventsStepOutput, type ListGoogleDriveFilesStepInput, type ListGoogleDriveFilesStepOutput, type ListOptions, type ListRecentGmailEmailsStepInput, type ListRecentGmailEmailsStepOutput, type LogicStepInput, type LogicStepOutput, type MakeDotComRunScenarioStepInput, type MakeDotComRunScenarioStepOutput, type MergeAudioStepInput, type MergeAudioStepOutput, type MergeVideosStepInput, type MergeVideosStepOutput, type MeshyAnimateStepInput, type MeshyAnimateStepOutput, type MeshyImageTo3dStepInput, type MeshyImageTo3dStepOutput, type MeshyRemeshStepInput, type MeshyRemeshStepOutput, type MeshyRigStepInput, type MeshyRigStepOutput, type MeshyTextTo3dStepInput, type MeshyTextTo3dStepOutput, type MeshyTextureStepInput, type MeshyTextureStepOutput, MindStudioAgent, MindStudioError, type MindStudioModel, type MindStudioModelSummary, type MixAudioIntoVideoStepInput, type MixAudioIntoVideoStepOutput, type ModelType, type MonacoSnippet, type MonacoSnippetField, type MonacoSnippetFieldType, type MuteVideoStepInput, type MuteVideoStepOutput, type N8nRunNodeStepInput, type N8nRunNodeStepOutput, type NotionCreatePageStepInput, type NotionCreatePageStepOutput, type NotionUpdatePageStepInput, type NotionUpdatePageStepOutput, type PackagedWorkflow, type PackagedWorkflowInput, type PackagedWorkflowSignature, type ParticlePodcastsFindMentionsStepInput, type ParticlePodcastsFindMentionsStepOutput, type ParticlePodcastsGetEpisodeStepInput, type ParticlePodcastsGetEpisodeStepOutput, type ParticlePodcastsGetEpisodeTranscriptStepInput, type ParticlePodcastsGetEpisodeTranscriptStepOutput, type ParticlePodcastsSearchCompaniesStepInput, type ParticlePodcastsSearchCompaniesStepOutput, type ParticlePodcastsSearchDialogueStepInput, type ParticlePodcastsSearchDialogueStepOutput, type ParticlePodcastsSearchPodcastsStepInput, type ParticlePodcastsSearchPodcastsStepOutput, type PeopleSearchStepInput, type PeopleSearchStepOutput, type PostToLinkedInStepInput, type PostToLinkedInStepOutput, type PostToSlackChannelStepInput, type PostToSlackChannelStepOutput, type PostToXStepInput, type PostToXStepOutput, type PostToZapierStepInput, type PostToZapierStepOutput, type Predicate, type PushInput, type PutOptions, Query, type QueryAppDatabaseStepInput, type QueryAppDatabaseStepOutput, type QueryDataSourceStepInput, type QueryDataSourceStepOutput, type QueryExternalDatabaseStepInput, type QueryExternalDatabaseStepOutput, type RedactPIIStepInput, type RedactPIIStepOutput, type RemoveBackgroundFromImageStepInput, type RemoveBackgroundFromImageStepOutput, type ReplyToGmailEmailStepInput, type ReplyToGmailEmailStepOutput, type ReportIssueInput, type ReportedIssue, type RequestContext, type ResizeVideoStepInput, type ResizeVideoStepOutput, type ResolvedUser, Roles, type RunAgentOptions, type RunAgentResult, type RunFromConnectorRegistryStepInput, type RunFromConnectorRegistryStepOutput, type RunPackagedWorkflowStepInput, type RunPackagedWorkflowStepOutput, type RunTaskOptions, type RunTaskResult, type ScrapeLinkedInCompanyStepInput, type ScrapeLinkedInCompanyStepOutput, type ScrapeLinkedInProfileStepInput, type ScrapeLinkedInProfileStepOutput, type ScrapeUrlStepInput, type ScrapeUrlStepOutput, type ScrapeXPostStepInput, type ScrapeXPostStepOutput, type ScrapeXProfileStepInput, type ScrapeXProfileStepOutput, type ScreenshotUrlStepInput, type ScreenshotUrlStepOutput, type SearchGmailEmailsStepInput, type SearchGmailEmailsStepOutput, type SearchGoogleCalendarEventsStepInput, type SearchGoogleCalendarEventsStepOutput, type SearchGoogleDriveStepInput, type SearchGoogleDriveStepOutput, type SearchGoogleImagesStepInput, type SearchGoogleImagesStepOutput, type SearchGoogleNewsStepInput, type SearchGoogleNewsStepOutput, type SearchGoogleStepInput, type SearchGoogleStepOutput, type SearchGoogleTrendsStepInput, type SearchGoogleTrendsStepOutput, type SearchPerplexityStepInput, type SearchPerplexityStepOutput, type SearchXPostsStepInput, type SearchXPostsStepOutput, type SearchYoutubeStepInput, type SearchYoutubeStepOutput, type SearchYoutubeTrendsStepInput, type SearchYoutubeTrendsStepOutput, type SendEmailStepInput, type SendEmailStepOutput, type SendGmailDraftStepInput, type SendGmailDraftStepOutput, type SendGmailMessageStepInput, type SendGmailMessageStepOutput, type SendSMSStepInput, type SendSMSStepOutput, type SendSlackDirectMessageStepInput, type SendSlackDirectMessageStepOutput, type SetGmailReadStatusStepInput, type SetGmailReadStatusStepOutput, type SetRunTitleStepInput, type SetRunTitleStepOutput, type SetVariableStepInput, type SetVariableStepOutput, type StepCostEstimateEntry, type StepExecutionMeta, type StepExecutionOptions, type StepExecutionResult, type StepInputMap, type StepLogEvent, type StepMetadata, type StepMethods, type StepName, type StepOutputMap, Store, type StoredFile, type SystemFields, Table, type TaskEvent, type TaskToolCall, type TaskToolConfig, type TaskUsage, type TelegramEditMessageStepInput, type TelegramEditMessageStepOutput, type TelegramReplyToMessageStepInput, type TelegramReplyToMessageStepOutput, type TelegramSendAudioStepInput, type TelegramSendAudioStepOutput, type TelegramSendFileStepInput, type TelegramSendFileStepOutput, type TelegramSendImageStepInput, type TelegramSendImageStepOutput, type TelegramSendMessageStepInput, type TelegramSendMessageStepOutput, type TelegramSendVideoStepInput, type TelegramSendVideoStepOutput, type TelegramSetTypingStepInput, type TelegramSetTypingStepOutput, type TextToSpeechStepInput, type TextToSpeechStepOutput, type TranscribeAudioStepInput, type TranscribeAudioStepOutput, type TrimMediaStepInput, type TrimMediaStepOutput, type UpdateGmailLabelsStepInput, type UpdateGmailLabelsStepOutput, type UpdateGoogleCalendarEventStepInput, type UpdateGoogleCalendarEventStepOutput, type UpdateGoogleDocStepInput, type UpdateGoogleDocStepOutput, type UpdateGoogleSheetStepInput, type UpdateGoogleSheetStepOutput, type UpdateInput, type UploadDataSourceDocumentStepInput, type UploadDataSourceDocumentStepOutput, type UploadFileResult, type UploadToken, type UpscaleImageStepInput, type UpscaleImageStepOutput, type UpscaleVideoStepInput, type UpscaleVideoStepOutput, type User, type UserInfoResult, type UserMessageStepInput, type UserMessageStepOutput, type VideoFaceSwapStepInput, type VideoFaceSwapStepOutput, type VideoRemoveBackgroundStepInput, type VideoRemoveBackgroundStepOutput, type VideoRemoveWatermarkStepInput, type VideoRemoveWatermarkStepOutput, type WatermarkImageStepInput, type WatermarkImageStepOutput, type WatermarkVideoStepInput, type WatermarkVideoStepOutput, type YouDotComFinanceResearchStepInput, type YouDotComFinanceResearchStepOutput, type YouDotComGetPageContentStepInput, type YouDotComGetPageContentStepOutput, type YouDotComLiveNewsStepInput, type YouDotComLiveNewsStepOutput, type YouDotComWebResearchStepInput, type YouDotComWebResearchStepOutput, type YouDotComWebSearchStepInput, type YouDotComWebSearchStepOutput, auth, blockTypeAliases, db, mindstudio as default, files, getRequestContext, mindstudio, monacoSnippets, prerender, reportIssue, resolveUser, runWithContext, stepMetadata, stream };

package/dist/index.js

@@ -1924,6 +1924,173 @@ function resolveTable(databases, tableName, databaseHint) {
   );
 }
 
+// src/files/store.ts
+import { createHash, randomUUID } from "crypto";
+function toBase64(content) {
+  return Buffer.from(
+    typeof content === "string" ? Buffer.from(content) : content
+  ).toString("base64");
+}
+function extensionFor(filename) {
+  if (!filename) {
+    return "";
+  }
+  const dot = filename.lastIndexOf(".");
+  return dot > 0 ? filename.slice(dot) : "";
+}
+var Store = class {
+  constructor(_store, _access, _call, _policy = {}) {
+    this._store = _store;
+    this._access = _access;
+    this._call = _call;
+    this._policy = _policy;
+  }
+  /** The store's access level. */
+  get access() {
+    return this._access;
+  }
+  /** Store bytes. Returns a {@link StoredFile} with a ready-to-use `url`. */
+  async put(content, options) {
+    const ext = extensionFor(options?.filename);
+    const key = options?.key ?? (options?.contentAddressed ? `${createHash("sha256").update(content).digest("hex")}${ext}` : `${randomUUID()}${ext}`);
+    const meta = await this._call("put", {
+      store: this._store,
+      access: this._access,
+      key,
+      body: toBase64(content),
+      ...options?.contentType ? { contentType: options.contentType } : {}
+    });
+    return this._toFile(key, meta);
+  }
+  /** Read an object's bytes (backend / trusted context). */
+  async get(key) {
+    const res = await this._call("get", {
+      store: this._store,
+      access: this._access,
+      key
+    });
+    return Buffer.from(res.body, "base64");
+  }
+  /** Metadata without downloading. Rejects if the object doesn't exist. */
+  async head(key) {
+    const meta = await this._call("head", {
+      store: this._store,
+      access: this._access,
+      key
+    });
+    return this._toFile(key, meta);
+  }
+  /** Whether an object exists. */
+  async exists(key) {
+    try {
+      await this.head(key);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  /** List objects in the store (optionally under `prefix`), one page at a time. */
+  async list(options) {
+    const res = await this._call("list", {
+      store: this._store,
+      access: this._access,
+      ...options?.prefix ? { prefix: options.prefix } : {},
+      ...options?.cursor ? { cursor: options.cursor } : {},
+      ...options?.limit ? { limit: options.limit } : {}
+    });
+    return {
+      files: (res.files ?? []).map((f) => this._toFile(f.key, f)),
+      ...res.cursor ? { cursor: res.cursor } : {}
+    };
+  }
+  /** Delete an object. No-op if it doesn't exist. */
+  async delete(key) {
+    await this._call("delete", {
+      store: this._store,
+      access: this._access,
+      key
+    });
+  }
+  /**
+   * Mint an {@link UploadToken} for a **client-direct** upload — the browser
+   * POSTs the file straight to storage, so the bytes never pass through the
+   * platform. Return the token from a backend method and hand it to the
+   * frontend's `platform.upload(token, file)`. Works for private + public stores.
+   *
+   * Enforced at upload time by the presigned POST: a max size (this call's
+   * `maxSize`, else the store's, else the platform default) and — when
+   * `contentType` is set — an exact content-type match. When the store declares
+   * `contentTypes`, `contentType` must be one of them.
+   *
+   * @example
+   * ```ts
+   * // backend method
+   * export async function getUploadSlot(input: { contentType: string }) {
+   *   return Uploads.createUploadToken({ contentType: input.contentType, maxSize: 50 * 1024 * 1024 });
+   * }
+   * ```
+   */
+  async createUploadToken(options) {
+    if (options?.contentType && this._policy.contentTypes && !this._policy.contentTypes.includes(options.contentType)) {
+      throw new MindStudioError(
+        `contentType "${options.contentType}" is not allowed by store "${this._store}".`,
+        "content_type_not_allowed",
+        400
+      );
+    }
+    const key = options?.key ?? `${randomUUID()}${extensionFor(options?.filename)}`;
+    const maxSize = options?.maxSize ?? this._policy.maxSize;
+    const res = await this._call("create-upload", {
+      store: this._store,
+      access: this._access,
+      key,
+      ...options?.contentType ? { contentType: options.contentType } : {},
+      ...maxSize ? { maxSize } : {},
+      ...options?.expiresIn ? { expiresIn: options.expiresIn } : {}
+    });
+    return {
+      key,
+      url: `/_/files/${this._access}/${this._store}/${key}`,
+      upload: { url: res.uploadUrl, fields: res.uploadFields }
+    };
+  }
+  _toFile(key, meta) {
+    const store = this._store;
+    const access = this._access;
+    const call = this._call;
+    return {
+      store,
+      key,
+      access,
+      url: `/_/files/${access}/${store}/${key}`,
+      ...typeof meta?.size === "number" ? { size: meta.size } : {},
+      ...meta?.contentType ? { contentType: meta.contentType } : {},
+      ...meta?.updatedAt ? { updatedAt: meta.updatedAt } : {},
+      async shareUrl(options) {
+        const res = await call("sign", {
+          store,
+          access,
+          key,
+          ...options?.expiresIn ? { expiresIn: options.expiresIn } : {}
+        });
+        return res.url;
+      }
+    };
+  }
+};
+
+// src/files/index.ts
+function createFiles(call) {
+  return {
+    defineStore(name, options) {
+      return new Store(name, options?.access ?? "private", call, {
+        ...options?.maxSize !== void 0 ? { maxSize: options.maxSize } : {},
+        ...options?.contentTypes ? { contentTypes: options.contentTypes } : {}
+      });
+    }
+  };
+}
+
 // src/generated/metadata.ts
 var stepMetadata = {
   "activeCampaignAddNote": {
@@ -2891,6 +3058,9 @@ var stepMetadata = {
     usageNotes: `- Use the "to" field to send to one or more specific recipient email addresses directly. Allowed recipients depend on the sender: when the app sends from a domain it owns (a verified custom domain or its <slug>.madewithremy.com subdomain) any recipient is allowed; when it falls back to the shared Remy address, recipients must be verified app users or members of the app's organization. (v1 apps cannot use a direct "to" \u2014 they must resolve recipients via a connection.)
 - Alternatively, recipient email addresses can be resolved from OAuth connections configured by the app creator via connectionId. The user running the workflow does not specify the recipient directly.
 - Use "cc" and "bcc" to add visible / hidden recipients (a string or an array). They are subject to the same recipient rules as "to".
+- "to" is optional only in the sense that recipients can come from elsewhere \u2014 omit it and supply "cc"/"bcc" for a hidden-list send, or omit all three and recipients are resolved from an OAuth connection. Naming nobody at all is an error.
+- Bcc-only sends are supported: with no "to" or "cc", the To: header is addressed to the app's own sender address (the standard "undisclosed recipients" pattern) so recipients can't see each other. The returned "recipients" reflects that auto-filled address.
+- Every recipient counts toward the app's daily outbound cap, including cc and bcc.
 - The sender defaults automatically: v2 apps send from the app's own identity \u2014 its verified custom domain if set, else its platform subdomain (noreply@<slug>.madewithremy.com), else the default Remy address.
 - Optionally set "from" to a custom handle, but ONLY if the app has a custom domain or subdomain: a bare handle ("support" \u2192 support@<app-domain>), a full "support@your-domain.com", or "Name <support@your-domain.com>". The domain must be one the app owns, or the step fails.
 - If the body is a URL to a hosted HTML file on the CDN, the HTML is fetched and used as the email body.
@@ -3933,6 +4103,8 @@ var MindStudioAgent = class {
   _auth;
   /** @internal Cached Db namespace instance, created during context hydration. */
   _db;
+  /** @internal Cached Files namespace instance (lazy; no context hydration needed). */
+  _files;
   /** @internal Auth type — 'internal' for CALLBACK_TOKEN (managed mode), 'apiKey' otherwise. */
   _authType;
   /** @internal Usage source sent on step executions (from MINDSTUDIO_REQUEST_SOURCE).
@@ -4809,6 +4981,54 @@ var MindStudioAgent = class {
       });
     }
   }
+  /**
+   * The `files` namespace — typed, private-by-default file storage (the twin of
+   * `db`). No context hydration needed: the hook token identifies the app
+   * server-side and stores are code-defined (access travels per call).
+   *
+   * @example
+   * ```ts
+   * const Uploads = agent.files.defineStore('uploads');
+   * const f = await Uploads.put(buffer, { contentType: 'image/png' });
+   * return { url: f.url };
+   * ```
+   */
+  get files() {
+    return this._files ??= createFiles(this._filesRequest.bind(this));
+  }
+  /**
+   * @internal Transport for the `files` namespace — POST /_internal/v2/files/<op>
+   * with the raw hook token (mirrors `_executeDbBatch`).
+   */
+  async _filesRequest(op, body) {
+    const url = `${this._currentHttpConfig.baseUrl}/_internal/v2/files/${op}`;
+    const res = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: this._token
+      },
+      body: JSON.stringify(body)
+    });
+    if (res.status === 204) {
+      return void 0;
+    }
+    const text = await res.text();
+    let json;
+    if (text) {
+      try {
+        json = JSON.parse(text);
+      } catch {
+      }
+    }
+    if (!res.ok) {
+      const rawMsg = json?.errorMessage ?? (typeof json?.error === "string" ? json.error : json?.error?.message);
+      const message = typeof rawMsg === "string" ? rawMsg : `File operation failed: ${res.status} ${res.statusText}`;
+      const code = json?.errorString ?? json?.code ?? "file_error";
+      throw new MindStudioError(message, code, res.status);
+    }
+    return json;
+  }
   /**
    * @internal Execute a batch of SQL queries against a managed database.
    * Used as the `executeBatch` callback for Table/Query instances.
@@ -5475,6 +5695,16 @@ var db = new Proxy(
     }
   }
 );
+var files = new Proxy(
+  {},
+  {
+    get(_, prop) {
+      const target = mindstudio.files;
+      const value = Reflect.get(target, prop, target);
+      return typeof value === "function" ? value.bind(target) : value;
+    }
+  }
+);
 var stream = (data) => mindstudio.stream(data);
 var resolveUser = (userId) => mindstudio.resolveUser(userId);
 var reportIssue = (input) => mindstudio.reportIssue(input);
@@ -5490,6 +5720,7 @@ export {
   blockTypeAliases,
   db,
   index_default as default,
+  files,
   getRequestContext,
   mindstudio,
   monacoSnippets,