@runtypelabs/cli 2.16.1 → 2.16.2

package/dist/index.js

@@ -15259,6 +15259,28 @@ var agentReflectionEventSchema = external_exports.object({
   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"),
@@ -15307,6 +15329,8 @@ var agentSSEEventSchema = external_exports.discriminatedUnion("type", [
   agentAwaitEventSchema,
   agentIterationCompleteEventSchema,
   agentReflectionEventSchema,
+  agentSkillLoadedEventSchema,
+  agentSkillProposedEventSchema,
   agentCompleteEventSchema,
   agentErrorEventSchema,
   agentPingEventSchema
@@ -28839,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",
@@ -31777,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"
@@ -31798,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"
@@ -32565,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"
   },
@@ -32650,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"
   },
@@ -35190,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 = {
@@ -35299,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 = {
@@ -35647,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`;
@@ -35779,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",
@@ -37745,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)
@@ -37780,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 }
           ]
         });
       },
@@ -37805,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) {
@@ -37832,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.1",
+  "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": "3.0.0",
+    "@runtypelabs/sdk": "4.0.0",
     "@runtypelabs/terminal-animations": "0.2.1"
   },
   "devDependencies": {
@@ -36,7 +36,7 @@
     "tsx": "^4.7.1",
     "typescript": "^5.3.3",
     "vitest": "^4.1.0",
-    "@runtypelabs/shared": "1.6.2"
+    "@runtypelabs/shared": "1.7.0"
   },
   "engines": {
     "node": ">=22.0.0"