@happyvertical/smrt-cli 0.55.9 → 0.55.11

package/dist/cli-generator.d.ts.map

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

package/dist/commands/cookbook/apply.d.ts

@@ -0,0 +1,102 @@
+/**
+ * `smrt cookbook apply` engine (#3748): create or update a project from a
+ * validated cookbook. Writes configuration only (package.json dependencies,
+ * `smrt.cookbook.json`, and the project name for a new project); never sample
+ * data and never anything else in the project.
+ */
+import type { Cookbook } from '@happyvertical/smrt-types';
+export declare const COOKBOOK_CONFIG_FILE = "smrt.cookbook.json";
+export declare const DEFAULT_TEMPLATE = "github:happyvertical/smrt-start";
+interface PackageJson {
+    name?: string;
+    [key: string]: unknown;
+}
+export interface ApplyOptions {
+    cookbook: Cookbook;
+    /** Packages the cookbook's recipes, features and policies need. */
+    packages: string[];
+    /** Target directory (new project) or project directory (`into`). */
+    dir?: string;
+    into?: boolean;
+    /** Local path, `github:owner/repo[#ref]`, or a git URL. */
+    template?: string;
+    dryRun?: boolean;
+    install?: boolean;
+    /**
+     * Where the package manager's output goes. `inherit` (default) uses this
+     * process's stdout; `stderr` keeps stdout free for a protocol (the MCP
+     * stdio server). Stdin is never shared with the install in `stderr` mode.
+     */
+    installOutput?: 'inherit' | 'stderr';
+    /** Version of the CLI, the last-resort dependency range. */
+    cliVersion: string;
+    cwd?: string;
+}
+export interface ApplyPlan {
+    mode: 'new' | 'update';
+    targetDir: string;
+    template?: {
+        spec: string;
+        revision?: string;
+    };
+    projectName?: string;
+    /** Dependencies added to package.json. */
+    addDependencies: Record<string, string>;
+    /** Needed packages already declared (left exactly as they are). */
+    keptDependencies: Record<string, string>;
+    config: 'create' | 'update' | 'unchanged';
+}
+export interface ApplyResult {
+    plan: ApplyPlan;
+    dryRun: boolean;
+    written: string[];
+    installed: boolean;
+    nextSteps: string[];
+}
+export declare class ApplyError extends Error {
+}
+/**
+ * Range for packages the project does not declare yet: the framework line the
+ * project already uses (smrt packages release as one fixed group), else this
+ * CLI's own release line.
+ */
+export declare function chooseRange(json: PackageJson, cliVersion: string): string;
+/** A valid unscoped npm package name from free text, or undefined when nothing usable remains. */
+export declare function npmNameFromText(value: string): string | undefined;
+/** Parse `github:owner/repo#ref`, a git URL, or a local path. */
+export declare function parseTemplateSpec(spec: string): {
+    kind: 'local';
+    path: string;
+} | {
+    kind: 'git';
+    url: string;
+    ref?: string;
+};
+interface AcquiredTemplate {
+    root: string;
+    revision?: string;
+    /**
+     * Paths (relative to `root`) to copy, when the template is a local git
+     * checkout: tracked plus untracked-but-not-ignored files. Undefined means
+     * copy everything except `.git` and `node_modules`.
+     */
+    files?: string[];
+    cleanup(): void;
+}
+/**
+ * Files a local git checkout contributes to a new project: everything tracked
+ * plus untracked files that are not git-ignored (`git ls-files -co
+ * --exclude-standard`). A working checkout carries git-ignored generated
+ * output (build products, a stale `src/routes/api/notes`) that must not leak
+ * into a new project, while uncommitted edits to the template still apply, so
+ * `git archive HEAD` (which would drop them) is not used. Returns undefined
+ * when `dir` is not inside a git work tree or git is unavailable.
+ */
+export declare function listLocalTemplateFiles(dir: string): string[] | undefined;
+/** Resolve a template to a directory: a local path as-is, a git source shallow-fetched. */
+export declare function acquireTemplate(spec: string): AcquiredTemplate;
+export declare function nextSteps(dir: string, json: PackageJson, installed: boolean, cwd: string): string[];
+/** Plan and (unless dry-run) perform the apply. */
+export declare function applyCookbook(options: ApplyOptions): ApplyResult;
+export {};
+//# sourceMappingURL=apply.d.ts.map

