openclaw-sentinel-cli 1.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,MAAM,OAAO,QAAQ;IACX,MAAM,CAAiB;IACxB,MAAM,CAAQ;IAErB,YAAY,MAAsF;QAChG,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;QACpE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,eAAe,CAAC;QAC3G,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;QAE/E,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAE/D,IAAI,CAAC,MAAM,GAAG;YACZ,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC;YAC9B,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC;YACpC,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,CAAC;YAChD,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC;SAClC,CAAC;IACJ,CAAC;CACF"}

package/dist/openclaw.d.ts

@@ -0,0 +1,24 @@
+type SentinelPluginConfig = {
+    apiKey?: string;
+    baseUrl?: string;
+    agentId?: string;
+    workspaceDir?: string;
+};
+type ToolRegistration = {
+    name: string;
+    description: string;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: Record<string, unknown>;
+    execute: (params: Record<string, unknown>) => Promise<unknown>;
+};
+type PluginAPI = {
+    getConfig: <T = SentinelPluginConfig>() => T;
+    registerTool: (tool: ToolRegistration) => void;
+};
+export declare function register(api: PluginAPI): Promise<void>;
+export {};

package/dist/openclaw.js

@@ -0,0 +1,144 @@
+import { SentinelClient } from './client.js';
+import { createBackupSkill } from './skills/backupBrain.js';
+import { createHeartbeatSkill } from './skills/sentinelHeartbeat.js';
+import { createMemorySkill } from './skills/remoteMemory.js';
+import { createMemorySearchSkill } from './skills/searchMemory.js';
+const toolSchemas = {
+    save_remote_memory: {
+        type: 'object',
+        properties: {
+            content: {
+                type: 'string',
+                description: 'The fact or data to remember',
+            },
+            tags: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Keywords for categorization',
+            },
+            source: {
+                type: 'string',
+                enum: ['user', 'web', 'system', 'file'],
+                description: 'Optional memory source',
+            },
+        },
+        required: ['content'],
+        additionalProperties: false,
+    },
+    search_remote_memory: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                minLength: 1,
+                description: 'Search phrase for memory retrieval',
+            },
+            limit: {
+                type: 'integer',
+                minimum: 1,
+                maximum: 20,
+                description: 'Maximum number of results to return (default 5)',
+            },
+            tags: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Optional tag filters',
+            },
+        },
+        required: ['query'],
+        additionalProperties: false,
+    },
+    backup_brain: {
+        type: 'object',
+        properties: {
+            trigger: {
+                type: 'string',
+                enum: ['manual', 'scheduled'],
+                description: 'Reason for backup',
+            },
+            workspaceDir: {
+                type: 'string',
+                minLength: 1,
+                description: 'Optional explicit OpenClaw workspace directory containing AGENTS.md/IDENTITY.md/SOUL.md/TOOLS.md/USER.md',
+            },
+        },
+        required: ['trigger'],
+        additionalProperties: false,
+    },
+    sentinel_heartbeat: {
+        type: 'object',
+        properties: {},
+        additionalProperties: false,
+    },
+};
+export async function register(api) {
+    const configGetter = api.getConfig;
+    const config = typeof configGetter === 'function' ? (configGetter.call(api) ?? {}) : {};
+    const apiKey = config.apiKey ?? process.env.SENTINEL_API_KEY;
+    const baseUrl = config.baseUrl ?? process.env.SENTINEL_API_BASE_URL;
+    const agentId = config.agentId ?? process.env.SENTINEL_AGENT_ID ?? process.env.AGENT_ID ?? 'default-agent';
+    const workspaceDir = config.workspaceDir ?? process.env.OPENCLAW_WORKSPACE_DIR;
+    const notConfiguredMessage = "Sentinel API key is not configured. Set plugin config 'apiKey' or SENTINEL_API_KEY, then reload plugins.";
+    const client = apiKey ? new SentinelClient({ apiKey, baseUrl, agentId }) : null;
+    const skills = client
+        ? [
+            createMemorySkill(client),
+            createMemorySearchSkill(client),
+            createBackupSkill(client, { workspaceDir }),
+            createHeartbeatSkill(client),
+        ]
+        : [
+            {
+                name: 'save_remote_memory',
+                description: "Saves important information to Sentinel Cloud. Trigger this if the user says 'Remember that...' or provides critical config/preferences.",
+                execute: async () => notConfiguredMessage,
+            },
+            {
+                name: 'search_remote_memory',
+                description: 'Searches saved Sentinel memories by query and optional tags.',
+                execute: async () => notConfiguredMessage,
+            },
+            {
+                name: 'backup_brain',
+                description: 'Uploads critical agent identity files (IDENTITY.md, etc.) to the cloud.',
+                execute: async () => notConfiguredMessage,
+            },
+            {
+                name: 'sentinel_heartbeat',
+                description: 'Checks the status of the Sentinel cloud connection. Run this periodically.',
+                execute: async () => notConfiguredMessage,
+            },
+        ];
+    const registerToolFn = api.registerTool ??
+        api.tool?.register;
+    if (typeof registerToolFn !== 'function') {
+        throw new Error('Unsupported OpenClaw PluginAPI: registerTool is unavailable.');
+    }
+    for (const skill of skills) {
+        registerToolFn({
+            name: skill.name,
+            description: skill.description,
+            annotations: {
+                readOnlyHint: skill.name === 'sentinel_heartbeat' || skill.name === 'search_remote_memory',
+                destructiveHint: false,
+                idempotentHint: skill.name === 'sentinel_heartbeat',
+                openWorldHint: false,
+            },
+            inputSchema: toolSchemas[skill.name] ?? {
+                type: 'object',
+                properties: {},
+                additionalProperties: false,
+            },
+            execute: async (params) => {
+                try {
+                    return await skill.execute(params ?? {});
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    return `Sentinel tool '${skill.name}' failed: ${message}. Verify SENTINEL_API_KEY, baseUrl, and gateway scope.`;
+                }
+            },
+        });
+    }
+}
+//# sourceMappingURL=openclaw.js.map

