@promptbook/documents 0.113.0-1 → 0.113.0-10

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;

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

@@ -0,0 +1,7 @@
+import type { PipelineValidationContext } from './createPipelineValidationContext';
+/**
+ * Validates pipeline-level metadata fields.
+ *
+ * @private function of `validatePipeline`
+ */
+export declare function validatePipelineMetadata({ pipeline, pipelineIdentification }: PipelineValidationContext): void;

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

@@ -0,0 +1,7 @@
+import type { PipelineValidationContext } from './createPipelineValidationContext';
+/**
+ * Validates all pipeline parameter declarations.
+ *
+ * @private function of `validatePipeline`
+ */
+export declare function validatePipelineParameters({ pipeline, pipelineIdentification }: PipelineValidationContext): void;

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

@@ -0,0 +1,7 @@
+import type { PipelineValidationContext } from './createPipelineValidationContext';
+/**
+ * Validates all pipeline tasks and their per-task invariants.
+ *
+ * @private function of `validatePipeline`
+ */
+export declare function validatePipelineTasks({ pipeline, pipelineIdentification }: PipelineValidationContext): void;

package/umd/src/llm-providers/_common/register/$registeredLlmToolsMessage/RegisteredLlmToolsMessageContext.d.ts

@@ -0,0 +1,46 @@
+import type { string_name } from '../../../../types/string_name';
+import type { Registered } from '../../../../utils/misc/$Register';
+import type { LlmToolsMetadata } from '../LlmToolsMetadata';
+/**
+ * Environment variables available for provider resolution.
+ *
+ * @private type of `$registeredLlmToolsMessage`
+ */
+export type AvailableEnvironmentVariables = Record<string_name, string>;
+/**
+ * Mixed provider entry assembled from both provider registers.
+ *
+ * @private type of `$registeredLlmToolsMessage`
+ */
+export type RegisteredLlmToolEntry = Registered & Partial<Pick<LlmToolsMetadata, 'title' | 'envVariables'>>;
+/**
+ * Provider entry enriched with runtime availability and configuration flags.
+ *
+ * @private type of `$registeredLlmToolsMessage`
+ */
+export type RegisteredLlmToolStatus = RegisteredLlmToolEntry & {
+    readonly isMetadataAvailable: boolean;
+    readonly isInstalled: boolean;
+    readonly isFullyConfigured: boolean;
+    readonly isPartiallyConfigured: boolean;
+};
+/**
+ * Provider register snapshots used to build the summary.
+ *
+ * @private type of `$registeredLlmToolsMessage`
+ */
+export type RegisteredLlmToolRegisters = {
+    readonly registeredMetadata: ReadonlyArray<LlmToolsMetadata>;
+    readonly registeredTools: ReadonlyArray<Registered>;
+};
+/**
+ * Message-rendering context for the registered providers summary.
+ *
+ * @private type of `$registeredLlmToolsMessage`
+ */
+export type RegisteredLlmToolsMessageContext = {
+    readonly env: AvailableEnvironmentVariables;
+    readonly llmToolStatuses: ReadonlyArray<RegisteredLlmToolStatus>;
+    readonly usedEnvMessage: string;
+    readonly isRunningInNode: boolean;
+};

package/umd/src/llm-providers/_common/register/$registeredLlmToolsMessage/USED_ENV_FILENAME.d.ts

@@ -0,0 +1,11 @@
+import type { string_filename } from '../../../../types/string_filename';
+import type { $side_effect } from '../../../../utils/organization/$side_effect';
+/**
+ * Shared state for the `.env` file used to configure LLM tools.
+ *
+ * @private internal state of `$registeredLlmToolsMessage`
+ */
+export declare const USED_ENV_FILENAME: {
+    set(filepath: string_filename): $side_effect;
+    createMessage(): string;
+};

package/umd/src/llm-providers/_common/register/$registeredLlmToolsMessage/createRegisteredLlmToolConfigurationStatusMessage.d.ts

