@goondan/runtime 0.0.3-alpha1

package/dist/extension/api-impl.js

@@ -0,0 +1,59 @@
+export class ExtensionApiImpl {
+    extensionName;
+    pipelineRegistry;
+    toolRegistry;
+    stateManager;
+    eventBus;
+    loggerImpl;
+    constructor(extensionName, pipelineRegistry, toolRegistry, stateManager, eventBus, loggerImpl) {
+        this.extensionName = extensionName;
+        this.pipelineRegistry = pipelineRegistry;
+        this.toolRegistry = toolRegistry;
+        this.stateManager = stateManager;
+        this.eventBus = eventBus;
+        this.loggerImpl = loggerImpl;
+    }
+    get pipeline() {
+        return this.pipelineRegistry;
+    }
+    get tools() {
+        return {
+            register: (item, handler) => {
+                this.toolRegistry.register(item, handler);
+            },
+        };
+    }
+    get state() {
+        return {
+            get: () => {
+                return this.stateManager.get(this.extensionName);
+            },
+            set: (value) => {
+                return this.stateManager.set(this.extensionName, value);
+            },
+        };
+    }
+    get events() {
+        return {
+            on: (event, handler) => {
+                this.eventBus.on(event, handler);
+                return () => {
+                    this.eventBus.off(event, handler);
+                };
+            },
+            emit: (event, ...args) => {
+                this.eventBus.emit(event, ...args);
+                return Promise.resolve();
+            },
+        };
+    }
+    get logger() {
+        return {
+            debug: (...args) => this.loggerImpl.debug(...args),
+            info: (...args) => this.loggerImpl.info(...args),
+            warn: (...args) => this.loggerImpl.warn(...args),
+            error: (...args) => this.loggerImpl.error(...args),
+        };
+    }
+}
+//# sourceMappingURL=api-impl.js.map

package/dist/extension/api-impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-impl.js","sourceRoot":"","sources":["../../src/extension/api-impl.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,gBAAgB;IAER;IACA;IACA;IACA;IACA;IACA;IANnB,YACmB,aAAqB,EACrB,gBAAkC,EAClC,YAA0B,EAC1B,YAAmC,EACnC,QAAsB,EACtB,UAAmB;QALnB,kBAAa,GAAb,aAAa,CAAQ;QACrB,qBAAgB,GAAhB,gBAAgB,CAAkB;QAClC,iBAAY,GAAZ,YAAY,CAAc;QAC1B,iBAAY,GAAZ,YAAY,CAAuB;QACnC,aAAQ,GAAR,QAAQ,CAAc;QACtB,eAAU,GAAV,UAAU,CAAS;IACnC,CAAC;IAEJ,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,IAAI,KAAK;QACP,OAAO;YACL,QAAQ,EAAE,CAAC,IAAqB,EAAE,OAAoB,EAAQ,EAAE;gBAC9D,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC5C,CAAC;SACF,CAAC;IACJ,CAAC;IAED,IAAI,KAAK;QACP,OAAO;YACL,GAAG,EAAE,GAA8B,EAAE;gBACnC,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACnD,CAAC;YACD,GAAG,EAAE,CAAC,KAAgB,EAAiB,EAAE;gBACvC,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;YAC1D,CAAC;SACF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM;QACR,OAAO;YACL,EAAE,EAAE,CAAC,KAAa,EAAE,OAAqD,EAAgB,EAAE;gBACzF,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBACjC,OAAO,GAAG,EAAE;oBACV,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBACpC,CAAC,CAAC;YACJ,CAAC;YACD,IAAI,EAAE,CAAC,KAAa,EAAE,GAAG,IAAe,EAAiB,EAAE;gBACzD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;gBACnC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YAC3B,CAAC;SACF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM;QACR,OAAO;YACL,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YAC7D,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YAC3D,IAAI,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YAC3D,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;SAC9D,CAAC;IACJ,CAAC;CACF"}

package/dist/extension/api-impl.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api-impl.test.d.ts.map

package/dist/extension/api-impl.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-impl.test.d.ts","sourceRoot":"","sources":["../../src/extension/api-impl.test.ts"],"names":[],"mappings":""}

package/dist/extension/api-impl.test.js

