@compozy/extension-sdk 0.3.0-beta.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NauckGroup LTDA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cjs/base-types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=base-types.js.map

package/dist/cjs/base-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-types.js","sourceRoot":"","sources":["../../src/base-types.ts"],"names":[],"mappings":""}

package/dist/cjs/capabilities.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOLS_CALL_METHOD = exports.PROVIDE_TOOLS_METHOD = exports.TOOL_PROVIDER_CAPABILITY = void 0;
+exports.isToolProviderMethod = isToolProviderMethod;
+exports.validateProvidedMethodCoverage = validateProvidedMethodCoverage;
+const errors_js_1 = require("./errors.js");
+const contracts_js_1 = require("./generated/contracts.js");
+exports.TOOL_PROVIDER_CAPABILITY = "tool.provider";
+exports.PROVIDE_TOOLS_METHOD = "provide_tools";
+exports.TOOLS_CALL_METHOD = "tools/call";
+function isToolProviderMethod(method) {
+    return method === exports.PROVIDE_TOOLS_METHOD || method === exports.TOOLS_CALL_METHOD;
+}
+function validateProvidedMethodCoverage(provides, implementedMethods) {
+    const implemented = new Set(implementedMethods);
+    for (const capability of provides) {
+        const requiredMethods = contracts_js_1.REQUIRED_METHODS_BY_PROVIDE[capability];
+        if (!requiredMethods) {
+            continue;
+        }
+        const missing = requiredMethods.filter(method => !implemented.has(method));
+        if (missing.length > 0) {
+            throw new errors_js_1.InternalError(`capability ${capability} requires methods ${missing.join(", ")}`);
+        }
+    }
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/cjs/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/capabilities.ts"],"names":[],"mappings":";;;;;AAAA,2CAA4C;AAC5C,2DAAuE;AAE1D,QAAA,wBAAwB,GAAG,eAAe,CAAC;AAC3C,QAAA,oBAAoB,GAAG,eAAe,CAAC;AACvC,QAAA,iBAAiB,GAAG,YAAY,CAAC;AAE9C,8BAAqC,MAAc;IACjD,OAAO,MAAM,KAAK,QAAA,oBAAoB,IAAI,MAAM,KAAK,QAAA,iBAAiB,CAAC;AACzE,CAAC;AAED,wCACE,QAA2B,EAC3B,kBAAqC;IAErC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChD,KAAK,MAAM,UAAU,IAAI,QAAQ,EAAE,CAAC;QAClC,MAAM,eAAe,GACnB,0CACD,CAAC,UAAU,CAAC,CAAC;QACd,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,yBAAa,CAAC,cAAc,UAAU,qBAAqB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/cjs/connectivity-provider.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONNECTIVITY_TEARDOWN_METHOD = exports.CONNECTIVITY_STATUS_METHOD = exports.CONNECTIVITY_ESTABLISH_METHOD = exports.CONNECTIVITY_PROVIDER_CAPABILITY = void 0;
+exports.registerConnectivityProvider = registerConnectivityProvider;
+const errors_js_1 = require("./errors.js");
+const extension_provide_surface_js_1 = require("./extension-provide-surface.js");
+exports.CONNECTIVITY_PROVIDER_CAPABILITY = "connectivity.provider";
+exports.CONNECTIVITY_ESTABLISH_METHOD = "connectivity/establish";
+exports.CONNECTIVITY_STATUS_METHOD = "connectivity/status";
+exports.CONNECTIVITY_TEARDOWN_METHOD = "connectivity/teardown";
+function parseRequestRecord(method, request) {
+    if (typeof request !== "object" || request === null || Array.isArray(request)) {
+        throw new errors_js_1.InvalidParamsError(`${method} params must be an object`);
+    }
+    return request;
+}
+function requiredString(method, request, field) {
+    const value = request[field];
+    if (typeof value !== "string" || value.length === 0) {
+        throw new errors_js_1.InvalidParamsError(`${method} requires a non-empty ${field}`);
+    }
+    return value;
+}
+function parseEstablishRequest(request) {
+    const record = parseRequestRecord(exports.CONNECTIVITY_ESTABLISH_METHOD, request);
+    return {
+        tier: requiredString(exports.CONNECTIVITY_ESTABLISH_METHOD, record, "tier"),
+        forward_target: requiredString(exports.CONNECTIVITY_ESTABLISH_METHOD, record, "forward_target"),
+        challenge_path: requiredString(exports.CONNECTIVITY_ESTABLISH_METHOD, record, "challenge_path"),
+        deadline: requiredString(exports.CONNECTIVITY_ESTABLISH_METHOD, record, "deadline"),
+    };
+}
+function parseStatusRequest(request) {
+    const record = parseRequestRecord(exports.CONNECTIVITY_STATUS_METHOD, request);
+    return {
+        tier: requiredString(exports.CONNECTIVITY_STATUS_METHOD, record, "tier"),
+    };
+}
+function parseTeardownRequest(request) {
+    const record = parseRequestRecord(exports.CONNECTIVITY_TEARDOWN_METHOD, request);
+    return {
+        tier: requiredString(exports.CONNECTIVITY_TEARDOWN_METHOD, record, "tier"),
+        deadline: requiredString(exports.CONNECTIVITY_TEARDOWN_METHOD, record, "deadline"),
+    };
+}
+function registerConnectivityProvider(extension, handlers) {
+    if (!extension) {
+        throw new Error("extension is required");
+    }
+    if (typeof handlers?.establish !== "function" ||
+        typeof handlers.status !== "function" ||
+        typeof handlers.teardown !== "function") {
+        throw new Error("connectivity provider handlers are required");
+    }
+    return extension[extension_provide_surface_js_1.registerProvideSurface](exports.CONNECTIVITY_PROVIDER_CAPABILITY, [
+        {
+            method: exports.CONNECTIVITY_ESTABLISH_METHOD,
+            handler: async (context, request) => await handlers.establish(context, parseEstablishRequest(request)),
+        },
+        {
+            method: exports.CONNECTIVITY_STATUS_METHOD,
+            handler: async (context, request) => await handlers.status(context, parseStatusRequest(request)),
+        },
+        {
+            method: exports.CONNECTIVITY_TEARDOWN_METHOD,
+            handler: async (context, request) => await handlers.teardown(context, parseTeardownRequest(request)),
+        },
+    ]);
+}
+//# sourceMappingURL=connectivity-provider.js.map

package/dist/cjs/connectivity-provider.js.map

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

package/dist/cjs/errors.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolExecutionError = exports.ShutdownInProgressError = exports.NotInitializedError = exports.RateLimitedError = exports.CapabilityDeniedError = exports.InternalError = exports.InvalidParamsError = exports.MethodNotFoundError = exports.InvalidRequestError = exports.ParseError = exports.RPCError = void 0;
+exports.isRPCError = isRPCError;
+exports.errorFromObject = errorFromObject;
+exports.ensureRPCError = ensureRPCError;
+class RPCError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.name = new.target.name;
+        this.code = code;
+        this.data = data;
+    }
+    toJSONRPC() {
+        const base = {
+            code: this.code,
+            message: this.message,
+        };
+        if (this.data === undefined) {
+            return base;
+        }
+        return {
+            ...base,
+            data: this.data,
+        };
+    }
+}
+exports.RPCError = RPCError;
+class ParseError extends RPCError {
+    constructor(error) {
+        super(-32700, "Parse error", { error });
+    }
+}
+exports.ParseError = ParseError;
+class InvalidRequestError extends RPCError {
+    constructor(reason) {
+        super(-32600, "Invalid request", { reason });
+    }
+}
+exports.InvalidRequestError = InvalidRequestError;
+class MethodNotFoundError extends RPCError {
+    constructor(method) {
+        super(-32601, "Method not found", { method });
+    }
+}
+exports.MethodNotFoundError = MethodNotFoundError;
+class InvalidParamsError extends RPCError {
+    constructor(error, data) {
+        super(-32602, "Invalid params", { error, ...data });
+    }
+}
+exports.InvalidParamsError = InvalidParamsError;
+class InternalError extends RPCError {
+    constructor(error) {
+        super(-32603, "Internal error", { error });
+    }
+}
+exports.InternalError = InternalError;
+class CapabilityDeniedError extends RPCError {
+    constructor(data) {
+        super(-32001, "Capability denied", data);
+    }
+}
+exports.CapabilityDeniedError = CapabilityDeniedError;
+class RateLimitedError extends RPCError {
+    constructor(data) {
+        super(-32002, "Rate limited", data);
+    }
+}
+exports.RateLimitedError = RateLimitedError;
+class NotInitializedError extends RPCError {
+    constructor(data = { allowed_methods: ["initialize"] }) {
+        super(-32003, "Not initialized", data);
+    }
+}
+exports.NotInitializedError = NotInitializedError;
+class ShutdownInProgressError extends RPCError {
+    constructor(data = {}) {
+        super(-32004, "Shutdown in progress", data);
+    }
+}
+exports.ShutdownInProgressError = ShutdownInProgressError;
+class ToolExecutionError extends RPCError {
+    constructor(data = {}) {
+        super(-32010, "Tool execution failed", data);
+    }
+}
+exports.ToolExecutionError = ToolExecutionError;
+function isRPCError(error) {
+    return error instanceof RPCError;
+}
+function errorFromObject(error) {
+    switch (error.code) {
+        case -32601:
+            return new MethodNotFoundError(String(error.data?.method ?? ""));
+        case -32602:
+            return new InvalidParamsError(String(error.data?.error ?? error.message), error.data ?? {});
+        case -32001:
+            return new CapabilityDeniedError(error.data ?? {});
+        case -32002:
+            return new RateLimitedError(error.data ?? {});
+        case -32003:
+            return new NotInitializedError(error.data ?? {});
+        case -32004:
+            return new ShutdownInProgressError(error.data ?? {});
+        case -32010:
+            return new ToolExecutionError(error.data ?? {});
+        default:
+            return new RPCError(error.code, error.message, error.data);
+    }
+}
+function ensureRPCError(error) {
+    if (error instanceof RPCError) {
+        return error;
+    }
+    if (error instanceof Error) {
+        return new InternalError(error.message);
+    }
+    return new InternalError(String(error));
+}
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

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

