@grackle-ai/adapter-local 0.72.2

package/README.md

@@ -0,0 +1,18 @@
+# @grackle-ai/adapter-local
+
+Grackle environment adapter for connecting to a locally-running PowerLine process.
+
+## Overview
+
+The local adapter connects to a PowerLine gRPC server on the same machine. It is the simplest adapter — no tunneling, no remote provisioning.
+
+## Configuration
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `port` | `number` | `7433` | PowerLine port |
+| `host` | `string` | `"localhost"` | PowerLine host |
+
+## Prerequisites
+
+- A locally-running PowerLine process (typically managed by the Grackle server)

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { LocalAdapter } from "./local.js";
+export type { LocalEnvironmentConfig } from "./local.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { LocalAdapter } from "./local.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/local.d.ts

@@ -0,0 +1,17 @@
+import type { EnvironmentAdapter, BaseEnvironmentConfig, PowerLineConnection, ProvisionEvent, AdapterDependencies } from "@grackle-ai/adapter-sdk";
+/** Local-specific environment configuration. */
+export interface LocalEnvironmentConfig extends BaseEnvironmentConfig {
+}
+/** Environment adapter that connects to a locally-running PowerLine process. */
+export declare class LocalAdapter implements EnvironmentAdapter {
+    type: string;
+    private readonly sleep;
+    constructor(deps?: AdapterDependencies);
+    provision(environmentId: string, config: Record<string, unknown>, powerlineToken: string): AsyncGenerator<ProvisionEvent>;
+    connect(environmentId: string, config: Record<string, unknown>, powerlineToken: string): Promise<PowerLineConnection>;
+    disconnect(): Promise<void>;
+    stop(): Promise<void>;
+    destroy(): Promise<void>;
+    healthCheck(connection: PowerLineConnection): Promise<boolean>;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../src/local.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAMnJ,gDAAgD;AAChD,MAAM,WAAW,sBAAuB,SAAQ,qBAAqB;CAEpE;AAED,gFAAgF;AAChF,qBAAa,YAAa,YAAW,kBAAkB;IAC9C,IAAI,EAAE,MAAM,CAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;gBAEnC,IAAI,GAAE,mBAAwB;IAInC,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,cAAc,CAAC,cAAc,CAAC;IAyB1H,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAWrH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,WAAW,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;CAQ5E"}

package/dist/local.js

@@ -0,0 +1,60 @@
+import { DEFAULT_POWERLINE_PORT } from "@grackle-ai/common";
+import { createPowerLineClient, sleep as defaultSleep } from "@grackle-ai/adapter-sdk";
+const POWERLINE_RETRY_DELAY_MS = 1_000;
+const POWERLINE_MAX_RETRIES = 5;
+/** Environment adapter that connects to a locally-running PowerLine process. */
+export class LocalAdapter {
+    type = "local";
+    sleep;
+    constructor(deps = {}) {
+        this.sleep = deps.sleep ?? defaultSleep;
+    }
+    async *provision(environmentId, config, powerlineToken) {
+        const cfg = config;
+        const port = cfg.port || DEFAULT_POWERLINE_PORT;
+        const host = cfg.host || "localhost";
+        yield { stage: "connecting", message: `Connecting to PowerLine at ${host}:${port}...`, progress: 0.5 };
+        const client = createPowerLineClient(`http://${host}:${port}`, powerlineToken);
+        let lastErr;
+        for (let attempt = 0; attempt < POWERLINE_MAX_RETRIES; attempt++) {
+            try {
+                await client.ping({});
+                yield { stage: "ready", message: "Connected to local PowerLine", progress: 1 };
+                return;
+            }
+            catch (err) {
+                lastErr = err;
+                yield { stage: "connecting", message: `Waiting for PowerLine (attempt ${attempt + 1}/${POWERLINE_MAX_RETRIES})...`, progress: 0.5 + attempt * 0.1 };
+                await this.sleep(POWERLINE_RETRY_DELAY_MS);
+            }
+        }
+        yield { stage: "error", message: `Could not reach PowerLine: ${lastErr instanceof Error ? lastErr.message : String(lastErr)}`, progress: 0 };
+    }
+    async connect(environmentId, config, powerlineToken) {
+        const cfg = config;
+        const port = cfg.port || DEFAULT_POWERLINE_PORT;
+        const host = cfg.host || "localhost";
+        const client = createPowerLineClient(`http://${host}:${port}`, powerlineToken);
+        await client.ping({});
+        return { client, environmentId, port };
+    }
+    async disconnect() {
+        // Nothing to clean up for local connections
+    }
+    async stop() {
+        // Local PowerLine lifecycle is managed externally
+    }
+    async destroy() {
+        // Local PowerLine lifecycle is managed externally
+    }
+    async healthCheck(connection) {
+        try {
+            await connection.client.ping({});
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/local.js.map

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

package/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.57.7"
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@grackle-ai/adapter-local",
+  "version": "0.72.2",
+  "description": "Grackle local environment adapter",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nick-pape/grackle.git",
+    "directory": "packages/adapter-local"
+  },
+  "keywords": [
+    "grackle",
+    "adapter",
+    "local",
+    "environment"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "dependencies": {
+    "@grackle-ai/adapter-sdk": "0.72.2",
+    "@grackle-ai/common": "0.72.2"
+  },
+  "devDependencies": {
+    "@rushstack/heft": "1.2.7",
+    "@types/node": "^22.0.0",
+    "vitest": "^3.1.1",
+    "@grackle-ai/heft-rig": "0.0.1"
+  },
+  "scripts": {
+    "build": "heft build --clean",
+    "test": "vitest run",
+    "clean": "heft clean",
+    "_phase:build": "heft run --only build -- --clean",
+    "_phase:test": "vitest run"
+  }
+}