skedyul 1.7.27 → 1.7.28

package/dist/.build-stamp

@@ -1 +1 @@
-1787542758884
+1788249705157

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/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';
 /**
@@ -52,8 +54,10 @@ export interface EntityFieldDefinition {
     /** Whether this field should be mapped for a complete configuration */
     required?: boolean;
     /**
-     * Global FieldDefinition handle to attach when CRM apply creates or
-     * retargets the mapped workplace field (e.g. `calendar/recurrence`).
+     * 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 */

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

package/dist/esm/index.mjs

@@ -1343,7 +1343,7 @@ var EntityFieldDefinitionSchema = z8.object({
   /** @deprecated Prefer isUnique */
   matchCandidate: z8.boolean().optional(),
   required: z8.boolean().optional(),
-  /** Global FieldDefinition handle (e.g. calendar/recurrence) */
+  /** Global FieldDefinition handle (e.g. calendar/recurrence, calendar/series_id) */
   definition: z8.string().optional(),
   options: z8.array(
     z8.union([
@@ -1993,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(),
@@ -2674,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;
   },
@@ -2685,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

package/dist/index.d.ts

@@ -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

@@ -1734,7 +1734,7 @@ 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) */
+  /** 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([
@@ -2384,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(),
@@ -3065,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;
   },
@@ -3076,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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skedyul",
-  "version": "1.7.27",
+  "version": "1.7.28",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -82,7 +82,7 @@
     "build": "rm -rf dist tsconfig.tsbuildinfo && tsc --emitDeclarationOnly && pnpm exec tsup-node && node -e \"require('fs').mkdirSync('dist',{recursive:true}); require('fs').writeFileSync('dist/.build-stamp', String(Date.now()))\"",
     "db:generate": "echo 'No database generation needed for this package'",
     "dev:watch": "npx nodemon --watch src --ext js,ts --exec \"pnpm run build\"",
-    "test": "tsc --project tsconfig.tests.json && node --test dist-tests/tests/server.test.js dist-tests/tests/cli.test.js dist-tests/tests/cli-api.test.js dist-tests/tests/agent-schema-v3.test.js dist-tests/tests/ratelimit.test.js dist-tests/tests/sequencer.test.js dist-tests/tests/config-loader.test.js dist-tests/tests/gsm7.test.js dist-tests/tests/batch-operation.test.js"
+    "test": "tsc --project tsconfig.tests.json && node --test dist-tests/tests/server.test.js dist-tests/tests/cli.test.js dist-tests/tests/cli-api.test.js dist-tests/tests/agent-schema-v3.test.js dist-tests/tests/entity-field-definition.test.js dist-tests/tests/ratelimit.test.js dist-tests/tests/sequencer.test.js dist-tests/tests/config-loader.test.js dist-tests/tests/gsm7.test.js dist-tests/tests/batch-operation.test.js"
   },
   "keywords": [
     "mcp",