@rivus/agent 0.16.0 → 0.16.2

package/dist/pi.d.ts

@@ -66,6 +66,23 @@ interface PiNamedTool {
 }
 declare function resolvePiSessionToolNames(runtimeToolIds: ReadonlyArray<RivusRuntimeToolId>, customTools: ReadonlyArray<PiNamedTool>): ReadonlyArray<string>;
 //#endregion
+//#region src/adapters/pi/tool-execution/pi-bash-tool-options.d.ts
+interface PiBashSpawnContext {
+  command: string;
+  cwd: string;
+  env: Record<string, string | undefined>;
+}
+/** Rivus's Bash configuration boundary, independent of provider UI/model types. */
+interface PiBashToolOptions {
+  commandPrefix?: string;
+  shellPath?: string;
+  spawnHook?: (context: PiBashSpawnContext) => PiBashSpawnContext;
+}
+//#endregion
+//#region src/adapters/pi/tool-execution/pi-bash-tool.d.ts
+/** Keep Pi's native execution, rendering and abort cleanup with a bounded default. */
+declare function createPiBashTool(cwd: string, options?: PiBashToolOptions): PiToolDefinition;
+//#endregion
 //#region src/adapters/pi/runtime/pi-session-resources.d.ts
 interface CreatePiSessionResourcesOptions {
   readonly agentDir: string;
@@ -77,6 +94,10 @@ interface CreatePiSessionResourcesOptions {
   readonly systemPromptOverride?: (base: string | undefined) => string | undefined;
 }
 interface PiSessionResources {
+  readonly bashToolOptions?: {
+    readonly commandPrefix?: string;
+    readonly shellPath?: string;
+  };
   readonly skillNames: ReadonlySet<string>;
   readonly skillPaths: ReadonlyArray<string>;
   readonly refresh: () => Promise<void>;
@@ -105,4 +126,4 @@ interface PiToolProxyOptions {
 declare function createPiToolProxyDefinitions(options: PiToolProxyOptions): PiToolDefinition[];
 declare function createPiToolNameResolver(tools: ReadonlyArray<Pick<RivusResolvedToolDescriptor, "id">>): (toolName: string) => string;
 //#endregion
-export { type CreatePiSessionResourcesOptions, InvalidPiSkillCatalog, InvalidPiSkillSource, type PiSessionResources, type PiSkillRuntime, type PiToolApprovalGateway, type PiToolApprovalRequest, type PiToolContent, type PiToolDefinition, type PiToolProxyOptions, type PiToolResult, ProjectSkillReadDenied, type ResolvePiSkillSourcesOptions, createPiProjectSkillReadTool, createPiSessionResources, createPiSkillReadTool, createPiSkillReadTools, createPiSkillRuntime, createPiToolNameResolver, createPiToolProxyDefinitions, resolvePiSessionToolNames, resolvePiSkillSources, validatePiSkillCatalog, validatePiSkillCommand };
+export { type CreatePiSessionResourcesOptions, InvalidPiSkillCatalog, InvalidPiSkillSource, type PiBashToolOptions, type PiSessionResources, type PiSkillRuntime, type PiToolApprovalGateway, type PiToolApprovalRequest, type PiToolContent, type PiToolDefinition, type PiToolProxyOptions, type PiToolResult, ProjectSkillReadDenied, type ResolvePiSkillSourcesOptions, createPiBashTool, createPiProjectSkillReadTool, createPiSessionResources, createPiSkillReadTool, createPiSkillReadTools, createPiSkillRuntime, createPiToolNameResolver, createPiToolProxyDefinitions, resolvePiSessionToolNames, resolvePiSkillSources, validatePiSkillCatalog, validatePiSkillCommand };

package/dist/pi.js

@@ -1,3 +1,3 @@
+import { a as InvalidPiSkillSource, c as validatePiSkillCatalog, d as createPiProjectSkillReadTool, f as createPiSkillReadTool, i as resolvePiSessionToolNames, l as validatePiSkillCommand, m as createPiBashTool, n as createPiToolProxyDefinitions, o as resolvePiSkillSources, p as createPiSkillReadTools, r as createPiSessionResources, s as InvalidPiSkillCatalog, t as createPiToolNameResolver, u as ProjectSkillReadDenied } from "./chunks/pi.js";
 import { r as createPiSkillRuntime } from "./chunks/rivus-tool.js";
-import { a as InvalidPiSkillSource, c as validatePiSkillCatalog, d as createPiProjectSkillReadTool, f as createPiSkillReadTool, i as resolvePiSessionToolNames, l as validatePiSkillCommand, n as createPiToolProxyDefinitions, o as resolvePiSkillSources, p as createPiSkillReadTools, r as createPiSessionResources, s as InvalidPiSkillCatalog, t as createPiToolNameResolver, u as ProjectSkillReadDenied } from "./chunks/pi.js";
-export { InvalidPiSkillCatalog, InvalidPiSkillSource, ProjectSkillReadDenied, createPiProjectSkillReadTool, createPiSessionResources, createPiSkillReadTool, createPiSkillReadTools, createPiSkillRuntime, createPiToolNameResolver, createPiToolProxyDefinitions, resolvePiSessionToolNames, resolvePiSkillSources, validatePiSkillCatalog, validatePiSkillCommand };
+export { InvalidPiSkillCatalog, InvalidPiSkillSource, ProjectSkillReadDenied, createPiBashTool, createPiProjectSkillReadTool, createPiSessionResources, createPiSkillReadTool, createPiSkillReadTools, createPiSkillRuntime, createPiToolNameResolver, createPiToolProxyDefinitions, resolvePiSessionToolNames, resolvePiSkillSources, validatePiSkillCatalog, validatePiSkillCommand };

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

@@ -21,6 +21,7 @@ import {
   createConfiguredFeishuBackgroundSessionDelivery,
   createConfiguredFeishuCardRolloverRuntime,
   createConfiguredFeishuHumanInteractionPresenter,
+  createConfiguredFeishuMessageReactionSender,
   createConfiguredFeishuOpenApiClient,
   createConfiguredFeishuTextReplySender,
   createFeishuCotPublisher,
@@ -81,6 +82,7 @@ import {
   type RivusThinkingLevel
 } from "@rivus/agent";
 import {
+  createPiBashTool,
   createPiSkillReadTools,
   createPiSessionResources,
   createPiSkillRuntime,
@@ -437,9 +439,14 @@ export async function createRivusDeploymentAdapters(context: RivusDeploymentBoot
           client: openApiClient,
           config
         });
+        const reactions = createConfiguredFeishuMessageReactionSender({
+          client: openApiClient,
+          config
+        });
         const prepareCardTarget = (run: FeishuAgentRunPreparation) => cardRollover.prepareRun(run);
         const endpoint = createFeishuDeploymentEndpoint({
           agentId: input.agentId,
+          acknowledgeSteering: (messageId) => reactions.add(messageId),
           botOpenId,
           cardRollover: cardRollover.transport,
           finalizeRun: (runId) => cardRollover.rollover.releaseRun(runId),
@@ -532,9 +539,19 @@ export async function createRivusDeploymentAdapters(context: RivusDeploymentBoot
         const sessionRegistry = createPiSessionRegistry({
           createSession: async (firstInput) => {
             let activeInput = firstInput;
+            const resources = await createPiSessionResources({
+              agentDir: PI_AGENT_DIR,
+              appendSystemPromptOverride: () =>
+                [workspaceInstructions.content, skillRuntime.prompt].filter((content) => content.length > 0),
+              cwd: workingDirectory,
+              homeDirectory: homedir(),
+              ...(input.projectSpace ? { projectSkillPaths: input.projectSpace.skillPaths } : {}),
+              systemPromptOverride: () => input.definition.systemPrompt
+            });
             const managedContext =
               management?.enabled && runContexts && input.definition.runtimeToolGrantSet.toolIds.includes("bash")
                 ? createPiManagedSessionContext({
+                    ...(resources.bashToolOptions ? { bashToolOptions: resources.bashToolOptions } : {}),
                     binDirectory: management.binDirectory,
                     contexts: runContexts.registry,
                     cwd: workingDirectory,
@@ -542,17 +559,11 @@ export async function createRivusDeploymentAdapters(context: RivusDeploymentBoot
                     socketPath: management.socketPath
                   })
                 : undefined;
-            const resources = await createPiSessionResources({
-              agentDir: PI_AGENT_DIR,
-              appendSystemPromptOverride: () =>
-                [workspaceInstructions.content, skillRuntime.prompt].filter((content) => content.length > 0),
-              cwd: workingDirectory,
-              homeDirectory: homedir(),
-              ...(input.projectSpace ? { projectSkillPaths: input.projectSpace.skillPaths } : {}),
-              systemPromptOverride: () => input.definition.systemPrompt
-            });
+            const bashTool = input.definition.runtimeToolGrantSet.toolIds.includes("bash")
+              ? (managedContext?.tool ?? createPiBashTool(workingDirectory, resources.bashToolOptions))
+              : undefined;
             const customTools = [
-              ...(managedContext ? [managedContext.tool] : []),
+              ...(bashTool ? [bashTool] : []),
               ...createPiSkillReadTools({
                 cwd: workingDirectory,
                 runtimeToolIds: input.definition.runtimeToolGrantSet.toolIds,
@@ -570,7 +581,7 @@ export async function createRivusDeploymentAdapters(context: RivusDeploymentBoot
               }),
               ...(skillRuntime.tool ? [skillRuntime.tool] : [])
             ];
-            const nativeToolIds = managedContext
+            const nativeToolIds = bashTool
               ? input.definition.runtimeToolGrantSet.toolIds.filter((toolId) => toolId !== "bash")
               : input.definition.runtimeToolGrantSet.toolIds;
             const activeToolNames = resolvePiSessionToolNames(nativeToolIds, customTools);
@@ -605,6 +616,7 @@ export async function createRivusDeploymentAdapters(context: RivusDeploymentBoot
           ? management.runtime.registerSessionRegistry(sessionRegistry)
           : undefined;
         const loop = createPiAgentLoop({
+          supportsSteering: true,
           disposeSessionAfterRun: false,
           ...(management?.enabled ? { runBoundary: management.boundary } : {}),
           ...(telemetry ? { modelContentObserver: telemetry.modelContentObserver } : {}),

package/examples/pi-feishu.bootstrap.ts

@@ -81,6 +81,7 @@ export async function createRivusDaemonProcess(
     }
   });
   const piLoop = createPiAgentLoop({
+    supportsSteering: true,
     disposeSessionAfterRun: false,
     resolveSession: (input) => sessionRegistry.resolve(input)
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rivus/agent",
-  "version": "0.16.0",
+  "version": "0.16.2",
   "description": "A local agent daemon core built around a usable agent harness and domain events.",
   "type": "module",
   "license": "MIT",