@openreef/cli 0.1.1 → 0.3.0

package/dist/core/gateway-client.js

@@ -0,0 +1,238 @@
+import WebSocket from 'ws';
+import { randomUUID } from 'node:crypto';
+import { loadOrCreateDeviceIdentity, signDevicePayload, publicKeyRawBase64Url, buildDeviceAuthPayload, loadDeviceAuthToken, storeDeviceAuthToken, } from './device-identity.js';
+const PROTOCOL_VERSION = 3;
+const CLIENT_ID = 'cli';
+const CLIENT_MODE = 'cli';
+const ROLE = 'operator';
+const SCOPES = ['operator.admin', 'operator.approvals', 'operator.pairing'];
+/**
+ * Resolve Gateway auth credentials from multiple sources.
+ * If gatewayUrl is explicitly provided (override), ONLY explicit --gateway-token
+ * or --gateway-password satisfy auth — env/config fallbacks are NOT accepted.
+ * For local (non-overridden) URLs: explicit CLI → env vars → config file values.
+ */
+export function resolveGatewayAuth(opts) {
+    // If URL was explicitly overridden, require explicit CLI auth (no env/config fallback)
+    if (opts.gatewayUrl) {
+        if (!opts.gatewayToken && !opts.gatewayPassword) {
+            throw new Error('Gateway URL override requires --gateway-token or --gateway-password.');
+        }
+        return {
+            token: opts.gatewayToken ?? undefined,
+            password: opts.gatewayPassword ?? undefined,
+            skipStoredAuth: true,
+        };
+    }
+    // Local/default URL: full resolution chain
+    const e = opts.env ?? process.env;
+    const gw = (opts.config?.gateway ?? {});
+    const auth = (gw.auth ?? {});
+    const token = opts.gatewayToken ??
+        e.OPENCLAW_GATEWAY_TOKEN ??
+        auth.token;
+    const password = opts.gatewayPassword ??
+        e.OPENCLAW_GATEWAY_PASSWORD ??
+        auth.password;
+    return {
+        token: token ?? undefined,
+        password: password ?? undefined,
+    };
+}
+export class GatewayClient {
+    ws = null;
+    pending = new Map();
+    connected = false;
+    options;
+    timeoutMs;
+    constructor(options) {
+        this.options = options;
+        this.timeoutMs = options.timeoutMs ?? 15000;
+    }
+    async connect() {
+        const identity = loadOrCreateDeviceIdentity(this.options.env);
+        // Load stored device auth token as fallback (only for local URLs)
+        const storedAuth = this.options.skipStoredAuth
+            ? null
+            : loadDeviceAuthToken({
+                deviceId: identity.deviceId,
+                role: ROLE,
+                env: this.options.env,
+            });
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(this.options.url);
+            this.ws = ws;
+            let challengeNonce;
+            let connectSent = false;
+            let connectTimer;
+            const sendConnect = (nonce) => {
+                if (connectSent)
+                    return;
+                connectSent = true;
+                const signedAt = Date.now();
+                const authToken = this.options.token ?? storedAuth?.token ?? undefined;
+                const authPayload = buildDeviceAuthPayload({
+                    deviceId: identity.deviceId,
+                    clientId: CLIENT_ID,
+                    clientMode: CLIENT_MODE,
+                    role: ROLE,
+                    scopes: SCOPES,
+                    signedAtMs: signedAt,
+                    token: authToken ?? null,
+                    nonce,
+                });
+                const signature = signDevicePayload(identity.privateKeyPem, authPayload);
+                const connectParams = {
+                    minProtocol: PROTOCOL_VERSION,
+                    maxProtocol: PROTOCOL_VERSION,
+                    client: {
+                        id: CLIENT_ID,
+                        version: '0.3.0',
+                        platform: process.platform,
+                        mode: CLIENT_MODE,
+                    },
+                    role: ROLE,
+                    scopes: SCOPES,
+                    device: {
+                        id: identity.deviceId,
+                        publicKey: publicKeyRawBase64Url(identity.publicKeyPem),
+                        signature,
+                        signedAt: signedAt,
+                        ...(nonce ? { nonce } : {}),
+                    },
+                };
+                // Add auth if available
+                const auth = {};
+                if (authToken)
+                    auth.token = authToken;
+                if (this.options.password)
+                    auth.password = this.options.password;
+                if (Object.keys(auth).length > 0) {
+                    connectParams.auth = auth;
+                }
+                const reqId = randomUUID();
+                const frame = {
+                    type: 'req',
+                    id: reqId,
+                    method: 'connect',
+                    params: connectParams,
+                };
+                ws.send(JSON.stringify(frame));
+                // Wait for connect response
+                const timer = setTimeout(() => {
+                    this.pending.delete(reqId);
+                    reject(new Error('Gateway connect handshake timed out'));
+                }, this.timeoutMs);
+                this.pending.set(reqId, {
+                    resolve: (payload) => {
+                        this.connected = true;
+                        // Store device token if returned
+                        const p = payload;
+                        const authResult = p?.auth;
+                        if (authResult?.deviceToken) {
+                            storeDeviceAuthToken({
+                                deviceId: identity.deviceId,
+                                role: ROLE,
+                                token: authResult.deviceToken,
+                                scopes: SCOPES,
+                                env: this.options.env,
+                            });
+                        }
+                        resolve();
+                    },
+                    reject,
+                    timer,
+                });
+            };
+            ws.on('open', () => {
+                // Queue connect with 750ms delay — allows challenge to arrive first
+                connectTimer = setTimeout(() => sendConnect(), 750);
+            });
+            ws.on('message', (data) => {
+                let frame;
+                try {
+                    frame = JSON.parse(data.toString());
+                }
+                catch {
+                    return;
+                }
+                // Handle connect.challenge event
+                if (frame.type === 'event' &&
+                    frame.event === 'connect.challenge') {
+                    const payload = frame.payload;
+                    challengeNonce = payload.nonce;
+                    clearTimeout(connectTimer);
+                    sendConnect(challengeNonce);
+                    return;
+                }
+                // Handle response frames
+                if (frame.type === 'res') {
+                    const id = frame.id;
+                    const pending = this.pending.get(id);
+                    if (!pending)
+                        return;
+                    clearTimeout(pending.timer);
+                    this.pending.delete(id);
+                    if (frame.ok) {
+                        pending.resolve(frame.payload);
+                    }
+                    else {
+                        const err = frame.error;
+                        pending.reject(new Error(`Gateway error: ${err?.code ?? 'unknown'} — ${err?.message ?? 'no message'}`));
+                    }
+                }
+            });
+            ws.on('error', (err) => {
+                reject(new Error(`Gateway connection failed: ${err.message}`));
+            });
+            ws.on('close', () => {
+                this.connected = false;
+                for (const [id, pending] of this.pending) {
+                    clearTimeout(pending.timer);
+                    pending.reject(new Error('Gateway connection closed'));
+                    this.pending.delete(id);
+                }
+            });
+        });
+    }
+    async call(method, params) {
+        if (!this.ws || !this.connected) {
+            throw new Error('Gateway not connected. Call connect() first.');
+        }
+        const id = randomUUID();
+        const frame = { type: 'req', id, method, params: params ?? {} };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`Gateway call "${method}" timed out`));
+            }, this.timeoutMs);
+            this.pending.set(id, {
+                resolve: resolve,
+                reject,
+                timer,
+            });
+            this.ws.send(JSON.stringify(frame));
+        });
+    }
+    close() {
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+            this.connected = false;
+        }
+    }
+    async cronAdd(params) {
+        return this.call('cron.add', params);
+    }
+    async cronRemove(id) {
+        await this.call('cron.remove', { id });
+    }
+    async cronUpdate(id, patch) {
+        await this.call('cron.update', { id, patch });
+    }
+    async cronList(options) {
+        const result = await this.call('cron.list', options ?? {});
+        return result.jobs ?? [];
+    }
+}
+//# sourceMappingURL=gateway-client.js.map

