@roubo/plugin-sdk 0.1.0 → 0.1.1

package/dist/component-host-client.d.ts

@@ -0,0 +1,33 @@
+import type { MessageConnection } from "vscode-jsonrpc/node.js";
+import type { ComponentHostClient } from "./types.js";
+/**
+ * The routing key the host needs to dispatch a broker call to the right bench
+ * (and, for reportLog, the right component). A component plugin is spawned once
+ * and multiplexes benches over one shared connection, so the broker params must
+ * name the bench the call acts for (#685). The SDK stamps this from the
+ * in-flight lifecycle call rather than burdening plugin authors with passing it
+ * by hand: each lifecycle handler dispatch sets the routing context for the
+ * duration of the call (see defineComponentPlugin), and every outgoing host.*
+ * request/notification reads it back here.
+ */
+export interface HostRoutingContext {
+    benchId: number;
+    componentName: string;
+}
+/**
+ * Run `fn` with the given routing context bound, so any host.* call it makes
+ * (synchronously or via awaited continuations) stamps `benchId` /
+ * `componentName` onto its params. Used by defineComponentPlugin to wrap each
+ * lifecycle handler dispatch.
+ */
+export declare function runWithHostRoutingContext<T>(ctx: HostRoutingContext, fn: () => T): T;
+export declare function bindComponentHostConnection(connection: MessageConnection): void;
+export declare function unbindComponentHostConnection(connection: MessageConnection): void;
+/**
+ * The host broker surface a component plugin drives over JSON-RPC. The host
+ * owns every process and container handle; these calls ask the host to act on
+ * the plugin's behalf. `reportStatus` / `reportLog` are notifications (push,
+ * fire-and-forget); everything else is a request that resolves with a result.
+ */
+export declare const host: ComponentHostClient;
+//# sourceMappingURL=component-host-client.d.ts.map

package/dist/component-host-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-host-client.d.ts","sourceRoot":"","sources":["../src/component-host-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAEV,mBAAmB,EAIpB,MAAM,YAAY,CAAC;AAIpB;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAID;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,GAAG,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEpF;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAE/E;AAED,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAIjF;AAoCD;;;;;GAKG;AACH,eAAO,MAAM,IAAI,EAAE,mBA2JjB,CAAC"}

package/dist/component-host-client.js