package/dist/cjs/extension-context.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeExtensionContext = makeExtensionContext;
+exports.writeExtensionError = writeExtensionError;
+const node_util_1 = require("node:util");
+const errors_js_1 = require("./errors.js");
+function makeExtensionContext(request, host, session, stderr) {
+    if (!session) {
+        throw new errors_js_1.InternalError("session is not initialized");
+    }
+    if (request.id === undefined) {
+        throw new errors_js_1.InternalError("request id is required");
+    }
+    return {
+        request,
+        requestId: request.id,
+        host,
+        session,
+        log: (...values) => {
+            stderr.write(`${(0, node_util_1.format)(...values)}\n`);
+        },
+    };
+}
+function writeExtensionError(stderr, message, error) {
+    const detail = error instanceof Error ? (error.stack ?? error.message) : String(error);
+    stderr.write(`${message}: ${detail}\n`);
+}
+//# sourceMappingURL=extension-context.js.map

package/dist/cjs/extension-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-context.js","sourceRoot":"","sources":["../../src/extension-context.ts"],"names":[],"mappings":";;;;AAAA,yCAAmC;AAEnC,2CAA4C;AAK5C,8BACE,OAA+B,EAC/B,IAAa,EACb,OAAqC,EACrC,MAA6B;IAE7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,yBAAa,CAAC,4BAA4B,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,OAAO,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,yBAAa,CAAC,wBAAwB,CAAC,CAAC;IACpD,CAAC;IACD,OAAO;QACL,OAAO;QACP,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,IAAI;QACJ,OAAO;QACP,GAAG,EAAE,CAAC,GAAG,MAAiB,EAAE,EAAE;YAC5B,MAAM,CAAC,KAAK,CAAC,GAAG,IAAA,kBAAM,EAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,6BACE,MAA6B,EAC7B,OAAe,EACf,KAAc;IAEd,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvF,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,KAAK,MAAM,IAAI,CAAC,CAAC;AAC1C,CAAC"}

