@parall/claude-agent 1.15.1 → 1.17.0

package/dist/dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,KAAK,wBAAwB,GAAG,IAAI,CAClC,iBAAiB,EACf,gBAAgB,GAChB,cAAc,GACd,oBAAoB,GACpB,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,OAAO,GACP,gBAAgB,GAChB,cAAc,CACjB,GAAG;IACF,cAAc,EAAE,oBAAoB,CAAC;CACtC,CAAC;AAgBF,qBAAa,iBAAkB,YAAW,eAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,wBAAwB;IAEpD,QAAQ,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,YAAY,GAAG,aAAa,CAAC,YAAY,CAAC;IA2FjG,WAAW,CAAC,EAAE,UAAU,EAAE,EAAE,QAAQ;IAIpC,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,eAAe;IAIrC,OAAO,CAAC,SAAS;CAkClB"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,KAAK,wBAAwB,GAAG,IAAI,CAClC,iBAAiB,EACf,gBAAgB,GAChB,cAAc,GACd,oBAAoB,GACpB,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,OAAO,GACP,gBAAgB,GAChB,cAAc,CACjB,GAAG;IACF,cAAc,EAAE,oBAAoB,CAAC;CACtC,CAAC;AAEF,qBAAa,iBAAkB,YAAW,eAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,wBAAwB;IAEpD,QAAQ,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,YAAY,GAAG,aAAa,CAAC,YAAY,CAAC;IAwFjG,WAAW,CAAC,EAAE,UAAU,EAAE,EAAE,QAAQ;IAIpC,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,eAAe;IAIrC,OAAO,CAAC,SAAS;CAkClB"}

package/dist/dispatch.js

@@ -1,21 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { spawn } from "node:child_process";
 import { parseClaudeStreamJson } from "./output-parser.js";
