@sapiom/harness 0.8.9 → 0.9.0

package/dist/core/definition-name.d.ts

@@ -13,5 +13,17 @@
  * caller falls back to a weaker name source.
  */
 import { extractWorkflowGraphCached } from "./canvas-cache.js";
+export type ManifestNameInspection = {
+    status: "found";
+    name: string;
+} | {
+    status: "absent" | "failed";
+};
+/**
+ * Inspect the declared manifest name while preserving the difference between
+ * a valid unnamed agent and an extraction failure. Inventory uses the richer
+ * result to avoid warning for the normal unnamed case.
+ */
+export declare function inspectManifestName(projectDir: string, extract?: typeof extractWorkflowGraphCached): Promise<ManifestNameInspection>;
 export declare function resolveManifestName(projectDir: string, extract?: typeof extractWorkflowGraphCached): Promise<string | null>;
 //# sourceMappingURL=definition-name.d.ts.map

package/dist/core/definition-name.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition-name.d.ts","sourceRoot":"","sources":["../../src/core/definition-name.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAE/D,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAO,0BAAuD,GACtE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASxB"}
+{"version":3,"file":"definition-name.d.ts","sourceRoot":"","sources":["../../src/core/definition-name.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,MAAM,sBAAsB,GAC9B;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAA;CAAE,CAAC;AAEpC;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAO,0BAAuD,GACtE,OAAO,CAAC,sBAAsB,CAAC,CASjC;AAED,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAO,0BAAuD,GACtE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB"}

package/dist/core/definition-name.js

@@ -13,16 +13,25 @@
  * caller falls back to a weaker name source.
  */
 import { extractWorkflowGraphCached } from "./canvas-cache.js";
-export async function resolveManifestName(projectDir, extract = extractWorkflowGraphCached) {
+/**
+ * Inspect the declared manifest name while preserving the difference between
+ * a valid unnamed agent and an extraction failure. Inventory uses the richer
+ * result to avoid warning for the normal unnamed case.
+ */
+export async function inspectManifestName(projectDir, extract = extractWorkflowGraphCached) {
     try {
         const { result } = await extract(projectDir);
         if (!result.ok)
-            return null;
-        return result.graph.manifestName.trim() || null;
+            return { status: "failed" };
+        const name = result.graph.manifestName.trim();
+        return name === "" ? { status: "absent" } : { status: "found", name };
     }
     catch {
-        // Extraction is best-effort here — a name is a nicety, a deploy is not.
-        return null;
+        return { status: "failed" };
     }
 }
+export async function resolveManifestName(projectDir, extract = extractWorkflowGraphCached) {
+    const inspected = await inspectManifestName(projectDir, extract);
+    return inspected.status === "found" ? inspected.name : null;
+}
 //# sourceMappingURL=definition-name.js.map

package/dist/core/definition-name.js.map

@@ -1 +1 @@
-{"version":3,"file":"definition-name.js","sourceRoot":"","sources":["../../src/core/definition-name.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAkB,EAClB,UAA6C,0BAA0B;IAEvE,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAC5B,OAAO,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"definition-name.js","sourceRoot":"","sources":["../../src/core/definition-name.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAM/D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAkB,EAClB,UAA6C,0BAA0B;IAEvE,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC9C,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAkB,EAClB,UAA6C,0BAA0B;IAEvE,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACjE,OAAO,SAAS,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC"}

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

@@ -0,0 +1,68 @@
+import { type AgentKey, type GraphWarning, type WorkspaceKey } from "../shared/system-graph.js";
+import type { WorkflowInfo } from "../shared/types.js";
+import type { ManifestNameInspection } from "./definition-name.js";
+export { workspaceRelativeLocalKey } from "../shared/system-graph.js";
+export interface WorkspaceScope {
+    workspaceKey: WorkspaceKey;
+    root: string;
+}
+export interface AgentInventoryItem {
+    agentKey: AgentKey;
+    /** Internal deployment provenance. Never serialize this into SystemGraph. */
+    definitionId: number | null;
+    definitionSlug: string | null;
+    label: string;
+    resolutionAliases: string[];
+    /** Internal filesystem evidence. Never serialize this into SystemGraph. */
+    sourceRoot: string;
+}
+export interface AgentInventoryWarning {
+    code: Extract<GraphWarning["code"], "duplicate-agent-key" | "inventory-extraction-failed">;
+    agentKey: AgentKey;
+    message: string;
+}
+export interface AgentInventoryResult {
+    agents: AgentInventoryItem[];
+    /** False when a later graph open should retry degraded enrichment. */
+    cacheable: boolean;
+    warnings: AgentInventoryWarning[];
+}
+/** Read-only boundary between Studio's current registry and graph projection. */
+export interface AgentInventoryProvider {
+    listAgents(scope: WorkspaceScope): Promise<AgentInventoryResult>;
+}
+type ManifestNameInspector = (sourceRoot: string) => Promise<ManifestNameInspection>;
+export interface HarnessRegistryInventoryProviderOptions {
+    listWorkflows: () => readonly WorkflowInfo[] | Promise<readonly WorkflowInfo[]>;
+    inspectManifestName?: ManifestNameInspector;
+    /** Test seam; production keeps the default first-open latency budget. */
+    manifestInspectionBudgetMs?: number;
+}
+/**
+ * Resolve with the input path's own flavor so mixed Windows separators remain
+ * comparable even when the test process (or a future remote host) is POSIX.
+ */
+export declare function canonicalGraphPath(input: string): string;
+export declare function isWithinGraphPath(root: string, candidate: string): boolean;
+/** Canonical registered roots contained by a workspace, safe for symlinked scopes. */
+export declare function graphSourceRootsWithinScope(scopeRoot: string, sourceRoots: readonly string[]): string[];
+/**
+ * Attribute exact source edits to the deepest registered project roots.
+ * A null path list is the polling/ambiguous-event fallback and dirties every
+ * caller in the scope.
+ */
+export declare function dirtyGraphSourceRoots(scopeRoot: string, sourceRoots: readonly string[], sourcePaths: readonly string[] | null): string[];
+/**
+ * V0 inventory adapter. WorkflowRegistry's scan/connect flows remain the only
+ * writers; this provider receives snapshots and performs no discovery. The
+ * injected manifest-name inspection may run cached extraction, so enrichment
+ * has both a concurrency cap and a wall-clock budget on a cold graph open.
+ */
+export declare class HarnessRegistryInventoryProvider implements AgentInventoryProvider {
+    private readonly options;
+    constructor(options: HarnessRegistryInventoryProviderOptions);
+    listAgents(scope: WorkspaceScope): Promise<AgentInventoryResult>;
+    private prepareAgent;
+    private prepareFallbackAgent;
+}
+//# sourceMappingURL=system-graph-inventory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"system-graph-inventory.d.ts","sourceRoot":"","sources":["../../src/core/system-graph-inventory.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,QAAQ,CAAC;IACnB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CACX,YAAY,CAAC,MAAM,CAAC,EACpB,qBAAqB,GAAG,6BAA6B,CACtD,CAAC;IACF,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED,iFAAiF;AACjF,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAClE;AAED,KAAK,qBAAqB,GAAG,CAC3B,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAErC,MAAM,WAAW,uCAAuC;IACtD,aAAa,EAAE,MACX,SAAS,YAAY,EAAE,GACvB,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;IACrC,mBAAmB,CAAC,EAAE,qBAAqB,CAAC;IAC5C,yEAAyE;IACzE,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC;AAsDD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA6BxD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAU1E;AAED,sFAAsF;AACtF,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,MAAM,EAAE,CAWV;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,GACpC,MAAM,EAAE,CAsBV;AAkED;;;;;GAKG;AACH,qBAAa,gCAAiC,YAAW,sBAAsB;IAE3E,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,uCAAuC;IAG7D,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,oBAAoB,CAAC;YAoHxD,YAAY;IA+C1B,OAAO,CAAC,oBAAoB;CAqB7B"}

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

@@ -0,0 +1,312 @@
+import { realpathSync } from "node:fs";
+import * as path from "node:path";
+import { workspaceRelativeLocalKey, } from "../shared/system-graph.js";
+export { workspaceRelativeLocalKey } from "../shared/system-graph.js";
+const MANIFEST_INSPECTION_CONCURRENCY = 4;
+// Individual extraction can wait 15 s; inventory must return well before that.
+const MANIFEST_INSPECTION_BUDGET_MS = 5000;
+async function mapWithDeadline(values, concurrency, budgetMs, map) {
+    const results = new Array(values.length);
+    let nextIndex = 0;
+    let deadlineReached = false;
+    const worker = async () => {
+        while (!deadlineReached && nextIndex < values.length) {
+            const index = nextIndex;
+            nextIndex += 1;
+            try {
+                results[index] = await map(values[index]);
+            }
+            catch {
+                // The caller turns every unfinished/failed item into partial inventory.
+            }
+        }
+    };
+    const workers = Promise.all(Array.from({ length: Math.min(concurrency, values.length) }, async () => worker()));
+    let timer;
+    const deadline = new Promise((resolve) => {
+        timer = setTimeout(() => {
+            deadlineReached = true;
+            resolve();
+        }, budgetMs);
+    });
+    await Promise.race([workers, deadline]);
+    if (!deadlineReached && timer)
+        clearTimeout(timer);
+    // Already-started production inspections have their own 15 s timeout. Do
+    // not await them, and prevent workers from starting any more after the cap.
+    void workers;
+    return results.slice();
+}
+function isWindowsAbsolute(input) {
+    return /^[A-Za-z]:[\\/]/.test(input);
+}
+function pathApi(input) {
+    return isWindowsAbsolute(input) ? path.win32 : path.posix;
+}
+/**
+ * Resolve with the input path's own flavor so mixed Windows separators remain
+ * comparable even when the test process (or a future remote host) is POSIX.
+ */
+export function canonicalGraphPath(input) {
+    const windows = isWindowsAbsolute(input);
+    const api = pathApi(input);
+    const normalizedInput = windows ? input.replace(/\//g, "\\") : input;
+    const resolved = api.resolve(normalizedInput);
+    const matchesHost = windows === (process.platform === "win32");
+    if (!matchesHost)
+        return resolved;
+    try {
+        return realpathSync.native(resolved);
+    }
+    catch {
+        // Watchers can report a path after an atomic rename or deletion, so the
+        // leaf itself may no longer exist. Resolve the nearest existing ancestor
+        // and append the missing tail; otherwise a symlinked workspace would stop
+        // matching exactly when targeted invalidation matters most.
+        const missingSegments = [];
+        let ancestor = resolved;
+        let parent = api.dirname(ancestor);
+        while (parent !== ancestor) {
+            missingSegments.unshift(api.basename(ancestor));
+            ancestor = parent;
+            try {
+                return api.join(realpathSync.native(ancestor), ...missingSegments);
+            }
+            catch {
+                // Keep walking toward an existing ancestor.
+            }
+            parent = api.dirname(ancestor);
+        }
+        return resolved;
+    }
+}
+export function isWithinGraphPath(root, candidate) {
+    if (isWindowsAbsolute(root) !== isWindowsAbsolute(candidate))
+        return false;
+    const api = pathApi(root);
+    const relative = api.relative(root, candidate);
+    return (relative === "" ||
+        (relative !== ".." &&
+            !relative.startsWith(`..${api.sep}`) &&
+            !api.isAbsolute(relative)));
+}
+/** Canonical registered roots contained by a workspace, safe for symlinked scopes. */
+export function graphSourceRootsWithinScope(scopeRoot, sourceRoots) {
+    const canonicalScopeRoot = canonicalGraphPath(scopeRoot);
+    return [
+        ...new Set(sourceRoots
+            .map(canonicalGraphPath)
+            .filter((sourceRoot) => isWithinGraphPath(canonicalScopeRoot, sourceRoot))),
+    ].sort();
+}
+/**
+ * Attribute exact source edits to the deepest registered project roots.
+ * A null path list is the polling/ambiguous-event fallback and dirties every
+ * caller in the scope.
+ */
+export function dirtyGraphSourceRoots(scopeRoot, sourceRoots, sourcePaths) {
+    const roots = graphSourceRootsWithinScope(scopeRoot, sourceRoots);
+    if (sourcePaths === null)
+        return roots;
+    const dirty = new Set();
+    for (const sourcePath of sourcePaths) {
+        const canonicalSourcePath = canonicalGraphPath(sourcePath);
+        const matches = roots.filter((sourceRoot) => isWithinGraphPath(sourceRoot, canonicalSourcePath));
+        for (const match of matches) {
+            if (!matches.some((candidate) => candidate !== match && isWithinGraphPath(match, candidate))) {
+                dirty.add(match);
+            }
+        }
+    }
+    return [...dirty].sort();
+}
+function normalizedAlias(value) {
+    const alias = value?.trim() ?? "";
+    if (alias === "" ||
+        /[\0\r\n]/.test(alias) ||
+        alias.includes("/") ||
+        alias.includes("\\") ||
+        path.posix.isAbsolute(alias) ||
+        path.win32.isAbsolute(alias)) {
+        return null;
+    }
+    return alias;
+}
+function safeLabel(value, fallback) {
+    const label = value.trim();
+    if (label === "" ||
+        /[\0\r\n]/.test(label) ||
+        path.posix.isAbsolute(label) ||
+        path.win32.isAbsolute(label)) {
+        return fallback;
+    }
+    return label;
+}
+function uniqueAliases(values) {
+    return [
+        ...new Set(values.filter((value) => value !== null)),
+    ];
+}
+function preparedOrder(left, right) {
+    return (left.candidateKey.localeCompare(right.candidateKey) ||
+        left.sourceRoot.localeCompare(right.sourceRoot) ||
+        left.label.localeCompare(right.label));
+}
+function warningOrder(left, right) {
+    return (left.code.localeCompare(right.code) ||
+        left.agentKey.localeCompare(right.agentKey) ||
+        left.message.localeCompare(right.message));
+}
+/**
+ * V0 inventory adapter. WorkflowRegistry's scan/connect flows remain the only
+ * writers; this provider receives snapshots and performs no discovery. The
+ * injected manifest-name inspection may run cached extraction, so enrichment
+ * has both a concurrency cap and a wall-clock budget on a cold graph open.
+ */
+export class HarnessRegistryInventoryProvider {
+    constructor(options) {
+        this.options = options;
+    }
+    async listAgents(scope) {
+        // A registry read is the one operation whose failure makes inventory
+        // unavailable. Per-agent enrichment failures degrade to local identities.
+        const workflows = await this.options.listWorkflows();
+        const navigationRoot = scope.root;
+        const selectedScope = {
+            workspaceKey: scope.workspaceKey,
+            root: canonicalGraphPath(scope.root),
+        };
+        // Project-axis membership is containment in the SELECTED root. An agent can
+        // therefore appear in both a parent project's graph and a separately-opened
+        // nested project's graph, exactly as it appears under both project rows in
+        // the rail. Deepest-scope ownership made the parent row visibly list agents
+        // that disappeared when its graph opened.
+        const contained = workflows
+            .map((workflow) => ({
+            workflow,
+            sourceRoot: canonicalGraphPath(workflow.path),
+        }))
+            .filter(({ sourceRoot }) => isWithinGraphPath(selectedScope.root, sourceRoot))
+            .map(({ workflow, sourceRoot }) => {
+            const fallbackKey = workspaceRelativeLocalKey(navigationRoot, workflow.path) ??
+                workspaceRelativeLocalKey(selectedScope.root, sourceRoot);
+            if (!fallbackKey) {
+                throw new Error("Contained system graph path had no local identity");
+            }
+            return { workflow, sourceRoot, fallbackKey };
+        });
+        const inspections = await mapWithDeadline(contained, MANIFEST_INSPECTION_CONCURRENCY, this.options.manifestInspectionBudgetMs ?? MANIFEST_INSPECTION_BUDGET_MS, ({ workflow, sourceRoot, fallbackKey }) => this.prepareAgent(workflow, sourceRoot, fallbackKey));
+        const prepared = Array.from({ length: contained.length }, (_, index) => inspections[index] ??
+            this.prepareFallbackAgent(contained[index].workflow, contained[index].sourceRoot, contained[index].fallbackKey)).sort(preparedOrder);
+        const candidateCounts = new Map();
+        for (const agent of prepared) {
+            candidateCounts.set(agent.candidateKey, (candidateCounts.get(agent.candidateKey) ?? 0) + 1);
+        }
+        const used = new Set();
+        const assigned = prepared.map((agent) => {
+            const duplicate = (candidateCounts.get(agent.candidateKey) ?? 0) > 1;
+            let agentKey = duplicate ? agent.fallbackKey : agent.candidateKey;
+            if (used.has(agentKey))
+                agentKey = agent.fallbackKey;
+            let suffix = 2;
+            const base = agentKey;
+            while (used.has(agentKey)) {
+                agentKey = `${base}~${suffix}`;
+                suffix += 1;
+            }
+            used.add(agentKey);
+            return { agent, agentKey };
+        });
+        const warnings = [];
+        for (const candidateKey of [...candidateCounts.keys()].sort()) {
+            if ((candidateCounts.get(candidateKey) ?? 0) < 2)
+                continue;
+            warnings.push({
+                code: "duplicate-agent-key",
+                agentKey: candidateKey,
+                message: `Multiple agents use ${candidateKey}; kept each with a local identity.`,
+            });
+        }
+        for (const { agent, agentKey } of assigned) {
+            if (!agent.extractionFailed)
+                continue;
+            warnings.push({
+                code: "inventory-extraction-failed",
+                agentKey,
+                message: `Could not inspect ${agent.label}; using its local identity.`,
+            });
+        }
+        const agents = assigned
+            .map(({ agent, agentKey }) => ({
+            agentKey,
+            definitionId: agent.definitionId,
+            definitionSlug: agent.definitionSlug,
+            label: agent.label,
+            resolutionAliases: agent.resolutionAliases,
+            sourceRoot: agent.sourceRoot,
+        }))
+            .sort((left, right) => left.agentKey.localeCompare(right.agentKey) ||
+            left.sourceRoot.localeCompare(right.sourceRoot));
+        warnings.sort(warningOrder);
+        return {
+            agents,
+            cacheable: prepared.every((agent) => !agent.extractionFailed),
+            warnings,
+        };
+    }
+    async prepareAgent(workflow, sourceRoot, fallbackKey) {
+        const definitionSlug = normalizedAlias(workflow.definitionSlug);
+        let manifestName = null;
+        let extractionFailed = false;
+        if (!definitionSlug && this.options.inspectManifestName) {
+            try {
+                const inspected = await this.options.inspectManifestName(sourceRoot);
+                if (inspected.status === "found") {
+                    manifestName = normalizedAlias(inspected.name);
+                }
+                else {
+                    extractionFailed = inspected.status === "failed";
+                }
+            }
+            catch {
+                extractionFailed = true;
+            }
+        }
+        const candidateKey = definitionSlug ?? manifestName ?? fallbackKey;
+        // Keep the pre-disambiguation candidate as an alias for every copy. When
+        // duplicate local fallbacks exist, a caller targeting that candidate must
+        // see ambiguity rather than silently resolving to the unsuffixed copy.
+        const resolutionAliases = uniqueAliases([
+            definitionSlug,
+            manifestName,
+            candidateKey,
+        ]);
+        return {
+            candidateKey,
+            fallbackKey,
+            definitionId: workflow.definitionId,
+            definitionSlug,
+            extractionFailed,
+            label: safeLabel(workflow.name, definitionSlug ??
+                manifestName ??
+                (fallbackKey.slice("local:".length) || "Local agent")),
+            resolutionAliases,
+            sourceRoot,
+        };
+    }
+    prepareFallbackAgent(workflow, sourceRoot, fallbackKey) {
+        const definitionSlug = normalizedAlias(workflow.definitionSlug);
+        const candidateKey = definitionSlug ?? fallbackKey;
+        return {
+            candidateKey,
+            fallbackKey,
+            definitionId: workflow.definitionId,
+            definitionSlug,
+            extractionFailed: !definitionSlug,
+            label: safeLabel(workflow.name, definitionSlug ?? (fallbackKey.slice("local:".length) || "Local agent")),
+            resolutionAliases: [candidateKey],
+            sourceRoot,
+        };
+    }
+}
+//# sourceMappingURL=system-graph-inventory.js.map

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

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

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

@@ -0,0 +1,41 @@
+import { type AgentInvocationDetectionWarning, type AgentInvocationMode, type SourceEvidence } from "./canvas-interconnections.js";
+import type { AgentInventoryItem } from "./system-graph-inventory.js";
+export interface AgentRelationshipCandidate {
+    /** Inventory key or definition slug to resolve after extraction. */
+    target: string;
+    mode: AgentInvocationMode;
+    /** Internal-only evidence retained across callsite deduplication. */
+    evidence: SourceEvidence[];
+}
+export type AgentRelationshipWarning = AgentInvocationDetectionWarning;
+export interface AgentRelationshipProviderResult {
+    relationships: AgentRelationshipCandidate[];
+    warnings: AgentRelationshipWarning[];
+}
+/** Replaceable per-caller boundary consumed by the workspace graph projector. */
+export interface AgentRelationshipProvider {
+    listRelationships(caller: AgentInventoryItem): Promise<AgentRelationshipProviderResult>;
+    /** Optional lifecycle hook for providers that retain per-caller state. */
+    retainCallers?(callers: readonly AgentInventoryItem[]): void;
+}
+/**
+ * Successful per-caller relationship extraction behind the same cheap source
+ * fingerprint used by Canvas. Projection can therefore rebuild against a new
+ * inventory without re-walking unchanged caller trees.
+ */
+export declare class CachedAgentRelationshipProvider implements AgentRelationshipProvider {
+    private readonly inner;
+    private readonly fingerprint;
+    private readonly entries;
+    constructor(inner?: AgentRelationshipProvider, fingerprint?: (sourceRoot: string) => Promise<string>);
+    listRelationships(caller: AgentInventoryItem): Promise<AgentRelationshipProviderResult>;
+    invalidateSource(sourceRoot: string): void;
+    retainCallers(callers: readonly AgentInventoryItem[]): void;
+    clear(): void;
+}
+/** V0 filesystem adapter. It remains syntax-only and has no inventory target
+ * resolution, renderer, transport, deployment, or session dependencies. */
+export declare class SourceAgentRelationshipProvider implements AgentRelationshipProvider {
+    listRelationships(caller: AgentInventoryItem): Promise<AgentRelationshipProviderResult>;
+}
+//# sourceMappingURL=system-graph-relationships.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"system-graph-relationships.d.ts","sourceRoot":"","sources":["../../src/core/system-graph-relationships.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACpB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,mBAAmB,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED,MAAM,MAAM,wBAAwB,GAAG,+BAA+B,CAAC;AAEvE,MAAM,WAAW,+BAA+B;IAC9C,aAAa,EAAE,0BAA0B,EAAE,CAAC;IAC5C,QAAQ,EAAE,wBAAwB,EAAE,CAAC;CACtC;AAED,iFAAiF;AACjF,MAAM,WAAW,yBAAyB;IACxC,iBAAiB,CACf,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAC5C,0EAA0E;IAC1E,aAAa,CAAC,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI,CAAC;CAC9D;AAOD;;;;GAIG;AACH,qBAAa,+BACX,YAAW,yBAAyB;IAKlC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAJ9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;gBAGnD,KAAK,GAAE,yBAAiE,EACxE,WAAW,GAAE,CAC5B,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,MAAM,CAA8B;IAG7C,iBAAiB,CACrB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,+BAA+B,CAAC;IA2B3C,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAI1C,aAAa,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI;IAS3D,KAAK,IAAI,IAAI;CAGd;AAeD;2EAC2E;AAC3E,qBAAa,+BAAgC,YAAW,yBAAyB;IACzE,iBAAiB,CACrB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,+BAA+B,CAAC;CAiC5C"}

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

@@ -0,0 +1,98 @@
+import * as path from "node:path";
+import { detectAgentInvocations, } from "./canvas-interconnections.js";
+import { fingerprintWorkflowSources } from "./canvas-cache.js";
+/**
+ * Successful per-caller relationship extraction behind the same cheap source
+ * fingerprint used by Canvas. Projection can therefore rebuild against a new
+ * inventory without re-walking unchanged caller trees.
+ */
+export class CachedAgentRelationshipProvider {
+    constructor(inner = new SourceAgentRelationshipProvider(), fingerprint = fingerprintWorkflowSources) {
+        this.inner = inner;
+        this.fingerprint = fingerprint;
+        this.entries = new Map();
+    }
+    async listRelationships(caller) {
+        const key = path.resolve(caller.sourceRoot);
+        let fingerprint;
+        try {
+            fingerprint = await this.fingerprint(key);
+        }
+        catch (error) {
+            this.entries.delete(key);
+            throw error;
+        }
+        const hit = this.entries.get(key);
+        if (hit?.fingerprint === fingerprint)
+            return hit.result;
+        let result;
+        try {
+            result = Promise.resolve(this.inner.listRelationships(caller));
+        }
+        catch (error) {
+            result = Promise.reject(error);
+        }
+        const entry = { fingerprint, result };
+        this.entries.set(key, entry);
+        void result.catch(() => {
+            if (this.entries.get(key) === entry)
+                this.entries.delete(key);
+        });
+        return result;
+    }
+    invalidateSource(sourceRoot) {
+        this.entries.delete(path.resolve(sourceRoot));
+    }
+    retainCallers(callers) {
+        const retained = new Set(callers.map((caller) => path.resolve(caller.sourceRoot)));
+        for (const sourceRoot of this.entries.keys()) {
+            if (!retained.has(sourceRoot))
+                this.entries.delete(sourceRoot);
+        }
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+function evidenceOrder(left, right) {
+    return (left.file.localeCompare(right.file) ||
+        left.line - right.line ||
+        left.column - right.column);
+}
+const MODE_ORDER = {
+    blocking: 0,
+    async: 1,
+};
+/** V0 filesystem adapter. It remains syntax-only and has no inventory target
+ * resolution, renderer, transport, deployment, or session dependencies. */
+export class SourceAgentRelationshipProvider {
+    async listRelationships(caller) {
+        const scan = await detectAgentInvocations(caller.sourceRoot, new Set());
+        const grouped = new Map();
+        for (const invocation of scan.invocations) {
+            const key = `${invocation.slug}\0${invocation.mode}`;
+            const relationship = grouped.get(key);
+            if (relationship) {
+                relationship.evidence.push(invocation.evidence);
+            }
+            else {
+                grouped.set(key, {
+                    target: invocation.slug,
+                    mode: invocation.mode,
+                    evidence: [invocation.evidence],
+                });
+            }
+        }
+        const relationships = [...grouped.values()];
+        for (const relationship of relationships) {
+            relationship.evidence.sort(evidenceOrder);
+        }
+        relationships.sort((left, right) => left.evidence[0].file.localeCompare(right.evidence[0].file) ||
+            left.evidence[0].line - right.evidence[0].line ||
+            left.evidence[0].column - right.evidence[0].column ||
+            MODE_ORDER[left.mode] - MODE_ORDER[right.mode] ||
+            left.target.localeCompare(right.target));
+        return { relationships, warnings: scan.warnings };
+    }
+}
+//# sourceMappingURL=system-graph-relationships.js.map

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

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