@parall/claude-agent 1.15.1 → 1.16.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;AAiDF,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;IAwGjG,WAAW,CAAC,EAAE,UAAU,EAAE,EAAE,QAAQ;IAIpC,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,eAAe;IAIrC,OAAO,CAAC,SAAS;CAkClB"}

package/dist/dispatch.js

@@ -7,14 +7,53 @@ function extractBashCommand(input) {
     const command = input.command;
     return typeof command === "string" && command.trim() ? command.trim() : undefined;
 }
+// Returns the non-flag tokens that follow a Parall CLI invocation in `command`,
+// or null if the command isn't a Parall CLI call. Handles all the documented
+// forms — bare `parall`, `npx [--yes|-y] @parall/cli[@version]`,
+// `pnpm (exec|dlx) parall` — and skips `npx` flags so that `npx --yes`
+// matches as well as `npx -y`. Tokenization avoids the regex false-match
+// where `messages send --no-reply` looked like the receiver-side `no-reply`.
+function parseParallCliInvocation(command) {
+    const tokens = command.replace(/\s+/g, " ").trim().split(" ");
+    let i = 0;
+    if (tokens[i] === "parall") {
+        i++;
+    }
+    else if (tokens[i] === "npx") {
+        i++;
+        while (i < tokens.length && tokens[i].startsWith("-"))
+            i++;
+        if (i >= tokens.length || !/^@parall\/cli(?:@.+)?$/.test(tokens[i]))
+            return null;
+        i++;
+    }
+    else if (tokens[i] === "pnpm") {
+        i++;
+        if (i < tokens.length && (tokens[i] === "exec" || tokens[i] === "dlx"))
+            i++;
+        if (i >= tokens.length || tokens[i] !== "parall")
+            return null;
+        i++;
+    }
+    else {
+        return null;
+    }
+    return tokens.slice(i).filter((t) => !t.startsWith("-"));
+}
 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)
