@grackle-ai/powerline 0.170.0 → 0.171.0

package/dist/resource-watch.js

@@ -0,0 +1,169 @@
+/**
+ * Filesystem resource watch lifecycle: create, start, stop, flush.
+ * @module resource-watch
+ */
+import { ActionType, AhpErrorCodes, JsonRpcErrorCodes, ResourceChangeType } from "@grackle-ai/ahp";
+import { watch as chokidarWatch } from "chokidar";
+import { existsSync } from "node:fs";
+import { randomUUID } from "node:crypto";
+import { join as joinPath, relative as relativePath, sep as pathSep } from "node:path";
+import { pathToFileURL } from "node:url";
+import picomatch from "picomatch";
+import { MAX_RESOURCE_WATCHES_PER_CONNECTION, RESOURCE_WATCH_CHANNEL_PREFIX, WATCH_COALESCE_MS, } from "./channel-codec.js";
+import { logger } from "./logger.js";
+import { assertWithinRoots, ResourceError, resourceUriToPath } from "./resource-fs.js";
+import { COALESCE_DROP, coalesceChangeType } from "./resource-watch-coalesce.js";
+/**
+ * Validate an optional AHP `GlobSet` (excludes/includes) from untrusted client
+ * params: it must be `undefined` or an object with an `items` array of strings.
+ *
+ * @throws ResourceError with `InvalidParams` for any other shape.
+ */
+function assertGlobSet(value, field) {
+    if (value === undefined) {
+        return;
+    }
+    const items = typeof value === "object" && value !== null ? value.items : undefined;
+    if (!Array.isArray(items) || !items.every((g) => typeof g === "string")) {
+        throw new ResourceError(JsonRpcErrorCodes.InvalidParams, `createResourceWatch: ${field} must be { items: string[] }`);
+    }
+}
+/**
+ * Allocate a resource-watch channel for a sandbox-validated URI. The watcher
+ * itself is started lazily when the client subscribes to the returned channel
+ * ({@link startResourceWatch}).
+ *
+ * @throws ResourceError — `InvalidParams`/`PermissionDenied` (sandbox) or
+ * `NotFound` if the watch target does not exist.
+ */
+export async function createResourceWatchEntry(params, cState) {
+    if (cState.watches.size >= MAX_RESOURCE_WATCHES_PER_CONNECTION) {
+        throw new ResourceError(JsonRpcErrorCodes.InvalidParams, `Too many active resource watches (max ${MAX_RESOURCE_WATCHES_PER_CONNECTION})`);
+    }
+    assertGlobSet(params.excludes, "excludes");
+    assertGlobSet(params.includes, "includes");
+    const rootPath = await assertWithinRoots(resourceUriToPath(params.uri), cState.allowedRoots);
+    if (!existsSync(rootPath)) {
+        throw new ResourceError(AhpErrorCodes.NotFound, `Watch target does not exist: ${params.uri}`);
+    }
+    const channel = `${RESOURCE_WATCH_CHANNEL_PREFIX}${randomUUID()}`;
+    const descriptor = {
+        root: params.uri,
+        recursive: params.recursive ?? false,
+        ...(params.excludes !== undefined ? { excludes: params.excludes } : {}),
+        ...(params.includes !== undefined ? { includes: params.includes } : {}),
+    };
+    cState.watches.set(channel, { rootPath, descriptor, serverSeq: 0, pending: new Map() });
+    return { channel };
+}
+/**
+ * Flush the coalesced change batch for a watch as a single
+ * `resourceWatch/changed` action. Never dispatches an empty batch (per spec).
+ */
+export function flushResourceWatch(conn, channel, entry) {
+    entry.flushTimer = undefined;
+    if (entry.stopped === true || entry.pending.size === 0) {
+        return;
+    }
+    const items = [...entry.pending.values()];
+    entry.pending.clear();
+    const action = {
+        type: ActionType.ResourceWatchChanged,
+        changes: { items },
+    };
+    conn.session.notify("action", {
+        channel,
+        serverSeq: entry.serverSeq++,
+        action,
+        origin: undefined,
+    });
+}
+/**
+ * Start the chokidar watcher for a previously-created watch entry and wire its
+ * events into coalesced `resourceWatch/changed` notifications. Idempotent: a
+ * second subscribe to the same channel is a no-op.
+ */
+export function startResourceWatch(conn, channel, entry) {
+    if (entry.watcher !== undefined) {
+        return;
+    }
+    entry.stopped = false;
+    const { rootPath, descriptor } = entry;
+    const excludeMatchers = (descriptor.excludes?.items ?? []).map((g) => picomatch(g));
+    const includeMatchers = (descriptor.includes?.items ?? []).map((g) => picomatch(g));
+    const relForMatch = (p) => relativePath(rootPath, p).split(pathSep).join("/");
+    const lexicalRoot = resourceUriToPath(descriptor.root);
+    const emitUriFor = (changedPath) => {
+        const rel = relativePath(rootPath, changedPath);
+        const lexicalPath = rel === "" ? lexicalRoot : joinPath(lexicalRoot, rel);
+        return pathToFileURL(lexicalPath).href;
+    };
+    const watcher = chokidarWatch(rootPath, {
+        ignoreInitial: true,
+        awaitWriteFinish: { stabilityThreshold: 200, pollInterval: 50 },
+        followSymlinks: false,
+        ignored: (p) => {
+            if (p.split(pathSep).includes(".git")) {
+                return true;
+            }
+            if (excludeMatchers.length === 0) {
+                return false;
+            }
+            const rel = relForMatch(p);
+            return rel !== "" && excludeMatchers.some((m) => m(rel));
+        },
+        depth: descriptor.recursive ? undefined : 0,
+    });
+    entry.watcher = watcher;
+    const record = (type) => (changedPath) => {
+        if (entry.stopped === true) {
+            return;
+        }
+        if (includeMatchers.length > 0) {
+            const rel = relForMatch(changedPath);
+            if (rel !== "" && !includeMatchers.some((m) => m(rel))) {
+                return;
+            }
+        }
+        const uri = emitUriFor(changedPath);
+        const next = coalesceChangeType(entry.pending.get(uri)?.type, type);
+        if (next === COALESCE_DROP) {
+            entry.pending.delete(uri);
+        }
+        else {
+            entry.pending.set(uri, { uri, type: next });
+        }
+        if (entry.pending.size > 0 && entry.flushTimer === undefined) {
+            entry.flushTimer = setTimeout(() => {
+                flushResourceWatch(conn, channel, entry);
+            }, WATCH_COALESCE_MS);
+        }
+    };
+    watcher.on("add", record(ResourceChangeType.Added));
+    watcher.on("addDir", record(ResourceChangeType.Added));
+    watcher.on("change", record(ResourceChangeType.Updated));
+    watcher.on("unlink", record(ResourceChangeType.Deleted));
+    watcher.on("unlinkDir", record(ResourceChangeType.Deleted));
+    watcher.on("error", (err) => {
+        logger.error({ err, channel }, "Resource watch error; tearing down watch");
+        stopResourceWatch(entry);
+    });
+}
+/** Release a watch's filesystem resources (watcher + pending flush timer). */
+export function stopResourceWatch(entry) {
+    entry.stopped = true;
+    if (entry.flushTimer !== undefined) {
+        clearTimeout(entry.flushTimer);
+        entry.flushTimer = undefined;
+    }
+    entry.pending.clear();
+    const w = entry.watcher;
+    if (w !== undefined) {
+        for (const ev of ["add", "addDir", "change", "unlink", "unlinkDir", "error"]) {
+            w.removeAllListeners(ev);
+        }
+        w.close().catch(() => undefined);
+    }
+    entry.watcher = undefined;
+}
+//# sourceMappingURL=resource-watch.js.map

