@parall/agent-core 1.31.0 → 1.32.0

package/src/bridge-workspace.ts

@@ -84,9 +84,9 @@ Messages may arrive with a \`[Thread: prll://msg_xxx]\` line in the event block,
 
 /** Extracts the `command` string from a shell/bash tool call's input payload. */
 export function extractShellCommand(input: unknown): string | undefined {
-  if (!input || typeof input !== "object") return undefined;
+  if (!input || typeof input !== 'object') return undefined;
   const command = (input as { command?: unknown }).command;
-  return typeof command === "string" && command.trim() ? command.trim() : undefined;
+  return typeof command === 'string' && command.trim() ? command.trim() : undefined;
 }
 
 /**
@@ -101,24 +101,24 @@ export function extractShellCommand(input: unknown): string | undefined {
  * `no-reply` subcommand).
  */
 export function parseParallCliInvocation(command: string): string[] | null {
-  const tokens = command.replace(/\s+/g, " ").trim().split(" ");
+  const tokens = command.replace(/\s+/g, ' ').trim().split(' ');
   let i = 0;
-  if (tokens[i] === "parall") {
+  if (tokens[i] === 'parall') {
     i++;
-  } else if (tokens[i] === "npx") {
+  } else if (tokens[i] === 'npx') {
     i++;
-    while (i < tokens.length && tokens[i].startsWith("-")) 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") {
+  } 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;
+    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("-"));
+  return tokens.slice(i).filter((t) => !t.startsWith('-'));
 }
 
 /**
@@ -132,7 +132,7 @@ export function isParallSendCommand(command: string | undefined): boolean {
   if (!command) return false;
   const sub = parseParallCliInvocation(command);
   if (!sub || sub.length === 0) return false;
-  return sub[0] === "dm" || (sub[0] === "messages" && sub[1] === "send");
+  return sub[0] === 'dm' || (sub[0] === 'messages' && sub[1] === 'send');
 }
 
 /**
@@ -144,5 +144,5 @@ export function isParallSendCommand(command: string | undefined): boolean {
 export function isParallNoReplyCommand(command: string | undefined): boolean {
   if (!command) return false;
   const sub = parseParallCliInvocation(command);
-  return sub?.[0] === "no-reply";
+  return sub?.[0] === 'no-reply';
 }

package/src/dispatch-adapter.ts

@@ -1,5 +1,5 @@
-import type { ParallClient } from "@parall/sdk";
-import type { ParallEvent } from "./types.js";
+import type { ParallClient } from '@parall/sdk';
+import type { ParallEvent } from './types.js';
 
 export type GatewayLogger = {
   info: (msg: string) => void;
@@ -29,16 +29,31 @@ export type DispatchContext = {
 
 export type RuntimeEvent =
   | {
-      type: "runtime_session";
+      type: 'runtime_session';
       runtimeSessionId: string;
       runtimeLaneKey?: string;
       runtimeRef?: Record<string, unknown>;
     }
-  | { type: "thinking"; text: string; groupKey?: string }
-  | { type: "tool_call"; callId: string; toolName: string; input: unknown; startedAt?: string; groupKey?: string }
-  | { type: "tool_result"; callId: string; toolName: string; output: string; error?: string; durationMs?: number; groupKey?: string }
-  | { type: "text"; text: string; project?: boolean; groupKey?: string }
-  | { type: "error"; message: string };
+  | { type: 'thinking'; text: string; groupKey?: string }
+  | {
+      type: 'tool_call';
+      callId: string;
+      toolName: string;
+      input: unknown;
+      startedAt?: string;
+      groupKey?: string;
+    }
+  | {
+      type: 'tool_result';
+      callId: string;
+      toolName: string;
+      output: string;
+      error?: string;
+      durationMs?: number;
+      groupKey?: string;
+    }
+  | { type: 'text'; text: string; project?: boolean; groupKey?: string }
+  | { type: 'error'; message: string };
 
 export type DispatchOpts = {
   event: ParallEvent;
@@ -98,4 +113,12 @@ export interface DispatchAdapter {
 
   /** Return the path to the session's history file on disk, if the runtime persists it. */
   getSessionHistoryPath?(sessionKey: string): string | undefined;
+
+  /**
+   * Abort the in-flight dispatch for the given session. Called by the gateway
+   * when the dispatch deadline is exceeded. Implementations should unblock the
+   * `dispatch()` generator (e.g. close a turn sink, end stdin, fail a stream)
+   * so the `for await` loop in `runDispatch` exits naturally. Must be idempotent.
+   */
+  abortDispatch?(sessionKey: string): void;
 }

package/src/event-format.ts

@@ -1,31 +1,58 @@
-import type { ForkResult, ParallEvent } from "./types.js";
+import type { ForkResult, ParallEvent } from './types.js';
 
 function sanitizeMeta(value: string): string {
-  return value.replace(/[\r\n]+/g, " ").replace(/[[\]|]/g, " ").trim();
+  return value
+    .replace(/[\r\n]+/g, ' ')
+    .replace(/[[\]|]/g, ' ')
+    .trim();
 }
 
 export function buildEventBody(event: ParallEvent): string {
   const lines: string[] = [];
-  if (event.type === "message") {
+  if (event.type === 'message') {
     lines.push(`[Event: message.new]`);
     const chatLabel = event.targetName
       ? `"${event.targetName}" (prll://${event.targetId})`
       : `prll://${event.targetId}`;
-    lines.push(`[Chat: ${chatLabel} | type: ${event.targetType ?? "unknown"}]`);
+    lines.push(`[Chat: ${chatLabel} | type: ${event.targetType ?? 'unknown'}]`);
     lines.push(`[From: ${event.senderName} (prll://${event.senderId})]`);
     lines.push(`[Message ID: prll://${event.messageId}]`);
-    if (event.threadRootId) lines.push(`[Thread: prll://${event.threadRootId}]`);
+    if (event.threadRootId) {
+      const threadMeta = [
+        `prll://${event.threadRootId}`,
+        event.threadReplyCount != null ? `${event.threadReplyCount} replies` : null,
+        event.threadUnreadCount != null && event.threadUnreadCount > 0
+          ? `${event.threadUnreadCount} unread`
+          : null,
+        event.threadUnreadCount != null && event.threadUnreadCount > 0 && event.threadUnreadSince
+          ? `since: prll://${event.threadUnreadSince}`
+          : null,
+      ]
+        .filter(Boolean)
+        .join(' | ');
+      lines.push(`[Thread: ${threadMeta}]`);
+    }
+    if (event.unreadCount != null && event.unreadCount > 1) {
+      const countStr = event.unreadCount >= 1000 ? '999+' : String(event.unreadCount);
+      const sinceStr = event.unreadSince ? ` | since: prll://${event.unreadSince}` : '';
+      let line = `[Unread: ${countStr} messages${sinceStr}]`;
+      if (event.unreadCount > 50) line += ` — fetch recent context with --limit, not all`;
+      lines.push(line);
+    }
     if (event.noReply) lines.push(`[Hint: no_reply]`);
     if (event.attachments?.length) {
       for (const att of event.attachments) {
-        const sizeStr = att.fileSize >= 1048576
-          ? `${(att.fileSize / 1048576).toFixed(1)}MB`
-          : `${Math.round(att.fileSize / 1024)}KB`;
-        lines.push(`[Attachment: prll://${att.id} | ${sanitizeMeta(att.mimeType)} | ${sizeStr} | ${sanitizeMeta(att.fileName)}]`);
+        const sizeStr =
+          att.fileSize >= 1048576
+            ? `${(att.fileSize / 1048576).toFixed(1)}MB`
+            : `${Math.round(att.fileSize / 1024)}KB`;
+        lines.push(
+          `[Attachment: prll://${att.id} | ${sanitizeMeta(att.mimeType)} | ${sizeStr} | ${sanitizeMeta(att.fileName)}]`,
+        );
       }
     }
-    lines.push("", event.body);
-  } else if (event.type === "task_comment") {
+    lines.push('', event.body);
+  } else if (event.type === 'task_comment') {
     lines.push(`[Event: task.comment.created]`);
     const taskLabel = event.targetName
       ? `${event.targetName} (prll://${event.targetId})`
@@ -34,20 +61,34 @@ export function buildEventBody(event: ParallEvent): string {
     if (event.deliveryReason) lines.push(`[Delivery: ${sanitizeMeta(event.deliveryReason)}]`);
     lines.push(`[From: ${event.senderName} (prll://${event.senderId})]`);
     lines.push(`[Comment ID: prll://${event.messageId}]`);
-    lines.push("", event.body);
-  } else if (event.type === "approval") {
+    lines.push('', event.body);
+  } else if (event.type === 'wiki_comment') {
+    lines.push(`[Event: wiki.comment.created]`);
+    const target = event.replyTargetUri ?? `prll://${event.targetId}`;
+    if (event.targetType === 'changeset') {
+      lines.push(`[Wiki Changeset: ${target}]`);
+    } else {
+      lines.push(
+        `[Wiki: ${event.targetName ? `${sanitizeMeta(event.targetName)} (${target})` : target}]`,
+      );
+    }
+    if (event.deliveryReason) lines.push(`[Delivery: ${sanitizeMeta(event.deliveryReason)}]`);
+    lines.push(`[From: ${event.senderName} (prll://${event.senderId})]`);
+    lines.push(`[Comment ID: prll://${event.messageId}]`);
+    lines.push('', event.body);
+  } else if (event.type === 'approval') {
     lines.push(`[Event: approval.decided]`);
     lines.push(`[Approval: prll://${event.messageId}]`);
     lines.push(`[Chat: prll://${event.targetId}]`);
     lines.push(`[Decided by: ${event.senderName} (prll://${event.senderId})]`);
-    lines.push("", event.body);
-  } else if (event.type === "schedule") {
+    lines.push('', event.body);
+  } else if (event.type === 'schedule') {
     lines.push(`[Event: schedule.fired]`);
     lines.push(`[Schedule: prll://${event.targetId}]`);
     lines.push(`[Run: prll://${event.messageId}]`);
     if (event.scheduledFireAt) lines.push(`[Scheduled at: ${sanitizeMeta(event.scheduledFireAt)}]`);
     if (event.attachedUri) lines.push(`[Attached: ${sanitizeMeta(event.attachedUri)}]`);
-    lines.push("", event.body);
+    lines.push('', event.body);
   } else {
     lines.push(`[Event: task.assigned]`);
     const taskLabel = event.targetName
@@ -55,31 +96,36 @@ export function buildEventBody(event: ParallEvent): string {
       : `prll://${event.targetId}`;
     lines.push(`[Task: ${taskLabel}]`);
     lines.push(`[Assigned by: ${event.senderName} (prll://${event.senderId})]`);
-    lines.push("", event.body);
+    lines.push('', event.body);
   }
-  return lines.join("\n") + buildSendMessageHint(event);
+  return lines.join('\n') + buildSendMessageHint(event);
 }
 
 export function buildEventBodyForForkResult(event: ParallEvent): string {
-  return buildEventBody(event).replace(/\n<system-reminder>[\s\S]*<\/system-reminder>$/, "");
+  return buildEventBody(event).replace(/\n<system-reminder>[\s\S]*<\/system-reminder>$/, '');
 }
 
 function buildSendMessageHint(event: ParallEvent): string {
-  if (event.noReply) return "";
+  if (event.noReply) return '';
+
+  if (event.type === 'wiki_comment' && event.replyTargetUri) {
+    const where = event.targetType === 'changeset' ? 'this changeset comment' : 'this wiki page';
+    return `\n<system-reminder>To reply on ${where}, run: \`parall comments add --target "${event.replyTargetUri}" --body "..."\` (read the thread first with \`parall comments list --target "${event.replyTargetUri}"\`). To message someone instead, use \`parall messages send\` / \`parall dm\`. Your plain text output is not delivered.</system-reminder>`;
+  }
 
-  if (event.targetId.startsWith("cht_")) {
+  if (event.targetId.startsWith('cht_')) {
     return `\n<system-reminder>To reply, run: \`parall messages send prll://${event.targetId} --text "..."\` — your plain text output is not delivered to the chat.</system-reminder>`;
   }
 
-  if (event.targetId.startsWith("tsk_")) {
+  if (event.targetId.startsWith('tsk_')) {
     return `\n<system-reminder>To respond, use the CLI: \`parall tasks update\` / \`parall tasks comments add\`. To message someone, use \`parall messages send\` / \`parall dm\`. Your plain text output is not delivered.</system-reminder>`;
   }
 
-  if (event.targetId.startsWith("sch_")) {
+  if (event.targetId.startsWith('sch_')) {
     return `\n<system-reminder>To communicate, use the CLI: \`parall messages send\` / \`parall dm\`. Your plain text output is not delivered.</system-reminder>`;
   }
 
-  return "";
+  return '';
 }
 
 export function buildForkScopePrefix(event: ParallEvent): string {
@@ -90,17 +136,21 @@ export function buildForkScopePrefix(event: ParallEvent): string {
 }
 
 export function buildForkResultPrefix(results: ForkResult[]): string {
-  if (!results.length) return "";
+  if (!results.length) return '';
   const blocks = results.map((result) => {
     const lines: string[] = [];
     for (const body of result.eventBodies) {
       lines.push(body);
     }
-    lines.push(`[This event was handled by a parallel fork session. Do NOT re-handle, re-reply, or duplicate work for it.]`);
-    lines.push(`[Fork summary: ${result.agentSummary ? sanitizeMeta(result.agentSummary) : "No fork summary available — the fork completed without producing a text summary. Check the target chat/task for any actions the fork already took before acting."}]`);
-    if (result.actions.length) lines.push(`[Fork actions: ${result.actions.join("; ")}]`);
+    lines.push(
+      `[This event was handled by a parallel fork session. Do NOT re-handle, re-reply, or duplicate work for it.]`,
+    );
+    lines.push(
+      `[Fork summary: ${result.agentSummary ? sanitizeMeta(result.agentSummary) : 'No fork summary available — the fork completed without producing a text summary. Check the target chat/task for any actions the fork already took before acting.'}]`,
+    );
+    if (result.actions.length) lines.push(`[Fork actions: ${result.actions.join('; ')}]`);
     if (result.historyPath) lines.push(`[Fork history: ${result.historyPath}]`);
-    return lines.join("\n");
+    return lines.join('\n');
   });
-  return blocks.join("\n\n") + "\n\n---\n\n";
+  return blocks.join('\n\n') + '\n\n---\n\n';
 }