skedyul 1.7.26 → 1.7.28

package/dist/config/app-config.d.ts

@@ -31,11 +31,12 @@ export interface InstallConfig {
 export interface ProvisionConfig {
     /** Global environment variables (developer-level, shared across all installs) */
     env?: EnvSchema;
-    /** INTERNAL model definitions (app-owned, not visible to users) */
+    /** INTERNAL model definitions for data shared across installs */
     models?: ModelDefinition[];
     /**
-     * App entity contracts for install-time CRM maps (not shared models).
+     * App entity contracts for install-time CRM maps (not shared or internal models).
      * Workplaces map these to CRM; workflows apply maps via app-handle Liquid filters.
+     * Runtime `instance.*('<entity>')` resolves the mapped workplace model.
      */
     entities?: EntityDefinition[];
     /** Relationship definitions between INTERNAL models */

package/dist/config/schema-loader.d.ts

@@ -83,6 +83,11 @@ export interface BackendFieldDefinition {
         }>;
         limitChoices?: number;
     };
+    aiMeta?: {
+        description?: string;
+        mutability?: 'always' | 'restricted' | 'create_only' | 'immutable';
+    };
+    section?: string;
 }
 /**
  * Backend-compatible relationship definition.
@@ -159,7 +164,11 @@ export interface BackendDesiredSchema {
     navigation?: BackendNavigationDefinition;
 }
 /**
- * Transform a CRM schema to the backend's DesiredSchema format.
+ * Transform a CRM schema to a legacy backend DesiredSchema format.
+ *
+ * @deprecated The CLI API and UI upload accept public CRM v1 JSON directly
+ * (`list` / `unique` / `default` / `requirement` / `section` / `aiMeta`).
+ * Prefer sending the loaded schema without this transform.
  */
 export declare function transformToBackendSchema(schema: CRMSchema): BackendDesiredSchema;
 /**

package/dist/config/types/app-event.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Sync direction for events:
+ * - 'inbound': Events from external system → platform (e.g. Google Calendar changes)
+ * - 'outbound': Events from platform CRM → external system (e.g. pushing CRM changes to Google)
+ */
+export type EventDirection = 'inbound' | 'outbound';
 /**
  * App event definition for integration executable config.
  *
@@ -15,6 +21,13 @@ export interface AppEventDefinition {
     group?: string;
     /** Optional Lucide icon name for pickers */
     icon?: string;
+    /**
+     * Sync direction for this event type.
+     * - 'inbound': External system → platform (e.g. webhook events from Google)
+     * - 'outbound': Platform CRM → external (e.g. CRM instance.updated triggers)
+     * Defaults to 'inbound' for app.* events when not specified.
+     */
+    direction?: EventDirection;
     /**
      * Example flat domain payload for liquid context reference (e.g. external_id, phone, …).
      * Not the full emit payload — studio/branch metadata is added at emit time.

package/dist/config/types/entity.d.ts

@@ -2,8 +2,10 @@
  * App entity definition types.
  *
  * Entities describe external/logical payload shapes that workplaces map to CRM
- * via install-time CRM maps. They are NOT shared models — the app does not own
- * CRM writes; workflows/agents apply maps.
+ * via install-time CRM maps. They are NOT shared models and they are NOT
+ * internal models (internal models are for data shared across installs).
+ * Workflows apply maps with an app-handle Liquid filter. Runtime
+ * `instance.list/create/update('<entity>')` also resolves the mapped workplace model.
  */
 import type { BaseDefinition, FieldOption } from './base';
 /**
@@ -51,6 +53,13 @@ export interface EntityFieldDefinition {
     matchCandidate?: boolean;
     /** Whether this field should be mapped for a complete configuration */
     required?: boolean;
+    /**
+     * Optional global FieldDefinition handle to attach when CRM apply creates
+     * or retargets the mapped workplace field (e.g. `calendar/recurrence`,
+     * `calendar/series_id`, `phone`). Core looks this up by handle; do not
+     * mint a private definition.
+     */
+    definition?: string;
     /** Enum options when the source value is constrained */
     options?: FieldOption[] | string[];
 }

package/dist/config/types/model.d.ts

@@ -27,8 +27,9 @@ export type FieldType = 'string' | 'long_string' | 'number' | 'boolean' | 'date'
  * - 'none': No action (orphan the reference)
  * - 'cascade': Delete related records
  * - 'restrict': Prevent deletion if references exist
