@rivus/agent 0.3.1 → 0.4.0

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/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.config.json

@@ -18,7 +18,8 @@
         "allow": [
           "rivus-example-agents/runtime-info",
           "rivus-example-agents/save-note",
-          "rivus-example-agents/current-weather"
+          "rivus-example-agents/current-weather",
+          "rivus-example-agents/a-share-market-briefing"
         ]
       }
     },
@@ -52,6 +53,34 @@
         "targetRef": "env:RIVUS_DAILY_IELTS_WORD_TARGET",
         "targetType": "union_id"
       }
+    },
+    {
+      "id": "a-share-pre-market",
+      "agentId": "agent-a",
+      "templateId": "rivus-example-agents/a-share-pre-market",
+      "enabled": false,
+      "required": true,
+      "schedule": "0 9 * * 1-5",
+      "timeZone": "Asia/Shanghai",
+      "delivery": {
+        "endpointId": "feishu-agent-a",
+        "targetRef": "env:RIVUS_A_SHARE_BRIEFING_TARGET",
+        "targetType": "union_id"
+      }
+    },
+    {
+      "id": "a-share-post-market",
+      "agentId": "agent-a",
+      "templateId": "rivus-example-agents/a-share-post-market",
+      "enabled": false,
+      "required": true,
+      "schedule": "0 16 * * 1-5",
+      "timeZone": "Asia/Shanghai",
+      "delivery": {
+        "endpointId": "feishu-agent-a",
+        "targetRef": "env:RIVUS_A_SHARE_BRIEFING_TARGET",
+        "targetType": "union_id"
+      }
     }
   ],
   "endpoints": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rivus/agent",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "A local agent daemon core built around a usable agent harness and domain events.",
   "type": "module",
   "license": "MIT",
@@ -30,6 +30,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./acp": {
+      "types": "./dist/acp.d.ts",
+      "import": "./dist/acp.js"
+    },
     "./testing": {
       "types": "./dist/testing/index.d.ts",
       "import": "./dist/testing/index.js"
@@ -47,7 +51,7 @@
     "access": "public"
   },
   "scripts": {
-    "audit": "npm audit --audit-level=high",
+    "audit": "npm audit --omit=dev --audit-level=high",
     "build": "vp pack",
     "changeset": "changeset",
     "changeset:status": "changeset status",
@@ -78,10 +82,14 @@
     "typebox": "^1.1.38"
   },
   "peerDependencies": {
+    "@agentclientprotocol/sdk": "^1.3.0",
     "@earendil-works/pi-coding-agent": "0.80.6",
     "@larksuiteoapi/node-sdk": "^1.70.0"
   },
   "peerDependenciesMeta": {
+    "@agentclientprotocol/sdk": {
+      "optional": true
+    },
     "@earendil-works/pi-coding-agent": {
       "optional": true
     },
@@ -90,6 +98,7 @@
     }
   },
   "devDependencies": {
+    "@agentclientprotocol/sdk": "^1.3.0",
     "@changesets/cli": "^2.31.1",
     "@earendil-works/pi-coding-agent": "0.80.6",
     "@larksuiteoapi/node-sdk": "1.71.1",