@promptbook/vercel 0.113.0-0 → 0.113.0-10

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>;

package/umd/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/umd/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/umd/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.
  *

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/AgentsServerChildEnvironment.d.ts

@@ -0,0 +1,16 @@
+/// <reference types="node" />
+import type { number_port } from '../../../../types/number_positive';
+/**
+ * Subprocess environment carrying the explicit local worker credential.
+ *
+ * @private internal type of `startAgentsServer`
+ */
+export type AgentsServerChildEnvironment = NodeJS.ProcessEnv & {
+    readonly PTBK_AGENTS_SERVER_USER_CHAT_WORKER_TOKEN: string;
+};
+/**
+ * Creates the subprocess environment for Next and its internal local runner bridge.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function createAgentsServerChildEnvironment(port: number_port, agentRootPath: string): AgentsServerChildEnvironment;

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/AgentsServerLogStreams.d.ts

@@ -0,0 +1,30 @@
+/// <reference types="node" />
+import { type WriteStream } from 'fs';
+import type { AgentsServerRuntimePaths } from './AgentsServerRuntimePaths';
+/**
+ * Logger handles kept open for the foreground Agents Server lifetime.
+ *
+ * @private internal type of `startAgentsServer`
+ */
+export type AgentsServerLogStreams = {
+    readonly next: WriteStream;
+    readonly runner: WriteStream;
+};
+/**
+ * Creates file streams for service output persisted below `./logs`.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function createAgentsServerLogStreams(runtimePaths: AgentsServerRuntimePaths): AgentsServerLogStreams;
+/**
+ * Closes all foreground service log streams.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function closeAgentsServerLogStreams(logStreams: AgentsServerLogStreams): void;
+/**
+ * Appends one timestamped runner lifecycle event into its persistent log file.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function logRunnerEvent(logStream: WriteStream, event: string): void;

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/AgentsServerRuntimePaths.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Captures foreground file locations for one Agents Server launch.
+ *
+ * @private internal type of `startAgentsServer`
+ */
+export type AgentsServerRuntimePaths = {
+    readonly launchWorkingDirectory: string;
+    readonly appPath: string;
+    readonly agentRootPath: string;
+    readonly logDirectoryPath: string;
+    readonly nextLogPath: string;
+    readonly runnerLogPath: string;
+};
+/**
+ * Resolves local app, agent-root, and log paths for one foreground launch.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function resolveAgentsServerRuntimePaths(): Promise<AgentsServerRuntimePaths>;

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/AgentsServerSupervisorState.d.ts

@@ -0,0 +1,37 @@
+/// <reference types="node" />
+import type { CoderRunUiHandle } from '../../../../../scripts/run-codex-prompts/ui/renderCoderRunUi';
+/**
+ * Mutable supervisor state shared with child-process and watcher callbacks.
+ *
+ * @private internal type of `startAgentsServer`
+ */
+export type AgentsServerSupervisorState = {
+    isContinuing: boolean;
+    uiHandle?: CoderRunUiHandle;
+    lastUserChatJobWorkerError?: {
+        message: string;
+        repeatCount: number;
+    };
+    nextExit?: {
+        code: number | null;
+        signal: NodeJS.Signals | null;
+    };
+};
+/**
+ * Adds one Next or worker output line to the rich terminal UI when it is active.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function addUiOutput(state: AgentsServerSupervisorState, output: string): void;
+/**
+ * Adds one service error line to the rich terminal UI when it is active.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function addUiError(state: AgentsServerSupervisorState, error: string): void;
+/**
+ * Throws when the server child stopped while the watcher was still expected to be foreground work.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function assertNextServerStillRunning(state: AgentsServerSupervisorState): void;

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/LocalAgentRunnerLimits.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Local runner limits loaded from the running Agents Server app.
+ *
+ * @private internal type of `startAgentsServer`
+ */
+export type LocalAgentRunnerLimits = {
+    readonly maxFailedAttempts: number;
+    readonly maxParallelMessages: number;
+};

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/PreparedAgentsServerLaunch.d.ts

