@lzehrung/codegraph 2.1.0

package/dist/agent/followUps.js

@@ -0,0 +1,164 @@
+import { quoteShellArg } from "./shell.js";
+export function toolFollowUp(tool, arguments_ = {}, label) {
+    return {
+        tool,
+        arguments: { ...arguments_ },
+        ...(label !== undefined ? { label } : {}),
+    };
+}
+export function formatAgentFollowUpAsCli(followUp) {
+    const args = followUp.arguments;
+    switch (followUp.tool) {
+        case "file_deps": {
+            const file = stringArgument(args, "file");
+            const direction = args.direction === "rdeps" ? "rdeps" : "deps";
+            return appendJson(`codegraph ${direction}${file === undefined ? "" : ` ${formatPathArgument(file)}`}`, args);
+        }
+        case "calls": {
+            const handle = stringArgument(args, "handle");
+            const direction = args.direction === "callees" ? "callees" : "callers";
+            return appendJson(`codegraph ${direction}${handle === undefined ? "" : ` ${quoteShellArg(handle)}`}`, args);
+        }
+        case "type_hierarchy": {
+            const handle = stringArgument(args, "handle");
+            const direction = args.direction === "subtypes" ? "subtypes" : "supertypes";
+            return appendJson(`codegraph ${direction}${handle === undefined ? "" : ` ${quoteShellArg(handle)}`}`, args);
+        }
+        case "get_file": {
+            const file = stringArgument(args, "file");
+            return `codegraph file${file === undefined ? "" : ` ${formatPathArgument(file)}`}`;
+        }
+        case "packet_get": {
+            const target = stringArgument(args, "target");
+            return `codegraph packet get${target === undefined ? "" : ` ${formatPathArgument(target)}`}`;
+        }
+        case "chunk": {
+            const file = stringArgument(args, "file");
+            return `codegraph chunk${file === undefined ? "" : ` ${formatPathArgument(file)}`}`;
+        }
+        case "get_symbol": {
+            const handle = stringArgument(args, "handle");
+            return `codegraph explain${handle === undefined ? "" : ` ${quoteShellArg(handle)}`}`;
+        }
+        case "goto": {
+            const location = locationArgument(args);
+            return `codegraph goto ${quoteShellArg(location)}`;
+        }
+        case "refs": {
+            const target = stringArgument(args, "handle") ?? locationArgument(args);
+            return `codegraph refs ${quoteShellArg(target)}`;
+        }
+        case "search": {
+            const query = stringArgument(args, "query");
+            let command = `codegraph search${query === undefined ? "" : ` ${quoteShellArg(query)}`}`;
+            if (typeof args.mode === "string")
+                command += ` --mode ${quoteShellArg(args.mode)}`;
+            if (typeof args.from === "string")
+                command += ` --from ${quoteShellArg(args.from)}`;
+            return `${command} --json`;
+        }
+        case "explore": {
+            const query = stringArgument(args, "query");
+            return `codegraph explore${query === undefined ? "" : ` ${quoteShellArg(query)}`}`;
+        }
+        case "orient": {
+            let command = "codegraph orient";
+            if (typeof args.root === "string")
+                command += ` --root ${quoteShellArg(args.root)}`;
+            if (typeof args.budget === "string")
+                command += ` --budget ${quoteShellArg(args.budget)}`;
+            return command;
+        }
+        case "implementations": {
+            const handle = stringArgument(args, "handle");
+            return appendJson(`codegraph implementations${handle === undefined ? "" : ` ${quoteShellArg(handle)}`}`, args);
+        }
+        case "rename_preview": {
+            const handle = stringArgument(args, "handle");
+            const newName = stringArgument(args, "newName") ?? "<new-name>";
+            return `codegraph rename-preview${handle === undefined ? "" : ` ${quoteShellArg(handle)}`} ${quoteShellArg(newName)} --json`;
+        }
+        case "review":
+        case "impact": {
+            let command = `codegraph ${followUp.tool}`;
+            if (typeof args.provider === "string")
+                command += ` --provider ${quoteShellArg(args.provider)}`;
+            if (typeof args.base === "string")
+                command += ` --base ${quoteShellArg(args.base)}`;
+            if (typeof args.head === "string")
+                command += ` --head ${quoteShellArg(args.head)}`;
+            return command;
+        }
+        case "duplicates": {
+            const root = stringArgument(args, "root") ?? ".";
+            const files = Array.isArray(args.files)
+                ? args.files.filter((file) => typeof file === "string")
+                : [];
+            let command = `codegraph duplicates --root ${quoteShellArg(root)} ${files.map(quoteShellArg).join(" ")}`;
+            if (args.json === true)
+                command += " --json";
+            if (typeof args.minConfidence === "string")
+                command += ` --min-confidence ${quoteShellArg(args.minConfidence)}`;
+            if (args.includeSameFile === true)
+                command += " --include-same-file";
+            return command;
+        }
+        case "hotspots": {
+            const root = stringArgument(args, "root") ?? ".";
+            const limit = typeof args.limit === "number" ? ` --limit ${args.limit}` : "";
+            return `codegraph hotspots ${quoteShellArg(root)}${limit}`;
+        }
+        default:
+            return formatUnknownFollowUp(followUp);
+    }
+}
+export function formatAgentFollowUpsAsCli(followUps) {
+    return followUps.map(formatAgentFollowUpAsCli);
+}
+function stringArgument(args, key) {
+    return typeof args[key] === "string" ? args[key] : undefined;
+}
+function locationArgument(args) {
+    const file = stringArgument(args, "file") ?? "<file>";
+    const line = typeof args.line === "number" ? args.line : 1;
+    const column = typeof args.column === "number" ? args.column : 0;
+    return `${file}:${line}:${column}`;
+}
+function formatPathArgument(value) {
+    const target = value.startsWith("-") ||
+        value.startsWith("file:") ||
+        value.startsWith("symbol:") ||
+        value.startsWith("chunk:") ||
+        value.startsWith("sql:") ||
+        value.startsWith("graph:") ||
+        value.startsWith("review:")
+        ? `./${value}`
+        : value;
+    return quoteShellArg(target);
+}
+function appendJson(command, args) {
+    let output = command;
+    if (typeof args.depth === "number")
+        output += ` --depth ${args.depth}`;
+    if (typeof args.limit === "number")
+        output += ` --limit ${args.limit}`;
+    if (args.includeHeuristic === true)
+        output += " --include-heuristic";
+    return `${output} --json`;
+}
+function formatUnknownFollowUp(followUp) {
+    let command = `codegraph ${followUp.tool}`;
+    for (const [key, value] of Object.entries(followUp.arguments)) {
+        if (value === undefined || value === false)
+            continue;
+        if (value === true) {
+            command += ` --${key}`;
+            continue;
+        }
+        if (typeof value === "string" || typeof value === "number") {
+            command += ` --${key} ${quoteShellArg(String(value))}`;
+        }
+    }
+    return command;
+}
+//# sourceMappingURL=followUps.js.map

