shadow-claw 1.40.0 → 1.40.1

package/src/core/orchestrator/utils/setupPushTaskListener.test.ts

@@ -61,6 +61,18 @@ describe("setupPushTaskListener", () => {
         {} as ShadowClawDatabase,
       ),
     ).not.toThrow();
+
+    Object.defineProperty(global, "navigator", {
+      value: {},
+      configurable: true,
+    });
+
+    expect(() =>
+      setupPushTaskListener(
+        mockOrchestrator as Orchestrator,
+        {} as ShadowClawDatabase,
+      ),
+    ).not.toThrow();
   });
 
   it("should register a message listener if serviceWorker exists", () => {
@@ -203,6 +215,52 @@ describe("setupPushTaskListener", () => {
       );
     });
 
+    it("should ignore events without data or without groupId", () => {
+      listener({ data: null });
+      listener({ data: { type: "scheduled-task-trigger", taskId: "t1" } });
+      expect(mockOrchestrator.schedulerTriggeredGroups?.size).toBe(0);
+    });
+
+    it("should create default taskId and prompt for tool task when omitted", async () => {
+      mockOrchestratorStore.tasks = [];
+
+      listener({
+        data: {
+          type: "scheduled-task-trigger",
+          groupId: "g2",
+          taskType: "tools",
+          tools: ["t1"],
+        },
+      });
+
+      await new Promise(process.nextTick);
+
+      expect(mockOrchestratorStore.runTask).toHaveBeenCalledWith(
+        expect.objectContaining({
+          groupId: "g2",
+          type: "tools",
+          tools: ["t1"],
+          prompt: "",
+        }),
+      );
+    });
+
+    it("should do nothing if neither task, tools, nor prompt are present", async () => {
+      mockOrchestratorStore.tasks = [];
+
+      listener({
+        data: {
+          type: "scheduled-task-trigger",
+          groupId: "g-empty",
+        },
+      });
+
+      await new Promise(process.nextTick);
+
+      expect(mockOrchestratorStore.runTask).not.toHaveBeenCalled();
+      expect(mockSubmitMessage).not.toHaveBeenCalled();
+    });
+
     it("should handle error in runTaskHandler", async () => {
       mockOrchestratorStore.tasks = [];
       mockSubmitMessage.mockImplementation(() => {

package/src/core/orchestrator/utils/syncWebMcpRegistration.test.ts

@@ -1,34 +1,72 @@
 import { beforeEach, describe, expect, it, jest } from "@jest/globals";
 
-const mockRegisterWebMcpTools = jest.fn() as any;
-const mockUnregisterWebMcpTools = jest.fn() as any;
+import { CONFIG_KEYS } from "../../../config/config.js";
+import type { ShadowClawDatabase } from "../../../db/db.js";
+import type { DeclarativeToolDefinition } from "../../../subsystems/tools/declarative.js";
+import type { SkillRecord } from "../../../subsystems/skills/types.js";
+import type { ToolDefinition } from "../../../subsystems/tools/tools.js";
+import type { WebMcpMode } from "../../../subsystems/mcp/webmcp.js";
+import { activate_skill } from "../../../subsystems/skills/tool.js";
+import type { Orchestrator } from "../orchestrator.js";
+
+const mockRegisterWebMcpTools = jest
+  .fn<
+    (
+      worker: Worker | null,
+      onMessage: (msg: unknown) => Promise<void>,
+      activeGroupId: string,
+      tools: ToolDefinition[],
+    ) => Promise<void>
+  >()
+  .mockResolvedValue(undefined);
+
+const mockUnregisterWebMcpTools = jest.fn<() => void>();
+const mockApplyWebMcpMode = jest.fn<(mode: WebMcpMode) => void>();
 
 jest.unstable_mockModule("../../../subsystems/mcp/webmcp.js", () => ({
   registerWebMcpTools: mockRegisterWebMcpTools,
   unregisterWebMcpTools: mockUnregisterWebMcpTools,
-  setWebMcpMode: jest.fn(),
+  setWebMcpMode: mockApplyWebMcpMode,
 }));
 
-const mockHandleWorkerMessage = jest.fn() as any;
+const mockHandleWorkerMessage = jest
+  .fn<
+    (
+      orchestrator: Orchestrator,
+      db: ShadowClawDatabase,
+      msg: unknown,
+    ) => Promise<void>
+  >()
+  .mockResolvedValue(undefined);
+
 jest.unstable_mockModule("./handleWorkerMessage.js", () => ({
   handleWorkerMessage: mockHandleWorkerMessage,
 }));
 
 jest.unstable_mockModule("../../effect.js", () => ({
-  effect: (cb: any) => {
+  effect: (cb: () => void) => {
     cb();
     return jest.fn();
   },
 }));
 
-jest.unstable_mockModule("../../../stores/orchestrator.js", () => ({
-  orchestratorStore: {
-    activeGroupId: "group1",
-    groups: [{ groupId: "group1", toolTags: ["tool1"] }, { groupId: "group2" }],
-  },
+const mockSetConfig = jest
+  .fn<(db: ShadowClawDatabase, key: string, value: string) => Promise<void>>()
+  .mockResolvedValue(undefined);
+
+jest.unstable_mockModule("../../../db/setConfig.js", () => ({
+  setConfig: mockSetConfig,
 }));
 
-const mockDiscoverSkills = jest.fn() as any;
+const mockDiscoverSkills = jest
+  .fn<
+    (
+      db: ShadowClawDatabase,
+      groupId: string,
+    ) => Promise<{ skills: SkillRecord[] }>
+  >()
+  .mockResolvedValue({ skills: [] });
+
 jest.unstable_mockModule(
   "../../../subsystems/skills/discoverSkills.js",
   () => ({
@@ -36,79 +74,147 @@ jest.unstable_mockModule(
   }),
 );
 
-const mockLoadDeclarativeTools = jest.fn() as any;
+const mockLoadDeclarativeTools = jest
+  .fn<
+    (
+      db: ShadowClawDatabase,
+      groupId: string,
+    ) => Promise<{ tools: DeclarativeToolDefinition[] }>
+  >()
+  .mockResolvedValue({ tools: [] });
+
 jest.unstable_mockModule("../../../subsystems/tools/declarative.js", () => ({
   loadDeclarativeTools: mockLoadDeclarativeTools,
 }));
 
+let activeGroupId = "group1";
+const mockGroups: { groupId: string; toolTags?: string[] }[] = [
+  { groupId: "group1", toolTags: ["tool1", "enabled_decl_tool"] },
+  { groupId: "group2" },
+];
+const mockAllTools: ToolDefinition[] = [
+  {
+    name: "tool1",
+    description: "Tool 1",
+    input_schema: { type: "object", properties: {} },
+  },
+  {
+    name: "tool2",
+    description: "Tool 2",
+    input_schema: { type: "object", properties: {} },
+  },
+];
+let mockGlobalTools: ToolDefinition[] = [
+  {
+    name: "tool2",
+    description: "Tool 2",
+    input_schema: { type: "object", properties: {} },
+  },
+];
+let declarativeToolsFail = false;
+
+jest.unstable_mockModule("../../../stores/orchestrator.js", () => ({
+  orchestratorStore: {
+    get activeGroupId() {
+      return activeGroupId;
+    },
+    get groups() {
+      return mockGroups;
+    },
+  },
+}));
+
 jest.unstable_mockModule("../../../stores/tools.js", () => ({
   toolsStore: {
-    allTools: [{ name: "tool1" }, { name: "tool2" }],
-    enabledTools: [{ name: "tool2" }],
+    get allTools() {
+      return mockAllTools;
+    },
+    get enabledTools() {
+      return mockGlobalTools;
+    },
     declarativeTools: [],
     declarativeToolNamesEnabled: null,
-    refreshDeclarativeTools: jest.fn(async (db: any, groupId: any) => {
-      const res = await mockLoadDeclarativeTools(db, groupId);
-      return res?.tools || [];
-    }),
-    isDeclarativeToolEnabled: jest.fn(() => true),
+    refreshDeclarativeTools: jest.fn(
+      async (db: ShadowClawDatabase, gId: string) => {
+        if (declarativeToolsFail) {
+          throw new Error("OPFS declarative tools load failed");
+        }
+        const res = await mockLoadDeclarativeTools(db, gId);
+        return res?.tools || [];
+      },
+    ),
+    isDeclarativeToolEnabled: jest.fn(
+      (name: string) => name === "enabled_decl_tool",
+    ),
   },
 }));
 
-const { syncWebMcpRegistration } = await import("./syncWebMcpRegistration.js");
+const { syncWebMcpRegistration, setWebMcpMode, setWebMcpToolsEnabled } =
+  await import("./syncWebMcpRegistration.js");
+
+interface MockOrchestrator {
+  webMcpEffectCleanup: (() => void) | null;
+  webMcpToolsEnabled: boolean;
+  webMcpRegistrationLock: Promise<void>;
+  agentWorker: Worker | null;
+}
 
 describe("syncWebMcpRegistration", () => {
-  let mockOrchestrator: any;
-  let mockDb: any;
+  let mockOrchestrator: MockOrchestrator;
+  let mockDb: ShadowClawDatabase;
 
   beforeEach(() => {
     jest.clearAllMocks();
-    mockDb = {};
+    activeGroupId = "group1";
+    declarativeToolsFail = false;
+    mockGlobalTools = [
+      {
+        name: "tool2",
+        description: "Tool 2",
+        input_schema: { type: "object", properties: {} },
+      },
+    ];
+    mockDb = {} as unknown as ShadowClawDatabase;
     mockOrchestrator = {
       webMcpEffectCleanup: jest.fn(),
       webMcpToolsEnabled: true,
       webMcpRegistrationLock: Promise.resolve(),
-      agentWorker: {},
-      handleWorkerMessage: jest.fn(),
+      agentWorker: {} as unknown as Worker,
     };
     mockDiscoverSkills.mockResolvedValue({ skills: [] });
     mockLoadDeclarativeTools.mockResolvedValue({
       tools: [
         {
-          name: "generate_random_number",
-          description: "Generate random number",
+          name: "enabled_decl_tool",
+          description: "Enabled Declarative Tool",
+          input_schema: { type: "object", properties: {} },
+          execution: { type: "bash", command: "echo test" },
+        },
+        {
+          name: "disabled_decl_tool",
+          description: "Disabled Declarative Tool",
+          input_schema: { type: "object", properties: {} },
+          execution: { type: "bash", command: "echo disabled" },
         },
-        { name: "unpinned_decl_tool", description: "Unpinned tool" },
       ],
     });
   });
 
   it("should clean up existing effect and unregister if not enabled", () => {
     mockOrchestrator.webMcpToolsEnabled = false;
+    const cleanupMock = mockOrchestrator.webMcpEffectCleanup!;
 
-    const cleanupMock = mockOrchestrator.webMcpEffectCleanup;
-
-    syncWebMcpRegistration(mockOrchestrator, mockDb);
+    syncWebMcpRegistration(mockOrchestrator as unknown as Orchestrator, mockDb);
 
     expect(cleanupMock).toHaveBeenCalled();
     expect(mockOrchestrator.webMcpEffectCleanup).toBeNull();
     expect(mockUnregisterWebMcpTools).toHaveBeenCalled();
   });
 
-  it("should setup effect and register tools (including declarative tools filtered by toolTags) if enabled", async () => {
-    // Add generate_random_number to group1's toolTags
-    const orchestratorStoreModule =
-      await import("../../../stores/orchestrator.js");
-    orchestratorStoreModule.orchestratorStore.groups[0].toolTags = [
-      "tool1",
-      "generate_random_number",
-    ];
-
-    syncWebMcpRegistration(mockOrchestrator, mockDb);
+  it("should setup effect and register tools filtered by group toolTags", async () => {
+    syncWebMcpRegistration(mockOrchestrator as unknown as Orchestrator, mockDb);
 
     expect(mockOrchestrator.webMcpEffectCleanup).toBeDefined();
-
-    // The effect should run and chain onto webMcpRegistrationLock
     await mockOrchestrator.webMcpRegistrationLock;
 
     expect(mockUnregisterWebMcpTools).toHaveBeenCalled();
@@ -117,47 +223,100 @@ describe("syncWebMcpRegistration", () => {
       expect.any(Function),
       "group1",
       [
-        { name: "tool1" },
         {
-          name: "generate_random_number",
-          description: "Generate random number",
+          name: "tool1",
+          description: "Tool 1",
+          input_schema: { type: "object", properties: {} },
         },
+        expect.objectContaining({
+          name: "enabled_decl_tool",
+          description: "Enabled Declarative Tool",
+        }),
       ],
     );
 
-    // Call the callback to test coverage of handleWorkerMessage
-    const cb = mockRegisterWebMcpTools.mock.calls[0][1];
-    await cb("test message");
+    const onMessageCb = mockRegisterWebMcpTools.mock.calls[0][1];
+    await onMessageCb({ type: "worker-message" });
     expect(mockHandleWorkerMessage).toHaveBeenCalledWith(
-      mockOrchestrator,
+      mockOrchestrator as unknown as Orchestrator,
       mockDb,
-      "test message",
+      { type: "worker-message" },
     );
   });
 
-  it("should handle error in registration lock promise", async () => {
-    mockRegisterWebMcpTools.mockRejectedValueOnce(new Error("Test error"));
-    const consoleError = jest
-      .spyOn(console, "error")
-      .mockImplementation(() => {});
+  it("should register globalTools and enabledDeclarativeTools when group has no toolTags", async () => {
+    activeGroupId = "group2";
+
+    syncWebMcpRegistration(mockOrchestrator as unknown as Orchestrator, mockDb);
+    await mockOrchestrator.webMcpRegistrationLock;
+
+    expect(mockRegisterWebMcpTools).toHaveBeenCalledWith(
+      mockOrchestrator.agentWorker,
+      expect.any(Function),
+      "group2",
+      [
+        {
+          name: "tool2",
+          description: "Tool 2",
+          input_schema: { type: "object", properties: {} },
+        },
+        expect.objectContaining({
+          name: "enabled_decl_tool",
+          description: "Enabled Declarative Tool",
+        }),
+      ],
+    );
+  });
 
-    syncWebMcpRegistration(mockOrchestrator, mockDb);
+  it("should register globalTools and enabledDeclarativeTools when activeGroupId is not found in groups", async () => {
+    activeGroupId = "unknown-group";
 
+    syncWebMcpRegistration(mockOrchestrator as unknown as Orchestrator, mockDb);
     await mockOrchestrator.webMcpRegistrationLock;
-    expect(consoleError).toHaveBeenCalledWith(
-      "WebMCP registration failed:",
-      expect.any(Error),
+
+    expect(mockRegisterWebMcpTools).toHaveBeenCalledWith(
+      mockOrchestrator.agentWorker,
+      expect.any(Function),
+      "unknown-group",
+      [
+        {
+          name: "tool2",
+          description: "Tool 2",
+          input_schema: { type: "object", properties: {} },
+        },
+        expect.objectContaining({
+          name: "enabled_decl_tool",
+          description: "Enabled Declarative Tool",
+        }),
+      ],
     );
+  });
 
-    consoleError.mockRestore();
+  it("should ignore OPFS load errors in refreshDeclarativeTools and discoverSkills", async () => {
+    declarativeToolsFail = true;
+    mockDiscoverSkills.mockRejectedValueOnce(new Error("OPFS skills failure"));
+
+    syncWebMcpRegistration(mockOrchestrator as unknown as Orchestrator, mockDb);
+    await mockOrchestrator.webMcpRegistrationLock;
+
+    expect(mockRegisterWebMcpTools).toHaveBeenCalled();
   });
 
-  it("should append activate_skill tool to WebMCP tools when skills are discovered", async () => {
-    mockDiscoverSkills.mockResolvedValue({
-      skills: [{ name: "my-skill", description: "My custom skill" }],
+  it("should append activate_skill when skills are discovered and tool is not present", async () => {
+    mockDiscoverSkills.mockResolvedValueOnce({
+      skills: [
+        {
+          name: "test-skill",
+          description: "Test skill description",
+          path: "skills/test/SKILL.md",
+          basePath: "skills/test",
+          userInvocable: true,
+          disableModelInvocation: false,
+        },
+      ],
     });
 
-    syncWebMcpRegistration(mockOrchestrator, mockDb);
+    syncWebMcpRegistration(mockOrchestrator as unknown as Orchestrator, mockDb);
     await mockOrchestrator.webMcpRegistrationLock;
 
     expect(mockRegisterWebMcpTools).toHaveBeenCalledWith(
@@ -169,4 +328,121 @@ describe("syncWebMcpRegistration", () => {
       ]),
     );
   });
+
+  it("should not duplicate activate_skill if already present in tool list", async () => {
+    mockDiscoverSkills.mockResolvedValueOnce({
+      skills: [
+        {
+          name: "test-skill",
+          description: "Test skill description",
+          path: "skills/test/SKILL.md",
+          basePath: "skills/test",
+          userInvocable: true,
+          disableModelInvocation: false,
+        },
+      ],
+    });
+    activeGroupId = "group2";
+    mockGlobalTools = [
+      {
+        name: "tool2",
+        description: "Tool 2",
+        input_schema: { type: "object", properties: {} },
+      },
+      activate_skill,
+    ];
+
+    syncWebMcpRegistration(mockOrchestrator as unknown as Orchestrator, mockDb);
+    await mockOrchestrator.webMcpRegistrationLock;
+
+    const registeredTools = mockRegisterWebMcpTools.mock.calls[0][3];
+    const activateSkillCount = registeredTools.filter(
+      (t) => t.name === "activate_skill",
+    ).length;
+    expect(activateSkillCount).toBe(1);
+  });
+
+  it("should catch and log errors in registration lock promise", async () => {
+    mockRegisterWebMcpTools.mockRejectedValueOnce(
+      new Error("Registration error"),
+    );
+    const consoleError = jest
+      .spyOn(console, "error")
+      .mockImplementation(() => {});
+
+    syncWebMcpRegistration(mockOrchestrator as unknown as Orchestrator, mockDb);
+    await mockOrchestrator.webMcpRegistrationLock;
+
+    expect(consoleError).toHaveBeenCalledWith(
+      "WebMCP registration failed:",
+      expect.any(Error),
+    );
+    consoleError.mockRestore();
+  });
+
+  it("should proceed without calling cleanup if webMcpEffectCleanup is null", async () => {
+    mockOrchestrator.webMcpEffectCleanup = null;
+
+    syncWebMcpRegistration(mockOrchestrator as unknown as Orchestrator, mockDb);
+    await mockOrchestrator.webMcpRegistrationLock;
+
+    expect(mockRegisterWebMcpTools).toHaveBeenCalled();
+  });
+
+  describe("setWebMcpMode", () => {
+    it("should unregister tools, apply mode, save config, and trigger sync", async () => {
+      const syncDeps = {
+        orchestrator: mockOrchestrator as unknown as Orchestrator,
+      };
+
+      await setWebMcpMode(mockOrchestrator, mockDb, "native", syncDeps);
+      await mockOrchestrator.webMcpRegistrationLock;
+
+      expect(mockUnregisterWebMcpTools).toHaveBeenCalled();
+      expect(mockApplyWebMcpMode).toHaveBeenCalledWith("native");
+      expect(mockSetConfig).toHaveBeenCalledWith(
+        mockDb,
+        CONFIG_KEYS.WEBMCP_MODE,
+        "native",
+      );
+      expect(mockRegisterWebMcpTools).toHaveBeenCalled();
+    });
+  });
+
+  describe("setWebMcpToolsEnabled", () => {
+    it("should update enabled state to true, persist config, and sync", async () => {
+      mockOrchestrator.webMcpToolsEnabled = false;
+      const syncDeps = {
+        orchestrator: mockOrchestrator as unknown as Orchestrator,
+      };
+
+      await setWebMcpToolsEnabled(mockOrchestrator, mockDb, true, syncDeps);
+      await mockOrchestrator.webMcpRegistrationLock;
+
+      expect(mockOrchestrator.webMcpToolsEnabled).toBe(true);
+      expect(mockSetConfig).toHaveBeenCalledWith(
+        mockDb,
+        CONFIG_KEYS.WEBMCP_TOOLS_ENABLED,
+        "true",
+      );
+      expect(mockRegisterWebMcpTools).toHaveBeenCalled();
+    });
+
+    it("should update enabled state to false, persist config, and sync", async () => {
+      mockOrchestrator.webMcpToolsEnabled = true;
+      const syncDeps = {
+        orchestrator: mockOrchestrator as unknown as Orchestrator,
+      };
+
+      await setWebMcpToolsEnabled(mockOrchestrator, mockDb, false, syncDeps);
+
+      expect(mockOrchestrator.webMcpToolsEnabled).toBe(false);
+      expect(mockSetConfig).toHaveBeenCalledWith(
+        mockDb,
+        CONFIG_KEYS.WEBMCP_TOOLS_ENABLED,
+        "false",
+      );
+      expect(mockUnregisterWebMcpTools).toHaveBeenCalled();
+    });
+  });
 });

package/src/core/orchestrator/utils/syncWebMcpRegistration.ts

@@ -14,6 +14,8 @@ import { CONFIG_KEYS } from "../../../config/config.js";
 import { setConfig } from "../../../db/setConfig.js";
 
 import type { ShadowClawDatabase } from "../../../db/db.js";
+import type { DeclarativeToolDefinition } from "../../../subsystems/tools/declarative.js";
+import type { SkillRecord } from "../../../subsystems/skills/types.js";
 import type { WebMcpMode } from "../../../subsystems/mcp/webmcp.js";
 import type { OrchestratorState } from "../orchestrator-state.js";
 import type { Orchestrator } from "../orchestrator.js";
@@ -60,7 +62,7 @@ export function syncWebMcpRegistration(
         // Small delay to allow the browser's ModelContext to process the unregistrations.
         await new Promise((resolve) => setTimeout(resolve, 0));
 
-        let declarativeTools: any[] = [];
+        let declarativeTools: DeclarativeToolDefinition[] = [];
         try {
           declarativeTools = await toolsStore.refreshDeclarativeTools(
             db,
@@ -80,7 +82,7 @@ export function syncWebMcpRegistration(
             ? candidateTools.filter((t) => group.toolTags!.includes(t.name))
             : [...globalTools, ...enabledDeclarativeTools];
 
-        let skillDiscovery: { skills: any[] } = { skills: [] };
+        let skillDiscovery: { skills: SkillRecord[] } = { skills: [] };
         try {
           skillDiscovery = await discoverSkills(db, activeGroupId);
         } catch {

package/src/server/routes/mcp.ts

@@ -256,7 +256,7 @@ export function registerMcpRoutes(
         name: "shadow-claw",
         version: getPackageVersion(),
         description:
-          "Browser-native personal AI assistant with local and remote LLM orchestration, Web Workers, OPFS storage, and agentic tool execution.",
+          "Multi-runtime AI assistant with local and remote LLM orchestration, Web Workers, OPFS storage, and agentic tool execution.",
         title: "ShadowClaw MCP Server",
         websiteUrl: `${origin}/shadow-claw/`,
         repository: {
@@ -332,7 +332,7 @@ export function registerMcpRoutes(
         servers: [
           {
             name: "shadow-claw",
-            description: "ShadowClaw Browser-Native AI Assistant MCP Server",
+            description: "ShadowClaw Multi-Runtime AI Assistant MCP Server",
             endpoint: `${origin}/mcp`,
             capabilities: ["tools", "extensions"],
             card: `${origin}/.well-known/mcp.json`,

package/src/stores/file-viewer.test.ts

@@ -155,4 +155,15 @@ describe("FileViewerStore", () => {
       mimeType: "text/plain",
     });
   });
+
+  it("handles empty path and extension-less filenames", async () => {
+    (readGroupFile as any).mockResolvedValue("empty-content");
+    const s = new FileViewerStore();
+
+    expect(s.getPreviewBinaryMimeType("")).toBe("");
+    expect(s.getPreviewBinaryMimeType("noextension")).toBe("");
+
+    await s.openFile({} as any, "");
+    expect(s.file?.name).toBe("");
+  });
 });