@promptbook/pdf 0.113.0-8 → 0.114.0-0

package/umd/src/book-components/Chat/utils/renderMarkdown.d.ts

@@ -4,6 +4,84 @@ import type { string_html, string_markdown } from '../../../types/string_markdow
  */
 type RenderMarkdownOptions = {
     readonly citationReferenceClassName?: string;
+    readonly inlineReferences?: ReadonlyArray<MarkdownInlineReference>;
+    readonly inlineReferenceClassName?: string;
+};
+/**
+ * One inline markdown reference converted from `[[reference]]` into a safe link chip.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type MarkdownInlineReference = {
+    /**
+     * Raw reference text between `[[` and `]]`.
+     */
+    readonly reference: string;
+    /**
+     * Human-readable label rendered inside the link chip.
+     */
+    readonly label: string;
+    /**
+     * Link target for the rendered reference.
+     */
+    readonly href: string;
+    /**
+     * Optional hover title for the rendered reference.
+     */
+    readonly title?: string;
+    /**
+     * Optional expandable menu shown when the reference chip is clicked.
+     */
+    readonly menu?: MarkdownInlineReferenceMenu;
+};
+/**
+ * Status displayed alongside an expandable markdown inline reference.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type MarkdownInlineReferenceMenuStatus = {
+    /**
+     * Accessible text describing the current reference status.
+     */
+    readonly label: string;
+    /**
+     * Whether the status should be rendered as active.
+     */
+    readonly isActive: boolean;
+};
+/**
+ * One destination in an expandable markdown inline reference menu.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type MarkdownInlineReferenceMenuOption = {
+    /**
+     * Text rendered for the option.
+     */
+    readonly label: string;
+    /**
+     * New-tab destination, or `null` while the option is unavailable.
+     */
+    readonly href: string | null;
+    /**
+     * Optional hover text for the option.
+     */
+    readonly title?: string;
+};
+/**
+ * Expandable menu configuration for a markdown inline reference.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type MarkdownInlineReferenceMenu = {
+    /**
+     * Current reference status shown in the chip and menu.
+     */
+    readonly status: MarkdownInlineReferenceMenuStatus;
+    /**
+     * New-tab actions listed in the expanded menu.
+     */
+    readonly options: ReadonlyArray<MarkdownInlineReferenceMenuOption>;
 };
 /**
  * Convert markdown content to HTML.

package/umd/src/book-components/Chat/utils/resolveCitationSourceDisplay.d.ts

@@ -0,0 +1,149 @@
+import type { ParsedCitation } from './parseCitationsFromContent';
+/**
+ * Broad source category used by chat citation chips.
+ *
+ * @private utility type of `<Chat/>` citation rendering
+ */
+export type CitationSourceKind = 'archive' | 'audio' | 'code' | 'document' | 'file' | 'image' | 'json' | 'plain-text' | 'presentation' | 'spreadsheet' | 'table' | 'video' | 'website';
+/**
+ * Image subtype when the citation source carries enough information to identify it.
+ *
+ * @private utility type of `<Chat/>` citation rendering
+ */
+export type CitationImageFormat = 'avif' | 'gif' | 'image' | 'jpeg' | 'png' | 'svg' | 'webp';
+/**
+ * Render-ready metadata for one citation source.
+ *
+ * @private utility type of `<Chat/>` citation rendering
+ */
+export type CitationSourceDisplay = {
+    /**
+     * Broad source category.
+     */
+    readonly kind: CitationSourceKind;
+    /**
+     * Human-readable fallback label used before optional host metadata resolution.
+     */
+    readonly label: string;
+    /**
+     * Best known HTTP(S) target for previews and URL snippets.
+     */
+    readonly targetUrl?: string;
+    /**
+     * Image URL that can be rendered as a thumbnail.
+     */
+    readonly thumbnailUrl?: string;
+    /**
+     * Lower-cased file extension when one is known.
+     */
+    readonly extension?: string;
+    /**
+     * Image subtype when known.
+     */
+    readonly imageFormat?: CitationImageFormat;
+};
+/**
+ * Internal source signature before final labels/preview URLs are resolved.
+ *
+ * @private utility type of `<Chat/>` citation rendering
+ */
+export type CitationSourceSignature = {
+    /**
+     * Broad source category.
+     */
+    readonly kind: CitationSourceKind;
+    /**
+     * Image subtype when known.
+     */
+    readonly imageFormat?: CitationImageFormat;
+};
+/**
+ * Resolves render-ready source metadata for one citation.
+ *
+ * @param citation - Citation metadata from a rendered chat message.
+ * @returns Display label, source category, and optional preview URLs.
+ *
+ * @private utility of `<Chat/>` citation rendering
+ */
+export declare function resolveCitationSourceDisplay(citation: ParsedCitation): CitationSourceDisplay;
+/**
+ * Returns whether the provided value is a valid HTTP(S) URL.
+ *
+ * @param value - Candidate string to inspect.
+ * @returns True when the value parses as an HTTP or HTTPS URL.
+ *
+ * @private utility of `<Chat/>` citation rendering
+ */
+export declare function isCitationSourceUrl(value: string): boolean;
+/**
+ * Determines whether a citation should be displayed as a text snippet instead of a file/URL.
+ *
+ * @param citation - Parsed citation metadata.
+ * @returns True when the citation looks like inline text instead of a document or URL.
+ *
+ * @private utility of `<Chat/>` citation rendering
+ */
+export declare function isPlainTextCitationSource(citation: ParsedCitation): boolean;
+/**
+ * Creates a readable fallback label from a citation source when no title metadata is available.
+ *
+ * @param source - Raw citation source value.
+ * @returns Human-friendly source label.
+ *
+ * @private utility of `<Chat/>` citation rendering
+ */
+export declare function createReadableCitationSourceDisplayLabel(source: string): string;
+/**
+ * Creates a compact host/path label for URL-backed file citations.
+ *
+ * @param rawUrl - Raw URL value.
+ * @returns URL snippet such as `github.com/.../source.json`, or null for invalid URLs.
+ *
+ * @private utility of `<Chat/>` citation rendering
+ */
+export declare function createCitationUrlSnippet(rawUrl: string): string | null;
+/**
+ * Resolves a source signature from a file extension.
+ *
+ * @param extension - Lower- or mixed-case file extension.
+ * @returns Source signature or null for unknown extensions.
+ *
+ * @private utility of `<Chat/>` citation rendering
+ */
+export declare function resolveCitationSourceSignatureFromFileExtension(extension: string | null | undefined): CitationSourceSignature | null;
+/**
+ * Resolves a source signature from an HTTP content type.
+ *
+ * @param contentType - Raw Content-Type header value.
+ * @returns Source signature or null when the content type is not specific enough.
+ *
+ * @private utility of `<Chat/>` citation rendering
+ */
+export declare function resolveCitationSourceSignatureFromContentType(contentType: string): CitationSourceSignature | null;
+/**
+ * Resolves a source signature from decoded source text.
+ *
+ * @param source - Raw citation source text.
+ * @returns Source signature for JSON/binary-like source text, otherwise null.
+ *
+ * @private utility of `<Chat/>` citation rendering
+ */
+export declare function resolveRawCitationSourceSignature(source: string): CitationSourceSignature | null;
+/**
+ * Resolves a source signature from response bytes.
+ *
+ * @param bytes - Leading response bytes.
+ * @returns Source signature for known binary formats, otherwise null.
+ *
+ * @private utility of `<Chat/>` citation rendering
+ */
+export declare function resolveCitationSourceSignatureFromBytes(bytes: Uint8Array): CitationSourceSignature | null;
+/**
+ * Creates a generic fallback label for a source signature.
+ *
+ * @param signature - Source signature.
+ * @returns Human-readable fallback label.
+ *
+ * @private utility of `<Chat/>` citation rendering
+ */
+export declare function createCitationSourceSignatureFallbackLabel(signature: CitationSourceSignature): string;

