@tyvm/knowhow 0.0.82 → 0.0.84

package/ts_build/src/workers/tools/unlock.d.ts

@@ -0,0 +1,18 @@
+import { Tool } from "../../clients/types";
+import { WorkerPasskeyAuthService } from "../auth/WorkerPasskeyAuth";
+export interface UnlockToolParams {
+    signature?: string;
+    credentialId?: string;
+    authenticatorData?: string;
+    clientDataJSON?: string;
+    challenge?: string;
+}
+export declare function makeUnlockTool(authService: WorkerPasskeyAuthService): {
+    unlock: (params?: UnlockToolParams) => Promise<{
+        success: boolean;
+        message: string;
+        challenge?: string;
+        credentialId?: string;
+    }>;
+    unlockDefinition: Tool;
+};

package/ts_build/src/workers/tools/unlock.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeUnlockTool = void 0;
+function makeUnlockTool(authService) {
+    async function unlock(params = {}) {
+        const hasAssertion = params.signature &&
+            params.credentialId &&
+            params.authenticatorData &&
+            params.clientDataJSON &&
+            params.challenge;
+        if (!hasAssertion) {
+            const challenge = authService.generateChallenge();
+            return {
+                success: false,
+                challenge,
+                credentialId: authService.getCredentialId(),
+                message: "Sign this challenge with your passkey and call unlock again with the assertion data.",
+            };
+        }
+        const result = await authService.unlock({
+            signature: params.signature,
+            credentialId: params.credentialId,
+            authenticatorData: params.authenticatorData,
+            clientDataJSON: params.clientDataJSON,
+            challenge: params.challenge,
+        });
+        if (result.success) {
+            const info = authService.getSessionInfo();
+            return {
+                success: true,
+                message: `Worker unlocked successfully. Session expires at ${info.expiresAt}.`,
+            };
+        }
+        return {
+            success: false,
+            message: `Unlock failed: ${result.reason}`,
+        };
+    }
+    const unlockDefinition = {
+        type: "function",
+        function: {
+            name: "unlock",
+            description: "Unlock the worker using a passkey. " +
+                "Call with NO parameters to receive a challenge string. " +
+                "Then sign the challenge via the browser WebAuthn API (navigator.credentials.get) and call again with the assertion data to unlock. " +
+                "All other tools are blocked until the worker is unlocked.",
+            parameters: {
+                type: "object",
+                properties: {
+                    signature: {
+                        type: "string",
+                        description: "base64url-encoded signature from WebAuthn assertion response.signature",
+                    },
+                    credentialId: {
+                        type: "string",
+                        description: "base64url-encoded credential ID from WebAuthn assertion",
+                    },
+                    authenticatorData: {
+                        type: "string",
+                        description: "base64url-encoded authenticatorData from WebAuthn assertion response.authenticatorData",
+                    },
+                    clientDataJSON: {
+                        type: "string",
+                        description: "base64url-encoded clientDataJSON from WebAuthn assertion response.clientDataJSON",
+                    },
+                    challenge: {
+                        type: "string",
+                        description: "The challenge string returned by the first unlock() call (base64url)",
+                    },
+                },
+                required: [],
+            },
+        },
+    };
+    return { unlock, unlockDefinition };
+}
+exports.makeUnlockTool = makeUnlockTool;
+//# sourceMappingURL=unlock.js.map

