@warlock.js/core 5.31.0 → 5.32.0

package/esm/tooling/inspect/inspect-report.types.d.mts

@@ -1,5 +1,4 @@
 import { WarlockErrorCode } from "../../errors/error-codes.mjs";
-
 //#region ../../packages/core/src/tooling/inspect/inspect-report.types.d.ts
 /**
  * @fileoverview The `warlock inspect` report, schema version 1.
@@ -16,88 +15,110 @@ import { WarlockErrorCode } from "../../errors/error-codes.mjs";
  * `INSPECT_REPORT_JSON_SCHEMA` constant.
  */
 /** The version of the report shape. Bumped only for a breaking change. */
-declare const INSPECT_SCHEMA_VERSION = 1;
+export declare const INSPECT_SCHEMA_VERSION = 1;
 /** Every section the report can contain, in output order. */
-declare const INSPECT_SECTIONS: readonly ["routes", "models", "resources", "config", "events", "pages", "jobs", "schedules", "packages"];
+export declare const INSPECT_SECTIONS: readonly ["routes", "models", "resources", "config", "events", "pages", "jobs", "schedules", "packages"];
 /** One section name. */
-type InspectSection = (typeof INSPECT_SECTIONS)[number];
+export type InspectSection = (typeof INSPECT_SECTIONS)[number];
 /** A JSON Schema (draft 2020-12) fragment. */
-type JsonSchema = Record<string, unknown>;
+export type JsonSchema = Record<string, unknown>;
 /** Who guards a route, from the descriptor `authMiddleware()` attaches. */
-type InspectRouteAuth = {
-  /** Whether an auth guard runs on the route. */required: boolean; /** Where the token is read: `"header"` (bearer) or `{ cookie }`. */
+export type InspectRouteAuth = {
+  /** Whether an auth guard runs on the route. */
+  required: boolean;
+  /** Where the token is read: `"header"` (bearer) or `{ cookie }`. */
   sources: ("header" | {
     cookie: string;
-  })[]; /** User types the guard accepts; empty means any. */
+  })[];
+  /** User types the guard accepts; empty means any. */
   userTypes: string[];
 };
 /** The rate limit a route runs under. */
