@compozy/extension-sdk 0.3.0-beta.3

package/dist/esm/testing/conformance.js

@@ -0,0 +1,19 @@
+import { PUBLIC_PROVIDE_CONFORMANCE_FIXTURES } from "../generated/contracts.js";
+export function publicProvideFixtures() {
+    return PUBLIC_PROVIDE_CONFORMANCE_FIXTURES.map(fixture => ({
+        provide: fixture.provide,
+        requiredMethods: [...fixture.required_methods],
+    }));
+}
+export function validateProvideConformance(provide, implementedMethods) {
+    const fixture = publicProvideFixtures().find(candidate => candidate.provide === provide.trim());
+    if (!fixture) {
+        throw new Error(`provide ${JSON.stringify(provide.trim())} has no public conformance fixture`);
+    }
+    const implemented = new Set(implementedMethods);
+    const missing = fixture.requiredMethods.filter(method => !implemented.has(method));
+    if (missing.length > 0) {
+        throw new Error(`provide ${JSON.stringify(fixture.provide)} is missing required methods: ${missing.join(", ")}`);
+    }
+}
+//# sourceMappingURL=conformance.js.map

package/dist/esm/testing/conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../../../src/testing/conformance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mCAAmC,EAAE,MAAM,2BAA2B,CAAC;AAOhF,MAAM,UAAU,qBAAqB;IACnC,OAAO,mCAAmC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzD,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,eAAe,EAAE,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;KAC/C,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,OAAe,EACf,kBAAqC;IAErC,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAChG,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,oCAAoC,CAAC,CAAC;IACjG,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACnF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,WAAW,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,iCAAiC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/esm/testing/harness.js

