@grackle-ai/adapter-sdk 0.166.0 → 0.167.0

package/dist/base-adapter.d.ts

@@ -0,0 +1,85 @@
+import type { EnvironmentAdapter, PowerLineConnection, ProvisionEvent } from "./adapter.js";
+/**
+ * Lifecycle state for a single environment managed by an adapter.
+ *
+ * - `idle` — no active infrastructure or connection.
+ * - `provisioning` — provision or reconnect in progress (mutex held).
+ * - `provisioned` — infrastructure ready, not yet connected.
+ * - `connected` — gRPC connection to PowerLine is established.
+ */
+export type AdapterLifecycleState = "idle" | "provisioning" | "provisioned" | "connected";
+/**
+ * Abstract base class for environment adapters that enforces lifecycle state
+ * transitions and prevents concurrent operations on the same environment.
+ *
+ * Subclasses implement the `do*` template methods; {@link BaseAdapter} wraps
+ * each with state guards and a per-environment mutex.
+ *
+ * The {@link EnvironmentAdapter} interface is unchanged — callers see the
+ * same API. `reconnect` is NOT defined here because
+ * {@link reconnectOrProvision} checks `adapter.reconnect` to decide whether
+ * to attempt fast reconnect. Subclasses that support reconnect should define
+ * their own `reconnect` method and use `withProvisionLock` for the
+ * same mutex/state semantics as `provision`.
+ */
+export declare abstract class BaseAdapter implements EnvironmentAdapter {
+    abstract type: string;
+    private readonly states;
+    private readonly locks;
+    /** Return the lifecycle state for an environment (`idle` if unknown). */
+    getState(environmentId: string): AdapterLifecycleState;
+    /**
+     * Provision infrastructure and yield progress events.
+     *
+     * Acquires a per-environment mutex for the duration of provisioning.
+     * On success the state moves to `provisioned`; on error it resets to `idle`.
+     */
+    provision(environmentId: string, config: Record<string, unknown>, powerlineToken: string): AsyncGenerator<ProvisionEvent>;
+    /**
+     * Establish a connection to the PowerLine.
+     *
+     * Allowed from any non-locked state. Docker attach calls this from `idle`
+     * after a server restart (re-resolves connectivity on the fly).
+     */
+    connect(environmentId: string, config: Record<string, unknown>, powerlineToken: string): Promise<PowerLineConnection>;
+    /**
+     * Release connection resources. Idempotent — safe to call from any
+     * non-locked state. Throws if a provision/reconnect is in progress to
+     * prevent tearing down resources while they are being set up.
+     */
+    disconnect(environmentId: string): Promise<void>;
+    /**
+     * Stop the environment's compute. Idempotent — resets state to `idle`.
+     * Throws if a provision/reconnect is in progress.
+     */
+    stop(environmentId: string, config: Record<string, unknown>): Promise<void>;
+    /**
+     * Destroy the environment's compute. Idempotent — removes all state.
+     * Throws if a provision/reconnect is in progress.
+     */
+    destroy(environmentId: string, config: Record<string, unknown>): Promise<void>;
+    /** Return true if the PowerLine is reachable. Subclasses must implement. */
+    abstract healthCheck(connection: PowerLineConnection): Promise<boolean>;
+    protected abstract doProvision(environmentId: string, config: Record<string, unknown>, powerlineToken: string): AsyncGenerator<ProvisionEvent>;
+    protected abstract doConnect(environmentId: string, config: Record<string, unknown>, powerlineToken: string): Promise<PowerLineConnection>;
+    protected abstract doDisconnect(environmentId: string): Promise<void>;
+    protected abstract doStop(environmentId: string, config: Record<string, unknown>): Promise<void>;
+    protected abstract doDestroy(environmentId: string, config: Record<string, unknown>): Promise<void>;
+    /**
+     * Wrap an async generator (provision or reconnect) with the lifecycle mutex.
+     *
+     * Acquires a per-environment lock, sets state to `provisioning`, yields all
+     * events from the wrapped generator, then sets state to `provisioned`.
+     * On error the state resets to `idle`. Subclasses that support `reconnect`
+     * should use this in their own `reconnect` method:
+     *
+     * ```ts
+     * public async *reconnect(envId, config, token) {
+     *   yield* this.withProvisionLock(envId, this.doReconnect(envId, config, token));
+     * }
+     * ```
+     */
+    protected withProvisionLock(environmentId: string, generator: AsyncGenerator<ProvisionEvent>): AsyncGenerator<ProvisionEvent>;
+    private assertNotLocked;
+}
+//# sourceMappingURL=base-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../src/base-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5F;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,cAAc,GAAG,aAAa,GAAG,WAAW,CAAC;AAE1F;;;;;;;;;;;;;GAaG;AACH,8BAAsB,WAAY,YAAW,kBAAkB;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGnB;IACJ,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IAExD,yEAAyE;IAClE,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,qBAAqB;IAM7D;;;;;OAKG;IACW,SAAS,CACrB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,EAAE,MAAM,GACrB,cAAc,CAAC,cAAc,CAAC;IAOjC;;;;;OAKG;IACU,OAAO,CAClB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,mBAAmB,CAAC;IAO/B;;;;OAIG;IACU,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7D;;;OAGG;IACU,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxF;;;OAGG;IACU,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3F,4EAA4E;aAC5D,WAAW,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9E,SAAS,CAAC,QAAQ,CAAC,WAAW,CAC5B,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,EAAE,MAAM,GACrB,cAAc,CAAC,cAAc,CAAC;IAEjC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAC1B,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,mBAAmB,CAAC;IAE/B,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAErE,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAEhG,SAAS,CAAC,QAAQ,CAAC,SAAS,CAC1B,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC;IAIhB;;;;;;;;;;;;;OAaG;cACc,iBAAiB,CAChC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,cAAc,CAAC,cAAc,CAAC,GACxC,cAAc,CAAC,cAAc,CAAC;IAiBjC,OAAO,CAAC,eAAe;CAOxB"}

