@stndrds/schema 1.0.0-alpha.276 → 1.0.0-alpha.277

package/dist/{index-Bq1KrQkR.d.ts → index-AJeEKoy6.d.ts}

@@ -1,8 +1,8 @@
 import { z } from 'zod';
 import { A as Attribute, f as AttributeType, e as RollupAttribute } from './attributes-_b3Db8vT.js';
-import { IconName, MimeType } from '@stndrds/constants';
-import { Uuid } from './utils.js';
+import { IconName } from '@stndrds/constants';
 import { L as ListViewTabVisibility, T as Timestamps, R as ResourceVisibility } from './objects-A1ED9af-.js';
+import { Uuid } from './utils.js';
 
 /** Operators for text-based attributes */
 type TextFilterOperator = "is" | "is_not" | "contains" | "not_contains" | "starts_with" | "ends_with" | "is_empty" | "is_not_empty";
@@ -858,235 +858,6 @@ interface MentionedContext {
     summary: string;
 }
 
-type DocumentKind = "file" | "folder";
-interface Document extends Timestamps {
-    id: Uuid;
-    tenantId: Uuid;
-    title: string;
-    kind: DocumentKind;
-    parentId?: Uuid | null;
-    description?: string;
-    contentHash?: string;
-    createdBy?: Uuid;
-    updatedBy?: Uuid;
-    deletedAt?: Date | null;
-    /**
-     * Fractional ordering position within `(tenantId, parentId)`. Lower values
-     * sort first. New rows default to `max(siblings) + 1024` so reorderings can
-     * insert between neighbours without renumbering. The server may rebalance
-     * positions in the background to keep the spacing bounded.
-     */
-    position: number;
-}
-interface DocumentWithSubCount extends Document {
-    subCount: number | null;
-}
-/** OCR processing lifecycle for a single file within a document pack. */
-type FileOcrStatus = "pending" | "processing" | "completed" | "failed";
-/**
- * A single anonymous file belonging to a document pack.
- * Unlike the slot-based model, files carry no slot name — order within the
- * pack is `position` only, and `name` is provenance (originalName), never a
- * label rendered in the UI.
- */
-interface DocumentFile {
-    id: Uuid;
-    documentId: Uuid;
-    position: number;
-    /** Provenance only (originalName) — never rendered as a label. */
-    name: string;
-    mimeType: string;
-    size: number;
-    ocrStatus: FileOcrStatus | null;
-    ocrText: string | null;
-    ocrConfidence: number | null;
-    processedAt: Date | null;
-}
-type DocumentWithFiles = Document & {
-    files: DocumentFile[];
-};
-interface CreateDocument {
-    title: string;
-    kind?: DocumentKind;
-    parentId?: Uuid | null;
-    description?: string;
-    position?: number;
-}
-/**
- * Reference to a record attribute that should atomically attach a freshly
- * created Document. Passed alongside `CreateDocument` to make creation
- * link-aware end-to-end (client → REST → service → repo).
- *
- * The server requires this — orphan Documents are not creatable through the
- * REST API.
- */
-interface CreateDocumentLink {
-    objectName: string;
-    sourceRecordId: string;
-    attributeName: string;
-}
-interface UpdateDocument {
-    title?: string;
-    parentId?: Uuid | null;
-    position?: number;
-}
-interface DocumentListOptions {
-    limit?: number;
-    offset?: number;
-}
-interface RecordDocuments {
-    /** Documents grouped by attribute name (includes system 'attachments' attribute) */
-    byAttribute: Record<string, DocumentWithFiles[]>;
-}
-
-/**
- * Storage provider type
- */
-type StorageProvider = "s3" | "gcs" | "azure" | "local" | "cloudflare-r2" | string;
-/**
- * File - Represents uploaded file metadata and storage info
- *
- * ARCHITECTURE:
- * - Fixed table (no custom attributes)
- * - Manages file storage metadata
- * - uploadedBy links to user_profiles table
- * - Supports soft delete via deletedAt
- *
- * @example
- * ```typescript
- * const file: File = {
- *   id: "file-123",
- *   tenantId: "tenant-456",
- *   name: "contract-2025.pdf",
- *   originalName: "Contract Acme Corp 2025.pdf",
- *   mimeType: "application/pdf",
- *   size: 2458624,
- *   storageProvider: "s3",
- *   storagePath: "tenants/456/files/2025/11/contract-2025.pdf",
- *   storageBucket: "my-app-files",
- *   url: "https://cdn.example.com/files/file-123",
- *   uploadedBy: "profile-789",
- *   folderPath: "/contracts/2025",
- *   createdAt: new Date(),
- *   updatedAt: new Date(),
- * };
- * ```
- */
-interface File extends Timestamps {
-    id: Uuid;
-    tenantId: Uuid;
-    /**
-     * File name (sanitized for storage)
-     */
-    name: string;
-    /**
-     * Original file name (as uploaded by user)
-     */
-    originalName: string;
-    /**
-     * MIME type (e.g., "application/pdf", "image/jpeg")
-     */
-    mimeType: MimeType | string;
-    /**
-     * File size in bytes
-     */
-    size: number;
-    /**
-     * Storage provider (s3, gcs, azure, local, etc.)
-     */
-    storageProvider: StorageProvider;
-    /**
-     * Path in the storage bucket
-     */
-    storagePath: string;
-    /**
-     * Storage bucket name (if applicable)
-     */
-    storageBucket?: string;
-    /**
-     * Public or signed URL to access the file
-     */
-    url: string;
-    /**
-     * User who uploaded the file (FK to user_profiles)
-     * Optional for system-generated files or anonymous uploads.
-     */
-    uploadedBy?: Uuid;
-    /**
-     * Folder path for organization (e.g., "/contracts/2025")
-     */
-    folderPath?: string;
-    /**
-     * Soft delete timestamp (null = not deleted)
-     */
-    deletedAt?: Date;
-    /**
-     * Document this file belongs to, when the file is a member of a document
-     * pack. NULL for files that aren't part of a document (e.g. freshly
-     * uploaded blobs not yet attached to a pack).
-     */
-    documentId?: Uuid | null;
-    /**
-     * Append-only position within the owning document pack (plain integer,
-     * `max(position) + 1`). Packs are NOT reorderable (spec §2).
-     */
-    position?: number | null;
-    /**
-     * OCR processing status for this file, when applicable.
-     */
-    ocrStatus?: FileOcrStatus | null;
-    /**
-     * Extracted OCR text, when processing has completed.
-     */
-    ocrText?: string | null;
-    /**
-     * OCR confidence score, when processing has completed.
-     */
-    ocrConfidence?: number | null;
-    /**
-     * Timestamp of the last OCR processing attempt.
-     */
-    processedAt?: Date | null;
-}
-/**
- * Data required to create a new file record
- */
-/**
- * Data for creating a new file.
- * Tenant ID is automatically set from execution context.
- */
-interface CreateFile {
-    name: string;
-    originalName: string;
-    mimeType: MimeType | string;
-    size: number;
-    storageProvider: StorageProvider;
-    storagePath: string;
-    storageBucket?: string;
-    url: string;
-    uploadedBy?: Uuid;
-    folderPath?: string;
-    documentId?: Uuid | null;
-    position?: number | null;
-    ocrStatus?: FileOcrStatus | null;
-    ocrText?: string | null;
-    ocrConfidence?: number | null;
-    processedAt?: Date | null;
-}
-/**
- * Data for updating an existing file record
- */
-interface UpdateFile {
-    name?: string;
-    folderPath?: string;
-    documentId?: Uuid | null;
-    position?: number | null;
-    ocrStatus?: FileOcrStatus | null;
-    ocrText?: string | null;
-    ocrConfidence?: number | null;
-    processedAt?: Date | null;
-}
-
 /**
  * Outcome of a compaction pass: a no-op (context already small enough), an LLM
  * `summary`, or a degraded `truncation` (the summarizer failed/timed out/returned
@@ -1160,6 +931,12 @@ interface AgentConfig {
     systemPrompt: string;
     model: ModelDefinition;
     tools?: string[];
+    /**
+     * MCP servers whose tools mount into this agent's toolchain. Ids opt in
+     * explicitly; `"all"` mounts every server the viewer can see. Absent means
+     * none — so agents that predate this field are tool-identical.
+     */
+    mcpServers?: string[] | "all";
     timeoutMs?: number;
     costLimitUsd?: number | null;
     canDelegate: boolean;