@@ -0,0 +1,13 @@
+import type { PreparedAgentsServerRuntime } from '../buildAgentsServer';
+import type { AgentsServerChildEnvironment } from './AgentsServerChildEnvironment';
+import type { AgentsServerRuntimePaths } from './AgentsServerRuntimePaths';
+/**
+ * Prepared Next runtime and child environment used by one foreground launch.
+ *
+ * @private internal type of `startAgentsServer`
+ */
+export type PreparedAgentsServerLaunch = {
+    readonly runtimeArtifacts: PreparedAgentsServerRuntime;
+    readonly runtimeChildEnvironment: AgentsServerChildEnvironment;
+    readonly runtimePaths: AgentsServerRuntimePaths;
+};

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/StartAgentsServerOptions.d.ts

@@ -0,0 +1,24 @@
+import type { number_port } from '../../../../types/number_positive';
+import type { ThinkingLevel } from '../../coder/ThinkingLevel';
+import type { PromptRunnerHarnessName } from '../../common/promptRunnerCliOptions';
+/**
+ * Next runtime mode supported by the local Agents Server foreground launcher.
+ *
+ * @private internal type of `startAgentsServer`
+ */
+export type AgentsServerNextRuntimeMode = 'start' | 'dev';
+/**
+ * Options required to start the foreground Agents Server service group.
+ *
+ * @private internal type of `startAgentsServer`
+ */
+export type StartAgentsServerOptions = {
+    readonly port: number_port;
+    readonly agentName: PromptRunnerHarnessName;
+    readonly model?: string;
+    readonly noUi: boolean;
+    readonly thinkingLevel?: ThinkingLevel;
+    readonly allowCredits: boolean;
+    readonly nextRuntimeMode: AgentsServerNextRuntimeMode;
+    readonly isBuildForced: boolean;
+};

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/createInternalRouteErrorMessage.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Builds a foreground failure message for one internal Agents Server route.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function createInternalRouteErrorMessage(routeLabel: string, response: Response, details: string | null): string;

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/createLocalAgentRunOptions.d.ts