package/dist/core/gateway-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-client.js","sourceRoot":"","sources":["../../src/core/gateway-client.ts"],"names":[],"mappings":"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"}

package/dist/core/log-reader.d.ts

@@ -0,0 +1,28 @@
+export interface LogEntry {
+    timestamp?: string;
+    agentId: string;
+    file: string;
+    line: string;
+}
+export interface LogDiscoveryResult {
+    agentId: string;
+    sessionDir: string;
+    logFiles: string[];
+}
+/**
+ * Discover log files (session transcripts) for an agent.
+ * OpenClaw stores sessions at $STATE_DIR/agents/{agentId}/sessions/*.jsonl
+ */
+export declare function discoverLogs(agentId: string, env?: NodeJS.ProcessEnv): Promise<LogDiscoveryResult | null>;
+/**
+ * Read the last N lines from a log file.
+ */
+export declare function readLogTail(filePath: string, lines: number): Promise<string[]>;
+/**
+ * Read logs for an agent, returning the most recent entries.
+ */
+export declare function readAgentLogs(agentId: string, options?: {
+    lines?: number;
+    env?: NodeJS.ProcessEnv;
+}): Promise<LogEntry[]>;
+//# sourceMappingURL=log-reader.d.ts.map

package/dist/core/log-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-reader.d.ts","sourceRoot":"","sources":["../../src/core/log-reader.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GACtB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAepC;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,EAAE,CAAC,CAQnB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GACxD,OAAO,CAAC,QAAQ,EAAE,CAAC,CA8BrB"}