package/ts_build/src/workers/tools/unlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlock.js","sourceRoot":"","sources":["../../../../src/workers/tools/unlock.ts"],"names":[],"mappings":";;;AAyBA,SAAgB,cAAc,CAAC,WAAqC;IAClE,KAAK,UAAU,MAAM,CACnB,SAA2B,EAAE;QAE7B,MAAM,YAAY,GAChB,MAAM,CAAC,SAAS;YAChB,MAAM,CAAC,YAAY;YACnB,MAAM,CAAC,iBAAiB;YACxB,MAAM,CAAC,cAAc;YACrB,MAAM,CAAC,SAAS,CAAC;QAGnB,IAAI,CAAC,YAAY,EAAE;YACjB,MAAM,SAAS,GAAG,WAAW,CAAC,iBAAiB,EAAE,CAAC;YAClD,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,SAAS;gBACT,YAAY,EAAE,WAAW,CAAC,eAAe,EAAE;gBAC3C,OAAO,EACL,sFAAsF;aACzF,CAAC;SACH;QAGD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC;YACtC,SAAS,EAAE,MAAM,CAAC,SAAU;YAC5B,YAAY,EAAE,MAAM,CAAC,YAAa;YAClC,iBAAiB,EAAE,MAAM,CAAC,iBAAkB;YAC5C,cAAc,EAAE,MAAM,CAAC,cAAe;YACtC,SAAS,EAAE,MAAM,CAAC,SAAU;SAC7B,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,OAAO,EAAE;YAClB,MAAM,IAAI,GAAG,WAAW,CAAC,cAAc,EAAE,CAAC;YAC1C,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,oDAAoD,IAAI,CAAC,SAAS,GAAG;aAC/E,CAAC;SACH;QAED,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,kBAAkB,MAAM,CAAC,MAAM,EAAE;SAC3C,CAAC;IACJ,CAAC;IAED,MAAM,gBAAgB,GAAS;QAC7B,IAAI,EAAE,UAAmB;QACzB,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,qCAAqC;gBACrC,yDAAyD;gBACzD,qIAAqI;gBACrI,2DAA2D;YAC7D,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,SAAS,EAAE;wBACT,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,wEAAwE;qBAC3E;oBACD,YAAY,EAAE;wBACZ,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,yDAAyD;qBAC5D;oBACD,iBAAiB,EAAE;wBACjB,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,wFAAwF;qBAC3F;oBACD,cAAc,EAAE;wBACd,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,kFAAkF;qBACrF;oBACD,SAAS,EAAE;wBACT,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,sEAAsE;qBACzE;iBACF;gBACD,QAAQ,EAAE,EAAE;aACb;SACF;KACF,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;AACtC,CAAC;AA1FD,wCA0FC"}

package/ts_build/tests/unit/modules/moduleLoading.test.d.ts

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