@@ -0,0 +1,9 @@
+import type { AgentRunOptions } from '../../../../../scripts/run-agent-messages/AgentRunOptions';
+import type { LocalAgentRunnerLimits } from './LocalAgentRunnerLimits';
+import type { StartAgentsServerOptions } from './StartAgentsServerOptions';
+/**
+ * Creates local no-git agent runner options for folders managed by the Agents Server database.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function createLocalAgentRunOptions(options: StartAgentsServerOptions, localAgentRunnerLimits: LocalAgentRunnerLimits): AgentRunOptions;

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/forwardChildOutput.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="node" />
+import type { WriteStream } from 'fs';
+import { type AgentsServerSupervisorState } from './AgentsServerSupervisorState';
+/**
+ * Persists one child output chunk and forwards readable lines into UI or plain output.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function forwardChildOutput(chunk: string, options: {
+    readonly label: string;
+    readonly logStream: WriteStream;
+    readonly state: AgentsServerSupervisorState;
+}): void;

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/loadAgentsServerProjectEnvironment.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Loads launch-directory `.env` values without overriding explicit process environment.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function loadAgentsServerProjectEnvironment(launchWorkingDirectory: string): void;

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/prepareAgentsServerLaunch.d.ts

@@ -0,0 +1,18 @@
+import type { AgentsServerChildEnvironment } from './AgentsServerChildEnvironment';
+import type { AgentsServerLogStreams } from './AgentsServerLogStreams';
+import type { AgentsServerRuntimePaths } from './AgentsServerRuntimePaths';
+import type { AgentsServerSupervisorState } from './AgentsServerSupervisorState';
+import type { PreparedAgentsServerLaunch } from './PreparedAgentsServerLaunch';
+import type { StartAgentsServerOptions } from './StartAgentsServerOptions';
+/**
+ * Prepares the shared Next runtime for either production start or hot-reloading development mode.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function prepareAgentsServerLaunch(options: {
+    readonly childEnvironment: AgentsServerChildEnvironment;
+    readonly logStreams: AgentsServerLogStreams;
+    readonly startOptions: StartAgentsServerOptions;
+    readonly runtimePaths: AgentsServerRuntimePaths;
+    readonly state: AgentsServerSupervisorState;
+}): Promise<PreparedAgentsServerLaunch>;

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/readInternalRouteErrorDetails.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Reads an internal route error payload so foreground logs show the route-level reason.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function readInternalRouteErrorDetails(response: Response): Promise<string | null>;

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/resolveAgentsServerChildHostname.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="node" />
+/**
+ * Resolves the optional Next hostname from the prepared child environment.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function resolveAgentsServerChildHostname(environment: NodeJS.ProcessEnv): string | null;

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/startNextServer.d.ts

@@ -0,0 +1,20 @@
+/// <reference types="node" />
+import { type ChildProcess } from 'child_process';
+import type { AgentsServerChildEnvironment } from './AgentsServerChildEnvironment';
+import type { AgentsServerLogStreams } from './AgentsServerLogStreams';
+import type { AgentsServerRuntimePaths } from './AgentsServerRuntimePaths';
+import { type AgentsServerSupervisorState } from './AgentsServerSupervisorState';
+import type { StartAgentsServerOptions } from './StartAgentsServerOptions';
+/**
+ * Starts the configured Next server mode and wires its logs into the foreground dashboard.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function startNextServer(options: {
+    readonly nextCliPath: string;
+    readonly startOptions: StartAgentsServerOptions;
+    readonly runtimePaths: AgentsServerRuntimePaths;
+    readonly childEnvironment: AgentsServerChildEnvironment;
+    readonly logStreams: AgentsServerLogStreams;
+    readonly state: AgentsServerSupervisorState;
+}): ChildProcess;

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/startUserChatJobWorkerPump.d.ts

@@ -0,0 +1,15 @@
+import type { number_port } from '../../../../types/number_positive';
+import type { AgentsServerChildEnvironment } from './AgentsServerChildEnvironment';
+import type { AgentsServerLogStreams } from './AgentsServerLogStreams';
+import { type AgentsServerSupervisorState } from './AgentsServerSupervisorState';
+/**
+ * Starts periodic internal worker calls that queue and reconcile local message-folder jobs.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function startUserChatJobWorkerPump(options: {
+    readonly port: number_port;
+    readonly environment: AgentsServerChildEnvironment;
+    readonly logStreams: AgentsServerLogStreams;
+    readonly state: AgentsServerSupervisorState;
+}): () => void;

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/stopChildProcess.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="node" />
+import type { ChildProcess } from 'child_process';
+/**
+ * Stops only the child process spawned for the local Next server.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function stopChildProcess(commandProcess: ChildProcess | undefined): void;

package/umd/src/cli/cli-commands/agents-server/startAgentsServer/waitForLocalAgentRunnerLimits.d.ts

@@ -0,0 +1,16 @@
+import type { number_port } from '../../../../types/number_positive';
+import type { AgentsServerChildEnvironment } from './AgentsServerChildEnvironment';
+import type { AgentsServerLogStreams } from './AgentsServerLogStreams';
+import type { AgentsServerSupervisorState } from './AgentsServerSupervisorState';
+import type { LocalAgentRunnerLimits } from './LocalAgentRunnerLimits';
+/**
+ * Waits until the internal Next route can return current local runner limits.
+ *
+ * @private internal utility of `startAgentsServer`
+ */
+export declare function waitForLocalAgentRunnerLimits(options: {
+    readonly port: number_port;
+    readonly environment: AgentsServerChildEnvironment;
+    readonly logStreams: AgentsServerLogStreams;
+    readonly state: AgentsServerSupervisorState;
+}): Promise<LocalAgentRunnerLimits>;

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

