@openclawbrain/cli 0.4.0

package/dist/src/attachment-truth.d.ts

@@ -0,0 +1,34 @@
+import { type OpenClawHomeInspection } from "./openclaw-home-layout.js";
+declare const ATTACHMENT_RUNTIME_LOAD_PROOFS_CONTRACT: "openclaw_profile_runtime_load_proofs.v1";
+export interface OpenClawProfileRuntimeLoadProofRecordV1 {
+    openclawHome: string;
+    profileId: string | null;
+    profileSource: OpenClawHomeInspection["profileSource"];
+    loadedAt: string;
+    extensionEntryPath: string;
+}
+export interface OpenClawProfileRuntimeLoadProofsV1 {
+    contract: typeof ATTACHMENT_RUNTIME_LOAD_PROOFS_CONTRACT;
+    runtimeOwner: "openclaw";
+    activationRoot: string;
+    updatedAt: string;
+    profiles: OpenClawProfileRuntimeLoadProofRecordV1[];
+}
+export interface OpenClawProfileRuntimeLoadProofSetV1 {
+    path: string;
+    proofs: OpenClawProfileRuntimeLoadProofsV1 | null;
+    error: string | null;
+}
+export declare function resolveAttachmentRuntimeLoadProofsPath(activationRoot: string): string;
+export declare function listOpenClawProfileRuntimeLoadProofs(activationRoot: string): OpenClawProfileRuntimeLoadProofSetV1;
+export declare function recordOpenClawProfileRuntimeLoadProof(input: {
+    activationRoot: string;
+    extensionEntryPath: string;
+    loadedAt?: string | null;
+}): OpenClawProfileRuntimeLoadProofRecordV1;
+export declare function clearOpenClawProfileRuntimeLoadProof(input: {
+    activationRoot: string;
+    openclawHome: string;
+    clearedAt?: string | null;
+}): boolean;
+export {};

package/dist/src/attachment-truth.js