@@ -1263,6 +1040,13 @@ interface AgentBlueprint {
     canDelegate?: boolean;
     maxDepth?: number;
     maxTreeCostUsd?: number;
+    /**
+     * MCP servers this agent may use (see `AgentConfig.mcpServers`). Absent
+     * means none — an agent that never declares this stays tool-identical to
+     * one predating the field. Reconciled by the boot sync like the other
+     * optional config fields (`SYNCED_FIELDS`).
+     */
+    mcpServers?: string[] | "all";
     system: boolean;
     /** Code-declared agents are workspace-visible; private is runtime-only. */
     visibility: ResourceVisibility;
@@ -1385,6 +1169,14 @@ interface AgentDefinition {
     tools?: string[];
     schedule?: AgentSchedule;
     config: AgentExecutionConfig;
+    /**
+     * MCP servers this definition may use (see `AgentConfig.mcpServers`).
+     * Absent means none — a definition that predates this field is
+     * tool-identical to one that never sets it. The opt-in is narrowed further
+     * by the viewer's visibility at resolution time (`buildMcpToolset`); a
+     * server id here that the viewer cannot see yields no tools from it.
+     */
+    mcpServers?: string[] | "all";
     /** Code-declared (immutable via public API); reconciled by the boot sync. */
     system: boolean;
     visibility: ResourceVisibility;
@@ -1399,8 +1191,6 @@ interface AgentDefinition {
     critic?: CriticConfig;
     missionPolicy?: AgentMissionPolicy;
     autoDecide?: boolean;
-    fileIds?: string[];
-    attachments?: File[];
     requiredPermission?: AgentRequiredPermission;
 }
 interface AgentRun {
@@ -2410,4 +2200,4 @@ declare function parseAttributeConfigForCreate(type: AttributeType, input: unkno
  */
 declare function parseAttributeConfigForUpdate(stored: Attribute, patch: Partial<AddAttributeInput>): Record<string, unknown>;
 
-export { type AIQuestionOption as $, type Action as A, type AIBatchQuestion as B, type ConfigOverrides as C, type DetailViewConfig as D, type AIBatchQuestionAnswer as E, type FilterState as F, type Group as G, type AIBatchQuestionOption as H, type AIBatchQuestionType as I, type AIChatMessage as J, type AIChatMessagePart as K, type ListViewConfig as L, type ModelDefinition as M, type AIChatMessagePartType as N, type AIChatNotification as O, type PermissionScope as P, type AICompactionSummary as Q, type RelationGroup as R, type SortRule as S, type TriggerEventType as T, type AIMemoryEntry as U, type ViewType as V, type AIMemoryType as W, type AIMessageRole as X, type AIProviderMetrics as Y, type AIQuestion as Z, type AIQuestionAnswer as _, type ViewConfig as a, type EffectivePermissions as a$, type AIQuestionType as a0, type AISubagentStatus as a1, type AITodoItem as a2, type AITodoList as a3, type AITodoStatus as a4, type AIToolCall as a5, type AIToolCallStatus as a6, type AIUsageMetrics as a7, ALL_ACTIONS as a8, type AccessLevel as a9, type AgentTodoPlanStatus as aA, type AgentTodoPlanView as aB, type AgentToolCall as aC, type AgentTriggerDefinition as aD, type AgentTriggerType as aE, type ApprovalMode as aF, type AssignRoleInput as aG, type CompactionStrategy as aH, type CreateCustomObjectInput as aI, type CreateDocument as aJ, type CreateDocumentLink as aK, type CreateFile as aL, type CreatePermissionInput as aM, type CreateRoleInput as aN, type CreateViewInput as aO, type CriticConfig as aP, type CurrencyFilterValue as aQ, type CustomTab as aR, DEFAULT_APPROVAL_POLICY as aS, type Document as aT, type DocumentFile as aU, type DocumentKind as aV, type DocumentListOptions as aW, type DocumentWithFiles as aX, type DocumentWithSubCount as aY, type DocumentsTab as aZ, type EdgeQuantifier as a_, type ActivityTab as aa, type AddAttributeInput as ab, type AdvancedFilterState as ac, type AgentConfig as ad, type AgentDashboard as ae, type AgentDefinition as af, type AgentEvent as ag, type AgentMessageAttachment as ah, type AgentMessagePart as ai, type AgentMission as aj, type AgentMissionArtifact as ak, type AgentMissionPage as al, type AgentMissionPolicy as am, type AgentMissionRubric as an, type AgentMissionRubricCriterion as ao, type AgentMissionStatus as ap, type AgentMissionVerification as aq, type AgentMissionView as ar, type AgentRequiredPermission as as, type AgentRun as at, type AgentRunStatus as au, type AgentSession as av, type AgentSessionMessage as aw, type AgentSessionMode as ax, type AgentSessionStatus as ay, type AgentTodoPlan as az, type FilterOperator as b, type UpdateObjectInput as b$, type EmailsTab as b0, type ExtendedFilterRule as b1, type File as b2, type FileOcrStatus as b3, type FilterCombinator as b4, type FilterGroup as b5, type FormDensity as b6, type FormSubmittedAgentEvent as b7, type FormTab as b8, type FormsTab as b9, type Role as bA, SESSION_TERMINAL_STATUSES as bB, type SessionApprovalMode as bC, type SortDirection as bD, type StorageProvider as bE, type StreamEventCompactionEnd as bF, type StreamEventCompactionFailed as bG, type StreamEventCompactionStart as bH, type StreamEventMessagePersisted as bI, type StreamEventMessageUpdated as bJ, type StreamEventMissionUpdate as bK, type StreamEventTodoPlanUpdate as bL, type StreamEventUsage as bM, type SystemPermissions as bN, TODO_PLAN_STATUSES as bO, TODO_STATUSES as bP, type TabType as bQ, type TableSource as bR, type TerminalSessionStatus as bS, type TextPartData as bT, type ThinkingPartData as bU, type ToolImpact as bV, type ToolPartData as bW, type ToolPartErrorCode as bX, type ToolPartState as bY, type UpdateDocument as bZ, type UpdateFile as b_, type HumanRequestNeed as ba, type InverseSource as bb, type ListViewLayout as bc, MAX_TODOS as bd, MAX_TODO_DESCRIPTION_CHARS as be, MAX_TODO_ID_CHARS as bf, MAX_TODO_RESULT_CHARS as bg, type MentionEntityType as bh, type MentionReference as bi, type MentionedContext as bj, type MentionedEntityContext as bk, NO_VALUE_OPERATORS as bl, type NoValueOperator as bm, OPERATORS_BY_TYPE as bn, type ObjectPermissions as bo, type Permission as bp, type PhoneFilterValue as bq, type QueryState as br, type ReasoningPartData as bs, type RecordAgentEvent as bt, type RecordDocuments as bu, type RelationOption as bv, type RelationOptionsResponse as bw, type RelationSource as bx, type RetryPolicy as by, type RichtextTab as bz, type SystemResource as c, type UpdateRoleInput as c0, type UpdateViewInput as c1, type UserRoleAssignment as c2, type ViewOverlay as c3, accessLevelToActions as c4, actionsToAccessLevel as c5, agentDisplayName as c6, getRollupFilterOperators as c7, isDetailView as c8, isFieldGroup as c9, isListView as ca, isNoValueOperator as cb, isRelationGroup as cc, isTerminalSessionStatus as cd, multiselectOptionWriteSchema as ce, parseAttributeConfig as cf, parseAttributeConfigForCreate as cg, parseAttributeConfigForUpdate as ch, selectOptionWriteSchema as ci, statusGroupSchema as cj, statusOptionWriteSchema as ck, attributeConfigSchemas as cl, getAttributeConfigSchema as cm, type ProviderName as d, type AgentSchedule as e, type AgentExecutionConfig as f, type AgentApprovalPolicy as g, type AgentTriggerBlueprint as h, type AgentBlueprint as i, type DetailViewDefinition as j, type SidePanelConfig as k, type Field as l, type AttributeGroupField as m, type FieldGroup as n, type TableTab as o, type CreateMode as p, type Tab as q, type ListViewDefinition as r, type ViewDefinition as s, type ListViewTab as t, type FilterValue as u, type FilterRule as v, type DynamicValue as w, type RelativeDateValue as x, type AIAvailableModel as y, type AIBatchAnswerValue as z };
+export { type AIQuestionOption as $, type Action as A, type AIBatchQuestion as B, type ConfigOverrides as C, type DetailViewConfig as D, type AIBatchQuestionAnswer as E, type FilterState as F, type Group as G, type AIBatchQuestionOption as H, type AIBatchQuestionType as I, type AIChatMessage as J, type AIChatMessagePart as K, type ListViewConfig as L, type ModelDefinition as M, type AIChatMessagePartType as N, type AIChatNotification as O, type PermissionScope as P, type AICompactionSummary as Q, type RelationGroup as R, type SortRule as S, type TriggerEventType as T, type AIMemoryEntry as U, type ViewType as V, type AIMemoryType as W, type AIMessageRole as X, type AIProviderMetrics as Y, type AIQuestion as Z, type AIQuestionAnswer as _, type ViewConfig as a, type HumanRequestNeed as a$, type AIQuestionType as a0, type AISubagentStatus as a1, type AITodoItem as a2, type AITodoList as a3, type AITodoStatus as a4, type AIToolCall as a5, type AIToolCallStatus as a6, type AIUsageMetrics as a7, ALL_ACTIONS as a8, type AccessLevel as a9, type AgentTodoPlanStatus as aA, type AgentTodoPlanView as aB, type AgentToolCall as aC, type AgentTriggerDefinition as aD, type AgentTriggerType as aE, type ApprovalMode as aF, type AssignRoleInput as aG, type CompactionStrategy as aH, type CreateCustomObjectInput as aI, type CreatePermissionInput as aJ, type CreateRoleInput as aK, type CreateViewInput as aL, type CriticConfig as aM, type CurrencyFilterValue as aN, type CustomTab as aO, DEFAULT_APPROVAL_POLICY as aP, type DocumentsTab as aQ, type EdgeQuantifier as aR, type EffectivePermissions as aS, type EmailsTab as aT, type ExtendedFilterRule as aU, type FilterCombinator as aV, type FilterGroup as aW, type FormDensity as aX, type FormSubmittedAgentEvent as aY, type FormTab as aZ, type FormsTab as a_, type ActivityTab as aa, type AddAttributeInput as ab, type AdvancedFilterState as ac, type AgentConfig as ad, type AgentDashboard as ae, type AgentDefinition as af, type AgentEvent as ag, type AgentMessageAttachment as ah, type AgentMessagePart as ai, type AgentMission as aj, type AgentMissionArtifact as ak, type AgentMissionPage as al, type AgentMissionPolicy as am, type AgentMissionRubric as an, type AgentMissionRubricCriterion as ao, type AgentMissionStatus as ap, type AgentMissionVerification as aq, type AgentMissionView as ar, type AgentRequiredPermission as as, type AgentRun as at, type AgentRunStatus as au, type AgentSession as av, type AgentSessionMessage as aw, type AgentSessionMode as ax, type AgentSessionStatus as ay, type AgentTodoPlan as az, type FilterOperator as b, multiselectOptionWriteSchema as b$, type InverseSource as b0, type ListViewLayout as b1, MAX_TODOS as b2, MAX_TODO_DESCRIPTION_CHARS as b3, MAX_TODO_ID_CHARS as b4, MAX_TODO_RESULT_CHARS as b5, type MentionEntityType as b6, type MentionReference as b7, type MentionedContext as b8, type MentionedEntityContext as b9, type SystemPermissions as bA, TODO_PLAN_STATUSES as bB, TODO_STATUSES as bC, type TabType as bD, type TableSource as bE, type TerminalSessionStatus as bF, type TextPartData as bG, type ThinkingPartData as bH, type ToolImpact as bI, type ToolPartData as bJ, type ToolPartErrorCode as bK, type ToolPartState as bL, type UpdateObjectInput as bM, type UpdateRoleInput as bN, type UpdateViewInput as bO, type UserRoleAssignment as bP, type ViewOverlay as bQ, accessLevelToActions as bR, actionsToAccessLevel as bS, agentDisplayName as bT, getRollupFilterOperators as bU, isDetailView as bV, isFieldGroup as bW, isListView as bX, isNoValueOperator as bY, isRelationGroup as bZ, isTerminalSessionStatus as b_, NO_VALUE_OPERATORS as ba, type NoValueOperator as bb, OPERATORS_BY_TYPE as bc, type ObjectPermissions as bd, type Permission as be, type PhoneFilterValue as bf, type QueryState as bg, type ReasoningPartData as bh, type RecordAgentEvent as bi, type RelationOption as bj, type RelationOptionsResponse as bk, type RelationSource as bl, type RetryPolicy as bm, type RichtextTab as bn, type Role as bo, SESSION_TERMINAL_STATUSES as bp, type SessionApprovalMode as bq, type SortDirection as br, type StreamEventCompactionEnd as bs, type StreamEventCompactionFailed as bt, type StreamEventCompactionStart as bu, type StreamEventMessagePersisted as bv, type StreamEventMessageUpdated as bw, type StreamEventMissionUpdate as bx, type StreamEventTodoPlanUpdate as by, type StreamEventUsage as bz, type SystemResource as c, parseAttributeConfig as c0, parseAttributeConfigForCreate as c1, parseAttributeConfigForUpdate as c2, selectOptionWriteSchema as c3, statusGroupSchema as c4, statusOptionWriteSchema as c5, attributeConfigSchemas as c6, getAttributeConfigSchema as c7, type ProviderName as d, type AgentSchedule as e, type AgentExecutionConfig as f, type AgentApprovalPolicy as g, type AgentTriggerBlueprint as h, type AgentBlueprint as i, type DetailViewDefinition as j, type SidePanelConfig as k, type Field as l, type AttributeGroupField as m, type FieldGroup as n, type TableTab as o, type CreateMode as p, type Tab as q, type ListViewDefinition as r, type ViewDefinition as s, type ListViewTab as t, type FilterValue as u, type FilterRule as v, type DynamicValue as w, type RelativeDateValue as x, type AIAvailableModel as y, type AIBatchAnswerValue as z };

package/dist/{index-DtxtOBYT.d.mts → index-ApHE8c1J.d.mts}

@@ -1,8 +1,8 @@
 import { z } from 'zod';
 import { A as Attribute, f as AttributeType, e as RollupAttribute } from './attributes-lBLiOIY3.mjs';
-import { IconName, MimeType } from '@stndrds/constants';
-import { Uuid } from './utils.mjs';
+import { IconName } from '@stndrds/constants';
 import { L as ListViewTabVisibility, T as Timestamps, R as ResourceVisibility } from './objects-BCaBw2ef.mjs';
+import { Uuid } from './utils.mjs';
 
 /** Operators for text-based attributes */
 type TextFilterOperator = "is" | "is_not" | "contains" | "not_contains" | "starts_with" | "ends_with" | "is_empty" | "is_not_empty";
@@ -858,235 +858,6 @@ interface MentionedContext {
     summary: string;
 }
 
-type DocumentKind = "file" | "folder";
-interface Document extends Timestamps {
-    id: Uuid;
-    tenantId: Uuid;
-    title: string;
-    kind: DocumentKind;
-    parentId?: Uuid | null;
-    description?: string;
-    contentHash?: string;
-    createdBy?: Uuid;
-    updatedBy?: Uuid;
-    deletedAt?: Date | null;
-    /**
-     * Fractional ordering position within `(tenantId, parentId)`. Lower values
-     * sort first. New rows default to `max(siblings) + 1024` so reorderings can
-     * insert between neighbours without renumbering. The server may rebalance
-     * positions in the background to keep the spacing bounded.
-     */
-    position: number;
-}
-interface DocumentWithSubCount extends Document {
-    subCount: number | null;
-}
-/** OCR processing lifecycle for a single file within a document pack. */
-type FileOcrStatus = "pending" | "processing" | "completed" | "failed";
-/**
- * A single anonymous file belonging to a document pack.
- * Unlike the slot-based model, files carry no slot name — order within the
- * pack is `position` only, and `name` is provenance (originalName), never a
- * label rendered in the UI.
- */
-interface DocumentFile {
-    id: Uuid;
-    documentId: Uuid;
-    position: number;
-    /** Provenance only (originalName) — never rendered as a label. */
-    name: string;
-    mimeType: string;
-    size: number;
-    ocrStatus: FileOcrStatus | null;
-    ocrText: string | null;
-    ocrConfidence: number | null;
-    processedAt: Date | null;
-}
-type DocumentWithFiles = Document & {
-    files: DocumentFile[];
-};
-interface CreateDocument {
-    title: string;
-    kind?: DocumentKind;
-    parentId?: Uuid | null;
-    description?: string;
-    position?: number;
-}
-/**
- * Reference to a record attribute that should atomically attach a freshly
- * created Document. Passed alongside `CreateDocument` to make creation
- * link-aware end-to-end (client → REST → service → repo).
- *
- * The server requires this — orphan Documents are not creatable through the
- * REST API.
- */
-interface CreateDocumentLink {
-    objectName: string;
-    sourceRecordId: string;
-    attributeName: string;
-}
-interface UpdateDocument {
-    title?: string;
-    parentId?: Uuid | null;
-    position?: number;
-}
-interface DocumentListOptions {
-    limit?: number;
-    offset?: number;
-}
-interface RecordDocuments {
-    /** Documents grouped by attribute name (includes system 'attachments' attribute) */
-    byAttribute: Record<string, DocumentWithFiles[]>;
-}
-
-/**
- * Storage provider type
- */
-type StorageProvider = "s3" | "gcs" | "azure" | "local" | "cloudflare-r2" | string;
-/**
- * File - Represents uploaded file metadata and storage info
- *
- * ARCHITECTURE:
- * - Fixed table (no custom attributes)
- * - Manages file storage metadata
- * - uploadedBy links to user_profiles table
- * - Supports soft delete via deletedAt
- *
- * @example
- * ```typescript
- * const file: File = {
- *   id: "file-123",
- *   tenantId: "tenant-456",
- *   name: "contract-2025.pdf",
- *   originalName: "Contract Acme Corp 2025.pdf",
- *   mimeType: "application/pdf",
- *   size: 2458624,
- *   storageProvider: "s3",
- *   storagePath: "tenants/456/files/2025/11/contract-2025.pdf",
- *   storageBucket: "my-app-files",
- *   url: "https://cdn.example.com/files/file-123",
- *   uploadedBy: "profile-789",
- *   folderPath: "/contracts/2025",
- *   createdAt: new Date(),
- *   updatedAt: new Date(),
- * };
- * ```
- */
-interface File extends Timestamps {
-    id: Uuid;
-    tenantId: Uuid;
-    /**
-     * File name (sanitized for storage)
-     */
-    name: string;
-    /**
-     * Original file name (as uploaded by user)
-     */
-    originalName: string;
-    /**
-     * MIME type (e.g., "application/pdf", "image/jpeg")
-     */
-    mimeType: MimeType | string;
-    /**
-     * File size in bytes
-     */
-    size: number;
-    /**
-     * Storage provider (s3, gcs, azure, local, etc.)
-     */
-    storageProvider: StorageProvider;
-    /**
-     * Path in the storage bucket
-     */
-    storagePath: string;
-    /**
-     * Storage bucket name (if applicable)
-     */
-    storageBucket?: string;
-    /**
-     * Public or signed URL to access the file
-     */
-    url: string;
-    /**
-     * User who uploaded the file (FK to user_profiles)
-     * Optional for system-generated files or anonymous uploads.
-     */
-    uploadedBy?: Uuid;
-    /**
-     * Folder path for organization (e.g., "/contracts/2025")
-     */
-    folderPath?: string;
-    /**
-     * Soft delete timestamp (null = not deleted)
-     */
-    deletedAt?: Date;
-    /**
-     * Document this file belongs to, when the file is a member of a document
-     * pack. NULL for files that aren't part of a document (e.g. freshly
-     * uploaded blobs not yet attached to a pack).
-     */
-    documentId?: Uuid | null;
-    /**
-     * Append-only position within the owning document pack (plain integer,
-     * `max(position) + 1`). Packs are NOT reorderable (spec §2).
-     */
-    position?: number | null;
-    /**
-     * OCR processing status for this file, when applicable.
-     */
-    ocrStatus?: FileOcrStatus | null;
-    /**
-     * Extracted OCR text, when processing has completed.
-     */
-    ocrText?: string | null;
-    /**
-     * OCR confidence score, when processing has completed.
-     */
-    ocrConfidence?: number | null;
-    /**
-     * Timestamp of the last OCR processing attempt.
-     */
-    processedAt?: Date | null;
-}
-/**
- * Data required to create a new file record
- */
-/**
- * Data for creating a new file.
- * Tenant ID is automatically set from execution context.
- */
-interface CreateFile {
-    name: string;
-    originalName: string;
-    mimeType: MimeType | string;
-    size: number;
-    storageProvider: StorageProvider;
-    storagePath: string;
-    storageBucket?: string;
-    url: string;
-    uploadedBy?: Uuid;
-    folderPath?: string;
-    documentId?: Uuid | null;
-    position?: number | null;
-    ocrStatus?: FileOcrStatus | null;
-    ocrText?: string | null;
-    ocrConfidence?: number | null;
-    processedAt?: Date | null;
-}
-/**
- * Data for updating an existing file record
- */
-interface UpdateFile {
-    name?: string;
-    folderPath?: string;
-    documentId?: Uuid | null;
-    position?: number | null;
-    ocrStatus?: FileOcrStatus | null;
-    ocrText?: string | null;
-    ocrConfidence?: number | null;
-    processedAt?: Date | null;
-}
-
 /**
  * Outcome of a compaction pass: a no-op (context already small enough), an LLM
  * `summary`, or a degraded `truncation` (the summarizer failed/timed out/returned
@@ -1160,6 +931,12 @@ interface AgentConfig {
     systemPrompt: string;
     model: ModelDefinition;
     tools?: string[];
+    /**
+     * MCP servers whose tools mount into this agent's toolchain. Ids opt in
+     * explicitly; `"all"` mounts every server the viewer can see. Absent means
+     * none — so agents that predate this field are tool-identical.
+     */
+    mcpServers?: string[] | "all";
     timeoutMs?: number;
     costLimitUsd?: number | null;
     canDelegate: boolean;
@@ -1263,6 +1040,13 @@ interface AgentBlueprint {
     canDelegate?: boolean;
     maxDepth?: number;
     maxTreeCostUsd?: number;
+    /**
+     * MCP servers this agent may use (see `AgentConfig.mcpServers`). Absent
+     * means none — an agent that never declares this stays tool-identical to
+     * one predating the field. Reconciled by the boot sync like the other
+     * optional config fields (`SYNCED_FIELDS`).
+     */
+    mcpServers?: string[] | "all";
     system: boolean;
     /** Code-declared agents are workspace-visible; private is runtime-only. */
     visibility: ResourceVisibility;
@@ -1385,6 +1169,14 @@ interface AgentDefinition {
     tools?: string[];
     schedule?: AgentSchedule;
     config: AgentExecutionConfig;
+    /**
+     * MCP servers this definition may use (see `AgentConfig.mcpServers`).
+     * Absent means none — a definition that predates this field is
+     * tool-identical to one that never sets it. The opt-in is narrowed further
+     * by the viewer's visibility at resolution time (`buildMcpToolset`); a
+     * server id here that the viewer cannot see yields no tools from it.
+     */
+    mcpServers?: string[] | "all";
     /** Code-declared (immutable via public API); reconciled by the boot sync. */
     system: boolean;
     visibility: ResourceVisibility;
@@ -1399,8 +1191,6 @@ interface AgentDefinition {
     critic?: CriticConfig;
     missionPolicy?: AgentMissionPolicy;
     autoDecide?: boolean;
-    fileIds?: string[];
-    attachments?: File[];
     requiredPermission?: AgentRequiredPermission;
 }
 interface AgentRun {
@@ -2410,4 +2200,4 @@ declare function parseAttributeConfigForCreate(type: AttributeType, input: unkno
  */
 declare function parseAttributeConfigForUpdate(stored: Attribute, patch: Partial<AddAttributeInput>): Record<string, unknown>;
 
-export { type AIQuestionOption as $, type Action as A, type AIBatchQuestion as B, type ConfigOverrides as C, type DetailViewConfig as D, type AIBatchQuestionAnswer as E, type FilterState as F, type Group as G, type AIBatchQuestionOption as H, type AIBatchQuestionType as I, type AIChatMessage as J, type AIChatMessagePart as K, type ListViewConfig as L, type ModelDefinition as M, type AIChatMessagePartType as N, type AIChatNotification as O, type PermissionScope as P, type AICompactionSummary as Q, type RelationGroup as R, type SortRule as S, type TriggerEventType as T, type AIMemoryEntry as U, type ViewType as V, type AIMemoryType as W, type AIMessageRole as X, type AIProviderMetrics as Y, type AIQuestion as Z, type AIQuestionAnswer as _, type ViewConfig as a, type EffectivePermissions as a$, type AIQuestionType as a0, type AISubagentStatus as a1, type AITodoItem as a2, type AITodoList as a3, type AITodoStatus as a4, type AIToolCall as a5, type AIToolCallStatus as a6, type AIUsageMetrics as a7, ALL_ACTIONS as a8, type AccessLevel as a9, type AgentTodoPlanStatus as aA, type AgentTodoPlanView as aB, type AgentToolCall as aC, type AgentTriggerDefinition as aD, type AgentTriggerType as aE, type ApprovalMode as aF, type AssignRoleInput as aG, type CompactionStrategy as aH, type CreateCustomObjectInput as aI, type CreateDocument as aJ, type CreateDocumentLink as aK, type CreateFile as aL, type CreatePermissionInput as aM, type CreateRoleInput as aN, type CreateViewInput as aO, type CriticConfig as aP, type CurrencyFilterValue as aQ, type CustomTab as aR, DEFAULT_APPROVAL_POLICY as aS, type Document as aT, type DocumentFile as aU, type DocumentKind as aV, type DocumentListOptions as aW, type DocumentWithFiles as aX, type DocumentWithSubCount as aY, type DocumentsTab as aZ, type EdgeQuantifier as a_, type ActivityTab as aa, type AddAttributeInput as ab, type AdvancedFilterState as ac, type AgentConfig as ad, type AgentDashboard as ae, type AgentDefinition as af, type AgentEvent as ag, type AgentMessageAttachment as ah, type AgentMessagePart as ai, type AgentMission as aj, type AgentMissionArtifact as ak, type AgentMissionPage as al, type AgentMissionPolicy as am, type AgentMissionRubric as an, type AgentMissionRubricCriterion as ao, type AgentMissionStatus as ap, type AgentMissionVerification as aq, type AgentMissionView as ar, type AgentRequiredPermission as as, type AgentRun as at, type AgentRunStatus as au, type AgentSession as av, type AgentSessionMessage as aw, type AgentSessionMode as ax, type AgentSessionStatus as ay, type AgentTodoPlan as az, type FilterOperator as b, type UpdateObjectInput as b$, type EmailsTab as b0, type ExtendedFilterRule as b1, type File as b2, type FileOcrStatus as b3, type FilterCombinator as b4, type FilterGroup as b5, type FormDensity as b6, type FormSubmittedAgentEvent as b7, type FormTab as b8, type FormsTab as b9, type Role as bA, SESSION_TERMINAL_STATUSES as bB, type SessionApprovalMode as bC, type SortDirection as bD, type StorageProvider as bE, type StreamEventCompactionEnd as bF, type StreamEventCompactionFailed as bG, type StreamEventCompactionStart as bH, type StreamEventMessagePersisted as bI, type StreamEventMessageUpdated as bJ, type StreamEventMissionUpdate as bK, type StreamEventTodoPlanUpdate as bL, type StreamEventUsage as bM, type SystemPermissions as bN, TODO_PLAN_STATUSES as bO, TODO_STATUSES as bP, type TabType as bQ, type TableSource as bR, type TerminalSessionStatus as bS, type TextPartData as bT, type ThinkingPartData as bU, type ToolImpact as bV, type ToolPartData as bW, type ToolPartErrorCode as bX, type ToolPartState as bY, type UpdateDocument as bZ, type UpdateFile as b_, type HumanRequestNeed as ba, type InverseSource as bb, type ListViewLayout as bc, MAX_TODOS as bd, MAX_TODO_DESCRIPTION_CHARS as be, MAX_TODO_ID_CHARS as bf, MAX_TODO_RESULT_CHARS as bg, type MentionEntityType as bh, type MentionReference as bi, type MentionedContext as bj, type MentionedEntityContext as bk, NO_VALUE_OPERATORS as bl, type NoValueOperator as bm, OPERATORS_BY_TYPE as bn, type ObjectPermissions as bo, type Permission as bp, type PhoneFilterValue as bq, type QueryState as br, type ReasoningPartData as bs, type RecordAgentEvent as bt, type RecordDocuments as bu, type RelationOption as bv, type RelationOptionsResponse as bw, type RelationSource as bx, type RetryPolicy as by, type RichtextTab as bz, type SystemResource as c, type UpdateRoleInput as c0, type UpdateViewInput as c1, type UserRoleAssignment as c2, type ViewOverlay as c3, accessLevelToActions as c4, actionsToAccessLevel as c5, agentDisplayName as c6, getRollupFilterOperators as c7, isDetailView as c8, isFieldGroup as c9, isListView as ca, isNoValueOperator as cb, isRelationGroup as cc, isTerminalSessionStatus as cd, multiselectOptionWriteSchema as ce, parseAttributeConfig as cf, parseAttributeConfigForCreate as cg, parseAttributeConfigForUpdate as ch, selectOptionWriteSchema as ci, statusGroupSchema as cj, statusOptionWriteSchema as ck, attributeConfigSchemas as cl, getAttributeConfigSchema as cm, type ProviderName as d, type AgentSchedule as e, type AgentExecutionConfig as f, type AgentApprovalPolicy as g, type AgentTriggerBlueprint as h, type AgentBlueprint as i, type DetailViewDefinition as j, type SidePanelConfig as k, type Field as l, type AttributeGroupField as m, type FieldGroup as n, type TableTab as o, type CreateMode as p, type Tab as q, type ListViewDefinition as r, type ViewDefinition as s, type ListViewTab as t, type FilterValue as u, type FilterRule as v, type DynamicValue as w, type RelativeDateValue as x, type AIAvailableModel as y, type AIBatchAnswerValue as z };
+export { type AIQuestionOption as $, type Action as A, type AIBatchQuestion as B, type ConfigOverrides as C, type DetailViewConfig as D, type AIBatchQuestionAnswer as E, type FilterState as F, type Group as G, type AIBatchQuestionOption as H, type AIBatchQuestionType as I, type AIChatMessage as J, type AIChatMessagePart as K, type ListViewConfig as L, type ModelDefinition as M, type AIChatMessagePartType as N, type AIChatNotification as O, type PermissionScope as P, type AICompactionSummary as Q, type RelationGroup as R, type SortRule as S, type TriggerEventType as T, type AIMemoryEntry as U, type ViewType as V, type AIMemoryType as W, type AIMessageRole as X, type AIProviderMetrics as Y, type AIQuestion as Z, type AIQuestionAnswer as _, type ViewConfig as a, type HumanRequestNeed as a$, type AIQuestionType as a0, type AISubagentStatus as a1, type AITodoItem as a2, type AITodoList as a3, type AITodoStatus as a4, type AIToolCall as a5, type AIToolCallStatus as a6, type AIUsageMetrics as a7, ALL_ACTIONS as a8, type AccessLevel as a9, type AgentTodoPlanStatus as aA, type AgentTodoPlanView as aB, type AgentToolCall as aC, type AgentTriggerDefinition as aD, type AgentTriggerType as aE, type ApprovalMode as aF, type AssignRoleInput as aG, type CompactionStrategy as aH, type CreateCustomObjectInput as aI, type CreatePermissionInput as aJ, type CreateRoleInput as aK, type CreateViewInput as aL, type CriticConfig as aM, type CurrencyFilterValue as aN, type CustomTab as aO, DEFAULT_APPROVAL_POLICY as aP, type DocumentsTab as aQ, type EdgeQuantifier as aR, type EffectivePermissions as aS, type EmailsTab as aT, type ExtendedFilterRule as aU, type FilterCombinator as aV, type FilterGroup as aW, type FormDensity as aX, type FormSubmittedAgentEvent as aY, type FormTab as aZ, type FormsTab as a_, type ActivityTab as aa, type AddAttributeInput as ab, type AdvancedFilterState as ac, type AgentConfig as ad, type AgentDashboard as ae, type AgentDefinition as af, type AgentEvent as ag, type AgentMessageAttachment as ah, type AgentMessagePart as ai, type AgentMission as aj, type AgentMissionArtifact as ak, type AgentMissionPage as al, type AgentMissionPolicy as am, type AgentMissionRubric as an, type AgentMissionRubricCriterion as ao, type AgentMissionStatus as ap, type AgentMissionVerification as aq, type AgentMissionView as ar, type AgentRequiredPermission as as, type AgentRun as at, type AgentRunStatus as au, type AgentSession as av, type AgentSessionMessage as aw, type AgentSessionMode as ax, type AgentSessionStatus as ay, type AgentTodoPlan as az, type FilterOperator as b, multiselectOptionWriteSchema as b$, type InverseSource as b0, type ListViewLayout as b1, MAX_TODOS as b2, MAX_TODO_DESCRIPTION_CHARS as b3, MAX_TODO_ID_CHARS as b4, MAX_TODO_RESULT_CHARS as b5, type MentionEntityType as b6, type MentionReference as b7, type MentionedContext as b8, type MentionedEntityContext as b9, type SystemPermissions as bA, TODO_PLAN_STATUSES as bB, TODO_STATUSES as bC, type TabType as bD, type TableSource as bE, type TerminalSessionStatus as bF, type TextPartData as bG, type ThinkingPartData as bH, type ToolImpact as bI, type ToolPartData as bJ, type ToolPartErrorCode as bK, type ToolPartState as bL, type UpdateObjectInput as bM, type UpdateRoleInput as bN, type UpdateViewInput as bO, type UserRoleAssignment as bP, type ViewOverlay as bQ, accessLevelToActions as bR, actionsToAccessLevel as bS, agentDisplayName as bT, getRollupFilterOperators as bU, isDetailView as bV, isFieldGroup as bW, isListView as bX, isNoValueOperator as bY, isRelationGroup as bZ, isTerminalSessionStatus as b_, NO_VALUE_OPERATORS as ba, type NoValueOperator as bb, OPERATORS_BY_TYPE as bc, type ObjectPermissions as bd, type Permission as be, type PhoneFilterValue as bf, type QueryState as bg, type ReasoningPartData as bh, type RecordAgentEvent as bi, type RelationOption as bj, type RelationOptionsResponse as bk, type RelationSource as bl, type RetryPolicy as bm, type RichtextTab as bn, type Role as bo, SESSION_TERMINAL_STATUSES as bp, type SessionApprovalMode as bq, type SortDirection as br, type StreamEventCompactionEnd as bs, type StreamEventCompactionFailed as bt, type StreamEventCompactionStart as bu, type StreamEventMessagePersisted as bv, type StreamEventMessageUpdated as bw, type StreamEventMissionUpdate as bx, type StreamEventTodoPlanUpdate as by, type StreamEventUsage as bz, type SystemResource as c, parseAttributeConfig as c0, parseAttributeConfigForCreate as c1, parseAttributeConfigForUpdate as c2, selectOptionWriteSchema as c3, statusGroupSchema as c4, statusOptionWriteSchema as c5, attributeConfigSchemas as c6, getAttributeConfigSchema as c7, type ProviderName as d, type AgentSchedule as e, type AgentExecutionConfig as f, type AgentApprovalPolicy as g, type AgentTriggerBlueprint as h, type AgentBlueprint as i, type DetailViewDefinition as j, type SidePanelConfig as k, type Field as l, type AttributeGroupField as m, type FieldGroup as n, type TableTab as o, type CreateMode as p, type Tab as q, type ListViewDefinition as r, type ViewDefinition as s, type ListViewTab as t, type FilterValue as u, type FilterRule as v, type DynamicValue as w, type RelativeDateValue as x, type AIAvailableModel as y, type AIBatchAnswerValue as z };