@compozy/extension-sdk 0.3.0-beta.3

package/dist/cjs/transport.js

@@ -0,0 +1,240 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotReadyTransport = exports.StdioTransport = exports.JSON_RPC_VERSION = exports.DEFAULT_MAX_MESSAGE_BYTES = void 0;
+const node_buffer_1 = require("node:buffer");
+const errors_js_1 = require("./errors.js");
+exports.DEFAULT_MAX_MESSAGE_BYTES = 10 * 1024 * 1024;
+exports.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 === exports.JSON_RPC_VERSION && typeof value.method === "string";
+}
+function isResponseFrame(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    return value.jsonrpc === exports.JSON_RPC_VERSION && "id" in value && !("method" in value);
+}
+class StdioTransport {
+    input;
+    output;
+    maxMessageBytes;
+    handlers = new Map();
+    pending = new Map();
+    errorListeners = new Set();
+    readBuffer = node_buffer_1.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 ?? exports.DEFAULT_MAX_MESSAGE_BYTES;
+        this.onDataBound = chunk => {
+            this.handleChunk(typeof chunk === "string" ? node_buffer_1.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: exports.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 = node_buffer_1.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 (node_buffer_1.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 errors_js_1.ParseError(error.message) : new errors_js_1.ParseError(String(error)));
+            return;
+        }
+        if (Array.isArray(parsed)) {
+            this.fail(new errors_js_1.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 errors_js_1.InvalidRequestError("invalid json-rpc envelope"));
+    }
+    async dispatchRequest(request) {
+        const handler = this.handlers.get(request.method.trim());
+        if (!handler) {
+            await this.sendError(request.id, new errors_js_1.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, (0, errors_js_1.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((0, errors_js_1.errorFromObject)(response.error));
+            return;
+        }
+        pending.resolve(response.result);
+    }
+    async sendResult(id, result) {
+        this.writeFrame({
+            jsonrpc: exports.JSON_RPC_VERSION,
+            id,
+            result,
+        });
+    }
+    async sendError(id, error) {
+        const rpcError = (0, errors_js_1.ensureRPCError)(error);
+        this.writeFrame({
+            jsonrpc: exports.JSON_RPC_VERSION,
+            id,
+            error: rpcError.toJSONRPC(),
+        });
+    }
+    writeFrame(frame) {
+        const encoded = JSON.stringify(frame);
+        if (node_buffer_1.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);
+        }
+    }
+}
+exports.StdioTransport = StdioTransport;
+class NotReadyTransport {
+    handle() { }
+    onTransportError() {
+        return () => { };
+    }
+    start() { }
+    async close() { }
+    async call(_method, _params) {
+        throw new errors_js_1.NotInitializedError();
+    }
+}
+exports.NotReadyTransport = NotReadyTransport;
+//# sourceMappingURL=transport.js.map

package/dist/cjs/transport.js.map

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

package/dist/cjs/types.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./base-types.js"), exports);
+__exportStar(require("./generated/contracts.js"), exports);
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

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

package/dist/cjs/watch-source.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExtensionWatchSources = exports.WATCH_POLL_METHOD = exports.WATCH_SOURCE_CAPABILITY = void 0;
+exports.isWatchSourceMethod = isWatchSourceMethod;
+exports.parseWatchPollRequest = parseWatchPollRequest;
+exports.normalizeWatchPollResponse = normalizeWatchPollResponse;
+const errors_js_1 = require("./errors.js");
+const json_js_1 = require("./json.js");
+exports.WATCH_SOURCE_CAPABILITY = "loop.watch_source";
+exports.WATCH_POLL_METHOD = "watch/poll";
+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(exports.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(exports.WATCH_POLL_METHOD);
+    }
+    hasHandlers() {
+        return this.handlers.size > 0;
+    }
+    implementedMethods() {
+        return this.hasHandlers() ? [exports.WATCH_POLL_METHOD] : [];
+    }
+    bindMethods() {
+        if (this.hasHandlers()) {
+            this.options.bindMethod(exports.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 errors_js_1.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 ?? []),
+            exports.WATCH_SOURCE_CAPABILITY,
+        ]);
+        definition.capabilities = capabilities;
+    }
+}
+exports.ExtensionWatchSources = ExtensionWatchSources;
+function isWatchSourceMethod(method) {
+    return method === exports.WATCH_POLL_METHOD;
+}
+function parseWatchPollRequest(params) {
+    if (typeof params !== "object" || params === null) {
+        throw new errors_js_1.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 errors_js_1.InvalidParamsError("spec must be an object");
+    }
+    const kind = request.spec.kind;
+    if (typeof kind !== "string" || kind.trim() === "") {
+        throw new errors_js_1.InvalidParamsError("spec.kind is required");
+    }
+    if (request.expected_state_digest !== undefined &&
+        typeof request.expected_state_digest !== "string") {
+        throw new errors_js_1.InvalidParamsError("expected_state_digest must be a string");
+    }
+    return {
+        spec: (0, json_js_1.cloneJSON)(request.spec),
+        kind: kind.trim(),
+        ...(request.expected_state_digest
+            ? { expected_state_digest: request.expected_state_digest.trim() }
+            : {}),
+    };
+}
+function normalizeWatchPollResponse(response) {
+    if (typeof response !== "object" || response === null) {
+        throw new errors_js_1.InvalidParamsError("watch source response must be an object");
+    }
+    if (typeof response.ready !== "boolean") {
+        throw new errors_js_1.InvalidParamsError("watch source response.ready must be a boolean");
+    }
+    if (response.state_digest !== undefined && typeof response.state_digest !== "string") {
+        throw new errors_js_1.InvalidParamsError("watch source response.state_digest must be a string");
+    }
+    if (response.settled_at !== undefined && typeof response.settled_at !== "string") {
+        throw new errors_js_1.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: (0, json_js_1.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/cjs/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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"}

package/dist/esm/base-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base-types.js.map

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

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

package/dist/esm/capabilities.js

@@ -0,0 +1,22 @@
+import { InternalError } from "./errors.js";
+import { REQUIRED_METHODS_BY_PROVIDE } from "./generated/contracts.js";
+export const TOOL_PROVIDER_CAPABILITY = "tool.provider";
+export const PROVIDE_TOOLS_METHOD = "provide_tools";
+export const TOOLS_CALL_METHOD = "tools/call";
+export function isToolProviderMethod(method) {
+    return method === PROVIDE_TOOLS_METHOD || method === TOOLS_CALL_METHOD;
+}
+export function validateProvidedMethodCoverage(provides, implementedMethods) {
+    const implemented = new Set(implementedMethods);
+    for (const capability of provides) {
+        const requiredMethods = REQUIRED_METHODS_BY_PROVIDE[capability];
+        if (!requiredMethods) {
+            continue;
+        }
+        const missing = requiredMethods.filter(method => !implemented.has(method));
+        if (missing.length > 0) {
+            throw new InternalError(`capability ${capability} requires methods ${missing.join(", ")}`);
+        }
+    }
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/esm/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAC;AACxD,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC;AACpD,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAE9C,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,MAAM,KAAK,oBAAoB,IAAI,MAAM,KAAK,iBAAiB,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,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,2BACD,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,aAAa,CAAC,cAAc,UAAU,qBAAqB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/esm/errors.js

@@ -0,0 +1,106 @@
+export 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,
+        };
+    }
+}
+export class ParseError extends RPCError {
+    constructor(error) {
+        super(-32700, "Parse error", { error });
+    }
+}
+export class InvalidRequestError extends RPCError {
+    constructor(reason) {
+        super(-32600, "Invalid request", { reason });
+    }
+}
+export class MethodNotFoundError extends RPCError {
+    constructor(method) {
+        super(-32601, "Method not found", { method });
+    }
+}
+export class InvalidParamsError extends RPCError {
+    constructor(error, data) {
+        super(-32602, "Invalid params", { error, ...data });
+    }
+}
+export class InternalError extends RPCError {
+    constructor(error) {
+        super(-32603, "Internal error", { error });
+    }
+}
+export class CapabilityDeniedError extends RPCError {
+    constructor(data) {
+        super(-32001, "Capability denied", data);
+    }
+}
+export class RateLimitedError extends RPCError {
+    constructor(data) {
+        super(-32002, "Rate limited", data);
+    }
+}
+export class NotInitializedError extends RPCError {
+    constructor(data = { allowed_methods: ["initialize"] }) {
+        super(-32003, "Not initialized", data);
+    }
+}
+export class ShutdownInProgressError extends RPCError {
+    constructor(data = {}) {
+        super(-32004, "Shutdown in progress", data);
+    }
+}
+export class ToolExecutionError extends RPCError {
+    constructor(data = {}) {
+        super(-32010, "Tool execution failed", data);
+    }
+}
+export function isRPCError(error) {
+    return error instanceof RPCError;
+}
+export 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);
+    }
+}
+export 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/esm/errors.js.map

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

