@promptbook/vercel 0.113.0-0 → 0.113.0-10

package/umd/src/book-components/BookEditor/useBookEditorMonacoUploads/useCompletedUploadsAutoClear.d.ts

@@ -0,0 +1,12 @@
+import type { SetUploadItems, UploadDecorationIdsRef, UploadFilesRef, UploadItem } from './bookEditorMonacoUploadTypes';
+/**
+ * Clears upload UI state shortly after all uploads finish.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useCompletedUploadsAutoClear({ uploadItems, uploadFilesRef, uploadDecorationIdsRef, setUploadItems, }: {
+    readonly uploadItems: ReadonlyArray<UploadItem>;
+    readonly uploadFilesRef: UploadFilesRef;
+    readonly uploadDecorationIdsRef: UploadDecorationIdsRef;
+    readonly setUploadItems: SetUploadItems;
+}): void;

package/umd/src/book-components/BookEditor/useBookEditorMonacoUploads.d.ts

@@ -1,62 +1,10 @@
 import type { editor } from 'monaco-editor';
-import type { Promisable } from 'type-fest';
+import type { BookEditorMonacoOnFileUpload } from './useBookEditorMonacoUploads/bookEditorMonacoUploadTypes';
+export type { UploadItem, UploadStats } from './useBookEditorMonacoUploads/bookEditorMonacoUploadTypes';
 /**
  * Type describing monaco editor.
  */
 type MonacoEditor = typeof import('monaco-editor');
-/**
- * Type describing upload status.
- */
-type UploadStatus = 'queued' | 'uploading' | 'paused' | 'completed' | 'failed';
-/**
- * Type describing upload item.
- */
-export type UploadItem = {
-    readonly id: string;
-    readonly fileName: string;
-    readonly fileSize: number;
-    readonly status: UploadStatus;
-    readonly progress: number;
-    readonly loadedBytes: number;
-    readonly totalBytes: number;
-    readonly startedAt: number | null;
-    readonly completedAt: number | null;
-    readonly errorMessage?: string;
-};
-/**
- * Type describing upload stats.
- */
-export type UploadStats = {
-    readonly totalFiles: number;
-    readonly queuedFiles: number;
-    readonly uploadingFiles: number;
-    readonly pausedFiles: number;
-    readonly failedFiles: number;
-    readonly completedFiles: number;
-    readonly totalBytes: number;
-    readonly uploadedBytes: number;
-    readonly progress: number;
-    readonly elapsedMs: number;
-    readonly speedBytesPerSecond: number;
-};
-/**
- * Type describing book editor monaco upload progress callback.
- */
-type BookEditorMonacoUploadProgressCallback = (progress: number, stats?: {
-    loadedBytes: number;
-    totalBytes: number;
-}) => void;
-/**
- * Options for book editor monaco upload.
- */
-type BookEditorMonacoUploadOptions = {
-    readonly onProgress?: BookEditorMonacoUploadProgressCallback;
-    readonly abortSignal?: AbortSignal;
-};
-/**
- * Type describing book editor monaco on file upload.
- */
-type BookEditorMonacoOnFileUpload = (file: File, options?: BookEditorMonacoUploadOptions | BookEditorMonacoUploadProgressCallback) => Promisable<string>;
 /**
  * Props for use book editor monaco uploads.
  */