package/dist/openclaw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw.js","sourceRoot":"","sources":["../src/openclaw.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AA2BnE,MAAM,WAAW,GAA4C;IAC3D,kBAAkB,EAAE;QAClB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;aAC5C;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,6BAA6B;aAC3C;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC;gBACvC,WAAW,EAAE,wBAAwB;aACtC;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,oBAAoB,EAAE,KAAK;KAC5B;IACD,oBAAoB,EAAE;QACpB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,CAAC;gBACZ,WAAW,EAAE,oCAAoC;aAClD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,iDAAiD;aAC/D;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,sBAAsB;aACpC;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,oBAAoB,EAAE,KAAK;KAC5B;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;gBAC7B,WAAW,EAAE,mBAAmB;aACjC;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,CAAC;gBACZ,WAAW,EACT,0GAA0G;aAC7G;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;QACrB,oBAAoB,EAAE,KAAK;KAC5B;IACD,kBAAkB,EAAE;QAClB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAc;IAC3C,MAAM,YAAY,GAAI,GAA6D,CAAC,SAAS,CAAC;IAC9F,MAAM,MAAM,GAAG,OAAO,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IACpE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,eAAe,CAAC;IAC3G,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAC/E,MAAM,oBAAoB,GACxB,0GAA0G,CAAC;IAE7G,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEhF,MAAM,MAAM,GAAG,MAAM;QACnB,CAAC,CAAC;YACE,iBAAiB,CAAC,MAAM,CAAC;YACzB,uBAAuB,CAAC,MAAM,CAAC;YAC/B,iBAAiB,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,CAAC;YAC3C,oBAAoB,CAAC,MAAM,CAAC;SAC7B;QACH,CAAC,CAAC;YACE;gBACE,IAAI,EAAE,oBAAoB;gBAC1B,WAAW,EACT,0IAA0I;gBAC5I,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,oBAAoB;aAC1C;YACD;gBACE,IAAI,EAAE,sBAAsB;gBAC5B,WAAW,EAAE,8DAA8D;gBAC3E,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,oBAAoB;aAC1C;YACD;gBACE,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,yEAAyE;gBACtF,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,oBAAoB;aAC1C;YACD;gBACE,IAAI,EAAE,oBAAoB;gBAC1B,WAAW,EAAE,4EAA4E;gBACzF,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,oBAAoB;aAC1C;SACF,CAAC;IAEN,MAAM,cAAc,GACjB,GAAsE,CAAC,YAAY;QACnF,GAA6E,CAAC,IAAI,EAAE,QAAQ,CAAC;IAEhG,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,cAAc,CAAC;YACb,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,WAAW,EAAE;gBACX,YAAY,EAAE,KAAK,CAAC,IAAI,KAAK,oBAAoB,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB;gBAC1F,eAAe,EAAE,KAAK;gBACtB,cAAc,EAAE,KAAK,CAAC,IAAI,KAAK,oBAAoB;gBACnD,aAAa,EAAE,KAAK;aACrB;YACD,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI;gBACtC,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE;gBACd,oBAAoB,EAAE,KAAK;aAC5B;YACD,OAAO,EAAE,KAAK,EAAE,MAA+B,EAAE,EAAE;gBACjD,IAAI,CAAC;oBACH,OAAO,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;gBAC3C,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACvE,OAAO,kBAAkB,KAAK,CAAC,IAAI,aAAa,OAAO,wDAAwD,CAAC;gBAClH,CAAC;YACH,CAAC;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/skills/backupBrain.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import { SentinelClient } from '../client.js';
+type BackupSkillOptions = {
+    workspaceDir?: string;
+};
+export declare const createBackupSkill: (sentinel: SentinelClient, options?: BackupSkillOptions) => {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        trigger: z.ZodEnum<["manual", "scheduled"]>;
+        workspaceDir: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        trigger: "manual" | "scheduled";
+        workspaceDir?: string | undefined;
+    }, {
+        trigger: "manual" | "scheduled";
+        workspaceDir?: string | undefined;
+    }>;
+    execute: (args: any) => Promise<string>;
+};
+export {};