package/dist/base-adapter.js

@@ -0,0 +1,112 @@
+/**
+ * Abstract base class for environment adapters that enforces lifecycle state
+ * transitions and prevents concurrent operations on the same environment.
+ *
+ * Subclasses implement the `do*` template methods; {@link BaseAdapter} wraps
+ * each with state guards and a per-environment mutex.
+ *
+ * The {@link EnvironmentAdapter} interface is unchanged — callers see the
+ * same API. `reconnect` is NOT defined here because
+ * {@link reconnectOrProvision} checks `adapter.reconnect` to decide whether
+ * to attempt fast reconnect. Subclasses that support reconnect should define
+ * their own `reconnect` method and use `withProvisionLock` for the
+ * same mutex/state semantics as `provision`.
+ */
+export class BaseAdapter {
+    states = new Map();
+    locks = new Set();
+    /** Return the lifecycle state for an environment (`idle` if unknown). */
+    getState(environmentId) {
+        return this.states.get(environmentId) ?? "idle";
+    }
+    // ─── Guarded lifecycle methods ──────────────────────────────
+    /**
+     * Provision infrastructure and yield progress events.
+     *
+     * Acquires a per-environment mutex for the duration of provisioning.
+     * On success the state moves to `provisioned`; on error it resets to `idle`.
+     */
+    async *provision(environmentId, config, powerlineToken) {
+        yield* this.withProvisionLock(environmentId, this.doProvision(environmentId, config, powerlineToken));
+    }
+    /**
+     * Establish a connection to the PowerLine.
+     *
+     * Allowed from any non-locked state. Docker attach calls this from `idle`
+     * after a server restart (re-resolves connectivity on the fly).
+     */
+    async connect(environmentId, config, powerlineToken) {
+        this.assertNotLocked(environmentId);
+        const conn = await this.doConnect(environmentId, config, powerlineToken);
+        this.states.set(environmentId, "connected");
+        return conn;
+    }
+    /**
+     * Release connection resources. Idempotent — safe to call from any
+     * non-locked state. Throws if a provision/reconnect is in progress to
+     * prevent tearing down resources while they are being set up.
+     */
+    async disconnect(environmentId) {
+        this.assertNotLocked(environmentId);
+        await this.doDisconnect(environmentId);
+        if (this.getState(environmentId) === "connected") {
+            this.states.set(environmentId, "idle");
+        }
+    }
+    /**
+     * Stop the environment's compute. Idempotent — resets state to `idle`.
+     * Throws if a provision/reconnect is in progress.
+     */
+    async stop(environmentId, config) {
+        this.assertNotLocked(environmentId);
+        await this.doStop(environmentId, config);
+        this.states.set(environmentId, "idle");
+    }
+    /**
+     * Destroy the environment's compute. Idempotent — removes all state.
+     * Throws if a provision/reconnect is in progress.
+     */
+    async destroy(environmentId, config) {
+        this.assertNotLocked(environmentId);
+        await this.doDestroy(environmentId, config);
+        this.states.delete(environmentId);
+    }
+    // ─── Lock helper for subclass reconnect ─────────────────────
+    /**
+     * Wrap an async generator (provision or reconnect) with the lifecycle mutex.
+     *
+     * Acquires a per-environment lock, sets state to `provisioning`, yields all
+     * events from the wrapped generator, then sets state to `provisioned`.
+     * On error the state resets to `idle`. Subclasses that support `reconnect`
+     * should use this in their own `reconnect` method:
+     *
+     * ```ts
+     * public async *reconnect(envId, config, token) {
+     *   yield* this.withProvisionLock(envId, this.doReconnect(envId, config, token));
+     * }
+     * ```
+     */
+    async *withProvisionLock(environmentId, generator) {
+        this.assertNotLocked(environmentId);
+        this.locks.add(environmentId);
+        this.states.set(environmentId, "provisioning");
+        try {
+            yield* generator;
+            this.states.set(environmentId, "provisioned");
+        }
+        catch (err) {
+            this.states.set(environmentId, "idle");
+            throw err;
+        }
+        finally {
+            this.locks.delete(environmentId);
+        }
+    }
+    // ─── Internals ──────────────────────────────────────────────
+    assertNotLocked(environmentId) {
+        if (this.locks.has(environmentId)) {
+            throw new Error(`Operation already in progress for environment ${environmentId} (state: ${this.getState(environmentId)})`);
+        }
+    }
+}
+//# sourceMappingURL=base-adapter.js.map