@@ -1,36 +1,9 @@
-import type { ThinkingLevel } from '../coder/ThinkingLevel';
-import type { PromptRunnerHarnessName } from '../common/promptRunnerCliOptions';
-import type { number_port } from '../../../types/number_positive';
-/**
- * Next runtime mode supported by the local Agents Server foreground launcher.
- *
- * @private internal type of `ptbk agents-server`
- */
-export type AgentsServerNextRuntimeMode = 'start' | 'dev';
-/**
- * Options required to start the foreground Agents Server service group.
- *
- * @private internal type of `ptbk agents-server`
- */
-export type StartAgentsServerOptions = {
-    readonly port: number_port;
-    readonly agentName: PromptRunnerHarnessName;
-    readonly model?: string;
-    readonly noUi: boolean;
-    readonly thinkingLevel?: ThinkingLevel;
-    readonly allowCredits: boolean;
-    readonly nextRuntimeMode: AgentsServerNextRuntimeMode;
-    readonly isBuildForced: boolean;
-};
+import type { StartAgentsServerOptions } from './startAgentsServer/StartAgentsServerOptions';
+export { loadAgentsServerProjectEnvironment } from './startAgentsServer/loadAgentsServerProjectEnvironment';
+export type { AgentsServerNextRuntimeMode, StartAgentsServerOptions } from './startAgentsServer/StartAgentsServerOptions';
 /**
  * Starts the Agents Server web app and local coding-agent queue workers in the foreground.
  *
  * @private internal utility of `ptbk agents-server`
  */
 export declare function startAgentsServer(options: StartAgentsServerOptions): Promise<void>;
-/**
- * Loads launch-directory `.env` values without overriding explicit process environment.
- *
- * @private internal utility of `ptbk agents-server`
- */
-export declare function loadAgentsServerProjectEnvironment(launchWorkingDirectory: string): void;

package/umd/src/cli/cli-commands/common/createPositiveIntegerOptionParser.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Creates a Commander argument parser that accepts only positive integers.
+ *
+ * The returned parser is meant to be passed as the coercion callback of `command.option(...)`.
+ * It throws a branded `NotAllowed` error with a clear message referencing the given option name
+ * when the provided value is not a positive integer.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function createPositiveIntegerOptionParser(optionName: string): (value: string) => number;

package/umd/src/cli/cli-commands/common/promptRunnerCliOptions.d.ts

@@ -1,6 +1,6 @@
 import { Command as Program } from 'commander';
-import type { ThinkingLevel } from '../coder/ThinkingLevel';
 import { PTBK_HARNESS_ENV, PTBK_MODEL_ENV, PTBK_THINKING_LEVEL_ENV } from '../../../book-3.0/cliAgentEnv';