package/umd/src/book-components/Chat/utils/thinkingMessageVariants.d.ts

@@ -7,6 +7,15 @@
  * @private internal helper for Promptbook chat placeholders
  */
 export declare function normalizeThinkingMessageVariants(thinkingMessages?: ReadonlyArray<string>): ReadonlyArray<string>;
+/**
+ * Parses configured thinking-message variants without applying default fallbacks.
+ *
+ * @param thinkingMessages Raw thinking-message variants.
+ * @returns Trimmed non-empty variants.
+ *
+ * @private internal helper for Promptbook chat placeholders
+ */
+export declare function parseThinkingMessageVariants(thinkingMessages?: ReadonlyArray<string> | null): ReadonlyArray<string>;
 /**
  * Returns a random delay used between browser-side thinking-message rotations.
  *

package/umd/src/cli/cli-commands/agent-folder/agentProjectPaths.d.ts

@@ -1,5 +1,5 @@
-import { AGENT_BOOK_FILE_PATH, AGENT_FAILED_MESSAGES_DIRECTORY_PATH, AGENT_FINISHED_MESSAGES_DIRECTORY_PATH, AGENT_MESSAGES_DIRECTORY_PATH, AGENT_QUEUED_MESSAGES_DIRECTORY_PATH } from '../../../book-3.0/agentFolderPaths';
-export { AGENT_BOOK_FILE_PATH, AGENT_FAILED_MESSAGES_DIRECTORY_PATH, AGENT_FINISHED_MESSAGES_DIRECTORY_PATH, AGENT_MESSAGES_DIRECTORY_PATH, AGENT_QUEUED_MESSAGES_DIRECTORY_PATH, };
+import { AGENT_BOOK_FILE_PATH, AGENT_FAILED_MESSAGES_DIRECTORY_PATH, AGENT_FINISHED_MESSAGES_DIRECTORY_PATH, AGENT_MESSAGES_DIRECTORY_PATH, AGENT_PROJECTS_DIRECTORY_PATH, AGENT_QUEUED_MESSAGES_DIRECTORY_PATH } from '../../../book-3.0/agentFolderPaths';
+export { AGENT_BOOK_FILE_PATH, AGENT_FAILED_MESSAGES_DIRECTORY_PATH, AGENT_FINISHED_MESSAGES_DIRECTORY_PATH, AGENT_MESSAGES_DIRECTORY_PATH, AGENT_PROJECTS_DIRECTORY_PATH, AGENT_QUEUED_MESSAGES_DIRECTORY_PATH, };
 /**
  * Relative path to local knowledge files initialized by `ptbk agent-folder init`.
  *

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/AGENTS_SERVER_BUILD_CACHE_FILENAME.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Metadata file stored beside the production Next build output.
+ *
+ * @private internal constant of `buildAgentsServer`
+ */
+export declare const AGENTS_SERVER_BUILD_CACHE_FILENAME = ".ptbk-agents-server-build-cache.json";

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/AGENTS_SERVER_BUILD_CACHE_VERSION.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Version of the CLI-owned Agents Server build cache metadata.
+ *
+ * @private internal constant of `buildAgentsServer`
+ */
+export declare const AGENTS_SERVER_BUILD_CACHE_VERSION = 1;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/AGENTS_SERVER_NEXT_BUILD_ID_FILENAME.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Next production build marker required before a cached build is reused.
+ *
+ * @private internal constant of `buildAgentsServer`
+ */
+export declare const AGENTS_SERVER_NEXT_BUILD_ID_FILENAME = "BUILD_ID";

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/AgentsServerBuildCache.d.ts

