@openpkg-ts/sdk 0.53.1 → 0.54.1

package/README.md

@@ -89,11 +89,11 @@ const { spec, diagnostics, verification } = await extractSpec({
   maxTypeDepth: 4,
   only: ['use*'],           // filter by pattern
   ignore: ['*Internal'],    // exclude by pattern
-  followExternal: ['@ai-sdk/*'], // or true, or 'auto' with decisions: 'jev'
+  followExternal: ['@ai-sdk/*'], // or true
 });
 ```
 
-`followExternal: 'auto'` scores referenced externals with Jev and expands the load-bearing ones. Requires `decisions: 'jev'`, `AI_GATEWAY_API_KEY`, and optional peer `ai` (≥7.0.105). Specs record `generation.entryPoint` and `generation.entryPointSource` (`types` / `exports` / `fallback` / `explicit` / `llm`).
+Specs record `generation.entryPoint` and `generation.entryPointSource` (`types` / `exports` / `fallback` / `explicit` / `llm`).
 
 ### resolveTarget
 
@@ -111,7 +111,7 @@ if (resolved.kind === 'ok') {
 }
 ```
 
-`decisions: 'jev'` uses Jev when the heuristic is ambiguous. GitHub URLs clone via `gh` if present, else `git clone --depth 1`.
+GitHub URLs clone via `gh` if present, else `git clone --depth 1`.
 
 ### diffSpecs
 

package/dist/index.d.ts

@@ -1,42 +1,5 @@
 import { BreakingSeverity, CategorizedBreaking, calculateNextVersion, categorizeBreakingChanges, diffSpec, diffSpec as diffSpec2, MemberChangeInfo, recommendSemverBump, SemverBump, SemverRecommendation, SpecDiff } from "@openpkg-ts/spec";
 import { EntryPointDetectionMethod, OpenPkg } from "@openpkg-ts/spec";
