@compozy/extension-sdk 0.3.0-beta.10

package/dist/cjs/extension-runtime.js

@@ -0,0 +1,227 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeStringList = normalizeStringList;
+exports.normalizeHostMethodList = normalizeHostMethodList;
+exports.implementedExtensionMethods = implementedExtensionMethods;
+exports.transportMethods = transportMethods;
+exports.ensureSubset = ensureSubset;
+exports.parseShutdownRequest = parseShutdownRequest;
+exports.parseToolCallRequest = parseToolCallRequest;
+exports.normalizeToolResult = normalizeToolResult;
+exports.toolExecutionError = toolExecutionError;
+exports.normalizeSchema = normalizeSchema;
+exports.canonicalExtensionToolID = canonicalExtensionToolID;
+const errors_js_1 = require("./errors.js");
+const json_js_1 = require("./json.js");
+const capabilities_js_1 = require("./capabilities.js");
+function normalizeStringList(values) {
+    return Array.from(new Set((values ?? []).map(value => value.trim()).filter(Boolean))).sort();
+}
+function normalizeHostMethodList(values) {
+    return normalizeStringList(values);
+}
+function implementedExtensionMethods(userMethods, hasTools, watchMethods) {
+    const methods = new Set(["health_check", "shutdown", ...userMethods, ...watchMethods]);
+    if (hasTools) {
+        methods.add(capabilities_js_1.PROVIDE_TOOLS_METHOD);
+        methods.add(capabilities_js_1.TOOLS_CALL_METHOD);
+    }
+    return [...methods].sort();
+}
+function transportMethods(userMethods, hasTools) {
+    const methods = new Set(["initialize", "health_check", "shutdown", ...userMethods]);
+    if (hasTools) {
+        methods.add(capabilities_js_1.PROVIDE_TOOLS_METHOD);
+        methods.add(capabilities_js_1.TOOLS_CALL_METHOD);
+    }
+    return [...methods];
+}
+function ensureSubset(label, requested, granted) {
+    const grantedSet = new Set(granted.map(value => value.trim()));
+    const missing = requested.filter(value => !grantedSet.has(value));
+    if (missing.length > 0) {
+        throw new errors_js_1.CapabilityDeniedError({
+            field: label,
+            required: missing,
+            granted: [...grantedSet],
+        });
+    }
+}
+function parseShutdownRequest(params) {
+    if (typeof params !== "object" || params === null) {
+        throw new errors_js_1.InvalidParamsError("shutdown params must be an object");
+    }
+    const request = params;
+    if (!Number.isFinite(request.deadline_ms) || request.deadline_ms <= 0) {
+        throw new errors_js_1.InvalidParamsError("deadline_ms must be greater than zero");
+    }
+    return {
+        reason: request.reason ?? "shutdown",
+        deadline_ms: request.deadline_ms,
+    };
+}
+function parseToolCallRequest(params) {
+    if (typeof params !== "object" || params === null) {
+        throw new errors_js_1.InvalidParamsError("tools/call params must be an object");
+    }
+    const request = params;
+    if (typeof request.tool_id !== "string" || request.tool_id.trim() === "") {
+        throw new errors_js_1.InvalidParamsError("tool_id is required");
+    }
+    if (typeof request.handler !== "string" || request.handler.trim() === "") {
+        throw new errors_js_1.InvalidParamsError("handler is required");
+    }
+    return {
+        tool_id: request.tool_id.trim(),
+        handler: request.handler.trim(),
+        ...(request.session_id ? { session_id: request.session_id } : {}),
+        ...(request.invocation_id !== undefined ? { invocation_id: request.invocation_id } : {}),
+        ...(request.trusted_workspace !== undefined
+            ? { trusted_workspace: request.trusted_workspace }
+            : {}),
+        input: (request.input ?? {}),
+    };
+}
+function normalizeToolResult(value) {
+    if (value === undefined) {
+        return emptyToolResult();
+    }
+    if (isToolResult(value)) {
+        return { ...emptyToolResult(), ...value };
+    }
+    if (typeof value === "string") {
+        return {
+            ...emptyToolResult(),
+            content: [{ type: "text", text: value }],
+            preview: value,
+        };
+    }
+    return {
+        ...emptyToolResult(),
+        structured: value,
+    };
+}
+function emptyToolResult() {
+    return {
+        truncated: false,
+        bytes: 0,
+        duration_ms: 0,
+    };
+}
+function isToolResult(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return false;
+    }
+    return [
+        "content",
+        "structured",
+        "preview",
+        "artifacts",
+        "metadata",
+        "redactions",
+        "truncated",
+        "bytes",
+        "duration_ms",
+    ].some(key => Object.prototype.hasOwnProperty.call(value, key));
+}
+function toolExecutionError(error, call, sensitiveInputFields) {
+    const errorMessage = redactSensitiveText(error instanceof Error ? error.message : String(error), call.input, sensitiveInputFields);
+    return new errors_js_1.ToolExecutionError({
+        tool_id: call.tool_id,
+        handler: call.handler,
+        error: errorMessage,
+        ...(sensitiveInputFields.length > 0
+            ? {
+                input: redactSensitiveInput(call.input, sensitiveInputFields),
+                sensitive_input_fields: sensitiveInputFields,
+            }
+            : {}),
+    });
+}
+function redactSensitiveInput(value, sensitiveInputFields) {
+    const cloned = (0, json_js_1.cloneJSON)(value);
+    for (const field of sensitiveInputFields) {
+        redactPath(cloned, field
+            .split(".")
+            .map(part => part.trim())
+            .filter(Boolean));
+    }
+    return cloned;
+}
+function redactPath(value, path) {
+    if (path.length === 0 || typeof value !== "object" || value === null || Array.isArray(value)) {
+        return;
+    }
+    const [head, ...rest] = path;
+    if (head === undefined) {
+        return;
+    }
+    if (!(head in value)) {
+        return;
+    }
+    if (rest.length === 0) {
+        value[head] = "[REDACTED]";
+        return;
+    }
+    redactPath(value[head], rest);
+}
+function redactSensitiveText(text, input, sensitiveInputFields) {
+    let redacted = text;
+    for (const field of sensitiveInputFields) {
+        const value = readPath(input, field
+            .split(".")
+            .map(part => part.trim())
+            .filter(Boolean));
+        if (typeof value === "string" && value !== "") {
+            redacted = redacted.replaceAll(value, "[REDACTED]");
+        }
+    }
+    return redacted;
+}
+function readPath(value, path) {
+    if (path.length === 0) {
+        return value;
+    }
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    const [head, ...rest] = path;
+    if (head === undefined) {
+        return undefined;
+    }
+    if (!(head in value)) {
+        return undefined;
+    }
+    return readPath(value[head], rest);
+}
+function normalizeSchema(value, field) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new Error(`${field} must be a JSON object`);
+    }
+    return (0, json_js_1.cloneJSON)(value);
+}
+function canonicalExtensionToolID(extensionName, handler) {
+    return `ext__${canonicalIDSegment(extensionName)}__${canonicalIDSegment(handler)}`;
+}
+function canonicalIDSegment(raw) {
+    const normalized = raw.trim().toLowerCase();
+    let output = "";
+    let lastUnderscore = false;
+    for (const char of normalized) {
+        if ((char >= "a" && char <= "z") || (char >= "0" && char <= "9")) {
+            output += char;
+            lastUnderscore = false;
+            continue;
+        }
+        if (output.length > 0 && !lastUnderscore) {
+            output += "_";
+            lastUnderscore = true;
+        }
+    }
+    const segment = output.replaceAll(/^_+|_+$/g, "");
+    if (!/^[a-z][a-z0-9_]*$/.test(segment) || segment.includes("__")) {
+        throw new Error(`invalid tool id segment: ${raw}`);
+    }
+    return segment;
+}
+//# sourceMappingURL=extension-runtime.js.map

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

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