package/dist/commands/cookbook/apply.d.ts.map

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

package/dist/commands/cookbook/recipe-index.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Recipe index for `smrt cookbook validate|apply` (#3748).
+ *
+ * Source of truth: each package's published manifest (its
+ * `./manifest` export; `dist/manifest.json` or `dist/lib/manifest.json`), which carries `recipes[]` and the `objects` the
+ * cookbook's policies and features point at. Manifests are read from, in
+ * order: explicit `--manifests` paths, the SMRT workspace around the working
+ * directory, the project's `node_modules`, and finally (opt-out with
+ * `--no-registry`) the npm registry for packages that are not installed yet.
+ */
+import { type RegistryOptions } from './registry.js';
+export { type FetchLike, type RegistryOptions, registryForPackage, } from './registry.js';
+export declare const SMRT_SCOPE = "@happyvertical";
+/** One recipe, with the facts validation and apply need. */
+export interface RecipeIndexEntry {
+    id: string;
+    packageName: string;
+    packageVersion?: string;
+    requires: string[];
+    requiresAny: string[][];
+    models: string[];
+    /** The recipe declares model/field curation options. */
+    hasOptions: boolean;
+    /** The recipe carries demo seed data (never applied by cookbook apply). */
+    hasDemoSeed: boolean;
+}
+/** One package's manifest facts. */
+export interface PackageIndexEntry {
+    packageName: string;
+    packageVersion?: string;
+    /** Where it was read from, for diagnostics. */
+    source: string;
+    /** Qualified object name to its field names. */
+    objects: Map<string, Set<string>>;
+    /** The manifest as read, for callers that need more than the index keeps. */
+    manifest: ManifestLike;
+}
+export interface RecipeIndex {
+    recipes: Map<string, RecipeIndexEntry>;
+    packages: Map<string, PackageIndexEntry>;
+    /** Packages a registry or manifest lookup was tried for and not found. */
+    missing: Set<string>;
+}
+export declare function createRecipeIndex(): RecipeIndex;
+export interface ManifestLike {
+    packageName?: string;
+    packageVersion?: string;
+    objects?: Record<string, {
+        fields?: Record<string, unknown> | unknown[];
+    }>;
+    recipes?: Array<{
+        id?: string;
+        requires?: string[];
+        requiresAny?: string[][];
+        models?: string[];
+        options?: Record<string, unknown>;
+        demoSeed?: unknown;
+    }>;
+}
+/** Add one parsed manifest to the index. Returns false when it names no package. */
+export declare function addManifest(index: RecipeIndex, manifest: ManifestLike, source: string): boolean;
+/**
+ * A package directory's manifest file: its `exports['./manifest']` (or
+ * `./manifest.json`) target, else the known locations. SvelteKit-library
+ * packages publish at `dist/lib/manifest.json`, not `dist/manifest.json`.
+ */
+export declare function manifestPathForPackageDir(dir: string): string | null;
+/**
+ * Read manifests from a path: a manifest file, a directory of `*.json`
+ * manifests, or a directory of package directories (`<pkg>/dist/manifest.json`
+ * or `<pkg>/manifest.json`).
+ */
+export declare function loadManifestPath(index: RecipeIndex, path: string, warn?: (message: string) => void): void;
+/** Walk up from `start` for the SMRT monorepo root (`packages/*` + workspace file). */
+export declare function findSmrtWorkspace(start: string): string | null;
+/** Load workspace and installed manifests visible from `dir`. */
+export declare function loadLocalManifests(index: RecipeIndex, dir: string, warn?: (message: string) => void): void;
+/** The package that conventionally owns a recipe id (`commerce.sales` -> smrt-commerce). */
+export declare function candidatePackageForRecipe(id: string): string;
+/** The package a qualified object (`@scope/pkg:Class`) belongs to, if qualified. */
+export declare function packageOfQualifiedName(ref: string): string | null;
+/**
+ * Fetch a package's manifest from the registry that owns its scope, without
+ * installing it. Returns false when the package or its manifest is missing.
+ */
+export declare function loadRegistryManifest(index: RecipeIndex, packageName: string, options?: RegistryOptions): Promise<boolean>;
+/** What a cookbook needs resolved, for the registry-fill loop. */
+export declare function neededPackages(index: RecipeIndex, cookbook: {
+    recipes?: string[];
+    features?: string[];
+    policies?: Array<{
+        objectRef?: string;
+    }>;
+}): string[];
+export interface ResolveOptions {
+    /** Project (or working) directory to look for installed manifests from. */
+    dir: string;
+    manifests?: string[];
+    registry?: boolean;
+    registryOptions?: RegistryOptions;
+    warn?: (message: string) => void;
+}
+/**
+ * Build the index a cookbook needs: local sources first, then the registry
+ * for packages still unresolved, repeating until no new package appears.
+ */
+export declare function resolveRecipeIndex(cookbook: Parameters<typeof neededPackages>[1], options: ResolveOptions): Promise<RecipeIndex>;
+//# sourceMappingURL=recipe-index.d.ts.map

