@parall/parall 1.56.1 → 1.57.1

package/dist/index.bundle.mjs

@@ -44537,7 +44537,7 @@ var require_headers = __commonJS({
         }
       }
     };
-    var Headers = class _Headers {
+    var Headers2 = class _Headers {
       #guard;
       /**
        * @type {HeadersList}
@@ -44678,13 +44678,13 @@ var require_headers = __commonJS({
         target.#headersList = list;
       }
     };
-    var { getHeadersGuard, setHeadersGuard, getHeadersList, setHeadersList } = Headers;
-    Reflect.deleteProperty(Headers, "getHeadersGuard");
-    Reflect.deleteProperty(Headers, "setHeadersGuard");
-    Reflect.deleteProperty(Headers, "getHeadersList");
-    Reflect.deleteProperty(Headers, "setHeadersList");
-    iteratorMixin("Headers", Headers, headersListSortAndCombine, 0, 1);
-    Object.defineProperties(Headers.prototype, {
+    var { getHeadersGuard, setHeadersGuard, getHeadersList, setHeadersList } = Headers2;
+    Reflect.deleteProperty(Headers2, "getHeadersGuard");
+    Reflect.deleteProperty(Headers2, "setHeadersGuard");
+    Reflect.deleteProperty(Headers2, "getHeadersList");
+    Reflect.deleteProperty(Headers2, "setHeadersList");
+    iteratorMixin("Headers", Headers2, headersListSortAndCombine, 0, 1);
+    Object.defineProperties(Headers2.prototype, {
       append: kEnumerableProperty,
       delete: kEnumerableProperty,
       get: kEnumerableProperty,
@@ -44702,7 +44702,7 @@ var require_headers = __commonJS({
     webidl.converters.HeadersInit = function(V, prefix, argument) {
       if (webidl.util.Type(V) === webidl.util.Types.OBJECT) {
         const iterator = Reflect.get(V, Symbol.iterator);
-        if (!util.types.isProxy(V) && iterator === Headers.prototype.entries) {
+        if (!util.types.isProxy(V) && iterator === Headers2.prototype.entries) {
           try {
             return getHeadersList(V).entriesList;
           } catch {
@@ -44723,7 +44723,7 @@ var require_headers = __commonJS({
       fill,
       // for test.
       compareHeaderName,
-      Headers,
+      Headers: Headers2,
       HeadersList,
       getHeadersGuard,
       setHeadersGuard,
@@ -44737,7 +44737,7 @@ var require_headers = __commonJS({
 var require_response = __commonJS({
   "../node_modules/.pnpm/undici@7.24.8/node_modules/undici/lib/web/fetch/response.js"(exports2, module2) {
     "use strict";
-    var { Headers, HeadersList, fill, getHeadersGuard, setHeadersGuard, setHeadersList } = require_headers();
+    var { Headers: Headers2, HeadersList, fill, getHeadersGuard, setHeadersGuard, setHeadersList } = require_headers();
     var { extractBody, cloneBody, mixinBody, streamRegistry, bodyUnusable } = require_body();
     var util = require_util2();
     var nodeUtil = __require("node:util");
@@ -44759,7 +44759,7 @@ var require_response = __commonJS({
     var assert = __require("node:assert");
     var { isomorphicEncode, serializeJavascriptValueToJSONString } = require_infra();
     var textEncoder = new TextEncoder("utf-8");
-    var Response = class _Response {
+    var Response2 = class _Response {
       /** @type {Headers} */
       #headers;
       #state;
@@ -44813,7 +44813,7 @@ var require_response = __commonJS({
         }
         init = webidl.converters.ResponseInit(init);
         this.#state = makeResponse({});
-        this.#headers = new Headers(kConstruct);
+        this.#headers = new Headers2(kConstruct);
         setHeadersGuard(this.#headers, "response");
         setHeadersList(this.#headers, this.#state.headersList);
         let bodyWithType = null;
@@ -44931,13 +44931,13 @@ var require_response = __commonJS({
         response.#state = newState;
       }
     };
-    var { getResponseHeaders, setResponseHeaders, getResponseState, setResponseState } = Response;
-    Reflect.deleteProperty(Response, "getResponseHeaders");
-    Reflect.deleteProperty(Response, "setResponseHeaders");
-    Reflect.deleteProperty(Response, "getResponseState");
-    Reflect.deleteProperty(Response, "setResponseState");
-    mixinBody(Response, getResponseState);
-    Object.defineProperties(Response.prototype, {
+    var { getResponseHeaders, setResponseHeaders, getResponseState, setResponseState } = Response2;
+    Reflect.deleteProperty(Response2, "getResponseHeaders");
+    Reflect.deleteProperty(Response2, "setResponseHeaders");
+    Reflect.deleteProperty(Response2, "getResponseState");
+    Reflect.deleteProperty(Response2, "setResponseState");
+    mixinBody(Response2, getResponseState);
+    Object.defineProperties(Response2.prototype, {
       type: kEnumerableProperty,
       url: kEnumerableProperty,
       status: kEnumerableProperty,
@@ -44953,7 +44953,7 @@ var require_response = __commonJS({
         configurable: true
       }
     });
-    Object.defineProperties(Response, {
+    Object.defineProperties(Response2, {
       json: kEnumerableProperty,
       redirect: kEnumerableProperty,
       error: kEnumerableProperty
@@ -45086,9 +45086,9 @@ var require_response = __commonJS({
       }
     }
     function fromInnerResponse(innerResponse, guard) {
-      const response = new Response(kConstruct);
+      const response = new Response2(kConstruct);
       setResponseState(response, innerResponse);
-      const headers = new Headers(kConstruct);
+      const headers = new Headers2(kConstruct);
       setResponseHeaders(response, headers);
       setHeadersList(headers, innerResponse.headersList);
       setHeadersGuard(headers, guard);
@@ -45140,14 +45140,14 @@ var require_response = __commonJS({
         converter: webidl.converters.HeadersInit
       }
     ]);
-    webidl.is.Response = webidl.util.MakeTypeAssertion(Response);
+    webidl.is.Response = webidl.util.MakeTypeAssertion(Response2);
     module2.exports = {
       isNetworkError,
       makeNetworkError,
       makeResponse,
       makeAppropriateNetworkError,
       filterResponse,
-      Response,
+      Response: Response2,
       cloneResponse,
       fromInnerResponse,
       getResponseState
@@ -45160,7 +45160,7 @@ var require_request2 = __commonJS({
   "../node_modules/.pnpm/undici@7.24.8/node_modules/undici/lib/web/fetch/request.js"(exports2, module2) {
     "use strict";
     var { extractBody, mixinBody, cloneBody, bodyUnusable } = require_body();
-    var { Headers, fill: fillHeaders, HeadersList, setHeadersGuard, getHeadersGuard, setHeadersList, getHeadersList } = require_headers();
+    var { Headers: Headers2, fill: fillHeaders, HeadersList, setHeadersGuard, getHeadersGuard, setHeadersList, getHeadersList } = require_headers();
     var util = require_util2();
     var nodeUtil = __require("node:util");
     var {
@@ -45429,7 +45429,7 @@ var require_request2 = __commonJS({
             requestFinalizer.register(ac, { signal, abort }, abort);
           }
         }
-        this.#headers = new Headers(kConstruct);
+        this.#headers = new Headers2(kConstruct);
         setHeadersList(this.#headers, request3.headersList);
         setHeadersGuard(this.#headers, "request");
         if (mode === "no-cors") {
@@ -45770,7 +45770,7 @@ var require_request2 = __commonJS({
       setRequestState(request3, innerRequest);
       setRequestDispatcher(request3, dispatcher);
       setRequestSignal(request3, signal);
-      const headers = new Headers(kConstruct);
+      const headers = new Headers2(kConstruct);
       setRequestHeaders(request3, headers);
       setHeadersList(headers, innerRequest.headersList);
       setHeadersGuard(headers, guard);
@@ -48214,8 +48214,8 @@ var require_cookies = __commonJS({
     var { parseSetCookie } = require_parse2();
     var { stringify } = require_util5();
     var { webidl } = require_webidl();
-    var { Headers } = require_headers();
-    var brandChecks = webidl.brandCheckMultiple([Headers, globalThis.Headers].filter(Boolean));
+    var { Headers: Headers2 } = require_headers();
+    var brandChecks = webidl.brandCheckMultiple([Headers2, globalThis.Headers].filter(Boolean));
     function getCookies(headers) {
       webidl.argumentLengthCheck(arguments, 1, "getCookies");
       brandChecks(headers);
@@ -48956,7 +48956,7 @@ var require_connection = __commonJS({
     var { parseExtensions, isClosed, isClosing, isEstablished, isConnecting, validateCloseCodeAndReason } = require_util6();
     var { makeRequest } = require_request2();
     var { fetching } = require_fetch();
-    var { Headers, getHeadersList } = require_headers();
+    var { Headers: Headers2, getHeadersList } = require_headers();
     var { getDecodeSplit } = require_util3();
     var { WebsocketFrameSend } = require_frame();
     var assert = __require("node:assert");
@@ -48978,7 +48978,7 @@ var require_connection = __commonJS({
         useURLCredentials: true
       });
       if (options.headers) {
-        const headersList = getHeadersList(new Headers(options.headers));
+        const headersList = getHeadersList(new Headers2(options.headers));
         request3.headersList = headersList;
       }
       const keyValue = crypto3.randomBytes(16).toString("base64");
@@ -51581,7 +51581,10 @@ function buildEventBody(event) {
   } else if (event.type === "channel_message") {
     lines.push(`[Event: channel.message]`);
     const providerLabel = sanitizeMeta(event.channelProvider ?? "external IM");
-    const convLabel = event.channelExternalConversationId ? `${sanitizeMeta(event.channelExternalConversationId)} (${sanitizeMeta(event.channelConversationType ?? "conversation")})` : sanitizeMeta(event.channelConversationType ?? "conversation");
+    const convType = sanitizeMeta(event.channelConversationType ?? "conversation");
+    const convId = event.channelExternalConversationId ? sanitizeMeta(event.channelExternalConversationId) : void 0;
+    const convName = event.channelExternalConversationName ? sanitizeMeta(event.channelExternalConversationName) : void 0;
+    const convLabel = convName ? `${convName} (${convId ? `${convId}, ` : ""}${convType})` : convId ? `${convId} (${convType})` : convType;
     lines.push(`[Channel: ${providerLabel} | conversation: ${convLabel}]`);
     lines.push(`[From: ${sanitizeMeta(event.senderName)} (external user, not a Parall member)]`);
     if (event.channelExternalMessageId) {
@@ -51754,6 +51757,8 @@ var ENDPOINTS = {
   // Users
   USERS_ME: `${API_BASE}/users/me`,
   USER_AVATAR: `${API_BASE}/users/me/avatar`,
+  PERSONAL_API_KEYS: `${API_BASE}/users/me/api-keys`,
+  PERSONAL_API_KEY: (keyId) => `${API_BASE}/users/me/api-keys/${keyId}`,
   USER: (id) => `${API_BASE}/users/${id}`,
   // WebSocket ticket
   WS_TICKET: `${API_BASE}/ws/ticket`,
@@ -51768,6 +51773,24 @@ var ENDPOINTS = {
   TEAM_MEMBERS: (orgId, teamId) => `${API_BASE}/orgs/${orgId}/teams/${teamId}/members`,
   TEAM_MEMBER: (orgId, teamId, userId) => `${API_BASE}/orgs/${orgId}/teams/${teamId}/members/${userId}`,
   ORG_MEMBERS_ONLINE: (orgId) => `${API_BASE}/orgs/${orgId}/members/online`,
+  LLM_PROVIDERS: (orgId) => `${API_BASE}/orgs/${orgId}/llm-providers`,
+  LLM_PROVIDER: (orgId, providerId) => `${API_BASE}/orgs/${orgId}/llm-providers/${providerId}`,
+  ORG_LLM_MODELS: (orgId) => `${API_BASE}/orgs/${orgId}/llm-models`,
+  ORG_LLM_MODEL: (orgId, modelRowId) => `${API_BASE}/orgs/${orgId}/llm-models/${modelRowId}`,
+  /**
+   * Platform catalog merged with this org's own model rows. Pass `runtime` to
+   * filter org-added models to the ones that runtime can actually reach —
+   * without it a picker can offer a model the write path rejects.
+   */
+  ORG_MODEL_CATALOG: (orgId, runtime2, includeModel) => {
+    const params = new URLSearchParams();
+    if (runtime2)
+      params.set("runtime", runtime2);
+    if (includeModel)
+      params.set("include_model", includeModel);
+    const qs = params.toString();
+    return `${API_BASE}/orgs/${orgId}/models${qs ? `?${qs}` : ""}`;
+  },
   ORG_MEMBER: (orgId, userId) => `${API_BASE}/orgs/${orgId}/members/${userId}`,
   ORG_MEMBER_CHATS: (orgId, memberId) => `${API_BASE}/orgs/${orgId}/members/${memberId}/chats`,
   ORG_MEMBER_TASKS: (orgId, memberId) => `${API_BASE}/orgs/${orgId}/members/${memberId}/tasks`,
@@ -52521,6 +52544,55 @@ var WechatClient = class extends TaskLabelClient {
   }
 };
 
+// ../sdk/dist/llm-provider-client.js
+var LLMProviderClient = class extends WechatClient {
+  async getLLMProviders(orgId) {
+    const response = await this.request("GET", ENDPOINTS.LLM_PROVIDERS(orgId));
+    return response.data;
+  }
+  async createLLMProvider(orgId, data) {
+    return this.request("POST", ENDPOINTS.LLM_PROVIDERS(orgId), data);
+  }
+  /** Omitting `api_key` leaves the stored credential untouched. */
+  async updateLLMProvider(orgId, providerId, data) {
+    return this.request("PATCH", ENDPOINTS.LLM_PROVIDER(orgId, providerId), data);
+  }
+  /** Fails with PROVIDER_IN_USE while model rows still point at it. */
+  async deleteLLMProvider(orgId, providerId) {
+    return this.request("DELETE", ENDPOINTS.LLM_PROVIDER(orgId, providerId));
+  }
+  async getOrgLLMModels(orgId) {
+    const response = await this.request("GET", ENDPOINTS.ORG_LLM_MODELS(orgId));
+    return response.data;
+  }
+  async createOrgLLMModel(orgId, data) {
+    return this.request("POST", ENDPOINTS.ORG_LLM_MODELS(orgId), data);
+  }
+  /**
+   * Patches a model row in place. Repointing a provider or fixing an upstream
+   * name this way avoids the delete-and-recreate window, during which an
+   * org-only model has no upstream at all and its pinned agents fail.
+   */
+  async updateOrgLLMModel(orgId, modelRowId, data) {
+    return this.request("PATCH", ENDPOINTS.ORG_LLM_MODEL(orgId, modelRowId), data);
+  }
+  async deleteOrgLLMModel(orgId, modelRowId) {
+    return this.request("DELETE", ENDPOINTS.ORG_LLM_MODEL(orgId, modelRowId));
+  }
+  /**
+   * The catalog as this org sees it: platform models with the org's rows
+   * merged in. Distinct from the public model catalog, which stays org-agnostic
+   * and cacheable — use this one wherever an org context exists.
+   *
+   * Pass `runtime` on a picker: org-added models are then filtered to what that
+   * runtime's protocol can reach, matching the server-side pin validation.
+   */
+  async getOrgModelCatalog(orgId, runtime2, includeModel) {
+    const response = await this.request("GET", ENDPOINTS.ORG_MODEL_CATALOG(orgId, runtime2, includeModel));
+    return response.data;
+  }
+};
+
 // ../sdk/dist/attachment-client.js
 var COMPLETION_RETRY_DELAYS_MS = [250, 750];
 function isRetryableCompletionError(error) {
@@ -52529,7 +52601,7 @@ function isRetryableCompletionError(error) {
   const status = error.status;
   return status === 0 || typeof status === "number" && status >= 500;
 }
-var AttachmentClient = class extends WechatClient {
+var AttachmentClient = class extends LLMProviderClient {
   async getUploadPresignUrl(orgId, req) {
     return this.request("POST", ENDPOINTS.UPLOAD_PRESIGN(orgId), req);
   }
@@ -52557,6 +52629,99 @@ var AttachmentClient = class extends WechatClient {
   }
 };
 
+// ../sdk/dist/wiki-upload.js
+function createWikiUploadFormData(params) {
+  const form = new FormData();
+  form.append("path", params.path);
+  form.append("file", params.file);
+  if (params.message)
+    form.append("message", params.message);
+  if (params.uploadId)
+    form.append("upload_id", params.uploadId);
+  if (params.conflict)
+    form.append("conflict", params.conflict);
+  if ("contentRoute" in params && params.contentRoute) {
+    form.append("content_route", params.contentRoute);
+  }
+  return form;
+}
+function sendMultipartRequest(options) {
+  if (options.onProgress && typeof XMLHttpRequest !== "undefined") {
+    return multipartXHR(options, options.onProgress);
+  }
+  const timeoutSignal = AbortSignal.timeout(options.timeoutMs);
+  const signal = options.signal ? AbortSignal.any([options.signal, timeoutSignal]) : timeoutSignal;
+  return fetch(options.url, {
+    method: options.method,
+    headers: options.headers,
+    body: options.body,
+    signal
+  });
+}
+function multipartXHR(options, onProgress) {
+  return new Promise((resolve3, reject) => {
+    const xhr = new XMLHttpRequest();
+    let settled = false;
+    const finish = (fn) => {
+      if (settled)
+        return;
+      settled = true;
+      options.signal?.removeEventListener("abort", abortFromSignal);
+      fn();
+    };
+    const abortFromSignal = () => xhr.abort();
+    xhr.open(options.method, options.url, true);
+    xhr.timeout = options.timeoutMs;
+    for (const [name, value] of Object.entries(options.headers)) {
+      xhr.setRequestHeader(name, value);
+    }
+    xhr.upload.onprogress = (event) => {
+      try {
+        onProgress(event.loaded, event.lengthComputable ? event.total : 0);
+      } catch {
+      }
+    };
+    xhr.onload = () => finish(() => {
+      const responseHeaders = new Headers();
+      for (const line of xhr.getAllResponseHeaders().trim().split(/[\r\n]+/)) {
+        if (!line)
+          continue;
+        const separator = line.indexOf(":");
+        if (separator > 0) {
+          responseHeaders.append(line.slice(0, separator).trim(), line.slice(separator + 1).trim());
+        }
+      }
+      const responseBody = xhr.status === 204 || xhr.responseText === "" ? null : xhr.responseText;
+      resolve3(new Response(responseBody, {
+        status: xhr.status,
+        statusText: xhr.statusText,
+        headers: responseHeaders
+      }));
+    });
+    xhr.onerror = () => finish(() => reject(new TypeError("Network request failed")));
+    xhr.ontimeout = () => finish(() => reject(new DOMException("Request timed out", "TimeoutError")));
+    xhr.onabort = () => finish(() => reject(new DOMException("Request aborted", "AbortError")));
+    if (options.signal?.aborted) {
+      finish(() => reject(new DOMException("Request aborted", "AbortError")));
+      return;
+    }
+    options.signal?.addEventListener("abort", abortFromSignal, { once: true });
+    xhr.send(options.body);
+  });
+}
+
+// ../sdk/dist/wiki-changeset.js
+function normalizeWikiChangeset(changeset) {
+  return {
+    ...changeset,
+    head_branch: changeset.head_branch ?? null,
+    base_commit: changeset.base_commit ?? null,
+    merge_commit: changeset.merge_commit ?? null,
+    changed_paths: changeset.changed_paths ?? [],
+    file_changes: changeset.file_changes ?? []
+  };
+}
+
 // ../sdk/dist/client.js
 var ParallClient = class _ParallClient extends AttachmentClient {
   baseUrl;
@@ -52762,23 +52927,27 @@ var ParallClient = class _ParallClient extends AttachmentClient {
    * Multipart upload variant of `request`. Same auth / refresh / error
    * handling, but lets the caller hand us a prepared `FormData` (file +
    * text fields) and skips the JSON content-type. Used by
-   * uploadWikiFile / uploadWikiFileToChangeset — wiki binary uploads can
+   * uploadWikiFile / uploadWikiFileToChangeset — wiki file uploads can
    * hit the 100 MiB cap, so a longer 5-minute timeout is used so a
    * 50 MiB blob on a slow connection doesn't get chopped at 15 s.
    */
-  async multipartRequest(method, path9, body, retried = false) {
+  async multipartRequest(method, path9, body, retried = false, opts) {
     if (!retried) {
       await this.ensureFreshToken(path9);
     }
     const { "Content-Type": _drop, ...headers } = this.buildHeaders(path9);
     void _drop;
+    const timeoutMs = opts?.timeoutMs ?? 5 * 60 * 1e3;
     let res;
     try {
-      res = await fetch(`${this.baseUrlFor(path9)}${path9}`, {
+      res = await sendMultipartRequest({
         method,
+        url: `${this.baseUrlFor(path9)}${path9}`,
         headers,
         body,
-        signal: AbortSignal.timeout(5 * 60 * 1e3)
+        timeoutMs,
+        signal: opts?.signal,
+        onProgress: opts?.onProgress
       });
     } catch (err) {
       throw _ParallClient.normalizeFetchError(err);
@@ -52789,7 +52958,7 @@ var ParallClient = class _ParallClient extends AttachmentClient {
       if (!retried && !isAuthPath && this.getRefreshToken) {
         const refreshed = await this.tryRefresh();
         if (refreshed) {
-          return this.multipartRequest(method, path9, body, true);
+          return this.multipartRequest(method, path9, body, true, opts);
         }
       }
       if (this.onTokenExpired && !isAuthPath) {
@@ -52868,6 +53037,18 @@ var ParallClient = class _ParallClient extends AttachmentClient {
   async deleteAvatar() {
     return this.request("DELETE", ENDPOINTS.USER_AVATAR);
   }
+  // ---- Personal API keys (org-scoped; JWT session required) ----
+  /** Mints an org-scoped personal API key. The plaintext is returned once and never again. */
+  async createPersonalApiKey(req) {
+    return this.request("POST", ENDPOINTS.PERSONAL_API_KEYS, req);
+  }
+  async listPersonalApiKeys() {
+    const res = await this.request("GET", ENDPOINTS.PERSONAL_API_KEYS);
+    return res.data;
+  }
+  async revokePersonalApiKey(keyId) {
+    return this.request("DELETE", ENDPOINTS.PERSONAL_API_KEY(keyId));
+  }
   async uploadAgentAvatar(orgId, agentId, file) {
     const fd = new FormData();
     fd.append("file", file);
@@ -54086,26 +54267,21 @@ var ParallClient = class _ParallClient extends AttachmentClient {
    * through createWikiChangeset / updateWikiChangeset.
    */
   async uploadWikiFile(orgId, wikiId, params) {
-    const fd = new FormData();
-    fd.append("path", params.path);
-    fd.append("file", params.file);
-    if (params.message)
-      fd.append("message", params.message);
-    return this.multipartRequest("POST", ENDPOINTS.WIKI_UPLOADS(orgId, wikiId), fd);
+    const fd = createWikiUploadFormData(params);
+    return this.multipartRequest("POST", ENDPOINTS.WIKI_UPLOADS(orgId, wikiId), fd, false, {
+      signal: params.signal,
+      onProgress: params.onProgress
+    });
   }
   /**
-   * Upload a binary file into a changeset's feature branch (read scope +
-   * author-only). Used by reader flow: propose a changeset, attach
-   * binary, PATCH markdown that references it. On merge the binary
-   * squashes into the default branch.
+   * Upload a file into a changeset's feature branch (read scope +
+   * author-only). The default remains binary-only; contentRoute `auto`
+   * opts into reviewable text for the Web library upload flow. On merge the
+   * branch contents squash into the default branch.
    */
   async uploadWikiFileToChangeset(orgId, wikiId, changesetId, params) {
-    const fd = new FormData();
-    fd.append("path", params.path);
-    fd.append("file", params.file);
-    if (params.message)
-      fd.append("message", params.message);
-    return this.multipartRequest("POST", ENDPOINTS.WIKI_CHANGESET_FILES(orgId, wikiId, changesetId), fd);
+    const fd = createWikiUploadFormData(params);
+    return this.multipartRequest("POST", ENDPOINTS.WIKI_CHANGESET_FILES(orgId, wikiId, changesetId), fd, false, { signal: params.signal, onProgress: params.onProgress });
   }
   /** Remove a binary file from the default branch. Text files must use a
    * changeset delete action. The blob stays reachable via git history. */
@@ -54972,13 +55148,6 @@ var ParallClient = class _ParallClient extends AttachmentClient {
     );
   }
 };
-function normalizeWikiChangeset(changeset) {
-  return {
-    ...changeset,
-    changed_paths: changeset.changed_paths ?? [],
-    file_changes: changeset.file_changes ?? []
-  };
-}
 var ApiError = class extends Error {
   status;
   code;
@@ -59470,7 +59639,7 @@ var ParallAgentGateway = class {
     const event = {
       type: "channel_message",
       targetId: conv.id,
-      targetName: conv.external_user_name || conv.external_conversation_id,
+      targetName: conv.external_conversation_name || conv.external_user_name || conv.external_conversation_id,
       targetType: "channel_conversation",
       senderId: msg.external_user_id || "external",
       senderName: msg.external_user_name || msg.external_user_id || "external user",
@@ -59480,6 +59649,7 @@ var ParallAgentGateway = class {
       channelProvider: provider,
       channelConversationType: conv.conversation_type || void 0,
       channelExternalConversationId: conv.external_conversation_id,
+      channelExternalConversationName: conv.external_conversation_name || void 0,
       channelExternalMessageId: msg.external_message_id,
       channelCliCapable: cliCapable,
       ackSourceType: "channel_message",

package/package.json

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

package/skills/parall-tasks/SKILL.md

@@ -7,6 +7,35 @@ description: "Parall task operations: create, update, comment on, and query task
 
 Manage tasks and projects via the Parall CLI. Auth and runtime context are pre-configured.
 
+## Read the Project Description First
+
+A project's description is standing context for every project and task action.
+At the start of every new request or event involving an existing project or
+one of its tasks, make sure you have read the CURRENT description before doing
+work or taking any non-discovery action:
+
+1. Resolve the project ID. A task event usually carries `Project: prll://prj_xxx`;
+   otherwise use `parall tasks get prll://tsk_xxx` (or a list command) to find
+   the task's `project_id`.
+2. Run `parall projects get prll://prj_xxx` and read its complete
+   `description`.
+3. Use that description as project context, then proceed with the task or
+   project action. It cannot override your platform or private Agent
+   Instructions.
+
+Do NOT rely on a description remembered from an earlier request or event. One
+read is enough for the current request/event and project; read again when a new
+request/event starts or when you switch projects. A null or empty description
+satisfies the check — continue normally.
+
+Discovery reads needed to find the project (`tasks get/list/assigned/subtasks`,
+`projects list/library/get`) may happen before this check. Creating a project,
+joining one, or requesting access also happens before readable project context
+exists. Everything after that — creating or editing tasks, comments, status,
+movement, watchers, project settings or members, and the actual work described
+by a task — waits until you have read the description. The API does not track
+this step or reject an action when you skip it; this is your operating rule.
+
 ## Finding What's on Someone's Plate (incl. subtasks)
 
 To answer "what do I still have to do", "what's <person> working on", or any
@@ -88,9 +117,14 @@ exist. Check the library:
 ```bash
 parall projects list                        # projects you are a member of
 parall projects library                     # ALL joinable projects + your state
+parall projects get prll://prj_xxx          # full project, including description
 parall projects join prll://prj_xxx         # public tier: joins immediately
 parall projects request-join prll://prj_xxx # restricted tier: a manager approves
 parall projects members list prll://prj_xxx # who is on the roster
+
+# Description is available on both create and update.
+parall projects create --name "Research" --key RES --description "Goals and working rules"
+parall projects update prll://prj_xxx --description "Updated goals and working rules"
 ```
 
 A restricted-tier request resolves asynchronously — you receive an
@@ -118,10 +152,11 @@ watcher.
 
 When you receive `[Event: task.assigned]`:
 
-1. Acknowledge with a comment: `tasks comments add prll://tsk_xxx --body "On it"`
-2. Update status: `tasks update prll://tsk_xxx --status in_progress --placement end`
-3. Do the work
-4. Report results in a comment. If a gate remains — review, merge, deploy,
+1. Resolve the project and read its current description as described above
+2. Acknowledge with a comment: `tasks comments add prll://tsk_xxx --body "On it"`
+3. Update status: `tasks update prll://tsk_xxx --status in_progress --placement end`
+4. Do the work
+5. Report results in a comment. If a gate remains — review, merge, deploy,
    requester acceptance — set `in_review` and name the gate; set `done`
    only once the work has actually landed
 
@@ -129,8 +164,9 @@ When you receive `[Event: task.assigned]`:
 
 When you receive `[Event: task.comment.created]`, someone commented on a task you are watching. Read the comment body and respond if action is needed:
 
-1. Review the comment content and task context
-2. Reply via comment: `tasks comments add prll://tsk_xxx --body "Response..."`
-3. If the comment requests status changes, update accordingly
+1. Resolve the project and read its current description as described above
+2. Review the comment content and task context
+3. Reply via comment: `tasks comments add prll://tsk_xxx --body "Response..."`
+4. If the comment requests status changes, update accordingly
 
 CLI success output is JSON; errors print a JSON line plus, on a `PERMISSION_DENIED`, an optional plain-text `Request approval:` line — read both.