@rivus/agent 0.1.1 → 0.4.0

package/examples/a-share-overseas-evidence.mjs

@@ -0,0 +1,86 @@
+import { readAShareProviderResponse } from "./a-share-provider-response.mjs";
+
+const SOURCE = "腾讯证券海外指数公开行情";
+const MAX_AGE_MS = 4 * 24 * 60 * 60 * 1000;
+const INDEXES = Object.freeze([
+  { name: "道琼斯", symbol: "usDJI" },
+  { name: "纳斯达克", symbol: "usIXIC" },
+  { name: "标普 500", symbol: "usINX" }
+]);
+
+export async function readAShareOverseasEvidence({ occurrence }) {
+  const url = new URL("https://qt.gtimg.cn/");
+  url.searchParams.set("q", INDEXES.map(({ symbol }) => symbol).join(","));
+  const responseBody = await readAShareProviderResponse({
+    accept: "text/plain",
+    maxBytes: 64 * 1024,
+    referer: "https://finance.qq.com/",
+    source: "a-share overseas evidence",
+    url
+  });
+  const body = new TextDecoder("gbk").decode(responseBody);
+  const quotes = INDEXES.map((index) => parseQuote(index, body));
+  const asOf = quotes
+    .map(({ providerTime }) => providerTime)
+    .sort((left, right) => left.localeCompare(right))
+    .at(-1);
+  if (new Set(quotes.map(({ providerTime }) => providerTime)).size !== 1) {
+    throw new Error("a-share overseas evidence timestamps are inconsistent");
+  }
+  const age = providerClockTime(occurrence) - providerClockTime(asOf);
+  if (age < 0 || age > MAX_AGE_MS) throw new Error("a-share overseas evidence is stale for the occurrence");
+  return Object.freeze({ asOf, quotes: Object.freeze(quotes), source: SOURCE });
+}
+
+function providerClockTime(value) {
+  if (value.includes("T")) {
+    const parts = new Intl.DateTimeFormat("en-CA", {
+      day: "2-digit",
+      hour: "2-digit",
+      hourCycle: "h23",
+      minute: "2-digit",
+      month: "2-digit",
+      second: "2-digit",
+      timeZone: "America/New_York",
+      year: "numeric"
+    }).formatToParts(new Date(value));
+    const read = (type) => parts.find((part) => part.type === type)?.value;
+    return Date.parse(
+      `${read("year")}-${read("month")}-${read("day")}T${read("hour")}:${read("minute")}:${read("second")}Z`
+    );
+  }
+  return Date.parse(`${value.replace(" ", "T")}Z`);
+}
+
+function parseQuote(index, body) {
+  const match = body.match(new RegExp(`(?:^|\\n)v_${index.symbol}="([^"]+)";`, "u"));
+  if (!match) throw new Error(`a-share overseas evidence is missing ${index.symbol}`);
+  const fields = match[1].split("~");
+  const providerTime = fields[30];
+  if (!/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/.test(providerTime ?? "")) {
+    throw new Error(`a-share overseas evidence is missing a timestamp for ${index.symbol}`);
+  }
+  if (!isValidProviderTimestamp(providerTime)) {
+    throw new Error(`a-share overseas evidence has an invalid timestamp for ${index.symbol}`);
+  }
+  if (fields[35] !== "USD") throw new Error(`a-share overseas evidence has an unexpected currency for ${index.symbol}`);
+  return Object.freeze({
+    changePercent: readFiniteNumber(fields[32], index.symbol, "change percent"),
+    name: index.name,
+    price: readFiniteNumber(fields[3], index.symbol, "price"),
+    providerTime,
+    symbol: index.symbol
+  });
+}
+
+function isValidProviderTimestamp(value) {
+  const normalized = value.replace(" ", "T");
+  const timestamp = Date.parse(`${normalized}Z`);
+  return Number.isFinite(timestamp) && new Date(timestamp).toISOString().slice(0, 19) === normalized;
+}
+
+function readFiniteNumber(value, symbol, field) {
+  const number = Number(value);
+  if (!Number.isFinite(number)) throw new Error(`a-share overseas evidence is missing ${field} for ${symbol}`);
+  return number;
+}