package/dist/core/log-reader.js

@@ -0,0 +1,69 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { resolveStateDir } from './openclaw-paths.js';
+/**
+ * Discover log files (session transcripts) for an agent.
+ * OpenClaw stores sessions at $STATE_DIR/agents/{agentId}/sessions/*.jsonl
+ */
+export async function discoverLogs(agentId, env) {
+    const stateDir = resolveStateDir(env);
+    const sessionDir = join(stateDir, 'agents', agentId, 'sessions');
+    if (!existsSync(sessionDir))
+        return null;
+    try {
+        const entries = await readdir(sessionDir);
+        const logFiles = entries
+            .filter((e) => e.endsWith('.jsonl'))
+            .sort();
+        return { agentId, sessionDir, logFiles };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read the last N lines from a log file.
+ */
+export async function readLogTail(filePath, lines) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        const allLines = content.split('\n').filter((l) => l.trim().length > 0);
+        return allLines.slice(-lines);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Read logs for an agent, returning the most recent entries.
+ */
+export async function readAgentLogs(agentId, options = {}) {
+    const maxLines = options.lines ?? 50;
+    const discovery = await discoverLogs(agentId, options.env);
+    if (!discovery || discovery.logFiles.length === 0)
+        return [];
+    const entries = [];
+    // Read from most recent files first
+    const sortedFiles = [...discovery.logFiles].reverse();
+    for (const file of sortedFiles) {
+        if (entries.length >= maxLines)
+            break;
+        const filePath = join(discovery.sessionDir, file);
+        const remaining = maxLines - entries.length;
+        const lines = await readLogTail(filePath, remaining);
+        for (const line of lines) {
+            let timestamp;
+            try {
+                const parsed = JSON.parse(line);
+                timestamp = parsed.ts ?? parsed.timestamp ?? parsed.createdAt;
+            }
+            catch {
+                // Not valid JSON — use raw line
+            }
+            entries.push({ timestamp, agentId, file, line });
+        }
+    }
+    return entries.reverse();
+}
+//# sourceMappingURL=log-reader.js.map

package/dist/core/log-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-reader.js","sourceRoot":"","sources":["../../src/core/log-reader.ts"],"names":[],"mappings":"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"}

package/dist/core/migration-planner.d.ts

@@ -0,0 +1,37 @@
+import type { FormationState, OpenClawBinding, CronJobState } from '../types/state.js';
+import type { ReefManifest, CronJob as ManifestCron } from '../types/manifest.js';
+export interface AgentChange {
+    slug: string;
+    agentId: string;
+    type: 'add' | 'remove' | 'update' | 'unchanged';
+    changedFiles?: string[];
+}
+export interface BindingChange {
+    binding: OpenClawBinding;
+    type: 'add' | 'remove';
+}
+export interface CronChange {
+    type: 'add' | 'remove' | 'update';
+    name: string;
+    agentSlug: string;
+    oldCron?: CronJobState;
+    newCron?: ManifestCron;
+}
+export interface A2aChange {
+    type: 'add' | 'remove' | 'reapply';
+    from: string;
+    to: string;
+}
+export interface MigrationPlan {
+    agents: AgentChange[];
+    bindings: BindingChange[];
+    cron: CronChange[];
+    a2a: A2aChange[];
+    versionChange: {
+        from: string;
+        to: string;
+    } | null;
+    isEmpty: boolean;
+}
+export declare function computeMigrationPlan(state: FormationState, manifest: ReefManifest, namespace: string, idMap: Map<string, string>, newFileHashes: Record<string, string>): MigrationPlan;
+//# sourceMappingURL=migration-planner.d.ts.map

package/dist/core/migration-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-planner.d.ts","sourceRoot":"","sources":["../../src/core/migration-planner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAElF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IAChD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,GAAG,EAAE,SAAS,EAAE,CAAC;IACjB,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,aAAa,CAyKf"}

package/dist/core/migration-planner.js

@@ -0,0 +1,160 @@
+import { bindingsEqual } from './config-patcher.js';
+export function computeMigrationPlan(state, manifest, namespace, idMap, newFileHashes) {
+    const agents = [];
+    const bindings = [];
+    const cron = [];
+    const a2a = [];
+    const oldSlugs = new Set(Object.keys(state.agents));
+    const newSlugs = new Set(Object.keys(manifest.agents));
+    // Agent changes
+    for (const slug of newSlugs) {
+        const agentId = idMap.get(slug);
+        if (!oldSlugs.has(slug)) {
+            agents.push({ slug, agentId, type: 'add' });
+        }
+        else {
+            // Check for file changes
+            const changedFiles = [];
+            for (const [key, newHash] of Object.entries(newFileHashes)) {
+                if (!key.startsWith(`${agentId}:`))
+                    continue;
+                const relativePath = key.slice(agentId.length + 1);
+                const oldHash = state.fileHashes[key];
+                if (oldHash !== newHash) {
+                    changedFiles.push(relativePath);
+                }
+            }
+            // Check for removed files
+            for (const key of Object.keys(state.fileHashes)) {
+                if (!key.startsWith(`${agentId}:`))
+                    continue;
+                if (!(key in newFileHashes)) {
+                    const relativePath = key.slice(agentId.length + 1);
+                    changedFiles.push(relativePath);
+                }
+            }
+            if (changedFiles.length > 0) {
+                agents.push({ slug, agentId, type: 'update', changedFiles });
+            }
+            else {
+                agents.push({ slug, agentId, type: 'unchanged' });
+            }
+        }
+    }
+    for (const slug of oldSlugs) {
+        if (!newSlugs.has(slug)) {
+            const agentId = state.agents[slug].id;
+            agents.push({ slug, agentId, type: 'remove' });
+        }
+    }
+    // Binding changes
+    const newBindings = [];
+    for (const binding of manifest.bindings ?? []) {
+        const resolvedAgentId = idMap.get(binding.agent);
+        if (!resolvedAgentId)
+            continue;
+        newBindings.push({
+            agentId: resolvedAgentId,
+            match: { channel: binding.channel },
+        });
+    }
+    // Find added bindings
+    for (const newBinding of newBindings) {
+        const found = state.bindings.some((b) => bindingsEqual(b, newBinding));
+        if (!found) {
+            bindings.push({ binding: newBinding, type: 'add' });
+        }
+    }
+    // Find removed bindings
+    for (const oldBinding of state.bindings) {
+        const found = newBindings.some((b) => bindingsEqual(b, oldBinding));
+        if (!found) {
+            bindings.push({ binding: oldBinding, type: 'remove' });
+        }
+    }
+    // Cron changes
+    const oldCronByName = new Map();
+    for (const job of state.cronJobs) {
+        oldCronByName.set(job.name, job);
+    }
+    const newCronNames = new Set();
+    for (const [i, cronEntry] of (manifest.cron ?? []).entries()) {
+        const jobName = `reef:${namespace}:${cronEntry.agent}-${i}`;
+        newCronNames.add(jobName);
+        const old = oldCronByName.get(jobName);
+        if (!old) {
+            cron.push({
+                type: 'add',
+                name: jobName,
+                agentSlug: cronEntry.agent,
+                newCron: cronEntry,
+            });
+        }
+        else {
+            // Check for updates (only if state has schedule/prompt fields)
+            const scheduleChanged = old.schedule && old.schedule !== cronEntry.schedule;
+            const promptChanged = old.prompt && old.prompt !== cronEntry.prompt;
+            const timezoneChanged = old.timezone !== cronEntry.timezone;
+            if (scheduleChanged || promptChanged || timezoneChanged) {
+                cron.push({
+                    type: 'update',
+                    name: jobName,
+                    agentSlug: cronEntry.agent,
+                    oldCron: old,
+                    newCron: cronEntry,
+                });
+            }
+        }
+    }
+    // Find removed cron jobs
+    for (const job of state.cronJobs) {
+        if (!newCronNames.has(job.name)) {
+            cron.push({
+                type: 'remove',
+                name: job.name,
+                agentSlug: job.agentSlug,
+                oldCron: job,
+            });
+        }
+    }
+    // A2a changes
+    const newEdges = manifest.agentToAgent ?? {};
+    const oldEdges = state.agentToAgentEdges;
+    if (oldEdges === undefined) {
+        // v0.2.0 state — can't diff, reapply all
+        for (const [from, targets] of Object.entries(newEdges)) {
+            for (const to of targets) {
+                a2a.push({ type: 'reapply', from, to });
+            }
+        }
+    }
+    else {
+        // Find added edges
+        for (const [from, targets] of Object.entries(newEdges)) {
+            for (const to of targets) {
+                if (!oldEdges[from]?.includes(to)) {
+                    a2a.push({ type: 'add', from, to });
+                }
+            }
+        }
+        // Find removed edges
+        for (const [from, targets] of Object.entries(oldEdges)) {
+            for (const to of targets) {
+                if (!newEdges[from]?.includes(to)) {
+                    a2a.push({ type: 'remove', from, to });
+                }
+            }
+        }
+    }
+    // Version change
+    const versionChange = state.version !== manifest.version
+        ? { from: state.version, to: manifest.version }
+        : null;
+    const isEmpty = agents.every((a) => a.type === 'unchanged') &&
+        bindings.length === 0 &&
+        cron.length === 0 &&
+        a2a.length === 0 &&
+        !versionChange;
+    return { agents, bindings, cron, a2a, versionChange, isEmpty };
+}
+//# sourceMappingURL=migration-planner.js.map

package/dist/core/migration-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-planner.js","sourceRoot":"","sources":["../../src/core/migration-planner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAuCpD,MAAM,UAAU,oBAAoB,CAClC,KAAqB,EACrB,QAAsB,EACtB,SAAiB,EACjB,KAA0B,EAC1B,aAAqC;IAErC,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,MAAM,IAAI,GAAiB,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAgB,EAAE,CAAC;IAE5B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAEvD,gBAAgB;IAChB,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,yBAAyB;YACzB,MAAM,YAAY,GAAa,EAAE,CAAC;YAClC,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC3D,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,CAAC;oBAAE,SAAS;gBAC7C,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACnD,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;gBACtC,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;oBACxB,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;YACD,0BAA0B;YAC1B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;gBAChD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,CAAC;oBAAE,SAAS;gBAC7C,IAAI,CAAC,CAAC,GAAG,IAAI,aAAa,CAAC,EAAE,CAAC;oBAC5B,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;oBACnD,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;YAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;YAC/D,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,MAAM,WAAW,GAAsB,EAAE,CAAC;IAC1C,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC9C,MAAM,eAAe,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,eAAe;YAAE,SAAS;QAC/B,WAAW,CAAC,IAAI,CAAC;YACf,OAAO,EAAE,eAAe;YACxB,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED,sBAAsB;IACtB,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,eAAe;IACf,MAAM,aAAa,GAAG,IAAI,GAAG,EAAwB,CAAC;IACtD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,KAAK,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC7D,MAAM,OAAO,GAAG,QAAQ,SAAS,IAAI,SAAS,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QAC5D,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1B,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEvC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,SAAS,CAAC,KAAK;gBAC1B,OAAO,EAAE,SAAS;aACnB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,+DAA+D;YAC/D,MAAM,eAAe,GAAG,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ,CAAC;YAC5E,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,CAAC;YACpE,MAAM,eAAe,GAAG,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ,CAAC;YAE5D,IAAI,eAAe,IAAI,aAAa,IAAI,eAAe,EAAE,CAAC;gBACxD,IAAI,CAAC,IAAI,CAAC;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,OAAO;oBACb,SAAS,EAAE,SAAS,CAAC,KAAK;oBAC1B,OAAO,EAAE,GAAG;oBACZ,OAAO,EAAE,SAAS;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,OAAO,EAAE,GAAG;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,cAAc;IACd,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,KAAK,CAAC,iBAAiB,CAAC;IAEzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,yCAAyC;QACzC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvD,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;gBACzB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,mBAAmB;QACnB,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvD,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;gBACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;oBAClC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC;QACH,CAAC;QACD,qBAAqB;QACrB,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvD,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;gBACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;oBAClC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;gBACzC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,iBAAiB;IACjB,MAAM,aAAa,GACjB,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO;QAChC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,OAAO,EAAE;QAC/C,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,OAAO,GACX,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;QAC3C,QAAQ,CAAC,MAAM,KAAK,CAAC;QACrB,IAAI,CAAC,MAAM,KAAK,CAAC;QACjB,GAAG,CAAC,MAAM,KAAK,CAAC;QAChB,CAAC,aAAa,CAAC;IAEjB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;AACjE,CAAC"}

package/dist/core/openclaw-paths.d.ts

@@ -0,0 +1,23 @@
+export declare function resolveHomeDir(env?: NodeJS.ProcessEnv): string;
+export declare function resolveStateDir(env?: NodeJS.ProcessEnv): string;
+export declare function resolveConfigPath(env?: NodeJS.ProcessEnv): string;
+export declare function resolveWorkspacePath(agentId: string, env?: NodeJS.ProcessEnv): string;
+export declare function resolveReefStateDir(env?: NodeJS.ProcessEnv): string;
+export declare function resolveGatewayUrl(config?: Record<string, unknown>, env?: NodeJS.ProcessEnv): string;
+export declare function validateAgentId(id: string): {
+    valid: boolean;
+    normalized: string;
+    error?: string;
+};
+export declare function validateAgentIds(slugs: string[], namespace: string): {
+    valid: boolean;
+    ids: Map<string, string>;
+    errors: string[];
+};
+/**
+ * Return paths under $STATE_DIR/agents/{agentId}/ that should be cleaned up
+ * on uninstall: sessions, agent state, qmd memory, and the parent directory.
+ * Order: children first, so the parent can be rmdir'd if empty.
+ */
+export declare function resolveAgentStatePaths(agentId: string, env?: NodeJS.ProcessEnv): string[];
+//# sourceMappingURL=openclaw-paths.d.ts.map

package/dist/core/openclaw-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-paths.d.ts","sourceRoot":"","sources":["../../src/core/openclaw-paths.ts"],"names":[],"mappings":"AAcA,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAU9D;AAED,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAe/D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAsCjE;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GACtB,MAAM,CAER;AAED,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAEnE;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GACtB,MAAM,CA4BR;AAyBD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CA4BA;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA2BhE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GACtB,MAAM,EAAE,CAQV"}