@@ -0,0 +1,10 @@
+import { AGENTS_SERVER_BUILD_CACHE_VERSION } from './AGENTS_SERVER_BUILD_CACHE_VERSION';
+/**
+ * Metadata persisted after one successful Agents Server production build.
+ *
+ * @private internal type of `buildAgentsServer`
+ */
+export type AgentsServerBuildCache = {
+    readonly version: typeof AGENTS_SERVER_BUILD_CACHE_VERSION;
+    readonly sourceFingerprint: string;
+};

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/AgentsServerBuildCacheOptions.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="node" />
+/**
+ * Input paths required to validate or update the cached Agents Server build.
+ *
+ * @private internal type of `buildAgentsServer`
+ */
+export type AgentsServerBuildCacheOptions = {
+    readonly appPath: string;
+    readonly environment?: NodeJS.ProcessEnv;
+};

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/NODE_MODULES_DIRECTORY_NAME.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Directory segment used for Node package installs.
+ *
+ * @private internal constant of `buildAgentsServer`
+ */
+export declare const NODE_MODULES_DIRECTORY_NAME = "node_modules";

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/PreparedAgentsServerRuntime.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Paths needed after the Agents Server production build is ready.
+ *
+ * @private internal type of `buildAgentsServer`
+ */
+export type AgentsServerBuildArtifacts = {
+    readonly appPath: string;
+    readonly nodeModulesPath: string;
+    readonly nextCliPath: string;
+};
+/**
+ * Runtime paths resolved for Agents Server commands before choosing build or dev execution.
+ *
+ * @private internal type of `buildAgentsServer`
+ */
+export type PreparedAgentsServerRuntime = AgentsServerBuildArtifacts & {
+    readonly isAppPathMaterialized: boolean;
+};

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/createAgentsServerBuildSourceFingerprint.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Fingerprints all runtime source paths that can affect the local Agents Server build.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function createAgentsServerBuildSourceFingerprint(appPath: string): Promise<string>;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/createAgentsServerRuntimeEnvironment.d.ts