package/dist/skills/backupBrain.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { resolveWorkspaceDir } from '../workspace.js';
+export const createBackupSkill = (sentinel, options = {}) => ({
+    name: 'backup_brain',
+    description: 'Uploads critical agent identity files (IDENTITY.md, etc.) to the cloud.',
+    parameters: z.object({
+        trigger: z.enum(['manual', 'scheduled']).describe('Reason for backup'),
+        workspaceDir: z
+            .string()
+            .min(1)
+            .optional()
+            .describe('Optional explicit OpenClaw workspace directory containing required identity files.'),
+    }),
+    execute: async (args) => {
+        const filesToBackup = ['IDENTITY.md', 'AGENTS.md', 'SOUL.md', 'TOOLS.md', 'USER.md'];
+        const fileData = [];
+        const missingFiles = [];
+        const workspaceDir = resolveWorkspaceDir({ workspaceDir: args?.workspaceDir ?? options.workspaceDir });
+        for (const file of filesToBackup) {
+            try {
+                const content = await fs.readFile(path.join(workspaceDir, file), 'utf-8');
+                fileData.push({
+                    name: file,
+                    content,
+                    size: `${Buffer.byteLength(content, 'utf-8')} B`,
+                });
+            }
+            catch {
+                missingFiles.push(file);
+            }
+        }
+        if (missingFiles.length > 0) {
+            return `Backup skipped. Missing required files: ${missingFiles.join(', ')}.`;
+        }
+        await sentinel.mutate('backups:create', {
+            files: fileData,
+        });
+        return `Backup successful. Uploaded ${fileData.length} files (${args.trigger}).`;
+    },
+});
+//# sourceMappingURL=backupBrain.js.map

