@compozy/extension-sdk 0.3.0-beta.3

package/dist/esm/extension.js

@@ -0,0 +1,325 @@
+import { ExtensionWatchSources, WATCH_POLL_METHOD, isWatchSourceMethod, } from "./watch-source.js";
+import { HostAPI } from "./host-api.js";
+import { StdioTransport } from "./transport.js";
+import { PROVIDE_TOOLS_METHOD, TOOL_PROVIDER_CAPABILITY, TOOLS_CALL_METHOD, isToolProviderMethod, validateProvidedMethodCoverage, } from "./capabilities.js";
+import { InvalidParamsError, MethodNotFoundError, NotInitializedError, ShutdownInProgressError, isRPCError, } from "./errors.js";
+import { ensureSubset, implementedExtensionMethods, normalizeHostMethodList, normalizeStringList, normalizeToolResult, parseShutdownRequest, parseToolCallRequest, toolExecutionError, transportMethods, } from "./extension-runtime.js";
+import { SDK_NAME, SDK_VERSION } from "./extension-contract.js";
+import { makeExtensionContext, writeExtensionError } from "./extension-context.js";
+import { makeExtensionToolContext } from "./extension-tool-context.js";
+import { parseInitializeRequest, validateProtocolVersion } from "./extension-initialize.js";
+import { buildExtensionDescribePayload, cloneExtensionToolDescriptors, defaultExtensionDescribeProcess, runExtensionDescribeMode, } from "./extension-describe.js";
+import { buildRegisteredTool } from "./extension-tool-registration.js";
+export class Extension {
+    definition;
+    transport;
+    stderr;
+    sdkVersion;
+    describeProcess;
+    handlers = new Map();
+    toolHandlers = new Map();
+    commandGroups = [];
+    watchSources = new ExtensionWatchSources({
+        bindMethod: method => this.bindMethod(method),
+        hasUserHandler: method => this.handlers.has(method),
+        makeContext: request => this.makeContext(request),
+    });
+    readyCallbacks = new Set();
+    transportBindings = new Set();
+    host;
+    initialized = false;
+    shutdownStarted = false;
+    shutdownDeadlineMS;
+    session;
+    startPromise;
+    resolveStart;
+    rejectStart;
+    constructor(definition, options = {}) {
+        this.definition = definition;
+        this.transport = options.transport ?? new StdioTransport();
+        this.stderr = options.stderr ?? process.stderr;
+        this.sdkVersion = options.sdkVersion ?? SDK_VERSION;
+        this.describeProcess = options.describeProcess ?? defaultExtensionDescribeProcess();
+        this.host = new HostAPI({
+            call: async (method, params) => await this.transport.call(method, params),
+        }, { isReady: () => this.initialized && !this.shutdownStarted });
+        this.bindTransportHandlers();
+    }
+    bindTransport(transport) {
+        if (this.startPromise) {
+            throw new Error("transport may only be swapped before start()");
+        }
+        this.transport = transport;
+        this.transportBindings.clear();
+        this.bindTransportHandlers();
+        return this;
+    }
+    handle(method, handler) {
+        const cleanMethod = method.trim();
+        if (cleanMethod === "initialize") {
+            throw new Error("initialize is reserved by the SDK");
+        }
+        if (this.toolHandlers.size > 0 && isToolProviderMethod(cleanMethod)) {
+            throw new Error(`${cleanMethod} is reserved by extension.tool()`);
+        }
+        if (this.watchSources.hasHandlers() && isWatchSourceMethod(cleanMethod)) {
+            throw new Error(`${cleanMethod} is reserved by extension.watchSource()`);
+        }
+        this.handlers.set(cleanMethod, handler);
+        this.bindMethod(cleanMethod);
+        return this;
+    }
+    tool(handler, options, toolHandler) {
+        const cleanHandler = handler.trim();
+        if (!cleanHandler) {
+            throw new Error("tool handler is required");
+        }
+        if (this.toolHandlers.has(cleanHandler)) {
+            throw new Error(`tool handler already registered: ${cleanHandler}`);
+        }
+        if (this.handlers.has(PROVIDE_TOOLS_METHOD) || this.handlers.has(TOOLS_CALL_METHOD)) {
+            throw new Error("provide_tools and tools/call are reserved by extension.tool()");
+        }
+        this.toolHandlers.set(cleanHandler, buildRegisteredTool(this.definition.name, cleanHandler, options, toolHandler));
+        this.ensureToolProviderCapability();
+        this.ensureToolProviderHandlers();
+        return this;
+    }
+    watchSource(kind, options, handler) {
+        this.watchSources.register(this.definition, kind, options, handler);
+        return this;
+    }
+    commandGroup(path, summary) {
+        if (this.initialized) {
+            throw new Error("extension registration is closed after initialize");
+        }
+        this.commandGroups.push({ path: path.trim(), summary: summary.trim() });
+        return this;
+    }
+    onReady(callback) {
+        this.readyCallbacks.add(callback);
+        if (this.initialized && this.session) {
+            queueMicrotask(() => {
+                void this.runReadyCallback(callback, this.session);
+            });
+        }
+        return this;
+    }
+    async start() {
+        if (runExtensionDescribeMode(this.describeProcess, () => this.describe())) {
+            return this.host;
+        }
+        if (this.startPromise) {
+            return await this.startPromise;
+        }
+        this.startPromise = new Promise((resolve, reject) => {
+            this.resolveStart = resolve;
+            this.rejectStart = reject;
+        });
+        this.transport.onTransportError(error => {
+            if (!this.initialized && this.rejectStart) {
+                this.rejectStart(error);
+            }
+            this.logError("transport error", error);
+        });
+        this.transport.start();
+        return await this.startPromise;
+    }
+    getImplementedMethods() {
+        return implementedExtensionMethods(this.handlers.keys(), this.toolHandlers.size > 0, this.watchSources.implementedMethods());
+    }
+    getSupportedHookEvents() {
+        return [...(this.definition.supported_hook_events ?? [])];
+    }
+    getToolDescriptors() {
+        return cloneExtensionToolDescriptors(this.toolHandlers.values());
+    }
+    describe() {
+        return buildExtensionDescribePayload({
+            definition: this.definition,
+            tools: this.getToolDescriptors(),
+            commandGroups: this.commandGroups.map(group => ({ ...group })),
+            watchSourceKinds: this.watchSources.kinds(),
+            sdkVersion: this.sdkVersion,
+        });
+    }
+    bindTransportHandlers() {
+        for (const method of transportMethods(this.handlers.keys(), this.toolHandlers.size > 0)) {
+            this.bindMethod(method);
+        }
+        this.watchSources.bindMethods();
+    }
+    bindMethod(method) {
+        if (this.transportBindings.has(method)) {
+            this.transport.handle(method, async (params, request) => await this.dispatch(method, params, request));
+            return;
+        }
+        this.transportBindings.add(method);
+        this.transport.handle(method, async (params, request) => await this.dispatch(method, params, request));
+    }
+    async dispatch(method, params, request) {
+        if (method === "initialize") {
+            return await this.handleInitialize(params);
+        }
+        if (!this.initialized || !this.session) {
+            throw new NotInitializedError();
+        }
+        if (this.shutdownStarted && method !== "shutdown") {
+            throw new ShutdownInProgressError(this.shutdownDeadlineMS === undefined ? {} : { deadline_ms: this.shutdownDeadlineMS });
+        }
+        switch (method) {
+            case "health_check":
+                return await this.handleHealthCheck(request, params);
+            case "shutdown":
+                return await this.handleShutdown(request, params);
+            case PROVIDE_TOOLS_METHOD:
+                return this.handleProvideTools();
+            case TOOLS_CALL_METHOD:
+                return await this.handleToolCall(request, params);
+            case WATCH_POLL_METHOD:
+                return await this.watchSources.handlePoll(request, params);
+            default:
+                return await this.handleUserMethod(method, request, params);
+        }
+    }
+    async handleInitialize(params) {
+        if (this.initialized) {
+            throw new InvalidParamsError("initialize may only be called once");
+        }
+        const request = parseInitializeRequest(params);
+        validateProtocolVersion(request);
+        const requestedProvides = normalizeStringList(this.definition.capabilities?.provides);
+        const requestedPermissions = normalizeHostMethodList(this.definition.permissions?.requires);
+        ensureSubset("provides", requestedProvides, request.capabilities.provides);
+        ensureSubset("permissions", requestedPermissions, request.capabilities.granted_permissions);
+        const implementedMethods = this.getImplementedMethods();
+        validateProvidedMethodCoverage(requestedProvides, implementedMethods);
+        const response = {
+            protocol_version: "1",
+            extension_info: {
+                name: this.definition.name,
+                version: this.definition.version,
+                sdk_name: SDK_NAME,
+                sdk_version: this.sdkVersion,
+            },
+            accepted_capabilities: {
+                provides: requestedProvides,
+                permissions: requestedPermissions,
+            },
+            implemented_methods: implementedMethods,
+            supported_hook_events: this.getSupportedHookEvents(),
+            ...this.watchSources.initializeResponseFields(),
+            supports: {
+                health_check: true,
+            },
+        };
+        this.initialized = true;
+        this.session = {
+            initializeRequest: request,
+            initializeResponse: response,
+            runtime: request.runtime,
+            acceptedCapabilities: response.accepted_capabilities,
+        };
+        setImmediate(() => {
+            void this.finishInitialization();
+        });
+        return response;
+    }
+    async finishInitialization() {
+        if (!this.session) {
+            return;
+        }
+        for (const callback of this.readyCallbacks) {
+            await this.runReadyCallback(callback, this.session);
+        }
+        this.resolveStart?.(this.host);
+        this.resolveStart = undefined;
+        this.rejectStart = undefined;
+    }
+    async runReadyCallback(callback, session) {
+        try {
+            await callback(this.host, session);
+        }
+        catch (error) {
+            this.logError("onReady callback failed", error);
+        }
+    }
+    async handleHealthCheck(request, params) {
+        const customHandler = this.handlers.get("health_check");
+        if (!customHandler) {
+            return {
+                healthy: true,
+                message: "",
+                details: {},
+            };
+        }
+        return (await customHandler(this.makeContext(request), params));
+    }
+    async handleShutdown(request, params) {
+        const shutdownRequest = parseShutdownRequest(params);
+        this.shutdownStarted = true;
+        this.shutdownDeadlineMS = shutdownRequest.deadline_ms;
+        const customHandler = this.handlers.get("shutdown");
+        if (customHandler) {
+            const result = (await customHandler(this.makeContext(request), shutdownRequest));
+            return result ?? { acknowledged: true };
+        }
+        return { acknowledged: true };
+    }
+    handleProvideTools() {
+        return {
+            tools: this.getToolDescriptors(),
+        };
+    }
+    async handleToolCall(request, params) {
+        const call = parseToolCallRequest(params);
+        const registered = this.toolHandlers.get(call.handler);
+        if (!registered) {
+            throw new MethodNotFoundError(call.handler);
+        }
+        if (registered.descriptor.id !== call.tool_id) {
+            throw new InvalidParamsError("tool_id does not match handler", {
+                expected_tool_id: registered.descriptor.id,
+                actual_tool_id: call.tool_id,
+                handler: call.handler,
+            });
+        }
+        const context = this.makeContext(request);
+        try {
+            const result = await registered.handler(makeExtensionToolContext(call, context));
+            return { result: normalizeToolResult(result) };
+        }
+        catch (error) {
+            if (isRPCError(error)) {
+                throw error;
+            }
+            throw toolExecutionError(error, call, registered.sensitiveInputFields);
+        }
+    }
+    async handleUserMethod(method, request, params) {
+        const handler = this.handlers.get(method);
+        if (!handler) {
+            throw new MethodNotFoundError(method);
+        }
+        return await handler(this.makeContext(request), params);
+    }
+    makeContext(request) {
+        return makeExtensionContext(request, this.host, this.session, this.stderr);
+    }
+    logError(message, error) {
+        writeExtensionError(this.stderr, message, error);
+    }
+    ensureToolProviderCapability() {
+        const capabilities = this.definition.capabilities ?? {};
+        capabilities.provides = normalizeStringList([
+            ...(capabilities.provides ?? []),
+            TOOL_PROVIDER_CAPABILITY,
+        ]);
+        this.definition.capabilities = capabilities;
+    }
+    ensureToolProviderHandlers() {
+        this.bindMethod(PROVIDE_TOOLS_METHOD);
+        this.bindMethod(TOOLS_CALL_METHOD);
+    }
+}
+//# sourceMappingURL=extension.js.map