package/dist/esm/extension-context.js

@@ -0,0 +1,24 @@
+import { format } from "node:util";
+import { InternalError } from "./errors.js";
+export function makeExtensionContext(request, host, session, stderr) {
+    if (!session) {
+        throw new InternalError("session is not initialized");
+    }
+    if (request.id === undefined) {
+        throw new InternalError("request id is required");
+    }
+    return {
+        request,
+        requestId: request.id,
+        host,
+        session,
+        log: (...values) => {
+            stderr.write(`${format(...values)}\n`);
+        },
+    };
+}
+export 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/esm/extension-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-context.js","sourceRoot":"","sources":["../../src/extension-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK5C,MAAM,UAAU,oBAAoB,CAClC,OAA+B,EAC/B,IAAa,EACb,OAAqC,EACrC,MAA6B;IAE7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,aAAa,CAAC,4BAA4B,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,OAAO,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,aAAa,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,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,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/esm/extension-contract.js

@@ -0,0 +1,6 @@
+import { HostAPI } from "./host-api.js";
+export const SDK_NAME = "@compozy/extension-sdk";
+export const SDK_VERSION = "0.1.0";
+export const SDK_MIN_COMPOZY_VERSION = "0.3.0-beta.1";
+export const SUPPORTED_PROTOCOL_VERSIONS = ["1"];
+//# sourceMappingURL=extension-contract.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension-contract.js","sourceRoot":"","sources":["../../src/extension-contract.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,CAAC,MAAM,QAAQ,GAAG,wBAAwB,CAAC;AAEjD,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC,MAAM,CAAC,MAAM,uBAAuB,GAAG,cAAc,CAAC;AAEtD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,GAAG,CAAC,CAAC"}