package/dist/agent/followUps.js.map

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

package/dist/agent/handles.d.ts

@@ -0,0 +1,29 @@
+export type AgentSymbolHandle = {
+    file: string;
+    name: string;
+    line: number;
+    column: number;
+};
+export type AgentSqlHandle = {
+    name: string;
+    file: string;
+    line: number;
+};
+export type AgentFileHandle = {
+    file: string;
+};
+export type AgentChunkHandle = {
+    file: string;
+    line: number;
+};
+export declare function formatAgentSymbolHandle(handle: AgentSymbolHandle): string;
+export declare function parseAgentSymbolHandle(handle: string): AgentSymbolHandle | null;
+export declare function formatAgentFileHandle(handle: AgentFileHandle): string;
+export declare function parseAgentFileHandle(handle: string): AgentFileHandle | null;
+export declare function formatAgentChunkHandle(handle: AgentChunkHandle): string;
+export declare function parseAgentChunkHandle(handle: string): AgentChunkHandle | null;
+export declare function formatAgentGraphHandle(handle: AgentFileHandle): string;
+export declare function parseAgentGraphHandle(handle: string): AgentFileHandle | null;
+export declare function formatAgentSqlHandle(handle: AgentSqlHandle): string;
+export declare function parseAgentSqlHandle(handle: string): AgentSqlHandle | null;
+//# sourceMappingURL=handles.d.ts.map

package/dist/agent/handles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handles.d.ts","sourceRoot":"","sources":["../../src/agent/handles.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAQzE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAe/E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAErE;AAWD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAE3E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAEvE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAU7E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAEtE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAE5E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAEnE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAoBzE"}

package/dist/agent/handles.js

