@parall/parall 1.25.0 → 1.26.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/parall",
-  "version": "1.25.0",
+  "version": "1.26.1",
   "description": "OpenClaw channel plugin for Parall IM",
   "license": "MIT",
   "repository": {
@@ -15,8 +15,8 @@
     "openclaw.plugin.json"
   ],
   "dependencies": {
-    "@parall/sdk": "1.25.0",
-    "@parall/agent-core": "1.25.0"
+    "@parall/sdk": "1.26.1",
+    "@parall/agent-core": "1.26.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
@@ -36,7 +36,7 @@
     }
   },
   "scripts": {
-    "build": "tsc -b",
+    "build": "tsc -b && node scripts/generate-skills.mjs",
     "test": "node --test test/*.test.mjs"
   }
 }

package/skills/parall-schedules/SKILL.md

@@ -37,7 +37,7 @@ parall schedules create \
   --name "Followup" \
   --description "Remind the user about the PR review if still pending" \
   --target-ids prll://usr_xxx \
-  --run-at 2026-04-19T15:00:00Z
+  --run-at <FUTURE_RFC3339_TIME>
 ```
 
 `--target-ids` is who receives the fire (usually yourself when you're self-scheduling; another agent or human when delegating). `--attached-to-uri` optionally anchors the schedule to a task / chat / project / wiki page — when that resource is archived or deleted, the schedule auto-cancels (`cancel_reason=attached_gone`).
@@ -75,7 +75,7 @@ Your job is to interpret the description and act:
 
 1. Read the description and any `prll://` refs it contains
 2. Do whatever the prompt asks (send a message, create a task, update a wiki, etc.) — there is no canonical response format
-3. Optional: if the fire is genuinely a no-op and you don't want to produce any artifact, use `no-reply` (from `parall-platform` skill) to stay silent for this turn
+3. Optional: if the fire is genuinely a no-op and you don't want to produce any artifact, use `no-reply` (from parall-platform skill) to stay silent for this turn
 
 Do not treat schedule fires as "tasks assigned to you" — there's no status to transition, no acknowledgment required. If the work warrants a task (multi-step, needs tracking), create one from within the response.
 

package/skills/parall-wiki/SKILL.md