package/examples/a-share-policy-evidence.mjs

@@ -0,0 +1,145 @@
+import { readAShareProviderResponse } from "./a-share-provider-response.mjs";
+
+const LOOKBACK_MS = 3 * 24 * 60 * 60 * 1000;
+
+export async function readASharePolicyEvidence({ occurrence }) {
+  const occurrenceTime = Date.parse(occurrence);
+  const readers = [
+    { read: readPbcHeadlines, source: "中国人民银行" },
+    { read: readCsrcHeadlines, source: "中国证监会" }
+  ];
+  const settled = await Promise.allSettled(readers.map(({ read }) => read()));
+  const available = settled.flatMap((result, index) =>
+    result.status === "fulfilled" ? [{ items: result.value, source: readers[index].source }] : []
+  );
+  if (available.length === 0) throw new Error("a-share policy evidence sources are unavailable");
+  const items = available
+    .flatMap(({ items }) => items)
+    .filter(({ publishedAt }) => {
+      const publishedTime = Date.parse(publishedAt);
+      return publishedTime <= occurrenceTime && publishedTime >= occurrenceTime - LOOKBACK_MS;
+    })
+    .sort((left, right) => right.publishedAt.localeCompare(left.publishedAt))
+    .slice(0, 4);
+  const sources = available.map(({ source }) => source);
+  const unavailableSources = settled.flatMap((result, index) =>
+    result.status === "rejected" ? [readers[index].source] : []
+  );
+  return Object.freeze({
+    items: Object.freeze(items),
+    sources: Object.freeze(sources),
+    unavailableSources: Object.freeze(unavailableSources)
+  });
+}
+
+async function readPbcHeadlines() {
+  const url = new URL("https://www.pbc.gov.cn/goutongjiaoliu/113456/113469/index.html");
+  const body = await readText(url, "中国人民银行");
+  const items = [];
+  const pattern =
+    /<a\s+([^>]*\bistitle="true"[^>]*)>[\s\S]*?<\/a>\s*<\/font>\s*<span[^>]*>\s*(\d{4}-\d{2}-\d{2})\s*<\/span>/giu;
+  for (const match of body.matchAll(pattern)) {
+    const href = readHtmlAttribute(match[1], "href");
+    const title = decodeHtml(readHtmlAttribute(match[1], "title"));
+    if (!href || !title || title.length > 200) continue;
+    const itemUrl = normalizeSourceUrl(href, url, "www.pbc.gov.cn");
+    if (!itemUrl) continue;
+    items.push(
+      Object.freeze({
+        publishedAt: readPbcPublishedAt(itemUrl, match[2]),
+        source: "中国人民银行",
+        title,
+        url: itemUrl
+      })
+    );
+    if (items.length === 2) break;
+  }
+  if (items.length === 0) throw new Error("PBC policy evidence contains no valid headlines");
+  return Object.freeze(items);
+}
+
+function readPbcPublishedAt(itemUrl, displayedDate) {
+  const timestamp = new URL(itemUrl).pathname.match(/\/(\d{14})\d*\/index\.html$/u)?.[1];
+  if (!timestamp) return `${displayedDate}T23:59:59+08:00`;
+  return `${timestamp.replace(/^(\d{4})(\d{2})(\d{2})(\d{2})(\d{2})(\d{2})$/u, "$1-$2-$3T$4:$5:$6")}+08:00`;
+}
+
+async function readCsrcHeadlines() {
+  const url = new URL("https://www.csrc.gov.cn/searchList/a1a078ee0bc54721ab6b148884c784a8");
+  url.searchParams.set("_isAgg", "true");
+  url.searchParams.set("_isJson", "true");
+  url.searchParams.set("_pageSize", "5");
+  url.searchParams.set("_template", "index");
+  url.searchParams.set("_rangeTimeGte", "");
+  url.searchParams.set("_channelName", "");
+  url.searchParams.set("page", "1");
+  const body = await readText(url, "中国证监会", 256 * 1024);
+  let payload;
+  try {
+    payload = JSON.parse(body);
+  } catch (cause) {
+    throw new Error("CSRC policy evidence is not valid JSON", { cause });
+  }
+  const results = Array.isArray(payload?.data?.results) ? payload.data.results : undefined;
+  if (!results) throw new Error("CSRC policy evidence contains no result list");
+  const items = results
+    .flatMap((row) => {
+      if (
+        typeof row?.title !== "string" ||
+        !row.title ||
+        row.title.length > 200 ||
+        typeof row?.url !== "string" ||
+        !/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/.test(row?.publishedTimeStr ?? "")
+      ) {
+        return [];
+      }
+      const itemUrl = normalizeSourceUrl(row.url, url, "www.csrc.gov.cn");
+      if (!itemUrl) return [];
+      return [
+        Object.freeze({
+          publishedAt: `${row.publishedTimeStr.replace(" ", "T")}+08:00`,
+          source: "中国证监会",
+          title: row.title,
+          url: itemUrl
+        })
+      ];
+    })
+    .slice(0, 2);
+  if (items.length === 0) throw new Error("CSRC policy evidence contains no valid headlines");
+  return Object.freeze(items);
+}
+
+async function readText(url, source, maxBytes = 128 * 1024) {
+  const body = await readAShareProviderResponse({
+    accept: "text/html,application/json",
+    maxBytes,
+    referer: `${url.origin}/`,
+    source: `${source} policy evidence`,
+    url
+  });
+  return body.toString("utf8");
+}
+
+function readHtmlAttribute(attributes, name) {
+  return attributes.match(new RegExp(`\\b${name}="([^"]+)"`, "iu"))?.[1];
+}
+
+function normalizeSourceUrl(value, baseUrl, expectedHostname) {
+  let url;
+  try {
+    url = new URL(value, baseUrl);
+  } catch {
+    return undefined;
+  }
+  if (url.protocol !== "https:" || url.hostname !== expectedHostname) return undefined;
+  return url.href;
+}
+
+function decodeHtml(value) {
+  return value
+    .replaceAll("&amp;", "&")
+    .replaceAll("&quot;", '"')
+    .replaceAll("&#39;", "'")
+    .replaceAll("&lt;", "<")
+    .replaceAll("&gt;", ">");
+}