@@ -0,0 +1,151 @@
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { MethodNotFoundError } from "../errors.js";
+import { Extension } from "../extension.js";
+import { MockTransport, createMockTransportPair } from "./mock-transport.js";
+const DEFAULT_RUNTIME = {
+    health_check_interval_ms: 30_000,
+    health_check_timeout_ms: 5_000,
+    shutdown_timeout_ms: 10_000,
+    default_hook_timeout_ms: 5_000,
+};
+const DAEMON_METHODS = new Set(["execute_hook", "health_check", "shutdown"]);
+export class TestHarness {
+    mockedHostHandlers = new Map();
+    stderr;
+    hostTransport;
+    extensionTransport;
+    extension;
+    initializeRequest;
+    initializeResponse;
+    describeStdout = "";
+    describeExitCode;
+    constructor(options = {}) {
+        this.stderr = options.stderr ?? process.stderr;
+    }
+    mockHostAPI(method, handler) {
+        this.mockedHostHandlers.set(method.trim(), handler);
+        this.bindMockedHostHandler(method.trim(), handler);
+        return this;
+    }
+    async loadExtension(target, options = {}) {
+        const pair = createMockTransportPair();
+        this.hostTransport = pair.host;
+        this.extensionTransport = pair.extension;
+        for (const [method, handler] of this.mockedHostHandlers) {
+            this.bindMockedHostHandler(method, handler);
+        }
+        const extension = await this.resolveExtension(target);
+        extension.bindTransport(this.extensionTransport);
+        this.extension = extension;
+        const request = this.buildInitializeRequest(extension.definition, extension.getImplementedMethods(), options);
+        this.initializeRequest = request;
+        const startPromise = extension.start();
+        this.initializeResponse = await this.hostTransport.call("initialize", request);
+        await startPromise;
+        return extension;
+    }
+    async call(method, params) {
+        if (!this.hostTransport) {
+            throw new Error("extension is not loaded");
+        }
+        return await this.hostTransport.call(method, params);
+    }
+    getLastInitializeRequest() {
+        return this.initializeRequest;
+    }
+    getLastInitializeResponse() {
+        return this.initializeResponse;
+    }
+    getHostTransport() {
+        if (!this.hostTransport) {
+            throw new Error("host transport is not initialized");
+        }
+        return this.hostTransport;
+    }
+    captureDescribeProcess(argv = ["extension", "__describe"]) {
+        this.describeStdout = "";
+        this.describeExitCode = undefined;
+        return {
+            argv,
+            stdout: {
+                write: ((chunk) => {
+                    this.describeStdout += typeof chunk === "string" ? chunk : Buffer.from(chunk).toString();
+                    return true;
+                }),
+            },
+            setExitCode: code => {
+                this.describeExitCode = code;
+            },
+        };
+    }
+    getDescribeResult() {
+        return { stdout: this.describeStdout, exitCode: this.describeExitCode };
+    }
+    bindMockedHostHandler(method, handler) {
+        if (!this.hostTransport) {
+            return;
+        }
+        this.hostTransport.handle(method, async (params) => await handler(params));
+    }
+    async resolveExtension(target) {
+        if (target instanceof Extension) {
+            return target;
+        }
+        if (typeof target === "function") {
+            return await target({ transport: this.extensionTransport, stderr: this.stderr });
+        }
+        const moduleURL = pathToFileURL(path.resolve(target)).href;
+        const imported = (await import(moduleURL));
+        if (typeof imported.createExtension === "function") {
+            return await imported.createExtension({
+                transport: this.extensionTransport,
+                stderr: this.stderr,
+            });
+        }
+        if (imported.extension instanceof Extension) {
+            return imported.extension;
+        }
+        if (imported.default instanceof Extension) {
+            return imported.default;
+        }
+        if (typeof imported.default === "function") {
+            return await imported.default({ transport: this.extensionTransport, stderr: this.stderr });
+        }
+        throw new MethodNotFoundError("createExtension");
+    }
+    buildInitializeRequest(definition, implementedMethods, options) {
+        const daemonRequests = options.daemonRequests ?? implementedMethods.filter(method => DAEMON_METHODS.has(method));
+        const extensionServices = options.extensionServices ?? implementedMethods.filter(method => !DAEMON_METHODS.has(method));
+        const requestedProvides = definition.capabilities?.provides ?? [];
+        const requestedPermissions = definition.permissions?.requires ?? [];
+        return {
+            protocol_version: "1",
+            supported_protocol_versions: ["1"],
+            compozy_version: options.compozyVersion ?? "0.5.0",
+            session_nonce: options.sessionNonce ?? "session-nonce-test",
+            extension: {
+                name: definition.name,
+                version: definition.version,
+                source_tier: options.sourceTier ?? "user",
+            },
+            capabilities: {
+                provides: options.provides ?? [...requestedProvides],
+                granted_permissions: (options.grantedPermissions ?? [
+                    ...requestedPermissions,
+                ]),
+                granted_resource_kinds: options.grantedResourceKinds ?? [],
+                granted_resource_scopes: options.grantedResourceScopes ?? [],
+            },
+            methods: {
+                daemon_requests: daemonRequests,
+                extension_services: extensionServices,
+            },
+            runtime: {
+                ...DEFAULT_RUNTIME,
+                ...options.runtime,
+            },
+        };
+    }
+}
+//# sourceMappingURL=harness.js.map

