@rivus/runtime 0.16.6 → 0.18.0

package/README.md

@@ -3,3 +3,24 @@
 Standalone agent execution runtime for Rivus, including the Pi and ACP adapters, memory, tool execution, and run history.
 
 Use the root entrypoint for execution contracts, `@rivus/runtime/pi` for Pi assembly, and `@rivus/runtime/acp` for ACP.
+
+`createAgentHarness` returns the canonical Effect Harness; its session handles, event/update handlers and injected
+Clock/Run ID ports compose Effect directly. Promise Harness clients, runtime conveniences, event constructors,
+projection helpers and generic Clock/Run ID factories are not public entrypoints. Infer private options and results
+from the retained Factory/Port signatures instead of importing implementation modules.
+
+Pi assembly owns SDK model, resource and session creation. `createSession({ sessionCwd })` honors an explicit working
+directory with or without `sessionDirectory`; omitting both options preserves the SDK defaults.
+Pi and ACP loops implement the same native Effect contract. SDK session, plugin callback and stdio transport APIs retain
+their real asynchronous boundaries. Pi still validates SDK-managed history when changing a live Session's model.
+
+Runtime-only applications supply their loop and ports without installing Gateway or Agent. The Agent SDK does not
+re-export execution helpers; consume this package for runtime behavior.
+
+Memory consumers open `openJsonlAgentMemoryRepository` and inject it into `createMemoryService` with an identity source.
+`createRivusMemoryToolDescriptor` and `createProjectMemoryPromptPreparer` use the canonical Effect service directly;
+Legacy Memory DTOs, Promise services/handles and compaction aliases are removed. The JSONL v1 format is unchanged.
+
+Tool Broker, Ledger, policy and approval ports use Effect. Pi runs the workflow only at its SDK execute callback,
+using `unwrapExit` to preserve failure identity. Legacy tool authority, Promise Ledger and Pi Proxy aliases are removed;
+open the canonical `openJsonlToolOperationLedger` and inject it directly. The existing operation file format is unchanged.

package/dist/acp.d.ts

@@ -1,37 +1,5 @@
-import { C as AgentLoopInput, a as AgentLoopInput$1, b as AgentLoop, t as AgentLoop$1 } from "./chunks/agent-loop.js";
+import { n as AgentLoopInput, t as AgentLoop } from "./chunks/agent-loop.js";
 import * as acp from "@agentclientprotocol/sdk";
