@dirxai/core 0.3.0 → 0.3.1

package/dist/chunk-AMKKT77F.js

@@ -0,0 +1,177 @@
+// src/scanner/detect.ts
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+var FRAMEWORK_PACKAGES = {
+  next: "nextjs",
+  hono: "hono",
+  fastify: "fastify",
+  express: "express",
+  "@hono/node-server": "hono",
+  koa: "koa"
+};
+function detectFramework(target) {
+  if (existsSync(join(target, "Cargo.toml"))) {
+    return { lang: "rust", framework: "axum" };
+  }
+  if (existsSync(join(target, "go.mod"))) {
+    return { lang: "go", framework: "net/http" };
+  }
+  if (existsSync(join(target, "package.json"))) {
+    const detected = detectFrameworkFromDeps(target);
+    if (detected) return { lang: "node", framework: detected };
+    return { lang: "node", framework: "express" };
+  }
+  if (existsSync(join(target, "requirements.txt")) || existsSync(join(target, "pyproject.toml"))) {
+    return { lang: "python", framework: "fastapi" };
+  }
+  return { lang: "unknown", framework: "generic" };
+}
+function detectFrameworkFromDeps(target) {
+  const pkgPath = join(target, "package.json");
+  if (!existsSync(pkgPath)) return null;
+  try {
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    const deps = {
+      ...pkg.dependencies,
+      ...pkg.devDependencies
+    };
+    for (const [pkg2, fw] of Object.entries(FRAMEWORK_PACKAGES)) {
+      if (pkg2 in deps) return fw;
+    }
+  } catch {
+  }
+  return null;
+}
+function hasDirxSdk(target) {
+  const pkgPath = join(target, "package.json");
+  if (!existsSync(pkgPath)) return false;
+  try {
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+    const deps = {
+      ...pkg.dependencies,
+      ...pkg.devDependencies
+    };
+    return "@dirxai/core" in deps;
+  } catch {
+    return false;
+  }
+}
+
+// src/scanner/routes.ts
+import { readFileSync as readFileSync2, readdirSync, statSync } from "fs";
+import { join as join2, relative, extname } from "path";
+var MAX_SCAN_DEPTH = 8;
+var SKIP_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  "target",
+  "__pycache__",
+  "vendor",
+  "dist",
+  "build",
+  ".next"
+]);
+var SCAN_EXTENSIONS = /* @__PURE__ */ new Set([
+  ".ts",
+  ".tsx",
+  ".js",
+  ".jsx",
+  ".py",
+  ".go",
+  ".rs"
+]);
+function getRoutePatterns(framework) {
+  switch (framework) {
+    case "express":
+    case "hono":
+    case "fastify":
+    case "koa":
+      return [".get(", ".post(", ".put(", ".delete(", ".patch(", "router."];
+    case "nextjs":
+      return ["export default", "export async function"];
+    case "fastapi":
+      return ["@app.get", "@app.post", "@app.put", "@app.delete", "@router."];
+    case "go":
+    case "net/http":
+      return ["HandleFunc(", "Get(", "Post(", "Put(", "Delete(", "r.Route("];
+    case "axum":
+      return [".route(", ".get(", ".post(", ".put(", ".delete("];
+    default:
+      return [];
+  }
+}
+function extractRoutesRegex(content) {
+  const regex = /\.\s*(get|post|put|patch|delete)\s*\(\s*["'`](\/[^"'`]*)["'`]/gi;
+  const results = [];
+  let match;
+  while ((match = regex.exec(content)) !== null) {
+    results.push({
+      method: match[1].toUpperCase(),
+      path: match[2]
+    });
+  }
+  return results;
+}
+function scanRoutes(root, framework) {
+  const patterns = getRoutePatterns(framework);
+  if (patterns.length === 0) return [];
+  const routes = [];
+  walkDir(root, root, patterns, framework, routes, 0);
+  return routes;
+}
+function walkDir(root, dir, patterns, framework, routes, depth) {
+  if (depth > MAX_SCAN_DEPTH) return;
+  let entries;
+  try {
+    entries = readdirSync(dir);
+  } catch {
+    return;
+  }
+  for (const name of entries) {
+    if (SKIP_DIRS.has(name)) continue;
+    const fullPath = join2(dir, name);
+    let stat;
+    try {
+      stat = statSync(fullPath);
+    } catch {
+      continue;
+    }
+    if (stat.isDirectory()) {
+      walkDir(root, fullPath, patterns, framework, routes, depth + 1);
+      continue;
+    }
+    if (!stat.isFile()) continue;
+    if (!SCAN_EXTENSIONS.has(extname(name))) continue;
+    try {
+      const content = readFileSync2(fullPath, "utf-8");
+      if (patterns.some((p) => content.includes(p))) {
+        routes.push({
+          file: relative(root, fullPath),
+          framework
+        });
+      }
+    } catch {
+    }
+  }
+}
+
+// src/scanner/schema.ts
+function extractPrismaModelNames(content) {
+  const models = [];
+  const regex = /model\s+(\w+)\s*\{/g;
+  let match;
+  while ((match = regex.exec(content)) !== null) {
+    models.push(match[1]);
+  }
+  return models;
+}
+
+export {
+  detectFramework,
+  detectFrameworkFromDeps,
+  hasDirxSdk,
+  getRoutePatterns,
+  extractRoutesRegex,
+  scanRoutes,
+  extractPrismaModelNames
+};

package/dist/chunk-VTJP4C2Q.js

@@ -0,0 +1,30 @@
+// src/types.ts
+var KNOWN_PROVIDERS = {
+  "api.github.com": {
+    envVar: "GITHUB_TOKEN",
+    guideUrl: "https://github.com/settings/tokens"
+  },
+  "api.openai.com": {
+    envVar: "OPENAI_API_KEY",
+    guideUrl: "https://platform.openai.com/api-keys"
+  },
+  "api.anthropic.com": {
+    envVar: "ANTHROPIC_API_KEY",
+    guideUrl: "https://console.anthropic.com/settings/keys"
+  },
+  "generativelanguage.googleapis.com": {
+    envVar: "GOOGLE_API_KEY",
+    guideUrl: "https://aistudio.google.com/apikey"
+  },
+  "api.stripe.com": {
+    envVar: "STRIPE_SECRET_KEY",
+    guideUrl: "https://dashboard.stripe.com/apikeys"
+  }
+};
+function getAuthHint(domain) {
+  return KNOWN_PROVIDERS[domain] ?? null;
+}
+
+export {
+  getAuthHint
+};

package/dist/index.cjs

@@ -25,10 +25,215 @@ __export(index_exports, {
   DirxErrorCode: () => DirxErrorCode,
   Guard: () => Guard,
   JwksClient: () => JwksClient,
-  createGuard: () => createGuard
+  createGuard: () => createGuard,
+  detectFramework: () => detectFramework,
+  detectFrameworkFromDeps: () => detectFrameworkFromDeps,
+  extractPrismaModelNames: () => extractPrismaModelNames,
+  extractRoutesRegex: () => extractRoutesRegex,
+  generateDirJson: () => generateDirJson,
+  generateDirMd: () => generateDirMd,
+  getAuthHint: () => getAuthHint,
+  getRoutePatterns: () => getRoutePatterns,
+  hasDirxSdk: () => hasDirxSdk,
+  scanRoutes: () => scanRoutes
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/scanner/detect.ts
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+var FRAMEWORK_PACKAGES = {
+  next: "nextjs",
+  hono: "hono",
+  fastify: "fastify",
+  express: "express",
+  "@hono/node-server": "hono",
+  koa: "koa"
+};
+function detectFramework(target) {
+  if ((0, import_node_fs.existsSync)((0, import_node_path.join)(target, "Cargo.toml"))) {
+    return { lang: "rust", framework: "axum" };
+  }
+  if ((0, import_node_fs.existsSync)((0, import_node_path.join)(target, "go.mod"))) {
+    return { lang: "go", framework: "net/http" };
+  }
+  if ((0, import_node_fs.existsSync)((0, import_node_path.join)(target, "package.json"))) {
+    const detected = detectFrameworkFromDeps(target);
+    if (detected) return { lang: "node", framework: detected };
+    return { lang: "node", framework: "express" };
+  }
+  if ((0, import_node_fs.existsSync)((0, import_node_path.join)(target, "requirements.txt")) || (0, import_node_fs.existsSync)((0, import_node_path.join)(target, "pyproject.toml"))) {
+    return { lang: "python", framework: "fastapi" };
+  }
+  return { lang: "unknown", framework: "generic" };
+}
+function detectFrameworkFromDeps(target) {
+  const pkgPath = (0, import_node_path.join)(target, "package.json");
+  if (!(0, import_node_fs.existsSync)(pkgPath)) return null;
+  try {
+    const pkg = JSON.parse((0, import_node_fs.readFileSync)(pkgPath, "utf-8"));
+    const deps = {
+      ...pkg.dependencies,
+      ...pkg.devDependencies
+    };
+    for (const [pkg2, fw] of Object.entries(FRAMEWORK_PACKAGES)) {
+      if (pkg2 in deps) return fw;
+    }
+  } catch {
+  }
+  return null;
+}
+function hasDirxSdk(target) {
+  const pkgPath = (0, import_node_path.join)(target, "package.json");
+  if (!(0, import_node_fs.existsSync)(pkgPath)) return false;
+  try {
+    const pkg = JSON.parse((0, import_node_fs.readFileSync)(pkgPath, "utf-8"));
+    const deps = {
+      ...pkg.dependencies,
+      ...pkg.devDependencies
+    };
+    return "@dirxai/core" in deps;
+  } catch {
+    return false;
+  }
+}
+
+// src/scanner/routes.ts
+var import_node_fs2 = require("fs");
+var import_node_path2 = require("path");
+var MAX_SCAN_DEPTH = 8;
+var SKIP_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  "target",
+  "__pycache__",
+  "vendor",
+  "dist",
+  "build",
+  ".next"
+]);
+var SCAN_EXTENSIONS = /* @__PURE__ */ new Set([
+  ".ts",
+  ".tsx",
+  ".js",
+  ".jsx",
+  ".py",
+  ".go",
+  ".rs"
+]);
+function getRoutePatterns(framework) {
+  switch (framework) {
+    case "express":
+    case "hono":
+    case "fastify":
+    case "koa":
+      return [".get(", ".post(", ".put(", ".delete(", ".patch(", "router."];
+    case "nextjs":
+      return ["export default", "export async function"];
+    case "fastapi":
+      return ["@app.get", "@app.post", "@app.put", "@app.delete", "@router."];
+    case "go":
+    case "net/http":
+      return ["HandleFunc(", "Get(", "Post(", "Put(", "Delete(", "r.Route("];
+    case "axum":
+      return [".route(", ".get(", ".post(", ".put(", ".delete("];
+    default:
+      return [];
+  }
+}
+function extractRoutesRegex(content) {
+  const regex = /\.\s*(get|post|put|patch|delete)\s*\(\s*["'`](\/[^"'`]*)["'`]/gi;
+  const results = [];
+  let match;
+  while ((match = regex.exec(content)) !== null) {
+    results.push({
+      method: match[1].toUpperCase(),
+      path: match[2]
+    });
+  }
+  return results;
+}
+function scanRoutes(root, framework) {
+  const patterns = getRoutePatterns(framework);
+  if (patterns.length === 0) return [];
+  const routes = [];
+  walkDir(root, root, patterns, framework, routes, 0);
+  return routes;
+}
+function walkDir(root, dir, patterns, framework, routes, depth) {
+  if (depth > MAX_SCAN_DEPTH) return;
+  let entries;
+  try {
+    entries = (0, import_node_fs2.readdirSync)(dir);
+  } catch {
+    return;
+  }
+  for (const name of entries) {
+    if (SKIP_DIRS.has(name)) continue;
+    const fullPath = (0, import_node_path2.join)(dir, name);
+    let stat;
+    try {
+      stat = (0, import_node_fs2.statSync)(fullPath);
+    } catch {
+      continue;
+    }
+    if (stat.isDirectory()) {
+      walkDir(root, fullPath, patterns, framework, routes, depth + 1);
+      continue;
+    }
+    if (!stat.isFile()) continue;
+    if (!SCAN_EXTENSIONS.has((0, import_node_path2.extname)(name))) continue;
+    try {
+      const content = (0, import_node_fs2.readFileSync)(fullPath, "utf-8");
+      if (patterns.some((p) => content.includes(p))) {
+        routes.push({
+          file: (0, import_node_path2.relative)(root, fullPath),
+          framework
+        });
+      }
+    } catch {
+    }
+  }
+}
+
+// src/scanner/schema.ts
+function extractPrismaModelNames(content) {
+  const models = [];
+  const regex = /model\s+(\w+)\s*\{/g;
+  let match;
+  while ((match = regex.exec(content)) !== null) {
+    models.push(match[1]);
+  }
+  return models;
+}
+
+// src/types.ts
+var KNOWN_PROVIDERS = {
+  "api.github.com": {
+    envVar: "GITHUB_TOKEN",
+    guideUrl: "https://github.com/settings/tokens"
+  },
+  "api.openai.com": {
+    envVar: "OPENAI_API_KEY",
+    guideUrl: "https://platform.openai.com/api-keys"
+  },
+  "api.anthropic.com": {
+    envVar: "ANTHROPIC_API_KEY",
+    guideUrl: "https://console.anthropic.com/settings/keys"
+  },
+  "generativelanguage.googleapis.com": {
+    envVar: "GOOGLE_API_KEY",
+    guideUrl: "https://aistudio.google.com/apikey"
+  },
+  "api.stripe.com": {
+    envVar: "STRIPE_SECRET_KEY",
+    guideUrl: "https://dashboard.stripe.com/apikeys"
+  }
+};
+function getAuthHint(domain) {
+  return KNOWN_PROVIDERS[domain] ?? null;
+}
+
 // src/auth/jwks.ts
 var import_jose = require("jose");
 
@@ -217,6 +422,48 @@ var Guard = class {
 function createGuard(options) {
   return new Guard(options);
 }
+
+// src/generator.ts
+function generateDirMd(service, options) {
+  const sections = [];
+  sections.push(`# ${service.title}`);
+  if (service.description) {
+    sections.push(service.description);
+  }
+  if (service.base_url) {
+    sections.push(`## Base URL
+
+\`${service.base_url}\``);
+  }
+  if (service.actions.length > 0) {
+    sections.push(
+      `## Actions
+
+${service.actions.map((a) => `- \`${a}\``).join("\n")}`
+    );
+  }
+  if (service.endpoints.length > 0) {
+    const lines = ["## Endpoints", ""];
+    lines.push("| Method | Path | Description |");
+    lines.push("|--------|------|-------------|");
+    for (const ep of service.endpoints) {
+      const desc = ep.description ?? "";
+      lines.push(`| ${ep.method} | \`${ep.path}\` | ${desc} |`);
+    }
+    sections.push(lines.join("\n"));
+  }
+  if (options?.includeTimestamp) {
+    sections.push(
+      `---
+
+*Generated at ${(/* @__PURE__ */ new Date()).toISOString()}*`
+    );
+  }
+  return sections.join("\n\n") + "\n";
+}
+function generateDirJson(service) {
+  return JSON.stringify(service, null, 2);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AgentContext,
@@ -224,5 +471,15 @@ function createGuard(options) {
   DirxErrorCode,
   Guard,
   JwksClient,
-  createGuard
+  createGuard,
+  detectFramework,
+  detectFrameworkFromDeps,
+  extractPrismaModelNames,
+  extractRoutesRegex,
+  generateDirJson,
+  generateDirMd,
+  getAuthHint,
+  getRoutePatterns,
+  hasDirxSdk,
+  scanRoutes
 });

package/dist/index.d.cts

@@ -1,3 +1,6 @@
+export { DetectedStack, RouteHint, detectFramework, detectFrameworkFromDeps, extractPrismaModelNames, extractRoutesRegex, getRoutePatterns, hasDirxSdk, scanRoutes } from './scanner/index.cjs';
+import { DirxService } from './types.cjs';
+export { ByokAuth, DirxEndpoint, DirxEnvelope, EndpointMatch, ProviderHint, SearchResult, getAuthHint } from './types.cjs';
 import { J as JwksClientOptions, A as AgentContext } from './context-C7RRNS5U.cjs';
 export { D as DirxTokenPayload, a as JwksClient } from './context-C7RRNS5U.cjs';
 import 'jose';
@@ -57,6 +60,24 @@ declare class Guard {
 }
 declare function createGuard(options?: GuardOptions): Guard;
 
+/**
+ * DIR.md generator — produces a DirX service description from structured input.
+ *
+ * Third-party projects can use this to programmatically generate DIR.md files.
+ */
+
+interface GenerateOptions {
+    includeTimestamp?: boolean;
+}
+/**
+ * Generate a DIR.md markdown string from a DirxService definition.
+ */
+declare function generateDirMd(service: DirxService, options?: GenerateOptions): string;
+/**
+ * Generate a dir.json object from a DirxService definition.
+ */
+declare function generateDirJson(service: DirxService): string;
+
 /**
  * DirX error codes and typed error class.
  *
@@ -87,4 +108,4 @@ declare class DirxError extends Error {
     };
 }
 
-export { AgentContext, DirxError, DirxErrorCode, Guard, type GuardOptions, JwksClientOptions, createGuard };
+export { AgentContext, DirxError, DirxErrorCode, DirxService, type GenerateOptions, Guard, type GuardOptions, JwksClientOptions, createGuard, generateDirJson, generateDirMd };

package/dist/index.d.ts

@@ -1,3 +1,6 @@
+export { DetectedStack, RouteHint, detectFramework, detectFrameworkFromDeps, extractPrismaModelNames, extractRoutesRegex, getRoutePatterns, hasDirxSdk, scanRoutes } from './scanner/index.js';
+import { DirxService } from './types.js';
+export { ByokAuth, DirxEndpoint, DirxEnvelope, EndpointMatch, ProviderHint, SearchResult, getAuthHint } from './types.js';
 import { J as JwksClientOptions, A as AgentContext } from './context-C7RRNS5U.js';
 export { D as DirxTokenPayload, a as JwksClient } from './context-C7RRNS5U.js';
 import 'jose';
@@ -57,6 +60,24 @@ declare class Guard {
 }
 declare function createGuard(options?: GuardOptions): Guard;
 
+/**
+ * DIR.md generator — produces a DirX service description from structured input.
+ *
+ * Third-party projects can use this to programmatically generate DIR.md files.
+ */
+
+interface GenerateOptions {
+    includeTimestamp?: boolean;
+}
+/**
+ * Generate a DIR.md markdown string from a DirxService definition.
+ */
+declare function generateDirMd(service: DirxService, options?: GenerateOptions): string;
+/**
+ * Generate a dir.json object from a DirxService definition.
+ */
+declare function generateDirJson(service: DirxService): string;
+
 /**
  * DirX error codes and typed error class.
  *
@@ -87,4 +108,4 @@ declare class DirxError extends Error {
     };
 }
 
-export { AgentContext, DirxError, DirxErrorCode, Guard, type GuardOptions, JwksClientOptions, createGuard };
+export { AgentContext, DirxError, DirxErrorCode, DirxService, type GenerateOptions, Guard, type GuardOptions, JwksClientOptions, createGuard, generateDirJson, generateDirMd };

package/dist/index.js

@@ -1,6 +1,18 @@
 import {
   AgentContext
 } from "./chunk-5BEMU43U.js";
+import {
+  getAuthHint
+} from "./chunk-VTJP4C2Q.js";
+import {
+  detectFramework,
+  detectFrameworkFromDeps,
+  extractPrismaModelNames,
+  extractRoutesRegex,
+  getRoutePatterns,
+  hasDirxSdk,
+  scanRoutes
+} from "./chunk-AMKKT77F.js";
 
 // src/auth/jwks.ts
 import { createRemoteJWKSet, jwtVerify } from "jose";
@@ -159,11 +171,63 @@ var Guard = class {
 function createGuard(options) {
   return new Guard(options);
 }
+
+// src/generator.ts
+function generateDirMd(service, options) {
+  const sections = [];
+  sections.push(`# ${service.title}`);
+  if (service.description) {
+    sections.push(service.description);
+  }
+  if (service.base_url) {
+    sections.push(`## Base URL
+
+\`${service.base_url}\``);
+  }
+  if (service.actions.length > 0) {
+    sections.push(
+      `## Actions
+
+${service.actions.map((a) => `- \`${a}\``).join("\n")}`
+    );
+  }
+  if (service.endpoints.length > 0) {
+    const lines = ["## Endpoints", ""];
+    lines.push("| Method | Path | Description |");
+    lines.push("|--------|------|-------------|");
+    for (const ep of service.endpoints) {
+      const desc = ep.description ?? "";
+      lines.push(`| ${ep.method} | \`${ep.path}\` | ${desc} |`);
+    }
+    sections.push(lines.join("\n"));
+  }
+  if (options?.includeTimestamp) {
+    sections.push(
+      `---
+
+*Generated at ${(/* @__PURE__ */ new Date()).toISOString()}*`
+    );
+  }
+  return sections.join("\n\n") + "\n";
+}
+function generateDirJson(service) {
+  return JSON.stringify(service, null, 2);
+}
 export {
   AgentContext,
   DirxError,
   DirxErrorCode,
   Guard,
   JwksClient,
-  createGuard
+  createGuard,
+  detectFramework,
+  detectFrameworkFromDeps,
+  extractPrismaModelNames,
+  extractRoutesRegex,
+  generateDirJson,
+  generateDirMd,
+  getAuthHint,
+  getRoutePatterns,
+  hasDirxSdk,
+  scanRoutes
 };

package/dist/scanner/index.cjs

@@ -0,0 +1,209 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/scanner/index.ts
+var scanner_exports = {};
+__export(scanner_exports, {
+  detectFramework: () => detectFramework,
+  detectFrameworkFromDeps: () => detectFrameworkFromDeps,
+  extractPrismaModelNames: () => extractPrismaModelNames,
+  extractRoutesRegex: () => extractRoutesRegex,
+  getRoutePatterns: () => getRoutePatterns,
+  hasDirxSdk: () => hasDirxSdk,
+  scanRoutes: () => scanRoutes
+});
+module.exports = __toCommonJS(scanner_exports);
+
+// src/scanner/detect.ts
+var import_node_fs = require("fs");
+var import_node_path = require("path");
+var FRAMEWORK_PACKAGES = {
+  next: "nextjs",
+  hono: "hono",
+  fastify: "fastify",
+  express: "express",
+  "@hono/node-server": "hono",
+  koa: "koa"
+};
+function detectFramework(target) {
+  if ((0, import_node_fs.existsSync)((0, import_node_path.join)(target, "Cargo.toml"))) {
+    return { lang: "rust", framework: "axum" };
+  }
+  if ((0, import_node_fs.existsSync)((0, import_node_path.join)(target, "go.mod"))) {
+    return { lang: "go", framework: "net/http" };
+  }
+  if ((0, import_node_fs.existsSync)((0, import_node_path.join)(target, "package.json"))) {
+    const detected = detectFrameworkFromDeps(target);
+    if (detected) return { lang: "node", framework: detected };
+    return { lang: "node", framework: "express" };
+  }
+  if ((0, import_node_fs.existsSync)((0, import_node_path.join)(target, "requirements.txt")) || (0, import_node_fs.existsSync)((0, import_node_path.join)(target, "pyproject.toml"))) {
+    return { lang: "python", framework: "fastapi" };
+  }
+  return { lang: "unknown", framework: "generic" };
+}
+function detectFrameworkFromDeps(target) {
+  const pkgPath = (0, import_node_path.join)(target, "package.json");
+  if (!(0, import_node_fs.existsSync)(pkgPath)) return null;
+  try {
+    const pkg = JSON.parse((0, import_node_fs.readFileSync)(pkgPath, "utf-8"));
+    const deps = {
+      ...pkg.dependencies,
+      ...pkg.devDependencies
+    };
+    for (const [pkg2, fw] of Object.entries(FRAMEWORK_PACKAGES)) {
+      if (pkg2 in deps) return fw;
+    }
+  } catch {
+  }
+  return null;
+}
+function hasDirxSdk(target) {
+  const pkgPath = (0, import_node_path.join)(target, "package.json");
+  if (!(0, import_node_fs.existsSync)(pkgPath)) return false;
+  try {
+    const pkg = JSON.parse((0, import_node_fs.readFileSync)(pkgPath, "utf-8"));
+    const deps = {
+      ...pkg.dependencies,
+      ...pkg.devDependencies
+    };
+    return "@dirxai/core" in deps;
+  } catch {
+    return false;
+  }
+}
+
+// src/scanner/routes.ts
+var import_node_fs2 = require("fs");
+var import_node_path2 = require("path");
+var MAX_SCAN_DEPTH = 8;
+var SKIP_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  "target",
+  "__pycache__",
+  "vendor",
+  "dist",
+  "build",
+  ".next"
+]);
+var SCAN_EXTENSIONS = /* @__PURE__ */ new Set([
+  ".ts",
+  ".tsx",
+  ".js",
+  ".jsx",
+  ".py",
+  ".go",
+  ".rs"
+]);
+function getRoutePatterns(framework) {
+  switch (framework) {
+    case "express":
+    case "hono":
+    case "fastify":
+    case "koa":
+      return [".get(", ".post(", ".put(", ".delete(", ".patch(", "router."];
+    case "nextjs":
+      return ["export default", "export async function"];
+    case "fastapi":
+      return ["@app.get", "@app.post", "@app.put", "@app.delete", "@router."];
+    case "go":
+    case "net/http":
+      return ["HandleFunc(", "Get(", "Post(", "Put(", "Delete(", "r.Route("];
+    case "axum":
+      return [".route(", ".get(", ".post(", ".put(", ".delete("];
+    default:
+      return [];
+  }
+}
+function extractRoutesRegex(content) {
+  const regex = /\.\s*(get|post|put|patch|delete)\s*\(\s*["'`](\/[^"'`]*)["'`]/gi;
+  const results = [];
+  let match;
+  while ((match = regex.exec(content)) !== null) {
+    results.push({
+      method: match[1].toUpperCase(),
+      path: match[2]
+    });
+  }
+  return results;
+}
+function scanRoutes(root, framework) {
+  const patterns = getRoutePatterns(framework);
+  if (patterns.length === 0) return [];
+  const routes = [];
+  walkDir(root, root, patterns, framework, routes, 0);
+  return routes;
+}
+function walkDir(root, dir, patterns, framework, routes, depth) {
+  if (depth > MAX_SCAN_DEPTH) return;
+  let entries;
+  try {
+    entries = (0, import_node_fs2.readdirSync)(dir);
+  } catch {
+    return;
+  }
+  for (const name of entries) {
+    if (SKIP_DIRS.has(name)) continue;
+    const fullPath = (0, import_node_path2.join)(dir, name);
+    let stat;
+    try {
+      stat = (0, import_node_fs2.statSync)(fullPath);
+    } catch {
+      continue;
+    }
+    if (stat.isDirectory()) {
+      walkDir(root, fullPath, patterns, framework, routes, depth + 1);
+      continue;
+    }
+    if (!stat.isFile()) continue;
+    if (!SCAN_EXTENSIONS.has((0, import_node_path2.extname)(name))) continue;
+    try {
+      const content = (0, import_node_fs2.readFileSync)(fullPath, "utf-8");
+      if (patterns.some((p) => content.includes(p))) {
+        routes.push({
+          file: (0, import_node_path2.relative)(root, fullPath),
+          framework
+        });
+      }
+    } catch {
+    }
+  }
+}
+
+// src/scanner/schema.ts
+function extractPrismaModelNames(content) {
+  const models = [];
+  const regex = /model\s+(\w+)\s*\{/g;
+  let match;
+  while ((match = regex.exec(content)) !== null) {
+    models.push(match[1]);
+  }
+  return models;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  detectFramework,
+  detectFrameworkFromDeps,
+  extractPrismaModelNames,
+  extractRoutesRegex,
+  getRoutePatterns,
+  hasDirxSdk,
+  scanRoutes
+});

package/dist/scanner/index.d.cts

@@ -0,0 +1,60 @@
+/**
+ * Framework detection from project files and dependencies.
+ *
+ * Detects language and framework by inspecting dependency manifests
+ * (package.json, go.mod, Cargo.toml, requirements.txt, pyproject.toml).
+ */
+interface DetectedStack {
+    lang: string;
+    framework: string;
+}
+/**
+ * Detect framework from a project directory by inspecting manifest files.
+ */
+declare function detectFramework(target: string): DetectedStack;
+/**
+ * Detect framework from package.json dependencies.
+ * Returns null if no known framework is found.
+ */
+declare function detectFrameworkFromDeps(target: string): string | null;
+/**
+ * Check if a project has @dirxai/core in its dependencies.
+ */
+declare function hasDirxSdk(target: string): boolean;
+
+/**
+ * Route extraction from source code.
+ *
+ * Uses pattern matching to detect route definitions across
+ * multiple frameworks (Express, Hono, Fastify, Next.js, FastAPI, Go, Axum).
+ */
+interface RouteHint {
+    file: string;
+    framework: string;
+}
+/**
+ * Get route detection patterns for a given framework.
+ */
+declare function getRoutePatterns(framework: string): string[];
+/**
+ * Extract routes from source code using regex.
+ * Returns method + path pairs found in the content.
+ */
+declare function extractRoutesRegex(content: string): {
+    method: string;
+    path: string;
+}[];
+/**
+ * Scan a directory tree for files containing route definitions.
+ */
+declare function scanRoutes(root: string, framework: string): RouteHint[];
+
+/**
+ * Schema extraction from Prisma and other ORM definitions.
+ */
+/**
+ * Extract model names from a Prisma schema file content.
+ */
+declare function extractPrismaModelNames(content: string): string[];
+
+export { type DetectedStack, type RouteHint, detectFramework, detectFrameworkFromDeps, extractPrismaModelNames, extractRoutesRegex, getRoutePatterns, hasDirxSdk, scanRoutes };

package/dist/scanner/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Framework detection from project files and dependencies.
+ *
+ * Detects language and framework by inspecting dependency manifests
+ * (package.json, go.mod, Cargo.toml, requirements.txt, pyproject.toml).
+ */
+interface DetectedStack {
+    lang: string;
+    framework: string;
+}
+/**
+ * Detect framework from a project directory by inspecting manifest files.
+ */
+declare function detectFramework(target: string): DetectedStack;
+/**
+ * Detect framework from package.json dependencies.
+ * Returns null if no known framework is found.
+ */
+declare function detectFrameworkFromDeps(target: string): string | null;
+/**
+ * Check if a project has @dirxai/core in its dependencies.
+ */
+declare function hasDirxSdk(target: string): boolean;
+
+/**
+ * Route extraction from source code.
+ *
+ * Uses pattern matching to detect route definitions across
+ * multiple frameworks (Express, Hono, Fastify, Next.js, FastAPI, Go, Axum).
+ */
+interface RouteHint {
+    file: string;
+    framework: string;
+}
+/**
+ * Get route detection patterns for a given framework.
+ */
+declare function getRoutePatterns(framework: string): string[];
+/**
+ * Extract routes from source code using regex.
+ * Returns method + path pairs found in the content.
+ */
+declare function extractRoutesRegex(content: string): {
+    method: string;
+    path: string;
+}[];
+/**
+ * Scan a directory tree for files containing route definitions.
+ */
+declare function scanRoutes(root: string, framework: string): RouteHint[];
+
+/**
+ * Schema extraction from Prisma and other ORM definitions.
+ */
+/**
+ * Extract model names from a Prisma schema file content.
+ */
+declare function extractPrismaModelNames(content: string): string[];
+
+export { type DetectedStack, type RouteHint, detectFramework, detectFrameworkFromDeps, extractPrismaModelNames, extractRoutesRegex, getRoutePatterns, hasDirxSdk, scanRoutes };

package/dist/scanner/index.js

@@ -0,0 +1,18 @@
+import {
+  detectFramework,
+  detectFrameworkFromDeps,
+  extractPrismaModelNames,
+  extractRoutesRegex,
+  getRoutePatterns,
+  hasDirxSdk,
+  scanRoutes
+} from "../chunk-AMKKT77F.js";
+export {
+  detectFramework,
+  detectFrameworkFromDeps,
+  extractPrismaModelNames,
+  extractRoutesRegex,
+  getRoutePatterns,
+  hasDirxSdk,
+  scanRoutes
+};

package/dist/types.cjs

@@ -0,0 +1,54 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/types.ts
+var types_exports = {};
+__export(types_exports, {
+  getAuthHint: () => getAuthHint
+});
+module.exports = __toCommonJS(types_exports);
+var KNOWN_PROVIDERS = {
+  "api.github.com": {
+    envVar: "GITHUB_TOKEN",
+    guideUrl: "https://github.com/settings/tokens"
+  },
+  "api.openai.com": {
+    envVar: "OPENAI_API_KEY",
+    guideUrl: "https://platform.openai.com/api-keys"
+  },
+  "api.anthropic.com": {
+    envVar: "ANTHROPIC_API_KEY",
+    guideUrl: "https://console.anthropic.com/settings/keys"
+  },
+  "generativelanguage.googleapis.com": {
+    envVar: "GOOGLE_API_KEY",
+    guideUrl: "https://aistudio.google.com/apikey"
+  },
+  "api.stripe.com": {
+    envVar: "STRIPE_SECRET_KEY",
+    guideUrl: "https://dashboard.stripe.com/apikeys"
+  }
+};
+function getAuthHint(domain) {
+  return KNOWN_PROVIDERS[domain] ?? null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getAuthHint
+});