package/dist/skills/backupBrain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backupBrain.js","sourceRoot":"","sources":["../../src/skills/backupBrain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAMtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAwB,EAAE,UAA8B,EAAE,EAAE,EAAE,CAAC,CAAC;IAChG,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,yEAAyE;IACtF,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACtE,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,EAAE;aACV,QAAQ,CAAC,oFAAoF,CAAC;KAClG,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,EAAE;QAC3B,MAAM,aAAa,GAAG,CAAC,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QACrF,MAAM,QAAQ,GAA2D,EAAE,CAAC;QAC5E,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,mBAAmB,CAAC,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QAEvG,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;gBAC1E,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,IAAI;oBACV,OAAO;oBACP,IAAI,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI;iBACjD,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,2CAA2C,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/E,CAAC;QAED,MAAM,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE;YACtC,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QAEH,OAAO,+BAA+B,QAAQ,CAAC,MAAM,WAAW,IAAI,CAAC,OAAO,IAAI,CAAC;IACnF,CAAC;CACF,CAAC,CAAC"}

package/dist/skills/backupBrain.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/skills/backupBrain.test.js

@@ -0,0 +1,58 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import * as fs from 'node:fs/promises';
+import { createBackupSkill } from './backupBrain.js';
+const REQUIRED_FILES = ['IDENTITY.md', 'AGENTS.md', 'SOUL.md', 'TOOLS.md', 'USER.md'];
+class FakeSentinelClient {
+    calls = [];
+    async mutate(name, payload) {
+        this.calls.push({ name, payload });
+    }
+}
+async function writeRequiredFiles(workspaceDir, omit = []) {
+    for (const fileName of REQUIRED_FILES) {
+        if (omit.includes(fileName))
+            continue;
+        await fs.writeFile(path.join(workspaceDir, fileName), `content for ${fileName}\n`, 'utf-8');
+    }
+}
+test('backup_brain reads required files from configured workspace even when cwd is a subfolder', async () => {
+    const workspaceDir = await fs.mkdtemp(path.join(os.tmpdir(), 'sentinel-backup-workspace-'));
+    const nestedDir = path.join(workspaceDir, 'projects', 'nested');
+    await fs.mkdir(nestedDir, { recursive: true });
+    await writeRequiredFiles(workspaceDir);
+    const previousCwd = process.cwd();
+    process.chdir(nestedDir);
+    try {
+        const sentinel = new FakeSentinelClient();
+        const skill = createBackupSkill(sentinel, { workspaceDir });
+        const result = await skill.execute({ trigger: 'manual' });
+        assert.match(result, /Backup successful\. Uploaded 5 files \(manual\)\./);
+        assert.equal(sentinel.calls.length, 1);
+        assert.equal(sentinel.calls[0]?.name, 'backups:create');
+        const payload = sentinel.calls[0]?.payload;
+        assert.equal(payload.files.length, 5);
+        assert.deepEqual(payload.files.map((file) => file.name).sort(), [...REQUIRED_FILES].sort());
+    }
+    finally {
+        process.chdir(previousCwd);
+        await fs.rm(workspaceDir, { recursive: true, force: true });
+    }
+});
+test('backup_brain skips upload when required files are missing in resolved workspace', async () => {
+    const workspaceDir = await fs.mkdtemp(path.join(os.tmpdir(), 'sentinel-backup-missing-'));
+    await writeRequiredFiles(workspaceDir, ['USER.md']);
+    try {
+        const sentinel = new FakeSentinelClient();
+        const skill = createBackupSkill(sentinel, { workspaceDir });
+        const result = await skill.execute({ trigger: 'scheduled' });
+        assert.equal(result, 'Backup skipped. Missing required files: USER.md.');
+        assert.equal(sentinel.calls.length, 0);
+    }
+    finally {
+        await fs.rm(workspaceDir, { recursive: true, force: true });
+    }
+});
+//# sourceMappingURL=backupBrain.test.js.map

package/dist/skills/backupBrain.test.js.map

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

