skedyul 1.2.44 → 1.2.50

package/dist/skills/index.d.ts

@@ -1 +1 @@
-export { SKILL_SCHEMA_VERSION, SkillSourceSchema, SkillToolRequirementSchema, SkillExampleSchema, SkillEvaluationMetricSchema, SkillYAMLSchema, SkillRefSchema, SkillVersionWeightSchema, SkillMetadataSchema, ResolvedSkillSchema, type SkillSource, type SkillToolRequirement, type SkillExample, type SkillEvaluationMetric, type SkillYAML, type SkillRef, type SkillVersionWeight, type SkillMetadata, type ResolvedSkill, type SkillDiscoveryInfo, defineSkill, validateSkillYAML, formatSkillInstructions, formatSkillDiscovery, } from './types';
+export { SKILL_SCHEMA_VERSION, SkillSourceSchema, SkillToolRequirementSchema, SkillExampleSchema, SkillYAMLSchema, SkillRefSchema, SkillVersionWeightSchema, SkillMetadataSchema, ResolvedSkillSchema, CRMModelFieldRequirementsSchema, CRMContextSchema as SkillCRMContextSchema, type SkillSource, type SkillToolRequirement, type SkillExample, type SkillYAML, type SkillRef, type SkillVersionWeight, type SkillMetadata, type ResolvedSkill, type SkillDiscoveryInfo, type CRMModelFieldRequirements, type CRMContext as SkillCRMContext, defineSkill, validateSkillYAML, formatSkillInstructions, formatSkillDiscovery, } from './types';

package/dist/skills/types.d.ts

@@ -95,20 +95,38 @@ export declare const SkillExampleSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type SkillExample = z.infer<typeof SkillExampleSchema>;
 /**
- * Skill evaluation metric
+ * Field requirements for a CRM model in skill context.
+ * - required: Fields that MUST have a value or agent will fail (ERROR)
+ * - recommended: Fields that SHOULD have a value for optimal performance (WARNING)
+ * - Fields not listed are optional (no validation)
  */