package/dist/esm/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../src/extension.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,GAGpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAcxC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,YAAY,EACZ,2BAA2B,EAC3B,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAC5F,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAYvE,MAAM,OAAO,SAAS;IAyBF,UAAU;IAxBpB,SAAS,CAAgB;IAChB,MAAM,CAAwB;IAC9B,UAAU,CAAS;IACnB,eAAe,CAAmD;IAClE,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAC/C,YAAY,GAAG,IAAI,GAAG,EAA0B,CAAC;IACjD,aAAa,GAAgC,EAAE,CAAC;IAChD,YAAY,GAAG,IAAI,qBAAqB,CAAC;QACxD,UAAU,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAC7C,cAAc,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;QACnD,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;KAClD,CAAC,CAAC;IACc,cAAc,GAAG,IAAI,GAAG,EAAiB,CAAC;IAC1C,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,IAAI,CAAU;IACvB,WAAW,GAAG,KAAK,CAAC;IACpB,eAAe,GAAG,KAAK,CAAC;IACxB,kBAAkB,CAAqB;IACvC,OAAO,CAA+B;IACtC,YAAY,CAA+B;IAC3C,YAAY,CAAwC;IACpD,WAAW,CAA0C;IAE7D,YACkB,UAA+B,EAC/C,OAAO,GAAqB,EAAE;0BADd,UAAU;QAG1B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,cAAc,EAAE,CAAC;QAC3D,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;QAC/C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,WAAW,CAAC;QACpD,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,+BAA+B,EAAE,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,IAAI,OAAO,CACrB;YACE,IAAI,EAAE,KAAK,EAAW,MAAc,EAAE,MAAgB,EAAoB,EAAE,CAC1E,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAU,MAAM,EAAE,MAAM,CAAC;SACrD,EACD,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAC7D,CAAC;QAEF,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC/B,CAAC;IAEM,aAAa,CAAC,SAAwB;QAC3C,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM,CACX,MAAc,EACd,OAA2C;QAE3C,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,WAAW,KAAK,YAAY,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,IAAI,oBAAoB,CAAC,WAAW,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,GAAG,WAAW,kCAAkC,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,IAAI,mBAAmB,CAAC,WAAW,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CAAC,GAAG,WAAW,yCAAyC,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,OAA2B,CAAC,CAAC;QAC5D,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,IAAI,CACT,OAAe,EACf,OAA6B,EAC7B,WAAyC;QAEzC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,oCAAoC,YAAY,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACpF,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,GAAG,CACnB,YAAY,EACZ,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,CAAC,CAC9E,CAAC;QACF,IAAI,CAAC,4BAA4B,EAAE,CAAC;QACpC,IAAI,CAAC,0BAA0B,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,WAAW,CAChB,IAAY,EACZ,OAAoC,EACpC,OAA2C;QAE3C,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,YAAY,CAAC,IAAY,EAAE,OAAe;QAC/C,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,OAAO,CAAC,QAAuB;QACpC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACrC,cAAc,CAAC,GAAG,EAAE;gBAClB,KAAK,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAQ,CAAC,CAAC;YACtD,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,wBAAwB,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;YAC1E,OAAO,IAAI,CAAC,IAAI,CAAC;QACnB,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC;QACjC,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3D,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;YAC5B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE;YACtC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC1C,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAEvB,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC;IACjC,CAAC;IAEM,qBAAqB;QAC1B,OAAO,2BAA2B,CAChC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EACpB,IAAI,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,EAC1B,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAAE,CACvC,CAAC;IACJ,CAAC;IAEM,sBAAsB;QAC3B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5D,CAAC;IAEM,kBAAkB;QACvB,OAAO,6BAA6B,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IACnE,CAAC;IAEM,QAAQ;QACb,OAAO,6BAA6B,CAAC;YACnC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE;YAChC,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;YAC9D,gBAAgB,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE;YAC3C,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;IACL,CAAC;IAEO,qBAAqB;QAC3B,KAAK,MAAM,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC;YACxF,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC;IAEO,UAAU,CAAC,MAAc;QAC/B,IAAI,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,SAAS,CAAC,MAAM,CACnB,MAAM,EACN,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CACxE,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,MAAM,CACnB,MAAM,EACN,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CACxE,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,QAAQ,CACpB,MAAc,EACd,MAAe,EACf,OAA+B;QAE/B,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;YAC5B,OAAO,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACvC,MAAM,IAAI,mBAAmB,EAAE,CAAC;QAClC,CAAC;QACD,IAAI,IAAI,CAAC,eAAe,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAClD,MAAM,IAAI,uBAAuB,CAC/B,IAAI,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,kBAAkB,EAAE,CACtF,CAAC;QACJ,CAAC;QAED,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,cAAc;gBACjB,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvD,KAAK,UAAU;gBACb,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACpD,KAAK,oBAAoB;gBACvB,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACnC,KAAK,iBAAiB;gBACpB,OAAO,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACpD,KAAK,iBAAiB;gBACpB,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC7D;gBACE,OAAO,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,MAAe;QAC5C,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,kBAAkB,CAAC,oCAAoC,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC/C,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAEjC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QACtF,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAE5F,YAAY,CAAC,UAAU,EAAE,iBAAiB,EAAE,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC3E,YAAY,CAAC,aAAa,EAAE,oBAAoB,EAAE,OAAO,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;QAE5F,MAAM,kBAAkB,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACxD,8BAA8B,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;QAEtE,MAAM,QAAQ,GAAuB;YACnC,gBAAgB,EAAE,GAAG;YACrB,cAAc,EAAE;gBACd,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;gBAC1B,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO;gBAChC,QAAQ,EAAE,QAAQ;gBAClB,WAAW,EAAE,IAAI,CAAC,UAAU;aAC7B;YACD,qBAAqB,EAAE;gBACrB,QAAQ,EAAE,iBAAiB;gBAC3B,WAAW,EAAE,oBAAoB;aAClC;YACD,mBAAmB,EAAE,kBAAkB;YACvC,qBAAqB,EAAE,IAAI,CAAC,sBAAsB,EAAE;YACpD,GAAG,IAAI,CAAC,YAAY,CAAC,wBAAwB,EAAE;YAC/C,QAAQ,EAAE;gBACR,YAAY,EAAE,IAAI;aACnB;SACF,CAAC;QAEF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG;YACb,iBAAiB,EAAE,OAAO;YAC1B,kBAAkB,EAAE,QAAQ;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,oBAAoB,EAAE,QAAQ,CAAC,qBAAqB;SACrD,CAAC;QAEF,YAAY,CAAC,GAAG,EAAE;YAChB,KAAK,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,oBAAoB;QAChC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC3C,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;IAC/B,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,QAAuB,EACvB,OAAyB;QAEzB,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,QAAQ,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,OAA+B,EAC/B,MAAe;QAEf,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACxD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,EAAE;gBACX,OAAO,EAAE,EAAE;aACZ,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,MAAM,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,MAAe,CAAC,CAAsB,CAAC;IAChG,CAAC;IAEO,KAAK,CAAC,cAAc,CAC1B,OAA+B,EAC/B,MAAe;QAEf,MAAM,eAAe,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;QACrD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,kBAAkB,GAAG,eAAe,CAAC,WAAW,CAAC;QAEtD,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,CAAC,MAAM,aAAa,CACjC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EACzB,eAAwB,CACzB,CAAqB,CAAC;YACvB,OAAO,MAAM,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAChC,CAAC;IAEO,kBAAkB;QACxB,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE;SACjC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,cAAc,CAC1B,OAA+B,EAC/B,MAAe;QAEf,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAC9C,MAAM,IAAI,kBAAkB,CAAC,gCAAgC,EAAE;gBAC7D,gBAAgB,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE;gBAC1C,cAAc,EAAE,IAAI,CAAC,OAAO;gBAC5B,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,wBAAwB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;YACjF,OAAO,EAAE,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,oBAAoB,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,MAAc,EACd,OAA+B,EAC/B,MAAe;QAEf,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,MAAe,CAAC,CAAC;IACnE,CAAC;IAEO,WAAW,CAAC,OAA+B;QACjD,OAAO,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7E,CAAC;IAEO,QAAQ,CAAC,OAAe,EAAE,KAAc;QAC9C,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;IAEO,4BAA4B;QAClC,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,YAAY,IAAI,EAAE,CAAC;QACxD,YAAY,CAAC,QAAQ,GAAG,mBAAmB,CAAC;YAC1C,GAAG,CAAC,YAAY,CAAC,QAAQ,IAAI,EAAE,CAAC;YAChC,wBAAwB;SACzB,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,YAAY,GAAG,YAAY,CAAC;IAC9C,CAAC;IAEO,0BAA0B;QAChC,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/esm/generated/contracts.js