package/dist/cjs/extension-session.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildExtensionSession = buildExtensionSession;
+const capabilities_js_1 = require("./capabilities.js");
+const extension_contract_js_1 = require("./extension-contract.js");
+const extension_initialize_js_1 = require("./extension-initialize.js");
+const extension_runtime_js_1 = require("./extension-runtime.js");
+function buildExtensionSession(options) {
+    const request = (0, extension_initialize_js_1.parseInitializeRequest)(options.params);
+    (0, extension_initialize_js_1.validateProtocolVersion)(request);
+    const requestedProvides = (0, extension_runtime_js_1.normalizeStringList)(options.definition.capabilities?.provides);
+    const requestedPermissions = (0, extension_runtime_js_1.normalizeHostMethodList)(options.definition.permissions?.requires);
+    (0, extension_runtime_js_1.ensureSubset)("provides", requestedProvides, request.capabilities.provides);
+    (0, extension_runtime_js_1.ensureSubset)("permissions", requestedPermissions, request.capabilities.granted_permissions);
+    (0, capabilities_js_1.validateProvidedMethodCoverage)(requestedProvides, options.implementedMethods);
+    const response = {
+        protocol_version: "1",
+        extension_info: {
+            name: options.definition.name,
+            version: options.definition.version,
+            sdk_name: extension_contract_js_1.SDK_NAME,
+            sdk_version: options.sdkVersion,
+        },
+        accepted_capabilities: {
+            provides: requestedProvides,
+            permissions: requestedPermissions,
+        },
+        implemented_methods: options.implementedMethods,
+        supported_hook_events: options.supportedHookEvents,
+        ...(options.watchSourceKinds.length > 0
+            ? { watch_source_kinds: options.watchSourceKinds }
+            : {}),
+        supports: {
+            health_check: true,
+        },
+    };
+    return {
+        response,
+        session: {
+            initializeRequest: request,
+            initializeResponse: response,
+            runtime: request.runtime,
+            acceptedCapabilities: response.accepted_capabilities,
+        },
+    };
+}
+//# sourceMappingURL=extension-session.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension-session.js","sourceRoot":"","sources":["../../src/extension-session.ts"],"names":[],"mappings":";;;AAAA,uDAAmE;AACnE,mEAA0E;AAC1E,uEAA4F;AAC5F,iEAAoG;AAYpG,+BAAsC,OAAqC;IAIzE,MAAM,OAAO,GAAG,IAAA,gDAAsB,EAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,IAAA,iDAAuB,EAAC,OAAO,CAAC,CAAC;IAEjC,MAAM,iBAAiB,GAAG,IAAA,0CAAmB,EAAC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IACzF,MAAM,oBAAoB,GAAG,IAAA,8CAAuB,EAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC/F,IAAA,mCAAY,EAAC,UAAU,EAAE,iBAAiB,EAAE,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3E,IAAA,mCAAY,EAAC,aAAa,EAAE,oBAAoB,EAAE,OAAO,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;IAC5F,IAAA,gDAA8B,EAAC,iBAAiB,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE9E,MAAM,QAAQ,GAAuB;QACnC,gBAAgB,EAAE,GAAG;QACrB,cAAc,EAAE;YACd,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,IAAI;YAC7B,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO;YACnC,QAAQ,EAAE,gCAAQ;YAClB,WAAW,EAAE,OAAO,CAAC,UAAU;SAChC;QACD,qBAAqB,EAAE;YACrB,QAAQ,EAAE,iBAAiB;YAC3B,WAAW,EAAE,oBAAoB;SAClC;QACD,mBAAmB,EAAE,OAAO,CAAC,kBAAkB;QAC/C,qBAAqB,EAAE,OAAO,CAAC,mBAAmB;QAClD,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC;YACrC,CAAC,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,gBAAgB,EAAE;YAClD,CAAC,CAAC,EAAE,CAAC;QACP,QAAQ,EAAE;YACR,YAAY,EAAE,IAAI;SACnB;KACF,CAAC;IAEF,OAAO;QACL,QAAQ;QACR,OAAO,EAAE;YACP,iBAAiB,EAAE,OAAO;YAC1B,kBAAkB,EAAE,QAAQ;YAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,oBAAoB,EAAE,QAAQ,CAAC,qBAAqB;SACrD;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeExtensionToolContext = makeExtensionToolContext;
+const errors_js_1 = require("./errors.js");
+function makeExtensionToolContext(call, context) {
+    const invocationId = call.invocation_id;
+    return {
+        input: call.input,
+        context,
+        host: context.host,
+        session: context.session,
+        toolID: call.tool_id,
+        handler: call.handler,
+        ...(call.trusted_workspace !== undefined ? { trustedWorkspace: call.trusted_workspace } : {}),
+        ...(invocationId !== undefined ? { invocationId } : {}),
+        askClarification: async (question) => {
+            if (invocationId === undefined || invocationId.trim() === "") {
+                throw new errors_js_1.InvalidParamsError("tool invocation context is required");
+            }
+            const params = {
+                invocation_id: invocationId,
+                question: question.question,
+                ...(question.choices === undefined ? {} : { choices: [...question.choices] }),
+            };
+            return await context.host.request("clarify/ask", params);
+        },
+    };
+}
+//# sourceMappingURL=extension-tool-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension-tool-context.js","sourceRoot":"","sources":["../../src/extension-tool-context.ts"],"names":[],"mappings":";;;AAAA,2CAAiD;AAIjD,kCACE,IAA8B,EAC9B,OAAwC;IAExC,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC;IACxC,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAe;QAC3B,OAAO;QACP,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,IAAI,CAAC,OAAO;QACpB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,GAAG,CAAC,IAAI,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7F,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,gBAAgB,EAAE,KAAK,EAAC,QAAQ,EAAC,EAAE;YACjC,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBAC7D,MAAM,IAAI,8BAAkB,CAAC,qCAAqC,CAAC,CAAC;YACtE,CAAC;YACD,MAAM,MAAM,GAAqB;gBAC/B,aAAa,EAAE,YAAY;gBAC3B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,GAAG,CAAC,QAAQ,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;aAC9E,CAAC;YACF,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cjs/extension-tool-registration.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildRegisteredTool = buildRegisteredTool;
+const extension_runtime_js_1 = require("./extension-runtime.js");
+const schema_digest_js_1 = require("./schema-digest.js");
+function buildRegisteredTool(extensionName, handler, options, toolHandler) {
+    const inputSchema = (0, extension_runtime_js_1.normalizeSchema)(options.inputSchema, "inputSchema");
+    const outputSchema = options.outputSchema === undefined
+        ? undefined
+        : (0, extension_runtime_js_1.normalizeSchema)(options.outputSchema, "outputSchema");
+    const descriptor = {
+        id: options.id ?? (0, extension_runtime_js_1.canonicalExtensionToolID)(extensionName, handler),
+        handler,
+        ...(options.description?.trim() ? { description: options.description.trim() } : {}),
+        ...(options.friendlyVerb?.trim() ? { friendly_verb: options.friendlyVerb.trim() } : {}),
+        ...(options.preview?.trim() ? { preview: options.preview.trim() } : {}),
+        input_schema: inputSchema,
+        ...(outputSchema ? { output_schema: outputSchema } : {}),
+        input_schema_digest: (0, schema_digest_js_1.schemaDigest)(inputSchema),
+        ...(outputSchema ? { output_schema_digest: (0, schema_digest_js_1.schemaDigest)(outputSchema) } : {}),
+        read_only: Boolean(options.readOnly),
+        risk: options.risk ?? (options.readOnly ? "read" : "mutating"),
+        requires_interaction: Boolean(options.requiresInteraction),
+        capabilities: (0, extension_runtime_js_1.normalizeStringList)(options.capabilities),
+        ...(options.command
+            ? {
+                command: {
+                    verb: options.command.verb.trim(),
+                    summary: options.command.summary.trim(),
+                    ...(options.command.example?.trim() ? { example: options.command.example.trim() } : {}),
+                    flags: { ...options.command.flags },
+                },
+            }
+            : {}),
+    };
+    return {
+        descriptor,
+        handler: toolHandler,
+        sensitiveInputFields: (0, extension_runtime_js_1.normalizeStringList)(options.sensitiveInputFields),
+    };
+}
+//# sourceMappingURL=extension-tool-registration.js.map