package/dist/skills/remoteMemory.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { SentinelClient } from '../client.js';
+export declare const createMemorySkill: (sentinel: SentinelClient) => {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        content: z.ZodString;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        source: z.ZodOptional<z.ZodEnum<["user", "web", "system", "file"]>>;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        tags?: string[] | undefined;
+        source?: "user" | "web" | "system" | "file" | undefined;
+    }, {
+        content: string;
+        tags?: string[] | undefined;
+        source?: "user" | "web" | "system" | "file" | undefined;
+    }>;
+    execute: (args: any) => Promise<string>;
+};

package/dist/skills/remoteMemory.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+export const createMemorySkill = (sentinel) => ({
+    name: 'save_remote_memory',
+    description: 'Saves important information to Sentinel Cloud. ' +
+        "Trigger this if the user says 'Remember that...' or provides critical config/preferences.",
+    parameters: z.object({
+        content: z.string().describe('The fact or data to remember'),
+        tags: z.array(z.string()).optional().describe('Keywords for categorization'),
+        source: z.enum(['user', 'web', 'system', 'file']).optional(),
+    }),
+    execute: async (args) => {
+        try {
+            await sentinel.mutate('memories:create', {
+                content: args.content,
+                tags: Array.isArray(args.tags) ? args.tags : [],
+                source: args.source ?? 'user',
+            });
+            return 'Success: Memory saved to Sentinel Cloud.';
+        }
+        catch (e) {
+            return `Error saving memory: ${e.message}`;
+        }
+    },
+});
+//# sourceMappingURL=remoteMemory.js.map

package/dist/skills/remoteMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteMemory.js","sourceRoot":"","sources":["../../src/skills/remoteMemory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAwB,EAAE,EAAE,CAAC,CAAC;IAC9D,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,iDAAiD;QACjD,2FAA2F;IAC7F,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QAC5D,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QAC5E,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC7D,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE;gBACvC,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;gBAC/C,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,MAAM;aAC9B,CAAC,CAAC;YACH,OAAO,0CAA0C,CAAC;QACpD,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,wBAAwB,CAAC,CAAC,OAAO,EAAE,CAAC;QAC7C,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/skills/searchMemory.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import { SentinelClient } from '../client.js';
+export declare const createMemorySearchSkill: (sentinel: SentinelClient) => {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{
+        query: z.ZodString;
+        limit: z.ZodOptional<z.ZodNumber>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        query: string;
+        tags?: string[] | undefined;
+        limit?: number | undefined;
+    }, {
+        query: string;
+        tags?: string[] | undefined;
+        limit?: number | undefined;
+    }>;
+    execute: (input: unknown) => Promise<{
+        ok: boolean;
+        count: number;
+        results: Record<string, unknown>[];
+    }>;
+};

package/dist/skills/searchMemory.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+const SearchArgs = z.object({
+    query: z.string().min(1).describe('Search phrase for memory retrieval'),
+    limit: z.number().int().min(1).max(20).optional(),
+    tags: z.array(z.string()).optional(),
+});
+export const createMemorySearchSkill = (sentinel) => ({
+    name: 'search_remote_memory',
+    description: 'Searches saved Sentinel memories by query and optional tags.',
+    parameters: SearchArgs,
+    execute: async (input) => {
+        const args = SearchArgs.parse(input ?? {});
+        const response = (await sentinel.query('memories:search', {
+            query: args.query,
+            limit: args.limit ?? 5,
+            tags: args.tags,
+            includeArchived: false,
+        }));
+        const results = Array.isArray(response?.results) ? response.results : [];
+        return {
+            ok: true,
+            count: results.length,
+            results: results.slice(0, args.limit ?? 5),
+        };
+    },
+});
+//# sourceMappingURL=searchMemory.js.map