-
-//#region src/adapters/acp/runtime/acp-agent-loop.d.ts
-type AcpToolCallStatus = "pending" | "in_progress" | "completed" | "failed";
-interface AcpSessionUpdate {
-  readonly content?: unknown;
-  readonly name?: string | null;
-  readonly rawInput?: unknown;
-  readonly rawOutput?: unknown;
-  readonly sessionUpdate: string;
-  readonly status?: AcpToolCallStatus | null;
-  readonly title?: string | null;
-  readonly toolCallId?: string;
-  readonly [key: string]: unknown;
-}
-interface AcpPromptResult {
-  readonly stopReason: string;
-}
-interface AcpAgentSession {
-  cancel(options?: {
-    readonly preserveSession?: boolean;
-  }): Promise<void> | void;
-  prompt(text: string, onUpdate: (update: AcpSessionUpdate) => void): Promise<AcpPromptResult>;
-  dispose?(): Promise<void> | void;
-  invalidate?(): Promise<void> | void;
-}
-interface AcpAgentLoopOptions {
-  readonly cancellationSettleTimeoutMs?: number;
-  readonly disposeSessionAfterRun?: boolean;
-  readonly resolveSession: (input: AgentLoopInput) => Promise<AcpAgentSession> | AcpAgentSession;
-}
-declare function createAcpAgentLoop(options: AcpAgentLoopOptions): AgentLoop;
-//#endregion
 //#region src/adapters/acp/runtime/acp-permission-policy.d.ts
 interface AcpPermissionOption {
   readonly kind: "allow_once" | "allow_always" | "reject_once" | "reject_always";
@@ -51,25 +19,18 @@ interface AcpPermissionRequest {
 interface AcpPermissionSelection {
   readonly optionId: string;
 }
-type AcpPermissionDecision = {
-  readonly outcome: "cancelled";
-} | {
-  readonly optionId: string;
-  readonly outcome: "selected";
-};
 type AcpPermissionPolicy = (request: AcpPermissionRequest) => Promise<AcpPermissionSelection | undefined> | AcpPermissionSelection | undefined;
 interface AcpSessionPermissionContext {
   readonly sessionKey: string;
 }
 type AcpSessionPermissionPolicy = (request: AcpPermissionRequest, context: AcpSessionPermissionContext) => Promise<AcpPermissionSelection | undefined> | AcpPermissionSelection | undefined;
-declare function decideAcpPermission(request: AcpPermissionRequest, policy?: AcpPermissionPolicy): Promise<AcpPermissionDecision>;
 //#endregion
 //#region src/adapters/acp/runtime/acp-permission-bridge.d.ts
 interface AcpPermissionBridge {
   readonly policy: AcpSessionPermissionPolicy;
   bind(sessionKey: string, policy: AcpPermissionPolicy): () => void;
 }
-declare function createAcpPermissionBridge(): AcpPermissionBridge;
+export declare function createAcpPermissionBridge(): AcpPermissionBridge;
 //#endregion
 //#region src/adapters/acp/runtime/acp-agent-server.d.ts
 interface AcpAgentServerOptions {
@@ -78,8 +39,8 @@ interface AcpAgentServerOptions {
   readonly permissionBridge?: AcpPermissionBridge;
   readonly workingDirectory: string;
 }
-declare function createAcpAgentServer(options: AcpAgentServerOptions): acp.AgentApp;
-declare function serveAcpAgentOnStdio(app: acp.AgentApp): Promise<void>;
+export declare function createAcpAgentServer(options: AcpAgentServerOptions): acp.AgentApp;
+export declare function serveAcpAgentOnStdio(app: acp.AgentApp): Promise<void>;
 //#endregion
 //#region src/adapters/acp/runtime/acp-session-store.d.ts
 interface AcpSessionRecord {
@@ -97,7 +58,7 @@ interface JsonAcpSessionStoreOptions {
  * A small deployment-owned store for ACP provider session identities.
  * The file contains no prompts or credentials, only session-key bindings.
  */
-declare function createJsonAcpSessionStore(options: JsonAcpSessionStoreOptions): AcpSessionStore;
+export declare function createJsonAcpSessionStore(options: JsonAcpSessionStoreOptions): AcpSessionStore;
 //#endregion
 //#region src/adapters/acp/runtime/acp-stdio-agent-loop.d.ts
 interface AcpMcpServerEnvironmentVariable {
@@ -128,52 +89,6 @@ interface AcpStdioAgentLoopHandle {
   readonly loop: AgentLoop;
   dispose(): Promise<void>;
 }
-declare function createAcpStdioAgentLoop(options: AcpStdioAgentLoopOptions): AcpStdioAgentLoopHandle;
-declare class AcpSessionResumeUnavailable extends Error {
-  readonly sessionId: string;
-  readonly name = "AcpSessionResumeUnavailable";
-  constructor(sessionId: string);
-}
-declare class AcpSessionResumeFailed extends Error {
-  readonly sessionId: string;
-  readonly cause: unknown;
-  readonly name = "AcpSessionResumeFailed";
-  constructor(sessionId: string, cause: unknown);
-}
-//#endregion
-//#region src/adapters/compatibility/acp/acp-runtime.d.ts
-interface AcpAgentLoopOptions$1 {
-  readonly cancellationSettleTimeoutMs?: number;
-  readonly disposeSessionAfterRun?: boolean;
-  readonly resolveSession: (input: AgentLoopInput$1) => Promise<AcpAgentSession> | AcpAgentSession;
-}
-interface AcpAgentServerOptions$1 {
-  readonly loop: AgentLoop$1;
-  readonly workingDirectory: string;
-  readonly agentName?: string;
-  readonly permissionBridge?: AcpPermissionBridge;
-}
-interface AcpStdioAgentLoopOptions$1 {
-  readonly command: string;
-  readonly workingDirectory: string;
-  readonly mcpServers?: (input: AgentLoopInput$1) => ReadonlyArray<AcpMcpServer>;
-  /** Persist provider session IDs so a restarted ACP child can load/resume them. */
-  readonly sessionStore?: AcpSessionStore;
-  readonly permissionPolicy?: AcpSessionPermissionPolicy;
-  readonly environment?: Readonly<Record<string, string>>;
-  readonly arguments?: ReadonlyArray<string>;
-  readonly clientName?: string;
-  readonly initializationTimeoutMs?: number;
-  readonly terminationTimeoutMs?: number;
-  readonly onStderr?: (text: string) => void;
-}
-interface AcpStdioAgentLoopHandle$1 {
-  readonly loop: AgentLoop$1;
-  dispose(): Promise<void>;
-}
-declare function createAcpAgentLoop$1(options: AcpAgentLoopOptions$1): AgentLoop$1;
-declare function createAcpAgentServer$1(options: AcpAgentServerOptions$1): acp.AgentApp;
-declare function serveAcpAgentOnStdio$1(app: acp.AgentApp): Promise<void>;
-declare function createAcpStdioAgentLoop$1(options: AcpStdioAgentLoopOptions$1): AcpStdioAgentLoopHandle$1;
+export declare function createAcpStdioAgentLoop(options: AcpStdioAgentLoopOptions): AcpStdioAgentLoopHandle;
 //#endregion
-export { type AcpAgentLoopOptions, type AcpAgentServerOptions, type AcpAgentSession, type AcpMcpServer, type AcpMcpServerEnvironmentVariable, type AcpPermissionBridge, type AcpPermissionDecision, type AcpPermissionOption, type AcpPermissionPolicy, type AcpPermissionRequest, type AcpPermissionSelection, type AcpPermissionToolCall, type AcpPromptResult, type AcpSessionPermissionContext, type AcpSessionPermissionPolicy, type AcpSessionRecord, AcpSessionResumeFailed, AcpSessionResumeUnavailable, type AcpSessionStore, type AcpSessionUpdate, type AcpStdioAgentLoopHandle, type AcpStdioAgentLoopOptions, type AcpToolCallStatus, type JsonAcpSessionStoreOptions, type AcpAgentLoopOptions$1 as LegacyAcpAgentLoopOptions, type AcpAgentServerOptions$1 as LegacyAcpAgentServerOptions, type AcpStdioAgentLoopHandle$1 as LegacyAcpStdioAgentLoopHandle, type AcpStdioAgentLoopOptions$1 as LegacyAcpStdioAgentLoopOptions, createAcpAgentLoop, createAcpAgentServer, createAcpPermissionBridge, createAcpStdioAgentLoop, createJsonAcpSessionStore, createAcpAgentLoop$1 as createLegacyAcpAgentLoop, createAcpAgentServer$1 as createLegacyAcpAgentServer, createAcpStdioAgentLoop$1 as createLegacyAcpStdioAgentLoop, decideAcpPermission, serveAcpAgentOnStdio, serveAcpAgentOnStdio$1 as serveLegacyAcpAgentOnStdio };
+export {};