@@ -0,0 +1,97 @@
+import { describe, it, expect, beforeEach } from "bun:test";
+import { ExtensionApiImpl } from "./api-impl.js";
+import { PipelineRegistryImpl } from "../pipeline/registry.js";
+import { ToolRegistryImpl } from "../tools/registry.js";
+import { ExtensionStateManagerImpl } from "./state-manager.js";
+import { EventEmitter } from "node:events";
+import { FileWorkspaceStorage } from "../workspace/storage.js";
+import { WorkspacePaths } from "../workspace/paths.js";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as os from "node:os";
+describe("ExtensionApiImpl", () => {
+    let tempDir;
+    let api;
+    let pipelineRegistry;
+    let toolRegistry;
+    let stateManager;
+    let eventBus;
+    let logger;
+    beforeEach(async () => {
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "ext-api-test-"));
+        const paths = new WorkspacePaths({
+            stateRoot: tempDir,
+            projectRoot: tempDir,
+        });
+        const storage = new FileWorkspaceStorage(paths);
+        await storage.initializeSystemRoot();
+        await storage.initializeInstanceState("test-instance", "test-agent");
+        pipelineRegistry = new PipelineRegistryImpl();
+        toolRegistry = new ToolRegistryImpl();
+        stateManager = new ExtensionStateManagerImpl(storage, "test-instance", ["test-ext"]);
+        eventBus = new EventEmitter();
+        logger = console;
+        api = new ExtensionApiImpl("test-ext", pipelineRegistry, toolRegistry, stateManager, eventBus, logger);
+    });
+    it("should provide pipeline registry", () => {
+        expect(api.pipeline).toBe(pipelineRegistry);
+    });
+    it("should register tools via tools API", () => {
+        api.tools.register({
+            name: "test-ext__action",
+            description: "Test action",
+            parameters: { type: "object", properties: {} },
+        }, async () => ({ ok: true }));
+        const catalog = toolRegistry.getCatalog();
+        expect(catalog).toHaveLength(1);
+        expect(catalog[0]?.name).toBe("test-ext__action");
+    });
+    it("should get and set extension state", async () => {
+        await stateManager.loadAll();
+        await api.state.set({ count: 42 });
+        const state = await api.state.get();
+        expect(state).toEqual({ count: 42 });
+    });
+    it("should return null for uninitialized state", async () => {
+        await stateManager.loadAll();
+        const state = await api.state.get();
+        expect(state).toBeNull();
+    });
+    it("should subscribe to events", async () => {
+        const events = [];
+        const unsubscribe = api.events.on("test-event", (data) => {
+            events.push(data);
+        });
+        await api.events.emit("test-event", "payload1");
+        await api.events.emit("test-event", "payload2");
+        expect(events).toEqual(["payload1", "payload2"]);
+        unsubscribe();
+        await api.events.emit("test-event", "payload3");
+        expect(events).toEqual(["payload1", "payload2"]);
+    });
+    it("should provide logger API", () => {
+        expect(api.logger.debug).toBeDefined();
+        expect(api.logger.info).toBeDefined();
+        expect(api.logger.warn).toBeDefined();
+        expect(api.logger.error).toBeDefined();
+    });
+    it("should isolate state between extensions", async () => {
+        const storage = new FileWorkspaceStorage(new WorkspacePaths({
+            stateRoot: tempDir,
+            projectRoot: tempDir,
+        }));
+        const stateManager1 = new ExtensionStateManagerImpl(storage, "test-instance", ["ext1"]);
+        const stateManager2 = new ExtensionStateManagerImpl(storage, "test-instance", ["ext2"]);
+        await stateManager1.loadAll();
+        await stateManager2.loadAll();
+        const api1 = new ExtensionApiImpl("ext1", pipelineRegistry, toolRegistry, stateManager1, eventBus, logger);
+        const api2 = new ExtensionApiImpl("ext2", pipelineRegistry, toolRegistry, stateManager2, eventBus, logger);
+        await api1.state.set({ ext1Data: true });
+        await api2.state.set({ ext2Data: true });
+        const state1 = await api1.state.get();
+        const state2 = await api2.state.get();
+        expect(state1).toEqual({ ext1Data: true });
+        expect(state2).toEqual({ ext2Data: true });
+    });
+});
+//# sourceMappingURL=api-impl.test.js.map

