@stndrds/schema 1.0.0-alpha.258 → 1.0.0-alpha.260

package/dist/index.js

@@ -3,7 +3,7 @@
 var chunkFRCDMQER_js = require('./chunk-FRCDMQER.js');
 require('./chunk-PGERPYDR.js');
 var chunkL4U5QEQL_js = require('./chunk-L4U5QEQL.js');
-var chunk44EVNHSR_js = require('./chunk-44EVNHSR.js');
+var chunkTS3PJOMZ_js = require('./chunk-TS3PJOMZ.js');
 require('./chunk-SI34M4IC.js');
 require('./chunk-YIP5FJ5H.js');
 require('./chunk-QAF3HNKQ.js');
@@ -1262,36 +1262,20 @@ var DEFAULT_ROLE_PERMISSIONS = {
 function isDefaultRole(roleName) {
   return Object.values(DEFAULT_ROLES).includes(roleName);
 }
-
-// src/standard-schema.ts
-var STANDARD_SCHEMA_VENDOR = "@stndrds/schema";
-function createStandardSchemaProps(zodSchema) {
-  return {
-    version: 1,
-    vendor: STANDARD_SCHEMA_VENDOR,
-    validate: (value) => {
-      const result = zodSchema.safeParse(value);
-      if (result.success) {
-        return { value: result.data };
-      }
-      return {
-        issues: result.error.issues.map((issue) => ({
-          message: issue.message,
-          // Zod path segments are string | number which are valid PropertyKey
-          // for Standard Schema v1 (no conversion needed)
-          path: issue.path
-        }))
-      };
-    }
-  };
-}
-function isStandardSchema(obj) {
-  return typeof obj === "object" && obj !== null && "~standard" in obj && typeof obj["~standard"] === "object" && obj["~standard"].version === 1;
-}
 var VALID_ICONS = new Set(constants.ICONS);
 var ATTRIBUTE_NAME_REGEX = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
 var MAX_NAME_LENGTH = 63;
 var MAX_LABEL_LENGTH = 128;
+function assertUniqueBy(items, getKey, buildError) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const item of items) {
+    const key = getKey(item);
+    if (seen.has(key)) {
+      throw buildError(key);
+    }
+    seen.add(key);
+  }
+}
 function validateAttributeName(name) {
   if (!name || name.length === 0) {
     throw new Error("[AttributeBuilder] Attribute name cannot be empty");
@@ -1367,6 +1351,136 @@ function validateOptions(attributeName, options) {
   }
 }
 
+// src/builders/agent-builder.ts
+var DEFAULT_AGENT_EXECUTION_CONFIG = {
+  maxConcurrentRuns: 3,
+  retryPolicy: { maxRetries: 3, backoffMs: 1e3, backoffMultiplier: 2 },
+  timeoutMs: 3e5
+};
+var AgentBuilder = class {
+  constructor(config) {
+    if (!config.name || config.name.trim().length === 0) {
+      throw new chunkTS3PJOMZ_js.ValidationError("Agent name is required", []);
+    }
+    this.bp = { name: config.name, system: true, triggers: [] };
+  }
+  description(value) {
+    this.bp.description = value;
+    return this;
+  }
+  icon(value) {
+    this.bp.icon = value;
+    return this;
+  }
+  systemPrompt(value) {
+    this.bp.systemPrompt = value;
+    return this;
+  }
+  model(provider, model, options) {
+    this.bp.model = { provider, model, ...options };
+    return this;
+  }
+  tools(names) {
+    this.bp.tools = [...names];
+    return this;
+  }
+  /** Cron schedule; `enabled` defaults to true. */
+  schedule(value) {
+    this.bp.schedule = { ...value, enabled: value.enabled ?? true };
+    return this;
+  }
+  /**
+   * Partial execution config, shallow-merged over the current config
+   * (defaulting to {@link DEFAULT_AGENT_EXECUTION_CONFIG} on the first call).
+   *
+   * The merge is shallow at the top level only: passing a partial
+   * `retryPolicy` REPLACES the whole `retryPolicy` object rather than
+   * merging its individual fields. Pass a complete `retryPolicy` if you
+   * only want to override one of its fields.
+   */
+  config(value) {
+    this.bp.config = { ...this.bp.config ?? DEFAULT_AGENT_EXECUTION_CONFIG, ...value };
+    return this;
+  }
+  delegation(value) {
+    Object.assign(this.bp, value);
+    return this;
+  }
+  /**
+   * Declare a trigger. `name` is the stable identity the boot sync uses to
+   * reconcile trigger rows; `enabled` defaults to true.
+   */
+  trigger(name, eventType, options) {
+    this.bp.triggers.push({ name, eventType, ...options, enabled: options?.enabled ?? true });
+    return this;
+  }
+  /**
+   * Marks this agent as runtime-only (system: false).
+   *
+   * ⚠️ ADVANCED USE ONLY. In production, agents declared in code are
+   * automatically system:true (immutable at runtime). Use .runtime() ONLY for:
+   *   - Test fixtures (`*.test.ts`, `tests/`)
+   *   - Seed data (`seeds/`)
+   *   - Dev fixtures (`fixtures/`)
+   *
+   * Calling .runtime() in production code creates an agent that:
+   *   - Can be modified or deleted by end users via the admin UI
+   *   - Will be picked up by `standards diff` as runtime drift
+   */
+  runtime() {
+    this.bp.system = false;
+    return this;
+  }
+  build() {
+    if (!this.bp.systemPrompt) {
+      throw new chunkTS3PJOMZ_js.ValidationError(`Agent "${this.bp.name}": systemPrompt is required`, []);
+    }
+    if (!this.bp.model) {
+      throw new chunkTS3PJOMZ_js.ValidationError(`Agent "${this.bp.name}": model is required`, []);
+    }
+    assertUniqueBy(
+      this.bp.triggers,
+      (t) => t.name,
+      (name) => new chunkTS3PJOMZ_js.ValidationError(`Agent "${this.bp.name}": duplicate trigger name "${name}"`, [])
+    );
+    return {
+      ...this.bp,
+      config: this.bp.config ?? DEFAULT_AGENT_EXECUTION_CONFIG,
+      systemPrompt: this.bp.systemPrompt,
+      model: this.bp.model
+    };
+  }
+};
+function agent(config) {
+  return new AgentBuilder(config);
+}
+
+// src/standard-schema.ts
+var STANDARD_SCHEMA_VENDOR = "@stndrds/schema";
+function createStandardSchemaProps(zodSchema) {
+  return {
+    version: 1,
+    vendor: STANDARD_SCHEMA_VENDOR,
+    validate: (value) => {
+      const result = zodSchema.safeParse(value);
+      if (result.success) {
+        return { value: result.data };
+      }
+      return {
+        issues: result.error.issues.map((issue) => ({
+          message: issue.message,
+          // Zod path segments are string | number which are valid PropertyKey
+          // for Standard Schema v1 (no conversion needed)
+          path: issue.path
+        }))
+      };
+    }
+  };
+}
+function isStandardSchema(obj) {
+  return typeof obj === "object" && obj !== null && "~standard" in obj && typeof obj["~standard"] === "object" && obj["~standard"].version === 1;
+}
+
 // src/builders/attribute-builders.ts
 function asMutableArray(arr) {
   return arr;
@@ -1381,7 +1495,7 @@ var BaseAttributeBuilder = class {
    * @see https://standardschema.dev/
    */
   get "~standard"() {
-    const zodSchema = chunk44EVNHSR_js.createAttributeValidator(this.build());
+    const zodSchema = chunkTS3PJOMZ_js.createAttributeValidator(this.build());
     return createStandardSchemaProps(zodSchema);
   }
   constructor(type, name, label) {
@@ -2133,9 +2247,9 @@ var RollupAttributeBuilder = class extends BaseAttributeBuilder {
     if (fn === "original" && targetType !== void 0 && targetType !== "select" && targetType !== "status" && targetType !== "multiselect") {
       const relation2 = this.attr.relationAttribute ?? "relation";
       const target = this.attr.targetAttribute ?? "field";
-      throw new chunk44EVNHSR_js.SchemaError(
+      throw new chunkTS3PJOMZ_js.SchemaError(
         `Rollup "${this.attr.name}": .using("original") only supports a "select", "status", or "multiselect" target, but .targetType("${targetType}") was given. To surface a plain ${targetType} value from a related record, use a formula instead \u2014 e.g. formula({ name: "${this.attr.name}", label: "\u2026" }).expression("${relation2}.${target}").`,
-        chunk44EVNHSR_js.SchemaErrorCode.VALIDATION_FAILED
+        chunkTS3PJOMZ_js.SchemaErrorCode.VALIDATION_FAILED
       );
     }
     return super.build();
@@ -2645,7 +2759,7 @@ var ObjectBuilder = class {
    * @see https://standardschema.dev/
    */
   get "~standard"() {
-    const zodSchema = chunk44EVNHSR_js.createObjectValidator(this.build());
+    const zodSchema = chunkTS3PJOMZ_js.createObjectValidator(this.build());
     return createStandardSchemaProps(zodSchema);
   }
   /**
@@ -2859,26 +2973,26 @@ var ObjectBuilder = class {
       throw new Error("[ObjectBuilder] Missing required field: label");
     }
     if (!this._labelExpression) {
-      throw new chunk44EVNHSR_js.SchemaError(
+      throw new chunkTS3PJOMZ_js.SchemaError(
         `Object "${this.obj.name}" must have a labelExpression. The labelExpression defines how records are displayed in lists and relations (e.g. "{{ name }}").`,
-        chunk44EVNHSR_js.SchemaErrorCode.VALIDATION_FAILED
+        chunkTS3PJOMZ_js.SchemaErrorCode.VALIDATION_FAILED
       );
     }
     const labelResult = labelExpressionSchema.safeParse(this._labelExpression);
     if (!labelResult.success) {
       const errorMsg = labelResult.error.issues[0]?.message ?? "Invalid labelExpression";
-      throw new chunk44EVNHSR_js.SchemaError(
+      throw new chunkTS3PJOMZ_js.SchemaError(
         `Invalid labelExpression for "${this.obj.name}": ${errorMsg}`,
-        chunk44EVNHSR_js.SchemaErrorCode.VALIDATION_FAILED
+        chunkTS3PJOMZ_js.SchemaErrorCode.VALIDATION_FAILED
       );
     }
     if (this._embeddingExpression !== void 0) {
       const embeddingResult = labelExpressionSchema.safeParse(this._embeddingExpression);
       if (!embeddingResult.success) {
         const errorMsg = embeddingResult.error.issues[0]?.message ?? "Invalid embeddingExpression";
-        throw new chunk44EVNHSR_js.SchemaError(
+        throw new chunkTS3PJOMZ_js.SchemaError(
           `Invalid embeddingExpression for "${this.obj.name}": ${errorMsg}`,
-          chunk44EVNHSR_js.SchemaErrorCode.VALIDATION_FAILED
+          chunkTS3PJOMZ_js.SchemaErrorCode.VALIDATION_FAILED
         );
       }
     }
@@ -2919,7 +3033,7 @@ var ObjectBuilder = class {
       objectNameSchema.parse(name);
     } catch (error) {
       if (error instanceof z3__default.default.ZodError) {
-        throw new chunk44EVNHSR_js.SchemaError(error.issues[0].message, chunk44EVNHSR_js.SchemaErrorCode.INVALID_OBJECT_NAME);
+        throw new chunkTS3PJOMZ_js.SchemaError(error.issues[0].message, chunkTS3PJOMZ_js.SchemaErrorCode.INVALID_OBJECT_NAME);
       }
       throw error;
     }
@@ -2930,7 +3044,7 @@ function object(config) {
 }
 function validatePresetStructure(presetId, nodes, depth) {
   const fail = (message, detail) => {
-    throw new chunk44EVNHSR_js.ValidationError(message, [
+    throw new chunkTS3PJOMZ_js.ValidationError(message, [
       { path: ["documentLayout", "presets", presetId], message: detail }
     ]);
   };
@@ -3106,19 +3220,6 @@ var RelationGroupBuilder = class {
     return this.data;
   }
 };
-function assertViewVersion(version) {
-  if (version < 1) throw new Error("View version must be >= 1");
-}
-function assertUniqueBy(items, getKey, buildError) {
-  const seen = /* @__PURE__ */ new Set();
-  for (const item of items) {
-    const key = getKey(item);
-    if (seen.has(key)) {
-      throw new Error(buildError(key));
-    }
-    seen.add(key);
-  }
-}
 function validateViewName(name, builderName, examples) {
   const viewNameSchema = z3.z.string().min(1, "View name cannot be empty").max(63, "View name is too long (max 63 characters)").regex(/^[a-z][a-z0-9-]*$/, {
     message: `Invalid view name format.
@@ -3150,15 +3251,23 @@ var TableTabConfig = class {
     return this;
   }
   /**
-   * Allow creating new records
+   * Allow creating new records.
+   *
+   * @param options.mode - Creation behavior when clicking "+": "redirect"
+   * (navigate to detail), "inline" (empty row), or "peek" (instant-create a
+   * draft and open it in the record stack side panel).
+   * @example .create() or .create({ mode: "peek" })
    */
-  create() {
+  create(options) {
     this.tabData.allowCreate = true;
+    if (options?.mode) {
+      this.tabData.createMode = options.mode;
+    }
     return this;
   }
   /**
    * Set creation behavior when clicking "+"
-   * @param mode - "redirect" (navigate to detail), "inline" (empty row), or "peek" (instant-create a draft and open it in the record stack side panel)
+   * @deprecated Use `create({ mode })` instead.
    * @example .createMode("inline") or .createMode("peek")
    */
   createMode(mode) {
@@ -3180,7 +3289,8 @@ var TableTabConfig = class {
     return this;
   }
   /**
-   * Enable all CRUD operations (create, edit, delete)
+   * Sugar for `create().edit().delete()`. Prefer the explicit methods —
+   * creation options live on `create({ mode })`.
    */
   crud() {
     this.tabData.allowCreate = true;
@@ -3584,7 +3694,6 @@ var TabBuilder = class {
 };
 var DetailViewBuilder = class {
   constructor(name, label) {
-    this._version = 1;
     validateViewName(name, "DetailViewBuilder", {
       valid: "'detail', 'list-view', 'company-detail'",
       invalid: "'Detail', 'listView', 'list_view'"
@@ -3631,17 +3740,6 @@ var DetailViewBuilder = class {
     this.data.metadata = value;
     return this;
   }
-  /**
-   * Set the schema version for this view definition.
-   * Increment when making breaking changes to force client updates.
-   * @param v - Version number (must be >= 1)
-   * @default 1
-   */
-  version(v) {
-    assertViewVersion(v);
-    this._version = v;
-    return this;
-  }
   /**
    * Configure a side panel with flat attribute fields displayed alongside tab content.
    *
@@ -3684,7 +3782,7 @@ var DetailViewBuilder = class {
     assertUniqueBy(
       this.data.tabs,
       (tab) => tab.name,
-      (name) => `[DetailViewBuilder] Duplicate tab name "${name}"`
+      (name) => new Error(`[DetailViewBuilder] Duplicate tab name "${name}"`)
     );
     const config = {
       tabs: this.data.tabs,
@@ -3699,8 +3797,7 @@ var DetailViewBuilder = class {
       type: "detail",
       config,
       default: this.data.default,
-      metadata: this.data.metadata,
-      schema_version: this._version
+      metadata: this.data.metadata
     };
   }
 };
@@ -3709,7 +3806,6 @@ function detailView(name, label) {
 }
 var ListViewBuilder = class {
   constructor(name, label) {
-    this._version = 1;
     validateViewName(name, "ListViewBuilder", {
       valid: "'default', 'list-view', 'active-contacts'",
       invalid: "'Default', 'listView', 'list_view'"
@@ -3756,17 +3852,6 @@ var ListViewBuilder = class {
     this.data.metadata = value;
     return this;
   }
-  /**
-   * Set the schema version for this view definition.
-   * Increment when making breaking changes to force client updates.
-   * @param v - Version number (must be >= 1)
-   * @default 1
-   */
-  version(v) {
-    assertViewVersion(v);
-    this._version = v;
-    return this;
-  }
   /**
    * Set base filters applied to ALL tabs (scoping, tenant, etc.)
    * @example .baseFilter({ combinator: "and", rules: [{ attribute: "tenant", operator: "is", value: "acme" }] })
@@ -3808,7 +3893,7 @@ var ListViewBuilder = class {
     assertUniqueBy(
       this.data.tabs,
       (tab) => tab.id,
-      (id) => `[ListViewBuilder] Duplicate tab id "${id}"`
+      (id) => new Error(`[ListViewBuilder] Duplicate tab id "${id}"`)
     );
     const defaultTabs = this.data.tabs.filter((t) => t.default);
     if (defaultTabs.length > 1) {
@@ -3860,8 +3945,7 @@ var ListViewBuilder = class {
       type: "list",
       config,
       default: this.data.default,
-      metadata: this.data.metadata,
-      schema_version: this._version
+      metadata: this.data.metadata
     };
   }
 };
@@ -4195,7 +4279,7 @@ function jsonFlag(name, defaultValue) {
 
 // src/feature-flags/flag-registry.ts
 function duplicateFlagError(name) {
-  return new chunk44EVNHSR_js.DuplicateError(
+  return new chunkTS3PJOMZ_js.DuplicateError(
     "feature flag",
     name,
     `Flag "${name}" is already registered. Each flag name must be unique.`
@@ -4273,7 +4357,7 @@ var FlagRegistry = class {
   getOrThrow(name) {
     const flag = this.get(name);
     if (!flag) {
-      throw new chunk44EVNHSR_js.NotFoundError(
+      throw new chunkTS3PJOMZ_js.NotFoundError(
         "Feature flag",
         name,
         void 0,
@@ -4430,19 +4514,19 @@ var FlagService = class {
    */
   async setOverride(flagName, level, value, options = {}) {
     if (!this.repository) {
-      throw new chunk44EVNHSR_js.SchemaError(
+      throw new chunkTS3PJOMZ_js.SchemaError(
         "Cannot set override: no FeatureFlagsRepository configured. Add featureFlags to your DatabaseAdapter to enable runtime overrides.",
-        chunk44EVNHSR_js.SchemaErrorCode.CONFIGURATION_REQUIRED
+        chunkTS3PJOMZ_js.SchemaErrorCode.CONFIGURATION_REQUIRED
       );
     }
     const flag = this.registry.get(flagName);
     if (flag && !flag.allowedLevels.includes(level)) {
       const message = `Flag "${flagName}" does not allow ${level}-level overrides. Allowed levels: ${flag.allowedLevels.join(", ")}`;
-      throw new chunk44EVNHSR_js.ValidationError(message, [{ path: ["level"], message }]);
+      throw new chunkTS3PJOMZ_js.ValidationError(message, [{ path: ["level"], message }]);
     }
     if (flag?.system) {
       const message = `Flag "${flagName}" is a system flag and cannot be overridden via API.`;
-      throw new chunk44EVNHSR_js.ValidationError(message, [{ path: ["flagName"], message }]);
+      throw new chunkTS3PJOMZ_js.ValidationError(message, [{ path: ["flagName"], message }]);
     }
     await this.repository.setOverride({
       flagName,
@@ -4462,9 +4546,9 @@ var FlagService = class {
    */
   async deleteOverride(flagName, level, targetId) {
     if (!this.repository) {
-      throw new chunk44EVNHSR_js.SchemaError(
+      throw new chunkTS3PJOMZ_js.SchemaError(
         "Cannot delete override: no FeatureFlagsRepository configured.",
-        chunk44EVNHSR_js.SchemaErrorCode.CONFIGURATION_REQUIRED
+        chunkTS3PJOMZ_js.SchemaErrorCode.CONFIGURATION_REQUIRED
       );
     }
     await this.repository.deleteOverride(flagName, level, targetId);
@@ -4601,7 +4685,7 @@ var NativeObjectRegistryClass = class {
     if (!object2.system) {
       const message = `[NativeObjectRegistry] Cannot register object "${object2.name}" (id: ${object2.id}): missing system flag.
 Native objects must have system=true. Did you call .runtime() on the builder? Remove that call \u2014 objects are system:true by default.`;
-      throw new chunk44EVNHSR_js.ValidationError(message, []);
+      throw new chunkTS3PJOMZ_js.ValidationError(message, []);
     }
     if (this.objects.has(object2.name)) {
       const existing = this.objects.get(object2.name);
@@ -4609,7 +4693,7 @@ Native objects must have system=true. Did you call .runtime() on the builder? Re
   - Existing: "${existing?.label}" (id: ${existing?.id})
   - New: "${object2.label}" (id: ${object2.id})
 Please use unique names for each native object.`;
-      throw new chunk44EVNHSR_js.DuplicateError("object", object2.name, message);
+      throw new chunkTS3PJOMZ_js.DuplicateError("object", object2.name, message);
     }
     this.objects.set(object2.name, cloneObjectDefinition(object2));
   }
@@ -4641,7 +4725,7 @@ Please use unique names for each native object.`;
     if (!object2) {
       const message = `[NativeObjectRegistry] Native object "${name}" not found.
 Available objects: ${this.listNames().join(", ")}`;
-      throw new chunk44EVNHSR_js.NotFoundError("Native object", name, chunk44EVNHSR_js.SchemaErrorCode.OBJECT_NOT_FOUND, message);
+      throw new chunkTS3PJOMZ_js.NotFoundError("Native object", name, chunkTS3PJOMZ_js.SchemaErrorCode.OBJECT_NOT_FOUND, message);
     }
     return object2;
   }
@@ -4702,11 +4786,45 @@ Available objects: ${this.listNames().join(", ")}`;
   }
 };
 var registry = new NativeObjectRegistryClass();
+var SKILL_CONTENT_TEMPLATE = `## Overview
+
+Describe in one or two sentences what this skill does and the outcome it produces. The agent reads this page when it uses the skill \u2014 write instructions for the agent, not documentation for people.
+
+## When to use
+
+List the situations or requests that should trigger this skill. Concrete phrases beat vague categories.
+
+- When asked to \u2026
+- When a record of \u2026 needs \u2026
+
+## Instructions
+
+Write imperative, step-by-step directions. Name the exact objects, documents, or tools involved \u2014 the agent follows these literally.
+
+1. First, \u2026
+2. Then, \u2026
+3. Finally, \u2026
+
+## Examples
+
+Show at least one concrete example of the skill applied well.
+
+**Request:** "\u2026"
+
+**Expected result:** \u2026
+
+## What to avoid
+
+- Never \u2026
+- Do not \u2026
+`;
 var SKILL_OBJECT = object({ name: "skill", label: "Skill" }).sealed().icon("sparkles").order(Number.MAX_SAFE_INTEGER).pluralLabel("Skills").labelExpression("{{ name }}").embeddingExpression("{{ name }}\n{{ description }}\n{{ content }}").attribute(text({ name: "name", label: "Name" }).maxLength(constants.SKILL_NAME_MAX_LENGTH).required()).attribute(
-  text({ name: "description", label: "Description" }).multiline().maxLength(constants.SKILL_DESCRIPTION_MAX_LENGTH).required()
-).attribute(richtext({ name: "content", label: "Content" })).build();
-var SKILL_VIEW = detailView("skill-detail", "Skill").for("skill").version(2).default().sidePanel({ attributes: ["name", "description"] }).tab("content", "Content").richtext("content").titleAttribute("name").done().build();
-var SKILL_LIST_VIEW = listView("skill-list", "Skills").for("skill").version(2).default().tab("all", "All").table().columns("name", "description").sort("name", "asc").build();
+  text({ name: "description", label: "Description" }).multiline().maxLength(constants.SKILL_DESCRIPTION_MAX_LENGTH).required().placeholder(
+    'What this skill does and when to use it \u2014 e.g. "Drafts replies to customer complaints. Use when asked to answer an unhappy customer."'
+  )
+).attribute(richtext({ name: "content", label: "Content" }).defaultValue(SKILL_CONTENT_TEMPLATE)).build();
+var SKILL_VIEW = detailView("skill-detail", "Skill").for("skill").default().sidePanel({ attributes: ["name", "description"] }).tab("content", "Content").richtext("content").titleAttribute("name").done().build();
+var SKILL_LIST_VIEW = listView("skill-list", "Skills").for("skill").default().tab("all", "All").table().columns("name", "description").sort("name", "asc").build();
 var MEMORY_OBJECT = object({ name: "memory", label: "Memory" }).sealed().icon("database").order(Number.MAX_SAFE_INTEGER).pluralLabel("Memories").labelExpression("{{ name }}").embeddingExpression("{{ name }}\n{{ description }}\n{{ content }}").attribute(text({ name: "name", label: "Name" }).maxLength(constants.MEMORY_NAME_MAX_LENGTH).required()).attribute(
   text({ name: "description", label: "Description" }).multiline().maxLength(constants.MEMORY_DESCRIPTION_MAX_LENGTH).required()
 ).attribute(text({ name: "content", label: "Content" }).multiline()).attribute(
@@ -4746,7 +4864,7 @@ var ViewRegistry = class {
     const key = this.makeKey(view.object, view.name, view.type);
     if (this.views.has(key)) {
       const message = `[ViewRegistry] Duplicate view: "${view.name}" (${view.type}) for object "${view.object}"`;
-      throw new chunk44EVNHSR_js.DuplicateError("view", key, message);
+      throw new chunkTS3PJOMZ_js.DuplicateError("view", key, message);
     }
     const storedView = cloneViewDefinition(view);
     this.views.set(key, storedView);
@@ -4791,7 +4909,7 @@ var ViewRegistry = class {
       const availableNames = available.map((v) => `${v.name} (${v.type})`).join(", ") || "(none)";
       const message = `[ViewRegistry] View "${viewName}" not found for object "${objectName}".
 Available views: ${availableNames}`;
-      throw new chunk44EVNHSR_js.NotFoundError("View", `${objectName}:${viewName}`, void 0, message);
+      throw new chunkTS3PJOMZ_js.NotFoundError("View", `${objectName}:${viewName}`, void 0, message);
     }
     return view;
   }
@@ -4961,8 +5079,7 @@ function generateDefaultDetailView(object2, options = {}) {
     object: object2.name,
     type: "detail",
     config,
-    default: true,
-    schema_version: 1
+    default: true
   };
 }
 function generateDefaultListView(object2, options = {}) {
@@ -4989,8 +5106,7 @@ function generateDefaultListView(object2, options = {}) {
     object: object2.name,
     type: "list",
     config,
-    default: true,
-    schema_version: 1
+    default: true
   };
 }
 
@@ -5099,7 +5215,7 @@ var FormRegistry = class {
     const forms = Array.isArray(formOrForms) ? formOrForms : [formOrForms];
     for (const f of forms) {
       if (this.forms.has(f.name)) {
-        throw new chunk44EVNHSR_js.DuplicateError("form", f.name, `[FormRegistry] Duplicate form: "${f.name}"`);
+        throw new chunkTS3PJOMZ_js.DuplicateError("form", f.name, `[FormRegistry] Duplicate form: "${f.name}"`);
       }
       this.forms.set(f.name, cloneFormDefinition(f));
     }
@@ -6986,7 +7102,7 @@ function assertOperatorForType(operator, type, context) {
   if (!ops?.includes(operator)) {
     const validList = ops?.length ? ops.join(", ") : "(no operators registered for this type)";
     const summary = `Operator "${operator}" is not valid for ${context} type "${type}". Valid operators: ${validList}.`;
-    throw new chunk44EVNHSR_js.ValidationError(summary, [
+    throw new chunkTS3PJOMZ_js.ValidationError(summary, [
       {
         path: ["operator"],
         message: summary
@@ -7002,7 +7118,7 @@ function assertRelativeDateValue(rule) {
   const valid = typeof v === "object" && v !== null && typeof v.amount === "number" && Number.isFinite(v.amount) && v.amount > 0 && typeof v.unit === "string" && RELATIVE_DATE_UNITS.has(v.unit) && typeof v.direction === "string" && RELATIVE_DATE_DIRECTIONS.has(v.direction);
   if (!valid) {
     const m = `Operator "is_within" requires a relative-date value { amount: positive number, unit: days|weeks|months|years, direction: past|future }`;
-    throw new chunk44EVNHSR_js.ValidationError(m, [{ path: ["value"], message: m }]);
+    throw new chunkTS3PJOMZ_js.ValidationError(m, [{ path: ["value"], message: m }]);
   }
 }
 function assertDynamicValueForAttribute(rule, attrType) {
@@ -7010,34 +7126,34 @@ function assertDynamicValueForAttribute(rule, attrType) {
   const v = rule.value;
   if (v.dynamic === "actor" && attrType !== "user") {
     const m = `actor token (@me) is only valid on user attributes, not "${attrType}"`;
-    throw new chunk44EVNHSR_js.ValidationError(m, [{ path: ["value"], message: m }]);
+    throw new chunkTS3PJOMZ_js.ValidationError(m, [{ path: ["value"], message: m }]);
   }
   if (v.dynamic === "date" && attrType !== "date") {
     const m = `date token (@today/@now) is only valid on date attributes, not "${attrType}"`;
-    throw new chunk44EVNHSR_js.ValidationError(m, [{ path: ["value"], message: m }]);
+    throw new chunkTS3PJOMZ_js.ValidationError(m, [{ path: ["value"], message: m }]);
   }
 }
 function validateQualifiedRule(rule, context) {
   const rootAttr = context.attributes.find((a) => a.name === rule.attribute);
   const systemOps = SYSTEM_FILTER_OPERATORS[rule.attribute];
   if (!(rootAttr || systemOps)) {
-    throw new chunk44EVNHSR_js.ValidationError(`Unknown attribute: ${rule.attribute}`, [
+    throw new chunkTS3PJOMZ_js.ValidationError(`Unknown attribute: ${rule.attribute}`, [
       { path: ["attribute"], message: `Unknown attribute: ${rule.attribute}` }
     ]);
   }
   if (rule.quantifier !== void 0 && !rule.property) {
     const m = `quantifier is only valid on qualified edge rules (set "property")`;
-    throw new chunk44EVNHSR_js.ValidationError(m, [{ path: ["quantifier"], message: m }]);
+    throw new chunkTS3PJOMZ_js.ValidationError(m, [{ path: ["quantifier"], message: m }]);
   }
   if (!rootAttr) {
     if (rule.property) {
-      throw new chunk44EVNHSR_js.ValidationError(`Cannot qualify system attribute "${rule.attribute}"`, [
+      throw new chunkTS3PJOMZ_js.ValidationError(`Cannot qualify system attribute "${rule.attribute}"`, [
         { path: ["property"], message: `"${rule.attribute}" is a system column, not a reference` }
       ]);
     }
     if (!systemOps.includes(rule.operator)) {
       const summary = `Operator "${rule.operator}" is not valid for system attribute "${rule.attribute}". Valid operators: ${systemOps.join(", ")}.`;
-      throw new chunk44EVNHSR_js.ValidationError(summary, [{ path: ["operator"], message: summary }]);
+      throw new chunkTS3PJOMZ_js.ValidationError(summary, [{ path: ["operator"], message: summary }]);
     }
     assertRelativeDateValue(rule);
     return;
@@ -7048,25 +7164,25 @@ function validateQualifiedRule(rule, context) {
     if (!ops.includes(rule.operator)) {
       const validList = ops.length ? ops.join(", ") : "(not filterable)";
       const summary = `Operator "${rule.operator}" is not valid for attribute "${rootAttr.name}". Valid operators: ${validList}.`;
-      throw new chunk44EVNHSR_js.ValidationError(summary, [{ path: ["operator"], message: summary }]);
+      throw new chunkTS3PJOMZ_js.ValidationError(summary, [{ path: ["operator"], message: summary }]);
     }
     assertRelativeDateValue(rule);
     return;
   }
   if (!REFERENCE_TYPES.has(rootAttr.type)) {
-    throw new chunk44EVNHSR_js.ValidationError(`Cannot qualify ${rootAttr.type} attribute "${rule.attribute}"`, [
+    throw new chunkTS3PJOMZ_js.ValidationError(`Cannot qualify ${rootAttr.type} attribute "${rule.attribute}"`, [
       { path: ["property"], message: `Attribute "${rule.attribute}" is not a reference type` }
     ]);
   }
   const propSchema = rootAttr.properties;
   if (!propSchema) {
-    throw new chunk44EVNHSR_js.ValidationError(`Attribute "${rule.attribute}" has no qualifyWith schema`, [
+    throw new chunkTS3PJOMZ_js.ValidationError(`Attribute "${rule.attribute}" has no qualifyWith schema`, [
       { path: ["property"], message: `"${rule.attribute}" has no qualifyWith` }
     ]);
   }
   const propDef = propSchema.definitions.find((p) => p.name === rule.property);
   if (!propDef) {
-    throw new chunk44EVNHSR_js.ValidationError(
+    throw new chunkTS3PJOMZ_js.ValidationError(
       `Property "${rule.property}" not defined on "${rule.attribute}".qualifyWith()`,
       [{ path: ["property"], message: `Unknown property: ${rule.property}` }]
     );
@@ -7082,6 +7198,49 @@ var CONNECTOR_CALLBACK_PARAM = {
   provider: "connector_provider"
 };
 
+// src/utils/canonical-json.ts
+function canonicalStringify(value) {
+  const seen = /* @__PURE__ */ new Set();
+  function encode(v) {
+    if (v === null) return "null";
+    switch (typeof v) {
+      case "string":
+      case "number":
+      case "boolean":
+        return JSON.stringify(v);
+      case "undefined":
+        return void 0;
+      case "object":
+        break;
+      default:
+        throw new chunkTS3PJOMZ_js.ValidationError(`Cannot canonicalize value of type ${typeof v}`, []);
+    }
+    const obj = v;
+    if (seen.has(obj)) throw new chunkTS3PJOMZ_js.ValidationError("Cannot canonicalize circular structure", []);
+    seen.add(obj);
+    try {
+      if (Array.isArray(obj)) return `[${obj.map((e) => encode(e) ?? "null").join(",")}]`;
+      const entries = Object.entries(obj).map(([k, val]) => [k, encode(val)]).filter((pair) => pair[1] !== void 0).sort(([a], [b]) => a < b ? -1 : 1);
+      return `{${entries.map(([k, val]) => `${JSON.stringify(k)}:${val}`).join(",")}}`;
+    } finally {
+      seen.delete(obj);
+    }
+  }
+  return encode(value) ?? "null";
+}
+
+// src/utils/view-sync-payload.ts
+function viewSyncPayload(view) {
+  return {
+    label: view.label,
+    description: view.description ?? null,
+    icon: view.icon ?? null,
+    config: view.config,
+    default: view.default ?? false,
+    metadata: view.metadata ?? null
+  };
+}
+
 Object.defineProperty(exports, "asTenantId", {
   enumerable: true,
   get: function () { return chunkFRCDMQER_js.asTenantId; }
@@ -7116,175 +7275,175 @@ Object.defineProperty(exports, "parseComputedFormula", {
 });
 Object.defineProperty(exports, "AccessDeniedError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.AccessDeniedError; }
+  get: function () { return chunkTS3PJOMZ_js.AccessDeniedError; }
 });
 Object.defineProperty(exports, "AttributeInUseError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.AttributeInUseError; }
+  get: function () { return chunkTS3PJOMZ_js.AttributeInUseError; }
 });
 Object.defineProperty(exports, "AttributeNotFoundError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.AttributeNotFoundError; }
+  get: function () { return chunkTS3PJOMZ_js.AttributeNotFoundError; }
 });
 Object.defineProperty(exports, "ChangeTypeNotSupportedError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.ChangeTypeNotSupportedError; }
+  get: function () { return chunkTS3PJOMZ_js.ChangeTypeNotSupportedError; }
 });
 Object.defineProperty(exports, "ConcurrentModificationError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.ConcurrentModificationError; }
+  get: function () { return chunkTS3PJOMZ_js.ConcurrentModificationError; }
 });
 Object.defineProperty(exports, "DestructiveSyncNotAllowedError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.DestructiveSyncNotAllowedError; }
+  get: function () { return chunkTS3PJOMZ_js.DestructiveSyncNotAllowedError; }
 });
 Object.defineProperty(exports, "DuplicateError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.DuplicateError; }
+  get: function () { return chunkTS3PJOMZ_js.DuplicateError; }
 });
 Object.defineProperty(exports, "ForbiddenError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.ForbiddenError; }
+  get: function () { return chunkTS3PJOMZ_js.ForbiddenError; }
 });
 Object.defineProperty(exports, "MemoryNotFoundError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.MemoryNotFoundError; }
+  get: function () { return chunkTS3PJOMZ_js.MemoryNotFoundError; }
 });
 Object.defineProperty(exports, "MigrationTimeoutError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.MigrationTimeoutError; }
+  get: function () { return chunkTS3PJOMZ_js.MigrationTimeoutError; }
 });
 Object.defineProperty(exports, "NotFoundError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.NotFoundError; }
+  get: function () { return chunkTS3PJOMZ_js.NotFoundError; }
 });
 Object.defineProperty(exports, "NotImplementedError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.NotImplementedError; }
+  get: function () { return chunkTS3PJOMZ_js.NotImplementedError; }
 });
 Object.defineProperty(exports, "ObjectNotFoundError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.ObjectNotFoundError; }
+  get: function () { return chunkTS3PJOMZ_js.ObjectNotFoundError; }
 });
 Object.defineProperty(exports, "ObjectReferencedError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.ObjectReferencedError; }
+  get: function () { return chunkTS3PJOMZ_js.ObjectReferencedError; }
 });
 Object.defineProperty(exports, "OrphanSystemAttributeError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.OrphanSystemAttributeError; }
+  get: function () { return chunkTS3PJOMZ_js.OrphanSystemAttributeError; }
 });
 Object.defineProperty(exports, "ProtectedResourceError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.ProtectedResourceError; }
+  get: function () { return chunkTS3PJOMZ_js.ProtectedResourceError; }
 });
 Object.defineProperty(exports, "ProtectedRoleError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.ProtectedRoleError; }
+  get: function () { return chunkTS3PJOMZ_js.ProtectedRoleError; }
 });
 Object.defineProperty(exports, "RecordNotFoundError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.RecordNotFoundError; }
+  get: function () { return chunkTS3PJOMZ_js.RecordNotFoundError; }
 });
 Object.defineProperty(exports, "RecordReferencedError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.RecordReferencedError; }
+  get: function () { return chunkTS3PJOMZ_js.RecordReferencedError; }
 });
 Object.defineProperty(exports, "RepositoryError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.RepositoryError; }
+  get: function () { return chunkTS3PJOMZ_js.RepositoryError; }
 });
 Object.defineProperty(exports, "RoleNotFoundError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.RoleNotFoundError; }
+  get: function () { return chunkTS3PJOMZ_js.RoleNotFoundError; }
 });
 Object.defineProperty(exports, "SchemaError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.SchemaError; }
+  get: function () { return chunkTS3PJOMZ_js.SchemaError; }
 });
 Object.defineProperty(exports, "SchemaErrorCode", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.SchemaErrorCode; }
+  get: function () { return chunkTS3PJOMZ_js.SchemaErrorCode; }
 });
 Object.defineProperty(exports, "SearchBackendError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.SearchBackendError; }
+  get: function () { return chunkTS3PJOMZ_js.SearchBackendError; }
 });
 Object.defineProperty(exports, "StorageError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.StorageError; }
+  get: function () { return chunkTS3PJOMZ_js.StorageError; }
 });
 Object.defineProperty(exports, "SyncCascadeError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.SyncCascadeError; }
+  get: function () { return chunkTS3PJOMZ_js.SyncCascadeError; }
 });
 Object.defineProperty(exports, "SyncConflictError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.SyncConflictError; }
+  get: function () { return chunkTS3PJOMZ_js.SyncConflictError; }
 });
 Object.defineProperty(exports, "SyncError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.SyncError; }
+  get: function () { return chunkTS3PJOMZ_js.SyncError; }
 });
 Object.defineProperty(exports, "SystemEntityImmutableError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.SystemEntityImmutableError; }
+  get: function () { return chunkTS3PJOMZ_js.SystemEntityImmutableError; }
 });
 Object.defineProperty(exports, "ValidationError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.ValidationError; }
+  get: function () { return chunkTS3PJOMZ_js.ValidationError; }
 });
 Object.defineProperty(exports, "createFormAttributeValidator", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.createFormAttributeValidator; }
