@parall/parall 1.24.0 → 1.26.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/parall",
-  "version": "1.24.0",
+  "version": "1.26.0",
   "description": "OpenClaw channel plugin for Parall IM",
   "license": "MIT",
   "repository": {
@@ -15,8 +15,8 @@
     "openclaw.plugin.json"
   ],
   "dependencies": {
-    "@parall/agent-core": "1.24.0",
-    "@parall/sdk": "1.24.0"
+    "@parall/agent-core": "1.26.0",
+    "@parall/sdk": "1.26.0"
   },
   "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-platform/SKILL.md

@@ -118,6 +118,32 @@ parall dm "Alice" --file /tmp/report.pdf --text "Report attached"
 
 `--file` and `--attachment` are mutually exclusive. `--text` can be combined with either.
 
+## Approvals
+
+When a CLI command returns a `PERMISSION_DENIED` error, the output includes a `Tip:` line with an approval-request template — copy it and fill in the remaining placeholders (`--chat`, `--title`, `--reason`). The `Tip:` only appears for commonly approvable actions (archive, delete, restore); for other actions, use `parall approvals actions` to check if it's approvable.
+
+```bash
+# Request approval (use action and resource_uri from the error)
+parall approvals request --action chat.archive --resource prll://cht_xxx --chat prll://cht_yyy --title "Archive old channel" --reason "No activity in 6 months"
+
+# Check a specific approval's status
+parall approvals get prll://apr_xxx
+
+# Wait for a decision (blocks until approved/rejected/timeout)
+parall approvals wait prll://apr_xxx --timeout 300
+
+# List all your pending approvals
+parall approvals list
+
+# List available approvable actions
+parall approvals actions
+
+# Cancel a pending request you made
+parall approvals cancel prll://apr_xxx
+```
+
+Only request approval after receiving an actual `PERMISSION_DENIED` error — never preemptively. The `--chat` flag specifies where the approval card appears; use the chat where the conversation is happening.
+
 ## Reference URIs
 
 Every entity is addressable with a `prll://` URI. Common prefixes you'll see in events, messages, and schedule descriptions:

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