@promptbook/node 0.113.0-1 → 0.113.0-11

package/esm/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/esm/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/esm/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/esm/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/esm/src/book-components/Chat/Chat/CitationIframePreview.d.ts

@@ -9,7 +9,7 @@ export type CitationIframePreviewProps = {
 };
 /**
  * Renders a citation URL preview as an iframe when the target page allows embedding,
- * or falls back to a live server-side browser preview with an "Open in new tab" link
+ * 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>`.

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

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

package/esm/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/esm/src/book-components/Chat/Chat/insertDictationChunk.test.d.ts

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

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

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

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

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

package/esm/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/esm/src/book-components/Chat/Chat/useChatInputAreaComposer.draftMessage.test.d.ts

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

package/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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>;

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

@@ -1,109 +1,8 @@
-/// <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 `ptbk agents-server`
- */
-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 `ptbk agents-server`
- */
-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 `ptbk agents-server`
- */
-export declare const PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION_ENV = "PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION";
-/**
- * Inputs controlling one cached Agents Server production build.
- *
- * @private internal type of `ptbk agents-server`
- */
-type EnsureAgentsServerBuildOptions = {
-    readonly appPath?: string;
-    readonly environment?: NodeJS.ProcessEnv;
-    readonly isBuildForced?: boolean;
-    readonly onBuildEvent?: (event: string) => void;
-    readonly onBuildOutput?: (chunk: string) => void;
-};
-/**
- * Paths needed after the Agents Server production build is ready.
- *
- * @private internal type of `ptbk agents-server`
- */
-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 `ptbk agents-server`
- */
-export type PreparedAgentsServerRuntime = AgentsServerBuildArtifacts & {
-    readonly isAppPathMaterialized: boolean;
-};
-/**
- * Input paths required to validate or update the cached Agents Server build.
- *
- * @private internal type of `ptbk agents-server`
- */
-type AgentsServerBuildCacheOptions = {
-    readonly appPath: string;
-    readonly environment?: NodeJS.ProcessEnv;
-};
-/**
- * Ensures that the local Agents Server production build exists and matches its source fingerprint.
- *
- * @private internal utility of `ptbk agents-server`
- */
-export declare function ensureAgentsServerBuild(options?: EnsureAgentsServerBuildOptions): Promise<PreparedAgentsServerRuntime>;
-/**
- * Resolves the runtime app and dependency paths shared by Agents Server start and dev commands.
- *
- * @private internal utility of `ptbk agents-server`
- */
-export declare function prepareAgentsServerRuntime(options?: {
-    readonly appPath?: string;
-}): Promise<PreparedAgentsServerRuntime>;
-/**
- * Returns true when the production build marker and source fingerprint still match.
- *
- * @private internal utility of `ptbk agents-server`
- */
-export declare function isAgentsServerBuildCacheCurrent(options: AgentsServerBuildCacheOptions): Promise<boolean>;
-/**
- * Persists the source fingerprint for the just-created production build.
- *
- * @private internal utility of `ptbk agents-server`
- */
-export declare function writeAgentsServerBuildCache(options: AgentsServerBuildCacheOptions): Promise<void>;
-/**
- * Finds the Agents Server app in a source checkout or generated CLI package.
- *
- * @private internal utility of `ptbk agents-server`
- */
-export declare function resolveAgentsServerAppPath(): Promise<string>;
-/**
- * Adds dependency-resolution environment required by the materialized Agents Server runtime.
- *
- * @private internal utility of `ptbk agents-server`
- */
-export declare function createAgentsServerRuntimeEnvironment(environment: NodeJS.ProcessEnv, nodeModulesPath: string, options?: {
-    readonly isNextValidationIgnored?: boolean;
-}): NodeJS.ProcessEnv;
-/**
- * Uses the source checkout app directly, but copies npm-packaged app sources out of `node_modules`.
- *
- * @private internal utility of `ptbk agents-server`
- */
-export declare function resolveAgentsServerBuildAppPath(options: {
-    readonly nodeModulesPath: string;
-    readonly sourceAppPath: string;
-}): Promise<string>;
-export {};
+export { createAgentsServerRuntimeEnvironment, PTBK_AGENTS_SERVER_BUILD_WORKER_COUNT_ENV, PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION_ENV, PTBK_AGENTS_SERVER_NODE_MODULES_PATH_ENV, } from './buildAgentsServer/createAgentsServerRuntimeEnvironment';
+export { ensureAgentsServerBuild } from './buildAgentsServer/ensureAgentsServerBuild';
+export { isAgentsServerBuildCacheCurrent } from './buildAgentsServer/isAgentsServerBuildCacheCurrent';
+export { prepareAgentsServerRuntime } from './buildAgentsServer/prepareAgentsServerRuntime';
+export { resolveAgentsServerAppPath } from './buildAgentsServer/resolveAgentsServerAppPath';
+export { resolveAgentsServerBuildAppPath } from './buildAgentsServer/resolveAgentsServerBuildAppPath';
+export { writeAgentsServerBuildCache } from './buildAgentsServer/writeAgentsServerBuildCache';
+export type { AgentsServerBuildArtifacts, PreparedAgentsServerRuntime, } from './buildAgentsServer/PreparedAgentsServerRuntime';

package/esm/src/cli/cli-commands/agents-server/ensureAgentsServerEnvFile.d.ts

@@ -1,4 +1,4 @@
-import { type EnsureProjectEnvFileResult } from '../common/projectInitialization';
+import type { EnsureProjectEnvFileResult } from '../common/projectInitialization';
 /**
  * Ensures `.env` contains all required Agents Server configuration entries.
  *

package/esm/src/cli/cli-commands/agents-server/ensureAgentsServerGitignoreFile.d.ts

@@ -1,4 +1,4 @@
-import { type ProjectInitializationStatus } from '../common/projectInitialization';
+import type { ProjectInitializationStatus } from '../common/projectInitialization';
 /**
  * Ensures `.gitignore` excludes local Agents Server runtime artifacts.
  *