package/dist/esm/testing/harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../../src/testing/harness.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAU5C,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AA8B7E,MAAM,eAAe,GAAsB;IACzC,wBAAwB,EAAE,MAAM;IAChC,uBAAuB,EAAE,KAAK;IAC9B,mBAAmB,EAAE,MAAM;IAC3B,uBAAuB,EAAE,KAAK;CAC/B,CAAC;AAEF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC,CAAC;AAE7E,MAAM,OAAO,WAAW;IACL,kBAAkB,GAAG,IAAI,GAAG,EAG1C,CAAC;IACa,MAAM,CAAwB;IACvC,aAAa,CAA4B;IACzC,kBAAkB,CAA4B;IAC9C,SAAS,CAAwB;IACjC,iBAAiB,CAAgC;IACjD,kBAAkB,CAAiC;IACnD,cAAc,GAAG,EAAE,CAAC;IACpB,gBAAgB,CAAqB;IAE7C,YAAmB,OAAO,GAAuC,EAAE;QACjE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IACjD,CAAC;IAEM,WAAW,CAChB,MAAc,EACd,OAAwD;QAExD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,aAAa,CACxB,MAAiC,EACjC,OAAO,GAAuB,EAAE;QAEhC,MAAM,IAAI,GAAG,uBAAuB,EAAE,CAAC;QACvC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC;QAC/B,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC;QAEzC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACxD,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACtD,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,MAAM,OAAO,GAAG,IAAI,CAAC,sBAAsB,CACzC,SAAS,CAAC,UAAU,EACpB,SAAS,CAAC,qBAAqB,EAAE,EACjC,OAAO,CACR,CAAC;QACF,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC;QAEjC,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC;QACvC,IAAI,CAAC,kBAAkB,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CACrD,YAAY,EACZ,OAAO,CACR,CAAC;QACF,MAAM,YAAY,CAAC;QAEnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAEM,KAAK,CAAC,IAAI,CAAoB,MAAc,EAAE,MAAgB;QACnE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAU,MAAM,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC;IAEM,wBAAwB;QAC7B,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAEM,yBAAyB;QAC9B,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAEM,gBAAgB;QACrB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAEM,sBAAsB,CAC3B,IAAI,GAAsB,CAAC,WAAW,EAAE,YAAY,CAAC;QAErD,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;QAClC,OAAO;YACL,IAAI;YACJ,MAAM,EAAE;gBACN,KAAK,EAAE,CAAC,CAAC,KAA0B,EAAE,EAAE;oBACrC,IAAI,CAAC,cAAc,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;oBACzF,OAAO,IAAI,CAAC;gBACd,CAAC,CAAmC;aACrC;YACD,WAAW,EAAE,IAAI,CAAC,EAAE;gBAClB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;YAC/B,CAAC;SACF,CAAC;IACJ,CAAC;IAEM,iBAAiB;QACtB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1E,CAAC;IAEO,qBAAqB,CAC3B,MAAc,EACd,OAAwD;QAExD,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3E,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,MAAiC;QAC9D,IAAI,MAAM,YAAY,SAAS,EAAE,CAAC;YAChC,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YACjC,OAAO,MAAM,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,kBAAmB,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3D,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAyB,CAAC;QAEnE,IAAI,OAAO,QAAQ,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;YACnD,OAAO,MAAM,QAAQ,CAAC,eAAe,CAAC;gBACpC,SAAS,EAAE,IAAI,CAAC,kBAAmB;gBACnC,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,QAAQ,CAAC,SAAS,YAAY,SAAS,EAAE,CAAC;YAC5C,OAAO,QAAQ,CAAC,SAAS,CAAC;QAC5B,CAAC;QACD,IAAI,QAAQ,CAAC,OAAO,YAAY,SAAS,EAAE,CAAC;YAC1C,OAAO,QAAQ,CAAC,OAAO,CAAC;QAC1B,CAAC;QACD,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YAC3C,OAAO,MAAM,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,kBAAmB,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9F,CAAC;QAED,MAAM,IAAI,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IACnD,CAAC;IAEO,sBAAsB,CAC5B,UAA+B,EAC/B,kBAA4B,EAC5B,OAA2B;QAE3B,MAAM,cAAc,GAClB,OAAO,CAAC,cAAc,IAAI,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5F,MAAM,iBAAiB,GACrB,OAAO,CAAC,iBAAiB,IAAI,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAEhG,MAAM,iBAAiB,GAAG,UAAU,CAAC,YAAY,EAAE,QAAQ,IAAI,EAAE,CAAC;QAClE,MAAM,oBAAoB,GAAG,UAAU,CAAC,WAAW,EAAE,QAAQ,IAAI,EAAE,CAAC;QAEpE,OAAO;YACL,gBAAgB,EAAE,GAAG;YACrB,2BAA2B,EAAE,CAAC,GAA6B,CAAC;YAC5D,eAAe,EAAE,OAAO,CAAC,cAAc,IAAI,OAAO;YAClD,aAAa,EAAE,OAAO,CAAC,YAAY,IAAI,oBAAoB;YAC3D,SAAS,EAAE;gBACT,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,WAAW,EAAE,OAAO,CAAC,UAAU,IAAI,MAAM;aAC1C;YACD,YAAY,EAAE;gBACZ,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,GAAG,iBAAiB,CAAC;gBACpD,mBAAmB,EAAE,CAAC,OAAO,CAAC,kBAAkB,IAAI;oBAClD,GAAG,oBAAoB;iBACxB,CAAoB;gBACrB,sBAAsB,EAAE,OAAO,CAAC,oBAAoB,IAAI,EAAE;gBAC1D,uBAAuB,EAAE,OAAO,CAAC,qBAAqB,IAAI,EAAE;aAC7D;YACD,OAAO,EAAE;gBACP,eAAe,EAAE,cAAc;gBAC/B,kBAAkB,EAAE,iBAAiB;aACtC;YACD,OAAO,EAAE;gBACP,GAAG,eAAe;gBAClB,GAAG,OAAO,CAAC,OAAO;aACnB;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/testing/index.js

