import { type JsonValue } from '../setup/utils.js'; /** * The object form's resource filter, narrowed to the one resource type cradle * delivers. Absent `extensions` loads everything the package declares, `[]` * loads none, patterns decide otherwise (see `./package-filters.js`). */ interface PackageFilter { readonly extensions?: readonly string[]; /** pi's `autoload: false` — nothing loads except what an `extensions` pattern names. */ readonly autoloadDisabled?: boolean; } /** A parsed `npm:[@]` package source from settings.json's `packages` key. */ export interface NpmPackageSpec extends PackageFilter { readonly name: string; readonly version: string; } /** * Parse a settings.json record's `packages` key — pi's source strings, pi's * filter objects, or a mix — into validated npm: package specs. Only `npm:` * sources are supported — pi also accepts `git:`, `https://`, `ssh://`, and * local paths, all warned and dropped here, since cradle installs the package * itself rather than delegating to pi's loader. */ export declare function readPackageSpecs(record: { readonly [key: string]: JsonValue; }, path: string, warnings: string[]): readonly NpmPackageSpec[]; /** Deterministic npm manifest for a per-agent packages install, dependencies sorted by name. */ export declare function emitPackagesManifest(specs: readonly NpmPackageSpec[]): string; /** * Resolve each spec's installed package into the pi extension entry files its * settings.json entry selects, ready to pass as explicit `-e` flags. Every * failure (not installed, malformed manifest, an entry that escapes the * package directory, a missing entry file, no declared extensions) is a * warning + skip — packages are warn-don't-throw like every other * agent-folder input. A filter selecting nothing is silent: that is the * author asking for nothing, not a failure. */ export declare function resolvePackageEntries(npmDir: string, specs: readonly NpmPackageSpec[]): Promise<{ entries: string[]; warnings: string[]; }>; export {};