-function extractBashCommand(input) {
-    if (!input || typeof input !== "object")
-        return undefined;
-    const command = input.command;
-    return typeof command === "string" && command.trim() ? command.trim() : undefined;
-}
-function isParallSendCommand(command) {
-    if (!command)
-        return false;
-    const normalized = command.replace(/\s+/g, " ").trim();
-    const invokesParallCli = /(?:^| )(?:parall|npx @parall\/cli(?:@latest)?|pnpm (?:exec|dlx) parall)(?: |$)/.test(normalized);
-    if (!invokesParallCli)
-        return false;
-    return /\b(messages send|dm)\b/.test(normalized);
-}
 export class ClaudeCodeAdapter {
     opts;
     constructor(opts) {
@@ -54,7 +39,6 @@ export class ClaudeCodeAdapter {
         });
         const groupKey = randomUUID();
         let sawError = false;
-        let suppressProjectedText = false;
         let completed = false;
         try {
             for await (const event of parseClaudeStreamJson(proc.stdout)) {
@@ -62,20 +46,19 @@ export class ClaudeCodeAdapter {
                     this.opts.sessionManager.recordSessionId(sessionKey, event.sessionId);
                     continue;
                 }
-                if (event.type === "tool_call" && isParallSendCommand(extractBashCommand(event.input))) {
-                    suppressProjectedText = true;
-                }
                 if (event.type === "error") {
                     sawError = true;
                     yield event;
                     continue;
                 }
                 if (event.type === "text") {
-                    const project = suppressProjectedText ? false : event.project;
-                    suppressProjectedText = false;
+                    // Runtime output contract (symmetric with OpenClaw channel): Claude's
+                    // plain text is never projected as a chat message. To reply, the agent
+                    // must explicitly run `parall messages send` / `dm` via Bash. Text
+                    // events are still recorded as suppressed session steps for audit.
                     yield {
                         ...event,
-                        project,
+                        project: false,
                         groupKey,
                     };
                     continue;

package/dist/index.js

@@ -15,8 +15,8 @@ function createLogger(prefix) {
 }
 async function main() {
     const config = resolveClaudeAgentConfig(process.env);
-    ensureClaudeWorkspace(config.workspaceDir);
     const log = createLogger("claude-agent");
+    ensureClaudeWorkspace(config.workspaceDir, log);
     const client = new ParallClient({
         baseUrl: config.apiUrl,
         token: config.apiKey,

package/dist/workspace.d.ts

@@ -1,2 +1,4 @@
-export declare function ensureClaudeWorkspace(workspaceDir: string): void;
+export declare function ensureClaudeWorkspace(workspaceDir: string, log?: {
+    warn: (msg: string) => void;
+}): void;
 //# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AA8BA,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,QAQzD"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAkCA,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,QA0BtC"}

package/dist/workspace.js

@@ -2,35 +2,55 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 const CLAUDE_MD = `# CLAUDE.md
 
-You are an agent in Parall IM. You participate in chats, handle tasks, and can use Parall CLI commands for advanced operations.
+You are an agent in Parall IM. You participate in chats, handle tasks, and interact exclusively through the Parall CLI.
 
 ## Message Model
 
 Incoming events are rendered as structured \`[Event: ...]\` blocks.
-Reply with plain text when you want Parall to project your response back into the triggering chat.
+Each event includes \`[Chat: ... (prll://cht_xxx)]\` — use that chat ID (or full URI) when replying.
+
+**Your plain-text output is not delivered to anyone** — it is recorded as suppressed thinking in your session steps and discarded from the chat.
+To say something in a chat, you **must** invoke the Parall CLI via the Bash tool. To stay silent, simply do not invoke it.
 
 ## Parall CLI
 
-Use CLI only when you need an explicit side effect instead of plain-text projection:
+All outbound interactions go through \`@parall/cli\`. Credentials are pre-injected as environment variables — no setup needed.
 
-- \`npx @parall/cli@latest messages send CHT_ID --text "..." \`
-- \`npx @parall/cli@latest tasks update TSK_ID --status in_progress\`
-- \`npx @parall/cli@latest dm USER_ID --text "..." --no-reply\`
+- \`npx --yes @parall/cli@latest messages send prll://cht_xxx --text "..."\` — reply into the triggering chat
+- \`npx --yes @parall/cli@latest dm prll://usr_xxx --text "..." [--no-reply]\` — direct message another user
+- \`npx --yes @parall/cli@latest tasks update prll://tsk_xxx --status in_progress\` — task state
+- \`npx --yes @parall/cli@latest no-reply [--reason "..."]\` — explicitly declare this turn silent (audit signal; not required for silence, just clarifies intent)
 
-Credentials are already injected through environment variables:
-\`PRLL_API_URL\`, \`PRLL_API_KEY\`, \`PRLL_ORG_ID\`, \`PRLL_SESSION_ID\`, \`PRLL_CHAT_ID\`, \`PRLL_TRIGGER_MESSAGE_ID\`, \`PRLL_STEP_ID_FILE\`.
+Available env: \`PRLL_API_URL\`, \`PRLL_API_KEY\`, \`PRLL_ORG_ID\`, \`PRLL_SESSION_ID\`, \`PRLL_CHAT_ID\`, \`PRLL_TRIGGER_MESSAGE_ID\`, \`PRLL_STEP_ID_FILE\`.
 
 ## Guardrails
 
-- If an event includes \`[Hint: no_reply]\`, do not send a reply.
-- Prefer plain text over CLI for normal chat replies.
-- Keep replies concise and task-focused.
+- A dispatch may coalesce multiple events. Decide per event whether to reply via \`messages send\` / \`dm\` — events you do not act on simply receive no reply.
+- If an event carries \`[Hint: no_reply]\`, do not send anything for that event. \`no-reply\` is optional and only useful as an explicit intent marker.
+- Never try to "speak" by typing sentences like "No response needed" / "Noted" / "OK" — they are discarded, so they accomplish nothing except polluting your session log.
+- Keep CLI replies concise and task-focused.
 `;
-export function ensureClaudeWorkspace(workspaceDir) {
+export function ensureClaudeWorkspace(workspaceDir, log) {
     fs.mkdirSync(workspaceDir, { recursive: true });
     fs.mkdirSync(path.join(workspaceDir, ".claude"), { recursive: true });
+    // CLAUDE.md is bridge-managed: always overwrite so a hosted PVC keeps the
+    // current guardrails (e.g. the `no-reply` instruction). Operators must not
+    // hand-edit this file — workspace customizations should go into AGENTS.md
+    // / SOUL.md / TOOLS.md, which are env-driven and untouched here. Surface a
+    // warning when we replace a file whose content diverges, so an operator
+    // who did edit it locally gets a signal instead of silently losing changes.
     const claudeMdPath = path.join(workspaceDir, "CLAUDE.md");
-    if (!fs.existsSync(claudeMdPath)) {
-        fs.writeFileSync(claudeMdPath, CLAUDE_MD, "utf8");
+    if (log) {
+        try {
+            const existing = fs.readFileSync(claudeMdPath, "utf8");
+            if (existing !== CLAUDE_MD) {
+                log.warn(`claude-agent: overwriting divergent ${claudeMdPath} with bridge-managed template ` +
+                    `(local edits to CLAUDE.md are not preserved — customize AGENTS.md / SOUL.md / TOOLS.md instead)`);
+            }
+        }
+        catch {
+            // file missing or unreadable — first-boot case, no warning needed
+        }
     }
+    fs.writeFileSync(claudeMdPath, CLAUDE_MD, "utf8");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/claude-agent",
-  "version": "1.15.1",
+  "version": "1.17.0",
   "description": "Claude Code bridge runtime for self-hosted Parall agents",
   "license": "MIT",
   "repository": {
@@ -25,9 +25,9 @@
     "src"
   ],
   "dependencies": {
-    "@parall/agent-core": "1.15.1",
-    "@parall/cli": "1.15.1",
-    "@parall/sdk": "1.15.1"
+    "@parall/sdk": "1.17.0",
+    "@parall/agent-core": "1.17.0",
+    "@parall/cli": "1.17.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/dispatch.ts

@@ -26,20 +26,6 @@ type ClaudeCodeAdapterOptions = Pick<
   sessionManager: ClaudeSessionManager;
 };
 
-function extractBashCommand(input: unknown): string | undefined {
-  if (!input || typeof input !== "object") return undefined;
-  const command = (input as { command?: unknown }).command;
-  return typeof command === "string" && command.trim() ? command.trim() : undefined;
-}
-
-function isParallSendCommand(command: string | undefined): boolean {
-  if (!command) return false;
-  const normalized = command.replace(/\s+/g, " ").trim();
-  const invokesParallCli = /(?:^| )(?:parall|npx @parall\/cli(?:@latest)?|pnpm (?:exec|dlx) parall)(?: |$)/.test(normalized);
-  if (!invokesParallCli) return false;
-  return /\b(messages send|dm)\b/.test(normalized);
-}
-
 export class ClaudeCodeAdapter implements DispatchAdapter {
   constructor(private readonly opts: ClaudeCodeAdapterOptions) {}
 
@@ -82,7 +68,6 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
 
     const groupKey = randomUUID();
     let sawError = false;
-    let suppressProjectedText = false;
     let completed = false;
 
     try {
@@ -92,10 +77,6 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
           continue;
         }
 
-        if (event.type === "tool_call" && isParallSendCommand(extractBashCommand(event.input))) {
-          suppressProjectedText = true;
-        }
-
         if (event.type === "error") {
           sawError = true;
           yield event;
@@ -103,11 +84,13 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
         }
 
         if (event.type === "text") {
-          const project = suppressProjectedText ? false : event.project;
-          suppressProjectedText = false;
+          // Runtime output contract (symmetric with OpenClaw channel): Claude's
+          // plain text is never projected as a chat message. To reply, the agent
+          // must explicitly run `parall messages send` / `dm` via Bash. Text
+          // events are still recorded as suppressed session steps for audit.
           yield {
             ...event,
-            project,
+            project: false,
             groupKey,
           };
           continue;

package/src/index.ts

@@ -24,8 +24,8 @@ function createLogger(prefix: string) {
 
 async function main() {
   const config = resolveClaudeAgentConfig(process.env);
-  ensureClaudeWorkspace(config.workspaceDir);
   const log = createLogger("claude-agent");
+  ensureClaudeWorkspace(config.workspaceDir, log);
 
   const client = new ParallClient({
     baseUrl: config.apiUrl,

package/src/workspace.ts

@@ -3,37 +3,61 @@ import * as path from "node:path";
 
 const CLAUDE_MD = `# CLAUDE.md
 
-You are an agent in Parall IM. You participate in chats, handle tasks, and can use Parall CLI commands for advanced operations.
+You are an agent in Parall IM. You participate in chats, handle tasks, and interact exclusively through the Parall CLI.
 
 ## Message Model
 
 Incoming events are rendered as structured \`[Event: ...]\` blocks.
-Reply with plain text when you want Parall to project your response back into the triggering chat.
+Each event includes \`[Chat: ... (prll://cht_xxx)]\` — use that chat ID (or full URI) when replying.
+
+**Your plain-text output is not delivered to anyone** — it is recorded as suppressed thinking in your session steps and discarded from the chat.
+To say something in a chat, you **must** invoke the Parall CLI via the Bash tool. To stay silent, simply do not invoke it.
 
 ## Parall CLI
 
-Use CLI only when you need an explicit side effect instead of plain-text projection:
+All outbound interactions go through \`@parall/cli\`. Credentials are pre-injected as environment variables — no setup needed.
 
-- \`npx @parall/cli@latest messages send CHT_ID --text "..." \`
-- \`npx @parall/cli@latest tasks update TSK_ID --status in_progress\`
-- \`npx @parall/cli@latest dm USER_ID --text "..." --no-reply\`
+- \`npx --yes @parall/cli@latest messages send prll://cht_xxx --text "..."\` — reply into the triggering chat
+- \`npx --yes @parall/cli@latest dm prll://usr_xxx --text "..." [--no-reply]\` — direct message another user
+- \`npx --yes @parall/cli@latest tasks update prll://tsk_xxx --status in_progress\` — task state
+- \`npx --yes @parall/cli@latest no-reply [--reason "..."]\` — explicitly declare this turn silent (audit signal; not required for silence, just clarifies intent)
 
-Credentials are already injected through environment variables:
-\`PRLL_API_URL\`, \`PRLL_API_KEY\`, \`PRLL_ORG_ID\`, \`PRLL_SESSION_ID\`, \`PRLL_CHAT_ID\`, \`PRLL_TRIGGER_MESSAGE_ID\`, \`PRLL_STEP_ID_FILE\`.
+Available env: \`PRLL_API_URL\`, \`PRLL_API_KEY\`, \`PRLL_ORG_ID\`, \`PRLL_SESSION_ID\`, \`PRLL_CHAT_ID\`, \`PRLL_TRIGGER_MESSAGE_ID\`, \`PRLL_STEP_ID_FILE\`.
 
 ## Guardrails
 
-- If an event includes \`[Hint: no_reply]\`, do not send a reply.
-- Prefer plain text over CLI for normal chat replies.
-- Keep replies concise and task-focused.
+- A dispatch may coalesce multiple events. Decide per event whether to reply via \`messages send\` / \`dm\` — events you do not act on simply receive no reply.
+- If an event carries \`[Hint: no_reply]\`, do not send anything for that event. \`no-reply\` is optional and only useful as an explicit intent marker.
+- Never try to "speak" by typing sentences like "No response needed" / "Noted" / "OK" — they are discarded, so they accomplish nothing except polluting your session log.
+- Keep CLI replies concise and task-focused.
 `;
 
-export function ensureClaudeWorkspace(workspaceDir: string) {
+export function ensureClaudeWorkspace(
+  workspaceDir: string,
+  log?: { warn: (msg: string) => void },
+) {
   fs.mkdirSync(workspaceDir, { recursive: true });
   fs.mkdirSync(path.join(workspaceDir, ".claude"), { recursive: true });
 
+  // CLAUDE.md is bridge-managed: always overwrite so a hosted PVC keeps the
+  // current guardrails (e.g. the `no-reply` instruction). Operators must not
+  // hand-edit this file — workspace customizations should go into AGENTS.md
+  // / SOUL.md / TOOLS.md, which are env-driven and untouched here. Surface a
+  // warning when we replace a file whose content diverges, so an operator
+  // who did edit it locally gets a signal instead of silently losing changes.
   const claudeMdPath = path.join(workspaceDir, "CLAUDE.md");
-  if (!fs.existsSync(claudeMdPath)) {
-    fs.writeFileSync(claudeMdPath, CLAUDE_MD, "utf8");
+  if (log) {
+    try {
+      const existing = fs.readFileSync(claudeMdPath, "utf8");
+      if (existing !== CLAUDE_MD) {
+        log.warn(
+          `claude-agent: overwriting divergent ${claudeMdPath} with bridge-managed template ` +
+            `(local edits to CLAUDE.md are not preserved — customize AGENTS.md / SOUL.md / TOOLS.md instead)`,
+        );
+      }
+    } catch {
+      // file missing or unreadable — first-boot case, no warning needed
+    }
   }
+  fs.writeFileSync(claudeMdPath, CLAUDE_MD, "utf8");
 }