+ * - 'set_null': Clear the relation field on related records
  */
-export type OnDelete = 'none' | 'cascade' | 'restrict';
+export type OnDelete = 'none' | 'cascade' | 'restrict' | 'set_null';
 /**
  * Field requirement types.
  * - 'optional': Field is never required
@@ -180,23 +181,22 @@ export interface RelationshipLink {
     label: string;
 }
 /**
- * Relationship cardinality from source (one) to target (many or one).
+ * Relationship cardinality from source to target.
  * - 'one_to_one': One source record relates to one target record
  * - 'one_to_many': One source record relates to many target records
- *
- * Note: For many-to-one relationships, swap source and target and use 'one_to_many'.
+ * - 'many_to_one': Many source records relate to one target record
+ * - 'many_to_many': Many source records relate to many target records
  */
-export type Cardinality = 'one_to_one' | 'one_to_many';
+export type Cardinality = 'one_to_one' | 'one_to_many' | 'many_to_one' | 'many_to_many';
 /**
  * Relationship definition between two models.
- * Source is always the "one" side, target is the "many" side (for one_to_many).
  */
 export interface RelationshipDefinition {
-    /** Source side of the relationship (the "one" side) */
+    /** Source side of the relationship */
     source: RelationshipLink;
-    /** Target side of the relationship (the "many" side for one_to_many) */
+    /** Target side of the relationship */
     target: RelationshipLink;
-    /** Cardinality: 'one_to_one' or 'one_to_many' */
+    /** Cardinality from the source side */
     cardinality: Cardinality;
     /** Behavior when a related record is deleted */
     onDelete?: OnDelete;

package/dist/core/client.d.ts

@@ -109,6 +109,12 @@ export interface ReceiveMessageInput {
     contact?: ReceiveMessageContact;
     /** Optional remote/external message ID (provider message id) */
     remoteId?: string;
+    /**
+     * How many files will be linked via attachFilesToMessage after this call.
+     * When set, the platform holds thread.message.received until that many
+     * attachments land (or a timeout), so consumers see the files.
+     */
+    expectedAttachmentCount?: number;
 }
 /**
  * Parameters for creating a communication channel.
@@ -208,7 +214,9 @@ export declare const communicationChannel: {
      * - Before: attachments are stashed on MessageInbox and linked when the message is created
      * - After: rows are created immediately and `thread.attachment.received` is emitted
      *
-     * Typical flow for email/MMS: `receiveMessage` → `file.upload` → `attachFilesToMessage`.
+     * Typical flow for email/MMS: `receiveMessage({ expectedAttachmentCount })` →
+     * `file.upload` → `attachFilesToMessage`. Pass `expectedAttachmentCount` so
+     * `thread.message.received` waits for the files.
      *
      * @example
      * ```ts
@@ -545,8 +553,9 @@ export declare const file: {
     /**
      * Upload file content and create a File record.
      *
-     * Files are scoped to the app installation and stored privately.
+     * Files are stored privately under workplaces/{subdomain}/files/{timestamp}-{name}.
      * Use file.getUrl() to generate a temporary download URL when needed.
+     * The optional `path` argument is accepted for compatibility but ignored for the S3 key.
      *
      * @example
      * ```ts
@@ -557,14 +566,6 @@ export declare const file: {
      *   name: 'document.pdf',
      *   mimeType: 'application/pdf',
      * })
-     *
-     * // Upload with a path prefix for organization
-     * const { id } = await file.upload({
-     *   content: imageBuffer,
-     *   name: 'photo.jpg',
-     *   mimeType: 'image/jpeg',
-     *   path: 'attachments',
-     * })
      * ```
      */
     upload(params: FileUploadParams): Promise<FileUploadResult>;

package/dist/esm/index.mjs

@@ -364,6 +364,10 @@ var CRMFieldAppearanceSchemaZ = z3.object({
   placeholder: z3.string().optional(),
   helpText: z3.string().optional()
 });
+var CRMFieldAiMetaSchemaZ = z3.object({
+  description: z3.string().optional(),
+  mutability: z3.enum(["always", "restricted", "create_only", "immutable"]).optional()
+});
 var CRMFieldSchemaZ = z3.object({
   handle: z3.string().regex(/^[a-z][a-z0-9_]*$/, "Handle must be lowercase alphanumeric with underscores, starting with a letter"),
   label: z3.string().min(1, "Label is required"),
@@ -377,6 +381,8 @@ var CRMFieldSchemaZ = z3.object({
   list: z3.boolean().optional(),
   default: z3.unknown().optional(),
   definition: CRMFieldDefinitionSchema.optional(),
+  /** AI metadata - description and mutability hints for agents */
+  aiMeta: CRMFieldAiMetaSchemaZ.optional(),
   /**
    * Workplace-scoped field section handle (visualization helper).
    * Find-or-create on apply; display name is derived from the handle on create.
@@ -392,8 +398,18 @@ var CRMModelSchemaZ = z3.object({
   icon: z3.string().optional(),
   fields: z3.array(CRMFieldSchemaZ)
 });
-var CRMCardinalitySchema = z3.enum(["one_to_one", "one_to_many"]);
-var CRMOnDeleteSchema = z3.enum(["none", "cascade", "restrict"]);
+var CRMCardinalitySchema = z3.enum([
+  "one_to_one",
+  "one_to_many",
+  "many_to_one",
+  "many_to_many"
+]);
+var CRMOnDeleteSchema = z3.enum([
+  "none",
+  "cascade",
+  "restrict",
+  "set_null"
+]);
 var CRMRelationshipLinkSchema = z3.object({
   model: z3.string(),
   field: z3.string(),
@@ -1327,6 +1343,8 @@ var EntityFieldDefinitionSchema = z8.object({
   /** @deprecated Prefer isUnique */
   matchCandidate: z8.boolean().optional(),
   required: z8.boolean().optional(),
+  /** Global FieldDefinition handle (e.g. calendar/recurrence, calendar/series_id) */
+  definition: z8.string().optional(),
   options: z8.array(
     z8.union([
       z8.string(),
@@ -1360,9 +1378,16 @@ var EntityDefinitionSchema = z8.object({
 });
 var RelationshipCardinalitySchema = z8.enum([
   "ONE_TO_ONE",
-  "ONE_TO_MANY"
+  "ONE_TO_MANY",
+  "MANY_TO_ONE",
+  "MANY_TO_MANY"
+]);
+var OnDeleteBehaviorSchema = z8.enum([
+  "NONE",
+  "CASCADE",
+  "RESTRICT",
+  "SET_NULL"
 ]);
-var OnDeleteBehaviorSchema = z8.enum(["NONE", "CASCADE", "RESTRICT"]);
 var RelationshipLinkSchema = z8.object({
   model: z8.string(),
   field: z8.string(),
@@ -1968,9 +1993,9 @@ var BatchOperationDefinitionSchema = z8.object({
 });
 var ProvisionConfigSchema = z8.object({
   env: EnvSchemaSchema.optional(),
-  /** INTERNAL model definitions (app-owned, not visible to users) */
+  /** INTERNAL model definitions for data shared across installs */
   models: z8.array(ModelDefinitionSchema).optional(),
-  /** App entity contracts for install-time CRM maps (not shared models) */
+  /** App entity contracts for install-time CRM maps (not shared or internal models) */
   entities: z8.array(EntityDefinitionSchema).optional(),
   /** Relationship definitions between INTERNAL models */
   relationships: z8.array(RelationshipDefinitionSchema).optional(),
@@ -2649,7 +2674,8 @@ var communicationChannel = {
       from: input.from,
       message: input.message,
       contact: input.contact,
-      ...input.remoteId ? { remoteId: input.remoteId } : {}
+      ...input.remoteId ? { remoteId: input.remoteId } : {},
+      ...input.expectedAttachmentCount != null ? { expectedAttachmentCount: input.expectedAttachmentCount } : {}
     });
     return data;
   },
@@ -2660,7 +2686,9 @@ var communicationChannel = {
    * - Before: attachments are stashed on MessageInbox and linked when the message is created
    * - After: rows are created immediately and `thread.attachment.received` is emitted
    *
-   * Typical flow for email/MMS: `receiveMessage` → `file.upload` → `attachFilesToMessage`.
+   * Typical flow for email/MMS: `receiveMessage({ expectedAttachmentCount })` →
+   * `file.upload` → `attachFilesToMessage`. Pass `expectedAttachmentCount` so
+   * `thread.message.received` waits for the files.
    *
    * @example
    * ```ts
@@ -3246,8 +3274,9 @@ var file = {
   /**
    * Upload file content and create a File record.
    *
-   * Files are scoped to the app installation and stored privately.
+   * Files are stored privately under workplaces/{subdomain}/files/{timestamp}-{name}.
    * Use file.getUrl() to generate a temporary download URL when needed.
+   * The optional `path` argument is accepted for compatibility but ignored for the S3 key.
    *
    * @example
    * ```ts
@@ -3258,14 +3287,6 @@ var file = {
    *   name: 'document.pdf',
    *   mimeType: 'application/pdf',
    * })
-   *
-   * // Upload with a path prefix for organization
-   * const { id } = await file.upload({
-   *   content: imageBuffer,
-   *   name: 'photo.jpg',
-   *   mimeType: 'image/jpeg',
-   *   path: 'attachments',
-   * })
    * ```
    */
   async upload(params) {
@@ -8864,6 +8885,8 @@ export {
   CRMCardinalitySchema,
   CRMContextSchema2 as CRMContextSchema,
   CRMDataSchema,
+  CRMFieldAiMetaSchemaZ,
+  CRMFieldAppearanceSchemaZ,
   CRMFieldDefinitionSchema,
   CRMFieldOptionSchema,
   CRMFieldRequirementSchema,

package/dist/index.d.ts

@@ -34,7 +34,7 @@ export { CRMContextSchema, SenderContextSchema, ThreadContextItemSchema, ThreadI
 export type { CRMContext, SenderContext, ThreadContextItem, ThreadInfo, SandboxConfig, Subscription, Association, Contact, AgentSenderContext, AgentThreadContext, AgentContext, ContextIssueSeverity, ContextIssueType, ContextIssue, ContextValidationResult, MockSenderContext, MockThreadContext, MockContext, } from './context';
 export { MemoryEntryTypeSchema, MemoryEntrySchema, WorkingMemoryConfigSchema, SemanticMemoryConfigSchema, ExternalMemoryConfigSchema, MemoryConfigSchema, MemoryScopeSchema, MemoryQueryOptionsSchema, ConversationSummarySchema, AgentObservationSchema, ExternalDataCacheSchema, MemoryService, InMemoryStore, createInMemoryService, } from './memory';
 export type { MemoryEntryType, MemoryEntry, WorkingMemoryConfig as MemoryWorkingConfig, SemanticMemoryConfig as MemorySemanticConfig, ExternalMemoryConfig as MemoryExternalConfig, MemoryConfig, MemoryScope, MemoryQueryOptions, ConversationSummary, AgentObservation, ExternalDataCache, MemoryStore, } from './memory';
-export type { CRMFieldType, CRMFieldRequirement, CRMFieldOption, CRMFieldDefinition, CRMFieldSchema, CRMModelSchema, CRMCardinality, CRMOnDelete, CRMRelationshipLink, CRMRelationshipSchema, CRMSchema, CRMSchemaValidationResult, } from './schemas';
+export type { CRMFieldType, CRMFieldRequirement, CRMFieldOption, CRMFieldDefinition, CRMFieldAppearance, CRMFieldAiMeta, CRMFieldSchema, CRMModelSchema, CRMCardinality, CRMOnDelete, CRMRelationshipLink, CRMRelationshipSchema, CRMSchema, CRMSchemaValidationResult, } from './schemas';
 export type { SkedyulConfig, SerializableSkedyulConfig, InstallConfig, ProvisionConfig, BaseDefinition, Scope, FieldOwner, Visibility, ComputeLayer, StructuredFilter, FilterOperator, FilterCondition, FieldOption, EnvVariable, EnvSchema, InstallPhase, FieldType, Cardinality, OnDelete, InlineFieldDefinition, FieldVisibility, FieldDefinition, ModelDefinition, RelationshipLink, RelationshipDefinition, CapabilityType, ChannelCapability, ChannelBatchCapability, ChannelFieldPermissions, ChannelField, ChannelDefinition, WorkflowActionInput, WorkflowAction, WorkflowDefinition, AgentDefinition, NavigationItem, NavigationSection, NavigationSidebar, BreadcrumbItem, NavigationBreadcrumb, NavigationConfig, ContextMode, ContextItemModel, ContextItemTool, ContextItem, ContextDefinition, FormStyleProps, ButtonVariant, ButtonSize, ButtonProps, RelationshipExtension, FormHeader, FormActionDefinition, ActionDefinition, ModalFormDefinition, InputComponent, TextareaComponent, SelectComponent, ComboboxComponent, CheckboxComponent, DatePickerComponent, TimePickerComponent, StatusIndicator, FieldSettingComponent, ImageSettingComponent, FileSettingComponent, ListItemTemplate, ListComponent, EmptyFormComponent, AlertComponent, FormComponent, FormLayoutColumn, FormLayoutRow, FormLayoutConfig, FormProps, CardHeader, CardBlock, ListBlock, BlockDefinition, SetupStepDefinition, SetupStepKind, BatchCascadePhase, BatchOperationDefinition, BatchOperationContext, BatchOperationIterateResult, BatchOperationSetupResult, PageType, PageDefinition, HttpMethod, WebhookRequest, WebhookHandlerContext, WebhookHandlerResponse, WebhookHandlerFn, WebhookHandlerDefinition, Webhooks, WebhookHandlerMetadata, ModelDependency, ChannelDependency, WorkflowDependency, ResourceDependency, } from './config';
 export { compileAgent, compileWorkflow } from './compiler';
 export type { ValidationError, ValidationWarning, ResolvedPersona, ResolvedTool, EventConfig as CompilerEventConfig, IRMemoryConfig, PolicyConfig, IRRuntimeConfig, AgentIR, WorkflowStepIR, WorkflowIR, CompilationResult, } from './compiler';
@@ -48,3 +48,4 @@ export type { MessageBulkRecipient, MessageBulkSendInput, MessageBulkSendOutput,
 export type { QueueTouchPoint } from './types';
 export { toGsm7, estimateSmsSegments } from './tools/sms/gsm7';
 export type { SmsEncoding, SmsSegmentEstimate } from './tools/sms/gsm7';
+export type { EventDirection } from './config/types/app-event';

package/dist/index.js

@@ -51,6 +51,8 @@ __export(index_exports, {
   CRMCardinalitySchema: () => CRMCardinalitySchema,
   CRMContextSchema: () => CRMContextSchema2,
   CRMDataSchema: () => CRMDataSchema,
+  CRMFieldAiMetaSchemaZ: () => CRMFieldAiMetaSchemaZ,
+  CRMFieldAppearanceSchemaZ: () => CRMFieldAppearanceSchemaZ,
   CRMFieldDefinitionSchema: () => CRMFieldDefinitionSchema,
   CRMFieldOptionSchema: () => CRMFieldOptionSchema,
   CRMFieldRequirementSchema: () => CRMFieldRequirementSchema,
@@ -753,6 +755,10 @@ var CRMFieldAppearanceSchemaZ = import_v43.z.object({
   placeholder: import_v43.z.string().optional(),
   helpText: import_v43.z.string().optional()
 });
+var CRMFieldAiMetaSchemaZ = import_v43.z.object({
+  description: import_v43.z.string().optional(),
+  mutability: import_v43.z.enum(["always", "restricted", "create_only", "immutable"]).optional()
+});
 var CRMFieldSchemaZ = import_v43.z.object({
   handle: import_v43.z.string().regex(/^[a-z][a-z0-9_]*$/, "Handle must be lowercase alphanumeric with underscores, starting with a letter"),
   label: import_v43.z.string().min(1, "Label is required"),
@@ -766,6 +772,8 @@ var CRMFieldSchemaZ = import_v43.z.object({
   list: import_v43.z.boolean().optional(),
   default: import_v43.z.unknown().optional(),
   definition: CRMFieldDefinitionSchema.optional(),
+  /** AI metadata - description and mutability hints for agents */
+  aiMeta: CRMFieldAiMetaSchemaZ.optional(),
   /**
    * Workplace-scoped field section handle (visualization helper).
    * Find-or-create on apply; display name is derived from the handle on create.
@@ -781,8 +789,18 @@ var CRMModelSchemaZ = import_v43.z.object({
   icon: import_v43.z.string().optional(),
   fields: import_v43.z.array(CRMFieldSchemaZ)
 });
-var CRMCardinalitySchema = import_v43.z.enum(["one_to_one", "one_to_many"]);
-var CRMOnDeleteSchema = import_v43.z.enum(["none", "cascade", "restrict"]);
+var CRMCardinalitySchema = import_v43.z.enum([
+  "one_to_one",
+  "one_to_many",
+  "many_to_one",
+  "many_to_many"
+]);
+var CRMOnDeleteSchema = import_v43.z.enum([
+  "none",
+  "cascade",
+  "restrict",
+  "set_null"
+]);
 var CRMRelationshipLinkSchema = import_v43.z.object({
   model: import_v43.z.string(),
   field: import_v43.z.string(),
@@ -1716,6 +1734,8 @@ var EntityFieldDefinitionSchema = import_v48.z.object({
   /** @deprecated Prefer isUnique */
   matchCandidate: import_v48.z.boolean().optional(),
   required: import_v48.z.boolean().optional(),
+  /** Global FieldDefinition handle (e.g. calendar/recurrence, calendar/series_id) */
+  definition: import_v48.z.string().optional(),
   options: import_v48.z.array(
     import_v48.z.union([
       import_v48.z.string(),
@@ -1749,9 +1769,16 @@ var EntityDefinitionSchema = import_v48.z.object({
 });
 var RelationshipCardinalitySchema = import_v48.z.enum([
   "ONE_TO_ONE",
-  "ONE_TO_MANY"
+  "ONE_TO_MANY",
+  "MANY_TO_ONE",
+  "MANY_TO_MANY"
+]);
+var OnDeleteBehaviorSchema = import_v48.z.enum([
+  "NONE",
+  "CASCADE",
+  "RESTRICT",
+  "SET_NULL"
 ]);
-var OnDeleteBehaviorSchema = import_v48.z.enum(["NONE", "CASCADE", "RESTRICT"]);
 var RelationshipLinkSchema = import_v48.z.object({
   model: import_v48.z.string(),
   field: import_v48.z.string(),
@@ -2357,9 +2384,9 @@ var BatchOperationDefinitionSchema = import_v48.z.object({
 });
 var ProvisionConfigSchema = import_v48.z.object({
   env: EnvSchemaSchema.optional(),
-  /** INTERNAL model definitions (app-owned, not visible to users) */
+  /** INTERNAL model definitions for data shared across installs */
   models: import_v48.z.array(ModelDefinitionSchema).optional(),
-  /** App entity contracts for install-time CRM maps (not shared models) */
+  /** App entity contracts for install-time CRM maps (not shared or internal models) */
   entities: import_v48.z.array(EntityDefinitionSchema).optional(),
   /** Relationship definitions between INTERNAL models */
   relationships: import_v48.z.array(RelationshipDefinitionSchema).optional(),
@@ -3038,7 +3065,8 @@ var communicationChannel = {
       from: input.from,
       message: input.message,
       contact: input.contact,
-      ...input.remoteId ? { remoteId: input.remoteId } : {}
+      ...input.remoteId ? { remoteId: input.remoteId } : {},
+      ...input.expectedAttachmentCount != null ? { expectedAttachmentCount: input.expectedAttachmentCount } : {}
     });
     return data;
   },
@@ -3049,7 +3077,9 @@ var communicationChannel = {
    * - Before: attachments are stashed on MessageInbox and linked when the message is created
    * - After: rows are created immediately and `thread.attachment.received` is emitted
    *
-   * Typical flow for email/MMS: `receiveMessage` → `file.upload` → `attachFilesToMessage`.
+   * Typical flow for email/MMS: `receiveMessage({ expectedAttachmentCount })` →
+   * `file.upload` → `attachFilesToMessage`. Pass `expectedAttachmentCount` so
+   * `thread.message.received` waits for the files.
    *
    * @example
    * ```ts
@@ -3635,8 +3665,9 @@ var file = {
   /**
    * Upload file content and create a File record.
    *
-   * Files are scoped to the app installation and stored privately.
+   * Files are stored privately under workplaces/{subdomain}/files/{timestamp}-{name}.
    * Use file.getUrl() to generate a temporary download URL when needed.
+   * The optional `path` argument is accepted for compatibility but ignored for the S3 key.
    *
    * @example
    * ```ts
@@ -3647,14 +3678,6 @@ var file = {
    *   name: 'document.pdf',
    *   mimeType: 'application/pdf',
    * })
-   *
-   * // Upload with a path prefix for organization
-   * const { id } = await file.upload({
-   *   content: imageBuffer,
-   *   name: 'photo.jpg',
-   *   mimeType: 'image/jpeg',
-   *   path: 'attachments',
-   * })
    * ```
    */
   async upload(params) {
@@ -9254,6 +9277,8 @@ var index_default = { z: import_v414.z };
   CRMCardinalitySchema,
   CRMContextSchema,
   CRMDataSchema,
+  CRMFieldAiMetaSchemaZ,
+  CRMFieldAppearanceSchemaZ,
   CRMFieldDefinitionSchema,
   CRMFieldOptionSchema,
   CRMFieldRequirementSchema,

package/dist/schemas/crm-schema.d.ts

@@ -77,6 +77,19 @@ export declare const CRMFieldAppearanceSchemaZ: z.ZodObject<{
     helpText: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type CRMFieldAppearance = z.infer<typeof CRMFieldAppearanceSchemaZ>;
+/**
+ * AI metadata for CRM fields (hints for agents / auto-fill).
+ */
+export declare const CRMFieldAiMetaSchemaZ: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    mutability: z.ZodOptional<z.ZodEnum<{
+        always: "always";
+        restricted: "restricted";
+        create_only: "create_only";
+        immutable: "immutable";
+    }>>;
+}, z.core.$strip>;
+export type CRMFieldAiMeta = z.infer<typeof CRMFieldAiMetaSchemaZ>;
 /**
  * Field schema for CRM models.
  */
@@ -123,6 +136,15 @@ export declare const CRMFieldSchemaZ: z.ZodObject<{
         max: z.ZodOptional<z.ZodNumber>;
         pattern: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>]>>;
+    aiMeta: z.ZodOptional<z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        mutability: z.ZodOptional<z.ZodEnum<{
+            always: "always";
+            restricted: "restricted";
+            create_only: "create_only";
+            immutable: "immutable";
+        }>>;
+    }, z.core.$strip>>;
     section: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type CRMFieldSchema = z.infer<typeof CRMFieldSchemaZ>;
@@ -179,6 +201,15 @@ export declare const CRMModelSchemaZ: z.ZodObject<{
             max: z.ZodOptional<z.ZodNumber>;
             pattern: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>]>>;
+        aiMeta: z.ZodOptional<z.ZodObject<{
+            description: z.ZodOptional<z.ZodString>;
+            mutability: z.ZodOptional<z.ZodEnum<{
+                always: "always";
+                restricted: "restricted";
+                create_only: "create_only";
+                immutable: "immutable";
+            }>>;
+        }, z.core.$strip>>;
         section: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -189,6 +220,8 @@ export type CRMModelSchema = z.infer<typeof CRMModelSchemaZ>;
 export declare const CRMCardinalitySchema: z.ZodEnum<{
     one_to_one: "one_to_one";
     one_to_many: "one_to_many";
+    many_to_one: "many_to_one";
+    many_to_many: "many_to_many";
 }>;
 export type CRMCardinality = z.infer<typeof CRMCardinalitySchema>;
 /**
@@ -198,6 +231,7 @@ export declare const CRMOnDeleteSchema: z.ZodEnum<{
     none: "none";
     cascade: "cascade";
     restrict: "restrict";
+    set_null: "set_null";
 }>;
 export type CRMOnDelete = z.infer<typeof CRMOnDeleteSchema>;
 /**
@@ -226,11 +260,14 @@ export declare const CRMRelationshipSchemaZ: z.ZodObject<{
     cardinality: z.ZodEnum<{
         one_to_one: "one_to_one";
         one_to_many: "one_to_many";
+        many_to_one: "many_to_one";
+        many_to_many: "many_to_many";
     }>;
     onDelete: z.ZodOptional<z.ZodEnum<{
         none: "none";
         cascade: "cascade";
         restrict: "restrict";
+        set_null: "set_null";
     }>>;
 }, z.core.$strip>;
 export type CRMRelationshipSchema = z.infer<typeof CRMRelationshipSchemaZ>;
@@ -380,6 +417,15 @@ export declare const CRMSchemaZ: z.ZodObject<{
                 max: z.ZodOptional<z.ZodNumber>;
                 pattern: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>]>>;
+            aiMeta: z.ZodOptional<z.ZodObject<{
+                description: z.ZodOptional<z.ZodString>;
+                mutability: z.ZodOptional<z.ZodEnum<{
+                    always: "always";
+                    restricted: "restricted";
+                    create_only: "create_only";
+                    immutable: "immutable";
+                }>>;
+            }, z.core.$strip>>;
             section: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
@@ -397,11 +443,14 @@ export declare const CRMSchemaZ: z.ZodObject<{
         cardinality: z.ZodEnum<{
             one_to_one: "one_to_one";
             one_to_many: "one_to_many";
+            many_to_one: "many_to_one";
+            many_to_many: "many_to_many";
         }>;
         onDelete: z.ZodOptional<z.ZodEnum<{
             none: "none";
             cascade: "cascade";
             restrict: "restrict";
+            set_null: "set_null";
         }>>;
     }, z.core.$strip>>>;
     pages: z.ZodOptional<z.ZodArray<z.ZodObject<{

package/dist/schemas/index.d.ts

@@ -1,2 +1,2 @@
-export { CRMFieldTypeSchema, CRMFieldRequirementSchema, CRMFieldOptionSchema, CRMFieldDefinitionSchema, CRMFieldSchemaZ, CRMModelSchemaZ, CRMCardinalitySchema, CRMOnDeleteSchema, CRMRelationshipLinkSchema, CRMRelationshipSchemaZ, CRMSchemaZ, type CRMFieldType, type CRMFieldRequirement, type CRMFieldOption, type CRMFieldDefinition, type CRMFieldSchema, type CRMModelSchema, type CRMCardinality, type CRMOnDelete, type CRMRelationshipLink, type CRMRelationshipSchema, type CRMSchema, type CRMSchemaValidationResult, defineSchema, validateCRMSchema, parseCRMSchema, safeParseCRMSchema, } from './crm-schema';
+export { CRMFieldTypeSchema, CRMFieldRequirementSchema, CRMFieldOptionSchema, CRMFieldDefinitionSchema, CRMFieldAppearanceSchemaZ, CRMFieldAiMetaSchemaZ, CRMFieldSchemaZ, CRMModelSchemaZ, CRMCardinalitySchema, CRMOnDeleteSchema, CRMRelationshipLinkSchema, CRMRelationshipSchemaZ, CRMSchemaZ, type CRMFieldType, type CRMFieldRequirement, type CRMFieldOption, type CRMFieldDefinition, type CRMFieldAppearance, type CRMFieldAiMeta, type CRMFieldSchema, type CRMModelSchema, type CRMCardinality, type CRMOnDelete, type CRMRelationshipLink, type CRMRelationshipSchema, type CRMSchema, type CRMSchemaValidationResult, defineSchema, validateCRMSchema, parseCRMSchema, safeParseCRMSchema, } from './crm-schema';
 export { AGENT_SCHEMA_VERSION_V3, PersonaVoiceFormatV3Schema, PersonaVoiceV3Schema, PersonaV3Schema, ToolApprovalConfigSchema, ToolRefV3Schema, WorkingMemoryConfigSchema, ExternalMemoryConfigSchema, SemanticMemoryConfigSchema, MemoryConfigV3Schema, PoliciesConfigV3Schema, RuntimeConfigV3Schema, AgentYAMLV3Schema, TimeWindowTimeStampSchema, TimeWindowDayOfWeekSchema, TimeWindowSlotAgentSchema, ResponseModeSchema, TimeWindowBehaviorSchema, TimeWindowPolicySchema, TimeWindowPoliciesSchema, TimeWindowDefaultSchema, SchedulingDelaySchema, SchedulingPatternSchema, SchedulingBehaviorConfigSchema, type PersonaVoiceFormatV3, type PersonaVoiceV3, type PersonaV3, type ToolApprovalConfig, type ToolRefV3, type WorkingMemoryConfig, type ExternalMemoryConfig, type SemanticMemoryConfig, type MemoryConfigV3, type PoliciesConfigV3, type RuntimeConfigV3, type AgentYAMLV3, type TimeWindowTimeStamp, type TimeWindowDayOfWeek, type TimeWindowSlotAgent, type ResponseMode, type TimeWindowBehavior, type TimeWindowPolicy, type TimeWindowPolicies, type TimeWindowDefault, type SchedulingDelay, type SchedulingPattern, type SchedulingBehaviorConfig, defineAgentV3, validateAgentYAMLV3, } from './agent-schema-v3';