@rivus/agent 0.3.1 → 0.4.0

package/dist/index.js

@@ -1,10 +1,11 @@
+import { a as createAgentLoopSkillExecutionStart, c as createAgentLoopToolExecutionEnd, d as createAsyncIterableAgentLoop, f as createEventAgentLoop, i as createAgentLoopSkillExecutionEnd, l as createAgentLoopToolExecutionStart, m as createTextAgentLoopFromCallback, n as createAgentLoopModelExecutionEnd, o as createAgentLoopTextDelta, p as createTextAgentLoop, r as createAgentLoopModelExecutionStart, s as createAgentLoopThinkingDelta, t as createAgentLoopFromCallback, u as createAgentLoopToolExecutionUpdate } from "./agent-loop.js";
 import { a as RIVUS_MEMORY_TOOL_ID, c as createMemoryNamespace, d as InvalidRivusPlugin, f as RIVUS_PLUGIN_API_VERSION, i as MEMORY_SCOPES, l as createRivusMemoryToolContract, m as requiresToolApproval, n as resolveRivusAgentDefinition, o as RIVUS_MEMORY_TOOL_PLUGIN_ID, p as RivusToolInputRejected, s as RIVUS_MEMORY_TOOL_VERSION, t as createRivusPluginCatalog, u as restrictMemoryScopesForAudience } from "./rivus-plugin-registry.js";
 import { A as loadRivusDeployment, D as resolveFeishuEndpointCredentials, E as FeishuEndpointCredentialError, S as loadNodeRivusPluginModule, T as loadRivusDeploymentManifest, _ as OpenClawEnvImportError, a as RivusDeploymentDaemonLifecycleError, b as RivusDaemonConfigError, c as InvalidRivusEndpointBinding, d as AgentRuntimeDisposed, f as createAgentRuntimePool, g as createRivusDaemonShutdownController, h as createStableId, i as RivusDeploymentAutomationReadinessError, j as validateRivusDeploymentManifest, k as RivusPluginLoadError, l as createRivusAgentHost, m as createAgentInstanceRegistry, n as createRivusDeploymentCliProcess, o as RivusDeploymentReadinessError, p as AgentInstanceConflict, r as createConfiguredRivusDeploymentDaemon, s as createRivusDeploymentDaemon, t as runRivusDaemonCli, u as AgentInstanceBusy, v as createRivusEnvFromOpenClawConfig, w as RivusDeploymentManifestError, x as loadRivusDaemonConfig, y as formatRivusEnvFile } from "./rivus-daemon-cli.js";
 import { n as assertRivusPluginConforms, r as createFakeRivusPlugin, t as RivusPluginConformanceError } from "./rivus-plugin-testkit.js";
-import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { Cause, Deferred, Effect, Exit, Fiber, Option, Stream } from "effect";
-import { appendFile, lstat, mkdir, readFile, readdir, realpath, rename, stat, unlink, writeFile } from "node:fs/promises";
 import { createHash, randomUUID } from "node:crypto";
+import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { appendFile, lstat, mkdir, readFile, readdir, realpath, rename, stat, unlink, writeFile } from "node:fs/promises";
 import { isDeepStrictEqual } from "node:util";
 import { createServer } from "node:http";
 import { Buffer as Buffer$1 } from "node:buffer";
@@ -649,122 +650,6 @@ function assertNonNegativeInteger(value, name) {
 	if (!Number.isSafeInteger(value) || value < 0) throw new Error(`${name} must be a non-negative integer`);
 }
 //#endregion
