@yan162/changewayguard 6.8.25

package/dist/platform-client/index.js

@@ -0,0 +1,294 @@
+/**
+ * DashboardClient - SDK for communicating with OpenGuardrails Dashboard
+ *
+ * Handles:
+ * - Agent registration & heartbeat
+ * - Detection requests (routed through dashboard → core)
+ * - Usage & results queries
+ *
+ * Works with both local embedded dashboard and remote standalone dashboard.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { openclawHome } from "../agent/env.js";
+import { buildSignedAuthHeadersForUrl, withChangewayOpenPrefix } from "../agent/auth.js";
+export class DashboardClient {
+    config;
+    debugFileLog(msg) {
+        try {
+            const logPath = path.join(openclawHome, "logs", "moltguard-debug.log");
+            fs.appendFileSync(logPath, `[${new Date().toISOString()}] [DashboardClient] ${msg}\n`);
+        }
+        catch { /* ignore */ }
+    }
+    constructor(config) {
+        this.config = {
+            dashboardUrl: config.dashboardUrl.replace(/\/$/, ""),
+            sessionToken: config.sessionToken,
+            agentId: config.agentId ?? "",
+            timeoutMs: config.timeoutMs ?? 30000,
+        };
+    }
+    get agentId() {
+        return this.config.agentId;
+    }
+    async request(path, options = {}) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeoutMs);
+        const url = withChangewayOpenPrefix(`${this.config.dashboardUrl}${path}`);
+        const method = options.method ?? "GET";
+        try {
+            const headers = {
+                "Content-Type": "application/json",
+                ...buildSignedAuthHeadersForUrl({
+                    method,
+                    url,
+                    body: options.body,
+                    authorization: this.config.sessionToken ? `Bearer ${this.config.sessionToken}` : null,
+                }),
+                ...(options.headers || {}),
+            };
+            const res = await fetch(url, {
+                ...options,
+                headers,
+                signal: controller.signal,
+            });
+            if (!res.ok) {
+                const text = await res.text();
+                throw new Error(`Dashboard API ${res.status}: ${text}`);
+            }
+            return (await res.json());
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    // ─── Detection ──────────────────────────────────────────────────
+    /**
+     * Send messages for detection through the dashboard.
+     * Dashboard handles scanner config, policy evaluation, and routes to core.
+     */
+    async detect(req) {
+        return this.request("/api/detect", {
+            method: "POST",
+            body: JSON.stringify({
+                ...req,
+                agentId: req.agentId || this.config.agentId || undefined,
+            }),
+        });
+    }
+    // ─── Agent Management ───────────────────────────────────────────
+    /** Register this agent with the dashboard (upserts by name) */
+    async registerAgent(req) {
+        // Check if agent with same name already exists
+        try {
+            const list = await this.request("/api/agents");
+            if (list.success && list.data) {
+                const existing = list.data.find((a) => a.name === req.name);
+                if (existing) {
+                    this.config.agentId = existing.id;
+                    // Update status and metadata
+                    await this.request(`/api/agents/${existing.id}`, {
+                        method: "PUT",
+                        body: JSON.stringify({
+                            status: "active",
+                            ...(req.provider && { provider: req.provider }),
+                            ...(req.metadata && { metadata: req.metadata }),
+                        }),
+                    }).catch(() => { });
+                    return { success: true, data: { id: existing.id } };
+                }
+            }
+        }
+        catch {
+            // Fall through to create
+        }
+        const result = await this.request("/api/agents", {
+            method: "POST",
+            body: JSON.stringify(req),
+        });
+        if (result.success && result.data?.id) {
+            this.config.agentId = result.data.id;
+        }
+        return result;
+    }
+    /** Send heartbeat to indicate this agent is alive */
+    async heartbeat() {
+        if (!this.config.agentId)
+            return;
+        await this.request(`/api/agents/${this.config.agentId}/heartbeat`, {
+            method: "POST",
+        });
+    }
+    /** Upload full agent profile (workspace files, skills, cron jobs, etc.) */
+    async updateProfile(profile) {
+        if (!this.config.agentId)
+            return;
+        await this.request(`/api/agents/${this.config.agentId}`, {
+            method: "PUT",
+            body: JSON.stringify({ metadata: profile }),
+        });
+    }
+    /** Start periodic heartbeat */
+    startHeartbeat(intervalMs = 60_000) {
+        const timer = setInterval(() => {
+            this.heartbeat().catch(() => { });
+        }, intervalMs);
+        timer.unref();
+        return timer;
+    }
+    // ─── Tool Call Observations ─────────────────────────────────────
+    /** Report a tool call observation to the dashboard */
+    async reportToolCall(data) {
+        await this.request("/api/observations", {
+            method: "POST",
+            body: JSON.stringify(data),
+        });
+    }
+    /** Report a detection result to the dashboard */
+    async reportDetection(data) {
+        await this.request("/api/detections", {
+            method: "POST",
+            body: JSON.stringify(data),
+        });
+    }
+    /** Get observed permissions for an agent */
+    async getPermissions(agentId) {
+        const id = agentId || this.config.agentId;
+        if (!id)
+            return [];
+        const result = await this.request(`/api/observations/agents/${id}/permissions`);
+        return result.data ?? [];
+    }
+    // ─── Agentic Hours ──────────────────────────────────────────────
+    /** Report agentic hours data to the dashboard */
+    async reportAgenticHours(data) {
+        await this.request("/api/agentic-hours", {
+            method: "POST",
+            body: JSON.stringify(data),
+        });
+    }
+    // ─── Agentic Hours Accumulator ────────────────────────────────
+    hoursAccum = {
+        toolCallDurationMs: 0,
+        llmDurationMs: 0,
+        totalDurationMs: 0,
+        toolCallCount: 0,
+        llmCallCount: 0,
+        sessionCount: 0,
+        blockCount: 0,
+        riskEventCount: 0,
+    };
+    hoursFlushTimer = null;
+    /** Record a tool call duration for agentic hours */
+    recordToolCallDuration(durationMs, blocked = false) {
+        this.hoursAccum.toolCallDurationMs += durationMs;
+        this.hoursAccum.totalDurationMs += durationMs;
+        this.hoursAccum.toolCallCount += 1;
+        if (blocked)
+            this.hoursAccum.blockCount += 1;
+        this.ensureHoursFlush();
+    }
+    /** Record an LLM call duration for agentic hours */
+    recordLlmDuration(durationMs) {
+        this.hoursAccum.llmDurationMs += durationMs;
+        this.hoursAccum.totalDurationMs += durationMs;
+        this.hoursAccum.llmCallCount += 1;
+        this.ensureHoursFlush();
+    }
+    /** Record a session start */
+    recordSessionStart() {
+        this.hoursAccum.sessionCount += 1;
+        this.ensureHoursFlush();
+    }
+    /** Record a risk event */
+    recordRiskEvent() {
+        this.hoursAccum.riskEventCount += 1;
+        this.ensureHoursFlush();
+    }
+    ensureHoursFlush() {
+        if (this.hoursFlushTimer)
+            return;
+        this.hoursFlushTimer = setTimeout(() => {
+            this.flushAgenticHours();
+            this.hoursFlushTimer = null;
+        }, 60_000);
+        this.hoursFlushTimer.unref();
+    }
+    async flushAgenticHours() {
+        this.debugFileLog(`flushAgenticHours: agentId=${this.config.agentId} accum=${JSON.stringify(this.hoursAccum)}`);
+        if (!this.config.agentId) {
+            this.debugFileLog("flushAgenticHours: no agentId, skipping");
+            return;
+        }
+        const accum = { ...this.hoursAccum };
+        // Reset
+        this.hoursAccum = {
+            toolCallDurationMs: 0,
+            llmDurationMs: 0,
+            totalDurationMs: 0,
+            toolCallCount: 0,
+            llmCallCount: 0,
+            sessionCount: 0,
+            blockCount: 0,
+            riskEventCount: 0,
+        };
+        // Only flush if there's data
+        const hasData = accum.totalDurationMs > 0 ||
+            accum.toolCallCount > 0 ||
+            accum.llmCallCount > 0 ||
+            accum.sessionCount > 0;
+        if (!hasData)
+            return;
+        try {
+            this.debugFileLog(`flushAgenticHours: POSTing to dashboard: ${JSON.stringify(accum)}`);
+            await this.reportAgenticHours({
+                agentId: this.config.agentId,
+                ...accum,
+            });
+            this.debugFileLog(`flushAgenticHours: POST success`);
+        }
+        catch (err) {
+            this.debugFileLog(`flushAgenticHours: POST FAILED: ${err}`);
+            // Re-add on failure
+            this.hoursAccum.toolCallDurationMs += accum.toolCallDurationMs;
+            this.hoursAccum.llmDurationMs += accum.llmDurationMs;
+            this.hoursAccum.totalDurationMs += accum.totalDurationMs;
+            this.hoursAccum.toolCallCount += accum.toolCallCount;
+            this.hoursAccum.llmCallCount += accum.llmCallCount;
+            this.hoursAccum.sessionCount += accum.sessionCount;
+            this.hoursAccum.blockCount += accum.blockCount;
+            this.hoursAccum.riskEventCount += accum.riskEventCount;
+        }
+    }
+    /** Flush pending agentic hours and clean up timers */
+    async stop() {
+        if (this.hoursFlushTimer) {
+            clearTimeout(this.hoursFlushTimer);
+            this.hoursFlushTimer = null;
+        }
+        await this.flushAgenticHours();
+    }
+    // ─── Health ───────────────────────────────────────────────────────
+    /** Check if dashboard is reachable */
+    async checkHealth() {
+        try {
+            const url = withChangewayOpenPrefix(`${this.config.dashboardUrl}/health`);
+            const res = await fetch(url, {
+                headers: buildSignedAuthHeadersForUrl({
+                    method: "GET",
+                    url,
+                    authorization: this.config.sessionToken ? `Bearer ${this.config.sessionToken}` : null,
+                }),
+            });
+            const json = (await res.json());
+            return json.status === "ok";
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// Keep PlatformClient as alias
+export { DashboardClient as PlatformClient };
+//# sourceMappingURL=index.js.map

package/dist/platform-client/index.js.map

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

package/dist/platform-client/types.d.ts

@@ -0,0 +1,109 @@
+/** Types for Dashboard API communication */
+export type DashboardDetectRequest = {
+    messages: unknown[];
+    format?: "openai" | "anthropic" | "gemini" | "raw";
+    role?: "system" | "user" | "assistant" | "tool";
+    agentId?: string;
+};
+export type DashboardDetectResponse = {
+    success: boolean;
+    data?: {
+        safe: boolean;
+        verdict: "safe" | "unsafe";
+        categories: string[];
+        sensitivity_score: number;
+        findings: Array<{
+            scanner: string;
+            name: string;
+            description: string;
+        }>;
+        latency_ms: number;
+        request_id: string;
+        policy_action?: "block" | "alert" | "log";
+    };
+    blocked?: boolean;
+    error?: string;
+};
+export type AgentRegisterRequest = {
+    name: string;
+    description?: string;
+    provider?: string;
+    metadata?: Record<string, unknown>;
+};
+export type DashboardClientConfig = {
+    /** Dashboard URL (local or remote) */
+    dashboardUrl: string;
+    /** Session token for dashboard auth */
+    sessionToken: string;
+    /** Agent ID (set after registration) */
+    agentId?: string;
+    /** Request timeout in ms */
+    timeoutMs?: number;
+};
+export type ToolCallObservationRequest = {
+    agentId: string;
+    sessionKey?: string;
+    toolName: string;
+    params?: Record<string, unknown>;
+    phase: "before" | "after";
+    result?: unknown;
+    error?: string;
+    durationMs?: number;
+    blocked?: boolean;
+    blockReason?: string;
+};
+export type AgentPermission = {
+    id: string;
+    agentId: string;
+    toolName: string;
+    category: string | null;
+    accessPattern: string | null;
+    targetsJson: string[];
+    callCount: number;
+    errorCount: number;
+    firstSeen: string;
+    lastSeen: string;
+};
+export type DetectionResultRequest = {
+    agentId: string;
+    sessionKey?: string;
+    toolName?: string;
+    safe: boolean;
+    categories: string[];
+    findings: Array<{
+        scanner: string;
+        name: string;
+        description?: string;
+        matchedText?: string;
+        confidence?: "high" | "medium" | "low";
+    }>;
+    sensitivityScore?: number;
+    latencyMs?: number;
+    /** Whether quota was exceeded (detection skipped) */
+    quotaExceeded?: boolean;
+    /** Quota info when exceeded */
+    quotaInfo?: {
+        used: number;
+        total: number;
+        resetAt?: string;
+    };
+    scanType?: "static" | "dynamic";
+    filePath?: string;
+    fileType?: "soul" | "agent" | "memory" | "task" | "skill" | "plugin" | "other";
+};
+export type AgenticHoursRequest = {
+    agentId: string;
+    date?: string;
+    toolCallDurationMs?: number;
+    llmDurationMs?: number;
+    totalDurationMs?: number;
+    toolCallCount?: number;
+    llmCallCount?: number;
+    sessionCount?: number;
+    blockCount?: number;
+    riskEventCount?: number;
+};
+export type PlatformDetectRequest = DashboardDetectRequest;
+export type PlatformDetectResponse = DashboardDetectResponse;
+export type PlatformClientConfig = DashboardClientConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/platform-client/types.d.ts.map

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

package/dist/platform-client/types.js

@@ -0,0 +1,3 @@
+/** Types for Dashboard API communication */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/platform-client/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../platform-client/types.ts"],"names":[],"mappings":"AAAA,4CAA4C"}

package/dist/workspace-agents-guide.d.ts

@@ -0,0 +1,22 @@
+export declare const AGENTS_GUIDE_MARKER = "<!-- changewayguard:agents-guide:v1 -->";
+export type EnsureWorkspaceAgentsGuideOptions = {
+    openclawHomeDir?: string;
+    workspaceDir?: string;
+    guideFilePath?: string;
+    marker?: string;
+};
+export type EnsureWorkspaceAgentsGuideReason = "created" | "appended" | "marker_exists" | "guide_missing" | "guide_empty" | "workspace_missing" | "empty_file_detected" | "error";
+export type EnsureWorkspaceAgentsGuideResult = {
+    workspaceDir: string;
+    agentsPath: string;
+    updated: boolean;
+    created: boolean;
+    appended: boolean;
+    reason: EnsureWorkspaceAgentsGuideReason;
+    error?: unknown;
+};
+export declare function resolveGuideFilePath(explicitPath?: string): string | null;
+export declare function ensureAgentsGuideForFile(agentsPath: string, options?: Omit<EnsureWorkspaceAgentsGuideOptions, "openclawHomeDir" | "workspaceDir">): EnsureWorkspaceAgentsGuideResult;
+export declare function ensureAgentsGuideForWorkspace(workspaceDir: string, options?: Omit<EnsureWorkspaceAgentsGuideOptions, "openclawHomeDir" | "workspaceDir">): EnsureWorkspaceAgentsGuideResult;
+export declare function ensureWorkspaceAgentsGuide(options?: EnsureWorkspaceAgentsGuideOptions): EnsureWorkspaceAgentsGuideResult;
+//# sourceMappingURL=workspace-agents-guide.d.ts.map

package/dist/workspace-agents-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-agents-guide.d.ts","sourceRoot":"","sources":["../workspace-agents-guide.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,mBAAmB,4CAA4C,CAAC;AAE7E,MAAM,MAAM,iCAAiC,GAAG;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GACxC,SAAS,GACT,UAAU,GACV,eAAe,GACf,eAAe,GACf,aAAa,GACb,mBAAmB,GACnB,qBAAqB,GACrB,OAAO,CAAC;AAEZ,MAAM,MAAM,gCAAgC,GAAG;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,gCAAgC,CAAC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AA0BF,wBAAgB,oBAAoB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBzE;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,IAAI,CAAC,iCAAiC,EAAE,iBAAiB,GAAG,cAAc,CAAM,GACxF,gCAAgC,CAuClC;AAED,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,IAAI,CAAC,iCAAiC,EAAE,iBAAiB,GAAG,cAAc,CAAM,GACxF,gCAAgC,CAElC;AAED,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,iCAAsC,GAC9C,gCAAgC,CAYlC"}

package/dist/workspace-agents-guide.js

@@ -0,0 +1,92 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { openclawHome } from "./agent/env.js";
+const GUIDE_FILE_NAMES = [
+    "OpenClaw-linux:Mac-Guide-zh.md",
+    "OpenClaw-linux_Mac-Guide-zh.md",
+];
+export const AGENTS_GUIDE_MARKER = "<!-- changewayguard:agents-guide:v1 -->";
+function buildResult(workspaceDir, agentsPath, reason, error) {
+    return {
+        workspaceDir,
+        agentsPath,
+        updated: reason === "created" || reason === "appended",
+        created: reason === "created",
+        appended: reason === "appended",
+        reason,
+        ...(error !== undefined ? { error } : {}),
+    };
+}
+function renderGuideContent(rawGuideContent, marker) {
+    const trimmed = rawGuideContent.trim();
+    if (!trimmed)
+        return "";
+    if (trimmed.includes(marker))
+        return `${trimmed}\n`;
+    return `${marker}\n${trimmed}\n`;
+}
+export function resolveGuideFilePath(explicitPath) {
+    if (explicitPath) {
+        return explicitPath;
+    }
+    const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+    const candidates = GUIDE_FILE_NAMES.flatMap((guideFileName) => [
+        path.join(moduleDir, guideFileName),
+        path.join(moduleDir, "..", guideFileName),
+    ]);
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+export function ensureAgentsGuideForFile(agentsPath, options = {}) {
+    const workspaceDir = path.dirname(agentsPath);
+    const marker = options.marker ?? AGENTS_GUIDE_MARKER;
+    try {
+        const guidePath = resolveGuideFilePath(options.guideFilePath);
+        if (!guidePath || !fs.existsSync(guidePath)) {
+            return buildResult(workspaceDir, agentsPath, "guide_missing");
+        }
+        const guideContent = renderGuideContent(fs.readFileSync(guidePath, "utf-8"), marker);
+        if (!guideContent) {
+            return buildResult(workspaceDir, agentsPath, "guide_empty");
+        }
+        const agentsExists = fs.existsSync(agentsPath);
+        const existing = agentsExists ? fs.readFileSync(agentsPath, "utf-8") : null;
+        if (existing?.includes(marker)) {
+            return buildResult(workspaceDir, agentsPath, "marker_exists");
+        }
+        fs.mkdirSync(workspaceDir, { recursive: true });
+        if (!agentsExists) {
+            fs.writeFileSync(agentsPath, guideContent, "utf-8");
+            return buildResult(workspaceDir, agentsPath, "created");
+        }
+        if (existing !== null && existing.trim().length === 0) {
+            return buildResult(workspaceDir, agentsPath, "empty_file_detected");
+        }
+        const separator = existing?.endsWith("\n") ? "\n" : "\n\n";
+        fs.appendFileSync(agentsPath, `${separator}${guideContent}`, "utf-8");
+        return buildResult(workspaceDir, agentsPath, "appended");
+    }
+    catch (error) {
+        return buildResult(workspaceDir, agentsPath, "error", error);
+    }
+}
+export function ensureAgentsGuideForWorkspace(workspaceDir, options = {}) {
+    return ensureAgentsGuideForFile(path.join(workspaceDir, "AGENTS.md"), options);
+}
+export function ensureWorkspaceAgentsGuide(options = {}) {
+    const workspaceDir = options.workspaceDir
+        ?? path.join(options.openclawHomeDir ?? openclawHome, "workspace");
+    if (!workspaceDir) {
+        return buildResult("", "", "workspace_missing");
+    }
+    return ensureAgentsGuideForWorkspace(workspaceDir, {
+        guideFilePath: options.guideFilePath,
+        marker: options.marker,
+    });
+}
+//# sourceMappingURL=workspace-agents-guide.js.map

package/dist/workspace-agents-guide.js.map

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

package/dist/workspace-agents-sync.d.ts

@@ -0,0 +1,24 @@
+import { type Logger } from "./agent/types.js";
+import { type EnsureWorkspaceAgentsGuideResult } from "./workspace-agents-guide.js";
+import { type DiscoveredWorkspace } from "./workspace-discovery.js";
+export type WorkspaceAgentsSyncOptions = {
+    openclawHomeDir?: string;
+    guideFilePath?: string;
+    marker?: string;
+    logger?: Logger;
+};
+export type WorkspaceAgentsSyncEntry = {
+    workspace: DiscoveredWorkspace;
+    result: EnsureWorkspaceAgentsGuideResult;
+};
+export type WorkspaceAgentsSyncSummary = {
+    totalWorkspaces: number;
+    updatedCount: number;
+    createdCount: number;
+    appendedCount: number;
+    skippedCount: number;
+    errorCount: number;
+    entries: WorkspaceAgentsSyncEntry[];
+};
+export declare function syncAllWorkspaceAgentsGuides(options?: WorkspaceAgentsSyncOptions): WorkspaceAgentsSyncSummary;
+//# sourceMappingURL=workspace-agents-sync.d.ts.map

package/dist/workspace-agents-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-agents-sync.d.ts","sourceRoot":"","sources":["../workspace-agents-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAGL,KAAK,gCAAgC,EACtC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAA2B,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE7F,MAAM,MAAM,0BAA0B,GAAG;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,mBAAmB,CAAC;IAC/B,MAAM,EAAE,gCAAgC,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,wBAAwB,EAAE,CAAC;CACrC,CAAC;AASF,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,0BAA+B,GACvC,0BAA0B,CAuC5B"}

package/dist/workspace-agents-sync.js

@@ -0,0 +1,41 @@
+import { ensureAgentsGuideForWorkspace, } from "./workspace-agents-guide.js";
+import { collectAllWorkspaceDirs } from "./workspace-discovery.js";
+function toEnsureOptions(options) {
+    return {
+        guideFilePath: options.guideFilePath,
+        marker: options.marker,
+    };
+}
+export function syncAllWorkspaceAgentsGuides(options = {}) {
+    const entries = [];
+    const workspaces = collectAllWorkspaceDirs(options.openclawHomeDir);
+    const ensureOptions = toEnsureOptions(options);
+    for (const workspace of workspaces) {
+        const result = ensureAgentsGuideForWorkspace(workspace.workspaceDir, ensureOptions);
+        entries.push({ workspace, result });
+        if (result.reason === "error") {
+            options.logger?.warn(`Workspace AGENTS sync failed: ${result.workspaceDir} (${String(result.error)})`);
+            continue;
+        }
+        if (result.reason === "empty_file_detected") {
+            options.logger?.warn(`Workspace AGENTS sync skipped empty file: ${result.agentsPath}`);
+            continue;
+        }
+        if (result.updated) {
+            options.logger?.info(`Workspace AGENTS synced (${result.reason}): ${result.agentsPath}`);
+        }
+        else if (result.reason !== "marker_exists") {
+            options.logger?.debug?.(`Workspace AGENTS sync skipped (${result.reason}): ${result.agentsPath}`);
+        }
+    }
+    return {
+        totalWorkspaces: entries.length,
+        updatedCount: entries.filter((entry) => entry.result.updated).length,
+        createdCount: entries.filter((entry) => entry.result.created).length,
+        appendedCount: entries.filter((entry) => entry.result.appended).length,
+        skippedCount: entries.filter((entry) => !entry.result.updated && entry.result.reason !== "error").length,
+        errorCount: entries.filter((entry) => entry.result.reason === "error").length,
+        entries,
+    };
+}
+//# sourceMappingURL=workspace-agents-sync.js.map

package/dist/workspace-agents-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-agents-sync.js","sourceRoot":"","sources":["../workspace-agents-sync.ts"],"names":[],"mappings":"AACA,OAAO,EACL,6BAA6B,GAG9B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,uBAAuB,EAA4B,MAAM,0BAA0B,CAAC;AAwB7F,SAAS,eAAe,CAAC,OAAmC;IAC1D,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,UAAsC,EAAE;IAExC,MAAM,OAAO,GAA+B,EAAE,CAAC;IAC/C,MAAM,UAAU,GAAG,uBAAuB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACpE,MAAM,aAAa,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAE/C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;QACpF,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QAEpC,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC9B,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,iCAAiC,MAAM,CAAC,YAAY,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACvG,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,qBAAqB,EAAE,CAAC;YAC5C,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,6CAA6C,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YACvF,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,MAAM,EAAE,IAAI,CAClB,4BAA4B,MAAM,CAAC,MAAM,MAAM,MAAM,CAAC,UAAU,EAAE,CACnE,CAAC;QACJ,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;YAC7C,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,CACrB,kCAAkC,MAAM,CAAC,MAAM,MAAM,MAAM,CAAC,UAAU,EAAE,CACzE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,eAAe,EAAE,OAAO,CAAC,MAAM;QAC/B,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM;QACpE,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM;QACpE,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM;QACtE,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,MAAM;QACxG,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,MAAM;QAC7E,OAAO;KACR,CAAC;AACJ,CAAC"}