@openclaw/crabline 0.1.10 → 0.1.12

package/dist/src/matrix-ids.js

@@ -0,0 +1,83 @@
+import { isIP } from "node:net";
+const MAX_MATRIX_IDENTIFIER_BYTES = 255;
+function isMatrixIpv4Address(value) {
+    const octets = value.split(".");
+    return (octets.length === 4 && octets.every((octet) => /^\d{1,3}$/u.test(octet) && Number(octet) <= 255));
+}
+export function isMatrixServerName(value) {
+    const ipv6 = /^\[([^\]]+)\](?::(\d{1,5}))?$/u.exec(value);
+    if (ipv6) {
+        return isIP(ipv6[1]) === 6;
+    }
+    const hostAndPort = /^([^:]+?)(?::(\d{1,5}))?$/u.exec(value);
+    if (!hostAndPort) {
+        return false;
+    }
+    const hostname = hostAndPort[1];
+    if (isMatrixIpv4Address(hostname)) {
+        return true;
+    }
+    if (/^\d+\.\d+\.\d+\.\d+$/u.test(hostname)) {
+        return false;
+    }
+    return hostname.length <= 255 && /^[A-Za-z0-9.-]+$/u.test(hostname);
+}
+function hasLoneSurrogate(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code >= 0xd800 && code <= 0xdbff) {
+            const next = value.charCodeAt(index + 1);
+            if (next < 0xdc00 || next > 0xdfff) {
+                return true;
+            }
+            index += 1;
+        }
+        else if (code >= 0xdc00 && code <= 0xdfff) {
+            return true;
+        }
+    }
+    return false;
+}
+function isMatrixScopedIdentifier(value, sigil, allowEmptyLocalpart = false) {
+    const separator = value.indexOf(":");
+    const localpart = value.slice(1, separator);
+    return (value.startsWith(sigil) &&
+        Buffer.byteLength(value, "utf8") <= MAX_MATRIX_IDENTIFIER_BYTES &&
+        separator >= (allowEmptyLocalpart ? 1 : 2) &&
+        !localpart.includes("\0") &&
+        !hasLoneSurrogate(localpart) &&
+        isMatrixServerName(value.slice(separator + 1)));
+}
+function isMatrixHashIdentifier(value, sigil, allowLegacyBase64) {
+    if (!value.startsWith(sigil) || Buffer.byteLength(value, "utf8") > MAX_MATRIX_IDENTIFIER_BYTES) {
+        return false;
+    }
+    const opaqueId = value.slice(1);
+    const encoding = allowLegacyBase64 && /^[A-Za-z0-9+/]{43}$/u.test(opaqueId)
+        ? "base64"
+        : /^[A-Za-z0-9_-]{43}$/u.test(opaqueId)
+            ? "base64url"
+            : undefined;
+    if (!encoding) {
+        return false;
+    }
+    const decoded = Buffer.from(opaqueId, encoding);
+    return decoded.length === 32 && decoded.toString(encoding).replace(/=+$/u, "") === opaqueId;
+}
+export function isMatrixRoomId(value) {
+    return isMatrixScopedIdentifier(value, "!") || isMatrixHashIdentifier(value, "!", false);
+}
+export function isMatrixEventId(value) {
+    return isMatrixScopedIdentifier(value, "$") || isMatrixHashIdentifier(value, "$", true);
+}
+export function isMatrixUserId(value) {
+    if (!isMatrixScopedIdentifier(value, "@")) {
+        return false;
+    }
+    const localpart = value.slice(1, value.indexOf(":"));
+    return /^[a-z0-9._=/+-]+$/u.test(localpart);
+}
+export function isHistoricalMatrixUserId(value) {
+    return isMatrixScopedIdentifier(value, "@", true);
+}
+//# sourceMappingURL=matrix-ids.js.map