@@ -0,0 +1,17 @@
+export const REQUIRED_METHODS_BY_PROVIDE = {
+    "bridge.adapter": ["bridges/deliver", "bridges/targets/snapshot"],
+    "loop.watch_source": ["watch/poll"],
+    "memory.backend": ["memory/forget", "memory/recall", "memory/store"],
+    "model.source": ["models/list"],
+    "tool.provider": ["provide_tools", "tools/call"],
+};
+export const PUBLIC_PROVIDE_CONFORMANCE_FIXTURES = [
+    {
+        provide: "loop.watch_source",
+        required_methods: REQUIRED_METHODS_BY_PROVIDE["loop.watch_source"],
+    },
+    { provide: "memory.backend", required_methods: REQUIRED_METHODS_BY_PROVIDE["memory.backend"] },
+    { provide: "model.source", required_methods: REQUIRED_METHODS_BY_PROVIDE["model.source"] },
+    { provide: "tool.provider", required_methods: REQUIRED_METHODS_BY_PROVIDE["tool.provider"] },
+];
+//# sourceMappingURL=contracts.js.map

package/dist/esm/generated/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/generated/contracts.ts"],"names":[],"mappings":"AA03NA,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,gBAAgB,EAAE,CAAC,iBAAiB,EAAE,0BAA0B,CAAC;IACjE,mBAAmB,EAAE,CAAC,YAAY,CAAC;IACnC,gBAAgB,EAAE,CAAC,eAAe,EAAE,eAAe,EAAE,cAAc,CAAC;IACpE,cAAc,EAAE,CAAC,aAAa,CAAC;IAC/B,eAAe,EAAE,CAAC,eAAe,EAAE,YAAY,CAAC;CACc,CAAC;AAOjE,MAAM,CAAC,MAAM,mCAAmC,GAAyC;IACvF;QACE,OAAO,EAAE,mBAAmB;QAC5B,gBAAgB,EAAE,2BAA2B,CAAC,mBAAmB,CAAC;KACnE;IACD,EAAE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,2BAA2B,CAAC,gBAAgB,CAAC,EAAE;IAC9F,EAAE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,2BAA2B,CAAC,cAAc,CAAC,EAAE;IAC1F,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,2BAA2B,CAAC,eAAe,CAAC,EAAE;CAC7F,CAAC"}

