@sapiom/harness 0.8.9 → 0.10.0

package/dist/core/system-graph-watcher.js

@@ -0,0 +1,448 @@
+import * as fs from "node:fs";
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import { isAgentProjectScanIgnoredDir } from "./agent-project-discovery.js";
+import { normalizeWatchPath } from "./canvas-watcher.js";
+import { snapshotWorkspaceWorkflowsAsync } from "./workspace-watcher.js";
+const SOURCE_DEBOUNCE_MS = 150;
+const INVENTORY_DEBOUNCE_MS = 250;
+const INVENTORY_RETRY_BASE_MS = 500;
+const MAX_INVENTORY_RETRIES = 3;
+const POLL_INTERVAL_MS = 2000;
+const SOURCE_EXTENSIONS = new Set([".ts", ".tsx"]);
+const UNREADABLE_SOURCE_FINGERPRINT = "<unreadable>";
+function ignoredRelativePath(relativePath) {
+    return relativePath
+        .split("/")
+        .filter(Boolean)
+        .some((segment) => isAgentProjectScanIgnoredDir(segment));
+}
+function sourceRelativePath(relativePath) {
+    return (!ignoredRelativePath(relativePath) &&
+        SOURCE_EXTENSIONS.has(path.extname(relativePath)));
+}
+function confinedSourcePath(root, relativePath) {
+    const absolute = path.resolve(root, relativePath);
+    const relative = path.relative(root, absolute);
+    if (relative === ".." ||
+        relative.startsWith(`..${path.sep}`) ||
+        path.isAbsolute(relative)) {
+        return null;
+    }
+    return absolute;
+}
+/**
+ * Async source fingerprint for the registered agent roots in one workspace.
+ *
+ * The graph watcher deliberately does not reuse Canvas's synchronous,
+ * 400-file project snapshot here: a workspace can contain many agent projects,
+ * and polling it on the server event loop would both stutter Studio and miss
+ * edits after that project-sized ceiling. Async directory reads yield between
+ * entries, while scoping the walk to registry roots keeps the unbounded file
+ * count honest without traversing unrelated workspace trees.
+ */
+export async function snapshotWorkflowSourceRootsAsync(sourceRoots) {
+    const roots = [
+        ...new Set(sourceRoots.map((root) => path.resolve(root))),
+    ].sort();
+    const snapshots = new Map();
+    const walk = async (dir, parts) => {
+        let entries;
+        try {
+            entries = await fsp.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            parts.push(`${dir}\0${UNREADABLE_SOURCE_FINGERPRINT}`);
+            return;
+        }
+        for (const entry of entries) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (isAgentProjectScanIgnoredDir(entry.name))
+                    continue;
+                await walk(full, parts);
+                continue;
+            }
+            if (!entry.isFile() || !SOURCE_EXTENSIONS.has(path.extname(entry.name))) {
+                continue;
+            }
+            try {
+                const stat = await fsp.stat(full);
+                parts.push(`${full}:${stat.mtimeMs}:${stat.size}`);
+            }
+            catch {
+                parts.push(`${full}:gone`);
+            }
+        }
+    };
+    for (const root of roots) {
+        const parts = [`root\0${root}`];
+        await walk(root, parts);
+        snapshots.set(root, parts.sort().join("|"));
+    }
+    return snapshots;
+}
+function isNestedSourceRoot(parent, candidate) {
+    const relative = path.relative(parent, candidate);
+    return (relative !== "" &&
+        relative !== ".." &&
+        !relative.startsWith(`..${path.sep}`) &&
+        !path.isAbsolute(relative));
+}
+function changedSourceRoots(previous, current) {
+    const changed = [...new Set([...previous.keys(), ...current.keys()])].filter((root) => previous.get(root) !== current.get(root));
+    // Nested registered projects appear in their parent's recursive snapshot.
+    // Attribute the edit only to the deepest changed caller(s).
+    return changed
+        .filter((root) => !changed.some((candidate) => candidate !== root && isNestedSourceRoot(root, candidate)))
+        .sort();
+}
+class WorkspaceSystemGraphWatcher {
+    constructor(scope, callbacks, options, initialInventorySnapshot) {
+        this.scope = scope;
+        this.callbacks = callbacks;
+        this.options = options;
+        this.watcher = null;
+        this.pollTimer = null;
+        this.sourceTimer = null;
+        this.inventoryTimer = null;
+        this.inventoryRetryTimer = null;
+        this.closed = false;
+        this.sourcePaths = new Set();
+        this.ambiguousSourceChange = false;
+        this.lastSourceSnapshots = null;
+        this.failedInventorySnapshot = null;
+        this.inventoryGeneration = 0;
+        this.inventoryCheckInFlight = false;
+        this.inventoryCheckPending = false;
+        this.pollInFlight = false;
+        this.callbackQueue = Promise.resolve();
+        this.lastInventorySnapshot = initialInventorySnapshot;
+        this.arm();
+    }
+    static async create(scope, callbacks, options) {
+        // Establish the native/polling watcher from an async baseline. The graph
+        // route awaits this factory, so no synchronous workspace walk runs on the
+        // server loop before the watcher starts.
+        const initialInventorySnapshot = await snapshotWorkspaceWorkflowsAsync(scope.root);
+        return new WorkspaceSystemGraphWatcher(scope, callbacks, options, initialInventorySnapshot);
+    }
+    enqueue(callback, onFailure) {
+        this.callbackQueue = this.callbackQueue.then(async () => {
+            if (this.closed)
+                return;
+            try {
+                await callback();
+            }
+            catch {
+                // Watch callbacks are refresh hints. A failed scan/build must not tear
+                // down the watcher or affect the rest of Studio.
+                try {
+                    onFailure?.();
+                }
+                catch {
+                    // Failure recovery is best-effort too.
+                }
+            }
+        });
+    }
+    scheduleSourceChange(sourcePath) {
+        if (this.closed)
+            return;
+        if (sourcePath === null)
+            this.ambiguousSourceChange = true;
+        else
+            this.sourcePaths.add(sourcePath);
+        if (this.sourceTimer)
+            clearTimeout(this.sourceTimer);
+        this.sourceTimer = setTimeout(() => {
+            this.sourceTimer = null;
+            const paths = this.ambiguousSourceChange
+                ? null
+                : [...this.sourcePaths].sort();
+            this.sourcePaths.clear();
+            this.ambiguousSourceChange = false;
+            this.enqueue(() => this.callbacks.onSourceChange(this.scope, paths));
+        }, this.options.sourceDebounceMs ?? SOURCE_DEBOUNCE_MS);
+    }
+    dispatchInventoryChange(snapshot, retryNumber = 0, retryGeneration) {
+        const generation = retryGeneration ?? this.inventoryGeneration + 1;
+        if (retryGeneration !== undefined &&
+            retryGeneration !== this.inventoryGeneration) {
+            return;
+        }
+        if (retryGeneration === undefined) {
+            this.inventoryGeneration = generation;
+            if (this.inventoryRetryTimer)
+                clearTimeout(this.inventoryRetryTimer);
+            this.inventoryRetryTimer = null;
+        }
+        this.lastInventorySnapshot = snapshot;
+        this.failedInventorySnapshot = null;
+        this.enqueue(() => {
+            if (generation !== this.inventoryGeneration)
+                return;
+            return this.callbacks.onInventoryChange(this.scope);
+        }, () => {
+            if (this.closed ||
+                generation !== this.inventoryGeneration ||
+                this.lastInventorySnapshot !== snapshot) {
+                return;
+            }
+            if (retryNumber >=
+                (this.options.maxInventoryRetries ?? MAX_INVENTORY_RETRIES)) {
+                // Consume the observed fingerprint after bounded recovery. This
+                // leaves the server snapshot stale without turning polling into a
+                // permanent registry-scan/event-bus loop. A later real source or
+                // inventory change clears this sentinel and starts a fresh series.
+                this.failedInventorySnapshot = snapshot;
+                return;
+            }
+            this.scheduleInventoryRetry(snapshot, retryNumber + 1, generation);
+        });
+    }
+    scheduleInventoryRetry(snapshot, retryNumber, generation) {
+        if (this.closed || generation !== this.inventoryGeneration)
+            return;
+        if (this.inventoryRetryTimer)
+            clearTimeout(this.inventoryRetryTimer);
+        const delay = (this.options.inventoryRetryBaseMs ?? INVENTORY_RETRY_BASE_MS) *
+            2 ** (retryNumber - 1);
+        this.inventoryRetryTimer = setTimeout(() => {
+            this.inventoryRetryTimer = null;
+            if (this.closed || generation !== this.inventoryGeneration)
+                return;
+            void snapshotWorkspaceWorkflowsAsync(this.scope.root)
+                .then((currentSnapshot) => {
+                if (this.closed || generation !== this.inventoryGeneration)
+                    return;
+                if (currentSnapshot !== snapshot) {
+                    this.dispatchInventoryChange(currentSnapshot);
+                    return;
+                }
+                this.dispatchInventoryChange(snapshot, retryNumber, generation);
+            })
+                .catch(() => {
+                if (this.closed || generation !== this.inventoryGeneration)
+                    return;
+                this.dispatchInventoryChange(snapshot, retryNumber, generation);
+            });
+        }, delay);
+    }
+    scheduleInventoryCheck(delay = this.options.inventoryDebounceMs ?? INVENTORY_DEBOUNCE_MS) {
+        if (this.closed)
+            return;
+        if (this.inventoryTimer)
+            clearTimeout(this.inventoryTimer);
+        this.inventoryTimer = setTimeout(() => {
+            this.inventoryTimer = null;
+            this.checkInventoryAsync();
+        }, delay);
+    }
+    checkInventoryAsync() {
+        if (this.closed)
+            return;
+        if (this.inventoryCheckInFlight) {
+            // One more async pass after the current walk is enough to cover any
+            // number of native events that arrive while it yields between dirs.
+            this.inventoryCheckPending = true;
+            return;
+        }
+        this.inventoryCheckInFlight = true;
+        this.inventoryCheckPending = false;
+        void snapshotWorkspaceWorkflowsAsync(this.scope.root)
+            .then((snapshot) => {
+            if (this.closed)
+                return;
+            if (snapshot === this.lastInventorySnapshot &&
+                snapshot !== this.failedInventorySnapshot) {
+                return;
+            }
+            this.dispatchInventoryChange(snapshot);
+        })
+            .catch(() => {
+            // A later native event retries an unreadable workspace. Watch hints
+            // must never surface as an unhandled rejection or tear down Studio.
+        })
+            .finally(() => {
+            this.inventoryCheckInFlight = false;
+            if (this.closed || !this.inventoryCheckPending)
+                return;
+            this.inventoryCheckPending = false;
+            this.checkInventoryAsync();
+        });
+    }
+    arm() {
+        if (this.closed)
+            return;
+        if (this.options.forcePolling) {
+            this.fallBackToPolling();
+            return;
+        }
+        try {
+            const listener = (_event, rawFilename) => {
+                if (rawFilename === null) {
+                    this.scheduleSourceChange(null);
+                    this.scheduleInventoryCheck();
+                    return;
+                }
+                const relativePath = normalizeWatchPath(rawFilename);
+                if (ignoredRelativePath(relativePath))
+                    return;
+                if (sourceRelativePath(relativePath)) {
+                    this.scheduleSourceChange(confinedSourcePath(this.scope.root, relativePath));
+                }
+                // Event kind is unreliable across editors/platforms. The marker
+                // fingerprint decides whether inventory really changed.
+                this.scheduleInventoryCheck();
+            };
+            this.watcher = this.options.watchFactory
+                ? this.options.watchFactory(this.scope.root, listener)
+                : fs.watch(this.scope.root, { recursive: true }, (_event, rawFilename) => {
+                    listener(_event, rawFilename);
+                });
+            this.watcher.on("error", () => this.fallBackToPolling());
+        }
+        catch {
+            this.fallBackToPolling();
+        }
+    }
+    fallBackToPolling() {
+        if (this.closed || this.pollTimer)
+            return;
+        let refreshAfterInitialSnapshot = this.watcher !== null;
+        this.watcher?.close();
+        this.watcher = null;
+        const poll = () => {
+            if (this.closed || this.pollInFlight)
+                return;
+            this.pollInFlight = true;
+            let sourceRoots = [];
+            try {
+                sourceRoots = this.callbacks.listSourceRoots(this.scope);
+            }
+            catch {
+                // Registry reads are hints too. Inventory polling still proceeds.
+            }
+            void Promise.all([
+                snapshotWorkflowSourceRootsAsync(sourceRoots),
+                snapshotWorkspaceWorkflowsAsync(this.scope.root),
+            ])
+                .then(([sourceSnapshots, inventorySnapshot]) => {
+                if (this.closed)
+                    return;
+                const changedRoots = this.lastSourceSnapshots
+                    ? changedSourceRoots(this.lastSourceSnapshots, sourceSnapshots)
+                    : [];
+                const ambiguousInitialChange = this.lastSourceSnapshots === null && refreshAfterInitialSnapshot;
+                const sourceChanged = ambiguousInitialChange || changedRoots.length > 0;
+                this.lastSourceSnapshots = sourceSnapshots;
+                refreshAfterInitialSnapshot = false;
+                if (ambiguousInitialChange)
+                    this.scheduleSourceChange(null);
+                else {
+                    for (const sourceRoot of changedRoots) {
+                        this.scheduleSourceChange(sourceRoot);
+                    }
+                }
+                if (inventorySnapshot !== this.lastInventorySnapshot) {
+                    this.dispatchInventoryChange(inventorySnapshot);
+                }
+                else if (sourceChanged &&
+                    inventorySnapshot === this.failedInventorySnapshot) {
+                    // Polling has no raw filesystem event. A source-fingerprint change
+                    // is its proof that a real edit occurred after bounded give-up.
+                    this.dispatchInventoryChange(inventorySnapshot);
+                }
+            })
+                .catch(() => {
+                // The next poll retries an unreadable workspace.
+            })
+                .finally(() => {
+                this.pollInFlight = false;
+            });
+        };
+        poll();
+        this.pollTimer = setInterval(poll, this.options.pollIntervalMs ?? POLL_INTERVAL_MS);
+    }
+    close() {
+        this.closed = true;
+        if (this.sourceTimer)
+            clearTimeout(this.sourceTimer);
+        if (this.inventoryTimer)
+            clearTimeout(this.inventoryTimer);
+        if (this.inventoryRetryTimer)
+            clearTimeout(this.inventoryRetryTimer);
+        if (this.pollTimer)
+            clearInterval(this.pollTimer);
+        this.watcher?.close();
+        this.watcher = null;
+    }
+}
+/** One watcher per requested workspace, independent of harness sessions. */
+export class SystemGraphWatcherManager {
+    constructor(callbacks, options = {}) {
+        this.callbacks = callbacks;
+        this.options = options;
+        this.watchers = new Map();
+        this.pendingStarts = new Map();
+    }
+    start(scope) {
+        const existing = this.watchers.get(scope.workspaceKey);
+        if (existing?.scope.root === scope.root)
+            return Promise.resolve();
+        const pending = this.pendingStarts.get(scope.workspaceKey);
+        if (pending?.root === scope.root)
+            return pending.promise;
+        this.stop(scope.workspaceKey);
+        const token = {};
+        const promise = WorkspaceSystemGraphWatcher.create(scope, this.callbacks, this.options)
+            .then((watcher) => {
+            const current = this.pendingStarts.get(scope.workspaceKey);
+            if (current?.token !== token) {
+                watcher.close();
+                return;
+            }
+            this.watchers.set(scope.workspaceKey, watcher);
+        })
+            .finally(() => {
+            if (this.pendingStarts.get(scope.workspaceKey)?.token === token) {
+                this.pendingStarts.delete(scope.workspaceKey);
+            }
+        });
+        this.pendingStarts.set(scope.workspaceKey, {
+            root: scope.root,
+            token,
+            promise,
+        });
+        return promise;
+    }
+    retain(workspaceKeys) {
+        const tracked = new Set([
+            ...this.watchers.keys(),
+            ...this.pendingStarts.keys(),
+        ]);
+        for (const workspaceKey of tracked) {
+            if (!workspaceKeys.has(workspaceKey))
+                this.stop(workspaceKey);
+        }
+    }
+    stop(workspaceKey) {
+        this.pendingStarts.delete(workspaceKey);
+        this.watchers.get(workspaceKey)?.close();
+        this.watchers.delete(workspaceKey);
+    }
+    stopAll() {
+        const tracked = new Set([
+            ...this.watchers.keys(),
+            ...this.pendingStarts.keys(),
+        ]);
+        for (const workspaceKey of tracked) {
+            this.stop(workspaceKey);
+        }
+    }
+    get size() {
+        return this.watchers.size;
+    }
+}
+//# sourceMappingURL=system-graph-watcher.js.map