package/ts_build/tests/unit/modules/moduleLoading.test.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+jest.mock("../../../src/config", () => ({
+    getConfig: jest.fn(),
+    getGlobalConfig: jest.fn(),
+    getConfigSync: jest.fn().mockReturnValue({}),
+}));
+jest.mock("../../../src/clients", () => ({
+    AIClient: jest.fn(),
+    Clients: jest.fn(),
+}));
+jest.mock("../../../src/services", () => ({
+    services: jest.fn().mockReturnValue({
+        Clients: {},
+        Plugins: {},
+        Agents: {},
+        Tools: {},
+    }),
+}));
+const modules_1 = require("../../../src/services/modules");
+const config_1 = require("../../../src/config");
+const mockGetConfig = config_1.getConfig;
+const mockGetGlobalConfig = config_1.getGlobalConfig;
+function makeContext(overrides) {
+    return {
+        Agents: {
+            registerAgent: jest.fn(),
+        },
+        Plugins: {
+            registerPlugin: jest.fn(),
+            loadPluginsFromConfig: jest.fn().mockResolvedValue(undefined),
+        },
+        Clients: {
+            registerClient: jest.fn(),
+            registerModels: jest.fn(),
+        },
+        Tools: {
+            addTool: jest.fn(),
+            setFunction: jest.fn(),
+        },
+        ...overrides,
+    };
+}
+function makeModule(overrides) {
+    return {
+        init: jest.fn().mockResolvedValue(undefined),
+        agents: [],
+        tools: [],
+        plugins: [],
+        clients: [],
+        commands: [],
+        ...overrides,
+    };
+}
+describe("ModulesService.loadModulesFromConfig", () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+        mockGetConfig.mockResolvedValue({ modules: [] });
+        mockGetGlobalConfig.mockResolvedValue({ modules: [] });
+    });
+    it("should load agents from a module", async () => {
+        const mockAgent = { name: "TestAgent" };
+        const mockModule = makeModule({ agents: [mockAgent] });
+        mockGetConfig.mockResolvedValue({
+            modules: ["./test-module"],
+        });
+        const service = new modules_1.ModulesService();
+        const context = makeContext();
+        const requireSpy = jest.spyOn(service, "loadModulesFromConfig")
+            .mockImplementation(async (ctx) => {
+            const resolvedCtx = ctx || context;
+            await mockModule.init({ config: {}, cwd: process.cwd() });
+            for (const agent of mockModule.agents) {
+                resolvedCtx.Agents.registerAgent(agent);
+            }
+        });
+        await service.loadModulesFromConfig(context);
+        expect(context.Agents.registerAgent).toHaveBeenCalledWith(mockAgent);
+        requireSpy.mockRestore();
+    });
+    it("should load tools from a module", async () => {
+        const mockToolDef = {
+            type: "function",
+            function: {
+                name: "myTool",
+                description: "A test tool",
+                parameters: { type: "object", properties: {}, required: [] },
+            },
+        };
+        const mockToolHandler = jest.fn();
+        const mockModule = makeModule({
+            tools: [{ name: "myTool", handler: mockToolHandler, definition: mockToolDef }],
+        });
+        const service = new modules_1.ModulesService();
+        const context = makeContext();
+        const spy = jest.spyOn(service, "loadModulesFromConfig")
+            .mockImplementation(async (ctx) => {
+            const resolvedCtx = ctx || context;
+            await mockModule.init({ config: {}, cwd: process.cwd() });
+            for (const tool of mockModule.tools) {
+                resolvedCtx.Tools.addTool(tool.definition);
+                resolvedCtx.Tools.setFunction(tool.definition.function.name, tool.handler);
+            }
+        });
+        await service.loadModulesFromConfig(context);
+        expect(context.Tools.addTool).toHaveBeenCalledWith(mockToolDef);
+        expect(context.Tools.setFunction).toHaveBeenCalledWith("myTool", mockToolHandler);
+        spy.mockRestore();
+    });
+    it("should load plugins from a module", async () => {
+        const mockPlugin = {
+            meta: { key: "test-plugin", name: "Test Plugin" },
+            isEnabled: () => true,
+            enable: () => { },
+            disable: () => { },
+            call: () => Promise.resolve(""),
+            callMany: () => Promise.resolve(""),
+            embed: () => Promise.resolve([]),
+        };
+        const mockModule = makeModule({
+            plugins: [{ name: "test-plugin", plugin: mockPlugin }],
+        });
+        const service = new modules_1.ModulesService();
+        const context = makeContext();
+        const spy = jest.spyOn(service, "loadModulesFromConfig")
+            .mockImplementation(async (ctx) => {
+            const resolvedCtx = ctx || context;
+            await mockModule.init({ config: {}, cwd: process.cwd() });
+            for (const plugin of mockModule.plugins) {
+                resolvedCtx.Plugins.registerPlugin(plugin.name, plugin.plugin);
+            }
+        });
+        await service.loadModulesFromConfig(context);
+        expect(context.Plugins.registerPlugin).toHaveBeenCalledWith("test-plugin", mockPlugin);
+        spy.mockRestore();
+    });
+    it("should call loadPluginsFromConfig with both global and local configs", async () => {
+        const localConfig = {
+            modules: [],
+            pluginPackages: { asana: "@knowhow/plugin-asana" },
+        };
+        const globalConfig = {
+            modules: [],
+            pluginPackages: { linear: "@knowhow/plugin-linear" },
+        };
+        mockGetConfig.mockResolvedValue(localConfig);
+        mockGetGlobalConfig.mockResolvedValue(globalConfig);
+        const service = new modules_1.ModulesService();
+        const context = makeContext();
+        await service.loadModulesFromConfig(context);
+        expect(context.Plugins.loadPluginsFromConfig).toHaveBeenCalledTimes(2);
+        expect(context.Plugins.loadPluginsFromConfig).toHaveBeenCalledWith(localConfig);
+        expect(context.Plugins.loadPluginsFromConfig).toHaveBeenCalledWith(globalConfig);
+    });
+    it("should load modules from both global and local config paths", async () => {
+        const globalModule = makeModule({ agents: [{ name: "GlobalAgent" }] });
+        const localModule = makeModule({ agents: [{ name: "LocalAgent" }] });
+        mockGetConfig.mockResolvedValue({
+            modules: ["./local-module"],
+        });
+        mockGetGlobalConfig.mockResolvedValue({
+            modules: ["./global-module"],
+        });
+        const service = new modules_1.ModulesService();
+        const context = makeContext();
+        const loadedPaths = [];
+        const spy = jest.spyOn(service, "loadModulesFromConfig")
+            .mockImplementation(async (ctx) => {
+            const resolvedCtx = ctx || context;
+            for (const [path, mod] of [
+                ["./global-module", globalModule],
+                ["./local-module", localModule],
+            ]) {
+                loadedPaths.push(path);
+                await mod.init({ config: {}, cwd: process.cwd() });
+                for (const agent of mod.agents) {
+                    resolvedCtx.Agents.registerAgent(agent);
+                }
+            }
+        });
+        await service.loadModulesFromConfig(context);
+        expect(loadedPaths).toEqual(["./global-module", "./local-module"]);
+        expect(context.Agents.registerAgent).toHaveBeenCalledTimes(2);
+        spy.mockRestore();
+    });
+});
+//# sourceMappingURL=moduleLoading.test.js.map

package/ts_build/tests/unit/modules/moduleLoading.test.js.map

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

package/ts_build/tests/unit/plugins/pluginLoading.test.d.ts

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