package/dist/esm/host-api.js

@@ -0,0 +1,183 @@
+import { InvalidParamsError, NotInitializedError } from "./errors.js";
+async function callHostMethod(transport, method, params, isReady) {
+    if (!isReady()) {
+        throw new NotInitializedError();
+    }
+    return (await transport.call(method, params));
+}
+export class HostAPI {
+    transport;
+    isReady;
+    sessions;
+    soul;
+    heartbeat;
+    memory;
+    observe;
+    logs;
+    skills;
+    bridges;
+    network;
+    resources;
+    constructor(transport, options = {}) {
+        this.transport = transport;
+        this.isReady = options.isReady ?? (() => true);
+        this.sessions = {
+            list: async (params) => await this.request("sessions/list", params),
+            create: async (params) => await this.request("sessions/create", params),
+            prompt: async (params) => await this.request("sessions/prompt", params),
+            stop: async (params) => await this.request("sessions/stop", params),
+            status: async (params) => await this.request("sessions/status", params),
+            events: async (params) => await this.request("sessions/events", params),
+            refreshSoul: async (params) => await this.request("sessions/soul/refresh", params),
+            health: async (params) => await this.request("sessions/health/get", params),
+            authoredStatus: async (params) => await this.request("sessions/status/get", params),
+        };
+        this.soul = {
+            get: async (params) => await this.request("agents/soul/get", params),
+            validate: async (params) => await this.request("agents/soul/validate", params),
+            put: async (params) => await this.request("agents/soul/put", params),
+            delete: async (params) => await this.request("agents/soul/delete", params),
+            history: async (params) => await this.request("agents/soul/history", params),
+            rollback: async (params) => await this.request("agents/soul/rollback", params),
+        };
+        this.heartbeat = {
+            get: async (params) => await this.request("agents/heartbeat/get", params),
+            validate: async (params) => await this.request("agents/heartbeat/validate", params),
+            put: async (params) => await this.request("agents/heartbeat/put", params),
+            delete: async (params) => await this.request("agents/heartbeat/delete", params),
+            history: async (params) => await this.request("agents/heartbeat/history", params),
+            rollback: async (params) => await this.request("agents/heartbeat/rollback", params),
+            status: async (params) => await this.request("agents/heartbeat/status", params),
+            wake: async (params) => await this.request("agents/heartbeat/wake", params),
+        };
+        this.memory = {
+            recall: async (params) => await this.request("memory/recall", params),
+            store: async (params) => await this.request("memory/store", params),
+            forget: async (params) => await this.request("memory/forget", params),
+        };
+        this.observe = {
+            health: async () => await this.request("observe/health", undefined),
+        };
+        this.logs = {
+            list: async (params) => await this.request("logs/list", params),
+        };
+        this.skills = {
+            list: async (params) => await this.request("skills/list", params),
+        };
+        this.bridges = {
+            list: async () => await this.request("bridges/instances/list", undefined),
+            ingest: async (params) => await this.request("bridges/messages/ingest", params),
+            get: async (params) => await this.request("bridges/instances/get", params),
+            reportState: async (params) => await this.request("bridges/instances/report_state", params),
+        };
+        this.network = {
+            status: async () => await this.request("network/status", undefined),
+            channels: async (params) => await this.request("network/channels", params),
+            peers: async (params) => await this.request("network/peers", params),
+            threads: async (params) => await this.request("network/threads", params),
+            thread: {
+                get: async (params) => await this.request("network/thread/get", params),
+                messages: async (params) => await this.request("network/thread/messages", params),
+            },
+            directs: async (params) => await this.request("network/directs", params),
+            direct: {
+                resolve: async (params) => await this.request("network/direct/resolve", params),
+                messages: async (params) => await this.request("network/direct/messages", params),
+            },
+            work: {
+                get: async (params) => await this.request("network/work/get", params),
+            },
+            send: async (params) => await this.request("network/send", params),
+        };
+        this.resources = {
+            list: async (params) => {
+                validateResourcesListParams(params);
+                return await this.request("resources/list", params);
+            },
+            get: async (params) => {
+                validateResourceGetParams(params);
+                return await this.request("resources/get", params);
+            },
+            snapshot: async (params) => {
+                validateResourcesSnapshotParams(params);
+                return await this.request("resources/snapshot", params);
+            },
+        };
+    }
+    async request(method, params) {
+        return await callHostMethod(this.transport, method, params, this.isReady);
+    }
+}
+function validateResourcesListParams(params) {
+    if (params === undefined) {
+        return;
+    }
+    if (!isRecord(params)) {
+        throw new InvalidParamsError("resources.list params must be an object");
+    }
+    if (params.kind !== undefined) {
+        assertNonEmptyString(params.kind, "resources.list kind");
+    }
+    if (params.scope !== undefined) {
+        validateResourceScope(params.scope, "resources.list scope");
+    }
+    const limit = params.limit;
+    if (limit !== undefined &&
+        limit !== null &&
+        (typeof limit !== "number" || !Number.isInteger(limit) || limit < 0)) {
+        throw new InvalidParamsError("resources.list limit must be a non-negative integer");
+    }
+}
+function validateResourceGetParams(params) {
+    if (!isRecord(params)) {
+        throw new InvalidParamsError("resources.get params must be an object");
+    }
+    assertNonEmptyString(params.kind, "resources.get kind");
+    assertNonEmptyString(params.id, "resources.get id");
+}
+function validateResourcesSnapshotParams(params) {
+    if (!isRecord(params)) {
+        throw new InvalidParamsError("resources.snapshot params must be an object");
+    }
+    if (!Number.isInteger(params.source_version) || params.source_version <= 0) {
+        throw new InvalidParamsError("resources.snapshot source_version must be a positive integer");
+    }
+    if (!Array.isArray(params.records)) {
+        throw new InvalidParamsError("resources.snapshot records must be an array");
+    }
+    for (const [index, record] of params.records.entries()) {
+        if (!isRecord(record)) {
+            throw new InvalidParamsError(`resources.snapshot records[${index}] must be an object`);
+        }
+        assertNonEmptyString(record.kind, `resources.snapshot records[${index}].kind`);
+        assertNonEmptyString(record.id, `resources.snapshot records[${index}].id`);
+        validateResourceScope(record.scope, `resources.snapshot records[${index}].scope`);
+        if (!Object.prototype.hasOwnProperty.call(record, "spec") || record.spec === undefined) {
+            throw new InvalidParamsError(`resources.snapshot records[${index}].spec is required`);
+        }
+    }
+}
+function validateResourceScope(scope, field) {
+    if (!isRecord(scope)) {
+        throw new InvalidParamsError(`${field} must be an object`);
+    }
+    if (scope.kind !== "global" && scope.kind !== "workspace") {
+        throw new InvalidParamsError(`${field}.kind must be "global" or "workspace"`);
+    }
+    const id = typeof scope.id === "string" ? scope.id.trim() : "";
+    if (scope.kind === "global" && id !== "") {
+        throw new InvalidParamsError(`${field}.id must be empty for global scope`);
+    }
+    if (scope.kind === "workspace" && id === "") {
+        throw new InvalidParamsError(`${field}.id is required for workspace scope`);
+    }
+}
+function assertNonEmptyString(value, field) {
+    if (typeof value !== "string" || value.trim() === "") {
+        throw new InvalidParamsError(`${field} is required`);
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=host-api.js.map

package/dist/esm/host-api.js.map

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

package/dist/esm/index.js

@@ -0,0 +1,6 @@
+export { Extension } from "./extension.js";
+export { HostAPI } from "./host-api.js";
+export { DEFAULT_MAX_MESSAGE_BYTES, JSON_RPC_VERSION, NotReadyTransport, StdioTransport, } from "./transport.js";
+export { CapabilityDeniedError, InternalError, InvalidParamsError, InvalidRequestError, MethodNotFoundError, NotInitializedError, ParseError, RateLimitedError, RPCError, ShutdownInProgressError, ToolExecutionError, ensureRPCError, errorFromObject, isRPCError, } from "./errors.js";
+export { canonicalJSON, schemaDigest } from "./schema-digest.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACR,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/esm/json.js

@@ -0,0 +1,10 @@
+export function cloneJSON(value) {
+    if (value === null || typeof value !== "object") {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(item => cloneJSON(item));
+    }
+    return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, cloneJSON(entry)]));
+}
+//# sourceMappingURL=json.js.map