@@ -28,7 +28,7 @@ parall wiki sync <slug>
 ```
 
 This downloads wiki files to a local directory. The output includes the
-**absolute mount path** for each wiki (e.g. `synced → /data/.openclaw/workspace/kb`).
+**absolute mount path** for each wiki (e.g. `synced → /path/to/workspace/kb`).
 
 ### Step 2: Find the mount path
 

package/src/config-manager.ts

@@ -81,18 +81,43 @@ function applyToOpenClawConfig(
   models.providers = providers;
   existing.models = models;
 
-  // Deep-merge agents.defaults (preserve existing fields, overlay platform)
+  // Strip keys OpenClaw doesn't recognize from agents.defaults — platform-only
+  // keys like thinking_effort are consumed by agent-core's PlatformConfigManager.
+  // See: OpenClaw agents.defaults config schema.
+  const OPENCLAW_AGENTS_DEFAULTS_KEYS = new Set(["model", "maxTokens", "compaction"]);
+
+  // Unconditionally sanitize existing defaults to self-heal already-poisoned
+  // openclaw.json files (e.g. mode=self agents that were poisoned while in
+  // platform mode).
+  const agents = (existing.agents ?? {}) as Record<string, unknown>;
+  const existingDefaults = (agents.defaults ?? {}) as Record<string, unknown>;
+  const cleanedExisting: Record<string, unknown> = {};
+  for (const [k, v] of Object.entries(existingDefaults)) {
+    if (OPENCLAW_AGENTS_DEFAULTS_KEYS.has(k)) {
+      cleanedExisting[k] = v;
+    }
+  }
+
+  // Overlay platform defaults (filtered) when present.
   const platformAgents = (platformConfig.agents ?? {}) as Record<string, unknown>;
-  if (platformAgents.defaults !== undefined) {
-    const agents = (existing.agents ?? {}) as Record<string, unknown>;
-    const existingDefaults = (agents.defaults ?? {}) as Record<string, unknown>;
-    agents.defaults = {
-      ...existingDefaults,
-      ...(platformAgents.defaults as Record<string, unknown>),
-    };
-    existing.agents = agents;
+  const rawDefaults = platformAgents.defaults;
+  if (
+    rawDefaults !== undefined &&
+    rawDefaults !== null &&
+    typeof rawDefaults === "object" &&
+    !Array.isArray(rawDefaults)
+  ) {
+    const raw = rawDefaults as Record<string, unknown>;
+    for (const [k, v] of Object.entries(raw)) {
+      if (OPENCLAW_AGENTS_DEFAULTS_KEYS.has(k)) {
+        cleanedExisting[k] = v;
+      }
+    }
   }
 
+  agents.defaults = cleanedExisting;
+  existing.agents = agents;
+
   // No plugin tools to allow — all operations go through CLI.
 
   // Atomic write

package/src/fork.ts

@@ -2,9 +2,10 @@
 //
 // When the orchestrator's main session is busy, new events are handled by
 // forking the main session's transcript and dispatching to the fork in parallel.
-// The on-disk JSONL transcript always reflects the state BEFORE the current
-// dispatch (in-flight messages are memory-only), so the fork inherits all
-// prior history without race conditions.
+// The caller provides a pre-dispatch branch point so the fork inherits
+// history up to (but not including) the in-flight dispatch. Without a
+// branch point, the fork falls back to the current on-disk leaf — which
+// may include partial in-flight state.
 
 import * as fs from "node:fs";
 import * as path from "node:path";
@@ -102,6 +103,7 @@ export function forkOrchestratorSession(opts: {
   accountId: string;
   transcriptFile: string;
   sessionsDir: string;
+  branchPointId?: string;
 }): ForkSessionResult | null {
   const { orchestratorSessionKey, accountId, transcriptFile, sessionsDir } = opts;
 
@@ -109,7 +111,7 @@ export function forkOrchestratorSession(opts: {
 
   try {
     const manager = SessionManager.open(transcriptFile);
-    const leafId = manager.getLeafId();
+    const leafId = opts.branchPointId ?? manager.getLeafId();
 
     let sessionId: string;
     let sessionFile: string;

package/src/gateway.ts

@@ -27,6 +27,7 @@ import { buildOrchestratorSessionKey } from "./session.js";
 import type { ResolvedParallAccount } from "./types.js";
 import { fetchAndApplyPlatformConfig } from "./config-manager.js";
 import { startWikiHelper } from "./wiki-helper.js";
+import { SessionManager } from "@mariozechner/pi-coding-agent";
 import { cleanupForkSession, forkOrchestratorSession, resolveTranscriptFile } from "./fork.js";
 
 function resolveWsUrl(account: ResolvedParallAccount): string {
@@ -210,7 +211,18 @@ function createOpenClawDispatchAdapter(opts: {
       yield* stream.stream();
     },
 
-    forkSession({ sessionKey }) {
+    getBranchPoint(sessionKey: string): string | undefined {
+      const transcriptFile = resolveTranscriptFile(opts.sessionsDir, sessionKey);
+      if (!transcriptFile) return undefined;
+      try {
+        const manager = SessionManager.open(transcriptFile);
+        return manager.getLeafId() ?? undefined;
+      } catch {
+        return undefined;
+      }
+    },
+
+    forkSession({ sessionKey, preDispatchBranchPoint }) {
       const transcriptFile = resolveTranscriptFile(opts.sessionsDir, sessionKey);
       if (!transcriptFile) return null;
       return forkOrchestratorSession({
@@ -218,6 +230,7 @@ function createOpenClawDispatchAdapter(opts: {
         accountId: opts.accountId,
         transcriptFile,
         sessionsDir: opts.sessionsDir,
+        branchPointId: preDispatchBranchPoint,
       });
     },