package/dist/skills/searchMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchMemory.js","sourceRoot":"","sources":["../../src/skills/searchMemory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IACvE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IACjD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,QAAwB,EAAE,EAAE,CAAC,CAAC;IACpE,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,8DAA8D;IAC3E,UAAU,EAAE,UAAU;IACtB,OAAO,EAAE,KAAK,EAAE,KAAc,EAAE,EAAE;QAChC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAE3C,MAAM,QAAQ,GAAG,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,iBAAiB,EAAE;YACxD,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,eAAe,EAAE,KAAK;SACvB,CAAC,CAAiD,CAAC;QAEpD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAEzE,OAAO;YACL,EAAE,EAAE,IAAI;YACR,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;SAC3C,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/skills/sentinelHeartbeat.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+import { SentinelClient } from '../client.js';
+export declare const createHeartbeatSkill: (sentinel: SentinelClient) => {
+    name: string;
+    description: string;
+    parameters: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    execute: () => Promise<string>;
+};

package/dist/skills/sentinelHeartbeat.js

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+const ONE_DAY_MS = 24 * 60 * 60 * 1000;
+const lastSeenMemoryByAgent = new Map();
+export const createHeartbeatSkill = (sentinel) => ({
+    name: 'sentinel_heartbeat',
+    description: 'Checks the status of the Sentinel cloud connection. Run this periodically.',
+    parameters: z.object({}),
+    execute: async () => {
+        const instructions = [];
+        let gatewayOk = false;
+        let needsBackup = false;
+        let hasNewMemories = false;
+        try {
+            await sentinel.query('health:get', {});
+            gatewayOk = true;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return `ALERT: Gateway health check failed (${message}).`;
+        }
+        try {
+            const backupResponse = (await sentinel.query('backups:list', {}));
+            const backups = Array.isArray(backupResponse.backups) ? backupResponse.backups : [];
+            const completed = backups.filter((entry) => entry.status === 'completed');
+            if (completed.length === 0) {
+                needsBackup = true;
+            }
+            else {
+                const latestTs = Math.max(...completed.map((entry) => typeof entry.createdAt === 'number' ? entry.createdAt : (entry._creationTime ?? 0)));
+                needsBackup = Date.now() - latestTs > ONE_DAY_MS;
+            }
+        }
+        catch {
+            needsBackup = true;
+        }
+        try {
+            const memoryResponse = (await sentinel.query('memories:search', {
+                query: '',
+                limit: 1,
+                includeArchived: false,
+            }));
+            const latestMemoryTs = memoryResponse.results?.[0]?._creationTime;
+            if (typeof latestMemoryTs === 'number') {
+                const lastSeen = lastSeenMemoryByAgent.get(sentinel.agentId) ?? 0;
+                hasNewMemories = latestMemoryTs > lastSeen;
+                lastSeenMemoryByAgent.set(sentinel.agentId, latestMemoryTs);
+            }
+        }
+        catch {
+            hasNewMemories = false;
+        }
+        if (needsBackup) {
+            instructions.push('Backup Required (Last backup > 24h ago).');
+        }
+        if (hasNewMemories) {
+            instructions.push('New Memories Available (User updated dashboard).');
+        }
+        if (instructions.length === 0) {
+            return gatewayOk ? 'System Nominal. Connection active.' : 'ALERT: Gateway unavailable.';
+        }
+        return `ALERT: ${instructions.join(' ')}`;
+    },
+});
+//# sourceMappingURL=sentinelHeartbeat.js.map

package/dist/skills/sentinelHeartbeat.js.map

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

package/dist/workspace.d.ts

@@ -0,0 +1,5 @@
+export type WorkspaceResolutionOptions = {
+    workspaceDir?: string;
+};
+export declare function resolveWorkspaceDir(options?: WorkspaceResolutionOptions): string;
+export declare function resolveWorkspaceFilePath(fileName: string, options?: WorkspaceResolutionOptions): string;

package/dist/workspace.js