package/examples/a-share-provider-response.mjs

@@ -0,0 +1,21 @@
+import { readBoundedHttpsResponse } from "./https-response-reader.mjs";
+
+export async function readAShareProviderResponse({ accept, maxBytes, referer, source, url }) {
+  let response;
+  try {
+    response = await readBoundedHttpsResponse(url, {
+      headers: {
+        accept,
+        referer,
+        "user-agent": "rivus-a-share-market-briefing/1.1"
+      },
+      maxBytes
+    });
+  } catch (cause) {
+    throw new Error(`${source} request failed`, { cause });
+  }
+  if (response.status < 200 || response.status >= 300) {
+    throw new Error(`${source} request failed with HTTP ${response.status}`);
+  }
+  return response.body;
+}

package/examples/a-share-sector-evidence.mjs

@@ -0,0 +1,70 @@
+import { dateInShanghai } from "./a-share-market-date.mjs";
+import { readAShareProviderResponse } from "./a-share-provider-response.mjs";
+
+const SOURCE = "东方财富行业板块公开行情";
+
+export async function readAShareSectorEvidence({ marketDate }) {
+  const [leaders, laggards] = await Promise.all([readSectorRanking(true), readSectorRanking(false)]);
+  const sectors = [...leaders, ...laggards];
+  const asOf = sectors
+    .map(({ asOf }) => asOf)
+    .sort((left, right) => left.localeCompare(right))
+    .at(-1);
+  if (!sectors.every((sector) => dateInShanghai(new Date(sector.asOf)) === marketDate)) {
+    throw new Error("a-share sector evidence is stale for the market date");
+  }
+  return Object.freeze({ asOf, laggards, leaders, source: SOURCE });
+}
+
+async function readSectorRanking(descending) {
+  const url = new URL("https://push2delay.eastmoney.com/api/qt/clist/get");
+  url.searchParams.set("pn", "1");
+  url.searchParams.set("pz", "3");
+  url.searchParams.set("po", descending ? "1" : "0");
+  url.searchParams.set("np", "1");
+  url.searchParams.set("fltt", "2");
+  url.searchParams.set("invt", "2");
+  url.searchParams.set("fid", "f3");
+  url.searchParams.set("fs", "m:90+t:2");
+  url.searchParams.set("fields", "f12,f14,f3,f124");
+  const body = await readAShareProviderResponse({
+    accept: "application/json",
+    maxBytes: 64 * 1024,
+    referer: "https://quote.eastmoney.com/",
+    source: "a-share sector evidence",
+    url
+  });
+  return parseSectorRanking(body.toString("utf8"));
+}
+
+function parseSectorRanking(body) {
+  let payload;
+  try {
+    payload = JSON.parse(body);
+  } catch (cause) {
+    throw new Error("a-share sector evidence is not valid JSON", { cause });
+  }
+  const rows = payload?.rc === 0 && Array.isArray(payload?.data?.diff) ? payload.data.diff : undefined;
+  if (!rows || rows.length !== 3) throw new Error("a-share sector evidence must contain three ranked industries");
+  return Object.freeze(
+    rows.map((row) => {
+      if (
+        typeof row?.f12 !== "string" ||
+        !row.f12 ||
+        typeof row?.f14 !== "string" ||
+        !row.f14 ||
+        !Number.isFinite(row?.f3) ||
+        !Number.isSafeInteger(row?.f124) ||
+        row.f124 <= 0
+      ) {
+        throw new Error("a-share sector evidence contains an invalid industry record");
+      }
+      return Object.freeze({
+        asOf: new Date(row.f124 * 1000).toISOString(),
+        changePercent: row.f3,
+        id: row.f12,
+        name: row.f14
+      });
+    })
+  );
+}