package/dist/types.d.cts

@@ -0,0 +1,56 @@
+/**
+ * Shared DirX types for CLI, SDK, and server interop.
+ *
+ * DirxEnvelope is the canonical response wrapper used by the gateway.
+ * All other types define the domain model for DirX services.
+ */
+interface DirxEnvelope<T = unknown> {
+    ok: boolean;
+    data?: T;
+    error?: string | {
+        code: string;
+        message: string;
+    };
+    meta?: Record<string, unknown>;
+}
+interface DirxEndpoint {
+    path: string;
+    method: string;
+    description?: string;
+}
+interface DirxService {
+    title: string;
+    description?: string;
+    base_url: string;
+    actions: string[];
+    endpoints: DirxEndpoint[];
+}
+interface SearchResult {
+    domain: string;
+    title: string;
+    description?: string;
+    path?: string;
+    score?: number;
+    matched_endpoints?: EndpointMatch[];
+}
+interface EndpointMatch {
+    method: string;
+    path: string;
+    description?: string;
+}
+interface ByokAuth {
+    type: string;
+    token?: string;
+    header?: string;
+    key?: string;
+}
+interface ProviderHint {
+    envVar?: string;
+    guideUrl: string;
+}
+/**
+ * Get authentication hint for a known provider domain.
+ */
+declare function getAuthHint(domain: string): ProviderHint | null;
+
+export { type ByokAuth, type DirxEndpoint, type DirxEnvelope, type DirxService, type EndpointMatch, type ProviderHint, type SearchResult, getAuthHint };