@@ -0,0 +1,10 @@
+import * as path from 'path';
+export function resolveWorkspaceDir(options = {}) {
+    const explicitWorkspaceDir = options.workspaceDir?.trim();
+    const envWorkspaceDir = process.env.OPENCLAW_WORKSPACE_DIR?.trim();
+    return path.resolve(explicitWorkspaceDir || envWorkspaceDir || process.cwd());
+}
+export function resolveWorkspaceFilePath(fileName, options = {}) {
+    return path.join(resolveWorkspaceDir(options), fileName);
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAM7B,MAAM,UAAU,mBAAmB,CAAC,UAAsC,EAAE;IAC1E,MAAM,oBAAoB,GAAG,OAAO,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC;IAC1D,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,IAAI,EAAE,CAAC;IAEnE,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,IAAI,eAAe,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,QAAgB,EAChB,UAAsC,EAAE;IAExC,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC3D,CAAC"}

package/dist/workspace.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/workspace.test.js

@@ -0,0 +1,60 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import * as fs from 'node:fs/promises';
+import { resolveWorkspaceDir } from './workspace.js';
+test('resolveWorkspaceDir prefers explicit option over env and cwd', () => {
+    const previousEnv = process.env.OPENCLAW_WORKSPACE_DIR;
+    process.env.OPENCLAW_WORKSPACE_DIR = '/env/workspace';
+    try {
+        const resolved = resolveWorkspaceDir({ workspaceDir: '/explicit/workspace' });
+        assert.equal(resolved, path.resolve('/explicit/workspace'));
+    }
+    finally {
+        if (previousEnv === undefined) {
+            delete process.env.OPENCLAW_WORKSPACE_DIR;
+        }
+        else {
+            process.env.OPENCLAW_WORKSPACE_DIR = previousEnv;
+        }
+    }
+});
+test('resolveWorkspaceDir uses OPENCLAW_WORKSPACE_DIR when explicit option is absent', () => {
+    const previousEnv = process.env.OPENCLAW_WORKSPACE_DIR;
+    process.env.OPENCLAW_WORKSPACE_DIR = '/env/workspace';
+    try {
+        const resolved = resolveWorkspaceDir();
+        assert.equal(resolved, path.resolve('/env/workspace'));
+    }
+    finally {
+        if (previousEnv === undefined) {
+            delete process.env.OPENCLAW_WORKSPACE_DIR;
+        }
+        else {
+            process.env.OPENCLAW_WORKSPACE_DIR = previousEnv;
+        }
+    }
+});
+test('resolveWorkspaceDir falls back to process.cwd()', async () => {
+    const previousEnv = process.env.OPENCLAW_WORKSPACE_DIR;
+    delete process.env.OPENCLAW_WORKSPACE_DIR;
+    const previousCwd = process.cwd();
+    const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'sentinel-workspace-'));
+    try {
+        process.chdir(tempDir);
+        const resolved = resolveWorkspaceDir();
+        assert.equal(resolved, path.resolve(tempDir));
+    }
+    finally {
+        process.chdir(previousCwd);
+        await fs.rm(tempDir, { recursive: true, force: true });
+        if (previousEnv === undefined) {
+            delete process.env.OPENCLAW_WORKSPACE_DIR;
+        }
+        else {
+            process.env.OPENCLAW_WORKSPACE_DIR = previousEnv;
+        }
+    }
+});
+//# sourceMappingURL=workspace.test.js.map

package/dist/workspace.test.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,30 @@
+{
+  "id": "sentinel.sentinel-sdk",
+  "name": "Sentinel SDK",
+  "version": "1.1.0",
+  "description": "Registers Sentinel memory and reliability tools for OpenClaw agents.",
+  "author": "OpenClaw Sentinel <support@openclawsentinel.com>",
+  "slots": ["tool"],
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "apiKey": {
+        "type": "string",
+        "minLength": 1,
+        "description": "Sentinel API key generated by openclawsentinel.com"
+      },
+      "baseUrl": {
+        "type": "string",
+        "format": "uri",
+        "description": "Sentinel API base URL. Defaults to https://api.openclawsentinel.com"
+      },
+      "agentId": {
+        "type": "string",
+        "minLength": 1,
+        "description": "Agent identifier used for memory and backup records"
+      }
+    },
+    "required": [],
+    "additionalProperties": false
+  }
+}