package/dist/extension/api-impl.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-impl.test.js","sourceRoot":"","sources":["../../src/extension/api-impl.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,IAAI,OAAe,CAAC;IACpB,IAAI,GAAqB,CAAC;IAC1B,IAAI,gBAAsC,CAAC;IAC3C,IAAI,YAA8B,CAAC;IACnC,IAAI,YAAuC,CAAC;IAC5C,IAAI,QAAsB,CAAC;IAC3B,IAAI,MAAe,CAAC;IAEpB,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,IAAI,cAAc,CAAC;YAC/B,SAAS,EAAE,OAAO;YAClB,WAAW,EAAE,OAAO;SACrB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,OAAO,CAAC,oBAAoB,EAAE,CAAC;QACrC,MAAM,OAAO,CAAC,uBAAuB,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;QAErE,gBAAgB,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC9C,YAAY,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACtC,YAAY,GAAG,IAAI,yBAAyB,CAAC,OAAO,EAAE,eAAe,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QACrF,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;QAC9B,MAAM,GAAG,OAAO,CAAC;QAEjB,GAAG,GAAG,IAAI,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,GAAG,CAAC,KAAK,CAAC,QAAQ,CAChB;YACE,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,aAAa;YAC1B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;SAC/C,EACD,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAC3B,CAAC;QAEF,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,YAAY,CAAC,OAAO,EAAE,CAAC;QAE7B,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAEpC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,YAAY,CAAC,OAAO,EAAE,CAAC;QAE7B,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE;YACvD,MAAM,CAAC,IAAI,CAAC,IAAc,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAChD,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAEhD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;QAEjD,WAAW,EAAE,CAAC;QAEd,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,OAAO,GAAG,IAAI,oBAAoB,CACtC,IAAI,cAAc,CAAC;YACjB,SAAS,EAAE,OAAO;YAClB,WAAW,EAAE,OAAO;SACrB,CAAC,CACH,CAAC;QAEF,MAAM,aAAa,GAAG,IAAI,yBAAyB,CAAC,OAAO,EAAE,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QACxF,MAAM,aAAa,GAAG,IAAI,yBAAyB,CAAC,OAAO,EAAE,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAExF,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC;QAC9B,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC;QAE9B,MAAM,IAAI,GAAG,IAAI,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC3G,MAAM,IAAI,GAAG,IAAI,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAE3G,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAEtC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/extension/index.d.ts

@@ -0,0 +1,4 @@
+export { ExtensionApiImpl } from "./api-impl.js";
+export { ExtensionStateManagerImpl, type ExtensionStateManager } from "./state-manager.js";
+export { loadExtensions, ExtensionLoadError, type ExtensionSpec, type ExtensionModule } from "./loader.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/extension/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extension/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/extension/index.js

@@ -0,0 +1,4 @@
+export { ExtensionApiImpl } from "./api-impl.js";
+export { ExtensionStateManagerImpl } from "./state-manager.js";
+export { loadExtensions, ExtensionLoadError } from "./loader.js";
+//# sourceMappingURL=index.js.map

package/dist/extension/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extension/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAA8B,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAA4C,MAAM,aAAa,CAAC"}

package/dist/extension/integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=integration.test.d.ts.map

package/dist/extension/integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.test.d.ts","sourceRoot":"","sources":["../../src/extension/integration.test.ts"],"names":[],"mappings":""}

package/dist/extension/integration.test.js