@@ -0,0 +1,168 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+let activeConnection = null;
+const routingStore = new AsyncLocalStorage();
+/**
+ * Run `fn` with the given routing context bound, so any host.* call it makes
+ * (synchronously or via awaited continuations) stamps `benchId` /
+ * `componentName` onto its params. Used by defineComponentPlugin to wrap each
+ * lifecycle handler dispatch.
+ */
+export function runWithHostRoutingContext(ctx, fn) {
+    return routingStore.run(ctx, fn);
+}
+export function bindComponentHostConnection(connection) {
+    activeConnection = connection;
+}
+export function unbindComponentHostConnection(connection) {
+    if (activeConnection === connection) {
+        activeConnection = null;
+    }
+}
+function requireConnection() {
+    if (!activeConnection) {
+        throw new Error("@roubo/plugin-sdk: host.* called before defineComponentPlugin(). Call defineComponentPlugin({...}) once at module top level.");
+    }
+    return activeConnection;
+}
+/**
+ * The bench this broker call acts for. A host.* call made outside any lifecycle
+ * handler (no ambient routing context) cannot be routed, so it throws here
+ * rather than silently mis-resolving: the host has no way to attribute it.
+ */
+function requireBenchId(method) {
+    const ctx = routingStore.getStore();
+    if (!ctx) {
+        throw new Error(`@roubo/plugin-sdk: ${method} called outside a lifecycle handler; the host cannot route it to a bench.`);
+    }
+    return ctx.benchId;
+}
+function requireComponentName(method) {
+    const ctx = routingStore.getStore();
+    if (!ctx) {
+        throw new Error(`@roubo/plugin-sdk: ${method} called outside a lifecycle handler; the host cannot route it to a component.`);
+    }
+    return ctx.componentName;
+}
+/**
+ * The host broker surface a component plugin drives over JSON-RPC. The host
+ * owns every process and container handle; these calls ask the host to act on
+ * the plugin's behalf. `reportStatus` / `reportLog` are notifications (push,
+ * fire-and-forget); everything else is a request that resolves with a result.
+ */
+export const host = Object.freeze({
+    process: Object.freeze({
+        async start(params) {
+            const method = "host.process.start";
+            return requireConnection().sendRequest(method, {
+                ...params,
+                benchId: requireBenchId(method),
+            });
+        },
+        async run(params) {
+            const method = "host.process.run";
+            return requireConnection().sendRequest(method, {
+                ...params,
+                benchId: requireBenchId(method),
+            });
+        },
+        async stop(params) {
+            const method = "host.process.stop";
+            await requireConnection().sendRequest(method, {
+                ...params,
+                benchId: requireBenchId(method),
+            });
+        },
+        async status(params) {
+            const method = "host.process.status";
+            return requireConnection().sendRequest(method, {
+                ...params,
+                benchId: requireBenchId(method),
+            });
+        },
+        async logs(params) {
+            const method = "host.process.logs";
+            return requireConnection().sendRequest(method, {
+                ...params,
+                benchId: requireBenchId(method),
+            });
+        },
+    }),
+    docker: Object.freeze({
+        async composeUp(params) {
+            const method = "host.docker.composeUp";
+            return requireConnection().sendRequest(method, {
+                ...params,
+                benchId: requireBenchId(method),
+            });
+        },
+        async waitForHealthy(params) {
+            const method = "host.docker.waitForHealthy";
+            return requireConnection().sendRequest(method, {
+                ...params,
+                benchId: requireBenchId(method),
+            });
+        },
+        async composeRunInit(params) {
+            const method = "host.docker.composeRunInit";
+            await requireConnection().sendRequest(method, {
+                ...params,
+                benchId: requireBenchId(method),
+            });
+        },
+        async composeStop(params) {
+            const method = "host.docker.composeStop";
+            await requireConnection().sendRequest(method, {
+                ...params,
+                benchId: requireBenchId(method),
+            });
+        },
+        async composeDown(params) {
+            const method = "host.docker.composeDown";
+            await requireConnection().sendRequest(method, {
+                ...params,
+                benchId: requireBenchId(method),
+            });
+        },
+        async assignContainer(params) {
+            const method = "host.docker.assignContainer";
+            await requireConnection().sendRequest(method, {
+                ...params,
+                benchId: requireBenchId(method),
+            });
+        },
+    }),
+    ports: Object.freeze({
+        async get(params) {
+            const method = "host.ports.get";
+            return requireConnection().sendRequest(method, {
+                ...params,
+                benchId: requireBenchId(method),
+            });
+        },
+    }),
+    component: Object.freeze({
+        reportStatus(status) {
+            const method = "host.component.reportStatus";
+            void requireConnection().sendNotification(method, {
+                ...status,
+                benchId: requireBenchId(method),
+            });
+        },
+        reportLog(params) {
+            const method = "host.component.reportLog";
+            void requireConnection().sendNotification(method, {
+                ...params,
+                benchId: requireBenchId(method),
+                componentName: requireComponentName(method),
+            });
+        },
+    }),
+    capability: Object.freeze({
+        async query(params) {
+            // capability.query is not bench-routed (it answers a static version gate),
+            // so it carries no benchId and works outside a lifecycle handler.
+            return requireConnection().sendRequest("host.capability.query", params);
+        },
+    }),
+});
+//# sourceMappingURL=component-host-client.js.map

package/dist/component-host-client.js.map

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

package/dist/connection.d.ts

@@ -0,0 +1,20 @@
+import { type MessageConnection } from "vscode-jsonrpc/node.js";
+/**
+ * Optional stdio-stream override shared by every `define*Plugin` entry point.
+ * Test harnesses inject paired in-memory streams; production plugin code
+ * leaves this unset and the bootstrap defaults to `process.stdin` /
+ * `process.stdout`.
+ */
+export interface PluginStreams {
+    input: NodeJS.ReadableStream;
+    output: NodeJS.WritableStream;
+}
+/**
+ * Resolve the JSON-RPC streams (defaulting to process stdio) and create the
+ * vscode-jsonrpc message connection. This is the shared plumbing that both
+ * `definePlugin` and `defineComponentPlugin` use so the transport lives in one
+ * place. The caller registers its own `onRequest` handlers, binds the host
+ * client, and calls `connection.listen()`.
+ */
+export declare function createPluginConnection(streams?: PluginStreams): MessageConnection;
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,iBAAiB,CAOjF"}