@@ -0,0 +1,4 @@
+export { TestHarness } from "./harness.js";
+export { publicProvideFixtures, validateProvideConformance, } from "./conformance.js";
+export { MockTransport, createMockTransportPair } from "./mock-transport.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,qBAAqB,EACrB,0BAA0B,GAE3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/esm/testing/mock-transport.js

@@ -0,0 +1,69 @@
+import { MethodNotFoundError, ensureRPCError } from "../errors.js";
+export class MockTransport {
+    handlers = new Map();
+    errors = new Set();
+    nextID = 0;
+    started = false;
+    closed = false;
+    peer;
+    requests = [];
+    connect(peer) {
+        this.peer = peer;
+    }
+    start() {
+        this.started = true;
+    }
+    handle(method, handler) {
+        this.handlers.set(method.trim(), handler);
+    }
+    onTransportError(listener) {
+        this.errors.add(listener);
+        return () => {
+            this.errors.delete(listener);
+        };
+    }
+    async close() {
+        this.closed = true;
+    }
+    async call(method, params) {
+        if (this.closed) {
+            throw new Error("transport closed");
+        }
+        const peer = this.peer;
+        if (!peer) {
+            throw new Error("mock transport peer is not connected");
+        }
+        this.start();
+        peer.start();
+        const id = ++this.nextID;
+        this.requests.push({ id, method, params });
+        const handler = peer.handlers.get(method.trim());
+        if (!handler) {
+            throw new MethodNotFoundError(method);
+        }
+        const envelope = {
+            jsonrpc: "2.0",
+            id,
+            method,
+            params,
+        };
+        try {
+            return (await handler(params, envelope));
+        }
+        catch (error) {
+            const rpcError = ensureRPCError(error);
+            for (const listener of this.errors) {
+                listener(rpcError);
+            }
+            throw rpcError;
+        }
+    }
+}
+export function createMockTransportPair() {
+    const host = new MockTransport();
+    const extension = new MockTransport();
+    host.connect(extension);
+    extension.connect(host);
+    return { host, extension };
+}
+//# sourceMappingURL=mock-transport.js.map

package/dist/esm/testing/mock-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-transport.js","sourceRoot":"","sources":["../../../src/testing/mock-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAUnE,MAAM,OAAO,aAAa;IACP,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAC/C,MAAM,GAAG,IAAI,GAAG,EAA0B,CAAC;IACpD,MAAM,GAAG,CAAC,CAAC;IACX,OAAO,GAAG,KAAK,CAAC;IAChB,MAAM,GAAG,KAAK,CAAC;IACf,IAAI,CAA4B;IAExB,QAAQ,GAAsB,EAAE,CAAC;IAE1C,OAAO,CAAC,IAAmB;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAEM,MAAM,CAAC,MAAc,EAAE,OAAyB;QACrD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAEM,gBAAgB,CAAC,QAAgC;QACtD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAEM,KAAK,CAAC,IAAI,CAAoB,MAAc,EAAE,MAAgB;QACnE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAE3C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QAED,MAAM,QAAQ,GAA2B;YACvC,OAAO,EAAE,KAAK;YACd,EAAE;YACF,MAAM;YACN,MAAM;SACP,CAAC;QAEF,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAY,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YACvC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACnC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACrB,CAAC;YACD,MAAM,QAAQ,CAAC;QACjB,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB;IAIrC,MAAM,IAAI,GAAG,IAAI,aAAa,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,IAAI,aAAa,EAAE,CAAC;IACtC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxB,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC"}

