bernard-agent 0.4.0 → 0.5.1

package/dist/tools/index.d.ts

@@ -1,339 +1,13 @@
 import type { ToolOptions } from './types.js';
 import type { MemoryStore } from '../memory.js';
+import type { RoutineStore } from '../routines.js';
 export type { ToolOptions } from './types.js';
-export declare function createTools(options: ToolOptions, memoryStore: MemoryStore, mcpTools?: Record<string, any>): {
-    mcp_config: import("ai").Tool<import("zod").ZodObject<{
-        action: import("zod").ZodEnum<["list", "add", "remove", "get"]>;
-        key: import("zod").ZodOptional<import("zod").ZodString>;
-        command: import("zod").ZodOptional<import("zod").ZodString>;
-        args: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
-        env: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
-    }, "strip", import("zod").ZodTypeAny, {
-        action: "list" | "add" | "remove" | "get";
-        command?: string | undefined;
-        key?: string | undefined;
-        env?: Record<string, string> | undefined;
-        args?: string[] | undefined;
-    }, {
-        action: "list" | "add" | "remove" | "get";
-        command?: string | undefined;
-        key?: string | undefined;
-        env?: Record<string, string> | undefined;
-        args?: string[] | undefined;
-    }>, string> & {
-        execute: (args: {
-            action: "list" | "add" | "remove" | "get";
-            command?: string | undefined;
-            key?: string | undefined;
-            env?: Record<string, string> | undefined;
-            args?: string[] | undefined;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    mcp_add_url: import("ai").Tool<import("zod").ZodObject<{
-        key: import("zod").ZodString;
-        url: import("zod").ZodString;
-    }, "strip", import("zod").ZodTypeAny, {
-        key: string;
-        url: string;
-    }, {
-        key: string;
-        url: string;
-    }>, string> & {
-        execute: (args: {
-            key: string;
-            url: string;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    web_read: import("ai").Tool<import("zod").ZodObject<{
-        url: import("zod").ZodString;
-        selector: import("zod").ZodOptional<import("zod").ZodString>;
-    }, "strip", import("zod").ZodTypeAny, {
-        url: string;
-        selector?: string | undefined;
-    }, {
-        url: string;
-        selector?: string | undefined;
-    }>, string> & {
-        execute: (args: {
-            url: string;
-            selector?: string | undefined;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    wait: import("ai").Tool<import("zod").ZodObject<{
-        seconds: import("zod").ZodNumber;
-    }, "strip", import("zod").ZodTypeAny, {
-        seconds: number;
-    }, {
-        seconds: number;
-    }>, string> & {
-        execute: (args: {
-            seconds: number;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    time_range: import("ai").Tool<import("zod").ZodObject<{
-        start: import("zod").ZodNumber;
-        end: import("zod").ZodNumber;
-    }, "strip", import("zod").ZodTypeAny, {
-        start: number;
-        end: number;
-    }, {
-        start: number;
-        end: number;
-    }>, string> & {
-        execute: (args: {
-            start: number;
-            end: number;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    time_range_total: import("ai").Tool<import("zod").ZodObject<{
-        ranges: import("zod").ZodArray<import("zod").ZodObject<{
-            start: import("zod").ZodNumber;
-            end: import("zod").ZodNumber;
-        }, "strip", import("zod").ZodTypeAny, {
-            start: number;
-            end: number;
-        }, {
-            start: number;
-            end: number;
-        }>, "many">;
-    }, "strip", import("zod").ZodTypeAny, {
-        ranges: {
-            start: number;
-            end: number;
-        }[];
-    }, {
-        ranges: {
-            start: number;
-            end: number;
-        }[];
-    }>, string> & {
-        execute: (args: {
-            ranges: {
-                start: number;
-                end: number;
-            }[];
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    cron_logs_list: import("ai").Tool<import("zod").ZodObject<{
-        job_id: import("zod").ZodString;
-        limit: import("zod").ZodDefault<import("zod").ZodNumber>;
-        offset: import("zod").ZodDefault<import("zod").ZodNumber>;
-    }, "strip", import("zod").ZodTypeAny, {
-        job_id: string;
-        limit: number;
-        offset: number;
-    }, {
-        job_id: string;
-        limit?: number | undefined;
-        offset?: number | undefined;
-    }>, string> & {
-        execute: (args: {
-            job_id: string;
-            limit: number;
-            offset: number;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    cron_logs_get: import("ai").Tool<import("zod").ZodObject<{
-        job_id: import("zod").ZodString;
-        run_id: import("zod").ZodString;
-    }, "strip", import("zod").ZodTypeAny, {
-        job_id: string;
-        run_id: string;
-    }, {
-        job_id: string;
-        run_id: string;
-    }>, string> & {
-        execute: (args: {
-            job_id: string;
-            run_id: string;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    cron_logs_summary: import("ai").Tool<import("zod").ZodObject<{
-        job_id: import("zod").ZodString;
-    }, "strip", import("zod").ZodTypeAny, {
-        job_id: string;
-    }, {
-        job_id: string;
-    }>, string> & {
-        execute: (args: {
-            job_id: string;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    cron_logs_cleanup: import("ai").Tool<import("zod").ZodObject<{
-        job_id: import("zod").ZodString;
-        action: import("zod").ZodEnum<["rotate", "delete"]>;
-        keep: import("zod").ZodDefault<import("zod").ZodNumber>;
-    }, "strip", import("zod").ZodTypeAny, {
-        action: "delete" | "rotate";
-        job_id: string;
-        keep: number;
-    }, {
-        action: "delete" | "rotate";
-        job_id: string;
-        keep?: number | undefined;
-    }>, string> & {
-        execute: (args: {
-            action: "delete" | "rotate";
-            job_id: string;
-            keep: number;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    cron_create: import("ai").Tool<import("zod").ZodObject<{
-        name: import("zod").ZodString;
-        schedule: import("zod").ZodString;
-        prompt: import("zod").ZodString;
-    }, "strip", import("zod").ZodTypeAny, {
-        name: string;
-        schedule: string;
-        prompt: string;
-    }, {
-        name: string;
-        schedule: string;
-        prompt: string;
-    }>, string> & {
-        execute: (args: {
-            name: string;
-            schedule: string;
-            prompt: string;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    cron_list: import("ai").Tool<import("zod").ZodObject<{}, "strip", import("zod").ZodTypeAny, {}, {}>, string> & {
-        execute: (args: {}, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    cron_run: import("ai").Tool<import("zod").ZodObject<{
-        id: import("zod").ZodString;
-    }, "strip", import("zod").ZodTypeAny, {
-        id: string;
-    }, {
-        id: string;
-    }>, string> & {
-        execute: (args: {
-            id: string;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    cron_get: import("ai").Tool<import("zod").ZodObject<{
-        id: import("zod").ZodString;
-    }, "strip", import("zod").ZodTypeAny, {
-        id: string;
-    }, {
-        id: string;
-    }>, string> & {
-        execute: (args: {
-            id: string;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    cron_update: import("ai").Tool<import("zod").ZodObject<{
-        id: import("zod").ZodString;
-        name: import("zod").ZodOptional<import("zod").ZodString>;
-        schedule: import("zod").ZodOptional<import("zod").ZodString>;
-        prompt: import("zod").ZodOptional<import("zod").ZodString>;
-    }, "strip", import("zod").ZodTypeAny, {
-        id: string;
-        name?: string | undefined;
-        schedule?: string | undefined;
-        prompt?: string | undefined;
-    }, {
-        id: string;
-        name?: string | undefined;
-        schedule?: string | undefined;
-        prompt?: string | undefined;
-    }>, string> & {
-        execute: (args: {
-            id: string;
-            name?: string | undefined;
-            schedule?: string | undefined;
-            prompt?: string | undefined;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    cron_delete: import("ai").Tool<import("zod").ZodObject<{
-        id: import("zod").ZodString;
-    }, "strip", import("zod").ZodTypeAny, {
-        id: string;
-    }, {
-        id: string;
-    }>, string> & {
-        execute: (args: {
-            id: string;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    cron_enable: import("ai").Tool<import("zod").ZodObject<{
-        id: import("zod").ZodString;
-    }, "strip", import("zod").ZodTypeAny, {
-        id: string;
-    }, {
-        id: string;
-    }>, string> & {
-        execute: (args: {
-            id: string;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    cron_disable: import("ai").Tool<import("zod").ZodObject<{
-        id: import("zod").ZodString;
-    }, "strip", import("zod").ZodTypeAny, {
-        id: string;
-    }, {
-        id: string;
-    }>, string> & {
-        execute: (args: {
-            id: string;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    cron_status: import("ai").Tool<import("zod").ZodObject<{}, "strip", import("zod").ZodTypeAny, {}, {}>, string> & {
-        execute: (args: {}, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    cron_bounce: import("ai").Tool<import("zod").ZodObject<{}, "strip", import("zod").ZodTypeAny, {}, {}>, string> & {
-        execute: (args: {}, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    shell: import("ai").Tool<import("zod").ZodObject<{
-        command: import("zod").ZodString;
-    }, "strip", import("zod").ZodTypeAny, {
-        command: string;
-    }, {
-        command: string;
-    }>, import("./types.js").ShellResult> & {
-        execute: (args: {
-            command: string;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<import("./types.js").ShellResult>;
-    };
-    memory: import("ai").Tool<import("zod").ZodObject<{
-        action: import("zod").ZodEnum<["list", "read", "write", "delete"]>;
-        key: import("zod").ZodOptional<import("zod").ZodString>;
-        content: import("zod").ZodOptional<import("zod").ZodString>;
-    }, "strip", import("zod").ZodTypeAny, {
-        action: "list" | "read" | "write" | "delete";
-        key?: string | undefined;
-        content?: string | undefined;
-    }, {
-        action: "list" | "read" | "write" | "delete";
-        key?: string | undefined;
-        content?: string | undefined;
-    }>, string> & {
-        execute: (args: {
-            action: "list" | "read" | "write" | "delete";
-            key?: string | undefined;
-            content?: string | undefined;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    scratch: import("ai").Tool<import("zod").ZodObject<{
-        action: import("zod").ZodEnum<["list", "read", "write", "delete"]>;
-        key: import("zod").ZodOptional<import("zod").ZodString>;
-        content: import("zod").ZodOptional<import("zod").ZodString>;
-    }, "strip", import("zod").ZodTypeAny, {
-        action: "list" | "read" | "write" | "delete";
-        key?: string | undefined;
-        content?: string | undefined;
-    }, {
-        action: "list" | "read" | "write" | "delete";
-        key?: string | undefined;
-        content?: string | undefined;
-    }>, string> & {
-        execute: (args: {
-            action: "list" | "read" | "write" | "delete";
-            key?: string | undefined;
-            content?: string | undefined;
-        }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-    datetime: import("ai").Tool<import("zod").ZodObject<{}, "strip", import("zod").ZodTypeAny, {}, {}>, string> & {
-        execute: (args: {}, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
-    };
-};
+/**
+ * Assembles the complete tool registry for the agent.
+ *
+ * @param options - Shell execution options (timeout, dangerous-command confirmation callback).
+ * @param memoryStore - Persistent and scratch memory backing store.
+ * @param mcpTools - Optional MCP-provided tools to merge into the registry.
+ * @returns A flat record of all available AI SDK tools keyed by tool name.
+ */
+export declare function createTools(options: ToolOptions, memoryStore: MemoryStore, mcpTools?: Record<string, any>, routineStore?: RoutineStore): Record<string, any>;

package/dist/tools/index.js

@@ -11,11 +11,21 @@ const mcp_js_1 = require("./mcp.js");
 const mcp_url_js_1 = require("./mcp-url.js");
 const web_js_1 = require("./web.js");
 const wait_js_1 = require("./wait.js");
-function createTools(options, memoryStore, mcpTools) {
+const routine_js_1 = require("./routine.js");
+/**
+ * Assembles the complete tool registry for the agent.
+ *
+ * @param options - Shell execution options (timeout, dangerous-command confirmation callback).
+ * @param memoryStore - Persistent and scratch memory backing store.
+ * @param mcpTools - Optional MCP-provided tools to merge into the registry.
+ * @returns A flat record of all available AI SDK tools keyed by tool name.
+ */
+function createTools(options, memoryStore, mcpTools, routineStore) {
     return {
         shell: (0, shell_js_1.createShellTool)(options),
         memory: (0, memory_js_1.createMemoryTool)(memoryStore),
         scratch: (0, memory_js_1.createScratchTool)(memoryStore),
+        routine: (0, routine_js_1.createRoutineTool)(routineStore),
         datetime: (0, datetime_js_1.createDateTimeTool)(),
         ...(0, cron_js_1.createCronTools)(),
         ...(0, cron_logs_js_1.createCronLogTools)(),

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;AAeA,kCAmBC;AAlCD,yCAA6C;AAC7C,2CAAkE;AAClE,+CAAmD;AACnD,uCAA4C;AAC5C,iDAAoD;AACpD,uCAA4C;AAC5C,qCAA+C;AAC/C,6CAAmD;AACnD,qCAA6C;AAC7C,uCAA2C;AAM3C,SAAgB,WAAW,CACzB,OAAoB,EACpB,WAAwB,EACxB,QAA8B;IAE9B,OAAO;QACL,KAAK,EAAE,IAAA,0BAAe,EAAC,OAAO,CAAC;QAC/B,MAAM,EAAE,IAAA,4BAAgB,EAAC,WAAW,CAAC;QACrC,OAAO,EAAE,IAAA,6BAAiB,EAAC,WAAW,CAAC;QACvC,QAAQ,EAAE,IAAA,gCAAkB,GAAE;QAC9B,GAAG,IAAA,yBAAe,GAAE;QACpB,GAAG,IAAA,iCAAkB,GAAE;QACvB,GAAG,IAAA,yBAAe,GAAE;QACpB,UAAU,EAAE,IAAA,4BAAmB,GAAE;QACjC,WAAW,EAAE,IAAA,gCAAmB,GAAE;QAClC,QAAQ,EAAE,IAAA,0BAAiB,GAAE;QAC7B,IAAI,EAAE,IAAA,wBAAc,GAAE;QACtB,GAAG,QAAQ;KACZ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";;AAyBA,kCAqBC;AA9CD,yCAA6C;AAC7C,2CAAkE;AAClE,+CAAmD;AACnD,uCAA4C;AAC5C,iDAAoD;AACpD,uCAA4C;AAC5C,qCAA+C;AAC/C,6CAAmD;AACnD,qCAA6C;AAC7C,uCAA2C;AAC3C,6CAAiD;AAOjD;;;;;;;GAOG;AACH,SAAgB,WAAW,CACzB,OAAoB,EACpB,WAAwB,EACxB,QAA8B,EAC9B,YAA2B;IAE3B,OAAO;QACL,KAAK,EAAE,IAAA,0BAAe,EAAC,OAAO,CAAC;QAC/B,MAAM,EAAE,IAAA,4BAAgB,EAAC,WAAW,CAAC;QACrC,OAAO,EAAE,IAAA,6BAAiB,EAAC,WAAW,CAAC;QACvC,OAAO,EAAE,IAAA,8BAAiB,EAAC,YAAY,CAAC;QACxC,QAAQ,EAAE,IAAA,gCAAkB,GAAE;QAC9B,GAAG,IAAA,yBAAe,GAAE;QACpB,GAAG,IAAA,iCAAkB,GAAE;QACvB,GAAG,IAAA,yBAAe,GAAE;QACpB,UAAU,EAAE,IAAA,4BAAmB,GAAE;QACjC,WAAW,EAAE,IAAA,gCAAmB,GAAE;QAClC,QAAQ,EAAE,IAAA,0BAAiB,GAAE;QAC7B,IAAI,EAAE,IAAA,wBAAc,GAAE;QACtB,GAAG,QAAQ;KACZ,CAAC;AACJ,CAAC"}

package/dist/tools/mcp-url.d.ts

@@ -1,4 +1,10 @@
 import { z } from 'zod';
+/**
+ * Creates the tool for adding URL-based (SSE/HTTP) MCP servers.
+ *
+ * Unlike {@link createMCPConfigTool}, this tool is specialized for URL endpoints
+ * rather than local stdio processes. Changes require a Bernard restart.
+ */
 export declare function createMCPAddUrlTool(): import("ai").Tool<z.ZodObject<{
     key: z.ZodString;
     url: z.ZodString;

package/dist/tools/mcp-url.js

@@ -4,6 +4,12 @@ exports.createMCPAddUrlTool = createMCPAddUrlTool;
 const ai_1 = require("ai");
 const zod_1 = require("zod");
 const mcp_js_1 = require("../mcp.js");
+/**
+ * Creates the tool for adding URL-based (SSE/HTTP) MCP servers.
+ *
+ * Unlike {@link createMCPConfigTool}, this tool is specialized for URL endpoints
+ * rather than local stdio processes. Changes require a Bernard restart.
+ */
 function createMCPAddUrlTool() {
     return (0, ai_1.tool)({
         description: 'Add a URL-based MCP server (SSE or HTTP endpoint). Use this when given an MCP server URL. Changes take effect after restarting Bernard.',

package/dist/tools/mcp-url.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-url.js","sourceRoot":"","sources":["../../src/tools/mcp-url.ts"],"names":[],"mappings":";;AAIA,kDAmBC;AAvBD,2BAA0B;AAC1B,6BAAwB;AACxB,sCAA4C;AAE5C,SAAgB,mBAAmB;IACjC,OAAO,IAAA,SAAI,EAAC;QACV,WAAW,EACT,yIAAyI;QAC3I,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;YACnB,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;YACtE,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;SACrF,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAmB,EAAE;YAC/C,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,KAAe,CAAC,CAAC,CAAE,KAAe,CAAC;gBACxE,IAAA,wBAAe,EAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;gBAChC,OAAO,6BAA6B,GAAG,YAAY,GAAG,kBAAkB,IAAI,gDAAgD,CAAC;YAC/H,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,OAAO,wBAAwB,GAAG,EAAE,CAAC;YACvC,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"mcp-url.js","sourceRoot":"","sources":["../../src/tools/mcp-url.ts"],"names":[],"mappings":";;AAUA,kDAmBC;AA7BD,2BAA0B;AAC1B,6BAAwB;AACxB,sCAA4C;AAE5C;;;;;GAKG;AACH,SAAgB,mBAAmB;IACjC,OAAO,IAAA,SAAI,EAAC;QACV,WAAW,EACT,yIAAyI;QAC3I,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;YACnB,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;YACtE,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;SACrF,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAmB,EAAE;YAC/C,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,KAAe,CAAC,CAAC,CAAE,KAAe,CAAC;gBACxE,IAAA,wBAAe,EAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;gBAChC,OAAO,6BAA6B,GAAG,YAAY,GAAG,kBAAkB,IAAI,gDAAgD,CAAC;YAC/H,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,OAAO,wBAAwB,GAAG,EAAE,CAAC;YACvC,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/mcp.d.ts

@@ -1,4 +1,10 @@
 import { z } from 'zod';
+/**
+ * Creates the MCP server configuration tool for managing stdio-based MCP servers.
+ *
+ * Supports add, remove, list, and get actions. Configuration changes require
+ * a Bernard restart to take effect.
+ */
 export declare function createMCPConfigTool(): import("ai").Tool<z.ZodObject<{
     action: z.ZodEnum<["list", "add", "remove", "get"]>;
     key: z.ZodOptional<z.ZodString>;

package/dist/tools/mcp.js

@@ -4,6 +4,12 @@ exports.createMCPConfigTool = createMCPConfigTool;
 const ai_1 = require("ai");
 const zod_1 = require("zod");
 const mcp_js_1 = require("../mcp.js");
+/**
+ * Creates the MCP server configuration tool for managing stdio-based MCP servers.
+ *
+ * Supports add, remove, list, and get actions. Configuration changes require
+ * a Bernard restart to take effect.
+ */
 function createMCPConfigTool() {
     return (0, ai_1.tool)({
         description: 'Manage MCP server configuration. Add, remove, list, or inspect MCP servers. Changes take effect after restarting Bernard.',

package/dist/tools/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/tools/mcp.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/tools/mcp.ts"],"names":[],"mappings":";;AAUA,kDAoHC;AA9HD,2BAA0B;AAC1B,6BAAwB;AACxB,sCAAwF;AAExF;;;;;GAKG;AACH,SAAgB,mBAAmB;IACjC,OAAO,IAAA,SAAI,EAAC;QACV,WAAW,EACT,2HAA2H;QAC7H,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAClF,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;YACtF,OAAO,EAAE,OAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,oEAAoE,CAAC;YACjF,IAAI,EAAE,OAAC;iBACJ,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBACjB,QAAQ,EAAE;iBACV,QAAQ,CACP,yFAAyF,CAC1F;YACH,GAAG,EAAE,OAAC;iBACH,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;iBAClB,QAAQ,EAAE;iBACV,QAAQ,CAAC,qDAAqD,CAAC;SACnE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,EAAmB,EAAE;YACtE,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,MAAM,CAAC,CAAC,CAAC;oBACZ,IAAI,CAAC;wBACH,MAAM,OAAO,GAAG,IAAA,uBAAc,GAAE,CAAC;wBACjC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;4BAAE,OAAO,4BAA4B,CAAC;wBAE9D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;4BAC9B,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;gCACV,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;gCACnD,OAAO,OAAO,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,GAAG,GAAG,OAAO,EAAE,CAAC;4BACrD,CAAC;4BACD,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;4BACrF,OAAO,OAAO,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,OAAO,GAAG,OAAO,EAAE,CAAC;wBAC7D,CAAC,CAAC,CAAC;wBAEH,OAAO,gBAAgB,OAAO,CAAC,MAAM,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACjE,CAAC;oBAAC,OAAO,GAAY,EAAE,CAAC;wBACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;wBAC7D,OAAO,0BAA0B,GAAG,EAAE,CAAC;oBACzC,CAAC;gBACH,CAAC;gBAED,KAAK,KAAK,CAAC,CAAC,CAAC;oBACX,IAAI,CAAC,GAAG;wBAAE,OAAO,wCAAwC,CAAC;oBAC1D,IAAI,CAAC,OAAO;wBAAE,OAAO,4CAA4C,CAAC;oBAElE,IAAI,CAAC;wBACH,IAAA,qBAAY,EAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;wBACtC,MAAM,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC7E,MAAM,MAAM,GACV,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACtF,OAAO,6BAA6B,GAAG,gBAAgB,OAAO,GAAG,OAAO,GAAG,MAAM,gDAAgD,CAAC;oBACpI,CAAC;oBAAC,OAAO,GAAY,EAAE,CAAC;wBACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;wBAC7D,OAAO,wBAAwB,GAAG,EAAE,CAAC;oBACvC,CAAC;gBACH,CAAC;gBAED,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACd,IAAI,CAAC,GAAG;wBAAE,OAAO,2CAA2C,CAAC;oBAE7D,IAAI,CAAC;wBACH,IAAA,wBAAe,EAAC,GAAG,CAAC,CAAC;wBACrB,OAAO,eAAe,GAAG,wDAAwD,CAAC;oBACpF,CAAC;oBAAC,OAAO,GAAY,EAAE,CAAC;wBACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;wBAC7D,OAAO,0BAA0B,GAAG,EAAE,CAAC;oBACzC,CAAC;gBACH,CAAC;gBAED,KAAK,KAAK,CAAC,CAAC,CAAC;oBACX,IAAI,CAAC,GAAG;wBAAE,OAAO,wCAAwC,CAAC;oBAE1D,IAAI,CAAC;wBACH,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,GAAG,CAAC,CAAC;wBACjC,IAAI,CAAC,MAAM,EAAE,CAAC;4BACZ,MAAM,OAAO,GAAG,IAAA,uBAAc,GAAE,CAAC;4BACjC,MAAM,IAAI,GACR,OAAO,CAAC,MAAM,GAAG,CAAC;gCAChB,CAAC,CAAC,uBAAuB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gCAC/D,CAAC,CAAC,yBAAyB,CAAC;4BAChC,OAAO,eAAe,GAAG,eAAe,IAAI,EAAE,CAAC;wBACjD,CAAC;wBAED,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;4BACpB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC;4BACrC,MAAM,UAAU,GACd,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;gCACtD,CAAC,CAAC,gBAAgB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gCAC1D,CAAC,CAAC,EAAE,CAAC;4BACT,OAAO,eAAe,GAAG,cAAc,MAAM,CAAC,GAAG,kBAAkB,OAAO,GAAG,UAAU,EAAE,CAAC;wBAC5F,CAAC;wBAED,MAAM,OAAO,GACX,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACpF,MAAM,MAAM,GACV,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC;4BAC9C,CAAC,CAAC,YAAY,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;iCACnC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;iCAC5B,IAAI,CAAC,IAAI,CAAC,EAAE;4BACjB,CAAC,CAAC,EAAE,CAAC;wBACT,OAAO,eAAe,GAAG,kBAAkB,MAAM,CAAC,OAAO,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC;oBACjF,CAAC;oBAAC,OAAO,GAAY,EAAE,CAAC;wBACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;wBAC7D,OAAO,yBAAyB,GAAG,EAAE,CAAC;oBACxC,CAAC;gBACH,CAAC;gBAED;oBACE,OAAO,mBAAmB,MAAM,EAAE,CAAC;YACvC,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/memory.d.ts

@@ -1,5 +1,12 @@
 import { z } from 'zod';
 import type { MemoryStore } from '../memory.js';
+/**
+ * Creates the persistent memory tool backed by on-disk markdown files.
+ *
+ * Supports list, read, write, and delete actions for cross-session recall.
+ *
+ * @param memoryStore - The backing MemoryStore instance.
+ */
 export declare function createMemoryTool(memoryStore: MemoryStore): import("ai").Tool<z.ZodObject<{
     action: z.ZodEnum<["list", "read", "write", "delete"]>;
     key: z.ZodOptional<z.ZodString>;
@@ -19,6 +26,13 @@ export declare function createMemoryTool(memoryStore: MemoryStore): import("ai")
         content?: string | undefined;
     }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
 };
+/**
+ * Creates the session-scoped scratch-pad tool for tracking intermediate work.
+ *
+ * Scratch notes survive context compression but are discarded when the session ends.
+ *
+ * @param memoryStore - The backing MemoryStore instance.
+ */
 export declare function createScratchTool(memoryStore: MemoryStore): import("ai").Tool<z.ZodObject<{
     action: z.ZodEnum<["list", "read", "write", "delete"]>;
     key: z.ZodOptional<z.ZodString>;

package/dist/tools/memory.js

@@ -4,9 +4,17 @@ exports.createMemoryTool = createMemoryTool;
 exports.createScratchTool = createScratchTool;
 const ai_1 = require("ai");
 const zod_1 = require("zod");
+const paths_js_1 = require("../paths.js");
+/**
+ * Creates the persistent memory tool backed by on-disk markdown files.
+ *
+ * Supports list, read, write, and delete actions for cross-session recall.
+ *
+ * @param memoryStore - The backing MemoryStore instance.
+ */
 function createMemoryTool(memoryStore) {
     return (0, ai_1.tool)({
-        description: 'Persistent memory that survives across sessions. Use this to remember user preferences, project knowledge, or anything worth recalling later. Stored as files on disk at ~/.bernard/memory/.',
+        description: `Persistent memory that survives across sessions. Use this to remember user preferences, project knowledge, or anything worth recalling later. Stored as files on disk at ${paths_js_1.MEMORY_DIR}.`,
         parameters: zod_1.z.object({
             action: zod_1.z.enum(['list', 'read', 'write', 'delete']).describe('The action to perform'),
             key: zod_1.z.string().optional().describe('The memory key (required for read/write/delete)'),
@@ -50,6 +58,13 @@ function createMemoryTool(memoryStore) {
         },
     });
 }
+/**
+ * Creates the session-scoped scratch-pad tool for tracking intermediate work.
+ *
+ * Scratch notes survive context compression but are discarded when the session ends.
+ *
+ * @param memoryStore - The backing MemoryStore instance.
+ */
 function createScratchTool(memoryStore) {
     return (0, ai_1.tool)({
         description: 'Session scratch notes for tracking complex task progress, intermediate findings, and working plans. These notes survive context compression but are discarded when the session ends. Use this to keep track of multi-step work within a single session.',

package/dist/tools/memory.js.map

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

package/dist/tools/routine.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { RoutineStore } from '../routines.js';
+/**
+ * Creates the routine management tool for saving and retrieving reusable multi-step workflows.
+ *
+ * Routines are named procedures (deploy, release, onboarding, etc.) that the user can
+ * teach Bernard and later invoke via `/{routine-id}` in the REPL.
+ */
+export declare function createRoutineTool(routineStore?: RoutineStore): import("ai").Tool<z.ZodObject<{
+    action: z.ZodEnum<["create", "update", "list", "read", "delete"]>;
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    content: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    action: "list" | "read" | "delete" | "update" | "create";
+    content?: string | undefined;
+    name?: string | undefined;
+    id?: string | undefined;
+    description?: string | undefined;
+}, {
+    action: "list" | "read" | "delete" | "update" | "create";
+    content?: string | undefined;
+    name?: string | undefined;
+    id?: string | undefined;
+    description?: string | undefined;
+}>, string> & {
+    execute: (args: {
+        action: "list" | "read" | "delete" | "update" | "create";
+        content?: string | undefined;
+        name?: string | undefined;
+        id?: string | undefined;
+        description?: string | undefined;
+    }, options: import("ai").ToolExecutionOptions) => PromiseLike<string>;
+};