@@ -0,0 +1,103 @@
+export function formatAgentSymbolHandle(handle) {
+    return [
+        "symbol",
+        encodeURIComponent(handle.file),
+        encodeURIComponent(handle.name),
+        String(handle.line),
+        String(handle.column),
+    ].join(":");
+}
+export function parseAgentSymbolHandle(handle) {
+    if (!handle.startsWith("symbol:"))
+        return null;
+    const parts = handle.split(":");
+    if (parts.length !== 5)
+        return null;
+    const file = decodeHandlePart(parts[1]);
+    const name = decodeHandlePart(parts[2]);
+    const line = Number(parts[3]);
+    const column = Number(parts[4]);
+    if (!file || !name || !Number.isFinite(line) || !Number.isFinite(column))
+        return null;
+    return {
+        file,
+        name,
+        line,
+        column,
+    };
+}
+export function formatAgentFileHandle(handle) {
+    return ["file", encodeURIComponent(handle.file)].join(":");
+}
+function parseAgentFileLikeHandle(handle, prefix) {
+    const handlePrefix = `${prefix}:`;
+    if (!handle.startsWith(handlePrefix))
+        return null;
+    const encodedFile = handle.slice(handlePrefix.length);
+    const file = decodeHandlePart(encodedFile) ?? encodedFile;
+    if (!file)
+        return null;
+    return { file };
+}
+export function parseAgentFileHandle(handle) {
+    return parseAgentFileLikeHandle(handle, "file");
+}
+export function formatAgentChunkHandle(handle) {
+    return ["chunk", encodeURIComponent(handle.file), String(handle.line)].join(":");
+}
+export function parseAgentChunkHandle(handle) {
+    if (!handle.startsWith("chunk:"))
+        return null;
+    const remainder = handle.slice("chunk:".length);
+    const separator = remainder.lastIndexOf(":");
+    if (separator < 0)
+        return null;
+    const encodedFile = remainder.slice(0, separator);
+    const line = Number(remainder.slice(separator + 1));
+    const file = decodeHandlePart(encodedFile) ?? encodedFile;
+    if (!file || !Number.isFinite(line))
+        return null;
+    return { file, line };
+}
+export function formatAgentGraphHandle(handle) {
+    return ["graph", encodeURIComponent(handle.file)].join(":");
+}
+export function parseAgentGraphHandle(handle) {
+    return parseAgentFileLikeHandle(handle, "graph");
+}
+export function formatAgentSqlHandle(handle) {
+    return ["sql", encodeURIComponent(handle.name), encodeURIComponent(handle.file), String(handle.line)].join(":");
+}
+export function parseAgentSqlHandle(handle) {
+    if (!handle.startsWith("sql:"))
+        return null;
+    const parts = handle.split(":");
+    if (parts.length === 4) {
+        const name = decodeHandlePart(parts[1]);
+        const file = decodeHandlePart(parts[2]);
+        const line = Number(parts[3]);
+        if (!name || !file || !Number.isFinite(line))
+            return null;
+        return { name, file, line };
+    }
+    if (parts.length > 4) {
+        const name = parts[1];
+        const file = parts.slice(2, -1).join(":");
+        const line = Number(parts[parts.length - 1]);
+        if (!name || !file || !Number.isFinite(line))
+            return null;
+        return { name, file, line };
+    }
+    return null;
+}
+function decodeHandlePart(value) {
+    if (value === undefined)
+        return null;
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=handles.js.map

package/dist/agent/handles.js.map

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

package/dist/agent/normalize.d.ts

@@ -0,0 +1,19 @@
+import { type AgentFollowUp } from "./followUps.js";
+export type AgentFileSnapshot = {
+    root: string;
+    files: readonly string[];
+    fileLookup?: ReadonlyMap<string, string>;
+};
+export type AgentSqlObjectKind = "table" | "view" | "index" | "routine";
+export declare function normalizeAgentFilePath(root: string, file: string): string;
+export declare function normalizeAgentOutputPath(root: string, file: string): string;
+export declare function createAgentFileLookup(files: readonly string[]): Map<string, string>;
+export declare function resolveAgentSnapshotFile(snapshot: AgentFileSnapshot, candidate: string): string | null;
+export declare function isAgentSqlFile(file: string): boolean;
+export declare function isAgentSqlObjectKind(kind: string): kind is AgentSqlObjectKind;
+export declare function isAgentSqlObjectNode(node: {
+    kind: string;
+}): boolean;
+export declare function collectFileFollowUps(file: string): AgentFollowUp[];
+export declare function collectDefinitionFollowUps(file: string, line: number, column: number): AgentFollowUp[];
+//# sourceMappingURL=normalize.d.ts.map

package/dist/agent/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/agent/normalize.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,gBAAgB,CAAC;AAElE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAExE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAEnF;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUtG;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,kBAAkB,CAE7E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAEpE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAMlE;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAEtG"}

package/dist/agent/normalize.js

@@ -0,0 +1,45 @@
+import path from "node:path";
+import { fileIdentityKey, normalizePath, resolveFilePathFromRoot, toProjectDisplayPath, toProjectRelativePath, } from "../util/paths.js";
+import { parseSourceLocationInput } from "../util/sourceLocation.js";
+import { toolFollowUp } from "./followUps.js";
+export function normalizeAgentFilePath(root, file) {
+    return toProjectRelativePath(root, file) ?? normalizePath(path.resolve(file));
+}
+export function normalizeAgentOutputPath(root, file) {
+    return toProjectDisplayPath(root, file);
+}
+export function createAgentFileLookup(files) {
+    return new Map(files.map((file) => [fileIdentityKey(file), normalizePath(file)]));
+}
+export function resolveAgentSnapshotFile(snapshot, candidate) {
+    const normalizedFiles = snapshot.fileLookup ?? createAgentFileLookup(snapshot.files);
+    const resolveCandidate = (value) => {
+        const absoluteCandidate = resolveFilePathFromRoot(snapshot.root, value);
+        return normalizedFiles.get(fileIdentityKey(absoluteCandidate)) ?? null;
+    };
+    const direct = resolveCandidate(candidate);
+    if (direct)
+        return direct;
+    const location = parseSourceLocationInput(candidate);
+    return location.file === candidate ? null : resolveCandidate(location.file);
+}
+export function isAgentSqlFile(file) {
+    return file.toLowerCase().endsWith(".sql");
+}
+export function isAgentSqlObjectKind(kind) {
+    return kind === "table" || kind === "view" || kind === "index" || kind === "routine";
+}
+export function isAgentSqlObjectNode(node) {
+    return isAgentSqlObjectKind(node.kind);
+}
+export function collectFileFollowUps(file) {
+    return [
+        toolFollowUp("file_deps", { file, direction: "deps" }),
+        toolFollowUp("file_deps", { file, direction: "rdeps" }),
+        toolFollowUp("chunk", { file }),
+    ];
+}
+export function collectDefinitionFollowUps(file, line, column) {
+    return [toolFollowUp("goto", { file, line, column }), toolFollowUp("refs", { file, line, column })];
+}
+//# sourceMappingURL=normalize.js.map

package/dist/agent/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/agent/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAsB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAUlE,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,IAAY;IAC/D,OAAO,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,IAAY;IACjE,OAAO,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAwB;IAC5D,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAA2B,EAAE,SAAiB;IACrF,MAAM,eAAe,GAAG,QAAQ,CAAC,UAAU,IAAI,qBAAqB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrF,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAiB,EAAE;QACxD,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxE,OAAO,eAAe,CAAC,GAAG,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,IAAI,IAAI,CAAC;IACzE,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,QAAQ,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;IACrD,OAAO,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAsB;IACzD,OAAO,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO;QACL,YAAY,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QACtD,YAAY,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;QACvD,YAAY,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAY,EAAE,IAAY,EAAE,MAAc;IACnF,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;AACtG,CAAC"}

package/dist/agent/orient.d.ts

@@ -0,0 +1,55 @@
+import type { BuildOptions } from "../indexer/types.js";
+import { type AgentSession } from "./session.js";
+import { type AgentFollowUp } from "./followUps.js";
+export type AgentOrientBudget = "small" | "medium" | "large";
+export type AgentOrientHealthMode = "skip" | "summary" | "full";
+export type AgentOrientRequest = {
+    root: string;
+    includeRoots?: string[];
+    budget?: AgentOrientBudget;
+    health?: AgentOrientHealthMode;
+    buildOptions?: BuildOptions;
+    review?: {
+        base: string;
+        head: string;
+    };
+};
+export type AgentTreeEntry = {
+    path: string;
+    kind: "directory" | "file";
+    depth: number;
+};
+export type AgentOrientationFocus = {
+    id?: number;
+    kind: "hotspot" | "file" | "review";
+    label?: string;
+    file?: string;
+    why: string;
+    followUps: AgentFollowUp[];
+};
+export type AgentPacketCommand = {
+    label: string;
+    command: string;
+};
+export type AgentOrientResponse = {
+    schemaVersion: 2;
+    root: string;
+    budget: AgentOrientBudget;
+    summary: string[];
+    focus: AgentOrientationFocus[];
+    tree: AgentTreeEntry[];
+    health: {
+        cycles: number | null;
+        unresolved: number | null;
+        duplicateGroups: number | null;
+    };
+    recommendedNext: AgentPacketCommand[];
+    omittedCounts: {
+        treeEntries: number;
+        focusTargets: number;
+        healthAnalyses: number;
+    };
+};
+export declare function orientCodegraph(request: AgentOrientRequest): Promise<AgentOrientResponse>;
+export declare function orientCodegraphWithSession(session: AgentSession, request: AgentOrientRequest): Promise<AgentOrientResponse>;
+//# sourceMappingURL=orient.d.ts.map

package/dist/agent/orient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orient.d.ts","sourceRoot":"","sources":["../../src/agent/orient.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAErE,OAAO,EAA4B,KAAK,aAAa,EAAgB,MAAM,gBAAgB,CAAC;AAE5F,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAC7D,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAEhE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAeF,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,aAAa,EAAE,CAAC,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;IACF,eAAe,EAAE,kBAAkB,EAAE,CAAC;IACtC,aAAa,EAAE;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH,CAAC;AAiBF,wBAAsB,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAQ/F;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CA+D9B"}