package/dist/core/system-graph-watcher.js.map

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

package/dist/core/system-graph.d.ts

@@ -0,0 +1,43 @@
+import type { SystemGraph, WorkspaceKey, WorkspaceScopeSummary } from "../shared/system-graph.js";
+import { type AgentInventoryProvider, type WorkspaceScope } from "./system-graph-inventory.js";
+import { type AgentRelationshipProvider } from "./system-graph-relationships.js";
+export { HarnessRegistryInventoryProvider } from "./system-graph-inventory.js";
+export type { AgentInventoryItem, AgentInventoryProvider, AgentInventoryResult, AgentInventoryWarning, WorkspaceScope, } from "./system-graph-inventory.js";
+export { CachedAgentRelationshipProvider, SourceAgentRelationshipProvider, } from "./system-graph-relationships.js";
+export type { AgentRelationshipCandidate, AgentRelationshipProvider, AgentRelationshipProviderResult, AgentRelationshipWarning, } from "./system-graph-relationships.js";
+export interface WorkspaceScopeResolver {
+    resolve(workspaceKey: WorkspaceKey): Promise<WorkspaceScope | null>;
+}
+export interface WorkspaceScopeCatalog extends WorkspaceScopeResolver {
+    list(): Promise<WorkspaceScopeSummary[]>;
+}
+export interface SystemGraphBuilder {
+    build(scope: WorkspaceScope): Promise<SystemGraphBuildResult>;
+    /** Optional lifecycle hook for builders with workspace-scoped caches. */
+    retainWorkspaces?(workspaceKeys: ReadonlySet<WorkspaceKey>): void;
+}
+export interface SystemGraphBuildResult {
+    /** Internal cache policy; only graph crosses the HTTP boundary. */
+    cacheable: boolean;
+    graph: SystemGraph;
+}
+/**
+ * Resolves only roots the running Studio already knows about. A caller cannot
+ * manufacture a key and turn the graph endpoint into an arbitrary path scan.
+ */
+export declare class LocalWorkspaceScopeCatalog implements WorkspaceScopeCatalog {
+    private readonly listRoots;
+    constructor(listRoots: () => readonly string[] | Promise<readonly string[]>);
+    list(): Promise<WorkspaceScopeSummary[]>;
+    resolve(workspaceKey: WorkspaceKey): Promise<WorkspaceScope | null>;
+}
+export declare class StaticSystemGraphBuilder implements SystemGraphBuilder {
+    private readonly inventory;
+    private readonly relationships;
+    private readonly callersByWorkspace;
+    constructor(inventory: AgentInventoryProvider, relationships?: AgentRelationshipProvider);
+    build(scope: WorkspaceScope): Promise<SystemGraphBuildResult>;
+    retainWorkspaces(workspaceKeys: ReadonlySet<WorkspaceKey>): void;
+    private retainRelationshipCallers;
+}
+//# sourceMappingURL=system-graph.d.ts.map

package/dist/core/system-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-graph.d.ts","sourceRoot":"","sources":["../../src/core/system-graph.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,WAAW,EAEX,YAAY,EACZ,qBAAqB,EACtB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAGL,KAAK,yBAAyB,EAE/B,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAC/E,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,GACf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,qBAAsB,SAAQ,sBAAsB;IACnE,IAAI,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC9D,yEAAyE;IACzE,gBAAgB,CAAC,CAAC,aAAa,EAAE,WAAW,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;CACnE;AAED,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;CACpB;AAMD;;;GAGG;AACH,qBAAa,0BAA2B,YAAW,qBAAqB;IAEpE,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MACxB,SAAS,MAAM,EAAE,GACjB,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;IAG1B,IAAI,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAcxC,OAAO,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;CAS1E;AA6JD,qBAAa,wBAAyB,YAAW,kBAAkB;IAO/D,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAPhC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAG/B;gBAGe,SAAS,EAAE,sBAAsB,EACjC,aAAa,GAAE,yBAE/B;IAGG,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAsJnE,gBAAgB,CAAC,aAAa,EAAE,WAAW,CAAC,YAAY,CAAC,GAAG,IAAI;IAShE,OAAO,CAAC,yBAAyB;CASlC"}