@@ -0,0 +1,28 @@
+/// <reference types="node" />
+/**
+ * Environment variable passed to the bundled Next app so webpack can resolve dependencies
+ * installed beside `ptbk` even when the app sources are materialized into a project cache.
+ *
+ * @private internal constant of `buildAgentsServer`
+ */
+export declare const PTBK_AGENTS_SERVER_NODE_MODULES_PATH_ENV = "PTBK_AGENTS_SERVER_NODE_MODULES_PATH";
+/**
+ * Environment variable consumed by `apps/agents-server/next.config.ts` to throttle build workers.
+ *
+ * @private internal constant of `buildAgentsServer`
+ */
+export declare const PTBK_AGENTS_SERVER_BUILD_WORKER_COUNT_ENV = "PTBK_AGENTS_SERVER_BUILD_WORKER_COUNT";
+/**
+ * Environment variable used only by the CLI-owned production build.
+ *
+ * @private internal constant of `buildAgentsServer`
+ */
+export declare const PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION_ENV = "PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION";
+/**
+ * Adds dependency-resolution environment required by the materialized Agents Server runtime.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function createAgentsServerRuntimeEnvironment(environment: NodeJS.ProcessEnv, nodeModulesPath: string, options?: {
+    readonly isNextValidationIgnored?: boolean;
+}): NodeJS.ProcessEnv;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/ensureAgentsServerBuild.d.ts

@@ -0,0 +1,19 @@
+/// <reference types="node" />
+import type { PreparedAgentsServerRuntime } from './PreparedAgentsServerRuntime';
+/**
+ * Inputs controlling one cached Agents Server production build.
+ */
+type EnsureAgentsServerBuildOptions = {
+    readonly appPath?: string;
+    readonly environment?: NodeJS.ProcessEnv;
+    readonly isBuildForced?: boolean;
+    readonly onBuildEvent?: (event: string) => void;
+    readonly onBuildOutput?: (chunk: string) => void;
+};
+/**
+ * Ensures that the local Agents Server production build exists and matches its source fingerprint.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function ensureAgentsServerBuild(options?: EnsureAgentsServerBuildOptions): Promise<PreparedAgentsServerRuntime>;
+export {};

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/getAgentsServerBuildInputRelativePaths.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Runtime paths copied into the CLI package and used by the Agents Server production build.
+ */
+declare const AGENTS_SERVER_BUILD_INPUT_RELATIVE_PATHS: readonly ["apps/agents-server", "apps/_common", "src", "books", "package.json", "package-lock.json", "security.config.ts", "servers.ts", "tsconfig.json"];
+/**
+ * Returns runtime input paths that can affect the materialized runtime and build fingerprint.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function getAgentsServerBuildInputRelativePaths(): typeof AGENTS_SERVER_BUILD_INPUT_RELATIVE_PATHS;
+export {};

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/isAgentsServerAppPath.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns true when one folder contains the Next Agents Server app marker files.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function isAgentsServerAppPath(candidate: string): Promise<boolean>;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/isAgentsServerAppPathMaterialized.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns true when the app path points at the project-local materialized runtime.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function isAgentsServerAppPathMaterialized(appPath: string): boolean;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/isAgentsServerBuildCacheCurrent.d.ts

@@ -0,0 +1,7 @@
+import type { AgentsServerBuildCacheOptions } from './AgentsServerBuildCacheOptions';
+/**
+ * Returns true when the production build marker and source fingerprint still match.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function isAgentsServerBuildCacheCurrent(options: AgentsServerBuildCacheOptions): Promise<boolean>;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/isAgentsServerBuildInputTestFile.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns true for test files that should not affect packaged Agents Server builds.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function isAgentsServerBuildInputTestFile(inputBasename: string): boolean;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/isExcludedAgentsServerBuildInputDirectoryName.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns true when a directory segment should not affect Agents Server production builds.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function isExcludedAgentsServerBuildInputDirectoryName(directoryName: string): boolean;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/isExcludedAgentsServerBuildInputPath.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns true for non-build files and folders inside shared runtime source paths.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function isExcludedAgentsServerBuildInputPath(inputPath: string, runtimeRootPath: string): boolean;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/isExcludedAgentsServerRuntimeSourcePath.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns true for runtime source files and folders that are not needed by the Agents Server build.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function isExcludedAgentsServerRuntimeSourcePath(sourceRuntimeRelativePath: string): boolean;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/isFile.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns true when one path exists as a regular file.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function isFile(path: string): Promise<boolean>;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/isPathInsideNodeModules.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns true when one path is nested below a `node_modules` segment.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function isPathInsideNodeModules(path: string): boolean;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/normalizeAgentsServerBuildInputPath.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Normalizes one absolute runtime path so cache fingerprints are stable across platforms.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function normalizeAgentsServerBuildInputPath(runtimeRootPath: string, inputPath: string): string;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/prepareAgentsServerRuntime.d.ts

@@ -0,0 +1,9 @@
+import type { PreparedAgentsServerRuntime } from './PreparedAgentsServerRuntime';
+/**
+ * Resolves the runtime app and dependency paths shared by Agents Server start and dev commands.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function prepareAgentsServerRuntime(options?: {
+    readonly appPath?: string;
+}): Promise<PreparedAgentsServerRuntime>;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/readAgentsServerBuildCache.d.ts

@@ -0,0 +1,8 @@
+import type { AgentsServerBuildCache } from './AgentsServerBuildCache';
+import type { AgentsServerBuildCacheOptions } from './AgentsServerBuildCacheOptions';
+/**
+ * Reads and validates cached build metadata.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function readAgentsServerBuildCache(options: AgentsServerBuildCacheOptions): Promise<AgentsServerBuildCache | undefined>;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/resolveAgentsServerAppPath.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Finds the Agents Server app in a source checkout or generated CLI package.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function resolveAgentsServerAppPath(): Promise<string>;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/resolveAgentsServerBuildAppPath.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Uses the source checkout app directly, but copies npm-packaged app sources out of `node_modules`.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function resolveAgentsServerBuildAppPath(options: {
+    readonly nodeModulesPath: string;
+    readonly sourceAppPath: string;
+}): Promise<string>;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/resolveAgentsServerBuildOutputPath.d.ts

@@ -0,0 +1,7 @@
+import type { AgentsServerBuildCacheOptions } from './AgentsServerBuildCacheOptions';
+/**
+ * Resolves the Next output directory used by a particular build environment.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function resolveAgentsServerBuildOutputPath(options: AgentsServerBuildCacheOptions): string;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/resolveNextCliPath.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Resolves the Next CLI module installed alongside the Promptbook CLI.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function resolveNextCliPath(): string;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/resolveNodeModulesPath.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Resolves the dependency root that contains the installed Next CLI.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function resolveNodeModulesPath(nextCliPath: string): string;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/runNextBuild.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="node" />
+/**
+ * Runs the finite Next production build used by local Agents Server commands.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function runNextBuild(options: {
+    readonly appPath: string;
+    readonly environment: NodeJS.ProcessEnv;
+    readonly nextCliPath: string;
+    readonly onBuildOutput?: (chunk: string) => void;
+}): Promise<void>;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/shouldCopyAgentsServerRuntimePath.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Excludes build artifacts, dependency folders, private env files, and test sources.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function shouldCopyAgentsServerRuntimePath(sourcePath: string, sourceRootPath: string): boolean;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/synchronizeMaterializedAgentsServerRuntime.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copies the bundled runtime into the launch project when the original app lives under `node_modules`.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function synchronizeMaterializedAgentsServerRuntime(options: {
+    readonly materializedRuntimeRootPath: string;
+    readonly nodeModulesPath: string;
+    readonly sourceAppPath: string;
+    readonly sourceRuntimeRootPath: string;
+}): Promise<void>;

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/writeAgentsServerBuildCache.d.ts

@@ -0,0 +1,7 @@
+import type { AgentsServerBuildCacheOptions } from './AgentsServerBuildCacheOptions';
+/**
+ * Persists the source fingerprint for the just-created production build.
+ *
+ * @private internal utility of `buildAgentsServer`
+ */
+export declare function writeAgentsServerBuildCache(options: AgentsServerBuildCacheOptions): Promise<void>;