@@ -0,0 +1,7 @@
+import type { AvailableEnvironmentVariables, RegisteredLlmToolStatus } from './RegisteredLlmToolsMessageContext';
+/**
+ * Creates the configuration-status sentence for one provider.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function createRegisteredLlmToolConfigurationStatusMessage({ envVariables, isFullyConfigured, isPartiallyConfigured }: RegisteredLlmToolStatus, env: AvailableEnvironmentVariables): string;

package/umd/src/llm-providers/_common/register/$registeredLlmToolsMessage/createRegisteredLlmToolEntryKey.d.ts

@@ -0,0 +1,7 @@
+import type { Registered } from '../../../../utils/misc/$Register';
+/**
+ * Creates a deduplication key for a provider entry.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function createRegisteredLlmToolEntryKey({ packageName, className }: Registered): string;

package/umd/src/llm-providers/_common/register/$registeredLlmToolsMessage/createRegisteredLlmToolInstallationStatusMessage.d.ts

@@ -0,0 +1,7 @@
+import type { RegisteredLlmToolStatus } from './RegisteredLlmToolsMessageContext';
+/**
+ * Creates the installation-status sentence for one provider.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function createRegisteredLlmToolInstallationStatusMessage({ isMetadataAvailable, isInstalled, }: Pick<RegisteredLlmToolStatus, 'isMetadataAvailable' | 'isInstalled'>): string;

package/umd/src/llm-providers/_common/register/$registeredLlmToolsMessage/createRegisteredLlmToolStatus.d.ts

@@ -0,0 +1,14 @@
+import type { Registered } from '../../../../utils/misc/$Register';
+import type { LlmToolsMetadata } from '../LlmToolsMetadata';
+import type { AvailableEnvironmentVariables, RegisteredLlmToolEntry, RegisteredLlmToolStatus } from './RegisteredLlmToolsMessageContext';
+/**
+ * Builds the runtime status for one provider entry.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function createRegisteredLlmToolStatus({ registeredLlmToolEntry, registeredMetadata, registeredTools, env, }: {
+    readonly registeredLlmToolEntry: RegisteredLlmToolEntry;
+    readonly registeredMetadata: ReadonlyArray<LlmToolsMetadata>;
+    readonly registeredTools: ReadonlyArray<Registered>;
+    readonly env: AvailableEnvironmentVariables;
+}): RegisteredLlmToolStatus;

package/umd/src/llm-providers/_common/register/$registeredLlmToolsMessage/createRegisteredLlmToolsMessageContext.d.ts

@@ -0,0 +1,7 @@
+import type { RegisteredLlmToolsMessageContext } from './RegisteredLlmToolsMessageContext';
+/**
+ * Collects all state needed to render the provider summary.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function createRegisteredLlmToolsMessageContext(): RegisteredLlmToolsMessageContext;

package/umd/src/llm-providers/_common/register/$registeredLlmToolsMessage/getAvailableRegisteredLlmToolsEnvironmentVariables.d.ts

@@ -0,0 +1,7 @@
+import type { AvailableEnvironmentVariables } from './RegisteredLlmToolsMessageContext';
+/**
+ * Reads environment variables relevant for provider configuration.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function getAvailableRegisteredLlmToolsEnvironmentVariables(isRunningInNode: boolean): AvailableEnvironmentVariables;

package/umd/src/llm-providers/_common/register/$registeredLlmToolsMessage/getRegisteredLlmToolRegisters.d.ts

@@ -0,0 +1,7 @@
+import type { RegisteredLlmToolRegisters } from './RegisteredLlmToolsMessageContext';
+/**
+ * Takes stable snapshots of both LLM provider registers.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function getRegisteredLlmToolRegisters(): RegisteredLlmToolRegisters;

package/umd/src/llm-providers/_common/register/$registeredLlmToolsMessage/hasRegisteredLlmToolEntry.d.ts

@@ -0,0 +1,7 @@
+import type { Registered } from '../../../../utils/misc/$Register';
+/**
+ * Checks whether the given provider entry already exists in the target register list.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function hasRegisteredLlmToolEntry(registeredLlmToolEntries: ReadonlyArray<Registered>, registeredLlmToolEntry: Registered): boolean;

package/umd/src/llm-providers/_common/register/$registeredLlmToolsMessage/listRegisteredLlmToolEntries.d.ts

@@ -0,0 +1,9 @@
+import type { Registered } from '../../../../utils/misc/$Register';
+import type { LlmToolsMetadata } from '../LlmToolsMetadata';
+import type { RegisteredLlmToolEntry } from './RegisteredLlmToolsMessageContext';
+/**
+ * Merges provider entries from the metadata and constructor registers.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function listRegisteredLlmToolEntries(registeredMetadata: ReadonlyArray<LlmToolsMetadata>, registeredTools: ReadonlyArray<Registered>): Array<RegisteredLlmToolEntry>;

package/umd/src/llm-providers/_common/register/$registeredLlmToolsMessage/listRegisteredLlmToolStatuses.d.ts

@@ -0,0 +1,7 @@
+import type { AvailableEnvironmentVariables, RegisteredLlmToolRegisters, RegisteredLlmToolStatus } from './RegisteredLlmToolsMessageContext';
+/**
+ * Lists provider entries enriched with installation and configuration state.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function listRegisteredLlmToolStatuses({ registeredMetadata, registeredTools }: RegisteredLlmToolRegisters, env: AvailableEnvironmentVariables): Array<RegisteredLlmToolStatus>;

package/umd/src/llm-providers/_common/register/$registeredLlmToolsMessage/renderAvailableRegisteredLlmTools.d.ts

@@ -0,0 +1,7 @@
+import type { AvailableEnvironmentVariables, RegisteredLlmToolStatus } from './RegisteredLlmToolsMessageContext';
+/**
+ * Renders all provider lines in the status summary.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function renderAvailableRegisteredLlmTools(llmToolStatuses: ReadonlyArray<RegisteredLlmToolStatus>, env: AvailableEnvironmentVariables, isRunningInNode: boolean): string;

package/umd/src/llm-providers/_common/register/$registeredLlmToolsMessage/renderNoRegisteredLlmToolsMessage.d.ts

@@ -0,0 +1,7 @@
+import type { string_markdown } from '../../../../types/string_markdown';
+/**
+ * Renders the fallback message for environments with no registered providers.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function renderNoRegisteredLlmToolsMessage(usedEnvMessage: string): string_markdown;

package/umd/src/llm-providers/_common/register/$registeredLlmToolsMessage/renderRegisteredLlmToolsMessage.d.ts

@@ -0,0 +1,8 @@
+import type { string_markdown } from '../../../../types/string_markdown';
+import type { RegisteredLlmToolsMessageContext } from './RegisteredLlmToolsMessageContext';
+/**
+ * Renders the full provider status summary.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function renderRegisteredLlmToolsMessage({ env, llmToolStatuses, usedEnvMessage, isRunningInNode, }: RegisteredLlmToolsMessageContext): string_markdown;

package/umd/src/llm-providers/_common/register/$registeredLlmToolsMessage/renderRelevantRegisteredLlmToolsEnvironmentVariables.d.ts

@@ -0,0 +1,7 @@
+import type { AvailableEnvironmentVariables, RegisteredLlmToolStatus } from './RegisteredLlmToolsMessageContext';
+/**
+ * Renders the list of environment variables used by at least one registered provider.
+ *
+ * @private function of `$registeredLlmToolsMessage`
+ */
+export declare function renderRelevantRegisteredLlmToolsEnvironmentVariables(env: AvailableEnvironmentVariables, llmToolStatuses: ReadonlyArray<RegisteredLlmToolStatus>): string;