package/dist/base-adapter.js.map

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

package/dist/index.d.ts

@@ -3,6 +3,8 @@ export { FatalAdapterError } from "./fatal-error.js";
 export { defaultLogger } from "./logger.js";
 export type { PowerLineConnection, ProvisionEvent, BaseEnvironmentConfig, EnvironmentAdapter, } from "./adapter.js";
 export { reconnectOrProvision } from "./adapter.js";
+export type { AdapterLifecycleState } from "./base-adapter.js";
+export { BaseAdapter } from "./base-adapter.js";
 export type { RemoteExecutor } from "./remote-executor.js";
 export type { RemoteTunnel, TunnelProcessFactory, TunnelPortProbe } from "./tunnel.js";
 export { ProcessTunnel } from "./tunnel.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG/F,YAAY,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGtF,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGnF,OAAO,EACL,KAAK,EACL,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,0BAA0B,EAC1B,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AAMpB,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAKpF,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,iBAAiB,GAClB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpD,YAAY,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG/F,YAAY,EAAE,UAAU,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGtF,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGnF,OAAO,EACL,KAAK,EACL,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,0BAA0B,EAC1B,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AAMpB,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAKpF,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,iBAAiB,GAClB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -2,6 +2,7 @@
 export { FatalAdapterError } from "./fatal-error.js";
 export { defaultLogger } from "./logger.js";
 export { reconnectOrProvision } from "./adapter.js";
+export { BaseAdapter } from "./base-adapter.js";
 export { ProcessTunnel } from "./tunnel.js";
 export { registerTunnel, getTunnel, closeTunnel, closeAllTunnels } from "./tunnel-registry.js";
 export { createAhpHostTransport, connectThroughTunnel, waitForLocalPort, TCP_PORT_PROBER, } from "./connect.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,gEAAgE;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAS5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAOpD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI/F,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,8DAA8D;AAC9D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAItF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAKjC,+DAA+D;AAC/D,OAAO,EACL,KAAK,EACL,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,0BAA0B,EAC1B,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AAoBpB,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAMpF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,iBAAiB,GAClB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,gEAAgE;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAS5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAOhD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI/F,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AAItB,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,8DAA8D;AAC9D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAItF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAKjC,+DAA+D;AAC/D,OAAO,EACL,KAAK,EACL,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,0BAA0B,EAC1B,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AAoBpB,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAMpF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,iBAAiB,GAClB,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grackle-ai/adapter-sdk",
-  "version": "0.166.0",
+  "version": "0.167.0",
   "description": "SDK for building Grackle environment adapters",
   "license": "MIT",
   "repository": {
@@ -28,15 +28,16 @@
     "dist/"
   ],
   "dependencies": {
-    "@grackle-ai/common": "0.166.0",
-    "@grackle-ai/ahp": "0.166.0",
-    "@grackle-ai/ahp-transport": "0.166.0"
+    "@grackle-ai/common": "0.167.0",
+    "@grackle-ai/ahp-transport": "0.167.0",
+    "@grackle-ai/ahp": "0.167.0"
   },
   "devDependencies": {
     "@rushstack/heft": "1.2.7",
     "@types/node": "^22.0.0",
-    "@vitest/coverage-v8": "^3.1.1",
-    "vitest": "^3.1.1",
+    "@vitest/coverage-v8": "^4.1.0",
+    "vitest": "^4.1.0",
+    "@vitest/spy": "^4.1.0",
     "@grackle-ai/heft-rig": "0.0.1"
   },
   "scripts": {