package/examples/acp-stdio-proxy.mjs

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+
+import {
+  createAcpAgentServer,
+  createAcpPermissionBridge,
+  createAcpStdioAgentLoop,
+  serveAcpAgentOnStdio
+} from "@rivus/agent/acp";
+
+const command = process.env.RIVUS_ACP_SERVER_COMMAND?.trim();
+if (!command) throw new Error("RIVUS_ACP_SERVER_COMMAND is required and must resolve to an explicit executable");
+
+const workingDirectory = process.env.RIVUS_ACP_WORKING_DIRECTORY?.trim() || process.cwd();
+const permissionBridge = createAcpPermissionBridge();
+const downstream = createAcpStdioAgentLoop({
+  arguments: parseArguments(process.env.RIVUS_ACP_SERVER_ARGUMENTS),
+  command,
+  environment: selectEnvironment(process.env.RIVUS_ACP_SERVER_ENV_KEYS),
+  onStderr: (text) => process.stderr.write(text),
+  permissionPolicy: permissionBridge.policy,
+  workingDirectory
+});
+const server = createAcpAgentServer({
+  agentName: "rivus-acp-proxy",
+  loop: downstream.loop,
+  permissionBridge,
+  workingDirectory
+});
+
+try {
+  await serveAcpAgentOnStdio(server);
+} finally {
+  await downstream.dispose();
+}
+
+function parseArguments(value) {
+  if (!value?.trim()) return [];
+  const parsed = JSON.parse(value);
+  if (!Array.isArray(parsed) || parsed.some((item) => typeof item !== "string")) {
+    throw new Error("RIVUS_ACP_SERVER_ARGUMENTS must be a JSON array of strings");
+  }
+  return parsed;
+}
+
+function selectEnvironment(value) {
+  const selected = {};
+  for (const key of value
+    ?.split(",")
+    .map((item) => item.trim())
+    .filter(Boolean) ?? []) {
+    const environmentValue = process.env[key];
+    if (environmentValue !== undefined) selected[key] = environmentValue;
+  }
+  return selected;
+}