package/dist/cjs/extension-contract.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_PROTOCOL_VERSIONS = exports.SDK_MIN_COMPOZY_VERSION = exports.SDK_VERSION = exports.SDK_NAME = void 0;
+exports.SDK_NAME = "@compozy/extension-sdk";
+exports.SDK_VERSION = "0.1.0";
+exports.SDK_MIN_COMPOZY_VERSION = "0.3.0-beta.1";
+exports.SUPPORTED_PROTOCOL_VERSIONS = ["1"];
+//# sourceMappingURL=extension-contract.js.map

package/dist/cjs/extension-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-contract.js","sourceRoot":"","sources":["../../src/extension-contract.ts"],"names":[],"mappings":";;;AAmBa,QAAA,QAAQ,GAAG,wBAAwB,CAAC;AAEpC,QAAA,WAAW,GAAG,OAAO,CAAC;AAEtB,QAAA,uBAAuB,GAAG,cAAc,CAAC;AAEzC,QAAA,2BAA2B,GAAG,CAAC,GAAG,CAAC,CAAC"}

package/dist/cjs/extension-describe.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultExtensionDescribeProcess = defaultExtensionDescribeProcess;
+exports.runExtensionDescribeMode = runExtensionDescribeMode;
+exports.cloneExtensionToolDescriptors = cloneExtensionToolDescriptors;
+exports.buildExtensionDescribePayload = buildExtensionDescribePayload;
+const extension_contract_js_1 = require("./extension-contract.js");
+const extension_runtime_js_1 = require("./extension-runtime.js");
+function defaultExtensionDescribeProcess() {
+    return {
+        argv: process.argv,
+        stdout: process.stdout,
+        setExitCode: code => {
+            process.exitCode = code;
+        },
+    };
+}
+function runExtensionDescribeMode(describeProcess, describe) {
+    if (describeProcess.argv.at(-1)?.trim() !== "__describe") {
+        return false;
+    }
+    describeProcess.stdout.write(`${JSON.stringify(describe())}\n`);
+    describeProcess.setExitCode(0);
+    return true;
+}
+function cloneExtensionToolDescriptors(tools) {
+    return [...tools].map(tool => ({
+        ...tool.descriptor,
+        ...(tool.descriptor.input_schema === undefined
+            ? {}
+            : { input_schema: structuredClone(tool.descriptor.input_schema) }),
+        ...(tool.descriptor.output_schema === undefined
+            ? {}
+            : { output_schema: structuredClone(tool.descriptor.output_schema) }),
+        capabilities: [...(tool.descriptor.capabilities ?? [])],
+        ...(tool.descriptor.command === undefined
+            ? {}
+            : { command: structuredClone(tool.descriptor.command) }),
+    }));
+}
+function buildExtensionDescribePayload(input) {
+    const command = input.definition.subprocess?.command.trim() ?? "";
+    if (!command) {
+        throw new Error("subprocess command is required");
+    }
+    return {
+        name: input.definition.name.trim(),
+        version: input.definition.version.trim(),
+        ...(input.definition.description?.trim()
+            ? { description: input.definition.description.trim() }
+            : {}),
+        provides: (0, extension_runtime_js_1.normalizeStringList)(input.definition.capabilities?.provides),
+        permissions: (0, extension_runtime_js_1.normalizeHostMethodList)(input.definition.permissions?.requires),
+        requires_env: (0, extension_runtime_js_1.normalizeStringList)(input.definition.requires_env),
+        resources: {
+            skills: (0, extension_runtime_js_1.normalizeStringList)(input.definition.resources?.skills),
+            loops: (0, extension_runtime_js_1.normalizeStringList)(input.definition.resources?.loops),
+            agents: (0, extension_runtime_js_1.normalizeStringList)(input.definition.resources?.agents),
+            automation: (0, extension_runtime_js_1.normalizeStringList)(input.definition.resources?.automation),
+            layouts: (0, extension_runtime_js_1.normalizeStringList)(input.definition.resources?.layouts),
+        },
+        subprocess: {
+            command,
+            args: [...(input.definition.subprocess?.args ?? [])],
+            env: { ...input.definition.subprocess?.env },
+        },
+        ...(input.definition.network_participation === undefined
+            ? {}
+            : {
+                network_participation: {
+                    required: input.definition.network_participation.required,
+                    mode: input.definition.network_participation.mode.trim().toLowerCase(),
+                    channel_scopes: (0, extension_runtime_js_1.normalizeStringList)(input.definition.network_participation.channel_scopes),
+                },
+            }),
+        tools: [...input.tools].sort((left, right) => left.handler.localeCompare(right.handler)),
+        command_groups: input.commandGroups.map(group => ({ ...group })),
+        hook_events: (0, extension_runtime_js_1.normalizeStringList)(input.definition.supported_hook_events),
+        watch_source_kinds: input.watchSourceKinds,
+        sdk: {
+            name: extension_contract_js_1.SDK_NAME,
+            version: input.sdkVersion,
+            protocol_version: "1",
+            min_compozy_version: extension_contract_js_1.SDK_MIN_COMPOZY_VERSION,
+        },
+    };
+}
+//# sourceMappingURL=extension-describe.js.map

