@compozy/extension-sdk 0.3.0-beta.10

package/dist/cjs/watch-source.js

@@ -0,0 +1,140 @@
+"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 (typeof response.event_key !== "string") {
+        throw new errors_js_1.InvalidParamsError("watch source response.event_key must be a string");
+    }
+    const eventKey = response.event_key.trim().normalize("NFC");
+    if (!eventKey) {
+        throw new errors_js_1.InvalidParamsError("watch source response.event_key is required");
+    }
+    if (new TextEncoder().encode(eventKey).byteLength > 256) {
+        throw new errors_js_1.InvalidParamsError("watch source response.event_key must be at most 256 bytes");
+    }
+    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,
+        event_key: eventKey,
+        ...(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":";;;;;;AAAA,2CAAiD;AACjD,uCAAsC;AAKzB,QAAA,uBAAuB,GAAG,mBAAmB,CAAC;AAC9C,QAAA,iBAAiB,GAAG,YAAY,CAAC;AA0C9C;IAGsC,OAAO;IAF1B,QAAQ,GAAG,IAAI,GAAG,EAAiC,CAAC;IAErE,YAAoC,OAAqC;uBAArC,OAAO;IAAiC,CAAC;IAEtE,QAAQ,CACb,UAA+B,EAC/B,IAAY,EACZ,gBAA6C,EAC7C,OAA2C;QAE3C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,oCAAoC,SAAS,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,QAAA,iBAAiB,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE;YAC3B,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,OAAsC;SAChD,CAAC,CAAC;QACH,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAA,iBAAiB,CAAC,CAAC;IAC7C,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;IAChC,CAAC;IAEM,kBAAkB;QACvB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,QAAA,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,CAAC;IAEM,WAAW;QAChB,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAA,iBAAiB,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAEM,KAAK;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,CAAC;IAEM,wBAAwB;QAC7B,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,CAAC;IAEM,KAAK,CAAC,UAAU,CACrB,OAA+B,EAC/B,MAAe;QAEf,MAAM,IAAI,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,8BAAkB,CAAC,qCAAqC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3F,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC;YACxC,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO;YACP,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3F,CAAC,CAAC;QACH,OAAO,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAEO,gBAAgB,CAAC,UAA+B;QACtD,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,IAAI,EAAE,CAAC;QACnD,YAAY,CAAC,QAAQ,GAAG,mBAAmB,CAAC;YAC1C,GAAG,CAAC,YAAY,CAAC,QAAQ,IAAI,EAAE,CAAC;YAChC,QAAA,uBAAuB;SACxB,CAAC,CAAC;QACH,UAAU,CAAC,YAAY,GAAG,YAAY,CAAC;IACzC,CAAC;CACF;;AAED,6BAAoC,MAAc;IAChD,OAAO,MAAM,KAAK,QAAA,iBAAiB,CAAC;AACtC,CAAC;AAED,+BAAsC,MAAe;IACnD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,8BAAkB,CAAC,qCAAqC,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,OAAO,GAAG,MAA0B,CAAC;IAC3C,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7F,MAAM,IAAI,8BAAkB,CAAC,wBAAwB,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,IAAI,GAAI,OAAO,CAAC,IAAkC,CAAC,IAAI,CAAC;IAC9D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,8BAAkB,CAAC,uBAAuB,CAAC,CAAC;IACxD,CAAC;IACD,IACE,OAAO,CAAC,qBAAqB,KAAK,SAAS;QAC3C,OAAO,OAAO,CAAC,qBAAqB,KAAK,QAAQ,EACjD,CAAC;QACD,MAAM,IAAI,8BAAkB,CAAC,wCAAwC,CAAC,CAAC;IACzE,CAAC;IACD,OAAO;QACL,IAAI,EAAE,IAAA,mBAAS,EAAC,OAAO,CAAC,IAAI,CAAC;QAC7B,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;QACjB,GAAG,CAAC,OAAO,CAAC,qBAAqB;YAC/B,CAAC,CAAC,EAAE,qBAAqB,EAAE,OAAO,CAAC,qBAAqB,CAAC,IAAI,EAAE,EAAE;YACjE,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED,oCAA2C,QAA2B;IACpE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,IAAI,8BAAkB,CAAC,yCAAyC,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,IAAI,8BAAkB,CAAC,+CAA+C,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC3C,MAAM,IAAI,8BAAkB,CAAC,kDAAkD,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,8BAAkB,CAAC,6CAA6C,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;QACxD,MAAM,IAAI,8BAAkB,CAAC,2DAA2D,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,QAAQ,CAAC,YAAY,KAAK,SAAS,IAAI,OAAO,QAAQ,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrF,MAAM,IAAI,8BAAkB,CAAC,qDAAqD,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,QAAQ,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QACjF,MAAM,IAAI,8BAAkB,CAAC,mDAAmD,CAAC,CAAC;IACpF,CAAC;IACD,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,SAAS,EAAE,QAAQ;QACnB,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAA,mBAAS,EAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAqC;IAChE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC/F,CAAC"}

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/connectivity-provider.js

@@ -0,0 +1,66 @@
+import { InvalidParamsError } from "./errors.js";
+import { registerProvideSurface } from "./extension-provide-surface.js";
+export const CONNECTIVITY_PROVIDER_CAPABILITY = "connectivity.provider";
+export const CONNECTIVITY_ESTABLISH_METHOD = "connectivity/establish";
+export const CONNECTIVITY_STATUS_METHOD = "connectivity/status";
+export const CONNECTIVITY_TEARDOWN_METHOD = "connectivity/teardown";
+function parseRequestRecord(method, request) {
+    if (typeof request !== "object" || request === null || Array.isArray(request)) {
+        throw new 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 InvalidParamsError(`${method} requires a non-empty ${field}`);
+    }
+    return value;
+}
+function parseEstablishRequest(request) {
+    const record = parseRequestRecord(CONNECTIVITY_ESTABLISH_METHOD, request);
+    return {
+        tier: requiredString(CONNECTIVITY_ESTABLISH_METHOD, record, "tier"),
+        forward_target: requiredString(CONNECTIVITY_ESTABLISH_METHOD, record, "forward_target"),
+        challenge_path: requiredString(CONNECTIVITY_ESTABLISH_METHOD, record, "challenge_path"),
+        deadline: requiredString(CONNECTIVITY_ESTABLISH_METHOD, record, "deadline"),
+    };
+}
+function parseStatusRequest(request) {
+    const record = parseRequestRecord(CONNECTIVITY_STATUS_METHOD, request);
+    return {
+        tier: requiredString(CONNECTIVITY_STATUS_METHOD, record, "tier"),
+    };
+}
+function parseTeardownRequest(request) {
+    const record = parseRequestRecord(CONNECTIVITY_TEARDOWN_METHOD, request);
+    return {
+        tier: requiredString(CONNECTIVITY_TEARDOWN_METHOD, record, "tier"),
+        deadline: requiredString(CONNECTIVITY_TEARDOWN_METHOD, record, "deadline"),
+    };
+}
+export 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[registerProvideSurface](CONNECTIVITY_PROVIDER_CAPABILITY, [
+        {
+            method: CONNECTIVITY_ESTABLISH_METHOD,
+            handler: async (context, request) => await handlers.establish(context, parseEstablishRequest(request)),
+        },
+        {
+            method: CONNECTIVITY_STATUS_METHOD,
+            handler: async (context, request) => await handlers.status(context, parseStatusRequest(request)),
+        },
+        {
+            method: CONNECTIVITY_TEARDOWN_METHOD,
+            handler: async (context, request) => await handlers.teardown(context, parseTeardownRequest(request)),
+        },
+    ]);
+}
+//# sourceMappingURL=connectivity-provider.js.map