package/examples/current-weather.mjs

@@ -1,4 +1,4 @@
-import { get } from "node:https";
+import { readBoundedHttpsResponse } from "./https-response-reader.mjs";
 
 export async function readCurrentWeather(input) {
   if (input !== undefined && (typeof input !== "object" || input === null || Array.isArray(input))) {
@@ -60,7 +60,10 @@ export async function readCurrentWeather(input) {
 async function fetchJson(url, operation) {
   let response;
   try {
-    response = await requestJson(url);
+    response = await readBoundedHttpsResponse(url, {
+      headers: { accept: "application/json" },
+      maxBytes: 1024 * 1024
+    });
   } catch (error) {
     throw new Error(`${operation} failed: ${error instanceof Error ? error.message : String(error)}`, {
       cause: error
@@ -71,7 +74,7 @@ async function fetchJson(url, operation) {
   }
   let value;
   try {
-    value = JSON.parse(response.body);
+    value = JSON.parse(response.body.toString("utf8"));
   } catch {
     throw new Error(`${operation} returned invalid JSON`);
   }
@@ -81,35 +84,6 @@ async function fetchJson(url, operation) {
   return value;
 }
 
-function requestJson(url) {
-  return new Promise((resolve, reject) => {
-    const request = get(
-      url,
-      {
-        family: 4,
-        headers: { accept: "application/json" },
-        signal: AbortSignal.timeout(10_000)
-      },
-      (response) => {
-        const status = response.statusCode ?? 0;
-        response.once("error", reject);
-        if (status < 200 || status >= 300) {
-          response.resume();
-          resolve({ body: "", status });
-          return;
-        }
-        let body = "";
-        response.setEncoding("utf8");
-        response.on("data", (chunk) => {
-          body += chunk;
-        });
-        response.once("end", () => resolve({ body, status }));
-      }
-    );
-    request.once("error", reject);
-  });
-}
-
 function readNumber(value, field) {
   if (typeof value !== "number" || !Number.isFinite(value)) throw new Error(`current-weather missing ${field}`);
   return value;

package/examples/https-response-reader.mjs

@@ -0,0 +1,36 @@
+import { get } from "node:https";
+
+export function readBoundedHttpsResponse(url, options) {
+  return new Promise((resolve, reject) => {
+    const request = get(
+      url,
+      {
+        family: 4,
+        headers: options.headers,
+        signal: AbortSignal.timeout(options.timeoutMs ?? 10_000)
+      },
+      (response) => {
+        const status = response.statusCode ?? 0;
+        response.once("error", reject);
+        if (status < 200 || status >= 300) {
+          response.resume();
+          resolve({ body: Buffer.alloc(0), status });
+          return;
+        }
+        const chunks = [];
+        let length = 0;
+        response.on("data", (chunk) => {
+          const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+          length += buffer.length;
+          if (length > options.maxBytes) {
+            request.destroy(new Error(`HTTPS response exceeds ${options.maxBytes} bytes`));
+            return;
+          }
+          chunks.push(buffer);
+        });
+        response.once("end", () => resolve({ body: Buffer.concat(chunks), status }));
+      }
+    );
+    request.once("error", reject);
+  });
+}

package/examples/pi-feishu-deployment.bootstrap.ts

@@ -15,7 +15,7 @@ import {
   createAgentHarness,
   createAgentHarnessPooledRuntime,
   createRivusMemoryToolDescriptor,
-  createConfiguredFeishuMarkdownMessageSender,
+  createConfiguredFeishuAutomationCardSender,
   createConfiguredFeishuCardKitPublisher,
   createConfiguredFeishuCardKitTargetPreparation,
   createConfiguredFeishuHumanInteractionPresenter,
@@ -113,7 +113,7 @@ export async function createRivusDeploymentAdapters(context: RivusDeploymentBoot
         pi: {}
       };
       const openApiClient = createOpenApiClient(config);
-      const sender = createConfiguredFeishuMarkdownMessageSender({
+      const sender = createConfiguredFeishuAutomationCardSender({
         client: openApiClient,
         config
       });

package/examples/rivus-agents.plugin.mjs

@@ -3,21 +3,31 @@ import { createHash } from "node:crypto";
 import { join } from "node:path";
 
 import { readCurrentWeather } from "./current-weather.mjs";
+import { readAShareMarketBriefing } from "./a-share-market-briefing.mjs";
 import { createHtmlArtifactWriter, createLarkDriveHtmlUploader } from "./html-drive-tools.mjs";
 
 const TOOL_IDS = {
+  aShareMarketBriefing: "rivus-example-agents/a-share-market-briefing",
   currentWeather: "rivus-example-agents/current-weather",
   larkDriveUploadHtml: "rivus-example-agents/lark-drive-upload-html",
   runtimeInfo: "rivus-example-agents/runtime-info",
   saveNote: "rivus-example-agents/save-note",
   writeHtmlArtifact: "rivus-example-agents/write-html-artifact"
 };
-const ALLOWED_TOOL_IDS = [TOOL_IDS.runtimeInfo, TOOL_IDS.saveNote, TOOL_IDS.currentWeather];
+const AGENT_A_TOOL_IDS = [
+  TOOL_IDS.runtimeInfo,
+  TOOL_IDS.saveNote,
+  TOOL_IDS.currentWeather,
+  TOOL_IDS.aShareMarketBriefing
+];
+const AGENT_B_TOOL_IDS = [TOOL_IDS.runtimeInfo, TOOL_IDS.saveNote, TOOL_IDS.currentWeather];
 const WEATHER_INSTRUCTION =
   "遇到当前或今日天气问题时必须调用 current-weather；用户未指定地点时不要猜测，省略 location 并在回答中明确说明工具返回的默认地点。";
 const MEMORY_INSTRUCTION =
   "用户明确要求记住、回忆或遗忘偏好时，必须调用 rivus_memory；propose 会持久化一条可在同 Scope 后续检索的待确认候选，不得声称用户已经确认，也不得声称候选尚未写入。";
 const DAILY_WORD_AUTOMATION_ID = "rivus-example-agents/daily-ielts-word";
+const A_SHARE_PRE_MARKET_AUTOMATION_ID = "rivus-example-agents/a-share-pre-market";
+const A_SHARE_POST_MARKET_AUTOMATION_ID = "rivus-example-agents/a-share-post-market";
 const LANGFUSE_PUBLISHER_SKILL_ID = "rivus-example-agents/langfuse-html-publisher";
 const LANGFUSE_PUBLISHER_SKILL = Object.freeze({
   content: [
@@ -101,6 +111,25 @@ export default {
       risk: "observe",
       version: "1.0.0"
     });
+    registry.registerTool({
+      createExecutor: () => ({ execute: readAShareMarketBriefing }),
+      description:
+        "Read a bounded, evidence-backed A-share pre-market or post-market analysis briefing with attributed facts, labeled inferences, source time, and stale-data handling",
+      digest: "sha256:example-a-share-market-briefing-v3",
+      id: TOOL_IDS.aShareMarketBriefing,
+      idempotency: "none",
+      inputSchema: {
+        additionalProperties: false,
+        properties: {
+          occurrence: { format: "date-time", type: "string" },
+          session: { enum: ["pre-market", "post-market"], type: "string" }
+        },
+        required: ["session", "occurrence"],
+        type: "object"
+      },
+      risk: "observe",
+      version: "1.1.0"
+    });
     registry.registerTool({
       createExecutor: () => createHtmlArtifactWriter(),
       description:
@@ -161,7 +190,7 @@ export default {
       model: {},
       skills: { allow: [] },
       systemPrompt: `You are Rivus Agent A. Be concise, analytical, and explicit about evidence. ${WEATHER_INSTRUCTION} ${MEMORY_INSTRUCTION}`,
-      tools: { allow: ALLOWED_TOOL_IDS }
+      tools: { allow: AGENT_A_TOOL_IDS }
     });
     registry.registerAgentProfile({
       displayName: "Rivus Agent B",
@@ -170,7 +199,7 @@ export default {
       model: {},
       skills: { allow: [] },
       systemPrompt: `You are Rivus Agent B. Focus on independent verification and clearly state uncertainty. ${WEATHER_INSTRUCTION} ${MEMORY_INSTRUCTION}`,
-      tools: { allow: ALLOWED_TOOL_IDS }
+      tools: { allow: AGENT_B_TOOL_IDS }
     });
     registry.registerAgentProfile({
       displayName: "Rivus Langfuse publishing demo",
@@ -200,9 +229,32 @@ export default {
       requestedSkillIds: [],
       requestedToolIds: []
     });
+    registry.registerAutomation(createAShareAutomation(A_SHARE_PRE_MARKET_AUTOMATION_ID, "pre-market"));
+    registry.registerAutomation(createAShareAutomation(A_SHARE_POST_MARKET_AUTOMATION_ID, "post-market"));
   }
 };
 
+function createAShareAutomation(id, session) {
+  const label = session === "pre-market" ? "盘前" : "盘后";
+  return {
+    createInput: ({ occurrence }) => {
+      const parameters = JSON.stringify({ session, occurrence });
+      return {
+        text: [
+          `计划发生时间：${occurrence}。生成 A 股${label}简报。`,
+          `必须且只调用一次 ${TOOL_IDS.aShareMarketBriefing}，参数严格使用：${parameters}。`,
+          "工具返回的 markdown 字段已区分市场事实和分析推断并列出来源，就是最终交付正文；必须原样输出，不增加开场、解释、预测、荐股、因果归因或任何工具结果之外的数字。",
+          "如果工具失败，不得估算或补全行情，让本次 Automation 明确失败以便按同一 Tick 重试。"
+        ].join("\n")
+      };
+    },
+    id,
+    profileId: "agent-a",
+    requestedSkillIds: [],
+    requestedToolIds: [TOOL_IDS.aShareMarketBriefing]
+  };
+}
+
 async function saveNote(input, context) {
   if (
     !input ||

package/examples/rivus-starter.plugin.mjs

@@ -0,0 +1,45 @@
+import { readCurrentWeather } from "./current-weather.mjs";
+
+const TOOL_ID = "rivus-starter/current-weather";
+
+export default {
+  manifest: {
+    apiVersion: "1",
+    id: "rivus-starter",
+    version: "1.0.0"
+  },
+  register(registry) {
+    registry.registerTool({
+      createExecutor: () => ({ execute: readCurrentWeather }),
+      description:
+        "Read current conditions and today's forecast from Open-Meteo, using the configured default when location is omitted",
+      digest: "sha256:rivus-starter-current-weather-v1",
+      id: TOOL_ID,
+      idempotency: "none",
+      inputSchema: {
+        additionalProperties: false,
+        properties: {
+          location: {
+            description: "City or place name. Omit it when the user did not specify one.",
+            maxLength: 100,
+            minLength: 1,
+            type: "string"
+          }
+        },
+        type: "object"
+      },
+      risk: "observe",
+      version: "1.0.0"
+    });
+    registry.registerAgentProfile({
+      displayName: "Rivus Agent",
+      id: "agent-a",
+      memory: { scopes: [] },
+      model: {},
+      skills: { allow: [] },
+      systemPrompt:
+        "You are a concise local assistant. For current or today's weather, call current-weather. If the user did not name a location, omit location and report the Tool's resolved place.",
+      tools: { allow: [TOOL_ID] }
+    });
+  }
+};