package/dist/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Shared DirX types for CLI, SDK, and server interop.
+ *
+ * DirxEnvelope is the canonical response wrapper used by the gateway.
+ * All other types define the domain model for DirX services.
+ */
+interface DirxEnvelope<T = unknown> {
+    ok: boolean;
+    data?: T;
+    error?: string | {
+        code: string;
+        message: string;
+    };
+    meta?: Record<string, unknown>;
+}
+interface DirxEndpoint {
+    path: string;
+    method: string;
+    description?: string;
+}
+interface DirxService {
+    title: string;
+    description?: string;
+    base_url: string;
+    actions: string[];
+    endpoints: DirxEndpoint[];
+}
+interface SearchResult {
+    domain: string;
+    title: string;
+    description?: string;
+    path?: string;
+    score?: number;
+    matched_endpoints?: EndpointMatch[];
+}
+interface EndpointMatch {
+    method: string;
+    path: string;
+    description?: string;
+}
+interface ByokAuth {
+    type: string;
+    token?: string;
+    header?: string;
+    key?: string;
+}
+interface ProviderHint {
+    envVar?: string;
+    guideUrl: string;
+}
+/**
+ * Get authentication hint for a known provider domain.
+ */
+declare function getAuthHint(domain: string): ProviderHint | null;
+
+export { type ByokAuth, type DirxEndpoint, type DirxEnvelope, type DirxService, type EndpointMatch, type ProviderHint, type SearchResult, getAuthHint };

package/dist/types.js

@@ -0,0 +1,6 @@
+import {
+  getAuthHint
+} from "./chunk-VTJP4C2Q.js";
+export {
+  getAuthHint
+};

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@dirxai/core",
-    "version": "0.3.0",
-    "description": "DirX server-side SDK — Guard middleware, JWKS auth, AgentContext, error codes",
+    "version": "0.3.1",
+    "description": "DirX SDK — scanner, types, Guard middleware, JWKS auth, error model",
     "license": "MIT",
     "type": "module",
     "main": "./dist/index.cjs",
@@ -17,6 +17,16 @@
             "types": "./dist/testing.d.ts",
             "import": "./dist/testing.js",
             "require": "./dist/testing.cjs"
+        },
+        "./scanner": {
+            "types": "./dist/scanner/index.d.ts",
+            "import": "./dist/scanner/index.js",
+            "require": "./dist/scanner/index.cjs"
+        },
+        "./types": {
+            "types": "./dist/types.d.ts",
+            "import": "./dist/types.js",
+            "require": "./dist/types.cjs"
         }
     },
     "scripts": {
@@ -36,6 +46,7 @@
         "dirx",
         "agent",
         "sdk",
+        "scanner",
         "gateway",
         "guard",
         "jwks",