@arnilo/prism-coding-agent

Optional first-party coding tools package for Prism. Provides host shell/filesystem tools — shell, read, write, edit — as Prism ToolDefinition objects. Inert until a host imports it and registers the tools into a ToolRegistry.

Behavior is a behavioral port of the pi coding agent's bash/read/write/edit tools, adapted to Prism's ToolDefinition / ToolResult contracts (no @earendil-works/* or typebox dependencies).

⚠️ These tools perform real shell and filesystem operations on the host. They provide no sandbox. Gate them with Prism PermissionPolicy / ToolValidator / trust policies before registering them for any provider turn. See the coding agent tools docs and the host security guide.

Install

npm install @arnilo/prism-coding-agent

@arnilo/prism is a peer dependency.

Usage

Register the full coding set:

import { createToolRegistry } from "@arnilo/prism";
import { createCodingTools } from "@arnilo/prism-coding-agent";

const tools = createToolRegistry(createCodingTools(process.cwd()));

Read-only subset (inspection-only agents):

import { createReadOnlyTools } from "@arnilo/prism-coding-agent";

const tools = createToolRegistry(createReadOnlyTools(process.cwd()));

Individual tools with options:

import { createShellTool, createWriteTool } from "@arnilo/prism-coding-agent";

const shell = createShellTool(process.cwd(), {
  shellPath: "/bin/bash",        // force bash; default: SHELL env → /bin/bash → sh
  commandPrefix: "set -euo pipefail",
  maxLines: 500,
});

const remoteWrite = createWriteTool(process.cwd(), {
  operations: {
    writeFile: async (abs, content) => { /* ship to remote */ },
    mkdir: async (dir) => { /* mkdir -p remotely */ },
  },
});

Tools

| Tool | Input | Result | | --- | --- | --- | | shell | { command, timeout? } | Combined output + metadata.exitCode. Non-zero exit is not an error. | | read | { path, offset?, limit? } | TextContent (text) or [note, ImageContent] (image). | | write | { path, content } | Successfully wrote N bytes (M lines) to <abs>. | | edit | { path, edits: [{oldText,newText}] } | Successfully replaced N block(s) + metadata.{diff,patch,firstChangedLine}. |

pi name mapping

| Prism | pi | | --- | --- | | shell | bash | | read / write / edit | read / write / edit |

Exports

Factories: createShellTool, createReadTool, createWriteTool, createEditTool, createCodingTools, createReadOnlyTools, createAllTools, createLocalBashOperations.

Helpers: detectSupportedImageMimeType, detectSupportedImageMimeTypeFromFile, getShellConfig, killProcessTree, waitForChildProcess, withFileMutationQueue.

Option/operation types: ToolsOptions, ShellToolOptions/BashOperations, ReadToolOptions/ReadOperations, WriteToolOptions/WriteOperations, EditToolOptions/EditOperations/EditToolDetails.

License

MIT