@aquaclawai/aquarium 1.0.0

package/dist/runtime/types.d.ts

@@ -0,0 +1,81 @@
+import type { Readable } from 'stream';
+export interface ExecResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export interface ExecOptions {
+    timeout?: number;
+    workDir?: string;
+}
+export interface InstanceSpec {
+    name: string;
+    image: string;
+    ports: Array<{
+        name: string;
+        containerPort: number;
+        protocol: 'tcp' | 'udp';
+    }>;
+    env: Record<string, string>;
+    secrets: Record<string, string>;
+    volumes: Array<{
+        name: string;
+        mountPath: string;
+        size: string;
+    }>;
+    resources: {
+        requests: {
+            cpu: string;
+            memory: string;
+        };
+        limits: {
+            cpu: string;
+            memory: string;
+        };
+    };
+    securityContext?: {
+        runAsUser?: number;
+        runAsGroup?: number;
+        fsGroup?: number;
+    };
+    healthCheck?: {
+        type: 'http' | 'tcp';
+        port: number;
+        path?: string;
+        initialDelaySeconds: number;
+        periodSeconds: number;
+    };
+    labels: Record<string, string>;
+}
+export interface StartResult {
+    runtimeId: string;
+    endpoints: Record<string, string>;
+}
+export interface RuntimeStatus {
+    running: boolean;
+    phase: 'running' | 'stopped' | 'starting' | 'error' | 'not_found';
+    startedAt?: string;
+    message?: string;
+}
+export interface RuntimeEngine {
+    readonly name: 'docker' | 'kubernetes';
+    isAvailable(): Promise<boolean>;
+    start(spec: InstanceSpec): Promise<StartResult>;
+    stop(runtimeId: string): Promise<void>;
+    restart(spec: InstanceSpec, runtimeId: string): Promise<StartResult>;
+    delete(runtimeId: string): Promise<void>;
+    purge(runtimeId: string): Promise<void>;
+    getStatus(runtimeId: string): Promise<RuntimeStatus>;
+    streamLogs(runtimeId: string, options?: {
+        follow?: boolean;
+        tailLines?: number;
+        timestamps?: boolean;
+    }): Promise<Readable>;
+    ensureLiteLLMConnected?(instanceId: string): Promise<void>;
+    cleanupOrphanNetworks?(): Promise<void>;
+    writeFiles?(containerName: string, basePath: string, files: Map<string, string>): Promise<void>;
+    listFiles?(runtimeId: string, dirPath: string): Promise<string[]>;
+    readFile?(runtimeId: string, filePath: string): Promise<string | null>;
+    exec?(runtimeId: string, command: string[], options?: ExecOptions): Promise<ExecResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime/types.d.ts.map

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

package/dist/runtime/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/runtime/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":""}

package/dist/server-core.d.ts

@@ -0,0 +1,26 @@
+import express from 'express';
+import type { Server as HttpServer } from 'node:http';
+import type { AuthPayload } from './middleware/auth.js';
+export interface CreateAppOptions {
+    /** Additional CSP domains for EE (e.g. Clerk). */
+    extraCspDomains?: {
+        scriptSrc?: string[];
+        connectSrc?: string[];
+        imgSrc?: string[];
+        frameSrc?: string[];
+    };
+    /** Token verifier for the WebSocket proxy. CE can pass a simple JWT verifier; EE passes verifyClerkToken. */
+    tokenVerifier?: (token: string) => Promise<AuthPayload | null> | AuthPayload | null;
+}
+export interface StartServerOptions {
+    /** Called after migrations complete (e.g. EE seeds LiteLLM models). */
+    onAfterMigrate?: () => Promise<void>;
+    /** Called just before the server starts listening (e.g. EE starts budget enforcer). */
+    onBeforeListen?: () => Promise<void>;
+}
+export declare function createApp(options?: CreateAppOptions): {
+    app: express.Application;
+    server: HttpServer;
+};
+export declare function startServer(server: HttpServer, options?: StartServerOptions): Promise<void>;
+//# sourceMappingURL=server-core.d.ts.map

package/dist/server-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-core.d.ts","sourceRoot":"","sources":["../src/server-core.ts"],"names":[],"mappings":"AAGA,OAAO,OAAO,MAAM,SAAS,CAAC;AAK9B,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AAwCtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,eAAe,CAAC,EAAE;QAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,6GAA6G;IAC7G,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,WAAW,GAAG,IAAI,CAAC;CACrF;AAED,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,uFAAuF;IACvF,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG;IAAE,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAyH1G;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CrG"}

package/dist/server-core.js

@@ -0,0 +1,184 @@
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import express from 'express';
+import cookieParser from 'cookie-parser';
+import helmet from 'helmet';
+import rateLimit from 'express-rate-limit';
+import { createServer } from 'node:http';
+import { config } from './config.js';
+import { db } from './db/index.js';
+import { setupWebSocket } from './ws/index.js';
+import { reconcileInstances } from './services/instance-manager.js';
+import { getRuntimeEngine } from './runtime/factory.js';
+import { startHealthMonitor } from './services/health-monitor.js';
+import { startGatewayEventRelay } from './services/gateway-event-relay.js';
+import { runDailySnapshots } from './services/snapshot-store.js';
+import { dynamicCors, dynamicGeneralLimiter, dynamicLoginLimiter, dynamicCredentialsLimiter, reloadDynamicMiddleware, } from './middleware/dynamic-middleware.js';
+import authRoutes from './routes/auth.js';
+import instanceRoutes from './routes/instances.js';
+import credentialRoutes from './routes/credentials.js';
+import agentTypeRoutes from './routes/agent-types.js';
+import rpcProxyRoutes from './routes/rpc-proxy.js';
+import oauthRoutes from './routes/oauth.js';
+import channelRoutes from './routes/channels.js';
+import adminRoutes from './routes/admin.js';
+import templateRoutes from './routes/templates.js';
+import userCredentialRoutes from './routes/user-credentials.js';
+import groupChatRoutes from './routes/group-chats.js';
+import metadataRoutes from './routes/metadata.js';
+import userRoutes from './routes/users.js';
+import notificationsRoutes from './routes/notifications.js';
+import skillRoutes from './routes/skills.js';
+import execApprovalRoutes from './routes/exec-approval.js';
+import securityRoutes from './routes/security.js';
+import dashboardRoutes from './routes/dashboard.js';
+import systemConfigRoutes from './routes/system-config.js';
+import snapshotRoutes from './routes/snapshots.js';
+import instanceFilesRoutes from './routes/instance-files.js';
+import uiProxyRoutes from './routes/ui-proxy.js';
+import { attachWebSocketProxy } from './routes/instance-proxy.js';
+import { getInstance } from './services/instance-manager.js';
+export function createApp(options = {}) {
+    const { extraCspDomains = {}, tokenVerifier } = options;
+    const app = express();
+    // Trust proxy headers from GKE ingress / load balancer
+    app.set('trust proxy', 1);
+    app.use(helmet({
+        contentSecurityPolicy: {
+            directives: {
+                defaultSrc: ["'self'"],
+                scriptSrc: ["'self'", "'unsafe-inline'", ...(extraCspDomains.scriptSrc ?? [])],
+                styleSrc: ["'self'", "'unsafe-inline'", "https://fonts.googleapis.com"],
+                imgSrc: ["'self'", "data:", "blob:", ...(extraCspDomains.imgSrc ?? [])],
+                connectSrc: ["'self'", "wss:", "ws:", ...(extraCspDomains.connectSrc ?? [])],
+                workerSrc: ["'self'", "blob:"],
+                fontSrc: ["'self'", "https://fonts.gstatic.com"],
+                objectSrc: ["'none'"],
+                frameAncestors: ["'self'"],
+                frameSrc: ["'self'", ...(extraCspDomains.frameSrc ?? [])],
+                baseUri: ["'self'"],
+                formAction: ["'self'"],
+            },
+        },
+    }));
+    app.use(dynamicCors);
+    app.use(cookieParser());
+    app.use(express.json({ limit: '10mb' }));
+    // Health check must be before any auth-guarded routers (e.g. securityRoutes on /api)
+    app.get('/api/health', (_req, res) => {
+        res.json({ ok: true, ts: Date.now() });
+    });
+    // §6.2 API rate limiting (disabled in development for E2E tests)
+    if (config.nodeEnv === 'production') {
+        app.use('/api/', rateLimit({
+            windowMs: 15 * 60 * 1000,
+            max: 300,
+            standardHeaders: true,
+            legacyHeaders: false,
+            validate: { trustProxy: false, xForwardedForHeader: false },
+        }));
+        app.use('/api/auth/login', rateLimit({
+            windowMs: 15 * 60 * 1000,
+            max: 100,
+            skipSuccessfulRequests: true,
+            standardHeaders: true,
+            legacyHeaders: false,
+            validate: { trustProxy: false, xForwardedForHeader: false },
+        }));
+        app.use('/api/credentials', rateLimit({
+            windowMs: 60 * 1000,
+            max: 30,
+            standardHeaders: true,
+            legacyHeaders: false,
+            validate: { trustProxy: false, xForwardedForHeader: false },
+        }));
+    }
+    // Dynamic rate limiters (admin-configurable) — also disabled in development for E2E tests
+    if (config.nodeEnv === 'production') {
+        app.use('/api/', dynamicGeneralLimiter);
+        app.use('/api/auth/login', dynamicLoginLimiter);
+        app.use('/api/credentials', dynamicCredentialsLimiter);
+    }
+    // Shared routes (both CE and EE)
+    app.use('/api/auth', authRoutes);
+    app.use('/api/instances', instanceRoutes);
+    app.use('/api/instances', credentialRoutes);
+    app.use('/api/instances', rpcProxyRoutes);
+    app.use('/api/agent-types', agentTypeRoutes);
+    app.use('/api/oauth', oauthRoutes);
+    app.use('/api/instances', channelRoutes);
+    app.use('/api/admin/config', systemConfigRoutes);
+    app.use('/api/admin', adminRoutes);
+    app.use('/api/templates', templateRoutes);
+    app.use('/api/credentials', userCredentialRoutes);
+    app.use('/api/group-chats', groupChatRoutes);
+    app.use('/api/metadata', metadataRoutes);
+    app.use('/api/users', userRoutes);
+    app.use('/api/notifications', notificationsRoutes);
+    app.use('/api/instances', skillRoutes);
+    app.use('/api/instances', execApprovalRoutes);
+    app.use('/api', securityRoutes);
+    app.use('/api/dashboard', dashboardRoutes);
+    app.use('/api/instances/:id/snapshots', snapshotRoutes);
+    app.use('/api/instances', instanceFilesRoutes);
+    app.use('/api/instances', uiProxyRoutes);
+    // Note: instanceProxyRoutes registered LAST under /api/instances (catch-all patterns)
+    // EE entry will register geoToolsRoutes before instanceProxyRoutes
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    // Try npm package path first (dist/web-dist/), then monorepo path (../../web/dist)
+    const webDistCandidates = [
+        join(__dirname, 'web-dist'), // npm package layout
+        join(__dirname, '../../web/dist'), // monorepo layout
+    ];
+    const webDistPath = webDistCandidates.find(p => existsSync(p));
+    if (webDistPath) {
+        app.use(express.static(webDistPath));
+        app.get('*', (req, res, next) => {
+            if (req.path.startsWith('/api') || req.path.startsWith('/ws'))
+                return next();
+            res.sendFile(join(webDistPath, 'index.html'));
+        });
+    }
+    const server = createServer(app);
+    setupWebSocket(server);
+    attachWebSocketProxy(server, (id, userId) => getInstance(id, userId), tokenVerifier ?? (async () => null));
+    return { app, server };
+}
+export async function startServer(server, options = {}) {
+    try {
+        const migrationDirs = [
+            fileURLToPath(new URL('./db/migrations', import.meta.url)),
+        ];
+        if (config.isEE) {
+            migrationDirs.push(fileURLToPath(new URL('./db/migrations/ee', import.meta.url)));
+        }
+        await db.migrate.latest({
+            directory: migrationDirs,
+            loadExtensions: [process.env.NODE_ENV === 'production' ? '.js' : '.ts'],
+        });
+        await options.onAfterMigrate?.();
+        await reloadDynamicMiddleware();
+        await reconcileInstances();
+        const engine = getRuntimeEngine(config.defaultDeploymentTarget);
+        if (engine.cleanupOrphanNetworks) {
+            await engine.cleanupOrphanNetworks();
+        }
+        startHealthMonitor();
+        startGatewayEventRelay();
+        setInterval(async () => {
+            console.log('[Scheduler] Running daily snapshots...');
+            const result = await runDailySnapshots();
+            console.log(`[Scheduler] Daily snapshots: ${result.created} created, ${result.failed} failed`);
+        }, 24 * 60 * 60 * 1000);
+        await options.onBeforeListen?.();
+        server.listen(config.port, () => {
+            console.log(`Server listening on port ${config.port}`);
+        });
+    }
+    catch (err) {
+        console.error('Failed to start server:', err);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=server-core.js.map

package/dist/server-core.js.map

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

package/dist/services/config-diff.d.ts

@@ -0,0 +1,6 @@
+import type { ConfigChangeSummary } from '@aquarium/shared';
+type ConfigObject = Record<string, unknown>;
+export declare function computeChangeSummary(prevConfig: ConfigObject | null, currConfig: ConfigObject | null): ConfigChangeSummary[];
+export declare function computeChangeCount(prevConfig: ConfigObject | null, currConfig: ConfigObject | null): number;
+export {};
+//# sourceMappingURL=config-diff.d.ts.map

package/dist/services/config-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-diff.d.ts","sourceRoot":"","sources":["../../src/services/config-diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5C,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,YAAY,GAAG,IAAI,EAC/B,UAAU,EAAE,YAAY,GAAG,IAAI,GAC9B,mBAAmB,EAAE,CA6CvB;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,YAAY,GAAG,IAAI,EAC/B,UAAU,EAAE,YAAY,GAAG,IAAI,GAC9B,MAAM,CAER"}

package/dist/services/config-diff.js

@@ -0,0 +1,85 @@
+import { CONFIG_FIELD_META } from './config-field-meta.js';
+export function computeChangeSummary(prevConfig, currConfig) {
+    const changes = [];
+    const prev = prevConfig ?? {};
+    const curr = currConfig ?? {};
+    for (const meta of CONFIG_FIELD_META) {
+        const { key, label, category, valueFormatter } = meta;
+        const prevValue = prev[key];
+        const currValue = curr[key];
+        const prevExists = prevValue !== undefined && prevValue !== null && prevValue !== '';
+        const currExists = currValue !== undefined && currValue !== null && currValue !== '';
+        if (!prevExists && currExists) {
+            changes.push({
+                field: key,
+                fieldLabel: label,
+                category,
+                changeType: 'added',
+                newValue: valueFormatter ? valueFormatter(currValue) : summarizeValue(currValue),
+                sizeDelta: computeSizeDelta(null, currValue),
+            });
+        }
+        else if (prevExists && !currExists) {
+            changes.push({
+                field: key,
+                fieldLabel: label,
+                category,
+                changeType: 'removed',
+                oldValue: valueFormatter ? valueFormatter(prevValue) : summarizeValue(prevValue),
+                sizeDelta: computeSizeDelta(prevValue, null),
+            });
+        }
+        else if (prevExists && currExists && !isEqual(prevValue, currValue)) {
+            changes.push({
+                field: key,
+                fieldLabel: label,
+                category,
+                changeType: 'modified',
+                oldValue: valueFormatter ? valueFormatter(prevValue) : summarizeValue(prevValue),
+                newValue: valueFormatter ? valueFormatter(currValue) : summarizeValue(currValue),
+                sizeDelta: computeSizeDelta(prevValue, currValue),
+            });
+        }
+    }
+    return changes;
+}
+export function computeChangeCount(prevConfig, currConfig) {
+    return computeChangeSummary(prevConfig, currConfig).length;
+}
+function summarizeValue(value) {
+    if (value === null || value === undefined)
+        return '（空）';
+    if (typeof value === 'string') {
+        if (value.length === 0)
+            return '（空）';
+        if (value.length <= 30)
+            return value;
+        return value.slice(0, 27) + '...';
+    }
+    if (typeof value === 'number')
+        return String(value);
+    if (typeof value === 'boolean')
+        return value ? '是' : '否';
+    if (Array.isArray(value))
+        return `${value.length} 项`;
+    if (typeof value === 'object')
+        return `${Object.keys(value).length} 个字段`;
+    return String(value);
+}
+function computeSizeDelta(oldVal, newVal) {
+    const oldSize = oldVal != null ? Buffer.byteLength(JSON.stringify(oldVal), 'utf8') : 0;
+    const newSize = newVal != null ? Buffer.byteLength(JSON.stringify(newVal), 'utf8') : 0;
+    return newSize - oldSize;
+}
+function isEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== typeof b)
+        return false;
+    if (a === null || b === null)
+        return a === b;
+    if (typeof a !== 'object')
+        return a === b;
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+//# sourceMappingURL=config-diff.js.map

package/dist/services/config-diff.js.map

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

package/dist/services/config-field-meta.d.ts

@@ -0,0 +1,22 @@
+import type { ConfigChangeSummary } from '@aquarium/shared';
+export interface ConfigFieldMeta {
+    key: string;
+    label: string;
+    labelKey: string;
+    category: ConfigChangeSummary['category'];
+    valueFormatter?: (value: unknown) => string;
+}
+/**
+ * Registry of all tracked config fields for openclaw agent type.
+ * Maps config JSON keys to human-readable labels and categories.
+ */
+export declare const CONFIG_FIELD_META: ConfigFieldMeta[];
+/**
+ * Get field metadata by key
+ */
+export declare function getFieldMeta(key: string): ConfigFieldMeta | undefined;
+/**
+ * Get all tracked field keys
+ */
+export declare function getTrackedFieldKeys(): string[];
+//# sourceMappingURL=config-field-meta.d.ts.map

package/dist/services/config-field-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-field-meta.d.ts","sourceRoot":"","sources":["../../src/services/config-field-meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC1C,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;CAC7C;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAAe,EAoJ9C,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAErE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C"}

package/dist/services/config-field-meta.js

@@ -0,0 +1,177 @@
+/**
+ * Registry of all tracked config fields for openclaw agent type.
+ * Maps config JSON keys to human-readable labels and categories.
+ */
+export const CONFIG_FIELD_META = [
+    // ── Core Settings ──
+    {
+        key: 'defaultProvider',
+        label: 'Default Provider',
+        labelKey: 'configFields.defaultProvider',
+        category: 'core',
+    },
+    {
+        key: 'defaultModel',
+        label: 'Default Model',
+        labelKey: 'configFields.defaultModel',
+        category: 'core',
+    },
+    {
+        key: 'agentName',
+        label: 'Agent Name',
+        labelKey: 'configFields.agentName',
+        category: 'core',
+    },
+    {
+        key: 'temperature',
+        label: 'Temperature',
+        labelKey: 'configFields.temperature',
+        category: 'core',
+        valueFormatter: (v) => {
+            if (typeof v === 'number') {
+                if (v <= 0.3)
+                    return `工作模式 (${v})`;
+                if (v >= 0.7)
+                    return `生活模式 (${v})`;
+                return `平衡模式 (${v})`;
+            }
+            return String(v ?? '—');
+        },
+    },
+    {
+        key: 'customPrinciples',
+        label: 'Custom Principles',
+        labelKey: 'configFields.customPrinciples',
+        category: 'core',
+        valueFormatter: (v) => {
+            if (Array.isArray(v))
+                return `共 ${v.length} 条原则`;
+            return String(v ?? '—');
+        },
+    },
+    // ── Workspace Files ──
+    {
+        key: 'agentsmd',
+        label: 'AGENTS.md',
+        labelKey: 'configFields.agentsmd',
+        category: 'workspace',
+        valueFormatter: formatFileSize,
+    },
+    {
+        key: 'soulmd',
+        label: 'SOUL.md',
+        labelKey: 'configFields.soulmd',
+        category: 'workspace',
+        valueFormatter: formatFileSize,
+    },
+    {
+        key: 'identitymd',
+        label: 'IDENTITY.md',
+        labelKey: 'configFields.identitymd',
+        category: 'workspace',
+        valueFormatter: formatFileSize,
+    },
+    {
+        key: 'usermd',
+        label: 'USER.md',
+        labelKey: 'configFields.usermd',
+        category: 'workspace',
+        valueFormatter: formatFileSize,
+    },
+    {
+        key: 'toolsmd',
+        label: 'TOOLS.md',
+        labelKey: 'configFields.toolsmd',
+        category: 'workspace',
+        valueFormatter: formatFileSize,
+    },
+    {
+        key: 'bootstrapmd',
+        label: 'BOOTSTRAP.md',
+        labelKey: 'configFields.bootstrapmd',
+        category: 'workspace',
+        valueFormatter: formatFileSize,
+    },
+    {
+        key: 'heartbeatmd',
+        label: 'HEARTBEAT.md',
+        labelKey: 'configFields.heartbeatmd',
+        category: 'workspace',
+        valueFormatter: formatFileSize,
+    },
+    {
+        key: 'memorymd',
+        label: 'MEMORY.md',
+        labelKey: 'configFields.memorymd',
+        category: 'workspace',
+        valueFormatter: formatFileSize,
+    },
+    // ── Channels ──
+    {
+        key: 'enableWhatsApp',
+        label: 'WhatsApp',
+        labelKey: 'configFields.enableWhatsApp',
+        category: 'channel',
+        valueFormatter: (v) => (v ? '已启用' : '未启用'),
+    },
+    {
+        key: 'enableTelegram',
+        label: 'Telegram',
+        labelKey: 'configFields.enableTelegram',
+        category: 'channel',
+        valueFormatter: (v) => (v ? '已启用' : '未启用'),
+    },
+    // ── Tools ──
+    {
+        key: 'toolPermissions',
+        label: 'Tool Permissions',
+        labelKey: 'configFields.toolPermissions',
+        category: 'tool',
+        valueFormatter: (v) => {
+            if (typeof v === 'object' && v !== null) {
+                const count = Object.keys(v).length;
+                return `${count} 个工具权限`;
+            }
+            return String(v ?? '—');
+        },
+    },
+    // ── MCP ──
+    {
+        key: 'mcpServers',
+        label: 'MCP Servers',
+        labelKey: 'configFields.mcpServers',
+        category: 'mcp',
+        valueFormatter: (v) => {
+            if (typeof v === 'object' && v !== null) {
+                const count = Object.keys(v).length;
+                return `${count} 个 MCP 服务`;
+            }
+            return String(v ?? '—');
+        },
+    },
+];
+/**
+ * Get field metadata by key
+ */
+export function getFieldMeta(key) {
+    return CONFIG_FIELD_META.find((f) => f.key === key);
+}
+/**
+ * Get all tracked field keys
+ */
+export function getTrackedFieldKeys() {
+    return CONFIG_FIELD_META.map((f) => f.key);
+}
+// ── Helpers ──
+function formatFileSize(v) {
+    if (typeof v === 'string') {
+        const bytes = Buffer.byteLength(v, 'utf8');
+        if (bytes === 0)
+            return '（空）';
+        if (bytes < 1024)
+            return `${bytes} B`;
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    }
+    return String(v ?? '（空）');
+}
+//# sourceMappingURL=config-field-meta.js.map

package/dist/services/config-field-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-field-meta.js","sourceRoot":"","sources":["../../src/services/config-field-meta.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,sBAAsB;IACtB;QACE,GAAG,EAAE,iBAAiB;QACtB,KAAK,EAAE,kBAAkB;QACzB,QAAQ,EAAE,8BAA8B;QACxC,QAAQ,EAAE,MAAM;KACjB;IACD;QACE,GAAG,EAAE,cAAc;QACnB,KAAK,EAAE,eAAe;QACtB,QAAQ,EAAE,2BAA2B;QACrC,QAAQ,EAAE,MAAM;KACjB;IACD;QACE,GAAG,EAAE,WAAW;QAChB,KAAK,EAAE,YAAY;QACnB,QAAQ,EAAE,wBAAwB;QAClC,QAAQ,EAAE,MAAM;KACjB;IACD;QACE,GAAG,EAAE,aAAa;QAClB,KAAK,EAAE,aAAa;QACpB,QAAQ,EAAE,0BAA0B;QACpC,QAAQ,EAAE,MAAM;QAChB,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE;YACpB,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC1B,IAAI,CAAC,IAAI,GAAG;oBAAE,OAAO,SAAS,CAAC,GAAG,CAAC;gBACnC,IAAI,CAAC,IAAI,GAAG;oBAAE,OAAO,SAAS,CAAC,GAAG,CAAC;gBACnC,OAAO,SAAS,CAAC,GAAG,CAAC;YACvB,CAAC;YACD,OAAO,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAC1B,CAAC;KACF;IACD;QACE,GAAG,EAAE,kBAAkB;QACvB,KAAK,EAAE,mBAAmB;QAC1B,QAAQ,EAAE,+BAA+B;QACzC,QAAQ,EAAE,MAAM;QAChB,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE;YACpB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC,CAAC,MAAM,MAAM,CAAC;YACjD,OAAO,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAC1B,CAAC;KACF;IAED,wBAAwB;IACxB;QACE,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,WAAW;QAClB,QAAQ,EAAE,uBAAuB;QACjC,QAAQ,EAAE,WAAW;QACrB,cAAc,EAAE,cAAc;KAC/B;IACD;QACE,GAAG,EAAE,QAAQ;QACb,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,qBAAqB;QAC/B,QAAQ,EAAE,WAAW;QACrB,cAAc,EAAE,cAAc;KAC/B;IACD;QACE,GAAG,EAAE,YAAY;QACjB,KAAK,EAAE,aAAa;QACpB,QAAQ,EAAE,yBAAyB;QACnC,QAAQ,EAAE,WAAW;QACrB,cAAc,EAAE,cAAc;KAC/B;IACD;QACE,GAAG,EAAE,QAAQ;QACb,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,qBAAqB;QAC/B,QAAQ,EAAE,WAAW;QACrB,cAAc,EAAE,cAAc;KAC/B;IACD;QACE,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,sBAAsB;QAChC,QAAQ,EAAE,WAAW;QACrB,cAAc,EAAE,cAAc;KAC/B;IACD;QACE,GAAG,EAAE,aAAa;QAClB,KAAK,EAAE,cAAc;QACrB,QAAQ,EAAE,0BAA0B;QACpC,QAAQ,EAAE,WAAW;QACrB,cAAc,EAAE,cAAc;KAC/B;IACD;QACE,GAAG,EAAE,aAAa;QAClB,KAAK,EAAE,cAAc;QACrB,QAAQ,EAAE,0BAA0B;QACpC,QAAQ,EAAE,WAAW;QACrB,cAAc,EAAE,cAAc;KAC/B;IACD;QACE,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,WAAW;QAClB,QAAQ,EAAE,uBAAuB;QACjC,QAAQ,EAAE,WAAW;QACrB,cAAc,EAAE,cAAc;KAC/B;IAED,iBAAiB;IACjB;QACE,GAAG,EAAE,gBAAgB;QACrB,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,6BAA6B;QACvC,QAAQ,EAAE,SAAS;QACnB,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;KAC3C;IACD;QACE,GAAG,EAAE,gBAAgB;QACrB,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,6BAA6B;QACvC,QAAQ,EAAE,SAAS;QACnB,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;KAC3C;IAED,cAAc;IACd;QACE,GAAG,EAAE,iBAAiB;QACtB,KAAK,EAAE,kBAAkB;QACzB,QAAQ,EAAE,8BAA8B;QACxC,QAAQ,EAAE,MAAM;QAChB,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE;YACpB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBACpC,OAAO,GAAG,KAAK,QAAQ,CAAC;YAC1B,CAAC;YACD,OAAO,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAC1B,CAAC;KACF;IAED,YAAY;IACZ;QACE,GAAG,EAAE,YAAY;QACjB,KAAK,EAAE,aAAa;QACpB,QAAQ,EAAE,yBAAyB;QACnC,QAAQ,EAAE,KAAK;QACf,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE;YACpB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBACpC,OAAO,GAAG,KAAK,WAAW,CAAC;YAC7B,CAAC;YACD,OAAO,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAC1B,CAAC;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,gBAAgB;AAEhB,SAAS,cAAc,CAAC,CAAU;IAChC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3C,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC9B,IAAI,KAAK,GAAG,IAAI;YAAE,OAAO,GAAG,KAAK,IAAI,CAAC;QACtC,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3C,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;AAC5B,CAAC"}

package/dist/services/config-validator.d.ts

@@ -0,0 +1,8 @@
+export declare function clearSchemaCache(instanceId: string): void;
+export declare function validateConfigPatch(instanceId: string, mergedConfig: Record<string, unknown>, fetchSchema: () => Promise<object | null>, options?: {
+    skipFullSchemaValidation?: boolean;
+}): Promise<{
+    valid: boolean;
+    errors?: string[];
+}>;
+//# sourceMappingURL=config-validator.d.ts.map