package/dist/esm/transport.js

@@ -0,0 +1,235 @@
+import { Buffer } from "node:buffer";
+import { InvalidRequestError, MethodNotFoundError, NotInitializedError, ParseError, ensureRPCError, errorFromObject, } from "./errors.js";
+export const DEFAULT_MAX_MESSAGE_BYTES = 10 * 1024 * 1024;
+export const JSON_RPC_VERSION = "2.0";
+function keyOfID(id) {
+    return `${typeof id}:${String(id)}`;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isRequestFrame(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    return value.jsonrpc === JSON_RPC_VERSION && typeof value.method === "string";
+}
+function isResponseFrame(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    return value.jsonrpc === JSON_RPC_VERSION && "id" in value && !("method" in value);
+}
+export class StdioTransport {
+    input;
+    output;
+    maxMessageBytes;
+    handlers = new Map();
+    pending = new Map();
+    errorListeners = new Set();
+    readBuffer = Buffer.alloc(0);
+    nextID = 0;
+    started = false;
+    closed = false;
+    onDataBound;
+    onErrorBound;
+    onEndBound;
+    constructor(options = {}) {
+        this.input = options.input ?? process.stdin;
+        this.output = options.output ?? process.stdout;
+        this.maxMessageBytes = options.maxMessageBytes ?? DEFAULT_MAX_MESSAGE_BYTES;
+        this.onDataBound = chunk => {
+            this.handleChunk(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+        };
+        this.onErrorBound = error => {
+            this.fail(error);
+        };
+        this.onEndBound = () => {
+            this.fail(new Error("transport closed"));
+        };
+    }
+    start() {
+        if (this.started) {
+            return;
+        }
+        this.started = true;
+        this.input.on("data", this.onDataBound);
+        this.input.on("error", this.onErrorBound);
+        this.input.on("end", this.onEndBound);
+        this.input.on("close", this.onEndBound);
+    }
+    handle(method, handler) {
+        this.handlers.set(method.trim(), handler);
+    }
+    onTransportError(listener) {
+        this.errorListeners.add(listener);
+        return () => {
+            this.errorListeners.delete(listener);
+        };
+    }
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        this.fail(new Error("transport closed"));
+    }
+    async call(method, params) {
+        if (this.closed) {
+            throw new Error("transport closed");
+        }
+        this.start();
+        const id = ++this.nextID;
+        const frame = {
+            jsonrpc: JSON_RPC_VERSION,
+            id,
+            method,
+            params,
+        };
+        return await new Promise((resolve, reject) => {
+            this.pending.set(keyOfID(id), { resolve, reject });
+            try {
+                this.writeFrame(frame);
+            }
+            catch (error) {
+                this.pending.delete(keyOfID(id));
+                reject(error);
+            }
+        });
+    }
+    handleChunk(chunk) {
+        if (this.closed) {
+            return;
+        }
+        this.readBuffer = Buffer.concat([this.readBuffer, chunk]);
+        if (this.readBuffer.length > this.maxMessageBytes + 1) {
+            this.fail(new Error(`message exceeds ${this.maxMessageBytes} bytes`));
+            return;
+        }
+        while (true) {
+            const newlineIndex = this.readBuffer.indexOf(0x0a);
+            if (newlineIndex === -1) {
+                if (this.readBuffer.length > this.maxMessageBytes) {
+                    this.fail(new Error(`message exceeds ${this.maxMessageBytes} bytes`));
+                }
+                return;
+            }
+            const line = this.readBuffer.subarray(0, newlineIndex);
+            this.readBuffer = this.readBuffer.subarray(newlineIndex + 1);
+            const trimmed = line.toString("utf8").trim();
+            if (trimmed.length === 0) {
+                continue;
+            }
+            if (Buffer.byteLength(trimmed) > this.maxMessageBytes) {
+                this.fail(new Error(`message exceeds ${this.maxMessageBytes} bytes`));
+                return;
+            }
+            this.processLine(trimmed);
+            if (this.closed) {
+                return;
+            }
+        }
+    }
+    processLine(line) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch (error) {
+            this.fail(error instanceof Error ? new ParseError(error.message) : new ParseError(String(error)));
+            return;
+        }
+        if (Array.isArray(parsed)) {
+            this.fail(new InvalidRequestError("batch requests are not supported"));
+            return;
+        }
+        if (isRequestFrame(parsed)) {
+            if (!("id" in parsed) || parsed.id === undefined || parsed.id === null) {
+                return;
+            }
+            void this.dispatchRequest(parsed);
+            return;
+        }
+        if (isResponseFrame(parsed)) {
+            this.dispatchResponse(parsed);
+            return;
+        }
+        this.fail(new InvalidRequestError("invalid json-rpc envelope"));
+    }
+    async dispatchRequest(request) {
+        const handler = this.handlers.get(request.method.trim());
+        if (!handler) {
+            await this.sendError(request.id, new MethodNotFoundError(request.method));
+            return;
+        }
+        try {
+            const result = await handler(request.params, request);
+            await this.sendResult(request.id, result ?? null);
+        }
+        catch (error) {
+            await this.sendError(request.id, ensureRPCError(error));
+        }
+    }
+    dispatchResponse(response) {
+        const pending = this.pending.get(keyOfID(response.id));
+        if (!pending) {
+            return;
+        }
+        this.pending.delete(keyOfID(response.id));
+        if (response.error) {
+            pending.reject(errorFromObject(response.error));
+            return;
+        }
+        pending.resolve(response.result);
+    }
+    async sendResult(id, result) {
+        this.writeFrame({
+            jsonrpc: JSON_RPC_VERSION,
+            id,
+            result,
+        });
+    }
+    async sendError(id, error) {
+        const rpcError = ensureRPCError(error);
+        this.writeFrame({
+            jsonrpc: JSON_RPC_VERSION,
+            id,
+            error: rpcError.toJSONRPC(),
+        });
+    }
+    writeFrame(frame) {
+        const encoded = JSON.stringify(frame);
+        if (Buffer.byteLength(encoded) > this.maxMessageBytes) {
+            throw new Error(`message exceeds ${this.maxMessageBytes} bytes`);
+        }
+        this.output.write(`${encoded}\n`);
+    }
+    fail(error) {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        this.input.off("data", this.onDataBound);
+        this.input.off("error", this.onErrorBound);
+        this.input.off("end", this.onEndBound);
+        this.input.off("close", this.onEndBound);
+        for (const pending of this.pending.values()) {
+            pending.reject(error);
+        }
+        this.pending.clear();
+        for (const listener of this.errorListeners) {
+            listener(error);
+        }
+    }
+}
+export class NotReadyTransport {
+    handle() { }
+    onTransportError() {
+        return () => { };
+    }
+    start() { }
+    async close() { }
+    async call(_method, _params) {
+        throw new NotInitializedError();
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/esm/transport.js.map

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

package/dist/esm/types.js

@@ -0,0 +1,3 @@
+export * from "./base-types.js";
+export * from "./generated/contracts.js";
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAmBA,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC"}

package/dist/esm/watch-source.js

@@ -0,0 +1,122 @@
+import { InvalidParamsError } from "./errors.js";
+import { cloneJSON } from "./json.js";
+export const WATCH_SOURCE_CAPABILITY = "loop.watch_source";
+export const WATCH_POLL_METHOD = "watch/poll";
+export class ExtensionWatchSources {
+    options;
+    handlers = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    register(definition, kind, _registerOptions, handler) {
+        const cleanKind = kind.trim();
+        if (!cleanKind) {
+            throw new Error("watch source kind is required");
+        }
+        if (this.handlers.has(cleanKind)) {
+            throw new Error(`watch source already registered: ${cleanKind}`);
+        }
+        if (this.options.hasUserHandler(WATCH_POLL_METHOD)) {
+            throw new Error("watch/poll is reserved by extension.watchSource()");
+        }
+        this.handlers.set(cleanKind, {
+            kind: cleanKind,
+            handler: handler,
+        });
+        this.ensureCapability(definition);
+        this.options.bindMethod(WATCH_POLL_METHOD);
+    }
+    hasHandlers() {
+        return this.handlers.size > 0;
+    }
+    implementedMethods() {
+        return this.hasHandlers() ? [WATCH_POLL_METHOD] : [];
+    }
+    bindMethods() {
+        if (this.hasHandlers()) {
+            this.options.bindMethod(WATCH_POLL_METHOD);
+        }
+    }
+    kinds() {
+        return Array.from(this.handlers.keys()).sort();
+    }
+    initializeResponseFields() {
+        return this.hasHandlers() ? { watch_source_kinds: this.kinds() } : {};
+    }
+    async handlePoll(request, params) {
+        const poll = parseWatchPollRequest(params);
+        const registered = this.handlers.get(poll.kind);
+        if (!registered) {
+            throw new InvalidParamsError("watch source kind is not registered", { kind: poll.kind });
+        }
+        const context = this.options.makeContext(request);
+        const response = await registered.handler({
+            kind: registered.kind,
+            spec: poll.spec,
+            context,
+            host: context.host,
+            session: context.session,
+            ...(poll.expected_state_digest ? { expectedStateDigest: poll.expected_state_digest } : {}),
+        });
+        return normalizeWatchPollResponse(response);
+    }
+    ensureCapability(definition) {
+        const capabilities = definition.capabilities ?? {};
+        capabilities.provides = normalizeStringList([
+            ...(capabilities.provides ?? []),
+            WATCH_SOURCE_CAPABILITY,
+        ]);
+        definition.capabilities = capabilities;
+    }
+}
+export function isWatchSourceMethod(method) {
+    return method === WATCH_POLL_METHOD;
+}
+export function parseWatchPollRequest(params) {
+    if (typeof params !== "object" || params === null) {
+        throw new InvalidParamsError("watch/poll params must be an object");
+    }
+    const request = params;
+    if (typeof request.spec !== "object" || request.spec === null || Array.isArray(request.spec)) {
+        throw new InvalidParamsError("spec must be an object");
+    }
+    const kind = request.spec.kind;
+    if (typeof kind !== "string" || kind.trim() === "") {
+        throw new InvalidParamsError("spec.kind is required");
+    }
+    if (request.expected_state_digest !== undefined &&
+        typeof request.expected_state_digest !== "string") {
+        throw new InvalidParamsError("expected_state_digest must be a string");
+    }
+    return {
+        spec: cloneJSON(request.spec),
+        kind: kind.trim(),
+        ...(request.expected_state_digest
+            ? { expected_state_digest: request.expected_state_digest.trim() }
+            : {}),
+    };
+}
+export function normalizeWatchPollResponse(response) {
+    if (typeof response !== "object" || response === null) {
+        throw new InvalidParamsError("watch source response must be an object");
+    }
+    if (typeof response.ready !== "boolean") {
+        throw new InvalidParamsError("watch source response.ready must be a boolean");
+    }
+    if (response.state_digest !== undefined && typeof response.state_digest !== "string") {
+        throw new InvalidParamsError("watch source response.state_digest must be a string");
+    }
+    if (response.settled_at !== undefined && typeof response.settled_at !== "string") {
+        throw new InvalidParamsError("watch source response.settled_at must be a string");
+    }
+    return {
+        ready: response.ready,
+        ...(response.state_digest ? { state_digest: response.state_digest } : {}),
+        ...(response.payload !== undefined ? { payload: cloneJSON(response.payload) } : {}),
+        ...(response.settled_at ? { settled_at: response.settled_at } : {}),
+    };
+}
+function normalizeStringList(values) {
+    return Array.from(new Set((values ?? []).map(value => value.trim()).filter(Boolean))).sort();
+}
+//# sourceMappingURL=watch-source.js.map

package/dist/esm/watch-source.js.map

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