@openclaw/crabline 0.1.9 → 0.1.11

package/dist/src/openclaw/shared.js

@@ -1,22 +1,80 @@
 import { ADMIN_TOKEN_HEADER } from "../servers/http.js";
 export const DEFAULT_ACCOUNT_ID = "default";
 export const OPENCLAW_CRABLINE_CHANNEL_CAPABILITY_MATRIX_PATH = "crabline-fake-provider-capabilities.json";
-export const OPENCLAW_CRABLINE_CHANNEL_SMOKE_PATH = "crabline-fake-provider-smoke.json";
+export const OPENCLAW_CRABLINE_PROVIDER_READINESS_PATH = "crabline-fake-provider-smoke.json";
+/** @deprecated Use OPENCLAW_CRABLINE_PROVIDER_READINESS_PATH. */
+export const OPENCLAW_CRABLINE_CHANNEL_SMOKE_PATH = OPENCLAW_CRABLINE_PROVIDER_READINESS_PATH;
 export const OPENCLAW_CRABLINE_MANIFEST_PATH = "crabline-fake-provider-server.json";
+export const OPENCLAW_CRABLINE_ARTIFACT_STORE_DIRECTORY = ".crabline-smoke-artifacts";
+export const OPENCLAW_CRABLINE_ARTIFACT_POINTER_PATH = `${OPENCLAW_CRABLINE_ARTIFACT_STORE_DIRECTORY}/current.json`;
 export const OPENCLAW_CRABLINE_DEFAULT_CHANNEL = "telegram";
+const OPENCLAW_CRABLINE_PROVIDER_PROBE_TIMEOUT_MS = 5_000;
+const OPENCLAW_CRABLINE_PROVIDER_PROBE_LABELS = {
+    mattermost: "Mattermost users.me",
+    matrix: "Matrix whoami",
+    signal: "Signal check",
+    slack: "Slack auth.test",
+    telegram: "Telegram getMe",
+    whatsapp: "WhatsApp phone number",
+    zalo: "Zalo getMe",
+};
 export function createOpenClawCrablineProviderBridge(params) {
+    const createAdapter = (manifest) => {
+        const adapter = params.createAdapter(manifest);
+        return {
+            ...adapter,
+            createInbound(input) {
+                if (!readNonBlankString(input.text)) {
+                    throw new Error("OpenClaw Crabline inbound message text is required.");
+                }
+                if (input.conversation.kind !== "direct" && input.conversation.kind !== "group") {
+                    throw new Error("OpenClaw Crabline inbound conversation kind must be direct or group.");
+                }
+                return adapter.createInbound(input);
+            },
+        };
+    };
     const bridge = {
-        createAdapter: params.createAdapter,
+        createAdapter,
         createAdapterFromManifest(manifest) {
             if (manifest.provider !== params.provider) {
                 throw new Error(`Unsupported OpenClaw provider binding: expected ${params.provider}, got ${manifest.provider}.`);
             }
-            return params.createAdapter(manifest);
+            return createAdapter(manifest);
         },
         provider: params.provider,
     };
     return bridge;
 }