package/dist/commands/cookbook/recipe-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-index.d.ts","sourceRoot":"","sources":["../../../src/commands/cookbook/recipe-index.ts"],"names":[],"mappings":"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"}

package/dist/commands/cookbook/registry.d.ts

@@ -0,0 +1,69 @@
+/**
+ * npm registry access shared by the cookbook recipe index (#3748) and
+ * `smrt kitchen` (#3750): which registry owns a package's scope (the way npm
+ * and pnpm pick it, auth token included), and fetching and extracting a
+ * package tarball without installing it.
+ */
+export type FetchLike = (url: string, init?: {
+    headers?: Record<string, string>;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+    arrayBuffer(): Promise<ArrayBuffer>;
+}>;
+export interface RegistryOptions {
+    /** Force one registry for every package (tests, mirrors). */
+    registryUrl?: string;
+    /** Directory whose `.npmrc` chain is consulted. */
+    dir?: string;
+    /** Exact version to try first (the framework line); falls back to latest. */
+    versionHint?: string;
+    fetchImpl?: FetchLike;
+}
+/**
+ * The registry for a package, the way npm and pnpm pick it: the scope's
+ * `@scope:registry` (`.npmrc` chain, then `npm config`), then
+ * `npm_config_registry`, then an unscoped `registry=`, then npmjs.
+ * Also returns an auth token configured for that registry's host.
+ */
+export declare function registryForPackage(packageName: string, dir?: string): {
+    url: string;
+    token?: string;
+};
+/** A package this CLI may fetch from a registry without installing it. */
+export declare const SMRT_PACKAGE_NAME: RegExp;
+/** The most a package tarball may weigh (the planner is about 70 MB). */
+export declare const MAX_TARBALL_BYTES: number;
+export interface PackageLookup {
+    /** The version the registry resolved. */
+    version?: string;
+    /** Registry the package came from. */
+    registry: string;
+    tarballUrl: string;
+    /** Sent with the tarball request: empty unless it is on the registry's origin. */
+    headers: Record<string, string>;
+    /** The registry's `dist.integrity` (`sha512-<base64>`), checked on download. */
+    integrity?: string;
+}
+export interface PackageTarball {
+    version?: string;
+    registry: string;
+    data: ArrayBuffer;
+}
+/**
+ * Ask the registry that owns a package's scope which version to use, without
+ * downloading anything. Tries `versionHint` first (when given), then `latest`.
+ * Returns null when the package or version is unavailable.
+ */
+export declare function lookupPackage(packageName: string, options?: RegistryOptions): Promise<PackageLookup | null>;
+/** Download the tarball a {@link lookupPackage} found. Null when unavailable. */
+export declare function downloadPackage(found: PackageLookup, fetchImpl?: FetchLike): Promise<PackageTarball | null>;
+/** Look a package up and download its tarball. Null when unavailable. */
+export declare function fetchPackageTarball(packageName: string, options?: RegistryOptions): Promise<PackageTarball | null>;
+/**
+ * Extract a tarball into `cwd` (entries keep their `package/` prefix). A
+ * `filter` limits which entries are written.
+ */
+export declare function extractTarball(data: ArrayBuffer, cwd: string, filter?: (path: string) => boolean): Promise<void>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/commands/cookbook/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/commands/cookbook/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,MAAM,SAAS,GAAG,CACtB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,KACxC,OAAO,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACrC,CAAC,CAAC;AAEH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAoCD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,GAAG,GAAE,MAAsB,GAC1B;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA0BjC;AAED,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,QAA8C,CAAC;AAK7E,yEAAyE;AACzE,eAAO,MAAM,iBAAiB,QAAoB,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAkD/B;AAED,iFAAiF;AACjF,wBAAsB,eAAe,CACnC,KAAK,EAAE,aAAa,EACpB,SAAS,GAAE,SAAyC,GACnD,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAkBhC;AAED,yEAAyE;AACzE,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAGhC;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/commands/cookbook/shared.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Pieces of `smrt cookbook` that `smrt kitchen` (#3750) reuses: reading a
+ * cookbook source, validating it against the recipe index, and printing an
+ * apply result.
+ */
+import { type ApplyResult } from './apply.js';
+import { type CookbookReport } from './validate.js';
+/** Version of this CLI: the last-resort range for packages a cookbook adds. */
+export declare function cliVersion(): string;
+/** Cookbook text from a file path or an http(s) URL. */
+export declare function readCookbookSource(source: string): Promise<string>;
+export declare const asList: (value: string[] | string | undefined) => string[];
+export interface ValidateSourceOptions {
+    /** Project directory manifests are looked up from. */
+    dir: string;
+    manifests?: string[];
+    registry?: boolean;
+}
+/** Validate cookbook text structurally and against the resolved recipe index. */
+export declare function validateCookbookSource(text: string, options: ValidateSourceOptions): Promise<CookbookReport>;
+/** Print what an apply did (or, for a dry run, would do) and the next steps. */
+export declare function printApplyResult(result: ApplyResult, warnings: string[], log?: (line: string) => void, warn?: (line: string) => void): void;
+//# sourceMappingURL=shared.d.ts.map

package/dist/commands/cookbook/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/commands/cookbook/shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,EACL,KAAK,cAAc,EAGpB,MAAM,eAAe,CAAC;AAEvB,+EAA+E;AAC/E,wBAAgB,UAAU,IAAI,MAAM,CAiBnC;AAKD,wDAAwD;AACxD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBxE;AAED,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,KAAG,MAAM,EACD,CAAC;AAEpE,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,iFAAiF;AACjF,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,cAAc,CAAC,CAWzB;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,MAAM,EAAE,EAClB,GAAG,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAkB,EACzC,IAAI,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAmB,GAC1C,IAAI,CAqBN"}

package/dist/commands/cookbook/validate.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Cookbook validation against the recipe index (#3748): the structural check
+ * lives in core (`validateCookbook`); this adds what needs manifests.
+ */
+import type { Cookbook } from '@happyvertical/smrt-types';
+import { type RecipeIndex } from './recipe-index.js';
+export interface CookbookReport {
+    ok: boolean;
+    errors: string[];
+    warnings: string[];
+    cookbook?: Cookbook;
+    /** Packages the cookbook's recipes, features and policies need. */
+    packages: string[];
+}
+/** Validate cookbook text structurally and against the recipe index. */
+export declare function validateCookbookText(text: string, index: RecipeIndex): CookbookReport;
+/** Cookbook shape needed to plan resolution before validation. */
+export declare function parseForResolution(text: string): {
+    recipes: string[];
+    features: string[];
+    policies: Array<{
+        objectRef?: string;
+    }>;
+};
+//# sourceMappingURL=validate.d.ts.map

package/dist/commands/cookbook/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/commands/cookbook/validate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAOD,wEAAwE;AACxE,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,GACjB,cAAc,CAkFhB;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzC,CAoBA"}

package/dist/commands/cookbook.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `smrt cookbook validate|apply` (#3748). See `agents/cookbook.md`.
+ */
+import type { CLICommand } from '../cli-generator.js';
+export declare const cookbookCommands: Record<string, CLICommand>;
+//# sourceMappingURL=cookbook.d.ts.map

package/dist/commands/cookbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookbook.d.ts","sourceRoot":"","sources":["../../src/commands/cookbook.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAiFtD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAiGvD,CAAC"}

package/dist/commands/index.d.ts

@@ -2,6 +2,7 @@
  * CLI Commands - Export all command modules
  */
 export { configExportCommand } from './config-export.js';
+export { cookbookCommands } from './cookbook.js';
 export { dbDiffCommand } from './db-diff.js';
 export { dbGenerateCommand } from './db-generate.js';
 export { dbHistoryCommand } from './db-history.js';
@@ -17,6 +18,7 @@ export { generateCommands } from './generate.js';
 export { gitCommands } from './git.js';
 export { gnodeCommands } from './gnode.js';
 export { initCommands } from './init.js';
+export { kitchenCommands } from './kitchen.js';
 export { mcpAppsCommands } from './mcp-apps-packaging.js';
 export { playgroundCommands } from './playground.js';
 export { utilityCommands } from './utilities.js';

package/dist/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/commands/kitchen/ai.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The language model behind `smrt kitchen`'s chat endpoint (#3750): the
+ * user's configured `@happyvertical/ai` provider, resolved the way the rest of
+ * s-m-r-t resolves it (the `ai` block of `smrt.config.ts`, then `SMRT_AI_*`,
+ * then the provider's own key variable such as `OPENAI_API_KEY`).
+ */
+import { type ResolveAIProviderOptions, toAIClientOptions } from '@happyvertical/smrt-config';
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+/** What the chat endpoint needs from a model. */
+export interface KitchenAI {
+    /** For the terminal: provider and model, never a key. */
+    label: string;
+    chat(messages: ChatMessage[]): Promise<string>;
+}
+export interface ResolveAIOptions {
+    /** Where to look for `smrt.config.*` (default: the target dir, else the cwd). */
+    dir?: string;
+    env?: ResolveAIProviderOptions['env'];
+    /** Build the client; tests pass a stub, the default is `getAI`. */
+    createClient?: (options: ReturnType<typeof toAIClientOptions>) => Promise<{
+        chat(messages: ChatMessage[], options?: Record<string, unknown>): Promise<{
+            content: string;
+        }>;
+    }>;
+}
+/**
+ * The configured model, or null when no provider is configured (the kitchen
+ * then runs the planner's in-browser model instead).
+ */
+export declare function resolveKitchenAI(options?: ResolveAIOptions): Promise<KitchenAI | null>;
+//# sourceMappingURL=ai.d.ts.map

package/dist/commands/kitchen/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../../src/commands/kitchen/ai.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAEL,KAAK,wBAAwB,EAC7B,iBAAiB,EAElB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iDAAiD;AACjD,MAAM,WAAW,SAAS;IACxB,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACtC,mEAAmE;IACnE,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,KAAK,OAAO,CAAC;QACxE,IAAI,CACF,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACjC,CAAC,CAAC;CACJ;AAWD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAsB3B"}

package/dist/commands/kitchen/apply.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Applying a cookbook the page sent to `smrt kitchen` (#3750): the same
+ * validation and apply engine as `smrt cookbook apply`, wrapped as one call
+ * that returns the HTTP-shaped outcome the planner shows to the visitor.
+ */
+import { type ApplyResult } from '../cookbook/apply.js';
+import type { RecipeIndex } from '../cookbook/recipe-index.js';
+export interface ApplierOptions {
+    /** The project directory (`smrt kitchen [dir]`). */
+    dir: string;
+    /** Project template (local path, `github:owner/repo[#ref]`, git URL). */
+    template?: string;
+    /** Run the package manager's install after writing. */
+    install: boolean;
+    /** Where the install's output goes (`stderr` keeps stdout for a protocol). */
+    installOutput?: 'inherit' | 'stderr';
+    /** Plan only: write nothing (a remote template is still fetched to a temp dir). */
+    dryRun?: boolean;
+    manifests?: string[];
+    /**
+     * Validate against this already-resolved index instead of looking manifests
+     * up again from `dir` (a new project has none there). `manifests` and
+     * `registry` are then unused.
+     */
+    index?: RecipeIndex;
+    /** Allow fetching manifests of uninstalled packages from the registry. */
+    registry: boolean;
+    /** Where progress goes (the terminal). */
+    log?: (line: string) => void;
+}
+/** Body of a successful `POST /api/kitchen/cookbook`. */
+export interface AppliedBody {
+    ok: true;
+    dir: string;
+    mode: 'new' | 'update';
+    installed: boolean;
+    added: string[];
+    nextSteps: string[];
+}
+export type ApplyOutcome = {
+    ok: true;
+    status: 200;
+    body: AppliedBody;
+    result: ApplyResult;
+} | {
+    ok: false;
+    status: number;
+    errors: string[];
+};
+export type CookbookApplier = (text: string) => Promise<ApplyOutcome>;
+export declare function createCookbookApplier(options: ApplierOptions): CookbookApplier;
+//# sourceMappingURL=apply.d.ts.map

package/dist/commands/kitchen/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../src/commands/kitchen/apply.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAI/D,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,OAAO,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACrC,mFAAmF;IACnF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,0EAA0E;IAC1E,QAAQ,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,IAAI,CAAC;IACT,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GACjE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEpD,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAEtE,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,GACtB,eAAe,CA8DjB"}

package/dist/commands/kitchen/mcp/catalog.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The engine catalog (#3752) built from real recipe manifests: the recipes
+ * each package declares, the models its objects declare, and the library of
+ * ready-made cookbooks. Nothing here is invented; a package that cannot be
+ * found contributes nothing and is reported.
+ */
+import type { EngineCatalog, EngineLibraryCookbook } from '@happyvertical/smrt-core/cookbook/engine';
+import { type RecipeIndex } from '../../cookbook/recipe-index.js';
+/** `@happyvertical/smrt-commerce` -> `commerce`, as item ids spell it. */
+export declare function packageIdOf(packageName: string): string;
+/** Build the engine catalog from every manifest in the index. */
+export declare function catalogFromIndex(index: RecipeIndex, cookbooks?: readonly EngineLibraryCookbook[]): EngineCatalog;
+/**
+ * Ready-made cookbooks from `<dir>/<id>.cookbook.json` files. A file that is
+ * not a valid cookbook is skipped and named in `warnings`.
+ */
+export declare function readLibraryDir(dir: string, warnings: string[]): EngineLibraryCookbook[];
+/** The library this CLI ships plus any extra directories (later ids win). */
+export declare function loadLibrary(extraDirs: readonly string[], warnings: string[]): EngineLibraryCookbook[];
+export interface CatalogOptions {
+    /** Directory manifests are looked up from (the server's working directory). */
+    dir: string;
+    manifests?: string[];
+    registry?: boolean;
+    /** Extra smrt packages to read recipes from, beyond what the library names. */
+    packages?: string[];
+    library?: string[];
+}
+export interface LoadedCatalog {
+    catalog: EngineCatalog;
+    index: RecipeIndex;
+    warnings: string[];
+}
+/**
+ * Resolve the manifests behind the library's recipes (local sources first,
+ * then the scope registry, as `cookbook validate` does) and build the catalog.
+ */
+export declare function loadCatalog(options: CatalogOptions): Promise<LoadedCatalog>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/commands/kitchen/mcp/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../../src/commands/kitchen/mcp/catalog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EACV,aAAa,EAEb,qBAAqB,EAGtB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAEL,KAAK,WAAW,EAGjB,MAAM,gCAAgC,CAAC;AA2BxC,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEvD;AA2DD,iEAAiE;AACjE,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAClB,SAAS,GAAE,SAAS,qBAAqB,EAAO,GAC/C,aAAa,CAWf;AAwBD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAAE,GACjB,qBAAqB,EAAE,CA6BzB;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CACzB,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,QAAQ,EAAE,MAAM,EAAE,GACjB,qBAAqB,EAAE,CAUzB;AAED,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CAkCxB"}

package/dist/commands/kitchen/mcp/server.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `smrt kitchen mcp` (#3752): the Kitchen tools served over stdio. stdout
+ * carries the protocol only; everything else goes to stderr.
+ */
+import { Server } from '@modelcontextprotocol/server';
+import { KitchenSession, type KitchenToolsOptions } from './tools.js';
+export declare const SERVER_NAME = "smrt-kitchen";
+/** Build the MCP server; one {@link KitchenSession} (plans, catalog) per server. */
+export declare function createKitchenMcpServer(options: KitchenToolsOptions): {
+    server: Server;
+    session: KitchenSession;
+};
+/** Serve on this process's stdio until the host closes it or the process is stopped. */
+export declare function runKitchenMcp(options: KitchenToolsOptions): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/commands/kitchen/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../src/commands/kitchen/mcp/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAGtD,OAAO,EAEL,cAAc,EACd,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,WAAW,iBAAiB,CAAC;AAQ1C,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,CAAC;CACzB,CAgCA;AAED,wFAAwF;AACxF,wBAAsB,aAAa,CACjC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/commands/kitchen/mcp/tools.d.ts

@@ -0,0 +1,68 @@
+/**
+ * The tools of `smrt kitchen mcp` (#3752): a local, stdio Model Context
+ * Protocol server that lets a host's own model (ChatGPT, Codex, Claude)
+ * plan a SMRT app with the cookbook command engine, then create the project
+ * with `cookbook apply`. The host reasons; nothing here calls a model or
+ * holds a credential.
+ *
+ * Plans live in this process, one engine per plan id. Nothing is stored
+ * remotely; `apply_plan` writes `smrt.cookbook.json` into the project.
+ */
+import { type JsonSchema, type PlanSnapshot } from '@happyvertical/smrt-core/cookbook/engine';
+import { type CatalogOptions, type LoadedCatalog } from './catalog.js';
+/** The most plans one server process holds; the oldest is dropped past it. */
+export declare const MAX_PLANS = 20;
+export interface KitchenToolsOptions extends CatalogOptions {
+    /** Default project template for `apply_plan` (default: smrt-start). */
+    template?: string;
+    /** Replaces the catalog loader (tests). */
+    catalogLoader?: () => Promise<LoadedCatalog>;
+}
+/** Tool annotations as MCP defines them. */
+export interface KitchenToolAnnotations {
+    title: string;
+    readOnlyHint: boolean;
+    destructiveHint: boolean;
+    idempotentHint: boolean;
+    openWorldHint: boolean;
+}
+export interface KitchenToolDefinition {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: JsonSchema;
+    outputSchema: JsonSchema;
+    annotations: KitchenToolAnnotations;
+}
+/** What a handler returns: structured data plus the compact text for the model. */
+export interface KitchenToolResult {
+    data: Record<string, unknown> & {
+        ok: boolean;
+    };
+    text: string;
+}
+export declare const KITCHEN_TOOLS: readonly KitchenToolDefinition[];
+/** One line of a snapshot, for the model's text. */
+export declare function describeSnapshot(snapshot: PlanSnapshot): string;
+/** The server's state: the lazily loaded catalog and the plans. */
+export declare class KitchenSession {
+    private readonly options;
+    private loaded?;
+    private readonly plans;
+    constructor(options: KitchenToolsOptions);
+    /** Load the catalog once; a failed load is retried on the next call. */
+    catalog(): Promise<LoadedCatalog>;
+    private plan;
+    /** Validate arguments against a tool's published schema. */
+    private static check;
+    call(name: string, args?: Record<string, unknown>): Promise<KitchenToolResult>;
+    private dispatch;
+    private listCookbooks;
+    private searchRecipes;
+    private startPlan;
+    private runCommands;
+    private validatePlan;
+    private exportPlan;
+    private applyPlan;
+}
+//# sourceMappingURL=tools.d.ts.map