@@ -0,0 +1,224 @@
+import { describe, it, expect, beforeEach } from "bun:test";
+import { loadExtensions } from "./loader.js";
+import { PipelineRegistryImpl } from "../pipeline/registry.js";
+import { ToolRegistryImpl } from "../tools/registry.js";
+import { ExtensionStateManagerImpl } from "./state-manager.js";
+import { ExtensionApiImpl } from "./api-impl.js";
+import { FileWorkspaceStorage } from "../workspace/storage.js";
+import { WorkspacePaths } from "../workspace/paths.js";
+import { RuntimeEventBusImpl } from "../events/runtime-events.js";
+import { EventEmitter } from "node:events";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as os from "node:os";
+describe("Extension Integration", () => {
+    let tempDir;
+    let storage;
+    let pipelineRegistry;
+    let toolRegistry;
+    let eventBus;
+    let runtimeEventBus;
+    beforeEach(async () => {
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "ext-integration-test-"));
+        const paths = new WorkspacePaths({
+            stateRoot: tempDir,
+            projectRoot: tempDir,
+        });
+        storage = new FileWorkspaceStorage(paths);
+        await storage.initializeSystemRoot();
+        await storage.initializeInstanceState("test-instance", "test-agent");
+        runtimeEventBus = new RuntimeEventBusImpl();
+        pipelineRegistry = new PipelineRegistryImpl(runtimeEventBus);
+        toolRegistry = new ToolRegistryImpl();
+        eventBus = new EventEmitter();
+    });
+    it("should load logging extension from base package", async () => {
+        const baseExtensionPath = path.resolve(path.dirname(import.meta.url.replace("file://", "")), "../../../base/src/extensions/logging.ts");
+        const extensionExists = await fs
+            .access(baseExtensionPath)
+            .then(() => true)
+            .catch(() => false);
+        if (!extensionExists) {
+            console.warn("Skipping test: base logging extension not found");
+            return;
+        }
+        const resources = [
+            {
+                apiVersion: "goondan.ai/v1",
+                kind: "Extension",
+                metadata: { name: "logging" },
+                spec: {
+                    entry: baseExtensionPath,
+                    config: {
+                        level: "info",
+                        includeToolArgs: true,
+                    },
+                },
+                __file: "test.yaml",
+                __docIndex: 0,
+            },
+        ];
+        const apiFactory = (name) => {
+            const stateManager = new ExtensionStateManagerImpl(storage, "test-instance", [name]);
+            return new ExtensionApiImpl(name, pipelineRegistry, toolRegistry, stateManager, eventBus, console);
+        };
+        await loadExtensions(resources, apiFactory, tempDir, console);
+    });
+    it("should run middleware registered by extension", async () => {
+        const extDir = path.join(tempDir, "extensions");
+        await fs.mkdir(extDir, { recursive: true });
+        const extPath = path.join(extDir, "test-middleware.ts");
+        await fs.writeFile(extPath, `
+      export function register(api) {
+        api.pipeline.register('turn', async (ctx) => {
+          ctx.metadata.extensionRan = true;
+          return ctx.next();
+        });
+      }
+    `, "utf8");
+        const resources = [
+            {
+                apiVersion: "goondan.ai/v1",
+                kind: "Extension",
+                metadata: { name: "test-middleware" },
+                spec: { entry: "./test-middleware.ts" },
+                __file: "test.yaml",
+                __docIndex: 0,
+                __rootDir: extDir,
+            },
+        ];
+        const apiFactory = (name) => {
+            const stateManager = new ExtensionStateManagerImpl(storage, "test-instance", [name]);
+            return new ExtensionApiImpl(name, pipelineRegistry, toolRegistry, stateManager, eventBus, console);
+        };
+        await loadExtensions(resources, apiFactory, tempDir, console);
+        const metadata = {};
+        const conversationState = await storage.createConversationState("test-instance");
+        await pipelineRegistry.runTurn({
+            agentName: "test-agent",
+            instanceKey: "test-instance",
+            turnId: "turn-1",
+            traceId: "trace-1",
+            inputEvent: {
+                id: "evt-1",
+                type: "user.input",
+                input: "hello",
+                source: { kind: "connector", name: "cli" },
+                createdAt: new Date(),
+            },
+            conversationState,
+            emitMessageEvent: () => { },
+            metadata,
+        }, async () => {
+            return {
+                turnId: "turn-1",
+                finishReason: "text_response",
+            };
+        });
+        expect(metadata.extensionRan).toBe(true);
+    });
+    it("should emit runtime events through pipeline", async () => {
+        const events = [];
+        runtimeEventBus.on("turn.started", (event) => {
+            events.push(`turn.started:${event.turnId}`);
+        });
+        runtimeEventBus.on("turn.completed", (event) => {
+            events.push(`turn.completed:${event.turnId}`);
+        });
+        const conversationState = await storage.createConversationState("test-instance");
+        await pipelineRegistry.runTurn({
+            agentName: "test-agent",
+            instanceKey: "test-instance",
+            turnId: "turn-1",
+            traceId: "trace-1",
+            inputEvent: {
+                id: "evt-1",
+                type: "user.input",
+                input: "hello",
+                source: { kind: "connector", name: "cli" },
+                createdAt: new Date(),
+            },
+            conversationState,
+            emitMessageEvent: () => { },
+            metadata: {},
+        }, async () => {
+            return {
+                turnId: "turn-1",
+                finishReason: "text_response",
+            };
+        });
+        expect(events).toEqual(["turn.started:turn-1", "turn.completed:turn-1"]);
+    });
+    it("should persist extension state across turns", async () => {
+        const extDir = path.join(tempDir, "extensions");
+        await fs.mkdir(extDir, { recursive: true });
+        const extPath = path.join(extDir, "stateful-ext.ts");
+        await fs.writeFile(extPath, `
+      export function register(api) {
+        api.pipeline.register('turn', async (ctx) => {
+          const state = await api.state.get() ?? { count: 0 };
+          const newCount = state.count + 1;
+          await api.state.set({ count: newCount });
+          ctx.metadata.turnCount = newCount;
+          return ctx.next();
+        });
+      }
+    `, "utf8");
+        const resources = [
+            {
+                apiVersion: "goondan.ai/v1",
+                kind: "Extension",
+                metadata: { name: "stateful-ext" },
+                spec: { entry: "./stateful-ext.ts" },
+                __file: "test.yaml",
+                __docIndex: 0,
+                __rootDir: extDir,
+            },
+        ];
+        const stateManager = new ExtensionStateManagerImpl(storage, "test-instance", ["stateful-ext"]);
+        await stateManager.loadAll();
+        const apiFactory = (name) => {
+            return new ExtensionApiImpl(name, pipelineRegistry, toolRegistry, stateManager, eventBus, console);
+        };
+        await loadExtensions(resources, apiFactory, tempDir, console);
+        const conversationState = await storage.createConversationState("test-instance");
+        const metadata1 = {};
+        await pipelineRegistry.runTurn({
+            agentName: "test-agent",
+            instanceKey: "test-instance",
+            turnId: "turn-1",
+            traceId: "trace-1",
+            inputEvent: {
+                id: "evt-1",
+                type: "user.input",
+                input: "hello",
+                source: { kind: "connector", name: "cli" },
+                createdAt: new Date(),
+            },
+            conversationState,
+            emitMessageEvent: () => { },
+            metadata: metadata1,
+        }, async () => ({ turnId: "turn-1", finishReason: "text_response" }));
+        await stateManager.saveAll();
+        const metadata2 = {};
+        await pipelineRegistry.runTurn({
+            agentName: "test-agent",
+            instanceKey: "test-instance",
+            turnId: "turn-2",
+            traceId: "trace-2",
+            inputEvent: {
+                id: "evt-2",
+                type: "user.input",
+                input: "hello again",
+                source: { kind: "connector", name: "cli" },
+                createdAt: new Date(),
+            },
+            conversationState,
+            emitMessageEvent: () => { },
+            metadata: metadata2,
+        }, async () => ({ turnId: "turn-2", finishReason: "text_response" }));
+        expect(metadata1.turnCount).toBe(1);
+        expect(metadata2.turnCount).toBe(2);
+    });
+});
+//# sourceMappingURL=integration.test.js.map