+  get: function () { return chunkTS3PJOMZ_js.createFormAttributeValidator; }
 });
 Object.defineProperty(exports, "isAttributeInUseError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.isAttributeInUseError; }
+  get: function () { return chunkTS3PJOMZ_js.isAttributeInUseError; }
 });
 Object.defineProperty(exports, "isNotFoundError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.isNotFoundError; }
+  get: function () { return chunkTS3PJOMZ_js.isNotFoundError; }
 });
 Object.defineProperty(exports, "isObjectReferencedError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.isObjectReferencedError; }
+  get: function () { return chunkTS3PJOMZ_js.isObjectReferencedError; }
 });
 Object.defineProperty(exports, "isProtectedResourceError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.isProtectedResourceError; }
+  get: function () { return chunkTS3PJOMZ_js.isProtectedResourceError; }
 });
 Object.defineProperty(exports, "isRecordReferencedError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.isRecordReferencedError; }
+  get: function () { return chunkTS3PJOMZ_js.isRecordReferencedError; }
 });
 Object.defineProperty(exports, "isSchemaError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.isSchemaError; }
+  get: function () { return chunkTS3PJOMZ_js.isSchemaError; }
 });
 Object.defineProperty(exports, "isValidationError", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.isValidationError; }
+  get: function () { return chunkTS3PJOMZ_js.isValidationError; }
 });
 Object.defineProperty(exports, "rejectUnknownAttributesOrThrow", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.rejectUnknownAttributesOrThrow; }