package/ts_build/tests/unit/plugins/pluginLoading.test.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const plugins_1 = require("../../../src/plugins/plugins");
+function makeContext() {
+    return {
+        Events: {
+            on: jest.fn(),
+            emit: jest.fn(),
+            emitBlocking: jest.fn(),
+            emitNonBlocking: jest.fn(),
+        },
+    };
+}
+describe("PluginService.loadPlugin", () => {
+    it("should register the plugin under its meta.key", async () => {
+        const service = new plugins_1.PluginService(makeContext());
+        const mockKey = "test-plugin";
+        service.loadPlugin = jest.fn().mockImplementation(async (_spec) => {
+            const instance = {
+                meta: { key: mockKey, name: "Test Plugin" },
+                isEnabled: () => true,
+                enable: () => { },
+                disable: () => { },
+                call: () => Promise.resolve(""),
+                callMany: () => Promise.resolve(""),
+                embed: () => Promise.resolve([]),
+            };
+            service.pluginMap.set(instance.meta.key, instance);
+            return instance.meta.key;
+        });
+        const key = await service.loadPlugin("some-package");
+        expect(key).toBe(mockKey);
+        expect(service.isPlugin(mockKey)).toBe(true);
+    });
+    it("should call getPlugin after loading", async () => {
+        const service = new plugins_1.PluginService(makeContext());
+        const mockKey = "my-plugin";
+        service.loadPlugin = jest.fn().mockImplementation(async (_spec) => {
+            const instance = {
+                meta: { key: mockKey, name: "My Plugin" },
+                isEnabled: () => true,
+                enable: () => { },
+                disable: () => { },
+                call: () => Promise.resolve("result"),
+                callMany: () => Promise.resolve("result"),
+                embed: () => Promise.resolve([]),
+            };
+            service.pluginMap.set(instance.meta.key, instance);
+            return instance.meta.key;
+        });
+        await service.loadPlugin("./some-path");
+        const plugin = service.getPlugin(mockKey);
+        expect(plugin).toBeDefined();
+        expect(plugin.meta.key).toBe(mockKey);
+    });
+});
+describe("PluginService.loadPluginsFromConfig", () => {
+    it("should load plugins listed in config.pluginPackages", async () => {
+        const service = new plugins_1.PluginService(makeContext());
+        const loadedSpecs = [];
+        service.loadPlugin = jest.fn().mockImplementation(async (spec) => {
+            loadedSpecs.push(spec);
+            const key = `plugin-from-${spec}`;
+            const instance = {
+                meta: { key, name: key },
+                isEnabled: () => true,
+                enable: () => { },
+                disable: () => { },
+                call: () => Promise.resolve(""),
+                callMany: () => Promise.resolve(""),
+                embed: () => Promise.resolve([]),
+            };
+            service.pluginMap.set(key, instance);
+            return key;
+        });
+        const config = {
+            pluginPackages: {
+                asana: "@knowhow/plugin-asana",
+                linear: "@knowhow/plugin-linear",
+            },
+        };
+        await service.loadPluginsFromConfig(config);
+        expect(loadedSpecs).toContain("@knowhow/plugin-asana");
+        expect(loadedSpecs).toContain("@knowhow/plugin-linear");
+        expect(loadedSpecs.length).toBe(2);
+    });
+    it("should handle empty pluginPackages gracefully", async () => {
+        const service = new plugins_1.PluginService(makeContext());
+        service.loadPlugin = jest.fn();
+        const config = {};
+        await expect(service.loadPluginsFromConfig(config)).resolves.toBeUndefined();
+        expect(service.loadPlugin).not.toHaveBeenCalled();
+    });
+    it("should log a warning and not crash when a plugin fails to load", async () => {
+        const service = new plugins_1.PluginService(makeContext());
+        const warnSpy = jest.spyOn(console, "warn").mockImplementation(() => { });
+        service.loadPlugin = jest.fn().mockRejectedValue(new Error("Module not found"));
+        const config = {
+            pluginPackages: {
+                broken: "non-existent-package",
+            },
+        };
+        await expect(service.loadPluginsFromConfig(config)).resolves.toBeUndefined();
+        expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining("broken"), expect.any(String));
+        warnSpy.mockRestore();
+    });
+    it("should load each plugin with the correct spec string", async () => {
+        const service = new plugins_1.PluginService(makeContext());
+        const loadedSpecs = [];
+        service.loadPlugin = jest.fn().mockImplementation(async (spec) => {
+            loadedSpecs.push(spec);
+            return spec;
+        });
+        const config = {
+            pluginPackages: {
+                valid: "@knowhow/valid-plugin",
+            },
+        };
+        await service.loadPluginsFromConfig(config);
+        expect(loadedSpecs).toEqual(["@knowhow/valid-plugin"]);
+    });
+});
+//# sourceMappingURL=pluginLoading.test.js.map

package/ts_build/tests/unit/plugins/pluginLoading.test.js.map

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