package/dist/extension/integration.test.js.map

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

package/dist/extension/loader.d.ts

@@ -0,0 +1,17 @@
+import type { ExtensionApi, RuntimeResource } from "../types.js";
+export interface ExtensionSpec {
+    entry: string;
+    config?: Record<string, unknown>;
+}
+export interface ExtensionModule {
+    register(api: ExtensionApi): void | Promise<void>;
+}
+export declare class ExtensionLoadError extends Error {
+    readonly code: string;
+    readonly extensionName: string;
+    readonly suggestion?: string | undefined;
+    readonly helpUrl?: string | undefined;
+    constructor(message: string, code: string, extensionName: string, suggestion?: string | undefined, helpUrl?: string | undefined);
+}
+export declare function loadExtensions(extensionResources: RuntimeResource<ExtensionSpec>[], apiFactory: (extensionName: string) => ExtensionApi, bundleRootDir: string, logger: Console): Promise<void>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/extension/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/extension/loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAWD,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,IAAI,EAAE,MAAM;aACZ,aAAa,EAAE,MAAM;aACrB,UAAU,CAAC,EAAE,MAAM;aACnB,OAAO,CAAC,EAAE,MAAM;gBAJhC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,OAAO,CAAC,EAAE,MAAM,YAAA;CAKnC;AAED,wBAAsB,cAAc,CAClC,kBAAkB,EAAE,eAAe,CAAC,aAAa,CAAC,EAAE,EACpD,UAAU,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,YAAY,EACnD,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAqCf"}

