@parall/parall 1.31.0 → 1.32.0

package/dist/oc-session.js

@@ -5,9 +5,9 @@
 // Sync check: when bumping devDependencies.openclaw, diff upstream
 // pi-coding-agent/dist/core/session-manager.js for new migration steps
 // or structural changes to createBranchedSession / _buildIndex.
-import { randomUUID } from "node:crypto";
-import { existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
-import { join, resolve } from "node:path";
+import { randomUUID } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
 export const CURRENT_SESSION_VERSION = 3;
 // ---------------------------------------------------------------------------
 // Helpers
@@ -23,7 +23,7 @@ function generateId(existing) {
 function loadEntries(filePath) {
     if (!existsSync(filePath))
         return [];
-    const lines = readFileSync(filePath, "utf-8").trim().split("\n");
+    const lines = readFileSync(filePath, 'utf-8').trim().split('\n');
     const entries = [];
     for (const line of lines) {
         if (!line.trim())
@@ -38,7 +38,7 @@ function loadEntries(filePath) {
     if (entries.length === 0)
         return entries;
     const h = entries[0];
-    if (h.type !== "session" || typeof h.id !== "string")
+    if (h.type !== 'session' || typeof h.id !== 'string')
         return [];
     return entries;
 }
@@ -47,7 +47,7 @@ function migrateV1ToV2(entries) {
     const ids = new Set();
     let prevId = null;
     for (const entry of entries) {
-        if (entry.type === "session") {
+        if (entry.type === 'session') {
             entry.version = 2;
             continue;
         }
@@ -56,11 +56,11 @@ function migrateV1ToV2(entries) {
         ids.add(e.id);
         e.parentId = prevId;
         prevId = e.id;
-        if (e.type === "compaction") {
+        if (e.type === 'compaction') {
             const comp = e;
-            if (typeof comp.firstKeptEntryIndex === "number") {
+            if (typeof comp.firstKeptEntryIndex === 'number') {
                 const target = entries[comp.firstKeptEntryIndex];
-                if (target && target.type !== "session") {
+                if (target && target.type !== 'session') {
                     comp.firstKeptEntryId = target.id;
                 }
                 delete comp.firstKeptEntryIndex;
@@ -70,18 +70,20 @@ function migrateV1ToV2(entries) {
 }
 function migrateV2ToV3(entries) {
     for (const entry of entries) {
-        if (entry.type === "session") {
+        if (entry.type === 'session') {
             entry.version = 3;
             continue;
         }
         const e = entry;
-        if (e.type === "message" && e.message && e.message.role === "hookMessage") {
-            e.message.role = "custom";
+        if (e.type === 'message' &&
+            e.message &&
+            e.message.role === 'hookMessage') {
+            e.message.role = 'custom';
         }
     }
 }
 function migrate(entries) {
-    const header = entries.find((e) => e.type === "session");
+    const header = entries.find((e) => e.type === 'session');
     const version = header?.version ?? 1;
     if (version >= CURRENT_SESSION_VERSION)
         return false;
@@ -95,7 +97,7 @@ function migrate(entries) {
 // SessionManager (read-only subset + createBranchedSession)
 // ---------------------------------------------------------------------------
 export class SessionManager {
-    sessionId = "";
+    sessionId = '';
     sessionFile;
     sessionDir;
     cwd;
@@ -136,7 +138,7 @@ export class SessionManager {
             this.flushed = true;
             return;
         }
-        const header = this.fileEntries.find((e) => e.type === "session");
+        const header = this.fileEntries.find((e) => e.type === 'session');
         if (header && header.version > CURRENT_SESSION_VERSION) {
             throw new Error(`Session file ${this.sessionFile} uses version ${header.version}, ` +
                 `but oc-session.ts only supports up to ${CURRENT_SESSION_VERSION}. ` +
@@ -152,13 +154,19 @@ export class SessionManager {
         this.sessionId = randomUUID();
         const timestamp = new Date().toISOString();
         this.fileEntries = [
-            { type: "session", version: CURRENT_SESSION_VERSION, id: this.sessionId, timestamp, cwd: this.cwd },
+            {
+                type: 'session',
+                version: CURRENT_SESSION_VERSION,
+                id: this.sessionId,
+                timestamp,
+                cwd: this.cwd,
+            },
         ];
         this.byId.clear();
         this.labelsById.clear();
         this.leafId = null;
         this.flushed = false;
-        const ts = timestamp.replace(/[:.]/g, "-");
+        const ts = timestamp.replace(/[:.]/g, '-');
         this.sessionFile = join(this.sessionDir, `${ts}_${this.sessionId}.jsonl`);
     }
     buildIndex() {
@@ -167,12 +175,12 @@ export class SessionManager {
         this.labelTimestampsById.clear();
         this.leafId = null;
         for (const entry of this.fileEntries) {
-            if (entry.type === "session")
+            if (entry.type === 'session')
                 continue;
             const e = entry;
             this.byId.set(e.id, e);
             this.leafId = e.id;
-            if (e.type === "label") {
+            if (e.type === 'label') {
                 if (e.label) {
                     this.labelsById.set(e.targetId, e.label);
                     this.labelTimestampsById.set(e.targetId, e.timestamp);
@@ -187,7 +195,7 @@ export class SessionManager {
     rewrite() {
         if (!this.sessionFile)
             return;
-        writeFileSync(this.sessionFile, this.fileEntries.map((e) => JSON.stringify(e)).join("\n") + "\n");
+        writeFileSync(this.sessionFile, this.fileEntries.map((e) => JSON.stringify(e)).join('\n') + '\n');
     }
     // -- Public accessors ------------------------------------------------------
     getLeafId() {
@@ -220,13 +228,13 @@ export class SessionManager {
         const branch = this.getBranch(leafId);
         if (branch.length === 0)
             throw new Error(`Entry ${leafId} not found`);
-        const pathWithoutLabels = branch.filter((e) => e.type !== "label");
+        const pathWithoutLabels = branch.filter((e) => e.type !== 'label');
         const newId = randomUUID();
         const timestamp = new Date().toISOString();
-        const ts = timestamp.replace(/[:.]/g, "-");
+        const ts = timestamp.replace(/[:.]/g, '-');
         const newFile = join(this.sessionDir, `${ts}_${newId}.jsonl`);
         const header = {
-            type: "session",
+            type: 'session',
             version: CURRENT_SESSION_VERSION,
             id: newId,
             timestamp,
@@ -245,7 +253,7 @@ export class SessionManager {
         const labelEntries = [];
         for (const { targetId, label, timestamp: labelTs } of labelsToWrite) {
             const le = {
-                type: "label",
+                type: 'label',
                 id: generateId(pathEntryIds),
                 parentId,
                 timestamp: labelTs ?? timestamp,
@@ -260,7 +268,7 @@ export class SessionManager {
         this.sessionId = newId;
         this.sessionFile = newFile;
         this.buildIndex();
-        const hasAssistant = this.fileEntries.some((e) => e.type === "message" && e.message?.role === "assistant");
+        const hasAssistant = this.fileEntries.some((e) => e.type === 'message' && e.message?.role === 'assistant');
         if (hasAssistant) {
             this.rewrite();
             this.flushed = true;
@@ -273,9 +281,9 @@ export class SessionManager {
     // -- Factory ---------------------------------------------------------------
     static open(path) {
         const entries = loadEntries(path);
-        const header = entries.find((e) => e.type === "session");
+        const header = entries.find((e) => e.type === 'session');
         const cwd = header?.cwd ?? process.cwd();
-        const dir = resolve(path, "..");
+        const dir = resolve(path, '..');
         return new SessionManager(cwd, dir, path);
     }
 }

package/dist/outbound.d.ts

@@ -1,6 +1,6 @@
-import type { ChannelPlugin } from "openclaw/plugin-sdk/core";
+import type { ChannelPlugin } from 'openclaw/plugin-sdk/core';
 /** Extract ChannelOutboundAdapter from ChannelPlugin (removed from public SDK exports in 2026.3.24). */
-type ChannelOutboundAdapter = NonNullable<ChannelPlugin["outbound"]>;
+type ChannelOutboundAdapter = NonNullable<ChannelPlugin['outbound']>;
 export declare const parallOutbound: ChannelOutboundAdapter;
 export {};
 //# sourceMappingURL=outbound.d.ts.map

package/dist/outbound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outbound.d.ts","sourceRoot":"","sources":["../src/outbound.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,wGAAwG;AACxG,KAAK,sBAAsB,GAAG,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;AAMrE,eAAO,MAAM,cAAc,EAAE,sBA2B5B,CAAC"}
+{"version":3,"file":"outbound.d.ts","sourceRoot":"","sources":["../src/outbound.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,wGAAwG;AACxG,KAAK,sBAAsB,GAAG,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;AAMrE,eAAO,MAAM,cAAc,EAAE,sBA4B5B,CAAC"}

package/dist/outbound.js

@@ -1,30 +1,29 @@
-import { resolveParallAccount } from "./accounts.js";
-import { getParallAccountState } from "./runtime.js";
-import { ParallClient } from "@parall/sdk";
+import { resolveParallAccount } from './accounts.js';
+import { getParallAccountState } from './runtime.js';
+import { ParallClient } from '@parall/sdk';
 export const parallOutbound = {
-    deliveryMode: "direct",
+    deliveryMode: 'direct',
     textChunkLimit: 10000,
     chunker: null,
     sendText: async ({ cfg, to, text, accountId }) => {
         const account = resolveParallAccount({ cfg, accountId: accountId ?? undefined });
         if (!account.enabled)
-            throw new Error("Parall account is disabled");
+            throw new Error('Parall account is disabled');
         if (!account.configured)
-            throw new Error("Parall account is not configured: parall_url/api_key/org_id required");
+            throw new Error('Parall account is not configured: parall_url/api_key/org_id required');
         const state = getParallAccountState(account.accountId);
-        const client = state?.client ?? new ParallClient({
-            baseUrl: account.config.parall_url,
-            token: account.config.api_key,
-        });
+        const client = state?.client ??
+            new ParallClient({
+                baseUrl: account.config.parall_url,
+                token: account.config.api_key,
+            });
         const orgId = state?.orgId ?? account.config.org_id;
         const chatId = to;
-        // Outbound path has no step context — send without agent_step_id.
-        // Step linkage happens via the CLI's ENV-injected PRLL_STEP_ID in the normal dispatch path.
         const req = {
-            message_type: "text",
+            message_type: 'text',
             content: { text },
         };
         const msg = await client.sendMessage(orgId, chatId, req);
-        return { channel: "parall", messageId: msg.id, channelId: chatId };
+        return { channel: 'parall', messageId: msg.id, channelId: chatId };
     },
 };

package/dist/routing.d.ts

@@ -1,3 +1,3 @@
-export { defaultRoutingStrategy, routeTrigger, } from "@parall/agent-core";
-export type { RoutingStrategy, TriggerDisposition, } from "@parall/agent-core";
+export { defaultRoutingStrategy, routeTrigger, } from '@parall/agent-core';
+export type { RoutingStrategy, TriggerDisposition, } from '@parall/agent-core';
 //# sourceMappingURL=routing.d.ts.map

package/dist/routing.js

@@ -1 +1 @@
-export { defaultRoutingStrategy, routeTrigger, } from "@parall/agent-core";
+export { defaultRoutingStrategy, routeTrigger, } from '@parall/agent-core';

package/dist/runtime.d.ts

@@ -1,8 +1,8 @@
-import type { PluginRuntime } from "openclaw/plugin-sdk";
-import type { ParallClient, ParallWs } from "@parall/sdk";
-import type { AgentIdentity } from "@parall/agent-core";
-export type { ForkResult, DispatchState, ParallEvent } from "@parall/agent-core";
-export { setSessionChatId, getSessionChatId, setSessionMessageId, getSessionMessageId, clearSessionMessageId, setDispatchMessageId, getDispatchMessageId, clearDispatchMessageId, setDispatchGroupKey, getDispatchGroupKey, clearDispatchGroupKey, setDispatchNoReply, getDispatchNoReply, clearDispatchNoReply, } from "@parall/agent-core";
+import type { PluginRuntime } from 'openclaw/plugin-sdk';
+import type { ParallClient, ParallWs } from '@parall/sdk';
+import type { AgentIdentity } from '@parall/agent-core';
+export type { ForkResult, DispatchState, ParallEvent } from '@parall/agent-core';
+export { setSessionChatId, getSessionChatId, setSessionMessageId, getSessionMessageId, clearSessionMessageId, setDispatchMessageId, getDispatchMessageId, clearDispatchMessageId, setDispatchGroupKey, getDispatchGroupKey, clearDispatchGroupKey, setDispatchNoReply, getDispatchNoReply, clearDispatchNoReply, } from '@parall/agent-core';
 export type ParallAccountState = {
     client: ParallClient;
     apiUrl: string;

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAIF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,QAEnD;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAKD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,QAEjF;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,QAEzD;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEvF;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,QAMnG;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEhG;AAED,wBAAgB,yBAAyB,IAAI,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAEnF;AAID,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,QAEvD;AAED,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAE5D"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAIF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,QAEnD;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAKD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,QAEjF;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,QAEzD;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEvF;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,QAOvB;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEhG;AAED,wBAAgB,yBAAyB,IAAI,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAEnF;AAID,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,QAEvD;AAED,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAE5D"}

package/dist/runtime.js

@@ -1,11 +1,11 @@
-export { setSessionChatId, getSessionChatId, setSessionMessageId, getSessionMessageId, clearSessionMessageId, setDispatchMessageId, getDispatchMessageId, clearDispatchMessageId, setDispatchGroupKey, getDispatchGroupKey, clearDispatchGroupKey, setDispatchNoReply, getDispatchNoReply, clearDispatchNoReply, } from "@parall/agent-core";
+export { setSessionChatId, getSessionChatId, setSessionMessageId, getSessionMessageId, clearSessionMessageId, setDispatchMessageId, getDispatchMessageId, clearDispatchMessageId, setDispatchGroupKey, getDispatchGroupKey, clearDispatchGroupKey, setDispatchNoReply, getDispatchNoReply, clearDispatchNoReply, } from '@parall/agent-core';
 let runtime = null;
 export function setParallRuntime(next) {
     runtime = next;
 }
 export function getParallRuntime() {
     if (!runtime) {
-        throw new Error("Parall runtime not initialized");
+        throw new Error('Parall runtime not initialized');
     }
     return runtime;
 }

package/dist/session.js

@@ -1,4 +1,4 @@
-const PRLL_SESSION_PREFIX = "agent:main:parall:";
+const PRLL_SESSION_PREFIX = 'agent:main:parall:';
 /** Build OpenClaw session key from Parall account, chat type, and chat ID. */
 export function buildSessionKey(accountId, chatType, chatId) {
     return `${PRLL_SESSION_PREFIX}${accountId}:${chatType}:${chatId}`;
@@ -11,7 +11,7 @@ export function extractAccountIdFromSessionKey(sessionKey) {
     if (!sessionKey?.startsWith(PRLL_SESSION_PREFIX))
         return undefined;
     const rest = sessionKey.slice(PRLL_SESSION_PREFIX.length);
-    const firstColon = rest.indexOf(":");
+    const firstColon = rest.indexOf(':');
     if (firstColon < 0)
         return undefined;
     return rest.slice(0, firstColon) || undefined;
@@ -25,10 +25,10 @@ export function extractChatIdFromSessionKey(sessionKey) {
         return undefined;
     const rest = sessionKey.slice(PRLL_SESSION_PREFIX.length);
     // Skip accountId and chatType segments
-    const parts = rest.split(":");
+    const parts = rest.split(':');
     if (parts.length < 3)
         return undefined;
-    return parts.slice(2).join(":") || undefined;
+    return parts.slice(2).join(':') || undefined;
 }
 /** Build the single orchestrator session key for all Parall events. */
 export function buildOrchestratorSessionKey(accountId) {

package/dist/wiki-helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wiki-helper.d.ts","sourceRoot":"","sources":["../src/wiki-helper.ts"],"names":[],"mappings":"AAGA,KAAK,MAAM,GAAG;IACZ,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAqGF,wBAAsB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgD/F"}
+{"version":3,"file":"wiki-helper.d.ts","sourceRoot":"","sources":["../src/wiki-helper.ts"],"names":[],"mappings":"AAGA,KAAK,MAAM,GAAG;IACZ,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AA8GF,wBAAsB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoD/F"}

package/dist/wiki-helper.js

@@ -1,24 +1,24 @@
-import { spawn, spawnSync } from "node:child_process";
-import path from "node:path";
+import { spawn, spawnSync } from 'node:child_process';
+import path from 'node:path';
 const DEFAULT_SYNC_TIMEOUT_MS = 90_000; // includes npx cold-start download time
 const DEFAULT_WATCH_INTERVAL_SEC = 30;
 function isCommandMissing(error) {
-    return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+    return typeof error === 'object' && error !== null && 'code' in error && error.code === 'ENOENT';
 }
 // Prefer bare `parall` (globally installed in hosted images). Fall back to
 // npx for self-hosted environments that haven't installed @parall/cli yet.
 let _cli;
 function resolveParallCli() {
     if (!_cli) {
-        const r = spawnSync("parall", ["--version"], { stdio: "ignore", timeout: 5_000 });
+        const r = spawnSync('parall', ['--version'], { stdio: 'ignore', timeout: 5_000 });
         _cli = r.error
-            ? { cmd: "npx", prefix: ["--yes", "@parall/cli@latest"] }
-            : { cmd: "parall", prefix: [] };
+            ? { cmd: 'npx', prefix: ['--yes', '@parall/cli@latest'] }
+            : { cmd: 'parall', prefix: [] };
     }
     return _cli;
 }
 function resolveMountRoot(stateDir) {
-    return process.env.PRLL_WIKI_MOUNT_ROOT?.trim() || path.join(stateDir, "workspace");
+    return process.env.PRLL_WIKI_MOUNT_ROOT?.trim() || path.join(stateDir, 'workspace');
 }
 function resolveWatchIntervalSec() {
     const raw = process.env.PRLL_WIKI_REFRESH_INTERVAL_SEC?.trim();
@@ -43,9 +43,9 @@ async function runWikiSync(params, env) {
         let timedOut = false;
         let settled = false;
         const { cmd, prefix } = resolveParallCli();
-        const child = spawn(cmd, [...prefix, "wiki", "sync"], {
+        const child = spawn(cmd, [...prefix, 'wiki', 'sync'], {
             env,
-            stdio: "ignore",
+            stdio: 'ignore',
         });
         const settle = (value) => {
             if (settled)
@@ -56,33 +56,33 @@ async function runWikiSync(params, env) {
         const timer = setTimeout(() => {
             timedOut = true;
             params.log?.warn?.(`parall[${params.accountId}]: parall sync timed out after ${DEFAULT_SYNC_TIMEOUT_MS}ms`);
-            child.kill("SIGTERM");
-            setTimeout(() => child.kill("SIGKILL"), 5_000).unref();
+            child.kill('SIGTERM');
+            setTimeout(() => child.kill('SIGKILL'), 5_000).unref();
         }, DEFAULT_SYNC_TIMEOUT_MS);
         timer.unref();
-        child.on("error", (error) => {
+        child.on('error', (error) => {
             clearTimeout(timer);
             if (isCommandMissing(error)) {
                 params.log?.warn?.(`parall[${params.accountId}]: parall not installed, skipping wiki auto-sync/watch`);
-                settle("missing");
+                settle('missing');
                 return;
             }
             params.log?.warn?.(`parall[${params.accountId}]: parall sync failed to start: ${String(error)}`);
-            settle("failed");
+            settle('failed');
         });
-        child.on("exit", (code, signal) => {
+        child.on('exit', (code, signal) => {
             clearTimeout(timer);
             if (timedOut) {
-                settle("failed");
+                settle('failed');
                 return;
             }
             if (code === 0) {
                 params.log?.info?.(`parall[${params.accountId}]: parall sync completed`);
-                settle("ok");
+                settle('ok');
                 return;
             }
-            params.log?.warn?.(`parall[${params.accountId}]: parall sync exited with code=${code ?? "null"} signal=${signal ?? "null"}`);
-            settle("failed");
+            params.log?.warn?.(`parall[${params.accountId}]: parall sync exited with code=${code ?? 'null'} signal=${signal ?? 'null'}`);
+            settle('failed');
         });
     });
 }
@@ -90,7 +90,7 @@ export async function startWikiHelper(params) {
     const mountRoot = resolveMountRoot(params.stateDir);
     const env = buildWikiHelperEnv(params, mountRoot);
     const syncResult = await runWikiSync(params, env);
-    if (syncResult === "missing") {
+    if (syncResult === 'missing') {
         return {
             mountRoot,
             stop() { },
@@ -99,11 +99,11 @@ export async function startWikiHelper(params) {
     const intervalSec = resolveWatchIntervalSec();
     let stopped = false;
     const { cmd, prefix } = resolveParallCli();
-    const watch = spawn(cmd, [...prefix, "wiki", "watch", "--interval-sec", String(intervalSec)], {
+    const watch = spawn(cmd, [...prefix, 'wiki', 'watch', '--interval-sec', String(intervalSec)], {
         env,
-        stdio: "ignore",
+        stdio: 'ignore',
     });
-    watch.on("error", (error) => {
+    watch.on('error', (error) => {
         if (stopped)
             return;
         if (isCommandMissing(error)) {
@@ -112,10 +112,10 @@ export async function startWikiHelper(params) {
         }
         params.log?.warn?.(`parall[${params.accountId}]: parall watch failed: ${String(error)}`);
     });
-    watch.on("exit", (code, signal) => {
+    watch.on('exit', (code, signal) => {
         if (stopped)
             return;
-        params.log?.warn?.(`parall[${params.accountId}]: parall watch exited with code=${code ?? "null"} signal=${signal ?? "null"}`);
+        params.log?.warn?.(`parall[${params.accountId}]: parall watch exited with code=${code ?? 'null'} signal=${signal ?? 'null'}`);
     });
     params.log?.info?.(`parall[${params.accountId}]: parall watch started (interval=${intervalSec}s)`);
     return {
@@ -123,8 +123,8 @@ export async function startWikiHelper(params) {
         stop() {
             stopped = true;
             if (watch.exitCode === null && watch.signalCode === null) {
-                watch.kill("SIGTERM");
-                setTimeout(() => watch.kill("SIGKILL"), 5_000).unref();
+                watch.kill('SIGTERM');
+                setTimeout(() => watch.kill('SIGKILL'), 5_000).unref();
             }
         },
     };

package/openclaw.plugin.json

@@ -12,7 +12,10 @@
           "parall_url": { "type": "string", "description": "Parall API base URL" },
           "api_key": { "type": "string", "description": "Agent API key (agk_xxx)" },
           "org_id": { "type": "string", "description": "Organisation ID" },
-          "ws_url": { "type": "string", "description": "WebSocket URL (optional, derived from parall_url)" }
+          "ws_url": {
+            "type": "string",
+            "description": "WebSocket URL (optional, derived from parall_url)"
+          }
         },
         "required": ["parall_url", "api_key", "org_id"]
       }

package/package.json

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

package/skills/parall-clips/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: parall-clips
+description: "Parall clip operations: list installed clips, invoke clip commands, inspect clip details. Use when: the task requires external capabilities (GitHub, web search, etc.), user asks about available tools/clips, or you need to call a clip command."
+---
+
+# Parall Clips
+
+Clips are capability extensions — packaged toolkits that give you extra commands (e.g. GitHub operations, web search, code analysis). Clips installed in the org are available for any agent to invoke via the CLI.
+
+## Discovering available clips
+
+```bash
+# List all clips installed in the org
+parall clip list
+
+# Show detailed info about a clip (manifest, commands, version)
+parall clip info <alias>
+```
+
+## Invoking a clip command
+
+```bash
+# Invoke a command on a clip by alias
+parall clip invoke <alias> <command> [input]
+
+# input is optional — when provided, it can be a JSON string or plain text
+parall clip invoke github-tools list-repos '{"org": "acme"}'
+parall clip invoke web-search search "latest Node.js LTS version"
+
+# Custom timeout (default 30s)
+parall clip invoke github-tools create-issue '{"title": "Bug report"}' --timeout 60000
+```
+
+## How clips work
+
+1. An org admin installs a clip from the Pinix registry or creates a custom one
+2. `parall clip list` shows every clip installed in the org
+3. You can only **invoke** clips that an admin has **bound to you** — invoking an unbound clip returns a "not bound" error. Ask an admin to bind the clip if you need it.
+4. Each clip exposes one or more named commands with typed input/output
+
+## When to use clips
+
+- Check `parall clip list` when a task requires capabilities beyond your built-in tools (e.g. GitHub API, external services, specialized analysis)
+- Use `parall clip info <alias>` to discover available commands and their expected input format
+- If `parall clip invoke` reports the clip isn't bound to you, that clip exists in the org but hasn't been granted to you — ask an admin to bind it
+- Clip invocations return JSON output on success or an error message on failure
+
+CLI command results are JSON on stdout.

package/src/accounts.ts

@@ -1,6 +1,6 @@
-import type { ResolvedParallAccount, ParallChannelConfig } from "./types.js";
+import type { ResolvedParallAccount, ParallChannelConfig } from './types.js';
 
-const DEFAULT_ACCOUNT_ID = "default";
+const DEFAULT_ACCOUNT_ID = 'default';
 
 type OpenClawConfig = Record<string, unknown>;
 
@@ -22,9 +22,9 @@ export function resolveParallAccount(params: {
   const { cfg, accountId = DEFAULT_ACCOUNT_ID } = params;
   const parallCfg = readParallConfig(cfg);
   const config: ParallChannelConfig = {
-    parall_url: parallCfg?.parall_url ?? "",
-    api_key: parallCfg?.api_key ?? "",
-    org_id: parallCfg?.org_id ?? "",
+    parall_url: parallCfg?.parall_url ?? '',
+    api_key: parallCfg?.api_key ?? '',
+    org_id: parallCfg?.org_id ?? '',
     ws_url: parallCfg?.ws_url,
     enabled: parallCfg?.enabled,
   };

package/src/channel.ts

@@ -1,23 +1,23 @@
-import type { ChannelPlugin } from "openclaw/plugin-sdk/core";
-import { listParallAccountIds, resolveParallAccount } from "./accounts.js";
-import { parallGateway } from "./gateway.js";
-import { parallOutbound } from "./outbound.js";
-import type { ResolvedParallAccount } from "./types.js";
+import type { ChannelPlugin } from 'openclaw/plugin-sdk/core';
+import { listParallAccountIds, resolveParallAccount } from './accounts.js';
+import { parallGateway } from './gateway.js';
+import { parallOutbound } from './outbound.js';
+import type { ResolvedParallAccount } from './types.js';
 
-const meta: ChannelPlugin["meta"] = {
-  id: "parall",
-  label: "Parall",
-  selectionLabel: "Parall IM",
-  docsPath: "/channels/parall",
-  blurb: "Agent-Native IM platform.",
+const meta: ChannelPlugin['meta'] = {
+  id: 'parall',
+  label: 'Parall',
+  selectionLabel: 'Parall IM',
+  docsPath: '/channels/parall',
+  blurb: 'Agent-Native IM platform.',
   order: 80,
 };
 
 export const parallPlugin: ChannelPlugin<ResolvedParallAccount> = {
-  id: "parall",
+  id: 'parall',
   meta,
   capabilities: {
-    chatTypes: ["direct", "group"],
+    chatTypes: ['direct', 'group'],
     polls: false,
     threads: false,
     media: true,
@@ -27,7 +27,8 @@ export const parallPlugin: ChannelPlugin<ResolvedParallAccount> = {
   },
   config: {
     listAccountIds: (cfg) => listParallAccountIds(cfg),
-    resolveAccount: (cfg, accountId) => resolveParallAccount({ cfg, accountId: accountId ?? undefined }),
+    resolveAccount: (cfg, accountId) =>
+      resolveParallAccount({ cfg, accountId: accountId ?? undefined }),
     isConfigured: (account) => account.configured,
     describeAccount: (account) => ({
       accountId: account.accountId,