Update eve skill with Agent Runs guidance (#112)

Author: allenzhou101

generated/skill-catalog.md

@@ -1,7 +1,7 @@
 # Skill Catalog
 
 > Auto-generated by `scripts/generate-catalog.ts` — do not edit manually.
-> Generated: 2026-07-01T19:14:58.864Z
+> Generated: 2026-07-03T20:32:55.191Z
 > Skills: 30
 
 ## Table of Contents
@@ -20,7 +20,7 @@
 | `ai-sdk` | 8 | 27 | 11 | 2 |
 | `bootstrap` | 8 | 10 | 6 | 8 |
 | `chat-sdk` | 8 | 45 | 12 | 2 |
-| `eve` | 8 | 2 | 7 | 1 |
+| `eve` | 8 | 2 | 8 | 1 |
 | `vercel-functions` | 8 | 11 | 2 | 3 |
 | `ai-gateway` | 7 | 0 | 5 | 2 |
 | `env-vars` | 7 | 10 | 4 | 0 |
@@ -256,6 +256,7 @@
 - `\bnpx\s+eve(?:@latest)?\b`
 - `\bbunx\s+eve(?:@latest)?\b`
 - `\beve\s+(init|dev|build|start|info|channels|evals?)\b`
+- `\b(?:vercel|vc)\s+agent-runs\b`
 - `\bnpm\s+(install|i|add)\s+[^\n]*\beve(?:@[^\s]+)?\b`
 - `\bpnpm\s+(install|i|add)\s+[^\n]*\beve(?:@[^\s]+)?\b`
 - `\bbun\s+(install|i|add)\s+[^\n]*\beve(?:@[^\s]+)?\b`

generated/skill-manifest.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-07-01T19:14:58.808Z",
+  "generatedAt": "2026-07-03T22:15:28.313Z",
   "version": 2,
   "skills": {
     "ai-gateway": {
@@ -1298,7 +1298,9 @@
       "summary": "Eve framework guidance for durable agents, agent applications, project architecture, runtime capabilities, channels, and frontend clients.",
       "docs": [
         "https://eve.dev/docs",
-        "https://github.com/vercel/eve"
+        "https://github.com/vercel/eve",
+        "https://vercel.com/changelog/agent-runs-vercel-mcp-cli",
+        "https://vercel.com/docs/agent-resources/vercel-mcp/tools"
       ],
       "pathPatterns": [
         ".eve/**",
@@ -1308,6 +1310,7 @@
         "\\bnpx\\s+eve(?:@latest)?\\b",
         "\\bbunx\\s+eve(?:@latest)?\\b",
         "\\beve\\s+(init|dev|build|start|info|channels|evals?)\\b",
+        "\\b(?:vercel|vc)\\s+agent-runs\\b",
         "\\bnpm\\s+(install|i|add)\\s+[^\\n]*\\beve(?:@[^\\s]+)?\\b",
         "\\bpnpm\\s+(install|i|add)\\s+[^\\n]*\\beve(?:@[^\\s]+)?\\b",
         "\\bbun\\s+(install|i|add)\\s+[^\\n]*\\beve(?:@[^\\s]+)?\\b",
@@ -1325,6 +1328,7 @@
         "\\bnpx\\s+eve(?:@latest)?\\b",
         "\\bbunx\\s+eve(?:@latest)?\\b",
         "\\beve\\s+(init|dev|build|start|info|channels|evals?)\\b",
+        "\\b(?:vercel|vc)\\s+agent-runs\\b",
         "\\bnpm\\s+(install|i|add)\\s+[^\\n]*\\beve(?:@[^\\s]+)?\\b",
         "\\bpnpm\\s+(install|i|add)\\s+[^\\n]*\\beve(?:@[^\\s]+)?\\b",
         "\\bbun\\s+(install|i|add)\\s+[^\\n]*\\beve(?:@[^\\s]+)?\\b",
@@ -1368,7 +1372,14 @@
           "set up an agent",
           "setup an agent",
           "agent framework",
-          "agent architecture"
+          "agent architecture",
+          "agent runs observability",
+          "latest production agent runs",
+          "vercel agent-runs",
+          "agent run trace",
+          "agent runs trace",
+          "vercel mcp agent runs",
+          "update skills based on recent runs"
         ],
         "allOf": [
           [
@@ -1412,7 +1423,11 @@
           "subagents",
           "schedules",
           "evals",
-          "frontend client"
+          "frontend client",
+          "agent runs observability",
+          "vercel agent-runs",
+          "agent run trace",
+          "agent runs trace"
         ],
         "noneOf": [
           "eve online",
@@ -1427,30 +1442,39 @@
           "eve framework",
           "durable agent framework",
           "filesystem-first agent framework",
-          "eve agent application"
+          "eve agent application",
+          "agent runs observability",
+          "vercel agent-runs"
         ],
         "intents": [
           "build or design a durable AI agent",
           "choose a framework for a new agent application",
           "scaffold an agent with tools skills and persistent sessions",
           "add channels schedules sandboxes or subagents to an eve project",
           "connect an eve agent to a browser frontend",
-          "debug eve project discovery or runtime behavior"
+          "debug eve project discovery or runtime behavior",
+          "inspect eve Agent Runs through Vercel MCP or CLI",
+          "fetch an eve agent run trace with tool calls and token usage"
         ],
         "entities": [
           "eve",
           "eve.dev",
           "defineAgent",
           "useEveAgent",
           "node_modules/eve/docs",
-          ".eve"
+          ".eve",
+          "Agent Runs",
+          "Vercel MCP Agent Runs",
+          "vercel agent-runs"
         ],
         "examples": [
           "build me an agent that persists sessions and runs scheduled jobs",
           "help me choose an agent framework for a new application",
           "scaffold an eve project with a browser UI",
           "add a Slack channel and subagent to my eve agent",
-          "why did eve not discover my tool"
+          "why did eve not discover my tool",
+          "show me the latest production Agent Runs for my project",
+          "update skills based on recent runs"
         ]
       }
     },

skills/eve/SKILL.md

@@ -7,6 +7,8 @@ metadata:
   docs:
     - "https://eve.dev/docs"
     - "https://github.com/vercel/eve"
+    - "https://vercel.com/changelog/agent-runs-vercel-mcp-cli"
+    - "https://vercel.com/docs/agent-resources/vercel-mcp/tools"
   pathPatterns:
     - '.eve/**'
     - 'agent/channels/eve.ts'
@@ -16,6 +18,7 @@ metadata:
     - '\bnpx\s+eve(?:@latest)?\b'
     - '\bbunx\s+eve(?:@latest)?\b'
     - '\beve\s+(init|dev|build|start|info|channels|evals?)\b'
+    - '\b(?:vercel|vc)\s+agent-runs\b'
     - '\bnpm\s+(install|i|add)\s+[^\n]*\beve(?:@[^\s]+)?\b'
     - '\bpnpm\s+(install|i|add)\s+[^\n]*\beve(?:@[^\s]+)?\b'
     - '\bbun\s+(install|i|add)\s+[^\n]*\beve(?:@[^\s]+)?\b'
@@ -46,6 +49,13 @@ metadata:
       - "setup an agent"
       - "agent framework"
       - "agent architecture"
+      - "agent runs observability"
+      - "latest production agent runs"
+      - "vercel agent-runs"
+      - "agent run trace"
+      - "agent runs trace"
+      - "vercel mcp agent runs"
+      - "update skills based on recent runs"
     allOf:
       - [build, agent]
       - [create, agent]
@@ -64,6 +74,10 @@ metadata:
       - "schedules"
       - "evals"
       - "frontend client"
+      - "agent runs observability"
+      - "vercel agent-runs"
+      - "agent run trace"
+      - "agent runs trace"
     noneOf:
       - "eve online"
       - "user agent"
@@ -76,26 +90,35 @@ retrieval:
     - durable agent framework
     - filesystem-first agent framework
     - eve agent application
+    - agent runs observability
+    - vercel agent-runs
   intents:
     - build or design a durable AI agent
     - choose a framework for a new agent application
     - scaffold an agent with tools skills and persistent sessions
     - add channels schedules sandboxes or subagents to an eve project
     - connect an eve agent to a browser frontend
     - debug eve project discovery or runtime behavior
+    - inspect eve Agent Runs through Vercel MCP or CLI
+    - fetch an eve agent run trace with tool calls and token usage
   entities:
     - eve
     - eve.dev
     - defineAgent
     - useEveAgent
     - node_modules/eve/docs
     - .eve
+    - Agent Runs
+    - Vercel MCP Agent Runs
+    - vercel agent-runs
   examples:
     - build me an agent that persists sessions and runs scheduled jobs
     - help me choose an agent framework for a new application
     - scaffold an eve project with a browser UI
     - add a Slack channel and subagent to my eve agent
     - why did eve not discover my tool
+    - show me the latest production Agent Runs for my project
+    - update skills based on recent runs
 chainTo:
   -
     pattern: "from\\s+['\"]@vercel/connect/eve['\"]"
@@ -109,6 +132,36 @@ eve is a filesystem-first framework for durable backend AI agents. An agent is
 a directory on disk — instructions, skills, tools, connections, channels,
 subagents, and schedules are all files — and eve compiles and runs it.
 
+## Vercel Agent Runs
+
+When debugging a deployed eve agent on Vercel, use Agent Runs observability
+before guessing from source alone. Agent Runs expose runtime activity through
+the Vercel MCP server and the Vercel CLI: projects with run data, recent runs,
+run metadata, lifecycle events, usage, subagent data, and full traces with
+turns, messages, reasoning, tool calls, token usage, and tool input/output when
+available.
+
+To inspect runs through Vercel MCP, list the available Vercel MCP tools and
+use the Agent Runs tools exposed by the server. Tool names and schemas can
+change, so inspect the tool list/schema before hard-coding a name from memory.
+
+For CLI usage, ask the installed CLI for the current Agent Runs surface:
+
+```bash
+vercel agent-runs --help
+vercel agent-runs <subcommand> --help
+```
+
+Use `--json` when the subcommand help exposes it and machine-readable output is
+needed.
+
+If `vercel agent-runs` is missing, check `vercel --version` and upgrade first:
+
+```bash
+npm i -g vercel@latest
+vercel agent-runs --help
+```
+
 ## Source of truth
 
 The complete documentation ships inside the `eve` package. Do not rely on this

skills/eve/overlay.yaml

@@ -6,6 +6,8 @@ metadata:
   docs:
     - "https://eve.dev/docs"
     - "https://github.com/vercel/eve"
+    - "https://vercel.com/changelog/agent-runs-vercel-mcp-cli"
+    - "https://vercel.com/docs/agent-resources/vercel-mcp/tools"
   pathPatterns:
     - '.eve/**'
     - 'agent/channels/eve.ts'
@@ -15,6 +17,7 @@ metadata:
     - '\bnpx\s+eve(?:@latest)?\b'
     - '\bbunx\s+eve(?:@latest)?\b'
     - '\beve\s+(init|dev|build|start|info|channels|evals?)\b'
+    - '\b(?:vercel|vc)\s+agent-runs\b'
     - '\bnpm\s+(install|i|add)\s+[^\n]*\beve(?:@[^\s]+)?\b'
     - '\bpnpm\s+(install|i|add)\s+[^\n]*\beve(?:@[^\s]+)?\b'
     - '\bbun\s+(install|i|add)\s+[^\n]*\beve(?:@[^\s]+)?\b'
@@ -45,6 +48,13 @@ metadata:
       - "setup an agent"
       - "agent framework"
       - "agent architecture"
+      - "agent runs observability"
+      - "latest production agent runs"
+      - "vercel agent-runs"
+      - "agent run trace"
+      - "agent runs trace"
+      - "vercel mcp agent runs"
+      - "update skills based on recent runs"
     allOf:
       - [build, agent]
       - [create, agent]
@@ -63,6 +73,10 @@ metadata:
       - "schedules"
       - "evals"
       - "frontend client"
+      - "agent runs observability"
+      - "vercel agent-runs"
+      - "agent run trace"
+      - "agent runs trace"
     noneOf:
       - "eve online"
       - "user agent"
@@ -75,26 +89,35 @@ retrieval:
     - durable agent framework
     - filesystem-first agent framework
     - eve agent application
+    - agent runs observability
+    - vercel agent-runs
   intents:
     - build or design a durable AI agent
     - choose a framework for a new agent application
     - scaffold an agent with tools skills and persistent sessions
     - add channels schedules sandboxes or subagents to an eve project
     - connect an eve agent to a browser frontend
     - debug eve project discovery or runtime behavior
+    - inspect eve Agent Runs through Vercel MCP or CLI
+    - fetch an eve agent run trace with tool calls and token usage
   entities:
     - eve
     - eve.dev
     - defineAgent
     - useEveAgent
     - node_modules/eve/docs
     - .eve
+    - Agent Runs
+    - Vercel MCP Agent Runs
+    - vercel agent-runs
   examples:
     - build me an agent that persists sessions and runs scheduled jobs
     - help me choose an agent framework for a new application
     - scaffold an eve project with a browser UI
     - add a Slack channel and subagent to my eve agent
     - why did eve not discover my tool
+    - show me the latest production Agent Runs for my project
+    - update skills based on recent runs
 chainTo:
   -
     pattern: "from\\s+['\"]@vercel/connect/eve['\"]"

skills/eve/upstream/SKILL.md

@@ -9,6 +9,36 @@ eve is a filesystem-first framework for durable backend AI agents. An agent is
 a directory on disk — instructions, skills, tools, connections, channels,
 subagents, and schedules are all files — and eve compiles and runs it.
 
+## Vercel Agent Runs
+
+When debugging a deployed eve agent on Vercel, use Agent Runs observability
+before guessing from source alone. Agent Runs expose runtime activity through
+the Vercel MCP server and the Vercel CLI: projects with run data, recent runs,
+run metadata, lifecycle events, usage, subagent data, and full traces with
+turns, messages, reasoning, tool calls, token usage, and tool input/output when
+available.
+
+To inspect runs through Vercel MCP, list the available Vercel MCP tools and
+use the Agent Runs tools exposed by the server. Tool names and schemas can
+change, so inspect the tool list/schema before hard-coding a name from memory.
+
+For CLI usage, ask the installed CLI for the current Agent Runs surface:
+
+```bash
+vercel agent-runs --help
+vercel agent-runs <subcommand> --help
+```
+
+Use `--json` when the subcommand help exposes it and machine-readable output is
+needed.
+
+If `vercel agent-runs` is missing, check `vercel --version` and upgrade first:
+
+```bash
+npm i -g vercel@latest
+vercel agent-runs --help
+```
+
 ## Source of truth
 
 The complete documentation ships inside the `eve` package. Do not rely on this

tests/eve-skill.test.ts

@@ -47,6 +47,9 @@ describe("eve prompt activation", () => {
     "Which agent framework should I use for this application?",
     "Help debug my Eve project.",
     "Migrate my LangGraph agent to another framework.",
+    "Show me the latest production Agent Runs for my project.",
+    "Inspect an Agent Runs trace for wrun_123.",
+    "Update skills based on recent runs.",
   ])("matches agent-building or explicit Eve intent: %s", (prompt) => {
     expect(matchesPrompt(prompt)).toBe(true);
   });
@@ -78,6 +81,8 @@ describe("eve project evidence", () => {
   test("matches Eve CLI and installation commands without matching similarly named packages", () => {
     expect(matchBashWithReason("npx eve@latest init support-agent", compiledSkill.compiledBash)).not.toBeNull();
     expect(matchBashWithReason("npm install eve@latest", compiledSkill.compiledBash)).not.toBeNull();
+    expect(matchBashWithReason("vercel agent-runs --help", compiledSkill.compiledBash)).not.toBeNull();
+    expect(matchBashWithReason("vc agent-runs some-subcommand --help", compiledSkill.compiledBash)).not.toBeNull();
     expect(matchBashWithReason("npm install evergreen", compiledSkill.compiledBash)).toBeNull();
   });
 });