-declare const JEV_MODEL = "typesafe-ai/jev";
-declare const JEV_CONFIDENCE = .5;
-type ChoiceQuestion = {
-	type: "choice";
-	instructions: string;
-	criteria: Record<string, string>;
-};
-type ScoreQuestion = {
-	type: "score";
-	instructions: string;
-	criteria: string[];
-};
-type EvaluateQuestion = ChoiceQuestion | ScoreQuestion;
-type EvaluateRequest = {
-	model: string;
-	state: unknown;
-	questions: Record<string, EvaluateQuestion>;
-	providerOptions?: {
-		gateway?: {
-			zeroDataRetention?: boolean;
-		};
-	};
-};
-type EvaluateAnswer = {
-	choice?: string;
-	score?: number;
-	probabilities?: Record<string, number>;
-};
-type EvaluateResult = {
-	answers: Record<string, EvaluateAnswer>;
-	providerMetadata?: {
-		typesafe?: {
-			confidence?: Record<string, number>;
-		};
-	};
-};
-type EvaluateFn = (request: EvaluateRequest) => Promise<EvaluateResult>;
 /** Configuration for resolving external package re-exports */
 interface ExternalsConfig {
 	/** Package patterns to resolve (globs supported, e.g., "@myorg/*") */
@@ -84,9 +47,7 @@ interface ExtractOptions {
 	* - `false` → disable the reachability-expansion pass entirely
 	* - default → workspace siblings only; everything else stubbed
 	*/
-	followExternal?: boolean | string[] | "auto";
-	evaluate?: EvaluateFn;
-	decisions?: "heuristic" | "jev";
+	followExternal?: boolean | string[];
 	/** Callback when properties are truncated */
 	onTruncation?: (typeName: string, actual: number, limit: number) => void;
 }
@@ -189,13 +150,11 @@ interface OpenpkgConfig {
 	* them as opaque stubs. `true` follows every dependency; a string[] follows
 	* only the named packages (by declaring package name). Default: stub.
 	*/
-	followExternal?: boolean | string[] | "auto";
+	followExternal?: boolean | string[];
 	/** Only extract these exports (supports * wildcards). */
 	only?: string[];
 	/** Ignore these exports (supports * wildcards). */
 	ignore?: string[];
-	/** Use Jev for package/entry routing. Requires AI_GATEWAY_API_KEY. */
-	decisions?: "heuristic" | "jev";
 }
 /** Default config filename */
 declare const CONFIG_FILENAME = "openpkg.config.json";
@@ -1077,8 +1036,6 @@ type ResolveTargetOptions = {
 	input?: string;
 	intent?: string;
 	cwd?: string;
-	decisions?: "heuristic" | "jev";
-	evaluate?: EvaluateFn;
 	clone?: CloneFn;
 };
 type ResolveOk = {
@@ -1106,11 +1063,7 @@ type ResolveExplicit = {
 	entryFile: string;
 	entryPointSource: "explicit";
 };
-type ResolveUnavailable = {
-	kind: "unavailable";
-	reason: string;
-};
-type ResolveTargetResult = (ResolveOk | ResolveAmbiguous | ResolveNeedsBuild | ResolveEmpty | ResolveExplicit | ResolveUnavailable) & {
+type ResolveTargetResult = (ResolveOk | ResolveAmbiguous | ResolveNeedsBuild | ResolveEmpty | ResolveExplicit) & {
 	/** Present when this resolution owns a temp clone. Call after extraction. */
 	cleanup?: () => void;
 };
@@ -2030,4 +1983,4 @@ declare function findDiscriminatorProperty(unionTypes: ts16.Type[], checker: ts1
 import ts17 from "typescript";
 declare function isExported(node: ts17.Node): boolean;
 declare function getNodeName(node: ts17.Node): string | undefined;
-export { zodAdapter, writtenTypeText, withDescription2 as withDescription, withDeprecated, validateSpec, valibotAdapter, typeboxAdapter, toToolSchema, toSearchIndexJSON, toSearchIndex2 as toSearchIndex, toPagefindRecords2 as toPagefindRecords, toNavigation2 as toNavigation, toMarkdown2 as toMarkdown, toJsonSchema, toJSONString, toJSON2 as toJSON, toHTML2 as toHTML, toFumadocsMetaJSON, toDocusaurusSidebarJS, toAlgoliaRecords2 as toAlgoliaRecords, stripUndefinedFromType, stripTsExtensions, sortByName, shouldEmitAliasTypeText, serializeVariable, serializeTypeAlias, serializeInterface, serializeFunctionExport, serializeEnum, serializeClass, scrubImportQualifiers, schemasAreEqual, schemaIsAny, resolveTypeRef, resolveTarget, resolveExportTarget, resolveCompiledPath, renderTypeText, registerReferencedTypes, registerAdapter, recommendSemverBump, query, pickEntry, parseGithubRepo, normalizeType, normalizeSchema, normalizeMembers, normalizeExport, mergeConfig, loadSpec, loadConfig, listExports, isTypeReference, isTypeOnlyExport, isSymbolDeprecated, isStandardJSONSchema, isSchemaType, isRemoteInput, isReadonlyPropertySymbol, isPureRefSchema, isProperty, isPrimitiveName, isPathLikeInput, isMethod, isExported, isEntryFilePath, isBuiltinSymbol, isBuiltinGeneric, isAnonymous, groupByVisibility, getValidationErrors, getTypeOrigin, getSourceLocation, getProperties, getParamDescription, getNonNullableType, getNodeName, getMethods, getMemberBadges, getJSDocComment, getExportKind, getExport2 as getExport, getAvailableVersions, toMarkdown2 as generateDocs, formatTypeParameters, formatSchema, formatReturnType, formatParameters, formatMappedType, formatConditionalType, formatBadges, findWorkspaceRoot, findDiscriminatorProperty, findAdapter, filterSpec, extractTypeParameters, extractStandardSchemasFromTs, extractStandardSchemasFromProject, extractStandardSchemas, extractSpec, extractSchemaType, extractParameters, extract, exportToMarkdown, exportToJsonSchema, ensureNonEmptySchema, diffSpec2 as diffSpecs, diffSpec, detectTsRuntime, deduplicateSchemas, decoratePropertySchema, declaredTypeNode, createProgram, createDocs, cloneRemote, categorizeBreakingChanges, catalogPackages, calculateNextVersion, bundleRefs, buildSignatureString, buildSchema, buildObjectSchema, buildFunctionSchema, assertSpec, asStandardSchema, arktypeAdapter, TypeRegistry, TypeReference2 as TypeReference, TsRuntime, ToolSchemaResult, ToolSchemaProvider, ToToolSchemaOptions, ToJsonSchemaOptions, StandardSchemaExtractionResult, StandardSchemaExtractionOutput, StandardJSONSchemaV1, StandardJSONSchemaTarget, StandardJSONSchemaOptions, SpecMappedType, SpecError, SpecDiff, SpecConditionalType, SkippedExportDetail, SimplifiedSpec, SimplifiedSignature, SimplifiedReturn, SimplifiedParameter, SimplifiedMember, SimplifiedExport, SimplifiedExample, SerializerContext, SemverRecommendation, SemverBump, SearchRecord, SearchOptions, SearchIndex, SchemaVersion, SchemaExtractionResult, SchemaAdapter, STRING_PROTOTYPE_METHODS, ResolveUnavailable, ResolveTargetResult, ResolveTargetOptions, ResolveOk, ResolveNeedsBuild, ResolveExplicit, ResolveEmpty, ResolveAmbiguous, QueryBuilder, ProjectExtractionOutput, ProjectExtractionInfo, ProgramResult, ProgramOptions, PagefindRecord, PackageRecord, PRIMITIVES, OpenpkgConfig, NormalizeOptions, NavOptions, NavItem, NavGroup, NavFormat, NUMBER_PROTOTYPE_METHODS, MemberChangeInfo, MarkdownOptions, LoadOptions, ListExportsResult, ListExportsOptions, LATEST_VERSION, JsonSchemaDocument, JSONSchema, JSONOptions, JEV_MODEL, JEV_CONFIDENCE, HTMLOptions, GroupBy, GetExportResult, GetExportOptions, GenericNav, FumadocsMetaItem, FumadocsMeta, FormatSchemaOptions, ForgottenExport, FilterResult, FilterCriteria, ExtractionWarningCode, ExtractionWarning, ExtractStandardSchemasOptions, ExtractResult, ExtractOptions, ExtractFromProjectOptions, ExternalsConfig, ExportVerification, ExportTracker, ExportMarkdownOptions, ExportItem, EvaluateResult, EvaluateRequest, EvaluateFn, DocusaurusSidebarItem, DocusaurusSidebar, DocsInstance, Diagnostic, CloneFn, CategorizedBreaking, CacheManagerOptions, CacheManager, CONFIG_FILENAME, BundleResult, BundleOptions, BuiltinSchema, BreakingSeverity, BUILTIN_TYPE_SCHEMAS, AsStandardSchemaOptions, AlgoliaRecord, ARRAY_PROTOTYPE_METHODS };
+export { zodAdapter, writtenTypeText, withDescription2 as withDescription, withDeprecated, validateSpec, valibotAdapter, typeboxAdapter, toToolSchema, toSearchIndexJSON, toSearchIndex2 as toSearchIndex, toPagefindRecords2 as toPagefindRecords, toNavigation2 as toNavigation, toMarkdown2 as toMarkdown, toJsonSchema, toJSONString, toJSON2 as toJSON, toHTML2 as toHTML, toFumadocsMetaJSON, toDocusaurusSidebarJS, toAlgoliaRecords2 as toAlgoliaRecords, stripUndefinedFromType, stripTsExtensions, sortByName, shouldEmitAliasTypeText, serializeVariable, serializeTypeAlias, serializeInterface, serializeFunctionExport, serializeEnum, serializeClass, scrubImportQualifiers, schemasAreEqual, schemaIsAny, resolveTypeRef, resolveTarget, resolveExportTarget, resolveCompiledPath, renderTypeText, registerReferencedTypes, registerAdapter, recommendSemverBump, query, pickEntry, parseGithubRepo, normalizeType, normalizeSchema, normalizeMembers, normalizeExport, mergeConfig, loadSpec, loadConfig, listExports, isTypeReference, isTypeOnlyExport, isSymbolDeprecated, isStandardJSONSchema, isSchemaType, isRemoteInput, isReadonlyPropertySymbol, isPureRefSchema, isProperty, isPrimitiveName, isPathLikeInput, isMethod, isExported, isEntryFilePath, isBuiltinSymbol, isBuiltinGeneric, isAnonymous, groupByVisibility, getValidationErrors, getTypeOrigin, getSourceLocation, getProperties, getParamDescription, getNonNullableType, getNodeName, getMethods, getMemberBadges, getJSDocComment, getExportKind, getExport2 as getExport, getAvailableVersions, toMarkdown2 as generateDocs, formatTypeParameters, formatSchema, formatReturnType, formatParameters, formatMappedType, formatConditionalType, formatBadges, findWorkspaceRoot, findDiscriminatorProperty, findAdapter, filterSpec, extractTypeParameters, extractStandardSchemasFromTs, extractStandardSchemasFromProject, extractStandardSchemas, extractSpec, extractSchemaType, extractParameters, extract, exportToMarkdown, exportToJsonSchema, ensureNonEmptySchema, diffSpec2 as diffSpecs, diffSpec, detectTsRuntime, deduplicateSchemas, decoratePropertySchema, declaredTypeNode, createProgram, createDocs, cloneRemote, categorizeBreakingChanges, catalogPackages, calculateNextVersion, bundleRefs, buildSignatureString, buildSchema, buildObjectSchema, buildFunctionSchema, assertSpec, asStandardSchema, arktypeAdapter, TypeRegistry, TypeReference2 as TypeReference, TsRuntime, ToolSchemaResult, ToolSchemaProvider, ToToolSchemaOptions, ToJsonSchemaOptions, StandardSchemaExtractionResult, StandardSchemaExtractionOutput, StandardJSONSchemaV1, StandardJSONSchemaTarget, StandardJSONSchemaOptions, SpecMappedType, SpecError, SpecDiff, SpecConditionalType, SkippedExportDetail, SimplifiedSpec, SimplifiedSignature, SimplifiedReturn, SimplifiedParameter, SimplifiedMember, SimplifiedExport, SimplifiedExample, SerializerContext, SemverRecommendation, SemverBump, SearchRecord, SearchOptions, SearchIndex, SchemaVersion, SchemaExtractionResult, SchemaAdapter, STRING_PROTOTYPE_METHODS, ResolveTargetResult, ResolveTargetOptions, ResolveOk, ResolveNeedsBuild, ResolveExplicit, ResolveEmpty, ResolveAmbiguous, QueryBuilder, ProjectExtractionOutput, ProjectExtractionInfo, ProgramResult, ProgramOptions, PagefindRecord, PackageRecord, PRIMITIVES, OpenpkgConfig, NormalizeOptions, NavOptions, NavItem, NavGroup, NavFormat, NUMBER_PROTOTYPE_METHODS, MemberChangeInfo, MarkdownOptions, LoadOptions, ListExportsResult, ListExportsOptions, LATEST_VERSION, JsonSchemaDocument, JSONSchema, JSONOptions, HTMLOptions, GroupBy, GetExportResult, GetExportOptions, GenericNav, FumadocsMetaItem, FumadocsMeta, FormatSchemaOptions, ForgottenExport, FilterResult, FilterCriteria, ExtractionWarningCode, ExtractionWarning, ExtractStandardSchemasOptions, ExtractResult, ExtractOptions, ExtractFromProjectOptions, ExternalsConfig, ExportVerification, ExportTracker, ExportMarkdownOptions, ExportItem, DocusaurusSidebarItem, DocusaurusSidebar, DocsInstance, Diagnostic, CloneFn, CategorizedBreaking, CacheManagerOptions, CacheManager, CONFIG_FILENAME, BundleResult, BundleOptions, BuiltinSchema, BreakingSeverity, BUILTIN_TYPE_SCHEMAS, AsStandardSchemaOptions, AlgoliaRecord, ARRAY_PROTOTYPE_METHODS };

package/dist/index.js

@@ -78,70 +78,9 @@ function mergeConfig(fileConfig, cliOptions) {
     ...hasExternals ? { externals } : {},
     followExternal: cliOptions.followExternal ?? fileConfig.followExternal,
     only: cliOptions.only ?? fileConfig.only,
-    ignore: cliOptions.ignore ?? fileConfig.ignore,
-    decisions: cliOptions.decisions ?? fileConfig.decisions
+    ignore: cliOptions.ignore ?? fileConfig.ignore
   };
 }
-// src/core/decisions.ts
-var JEV_MODEL = "typesafe-ai/jev";
-var JEV_CONFIDENCE = 0.5;
-var MAX_JEV_QUESTIONS = 50;
-async function loadEvaluate() {
-  try {
-    const specifier = "ai";
-    const mod = await import(specifier);
-    if (typeof mod.experimental_evaluate !== "function") {
-      throw new Error("ai.experimental_evaluate is not a function");
-    }
-    return (request) => mod.experimental_evaluate({
-      ...request,
-      providerOptions: {
-        gateway: { zeroDataRetention: true },
-        ...request.providerOptions
-      }
-    });
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    throw new Error(`--jev requires the ai package (AI SDK ≥7.0.105): bun add ai
-${msg}`);
-  }
-}
-function namedConfidence(result, id) {
-  const named = result.providerMetadata?.typesafe?.confidence?.[id];
-  return typeof named === "number" ? named : undefined;
-}
-function choiceConfidence(result, id, choice) {
-  const named = namedConfidence(result, id);
-  if (named !== undefined)
-    return named;
-  const p = result.answers[id]?.probabilities?.[choice];
-  return typeof p === "number" ? p : 0;
-}
-async function jevEvaluate(evaluate, state, questions) {
-  return evaluate({
-    model: JEV_MODEL,
-    state: JSON.parse(JSON.stringify(state)),
-    questions,
-    providerOptions: { gateway: { zeroDataRetention: true } }
-  });
-}
-async function jevChoice(args) {
-  const keys = Object.keys(args.criteria);
-  if (keys.length < 2)
-    return null;
-  const id = args.id ?? "choice";
-  const result = await jevEvaluate(args.evaluate, args.state, {
-    [id]: {
-      type: "choice",
-      instructions: args.instructions,
-      criteria: args.criteria
-    }
-  });
-  const choice = result.answers[id]?.choice;
-  if (!choice || !(choice in args.criteria))
-    return null;
-  return { choice, confidence: choiceConfidence(result, id, choice) };
-}
 // src/core/loader.ts
 import * as fs2 from "node:fs";
 import { validateSpec } from "@openpkg-ts/spec";
@@ -1612,10 +1551,6 @@ function pickEntry(pkgDir) {
   const best = [...cands].sort((a, b) => scoreCandidate(b) - scoreCandidate(a))[0];
   return { entryFile: best.abs, entryPointSource: methodFor(best) };
 }
-function listEntryCandidates(pkgDir) {
-  const pkg = readJson(path2.join(pkgDir, "package.json")) ?? {};
-  return collectCandidates(pkgDir, pkg);
-}
 function isIgnoredPath(dir) {
   const norm = dir.split(path2.sep).join("/");
   return /\/(examples|fixtures|__tests__|test-fixtures)(\/|$)/.test(norm);
@@ -1666,80 +1601,9 @@ function buildCommand(pkg) {
     return "bun run build";
   return;
 }
-function head(abs, maxChars = 1200) {
-  try {
-    return fs3.readFileSync(abs, "utf8").slice(0, maxChars);
-  } catch {
-    return "";
-  }
-}
-var PACKAGE_NONE = "none";
-async function jevPickPackage(candidates, ctx) {
-  if (!ctx.evaluate || candidates.length < 2)
-    return null;
-  const criteria = {};
-  const byId = new Map;
-  for (const [i, pkg] of candidates.entries()) {
-    const id = `p${i}`;
-    byId.set(id, pkg);
-    criteria[id] = `${pkg.name} — ${pkg.description ?? pkg.dir}${pkg.hasSrc ? " (src)" : ""}`;
-  }
-  criteria[PACKAGE_NONE] = "No single package is the product — these are peer libraries";
-  const picked = await jevChoice({
-    evaluate: ctx.evaluate,
-    instructions: "Which package is the public TypeScript SDK to extract? Prefer the named product, not examples, wasm glue, or private packages.",
-    criteria,
-    state: {
-      intent: ctx.intent ?? null,
-      catalog: candidates.map((p, i) => ({
-        id: `p${i}`,
-        name: p.name,
-        description: p.description ?? null,
-        hasSrc: p.hasSrc,
-        hasDist: p.hasDist,
-        types: p.types ?? p.typings ?? null,
-        private: p.private
-      }))
-    },
-    id: "package"
-  });
-  if (!picked || picked.choice === PACKAGE_NONE)
-    return null;
-  if (picked.confidence < JEV_CONFIDENCE)
-    return null;
-  return byId.get(picked.choice) ?? null;
-}
-async function jevPickEntry(cands, ctx) {
-  if (!ctx.evaluate || cands.length < 2)
-    return null;
-  const criteria = {};
-  const byId = new Map;
-  for (const [i, c] of cands.entries()) {
-    const id = `c${i}`;
-    byId.set(id, c);
-    criteria[id] = `${c.rel} (${c.source})`;
-  }
-  const picked = await jevChoice({
-    evaluate: ctx.evaluate,
-    instructions: "Which file is the best OpenPkg entry point? Prefer TypeScript source over .d.ts/.js. Prefer the package root public API.",
-    criteria,
-    state: {
-      candidates: cands.map((c, i) => ({
-        id: `c${i}`,
-        path: c.rel,
-        source: c.source,
-        head: head(c.abs)
-      }))
-    },
-    id: "entry"
-  });
-  if (!picked || picked.confidence < JEV_CONFIDENCE)
-    return null;
-  return byId.get(picked.choice) ?? null;
-}
-async function finishPackage(pkg, ctx) {
-  const cands = listEntryCandidates(pkg.dir);
-  if (!cands.length) {
+function finishPackage(pkg) {
+  const picked = pickEntry(pkg.dir);
+  if (!picked) {
     return {
       kind: "needs-build",
       package: pkg,
@@ -1747,24 +1611,9 @@ async function finishPackage(pkg, ctx) {
       ...buildCommand(pkg) ? { command: buildCommand(pkg) } : {}
     };
   }
-  const heuristic = [...cands].sort((a, b) => scoreCandidate(b) - scoreCandidate(a))[0];
-  let chosen = heuristic;
-  let source = methodFor(heuristic);
-  if (ctx.decisions === "jev" && cands.length >= 2) {
-    const jev = await jevPickEntry(cands, ctx);
-    if (jev) {
-      chosen = jev;
-      source = "llm";
-    }
-  }
-  return {
-    kind: "ok",
-    package: pkg,
-    entryFile: chosen.abs,
-    entryPointSource: source
-  };
+  return { kind: "ok", package: pkg, ...picked };
 }
-async function resolveLocal(abs, startDir, ctx) {
+function resolveLocal(abs, startDir, intent) {
   const catalog = catalogPackages(startDir);
   if (!catalog.length) {
     return { kind: "empty", reason: "no JS/TS packages found" };
@@ -1772,9 +1621,8 @@ async function resolveLocal(abs, startDir, ctx) {
   const root = findWorkspaceRoot(startDir);
   const pointed = catalog.find((p) => p.dir === abs);
   if (pointed && (isExtractable(pointed) || pointed.dir !== root)) {
-    return finishPackage(pointed, ctx);
+    return finishPackage(pointed);
   }
-  const intent = ctx.intent;
   if (intent) {
     const scored = catalog.map((p) => ({ p, n: intentScore(p, intent) })).filter((x) => x.n > 0).sort((a, b) => b.n - a.n);
     if (!scored.length) {
@@ -1782,61 +1630,30 @@ async function resolveLocal(abs, startDir, ctx) {
     }
     const top = scored.filter((x) => x.n === scored[0].n).map((x) => x.p);
     if (top.length === 1)
-      return finishPackage(top[0], ctx);
-    if (ctx.decisions === "jev") {
-      const jev = await jevPickPackage(top, ctx);
-      if (jev)
-        return finishPackage(jev, ctx);
-    }
+      return finishPackage(top[0]);
     return { kind: "ambiguous", candidates: top };
   }
   const enclosed = enclosingPackage(startDir, catalog);
   if (enclosed && enclosed.dir !== root)
-    return finishPackage(enclosed, ctx);
+    return finishPackage(enclosed);
   const extractable = catalog.filter(isExtractable);
   if (extractable.length === 1)
-    return finishPackage(extractable[0], ctx);
-  if (extractable.length > 1) {
-    if (ctx.decisions === "jev") {
-      const jev = await jevPickPackage(extractable, ctx);
-      if (jev)
-        return finishPackage(jev, ctx);
-    }
+    return finishPackage(extractable[0]);
+  if (extractable.length > 1)
     return { kind: "ambiguous", candidates: extractable };
-  }
   if (catalog.length === 1)
-    return finishPackage(catalog[0], ctx);
+    return finishPackage(catalog[0]);
   return { kind: "empty", reason: "no extractable JS/TS packages found" };
 }
 async function resolveTarget(options = {}) {
   const cwd = path2.resolve(options.cwd ?? process.cwd());
   const raw = options.input?.trim() || cwd;
-  const decisions = options.decisions ?? "heuristic";
-  const ctx = {
-    decisions,
-    evaluate: options.evaluate,
-    intent: options.intent?.trim() || undefined
-  };
-  if (decisions === "jev" && !ctx.evaluate) {
-    if (!process.env.AI_GATEWAY_API_KEY) {
-      return {
-        kind: "unavailable",
-        reason: `--jev requires AI_GATEWAY_API_KEY
-  https://vercel.com/docs/ai-gateway
-  omit --jev to stay local`
-      };
-    }
-    try {
-      ctx.evaluate = await loadEvaluate();
-    } catch (err) {
-      return { kind: "unavailable", reason: err instanceof Error ? err.message : String(err) };
-    }
-  }
+  const intent = options.intent?.trim() || undefined;
   if (isRemoteInput(raw)) {
     const owned = !options.clone;
     try {
       const cloned = await (options.clone ?? cloneRemote)(raw);
-      const result = await resolveLocal(cloned, cloned, ctx);
+      const result = resolveLocal(cloned, cloned, intent);
       if (!owned)
         return result;
       return {
@@ -1858,7 +1675,7 @@ async function resolveTarget(options = {}) {
     return { kind: "empty", reason: `input does not exist: ${options.input?.trim() || raw}` };
   }
   const startDir = existsDir(abs) ? abs : cwd;
-  return resolveLocal(abs, startDir, ctx);
+  return resolveLocal(abs, startDir, intent);
 }
 // src/primitives/filter.ts
 function matchesExport(exp, criteria) {
@@ -1966,9 +1783,85 @@ function filterSpec(spec, criteria) {
 // src/primitives/get.ts
 import ts13 from "typescript";
 
-// src/ast/utils.ts
+// src/ast/type-identity.ts
 import * as path3 from "node:path";
 import ts from "typescript";
+var NODE_MODULES_PKG = /node_modules\/(@[^/]+\/[^/]+|[^/]+)/g;
+function isLibFile(fileName) {
+  return fileName.includes("/typescript/lib/lib.") || fileName.includes("\\typescript\\lib\\lib.");
+}
+function packageNameFromPath(fileName) {
+  return [...fileName.matchAll(NODE_MODULES_PKG)].at(-1)?.[1];
+}
+function packageLabel(fileName, workspacePackages) {
+  let pkg = packageNameFromPath(fileName);
+  if (!pkg) {
+    for (const [name, dir] of workspacePackages) {
+      if (fileName.startsWith(`${path3.resolve(dir)}${path3.sep}`)) {
+        pkg = name;
+        break;
+      }
+    }
+  }
+  return (pkg ?? "local").replace(/^@/, "").replace(/\//g, "-");
+}
+function declKey(symbol, checker) {
+  let resolved = symbol;
+  if (symbol.flags & ts.SymbolFlags.Alias) {
+    try {
+      resolved = checker.getAliasedSymbol(symbol);
+    } catch {}
+  }
+  const decl = resolved.declarations?.[0];
+  if (!decl)
+    return;
+  return `${decl.getSourceFile().fileName}#${decl.getStart()}`;
+}
+function resolveTypeId(symbol, ctx) {
+  const cached = ctx.typeIds.get(symbol);
+  if (cached)
+    return cached;
+  const key = declKey(symbol, ctx.typeChecker);
+  if (key) {
+    const existing = ctx.declIds.get(key);
+    if (existing) {
+      ctx.typeIds.set(symbol, existing);
+      return existing;
+    }
+  }
+  const claim = (id) => {
+    ctx.typeIds.set(symbol, id);
+    if (key)
+      ctx.declIds.set(key, id);
+    ctx.idOwner.set(id, key ?? id);
+    return id;
+  };
+  const name = symbol.getName();
+  const owner = ctx.idOwner.get(name);
+  if (!owner || owner === key)
+    return claim(name);
+  const file = symbol.declarations?.[0]?.getSourceFile().fileName ?? "";
+  const scoped = `${packageLabel(file, ctx.workspacePackages)}.${name}`;
+  const scopedOwner = ctx.idOwner.get(scoped);
+  if (!scopedOwner || scopedOwner === key)
+    return claim(scoped);
+  let n = 2;
+  while (ctx.idOwner.has(`${name}_${n}`))
+    n++;
+  return claim(`${name}_${n}`);
+}
+function typeRefId(type, ctx) {
+  const symbol = type.aliasSymbol ?? type.getSymbol();
+  if (!symbol)
+    return "";
+  if (!ctx)
+    return symbol.getName();
+  return resolveTypeId(symbol, ctx);
+}
+
+// src/ast/utils.ts
+import * as path4 from "node:path";
+import ts2 from "typescript";
 var INLINE_TAG_RE = /(^|[^\\])\{@([a-zA-Z][a-zA-Z0-9]*)((?:[^}\\]|\\.)*)\}/g;
 function parseInlineTags(...texts) {
   const inlineTags = [];
@@ -2062,12 +1955,12 @@ function extractSeeTagText(tag) {
     if (Array.isArray(tag.comment)) {
       const parts = [];
       for (const part of tag.comment) {
-        if (ts.isJSDocLink(part) || ts.isJSDocLinkCode(part) || ts.isJSDocLinkPlain(part)) {
+        if (ts2.isJSDocLink(part) || ts2.isJSDocLinkCode(part) || ts2.isJSDocLinkPlain(part)) {
           if (part.name) {
             try {
               parts.push(part.name.getText());
             } catch {
-              if (ts.isIdentifier(part.name)) {
+              if (ts2.isIdentifier(part.name)) {
                 parts.push(part.name.text);
               }
             }
@@ -2075,7 +1968,7 @@ function extractSeeTagText(tag) {
           if (part.text) {
             parts.push(part.text);
           }
-        } else if (part.kind === ts.SyntaxKind.JSDocText) {
+        } else if (part.kind === ts2.SyntaxKind.JSDocText) {
           parts.push(part.text);
         }
       }
@@ -2084,13 +1977,13 @@ function extractSeeTagText(tag) {
         return result;
     }
   }
-  return typeof tag.comment === "string" ? tag.comment : ts.getTextOfJSDocComment(tag.comment) ?? "";
+  return typeof tag.comment === "string" ? tag.comment : ts2.getTextOfJSDocComment(tag.comment) ?? "";
 }
 function getJSDocComment(node, symbol, checker) {
-  const jsDocTags = ts.getJSDocTags(node);
+  const jsDocTags = ts2.getJSDocTags(node);
   const commentLevelTags = [];
   const tags = jsDocTags.map((tag) => {
-    const rawText = typeof tag.comment === "string" ? tag.comment : ts.getTextOfJSDocComment(tag.comment) ?? "";
+    const rawText = typeof tag.comment === "string" ? tag.comment : ts2.getTextOfJSDocComment(tag.comment) ?? "";
     const { retained, hoisted } = tag.tagName.text === "see" ? { retained: rawText, hoisted: [] } : splitCommentLevelTags(rawText);
     commentLevelTags.push(...hoisted);
     if (tag.tagName.text === "param") {
@@ -2127,12 +2020,12 @@ function getJSDocComment(node, symbol, checker) {
     }
     return withInlineTags({ name: tag.tagName.text, text: rawText }, retained);
   });
-  const jsDocComments = ts.getJSDocCommentsAndTags(node).filter(ts.isJSDoc);
+  const jsDocComments = ts2.getJSDocCommentsAndTags(node).filter(ts2.isJSDoc);
   let description;
   if (jsDocComments.length > 0) {
     const firstDoc = jsDocComments[0];
     if (firstDoc.comment) {
-      description = typeof firstDoc.comment === "string" ? firstDoc.comment : ts.getTextOfJSDocComment(firstDoc.comment);
+      description = typeof firstDoc.comment === "string" ? firstDoc.comment : ts2.getTextOfJSDocComment(firstDoc.comment);
     }
   }
   if (!description && symbol && checker) {
@@ -2153,7 +2046,7 @@ function getJSDocComment(node, symbol, checker) {
 }
 function getSourceLocation(node, sourceFile) {
   const { line } = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
-  const relative3 = path3.relative(process.cwd(), sourceFile.fileName);
+  const relative3 = path4.relative(process.cwd(), sourceFile.fileName);
   const file = relative3.startsWith("..") ? sourceFile.fileName : relative3;
   return {
     file,
@@ -2173,7 +2066,7 @@ function getParamDescription(propertyName, jsdocTags, inferredAlias) {
     }
     const isMatch = tagParamName === propertyName || inferredAlias && tagParamName === `${inferredAlias}.${propertyName}` || tagParamName.endsWith(`.${propertyName}`);
     if (isMatch) {
-      const comment = typeof tag.comment === "string" ? tag.comment : ts.getTextOfJSDocComment(tag.comment);
+      const comment = typeof tag.comment === "string" ? tag.comment : ts2.getTextOfJSDocComment(tag.comment);
       return stripParamSeparator(comment);
     }
   }
@@ -2186,11 +2079,11 @@ function extractVarianceModifiers(modifiers) {
   let hasOut = false;
   let isConst;
   for (const mod of modifiers) {
-    if (mod.kind === ts.SyntaxKind.InKeyword)
+    if (mod.kind === ts2.SyntaxKind.InKeyword)
       hasIn = true;
-    if (mod.kind === ts.SyntaxKind.OutKeyword)
+    if (mod.kind === ts2.SyntaxKind.OutKeyword)
       hasOut = true;
-    if (mod.kind === ts.SyntaxKind.ConstKeyword)
+    if (mod.kind === ts2.SyntaxKind.ConstKeyword)
       isConst = true;
   }
   const variance = hasIn && hasOut ? "inout" : hasIn ? "in" : hasOut ? "out" : undefined;
@@ -2212,7 +2105,7 @@ function extractTypeParameters(node, checker) {
       const defType = checker.getTypeAtLocation(tp.default);
       defaultType = checker.typeToString(defType);
     }
-    const { variance, isConst } = extractVarianceModifiers(ts.getModifiers(tp));
+    const { variance, isConst } = extractVarianceModifiers(ts2.getModifiers(tp));
     return {
       name,
       ...constraint ? { constraint } : {},
@@ -2233,7 +2126,7 @@ function isSymbolDeprecated(symbol) {
     return { deprecated: true, reason };
   }
   for (const declaration of symbol.getDeclarations() ?? []) {
-    const tag = ts.getJSDocDeprecatedTag(declaration);
+    const tag = ts2.getJSDocDeprecatedTag(declaration);
     if (tag) {
       let reason;
       if (typeof tag.comment === "string") {
@@ -2243,10 +2136,10 @@ function isSymbolDeprecated(symbol) {
       }
       return { deprecated: true, reason };
     }
-    if (ts.isExportSpecifier(declaration)) {
+    if (ts2.isExportSpecifier(declaration)) {
       const exportDecl = declaration.parent?.parent;
-      if (exportDecl && ts.isExportDeclaration(exportDecl)) {
-        const parentTag = ts.getJSDocDeprecatedTag(exportDecl);
+      if (exportDecl && ts2.isExportDeclaration(exportDecl)) {
+        const parentTag = ts2.getJSDocDeprecatedTag(exportDecl);
         if (parentTag) {
           let reason;
           if (typeof parentTag.comment === "string") {
@@ -2291,8 +2184,8 @@ function extractTypeParametersFromSignature(signature, checker) {
     const tpSymbol = tp.getSymbol();
     const declarations = tpSymbol?.getDeclarations() ?? [];
     for (const decl of declarations) {
-      if (ts.isTypeParameterDeclaration(decl)) {
-        ({ variance, isConst } = extractVarianceModifiers(ts.getModifiers(decl)));
+      if (ts2.isTypeParameterDeclaration(decl)) {
+        ({ variance, isConst } = extractVarianceModifiers(ts2.getModifiers(decl)));
         break;
       }
     }
@@ -2306,60 +2199,60 @@ function extractTypeParametersFromSignature(signature, checker) {
   });
 }
 function getExportKind(declaration, type) {
-  if (ts.isFunctionDeclaration(declaration) || ts.isFunctionExpression(declaration))
+  if (ts2.isFunctionDeclaration(declaration) || ts2.isFunctionExpression(declaration))
     return "function";
-  if (ts.isClassDeclaration(declaration))
+  if (ts2.isClassDeclaration(declaration))
     return "class";
-  if (ts.isInterfaceDeclaration(declaration))
+  if (ts2.isInterfaceDeclaration(declaration))
     return "interface";
-  if (ts.isTypeAliasDeclaration(declaration))
+  if (ts2.isTypeAliasDeclaration(declaration))
     return "type";
-  if (ts.isEnumDeclaration(declaration))
+  if (ts2.isEnumDeclaration(declaration))
     return "enum";
-  if (ts.isModuleDeclaration(declaration) || ts.isNamespaceExport(declaration))
+  if (ts2.isModuleDeclaration(declaration) || ts2.isNamespaceExport(declaration))
     return "namespace";
-  if (ts.isVariableDeclaration(declaration) && type.getConstructSignatures().length > 0)
+  if (ts2.isVariableDeclaration(declaration) && type.getConstructSignatures().length > 0)
     return "class";
-  if (ts.isVariableDeclaration(declaration) && type.getCallSignatures().length > 0)
+  if (ts2.isVariableDeclaration(declaration) && type.getCallSignatures().length > 0)
     return "function";
   return "variable";
 }
 
 // src/compiler/program.ts
 import * as fs4 from "node:fs";
-import * as path4 from "node:path";
-import ts2 from "typescript";
+import * as path5 from "node:path";
+import ts3 from "typescript";
 function isJsFile(file) {
   return /\.(js|mjs|cjs|jsx)$/.test(file);
 }
 function getScriptKind(file) {
   if (/\.tsx$/.test(file))
-    return ts2.ScriptKind.TSX;
+    return ts3.ScriptKind.TSX;
   if (/\.jsx$/.test(file))
-    return ts2.ScriptKind.JSX;
+    return ts3.ScriptKind.JSX;
   if (/\.(js|mjs|cjs)$/.test(file))
-    return ts2.ScriptKind.JS;
-  return ts2.ScriptKind.TS;
+    return ts3.ScriptKind.JS;
+  return ts3.ScriptKind.TS;
 }
 var DEFAULT_COMPILER_OPTIONS = {
-  target: ts2.ScriptTarget.Latest,
-  module: ts2.ModuleKind.NodeNext,
+  target: ts3.ScriptTarget.Latest,
+  module: ts3.ModuleKind.NodeNext,
   lib: ["lib.es2021.d.ts"],
   declaration: true,
-  moduleResolution: ts2.ModuleResolutionKind.NodeNext,
+  moduleResolution: ts3.ModuleResolutionKind.NodeNext,
   strict: true
 };
 function resolveWorkspaceEntry(pkgDir) {
   const candidates = [
-    path4.join(pkgDir, "src", "index.ts"),
-    path4.join(pkgDir, "src", "index.tsx"),
-    path4.join(pkgDir, "index.ts")
+    path5.join(pkgDir, "src", "index.ts"),
+    path5.join(pkgDir, "src", "index.tsx"),
+    path5.join(pkgDir, "index.ts")
   ];
   try {
-    const pkg = JSON.parse(fs4.readFileSync(path4.join(pkgDir, "package.json"), "utf-8"));
+    const pkg = JSON.parse(fs4.readFileSync(path5.join(pkgDir, "package.json"), "utf-8"));
     for (const field of [pkg.types, pkg.typings]) {
       if (typeof field === "string") {
-        candidates.push(path4.resolve(pkgDir, field));
+        candidates.push(path5.resolve(pkgDir, field));
       }
     }
   } catch {}
@@ -2371,51 +2264,51 @@ function isDirentDir2(parent, entry) {
   if (!entry.isSymbolicLink())
     return false;
   try {
-    return fs4.statSync(path4.join(parent, entry.name)).isDirectory();
+    return fs4.statSync(path5.join(parent, entry.name)).isDirectory();
   } catch {
     return false;
   }
 }
 function extensionOf(file) {
   if (file.endsWith(".d.mts"))
-    return ts2.Extension.Dmts;
+    return ts3.Extension.Dmts;
   if (file.endsWith(".d.cts"))
-    return ts2.Extension.Dcts;
+    return ts3.Extension.Dcts;
   if (file.endsWith(".d.ts"))
-    return ts2.Extension.Dts;
+    return ts3.Extension.Dts;
   if (file.endsWith(".mts"))
-    return ts2.Extension.Mts;
+    return ts3.Extension.Mts;
   if (file.endsWith(".cts"))
-    return ts2.Extension.Cts;
+    return ts3.Extension.Cts;
   if (file.endsWith(".tsx"))
-    return ts2.Extension.Tsx;
+    return ts3.Extension.Tsx;
   if (file.endsWith(".ts"))
-    return ts2.Extension.Ts;
+    return ts3.Extension.Ts;
   if (file.endsWith(".mjs"))
-    return ts2.Extension.Mjs;
+    return ts3.Extension.Mjs;
   if (file.endsWith(".cjs"))
-    return ts2.Extension.Cjs;
+    return ts3.Extension.Cjs;
   if (file.endsWith(".jsx"))
-    return ts2.Extension.Jsx;
+    return ts3.Extension.Jsx;
   if (file.endsWith(".js"))
-    return ts2.Extension.Js;
-  return ts2.Extension.Ts;
+    return ts3.Extension.Js;
+  return ts3.Extension.Ts;
 }
 function resolveProjectReferences(configPath, parsedConfig) {
   const additionalFiles = [];
   if (!parsedConfig.projectReferences?.length) {
     return additionalFiles;
   }
-  const configDir = path4.dirname(configPath);
+  const configDir = path5.dirname(configPath);
   for (const ref of parsedConfig.projectReferences) {
-    const refPath = path4.resolve(configDir, ref.path);
-    const refConfigPath = fs4.existsSync(path4.join(refPath, "tsconfig.json")) ? path4.join(refPath, "tsconfig.json") : refPath;
+    const refPath = path5.resolve(configDir, ref.path);
+    const refConfigPath = fs4.existsSync(path5.join(refPath, "tsconfig.json")) ? path5.join(refPath, "tsconfig.json") : refPath;
     if (!fs4.existsSync(refConfigPath))
       continue;
-    const refConfigFile = ts2.readConfigFile(refConfigPath, ts2.sys.readFile);
+    const refConfigFile = ts3.readConfigFile(refConfigPath, ts3.sys.readFile);
     if (refConfigFile.error)
       continue;
-    const refParsed = ts2.parseJsonConfigFileContent(refConfigFile.config, ts2.sys, path4.dirname(refConfigPath));
+    const refParsed = ts3.parseJsonConfigFileContent(refConfigFile.config, ts3.sys, path5.dirname(refConfigPath));
     additionalFiles.push(...refParsed.fileNames);
   }
   return additionalFiles;
@@ -2448,7 +2341,7 @@ function buildWorkspaceMap(baseDir) {
   let rootDir;
   let workspaceGlobs2 = [];
   for (let i = 0;i < 10; i++) {
-    const pnpmPath = path4.join(currentDir, "pnpm-workspace.yaml");
+    const pnpmPath = path5.join(currentDir, "pnpm-workspace.yaml");
     if (fs4.existsSync(pnpmPath)) {
       try {
         const yamlContent = fs4.readFileSync(pnpmPath, "utf-8");
@@ -2459,7 +2352,7 @@ function buildWorkspaceMap(baseDir) {
         }
       } catch {}
     }
-    const pkgPath = path4.join(currentDir, "package.json");
+    const pkgPath = path5.join(currentDir, "package.json");
     if (fs4.existsSync(pkgPath)) {
       try {
         const pkg = JSON.parse(fs4.readFileSync(pkgPath, "utf-8"));
@@ -2470,7 +2363,7 @@ function buildWorkspaceMap(baseDir) {
         }
       } catch {}
     }
-    const parent = path4.dirname(currentDir);
+    const parent = path5.dirname(currentDir);
     if (parent === currentDir)
       break;
     currentDir = parent;
@@ -2479,15 +2372,15 @@ function buildWorkspaceMap(baseDir) {
     return;
   const packages = new Map;
   for (const glob of workspaceGlobs2) {
-    const globDir = path4.join(rootDir, glob.replace(/\/\*$/, ""));
+    const globDir = path5.join(rootDir, glob.replace(/\/\*$/, ""));
     if (!fs4.existsSync(globDir) || !fs4.statSync(globDir).isDirectory())
       continue;
     const entries = fs4.readdirSync(globDir, { withFileTypes: true });
     for (const entry of entries) {
       if (!isDirentDir2(globDir, entry))
         continue;
-      const pkgDir = path4.join(globDir, entry.name);
-      const pkgJsonPath = path4.join(pkgDir, "package.json");
+      const pkgDir = path5.join(globDir, entry.name);
+      const pkgJsonPath = path5.join(pkgDir, "package.json");
       if (!fs4.existsSync(pkgJsonPath))
         continue;
       try {
@@ -2505,7 +2398,7 @@ function discoverAmbientTypePackages(baseDir) {
   const seen = new Set;
   let currentDir = baseDir;
   for (let i = 0;i < 10; i++) {
-    const typesDir = path4.join(currentDir, "node_modules", "@types");
+    const typesDir = path5.join(currentDir, "node_modules", "@types");
     try {
       if (fs4.existsSync(typesDir) && fs4.statSync(typesDir).isDirectory()) {
         for (const entry of fs4.readdirSync(typesDir, { withFileTypes: true })) {
@@ -2518,7 +2411,7 @@ function discoverAmbientTypePackages(baseDir) {
         }
       }
     } catch {}
-    const parent = path4.dirname(currentDir);
+    const parent = path5.dirname(currentDir);
     if (parent === currentDir)
       break;
     currentDir = parent;
@@ -2527,24 +2420,24 @@ function discoverAmbientTypePackages(baseDir) {
 }
 function createProgram(options) {
   const { content } = options;
-  const entryFile = path4.resolve(options.entryFile);
-  const baseDir = path4.resolve(options.baseDir ?? path4.dirname(entryFile));
-  let configPath = ts2.findConfigFile(baseDir, ts2.sys.fileExists, "tsconfig.json");
+  const entryFile = path5.resolve(options.entryFile);
+  const baseDir = path5.resolve(options.baseDir ?? path5.dirname(entryFile));
+  let configPath = ts3.findConfigFile(baseDir, ts3.sys.fileExists, "tsconfig.json");
   if (!configPath) {
-    configPath = ts2.findConfigFile(baseDir, ts2.sys.fileExists, "jsconfig.json");
+    configPath = ts3.findConfigFile(baseDir, ts3.sys.fileExists, "jsconfig.json");
   }
   let compilerOptions = { ...DEFAULT_COMPILER_OPTIONS };
   let additionalRootFiles = [];
   if (configPath) {
-    const configFile = ts2.readConfigFile(configPath, ts2.sys.readFile);
-    const parsedConfig = ts2.parseJsonConfigFileContent(configFile.config, ts2.sys, path4.dirname(configPath));
+    const configFile = ts3.readConfigFile(configPath, ts3.sys.readFile);
+    const parsedConfig = ts3.parseJsonConfigFileContent(configFile.config, ts3.sys, path5.dirname(configPath));
     compilerOptions = { ...compilerOptions, ...parsedConfig.options };
     additionalRootFiles = resolveProjectReferences(configPath, parsedConfig);
     let sourceFiles = parsedConfig.fileNames.filter((f) => !f.includes(".test.") && !f.includes(".spec.") && !f.includes("/dist/") && !f.includes("/node_modules/"));
     if (/\.d\.[cm]?ts$/.test(entryFile)) {
       sourceFiles = sourceFiles.filter((f) => {
         try {
-          return !ts2.getOutputFileNames(parsedConfig, f, !ts2.sys.useCaseSensitiveFileNames).some((out) => path4.resolve(out) === entryFile);
+          return !ts3.getOutputFileNames(parsedConfig, f, !ts3.sys.useCaseSensitiveFileNames).some((out) => path5.resolve(out) === entryFile);
         } catch {
           return true;
         }
@@ -2572,7 +2465,7 @@ function createProgram(options) {
     }
   }
   const workspaceMap = buildWorkspaceMap(baseDir);
-  const compilerHost = ts2.createCompilerHost(compilerOptions, true);
+  const compilerHost = ts3.createCompilerHost(compilerOptions, true);
   let inMemorySource;
   if (workspaceMap) {
     compilerHost.resolveModuleNameLiterals = (moduleLiterals, containingFile, redirectedReference, options2, containingSourceFile) => moduleLiterals.map((literal) => {
@@ -2589,12 +2482,12 @@ function createProgram(options) {
           };
         }
       }
-      const mode = ts2.getModeForUsageLocation(containingSourceFile, literal, options2);
-      return ts2.resolveModuleName(literal.text, containingFile, options2, compilerHost, undefined, redirectedReference, mode);
+      const mode = ts3.getModeForUsageLocation(containingSourceFile, literal, options2);
+      return ts3.resolveModuleName(literal.text, containingFile, options2, compilerHost, undefined, redirectedReference, mode);
     });
   }
   if (content !== undefined) {
-    inMemorySource = ts2.createSourceFile(entryFile, content, ts2.ScriptTarget.Latest, true, getScriptKind(entryFile));
+    inMemorySource = ts3.createSourceFile(entryFile, content, ts3.ScriptTarget.Latest, true, getScriptKind(entryFile));
     const originalGetSourceFile = compilerHost.getSourceFile.bind(compilerHost);
     compilerHost.getSourceFile = (fileName, languageVersion, onError, shouldCreateNewSourceFile) => {
       if (fileName === entryFile) {
@@ -2604,7 +2497,7 @@ function createProgram(options) {
     };
   }
   const rootFiles = [entryFile, ...additionalRootFiles];
-  const program = ts2.createProgram(rootFiles, compilerOptions, compilerHost);
+  const program = ts3.createProgram(rootFiles, compilerOptions, compilerHost);
   const sourceFile = inMemorySource ?? program.getSourceFile(entryFile);
   return {
     program,
@@ -2625,77 +2518,6 @@ import ts5 from "typescript";
 // src/types/schema-builder.ts
 import ts4 from "typescript";
 
-// src/ast/type-identity.ts
-import * as path5 from "node:path";
-import ts3 from "typescript";
-var NODE_MODULES_PKG = /node_modules\/(@[^/]+\/[^/]+|[^/]+)/;
-function packageLabel(fileName, workspacePackages) {
-  const match = fileName.match(NODE_MODULES_PKG);
-  let pkg = match?.[1];
-  if (!pkg) {
-    for (const [name, dir] of workspacePackages) {
-      if (fileName.startsWith(`${path5.resolve(dir)}${path5.sep}`)) {
-        pkg = name;
-        break;
-      }
-    }
-  }
-  return (pkg ?? "local").replace(/^@/, "").replace(/\//g, "-");
-}
-function declKey(symbol, checker) {
-  let resolved = symbol;
-  if (symbol.flags & ts3.SymbolFlags.Alias) {
-    try {
-      resolved = checker.getAliasedSymbol(symbol);
-    } catch {}
-  }
-  const decl = resolved.declarations?.[0];
-  if (!decl)
-    return;
-  return `${decl.getSourceFile().fileName}#${decl.getStart()}`;
-}
-function resolveTypeId(symbol, ctx) {
-  const cached = ctx.typeIds.get(symbol);
-  if (cached)
-    return cached;
-  const key = declKey(symbol, ctx.typeChecker);
-  if (key) {
-    const existing = ctx.declIds.get(key);
-    if (existing) {
-      ctx.typeIds.set(symbol, existing);
-      return existing;
-    }
-  }
-  const claim = (id) => {
-    ctx.typeIds.set(symbol, id);
-    if (key)
-      ctx.declIds.set(key, id);
-    ctx.idOwner.set(id, key ?? id);
-    return id;
-  };
-  const name = symbol.getName();
-  const owner = ctx.idOwner.get(name);
-  if (!owner || owner === key)
-    return claim(name);
-  const file = symbol.declarations?.[0]?.getSourceFile().fileName ?? "";
-  const scoped = `${packageLabel(file, ctx.workspacePackages)}.${name}`;
-  const scopedOwner = ctx.idOwner.get(scoped);
-  if (!scopedOwner || scopedOwner === key)
-    return claim(scoped);
-  let n = 2;
-  while (ctx.idOwner.has(`${name}_${n}`))
-    n++;
-  return claim(`${name}_${n}`);
-}
-function typeRefId(type, ctx) {
-  const symbol = type.aliasSymbol ?? type.getSymbol();
-  if (!symbol)
-    return "";
-  if (!ctx)
-    return symbol.getName();
-  return resolveTypeId(symbol, ctx);
-}
-
 // src/schema/builtins.ts
 var BUILTIN_TYPE_SCHEMAS = {
   Array: { type: "array" },
@@ -3013,9 +2835,7 @@ function isBuiltinSymbol(symbol) {
   const declarations = symbol.getDeclarations();
   if (!declarations || declarations.length === 0)
     return false;
-  const sourceFile = declarations[0].getSourceFile();
-  const fileName = sourceFile.fileName;
-  return fileName.includes("/typescript/lib/lib.") || fileName.includes("\\typescript\\lib\\lib.");
+  return isLibFile(declarations[0].getSourceFile().fileName);
 }
 function getTypeOrigin(type, _checker) {
   const symbol = type.getSymbol() ?? type.aliasSymbol;
@@ -3025,12 +2845,9 @@ function getTypeOrigin(type, _checker) {
   if (!declarations || declarations.length === 0)
     return;
   const fileName = declarations[0].getSourceFile().fileName;
-  const match = fileName.match(/node_modules\/(@[^/]+\/[^/]+|[^/]+)/);
-  if (!match)
-    return;
-  if (match[1] === "typescript")
+  if (isLibFile(fileName))
     return;
-  return match[1];
+  return packageNameFromPath(fileName);
 }
 function isBuiltinGeneric(name) {
   return BUILTIN_GENERICS.has(name);
@@ -4160,7 +3977,7 @@ class TypeRegistry {
     const props = {};
     const required = [];
     const limit = ctx.maxProperties;
-    const isArrayLike = checker.isArrayType(type) || checker.isTupleType(type) || type.symbol?.getName() === "Array" && type.symbol?.getDeclarations()?.[0]?.getSourceFile()?.fileName?.includes("/typescript/lib/lib.");
+    const isArrayLike = checker.isArrayType(type) || checker.isTupleType(type) || type.symbol?.getName() === "Array" && isLibFile(type.symbol?.getDeclarations()?.[0]?.getSourceFile()?.fileName ?? "");
     const isStringLike = type.flags & ts6.TypeFlags.StringLike;
     const isNumberLike = type.flags & ts6.TypeFlags.NumberLike;
     const included = properties.filter((prop) => {
@@ -6151,11 +5968,9 @@ function detectExternalPackage(symbol, checker) {
   const allDecls = [...targetSymbol.declarations ?? [], ...symbol.declarations ?? []];
   for (const decl of allDecls) {
     const sf = decl.getSourceFile();
-    if (sf?.fileName.includes("node_modules")) {
-      const match = sf.fileName.match(/node_modules\/(@[^/]+\/[^/]+|[^/]+)/);
-      if (match)
-        return match[1];
-    }
+    const pkg = sf && packageNameFromPath(sf.fileName);
+    if (pkg)
+      return pkg;
     if (ts13.isExportSpecifier(decl)) {
       const exportDecl = decl.parent?.parent;
       if (exportDecl && ts13.isExportDeclaration(exportDecl) && exportDecl.moduleSpecifier) {
@@ -6979,80 +6794,6 @@ function extractExternalExport(exportName, resolvedModule, program, ctx, visited
   return specExport;
 }
 
-// src/builder/jev-extract.ts
-var FOLLOW_SCORE_LEVELS = [
-  "opaque — a stub is enough",
-  "useful — expanding helps",
-  "essential — needed to understand the public API"
-];
-var AMBIGUOUS_CODES = new Set([
-  "FORGOTTEN_EXPORT",
-  "SERIALIZATION_FAILED",
-  "RUNTIME_SCHEMA_ERROR"
-]);
-async function selectFollowExternal(refs, evaluate) {
-  const sliced = refs.slice(0, MAX_JEV_QUESTIONS);
-  if (!sliced.length)
-    return [];
-  const questions = {};
-  for (const [i, ref] of sliced.entries()) {
-    questions[`t${i}`] = {
-      type: "score",
-      instructions: `How load-bearing is ${ref.typeName} from ${ref.package} for understanding this public TypeScript API?`,
-      criteria: FOLLOW_SCORE_LEVELS
-    };
-  }
-  const result = await jevEvaluate(evaluate, {
-    types: sliced,
-    task: "OpenPkg extracts a public TS API. Stub opaque externals; expand load-bearing ones."
-  }, questions);
-  const follow = new Set;
-  for (const [i, ref] of sliced.entries()) {
-    const id = `t${i}`;
-    const score = result.answers[id]?.score;
-    if (typeof score !== "number")
-      continue;
-    const conf = namedConfidence(result, id) ?? (score >= 1.5 || score <= 0.5 ? 1 : 0);
-    if (score >= 1.5 || score >= 1 && conf >= JEV_CONFIDENCE)
-      follow.add(ref.package);
-  }
-  return [...follow];
-}
-async function calibrateDiagnostics(diagnostics, evaluate) {
-  const targets = diagnostics.map((d, index) => ({ d, index })).filter(({ d }) => d.code && AMBIGUOUS_CODES.has(d.code)).slice(0, MAX_JEV_QUESTIONS);
-  if (targets.length < 1)
-    return;
-  const questions = {};
-  for (const [i, { d }] of targets.entries()) {
-    questions[`d${i}`] = {
-      type: "choice",
-      instructions: `What severity should this extraction diagnostic have? ${d.message}`,
-      criteria: {
-        error: "Blocks a correct spec",
-        warning: "Likely a real API gap",
-        info: "Informational only"
-      }
-    };
-  }
-  const result = await jevEvaluate(evaluate, {
-    diagnostics: targets.map(({ d }) => ({
-      code: d.code,
-      message: d.message,
-      severity: d.severity
-    }))
-  }, questions);
-  for (const [i, { d }] of targets.entries()) {
-    const id = `d${i}`;
-    const choice = result.answers[id]?.choice;
-    if (choice !== "error" && choice !== "warning" && choice !== "info")
-      continue;
-    const conf = namedConfidence(result, id) ?? result.answers[id]?.probabilities?.[choice] ?? 0;
-    if (conf < JEV_CONFIDENCE)
-      continue;
-    d.severity = choice;
-  }
-}
-
 // src/builder/schema-merger.ts
 function mergeRuntimeSchemas(staticExports, runtimeSchemas) {
   let merged = 0;
@@ -7220,10 +6961,6 @@ function hasInternalTag(typeName, program, sourceFile) {
 
 // src/builder/type-expansion.ts
 import ts18 from "typescript";
-var NODE_MODULES_PKG2 = /node_modules\/(@[^/]+\/[^/]+|[^/]+)/;
-function isLibFile(fileName) {
-  return fileName.includes("/typescript/lib/lib.") || fileName.includes("\\typescript\\lib\\lib.");
-}
 function createExternalExpansionPredicate(opts) {
   const matchesEntry = (entry, pkg) => {
     if (!entry.includes("*"))
@@ -7232,8 +6969,6 @@ function createExternalExpansionPredicate(opts) {
     return rx.test(pkg);
   };
   const packageAllowed = (pkg) => {
-    if (pkg === "typescript")
-      return false;
     if (opts.followExternal === true)
       return true;
     if (Array.isArray(opts.followExternal) && opts.followExternal.some((e) => matchesEntry(e, pkg))) {
@@ -7248,91 +6983,12 @@ function createExternalExpansionPredicate(opts) {
     const fileName = decl.getSourceFile().fileName;
     if (isLibFile(fileName))
       return false;
-    const match = fileName.match(NODE_MODULES_PKG2);
-    if (match)
-      return packageAllowed(match[1]);
+    const pkg = packageNameFromPath(fileName);
+    if (pkg)
+      return packageAllowed(pkg);
     return true;
   };
 }
-function collectReferencedExternals(exportedSymbols, checker, workspacePackages) {
-  const out = [];
-  const seen = new Set;
-  const visited = new Set;
-  const consider = (symbol) => {
-    if (!symbol)
-      return;
-    const decl = symbol.declarations?.[0];
-    if (!decl)
-      return;
-    const fileName = decl.getSourceFile().fileName;
-    if (isLibFile(fileName))
-      return;
-    const match = fileName.match(NODE_MODULES_PKG2);
-    if (!match)
-      return;
-    const pkg = match[1];
-    if (pkg === "typescript" || workspacePackages.has(pkg))
-      return;
-    const typeName = symbol.getName();
-    if (typeName.startsWith("__"))
-      return;
-    const key = `${pkg}:${typeName}`;
-    if (seen.has(key))
-      return;
-    seen.add(key);
-    out.push({ typeName, package: pkg });
-  };
-  const visit = (type, depth) => {
-    if (!type || depth > 20 || visited.has(type))
-      return;
-    visited.add(type);
-    const symbol = type.aliasSymbol ?? type.getSymbol();
-    consider(symbol);
-    for (const arg of type.aliasTypeArguments ?? [])
-      visit(arg, depth + 1);
-    const typeRef = type;
-    if (typeRef.target) {
-      for (const arg of checker.getTypeArguments(typeRef) ?? [])
-        visit(arg, depth + 1);
-    }
-    if (type.isUnion() || type.isIntersection()) {
-      for (const t of type.types)
-        visit(t, depth + 1);
-    }
-    const fileName = symbol?.declarations?.[0]?.getSourceFile().fileName;
-    if (fileName) {
-      if (isLibFile(fileName))
-        return;
-      const match = fileName.match(NODE_MODULES_PKG2);
-      if (match && !workspacePackages.has(match[1]))
-        return;
-    }
-    if (!(type.flags & ts18.TypeFlags.Object || type.isClassOrInterface()))
-      return;
-    if (type.isClassOrInterface()) {
-      for (const base of checker.getBaseTypes(type) ?? [])
-        visit(base, depth + 1);
-    }
-    for (const prop of type.getProperties()) {
-      if (prop.getName().startsWith("__@"))
-        continue;
-      visit(checker.getTypeOfSymbol(prop), depth + 1);
-    }
-    for (const sig of [...type.getCallSignatures(), ...type.getConstructSignatures()]) {
-      for (const param of sig.getParameters())
-        visit(checker.getTypeOfSymbol(param), depth + 1);
-      visit(sig.getReturnType(), depth + 1);
-    }
-    for (const info of checker.getIndexInfosOfType(type)) {
-      visit(info.type, depth + 1);
-    }
-  };
-  for (const symbol of exportedSymbols) {
-    visit(checker.getTypeOfSymbol(symbol), 0);
-    visit(checker.getDeclaredTypeOfSymbol(symbol), 0);
-  }
-  return out;
-}
 function expandReachableTypes(exportedSymbols, ctx, opts) {
   if (opts.followExternal === false)
     return;
@@ -7801,44 +7457,7 @@ async function extract(options) {
         ...included ? {} : { skipReason: "filtered" }
       });
     }
-    let followExternal = options.followExternal;
-    let evaluate = options.evaluate;
-    if (followExternal === "auto" && !evaluate && options.decisions !== "jev") {
-      diagnostics.push({
-        message: "followExternal auto requires decisions: 'jev' (or an injected evaluate)",
-        severity: "error",
-        code: "JEV_UNAVAILABLE"
-      });
-      followExternal = undefined;
-    }
-    const wantsJev = options.decisions === "jev";
-    if (wantsJev && !evaluate) {
-      if (process.env.AI_GATEWAY_API_KEY) {
-        try {
-          evaluate = await loadEvaluate();
-        } catch (err) {
-          diagnostics.push({
-            message: err instanceof Error ? err.message : String(err),
-            severity: "error",
-            code: "JEV_UNAVAILABLE"
-          });
-        }
-      } else if (followExternal === "auto") {
-        diagnostics.push({
-          message: "followExternal auto requires --jev and AI_GATEWAY_API_KEY",
-          severity: "error",
-          code: "JEV_UNAVAILABLE"
-        });
-      }
-    }
-    if (followExternal === "auto") {
-      if (!evaluate) {
-        followExternal = undefined;
-      } else {
-        const refs = collectReferencedExternals(exportedSymbols, typeChecker, result.workspacePackages ?? new Map);
-        followExternal = await selectFollowExternal(refs, evaluate);
-      }
-    }
+    const followExternal = options.followExternal;
     const ctx = createContext(program, sourceFile, {
       maxTypeDepth,
       includePrivate,
@@ -7870,12 +7489,10 @@ async function extract(options) {
           const allDecls = [...targetSymbol.declarations ?? [], ...symbol.declarations ?? []];
           for (const decl of allDecls) {
             const sf = decl.getSourceFile();
-            if (sf?.fileName.includes("node_modules")) {
-              const match = sf.fileName.match(/node_modules\/(@[^/]+\/[^/]+|[^/]+)/);
-              if (match) {
-                externalPackage = match[1];
-                break;
-              }
+            const pkg = sf && packageNameFromPath(sf.fileName);
+            if (pkg) {
+              externalPackage = pkg;
+              break;
             }
             if (ts19.isExportSpecifier(decl)) {
               const exportDecl = decl.parent?.parent;
@@ -8081,9 +7698,6 @@ async function extract(options) {
         suggestion: "Check serialization errors for these exports"
       });
     }
-    if (evaluate) {
-      await calibrateDiagnostics(diagnostics, evaluate);
-    }
     return {
       spec,
       diagnostics,
@@ -8344,7 +7958,7 @@ function findTypeInProgram(name, checker, program, sourceFile, symFlags) {
   const entryDir = path10.dirname(sourceFile.fileName);
   for (const sf of program.getSourceFiles()) {
     const fn = sf.fileName;
-    if (fn.includes("/typescript/lib/lib.") || fn.includes("\\typescript\\lib\\lib."))
+    if (isLibFile(fn))
       continue;
     if (fn.includes("/@types/node/") || fn.includes("\\@types\\node\\"))
       continue;
@@ -9004,8 +8618,6 @@ export {
   PRIMITIVES,
   NUMBER_PROTOTYPE_METHODS,
   LATEST_VERSION,
-  JEV_MODEL,
-  JEV_CONFIDENCE,
   CacheManager,
   CONFIG_FILENAME,
   BUILTIN_TYPE_SCHEMAS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpkg-ts/sdk",
-  "version": "0.53.1",
+  "version": "0.54.1",
   "description": "TypeScript API extraction SDK - programmatic primitives for OpenPkg specs",
   "keywords": [
     "openpkg",
@@ -48,13 +48,9 @@
     "typescript": "^5.0.0 || ^6.0.0"
   },
   "peerDependencies": {
-    "ai": "^7.0.105",
     "shiki": "^1.0.0"
   },
   "peerDependenciesMeta": {
-    "ai": {
-      "optional": true
-    },
     "shiki": {
       "optional": true
     }