@compozy/extension-sdk 0.3.0-beta.10

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

package/dist/esm/extension-runtime.js

@@ -0,0 +1,214 @@
+import { CapabilityDeniedError, InvalidParamsError, ToolExecutionError } from "./errors.js";
+import { cloneJSON } from "./json.js";
+import { PROVIDE_TOOLS_METHOD, TOOLS_CALL_METHOD } from "./capabilities.js";
+export function normalizeStringList(values) {
+    return Array.from(new Set((values ?? []).map(value => value.trim()).filter(Boolean))).sort();
+}
+export function normalizeHostMethodList(values) {
+    return normalizeStringList(values);
+}
+export function implementedExtensionMethods(userMethods, hasTools, watchMethods) {
+    const methods = new Set(["health_check", "shutdown", ...userMethods, ...watchMethods]);
+    if (hasTools) {
+        methods.add(PROVIDE_TOOLS_METHOD);
+        methods.add(TOOLS_CALL_METHOD);
+    }
+    return [...methods].sort();
+}
+export function transportMethods(userMethods, hasTools) {
+    const methods = new Set(["initialize", "health_check", "shutdown", ...userMethods]);
+    if (hasTools) {
+        methods.add(PROVIDE_TOOLS_METHOD);
+        methods.add(TOOLS_CALL_METHOD);
+    }
+    return [...methods];
+}
+export 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 CapabilityDeniedError({
+            field: label,
+            required: missing,
+            granted: [...grantedSet],
+        });
+    }
+}
+export function parseShutdownRequest(params) {
+    if (typeof params !== "object" || params === null) {
+        throw new InvalidParamsError("shutdown params must be an object");
+    }
+    const request = params;
+    if (!Number.isFinite(request.deadline_ms) || request.deadline_ms <= 0) {
+        throw new InvalidParamsError("deadline_ms must be greater than zero");
+    }
+    return {
+        reason: request.reason ?? "shutdown",
+        deadline_ms: request.deadline_ms,
+    };
+}
+export function parseToolCallRequest(params) {
+    if (typeof params !== "object" || params === null) {
+        throw new InvalidParamsError("tools/call params must be an object");
+    }
+    const request = params;
+    if (typeof request.tool_id !== "string" || request.tool_id.trim() === "") {
+        throw new InvalidParamsError("tool_id is required");
+    }
+    if (typeof request.handler !== "string" || request.handler.trim() === "") {
+        throw new 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 ?? {}),
+    };
+}
+export 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));
+}
+export function toolExecutionError(error, call, sensitiveInputFields) {
+    const errorMessage = redactSensitiveText(error instanceof Error ? error.message : String(error), call.input, sensitiveInputFields);
+    return new 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 = 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);
+}
+export function normalizeSchema(value, field) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new Error(`${field} must be a JSON object`);
+    }
+    return cloneJSON(value);
+}
+export 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/esm/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/esm/extension-session.js

@@ -0,0 +1,44 @@
+import { validateProvidedMethodCoverage } from "./capabilities.js";
+import { SDK_NAME } from "./extension-contract.js";
+import { parseInitializeRequest, validateProtocolVersion } from "./extension-initialize.js";
+import { ensureSubset, normalizeHostMethodList, normalizeStringList } from "./extension-runtime.js";
+export function buildExtensionSession(options) {
+    const request = parseInitializeRequest(options.params);
+    validateProtocolVersion(request);
+    const requestedProvides = normalizeStringList(options.definition.capabilities?.provides);
+    const requestedPermissions = normalizeHostMethodList(options.definition.permissions?.requires);
+    ensureSubset("provides", requestedProvides, request.capabilities.provides);
+    ensureSubset("permissions", requestedPermissions, request.capabilities.granted_permissions);
+    validateProvidedMethodCoverage(requestedProvides, options.implementedMethods);
+    const response = {
+        protocol_version: "1",
+        extension_info: {
+            name: options.definition.name,
+            version: options.definition.version,
+            sdk_name: 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/esm/extension-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-session.js","sourceRoot":"","sources":["../../src/extension-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAyB,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAYpG,MAAM,UAAU,qBAAqB,CAAC,OAAqC;IAIzE,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAEjC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IACzF,MAAM,oBAAoB,GAAG,uBAAuB,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC/F,YAAY,CAAC,UAAU,EAAE,iBAAiB,EAAE,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3E,YAAY,CAAC,aAAa,EAAE,oBAAoB,EAAE,OAAO,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;IAC5F,8BAA8B,CAAC,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,QAAQ;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/esm/extension-tool-context.js

@@ -0,0 +1,26 @@
+import { InvalidParamsError } from "./errors.js";
+export 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 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/esm/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,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAIjD,MAAM,UAAU,wBAAwB,CACtC,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,kBAAkB,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/esm/extension-tool-registration.js

@@ -0,0 +1,39 @@
+import { canonicalExtensionToolID, normalizeSchema, normalizeStringList, } from "./extension-runtime.js";
+import { schemaDigest } from "./schema-digest.js";
+export function buildRegisteredTool(extensionName, handler, options, toolHandler) {
+    const inputSchema = normalizeSchema(options.inputSchema, "inputSchema");
+    const outputSchema = options.outputSchema === undefined
+        ? undefined
+        : normalizeSchema(options.outputSchema, "outputSchema");
+    const descriptor = {
+        id: options.id ?? 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: schemaDigest(inputSchema),
+        ...(outputSchema ? { output_schema_digest: schemaDigest(outputSchema) } : {}),
+        read_only: Boolean(options.readOnly),
+        risk: options.risk ?? (options.readOnly ? "read" : "mutating"),
+        requires_interaction: Boolean(options.requiresInteraction),
+        capabilities: 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: normalizeStringList(options.sensitiveInputFields),
+    };
+}
+//# sourceMappingURL=extension-tool-registration.js.map

package/dist/esm/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,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,MAAM,UAAU,mBAAmB,CACjC,aAAqB,EACrB,OAAe,EACf,OAA6B,EAC7B,WAAyC;IAEzC,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACxE,MAAM,YAAY,GAChB,OAAO,CAAC,YAAY,KAAK,SAAS;QAChC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAmC;QACjD,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,wBAAwB,CAAC,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,YAAY,CAAC,WAAW,CAAC;QAC9C,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,YAAY,CAAC,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,mBAAmB,CAAC,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,mBAAmB,CAAC,OAAO,CAAC,oBAAoB,CAAC;KACxE,CAAC;AACJ,CAAC"}