package/dist/esm/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/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"}

package/dist/esm/extension-describe.js

@@ -0,0 +1,82 @@
+import { SDK_MIN_COMPOZY_VERSION, SDK_NAME, } from "./extension-contract.js";
+import { normalizeHostMethodList, normalizeStringList } from "./extension-runtime.js";
+export function defaultExtensionDescribeProcess() {
+    return {
+        argv: process.argv,
+        stdout: process.stdout,
+        setExitCode: code => {
+            process.exitCode = code;
+        },
+    };
+}
+export 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;
+}
+export 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) }),
+    }));
+}
+export 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: normalizeStringList(input.definition.capabilities?.provides),
+        permissions: normalizeHostMethodList(input.definition.permissions?.requires),
+        requires_env: normalizeStringList(input.definition.requires_env),
+        resources: {
+            skills: normalizeStringList(input.definition.resources?.skills),
+            loops: normalizeStringList(input.definition.resources?.loops),
+            agents: normalizeStringList(input.definition.resources?.agents),
+            automation: normalizeStringList(input.definition.resources?.automation),
+            layouts: 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: 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: normalizeStringList(input.definition.supported_hook_events),
+        watch_source_kinds: input.watchSourceKinds,
+        sdk: {
+            name: SDK_NAME,
+            version: input.sdkVersion,
+            protocol_version: "1",
+            min_compozy_version: SDK_MIN_COMPOZY_VERSION,
+        },
+    };
+}
+//# sourceMappingURL=extension-describe.js.map

