@runtypelabs/cli 2.16.16 → 2.16.17

package/dist/index.js

@@ -15581,6 +15581,10 @@ var agentApprovalStartEventSchema = external_exports.object({
   toolName: external_exports.string(),
   toolType: external_exports.string(),
   description: external_exports.string(),
+  // Agent-authored justification for this specific call, extracted from the
+  // reserved `_approvalReason` parameter. It is the agent's claim about its
+  // intent — UIs must attribute it to the agent and render it as plain text.
+  reason: external_exports.string().optional(),
   parameters: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
   timeout: external_exports.number(),
   startedAt: external_exports.string(),
@@ -15888,7 +15892,13 @@ var stepSkipEventSchema = external_exports.object({
   error: external_exports.string().optional(),
   skippedAt: external_exports.string()
 });
-var stepAwaitEventSchema = external_exports.object({ ...baseFlowEvent, type: external_exports.literal("step_await") }).passthrough();
+var stepAwaitEventSchema = external_exports.object({
+  ...baseFlowEvent,
+  type: external_exports.literal("step_await"),
+  // Agent-authored justification for an approval-gated tool call
+  // (awaitReason === 'approval_required'); see agentApprovalStartEventSchema.
+  reason: external_exports.string().optional()
+}).passthrough();
 var toolStartEventSchema = external_exports.object({
   ...baseFlowEvent,
   type: external_exports.literal("tool_start"),
@@ -16215,7 +16225,12 @@ var approvalConfigSchema = external_exports.object({
    *  false/undefined: no approval required (default) */
   require: external_exports.union([external_exports.array(external_exports.string()), external_exports.boolean()]).optional(),
   /** Timeout in ms for approval response (default: 300000 = 5 min) */
-  timeout: external_exports.number().optional()
+  timeout: external_exports.number().optional(),
+  /** Whether to ask the model for a per-call justification on approval-gated
+   *  tools by injecting a reserved optional `_approvalReason` string into the
+   *  model-visible parameters schema. The value is stripped before the tool
+   *  executes and surfaced to the approver. Default: true (opt out with false). */
+  requestReason: external_exports.boolean().optional()
 });
 var toolSearchConfigSchema = external_exports.object({
   /** Explicit opt-in/out. When omitted, auto-activates if tool count >= threshold. */
@@ -33318,6 +33333,9 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "claude-4-sonnet": {
     "vercel": "anthropic/claude-4-sonnet"
   },
+  "claude-fable-5": {
+    "vercel": "anthropic/claude-fable-5"
+  },
   "claude-haiku-4-5": {
     "anthropic": "claude-haiku-4-5-20251001",
     "vercel": "anthropic/claude-haiku-4.5"
@@ -34137,6 +34155,7 @@ var MODEL_FAMILY_PROVIDER_IDS = {
     "vercel": "minimax/minimax-m2.5-highspeed"
   },
   "minimax-m2-7": {
+    "general-compute": "general-compute/minimax-m2.7",
     "vercel": "minimax/minimax-m2.7"
   },
   "minimax-m2-7-highspeed": {
@@ -34155,6 +34174,7 @@ var MODEL_FAMILY_PROVIDER_IDS = {
     "vercel": "minimax/minimax-m2.5-highspeed"
   },
   "minimax-m2.7": {
+    "general-compute": "general-compute/minimax-m2.7",
     "vercel": "minimax/minimax-m2.7"
   },
   "minimax-m2.7-highspeed": {
@@ -35539,7 +35559,11 @@ var agentRuntimeConfigSchema = external_exports.object({
     toolCallStrategy: external_exports.enum(["auto", "required", "none"]).optional(),
     approval: external_exports.object({
       require: external_exports.union([external_exports.array(external_exports.string()), external_exports.boolean()]),
-      timeout: external_exports.number().optional()
+      timeout: external_exports.number().optional(),
+      /** Opt out of agent-supplied approval reasons (`_approvalReason`
+       *  schema injection). Default: true. Mirrors approvalConfigSchema
+       *  in tool-types.ts. */
+      requestReason: external_exports.boolean().optional()
     }).optional(),
     perToolLimits: external_exports.record(
       external_exports.string(),
@@ -35638,10 +35662,9 @@ var FULL_PRODUCT_OBJECT_VERSION_1_1 = "1.1";
 var FULL_PRODUCT_OBJECT_VERSION_2_0 = "2.0";
 var createPolicySchema = external_exports.enum(["create", "skip", "manual"]).optional();
 var flowStepSchema = external_exports.object({
-  type: external_exports.string().refine(
-    (t) => FLOW_STEP_TYPES.includes(t),
-    { message: "Invalid flow step type" }
-  ),
+  type: external_exports.string().refine((t) => FLOW_STEP_TYPES.includes(t), {
+    message: "Invalid flow step type"
+  }),
   name: external_exports.string().min(1, "Step name is required"),
   config: external_exports.record(external_exports.string(), external_exports.any()).default({}),
   order: external_exports.number().int().nonnegative().optional(),
@@ -35706,13 +35729,15 @@ var agentVoiceConfigSchema = external_exports.object({
 });
 var agentErrorHandlingSchema = external_exports.object({
   onError: external_exports.enum(["fail", "continue", "fallback"]).optional(),
-  fallbacks: external_exports.array(external_exports.object({
-    type: external_exports.enum(["retry", "model"]),
-    model: external_exports.string().optional(),
-    temperature: external_exports.number().min(0).max(2).optional(),
-    maxTokens: external_exports.number().int().positive().optional(),
-    delay: external_exports.number().min(0).max(6e4).optional()
-  })).optional()
+  fallbacks: external_exports.array(
+    external_exports.object({
+      type: external_exports.enum(["retry", "model"]),
+      model: external_exports.string().optional(),
+      temperature: external_exports.number().min(0).max(2).optional(),
+      maxTokens: external_exports.number().int().positive().optional(),
+      delay: external_exports.number().min(0).max(6e4).optional()
+    })
+  ).optional()
 });
 var agentArtifactsConfigSchema = external_exports.object({
   enabled: external_exports.literal(true),
@@ -35737,24 +35762,32 @@ var agentMcpServerSchema = external_exports.object({
 var agentToolsConfigSchema2 = external_exports.object({
   toolIds: external_exports.array(external_exports.string()).optional(),
   toolConfigs: external_exports.record(external_exports.string(), external_exports.record(external_exports.string(), external_exports.any())).optional(),
-  runtimeTools: external_exports.array(external_exports.object({
-    name: external_exports.string().min(1),
-    description: external_exports.string().optional(),
-    toolType: external_exports.enum(["flow", "custom", "external", "local", "subagent"]).optional(),
-    parametersSchema: external_exports.record(external_exports.string(), external_exports.any()).optional(),
-    config: external_exports.record(external_exports.string(), external_exports.any())
-  })).optional(),
+  runtimeTools: external_exports.array(
+    external_exports.object({
+      name: external_exports.string().min(1),
+      description: external_exports.string().optional(),
+      toolType: external_exports.enum(["flow", "custom", "external", "local", "subagent"]).optional(),
+      parametersSchema: external_exports.record(external_exports.string(), external_exports.any()).optional(),
+      config: external_exports.record(external_exports.string(), external_exports.any())
+    })
+  ).optional(),
   mcpServers: external_exports.array(agentMcpServerSchema).optional(),
   maxToolCalls: external_exports.number().int().min(1).max(100).optional(),
   toolCallStrategy: external_exports.enum(["auto", "required", "none"]).optional(),
   approval: external_exports.object({
     require: external_exports.union([external_exports.array(external_exports.string()), external_exports.boolean()]),
-    timeout: external_exports.number().positive().optional()
+    timeout: external_exports.number().positive().optional(),
+    /** Opt out of agent-supplied approval reasons (`_approvalReason` schema
+     *  injection). Default: true. Mirrors approvalConfigSchema in tool-types.ts. */
+    requestReason: external_exports.boolean().optional()
   }).optional(),
-  perToolLimits: external_exports.record(external_exports.string(), external_exports.object({
-    maxCalls: external_exports.number().int().positive().optional(),
-    required: external_exports.boolean().optional()
-  })).optional(),
+  perToolLimits: external_exports.record(
+    external_exports.string(),
+    external_exports.object({
+      maxCalls: external_exports.number().int().positive().optional(),
+      required: external_exports.boolean().optional()
+    })
+  ).optional(),
   subagentConfig: agentSubagentConfigSchema2.optional(),
   codeModeConfig: external_exports.object({
     toolPool: external_exports.array(external_exports.string()).optional(),
@@ -35937,10 +35970,12 @@ var recordSchema = external_exports.object({
   name: external_exports.string().optional(),
   metadata: external_exports.record(external_exports.string(), external_exports.any()).optional(),
   metadataSchema: external_exports.record(external_exports.string(), external_exports.any()).optional(),
-  messages: external_exports.array(external_exports.object({
-    role: external_exports.string().min(1),
-    content: external_exports.string()
-  })).optional(),
+  messages: external_exports.array(
+    external_exports.object({
+      role: external_exports.string().min(1),
+      content: external_exports.string()
+    })
+  ).optional(),
   createPolicy: createPolicySchema
 });
 var scheduleSchema = external_exports.object({
@@ -35953,10 +35988,12 @@ var scheduleSchema = external_exports.object({
   runAt: external_exports.string().datetime({ offset: true }).optional(),
   recordType: external_exports.string().optional(),
   recordFilter: external_exports.record(external_exports.string(), external_exports.any()).optional(),
-  messages: external_exports.array(external_exports.object({
-    role: external_exports.string().min(1),
-    content: external_exports.string()
-  })).optional(),
+  messages: external_exports.array(
+    external_exports.object({
+      role: external_exports.string().min(1),
+      content: external_exports.string()
+    })
+  ).optional(),
   executionOptions: external_exports.record(external_exports.string(), external_exports.any()).optional(),
   enabled: external_exports.boolean().optional(),
   createPolicy: createPolicySchema
@@ -35982,6 +36019,30 @@ var metaSchema = external_exports.object({
   generatorVersion: external_exports.string().min(1),
   planHash: external_exports.string().min(1)
 });
+var internalDocResourceSchema = external_exports.object({
+  /** Open discriminator, e.g. 'doc' | 'example' | 'reference' | 'link'. Kept
+   *  as a free string (not an enum) so new kinds don't require a migration. */
+  type: external_exports.string().min(1),
+  /** Short human-readable label for the resource. */
+  title: external_exports.string().min(1),
+  /** Optional external/internal URL pointing at the resource. */
+  url: external_exports.string().optional(),
+  /** Optional inline body (markdown). Indexable as a retrieval chunk. */
+  content: external_exports.string().optional()
+});
+var internalDocsSchema = external_exports.object({
+  /** Long-form builder notes (markdown). The primary indexable body — cover
+   *  rationale, design choices, best practices, and implementation notes here.
+   *  (Kept as one body for now; may be promoted to typed sub-fields later —
+   *  any such additions must stay optional to remain backward-compatible.) */
+  content: external_exports.string().optional(),
+  /** Freeform tags to power future indexing / search / retrieval / faceting,
+   *  e.g. ['support', 'rag', 'beta']. */
+  tags: external_exports.array(external_exports.string()).optional(),
+  /** Linked knowledge resources (docs, examples, references). Extension point
+   *  for a broader template knowledge/resource system; grows additively. */
+  resources: external_exports.array(internalDocResourceSchema).optional()
+});
 var fullProductObjectSchema = external_exports.object({
   version: external_exports.enum([
     FULL_PRODUCT_OBJECT_VERSION_1_0,
@@ -35992,7 +36053,11 @@ var fullProductObjectSchema = external_exports.object({
     name: external_exports.string().min(1),
     description: external_exports.string().min(1),
     icon: external_exports.string().optional(),
-    metadata: external_exports.record(external_exports.string(), external_exports.any()).optional()
+    metadata: external_exports.record(external_exports.string(), external_exports.any()).optional(),
+    // Internal builder docs (NON user-facing). See `internalDocsSchema`.
+    // Never surfaced to end users / agents by default; safe to drop when
+    // materializing an end-user-facing view of the product.
+    internalDocs: internalDocsSchema.optional()
   }),
   capabilities: external_exports.array(capabilitySchema).max(50),
   tools: external_exports.array(toolSchema).max(100),
@@ -36375,15 +36440,21 @@ function validateConnectivity(fpo) {
       reachableCapIds.add(route.capabilityId);
     }
   }
+  for (const schedule of fpo.schedules ?? []) {
+    const capabilityId = schedule && typeof schedule === "object" ? schedule.capabilityId : void 0;
+    if (typeof capabilityId === "string") {
+      reachableCapIds.add(capabilityId);
+    }
+  }
   for (const [i, cap] of fpo.capabilities.entries()) {
     if (!reachableCapIds.has(cap.id)) {
       result.warnings.push(
         createIssue(
           "warning",
           "UNREACHABLE_CAPABILITY",
-          `Capability "${cap.id}" is not referenced by any surface route`,
+          `Capability "${cap.id}" is not referenced by any surface route or schedule`,
           `capabilities[${i}]`,
-          "Add a surface route or remove the capability"
+          "Add a surface route, add a top-level schedule, or remove the capability"
         )
       );
     }
@@ -36712,7 +36783,14 @@ var fullProductObjectTemplateSchema = external_exports.object({
   productObject: fullProductObjectSchema,
   template: external_exports.object({
     variables: external_exports.array(fpoTemplateVariableSchema).max(50)
-  })
+  }),
+  // Internal builder docs for THIS template (NON user-facing): why the
+  // template is shaped this way, design choices, best practices, and
+  // implementation notes. Distinct from `productObject.product.internalDocs`
+  // (which travels with the materialized product) — this documents the
+  // template/authoring intent itself. Never surfaced to end users / agents
+  // by default. See `internalDocsSchema`.
+  internalDocs: internalDocsSchema.optional()
 }).superRefine((doc, ctx) => {
   const hasVariables = doc.template.variables.length > 0;
   const hasPendingSecretTool = doc.productObject.tools.some(
@@ -37389,7 +37467,13 @@ var PLATFORM_CATALOG = {
 var SURFACE_TYPE_METADATA = {
   chat: {
     description: "Website widget, support bots, conversational interfaces. Uses Persona and can optionally accept WebMCP page tools discovered from document.modelContext.",
-    useCases: ["customer support", "onboarding", "internal tools", "FAQ bots", "page-aware assistants"],
+    useCases: [
+      "customer support",
+      "onboarding",
+      "internal tools",
+      "FAQ bots",
+      "page-aware assistants"
+    ],
     examples: [
       "Support chatbot",
       "Sales assistant widget",
@@ -37546,9 +37630,17 @@ var SURFACE_TYPE_METADATA = {
     behaviorTypeRef: "runtype://types/surface-configs"
   },
   schedule: {
-    description: "Cron jobs and periodic processing",
-    useCases: ["scheduled reports", "data cleanup", "periodic monitoring"],
-    examples: ["Daily report generator", "Weekly data sync", "Hourly health check"],
+    description: "Optional management/presentation surface for scheduled jobs; executable cron or one-time triggers live in top-level schedules[] or Schedule records",
+    useCases: [
+      "schedule management UI",
+      "scheduled report overview",
+      "periodic monitoring dashboard"
+    ],
+    examples: [
+      "Daily report schedule manager",
+      "Weekly data sync overview",
+      "Hourly health check monitor"
+    ],
     traits: {
       streaming: "none",
       messagesMutable: false,
@@ -38544,7 +38636,11 @@ var AgentInputSchema = external_exports.object({
     ).optional(),
     approval: external_exports.object({
       require: external_exports.union([external_exports.array(external_exports.string()), external_exports.boolean()]),
-      timeout: external_exports.number().optional()
+      timeout: external_exports.number().optional(),
+      /** Opt out of agent-supplied approval reasons (`_approvalReason`
+       *  schema injection). Default: true. Mirrors approvalConfigSchema
+       *  in tool-types.ts. */
+      requestReason: external_exports.boolean().optional()
     }).optional(),
     subagentConfig: VirtualAgentSubagentConfigSchema.optional(),
     codeModeConfig: external_exports.object({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/cli",
-  "version": "2.16.16",
+  "version": "2.16.17",
   "description": "Command-line interface for Runtype AI platform",
   "type": "module",
   "main": "dist/index.js",
@@ -21,8 +21,8 @@
     "micromatch": "^4.0.8",
     "rosie-skills": "0.8.1",
     "yaml": "^2.9.0",
-    "@runtypelabs/sdk": "4.7.1",
     "@runtypelabs/ink-components": "0.3.2",
+    "@runtypelabs/sdk": "4.8.0",
     "@runtypelabs/terminal-animations": "0.2.1"
   },
   "devDependencies": {
@@ -37,7 +37,7 @@
     "tsx": "^4.7.1",
     "typescript": "^5.3.3",
     "vitest": "^4.1.0",
-    "@runtypelabs/shared": "1.16.0"
+    "@runtypelabs/shared": "1.17.0"
   },
   "engines": {
     "node": ">=22.0.0"