-export declare const SkillEvaluationMetricSchema: z.ZodObject<{
-    metric: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    threshold: z.ZodOptional<z.ZodNumber>;
+export declare const CRMModelFieldRequirementsSchema: z.ZodObject<{
+    required: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    recommended: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
-export type SkillEvaluationMetric = z.infer<typeof SkillEvaluationMetricSchema>;
+export type CRMModelFieldRequirements = z.infer<typeof CRMModelFieldRequirementsSchema>;
 /**
  * CRM context configuration - specifies which models and fields to include
- * in the CRM schema when loading this skill.
+ * in the CRM schema when loading this skill, with requirement levels.
+ *
+ * Example:
+ * ```yaml
+ * crmContext:
+ *   models:
+ *     prospect:
+ *       required:
+ *         - stage
+ *         - intent_score
+ *       recommended:
+ *         - goals
+ *         - desired_frequency
+ * ```
  */
 export declare const CRMContextSchema: z.ZodObject<{
-    models: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+    models: z.ZodRecord<z.ZodString, z.ZodObject<{
+        required: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        recommended: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type CRMContext = z.infer<typeof CRMContextSchema>;
 /**
@@ -143,7 +161,10 @@ export declare const SkillYAMLSchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>]>>;
     crmContext: z.ZodOptional<z.ZodObject<{
-        models: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+        models: z.ZodRecord<z.ZodString, z.ZodObject<{
+            required: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            recommended: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     examples: z.ZodOptional<z.ZodArray<z.ZodObject<{
         context: z.ZodOptional<z.ZodString>;
@@ -152,12 +173,6 @@ export declare const SkillYAMLSchema: z.ZodObject<{
         output: z.ZodString;
         tool_call: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
-    evaluation: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        metric: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
-        threshold: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type SkillYAML = z.infer<typeof SkillYAMLSchema>;
 /**
@@ -187,7 +202,10 @@ export declare const SkillYAMLV2Schema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
     crmContext: z.ZodOptional<z.ZodObject<{
-        models: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>;
+        models: z.ZodRecord<z.ZodString, z.ZodObject<{
+            required: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            recommended: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     examples: z.ZodOptional<z.ZodArray<z.ZodObject<{
         context: z.ZodOptional<z.ZodString>;
@@ -196,12 +214,6 @@ export declare const SkillYAMLV2Schema: z.ZodObject<{
         output: z.ZodString;
         tool_call: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
-    evaluation: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        metric: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
-        threshold: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type SkillYAMLV2 = z.infer<typeof SkillYAMLV2Schema>;
 /**
@@ -218,6 +230,7 @@ export type SkillVersionWeight = z.infer<typeof SkillVersionWeightSchema>;
 export declare const SkillRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
     skill: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
+    alwaysLoad: z.ZodOptional<z.ZodBoolean>;
     version: z.ZodOptional<z.ZodNumber>;
     versions: z.ZodOptional<z.ZodArray<z.ZodObject<{
         version: z.ZodNumber;
@@ -245,7 +258,6 @@ export declare const SkillMetadataSchema: z.ZodObject<{
     s3Key: z.ZodOptional<z.ZodString>;
     appVersionId: z.ZodOptional<z.ZodString>;
     workplaceId: z.ZodOptional<z.ZodString>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     createdAt: z.ZodOptional<z.ZodString>;
     updatedAt: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;

package/dist/skills/types.js

@@ -21,11 +21,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var types_exports = {};
 __export(types_exports, {
   CRMContextSchema: () => CRMContextSchema,
+  CRMModelFieldRequirementsSchema: () => CRMModelFieldRequirementsSchema,
   LoadedSkillSchema: () => LoadedSkillSchema,
   ResolvedSkillSchema: () => ResolvedSkillSchema,
   SKILL_SCHEMA_VERSION: () => SKILL_SCHEMA_VERSION,
   SKILL_SCHEMA_VERSION_V2: () => SKILL_SCHEMA_VERSION_V2,
-  SkillEvaluationMetricSchema: () => SkillEvaluationMetricSchema,
   SkillExampleSchema: () => SkillExampleSchema,
   SkillMetadataSchema: () => SkillMetadataSchema,
   SkillRefSchema: () => SkillRefSchema,
@@ -83,14 +83,12 @@ var SkillExampleSchema = import_v4.z.object({
   output: import_v4.z.string(),
   tool_call: import_v4.z.string().optional()
 });
-var SkillEvaluationMetricSchema = import_v4.z.object({
-  metric: import_v4.z.string(),
-  description: import_v4.z.string().optional(),
-  threshold: import_v4.z.number().optional()
+var CRMModelFieldRequirementsSchema = import_v4.z.object({
+  required: import_v4.z.array(import_v4.z.string()).optional(),
+  recommended: import_v4.z.array(import_v4.z.string()).optional()
 });
 var CRMContextSchema = import_v4.z.object({
-  models: import_v4.z.record(import_v4.z.string(), import_v4.z.array(import_v4.z.string()))
-  // { modelHandle: [fieldHandles] }
+  models: import_v4.z.record(import_v4.z.string(), CRMModelFieldRequirementsSchema)
 });
 var SkillYAMLSchema = import_v4.z.object({
   // Schema version
@@ -107,11 +105,7 @@ var SkillYAMLSchema = import_v4.z.object({
   // CRM context - specifies which models/fields to include in schema
   crmContext: CRMContextSchema.optional(),
   // Few-shot examples
-  examples: import_v4.z.array(SkillExampleSchema).optional(),
-  // Evaluation criteria
-  evaluation: import_v4.z.array(SkillEvaluationMetricSchema).optional(),
-  // Tags for discovery
-  tags: import_v4.z.array(import_v4.z.string()).optional()
+  examples: import_v4.z.array(SkillExampleSchema).optional()
 });
 var SkillYAMLV2Schema = import_v4.z.object({
   $schema: import_v4.z.literal(SKILL_SCHEMA_VERSION_V2).optional(),
@@ -122,9 +116,7 @@ var SkillYAMLV2Schema = import_v4.z.object({
   instructions: import_v4.z.string(),
   tools: import_v4.z.array(SkillToolDefinitionSchema).optional(),
   crmContext: CRMContextSchema.optional(),
-  examples: import_v4.z.array(SkillExampleSchema).optional(),
-  evaluation: import_v4.z.array(SkillEvaluationMetricSchema).optional(),
-  tags: import_v4.z.array(import_v4.z.string()).optional()
+  examples: import_v4.z.array(SkillExampleSchema).optional()
 });
 var SkillVersionWeightSchema = import_v4.z.object({
   version: import_v4.z.number(),
@@ -137,6 +129,8 @@ var SkillRefSchema = import_v4.z.union([
     skill: import_v4.z.string(),
     description: import_v4.z.string().optional(),
     // For AI SDK Agent Skills discovery
+    /** Auto-inject this skill's instructions and tools on every agent turn */
+    alwaysLoad: import_v4.z.boolean().optional(),
     // Version selection (pick one):
     version: import_v4.z.number().optional(),
     // Pin to specific version number
@@ -158,7 +152,6 @@ var SkillMetadataSchema = import_v4.z.object({
   s3Key: import_v4.z.string().optional(),
   appVersionId: import_v4.z.string().optional(),
   workplaceId: import_v4.z.string().optional(),
-  tags: import_v4.z.array(import_v4.z.string()).optional(),
   createdAt: import_v4.z.string().datetime().optional(),
   updatedAt: import_v4.z.string().datetime().optional()
 });
@@ -254,11 +247,11 @@ IMPORTANT: Always use the proper tool calls. Do NOT output XML-like tags in your
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CRMContextSchema,
+  CRMModelFieldRequirementsSchema,
   LoadedSkillSchema,
   ResolvedSkillSchema,
   SKILL_SCHEMA_VERSION,
   SKILL_SCHEMA_VERSION_V2,
-  SkillEvaluationMetricSchema,
   SkillExampleSchema,
   SkillMetadataSchema,
   SkillRefSchema,

package/dist/skills/types.mjs

@@ -37,14 +37,12 @@ var SkillExampleSchema = z.object({
   output: z.string(),
   tool_call: z.string().optional()
 });
-var SkillEvaluationMetricSchema = z.object({
-  metric: z.string(),
-  description: z.string().optional(),
-  threshold: z.number().optional()
+var CRMModelFieldRequirementsSchema = z.object({
+  required: z.array(z.string()).optional(),
+  recommended: z.array(z.string()).optional()
 });
 var CRMContextSchema = z.object({
-  models: z.record(z.string(), z.array(z.string()))
-  // { modelHandle: [fieldHandles] }
+  models: z.record(z.string(), CRMModelFieldRequirementsSchema)
 });
 var SkillYAMLSchema = z.object({
   // Schema version
@@ -61,11 +59,7 @@ var SkillYAMLSchema = z.object({
   // CRM context - specifies which models/fields to include in schema
   crmContext: CRMContextSchema.optional(),
   // Few-shot examples
-  examples: z.array(SkillExampleSchema).optional(),
-  // Evaluation criteria
-  evaluation: z.array(SkillEvaluationMetricSchema).optional(),
-  // Tags for discovery
-  tags: z.array(z.string()).optional()
+  examples: z.array(SkillExampleSchema).optional()
 });
 var SkillYAMLV2Schema = z.object({
   $schema: z.literal(SKILL_SCHEMA_VERSION_V2).optional(),
@@ -76,9 +70,7 @@ var SkillYAMLV2Schema = z.object({
   instructions: z.string(),
   tools: z.array(SkillToolDefinitionSchema).optional(),
   crmContext: CRMContextSchema.optional(),
-  examples: z.array(SkillExampleSchema).optional(),
-  evaluation: z.array(SkillEvaluationMetricSchema).optional(),
-  tags: z.array(z.string()).optional()
+  examples: z.array(SkillExampleSchema).optional()
 });
 var SkillVersionWeightSchema = z.object({
   version: z.number(),
@@ -91,6 +83,8 @@ var SkillRefSchema = z.union([
     skill: z.string(),
     description: z.string().optional(),
     // For AI SDK Agent Skills discovery
+    /** Auto-inject this skill's instructions and tools on every agent turn */
+    alwaysLoad: z.boolean().optional(),
     // Version selection (pick one):
     version: z.number().optional(),
     // Pin to specific version number
@@ -112,7 +106,6 @@ var SkillMetadataSchema = z.object({
   s3Key: z.string().optional(),
   appVersionId: z.string().optional(),
   workplaceId: z.string().optional(),
-  tags: z.array(z.string()).optional(),
   createdAt: z.string().datetime().optional(),
   updatedAt: z.string().datetime().optional()
 });
@@ -207,11 +200,11 @@ IMPORTANT: Always use the proper tool calls. Do NOT output XML-like tags in your
 }
 export {
   CRMContextSchema,
+  CRMModelFieldRequirementsSchema,
   LoadedSkillSchema,
   ResolvedSkillSchema,
   SKILL_SCHEMA_VERSION,
   SKILL_SCHEMA_VERSION_V2,
-  SkillEvaluationMetricSchema,
   SkillExampleSchema,
   SkillMetadataSchema,
   SkillRefSchema,

package/dist/types/index.d.ts

@@ -7,9 +7,9 @@
 export type { AppInfo, AppInfoWithHandles, WorkplaceInfo, RequestInfo } from './shared';
 export type { InvocationType, ServerHookHandle, InvocationContext, } from './invocation';
 export { createToolCallContext, createServerHookContext, createWebhookContext, createWorkflowStepContext, } from './invocation';
-export type { ToolTrigger, ProvisionToolContext, FieldChangeToolContext, PageActionToolContext, FormSubmitToolContext, AgentToolContext, WorkflowToolContext, ToolExecutionContext, } from './tool-context';
-export { isProvisionContext, isRuntimeContext } from './tool-context';
-export type { ToolResult, ToolSuccess, ToolFailure, ErrorCode, ErrorCategory, ToolWarning, ToolPagination, ToolBilling, ToolRetry, ToolTiming, ToolCompletionHints, ToolConfig, BillingInfo, ToolResponseMeta, ToolEffect, ToolError, ToolExecutionResult, ToolSchemaWithJson, ToolSchema, ToolHandler, ToolDefinition, ToolRegistryEntry, ToolRegistry, ToolName, ToolMetadata, ToolCallResponse, } from './tool';
+export type { ToolTrigger, ProvisionToolContext, DeveloperPageActionToolContext, DeveloperFormSubmitToolContext, FieldChangeToolContext, PageActionToolContext, FormSubmitToolContext, AgentToolContext, WorkflowToolContext, CronToolContext, CronContext, ToolExecutionContext, } from './tool-context';
+export { isProvisionContext, isRuntimeContext, isCronContext, isDeveloperContext } from './tool-context';
+export type { ToolResult, ToolSuccess, ToolFailure, ErrorCode, ErrorCategory, ToolWarning, ToolPagination, ToolBilling, ToolRetry, ToolTiming, ToolCompletionHints, ToolConfig, BillingInfo, ToolResponseMeta, ToolEffect, ToolError, ToolExecutionResult, ToolSchemaWithJson, ToolSchema, ToolHandler, ToolDefinition, ToolRegistryEntry, ToolRegistry, ToolName, ToolMetadata, ToolCallResponse, ExecutionScope, } from './tool';
 export { ToolResponseMetaSchema } from './tool';
 export { createSuccessResponse, createListResponse, createErrorResponse, createValidationError, createNotFoundError, createAuthError, createRateLimitError, createExternalError, createTimeoutError, createPermissionError, createConflictError, isSuccess, isFailure, isRetryable, getRetryDelay, } from './tool-response';
 export type { HealthStatus, ComputeLayer, DedicatedServerInstance, ServerlessServerInstance, SkedyulServerInstance, } from './server';

package/dist/types/server.d.ts

@@ -13,6 +13,7 @@ export interface HealthStatus {
 export type { ComputeLayer };
 export interface DedicatedServerInstance {
     listen(port?: number): Promise<void>;
+    close(): Promise<void>;
     getHealthStatus(): HealthStatus;
 }
 export interface ServerlessServerInstance {

package/dist/types/tool-context.d.ts

@@ -2,7 +2,7 @@ import type { AppInfo, WorkplaceInfo, RequestInfo } from './shared';
 import type { InvocationContext } from './invocation';
 import type { ContextLogger } from '../server/logger';
 /** Trigger types for tool execution */
-export type ToolTrigger = 'provision' | 'field_change' | 'page_action' | 'form_submit' | 'agent' | 'workflow' | 'page_context';
+export type ToolTrigger = 'provision' | 'field_change' | 'page_action' | 'form_submit' | 'agent' | 'workflow' | 'page_context' | 'cron' | 'developer_page_action' | 'developer_form_submit';
 /** Base context shared by all tool executions */
 interface BaseToolContext {
     /** Environment variables */
@@ -20,6 +20,14 @@ interface BaseToolContext {
 export interface ProvisionToolContext extends BaseToolContext {
     trigger: 'provision';
 }
+/** Developer page action context - no installation, uses sk_prv_ token */
+export interface DeveloperPageActionToolContext extends BaseToolContext {
+    trigger: 'developer_page_action';
+}
+/** Developer form submit context - no installation, uses sk_prv_ token */
+export interface DeveloperFormSubmitToolContext extends BaseToolContext {
+    trigger: 'developer_form_submit';
+}
 /** Runtime base - has installation, workplace, request */
 interface RuntimeToolContext extends BaseToolContext {
     appInstallationId: string;
@@ -61,10 +69,29 @@ export interface AgentToolContext extends RuntimeToolContext {
 export interface WorkflowToolContext extends RuntimeToolContext {
     trigger: 'workflow';
 }
+/** Cron subscription metadata */
+export interface CronContext {
+    /** The subscription that triggered this execution */
+    subscriptionId: string;
+    /** When the cron was scheduled to run */
+    scheduledTime: Date;
+    /** Cursor from the last run (null on first run) */
+    cursor: Record<string, unknown> | null;
+}
+/** Cron-triggered context */
+export interface CronToolContext extends RuntimeToolContext {
+    trigger: 'cron';
+    /** Cron subscription metadata including cursor */
+    cron: CronContext;
+}
 /** Discriminated union of all tool execution contexts */
-export type ToolExecutionContext = ProvisionToolContext | FieldChangeToolContext | PageActionToolContext | FormSubmitToolContext | AgentToolContext | WorkflowToolContext;
+export type ToolExecutionContext = ProvisionToolContext | DeveloperPageActionToolContext | DeveloperFormSubmitToolContext | FieldChangeToolContext | PageActionToolContext | FormSubmitToolContext | AgentToolContext | WorkflowToolContext | CronToolContext;
 /** Type guard for provision context */
 export declare function isProvisionContext(ctx: ToolExecutionContext): ctx is ProvisionToolContext;
-/** Type guard for runtime context (any non-provision trigger) */
-export declare function isRuntimeContext(ctx: ToolExecutionContext): ctx is FieldChangeToolContext | PageActionToolContext | FormSubmitToolContext | AgentToolContext | WorkflowToolContext;
+/** Type guard for runtime context (requires appInstallationId) */
+export declare function isRuntimeContext(ctx: ToolExecutionContext): ctx is FieldChangeToolContext | PageActionToolContext | FormSubmitToolContext | AgentToolContext | WorkflowToolContext | CronToolContext;
+/** Type guard for developer context (no appInstallationId, uses sk_prv_ token) */
+export declare function isDeveloperContext(ctx: ToolExecutionContext): ctx is DeveloperPageActionToolContext | DeveloperFormSubmitToolContext;
+/** Type guard for cron context */
+export declare function isCronContext(ctx: ToolExecutionContext): ctx is CronToolContext;
 export {};

package/dist/types/tool-response.d.ts

@@ -30,6 +30,8 @@ export declare function createSuccessResponse<T>(output: T, options?: {
     pagination?: ToolPagination;
     billing?: ToolBilling;
     effect?: ToolEffect;
+    /** Cursor state for cron subscriptions - saved and passed to the next run */
+    cursor?: Record<string, unknown>;
 }): ToolSuccess<T>;
 /**
  * Create a successful list response with pagination.

package/dist/types/tool.d.ts

@@ -117,6 +117,8 @@ export interface ToolSuccess<T = unknown> {
     billing?: ToolBilling;
     effect?: ToolEffect;
     timing?: ToolTiming;
+    /** Cursor state for cron subscriptions - saved and passed to the next run */
+    cursor?: Record<string, unknown>;
 }
 /**
  * Failed tool execution result.
@@ -170,13 +172,17 @@ export type ToolResponseMeta = z.infer<typeof ToolResponseMetaSchema>;
  * @deprecated Use ToolResult<T> instead. This type is kept for backward compatibility.
  */
 export interface ToolExecutionResult<Output = unknown> {
+    /** Discriminator for new ToolResult shape (true=success, false=failure) */
+    success?: boolean;
     output: Output | null;
     billing: BillingInfo;
-    meta: ToolResponseMeta;
+    meta?: ToolResponseMeta;
     effect?: ToolEffect;
     error?: ToolError | null;
     /** Rich data blocks for UI rendering (profiles, spreadsheets, datetime cards) */
     dataBlocks?: import('./data-blocks').DataBlock[];
+    /** Cursor state for cron subscriptions - saved and passed to the next run */
+    cursor?: Record<string, unknown>;
 }
 export interface ToolSchemaWithJson<Schema extends z.ZodTypeAny = z.ZodTypeAny> {
     zod: Schema;
@@ -189,6 +195,17 @@ export type ToolSchema<Schema extends z.ZodTypeAny = z.ZodTypeAny> = Schema | To
  * Supports both new ToolResult and legacy ToolExecutionResult return types.
  */
 export type ToolHandler<Input, Output> = (input: Input, context: ToolExecutionContext) => Promise<ToolResult<Output> | ToolExecutionResult<Output>> | ToolResult<Output> | ToolExecutionResult<Output>;
+/**
+ * Execution scope for tools.
+ *
+ * - `installation` (default): Tool requires an appInstallationId at invoke time.
+ *   Standard for most tools - receives sk_wkp_ token scoped to the installation.
+ *
+ * - `app_version`: Tool runs without appInstallationId (developer/admin tools).
+ *   Receives sk_prv_ token. Handler discovers appInstallationId from records
+ *   and uses token.exchange for scoped writes.
+ */
+export type ExecutionScope = 'installation' | 'app_version';
 export interface ToolDefinition<Input = unknown, Output = unknown, InputSchema extends z.ZodTypeAny = z.ZodType<Input>, OutputSchema extends z.ZodTypeAny = z.ZodType<Output>> {
     name: string;
     label?: string;
@@ -198,6 +215,13 @@ export interface ToolDefinition<Input = unknown, Output = unknown, InputSchema e
     outputSchema?: ToolSchema<OutputSchema>;
     /** Tool execution configuration (timeout, retries, completion hints) */
     config?: ToolConfig;
+    /**
+     * Execution scope for this tool.
+     * - `installation` (default): Requires appInstallationId, receives sk_wkp_ token.
+     * - `app_version`: No appInstallationId required, receives sk_prv_ token.
+     *   Used for developer/admin tools that discover installations from records.
+     */
+    executionScope?: ExecutionScope;
     [key: string]: unknown;
 }
 export interface ToolRegistryEntry {
@@ -209,6 +233,8 @@ export interface ToolRegistryEntry {
     outputSchema?: ToolSchema;
     /** Tool execution configuration (timeout, retries, completion hints) */
     config?: ToolConfig;
+    /** Execution scope for this tool */
+    executionScope?: ExecutionScope;
     [key: string]: unknown;
 }
 export type ToolRegistry = Record<string, ToolRegistryEntry>;
@@ -219,8 +245,14 @@ export interface ToolMetadata {
     description: string;
     inputSchema?: Record<string, unknown>;
     outputSchema?: Record<string, unknown>;
+    /** Timeout in milliseconds for this tool (top-level for sync) */
+    timeout?: number;
+    /** Maximum retry attempts (top-level for sync) */
+    retries?: number;
     /** Tool execution configuration (timeout, retries, completion hints) */
     config?: ToolConfig;
+    /** Execution scope for this tool */
+    executionScope?: ExecutionScope;
 }
 /**
  * Response from a tool call.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skedyul",
-  "version": "1.2.44",
+  "version": "1.2.50",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -49,6 +49,12 @@
       "import": "./dist/skills/types.mjs",
       "require": "./dist/skills/types.js",
       "default": "./dist/skills/types.js"
+    },
+    "./scheduling": {
+      "types": "./dist/scheduling/index.d.ts",
+      "import": "./dist/scheduling/index.mjs",
+      "require": "./dist/scheduling/index.js",
+      "default": "./dist/scheduling/index.js"
     }
   },
   "files": [
@@ -58,7 +64,7 @@
     "build": "rm -rf dist tsconfig.tsbuildinfo && tsc --emitDeclarationOnly && tsup",
     "db:generate": "echo 'No database generation needed for this package'",
     "dev": "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"
+    "test": "tsc --project tsconfig.tests.json && node --test dist-tests/tests/server.test.js dist-tests/tests/cli.test.js dist-tests/tests/agent-schema-v3.test.js"
   },
   "keywords": [
     "mcp",
@@ -76,6 +82,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.23.0",
     "tsx": "^4.19.0",
+    "yaml": "^2.3.1",
     "zod": "^4.0.0"
   },
   "devDependencies": {