package/dist/cjs/extension-describe.js.map

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

package/dist/cjs/extension-initialize.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseInitializeRequest = parseInitializeRequest;
+exports.validateProtocolVersion = validateProtocolVersion;
+const errors_js_1 = require("./errors.js");
+const extension_contract_js_1 = require("./extension-contract.js");
+function parseInitializeRequest(params) {
+    if (typeof params !== "object" || params === null) {
+        throw new errors_js_1.InvalidParamsError("initialize params must be an object");
+    }
+    const request = params;
+    if (!request.protocol_version) {
+        throw new errors_js_1.InvalidParamsError("protocol_version is required");
+    }
+    if (typeof request.session_nonce !== "string" || request.session_nonce.trim() === "") {
+        throw new errors_js_1.InvalidParamsError("session_nonce is required");
+    }
+    if (!Array.isArray(request.supported_protocol_versions) ||
+        request.supported_protocol_versions.length === 0) {
+        throw new errors_js_1.InvalidParamsError("supported_protocol_versions is required");
+    }
+    if (!request.extension?.name || !request.extension?.version) {
+        throw new errors_js_1.InvalidParamsError("extension identity is required");
+    }
+    if (!request.capabilities || typeof request.capabilities !== "object") {
+        throw new errors_js_1.InvalidParamsError("capabilities are required");
+    }
+    if (!Array.isArray(request.capabilities.provides)) {
+        throw new errors_js_1.InvalidParamsError("capabilities.provides must be an array");
+    }
+    if (!Array.isArray(request.capabilities.granted_permissions)) {
+        throw new errors_js_1.InvalidParamsError("capabilities.granted_permissions must be an array");
+    }
+    if (!Array.isArray(request.capabilities.granted_resource_kinds)) {
+        throw new errors_js_1.InvalidParamsError("capabilities.granted_resource_kinds must be an array");
+    }
+    if (!Array.isArray(request.capabilities.granted_resource_scopes)) {
+        throw new errors_js_1.InvalidParamsError("capabilities.granted_resource_scopes must be an array");
+    }
+    if (!request.runtime) {
+        throw new errors_js_1.InvalidParamsError("runtime is required");
+    }
+    for (const field of [
+        "health_check_interval_ms",
+        "health_check_timeout_ms",
+        "shutdown_timeout_ms",
+        "default_hook_timeout_ms",
+    ]) {
+        if (!Number.isFinite(request.runtime[field]) || request.runtime[field] <= 0) {
+            throw new errors_js_1.InvalidParamsError(`${field} must be greater than zero`);
+        }
+    }
+    return request;
+}
+function validateProtocolVersion(request) {
+    if (!extension_contract_js_1.SUPPORTED_PROTOCOL_VERSIONS.includes(request.protocol_version)) {
+        throw new errors_js_1.InvalidParamsError("unsupported protocol version", {
+            reason: "unsupported_protocol_version",
+            protocol_version: request.protocol_version,
+            supported_protocol_versions: extension_contract_js_1.SUPPORTED_PROTOCOL_VERSIONS,
+        });
+    }
+    if (!request.supported_protocol_versions.includes("1")) {
+        throw new errors_js_1.InvalidParamsError("supported protocol versions must include 1");
+    }
+}
+//# sourceMappingURL=extension-initialize.js.map