+    const sub = parseParallCliInvocation(command);
+    if (!sub || sub.length === 0)
+        return false;
+    // `dm <user>` or `messages send <chat>`
+    return sub[0] === "dm" || (sub[0] === "messages" && sub[1] === "send");
+}
+function isParallNoReplyCommand(command) {
+    if (!command)
         return false;
-    return /\b(messages send|dm)\b/.test(normalized);
+    const sub = parseParallCliInvocation(command);
+    return sub?.[0] === "no-reply";
 }
 export class ClaudeCodeAdapter {
     opts;
@@ -55,6 +94,10 @@ export class ClaudeCodeAdapter {
         const groupKey = randomUUID();
         let sawError = false;
         let suppressProjectedText = false;
+        // Sticky for the whole dispatch: set when the agent explicitly calls
+        // `parall no-reply` to silence the turn. All subsequent text events are
+        // emitted with project=false so the bridge never leaks a chat message.
+        let noReplyCalled = false;
         let completed = false;
         try {
             for await (const event of parseClaudeStreamJson(proc.stdout)) {
@@ -62,8 +105,14 @@ 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 === "tool_call") {
+                    const cmd = extractBashCommand(event.input);
+                    if (isParallNoReplyCommand(cmd)) {
+                        noReplyCalled = true;
+                    }
+                    else if (isParallSendCommand(cmd)) {
+                        suppressProjectedText = true;
+                    }
                 }
                 if (event.type === "error") {
                     sawError = true;
@@ -71,7 +120,11 @@ export class ClaudeCodeAdapter {
                     continue;
                 }
                 if (event.type === "text") {
-                    const project = suppressProjectedText ? false : event.project;
+                    const project = noReplyCalled
+                        ? false
+                        : suppressProjectedText
+                            ? false
+                            : event.project;
                     suppressProjectedText = false;
                     yield {
                         ...event,

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":"AAiCA,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

@@ -13,24 +13,43 @@ Reply with plain text when you want Parall to project your response back into th
 
 Use CLI only when you need an explicit side effect instead of plain-text projection:
 
-- \`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 CHT_ID --text "..." \`
+- \`npx --yes @parall/cli@latest tasks update TSK_ID --status in_progress\`
+- \`npx --yes @parall/cli@latest dm USER_ID --text "..." --no-reply\`
+- \`npx --yes @parall/cli@latest no-reply [--reason "..."]\` — end this turn without any visible reply
 
 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\`.
 
 ## Guardrails
 
-- If an event includes \`[Hint: no_reply]\`, do not send a reply.
+- If an event includes \`[Hint: no_reply]\`, **run \`npx --yes @parall/cli@latest no-reply\` as your first action** and do not type anything — not even "No response needed" / "Noted" / "OK". Plain text becomes a projected chat message; only the \`no-reply\` command silences the turn.
+- Text emitted BEFORE \`no-reply\` in the same turn is already projected as a message and cannot be retracted; text AFTER is dropped by the bridge.
+- A single dispatch may carry several events coalesced together. Once you call \`no-reply\` in a dispatch, **plain text suppression is sticky for the whole turn** — if some events still need a reply, send them explicitly via \`messages send\` / \`dm\`. Plain-text replies after \`no-reply\` are dropped silently.
 - Prefer plain text over CLI for normal chat replies.
 - Keep 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.16.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/agent-core": "1.16.0",
+    "@parall/cli": "1.16.0",
+    "@parall/sdk": "1.16.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/dispatch.ts

@@ -32,12 +32,45 @@ function extractBashCommand(input: unknown): string | undefined {
   return typeof command === "string" && command.trim() ? command.trim() : undefined;
 }
 
+// Returns the non-flag tokens that follow a Parall CLI invocation in `command`,
+// or null if the command isn't a Parall CLI call. Handles all the documented
+// forms — bare `parall`, `npx [--yes|-y] @parall/cli[@version]`,
+// `pnpm (exec|dlx) parall` — and skips `npx` flags so that `npx --yes`
+// matches as well as `npx -y`. Tokenization avoids the regex false-match
+// where `messages send --no-reply` looked like the receiver-side `no-reply`.
+function parseParallCliInvocation(command: string): string[] | null {
+  const tokens = command.replace(/\s+/g, " ").trim().split(" ");
+  let i = 0;
+  if (tokens[i] === "parall") {
+    i++;
+  } else if (tokens[i] === "npx") {
+    i++;
+    while (i < tokens.length && tokens[i].startsWith("-")) i++;
+    if (i >= tokens.length || !/^@parall\/cli(?:@.+)?$/.test(tokens[i])) return null;
+    i++;
+  } else if (tokens[i] === "pnpm") {
+    i++;
+    if (i < tokens.length && (tokens[i] === "exec" || tokens[i] === "dlx")) i++;
+    if (i >= tokens.length || tokens[i] !== "parall") return null;
+    i++;
+  } else {
+    return null;
+  }
+  return tokens.slice(i).filter((t) => !t.startsWith("-"));
+}
+
 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);
+  const sub = parseParallCliInvocation(command);
+  if (!sub || sub.length === 0) return false;
+  // `dm <user>` or `messages send <chat>`
+  return sub[0] === "dm" || (sub[0] === "messages" && sub[1] === "send");
+}
+
+function isParallNoReplyCommand(command: string | undefined): boolean {
+  if (!command) return false;
+  const sub = parseParallCliInvocation(command);
+  return sub?.[0] === "no-reply";
 }
 
 export class ClaudeCodeAdapter implements DispatchAdapter {
@@ -83,6 +116,10 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
     const groupKey = randomUUID();
     let sawError = false;
     let suppressProjectedText = false;
+    // Sticky for the whole dispatch: set when the agent explicitly calls
+    // `parall no-reply` to silence the turn. All subsequent text events are
+    // emitted with project=false so the bridge never leaks a chat message.
+    let noReplyCalled = false;
     let completed = false;
 
     try {
@@ -92,8 +129,13 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
           continue;
         }
 
-        if (event.type === "tool_call" && isParallSendCommand(extractBashCommand(event.input))) {
-          suppressProjectedText = true;
+        if (event.type === "tool_call") {
+          const cmd = extractBashCommand(event.input);
+          if (isParallNoReplyCommand(cmd)) {
+            noReplyCalled = true;
+          } else if (isParallSendCommand(cmd)) {
+            suppressProjectedText = true;
+          }
         }
 
         if (event.type === "error") {
@@ -103,7 +145,11 @@ export class ClaudeCodeAdapter implements DispatchAdapter {
         }
 
         if (event.type === "text") {
-          const project = suppressProjectedText ? false : event.project;
+          const project = noReplyCalled
+            ? false
+            : suppressProjectedText
+              ? false
+              : event.project;
           suppressProjectedText = false;
           yield {
             ...event,

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

@@ -14,26 +14,49 @@ Reply with plain text when you want Parall to project your response back into th
 
 Use CLI only when you need an explicit side effect instead of plain-text projection:
 
-- \`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 CHT_ID --text "..." \`
+- \`npx --yes @parall/cli@latest tasks update TSK_ID --status in_progress\`
+- \`npx --yes @parall/cli@latest dm USER_ID --text "..." --no-reply\`
+- \`npx --yes @parall/cli@latest no-reply [--reason "..."]\` — end this turn without any visible reply
 
 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\`.
 
 ## Guardrails
 
-- If an event includes \`[Hint: no_reply]\`, do not send a reply.
+- If an event includes \`[Hint: no_reply]\`, **run \`npx --yes @parall/cli@latest no-reply\` as your first action** and do not type anything — not even "No response needed" / "Noted" / "OK". Plain text becomes a projected chat message; only the \`no-reply\` command silences the turn.
+- Text emitted BEFORE \`no-reply\` in the same turn is already projected as a message and cannot be retracted; text AFTER is dropped by the bridge.
+- A single dispatch may carry several events coalesced together. Once you call \`no-reply\` in a dispatch, **plain text suppression is sticky for the whole turn** — if some events still need a reply, send them explicitly via \`messages send\` / \`dm\`. Plain-text replies after \`no-reply\` are dropped silently.
 - Prefer plain text over CLI for normal chat replies.
 - Keep 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");
 }