@objectstack/spec 3.3.0 → 4.0.0

package/dist/index.js

@@ -1075,6 +1075,11 @@ __export(data_exports, {
   DriverOptionsSchema: () => DriverOptionsSchema,
   DriverType: () => DriverType,
   ESignatureConfigSchema: () => ESignatureConfigSchema,
+  EngineAggregateOptionsSchema: () => EngineAggregateOptionsSchema,
+  EngineCountOptionsSchema: () => EngineCountOptionsSchema,
+  EngineDeleteOptionsSchema: () => EngineDeleteOptionsSchema,
+  EngineQueryOptionsSchema: () => EngineQueryOptionsSchema,
+  EngineUpdateOptionsSchema: () => EngineUpdateOptionsSchema,
   EqualityOperatorSchema: () => EqualityOperatorSchema,
   ExternalDataSourceSchema: () => ExternalDataSourceSchema,
   ExternalFieldMappingSchema: () => ExternalFieldMappingSchema,
@@ -2356,33 +2361,47 @@ var BaseEngineOptionsSchema = zod.z.object({
   /** Execution context (identity, tenant, transaction) */
   context: ExecutionContextSchema.optional()
 });
+var EngineQueryOptionsSchema = BaseEngineOptionsSchema.extend({
+  /** Filter conditions (WHERE) — standard QueryAST `where` */
+  where: zod.z.union([zod.z.record(zod.z.string(), zod.z.unknown()), FilterConditionSchema]).optional(),
+  /** Fields to retrieve (SELECT) — standard QueryAST `fields` */
+  fields: zod.z.array(FieldNodeSchema).optional(),
+  /** Sorting instructions (ORDER BY) — standard QueryAST `orderBy` */
+  orderBy: zod.z.array(SortNodeSchema).optional(),
+  /** Max records to return (LIMIT) */
+  limit: zod.z.number().optional(),
+  /** Records to skip (OFFSET) — standard QueryAST `offset` */
+  offset: zod.z.number().optional(),
+  /** Alias for limit (OData compatibility) */
+  top: zod.z.number().optional(),
+  /** Cursor for keyset pagination */
+  cursor: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
+  /** Full-text search configuration */
+  search: FullTextSearchSchema.optional(),
+  /**
+   * Recursive relation loading map (expand).
+   * 
+   * Keys are lookup/master_detail field names; values are nested QueryAST
+   * objects that control select, filter, sort, and further expansion on
+   * the related object. The engine resolves expand via batch $in queries
+   * (driver-agnostic) with a default max depth of 3.
+   */
+  expand: zod.z.lazy(() => zod.z.record(zod.z.string(), QuerySchema)).optional(),
+  /** SELECT DISTINCT flag */
+  distinct: zod.z.boolean().optional()
+}).describe("QueryAST-aligned query options for IDataEngine.find() operations");
 var DataEngineQueryOptionsSchema = BaseEngineOptionsSchema.extend({
-  /** Filter conditions (WHERE) */
+  /** @deprecated Use `where` (EngineQueryOptionsSchema) */
   filter: DataEngineFilterSchema.optional(),
-  /** Fields to select (SELECT) */
+  /** @deprecated Use `fields` (EngineQueryOptionsSchema) */
   select: zod.z.array(zod.z.string()).optional(),
-  /** Sort order (ORDER BY) */
+  /** @deprecated Use `orderBy` (EngineQueryOptionsSchema) */
   sort: DataEngineSortSchema.optional(),
-  /** Limit number of results (LIMIT) */
   limit: zod.z.number().int().min(1).optional(),
-  /** Skip number of results (OFFSET) */
+  /** @deprecated Use `offset` (EngineQueryOptionsSchema) */
   skip: zod.z.number().int().min(0).optional(),
-  /** 
-   * Maximum number of results (OData style)
-   * Takes precedence over limit if both specified
-   */
   top: zod.z.number().int().min(1).optional(),
-  /**
-   * Include related records ($expand / Populate)
-   * 
-   * List of relationship field names (lookup or master_detail) to expand.
-   * The engine resolves these by batch-loading referenced records using $in
-   * queries and replacing foreign key IDs with full objects in the result.
-   * 
-   * This is driver-agnostic — expand is handled at the engine layer via
-   * secondary queries, not via SQL JOINs or driver-specific features.
-   * Fields without a valid `reference` in the schema are silently skipped.
-   */
+  /** @deprecated Use `expand` (EngineQueryOptionsSchema) */
   populate: zod.z.array(zod.z.string()).optional()
 }).describe("Query options for IDataEngine.find() operations");
 var DataEngineInsertOptionsSchema = BaseEngineOptionsSchema.extend({
@@ -2393,44 +2412,51 @@ var DataEngineInsertOptionsSchema = BaseEngineOptionsSchema.extend({
    */
   returning: zod.z.boolean().default(true).optional()
 }).describe("Options for DataEngine.insert operations");
+var EngineUpdateOptionsSchema = BaseEngineOptionsSchema.extend({
+  /** Filter conditions to identify records to update — standard QueryAST `where` */
+  where: zod.z.union([zod.z.record(zod.z.string(), zod.z.unknown()), FilterConditionSchema]).optional(),
+  /** Perform an upsert? If true, insert if not found. */
+  upsert: zod.z.boolean().default(false).optional(),
+  /** Update multiple records? If false, only the first match is updated. Default: false */
+  multi: zod.z.boolean().default(false).optional(),
+  /** Return the updated record(s)? Default: false (returns update count/status) */
+  returning: zod.z.boolean().default(false).optional()
+}).describe("QueryAST-aligned options for DataEngine.update operations");
 var DataEngineUpdateOptionsSchema = BaseEngineOptionsSchema.extend({
-  /** Filter conditions to identify records to update */
+  /** @deprecated Use `where` (EngineUpdateOptionsSchema) */
   filter: DataEngineFilterSchema.optional(),
-  /** 
-   * Perform an upsert? 
-   * If true, insert if not found.
-   */
   upsert: zod.z.boolean().default(false).optional(),
-  /**
-   * Update multiple records?
-   * If false, only the first match is updated.
-   * Default: false
-   */
   multi: zod.z.boolean().default(false).optional(),
-  /** 
-   * Return the updated record(s)? 
-   * Default: false (returns update count/status)
-   */
   returning: zod.z.boolean().default(false).optional()
 }).describe("Options for DataEngine.update operations");
+var EngineDeleteOptionsSchema = BaseEngineOptionsSchema.extend({
+  /** Filter conditions to identify records to delete — standard QueryAST `where` */
+  where: zod.z.union([zod.z.record(zod.z.string(), zod.z.unknown()), FilterConditionSchema]).optional(),
+  /** Delete multiple records? If false, only the first match is deleted. Default: false */
+  multi: zod.z.boolean().default(false).optional()
+}).describe("QueryAST-aligned options for DataEngine.delete operations");
 var DataEngineDeleteOptionsSchema = BaseEngineOptionsSchema.extend({
-  /** Filter conditions to identify records to delete */
+  /** @deprecated Use `where` (EngineDeleteOptionsSchema) */
   filter: DataEngineFilterSchema.optional(),
-  /**
-   * Delete multiple records?
-   * If false, only the first match is deleted.
-   * Default: false
-   */
   multi: zod.z.boolean().default(false).optional()
 }).describe("Options for DataEngine.delete operations");
+var EngineAggregateOptionsSchema = BaseEngineOptionsSchema.extend({
+  /** Filter conditions (WHERE) — standard QueryAST `where` */
+  where: zod.z.union([zod.z.record(zod.z.string(), zod.z.unknown()), FilterConditionSchema]).optional(),
+  /** Group By fields */
+  groupBy: zod.z.array(zod.z.string()).optional(),
+  /** 
+   * Aggregation definitions — uses standard AggregationNodeSchema (`function` key).
+   * e.g. [{ function: 'sum', field: 'amount', alias: 'total' }]
+   */
+  aggregations: zod.z.array(AggregationNodeSchema).optional()
+}).describe("QueryAST-aligned options for DataEngine.aggregate operations");
 var DataEngineAggregateOptionsSchema = BaseEngineOptionsSchema.extend({
-  /** Filter conditions (WHERE) */
+  /** @deprecated Use `where` (EngineAggregateOptionsSchema) */
   filter: DataEngineFilterSchema.optional(),
-  /** Group By fields */
   groupBy: zod.z.array(zod.z.string()).optional(),
   /** 
-   * Aggregation definitions 
-   * e.g. [{ field: 'amount', method: 'sum', alias: 'total' }]
+   * @deprecated Use `EngineAggregateOptionsSchema` with standard AggregationNodeSchema (`function` key).
    */
   aggregations: zod.z.array(zod.z.object({
     field: zod.z.string(),
@@ -2438,28 +2464,47 @@ var DataEngineAggregateOptionsSchema = BaseEngineOptionsSchema.extend({
     alias: zod.z.string().optional()
   })).optional()
 }).describe("Options for DataEngine.aggregate operations");
+var EngineCountOptionsSchema = BaseEngineOptionsSchema.extend({
+  /** Filter conditions — standard QueryAST `where` */
+  where: zod.z.union([zod.z.record(zod.z.string(), zod.z.unknown()), FilterConditionSchema]).optional()
+}).describe("QueryAST-aligned options for DataEngine.count operations");
 var DataEngineCountOptionsSchema = BaseEngineOptionsSchema.extend({
-  /** Filter conditions */
+  /** @deprecated Use `where` (EngineCountOptionsSchema) */
   filter: DataEngineFilterSchema.optional()
 }).describe("Options for DataEngine.count operations");
 var DataEngineContractSchema = zod.z.object({
-  find: zod.z.function().input(zod.z.tuple([zod.z.string(), DataEngineQueryOptionsSchema.optional()])).output(zod.z.promise(zod.z.array(zod.z.unknown()))),
-  findOne: zod.z.function().input(zod.z.tuple([zod.z.string(), DataEngineQueryOptionsSchema.optional()])).output(zod.z.promise(zod.z.unknown())),
+  find: zod.z.function().input(zod.z.tuple([zod.z.string(), EngineQueryOptionsSchema.optional()])).output(zod.z.promise(zod.z.array(zod.z.unknown()))),
+  findOne: zod.z.function().input(zod.z.tuple([zod.z.string(), EngineQueryOptionsSchema.optional()])).output(zod.z.promise(zod.z.unknown())),
   insert: zod.z.function().input(zod.z.tuple([zod.z.string(), zod.z.union([zod.z.record(zod.z.string(), zod.z.unknown()), zod.z.array(zod.z.record(zod.z.string(), zod.z.unknown()))]), DataEngineInsertOptionsSchema.optional()])).output(zod.z.promise(zod.z.unknown())),
-  update: zod.z.function().input(zod.z.tuple([zod.z.string(), zod.z.record(zod.z.string(), zod.z.unknown()), DataEngineUpdateOptionsSchema.optional()])).output(zod.z.promise(zod.z.unknown())),
-  delete: zod.z.function().input(zod.z.tuple([zod.z.string(), DataEngineDeleteOptionsSchema.optional()])).output(zod.z.promise(zod.z.unknown())),
-  count: zod.z.function().input(zod.z.tuple([zod.z.string(), DataEngineCountOptionsSchema.optional()])).output(zod.z.promise(zod.z.number())),
-  aggregate: zod.z.function().input(zod.z.tuple([zod.z.string(), DataEngineAggregateOptionsSchema])).output(zod.z.promise(zod.z.array(zod.z.unknown())))
+  update: zod.z.function().input(zod.z.tuple([zod.z.string(), zod.z.record(zod.z.string(), zod.z.unknown()), EngineUpdateOptionsSchema.optional()])).output(zod.z.promise(zod.z.unknown())),
+  delete: zod.z.function().input(zod.z.tuple([zod.z.string(), EngineDeleteOptionsSchema.optional()])).output(zod.z.promise(zod.z.unknown())),
+  count: zod.z.function().input(zod.z.tuple([zod.z.string(), EngineCountOptionsSchema.optional()])).output(zod.z.promise(zod.z.number())),
+  aggregate: zod.z.function().input(zod.z.tuple([zod.z.string(), EngineAggregateOptionsSchema])).output(zod.z.promise(zod.z.array(zod.z.unknown())))
 }).describe("Standard Data Engine Contract");
+var RpcLegacyFilterMixin = {
+  /** @deprecated Use `where` */
+  filter: DataEngineFilterSchema.optional()
+};
+var RpcQueryOptionsSchema = EngineQueryOptionsSchema.extend({
+  ...RpcLegacyFilterMixin,
+  /** @deprecated Use `fields` */
+  select: zod.z.array(zod.z.string()).optional(),
+  /** @deprecated Use `orderBy` */
+  sort: DataEngineSortSchema.optional(),
+  /** @deprecated Use `offset` */
+  skip: zod.z.number().int().min(0).optional(),
+  /** @deprecated Use `expand` */
+  populate: zod.z.array(zod.z.string()).optional()
+});
 var DataEngineFindRequestSchema = zod.z.object({
   method: zod.z.literal("find"),
   object: zod.z.string(),
-  query: DataEngineQueryOptionsSchema.optional()
+  query: RpcQueryOptionsSchema.optional()
 });
 var DataEngineFindOneRequestSchema = zod.z.object({
   method: zod.z.literal("findOne"),
   object: zod.z.string(),
-  query: DataEngineQueryOptionsSchema.optional()
+  query: RpcQueryOptionsSchema.optional()
 });
 var DataEngineInsertRequestSchema = zod.z.object({
   method: zod.z.literal("insert"),
@@ -2471,24 +2516,24 @@ var DataEngineUpdateRequestSchema = zod.z.object({
   method: zod.z.literal("update"),
   object: zod.z.string(),
   data: zod.z.record(zod.z.string(), zod.z.unknown()),
-  id: zod.z.union([zod.z.string(), zod.z.number()]).optional().describe("ID for single update, or use filter in options"),
-  options: DataEngineUpdateOptionsSchema.optional()
+  id: zod.z.union([zod.z.string(), zod.z.number()]).optional().describe("ID for single update, or use where in options"),
+  options: EngineUpdateOptionsSchema.extend(RpcLegacyFilterMixin).optional()
 });
 var DataEngineDeleteRequestSchema = zod.z.object({
   method: zod.z.literal("delete"),
   object: zod.z.string(),
-  id: zod.z.union([zod.z.string(), zod.z.number()]).optional().describe("ID for single delete, or use filter in options"),
-  options: DataEngineDeleteOptionsSchema.optional()
+  id: zod.z.union([zod.z.string(), zod.z.number()]).optional().describe("ID for single delete, or use where in options"),
+  options: EngineDeleteOptionsSchema.extend(RpcLegacyFilterMixin).optional()
 });
 var DataEngineCountRequestSchema = zod.z.object({
   method: zod.z.literal("count"),
   object: zod.z.string(),
-  query: DataEngineCountOptionsSchema.optional()
+  query: EngineCountOptionsSchema.extend(RpcLegacyFilterMixin).optional()
 });
 var DataEngineAggregateRequestSchema = zod.z.object({
   method: zod.z.literal("aggregate"),
   object: zod.z.string(),
-  query: DataEngineAggregateOptionsSchema
+  query: EngineAggregateOptionsSchema.extend(RpcLegacyFilterMixin)
 });
 var DataEngineExecuteRequestSchema = zod.z.object({
   method: zod.z.literal("execute"),
@@ -2502,10 +2547,10 @@ var DataEngineVectorFindRequestSchema = zod.z.object({
   object: zod.z.string(),
   /** The vector embedding to search for */
   vector: zod.z.array(zod.z.number()),
-  /** Optional pre-filter (Metadata filtering) */
-  filter: DataEngineFilterSchema.optional(),
-  /** Fields to select */
-  select: zod.z.array(zod.z.string()).optional(),
+  /** Optional pre-filter (Metadata filtering) — standard QueryAST `where` */
+  where: zod.z.union([zod.z.record(zod.z.string(), zod.z.unknown()), FilterConditionSchema]).optional(),
+  /** Fields to retrieve — standard QueryAST `fields` */
+  fields: zod.z.array(zod.z.string()).optional(),
   /** Number of results */
   limit: zod.z.number().int().default(5).optional(),
   /** Minimum similarity score (0-1) or distance threshold */
@@ -2705,6 +2750,13 @@ var DriverCapabilitiesSchema = zod.z.object({
    * Whether the driver supports automatic schema synchronization.
    */
   schemaSync: zod.z.boolean().default(false).describe("Supports automatic schema synchronization"),
+  /**
+   * Whether the driver supports batching multiple schema sync operations
+   * into a single (or fewer) round-trips for the DDL phase. When true,
+   * the engine may call `syncSchemasBatch()` instead of calling
+   * `syncSchema()` per object, reducing network round-trips for remote drivers.
+   */
+  batchSchemaSync: zod.z.boolean().default(false).describe("Supports batched schema sync to reduce schema DDL round-trips"),
   /**
    * Whether the driver supports database migrations.
    */
@@ -2960,6 +3012,20 @@ var DriverInterfaceSchema = zod.z.object({
    * @param options - Driver options.
    */
   syncSchema: zod.z.function().input(zod.z.tuple([zod.z.string(), zod.z.unknown(), DriverOptionsSchema.optional()])).output(zod.z.promise(zod.z.void())).describe("Sync object schema to DB"),
+  /**
+   * Batch-synchronize multiple object schemas with fewer round-trips.
+   *
+   * Drivers that advertise `supports.batchSchemaSync = true` MUST implement
+   * this method.  The engine will call it once with every
+   * `{ object, schema }` pair instead of calling `syncSchema()` N times.
+   *
+   * @param schemas - Array of `{ object: string; schema: unknown }` pairs.
+   * @param options - Driver options.
+   */
+  syncSchemasBatch: zod.z.function().input(zod.z.tuple([
+    zod.z.array(zod.z.object({ object: zod.z.string(), schema: zod.z.unknown() })),
+    DriverOptionsSchema.optional()
+  ])).output(zod.z.promise(zod.z.void())).optional().describe("Batch sync multiple schemas in one round-trip"),
   /**
    * Drop the underlying table or collection for an object.
    * WARNING: Destructive operation.
@@ -17290,8 +17356,12 @@ var MetadataTypeSchema = zod.z.enum([
   "role",
   // Security roles
   // AI Protocol
-  "agent"
+  "agent",
   // AI agent definitions (AgentSchema)
+  "tool",
+  // AI tool definitions (ToolSchema)
+  "skill"
+  // AI skill definitions (SkillSchema)
 ]);
 var MetadataTypeRegistryEntrySchema = zod.z.object({
   /** Metadata type identifier (e.g., 'object', 'view') */
@@ -17522,7 +17592,9 @@ var DEFAULT_METADATA_TYPE_REGISTRY = [
   { type: "profile", label: "Profile", filePatterns: ["**/*.profile.ts", "**/*.profile.yml"], supportsOverlay: true, allowRuntimeCreate: true, supportsVersioning: false, loadOrder: 15, domain: "security" },
   { type: "role", label: "Role", filePatterns: ["**/*.role.ts", "**/*.role.yml"], supportsOverlay: true, allowRuntimeCreate: true, supportsVersioning: false, loadOrder: 15, domain: "security" },
   // AI Protocol
-  { type: "agent", label: "AI Agent", filePatterns: ["**/*.agent.ts", "**/*.agent.yml"], supportsOverlay: false, allowRuntimeCreate: true, supportsVersioning: true, loadOrder: 90, domain: "ai" }
+  { type: "agent", label: "AI Agent", filePatterns: ["**/*.agent.ts", "**/*.agent.yml"], supportsOverlay: false, allowRuntimeCreate: true, supportsVersioning: true, loadOrder: 90, domain: "ai" },
+  { type: "tool", label: "AI Tool", filePatterns: ["**/*.tool.ts", "**/*.tool.yml"], supportsOverlay: true, allowRuntimeCreate: true, supportsVersioning: false, loadOrder: 85, domain: "ai" },
+  { type: "skill", label: "AI Skill", filePatterns: ["**/*.skill.ts", "**/*.skill.yml"], supportsOverlay: true, allowRuntimeCreate: true, supportsVersioning: false, loadOrder: 88, domain: "ai" }
 ];
 var MetadataBulkRegisterRequestSchema = zod.z.object({
   /** Items to register */
@@ -23017,6 +23089,8 @@ __export(ai_exports, {
   RootCauseAnalysisResultSchema: () => RootCauseAnalysisResultSchema,
   SelfHealingActionSchema: () => SelfHealingActionSchema,
   SelfHealingConfigSchema: () => SelfHealingConfigSchema,
+  SkillSchema: () => SkillSchema,
+  SkillTriggerConditionSchema: () => SkillTriggerConditionSchema,
   StructuredOutputConfigSchema: () => StructuredOutputConfigSchema,
   StructuredOutputFormatSchema: () => StructuredOutputFormatSchema,
   TestingConfigSchema: () => TestingConfigSchema,
@@ -23027,6 +23101,8 @@ __export(ai_exports, {
   TokenUsageSchema: () => TokenUsageSchema,
   TokenUsageStatsSchema: () => TokenUsageStatsSchema,
   ToolCallSchema: () => ToolCallSchema,
+  ToolCategorySchema: () => ToolCategorySchema,
+  ToolSchema: () => ToolSchema,
   TrainingConfigSchema: () => TrainingConfigSchema,
   TransformPipelineStepSchema: () => TransformPipelineStepSchema,
   TypedAgentActionSchema: () => TypedAgentActionSchema,
@@ -23044,6 +23120,8 @@ __export(ai_exports, {
   WorkflowFieldConditionSchema: () => WorkflowFieldConditionSchema,
   WorkflowScheduleSchema: () => WorkflowScheduleSchema,
   defineAgent: () => defineAgent,
+  defineSkill: () => defineSkill,
+  defineTool: () => defineTool,
   fullStackDevOpsAgentExample: () => fullStackDevOpsAgentExample
 });
 var AIModelConfigSchema = zod.z.object({
@@ -23101,12 +23179,17 @@ var AgentSchema = zod.z.object({
   instructions: zod.z.string().describe("System Prompt / Prime Directives"),
   model: AIModelConfigSchema.optional(),
   lifecycle: StateMachineSchema.optional().describe("State machine defining the agent conversation follow and constraints"),
-  /** Capabilities */
-  tools: zod.z.array(AIToolSchema).optional().describe("Available tools"),
+  /** Capabilities — Skill-based (primary) */
+  skills: zod.z.array(zod.z.string().regex(/^[a-z_][a-z0-9_]*$/)).optional().describe("Skill names to attach (Agent\u2192Skill\u2192Tool architecture)"),
+  /** Capabilities — Direct tool references (fallback / legacy) */
+  tools: zod.z.array(AIToolSchema).optional().describe("Direct tool references (legacy fallback)"),
+  /** Knowledge */
   knowledge: AIKnowledgeSchema.optional().describe("RAG access"),
   /** Interface */
   active: zod.z.boolean().default(true),
   access: zod.z.array(zod.z.string()).optional().describe("Who can chat with this agent"),
+  /** Permission profiles/roles required to use this agent */
+  permissions: zod.z.array(zod.z.string()).optional().describe("Required permissions or roles"),
   /** Multi-tenancy & Visibility */
   tenantId: zod.z.string().optional().describe("Tenant/Organization ID"),
   visibility: zod.z.enum(["global", "organization", "private"]).default("organization"),
@@ -23155,6 +23238,102 @@ var AgentSchema = zod.z.object({
 function defineAgent(config) {
   return AgentSchema.parse(config);
 }
+var ToolCategorySchema = zod.z.enum([
+  "data",
+  // CRUD / query operations
+  "action",
+  // Side-effect actions (send email, create record)
+  "flow",
+  // Trigger a visual flow
+  "integration",
+  // External API / webhook calls
+  "vector_search",
+  // RAG / vector search
+  "analytics",
+  // Aggregation & reporting
+  "utility"
+  // Formatters, parsers, helpers
+]).describe("Tool operational category");
+var ToolSchema = zod.z.object({
+  /** Machine name (snake_case, globally unique) */
+  name: zod.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe("Tool unique identifier (snake_case)"),
+  /** Human-readable display name */
+  label: zod.z.string().describe("Tool display name"),
+  /** Detailed description for LLM consumption (the model reads this to decide when to call the tool) */
+  description: zod.z.string().describe("Tool description for LLM function calling"),
+  /** Operational category */
+  category: ToolCategorySchema.optional().describe("Tool category for grouping and filtering"),
+  /**
+   * JSON Schema describing the tool input parameters.
+   * Must be a valid JSON Schema object. The AI model generates
+   * arguments conforming to this schema.
+   */
+  parameters: zod.z.record(zod.z.string(), zod.z.unknown()).describe("JSON Schema for tool parameters"),
+  /**
+   * Optional JSON Schema for the tool output.
+   * Used for structured output validation and downstream tool chaining.
+   */
+  outputSchema: zod.z.record(zod.z.string(), zod.z.unknown()).optional().describe("JSON Schema for tool output"),
+  /**
+   * Associated object name (when the tool operates on a specific data object).
+   * @example 'support_case'
+   */
+  objectName: zod.z.string().regex(/^[a-z_][a-z0-9_]*$/).optional().describe("Target object name (snake_case)"),
+  /** Whether the tool requires human confirmation before execution */
+  requiresConfirmation: zod.z.boolean().default(false).describe("Require user confirmation before execution"),
+  /** Permission profiles/roles required to use this tool */
+  permissions: zod.z.array(zod.z.string()).optional().describe("Required permissions or roles"),
+  /** Whether the tool is enabled */
+  active: zod.z.boolean().default(true).describe("Whether the tool is enabled"),
+  /** Whether this is a platform built-in tool (vs. user-defined) */
+  builtIn: zod.z.boolean().default(false).describe("Platform built-in tool flag")
+});
+function defineTool(config) {
+  return ToolSchema.parse(config);
+}
+var SkillTriggerConditionSchema = zod.z.object({
+  /** Condition field (e.g. 'objectName', 'userRole', 'channel') */
+  field: zod.z.string().describe("Context field to evaluate"),
+  /** Comparison operator */
+  operator: zod.z.enum(["eq", "neq", "in", "not_in", "contains"]).describe("Comparison operator"),
+  /** Expected value(s) */
+  value: zod.z.union([zod.z.string(), zod.z.array(zod.z.string())]).describe("Expected value or values")
+});
+var SkillSchema = zod.z.object({
+  /** Machine name (snake_case, globally unique) */
+  name: zod.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe("Skill unique identifier (snake_case)"),
+  /** Human-readable display name */
+  label: zod.z.string().describe("Skill display name"),
+  /** Detailed description of the skill's purpose */
+  description: zod.z.string().optional().describe("Skill description"),
+  /**
+   * Instructions injected into the system prompt when this skill is active.
+   * Guides the LLM on how and when to use the skill's tools.
+   */
+  instructions: zod.z.string().optional().describe("LLM instructions when skill is active"),
+  /**
+   * References to tool names that belong to this skill.
+   * Tools must be registered as first-class metadata (type: 'tool').
+   */
+  tools: zod.z.array(zod.z.string().regex(/^[a-z_][a-z0-9_]*$/)).describe("Tool names belonging to this skill"),
+  /**
+   * Natural language phrases that trigger skill activation.
+   * Used for intent matching and skill routing.
+   */
+  triggerPhrases: zod.z.array(zod.z.string()).optional().describe("Phrases that activate this skill"),
+  /**
+   * Programmatic conditions for skill activation.
+   * Evaluated against the runtime context (object name, user role, etc.).
+   */
+  triggerConditions: zod.z.array(SkillTriggerConditionSchema).optional().describe("Programmatic activation conditions"),
+  /** Permission profiles/roles required to use this skill */
+  permissions: zod.z.array(zod.z.string()).optional().describe("Required permissions or roles"),
+  /** Whether the skill is enabled */
+  active: zod.z.boolean().default(true).describe("Whether the skill is enabled")
+});
+function defineSkill(config) {
+  return SkillSchema.parse(config);
+}
 var NavigationActionTypeSchema = zod.z.enum([
   "navigate_to_object_list",
   // Navigate to object list view
@@ -27851,6 +28030,8 @@ var ApiRoutesSchema = zod.z.object({
   data: zod.z.string().describe("e.g. /api/v1/data"),
   /** Base URL for Schema Definitions (Metadata Protocol) */
   metadata: zod.z.string().describe("e.g. /api/v1/meta"),
+  /** Base URL for API Discovery endpoint */
+  discovery: zod.z.string().optional().describe("e.g. /api/v1/discovery"),
   /** Base URL for UI Configurations (Views, Menus) */
   ui: zod.z.string().optional().describe("e.g. /api/v1/ui"),
   /** Base URL for Authentication (plugin-provided) */
@@ -27874,7 +28055,9 @@ var ApiRoutesSchema = zod.z.object({
   /** Base URL for AI Engine (NLQ, Chat, Suggest) */
   ai: zod.z.string().optional().describe("e.g. /api/v1/ai"),
   /** Base URL for Internationalization */
-  i18n: zod.z.string().optional().describe("e.g. /api/v1/i18n")
+  i18n: zod.z.string().optional().describe("e.g. /api/v1/i18n"),
+  /** Base URL for Feed / Chatter API */
+  feed: zod.z.string().optional().describe("e.g. /api/v1/feed")
 });
 var DiscoverySchema = zod.z.object({
   /** System Identity */
@@ -29836,12 +30019,9 @@ var AutomationTriggerResponseSchema = zod.z.object({
   result: zod.z.unknown().optional()
 });
 var GetDiscoveryRequestSchema = zod.z.object({});
-var GetDiscoveryResponseSchema = zod.z.object({
-  version: zod.z.string().describe('API version (e.g., "v1", "2024-01")'),
-  apiName: zod.z.string().describe("API name"),
-  routes: ApiRoutesSchema.optional().describe("Available endpoint paths"),
-  services: zod.z.record(zod.z.string(), ServiceInfoSchema).optional().describe("Per-service availability map"),
-  capabilities: WellKnownCapabilitiesSchema.optional().describe("Well-known capability flags for frontend adaptation")
+var GetDiscoveryResponseSchema = DiscoverySchema.partial().required({ version: true }).extend({
+  /** @deprecated Use `name` instead. Kept for backward compatibility. */
+  apiName: zod.z.string().optional().describe("API name (deprecated \u2014 use name)")
 });
 var GetMetaTypesRequestSchema = zod.z.object({});
 var GetMetaTypesResponseSchema = zod.z.object({
@@ -31995,6 +32175,8 @@ var DEFAULT_DISPATCHER_ROUTES = [
   { prefix: "/api/v1/workflow", service: "workflow" },
   { prefix: "/api/v1/analytics", service: "analytics" },
   { prefix: "/api/v1/automation", service: "automation" },
+  { prefix: "/api/v1/storage", service: "file-storage" },
+  { prefix: "/api/v1/feed", service: "data" },
   { prefix: "/api/v1/i18n", service: "i18n" },
   { prefix: "/api/v1/notifications", service: "notification" },
   { prefix: "/api/v1/realtime", service: "realtime" },
@@ -39774,7 +39956,9 @@ exports.composeStacks = composeStacks;
 exports.defineAgent = defineAgent;
 exports.defineApp = defineApp;
 exports.defineFlow = defineFlow;
+exports.defineSkill = defineSkill;
 exports.defineStack = defineStack;
+exports.defineTool = defineTool;
 exports.defineView = defineView;
 exports.findClosestMatches = findClosestMatches;
 exports.formatSuggestion = formatSuggestion;