@rivus/agent 0.6.2 → 0.7.0

package/README.md

@@ -15,6 +15,7 @@ The first milestone is intentionally narrow: make the agent loop and agent harne
 - Multi-agent Host primitives with trusted Endpoint bindings, stable Runtime Generation/Instance identities, lazy per-instance Runtime pooling, isolated active-run gates, and restart restoration from persisted registry records.
 - Scoped Agent Memory with a single-writer append-only JSONL adapter, explicit Profile/Deployment grants, Host-bound tenant/subject/conversation/project/audience identity, and a provider-neutral `rivus_memory` Tool wired into the Pi manifest Runtime. Agent-private proposals survive process replacement; group invocations may access only Conversation and confirmed Project Memory, and Shared Profile reads expose only confirmed records. Bound Project Memory is recalled automatically with deterministic limits; durable confirmation UX, typed Shared Profile fields, full provenance/retention metadata, and durable Compaction are still separate work.
 - Manifest-driven fixed-time Agent Automations with daily or weekday-only schedules, stable Mandate/Tick identity, per-template Tool grant narrowing, isolated Runtime and invocation authority, a durable single-writer JSON Tick adapter that records the actual Agent Run, generated-before-delivery recovery, and idempotent proactive Feishu interactive-card delivery. The first Markdown heading becomes the card title while the remaining Markdown stays scannable in the card body. Revisioned Plugin State and the general Delivery Outbox remain composable domain primitives.
+- Opt-in background Agent Sessions (`manifest.backgroundSessions`): the model decides from ordinary natural language that work should continue in the background, calls the generic `background.start` Host Tool, and the foreground Run and card end promptly. A deployment-owned supervisor runs bounded steps on an isolated Runtime lane per Agent with the exact Agent/Profile/Project Space/Skills/Memory policy and a grant narrowed to exclude `background.start`; sessions wait durably (`background.wait`), wake, receive user input once (`background.send`), stop safely, and survive daemon restart on the same stable session and Pi transcript. Progress and one terminal result are delivered idempotently to the trusted source conversation. The Runtime contains no business scenario, meeting, or job code — no pre-model intent router exists.
 - Peer Delegation and Subagent coordination primitives with explicit edges, hop/budget limits, monotonic ToolGrantSet intersection, isolated child authority, denied ambient sender/private-memory/Shell capabilities, and parent cancellation cascading.
 - `@rivus/agent/testing` Conformance TestKit with a reusable Fake Plugin and checks for registration/reference failures, ToolGrantSet expansion, and lifecycle disposal leaks.
 - Effect-based `AgentHarness` use case with result-oriented `prompt()`, turn-oriented `promptTurn()`, event-oriented `stream()`, text-oriented `streamText()`, event-handling `promptWithEvents()`, active-run/run/session state and transcript lookup APIs, and a default runtime factory.
@@ -125,6 +126,17 @@ For a manifest-driven multi-agent deployment, keep `rivus.config.json`, its lock
       }
     }
   ],
+  "backgroundSessions": {
+    "enabled": false,
+    "required": false,
+    "stepTimeoutMs": 300000,
+    "maxConcurrentSessions": 4,
+    "leaseMs": 30000,
+    "leaseRenewalIntervalMs": 10000,
+    "maxConsecutiveFailures": 3,
+    "retryBackoffMs": 30000,
+    "sessionLifetimeMs": 86400000
+  },
   "endpoints": [
     {
       "id": "research-feishu",

package/dist/agent-loop.d.ts

@@ -296,7 +296,16 @@ interface AutomationAgentInvocationOrigin {
   readonly tenantKey: "automation";
   readonly tickId: string;
 }
-type AgentInvocationOrigin = FeishuAgentInvocationOrigin | LocalCliAgentInvocationOrigin | AutomationAgentInvocationOrigin;
+interface BackgroundSessionAgentInvocationOrigin {
+  readonly allowedActorOpenIds: ReadonlyArray<string>;
+  readonly endpointId: string;
+  readonly kind: "background-session";
+  readonly memory?: AgentMemoryInvocationIdentity;
+  readonly sessionId: string;
+  readonly sourceMessageId: string;
+  readonly tenantKey: string;
+}
+type AgentInvocationOrigin = FeishuAgentInvocationOrigin | LocalCliAgentInvocationOrigin | AutomationAgentInvocationOrigin | BackgroundSessionAgentInvocationOrigin;
 //#endregion
 //#region src/application/agent/agent-loop.d.ts
 interface AgentLoopInput {

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { D as loadRivusDeploymentManifest, G as validateRivusDeploymentManifest, H as loadMergedLocalEnvFile, T as resolveNodeRivusPluginModulePath, V as resolveFeishuEndpointCredentials, t as runRivusDaemonCli } from "./rivus-daemon-cli.js";
+import { D as loadRivusDeploymentManifest, T as resolveNodeRivusPluginModulePath, X as resolveFeishuEndpointCredentials, Z as loadMergedLocalEnvFile, et as validateRivusDeploymentManifest, t as runRivusDaemonCli } from "./rivus-daemon-cli.js";
 import { Effect } from "effect";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";