@@ -71,11 +19,10 @@ type UseBookEditorMonacoUploadsProps = {
  * @private function of BookEditorMonaco
  */
 export declare function useBookEditorMonacoUploads({ editor, monaco, onFileUpload }: UseBookEditorMonacoUploadsProps): {
-    activeUploadItems: UploadItem[];
-    uploadItems: UploadItem[];
-    uploadStats: UploadStats;
+    activeUploadItems: import("./useBookEditorMonacoUploads/bookEditorMonacoUploadTypes").UploadItem[];
+    uploadItems: import("./useBookEditorMonacoUploads/bookEditorMonacoUploadTypes").UploadItem[];
+    uploadStats: import("./useBookEditorMonacoUploads/bookEditorMonacoUploadTypes").UploadStats;
     handleFiles: (files: File[]) => Promise<void>;
     pauseUpload: (uploadId: string) => void;
     resumeUpload: (uploadId: string) => void;
 };
-export {};

package/umd/src/book-components/Chat/Chat/ChatImageAttachmentModal.d.ts

@@ -0,0 +1,25 @@
+/// <reference types="react" />
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * One attachment payload displayed by the chat image preview modal.
+ *
+ * @private type of `<ChatImageAttachmentModal/>`
+ */
+type ChatImageAttachment = NonNullable<ChatMessage['attachments']>[number];
+/**
+ * Props for the chat image attachment preview modal.
+ *
+ * @private props of `<ChatImageAttachmentModal/>`
+ */
+type ChatImageAttachmentModalProps = {
+    readonly attachment: ChatImageAttachment | null;
+    readonly mode?: 'LIGHT' | 'DARK';
+    readonly onClose: () => void;
+};
+/**
+ * Modal that previews an image attachment without leaving the chat surface.
+ *
+ * @private component of `<Chat/>`
+ */
+export declare function ChatImageAttachmentModal({ attachment, mode, onClose }: ChatImageAttachmentModalProps): import("react").ReactPortal | null;
+export {};

package/umd/src/book-components/Chat/Chat/ChatInputArea.d.ts

@@ -4,6 +4,7 @@ import type { WithTake } from '../../../utils/take/interfaces/ITakeChain';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
 import type { ChatProps, ChatSoundSystem } from './ChatProps';
+import type { ChatComposerDraft } from './useChatInputAreaComposer';
 /**
  * Wrapper for consistent button-click sound handling.
  *
@@ -22,6 +23,7 @@ export type ChatInputAreaProps = {
     speechRecognition?: ChatProps['speechRecognition'];
     speechRecognitionLanguage?: ChatProps['speechRecognitionLanguage'];
     defaultMessage?: string;
+    draftMessage?: ChatComposerDraft;
     replyingToMessage?: ChatMessage | null;
     onCancelReply?: ChatProps['onCancelReply'];
     enterBehavior?: ChatProps['enterBehavior'];
@@ -36,6 +38,7 @@ export type ChatInputAreaProps = {
     onButtonClick: ChatInputButtonClickHandler;
     chatInputClassName?: string;
     chatUiTranslations?: ChatProps['chatUiTranslations'];
+    mode?: 'LIGHT' | 'DARK';
 };
 /**
  * Renders the chat input area with text, file upload, and voice controls.

package/umd/src/book-components/Chat/Chat/ChatMessageAttachments.d.ts

@@ -0,0 +1,27 @@
+import { type CSSProperties } from 'react';
+import type { ChatMessage } from '../types/ChatMessage';
+/**
+ * One uploaded file attached to a chat message.
+ *
+ * @private type of `<Chat/>`
+ */
+export type ChatMessageAttachment = NonNullable<ChatMessage['attachments']>[number];
+/**
+ * Props accepted by the shared attachment chip list.
+ *
+ * @private props of `<Chat/>`
+ */
+type ChatMessageAttachmentsProps = {
+    readonly attachments: ReadonlyArray<ChatMessageAttachment>;
+    readonly mode: 'LIGHT' | 'DARK';
+    readonly className?: string;
+    readonly style?: CSSProperties;
+    readonly onRemoveAttachment?: (attachment: ChatMessageAttachment, attachmentIndex: number) => void;
+};
+/**
+ * Renders chat attachment chips and the shared image preview modal.
+ *
+ * @private component of `<Chat/>`
+ */
+export declare function ChatMessageAttachments({ attachments, mode, className, style, onRemoveAttachment, }: ChatMessageAttachmentsProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/umd/src/book-components/Chat/Chat/ChatMessageItem.d.ts

@@ -9,7 +9,7 @@ import type { ChatProps } from './ChatProps';
  *
  * @private props for internal subcomponent
  */
-type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'onActionButton' | 'onQuickMessageButton' | 'participants'> & {
+type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'onActionButton' | 'onQuickMessageButton' | 'onQuickMessageDraftButton' | 'participants'> & {
     message: ChatMessage;
     participant: ChatParticipant | undefined;
     isLastMessage: boolean;

package/umd/src/book-components/Chat/Chat/ChatMessageList.d.ts

@@ -44,6 +44,7 @@ export type ChatMessageListProps = {
     onMessage?: (messageContent: string) => Promisable<void>;
     onActionButton?: ChatProps['onActionButton'];
     onQuickMessageButton?: ChatProps['onQuickMessageButton'];
+    onQuickMessageDraftButton?: ChatProps['onQuickMessageDraftButton'];
     onReplyToMessage?: ChatProps['onReplyToMessage'];
     canReplyToMessage?: ChatProps['canReplyToMessage'];
     onCreateAgent?: (bookContent: string) => void;

package/umd/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -474,6 +474,14 @@ export type ChatProps = {
      * When not provided, quick message buttons fall back to `onMessage`.
      */
     onQuickMessageButton?(messageContent: string): Promisable<void>;
+    /**
+     * Called when user clicks a quick draft-message button parsed from message markdown.
+     *
+     * Unlike `onQuickMessageButton`, this prefills the composer with an editable draft
+     * instead of sending the message. When not provided, `<Chat/>` prefills its own
+     * composer so the draft can be edited before sending.
+     */
+    onQuickMessageDraftButton?(messageDraftContent: string): Promisable<void>;
     /**
      * Optional callback fired when the user starts replying to one existing message.
      */

package/umd/src/book-components/Chat/Chat/CitationIframePreview.d.ts

@@ -9,8 +9,8 @@ export type CitationIframePreviewProps = {
 };
 /**
  * Renders a citation URL preview as an iframe when the target page allows embedding,
- * or falls back to a server-side screenshot with an "Open in new tab" link when it
- * does not (e.g. X-Frame-Options: DENY / SAMEORIGIN).
+ * or falls back to a live server-side browser stream with an "Open in new tab" link
+ * when it does not (e.g. X-Frame-Options: DENY / SAMEORIGIN).
  *
  * Embedding capability is determined by `GET /api/page-preview/check?url=<url>`.
  * If that endpoint is unavailable the component falls back to the iframe directly.

package/umd/src/book-components/Chat/Chat/CitationIframePreview.test.d.ts

@@ -0,0 +1,2 @@
+/** @jest-environment jsdom */
+export {};

package/umd/src/book-components/Chat/Chat/insertDictationChunk.d.ts

@@ -8,7 +8,7 @@ export declare function insertDictationChunk(params: {
     readonly dictatedText: string;
     readonly selectionStart: number;
     readonly selectionEnd: number;
-    readonly shouldReplaceSelection: boolean;
+    readonly isReplacingSelection: boolean;
 }): {
     nextValue: string;
     start: number;

package/umd/src/book-components/Chat/Chat/insertDictationChunk.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/book-components/Chat/Chat/learnDictationDictionary.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/book-components/Chat/Chat/refineFinalDictationChunk.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/src/book-components/Chat/Chat/useChatInputAreaComposer.d.ts

@@ -2,6 +2,17 @@ import { type ChangeEvent, type KeyboardEvent as ReactKeyboardEvent, type Mutabl
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatInputUploadedFile } from './ChatInputUploadedFile';
 import type { ChatProps, ChatSoundSystem } from './ChatProps';
+/**
+ * One programmatic request to replace the composer content with an editable draft.
+ *
+ * A fresh object identity is used for every request so repeated draft insertions
+ * (even with identical text) re-apply to the composer.
+ *
+ * @private function of `<ChatInputArea/>`
+ */
+export type ChatComposerDraft = {
+    readonly content: string;
+};
 /**
  * Props for `useChatInputAreaComposer`.
  *
@@ -11,6 +22,7 @@ type UseChatInputAreaComposerProps = {
     readonly onMessage?: ChatProps['onMessage'];
     readonly onChange?: ChatProps['onChange'];
     readonly defaultMessage?: string;
+    readonly draftMessage?: ChatComposerDraft;
     readonly enterBehavior?: ChatProps['enterBehavior'];
     readonly resolveEnterBehavior?: ChatProps['resolveEnterBehavior'];
     readonly isFocusedOnLoad?: boolean;

package/umd/src/book-components/Chat/Chat/useChatInputAreaComposer.draftMessage.test.d.ts

@@ -0,0 +1,2 @@
+/** @jest-environment jsdom */
+export {};

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

@@ -1,4 +1,4 @@
-import { type ToolCall } from '../../../types/ToolCall';
+import type { ToolCall } from '../../../types/ToolCall';
 /**
  * Returns true when one tool call represents a user-facing action.
  *

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

@@ -8,6 +8,19 @@ export type MessageQuickButton = {
     text: string;
     message: string;
 };
+/**
+ * Represents a quick draft-message button parsed from chat markdown.
+ *
+ * Unlike `MessageQuickButton`, clicking this button prefills the composer with an
+ * editable draft instead of sending the message immediately.
+ *
+ * @private internal helper type of `MessageButton`
+ */
+export type MessageDraftQuickButton = {
+    type: 'messageDraft';
+    text: string;
+    messageDraft: string;
+};
 /**
  * Represents a quick action button parsed from chat markdown.
  *
@@ -23,9 +36,10 @@ export type ActionQuickButton = {
  *
  * @public exported from `@promptbook/components`
  */
-export type MessageButton = MessageQuickButton | ActionQuickButton;
+export type MessageButton = MessageQuickButton | MessageDraftQuickButton | ActionQuickButton;
 /**
- * Parses markdown quick buttons in the format `[Button Text](?message=...)` or `[Button Text](?action=...)`.
+ * Parses markdown quick buttons in the format `[Button Text](?message=...)`, `[Button Text](?messageDraft=...)`
+ * or `[Button Text](?action=...)`.
  * Returns both the content without supported quick buttons and the extracted button definitions.
  *
  * @param content The markdown content that may contain buttons

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;