-//#region src/application/agent/agent-loop.ts
-function createAgentLoopTextDelta(delta) {
-	return {
-		delta,
-		type: "assistant_text_delta"
-	};
-}
-function normalizeAgentLoopEvent(event) {
-	return typeof event === "string" ? createAgentLoopTextDelta(event) : event;
-}
-function createAgentLoopThinkingDelta(delta) {
-	return {
-		delta,
-		type: "assistant_thinking_delta"
-	};
-}
-function createAgentLoopModelExecutionStart(options) {
-	return {
-		...options,
-		type: "model_execution_start"
-	};
-}
-function createAgentLoopModelExecutionEnd(options) {
-	return {
-		...options,
-		type: "model_execution_end"
-	};
-}
-function createAgentLoopSkillExecutionStart(options) {
-	return {
-		...options,
-		type: "skill_execution_start"
-	};
-}
-function createAgentLoopSkillExecutionEnd(options) {
-	return {
-		...options,
-		type: "skill_execution_end"
-	};
-}
-function createAgentLoopToolExecutionStart(options) {
-	return {
-		input: options.input,
-		toolCallId: options.toolCallId,
-		toolName: options.toolName,
-		type: "tool_execution_start"
-	};
-}
-function createAgentLoopToolExecutionUpdate(options) {
-	return {
-		input: options.input,
-		partialResult: options.partialResult,
-		toolCallId: options.toolCallId,
-		toolName: options.toolName,
-		type: "tool_execution_update"
-	};
-}
-function createAgentLoopToolExecutionEnd(options) {
-	return {
-		isError: options.isError,
-		result: options.result,
-		toolCallId: options.toolCallId,
-		toolName: options.toolName,
-		type: "tool_execution_end"
-	};
-}
-function createEventAgentLoop(options) {
-	return { run: (input) => {
-		const events = typeof options.events === "function" ? options.events(input) : options.events;
-		if (isPromiseLike(events)) return Stream.fromEffect(Effect.tryPromise({
-			try: () => events,
-			catch: (cause) => cause
-		})).pipe(Stream.flatMap((resolvedEvents) => Stream.fromIterable(resolvedEvents)), Stream.map(normalizeAgentLoopEvent));
-		return Stream.fromIterable(events).pipe(Stream.map(normalizeAgentLoopEvent));
-	} };
-}
-function createAsyncIterableAgentLoop(options) {
-	return { run: (input) => Stream.fromAsyncIterable(options.run(input), (error) => error).pipe(Stream.map(normalizeAgentLoopEvent)) };
-}
-function createAgentLoopFromCallback(run) {
-	return { run: (input) => Stream.fromEffect(Effect.try({
-		try: () => run(input),
-		catch: (cause) => cause
-	})).pipe(Stream.flatMap(streamFromAgentLoopCallbackResult)) };
-}
-function createTextAgentLoop(options) {
-	return { run: (input) => Stream.fromEffect(options.generate(input)).pipe(Stream.map((delta) => createAgentLoopTextDelta(delta))) };
-}
-function createTextAgentLoopFromCallback(generate) {
-	return createTextAgentLoop({ generate: (input) => Effect.tryPromise({
-		try: async () => generate(input),
-		catch: (cause) => cause
-	}) });
-}
-function isPromiseLike(value) {
-	return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
-}
-function streamFromAgentLoopCallbackResult(result) {
-	if (Effect.isEffect(result)) return Stream.fromEffect(result).pipe(Stream.flatMap(streamFromAgentLoopCallbackOutput));
-	if (isPromiseLike(result)) return Stream.fromEffect(Effect.tryPromise({
-		try: () => Promise.resolve(result),
-		catch: (cause) => cause
-	})).pipe(Stream.flatMap(streamFromAgentLoopCallbackOutput));
-	return streamFromAgentLoopCallbackOutput(result);
-}
-function streamFromAgentLoopCallbackOutput(output) {
-	if (isEffectStream(output)) return output.pipe(Stream.map(normalizeAgentLoopEvent));
-	return (isAsyncIterable(output) ? Stream.fromAsyncIterable(output, (error) => error) : Stream.fromIterable(output)).pipe(Stream.map(normalizeAgentLoopEvent));
-}
-function isAsyncIterable(value) {
-	return Symbol.asyncIterator in value && typeof value[Symbol.asyncIterator] === "function";
-}
-function isEffectStream(value) {
-	return typeof value === "object" && value !== null && Stream.StreamTypeId in value;
-}
-//#endregion
 //#region src/infrastructure/http/json-fetch-request.ts
 function createJsonFetchRequest(options = {}) {
 	const fetchImpl = options.fetch ?? globalThis.fetch;
@@ -6170,7 +6055,7 @@ function createAutomationMandateStore() {
 //#endregion
 //#region src/application/automation/daily-automation-schedule.ts
 function createDailyAutomationSchedule(expression, timeZone, now = /* @__PURE__ */ new Date()) {
-	const { hour, minute } = parseDailySchedule(expression);
+	const { hour, minute, weekdays } = parseDailySchedule(expression);
 	try {
 		zonedParts(now, timeZone);
 	} catch (cause) {
@@ -6179,6 +6064,7 @@ function createDailyAutomationSchedule(expression, timeZone, now = /* @__PURE__
 	return Object.freeze({
 		currentOccurrence: (at) => {
 			const local = zonedParts(at, timeZone);
+			if (!matchesWeekday(local, weekdays)) return void 0;
 			const occurrence = zonedMinuteToInstant({
 				day: local.day,
 				hour,
@@ -6190,36 +6076,49 @@ function createDailyAutomationSchedule(expression, timeZone, now = /* @__PURE__
 		},
 		nextOccurrence: (at) => {
 			const local = zonedParts(at, timeZone);
-			const today = zonedMinuteToInstant({
-				day: local.day,
-				hour,
-				minute,
-				month: local.month,
-				year: local.year
-			}, timeZone);
-			if (today.getTime() > at.getTime()) return today;
-			const nextDate = new Date(Date.UTC(local.year, local.month - 1, local.day) + 864e5);
-			return zonedMinuteToInstant({
-				day: nextDate.getUTCDate(),
-				hour,
-				minute,
-				month: nextDate.getUTCMonth() + 1,
-				year: nextDate.getUTCFullYear()
-			}, timeZone);
+			const localDate = Date.UTC(local.year, local.month - 1, local.day);
+			for (let offsetDays = 0; offsetDays <= 7; offsetDays += 1) {
+				const date = new Date(localDate + offsetDays * 864e5);
+				const candidateParts = {
+					day: date.getUTCDate(),
+					hour,
+					minute,
+					month: date.getUTCMonth() + 1,
+					year: date.getUTCFullYear()
+				};
+				if (!matchesWeekday(candidateParts, weekdays)) continue;
+				const candidate = zonedMinuteToInstant(candidateParts, timeZone);
+				if (candidate.getTime() > at.getTime()) return candidate;
+			}
+			throw new Error(`Automation schedule does not resolve within one week: ${expression}`);
 		}
 	});
 }
 function parseDailySchedule(schedule) {
-	const match = /^(\d{1,2})\s+(\d{1,2})\s+\*\s+\*\s+\*$/.exec(schedule.trim());
+	const match = /^(\d{1,2})\s+(\d{1,2})\s+\*\s+\*\s+(\*|1-5)$/.exec(schedule.trim());
 	if (!match) throw new Error(`unsupported Automation schedule: ${schedule}`);
 	const minute = Number(match[1]);
 	const hour = Number(match[2]);
 	if (!Number.isInteger(minute) || minute < 0 || minute > 59 || !Number.isInteger(hour) || hour < 0 || hour > 23) throw new Error(`invalid Automation schedule: ${schedule}`);
-	return {
+	return match[3] === "1-5" ? {
+		hour,
+		minute,
+		weekdays: /* @__PURE__ */ new Set([
+			1,
+			2,
+			3,
+			4,
+			5
+		])
+	} : {
 		hour,
 		minute
 	};
 }
+function matchesWeekday(parts, weekdays) {
+	if (!weekdays) return true;
+	return weekdays.has(new Date(Date.UTC(parts.year, parts.month - 1, parts.day)).getUTCDay());
+}
 function zonedParts(date, timeZone) {
 	const parts = new Intl.DateTimeFormat("en-CA", {
 		day: "2-digit",
@@ -6311,7 +6210,7 @@ async function executeDue(options, schedule, at, claim) {
 	const occurrence = schedule.currentOccurrence(at);
 	if (!occurrence) return void 0;
 	const tick = claim(occurrence);
-	const existing = await options.repository.get(tick.mandateId, occurrence);
+	const existing = await options.repository.get(options.automationId, occurrence);
 	if (existing?.status === "delivered") return existing;
 	let record = existing;
 	if (record?.status !== "generated") {
@@ -6384,15 +6283,18 @@ const systemClock = {
 async function openJsonAutomationTickRepository(options) {
 	const records = /* @__PURE__ */ new Map();
 	const snapshot = await readSnapshot$1(options.filePath);
-	for (const record of snapshot.records) records.set(key(record.mandateId, record.occurrence), record);
+	for (const record of snapshot.records) {
+		const recordKey = key(record.automationId, record.occurrence);
+		records.set(recordKey, preferRecoveryRecord(records.get(recordKey), record));
+	}
 	let pendingWrite = Promise.resolve();
 	return {
-		get: async (mandateId, occurrence) => records.get(key(mandateId, occurrence)),
+		get: async (automationId, occurrence) => records.get(key(automationId, occurrence)),
 		put: async (record) => {
 			const stored = Object.freeze({ ...record });
 			const operation = pendingWrite.then(async () => {
 				const next = new Map(records);
-				next.set(key(record.mandateId, record.occurrence), stored);
+				next.set(key(record.automationId, record.occurrence), stored);
 				await writeSnapshot(options.filePath, [...next.values()]);
 				records.clear();
 				for (const [recordKey, value] of next) records.set(recordKey, value);
@@ -6407,13 +6309,13 @@ async function readSnapshot$1(filePath) {
 	const raw = await readPersistenceFile(filePath);
 	if (raw === void 0) return Object.freeze({
 		records: Object.freeze([]),
-		version: 2
+		version: 3
 	});
 	const value = JSON.parse(raw);
-	if (!isRecord$4(value) || value.version !== 2 || !Array.isArray(value.records)) throw new Error("Automation Tick snapshot must contain version 2 records");
+	if (!isRecord$4(value) || value.version !== 2 && value.version !== 3 || !Array.isArray(value.records)) throw new Error("Automation Tick snapshot must contain version 2 or 3 records");
 	return Object.freeze({
 		records: Object.freeze(value.records.map(readRecord)),
-		version: 2
+		version: value.version
 	});
 }
 async function writeSnapshot(filePath, records) {
@@ -6422,7 +6324,7 @@ async function writeSnapshot(filePath, records) {
 	try {
 		await writeFile(temporaryPath, `${JSON.stringify({
 			records,
-			version: 2
+			version: 3
 		})}\n`, {
 			encoding: "utf8",
 			flag: "wx"
@@ -6463,8 +6365,20 @@ function readRecord(value) {
 		tickId: value.tickId
 	});
 }
-function key(mandateId, occurrence) {
-	return `${mandateId}\0${occurrence}`;
+function key(automationId, occurrence) {
+	return `${automationId}\0${occurrence}`;
+}
+function preferRecoveryRecord(current, candidate) {
+	if (!current) return candidate;
+	return recoveryRank(candidate.status) >= recoveryRank(current.status) ? candidate : current;
+}
+function recoveryRank(status) {
+	switch (status) {
+		case "delivered": return 4;
+		case "generated": return 3;
+		case "failed": return 2;
+		case "running": return 1;
+	}
 }
 function isStatus(value) {
 	return value === "running" || value === "failed" || value === "generated" || value === "delivered";

package/dist/rivus-daemon-cli.js

@@ -1,10 +1,10 @@
 import { i as MEMORY_SCOPES, n as resolveRivusAgentDefinition, r as deepFreeze, t as createRivusPluginCatalog } from "./rivus-plugin-registry.js";
 import { createRequire } from "node:module";
+import { Effect } from "effect";
+import { createHash, randomUUID } from "node:crypto";
 import { pathToFileURL } from "node:url";
 import { dirname, isAbsolute, join, relative, sep } from "node:path";
-import { Effect } from "effect";
 import { open, readFile, realpath, stat } from "node:fs/promises";
-import { createHash, randomUUID } from "node:crypto";
 import { constants } from "node:fs";
 //#region src/application/plugin/rivus-automation-runtime-definition.ts
 function resolveRivusAutomationRuntimeDefinition(definition, requestedToolIds, requestedSkillIds) {
@@ -136,6 +136,9 @@ async function loadRivusDeployment(options) {
 	for (const automation of options.manifest.automations ?? []) {
 		const agent = agentStatusById.get(automation.agentId);
 		if (!agent || agent.status === "disabled" || !agent.definition) continue;
+		const deliveryEndpoint = options.manifest.endpoints.find(({ id }) => id === automation.delivery.endpointId);
+		const presentationAgent = agentStatusById.get(deliveryEndpoint.agentId);
+		if (!presentationAgent || presentationAgent.status === "disabled" || !presentationAgent.definition) continue;
 		const template = automationTemplates.get(automation.templateId);
 		if (!template) throw new Error(`automation ${automation.id} references unknown template: ${automation.templateId}`);
 		if (template.pluginId !== agent.pluginId || template.profileId !== agent.profileId) throw new Error(`automation ${automation.id} template is not owned by agent profile ${agent.profileId}`);
@@ -173,11 +176,10 @@ function validateRivusDeploymentManifest(manifest) {
 	for (const automation of manifest.automations ?? []) {
 		if (automationIds.has(automation.id)) throw new Error(`duplicate automation binding: ${automation.id}`);
 		automationIds.add(automation.id);
-		const agent = agentById.get(automation.agentId);
-		if (!agent) throw new Error(`automation ${automation.id} references unknown agent: ${automation.agentId}`);
+		if (!agentById.get(automation.agentId)) throw new Error(`automation ${automation.id} references unknown agent: ${automation.agentId}`);
 		const endpoint = manifest.endpoints.find(({ id }) => id === automation.delivery.endpointId);
 		if (!endpoint) throw new Error(`automation ${automation.id} references unknown delivery endpoint: ${automation.delivery.endpointId}`);
-		if (endpoint.agentId !== agent.agentId) throw new Error(`automation ${automation.id} delivery endpoint is bound to a different agent`);
+		if (automation.enabled && !endpoint.enabled) throw new Error(`automation ${automation.id} delivery endpoint must be enabled`);
 	}
 	const endpointIds = /* @__PURE__ */ new Set();
 	const sessionNamespaces = /* @__PURE__ */ new Set();
@@ -1067,13 +1069,15 @@ async function createRivusDeploymentDaemon(options) {
 			}
 			for (const slot of automationSlots) {
 				const resolvedDefinition = slot.resolvedDefinition;
-				const slotDegraded = await startSlot(slot, slot.agentEnabled && resolvedDefinition !== void 0, async () => {
+				const deliverySlot = slotById.get(slot.definition.delivery.endpointId);
+				const presentationReady = deliverySlot.lifecycle === "running" && (deliverySlot.adapter?.running() ?? false);
+				const slotDegraded = await startSlot(slot, slot.agentEnabled && resolvedDefinition !== void 0 && presentationReady, async () => {
 					if (!options.createAutomation) throw new RivusDeploymentDaemonLifecycleError("deployment bootstrap does not provide Automation adapters");
 					if (!resolvedDefinition) throw new RivusDeploymentDaemonLifecycleError(`automation definition not resolved: ${slot.definition.id}`);
 					return options.createAutomation({
 						automationId: slot.definition.id,
 						definition: resolvedDefinition,
-						deliveryEndpoint: slotById.get(slot.definition.delivery.endpointId).definition,
+						deliveryEndpoint: deliverySlot.definition,
 						instanceId: host.resolveAutomation(slot.definition.id).instanceId,
 						run: (input) => host.handleAutomation(slot.definition.id, {
 							invocation: {

package/dist/rivus-plugin-testkit.d.ts

@@ -1,100 +1,5 @@
-//#region src/domain/agent-memory.d.ts
-declare const MEMORY_SCOPES: readonly ["conversation", "agent-private", "shared-user-profile"];
-declare const RIVUS_MEMORY_TOOL_ID = "memory";
-declare const RIVUS_MEMORY_TOOL_PLUGIN_ID = "rivus-core";
-declare const RIVUS_MEMORY_TOOL_VERSION = "1.0.0";
-type MemoryScope = (typeof MEMORY_SCOPES)[number];
-type MemoryState = "proposed" | "confirmed" | "superseded" | "tombstoned";
-type MemoryInvocationAudience = "group" | "private";
-interface AgentMemoryIdentity {
-  readonly audience: MemoryInvocationAudience;
-  readonly conversationId?: string;
-  readonly subjectId: string;
-  readonly tenantId: string;
-}
-interface AgentMemoryAuthority extends AgentMemoryIdentity {
-  readonly scopes: ReadonlyArray<MemoryScope>;
-}
-interface MemoryBinding {
-  readonly agentId: string;
-  readonly conversationId?: string;
-  readonly scope: MemoryScope;
-  readonly subjectId: string;
-  readonly tenantId: string;
-}
-interface MemoryRecord {
-  readonly content: string;
-  readonly conversationSafe: boolean;
-  readonly id: string;
-  readonly revision: number;
-  readonly scope: MemoryScope;
-  readonly state: MemoryState;
-  readonly tombstoneReason?: string;
-}
-interface AgentMemorySnapshot {
-  readonly binding: MemoryBinding;
-  readonly record: MemoryRecord;
-}
-declare function createMemoryNamespace(binding: MemoryBinding): string;
-declare function restrictMemoryScopesForAudience(scopes: ReadonlyArray<MemoryScope>, audience: MemoryInvocationAudience): ReadonlyArray<MemoryScope>;
-declare function createRivusMemoryToolContract(scopes: ReadonlyArray<MemoryScope>): Readonly<{
-  description: "Search and read Memory inside Host-bound scopes; propose or request forgetting only in writable private scopes.";
-  digest: "sha256:rivus-memory-v3";
-  id: "memory";
-  idempotency: "required";
-  inputSchema: Readonly<{
-    additionalProperties: false;
-    properties: {
-      scope?: {
-        description: string;
-        enum: ("conversation" | "agent-private" | "shared-user-profile")[];
-        type: string;
-      };
-      command: {
-        description: string;
-        enum: string[];
-        type: string;
-      };
-      id: {
-        description: string;
-        minLength: number;
-        type: string;
-      };
-      input: {
-        additionalProperties: boolean;
-        description: string;
-        properties: {
-          content: {
-            minLength: number;
-            type: string;
-          };
-        };
-        required: string[];
-        type: string;
-      };
-      query: {
-        additionalProperties: boolean;
-        description: string;
-        properties: {
-          query: {
-            type: string;
-          };
-        };
-        required: string[];
-        type: string;
-      };
-      reason: {
-        description: string;
-        type: string;
-      };
-    };
-    required: string[];
-    type: "object";
-  }>;
-  risk: "mutate";
-  version: "1.0.0";
-}>;
-//#endregion
+import { c as MemoryScope, t as AgentMemoryAuthority } from "./agent-memory.js";
+
 //#region src/domain/rivus-plugin.d.ts
 declare const RIVUS_PLUGIN_API_VERSION = "1";
 type RivusToolRisk = "observe" | "mutate" | "irreversible" | "host-control";
@@ -288,4 +193,4 @@ declare class RivusPluginConformanceError extends Error {
 declare function assertRivusPluginConforms(input: RivusPluginConformanceInput): Promise<RivusPluginConformanceReport>;
 declare function createFakeRivusPlugin(): RivusPlugin;
 //#endregion
-export { RivusToolExecutionContext as A, AgentMemorySnapshot as B, RivusPluginCatalogSnapshot as C, RivusSkillDescriptor as D, RivusResolvedToolDescriptor as E, RivusToolInputRejected as F, MemoryScope as G, MemoryBinding as H, RivusToolRisk as I, RIVUS_MEMORY_TOOL_PLUGIN_ID as J, MemoryState as K, requiresToolApproval as L, RivusToolFactoryContext as M, RivusToolGrantSet as N, RivusSkillGrantSet as O, RivusToolIdempotency as P, restrictMemoryScopesForAudience as Q, AgentMemoryAuthority as R, RivusPluginCatalog as S, RivusPluginRegistry as T, MemoryInvocationAudience as U, MEMORY_SCOPES as V, MemoryRecord as W, createMemoryNamespace as X, RIVUS_MEMORY_TOOL_VERSION as Y, createRivusMemoryToolContract as Z, RivusAutomationInput as _, assertRivusPluginConforms as a, RivusHostToolDescriptor as b, RIVUS_PLUGIN_API_VERSION as c, RegisteredRivusPlugin as d, RegisteredRivusSkill as f, RivusAgentProfile as g, RivusAgentDeployment as h, RivusPluginLifecycleProbe as i, RivusToolExecutor as j, RivusToolDescriptor as k, RegisteredRivusAgentProfile as l, ResolvedRivusAgentDefinition as m, RivusPluginConformanceInput as n, createFakeRivusPlugin as o, RegisteredRivusTool as p, RIVUS_MEMORY_TOOL_ID as q, RivusPluginConformanceReport as r, InvalidRivusPlugin as s, RivusPluginConformanceError as t, RegisteredRivusAutomation as u, RivusAutomationTemplate as v, RivusPluginManifest as w, RivusPlugin as x, RivusAutomationTickContext as y, AgentMemoryIdentity as z };
+export { RivusToolExecutionContext as A, RivusPluginCatalogSnapshot as C, RivusSkillDescriptor as D, RivusResolvedToolDescriptor as E, RivusToolInputRejected as F, RivusToolRisk as I, requiresToolApproval as L, RivusToolFactoryContext as M, RivusToolGrantSet as N, RivusSkillGrantSet as O, RivusToolIdempotency as P, RivusPluginCatalog as S, RivusPluginRegistry as T, RivusAutomationInput as _, assertRivusPluginConforms as a, RivusHostToolDescriptor as b, RIVUS_PLUGIN_API_VERSION as c, RegisteredRivusPlugin as d, RegisteredRivusSkill as f, RivusAgentProfile as g, RivusAgentDeployment as h, RivusPluginLifecycleProbe as i, RivusToolExecutor as j, RivusToolDescriptor as k, RegisteredRivusAgentProfile as l, ResolvedRivusAgentDefinition as m, RivusPluginConformanceInput as n, createFakeRivusPlugin as o, RegisteredRivusTool as p, RivusPluginConformanceReport as r, InvalidRivusPlugin as s, RivusPluginConformanceError as t, RegisteredRivusAutomation as u, RivusAutomationTemplate as v, RivusPluginManifest as w, RivusPlugin as x, RivusAutomationTickContext as y };

package/examples/a-share-briefing-analysis.mjs

@@ -0,0 +1,93 @@
+export function analyzeAShareBriefing({ overseasEvidence, quotes, sectorEvidence }) {
+  return Object.freeze({
+    index: Object.freeze(analyzeIndexStructure(quotes)),
+    overseas: Object.freeze(analyzeOverseasStructure(overseasEvidence)),
+    sector: analyzeSectorStructure(sectorEvidence),
+    turnover: quotes
+      .filter(({ symbol }) => symbol === "sh000001" || symbol === "sz399001")
+      .reduce((sum, quote) => sum + quote.amount, 0)
+  });
+}
+
+function analyzeIndexStructure(quotes) {
+  const direction = readDirection(quotes);
+  const ranked = [...quotes].sort((left, right) => right.changePercent - left.changePercent);
+  const strongest = ranked[0];
+  const weakest = ranked.at(-1);
+  const spread = strongest.changePercent - weakest.changePercent;
+  const dispersion = spread >= 1.5 ? "结构分化较大" : spread >= 0.75 ? "存在一定分化" : "表现相对同步";
+  const average = quotes.reduce((sum, quote) => sum + quote.changePercent, 0) / quotes.length;
+  const positive = quotes.filter(({ changePercent }) => changePercent > 0).length;
+  const negative = quotes.filter(({ changePercent }) => changePercent < 0).length;
+  const strength =
+    positive === quotes.length
+      ? "四个指数一致收涨，指数层面的风险偏好偏强。"
+      : negative === quotes.length
+        ? "四个指数一致收跌，指数层面的风险偏好偏弱。"
+        : average >= 0.5
+          ? "多数指数收涨且平均涨幅偏强，但方向并不完全一致。"
+          : average <= -0.5
+            ? "多数指数承压且平均跌幅偏弱，仍需防范弱势扩散。"
+            : "指数涨跌互现，尚未形成一致的市场方向。";
+  const growth = quotes.find(({ name }) => name === "创业板指");
+  const largeCap = quotes.find(({ name }) => name === "沪深 300");
+  const styleGap = growth.changePercent - largeCap.changePercent;
+  const style =
+    styleGap >= 0.5
+      ? `创业板指较沪深 300 高 ${formatPercentagePoint(styleGap)}，成长风格相对占优。`
+      : styleGap <= -0.5
+        ? `沪深 300 较创业板指高 ${formatPercentagePoint(-styleGap)}，大盘风格相对占优。`
+        : "创业板指与沪深 300 表现接近，暂未形成清晰的成长/大盘偏向。";
+  const risk =
+    spread >= 1.5
+      ? `最强与最弱指数相差 ${formatPercentagePoint(spread)}，单看综合指数可能掩盖明显分化。`
+      : `最强与最弱指数相差 ${formatPercentagePoint(spread)}，指数间分化暂时可控。`;
+  return { direction: `四个宽基指数 ${direction}`, dispersion, risk, strength, strongest, style, weakest };
+}
+
+function analyzeOverseasStructure(evidence) {
+  if (!evidence) {
+    return {
+      conclusion: "隔夜海外指数数据不可用，外部风险背景待开盘数据确认",
+      direction: undefined,
+      inference: "海外指数数据不可用，不补写外部市场判断。"
+    };
+  }
+  const direction = readDirection(evidence.quotes);
+  const average = evidence.quotes.reduce((sum, quote) => sum + quote.changePercent, 0) / evidence.quotes.length;
+  const conclusion = `隔夜美股 ${direction}，外部风险背景${average >= 0.3 ? "偏积极" : average <= -0.3 ? "偏谨慎" : "偏中性"}`;
+  const nasdaq = evidence.quotes.find(({ symbol }) => symbol === "usIXIC");
+  const sp500 = evidence.quotes.find(({ symbol }) => symbol === "usINX");
+  const gap = nasdaq.changePercent - sp500.changePercent;
+  const relative =
+    gap >= 0.3
+      ? `纳斯达克较标普 500 高 ${formatPercentagePoint(gap)}，海外科技风险偏好相对更强。`
+      : gap <= -0.3
+        ? `纳斯达克较标普 500 低 ${formatPercentagePoint(-gap)}，海外科技风险偏好相对更弱。`
+        : "纳斯达克与标普 500 表现接近，海外科技风格未显示明显偏离。";
+  return { conclusion, direction, inference: `${conclusion}。${relative}` };
+}
+
+function analyzeSectorStructure(evidence) {
+  if (!evidence) return "行业数据不可用，不补写行业主线判断。";
+  const leaders = evidence.leaders
+    .slice(0, 2)
+    .map(({ name }) => name)
+    .join("、");
+  const laggards = evidence.laggards
+    .slice(0, 2)
+    .map(({ name }) => name)
+    .join("、");
+  return `领涨端集中在${leaders}，领跌端集中在${laggards}；这只描述行业横截面强弱，不构成市场涨跌的驱动归因。`;
+}
+
+function readDirection(quotes) {
+  const positive = quotes.filter(({ changePercent }) => changePercent > 0).length;
+  const negative = quotes.filter(({ changePercent }) => changePercent < 0).length;
+  const flat = quotes.length - positive - negative;
+  return `${positive} 涨 ${negative} 跌${flat > 0 ? ` ${flat} 平` : ""}`;
+}
+
+function formatPercentagePoint(value) {
+  return `${value.toFixed(2)} 个百分点`;
+}