@@ -0,0 +1,220 @@
+import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { inspectOpenClawHome } from "./openclaw-home-layout.js";
+import { resolveOpenClawHomeFromExtensionEntryPath } from "./openclaw-plugin-install.js";
+const ATTACHMENT_RUNTIME_LOAD_PROOFS_CONTRACT = "openclaw_profile_runtime_load_proofs.v1";
+const ATTACHMENT_TRUTH_DIRNAME = "attachment-truth";
+const ATTACHMENT_RUNTIME_LOAD_PROOFS_BASENAME = "runtime-load-proofs.json";
+function toErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function canonicalizeFilesystemPath(filePath) {
+    const resolvedPath = path.resolve(filePath);
+    try {
+        return realpathSync(resolvedPath);
+    }
+    catch {
+        return resolvedPath;
+    }
+}
+function normalizeIsoTimestamp(value, fieldName, fallbackValue) {
+    const candidate = value ?? fallbackValue;
+    if (candidate === undefined || candidate === null || candidate.trim().length === 0) {
+        throw new Error(`${fieldName} is required`);
+    }
+    if (Number.isNaN(Date.parse(candidate))) {
+        throw new Error(`${fieldName} must be an ISO timestamp`);
+    }
+    return new Date(candidate).toISOString();
+}
+function readRecord(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+function validateRuntimeLoadProofRecord(value, index) {
+    const record = readRecord(value);
+    if (record === null) {
+        throw new Error(`profiles[${index}] must be an object`);
+    }
+    const openclawHome = typeof record.openclawHome === "string" && record.openclawHome.trim().length > 0
+        ? canonicalizeFilesystemPath(record.openclawHome)
+        : null;
+    const profileId = record.profileId === null ? null : typeof record.profileId === "string" && record.profileId.trim().length > 0
+        ? record.profileId.trim()
+        : undefined;
+    const profileSource = record.profileSource === "openclaw_json_profile" ||
+        record.profileSource === "openclaw_json_single_profile_key" ||
+        record.profileSource === "directory_name" ||
+        record.profileSource === "none"
+        ? record.profileSource
+        : null;
+    const extensionEntryPath = typeof record.extensionEntryPath === "string" && record.extensionEntryPath.trim().length > 0
+        ? canonicalizeFilesystemPath(record.extensionEntryPath)
+        : null;
+    const loadedAt = typeof record.loadedAt === "string" && record.loadedAt.trim().length > 0
+        ? normalizeIsoTimestamp(record.loadedAt, `profiles[${index}].loadedAt`)
+        : null;
+    if (openclawHome === null) {
+        throw new Error(`profiles[${index}].openclawHome must be a non-empty string`);
+    }
+    if (profileId === undefined) {
+        throw new Error(`profiles[${index}].profileId must be null or a non-empty string`);
+    }
+    if (profileSource === null) {
+        throw new Error(`profiles[${index}].profileSource must be a supported OpenClaw profile source`);
+    }
+    if (extensionEntryPath === null) {
+        throw new Error(`profiles[${index}].extensionEntryPath must be a non-empty string`);
+    }
+    if (loadedAt === null) {
+        throw new Error(`profiles[${index}].loadedAt must be a non-empty ISO timestamp`);
+    }
+    return {
+        openclawHome,
+        profileId,
+        profileSource,
+        extensionEntryPath,
+        loadedAt
+    };
+}
+function validateRuntimeLoadProofs(activationRoot, value) {
+    const record = readRecord(value);
+    if (record === null) {
+        throw new Error("runtime load proof file must contain an object");
+    }
+    if (record.contract !== ATTACHMENT_RUNTIME_LOAD_PROOFS_CONTRACT) {
+        throw new Error(`runtime load proof contract must be ${ATTACHMENT_RUNTIME_LOAD_PROOFS_CONTRACT}`);
+    }
+    if (record.runtimeOwner !== "openclaw") {
+        throw new Error("runtime load proof runtimeOwner must be openclaw");
+    }
+    if (typeof record.activationRoot !== "string" || record.activationRoot.trim().length === 0) {
+        throw new Error("runtime load proof activationRoot must be a non-empty string");
+    }
+    const resolvedActivationRoot = path.resolve(record.activationRoot);
+    if (resolvedActivationRoot !== activationRoot) {
+        throw new Error(`runtime load proof activationRoot mismatch: expected ${activationRoot}, received ${resolvedActivationRoot}`);
+    }
+    const updatedAt = typeof record.updatedAt === "string" && record.updatedAt.trim().length > 0
+        ? normalizeIsoTimestamp(record.updatedAt, "updatedAt")
+        : null;
+    if (updatedAt === null) {
+        throw new Error("runtime load proof updatedAt must be a non-empty ISO timestamp");
+    }
+    if (!Array.isArray(record.profiles)) {
+        throw new Error("runtime load proof profiles must be an array");
+    }
+    const profiles = record.profiles.map((entry, index) => validateRuntimeLoadProofRecord(entry, index));
+    return {
+        contract: ATTACHMENT_RUNTIME_LOAD_PROOFS_CONTRACT,
+        runtimeOwner: "openclaw",
+        activationRoot,
+        updatedAt,
+        profiles
+    };
+}
+function buildEmptyRuntimeLoadProofs(activationRoot, updatedAt) {
+    return {
+        contract: ATTACHMENT_RUNTIME_LOAD_PROOFS_CONTRACT,
+        runtimeOwner: "openclaw",
+        activationRoot,
+        updatedAt,
+        profiles: []
+    };
+}
+function writeRuntimeLoadProofs(proofPath, proofs) {
+    mkdirSync(path.dirname(proofPath), { recursive: true });
+    writeFileSync(proofPath, `${JSON.stringify(proofs, null, 2)}\n`, "utf8");
+}
+function deriveOpenClawHomeFromExtensionEntryPath(extensionEntryPath) {
+    const openclawHome = resolveOpenClawHomeFromExtensionEntryPath(extensionEntryPath);
+    if (openclawHome === null) {
+        throw new Error(`extension entry path ${extensionEntryPath} is not nested under an OpenClaw extensions dir`);
+    }
+    return canonicalizeFilesystemPath(openclawHome);
+}
+export function resolveAttachmentRuntimeLoadProofsPath(activationRoot) {
+    return path.join(path.resolve(activationRoot), ATTACHMENT_TRUTH_DIRNAME, ATTACHMENT_RUNTIME_LOAD_PROOFS_BASENAME);
+}
+export function listOpenClawProfileRuntimeLoadProofs(activationRoot) {
+    const resolvedActivationRoot = path.resolve(activationRoot);
+    const proofPath = resolveAttachmentRuntimeLoadProofsPath(resolvedActivationRoot);
+    if (!existsSync(proofPath)) {
+        return {
+            path: proofPath,
+            proofs: null,
+            error: null
+        };
+    }
+    try {
+        const parsed = JSON.parse(readFileSync(proofPath, "utf8"));
+        return {
+            path: proofPath,
+            proofs: validateRuntimeLoadProofs(resolvedActivationRoot, parsed),
+            error: null
+        };
+    }
+    catch (error) {
+        return {
+            path: proofPath,
+            proofs: null,
+            error: toErrorMessage(error)
+        };
+    }
+}
+export function recordOpenClawProfileRuntimeLoadProof(input) {
+    const activationRoot = path.resolve(input.activationRoot);
+    const loadedAt = normalizeIsoTimestamp(input.loadedAt, "loadedAt", new Date().toISOString());
+    const extensionEntryPath = canonicalizeFilesystemPath(input.extensionEntryPath);
+    const openclawHome = deriveOpenClawHomeFromExtensionEntryPath(extensionEntryPath);
+    const inspection = inspectOpenClawHome(openclawHome);
+    const loadedProofs = listOpenClawProfileRuntimeLoadProofs(activationRoot);
+    if (loadedProofs.error !== null) {
+        throw new Error(`runtime load proof file ${loadedProofs.path} is unreadable: ${loadedProofs.error}`);
+    }
+    const nextRecord = {
+        openclawHome: canonicalizeFilesystemPath(openclawHome),
+        profileId: inspection.profileId,
+        profileSource: inspection.profileSource,
+        loadedAt,
+        extensionEntryPath
+    };
+    const nextProofs = loadedProofs.proofs === null
+        ? buildEmptyRuntimeLoadProofs(activationRoot, loadedAt)
+        : {
+            ...loadedProofs.proofs,
+            updatedAt: loadedAt,
+            profiles: [...loadedProofs.proofs.profiles]
+        };
+    nextProofs.profiles = nextProofs.profiles
+        .filter((record) => canonicalizeFilesystemPath(record.openclawHome) !== nextRecord.openclawHome)
+        .concat(nextRecord)
+        .sort((left, right) => left.openclawHome.localeCompare(right.openclawHome));
+    writeRuntimeLoadProofs(loadedProofs.path, nextProofs);
+    return nextRecord;
+}
+export function clearOpenClawProfileRuntimeLoadProof(input) {
+    const activationRoot = path.resolve(input.activationRoot);
+    const clearedAt = normalizeIsoTimestamp(input.clearedAt, "clearedAt", new Date().toISOString());
+    const openclawHome = canonicalizeFilesystemPath(input.openclawHome);
+    const loadedProofs = listOpenClawProfileRuntimeLoadProofs(activationRoot);
+    if (loadedProofs.error !== null) {
+        throw new Error(`runtime load proof file ${loadedProofs.path} is unreadable: ${loadedProofs.error}`);
+    }
+    if (loadedProofs.proofs === null) {
+        return false;
+    }
+    const filteredProfiles = loadedProofs.proofs.profiles.filter((record) => canonicalizeFilesystemPath(record.openclawHome) !== openclawHome);
+    if (filteredProfiles.length === loadedProofs.proofs.profiles.length) {
+        return false;
+    }
+    writeRuntimeLoadProofs(loadedProofs.path, {
+        ...loadedProofs.proofs,
+        updatedAt: clearedAt,
+        profiles: filteredProfiles
+    });
+    return true;
+}
+//# sourceMappingURL=attachment-truth.js.map

package/dist/src/attachment-truth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-truth.js","sourceRoot":"","sources":["../../src/attachment-truth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC3F,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,mBAAmB,EAA+B,MAAM,2BAA2B,CAAC;AAE7F,MAAM,uCAAuC,GAAG,yCAAkD,CAAC;AACnG,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AACpD,MAAM,uCAAuC,GAAG,0BAA0B,CAAC;AAwB3E,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,0BAA0B,CAAC,QAAgB;IAClD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,YAAY,CAAC;IACtB,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAgC,EAChC,SAAiB,EACjB,aAAsB;IAEtB,MAAM,SAAS,GAAG,KAAK,IAAI,aAAa,CAAC;IACzC,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnF,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,cAAc,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,2BAA2B,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,8BAA8B,CAAC,KAAc,EAAE,KAAa;IACnE,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,YAAY,KAAK,qBAAqB,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACnG,CAAC,CAAC,0BAA0B,CAAC,MAAM,CAAC,YAAY,CAAC;QACjD,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,SAAS,GACb,MAAM,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAC3G,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;QACzB,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,aAAa,GACjB,MAAM,CAAC,aAAa,KAAK,uBAAuB;QAChD,MAAM,CAAC,aAAa,KAAK,kCAAkC;QAC3D,MAAM,CAAC,aAAa,KAAK,gBAAgB;QACzC,MAAM,CAAC,aAAa,KAAK,MAAM;QAC7B,CAAC,CAAC,MAAM,CAAC,aAAa;QACtB,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,kBAAkB,GACtB,OAAO,MAAM,CAAC,kBAAkB,KAAK,QAAQ,IAAI,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAC1F,CAAC,CAAC,0BAA0B,CAAC,MAAM,CAAC,kBAAkB,CAAC;QACvD,CAAC,CAAC,IAAI,CAAC;IACX,MAAM,QAAQ,GACZ,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACtE,CAAC,CAAC,qBAAqB,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,KAAK,YAAY,CAAC;QACvE,CAAC,CAAC,IAAI,CAAC;IAEX,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,YAAY,KAAK,2CAA2C,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,YAAY,KAAK,gDAAgD,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,YAAY,KAAK,6DAA6D,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,kBAAkB,KAAK,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,YAAY,KAAK,iDAAiD,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,YAAY,KAAK,8CAA8C,CAAC,CAAC;IACnF,CAAC;IAED,OAAO;QACL,YAAY;QACZ,SAAS;QACT,aAAa;QACb,kBAAkB;QAClB,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAChC,cAAsB,EACtB,KAAc;IAEd,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,uCAAuC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,uCAAuC,uCAAuC,EAAE,CAAC,CAAC;IACpG,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ,IAAI,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3F,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,sBAAsB,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IACnE,IAAI,sBAAsB,KAAK,cAAc,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,wDAAwD,cAAc,cAAc,sBAAsB,EAAE,CAC7G,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GACb,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACxE,CAAC,CAAC,qBAAqB,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC;QACtD,CAAC,CAAC,IAAI,CAAC;IACX,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,8BAA8B,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;IACrG,OAAO;QACL,QAAQ,EAAE,uCAAuC;QACjD,YAAY,EAAE,UAAU;QACxB,cAAc;QACd,SAAS;QACT,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAClC,cAAsB,EACtB,SAAiB;IAEjB,OAAO;QACL,QAAQ,EAAE,uCAAuC;QACjD,YAAY,EAAE,UAAU;QACxB,cAAc;QACd,SAAS;QACT,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAC7B,SAAiB,EACjB,MAA0C;IAE1C,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,aAAa,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,wCAAwC,CAAC,kBAA0B;IAC1E,OAAO,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,0BAA0B,CAAC,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAC5H,CAAC;AAED,MAAM,UAAU,sCAAsC,CAAC,cAAsB;IAC3E,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,wBAAwB,EAAE,uCAAuC,CAAC,CAAC;AACpH,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,cAAsB;IAEtB,MAAM,sBAAsB,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,sCAAsC,CAAC,sBAAsB,CAAC,CAAC;IAEjF,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3D,OAAO;YACL,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,yBAAyB,CAAC,sBAAsB,EAAE,MAAM,CAAC;YACjE,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC;SAC7B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,KAIrD;IACC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7F,MAAM,kBAAkB,GAAG,0BAA0B,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAChF,MAAM,YAAY,GAAG,wCAAwC,CAAC,kBAAkB,CAAC,CAAC;IAClF,MAAM,UAAU,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,oCAAoC,CAAC,cAAc,CAAC,CAAC;IAC1E,IAAI,YAAY,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,2BAA2B,YAAY,CAAC,IAAI,mBAAmB,YAAY,CAAC,KAAK,EAAE,CACpF,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAA4C;QAC1D,YAAY,EAAE,0BAA0B,CAAC,YAAY,CAAC;QACtD,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,aAAa,EAAE,UAAU,CAAC,aAAa;QACvC,QAAQ;QACR,kBAAkB;KACnB,CAAC;IACF,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,KAAK,IAAI;QAC7C,CAAC,CAAC,2BAA2B,CAAC,cAAc,EAAE,QAAQ,CAAC;QACvD,CAAC,CAAC;YACE,GAAG,YAAY,CAAC,MAAM;YACtB,SAAS,EAAE,QAAQ;YACnB,QAAQ,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC;SAC5C,CAAC;IAEN,UAAU,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ;SACtC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,UAAU,CAAC,YAAY,CAAC;SAC/F,MAAM,CAAC,UAAU,CAAC;SAClB,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IAE9E,sBAAsB,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACtD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,oCAAoC,CAAC,KAIpD;IACC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,qBAAqB,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAChG,MAAM,YAAY,GAAG,0BAA0B,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,oCAAoC,CAAC,cAAc,CAAC,CAAC;IAE1E,IAAI,YAAY,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,2BAA2B,YAAY,CAAC,IAAI,mBAAmB,YAAY,CAAC,KAAK,EAAE,CACpF,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,gBAAgB,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAC1D,CAAC,MAAM,EAAE,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,YAAY,CAC7E,CAAC;IACF,IAAI,gBAAgB,CAAC,MAAM,KAAK,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sBAAsB,CAAC,YAAY,CAAC,IAAI,EAAE;QACxC,GAAG,YAAY,CAAC,MAAM;QACtB,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,gBAAgB;KAC3B,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/cli.d.ts

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+import { type TextEmbedder } from "@openclawbrain/compiler";
+import { type DaemonCliArgs } from "./daemon.js";
+import { createAsyncTeacherLiveLoop, createOpenClawLocalSessionTail, createRuntimeEventExportScanner, type AsyncTeacherLabelerConfigV1, type CurrentProfileBrainStatusInput, type WatchEmbedInstrumentationTraceV1 } from "./index.js";
+interface ParsedStatusRollbackCliArgs {
+    command: "status" | "rollback";
+    input: CurrentProfileBrainStatusInput;
+    openclawHome: string | null;
+    json: boolean;
+    help: boolean;
+    dryRun: boolean;
+    detailed: boolean;
+}
+interface ParsedAttachCliArgs {
+    command: "attach";
+    openclawHome: string;
+    openclawHomeSource: "explicit";
+    activationRoot: string;
+    activationRootSource: ParsedInstallCliArgs["activationRootSource"];
+    shared: boolean;
+    workspaceId: string;
+    workspaceIdSource: ParsedInstallCliArgs["workspaceIdSource"];
+    skipEmbedderProvision: boolean;
+    skipEmbedderProvisionSource: ParsedInstallCliArgs["skipEmbedderProvisionSource"];
+    json: boolean;
+    help: boolean;
+}
+interface ParsedInstallCliArgs {
+    command: "install";
+    openclawHome: string;
+    openclawHomeSource: "explicit" | "env" | "discovered_single_home";
+    activationRoot: string;
+    activationRootSource: "explicit" | "default_from_openclaw_home";
+    shared: boolean;
+    workspaceId: string;
+    workspaceIdSource: "explicit" | "openclaw_json_profile" | "openclaw_json_single_profile_key" | "current_profile_boundary" | "openclaw_home_dir" | "fallback";
+    skipEmbedderProvision: boolean;
+    skipEmbedderProvisionSource: "flag" | "env" | null;
+    json: boolean;
+    help: boolean;
+}
+type RestartMode = "never" | "safe" | "external";
+interface ParsedDetachCliArgs {
+    command: "detach";
+    openclawHome: string;
+    activationRoot: string | null;
+    restart: RestartMode;
+    json: boolean;
+    help: boolean;
+}
+interface ParsedUninstallCliArgs {
+    command: "uninstall";
+    openclawHome: string;
+    activationRoot: string | null;
+    dataMode: "keep" | "purge";
+    restart: RestartMode;
+    json: boolean;
+    help: boolean;
+}
+interface ParsedScanCliArgs {
+    command: "scan";
+    json: boolean;
+    help: boolean;
+    sessionPath: string | null;
+    livePath: string | null;
+    rootDir: string | null;
+    workspacePath: string | null;
+    packLabel: string | null;
+    observedAt: string | null;
+    snapshotOutPath: string | null;
+}
+interface ParsedContextCliArgs {
+    command: "context";
+    message: string;
+    activationRoot: string;
+    json: boolean;
+    help: boolean;
+}
+interface ParsedHistoryCliArgs {
+    command: "history";
+    activationRoot: string;
+    limit: number;
+    json: boolean;
+    help: boolean;
+}
+interface ParsedLearnCliArgs {
+    command: "learn";
+    activationRoot: string;
+    json: boolean;
+    help: boolean;
+}
+interface ParsedWatchCliArgs {
+    command: "watch";
+    activationRoot: string;
+    scanRoot: string | null;
+    interval: number;
+    json: boolean;
+    help: boolean;
+}
+interface ParsedExportCliArgs {
+    command: "export";
+    activationRoot: string;
+    outputPath: string;
+    json: boolean;
+    help: boolean;
+}
+interface ParsedImportCliArgs {
+    command: "import";
+    archivePath: string;
+    activationRoot: string;
+    force: boolean;
+    json: boolean;
+    help: boolean;
+}
+interface ParsedResetCliArgs {
+    command: "reset";
+    activationRoot: string;
+    yes: boolean;
+    json: boolean;
+    help: boolean;
+}
+type ParsedOperatorCliArgs = ParsedStatusRollbackCliArgs | ParsedAttachCliArgs | ParsedScanCliArgs | ParsedInstallCliArgs | ParsedDetachCliArgs | ParsedUninstallCliArgs | ParsedContextCliArgs | ParsedHistoryCliArgs | ParsedLearnCliArgs | ParsedWatchCliArgs | DaemonCliArgs | ParsedExportCliArgs | ParsedImportCliArgs | ParsedResetCliArgs;
+export declare function parseOperatorCliArgs(argv: readonly string[]): ParsedOperatorCliArgs;
+export interface WatchCommandRuntimeV1 {
+    activationRoot: string;
+    scanRoot: string;
+    pollIntervalSeconds: number;
+    sessionTailCursorPath: string;
+    teacherSnapshotPath: string;
+    startupWarnings: string[];
+    lastTeacherError: string | null;
+    replayState: {
+        replayedBundleCount: number;
+        replayedEventCount: number;
+    };
+    lastHandledMaterializationPackId: string | null;
+    lastEmbedInstrumentation: WatchEmbedInstrumentationTraceV1 | null;
+    scanner: ReturnType<typeof createRuntimeEventExportScanner>;
+    teacherLoop: ReturnType<typeof createAsyncTeacherLiveLoop>;
+    localSessionTail: ReturnType<typeof createOpenClawLocalSessionTail>;
+    embedder: TextEmbedder | null;
+}
+export interface CreateWatchCommandRuntimeInputV1 {
+    activationRoot: string;
+    scanRoot?: string | null;
+    pollIntervalSeconds?: number;
+    profileRoots?: readonly string[];
+    log?: (message: string) => void;
+    teacherLabeler?: AsyncTeacherLabelerConfigV1 | null;
+    embedder?: TextEmbedder | null;
+}
+export interface WatchCommandPassResultV1 {
+    localPoll: ReturnType<WatchCommandRuntimeV1["localSessionTail"]["pollOnce"]>;
+    exported: {
+        exportedBundleCount: number;
+        exportedEventCount: number;
+        warnings: string[];
+    };
+    scanResult: ReturnType<WatchCommandRuntimeV1["scanner"]["scanOnce"]>;
+    snapshot: ReturnType<WatchCommandRuntimeV1["teacherLoop"]["snapshot"]>;
+    materializedPackId: string | null;
+}
+export declare function createWatchCommandRuntime(input: CreateWatchCommandRuntimeInputV1): Promise<WatchCommandRuntimeV1>;
+export declare function runWatchCommandPass(runtime: WatchCommandRuntimeV1, options?: {
+    observedAt?: string;
+    json?: boolean;
+    log?: (message: string) => void;
+}): Promise<WatchCommandPassResultV1>;
+export declare function runOperatorCli(argv?: readonly string[]): number;
+export {};