+import type { ThinkingLevel } from '../coder/ThinkingLevel';
 export { PTBK_HARNESS_ENV, PTBK_MODEL_ENV, PTBK_THINKING_LEVEL_ENV };
 /**
  * Runner identifiers supported by Promptbook CLI agent orchestration commands.

package/umd/src/collection/agent-collection/CreateAgentInput.d.ts

@@ -1,5 +1,5 @@
+import type { AgentVisibility } from '../../book-2.0/agent-source/agentSourceVisibility';
 import type { string_book } from '../../book-2.0/agent-source/string_book';
-import { type AgentVisibility } from '../../book-2.0/agent-source/agentSourceVisibility';
 import type { LlmToolDefinition } from '../../types/LlmToolDefinition';
 /**
  * Supported visibility options for agent creation.

package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/prepareAgentSourceForPersistence.d.ts

@@ -1,5 +1,5 @@
 import type { AgentBasicInformation } from '../../../../book-2.0/agent-source/AgentBasicInformation';
-import { type AgentVisibility } from '../../../../book-2.0/agent-source/agentSourceVisibility';
+import type { AgentVisibility } from '../../../../book-2.0/agent-source/agentSourceVisibility';
 import type { string_book } from '../../../../book-2.0/agent-source/string_book';
 import type { string_agent_permanent_id } from '../../../../types/string_agent_name';
 /**

package/umd/src/commitments/META/META.d.ts

@@ -4,7 +4,7 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  * META commitment definition
  *
  * The META commitment handles all meta-information about the agent such as:
- * - META AVATAR: Sets the agent's built-in default avatar visual
+ * - META AVATAR / META VISUAL: Sets the agent's built-in default avatar visual
  * - META IMAGE: Sets the agent's avatar/profile image URL
  * - META LINK: Provides profile/source links for the person the agent models
  * - META DOMAIN: Sets the canonical custom domain/host of the agent
@@ -19,7 +19,7 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  * Example usage in agent source:
  *
  * ```book
- * META AVATAR pixel-art
+ * META VISUAL pixel-art
  * META IMAGE https://example.com/avatar.jpg
  * META LINK https://twitter.com/username
  * META DOMAIN my-agent.com

package/umd/src/commitments/META_AVATAR/META_AVATAR.d.ts

@@ -1,15 +1,19 @@
 import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * META AVATAR / META VISUAL commitment type.
+ */
+type MetaAvatarCommitmentType = 'META AVATAR' | 'META VISUAL';
 /**
  * META AVATAR commitment definition
  *
- * The `META AVATAR` commitment sets the built-in default avatar visual used when
- * the agent does not provide an explicit `META IMAGE`.
+ * The `META AVATAR` and `META VISUAL` commitments set the built-in default avatar visual
+ * used when the agent does not provide an explicit `META IMAGE`.
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class MetaAvatarCommitmentDefinition extends BaseCommitmentDefinition<'META AVATAR'> {
-    constructor();
+export declare class MetaAvatarCommitmentDefinition extends BaseCommitmentDefinition<MetaAvatarCommitmentType> {
+    constructor(type?: MetaAvatarCommitmentType);
     /**
      * Short one-line description of META AVATAR.
      */
@@ -24,3 +28,4 @@ export declare class MetaAvatarCommitmentDefinition extends BaseCommitmentDefini
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
+export {};

package/umd/src/commitments/index.d.ts

@@ -62,4 +62,4 @@ import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplemented
  *
  * @private Use functions to access commitments instead of this array directly
  */
-export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaAvatarCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaVisibilityCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, WalletCommitmentDefinition, WalletCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseDeepSearchCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseCalendarCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
+export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaAvatarCommitmentDefinition, MetaAvatarCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaVisibilityCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, WalletCommitmentDefinition, WalletCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseDeepSearchCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseCalendarCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];

package/umd/src/conversion/validation/validatePipeline/createPipelineValidationContext.d.ts

@@ -0,0 +1,16 @@
+import type { PipelineJson } from '../../../pipeline/PipelineJson/PipelineJson';
+/**
+ * Shared validation context for one pipeline validation pass.
+ *
+ * @private type of `validatePipeline`
+ */
+export type PipelineValidationContext = {
+    pipeline: PipelineJson;
+    pipelineIdentification: string;
+};
+/**
+ * Creates the shared validation context for one pipeline.
+ *
+ * @private function of `validatePipeline`
+ */
+export declare function createPipelineValidationContext(pipeline: PipelineJson): PipelineValidationContext;

package/umd/src/conversion/validation/validatePipeline/validatePipelineCollectionsStructure.d.ts

@@ -0,0 +1,7 @@
+import type { PipelineValidationContext } from './createPipelineValidationContext';
+/**
+ * Validates that the expected top-level collections have array structure.
+ *
+ * @private function of `validatePipeline`
+ */
+export declare function validatePipelineCollectionsStructure({ pipeline, pipelineIdentification, }: PipelineValidationContext): void;

package/umd/src/conversion/validation/validatePipeline/validatePipelineDependencyResolution.d.ts

@@ -0,0 +1,7 @@
+import type { PipelineValidationContext } from './createPipelineValidationContext';
+/**
+ * Validates that task dependencies can be resolved without cycles or missing definitions.
+ *
+ * @private function of `validatePipeline`
+ */
+export declare function validatePipelineDependencyResolution({ pipeline, pipelineIdentification, }: PipelineValidationContext): void;