-type InspectRouteRateLimit = {
-  /** `route` = the route's own option, `global` = `http.rateLimit`, `none` = no limiter. */source: "route" | "global" | "none"; /** Max requests per window; `"dynamic"` when configured as a function. */
-  max: number | "dynamic" | null; /** Window in milliseconds, or the configured string (`"1 minute"`); `"dynamic"` for a function. */
+export type InspectRouteRateLimit = {
+  /** `route` = the route's own option, `global` = `http.rateLimit`, `none` = no limiter. */
+  source: "route" | "global" | "none";
+  /** Max requests per window; `"dynamic"` when configured as a function. */
+  max: number | "dynamic" | null;
+  /** Window in milliseconds, or the configured string (`"1 minute"`); `"dynamic"` for a function. */
   timeWindow: number | string | null;
 };
 /** What the route's request log entries keep. */
-type InspectRouteLogging = {
-  /** Whether the request body is logged. */body: boolean; /** Whether the query string is logged. */
-  query: boolean; /** Whether `http.logging.private` rules exist that may remove more for some URLs. */
+export type InspectRouteLogging = {
+  /** Whether the request body is logged. */
+  body: boolean;
+  /** Whether the query string is logged. */
+  query: boolean;
+  /** Whether `http.logging.private` rules exist that may remove more for some URLs. */
   privateRules: boolean;
 };
 /** One request parameter (path, query or header). */
-type InspectParameter = {
+export type InspectParameter = {
   name: string;
   in: "path" | "query" | "header" | "cookie";
   required: boolean;
   schema: JsonSchema;
 };
 /** One registered HTTP route. */
-type InspectRoute = {
-  /** Uppercase method, `ALL` for `router.all`. */method: string;
+export type InspectRoute = {
+  /** Uppercase method, `ALL` for `router.all`. */
+  method: string;
   path: string;
-  name: string | null; /** Project-relative file that registered the route. */
-  sourceFile: string | null; /** Handler function name, `"anonymous"` when it has none. */
+  name: string | null;
+  /** Project-relative file that registered the route. */
+  sourceFile: string | null;
+  /** Handler function name, `"anonymous"` when it has none. */
   handler: string;
-  description: string | null; /** Whether a page (SSR) route registered it. */
-  isPage: boolean; /** Middleware function names in run order. */
+  description: string | null;
+  /** Whether a page (SSR) route registered it. */
+  isPage: boolean;
+  /** Middleware function names in run order. */
   middleware: string[];
-  auth: InspectRouteAuth; /** `false` when the route opted out of the CSRF origin guard (`csrf: false`). */
+  auth: InspectRouteAuth;
+  /** `false` when the route opted out of the CSRF origin guard (`csrf: false`). */
   csrf: boolean;
   rateLimit: InspectRouteRateLimit;
   logging: InspectRouteLogging;
   request: {
-    parameters: InspectParameter[]; /** JSON Schema of the request body, or `null`. */
-    body: JsonSchema | null; /** Whether `validation.validate` (custom middleware, not described) is set. */
+    parameters: InspectParameter[];
+    /** JSON Schema of the request body, or `null`. */
+    body: JsonSchema | null;
+    /** Whether `validation.validate` (custom middleware, not described) is set. */
     customValidation: boolean;
-  }; /** Declared responses keyed by status code. */
+  };
+  /** Declared responses keyed by status code. */
   responses: Record<string, {
     description: string;
     schema: JsonSchema | null;
   }>;
 };
 /** One model column, from the model's Seal `schema`. */
-type InspectModelColumn = {
+export type InspectModelColumn = {
   name: string;
   required: boolean;
   schema: JsonSchema;
 };
 /** One model relation. */
-type InspectModelRelation = {
+export type InspectModelRelation = {
   name: string;
-  type: string; /** Target model name, or `null` when it could not be resolved. */
+  type: string;
+  /** Target model name, or `null` when it could not be resolved. */
   model: string | null;
   foreignKey: string | null;
   localKey: string | null;
 };
 /** One model class. */
-type InspectModel = {
+export type InspectModel = {
   name: string;
   table: string | null;
-  primaryKey: string | null; /** Data source name, when configured by name. */
+  primaryKey: string | null;
+  /** Data source name, when configured by name. */
   dataSource: string | null;
-  sourceFile: string | null; /** Whether `@RegisterModel()` put it in the registry. */
+  sourceFile: string | null;
+  /** Whether `@RegisterModel()` put it in the registry. */
   registered: boolean;
   columns: InspectModelColumn[];
-  relations: InspectModelRelation[]; /** Name of the model's `static resource`, a key of `components.schemas`. */
+  relations: InspectModelRelation[];
+  /** Name of the model's `static resource`, a key of `components.schemas`. */
   resource: string | null;
   deleteStrategy: string | null;
   createdAtColumn: string | null;
@@ -105,19 +126,23 @@ type InspectModel = {
   deletedAtColumn: string | null;
 };
 /** One resource class reached from a route or a model. */
-type InspectResource = {
-  name: string; /** Its output shape (JSON Schema; nested resources are `$ref`s into `components.schemas`). */
-  schema: JsonSchema; /** Models whose `static resource` is this resource. */
+export type InspectResource = {
+  name: string;
+  /** Its output shape (JSON Schema; nested resources are `$ref`s into `components.schemas`). */
+  schema: JsonSchema;
+  /** Models whose `static resource` is this resource. */
   models: string[];
 };
 /** One config key: its path and value type. Values are never printed. */
-type InspectConfigKey = {
-  key: string; /** `string`, `number`, `boolean`, `null`, `array`, `object`, `function`, `regexp`, `date`, or a class name. */
-  type: string; /** The `src/config/*` file the top-level key comes from, when it exists. */
+export type InspectConfigKey = {
+  key: string;
+  /** `string`, `number`, `boolean`, `null`, `array`, `object`, `function`, `regexp`, `date`, or a class name. */
+  type: string;
+  /** The `src/config/*` file the top-level key comes from, when it exists. */
   file: string | null;
 };
 /** One event and the listeners app modules registered for it. */
-type InspectEvent = {
+export type InspectEvent = {
   event: string;
   listeners: {
     name: string;
@@ -125,17 +150,21 @@ type InspectEvent = {
   }[];
 };
 /** One page installed by `@warlock.js/web`. */
-type InspectPage = {
+export type InspectPage = {
   path: string;
   name: string | null;
-  file: string; /** Layout files from the outermost to the page's own directory. */
-  layouts: string[]; /** Files on the chain (layouts, then the page) that export a `loader`. */
-  loaders: string[]; /** Action names the page exports (`"default"` for `action`). */
-  actions: string[]; /** `"user"` when the page or a layout statically requires a user. */
+  file: string;
+  /** Layout files from the outermost to the page's own directory. */
+  layouts: string[];
+  /** Files on the chain (layouts, then the page) that export a `loader`. */
+  loaders: string[];
+  /** Action names the page exports (`"default"` for `action`). */
+  actions: string[];
+  /** `"user"` when the page or a layout statically requires a user. */
   guard: string | null;
 };
 /** One queue job defined with `defineJob()`. */
-type InspectJob = {
+export type InspectJob = {
   name: string;
   queue: string;
   attempts: number | null;
@@ -147,35 +176,38 @@ type InspectJob = {
   removeOnFail: boolean | number | null;
 };
 /** One scheduled task on the `@warlock.js/scheduler` scheduler. */
-type InspectSchedule = {
+export type InspectSchedule = {
   name: string;
   cron: string | null;
   intervals: Record<string, unknown>;
   nextRun: string | null;
 };
 /** One installed `@warlock.js/*` package. */
-type InspectPackage = {
+export type InspectPackage = {
   name: string;
   version: string;
 };
 /** Something inspect could not read, with its code when one applies. */
-type InspectWarning = {
+export type InspectWarning = {
   code: WarlockErrorCode | null;
-  message: string; /** The section or file it concerns. */
+  message: string;
+  /** The section or file it concerns. */
   source: string | null;
 };
 /** The whole report. Sections not requested are absent. */
-type InspectReport = {
+export type InspectReport = {
   schemaVersion: typeof INSPECT_SCHEMA_VERSION;
   generatedAt: string;
   app: {
     name: string | null;
-    version: string | null; /** Absolute project root. */
+    version: string | null;
+    /** Absolute project root. */
     root: string;
     node: string;
     environment: string;
     runtimeStrategy: string;
-  }; /** The sections this report contains. */
+  };
+  /** The sections this report contains. */
   sections: InspectSection[];
   routes?: InspectRoute[];
   models?: InspectModel[];
@@ -185,12 +217,12 @@ type InspectReport = {
   pages?: InspectPage[];
   jobs?: InspectJob[];
   schedules?: InspectSchedule[];
-  packages?: InspectPackage[]; /** Shared schemas that `$ref`s point at (`#/components/schemas/<name>`). */
+  packages?: InspectPackage[];
+  /** Shared schemas that `$ref`s point at (`#/components/schemas/<name>`). */
   components: {
     schemas: Record<string, JsonSchema>;
   };
   warnings: InspectWarning[];
 };
 //#endregion
-export { INSPECT_SCHEMA_VERSION, INSPECT_SECTIONS, InspectConfigKey, InspectEvent, InspectJob, InspectModel, InspectModelColumn, InspectModelRelation, InspectPackage, InspectPage, InspectParameter, InspectReport, InspectResource, InspectRoute, InspectRouteAuth, InspectRouteLogging, InspectRouteRateLimit, InspectSchedule, InspectSection, InspectWarning, JsonSchema };
 //# sourceMappingURL=inspect-report.types.d.mts.map

package/esm/tooling/inspect/inspect-report.types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"inspect-report.types.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/inspect-report.types.ts"],"mappings":"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"}
+{"version":3,"file":"inspect-report.types.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/inspect/inspect-report.types.ts"],"mappings":";;;;;;;;;;;;;;;;;qBAkBa;;qBAGA;;YAaD,yBAAyB;;YAGzB,aAAa;;YAGb;;EAEV;;EAEA;IAAuB;;;EAEvB;;;YAIU;;EAEV;;EAEA;;EAEA;;;YAIU;;EAEV;;EAEA;;EAEA;;;YAIU;EACV;EACA;EACA;EACA,QAAQ;;;YAIE;;EAEV;EACA;EACA;;EAEA;;EAEA;EACA;;EAEA;;EAEA;EACA,MAAM;;EAEN;EACA,WAAW;EACX,SAAS;EACT;IACE,YAAY;;IAEZ,MAAM;;IAEN;;;EAGF,WAAW;IAAiB;IAAqB,QAAQ;;;;YAI/C;EACV;EACA;EACA,QAAQ;;;YAIE;EACV;EACA;;EAEA;EACA;EACA;;;YAIU;EACV;EACA;EACA;;EAEA;EACA;;EAEA;EACA,SAAS;EACT,WAAW;;EAEX;EACA;EACA;EACA;EACA;;;YAIU;EACV;;EAEA,QAAQ;;EAER;;;YAIU;EACV;;EAEA;;EAEA;;;YAIU;EACV;EACA;IAAa;IAAc;;;;YAIjB;EACV;EACA;EACA;;EAEA;;EAEA;;EAEA;;EAEA;;;YAIU;EACV;EACA;EACA;EACA;IAAoB;IAAc;;EAClC;EACA;;;YAIU;EACV;EACA;EACA,WAAW;EACX;;;YAIU;EACV;EACA;;;YAIU;EACV,MAAM;EACN;;EAEA;;;YAIU;EACV,sBAAsB;EACtB;EACA;IACE;IACA;;IAEA;IACA;IACA;IACA;;;EAGF,UAAU;EACV,SAAS;EACT,SAAS;EACT,YAAY;EACZ,SAAS;EACT,SAAS;EACT,QAAQ;EACR,OAAO;EACP,YAAY;EACZ,WAAW;;EAEX;IAAc,SAAS,eAAe;;EACtC,UAAU"}

package/esm/tooling/mcp/create-mcp-context.d.mts

@@ -1,26 +1,29 @@
 import { InspectReport, InspectSection } from "../inspect/inspect-report.types.mjs";
 import { ConnectDevtoolsOptions } from "../devtools/devtools-client.mjs";
 import { WarlockMcpContext } from "./mcp-tools.mjs";
-
 //#region ../../packages/core/src/tooling/mcp/create-mcp-context.d.ts
 /** Options of {@link createMcpContext}. */
-type CreateMcpContextOptions = {
-  /** Project root. Default: `process.cwd()`. */cwd?: string; /** Let generate tools write into the project. Default `false`. */
-  allowWrites?: boolean; /** How the app is described: a booted snapshot (`warlock mcp`) or the live process (`warlock dev --mcp`). */
+export type CreateMcpContextOptions = {
+  /** Project root. Default: `process.cwd()`. */
+  cwd?: string;
+  /** Let generate tools write into the project. Default `false`. */
+  allowWrites?: boolean;
+  /** How the app is described: a booted snapshot (`warlock mcp`) or the live process (`warlock dev --mcp`). */
   inspect: (sections: readonly InspectSection[]) => Promise<InspectReport>;
   /**
    * The `warlock` CLI script. Runs the typecheck in a child process (so a heap
    * overflow cannot end the server) and the generators. Default: core's bin.
    */
-  cliEntry?: string; /** Where the dev server is, for `requests_recent`. Default: `.warlock/dev-server.json`. */
-  devtools?: Omit<ConnectDevtoolsOptions, "cwd">; /** The `warlock add` feature names to advertise. */
+  cliEntry?: string;
+  /** Where the dev server is, for `requests_recent`. Default: `.warlock/dev-server.json`. */
+  devtools?: Omit<ConnectDevtoolsOptions, "cwd">;
+  /** The `warlock add` feature names to advertise. */
   features?: readonly string[];
 };
 /**
  * The real {@link WarlockMcpContext}: `warlock check`, `runTests`, the devtools
  * client, the sandboxed generators and the installed-docs corpus (loaded once).
  */
-declare function createMcpContext(options: CreateMcpContextOptions): WarlockMcpContext;
+export declare function createMcpContext(options: CreateMcpContextOptions): WarlockMcpContext;
 //#endregion
-export { CreateMcpContextOptions, createMcpContext };
 //# sourceMappingURL=create-mcp-context.d.mts.map

package/esm/tooling/mcp/create-mcp-context.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"create-mcp-context.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/mcp/create-mcp-context.ts"],"mappings":";;;;;;KAYY,uBAAA;EAAA,8CAEV,GAAA;EAEA,WAAA,YAE0D;EAA1D,OAAA,GAAU,QAAA,WAAmB,cAAA,OAAqB,OAAA,CAAQ,aAAA;EAO1C;;;;EAFhB,QAAA,WAPA;EASA,QAAA,GAAW,IAAA,CAAK,sBAAA,UAPa;EAS7B,QAAA;AAAA;;;;;iBAgBc,gBAAA,CAAiB,OAAA,EAAS,uBAAA,GAA0B,iBAAiB"}
+{"version":3,"file":"create-mcp-context.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/mcp/create-mcp-context.ts"],"mappings":";;;;;YAYY;;EAEV;;EAEA;;EAEA,UAAU,mBAAmB,qBAAqB,QAAQ;;;;;EAK1D;;EAEA,WAAW,KAAK;;EAEhB;;;;;;wBAgBc,iBAAiB,SAAS,0BAA0B"}

package/esm/tooling/mcp/db-schema.d.mts

@@ -1,12 +1,13 @@
 import { InspectModel, JsonSchema } from "../inspect/inspect-report.types.mjs";
-
 //#region ../../packages/core/src/tooling/mcp/db-schema.d.ts
 /** One column of a {@link DbSchemaTable}. */
-type DbSchemaColumn = {
-  name: string; /** The JSON Schema `type` (`string`, `integer`, …), `format` appended when set (`string:date-time`). */
+export type DbSchemaColumn = {
+  name: string;
+  /** The JSON Schema `type` (`string`, `integer`, …), `format` appended when set (`string:date-time`). */
   type: string;
   required: boolean;
-  primaryKey: boolean; /** Set when a `belongsTo` relation uses this column. */
+  primaryKey: boolean;
+  /** Set when a `belongsTo` relation uses this column. */
   references: {
     model: string | null;
     column: string | null;
@@ -14,7 +15,7 @@ type DbSchemaColumn = {
   schema: JsonSchema;
 };
 /** One table, as the app's models declare it. */
-type DbSchemaTable = {
+export type DbSchemaTable = {
   table: string | null;
   model: string;
   dataSource: string | null;
@@ -30,8 +31,9 @@ type DbSchemaTable = {
   deleteStrategy: string | null;
 };
 /** What the `db_schema` tool returns. */
-type DbSchema = {
-  /** Where the facts come from: the models' Seal schemas, not the live database. */source: "models";
+export type DbSchema = {
+  /** Where the facts come from: the models' Seal schemas, not the live database. */
+  source: "models";
   tables: DbSchemaTable[];
 };
 /**
@@ -43,7 +45,6 @@ type DbSchema = {
  * what code is written against. It does not open a database connection, so
  * columns that exist only in a migration are not listed.
  */
-declare function buildDbSchema(models: readonly InspectModel[], filter?: string): DbSchema;
+export declare function buildDbSchema(models: readonly InspectModel[], filter?: string): DbSchema;
 //#endregion
-export { DbSchema, DbSchemaColumn, DbSchemaTable, buildDbSchema };
 //# sourceMappingURL=db-schema.d.mts.map

package/esm/tooling/mcp/db-schema.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"db-schema.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/mcp/db-schema.ts"],"mappings":";;;;KAGY,cAAA;EACV,IAAA,UADwB;EAGxB,IAAA;EACA,QAAA;EACA,UAAA,WAFA;EAIA,UAAA;IAAc,KAAA;IAAsB,MAAA;EAAA;EACpC,MAAA,EAAQ,UAAU;AAAA;;KAIR,aAAA;EACV,KAAA;EACA,KAAA;EACA,UAAA;EACA,UAAA;EACA,UAAA;EACA,OAAA,EAAS,cAAA;EACT,SAAA,EAAW,YAAY;EACvB,UAAA;IAAc,SAAA;IAA0B,SAAA;IAA0B,SAAA;EAAA;EAClE,cAAA;AAAA;;KAIU,QAAA;EAL8B,kFAOxC,MAAA;EACA,MAAA,EAAQ,aAAa;AAAA;AAPP;AAIhB;;;;;;;;AAJgB,iBA+BA,aAAA,CAAc,MAAA,WAAiB,YAAA,IAAgB,MAAA,YAAkB,QAAQ"}
+{"version":3,"file":"db-schema.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/mcp/db-schema.ts"],"mappings":";;;YAGY;EACV;;EAEA;EACA;EACA;;EAEA;IAAc;IAAsB;;EACpC,QAAQ;;;YAIE;EACV;EACA;EACA;EACA;EACA;EACA,SAAS;EACT,WAAW;EACX;IAAc;IAA0B;IAA0B;;EAClE;;;YAIU;;EAEV;EACA,QAAQ;;;;;;;;;;;wBAwBM,cAAc,iBAAiB,gBAAgB,kBAAkB"}

package/esm/tooling/mcp/docs-search.d.mts

@@ -6,41 +6,47 @@
  * versions in `node_modules`, not whatever the website documents today.
  */
 /** The globs, relative to the project root, that make up the corpus. */
-declare const DOCS_CORPUS_GLOBS: readonly ["node_modules/@warlock.js/*/skills/**/*.md", "node_modules/@warlock.js/*/README.md", "node_modules/@warlock.js/*/llms.txt", "node_modules/@warlock.js/*/llms-full.txt"];
+export declare const DOCS_CORPUS_GLOBS: readonly ["node_modules/@warlock.js/*/skills/**/*.md", "node_modules/@warlock.js/*/README.md", "node_modules/@warlock.js/*/llms.txt", "node_modules/@warlock.js/*/llms-full.txt"];
 /** One searchable section: a file split at its markdown headings. */
-type DocsSection = {
-  /** `@warlock.js/<name>`. */package: string; /** Project-relative POSIX path of the file. */
-  file: string; /** `skill`, `readme` or `llms`. */
-  source: "skill" | "readme" | "llms"; /** The section heading, or the file name for text before the first heading. */
-  heading: string; /** 1-based line where the section starts. */
+export type DocsSection = {
+  /** `@warlock.js/<name>`. */
+  package: string;
+  /** Project-relative POSIX path of the file. */
+  file: string;
+  /** `skill`, `readme` or `llms`. */
+  source: "skill" | "readme" | "llms";
+  /** The section heading, or the file name for text before the first heading. */
+  heading: string;
+  /** 1-based line where the section starts. */
   line: number;
   text: string;
 };
 /** One search hit. */
-type DocsSearchHit = {
+export type DocsSearchHit = {
   package: string;
   file: string;
   source: DocsSection["source"];
   heading: string;
   line: number;
-  score: number; /** The section's lines around the first match, bounded. */
+  score: number;
+  /** The section's lines around the first match, bounded. */
   excerpt: string;
 };
 /** The loaded corpus. */
-type DocsCorpus = {
+export type DocsCorpus = {
   files: string[];
   sections: DocsSection[];
 };
 /** Split markdown text into heading-delimited sections. */
-declare function splitSections(text: string, meta: {
+export declare function splitSections(text: string, meta: {
   package: string;
   file: string;
   source: DocsSection["source"];
 }): DocsSection[];
 /** Load the corpus of the app at `cwd`. Unreadable files are skipped. */
-declare function loadDocsCorpus(cwd: string): Promise<DocsCorpus>;
+export declare function loadDocsCorpus(cwd: string): Promise<DocsCorpus>;
 /** Lower-cased search terms of two or more characters. */
-declare function searchTerms(query: string): string[];
+export declare function searchTerms(query: string): string[];
 /**
  * Rank sections for a query: every term found in the heading counts 5, in the
  * body 1 per occurrence (capped), and each distinct term found adds 10, so a
@@ -48,7 +54,7 @@ declare function searchTerms(query: string): string[];
  * above READMEs above llms files on equal scores; the generated `llms-full.txt`
  * repeats the skills, so it is weighted down.
  */
-declare function searchDocs(corpus: DocsCorpus, query: string, options?: {
+export declare function searchDocs(corpus: DocsCorpus, query: string, options?: {
   limit?: number;
   package?: string;
 }): DocsSearchHit[];
@@ -58,7 +64,7 @@ declare function searchDocs(corpus: DocsCorpus, query: string, options?: {
  *
  * @returns `undefined` when `file` is not in the corpus.
  */
-declare function readDocsFile(corpus: DocsCorpus, cwd: string, file: string, options?: {
+export declare function readDocsFile(corpus: DocsCorpus, cwd: string, file: string, options?: {
   heading?: string;
   maxBytes?: number;
 }): {
@@ -68,5 +74,4 @@ declare function readDocsFile(corpus: DocsCorpus, cwd: string, file: string, opt
   truncated: boolean;
 } | undefined;
 //#endregion
-export { DOCS_CORPUS_GLOBS, DocsCorpus, DocsSearchHit, DocsSection, loadDocsCorpus, readDocsFile, searchDocs, searchTerms, splitSections };
 //# sourceMappingURL=docs-search.d.mts.map

package/esm/tooling/mcp/docs-search.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"docs-search.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/mcp/docs-search.ts"],"mappings":";;AAYA;;;;AAKU;AAGV;AAAA,cARa,iBAAA;;KAQD,WAAA;EAEV,4BAAA,OAAA,UAIA;EAFA,IAAA,UAMA;EAJA,MAAA,+BAKI;EAHJ,OAAA,UAOU;EALV,IAAA;EACA,IAAA;AAAA;;KAIU,aAAA;EACV,OAAA;EACA,IAAA;EACA,MAAA,EAAQ,WAAW;EACnB,OAAA;EACA,IAAA;EACA,KAAA,UAEO;EAAP,OAAA;AAAA;;KAIU,UAAA;EACV,KAAA;EACA,QAAA,EAAU,WAAW;AAAA;;iBAmBP,aAAA,CACd,IAAA,UACA,IAAA;EAAQ,OAAA;EAAiB,IAAA;EAAc,MAAA,EAAQ,WAAA;AAAA,IAC9C,WAAW;;iBAoCQ,cAAA,CAAe,GAAA,WAAc,OAAO,CAAC,UAAA;;iBAwB3C,WAAA,CAAY,KAAa;;;;;;AA5D3B;AAoCd;iBAmEgB,UAAA,CACd,MAAA,EAAQ,UAAA,EACR,KAAA,UACA,OAAA;EAAW,KAAA;EAAgB,OAAA;AAAA,IAC1B,aAAa;;;;AAvEqD;AAwBrE;;iBA2GgB,YAAA,CACd,MAAA,EAAQ,UAAU,EAClB,GAAA,UACA,IAAA,UACA,OAAA;EAAW,OAAA;EAAkB,QAAA;AAAA;EAC1B,IAAA;EAAc,OAAA;EAAwB,IAAA;EAAc,SAAA;AAAA"}
+{"version":3,"file":"docs-search.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/mcp/docs-search.ts"],"mappings":";;;;;;;;qBAYa;;YAQD;;EAEV;;EAEA;;EAEA;;EAEA;;EAEA;EACA;;;YAIU;EACV;EACA;EACA,QAAQ;EACR;EACA;EACA;;EAEA;;;YAIU;EACV;EACA,UAAU;;;wBAmBI,cACd,cACA;EAAQ;EAAiB;EAAc,QAAQ;IAC9C;;wBAoCmB,eAAe,cAAc,QAAQ;;wBAwB3C,YAAY;;;;;;;;wBA2CZ,WACd,QAAQ,YACR,eACA;EAAW;EAAgB;IAC1B;;;;;;;wBA4Da,aACd,QAAQ,YACR,aACA,cACA;EAAW;EAAkB;;EAC1B;EAAc;EAAwB;EAAc"}

package/esm/tooling/mcp/index.mjs

@@ -6,4 +6,4 @@ import { inputSchema, toStandardSchema, validateToolInput } from "./tool-input.m
 import { MCP_MAKE_GENERATORS, createWarlockMcpTools, describeToolError, makeSpecFromInput } from "./mcp-tools.mjs";
 import { isLoopbackHost, resolveMcpTransport, startWarlockMcpServer, toServeContract } from "./start-mcp-server.mjs";
 
-export {  };
+export { DOCS_CORPUS_GLOBS, MCP_INSTALL_HINT, MCP_MAKE_GENERATORS, buildDbSchema, createMcpContext, createWarlockMcpTools, describeToolError, inputSchema, isAiToolsServeModule, isLoopbackHost, loadAiToolsServe, loadDocsCorpus, makeSpecFromInput, readDocsFile, resolveMcpTransport, searchDocs, searchTerms, splitSections, startWarlockMcpServer, toServeContract, toStandardSchema, validateToolInput };

package/esm/tooling/mcp/load-ai-tools.d.mts

@@ -1,8 +1,8 @@
 //#region ../../packages/core/src/tooling/mcp/load-ai-tools.d.ts
 /** The install line printed when the MCP transport packages are missing. */
-declare const MCP_INSTALL_HINT = "npm install -D @warlock.js/ai-tools @warlock.js/ai";
+export declare const MCP_INSTALL_HINT = "npm install -D @warlock.js/ai-tools @warlock.js/ai";
 /** The tool shape `ai.mcp.serve` consumes, built structurally (see `@warlock.js/ai`'s `ToolContract`). */
-type ServeToolContract = {
+export type ServeToolContract = {
   name: string;
   description: string;
   input: unknown;
@@ -19,7 +19,7 @@ type ServeToolContract = {
   }>;
 };
 /** The transport options of `ai.mcp.serve` this command uses. */
-type ServeTransportOptions = {
+export type ServeTransportOptions = {
   type: "stdio";
 } | {
   type: "http";
@@ -31,12 +31,12 @@ type ServeTransportOptions = {
   };
 };
 /** The handle `start()` resolves. */
-type ServeHandle = {
+export type ServeHandle = {
   url?: string;
   close(): Promise<void>;
 };
 /** The slice of `@warlock.js/ai-tools` this command calls. */
-type AiToolsServeModule = {
+export type AiToolsServeModule = {
   serve(tools: ServeToolContract[], options: {
     name: string;
     version?: string;
@@ -47,7 +47,7 @@ type AiToolsServeModule = {
   };
 };
 /** Whether a loaded module exposes `serve()`. */
-declare function isAiToolsServeModule(value: unknown): value is AiToolsServeModule;
+export declare function isAiToolsServeModule(value: unknown): value is AiToolsServeModule;
 /**
  * Import `@warlock.js/ai-tools` lazily — it is an optional peer, so a project
  * that never runs `warlock mcp` does not need it. Tries core's own resolution
@@ -56,7 +56,6 @@ declare function isAiToolsServeModule(value: unknown): value is AiToolsServeModu
  * Throws `WL7003` with the install line when it (or `@warlock.js/ai`, which
  * it imports) is missing.
  */
-declare function loadAiToolsServe(cwd: string, importer?: (specifier: string) => Promise<unknown>): Promise<AiToolsServeModule>;
+export declare function loadAiToolsServe(cwd: string, importer?: (specifier: string) => Promise<unknown>): Promise<AiToolsServeModule>;
 //#endregion
-export { AiToolsServeModule, MCP_INSTALL_HINT, ServeToolContract, ServeTransportOptions, isAiToolsServeModule, loadAiToolsServe };
 //# sourceMappingURL=load-ai-tools.d.mts.map

package/esm/tooling/mcp/load-ai-tools.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"load-ai-tools.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/mcp/load-ai-tools.ts"],"mappings":";;cAMa,gBAAA;;KAGD,iBAAA;EACV,IAAA;EACA,WAAA;EACA,KAAA;EACA,OAAA,CAAQ,KAAA,EAAO,MAAA,oBAA0B,OAAA;EACzC,MAAA,CACE,GAAA,WACA,OAAA,aACC,OAAA;IACD,IAAA;IACA,KAAA,GAAQ,KAAA;IACR,KAAA;MAAS,KAAA;MAAe,MAAA;MAAgB,KAAA;IAAA;IACxC,MAAA,EAAQ,MAAA;EAAA;AAAA;;KAKA,qBAAA;EACN,IAAA;AAAA;EAEA,IAAA;EACA,IAAA;EACA,IAAA;EACA,IAAA;EACA,IAAA;IAAS,MAAA;EAAA;AAAA;;KAIH,WAAA;EAAgB,GAAA;EAAc,KAAA,IAAS,OAAO;AAAA;;KAG9C,kBAAA;EACV,KAAA,CACE,KAAA,EAAO,iBAAA,IACP,OAAA;IAAW,IAAA;IAAc,OAAA;IAAkB,SAAA,EAAW,qBAAA;EAAA;IACnD,KAAA,IAAS,OAAA,CAAQ,WAAA;IAAc,IAAA,IAAQ,OAAA;EAAA;AAAA;;iBAI9B,oBAAA,CAAqB,KAAA,YAAiB,KAAA,IAAS,kBAAkB;;AAf5D;AAIrB;;;;;;iBAuCsB,gBAAA,CACpB,GAAA,UACA,QAAA,IAAW,SAAA,aAAsB,OAAA,YAChC,OAAA,CAAQ,kBAAA"}
+{"version":3,"file":"load-ai-tools.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/mcp/load-ai-tools.ts"],"mappings":";;qBAMa;;YAGD;EACV;EACA;EACA;EACA,QAAQ,OAAO,0BAA0B;EACzC,OACE,cACA,oBACC;IACD;IACA,QAAQ;IACR;MAAS;MAAe;MAAgB;;IACxC,QAAQ;;;;YAKA;EACN;;EAEA;EACA;EACA;EACA;EACA;IAAS;;;;YAIH;EAAgB;EAAc,SAAS;;;YAGvC;EACV,MACE,OAAO,qBACP;IAAW;IAAc;IAAkB,WAAW;;IACnD,SAAS,QAAQ;IAAc,QAAQ;;;;wBAI9B,qBAAqB,iBAAiB,SAAS;;;;;;;;;wBA4BzC,iBACpB,aACA,YAAW,sBAAsB,mBAChC,QAAQ"}

package/esm/tooling/mcp/load-ai-tools.mjs

@@ -36,7 +36,8 @@ async function loadAiToolsServe(cwd, importer = (specifier) => import(specifier)
 		lastError = error;
 		if (!isMissingModule(error, PACKAGES) && !(error instanceof Error && /Cannot find package/.test(error.message))) break;
 	}
-	throw new WarlockError("WL7003", `warlock mcp needs @warlock.js/ai-tools (and @warlock.js/ai), which could not be loaded: ${lastError instanceof Error ? lastError.message : String(lastError)}. Install them: ${MCP_INSTALL_HINT}`, { cause: lastError });
+	const reason = lastError instanceof Error ? lastError.message : String(lastError);
+	throw new WarlockError("WL7003", `warlock mcp needs @warlock.js/ai-tools (and @warlock.js/ai), which could not be loaded: ${reason}. Install them: ${MCP_INSTALL_HINT}`, { cause: lastError });
 }
 
 //#endregion

package/esm/tooling/mcp/load-ai-tools.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"load-ai-tools.mjs","names":["resolveModule"],"sources":["../../../../../../../../../packages/core/src/tooling/mcp/load-ai-tools.ts"],"sourcesContent":["import path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { resolve as resolveModule } from \"import-meta-resolve\";\nimport { WarlockError } from \"../../errors/warlock-error\";\n\n/** The install line printed when the MCP transport packages are missing. */\nexport const MCP_INSTALL_HINT = \"npm install -D @warlock.js/ai-tools @warlock.js/ai\";\n\n/** The tool shape `ai.mcp.serve` consumes, built structurally (see `@warlock.js/ai`'s `ToolContract`). */\nexport type ServeToolContract = {\n  name: string;\n  description: string;\n  input: unknown;\n  execute(input: Record<string, unknown>): Promise<unknown>;\n  invoke(\n    raw: unknown,\n    context?: unknown,\n  ): Promise<{\n    data?: unknown;\n    error?: Error;\n    usage: { input: number; output: number; total: number };\n    report: Record<string, unknown>;\n  }>;\n};\n\n/** The transport options of `ai.mcp.serve` this command uses. */\nexport type ServeTransportOptions =\n  | { type: \"stdio\" }\n  | {\n      type: \"http\";\n      host: string;\n      port: number;\n      path: string;\n      auth?: { bearer: string };\n    };\n\n/** The handle `start()` resolves. */\nexport type ServeHandle = { url?: string; close(): Promise<void> };\n\n/** The slice of `@warlock.js/ai-tools` this command calls. */\nexport type AiToolsServeModule = {\n  serve(\n    tools: ServeToolContract[],\n    options: { name: string; version?: string; transport: ServeTransportOptions },\n  ): { start(): Promise<ServeHandle>; stop(): Promise<void> };\n};\n\n/** Whether a loaded module exposes `serve()`. */\nexport function isAiToolsServeModule(value: unknown): value is AiToolsServeModule {\n  return (\n    typeof value === \"object\" && value !== null && typeof Reflect.get(value, \"serve\") === \"function\"\n  );\n}\n\nfunction isMissingModule(error: unknown, names: readonly string[]): boolean {\n  if (typeof error !== \"object\" || error === null) return false;\n\n  const code = Reflect.get(error, \"code\");\n  const message = error instanceof Error ? error.message : \"\";\n\n  return (\n    (code === \"ERR_MODULE_NOT_FOUND\" || code === \"MODULE_NOT_FOUND\") &&\n    names.some((name) => message.includes(`'${name}'`) || message.includes(`\"${name}\"`))\n  );\n}\n\nconst PACKAGES = [\"@warlock.js/ai-tools\", \"@warlock.js/ai\"] as const;\n\n/**\n * Import `@warlock.js/ai-tools` lazily — it is an optional peer, so a project\n * that never runs `warlock mcp` does not need it. Tries core's own resolution\n * first (pnpm links installed peers next to core), then the app's.\n *\n * Throws `WL7003` with the install line when it (or `@warlock.js/ai`, which\n * it imports) is missing.\n */\nexport async function loadAiToolsServe(\n  cwd: string,\n  importer: (specifier: string) => Promise<unknown> = (specifier) => import(specifier),\n): Promise<AiToolsServeModule> {\n  const attempts: (() => Promise<unknown>)[] = [\n    () => importer(\"@warlock.js/ai-tools\"),\n    () =>\n      importer(\n        resolveModule(\"@warlock.js/ai-tools\", pathToFileURL(path.join(cwd, \"package.json\")).href),\n      ),\n  ];\n  let lastError: unknown;\n\n  for (const attempt of attempts) {\n    try {\n      const module = await attempt();\n\n      if (isAiToolsServeModule(module)) return module;\n\n      lastError = new Error(\"@warlock.js/ai-tools does not export serve()\");\n    } catch (error) {\n      lastError = error;\n\n      if (\n        !isMissingModule(error, PACKAGES) &&\n        !(error instanceof Error && /Cannot find package/.test(error.message))\n      ) {\n        break;\n      }\n    }\n  }\n\n  const reason = lastError instanceof Error ? lastError.message : String(lastError);\n\n  throw new WarlockError(\n    \"WL7003\",\n    `warlock mcp needs @warlock.js/ai-tools (and @warlock.js/ai), which could not be loaded: ${reason}. Install them: ${MCP_INSTALL_HINT}`,\n    { cause: lastError },\n  );\n}\n"],"mappings":";;;;;;;AAMA,MAAa,mBAAmB;;AA0ChC,SAAgB,qBAAqB,OAA6C;CAChF,OACE,OAAO,UAAU,YAAY,UAAU,QAAQ,OAAO,QAAQ,IAAI,OAAO,OAAO,MAAM;AAE1F;AAEA,SAAS,gBAAgB,OAAgB,OAAmC;CAC1E,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CAExD,MAAM,OAAO,QAAQ,IAAI,OAAO,MAAM;CACtC,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;CAEzD,QACG,SAAS,0BAA0B,SAAS,uBAC7C,MAAM,MAAM,SAAS,QAAQ,SAAS,IAAI,KAAK,EAAE,KAAK,QAAQ,SAAS,IAAI,KAAK,EAAE,CAAC;AAEvF;AAEA,MAAM,WAAW,CAAC,wBAAwB,gBAAgB;;;;;;;;;AAU1D,eAAsB,iBACpB,KACA,YAAqD,cAAc,OAAO,YAC7C;CAC7B,MAAM,WAAuC,OACrC,SAAS,sBAAsB,SAEnC,SACEA,UAAc,wBAAwB,cAAc,KAAK,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,IAAI,CAC1F,CACJ;CACA,IAAI;CAEJ,KAAK,MAAM,WAAW,UACpB,IAAI;EACF,MAAM,SAAS,MAAM,QAAQ;EAE7B,IAAI,qBAAqB,MAAM,GAAG,OAAO;EAEzC,4BAAY,IAAI,MAAM,8CAA8C;CACtE,SAAS,OAAO;EACd,YAAY;EAEZ,IACE,CAAC,gBAAgB,OAAO,QAAQ,KAChC,EAAE,iBAAiB,SAAS,sBAAsB,KAAK,MAAM,OAAO,IAEpE;CAEJ;CAKF,MAAM,IAAI,aACR,UACA,2FAJa,qBAAqB,QAAQ,UAAU,UAAU,OAAO,SAAS,EAIoB,kBAAkB,oBACpH,EAAE,OAAO,UAAU,CACrB;AACF"}
+{"version":3,"file":"load-ai-tools.mjs","names":["resolveModule"],"sources":["../../../../../../../../../packages/core/src/tooling/mcp/load-ai-tools.ts"],"sourcesContent":["import path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { resolve as resolveModule } from \"import-meta-resolve\";\nimport { WarlockError } from \"../../errors/warlock-error\";\n\n/** The install line printed when the MCP transport packages are missing. */\nexport const MCP_INSTALL_HINT = \"npm install -D @warlock.js/ai-tools @warlock.js/ai\";\n\n/** The tool shape `ai.mcp.serve` consumes, built structurally (see `@warlock.js/ai`'s `ToolContract`). */\nexport type ServeToolContract = {\n  name: string;\n  description: string;\n  input: unknown;\n  execute(input: Record<string, unknown>): Promise<unknown>;\n  invoke(\n    raw: unknown,\n    context?: unknown,\n  ): Promise<{\n    data?: unknown;\n    error?: Error;\n    usage: { input: number; output: number; total: number };\n    report: Record<string, unknown>;\n  }>;\n};\n\n/** The transport options of `ai.mcp.serve` this command uses. */\nexport type ServeTransportOptions =\n  | { type: \"stdio\" }\n  | {\n      type: \"http\";\n      host: string;\n      port: number;\n      path: string;\n      auth?: { bearer: string };\n    };\n\n/** The handle `start()` resolves. */\nexport type ServeHandle = { url?: string; close(): Promise<void> };\n\n/** The slice of `@warlock.js/ai-tools` this command calls. */\nexport type AiToolsServeModule = {\n  serve(\n    tools: ServeToolContract[],\n    options: { name: string; version?: string; transport: ServeTransportOptions },\n  ): { start(): Promise<ServeHandle>; stop(): Promise<void> };\n};\n\n/** Whether a loaded module exposes `serve()`. */\nexport function isAiToolsServeModule(value: unknown): value is AiToolsServeModule {\n  return (\n    typeof value === \"object\" && value !== null && typeof Reflect.get(value, \"serve\") === \"function\"\n  );\n}\n\nfunction isMissingModule(error: unknown, names: readonly string[]): boolean {\n  if (typeof error !== \"object\" || error === null) return false;\n\n  const code = Reflect.get(error, \"code\");\n  const message = error instanceof Error ? error.message : \"\";\n\n  return (\n    (code === \"ERR_MODULE_NOT_FOUND\" || code === \"MODULE_NOT_FOUND\") &&\n    names.some((name) => message.includes(`'${name}'`) || message.includes(`\"${name}\"`))\n  );\n}\n\nconst PACKAGES = [\"@warlock.js/ai-tools\", \"@warlock.js/ai\"] as const;\n\n/**\n * Import `@warlock.js/ai-tools` lazily — it is an optional peer, so a project\n * that never runs `warlock mcp` does not need it. Tries core's own resolution\n * first (pnpm links installed peers next to core), then the app's.\n *\n * Throws `WL7003` with the install line when it (or `@warlock.js/ai`, which\n * it imports) is missing.\n */\nexport async function loadAiToolsServe(\n  cwd: string,\n  importer: (specifier: string) => Promise<unknown> = (specifier) => import(specifier),\n): Promise<AiToolsServeModule> {\n  const attempts: (() => Promise<unknown>)[] = [\n    () => importer(\"@warlock.js/ai-tools\"),\n    () =>\n      importer(\n        resolveModule(\"@warlock.js/ai-tools\", pathToFileURL(path.join(cwd, \"package.json\")).href),\n      ),\n  ];\n  let lastError: unknown;\n\n  for (const attempt of attempts) {\n    try {\n      const module = await attempt();\n\n      if (isAiToolsServeModule(module)) return module;\n\n      lastError = new Error(\"@warlock.js/ai-tools does not export serve()\");\n    } catch (error) {\n      lastError = error;\n\n      if (\n        !isMissingModule(error, PACKAGES) &&\n        !(error instanceof Error && /Cannot find package/.test(error.message))\n      ) {\n        break;\n      }\n    }\n  }\n\n  const reason = lastError instanceof Error ? lastError.message : String(lastError);\n\n  throw new WarlockError(\n    \"WL7003\",\n    `warlock mcp needs @warlock.js/ai-tools (and @warlock.js/ai), which could not be loaded: ${reason}. Install them: ${MCP_INSTALL_HINT}`,\n    { cause: lastError },\n  );\n}\n"],"mappings":";;;;;;;AAMA,MAAa,mBAAmB;;AA0ChC,SAAgB,qBAAqB,OAA6C;CAChF,OACE,OAAO,UAAU,YAAY,UAAU,QAAQ,OAAO,QAAQ,IAAI,OAAO,OAAO,MAAM;AAE1F;AAEA,SAAS,gBAAgB,OAAgB,OAAmC;CAC1E,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CAExD,MAAM,OAAO,QAAQ,IAAI,OAAO,MAAM;CACtC,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;CAEzD,QACG,SAAS,0BAA0B,SAAS,uBAC7C,MAAM,MAAM,SAAS,QAAQ,SAAS,IAAI,KAAK,EAAE,KAAK,QAAQ,SAAS,IAAI,KAAK,EAAE,CAAC;AAEvF;AAEA,MAAM,WAAW,CAAC,wBAAwB,gBAAgB;;;;;;;;;AAU1D,eAAsB,iBACpB,KACA,YAAqD,cAAc,OAAO,YAC7C;CAC7B,MAAM,WAAuC,OACrC,SAAS,sBAAsB,SAEnC,SACEA,UAAc,wBAAwB,cAAc,KAAK,KAAK,KAAK,cAAc,CAAC,CAAC,CAAC,IAAI,CAC1F,CACJ;CACA,IAAI;CAEJ,KAAK,MAAM,WAAW,UACpB,IAAI;EACF,MAAM,SAAS,MAAM,QAAQ;EAE7B,IAAI,qBAAqB,MAAM,GAAG,OAAO;EAEzC,4BAAY,IAAI,MAAM,8CAA8C;CACtE,SAAS,OAAO;EACd,YAAY;EAEZ,IACE,CAAC,gBAAgB,OAAO,QAAQ,KAChC,EAAE,iBAAiB,SAAS,sBAAsB,KAAK,MAAM,OAAO,IAEpE;CAEJ;CAGF,MAAM,SAAS,qBAAqB,QAAQ,UAAU,UAAU,OAAO,SAAS;CAEhF,MAAM,IAAI,aACR,UACA,2FAA2F,OAAO,kBAAkB,oBACpH,EAAE,OAAO,UAAU,CACrB;AACF"}