@runtypelabs/cli 2.16.0 → 2.16.2

package/dist/index.js

@@ -15053,6 +15053,606 @@ function date4(params) {
 config(en_default());
 
 // ../shared/dist/index.mjs
+var mediaAnnotationsSchema = external_exports.object({
+  audience: external_exports.array(external_exports.enum(["user", "assistant"])).optional()
+});
+var mediaContentPartSchema = external_exports.union([
+  external_exports.object({
+    type: external_exports.literal("media"),
+    data: external_exports.string(),
+    mediaType: external_exports.string(),
+    annotations: mediaAnnotationsSchema.optional()
+  }),
+  external_exports.object({
+    type: external_exports.literal("image-url"),
+    url: external_exports.string(),
+    mediaType: external_exports.string().optional(),
+    annotations: mediaAnnotationsSchema.optional()
+  }),
+  external_exports.object({
+    type: external_exports.literal("file-url"),
+    url: external_exports.string(),
+    mediaType: external_exports.string(),
+    annotations: mediaAnnotationsSchema.optional()
+  })
+]);
+var externalAgentContextSchema = external_exports.object({
+  contextId: external_exports.string().optional(),
+  taskId: external_exports.string().optional()
+});
+var tokensSchema = external_exports.object({ input: external_exports.number(), output: external_exports.number() });
+var estimatedContextBreakdownSchema = external_exports.object({
+  estimatedTotalTokens: external_exports.number(),
+  categories: external_exports.record(external_exports.string(), external_exports.object({ estimatedTokens: external_exports.number(), chars: external_exports.number() })),
+  contextWindowSize: external_exports.number().optional(),
+  estimatedUtilizationPercent: external_exports.number().optional()
+});
+var baseAgentEvent = {
+  executionId: external_exports.string(),
+  seq: external_exports.number()
+};
+var agentStartEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_start"),
+  agentId: external_exports.string(),
+  agentName: external_exports.string(),
+  maxTurns: external_exports.number(),
+  startedAt: external_exports.string(),
+  config: external_exports.object({
+    model: external_exports.string().optional(),
+    enableReflection: external_exports.boolean().optional()
+  }).optional()
+});
+var agentIterationStartEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_iteration_start"),
+  iteration: external_exports.number(),
+  maxTurns: external_exports.number(),
+  totalCost: external_exports.number().optional(),
+  startedAt: external_exports.string()
+});
+var agentTurnStartEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_turn_start"),
+  iteration: external_exports.number(),
+  turnId: external_exports.string(),
+  turnIndex: external_exports.number(),
+  role: external_exports.enum(["user", "assistant", "system"])
+});
+var agentTurnDeltaEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_turn_delta"),
+  iteration: external_exports.number(),
+  turnId: external_exports.string(),
+  delta: external_exports.string(),
+  contentType: external_exports.enum(["text", "thinking", "tool_input"])
+});
+var agentTurnCompleteEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_turn_complete"),
+  iteration: external_exports.number(),
+  turnId: external_exports.string(),
+  role: external_exports.enum(["user", "assistant", "system"]),
+  completedAt: external_exports.string(),
+  content: external_exports.string().optional(),
+  tokens: tokensSchema.optional(),
+  cost: external_exports.number().optional(),
+  stopReason: external_exports.enum(["end_turn", "max_tool_calls", "length", "content_filter", "error", "unknown"]).optional(),
+  estimatedContextBreakdown: estimatedContextBreakdownSchema.optional()
+});
+var agentToolStartEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_tool_start"),
+  iteration: external_exports.number(),
+  toolCallId: external_exports.string(),
+  toolName: external_exports.string(),
+  toolType: external_exports.enum([
+    "flow",
+    "mcp",
+    "builtin",
+    "custom",
+    "external",
+    "advisor",
+    "subagent",
+    "local"
+  ]),
+  parameters: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  origin: external_exports.enum(["webmcp", "sdk"]).optional(),
+  pageOrigin: external_exports.string().optional()
+});
+var agentToolDeltaEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_tool_delta"),
+  iteration: external_exports.number(),
+  toolCallId: external_exports.string(),
+  delta: external_exports.string()
+});
+var agentToolInputDeltaEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_tool_input_delta"),
+  iteration: external_exports.number(),
+  toolCallId: external_exports.string(),
+  delta: external_exports.string()
+});
+var agentToolInputCompleteEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_tool_input_complete"),
+  iteration: external_exports.number(),
+  toolCallId: external_exports.string(),
+  toolName: external_exports.string(),
+  parameters: external_exports.record(external_exports.string(), external_exports.unknown()),
+  hiddenParameterNames: external_exports.array(external_exports.string()).optional()
+});
+var agentToolCompleteEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_tool_complete"),
+  iteration: external_exports.number(),
+  toolCallId: external_exports.string(),
+  toolName: external_exports.string(),
+  success: external_exports.boolean(),
+  result: external_exports.unknown().optional(),
+  executionTime: external_exports.number().optional()
+});
+var agentMediaEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_media"),
+  // agent_media is the one agent event emitted via `writeArtifactSse`
+  // (apps/api/src/lib/media-stream.ts), which bypasses the `AgentEventEmitter`
+  // envelope — so unlike every other agent event it carries NO executionId/seq
+  // on the wire. Override the base requiredness to match the bytes.
+  executionId: external_exports.string().optional(),
+  seq: external_exports.number().optional(),
+  iteration: external_exports.number(),
+  toolCallId: external_exports.string(),
+  toolName: external_exports.string(),
+  media: external_exports.array(mediaContentPartSchema)
+});
+var agentApprovalStartEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_approval_start"),
+  approvalId: external_exports.string(),
+  iteration: external_exports.number().optional(),
+  toolCallId: external_exports.string(),
+  toolName: external_exports.string(),
+  toolType: external_exports.string(),
+  description: external_exports.string(),
+  parameters: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  timeout: external_exports.number(),
+  startedAt: external_exports.string(),
+  externalAgent: externalAgentContextSchema.optional()
+});
+var agentApprovalCompleteEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_approval_complete"),
+  approvalId: external_exports.string(),
+  decision: external_exports.enum(["approved", "denied", "timeout"]),
+  completedAt: external_exports.string(),
+  resolvedBy: external_exports.enum(["user", "system"])
+});
+var agentAwaitEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_await"),
+  toolId: external_exports.string(),
+  toolName: external_exports.string(),
+  parameters: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  awaitedAt: external_exports.string(),
+  origin: external_exports.enum(["webmcp", "sdk"]).optional(),
+  pageOrigin: external_exports.string().optional()
+});
+var agentIterationCompleteEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_iteration_complete"),
+  iteration: external_exports.number(),
+  completedAt: external_exports.string(),
+  output: external_exports.string().optional(),
+  toolCallsMade: external_exports.number(),
+  cost: external_exports.number().optional(),
+  runningTotalCost: external_exports.number().optional(),
+  tokens: tokensSchema.optional(),
+  duration: external_exports.number().optional(),
+  stopConditionMet: external_exports.boolean(),
+  estimatedContextBreakdown: estimatedContextBreakdownSchema.optional()
+});
+var agentReflectionEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_reflection"),
+  iteration: external_exports.number(),
+  reflection: external_exports.string().optional()
+});
+var agentSkillLoadedEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_skill_loaded"),
+  iteration: external_exports.number(),
+  toolCallId: external_exports.string(),
+  /** Skill slug (the part after `skill:`). */
+  skill: external_exports.string(),
+  /** Names of the capability tools this skill activated for later turns. */
+  activatedCapabilities: external_exports.array(external_exports.string())
+});
+var agentSkillProposedEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_skill_proposed"),
+  iteration: external_exports.number(),
+  toolCallId: external_exports.string(),
+  /** Proposed skill slug. */
+  skill: external_exports.string(),
+  /** Review outcome: queued for review, or auto-published under the opt-out. */
+  outcome: external_exports.enum(["pending_approval", "auto_published"]),
+  /** Proposal audit-row id (for the dashboard review queue). */
+  proposalId: external_exports.string().optional()
+});
+var agentCompleteEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_complete"),
+  agentId: external_exports.string(),
+  success: external_exports.boolean(),
+  iterations: external_exports.number(),
+  stopReason: external_exports.enum(["complete", "end_turn", "max_turns", "max_cost", "timeout", "error"]),
+  completedAt: external_exports.string(),
+  totalCost: external_exports.number().optional(),
+  totalTokens: tokensSchema.optional(),
+  finalOutput: external_exports.string().optional(),
+  duration: external_exports.number().optional(),
+  error: external_exports.string().optional(),
+  externalAgent: externalAgentContextSchema.optional()
+});
+var agentErrorEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_error"),
+  iteration: external_exports.number().optional(),
+  error: external_exports.object({
+    code: external_exports.string(),
+    message: external_exports.string(),
+    details: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
+  }),
+  recoverable: external_exports.boolean()
+});
+var agentPingEventSchema = external_exports.object({
+  ...baseAgentEvent,
+  type: external_exports.literal("agent_ping"),
+  timestamp: external_exports.string()
+});
+var agentSSEEventSchema = external_exports.discriminatedUnion("type", [
+  agentStartEventSchema,
+  agentIterationStartEventSchema,
+  agentTurnStartEventSchema,
+  agentTurnDeltaEventSchema,
+  agentTurnCompleteEventSchema,
+  agentToolStartEventSchema,
+  agentToolDeltaEventSchema,
+  agentToolInputDeltaEventSchema,
+  agentToolInputCompleteEventSchema,
+  agentToolCompleteEventSchema,
+  agentMediaEventSchema,
+  agentApprovalStartEventSchema,
+  agentApprovalCompleteEventSchema,
+  agentAwaitEventSchema,
+  agentIterationCompleteEventSchema,
+  agentReflectionEventSchema,
+  agentSkillLoadedEventSchema,
+  agentSkillProposedEventSchema,
+  agentCompleteEventSchema,
+  agentErrorEventSchema,
+  agentPingEventSchema
+]);
+var baseFlowEvent = {
+  executionId: external_exports.string().optional(),
+  seq: external_exports.number().optional()
+};
+var toolContextSchema = external_exports.object({
+  toolId: external_exports.string(),
+  stepId: external_exports.string(),
+  executionId: external_exports.string()
+});
+var flowAgentContextSchema = external_exports.object({
+  executionId: external_exports.string(),
+  iteration: external_exports.number(),
+  seq: external_exports.number()
+});
+var flowStartEventSchema = external_exports.object({
+  ...baseFlowEvent,
+  type: external_exports.literal("flow_start"),
+  flowId: external_exports.string(),
+  flowName: external_exports.string().optional(),
+  totalSteps: external_exports.number().optional(),
+  startedAt: external_exports.string(),
+  source: external_exports.string().optional(),
+  // api-only debug context; absent from runtime + stripped user-facing. Loose by design.
+  executionContext: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  toolContext: toolContextSchema.optional(),
+  // Stripped from the wire by the api emitter (tail-only); kept for forward-compat.
+  input: external_exports.unknown().optional()
+});
+var flowCompleteEventSchema = external_exports.object({
+  ...baseFlowEvent,
+  type: external_exports.literal("flow_complete"),
+  // The agent-dispatch / claude-managed paths emit via `formatFlowComplete({ success, duration })`,
+  // which omits both flowId and completedAt — so both are optional on the wire superset.
+  flowId: external_exports.string().optional(),
+  // emitter/runtime send success+duration; api raw-writes send the step counts instead.
+  success: external_exports.boolean().optional(),
+  duration: external_exports.number().optional(),
+  executionTime: external_exports.number().optional(),
+  completedAt: external_exports.string().optional(),
+  totalSteps: external_exports.number().optional(),
+  successfulSteps: external_exports.number().optional(),
+  failedSteps: external_exports.number().optional(),
+  source: external_exports.string().optional(),
+  completedSteps: external_exports.number().optional(),
+  finalOutput: external_exports.string().optional(),
+  totalTokensUsed: external_exports.number().optional(),
+  output: external_exports.unknown().optional(),
+  executionContext: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  toolContext: toolContextSchema.optional()
+});
+var flowErrorEventSchema = external_exports.object({
+  ...baseFlowEvent,
+  type: external_exports.literal("flow_error"),
+  // api emits a string; runtime top-level emits an object; nested-relay a string.
+  error: external_exports.union([
+    external_exports.string(),
+    external_exports.object({
+      code: external_exports.string(),
+      message: external_exports.string(),
+      stepId: external_exports.string().optional(),
+      stepType: external_exports.string().optional()
+    })
+  ]),
+  executionTime: external_exports.number().optional(),
+  // Spread only on platform-key spend errors (api raw-write).
+  code: external_exports.string().optional(),
+  upgradeUrl: external_exports.string().optional(),
+  timestamp: external_exports.string().optional(),
+  flowId: external_exports.string().optional(),
+  toolContext: toolContextSchema.optional()
+});
+var flowAwaitEventSchema = external_exports.object({
+  ...baseFlowEvent,
+  type: external_exports.literal("flow_await"),
+  flowId: external_exports.string(),
+  toolId: external_exports.string().optional(),
+  toolName: external_exports.string().optional(),
+  parameters: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  awaitedAt: external_exports.string(),
+  origin: external_exports.enum(["webmcp", "sdk"]).optional(),
+  pageOrigin: external_exports.string().optional()
+});
+var stepStartEventSchema = external_exports.object({
+  ...baseFlowEvent,
+  type: external_exports.literal("step_start"),
+  // top-level emitters use id/name; the nested-relay uses stepId/stepName and omits id.
+  id: external_exports.string().optional(),
+  name: external_exports.string().optional(),
+  stepType: external_exports.string().optional(),
+  index: external_exports.number().optional(),
+  totalSteps: external_exports.number().optional(),
+  startedAt: external_exports.string(),
+  estimatedTokens: external_exports.number().optional(),
+  stepId: external_exports.string().optional(),
+  stepName: external_exports.string().optional(),
+  toolContext: toolContextSchema.optional()
+});
+var stepDeltaEventSchema = external_exports.object({
+  ...baseFlowEvent,
+  type: external_exports.literal("step_delta"),
+  id: external_exports.string().optional(),
+  // top-level emitters use `text`; the nested-relay uses `delta`.
+  text: external_exports.string().optional(),
+  delta: external_exports.string().optional(),
+  partId: external_exports.string().optional(),
+  messageId: external_exports.string().optional(),
+  toolId: external_exports.string().optional(),
+  toolContext: toolContextSchema.optional()
+});
+var stepCompleteEventSchema = external_exports.object({
+  ...baseFlowEvent,
+  type: external_exports.literal("step_complete"),
+  // top-level emitters use id; the nested-relay uses stepId and omits id. The api
+  // step-orchestrator raw-write omits completedAt — both fields optional on the superset.
+  id: external_exports.string().optional(),
+  name: external_exports.string().optional(),
+  stepType: external_exports.string().optional(),
+  success: external_exports.boolean().optional(),
+  // top-level emitters use `duration`; the nested-relay uses `durationMs`.
+  duration: external_exports.number().optional(),
+  durationMs: external_exports.number().optional(),
+  completedAt: external_exports.string().optional(),
+  tokensUsed: external_exports.number().optional(),
+  error: external_exports.string().optional(),
+  index: external_exports.number().optional(),
+  // consumer reads data.result || data.output; loose for SDK consumers.
+  result: external_exports.unknown().optional(),
+  output: external_exports.unknown().optional(),
+  executionTime: external_exports.number().optional(),
+  stepId: external_exports.string().optional(),
+  stepName: external_exports.string().optional(),
+  toolContext: toolContextSchema.optional()
+});
+var stepErrorEventSchema = external_exports.object({
+  ...baseFlowEvent,
+  type: external_exports.literal("step_error"),
+  // Only `error` is guaranteed by the emitter (formatStepError); the rest are
+  // consumer-expected but emitter-absent (a real gap), hence optional.
+  id: external_exports.string().optional(),
+  error: external_exports.string(),
+  index: external_exports.number().optional(),
+  executionTime: external_exports.number().optional(),
+  name: external_exports.string().optional(),
+  stepType: external_exports.string().optional()
+});
+var stepSkipEventSchema = external_exports.object({
+  ...baseFlowEvent,
+  type: external_exports.literal("step_skip"),
+  id: external_exports.string(),
+  name: external_exports.string().optional(),
+  stepType: external_exports.string(),
+  index: external_exports.number().optional(),
+  totalSteps: external_exports.number(),
+  when: external_exports.string(),
+  error: external_exports.string().optional(),
+  skippedAt: external_exports.string()
+});
+var stepAwaitEventSchema = external_exports.object({ ...baseFlowEvent, type: external_exports.literal("step_await") }).passthrough();
+var toolStartEventSchema = external_exports.object({
+  ...baseFlowEvent,
+  type: external_exports.literal("tool_start"),
+  // api uses toolId/name; runtime uses toolCallId/toolName.
+  toolId: external_exports.string().optional(),
+  toolCallId: external_exports.string().optional(),
+  name: external_exports.string().optional(),
+  toolName: external_exports.string().optional(),
+  toolType: external_exports.enum([
+    "flow",
+    "mcp",
+    "builtin",
+    "custom",
+    "external",
+    "advisor",
+    "subagent",
+    "local"
+  ]),
+  stepId: external_exports.string().optional(),
+  parameters: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  hiddenParameterNames: external_exports.array(external_exports.string()).optional(),
+  startedAt: external_exports.string().optional(),
+  agentContext: flowAgentContextSchema.optional(),
+  providerOptions: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
+}).passthrough();
+var toolDeltaEventSchema = external_exports.object({
+  ...baseFlowEvent,
+  type: external_exports.literal("tool_delta"),
+  toolId: external_exports.string().optional(),
+  delta: external_exports.string().optional()
+}).passthrough();
+var toolInputDeltaEventSchema = external_exports.object({
+  ...baseFlowEvent,
+  type: external_exports.literal("tool_input_delta"),
+  toolId: external_exports.string().optional(),
+  toolCallId: external_exports.string().optional(),
+  stepId: external_exports.string().optional(),
+  // Required on the raw/debug wire; stripped by filtered-stream user-facing mode.
+  delta: external_exports.string()
+});
+var toolInputCompleteEventSchema = external_exports.object({
+  ...baseFlowEvent,
+  type: external_exports.literal("tool_input_complete"),
+  toolId: external_exports.string().optional(),
+  toolCallId: external_exports.string().optional(),
+  toolName: external_exports.string().optional(),
+  stepId: external_exports.string().optional(),
+  // Required on the raw/debug wire; stripped by filtered-stream user-facing mode.
+  parameters: external_exports.record(external_exports.string(), external_exports.unknown()),
+  hiddenParameterNames: external_exports.array(external_exports.string()).optional(),
+  providerOptions: external_exports.record(external_exports.string(), external_exports.unknown()).optional()
+});
+var toolCompleteEventSchema = external_exports.object({
+  ...baseFlowEvent,
+  type: external_exports.literal("tool_complete"),
+  toolId: external_exports.string().optional(),
+  toolCallId: external_exports.string().optional(),
+  name: external_exports.string().optional(),
+  toolName: external_exports.string().optional(),
+  stepId: external_exports.string().optional(),
+  success: external_exports.boolean(),
+  result: external_exports.unknown().optional(),
+  // runtime folds tool errors into tool_complete (success:false); api has tool_error.
+  error: external_exports.string().optional(),
+  executionTime: external_exports.number().optional(),
+  completedAt: external_exports.string().optional(),
+  agentContext: flowAgentContextSchema.optional(),
+  toolCost: external_exports.number().optional()
+});
+var toolErrorEventSchema = external_exports.object({
+  ...baseFlowEvent,
+  type: external_exports.literal("tool_error"),
+  toolId: external_exports.string(),
+  name: external_exports.string(),
+  error: external_exports.string(),
+  executionTime: external_exports.number().optional(),
+  failedAt: external_exports.string().optional(),
+  agentContext: flowAgentContextSchema.optional()
+});
+var chunkEventSchema = external_exports.object({
+  ...baseFlowEvent,
+  type: external_exports.literal("chunk"),
+  id: external_exports.string(),
+  text: external_exports.string()
+});
+var textStartEventSchema = external_exports.object({ ...baseFlowEvent, type: external_exports.literal("text_start") }).passthrough();
+var textEndEventSchema = external_exports.object({ ...baseFlowEvent, type: external_exports.literal("text_end") }).passthrough();
+var reasonStartEventSchema = external_exports.object({ ...baseFlowEvent, type: external_exports.literal("reason_start") }).passthrough();
+var reasonDeltaEventSchema = external_exports.object({ ...baseFlowEvent, type: external_exports.literal("reason_delta") }).passthrough();
+var reasonCompleteEventSchema = external_exports.object({ ...baseFlowEvent, type: external_exports.literal("reason_complete") }).passthrough();
+var sourceEventSchema = external_exports.object({ ...baseFlowEvent, type: external_exports.literal("source") }).passthrough();
+var fallbackStartEventSchema = external_exports.object({ ...baseFlowEvent, type: external_exports.literal("fallback_start") }).passthrough();
+var fallbackCompleteEventSchema = external_exports.object({ ...baseFlowEvent, type: external_exports.literal("fallback_complete") }).passthrough();
+var fallbackExhaustedEventSchema = external_exports.object({ ...baseFlowEvent, type: external_exports.literal("fallback_exhausted") }).passthrough();
+var flowSSEEventSchema = external_exports.discriminatedUnion("type", [
+  flowStartEventSchema,
+  flowCompleteEventSchema,
+  flowErrorEventSchema,
+  flowAwaitEventSchema,
+  stepStartEventSchema,
+  stepDeltaEventSchema,
+  stepCompleteEventSchema,
+  stepErrorEventSchema,
+  stepSkipEventSchema,
+  stepAwaitEventSchema,
+  toolStartEventSchema,
+  toolDeltaEventSchema,
+  toolInputDeltaEventSchema,
+  toolInputCompleteEventSchema,
+  toolCompleteEventSchema,
+  toolErrorEventSchema,
+  chunkEventSchema,
+  textStartEventSchema,
+  textEndEventSchema,
+  reasonStartEventSchema,
+  reasonDeltaEventSchema,
+  reasonCompleteEventSchema,
+  sourceEventSchema,
+  fallbackStartEventSchema,
+  fallbackCompleteEventSchema,
+  fallbackExhaustedEventSchema
+]);
+var artifactStartEventSchema = external_exports.object({
+  type: external_exports.literal("artifact_start"),
+  id: external_exports.string(),
+  artifactType: external_exports.enum(["markdown", "component"]),
+  title: external_exports.string().optional(),
+  component: external_exports.string().optional()
+});
+var artifactDeltaEventSchema = external_exports.object({
+  type: external_exports.literal("artifact_delta"),
+  id: external_exports.string(),
+  delta: external_exports.string()
+});
+var artifactUpdateEventSchema = external_exports.object({
+  type: external_exports.literal("artifact_update"),
+  id: external_exports.string(),
+  props: external_exports.record(external_exports.string(), external_exports.unknown()),
+  component: external_exports.string()
+});
+var artifactCompleteEventSchema = external_exports.object({
+  type: external_exports.literal("artifact_complete"),
+  id: external_exports.string()
+});
+var artifactSingleEventSchema = external_exports.object({
+  type: external_exports.literal("artifact"),
+  id: external_exports.string().optional(),
+  artifactType: external_exports.enum(["markdown", "component"]).optional(),
+  title: external_exports.string().optional(),
+  content: external_exports.string().optional(),
+  props: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+  component: external_exports.string().optional()
+}).passthrough();
+var artifactSSEEventSchema = external_exports.discriminatedUnion("type", [
+  artifactStartEventSchema,
+  artifactDeltaEventSchema,
+  artifactUpdateEventSchema,
+  artifactCompleteEventSchema,
+  artifactSingleEventSchema
+]);
 var configurationStatusSchema = external_exports.enum([
   "configured",
   "needs_configuration",
@@ -28263,6 +28863,42 @@ var CORE_BUILTIN_TOOLS_REGISTRY = [
     platformKeySupport: true,
     requiresApiKey: false
   },
+  // Skills — deployed-agent self-authoring (data plane). Proposing a skill is
+  // a fire-and-forget review-queue write; it does NOT pause the loop. The
+  // skill is persisted for FUTURE runs (review-by-default), not activated in
+  // the current one. See `.claude/rules/api.md#agent-skills-two-plane-governance`.
+  {
+    id: "propose_skill",
+    name: "Propose Skill",
+    description: "Author a new reusable skill (a loadable instruction bundle, optionally referencing flows/agents/tools) and submit it for human review. Use this to capture a procedure you worked out so it can be loaded on demand in future runs. The proposal is queued for review by default and does NOT change the current run. Returns immediately.",
+    category: BuiltInToolCategory.DATA_MANAGEMENT,
+    providers: [BuiltInToolProvider.MULTI],
+    parametersSchema: {
+      type: "object",
+      properties: {
+        name: {
+          type: "string",
+          description: "Skill slug \u2014 lowercase letters, digits, underscore/hyphen, must start with a letter (\u226464 chars)."
+        },
+        description: {
+          type: "string",
+          description: "One-paragraph description of when this skill is relevant (\u22641024 chars). This is what a future agent reads to decide whether to load it."
+        },
+        body: {
+          type: "string",
+          description: "The skill instructions (markdown). The procedure to follow when loaded."
+        },
+        capabilities: {
+          type: "object",
+          description: "Optional capability bindings: { flowIds?, agentIds?, toolIds?, inlineTools? }. Referencing capabilities makes this a capability-bearing proposal (always reviewed). mcpServers are not supported."
+        }
+      },
+      required: ["name", "description", "body"]
+    },
+    executionHint: "platform",
+    requiresApiKey: false,
+    platformKeySupport: false
+  },
   // Record Management Tools — CRUD operations on Runtype records
   {
     id: "runtype_record_upsert",
@@ -31201,7 +31837,7 @@ var MODEL_FAMILY_PROVIDER_IDS = {
     "vercel": "google/gemini-2.5-pro"
   },
   "gemini-3-1-flash-image": {
-    "vercel": "google/gemini-3.1-flash-image-preview"
+    "vercel": "google/gemini-3.1-flash-image"
   },
   "gemini-3-1-flash-lite": {
     "vercel": "google/gemini-3.1-flash-lite"
@@ -31222,8 +31858,8 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "gemini-3-pro-image": {
     "vercel": "google/gemini-3-pro-image"
   },
-  "gemini-3.1-flash-image-preview": {
-    "vercel": "google/gemini-3.1-flash-image-preview"
+  "gemini-3.1-flash-image": {
+    "vercel": "google/gemini-3.1-flash-image"
   },
   "gemini-3.1-flash-lite": {
     "vercel": "google/gemini-3.1-flash-lite"
@@ -31841,6 +32477,9 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "minimax-m2.7-highspeed": {
     "vercel": "minimax/minimax-m2.7-highspeed"
   },
+  "minimax-m3": {
+    "vercel": "minimax/minimax-m3"
+  },
   "ministral-14b": {
     "vercel": "mistral/ministral-14b"
   },
@@ -31986,6 +32625,9 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "qwen3-7-max": {
     "vercel": "alibaba/qwen3.7-max"
   },
+  "qwen3-7-plus": {
+    "vercel": "alibaba/qwen3.7-plus"
+  },
   "qwen3-coder": {
     "vercel": "alibaba/qwen3-coder"
   },
@@ -32071,6 +32713,9 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "qwen3.7-max": {
     "vercel": "alibaba/qwen3.7-max"
   },
+  "qwen3.7-plus": {
+    "vercel": "alibaba/qwen3.7-plus"
+  },
   "seed-1-6": {
     "vercel": "bytedance/seed-1.6"
   },
@@ -32095,6 +32740,18 @@ var MODEL_FAMILY_PROVIDER_IDS = {
   "sonar-reasoning-pro": {
     "vercel": "perplexity/sonar-reasoning-pro"
   },
+  "step-3-5-flash": {
+    "vercel": "stepfun/step-3.5-flash"
+  },
+  "step-3-7-flash": {
+    "vercel": "stepfun/step-3.7-flash"
+  },
+  "step-3.5-flash": {
+    "vercel": "stepfun/step-3.5-flash"
+  },
+  "step-3.7-flash": {
+    "vercel": "stepfun/step-3.7-flash"
+  },
   "text-embedding-005": {
     "vercel": "google/text-embedding-005"
   },
@@ -34599,6 +35256,23 @@ var platformCatalogSchema = external_exports.object({
     maxFlowsPerProduct: external_exports.number().int().positive(),
     maxStepsPerFlow: external_exports.number().int().positive(),
     maxSurfacesPerProduct: external_exports.number().int().positive()
+  }),
+  /**
+   * Agent Skills — loadable SKILL.md context bundles a deployed agent pulls into
+   * its working context on demand. Distinct from A2A AgentSkill (agent-card
+   * roles). Flag-gated, so it's described here rather than listed as a fixed
+   * catalog (skills are user-authored, not a built-in set).
+   */
+  agentSkills: external_exports.object({
+    /** Rollout flag controlling availability; off in production until ramped. */
+    rolloutFlag: external_exports.string(),
+    description: external_exports.string(),
+    /** How an agent acquires a bound skill at runtime. */
+    loadModel: external_exports.string(),
+    /** One-line summary of the two-plane governance split. */
+    governance: external_exports.string(),
+    /** REST base path for the admin/control plane. */
+    restBase: external_exports.string()
   })
 });
 var PLATFORM_CATALOG = {
@@ -34708,6 +35382,13 @@ var PLATFORM_CATALOG = {
     maxFlowsPerProduct: 10,
     maxStepsPerFlow: 40,
     maxSurfacesPerProduct: 8
+  },
+  agentSkills: {
+    rolloutFlag: "enable-agent-skills",
+    description: "Loadable SKILL.md context bundles (Anthropic frontmatter + a runtype: capability block) that a deployed agent pulls into its working context on demand.",
+    loadModel: "A bound skill is surfaced as a `skill:<slug>` virtual tool \u2014 the model loads it on demand (L1 description in the tool list \u2192 L2 markdown body returned on call); bound capabilities activate for later turns.",
+    governance: "Two-plane: admin/control plane (REST /v1/skills, scoped by SKILLS:READ/WRITE, no review queue) vs deployed-agent/data plane (propose_skill, review-by-default via /v1/skill-proposals).",
+    restBase: "/v1/skills"
   }
 };
 var SURFACE_TYPE_METADATA = {
@@ -35056,6 +35737,7 @@ var PLATFORM_FEATURES_SUMMARY = (() => {
 - **Built-in tools**: GPT Image 2 image generation, provider-native web search (OpenAI web search, Anthropic web search/fetch, xAI Live Search for Grok-3 series, xAI X Search / Web Search agentic tools for Grok-4 series), Exa (AI search), Firecrawl (simple web scraping), Browser Run tools (rendered markdown, HTML, screenshots, snapshots, selector scraping, JSON extraction, link harvesting \u2014 stateless), Browser Session tools (persistent interactive browsing: open, navigate, click, type, scroll, screenshot, evaluate, close), Browser Agent (autonomous higher-level alternative \u2014 give a natural-language goal plus a startUrl or sessionId and the agent navigates/clicks/extracts on its own), Store Asset (host any file from a URL or base64 inline content \u2014 returns a permanent public or signed private URL, downloads as attachment), Publish Page (host HTML that renders inline in the browser at a shareable 7-day /preview/ URL under a locked-down CSP), vector search, UCP commerce tools (discovery, catalog, cart, checkout, orders for any UCP-enabled merchant)
 - **Integrations**: ${integrations}
 - **Flow step types**: prompt, ${stepTypes}
+- **Agent Skills**: loadable SKILL.md context bundles an agent pulls in on demand via a \`skill:<slug>\` tool (L1 description \u2192 L2 body), optionally binding flows/subagents/tools. Gated behind the \`enable-agent-skills\` rollout flag. See the Agent Skills guide.
 - **Available models**: ${models}
 - **Surface types**: ${PLATFORM_CATALOG.availableSurfaceTypes.join(", ")}
 - **Limits**: max ${PLATFORM_CATALOG.limits.maxFlowsPerProduct} flows/product, max ${PLATFORM_CATALOG.limits.maxStepsPerFlow} steps/flow, max ${PLATFORM_CATALOG.limits.maxSurfacesPerProduct} surfaces/product`;
@@ -35188,6 +35870,7 @@ var DOCUMENTATION_TOPIC_MAP = {
   "types-entities": "runtype://types/entities",
   "orthogonal-tools": "runtype://catalog/orthogonal-tools",
   "builtin-tools": "runtype://catalog/builtin-tools",
+  "agent-skills": "runtype://catalog/skills",
   "external-tools": "runtype://guide/external-tools",
   "dashboard-links": "runtype://catalog/dashboard-links",
   "mock-ecommerce": "runtype://catalog/mock-ecommerce",
@@ -37154,8 +37837,7 @@ flowsCommand.command("list").description("List all flows").option("--limit <n>",
         title: "Your Flows",
         columns: [
           { key: "id", color: "green" },
-          { key: "name" },
-          { key: "description", color: "gray" }
+          { key: "name" }
         ],
         emptyMessage: "No flows found",
         total: getTotalCount(data.pagination)
@@ -37189,8 +37871,7 @@ flowsCommand.command("list").description("List all flows").option("--limit <n>",
         return React2.createElement(EntityCard, {
           fields: [
             { label: "ID", value: flow.id, color: "green" },
-            { label: "Name", value: flow.name },
-            { label: "Description", value: flow.description, color: "gray" }
+            { label: "Name", value: flow.name }
           ]
         });
       },
@@ -37214,7 +37895,6 @@ flowsCommand.command("get <id>").description("Get flow details").option("--json"
       printDetail("Flow", [
         { label: "ID", value: data.id },
         { label: "Name", value: data.name },
-        { label: "Description", value: data.description },
         { label: "Steps", value: data.stepCount ?? data.flowSteps?.length }
       ]);
     } catch (error51) {
@@ -37241,7 +37921,6 @@ flowsCommand.command("get <id>").description("Get flow details").option("--json"
           fields: [
             { label: "ID", value: flow.id, color: "green" },
             { label: "Name", value: flow.name },
-            { label: "Description", value: flow.description },
             { label: "Steps", value: flow.stepCount ?? flow.flowSteps?.length }
           ]
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtypelabs/cli",
-  "version": "2.16.0",
+  "version": "2.16.2",
   "description": "Command-line interface for Runtype AI platform",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "rosie-skills": "0.8.1",
     "yaml": "^2.8.3",
     "@runtypelabs/ink-components": "0.3.2",
-    "@runtypelabs/sdk": "2.2.0",
+    "@runtypelabs/sdk": "4.0.0",
     "@runtypelabs/terminal-animations": "0.2.1"
   },
   "devDependencies": {
@@ -35,8 +35,8 @@
     "tsup": "^8.0.2",
     "tsx": "^4.7.1",
     "typescript": "^5.3.3",
-    "vitest": "^4.0.18",
-    "@runtypelabs/shared": "1.6.2"
+    "vitest": "^4.1.0",
+    "@runtypelabs/shared": "1.7.0"
   },
   "engines": {
     "node": ">=22.0.0"