package/dist/resource-watch.js.map

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

package/dist/runtime-loader.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Load and register all runtimes whose catalog entry has a `factory`
+ * descriptor.
+ *
+ * @param filter - When provided, only runtimes whose name passes the
+ *   predicate are loaded. Enables Code/Claw runtime-set composition.
+ */
+export declare function loadRuntimesFromCatalog(filter?: (name: string) => boolean): Promise<void>;
+//# sourceMappingURL=runtime-loader.d.ts.map

package/dist/runtime-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-loader.d.ts","sourceRoot":"","sources":["../src/runtime-loader.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB/F"}

package/dist/runtime-loader.js

@@ -0,0 +1,69 @@
+/**
+ * Catalog-driven runtime instantiation.
+ *
+ * Iterates {@link RUNTIME_CATALOG}, interprets each entry's factory
+ * descriptor, and registers the resulting {@link AgentRuntime}. This is
+ * the mechanism layer; the catalog is the policy layer.
+ */
+import { RUNTIME_CATALOG } from "@grackle-ai/common";
+import { registerRuntime, listRuntimes } from "./runtime-registry.js";
+import { logger } from "./logger.js";
+/**
+ * Load and register all runtimes whose catalog entry has a `factory`
+ * descriptor.
+ *
+ * @param filter - When provided, only runtimes whose name passes the
+ *   predicate are loaded. Enables Code/Claw runtime-set composition.
+ */
+export async function loadRuntimesFromCatalog(filter) {
+    for (const [name, entry] of Object.entries(RUNTIME_CATALOG)) {
+        if (entry.factory === undefined) {
+            continue;
+        }
+        if (filter !== undefined && !filter(name)) {
+            logger.debug({ runtime: name }, "Skipping runtime excluded by filter");
+            continue;
+        }
+        try {
+            const runtime = await instantiateRuntime(name, entry.factory);
+            registerRuntime(runtime);
+            logger.debug({ runtime: name }, "Registered runtime from catalog");
+        }
+        catch (err) {
+            logger.error({ err, runtime: name }, "Failed to load runtime %s — skipping", name);
+        }
+    }
+    const loaded = listRuntimes();
+    logger.info({ count: loaded.length, runtimes: loaded }, "Loaded %d runtimes", loaded.length);
+}
+async function instantiateRuntime(name, factory) {
+    switch (factory.type) {
+        case "sdk": {
+            const mod = (await import(factory.package));
+            const Constructor = mod[factory.exportName];
+            if (typeof Constructor !== "function") {
+                throw new Error(`Export "${factory.exportName}" from "${factory.package}" is not a constructor`);
+            }
+            try {
+                return new Constructor();
+            }
+            catch (err) {
+                throw new Error(`Failed to construct "${factory.exportName}" from "${factory.package}": ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        case "acp": {
+            const { AcpRuntime } = (await import("@grackle-ai/runtime-acp"));
+            return new AcpRuntime({
+                name,
+                command: factory.config.command,
+                args: factory.config.args,
+                isolateClaudeConfig: factory.config.isolateClaudeConfig,
+            });
+        }
+        default: {
+            const _exhaustive = factory;
+            throw new Error(`Unknown factory type: ${JSON.stringify(_exhaustive)}`);
+        }
+    }
+}
+//# sourceMappingURL=runtime-loader.js.map

package/dist/runtime-loader.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grackle-ai/powerline",
-  "version": "0.170.0",
+  "version": "0.171.0",
   "description": "gRPC PowerLine server for Grackle AI agent integration",
   "license": "MIT",
   "repository": {
@@ -37,15 +37,15 @@
     "picomatch": "4.0.4",
     "pino": "^10.3.1",
     "zod": "^4.0.0",
-    "@grackle-ai/ahp-transport": "0.170.0",
-    "@grackle-ai/ahp": "0.170.0",
-    "@grackle-ai/common": "0.170.0",
-    "@grackle-ai/runtime-claude-code": "0.170.0",
-    "@grackle-ai/runtime-sdk": "0.170.0",
-    "@grackle-ai/runtime-copilot": "0.170.0",
-    "@grackle-ai/runtime-codex": "0.170.0",
-    "@grackle-ai/runtime-genaiscript": "0.170.0",
-    "@grackle-ai/runtime-acp": "0.170.0"
+    "@grackle-ai/ahp-transport": "0.171.0",
+    "@grackle-ai/ahp": "0.171.0",
+    "@grackle-ai/runtime-sdk": "0.171.0",
+    "@grackle-ai/runtime-claude-code": "0.171.0",
+    "@grackle-ai/common": "0.171.0",
+    "@grackle-ai/runtime-copilot": "0.171.0",
+    "@grackle-ai/runtime-codex": "0.171.0",
+    "@grackle-ai/runtime-genaiscript": "0.171.0",
+    "@grackle-ai/runtime-acp": "0.171.0"
   },
   "devDependencies": {
     "@rushstack/heft": "1.2.7",