package/dist/cjs/extension-initialize.js.map

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

package/dist/cjs/extension-provide-surface.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExtensionProvideSurfaces = exports.registerProvideSurface = void 0;
+const extension_runtime_js_1 = require("./extension-runtime.js");
+exports.registerProvideSurface = Symbol("registerProvideSurface");
+class ExtensionProvideSurfaces {
+    options;
+    owners = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    owner(method) {
+        return this.owners.get(method);
+    }
+    register(definition, capability, registrations) {
+        const cleanCapability = capability.trim();
+        if (!cleanCapability) {
+            throw new Error("provide capability is required");
+        }
+        if (registrations.length === 0) {
+            throw new Error(`${cleanCapability} requires at least one service method`);
+        }
+        const prepared = registrations.map(registration => ({
+            method: registration.method.trim(),
+            handler: registration.handler,
+        }));
+        this.validateRegistrations(cleanCapability, prepared);
+        const previousCapabilities = definition.capabilities;
+        definition.capabilities = {
+            ...previousCapabilities,
+            provides: (0, extension_runtime_js_1.normalizeStringList)([...(previousCapabilities?.provides ?? []), cleanCapability]),
+        };
+        for (const registration of prepared) {
+            this.options.handlers.set(registration.method, registration.handler);
+            this.owners.set(registration.method, cleanCapability);
+        }
+        try {
+            for (const registration of prepared) {
+                this.options.bindMethod(registration.method);
+            }
+        }
+        catch (error) {
+            for (const registration of prepared) {
+                this.options.handlers.delete(registration.method);
+                this.owners.delete(registration.method);
+                this.options.unbindMethod(registration.method);
+            }
+            if (previousCapabilities === undefined) {
+                delete definition.capabilities;
+            }
+            else {
+                definition.capabilities = previousCapabilities;
+            }
+            throw error;
+        }
+    }
+    validateRegistrations(capability, registrations) {
+        const seen = new Set();
+        for (const registration of registrations) {
+            if (!registration.method) {
+                throw new Error(`${capability} service method is required`);
+            }
+            if (registration.method === "initialize") {
+                throw new Error("initialize is reserved by the SDK");
+            }
+            if (typeof registration.handler !== "function") {
+                throw new Error(`${registration.method} handler is required`);
+            }
+            if (seen.has(registration.method)) {
+                throw new Error(`${registration.method} is declared more than once`);
+            }
+            seen.add(registration.method);
+            if (this.options.handlers.has(registration.method) || this.owners.has(registration.method)) {
+                throw new Error(`${registration.method} is already registered`);
+            }
+            this.options.validateMethod(registration.method);
+        }
+    }
+}
+exports.ExtensionProvideSurfaces = ExtensionProvideSurfaces;
+//# sourceMappingURL=extension-provide-surface.js.map

package/dist/cjs/extension-provide-surface.js.map

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