package/dist/esm/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/json.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CAAC,KAAgB;IACxC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAClG,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/schema-digest.js

@@ -0,0 +1,41 @@
+import { createHash } from "node:crypto";
+export function canonicalJSON(value) {
+    return appendCanonicalValue(value);
+}
+export function schemaDigest(schema) {
+    if (!isJSONObject(schema)) {
+        throw new Error("schema must be a JSON object");
+    }
+    return createHash("sha256").update(canonicalJSON(schema)).digest("hex");
+}
+function appendCanonicalValue(value) {
+    if (value === null) {
+        return "null";
+    }
+    if (typeof value === "boolean") {
+        return value ? "true" : "false";
+    }
+    if (typeof value === "string") {
+        return JSON.stringify(value);
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new Error("number must be finite");
+        }
+        if (Object.is(value, -0) || value === 0) {
+            return "0";
+        }
+        return String(value).replace("e+", "e");
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map(item => appendCanonicalValue(item)).join(",")}]`;
+    }
+    const keys = Object.keys(value).sort();
+    return `{${keys
+        .map(key => `${JSON.stringify(key)}:${appendCanonicalValue(value[key])}`)
+        .join(",")}}`;
+}
+function isJSONObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=schema-digest.js.map

package/dist/esm/schema-digest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-digest.js","sourceRoot":"","sources":["../../src/schema-digest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,MAAM,UAAU,aAAa,CAAC,KAAgB;IAC5C,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAiB;IAC5C,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAgB;IAC5C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IAClC,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACxC,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACxE,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,OAAO,IAAI,IAAI;SACZ,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,oBAAoB,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC,EAAE,CAAC;SACrF,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CAAC,KAAgB;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}