+  get: function () { return chunkTS3PJOMZ_js.rejectUnknownAttributesOrThrow; }
 });
 Object.defineProperty(exports, "validateDraft", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.validateDraft; }
+  get: function () { return chunkTS3PJOMZ_js.validateDraft; }
 });
 Object.defineProperty(exports, "validateDraftOrThrow", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.validateDraftOrThrow; }
+  get: function () { return chunkTS3PJOMZ_js.validateDraftOrThrow; }
 });
 Object.defineProperty(exports, "validateObject", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.validateObject; }
+  get: function () { return chunkTS3PJOMZ_js.validateObject; }
 });
 Object.defineProperty(exports, "validateObjectOrThrow", {
   enumerable: true,
-  get: function () { return chunk44EVNHSR_js.validateObjectOrThrow; }
+  get: function () { return chunkTS3PJOMZ_js.validateObjectOrThrow; }
 });
 Object.defineProperty(exports, "DEFAULT_VALIDATION_MESSAGES", {
   enumerable: true,
@@ -7302,6 +7461,7 @@ exports.AUDIT_ACTIONS = AUDIT_ACTIONS;
 exports.AUDIT_RESOURCE_TYPES = AUDIT_RESOURCE_TYPES;
 exports.AUTOFILL_ELIGIBLE_TYPES = AUTOFILL_ELIGIBLE_TYPES;
 exports.ActivityTabConfig = ActivityTabConfig;
+exports.AgentBuilder = AgentBuilder;
 exports.BEHAVIOR_PROPERTIES = BEHAVIOR_PROPERTIES;
 exports.BROWSER_PREVIEW_STATUSES = BROWSER_PREVIEW_STATUSES;
 exports.COMPUTED_FUNCTIONS = COMPUTED_FUNCTIONS;
@@ -7311,6 +7471,7 @@ exports.CONNECTOR_CALLBACK_PARAM = CONNECTOR_CALLBACK_PARAM;
 exports.ComputedFormulaCompileError = ComputedFormulaCompileError;
 exports.CustomTabConfig = CustomTabConfig;
 exports.DB_COLUMN_FIELDS = DB_COLUMN_FIELDS;
+exports.DEFAULT_AGENT_EXECUTION_CONFIG = DEFAULT_AGENT_EXECUTION_CONFIG;
 exports.DEFAULT_ROLES = DEFAULT_ROLES;
 exports.DEFAULT_ROLE_DESCRIPTIONS = DEFAULT_ROLE_DESCRIPTIONS;
 exports.DEFAULT_ROLE_LABELS = DEFAULT_ROLE_LABELS;
@@ -7375,6 +7536,7 @@ exports.TableTabConfig = TableTabConfig;
 exports.USER_STATUSES = USER_STATUSES;
 exports.accessLevelToActions = accessLevelToActions;
 exports.actionsToAccessLevel = actionsToAccessLevel;
+exports.agent = agent;
 exports.applyPipes = applyPipes;
 exports.applyRelationProps = applyRelationProps;
 exports.assertAcyclicComputedDependencies = assertAcyclicComputedDependencies;
@@ -7382,6 +7544,7 @@ exports.assertLiveStreamCursor = assertLiveStreamCursor;
 exports.booleanFlag = booleanFlag;
 exports.buildPropertySchema = buildPropertySchema;
 exports.buildQualifiedAttribute = buildQualifiedAttribute;
+exports.canonicalStringify = canonicalStringify;
 exports.checkbox = checkbox;
 exports.compareLiveStreamCursors = compareLiveStreamCursors;
 exports.compileComputedFormula = compileComputedFormula;
@@ -7500,3 +7663,4 @@ exports.user = user;
 exports.validateAttributeName = validateAttributeName;
 exports.validateQualifiedRule = validateQualifiedRule;
 exports.viewRegistry = viewRegistry;
+exports.viewSyncPayload = viewSyncPayload;