package/dist/cjs/extension-tool-registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-tool-registration.js","sourceRoot":"","sources":["../../src/extension-tool-registration.ts"],"names":[],"mappings":";;;AAKA,iEAIgC;AAChC,yDAAkD;AAGlD,6BACE,aAAqB,EACrB,OAAe,EACf,OAA6B,EAC7B,WAAyC;IAEzC,MAAM,WAAW,GAAG,IAAA,sCAAe,EAAC,OAAO,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACxE,MAAM,YAAY,GAChB,OAAO,CAAC,YAAY,KAAK,SAAS;QAChC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,IAAA,sCAAe,EAAC,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAmC;QACjD,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,IAAA,+CAAwB,EAAC,aAAa,EAAE,OAAO,CAAC;QAClE,OAAO;QACP,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,YAAY,EAAE,WAAW;QACzB,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,mBAAmB,EAAE,IAAA,+BAAY,EAAC,WAAW,CAAC;QAC9C,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,IAAA,+BAAY,EAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;QACpC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;QAC9D,oBAAoB,EAAE,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC;QAC1D,YAAY,EAAE,IAAA,0CAAmB,EAAC,OAAO,CAAC,YAAY,CAAC;QACvD,GAAG,CAAC,OAAO,CAAC,OAAO;YACjB,CAAC,CAAC;gBACE,OAAO,EAAE;oBACP,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE;oBACjC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE;oBACvC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvF,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE;iBACpC;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IAEF,OAAO;QACL,UAAU;QACV,OAAO,EAAE,WAAmC;QAC5C,oBAAoB,EAAE,IAAA,0CAAmB,EAAC,OAAO,CAAC,oBAAoB,CAAC;KACxE,CAAC;AACJ,CAAC"}