@parall/parall 1.30.0 → 1.31.0

package/dist/gateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,uGAAuG;AACvG,KAAK,qBAAqB,CAAC,CAAC,GAAG,OAAO,IAAI,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAuBnF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAkQxD,eAAO,MAAM,aAAa,EAAE,qBAAqB,CAAC,qBAAqB,CAkItE,CAAC"}
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../src/gateway.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,uGAAuG;AACvG,KAAK,qBAAqB,CAAC,CAAC,GAAG,OAAO,IAAI,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AA4BnF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAoRxD,eAAO,MAAM,aAAa,EAAE,qBAAqB,CAAC,qBAAqB,CAsItE,CAAC"}

package/dist/gateway.js

@@ -1,4 +1,5 @@
 import { ParallAgentGateway, parseShutdownDeadlineMs, } from "@parall/agent-core";
+import { appendPreparedLocalAttachmentRefs, ensureLocalAttachmentGitExclude, pinLocalAttachmentPaths, } from "@parall/agent-core/internal/attachment-input";
 import { ApiError, ParallClient, ParallWs } from "@parall/sdk";
 import * as crypto from "node:crypto";
 import * as os from "node:os";
@@ -146,68 +147,86 @@ async function waitForOpenClawSessionId(sessionsDir, sessionKey, timeoutMs = 10_
 }
 function createOpenClawDispatchAdapter(opts) {
     return {
-        async *dispatch({ event, earlierEvents = [], bodyForAgent, sessionKey }) {
-            const stream = createRuntimeEventStream();
-            let reasoningBuffer = "";
-            let turnGroupKey = "";
-            const run = opts.core.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
-                ctx: buildInboundCtx(opts.core, opts.accountId, event, sessionKey, bodyForAgent, earlierEvents),
-                cfg: opts.cfg,
-                dispatcherOptions: {
-                    deliver: async (payload) => {
-                        const replyText = payload.text?.trim();
-                        if (!replyText)
-                            return;
-                        stream.push({
-                            type: "text",
-                            text: replyText,
-                            project: false,
-                            groupKey: turnGroupKey || undefined,
-                        });
-                    },
-                    onReplyStart: () => {
-                        turnGroupKey = crypto.randomUUID();
-                        setDispatchGroupKey(sessionKey, turnGroupKey);
-                    },
-                },
-                replyOptions: {
-                    onReasoningStream: (payload) => {
-                        reasoningBuffer += payload.text ?? "";
-                    },
-                    onReasoningEnd: async () => {
-                        if (!reasoningBuffer)
-                            return;
-                        stream.push({
-                            type: "thinking",
-                            text: reasoningBuffer,
-                            groupKey: turnGroupKey || undefined,
-                        });
-                        reasoningBuffer = "";
-                    },
-                },
-            });
-            run.then(() => stream.end()).catch((err) => stream.fail(err));
-            let sessionId;
+        async *dispatch({ event, earlierEvents = [], bodyForAgent, sessionKey, context }) {
+            let promptBody = bodyForAgent;
+            let releasePreparedAttachments = () => { };
             try {
-                sessionId = await Promise.race([
-                    waitForOpenClawSessionId(opts.sessionsDir, sessionKey),
-                    run.then(() => null, (err) => { throw err; }),
-                ]);
+                const prepared = await appendPreparedLocalAttachmentRefs(bodyForAgent, event, context, {
+                    workspaceDir: opts.workspaceDir,
+                    log: context.log,
+                });
+                promptBody = prepared.body;
+                releasePreparedAttachments = pinLocalAttachmentPaths(prepared.attachments.images);
             }
-            catch {
-                sessionId = null;
+            catch (err) {
+                context.log?.warn?.(`failed to prepare local attachments: ${String(err)}`);
             }
-            if (!sessionId) {
-                stream.fail(new Error(`OpenClaw did not expose a sessionId for ${sessionKey}`));
+            try {
+                const stream = createRuntimeEventStream();
+                let reasoningBuffer = "";
+                let turnGroupKey = "";
+                const run = opts.core.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
+                    ctx: buildInboundCtx(opts.core, opts.accountId, event, sessionKey, promptBody, earlierEvents),
+                    cfg: opts.cfg,
+                    dispatcherOptions: {
+                        deliver: async (payload) => {
+                            const replyText = payload.text?.trim();
+                            if (!replyText)
+                                return;
+                            stream.push({
+                                type: "text",
+                                text: replyText,
+                                project: false,
+                                groupKey: turnGroupKey || undefined,
+                            });
+                        },
+                        onReplyStart: () => {
+                            turnGroupKey = crypto.randomUUID();
+                            setDispatchGroupKey(sessionKey, turnGroupKey);
+                        },
+                    },
+                    replyOptions: {
+                        onReasoningStream: (payload) => {
+                            reasoningBuffer += payload.text ?? "";
+                        },
+                        onReasoningEnd: async () => {
+                            if (!reasoningBuffer)
+                                return;
+                            stream.push({
+                                type: "thinking",
+                                text: reasoningBuffer,
+                                groupKey: turnGroupKey || undefined,
+                            });
+                            reasoningBuffer = "";
+                        },
+                    },
+                });
+                run.then(() => stream.end()).catch((err) => stream.fail(err));
+                let sessionId;
+                try {
+                    sessionId = await Promise.race([
+                        waitForOpenClawSessionId(opts.sessionsDir, sessionKey),
+                        run.then(() => null, (err) => { throw err; }),
+                    ]);
+                }
+                catch {
+                    sessionId = null;
+                }
+                if (!sessionId) {
+                    stream.fail(new Error(`OpenClaw did not expose a sessionId for ${sessionKey}`));
+                }
+                else {
+                    yield {
+                        type: "runtime_session",
+                        runtimeSessionId: sessionId,
+                        runtimeLaneKey: sessionKey,
+                    };
+                }
+                yield* stream.stream();
             }
-            else {
-                yield {
-                    type: "runtime_session",
-                    runtimeSessionId: sessionId,
-                    runtimeLaneKey: sessionKey,
-                };
+            finally {
+                releasePreparedAttachments();
             }
-            yield* stream.stream();
         },
         getBranchPoint(sessionKey) {
             const transcriptFile = resolveTranscriptFile(opts.sessionsDir, sessionKey);
@@ -308,11 +327,14 @@ export const parallGateway = {
         });
         const orchestratorKey = buildOrchestratorSessionKey(ctx.accountId);
         const sessionsDir = path.join(stateDir, "agents", "main", "sessions");
+        const workspaceDir = process.cwd();
+        ensureLocalAttachmentGitExclude(workspaceDir);
         const dispatchAdapter = createOpenClawDispatchAdapter({
             core,
             cfg: ctx.cfg,
             accountId: ctx.accountId,
             sessionsDir,
+            workspaceDir,
         });
         const gateway = new ParallAgentGateway({
             accountId: ctx.accountId,
@@ -358,6 +380,7 @@ export const parallGateway = {
                 removeParallAccountState(ctx.accountId);
             },
             onNewSession: () => { clearSessionState(sessionsDir, orchestratorKey); },
+            onSessionStale: () => { clearSessionState(sessionsDir, orchestratorKey); },
         });
         try {
             await gateway.run(ctx.abortSignal);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/parall",
-  "version": "1.30.0",
+  "version": "1.31.0",
   "description": "OpenClaw channel plugin for Parall IM",
   "license": "MIT",
   "repository": {
@@ -16,8 +16,8 @@
     "openclaw.plugin.json"
   ],
   "dependencies": {
-    "@parall/agent-core": "1.30.0",
-    "@parall/sdk": "1.30.0"
+    "@parall/sdk": "1.31.0",
+    "@parall/agent-core": "1.31.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/gateway.ts

@@ -10,6 +10,11 @@ import {
   type ParallEvent,
   type RuntimeEvent,
 } from "@parall/agent-core";
+import {
+  appendPreparedLocalAttachmentRefs,
+  ensureLocalAttachmentGitExclude,
+  pinLocalAttachmentPaths,
+} from "@parall/agent-core/internal/attachment-input";
 import { ApiError, ParallClient, ParallWs } from "@parall/sdk";
 import type { ParallChannelConfig } from "./types.js";
 import * as crypto from "node:crypto";
@@ -185,68 +190,86 @@ function createOpenClawDispatchAdapter(opts: {
   cfg: Record<string, unknown>;
   accountId: string;
   sessionsDir: string;
+  workspaceDir: string;
 }): DispatchAdapter {
   return {
-    async *dispatch({ event, earlierEvents = [], bodyForAgent, sessionKey }) {
-      const stream = createRuntimeEventStream();
-      let reasoningBuffer = "";
-      let turnGroupKey = "";
+    async *dispatch({ event, earlierEvents = [], bodyForAgent, sessionKey, context }) {
+      let promptBody = bodyForAgent;
+      let releasePreparedAttachments = () => {};
+      try {
+        const prepared = await appendPreparedLocalAttachmentRefs(bodyForAgent, event, context, {
+          workspaceDir: opts.workspaceDir,
+          log: context.log,
+        });
+        promptBody = prepared.body;
+        releasePreparedAttachments = pinLocalAttachmentPaths(prepared.attachments.images);
+      } catch (err) {
+        context.log?.warn?.(`failed to prepare local attachments: ${String(err)}`);
+      }
 
-      const run = opts.core.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
-        ctx: buildInboundCtx(opts.core, opts.accountId, event, sessionKey, bodyForAgent, earlierEvents),
-        cfg: opts.cfg,
-        dispatcherOptions: {
-          deliver: async (payload: { text?: string }) => {
-            const replyText = payload.text?.trim();
-            if (!replyText) return;
-            stream.push({
-              type: "text",
-              text: replyText,
-              project: false,
-              groupKey: turnGroupKey || undefined,
-            });
-          },
-          onReplyStart: () => {
-            turnGroupKey = crypto.randomUUID();
-            setDispatchGroupKey(sessionKey, turnGroupKey);
-          },
-        },
-        replyOptions: {
-          onReasoningStream: (payload: { text?: string }) => {
-            reasoningBuffer += payload.text ?? "";
+      try {
+        const stream = createRuntimeEventStream();
+        let reasoningBuffer = "";
+        let turnGroupKey = "";
+
+        const run = opts.core.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
+          ctx: buildInboundCtx(opts.core, opts.accountId, event, sessionKey, promptBody, earlierEvents),
+          cfg: opts.cfg,
+          dispatcherOptions: {
+            deliver: async (payload: { text?: string }) => {
+              const replyText = payload.text?.trim();
+              if (!replyText) return;
+              stream.push({
+                type: "text",
+                text: replyText,
+                project: false,
+                groupKey: turnGroupKey || undefined,
+              });
+            },
+            onReplyStart: () => {
+              turnGroupKey = crypto.randomUUID();
+              setDispatchGroupKey(sessionKey, turnGroupKey);
+            },
           },
-          onReasoningEnd: async () => {
-            if (!reasoningBuffer) return;
-            stream.push({
-              type: "thinking",
-              text: reasoningBuffer,
-              groupKey: turnGroupKey || undefined,
-            });
-            reasoningBuffer = "";
+          replyOptions: {
+            onReasoningStream: (payload: { text?: string }) => {
+              reasoningBuffer += payload.text ?? "";
+            },
+            onReasoningEnd: async () => {
+              if (!reasoningBuffer) return;
+              stream.push({
+                type: "thinking",
+                text: reasoningBuffer,
+                groupKey: turnGroupKey || undefined,
+              });
+              reasoningBuffer = "";
+            },
           },
-        },
-      });
+        });
 
-      run.then(() => stream.end()).catch((err) => stream.fail(err));
-      let sessionId: string | null;
-      try {
-        sessionId = await Promise.race([
-          waitForOpenClawSessionId(opts.sessionsDir, sessionKey),
-          run.then(() => null as string | null, (err) => { throw err; }),
-        ]);
-      } catch {
-        sessionId = null;
-      }
-      if (!sessionId) {
-        stream.fail(new Error(`OpenClaw did not expose a sessionId for ${sessionKey}`));
-      } else {
-        yield {
-          type: "runtime_session",
-          runtimeSessionId: sessionId,
-          runtimeLaneKey: sessionKey,
-        };
+        run.then(() => stream.end()).catch((err) => stream.fail(err));
+        let sessionId: string | null;
+        try {
+          sessionId = await Promise.race([
+            waitForOpenClawSessionId(opts.sessionsDir, sessionKey),
+            run.then(() => null as string | null, (err) => { throw err; }),
+          ]);
+        } catch {
+          sessionId = null;
+        }
+        if (!sessionId) {
+          stream.fail(new Error(`OpenClaw did not expose a sessionId for ${sessionKey}`));
+        } else {
+          yield {
+            type: "runtime_session",
+            runtimeSessionId: sessionId,
+            runtimeLaneKey: sessionKey,
+          };
+        }
+        yield* stream.stream();
+      } finally {
+        releasePreparedAttachments();
       }
-      yield* stream.stream();
     },
 
     getBranchPoint(sessionKey: string): string | undefined {
@@ -351,11 +374,14 @@ export const parallGateway: ChannelGatewayAdapter<ResolvedParallAccount> = {
     });
     const orchestratorKey = buildOrchestratorSessionKey(ctx.accountId);
     const sessionsDir = path.join(stateDir, "agents", "main", "sessions");
+    const workspaceDir = process.cwd();
+    ensureLocalAttachmentGitExclude(workspaceDir);
     const dispatchAdapter = createOpenClawDispatchAdapter({
       core,
       cfg: ctx.cfg,
       accountId: ctx.accountId,
       sessionsDir,
+      workspaceDir,
     });
 
     const gateway = new ParallAgentGateway({
@@ -402,6 +428,7 @@ export const parallGateway: ChannelGatewayAdapter<ResolvedParallAccount> = {
         removeParallAccountState(ctx.accountId);
       },
       onNewSession: () => { clearSessionState(sessionsDir, orchestratorKey); },
+      onSessionStale: () => { clearSessionState(sessionsDir, orchestratorKey); },
     });
 
     try {