+export async function runOpenClawCrablineProviderProbe(provider, probe) {
+    const signal = AbortSignal.timeout(OPENCLAW_CRABLINE_PROVIDER_PROBE_TIMEOUT_MS);
+    const timeoutError = (cause) => new Error(`Crabline ${OPENCLAW_CRABLINE_PROVIDER_PROBE_LABELS[provider]} probe timed out after ${OPENCLAW_CRABLINE_PROVIDER_PROBE_TIMEOUT_MS} ms.`, { cause });
+    let onAbort;
+    const timeout = new Promise((_, reject) => {
+        onAbort = () => reject(timeoutError(signal.reason));
+        if (signal.aborted) {
+            onAbort();
+            return;
+        }
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+    const probeResult = Promise.resolve()
+        .then(() => probe(signal))
+        .catch((error) => {
+        if (signal.aborted) {
+            throw timeoutError(error);
+        }
+        throw error;
+    });
+    try {
+        return await Promise.race([probeResult, timeout]);
+    }
+    finally {
+        if (onAbort) {
+            signal.removeEventListener("abort", onAbort);
+        }
+    }
+}
 export function readString(value) {
     if (typeof value === "string" && value.trim()) {
         return value.trim();
@@ -26,6 +84,9 @@ export function readString(value) {
     }
     return undefined;
 }
+export function readNonBlankString(value) {
+    return typeof value === "string" && value.trim() ? value : undefined;
+}
 export function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -38,33 +99,69 @@ export function readInteger(value) {
 }
 export function parseQaTarget(target) {
     const trimmed = target.trim();
+    const invalidTarget = () => {
+        throw new Error("OpenClaw Crabline target must be a non-blank native id or a valid dm:<id>, group:<id>, channel:<id>, or thread:<id>/<thread-id> target.");
+    };
+    if (!trimmed) {
+        return invalidTarget();
+    }
     if (trimmed.startsWith("thread:")) {
-        const rest = trimmed.slice("thread:".length);
+        const encoded = trimmed.startsWith("thread:/v1/");
+        const rest = trimmed.slice(encoded ? "thread:/v1/".length : "thread:".length);
         const slash = rest.indexOf("/");
-        if (slash > 0) {
-            return { kind: "group", id: rest.slice(0, slash), threadId: rest.slice(slash + 1) };
+        if (slash <= 0 || slash !== rest.lastIndexOf("/")) {
+            return invalidTarget();
+        }
+        let id = rest.slice(0, slash).trim();
+        let threadId = rest.slice(slash + 1).trim();
+        if (encoded) {
+            try {
+                id = decodeURIComponent(id).trim();
+                threadId = decodeURIComponent(threadId).trim();
+            }
+            catch {
+                return invalidTarget();
+            }
+        }
+        if (!id || !threadId) {
+            return invalidTarget();
         }
+        return { kind: "group", id, native: false, threadId };
     }
     if (trimmed.startsWith("channel:")) {
-        return { kind: "group", id: trimmed.slice("channel:".length) };
+        const id = trimmed.slice("channel:".length).trim();
+        return id ? { kind: "group", id, native: false } : invalidTarget();
     }
     if (trimmed.startsWith("group:")) {
-        return { kind: "group", id: trimmed.slice("group:".length) };
+        const id = trimmed.slice("group:".length).trim();
+        return id ? { kind: "group", id, native: false } : invalidTarget();
     }
     if (trimmed.startsWith("dm:")) {
-        return { kind: "direct", id: trimmed.slice("dm:".length) };
+        const id = trimmed.slice("dm:".length).trim();
+        return id ? { kind: "direct", id, native: false } : invalidTarget();
     }
-    return { kind: "direct", id: trimmed };
+    if (/^(?:dm|group|channel|thread)(?=\s*:|$)/iu.test(trimmed)) {
+        return invalidTarget();
+    }
+    return { kind: "direct", id: trimmed, native: true };
+}
+export function canonicalConversationIdForInbound(input) {
+    const conversationId = readNonBlankString(input.conversation.id);
+    if (!conversationId) {
+        throw new Error("OpenClaw Crabline inbound conversation id is required.");
+    }
+    return conversationId.trim();
+}
+function encodeQaThreadComponent(value) {
+    return value.replaceAll("%", "%25").replaceAll("/", "%2F");
 }
 export function qaTargetForInbound(input) {
-    const prefix = input.conversation.kind === "direct"
-        ? "dm"
-        : input.conversation.kind === "channel"
-            ? "channel"
-            : "group";
-    return input.threadId
-        ? `thread:${input.conversation.id}/${input.threadId}`
-        : `${prefix}:${input.conversation.id}`;
+    const conversationId = canonicalConversationIdForInbound(input);
+    const threadId = input.threadId?.trim();
+    const prefix = input.conversation.kind === "direct" ? "dm" : "group";
+    return threadId
+        ? `thread:/v1/${encodeQaThreadComponent(conversationId)}/${encodeQaThreadComponent(threadId)}`
+        : `${prefix}:${conversationId}`;
 }
 export function createAdminInboundRequest(manifest) {
     return {

package/dist/src/openclaw/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/openclaw/shared.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/openclaw/shared.ts"],"names":[],"mappings":"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","sourcesContent":["import { ADMIN_TOKEN_HEADER } from \"../servers/http.js\";\nimport type { CrablineServerChannel, CrablineServerManifest } from \"../servers/index.js\";\nimport type { ServerEventObserver } from \"../servers/recorder.js\";\n\nexport const DEFAULT_ACCOUNT_ID = \"default\";\nexport const OPENCLAW_CRABLINE_CHANNEL_CAPABILITY_MATRIX_PATH =\n  \"crabline-fake-provider-capabilities.json\";\nexport const OPENCLAW_CRABLINE_PROVIDER_READINESS_PATH = \"crabline-fake-provider-smoke.json\";\n/** @deprecated Use OPENCLAW_CRABLINE_PROVIDER_READINESS_PATH. */\nexport const OPENCLAW_CRABLINE_CHANNEL_SMOKE_PATH = OPENCLAW_CRABLINE_PROVIDER_READINESS_PATH;\nexport const OPENCLAW_CRABLINE_MANIFEST_PATH = \"crabline-fake-provider-server.json\";\nexport const OPENCLAW_CRABLINE_ARTIFACT_STORE_DIRECTORY = \".crabline-smoke-artifacts\";\nexport const OPENCLAW_CRABLINE_ARTIFACT_POINTER_PATH = `${OPENCLAW_CRABLINE_ARTIFACT_STORE_DIRECTORY}/current.json`;\nexport const OPENCLAW_CRABLINE_DEFAULT_CHANNEL = \"telegram\";\n\nconst OPENCLAW_CRABLINE_PROVIDER_PROBE_TIMEOUT_MS = 5_000;\nconst OPENCLAW_CRABLINE_PROVIDER_PROBE_LABELS = {\n  mattermost: \"Mattermost users.me\",\n  matrix: \"Matrix whoami\",\n  signal: \"Signal check\",\n  slack: \"Slack auth.test\",\n  telegram: \"Telegram getMe\",\n  whatsapp: \"WhatsApp phone number\",\n  zalo: \"Zalo getMe\",\n} satisfies Record<CrablineServerManifest[\"provider\"], string>;\n\nexport type OpenClawCrablineChannelDriverSelection = {\n  channel: CrablineServerChannel;\n  channelDriver: \"crabline\";\n  capabilityMatrixPath: typeof OPENCLAW_CRABLINE_CHANNEL_CAPABILITY_MATRIX_PATH;\n  providerReadinessArtifactPath?: typeof OPENCLAW_CRABLINE_PROVIDER_READINESS_PATH;\n  smokeArtifactPath: typeof OPENCLAW_CRABLINE_CHANNEL_SMOKE_PATH;\n};\n\n/** @deprecated Use OpenClawCrablineProviderReadinessResult. */\nexport type OpenClawCrablineChannelDriverSmokeResult = {\n  artifactPointerPath: string;\n  capabilityReport: unknown;\n  capabilityMatrixPath: string;\n  generation: string;\n  manifestPath: string;\n  smoke: unknown;\n  smokeArtifactPath: string;\n  warnings?: string[];\n};\n\nexport type OpenClawCrablineProviderReadinessResult = OpenClawCrablineChannelDriverSmokeResult & {\n  providerReadiness: unknown;\n  providerReadinessArtifactPath: string;\n};\nexport type OpenClawCrablineConversation = {\n  id: string;\n  kind: \"direct\" | \"group\";\n};\n\nexport type OpenClawCrablineGatewayBinding = {\n  accountId: string;\n  channel: string;\n  createChannelDriverSmokeEnv(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;\n  createGatewayConfig(openclawConfig?: Record<string, unknown>): Record<string, unknown>;\n  requiredPluginIds: string[];\n};\n\nexport type OpenClawCrablineAgentDelivery = {\n  channel: string;\n  replyChannel: string;\n  replyTo: string;\n  to: string;\n};\n\nexport type OpenClawCrablineInboundInput = {\n  conversation: {\n    id: string;\n    kind: \"direct\" | \"group\";\n  };\n  senderId: string;\n  senderName?: string | undefined;\n  text: string;\n  threadId?: string | undefined;\n  nativeCommand?: { name: string } | undefined;\n};\n\nexport type OpenClawCrablineInbound = {\n  providerBody: Record<string, unknown>;\n  providerHeaders: Record<string, string>;\n  providerTargetKey: string;\n  providerUrl: string;\n  qaTarget: string;\n  stateConversation: OpenClawCrablineConversation;\n  threadId?: string | undefined;\n};\n\nexport type OpenClawCrablineOutboundMessage = {\n  accountId: string;\n  senderId: string;\n  senderName: string;\n  text: string;\n  to: string;\n};\n\nexport type StartOpenClawCrablineAdapterParams = {\n  channel: CrablineServerChannel;\n  onEvent?: ServerEventObserver | undefined;\n  openclawConfig?: Record<string, unknown> | undefined;\n  recorderPath?: string | undefined;\n};\n\nexport type StartedOpenClawCrablineAdapter = OpenClawCrablineGatewayBinding & {\n  close(): Promise<void>;\n  createAgentDelivery(params: { target: string }): OpenClawCrablineAgentDelivery;\n  createInbound(params: { input: OpenClawCrablineInboundInput }): OpenClawCrablineInbound;\n  createOutboundFromRecorderEvent(params: {\n    event: unknown;\n    targetByProviderTarget: ReadonlyMap<string, string>;\n  }): OpenClawCrablineOutboundMessage | null;\n  manifest: CrablineServerManifest;\n  probe(): Promise<unknown>;\n};\n\nexport type ParsedQaTarget = {\n  kind: \"direct\" | \"group\";\n  id: string;\n  native: boolean;\n  threadId?: string;\n};\n\nexport type OpenClawCrablineProviderAdapter = {\n  createAgentDelivery(parsed: ParsedQaTarget): OpenClawCrablineAgentDelivery;\n  createBinding(): OpenClawCrablineGatewayBinding;\n  createInbound(input: OpenClawCrablineInboundInput): OpenClawCrablineInbound;\n  createOutboundFromRecorderEvent(params: {\n    event: unknown;\n    targetByProviderTarget: ReadonlyMap<string, string>;\n  }): OpenClawCrablineOutboundMessage | null;\n  probe(signal?: AbortSignal): Promise<unknown>;\n};\n\nexport type OpenClawCrablineProviderBridge<\n  TManifest extends CrablineServerManifest = CrablineServerManifest,\n> = {\n  createAdapter(manifest: TManifest): OpenClawCrablineProviderAdapter;\n  createAdapterFromManifest(manifest: CrablineServerManifest): OpenClawCrablineProviderAdapter;\n  provider: TManifest[\"provider\"];\n};\n\nexport type OpenClawCrablineProviderBridgeRegistry = {\n  [Provider in CrablineServerManifest[\"provider\"]]: OpenClawCrablineProviderBridge<\n    Extract<CrablineServerManifest, { provider: Provider }>\n  >;\n};\n\nexport function createOpenClawCrablineProviderBridge<\n  TProvider extends CrablineServerManifest[\"provider\"],\n>(params: {\n  createAdapter(\n    manifest: Extract<CrablineServerManifest, { provider: TProvider }>,\n  ): OpenClawCrablineProviderAdapter;\n  provider: TProvider;\n}): OpenClawCrablineProviderBridge<Extract<CrablineServerManifest, { provider: TProvider }>> {\n  type ProviderManifest = Extract<CrablineServerManifest, { provider: TProvider }>;\n  const createAdapter = (manifest: ProviderManifest): OpenClawCrablineProviderAdapter => {\n    const adapter = params.createAdapter(manifest);\n    return {\n      ...adapter,\n      createInbound(input) {\n        if (!readNonBlankString(input.text)) {\n          throw new Error(\"OpenClaw Crabline inbound message text is required.\");\n        }\n        if (input.conversation.kind !== \"direct\" && input.conversation.kind !== \"group\") {\n          throw new Error(\"OpenClaw Crabline inbound conversation kind must be direct or group.\");\n        }\n        return adapter.createInbound(input);\n      },\n    };\n  };\n  const bridge: OpenClawCrablineProviderBridge<ProviderManifest> = {\n    createAdapter,\n    createAdapterFromManifest(manifest) {\n      if (manifest.provider !== params.provider) {\n        throw new Error(\n          `Unsupported OpenClaw provider binding: expected ${params.provider}, got ${manifest.provider}.`,\n        );\n      }\n      return createAdapter(manifest as ProviderManifest);\n    },\n    provider: params.provider as ProviderManifest[\"provider\"],\n  };\n  return bridge;\n}\n\nexport async function runOpenClawCrablineProviderProbe<T>(\n  provider: CrablineServerManifest[\"provider\"],\n  probe: (signal: AbortSignal) => Promise<T>,\n): Promise<T> {\n  const signal = AbortSignal.timeout(OPENCLAW_CRABLINE_PROVIDER_PROBE_TIMEOUT_MS);\n  const timeoutError = (cause: unknown) =>\n    new Error(\n      `Crabline ${OPENCLAW_CRABLINE_PROVIDER_PROBE_LABELS[provider]} probe timed out after ${OPENCLAW_CRABLINE_PROVIDER_PROBE_TIMEOUT_MS} ms.`,\n      { cause },\n    );\n  let onAbort: (() => void) | undefined;\n  const timeout = new Promise<never>((_, reject) => {\n    onAbort = () => reject(timeoutError(signal.reason));\n    if (signal.aborted) {\n      onAbort();\n      return;\n    }\n    signal.addEventListener(\"abort\", onAbort, { once: true });\n  });\n  const probeResult = Promise.resolve()\n    .then(() => probe(signal))\n    .catch((error: unknown) => {\n      if (signal.aborted) {\n        throw timeoutError(error);\n      }\n      throw error;\n    });\n  try {\n    return await Promise.race([probeResult, timeout]);\n  } finally {\n    if (onAbort) {\n      signal.removeEventListener(\"abort\", onAbort);\n    }\n  }\n}\n\nexport function readString(value: unknown): string | undefined {\n  if (typeof value === \"string\" && value.trim()) {\n    return value.trim();\n  }\n  if (typeof value === \"number\" || typeof value === \"bigint\") {\n    return String(value);\n  }\n  return undefined;\n}\n\nexport function readNonBlankString(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim() ? value : undefined;\n}\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nexport function readInteger(value: unknown): number | undefined {\n  const stringValue = readString(value);\n  if (!stringValue || !/^-?\\d+$/u.test(stringValue)) {\n    return undefined;\n  }\n  return Number(stringValue);\n}\n\nexport function parseQaTarget(target: string): ParsedQaTarget {\n  const trimmed = target.trim();\n  const invalidTarget = () => {\n    throw new Error(\n      \"OpenClaw Crabline target must be a non-blank native id or a valid dm:<id>, group:<id>, channel:<id>, or thread:<id>/<thread-id> target.\",\n    );\n  };\n  if (!trimmed) {\n    return invalidTarget();\n  }\n  if (trimmed.startsWith(\"thread:\")) {\n    const encoded = trimmed.startsWith(\"thread:/v1/\");\n    const rest = trimmed.slice(encoded ? \"thread:/v1/\".length : \"thread:\".length);\n    const slash = rest.indexOf(\"/\");\n    if (slash <= 0 || slash !== rest.lastIndexOf(\"/\")) {\n      return invalidTarget();\n    }\n    let id = rest.slice(0, slash).trim();\n    let threadId = rest.slice(slash + 1).trim();\n    if (encoded) {\n      try {\n        id = decodeURIComponent(id).trim();\n        threadId = decodeURIComponent(threadId).trim();\n      } catch {\n        return invalidTarget();\n      }\n    }\n    if (!id || !threadId) {\n      return invalidTarget();\n    }\n    return { kind: \"group\", id, native: false, threadId };\n  }\n  if (trimmed.startsWith(\"channel:\")) {\n    const id = trimmed.slice(\"channel:\".length).trim();\n    return id ? { kind: \"group\", id, native: false } : invalidTarget();\n  }\n  if (trimmed.startsWith(\"group:\")) {\n    const id = trimmed.slice(\"group:\".length).trim();\n    return id ? { kind: \"group\", id, native: false } : invalidTarget();\n  }\n  if (trimmed.startsWith(\"dm:\")) {\n    const id = trimmed.slice(\"dm:\".length).trim();\n    return id ? { kind: \"direct\", id, native: false } : invalidTarget();\n  }\n  if (/^(?:dm|group|channel|thread)(?=\\s*:|$)/iu.test(trimmed)) {\n    return invalidTarget();\n  }\n  return { kind: \"direct\", id: trimmed, native: true };\n}\n\nexport function canonicalConversationIdForInbound(input: OpenClawCrablineInboundInput) {\n  const conversationId = readNonBlankString(input.conversation.id);\n  if (!conversationId) {\n    throw new Error(\"OpenClaw Crabline inbound conversation id is required.\");\n  }\n  return conversationId.trim();\n}\n\nfunction encodeQaThreadComponent(value: string): string {\n  return value.replaceAll(\"%\", \"%25\").replaceAll(\"/\", \"%2F\");\n}\n\nexport function qaTargetForInbound(input: OpenClawCrablineInboundInput) {\n  const conversationId = canonicalConversationIdForInbound(input);\n  const threadId = input.threadId?.trim();\n  const prefix = input.conversation.kind === \"direct\" ? \"dm\" : \"group\";\n  return threadId\n    ? `thread:/v1/${encodeQaThreadComponent(conversationId)}/${encodeQaThreadComponent(threadId)}`\n    : `${prefix}:${conversationId}`;\n}\n\nexport function createAdminInboundRequest(manifest: CrablineServerManifest) {\n  return {\n    providerHeaders: {\n      \"content-type\": \"application/json\",\n      [ADMIN_TOKEN_HEADER]: manifest.adminToken,\n    },\n    providerUrl: manifest.endpoints.adminInboundUrl,\n  };\n}\n"]}

package/dist/src/openclaw/smoke-lock.d.ts

@@ -0,0 +1,63 @@
+import { type CrablineServerChannel } from "../servers/index.js";
+export type OpenClawCrablineSmokeRunLock = {
+    assertOwned(): Promise<void>;
+    commitFileAtomically(params: {
+        contents: string;
+        destinationPath: string;
+        stageDirectory?: string;
+        stageFile(filePath: string, contents: string): Promise<void>;
+    }): Promise<void>;
+    release(): Promise<void>;
+};
+type HeartbeatController = {
+    assertHealthy(): void;
+    settle(): Promise<void>;
+    stop(): Promise<void>;
+};
+type RemoveLockDirectory = (lockDirectory: string) => Promise<void>;
+type Sleep = (delayMs: number) => Promise<void>;
+type IsProcessAlive = (pid: number) => boolean;
+type GetProcessIdentity = (pid: number) => string | null;
+type StartHeartbeat = (renew: () => Promise<void>, intervalMs: number) => HeartbeatController;
+type BeforeRecoveryClaim = () => Promise<void>;
+type BeforeRecoveryDeleteClaim = () => Promise<void>;
+type BeforeReleaseClaim = () => Promise<void>;
+type BeforeCommitClaim = () => Promise<void>;
+type BeforeCommitFileRename = () => Promise<void>;
+type BeforeCommitRename = () => Promise<void>;
+type SecureWindowsDirectory = (directoryPath: string) => Promise<void>;
+type AfterLockDirectoryWrite = (directoryPath: string) => Promise<void>;
+export declare function processStartedAtMsFromTimeOrigin(timeOrigin: number): number;
+export declare const isProcessAlive: IsProcessAlive;
+export declare function processIdentityFromLinuxStat(value: string, bootId: string): string | null;
+export declare function processIdentityFromDarwin(processStartedAt: string, bootTime: string): string | null;
+export declare function darwinProcessIdentityEnvironment(environment: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export declare function acquireOpenClawCrablineSmokeRunLock(params: {
+    channel: CrablineServerChannel;
+    outputDir: string;
+}, dependencies?: {
+    afterLockCandidateInstall?: AfterLockDirectoryWrite;
+    afterLockOwnerWrite?: AfterLockDirectoryWrite;
+    getProcessIdentity?: GetProcessIdentity;
+    isProcessAlive?: IsProcessAlive;
+    leaseMs?: number;
+    now?: () => number;
+    pid?: number;
+    processIdentity?: string | null;
+    processStartedAtMs?: number;
+    platform?: NodeJS.Platform;
+    secureWindowsDirectory?: SecureWindowsDirectory;
+    beforeCommitClaim?: BeforeCommitClaim;
+    beforeCommitFileRename?: BeforeCommitFileRename;
+    beforeCommitRename?: BeforeCommitRename;
+    beforeRecoveryDeleteClaim?: BeforeRecoveryDeleteClaim;
+    beforeRecoveryClaim?: BeforeRecoveryClaim;
+    beforeReleaseClaim?: BeforeReleaseClaim;
+    removeDirectory?: RemoveLockDirectory;
+    sleep?: Sleep;
+    startHeartbeat?: StartHeartbeat;
+}): Promise<OpenClawCrablineSmokeRunLock>;
+export declare function releaseOpenClawCrablineSmokeRunLock(lock: Pick<OpenClawCrablineSmokeRunLock, "release">, dependencies?: {
+    sleep?: Sleep;
+}): Promise<void>;
+export {};