package/dist/connection.js

@@ -0,0 +1,16 @@
+import { createMessageConnection, StreamMessageReader, StreamMessageWriter, } from "vscode-jsonrpc/node.js";
+/**
+ * Resolve the JSON-RPC streams (defaulting to process stdio) and create the
+ * vscode-jsonrpc message connection. This is the shared plumbing that both
+ * `definePlugin` and `defineComponentPlugin` use so the transport lives in one
+ * place. The caller registers its own `onRequest` handlers, binds the host
+ * client, and calls `connection.listen()`.
+ */
+export function createPluginConnection(streams) {
+    const input = streams?.input ?? process.stdin;
+    const output = streams?.output ?? process.stdout;
+    const reader = new StreamMessageReader(input);
+    const writer = new StreamMessageWriter(output);
+    return createMessageConnection(reader, writer);
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,GAEpB,MAAM,wBAAwB,CAAC;AAahC;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAuB;IAC5D,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAC9C,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAEjD,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC"}

package/dist/define-component-plugin.d.ts

@@ -0,0 +1,38 @@
+import { type ComponentContract, type ComponentPluginHandle, type DefineComponentPluginOptions } from "./types.js";
+/**
+ * Register a component plugin's contract over the host JSON-RPC channel,
+ * parallel to `definePlugin()`. Plugin authors call this once, at module
+ * top-level, after defining their contract.
+ *
+ * A component plugin is written in one of two mutually exclusive modes:
+ *
+ * - **Declarative (preferred):** implement `translate({ config, context })`,
+ *   returning a `ProvisionDescriptor` the host's LifecycleEngine executes.
+ * - **Imperative (escape hatch):** implement all four lifecycle hooks
+ *   `start` / `stop` / `health` / `cleanup`, driving the host broker
+ *   (`componentHost.process.*`, `componentHost.docker.*`,
+ *   `componentHost.ports.*`) from inside them.
+ *
+ * ```ts
+ * import { defineComponentPlugin, componentHost } from "@roubo/plugin-sdk";
+ *
+ * // declarative
+ * defineComponentPlugin({
+ *   translate({ config, context }) {
+ *     return { schemaVersion: 1, kind: "process", command: config.command as string };
+ *   },
+ * });
+ * ```
+ *
+ * Validation is synchronous (throws at definition time, never at call time):
+ *
+ * - An incompatible `contractVersion` is rejected (it must equal
+ *   `SUPPORTED_CONTRACT_VERSION`).
+ * - Implementing `translate` AND any imperative hook is rejected (translate XOR
+ *   hooks; never silently both).
+ * - The imperative mode must implement ALL of `start` / `stop` / `health` /
+ *   `cleanup`; a plugin missing one (e.g. `stop`) is rejected here, not at
+ *   stop-time.
+ */
+export declare function defineComponentPlugin(contract: ComponentContract, options?: DefineComponentPluginOptions): ComponentPluginHandle;
+//# sourceMappingURL=define-component-plugin.d.ts.map

package/dist/define-component-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-component-plugin.d.ts","sourceRoot":"","sources":["../src/define-component-plugin.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,iBAAiB,EAGtB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EAClC,MAAM,YAAY,CAAC;AAkCpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE,4BAAiC,GACzC,qBAAqB,CAkEvB"}

package/dist/define-component-plugin.js

@@ -0,0 +1,120 @@
+import { bindComponentHostConnection, host, runWithHostRoutingContext, unbindComponentHostConnection, } from "./component-host-client.js";
+import { createPluginConnection } from "./connection.js";
+import { SUPPORTED_CONTRACT_VERSION, } from "./types.js";
+const IMPERATIVE_HOOKS = [
+    "start",
+    "stop",
+    "health",
+    "cleanup",
+];
+const COMPONENT_CONTRACT_METHODS = [
+    "translate",
+    ...IMPERATIVE_HOOKS,
+];
+/** Pull the `context` field out of a `translate` call's `{ config, context }`. */
+function extractContext(params) {
+    return params && typeof params === "object" ? params.context : params;
+}
+/**
+ * Read the bench routing key (benchId + componentName) off a lifecycle call's
+ * BenchContext. Returns null when the shape does not carry both, so the handler
+ * runs without an ambient routing context rather than with a partial one.
+ */
+function readRouting(benchContext) {
+    if (!benchContext || typeof benchContext !== "object")
+        return null;
+    const { benchId, componentName } = benchContext;
+    if (typeof benchId !== "number" || typeof componentName !== "string")
+        return null;
+    return { benchId, componentName };
+}
+/**
+ * Register a component plugin's contract over the host JSON-RPC channel,
+ * parallel to `definePlugin()`. Plugin authors call this once, at module
+ * top-level, after defining their contract.
+ *
+ * A component plugin is written in one of two mutually exclusive modes:
+ *
+ * - **Declarative (preferred):** implement `translate({ config, context })`,
+ *   returning a `ProvisionDescriptor` the host's LifecycleEngine executes.
+ * - **Imperative (escape hatch):** implement all four lifecycle hooks
+ *   `start` / `stop` / `health` / `cleanup`, driving the host broker
+ *   (`componentHost.process.*`, `componentHost.docker.*`,
+ *   `componentHost.ports.*`) from inside them.
+ *
+ * ```ts
+ * import { defineComponentPlugin, componentHost } from "@roubo/plugin-sdk";
+ *
+ * // declarative
+ * defineComponentPlugin({
+ *   translate({ config, context }) {
+ *     return { schemaVersion: 1, kind: "process", command: config.command as string };
+ *   },
+ * });
+ * ```
+ *
+ * Validation is synchronous (throws at definition time, never at call time):
+ *
+ * - An incompatible `contractVersion` is rejected (it must equal
+ *   `SUPPORTED_CONTRACT_VERSION`).
+ * - Implementing `translate` AND any imperative hook is rejected (translate XOR
+ *   hooks; never silently both).
+ * - The imperative mode must implement ALL of `start` / `stop` / `health` /
+ *   `cleanup`; a plugin missing one (e.g. `stop`) is rejected here, not at
+ *   stop-time.
+ */
+export function defineComponentPlugin(contract, options = {}) {
+    const contractVersion = options.contractVersion ?? SUPPORTED_CONTRACT_VERSION;
+    if (contractVersion !== SUPPORTED_CONTRACT_VERSION) {
+        throw new Error(`@roubo/plugin-sdk: defineComponentPlugin contractVersion ${contractVersion} is incompatible with the host (supported: ${SUPPORTED_CONTRACT_VERSION}). Rejected at validation.`);
+    }
+    const fields = contract;
+    const hasTranslate = typeof fields.translate === "function";
+    const implementedHooks = IMPERATIVE_HOOKS.filter((hook) => typeof fields[hook] === "function");
+    if (hasTranslate && implementedHooks.length > 0) {
+        throw new Error("@roubo/plugin-sdk: a component plugin implements translate OR the imperative hooks (start/stop/health/cleanup), not both. Rejected at validation.");
+    }
+    if (!hasTranslate) {
+        if (implementedHooks.length === 0) {
+            throw new Error("@roubo/plugin-sdk: a component plugin must implement either translate or the imperative hooks (start/stop/health/cleanup). Rejected at validation.");
+        }
+        const missing = IMPERATIVE_HOOKS.filter((hook) => !implementedHooks.includes(hook));
+        if (missing.length > 0) {
+            throw new Error(`@roubo/plugin-sdk: an imperative component plugin must implement all lifecycle hooks; missing ${missing.join(", ")}. Rejected at validation.`);
+        }
+    }
+    const connection = createPluginConnection(options.streams);
+    for (const method of COMPONENT_CONTRACT_METHODS) {
+        const handler = fields[method];
+        if (typeof handler !== "function")
+            continue;
+        connection.onRequest(method, (params) => {
+            // Bind the in-flight lifecycle call's routing context for the duration of
+            // the handler, so any host.* broker call it makes is stamped with this
+            // bench/component (#685). `translate` receives `{ config, context }`; the
+            // imperative hooks receive the BenchContext directly. Both carry benchId
+            // and componentName. When the params do not carry a usable context (an
+            // unexpected shape), dispatch the handler without a routing context: a
+            // broker call inside it then throws the "outside a lifecycle handler"
+            // error rather than mis-routing.
+            const benchContext = method === "translate" ? extractContext(params) : params;
+            const routing = readRouting(benchContext);
+            const invoke = () => handler(params);
+            return routing ? runWithHostRoutingContext(routing, invoke) : invoke();
+        });
+    }
+    bindComponentHostConnection(connection);
+    connection.listen();
+    return Object.freeze({
+        host: host,
+        dispose() {
+            try {
+                connection.dispose();
+            }
+            finally {
+                unbindComponentHostConnection(connection);
+            }
+        },
+    });
+}
+//# sourceMappingURL=define-component-plugin.js.map

package/dist/define-component-plugin.js.map

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

package/dist/define-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-plugin.d.ts","sourceRoot":"","sources":["../src/define-plugin.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAEV,mBAAmB,EAEnB,cAAc,EACd,YAAY,EACb,MAAM,YAAY,CAAC;AAiBpB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE,mBAAwB,GAChC,YAAY,CA6Bd"}
+{"version":3,"file":"define-plugin.d.ts","sourceRoot":"","sources":["../src/define-plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,mBAAmB,EAEnB,cAAc,EACd,YAAY,EACb,MAAM,YAAY,CAAC;AA4BpB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE,mBAAwB,GAChC,YAAY,CAwBd"}

package/dist/define-plugin.js

@@ -1,18 +1,29 @@
-import { createMessageConnection, StreamMessageReader, StreamMessageWriter, } from "vscode-jsonrpc/node.js";
+import { createPluginConnection } from "./connection.js";
 import { bindHostConnection, host, unbindHostConnection } from "./host-client.js";
 const CONTRACT_METHODS = [
     "listSourceCandidates",
+    "getSourceOptions",
     "listIssues",
     "getIssue",
     "getComments",
     "getCurrentUser",
     "validateConfig",
+    "setActiveConfig",
     "applyTransition",
+    "createIssue",
+    "addBlockedBy",
     "assignIssue",
     "unassignIssue",
     "getAvailableTransitions",
     "listIssueTypes",
+    "listStatusCategories",
     "listLabels",
+    "getConnectionStatus",
+    "probeAlertCategories",
+    "probeRepoAccess",
+    "filterFacets",
+    "getFacetOptions",
+    "getSortFields",
 ];
 /**
  * Register the plugin contract and start listening on the host JSON-RPC
@@ -36,11 +47,7 @@ const CONTRACT_METHODS = [
  * established here. Calling `host.*` before `definePlugin` throws.
  */
 export function definePlugin(contract, options = {}) {
-    const input = options.streams?.input ?? process.stdin;
-    const output = options.streams?.output ?? process.stdout;
-    const reader = new StreamMessageReader(input);
-    const writer = new StreamMessageWriter(output);
-    const connection = createMessageConnection(reader, writer);
+    const connection = createPluginConnection(options.streams);
     for (const method of CONTRACT_METHODS) {
         const handler = contract[method];
         if (typeof handler !== "function")

package/dist/define-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"define-plugin.js","sourceRoot":"","sources":["../src/define-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,GAEpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AASlF,MAAM,gBAAgB,GAAkC;IACtD,sBAAsB;IACtB,YAAY;IACZ,UAAU;IACV,aAAa;IACb,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,aAAa;IACb,eAAe;IACf,yBAAyB;IACzB,gBAAgB;IAChB,YAAY;CACJ,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAwB,EACxB,UAA+B,EAAE;IAEjC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IACtD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAEzD,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAsB,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9E,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,OAAO,OAAO,KAAK,UAAU;YAAE,SAAS;QAC5C,UAAU,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,MAAe,EAAE,EAAE,CAC9C,OAAmC,CAAC,MAAe,CAAC,CACtD,CAAC;IACJ,CAAC;IAED,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC/B,UAAU,CAAC,MAAM,EAAE,CAAC;IAEpB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,IAAkB;QACxB,OAAO;YACL,IAAI,CAAC;gBACH,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,CAAC;oBAAS,CAAC;gBACT,oBAAoB,CAAC,UAAU,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"define-plugin.js","sourceRoot":"","sources":["../src/define-plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AASlF,MAAM,gBAAgB,GAAkC;IACtD,sBAAsB;IACtB,kBAAkB;IAClB,YAAY;IACZ,UAAU;IACV,aAAa;IACb,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;IACjB,aAAa;IACb,cAAc;IACd,aAAa;IACb,eAAe;IACf,yBAAyB;IACzB,gBAAgB;IAChB,sBAAsB;IACtB,YAAY;IACZ,qBAAqB;IACrB,sBAAsB;IACtB,iBAAiB;IACjB,cAAc;IACd,iBAAiB;IACjB,eAAe;CACP,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAwB,EACxB,UAA+B,EAAE;IAEjC,MAAM,UAAU,GAAsB,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9E,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,OAAO,OAAO,KAAK,UAAU;YAAE,SAAS;QAC5C,UAAU,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,MAAe,EAAE,EAAE,CAC9C,OAAmC,CAAC,MAAe,CAAC,CACtD,CAAC;IACJ,CAAC;IAED,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC/B,UAAU,CAAC,MAAM,EAAE,CAAC;IAEpB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,IAAkB;QACxB,OAAO;YACL,IAAI,CAAC;gBACH,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,CAAC;oBAAS,CAAC;gBACT,oBAAoB,CAAC,UAAU,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,7 @@
 export { definePlugin } from "./define-plugin.js";
+export { defineComponentPlugin } from "./define-component-plugin.js";
 export { host } from "./host-client.js";
-export type { ContractMethodName, CurrentUser, DefinePluginOptions, FetchInit, FetchResult, HostClient, IssueTypeOption, ListIssuesParams, ListIssuesResult, LogPayload, NormalizedComment, NormalizedIssue, PluginContract, PluginHandle, SourceCandidate, ValidateConfigResult, } from "./types.js";
+export { host as componentHost } from "./component-host-client.js";
+export { SUPPORTED_CONTRACT_VERSION } from "./types.js";
+export type { BenchContext, CapabilityQueryResult, ComponentContract, ComponentContractMethodName, ComponentHostClient, ComponentPluginHandle, ComponentStatus, ConfiguredSource, DeclarativeComponentContract, DefineComponentPluginOptions, DockerProvisionDescriptor, ImperativeComponentContract, OneshotProvisionDescriptor, ProcessProvisionDescriptor, ProcessRunResult, ProcessStatusResult, ProvisionDescriptor, ConnectionStatus, ContractMethodName, CreateIssueResult, CurrentUser, DefinePluginOptions, FetchInit, FetchResult, FilterFacet, FilterFacetOption, GetFacetOptionsParams, GetSourceOptionsParams, HostClient, IssueTypeOption, ListIssueTypesParams, ListIssuesParams, ListIssuesResult, ListIssuesWarning, ListIssuesWarningCode, ListLabelsParams, LogPayload, NormalizedComment, NormalizedIssue, PluginContract, PluginHandle, ProbeAlertCategoriesParams, ProbeAlertCategoriesResult, ProbeAlertCategory, ProbeAlertCategoryReport, ProbeAlertCategoryStatus, ProbeRepoAccessResult, SearchableSourceCategory, SetActiveConfigResult, SourceCandidateCategory, SourceCandidateIcon, SourceCandidateItem, SourceCandidatesResponse, SourceCandidatesShape, SortField, SourceCategoryOption, SourceOptionsResult, ValidateConfigResult, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,eAAe,EACf,oBAAoB,GACrB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,IAAI,IAAI,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EACV,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,2BAA2B,EAC3B,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,4BAA4B,EAC5B,4BAA4B,EAC5B,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,EAC1B,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,0BAA0B,EAC1B,0BAA0B,EAC1B,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,SAAS,EACT,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,3 +1,6 @@
 export { definePlugin } from "./define-plugin.js";
+export { defineComponentPlugin } from "./define-component-plugin.js";
 export { host } from "./host-client.js";
+export { host as componentHost } from "./component-host-client.js";
+export { SUPPORTED_CONTRACT_VERSION } from "./types.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,IAAI,IAAI,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC"}