@llamaventures/cli 1.17.3 → 1.18.0

package/AGENT_BRIEFING.md

@@ -29,6 +29,7 @@ This npm package is public, but Llama OS skills are private. Do not assume the s
 - Use `llama agent-onboard` or MCP `agent_briefing` for the server-owned Agent Runtime Contract. The npm-bundled text is fallback only.
 - Use `llama skills search "<task>"` or MCP `skills_search` before choosing a Llama workflow.
 - Use `llama skills show <slug>` or MCP `skills_read` only for the relevant skill.
+- Use `llama activity new-deals|updated-deals` or MCP `activity_query` before scanning raw deal timelines for recent portfolio movement.
 - Use `llama explain <command-url-or-object>` or MCP `object_inspect` for 404s, deleted wiki pages, notifier links, deal URLs, and unknown Command objects before telling the user "the system is broken."
 
 The boundary matters: public CLI/MCP discovers skills, but authenticated Command decides which skill content the token may read.
@@ -296,7 +297,7 @@ Run `llama --help` for the full surface (~40 commands).
 
 ## MCP-native agents
 
-If you support [MCP](https://modelcontextprotocol.io), **prefer the MCP server over parsing CLI output.** The same package ships `llama-mcp` (56 typed tools, identical auth chain).
+If you support [MCP](https://modelcontextprotocol.io), **prefer the MCP server over parsing CLI output.** The same package ships `llama-mcp` (59 typed tools, identical auth chain).
 
 Add to your MCP client config (Claude Desktop / Claude Code / Cursor / OpenClaw / Codex / etc.):
 
@@ -309,6 +310,7 @@ Tools available:
 - `auth_status` — verify creds + identity (call first if anything 401s)
 - `agent_bootstrap` — fetch the live Command + Llama OS runtime manifest
 - `skills_search` / `skills_read` — discover and read authenticated runtime skills
+- `activity_query` — query new deals and meaningful updates without scanning raw timelines
 - `object_inspect` — explain Command URLs, 404s, deleted objects, and lifecycle trail
 - `deal_search` / `deal_show` / `deal_create` / `deal_update`
 - `brief_blocks` / `brief_add_text` / `brief_add_link` / `brief_add_callout`

package/CHANGELOG.md

@@ -6,6 +6,14 @@ this project adheres to [Semantic Versioning](https://semver.org).
 
 ## [Unreleased]
 
+## [1.18.0] - 2026-07-06
+
+### Added
+- `llama activity new-deals|updated-deals|events` plus MCP `activity_query`
+  for agent-friendly reads over Command's curated activity projection. Agents
+  can ask for recent deal creations or meaningful deal updates without scanning
+  raw timelines or event-bus payloads.
+
 ## [1.17.3] - 2026-07-01
 
 ### Changed
@@ -492,7 +500,10 @@ assistant-drafted (🤖) and enforces the AI trust ceiling.
 
 ---
 
-[Unreleased]: https://github.com/Llama-Ventures/llama-cli/compare/v1.17.1...HEAD
+[Unreleased]: https://github.com/Llama-Ventures/llama-cli/compare/v1.18.0...HEAD
+[1.18.0]: https://github.com/Llama-Ventures/llama-cli/compare/v1.17.3...v1.18.0
+[1.17.3]: https://github.com/Llama-Ventures/llama-cli/compare/v1.17.2...v1.17.3
+[1.17.2]: https://github.com/Llama-Ventures/llama-cli/compare/v1.17.1...v1.17.2
 [1.17.1]: https://github.com/Llama-Ventures/llama-cli/compare/v1.17.0...v1.17.1
 [1.17.0]: https://github.com/Llama-Ventures/llama-cli/compare/v1.16.0...v1.17.0
 [1.16.0]: https://github.com/Llama-Ventures/llama-cli/compare/v1.15.1...v1.16.0

package/README.md

@@ -7,7 +7,7 @@
 <p align="center">
   <strong>The Llama Ventures CLI &amp; MCP server.</strong><br/>
   One package, two binaries: <code>llama</code> — the CLI for humans and scripts —
-  and <code>llama-mcp</code> — a stdio MCP server with 58 typed tools for any
+  and <code>llama-mcp</code> — a stdio MCP server with 59 typed tools for any
   MCP-native agent. Both share the same auth chain, HTTP client, and error
   format, and talk to <a href="https://command.llamaventures.vc">command.llamaventures.vc</a>.
 </p>
@@ -94,6 +94,8 @@ schema forward-compatibility. Prefer it even from scripts.
 llama deal search "acme ai"            # find deals (deal list takes the same filters)
 llama deal show <dealId>
 llama deal feed <dealId>               # every contribution, newest first
+llama activity new-deals --since 24h   # recent deal creations
+llama activity updated-deals --since 7d # meaningful updates grouped by deal
 llama deal create "Acme AI" --source alex --source-direction Outbound --status Interested
 llama deal update <dealId> status Diligence
 llama post <dealId> "note body"
@@ -125,7 +127,7 @@ Authenticated calls send bounded, content-redacted telemetry to Command;
 
 ## MCP server
 
-`llama-mcp` is a stdio Model Context Protocol server exposing 58 typed tools
+`llama-mcp` is a stdio Model Context Protocol server exposing 59 typed tools
 that mirror the most-used CLI surface. Every tool is named and scoped — there
 is deliberately no generic API passthrough. Auth is identical to the CLI's
 chain. For the exact live list, pipe `tools/list` through it:

package/README.zh-CN.md

@@ -7,7 +7,7 @@
 <p align="center">
   <strong>Llama Ventures 的 CLI 与 MCP server。</strong><br/>
   一个包、两个可执行文件：<code>llama</code>——给人和脚本用的 CLI；
-  <code>llama-mcp</code>——带 58 个类型化工具的 stdio MCP server，任何
+  <code>llama-mcp</code>——带 59 个类型化工具的 stdio MCP server，任何
   MCP 原生 agent 都能接。两者共享同一认证链、同一 HTTP 客户端、同一错误格式，
   连接 <a href="https://command.llamaventures.vc">command.llamaventures.vc</a>。
 </p>
@@ -116,6 +116,8 @@ CLI 是 canonical 接口——认证、错误格式、schema 前向兼容都由
 llama deal search "acme ai"            # 找 deal（deal list 用同一套过滤参数）
 llama deal show <dealId>
 llama deal feed <dealId>               # 该 deal 的全部贡献，最新在前
+llama activity new-deals --since 24h   # 最近新建的 deal
+llama activity updated-deals --since 7d # 按 deal 聚合的实质更新
 llama deal create "Acme AI" --source alex --source-direction Outbound --status Interested
 llama deal update <dealId> status Diligence
 llama post <dealId> "备注内容"
@@ -145,7 +147,7 @@ MCP server 在 `isError: true` 内容里返回相同前缀。认证请求会向
 
 ## MCP server
 
-`llama-mcp` 是 stdio MCP server，58 个类型化工具镜像 CLI 最常用的命令面。
+`llama-mcp` 是 stdio MCP server，59 个类型化工具镜像 CLI 最常用的命令面。
 每个工具具名、有边界——**故意不提供**通用 API passthrough。认证链与 CLI
 完全一致。精确工具清单以 `tools/list` 为准：
 

package/bin/llama-mcp.mjs

@@ -349,6 +349,41 @@ server.registerTool(
   }
 );
 
+server.registerTool(
+  "activity_query",
+  {
+    description:
+      "Read Command's curated agent activity projection. Use this before " +
+      "scanning raw timelines or event-bus payloads. Examples: new deals in " +
+      "the past 24h, deals with meaningful updates in the past 7d, or recent " +
+      "fact/memo/brief events. Returns source ids so callers can drill down.",
+    inputSchema: {
+      kind: z
+        .enum(["events", "new_deals", "updated_deals"])
+        .default("events")
+        .describe("events = raw curated rows; new_deals = deal.created; updated_deals = grouped meaningful deal updates"),
+      since: z.string().optional().describe("24h, 7d, 30d, or ISO timestamp; default 24h"),
+      limit: z.number().optional().describe("default 50, cap 100"),
+      dealId: z.string().optional().describe("optional single deal UUID"),
+      entity: z.enum(["deal", "wiki", "all"]).optional().describe("default deal"),
+      verb: z.string().optional().describe("comma-separated activity verbs, e.g. fact.added,brief.revised"),
+      cursor: z.number().optional().describe("pagination cursor from next_cursor"),
+      minSignificance: z.number().optional().describe("1..3; default 2, new_deals default 3"),
+    },
+  },
+  async ({ kind, since, limit, dealId, entity, verb, cursor, minSignificance } = {}) => {
+    const params = new URLSearchParams({ kind: kind || "events" });
+    if (since) params.set("since", since);
+    if (limit) params.set("limit", String(limit));
+    if (dealId) params.set("deal_id", dealId);
+    if (entity) params.set("entity", entity);
+    if (verb) params.set("verb", verb);
+    if (cursor) params.set("cursor", String(cursor));
+    if (minSignificance) params.set("min_sig", String(minSignificance));
+    return callApi("GET", `/api/agent/activity?${params}`);
+  }
+);
+
 // ============================================================
 // Deals — read
 // ============================================================

package/bin/llama.mjs

@@ -291,6 +291,38 @@ async function searchDeals(q, flags) {
   return result;
 }
 
+function buildActivityQuery(kind, flags) {
+  const params = new URLSearchParams({ kind });
+  const mappings = [
+    ["since", "since"],
+    ["limit", "limit"],
+    ["cursor", "cursor"],
+    ["before-id", "before_id"],
+    ["before_id", "before_id"],
+    ["deal", "deal"],
+    ["deal-id", "deal_id"],
+    ["deal_id", "deal_id"],
+    ["entity", "entity"],
+    ["min-sig", "min_sig"],
+    ["min_sig", "min_sig"],
+    ["min-significance", "min_sig"],
+  ];
+  for (const [flag, param] of mappings) {
+    if (flags[flag] !== undefined && flags[flag] !== true) {
+      params.set(param, String(flags[flag]));
+    }
+  }
+  for (const verb of splitCsvFlag(flags.verb) ?? []) {
+    params.append("verb", verb);
+  }
+  return params;
+}
+
+async function fetchActivity(kind, flags) {
+  const params = buildActivityQuery(kind, flags);
+  return request("GET", `/api/agent/activity?${params}`);
+}
+
 function splitCsvFlag(value) {
   if (!value || value === true) return undefined;
   return String(value)
@@ -367,6 +399,8 @@ Agent onboarding (run once on first install):
   llama agent bootstrap                # fetch live Command + Llama OS skill manifest
   llama skills search "pipeline update" # discover relevant runtime skills
   llama skills show llama-pipeline      # read a skill from Command
+  llama activity new-deals --since 24h  # recent deal creations for agents
+  llama activity updated-deals --since 7d # meaningful deal updates, grouped
   llama explain <url-or-object>         # explain Command URL/object status + lifecycle
   llama eval good|bad --last            # mark the latest CLI/MCP result for eval
   llama eval add "<query>" --expect wiki:<slug>|deal:<uuid>
@@ -418,6 +452,13 @@ Deals:
                             [--limit 200] [--offset 0]
   llama deal list [--owner ...] [--status ...] [...same flags as search]
 
+Agent activity (read-only, cheap read model over append-only activity):
+  llama activity new-deals [--since 24h|7d|<ISO>] [--limit 50]
+  llama activity updated-deals [--since 24h|7d|<ISO>] [--limit 50] [--deal <uuid>]
+  llama activity events [--since 24h] [--verb fact.added,brief.revised] [--entity deal|wiki|all]
+      Use this before scanning raw timelines or event-bus payloads. It returns
+      JSON from Command's curated activity_events projection: source ids included.
+
 Collaborators (besides owner — attribution candidates, no approval):
   llama deal collab list <dealId>
   llama deal collab add <dealId> --user <userId|email>
@@ -614,6 +655,8 @@ Common:
   llama deal show <dealId>          full deal record
   llama deal feed <dealId>          every contribution (facts + notes), newest first
   llama post <dealId> "..."         add a note to a deal
+  llama activity new-deals --since 24h  recent deal creations
+  llama activity updated-deals --since 7d meaningful deal updates
   llama agent-onboard               print the AI-agent workflow contract
   llama agent bootstrap             live Llama OS skill manifest from Command
   llama skills search "<query>"     discover which skill to read
@@ -622,6 +665,7 @@ Common:
 
 Command groups — run \`llama help <group>\` for that group's commands:
   deal        create · show · feed · update · enrich · search · collaborators · links · delete
+  activity    new-deals · updated-deals · events for agent read models
   brief       brief blocks: list · add · edit · history · refresh
   facts       deal facts + skill corrections (the sourced, trust-rated layer)
   timeline    timeline · posts · mentions
@@ -644,6 +688,7 @@ the CLI auto-detects it — no token needed (\`llc_\` tokens are a fallback).`;
 // Area → which top-level sections of HELP_FULL belong to it.
 const HELP_AREA_MATCH = {
   deal: [/^Deals/, /^Collaborators/, /^Soft-delete/, /^Deal links/, /^Deal soft-delete/],
+  activity: [/^Agent activity/],
   brief: [/^Brief blocks/, /^Brief \/ persona/],
   facts: [/^Deal facts/, /^Skill corrections/],
   timeline: [/^Timeline/, /^Mentions/],
@@ -1043,6 +1088,40 @@ async function main() {
     return;
   }
 
+  if (area === "activity") {
+    const sub = action || "events";
+    const normalized = sub.replace(/-/g, "_");
+    const kind =
+      normalized === "new" || normalized === "new_deal" || normalized === "new_deals"
+        ? "new_deals"
+        : normalized === "updated" || normalized === "updates" || normalized === "updated_deal" || normalized === "updated_deals"
+          ? "updated_deals"
+          : normalized === "event" || normalized === "events" || normalized === "feed" || normalized === "all"
+            ? "events"
+            : null;
+    if (!kind) {
+      throw new Error("Usage: llama activity new-deals|updated-deals|events [--since 24h] [--limit 50]");
+    }
+    const { flags } = parseFlags(rest, [
+      "json",
+      "since",
+      "limit",
+      "cursor",
+      "before-id",
+      "before_id",
+      "deal",
+      "deal-id",
+      "deal_id",
+      "entity",
+      "verb",
+      "min-sig",
+      "min_sig",
+      "min-significance",
+    ]);
+    print(await fetchActivity(kind, flags));
+    return;
+  }
+
   if (area === "skills" || (area === "agent" && action === "skills")) {
     const sub = area === "skills" ? action : rest[0];
     const args = area === "skills" ? rest : rest.slice(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llamaventures/cli",
-  "version": "1.17.3",
+  "version": "1.18.0",
   "description": "CLI + MCP server for the Llama Ventures investment workbench (command.llamaventures.vc).",
   "type": "module",
   "scripts": {