@compozy/extension-sdk 0.3.0-beta.10

package/dist/esm/watch-source.js

@@ -0,0 +1,133 @@
+import { InvalidParamsError } from "./errors.js";
+import { cloneJSON } from "./json.js";
+export const WATCH_SOURCE_CAPABILITY = "loop.watch_source";
+export const WATCH_POLL_METHOD = "watch/poll";
+export 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(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(WATCH_POLL_METHOD);
+    }
+    hasHandlers() {
+        return this.handlers.size > 0;
+    }
+    implementedMethods() {
+        return this.hasHandlers() ? [WATCH_POLL_METHOD] : [];
+    }
+    bindMethods() {
+        if (this.hasHandlers()) {
+            this.options.bindMethod(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 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 ?? []),
+            WATCH_SOURCE_CAPABILITY,
+        ]);
+        definition.capabilities = capabilities;
+    }
+}
+export function isWatchSourceMethod(method) {
+    return method === WATCH_POLL_METHOD;
+}
+export function parseWatchPollRequest(params) {
+    if (typeof params !== "object" || params === null) {
+        throw new 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 InvalidParamsError("spec must be an object");
+    }
+    const kind = request.spec.kind;
+    if (typeof kind !== "string" || kind.trim() === "") {
+        throw new InvalidParamsError("spec.kind is required");
+    }
+    if (request.expected_state_digest !== undefined &&
+        typeof request.expected_state_digest !== "string") {
+        throw new InvalidParamsError("expected_state_digest must be a string");
+    }
+    return {
+        spec: cloneJSON(request.spec),
+        kind: kind.trim(),
+        ...(request.expected_state_digest
+            ? { expected_state_digest: request.expected_state_digest.trim() }
+            : {}),
+    };
+}
+export function normalizeWatchPollResponse(response) {
+    if (typeof response !== "object" || response === null) {
+        throw new InvalidParamsError("watch source response must be an object");
+    }
+    if (typeof response.ready !== "boolean") {
+        throw new InvalidParamsError("watch source response.ready must be a boolean");
+    }
+    if (typeof response.event_key !== "string") {
+        throw new InvalidParamsError("watch source response.event_key must be a string");
+    }
+    const eventKey = response.event_key.trim().normalize("NFC");
+    if (!eventKey) {
+        throw new InvalidParamsError("watch source response.event_key is required");
+    }
+    if (new TextEncoder().encode(eventKey).byteLength > 256) {
+        throw new InvalidParamsError("watch source response.event_key must be at most 256 bytes");
+    }
+    if (response.state_digest !== undefined && typeof response.state_digest !== "string") {
+        throw new InvalidParamsError("watch source response.state_digest must be a string");
+    }
+    if (response.settled_at !== undefined && typeof response.settled_at !== "string") {
+        throw new 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: 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/esm/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/types/base-types.d.ts

@@ -0,0 +1,25 @@
+export type JSONPrimitive = string | number | boolean | null;
+export type JSONValue = JSONPrimitive | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+export type ISODateTime = string;
+export type ProtocolVersion = "1";
+export type JSONRPCID = string | number;
+export interface JSONRPCRequestEnvelope<Params = unknown> {
+    jsonrpc: "2.0";
+    id?: JSONRPCID;
+    method: string;
+    params?: Params;
+}
+export interface JSONRPCResponseEnvelope<Result = unknown, Data = unknown> {
+    jsonrpc: "2.0";
+    id: JSONRPCID;
+    result?: Result;
+    error?: JSONRPCErrorObject<Data>;
+}
+export interface JSONRPCErrorObject<Data = unknown> {
+    code: number;
+    message: string;
+    data?: Data;
+}
+//# sourceMappingURL=base-types.d.ts.map

package/dist/types/base-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-types.d.ts","sourceRoot":"","sources":["../../src/base-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACnF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AACjC,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC;AAClC,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAExC,MAAM,WAAW,sBAAsB,CAAC,MAAM,GAAG,OAAO;IACtD,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB,CAAC,MAAM,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO;IACvE,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB,CAAC,IAAI,GAAG,OAAO;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,IAAI,CAAC;CACb"}

package/dist/types/capabilities.d.ts

@@ -0,0 +1,6 @@
+export declare const TOOL_PROVIDER_CAPABILITY = "tool.provider";
+export declare const PROVIDE_TOOLS_METHOD = "provide_tools";
+export declare const TOOLS_CALL_METHOD = "tools/call";
+export declare function isToolProviderMethod(method: string): boolean;
+export declare function validateProvidedMethodCoverage(provides: readonly string[], implementedMethods: readonly string[]): void;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/types/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/capabilities.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AACxD,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AACpD,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAE9C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,kBAAkB,EAAE,SAAS,MAAM,EAAE,GACpC,IAAI,CAcN"}

package/dist/types/connectivity-provider.d.ts

@@ -0,0 +1,14 @@
+import type { Extension } from "./extension.js";
+import type { ExtensionContext } from "./extension-contract.js";
+import type { ConnectivityEstablishRequest, ConnectivityReachability, ConnectivityStatusRequest, ConnectivityTeardownRequest, ConnectivityTeardownResponse } from "./types.js";
+export declare const CONNECTIVITY_PROVIDER_CAPABILITY = "connectivity.provider";
+export declare const CONNECTIVITY_ESTABLISH_METHOD = "connectivity/establish";
+export declare const CONNECTIVITY_STATUS_METHOD = "connectivity/status";
+export declare const CONNECTIVITY_TEARDOWN_METHOD = "connectivity/teardown";
+export interface ConnectivityProviderHandlers {
+    establish: (context: ExtensionContext, request: ConnectivityEstablishRequest) => Promise<ConnectivityReachability> | ConnectivityReachability;
+    status: (context: ExtensionContext, request: ConnectivityStatusRequest) => Promise<ConnectivityReachability> | ConnectivityReachability;
+    teardown: (context: ExtensionContext, request: ConnectivityTeardownRequest) => Promise<ConnectivityTeardownResponse> | ConnectivityTeardownResponse;
+}
+export declare function registerConnectivityProvider(extension: Extension, handlers: ConnectivityProviderHandlers): Extension;
+//# sourceMappingURL=connectivity-provider.d.ts.map

package/dist/types/connectivity-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectivity-provider.d.ts","sourceRoot":"","sources":["../../src/connectivity-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,KAAK,EACV,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,gCAAgC,0BAA0B,CAAC;AACxE,eAAO,MAAM,6BAA6B,2BAA2B,CAAC;AACtE,eAAO,MAAM,0BAA0B,wBAAwB,CAAC;AAChE,eAAO,MAAM,4BAA4B,0BAA0B,CAAC;AAEpE,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,CACT,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,4BAA4B,KAClC,OAAO,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAAC;IAClE,MAAM,EAAE,CACN,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAAC;IAClE,QAAQ,EAAE,CACR,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,2BAA2B,KACjC,OAAO,CAAC,4BAA4B,CAAC,GAAG,4BAA4B,CAAC;CAC3E;AA0CD,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,4BAA4B,GACrC,SAAS,CA4BX"}

package/dist/types/errors.d.ts

@@ -0,0 +1,66 @@
+import type { JSONRPCErrorObject, JSONValue } from "./types.js";
+export interface CapabilityDeniedData {
+    method?: string;
+    required?: string[];
+    granted?: string[];
+    field?: string;
+}
+export interface RateLimitedData {
+    scope?: string;
+    retry_after_ms?: number;
+    limit?: number;
+    burst?: number;
+}
+export interface AllowedMethodsData {
+    allowed_methods?: string[];
+}
+export interface ShutdownProgressData {
+    deadline_ms?: number;
+}
+export interface ToolExecutionData {
+    tool_id?: string;
+    handler?: string;
+    error?: string;
+    input?: JSONValue;
+    sensitive_input_fields?: string[];
+}
+export declare class RPCError<Data = unknown> extends Error {
+    readonly code: number;
+    readonly data: Data | undefined;
+    constructor(code: number, message: string, data?: Data);
+    toJSONRPC(): JSONRPCErrorObject<Data>;
+}
+export declare class ParseError extends RPCError<Record<string, JSONValue>> {
+    constructor(error: string);
+}
+export declare class InvalidRequestError extends RPCError<Record<string, JSONValue>> {
+    constructor(reason: string);
+}
+export declare class MethodNotFoundError extends RPCError<Record<string, string>> {
+    constructor(method: string);
+}
+export declare class InvalidParamsError extends RPCError<Record<string, JSONValue>> {
+    constructor(error: string, data?: Record<string, JSONValue>);
+}
+export declare class InternalError extends RPCError<Record<string, JSONValue>> {
+    constructor(error: string);
+}
+export declare class CapabilityDeniedError extends RPCError<CapabilityDeniedData> {
+    constructor(data: CapabilityDeniedData);
+}
+export declare class RateLimitedError extends RPCError<RateLimitedData> {
+    constructor(data: RateLimitedData);
+}
+export declare class NotInitializedError extends RPCError<AllowedMethodsData> {
+    constructor(data?: AllowedMethodsData);
+}
+export declare class ShutdownInProgressError extends RPCError<ShutdownProgressData> {
+    constructor(data?: ShutdownProgressData);
+}
+export declare class ToolExecutionError extends RPCError<ToolExecutionData> {
+    constructor(data?: ToolExecutionData);
+}
+export declare function isRPCError(error: unknown): error is RPCError;
+export declare function errorFromObject(error: JSONRPCErrorObject): RPCError;
+export declare function ensureRPCError(error: unknown): RPCError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

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

package/dist/types/extension-context.d.ts

@@ -0,0 +1,6 @@
+import type { HostAPI } from "./host-api.js";
+import type { ExtensionContext, ExtensionSession } from "./extension-contract.js";
+import type { JSONRPCRequestEnvelope } from "./types.js";
+export declare function makeExtensionContext(request: JSONRPCRequestEnvelope, host: HostAPI, session: ExtensionSession | undefined, stderr: NodeJS.WritableStream): ExtensionContext;
+export declare function writeExtensionError(stderr: NodeJS.WritableStream, message: string, error: unknown): void;
+//# sourceMappingURL=extension-context.d.ts.map

package/dist/types/extension-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-context.d.ts","sourceRoot":"","sources":["../../src/extension-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,MAAM,EAAE,MAAM,CAAC,cAAc,GAC5B,gBAAgB,CAgBlB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,cAAc,EAC7B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,IAAI,CAGN"}

package/dist/types/extension-contract.d.ts

@@ -0,0 +1,65 @@
+import type { TransportLike } from "./transport.js";
+import type { AcceptedCapabilities, ClarifyAnswer, ClarifyAskParams, ExtensionCommandSpec, ExtensionToolRuntimeDescriptor, ExtensionToolWorkspaceScope, InitializeRequest, InitializeResponse, InitializeRuntime, JSONRPCRequestEnvelope, JSONValue, RiskClass, ToolID, ToolResult } from "./types.js";
+import { HostAPI } from "./host-api.js";
+export declare const SDK_NAME = "@compozy/extension-sdk";
+export declare const SDK_VERSION = "0.1.0";
+export declare const SDK_MIN_COMPOZY_VERSION = "0.3.0-beta.1";
+export declare const SUPPORTED_PROTOCOL_VERSIONS: string[];
+export interface ExtensionDescribeProcess {
+    argv: readonly string[];
+    stdout: Pick<NodeJS.WritableStream, "write">;
+    setExitCode: (code: number) => void;
+}
+export interface ExtensionOptions {
+    transport?: TransportLike;
+    stderr?: NodeJS.WritableStream;
+    sdkVersion?: string;
+    describeProcess?: ExtensionDescribeProcess;
+}
+export interface ExtensionSession {
+    initializeRequest: InitializeRequest;
+    initializeResponse: InitializeResponse;
+    runtime: InitializeRuntime;
+    acceptedCapabilities: AcceptedCapabilities;
+}
+export interface ExtensionContext {
+    readonly request: JSONRPCRequestEnvelope;
+    readonly requestId: string | number;
+    readonly host: HostAPI;
+    readonly session: ExtensionSession;
+    log: (...values: unknown[]) => void;
+}
+export type ExtensionHandler<TParams = unknown, TResult = unknown> = (context: ExtensionContext, params: TParams) => Promise<TResult> | TResult;
+export interface ExtensionToolOptions {
+    id?: ToolID;
+    description?: string;
+    friendlyVerb?: string;
+    preview?: string;
+    inputSchema: JSONValue;
+    outputSchema?: JSONValue;
+    readOnly?: boolean;
+    risk?: RiskClass;
+    requiresInteraction?: boolean;
+    capabilities?: string[];
+    sensitiveInputFields?: string[];
+    command?: ExtensionCommandSpec;
+}
+export interface ExtensionToolContext<TInput = unknown> {
+    readonly input: TInput;
+    readonly context: ExtensionContext;
+    readonly host: HostAPI;
+    readonly session: ExtensionSession;
+    readonly toolID: ToolID;
+    readonly handler: string;
+    readonly trustedWorkspace?: ExtensionToolWorkspaceScope;
+    readonly invocationId?: string;
+    askClarification: (question: Omit<ClarifyAskParams, "invocation_id">) => Promise<ClarifyAnswer>;
+}
+export type ExtensionToolHandler<TInput = unknown> = (request: ExtensionToolContext<TInput>) => Promise<ToolResult | JSONValue | string | void> | ToolResult | JSONValue | string | void;
+export type ReadyCallback = (host: HostAPI, session: ExtensionSession) => Promise<void> | void;
+export interface RegisteredTool {
+    descriptor: ExtensionToolRuntimeDescriptor;
+    handler: ExtensionToolHandler;
+    sensitiveInputFields: string[];
+}
+//# sourceMappingURL=extension-contract.d.ts.map

package/dist/types/extension-contract.d.ts.map

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

package/dist/types/extension-describe.d.ts

@@ -0,0 +1,16 @@
+import { type ExtensionDescribeProcess } from "./extension-contract.js";
+import type { DescribePayload, ExtensionDefinition, ExtensionCommandGroupSpec, ExtensionToolRuntimeDescriptor } from "./types.js";
+import type { RegisteredTool } from "./extension-contract.js";
+interface ExtensionDescribeInput {
+    definition: ExtensionDefinition;
+    tools: ExtensionToolRuntimeDescriptor[];
+    commandGroups: ExtensionCommandGroupSpec[];
+    watchSourceKinds: string[];
+    sdkVersion: string;
+}
+export declare function defaultExtensionDescribeProcess(): ExtensionDescribeProcess;
+export declare function runExtensionDescribeMode(describeProcess: ExtensionDescribeProcess, describe: () => DescribePayload): boolean;
+export declare function cloneExtensionToolDescriptors(tools: Iterable<RegisteredTool>): ExtensionToolRuntimeDescriptor[];
+export declare function buildExtensionDescribePayload(input: ExtensionDescribeInput): DescribePayload;
+export {};
+//# sourceMappingURL=extension-describe.d.ts.map

package/dist/types/extension-describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-describe.d.ts","sourceRoot":"","sources":["../../src/extension-describe.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,8BAA8B,EAC/B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,UAAU,sBAAsB;IAC9B,UAAU,EAAE,mBAAmB,CAAC;IAChC,KAAK,EAAE,8BAA8B,EAAE,CAAC;IACxC,aAAa,EAAE,yBAAyB,EAAE,CAAC;IAC3C,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,+BAA+B,IAAI,wBAAwB,CAQ1E;AAED,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,wBAAwB,EACzC,QAAQ,EAAE,MAAM,eAAe,GAC9B,OAAO,CAOT;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,GAC9B,8BAA8B,EAAE,CAclC;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,sBAAsB,GAAG,eAAe,CAiD5F"}

package/dist/types/extension-initialize.d.ts

@@ -0,0 +1,4 @@
+import type { InitializeRequest } from "./types.js";
+export declare function parseInitializeRequest(params: unknown): InitializeRequest;
+export declare function validateProtocolVersion(request: InitializeRequest): void;
+//# sourceMappingURL=extension-initialize.d.ts.map

package/dist/types/extension-initialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-initialize.d.ts","sourceRoot":"","sources":["../../src/extension-initialize.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,CAkDzE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAWxE"}

package/dist/types/extension-provide-surface.d.ts

@@ -0,0 +1,23 @@
+import type { ExtensionDefinition } from "./types.js";
+import type { ExtensionHandler } from "./extension-contract.js";
+export declare const registerProvideSurface: unique symbol;
+export interface ProvideSurfaceRegistration {
+    method: string;
+    handler: ExtensionHandler;
+}
+interface ExtensionProvideSurfacesOptions {
+    handlers: Map<string, ExtensionHandler>;
+    validateMethod: (method: string) => void;
+    bindMethod: (method: string) => void;
+    unbindMethod: (method: string) => void;
+}
+export declare class ExtensionProvideSurfaces {
+    private readonly options;
+    private readonly owners;
+    constructor(options: ExtensionProvideSurfacesOptions);
+    owner(method: string): string | undefined;
+    register(definition: ExtensionDefinition, capability: string, registrations: readonly ProvideSurfaceRegistration[]): void;
+    private validateRegistrations;
+}
+export {};
+//# sourceMappingURL=extension-provide-surface.d.ts.map

package/dist/types/extension-provide-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-provide-surface.d.ts","sourceRoot":"","sources":["../../src/extension-provide-surface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,eAAO,MAAM,sBAAsB,eAAmC,CAAC;AAEvE,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,UAAU,+BAA+B;IACvC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACxC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,qBAAa,wBAAwB;IAGhB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAF3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IAEpD,YAAoC,OAAO,EAAE,+BAA+B,EAAI;IAEzE,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/C;IAEM,QAAQ,CACb,UAAU,EAAE,mBAAmB,EAC/B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,SAAS,0BAA0B,EAAE,GACnD,IAAI,CA0CN;IAED,OAAO,CAAC,qBAAqB;CAyB9B"}

package/dist/types/extension-runtime.d.ts

@@ -0,0 +1,14 @@
+import type { HostAPIMethod, ExtensionToolCallRequest, JSONValue, ShutdownRequest, ToolID, ToolResult } from "./types.js";
+import { ToolExecutionError } from "./errors.js";
+export declare function normalizeStringList(values: readonly string[] | undefined): string[];
+export declare function normalizeHostMethodList(values: readonly HostAPIMethod[] | undefined): HostAPIMethod[];
+export declare function implementedExtensionMethods(userMethods: Iterable<string>, hasTools: boolean, watchMethods: readonly string[]): string[];
+export declare function transportMethods(userMethods: Iterable<string>, hasTools: boolean): string[];
+export declare function ensureSubset(label: string, requested: string[], granted: readonly string[]): void;
+export declare function parseShutdownRequest(params: unknown): ShutdownRequest;
+export declare function parseToolCallRequest(params: unknown): ExtensionToolCallRequest;
+export declare function normalizeToolResult(value: ToolResult | JSONValue | string | void): ToolResult;
+export declare function toolExecutionError(error: unknown, call: ExtensionToolCallRequest, sensitiveInputFields: string[]): ToolExecutionError;
+export declare function normalizeSchema(value: JSONValue, field: string): JSONValue;
+export declare function canonicalExtensionToolID(extensionName: string, handler: string): ToolID;
+//# sourceMappingURL=extension-runtime.d.ts.map

package/dist/types/extension-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-runtime.d.ts","sourceRoot":"","sources":["../../src/extension-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,wBAAwB,EACxB,SAAS,EACT,eAAe,EACf,MAAM,EACN,UAAU,EACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAA6C,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAI5F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAEnF;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,GAC3C,aAAa,EAAE,CAEjB;AAED,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC7B,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,SAAS,MAAM,EAAE,GAC9B,MAAM,EAAE,CAOV;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,EAAE,CAO3F;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAUjG;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,eAAe,CAYrE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,wBAAwB,CAqB9E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,UAAU,CAkB7F;AA2BD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,wBAAwB,EAC9B,oBAAoB,EAAE,MAAM,EAAE,GAC7B,kBAAkB,CAiBpB;AAwED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAK1E;AAED,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvF"}

package/dist/types/extension-session.d.ts

@@ -0,0 +1,16 @@
+import { type ExtensionSession } from "./extension-contract.js";
+import type { ExtensionDefinition, HookEvent, InitializeResponse } from "./types.js";
+interface BuildExtensionSessionOptions {
+    definition: ExtensionDefinition;
+    params: unknown;
+    implementedMethods: string[];
+    supportedHookEvents: HookEvent[];
+    watchSourceKinds: string[];
+    sdkVersion: string;
+}
+export declare function buildExtensionSession(options: BuildExtensionSessionOptions): {
+    response: InitializeResponse;
+    session: ExtensionSession;
+};
+export {};
+//# sourceMappingURL=extension-session.d.ts.map

package/dist/types/extension-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-session.d.ts","sourceRoot":"","sources":["../../src/extension-session.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErF,UAAU,4BAA4B;IACpC,UAAU,EAAE,mBAAmB,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,mBAAmB,EAAE,SAAS,EAAE,CAAC;IACjC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG;IAC5E,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,gBAAgB,CAAC;CAC3B,CAyCA"}

package/dist/types/extension-tool-context.d.ts

@@ -0,0 +1,4 @@
+import type { ExtensionToolContext } from "./extension-contract.js";
+import type { ExtensionToolCallRequest, JSONValue } from "./types.js";
+export declare function makeExtensionToolContext<TInput = JSONValue>(call: ExtensionToolCallRequest, context: ExtensionToolContext["context"]): ExtensionToolContext<TInput>;
+//# sourceMappingURL=extension-tool-context.d.ts.map

package/dist/types/extension-tool-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-tool-context.d.ts","sourceRoot":"","sources":["../../src/extension-tool-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,KAAK,EAAoB,wBAAwB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExF,wBAAgB,wBAAwB,CAAC,MAAM,GAAG,SAAS,EACzD,IAAI,EAAE,wBAAwB,EAC9B,OAAO,EAAE,oBAAoB,CAAC,SAAS,CAAC,GACvC,oBAAoB,CAAC,MAAM,CAAC,CAuB9B"}

package/dist/types/extension-tool-registration.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionToolHandler, ExtensionToolOptions, RegisteredTool } from "./extension-contract.js";
+export declare function buildRegisteredTool<TInput>(extensionName: string, handler: string, options: ExtensionToolOptions, toolHandler: ExtensionToolHandler<TInput>): RegisteredTool;
+//# sourceMappingURL=extension-tool-registration.d.ts.map

package/dist/types/extension-tool-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-tool-registration.d.ts","sourceRoot":"","sources":["../../src/extension-tool-registration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACf,MAAM,yBAAyB,CAAC;AASjC,wBAAgB,mBAAmB,CAAC,MAAM,EACxC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,oBAAoB,EAC7B,WAAW,EAAE,oBAAoB,CAAC,MAAM,CAAC,GACxC,cAAc,CAqChB"}

package/dist/types/extension.d.ts

@@ -0,0 +1,59 @@
+import type { TransportLike } from "./transport.js";
+import { type ExtensionWatchSourceHandler, type ExtensionWatchSourceOptions } from "./watch-source.js";
+import { HostAPI } from "./host-api.js";
+import type { ExtensionDefinition, HookEvent, ExtensionToolRuntimeDescriptor, JSONValue } from "./types.js";
+import { registerProvideSurface, type ProvideSurfaceRegistration } from "./extension-provide-surface.js";
+import type { ExtensionHandler, ExtensionOptions, ExtensionToolHandler, ExtensionToolOptions, ReadyCallback } from "./extension-contract.js";
+export declare class Extension {
+    readonly definition: ExtensionDefinition;
+    private transport;
+    private readonly stderr;
+    private readonly sdkVersion;
+    private readonly describeProcess;
+    private readonly handlers;
+    private readonly toolHandlers;
+    private readonly commandGroups;
+    private readonly watchSources;
+    private readonly readyCallbacks;
+    private readonly transportBindings;
+    private readonly provideSurfaces;
+    private readonly host;
+    private initialized;
+    private shutdownStarted;
+    private shutdownDeadlineMS;
+    private session;
+    private startPromise;
+    private resolveStart;
+    private rejectStart;
+    constructor(definition: ExtensionDefinition, options?: ExtensionOptions);
+    bindTransport(transport: TransportLike): this;
+    handle<TParams = unknown, TResult = unknown>(method: string, handler: ExtensionHandler<TParams, TResult>): this;
+    [registerProvideSurface](capability: string, registrations: readonly ProvideSurfaceRegistration[]): this;
+    tool<TInput = unknown>(handler: string, options: ExtensionToolOptions, toolHandler: ExtensionToolHandler<TInput>): this;
+    watchSource<TSpec extends JSONValue = JSONValue>(kind: string, options: ExtensionWatchSourceOptions, handler: ExtensionWatchSourceHandler<TSpec>): this;
+    commandGroup(path: string, summary: string): this;
+    private ensureRegistrationOpen;
+    onReady(callback: ReadyCallback): this;
+    start(): Promise<HostAPI>;
+    getImplementedMethods(): string[];
+    getSupportedHookEvents(): HookEvent[];
+    getToolDescriptors(): ExtensionToolRuntimeDescriptor[];
+    describe(): import("./types.js").DescribePayload;
+    private bindTransportHandlers;
+    private bindMethod;
+    private dispatch;
+    private handleInitialize;
+    private finishInitialization;
+    private runReadyCallback;
+    private handleHealthCheck;
+    private handleShutdown;
+    private handleProvideTools;
+    private handleToolCall;
+    private handleUserMethod;
+    private makeContext;
+    private logError;
+    private ensureToolProviderCapability;
+    private ensureToolProviderHandlers;
+}
+export type { ExtensionContext, ExtensionDescribeProcess, ExtensionHandler, ExtensionOptions, ExtensionSession, ExtensionToolContext, ExtensionToolHandler, ExtensionToolOptions, } from "./extension-contract.js";
+//# sourceMappingURL=extension.d.ts.map

package/dist/types/extension.d.ts.map

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