package/dist/esm/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/esm/extension-initialize.js

@@ -0,0 +1,63 @@
+import { InvalidParamsError } from "./errors.js";
+import { SUPPORTED_PROTOCOL_VERSIONS } from "./extension-contract.js";
+export function parseInitializeRequest(params) {
+    if (typeof params !== "object" || params === null) {
+        throw new InvalidParamsError("initialize params must be an object");
+    }
+    const request = params;
+    if (!request.protocol_version) {
+        throw new InvalidParamsError("protocol_version is required");
+    }
+    if (typeof request.session_nonce !== "string" || request.session_nonce.trim() === "") {
+        throw new InvalidParamsError("session_nonce is required");
+    }
+    if (!Array.isArray(request.supported_protocol_versions) ||
+        request.supported_protocol_versions.length === 0) {
+        throw new InvalidParamsError("supported_protocol_versions is required");
+    }
+    if (!request.extension?.name || !request.extension?.version) {
+        throw new InvalidParamsError("extension identity is required");
+    }
+    if (!request.capabilities || typeof request.capabilities !== "object") {
+        throw new InvalidParamsError("capabilities are required");
+    }
+    if (!Array.isArray(request.capabilities.provides)) {
+        throw new InvalidParamsError("capabilities.provides must be an array");
+    }
+    if (!Array.isArray(request.capabilities.granted_permissions)) {
+        throw new InvalidParamsError("capabilities.granted_permissions must be an array");
+    }
+    if (!Array.isArray(request.capabilities.granted_resource_kinds)) {
+        throw new InvalidParamsError("capabilities.granted_resource_kinds must be an array");
+    }
+    if (!Array.isArray(request.capabilities.granted_resource_scopes)) {
+        throw new InvalidParamsError("capabilities.granted_resource_scopes must be an array");
+    }
+    if (!request.runtime) {
+        throw new 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 InvalidParamsError(`${field} must be greater than zero`);
+        }
+    }
+    return request;
+}
+export function validateProtocolVersion(request) {
+    if (!SUPPORTED_PROTOCOL_VERSIONS.includes(request.protocol_version)) {
+        throw new InvalidParamsError("unsupported protocol version", {
+            reason: "unsupported_protocol_version",
+            protocol_version: request.protocol_version,
+            supported_protocol_versions: SUPPORTED_PROTOCOL_VERSIONS,
+        });
+    }
+    if (!request.supported_protocol_versions.includes("1")) {
+        throw new InvalidParamsError("supported protocol versions must include 1");
+    }
+}
+//# sourceMappingURL=extension-initialize.js.map

package/dist/esm/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/esm/extension-provide-surface.js

@@ -0,0 +1,77 @@
+import { normalizeStringList } from "./extension-runtime.js";
+export const registerProvideSurface = Symbol("registerProvideSurface");
+export 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: 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);
+        }
+    }
+}
+//# sourceMappingURL=extension-provide-surface.js.map