package/umd/src/utils/agent-message-runtime/agentMessageRuntimePaths.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Temporary subdirectory used for agent-message runner shell scripts.
+ *
+ * @private internal constant of agent-message runtime paths
+ */
+export declare const AGENT_MESSAGE_SCRIPT_DIRECTORY_NAME = "agent-messages";
+/**
+ * Builds the temporary shell script path used by one queued agent-message harness run.
+ *
+ * @param projectPath - Local agent project path containing the message queue.
+ * @param sourceFileName - Queued message filename used to name the temporary shell script.
+ * @returns Temporary shell script path.
+ * @private internal utility of agent-message runners
+ */
+export declare function buildAgentMessageScriptPathFromFileName(projectPath: string, sourceFileName: string): string;
+/**
+ * Builds the live runtime log path used by one queued agent-message harness run.
+ *
+ * @param projectPath - Local agent project path containing the message queue.
+ * @param sourceFileName - Queued message filename used to name the temporary shell script.
+ * @returns Temporary live runtime log path.
+ * @private internal utility of agent-message runners
+ */
+export declare function buildAgentMessageRuntimeLogPathFromFileName(projectPath: string, sourceFileName: string): string;

package/umd/src/utils/agents/resolveAgentAvatarImageUrl.d.ts

@@ -39,7 +39,7 @@ export type ResolveAgentAvatarOptions = {
  */
 export type ResolveAgentAvatarImageUrlOptions = ResolveAgentAvatarOptions;
 /**
- * Default built-in avatar visual used when an agent does not define `META IMAGE`.
+ * Default built-in avatar visual used when an agent does not define `META IMAGE`, `META AVATAR`, or `META VISUAL`.
  *
  * @private shared avatar contract
  */
@@ -76,7 +76,7 @@ export declare function resolveAgentAvatarVisualId(agent: ResolveAgentAvatarOpti
 export declare function resolveAgentAvatarFallbackUrl(options: ResolveAgentAvatarOptions): string_url_image | null;
 /**
  * Resolve the best avatar representation for an agent, preferring explicit `META IMAGE`
- * and otherwise returning the default deterministic canvas visual.
+ * and otherwise returning the selected deterministic canvas visual.
  *
  * @private utility of `<Chat/>`
  */