package/dist/src/matrix-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix-ids.js","sourceRoot":"","sources":["../../src/matrix-ids.ts"],"names":[],"mappings":"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","sourcesContent":["import { isIP } from \"node:net\";\n\nconst MAX_MATRIX_IDENTIFIER_BYTES = 255;\n\nfunction isMatrixIpv4Address(value: string): boolean {\n  const octets = value.split(\".\");\n  return (\n    octets.length === 4 && octets.every((octet) => /^\\d{1,3}$/u.test(octet) && Number(octet) <= 255)\n  );\n}\n\nexport function isMatrixServerName(value: string): boolean {\n  const ipv6 = /^\\[([^\\]]+)\\](?::(\\d{1,5}))?$/u.exec(value);\n  if (ipv6) {\n    return isIP(ipv6[1]!) === 6;\n  }\n  const hostAndPort = /^([^:]+?)(?::(\\d{1,5}))?$/u.exec(value);\n  if (!hostAndPort) {\n    return false;\n  }\n  const hostname = hostAndPort[1]!;\n  if (isMatrixIpv4Address(hostname)) {\n    return true;\n  }\n  if (/^\\d+\\.\\d+\\.\\d+\\.\\d+$/u.test(hostname)) {\n    return false;\n  }\n  return hostname.length <= 255 && /^[A-Za-z0-9.-]+$/u.test(hostname);\n}\n\nfunction hasLoneSurrogate(value: string): boolean {\n  for (let index = 0; index < value.length; index += 1) {\n    const code = value.charCodeAt(index);\n    if (code >= 0xd800 && code <= 0xdbff) {\n      const next = value.charCodeAt(index + 1);\n      if (next < 0xdc00 || next > 0xdfff) {\n        return true;\n      }\n      index += 1;\n    } else if (code >= 0xdc00 && code <= 0xdfff) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction isMatrixScopedIdentifier(\n  value: string,\n  sigil: \"!\" | \"$\" | \"@\",\n  allowEmptyLocalpart = false,\n): boolean {\n  const separator = value.indexOf(\":\");\n  const localpart = value.slice(1, separator);\n  return (\n    value.startsWith(sigil) &&\n    Buffer.byteLength(value, \"utf8\") <= MAX_MATRIX_IDENTIFIER_BYTES &&\n    separator >= (allowEmptyLocalpart ? 1 : 2) &&\n    !localpart.includes(\"\\0\") &&\n    !hasLoneSurrogate(localpart) &&\n    isMatrixServerName(value.slice(separator + 1))\n  );\n}\n\nfunction isMatrixHashIdentifier(\n  value: string,\n  sigil: \"!\" | \"$\",\n  allowLegacyBase64: boolean,\n): boolean {\n  if (!value.startsWith(sigil) || Buffer.byteLength(value, \"utf8\") > MAX_MATRIX_IDENTIFIER_BYTES) {\n    return false;\n  }\n  const opaqueId = value.slice(1);\n  const encoding =\n    allowLegacyBase64 && /^[A-Za-z0-9+/]{43}$/u.test(opaqueId)\n      ? \"base64\"\n      : /^[A-Za-z0-9_-]{43}$/u.test(opaqueId)\n        ? \"base64url\"\n        : undefined;\n  if (!encoding) {\n    return false;\n  }\n  const decoded = Buffer.from(opaqueId, encoding);\n  return decoded.length === 32 && decoded.toString(encoding).replace(/=+$/u, \"\") === opaqueId;\n}\n\nexport function isMatrixRoomId(value: string): boolean {\n  return isMatrixScopedIdentifier(value, \"!\") || isMatrixHashIdentifier(value, \"!\", false);\n}\n\nexport function isMatrixEventId(value: string): boolean {\n  return isMatrixScopedIdentifier(value, \"$\") || isMatrixHashIdentifier(value, \"$\", true);\n}\n\nexport function isMatrixUserId(value: string): boolean {\n  if (!isMatrixScopedIdentifier(value, \"@\")) {\n    return false;\n  }\n  const localpart = value.slice(1, value.indexOf(\":\"));\n  return /^[a-z0-9._=/+-]+$/u.test(localpart);\n}\n\nexport function isHistoricalMatrixUserId(value: string): boolean {\n  return isMatrixScopedIdentifier(value, \"@\", true);\n}\n"]}

package/dist/src/openclaw/artifact-generation.d.ts

@@ -2,15 +2,20 @@ import type { CrablineServerManifest } from "../servers/index.js";
 import { publishPrivateFileAtomically, syncParentDirectory } from "./private-file.js";
 import { type OpenClawCrablineChannelDriverSelection } from "./shared.js";
 import type { OpenClawCrablineSmokeRunLock } from "./smoke-lock.js";
-export type OpenClawCrablineArtifactPointer = {
+type OpenClawCrablineArtifactPointerBase = {
     capabilityMatrixPath: string;
     generation: string;
     manifestPath: string;
     previousGeneration?: string;
     providerReadinessArtifactPath: string;
     smokeArtifactPath: string;
-    version: 1;
 };
+export type OpenClawCrablineArtifactPointer = (OpenClawCrablineArtifactPointerBase & {
+    version: 1;
+}) | (OpenClawCrablineArtifactPointerBase & {
+    recorderSnapshotPath: string | null;
+    version: 2;
+});
 export type PublishedOpenClawCrablineArtifactGeneration = OpenClawCrablineArtifactPointer & {
     pointerPath: string;
     providerReadiness: Record<string, unknown>;
@@ -26,12 +31,17 @@ type PublishGenerationDependencies = {
     secureWindowsFile?: (filePath: string) => Promise<void>;
     syncParent?: typeof syncParentDirectory;
 };
+type RecorderSnapshot = {
+    contents: string;
+    fileName: string;
+};
 export declare function readOpenClawCrablineArtifactPointer(outputDir: string): Promise<OpenClawCrablineArtifactPointer | null>;
 export declare function publishOpenClawCrablineArtifactGeneration(params: {
     capabilityReport: unknown;
     lock: OpenClawCrablineSmokeRunLock;
     manifest: CrablineServerManifest;
     outputDir: string;
+    recorderSnapshot?: RecorderSnapshot;
     selection: OpenClawCrablineChannelDriverSelection;
     providerReadiness: Record<string, unknown>;
 }, dependencies?: PublishGenerationDependencies): Promise<PublishedOpenClawCrablineArtifactGeneration>;