package/dist/extension/loader.js

@@ -0,0 +1,50 @@
+import * as path from "node:path";
+function isExtensionModule(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const candidate = value;
+    return typeof candidate.register === "function";
+}
+export class ExtensionLoadError extends Error {
+    code;
+    extensionName;
+    suggestion;
+    helpUrl;
+    constructor(message, code, extensionName, suggestion, helpUrl) {
+        super(message);
+        this.code = code;
+        this.extensionName = extensionName;
+        this.suggestion = suggestion;
+        this.helpUrl = helpUrl;
+        this.name = "ExtensionLoadError";
+    }
+}
+export async function loadExtensions(extensionResources, apiFactory, bundleRootDir, logger) {
+    for (const resource of extensionResources) {
+        const extensionName = resource.metadata.name;
+        try {
+            const entryPath = resolveEntryPath(resource, bundleRootDir);
+            logger.debug(`[extension.loader] loading ${extensionName} from ${entryPath}`);
+            const module = await import(entryPath);
+            if (!isExtensionModule(module)) {
+                throw new ExtensionLoadError(`extension module does not export register function: ${extensionName}`, "E_EXT_LOAD", extensionName, "Ensure your extension exports a named function: export function register(api: ExtensionApi) { ... }", "https://github.com/goondan/goondan/blob/main/docs/specs/extension.md#entrypoint");
+            }
+            const api = apiFactory(extensionName);
+            await module.register(api);
+            logger.debug(`[extension.loader] registered ${extensionName}`);
+        }
+        catch (error) {
+            if (error instanceof ExtensionLoadError) {
+                throw error;
+            }
+            throw new ExtensionLoadError(`failed to initialize extension ${extensionName}: ${error instanceof Error ? error.message : String(error)}`, "E_EXT_INIT", extensionName, "Check extension register() function for errors", undefined);
+        }
+    }
+}
+function resolveEntryPath(resource, bundleRootDir) {
+    const rootDir = resource.__rootDir ?? bundleRootDir;
+    const entryRelative = resource.spec.entry;
+    return path.resolve(rootDir, entryRelative);
+}
+//# sourceMappingURL=loader.js.map

package/dist/extension/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/extension/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAYlC,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,KAAgC,CAAC;IACnD,OAAO,OAAO,SAAS,CAAC,QAAQ,KAAK,UAAU,CAAC;AAClD,CAAC;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAGzB;IACA;IACA;IACA;IALlB,YACE,OAAe,EACC,IAAY,EACZ,aAAqB,EACrB,UAAmB,EACnB,OAAgB;QAEhC,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,SAAI,GAAJ,IAAI,CAAQ;QACZ,kBAAa,GAAb,aAAa,CAAQ;QACrB,eAAU,GAAV,UAAU,CAAS;QACnB,YAAO,GAAP,OAAO,CAAS;QAGhC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,kBAAoD,EACpD,UAAmD,EACnD,aAAqB,EACrB,MAAe;IAEf,KAAK,MAAM,QAAQ,IAAI,kBAAkB,EAAE,CAAC;QAC1C,MAAM,aAAa,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QAE7C,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;YAC5D,MAAM,CAAC,KAAK,CAAC,8BAA8B,aAAa,SAAS,SAAS,EAAE,CAAC,CAAC;YAE9E,MAAM,MAAM,GAAY,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;YAChD,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,kBAAkB,CAC1B,uDAAuD,aAAa,EAAE,EACtE,YAAY,EACZ,aAAa,EACb,qGAAqG,EACrG,iFAAiF,CAClF,CAAC;YACJ,CAAC;YAED,MAAM,GAAG,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;YACtC,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAE3B,MAAM,CAAC,KAAK,CAAC,iCAAiC,aAAa,EAAE,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;gBACxC,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,IAAI,kBAAkB,CAC1B,kCAAkC,aAAa,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC5G,YAAY,EACZ,aAAa,EACb,gDAAgD,EAChD,SAAS,CACV,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAwC,EAAE,aAAqB;IACvF,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,IAAI,aAAa,CAAC;IACpD,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;IAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AAC9C,CAAC"}

package/dist/extension/loader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=loader.test.d.ts.map

package/dist/extension/loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.test.d.ts","sourceRoot":"","sources":["../../src/extension/loader.test.ts"],"names":[],"mappings":""}