@promptbook/cli 0.113.0-8 → 0.114.0-0

package/umd/src/cli/cli-commands/common/harness/$resolveLatestHarnessVersion.d.ts

@@ -0,0 +1,10 @@
+import type { HarnessDefinition } from './HarnessDefinition';
+/**
+ * Reads the newest version of the harness published to npm.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it queries the npm registry
+ *
+ * @returns The newest published version or `null` when the registry could not be reached
+ * @private internal utility of `promptbookCli`
+ */
+export declare function $resolveLatestHarnessVersion(definition: HarnessDefinition): Promise<string | null>;

package/umd/src/cli/cli-commands/common/harness/HarnessDefinition.d.ts

@@ -0,0 +1,40 @@
+import type { PromptRunnerHarnessName } from '../promptRunnerCliOptions';
+/**
+ * Static description of one supported CLI coding harness.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export type HarnessDefinition = {
+    /**
+     * Harness identifier used by the `--harness` option.
+     */
+    readonly harnessName: PromptRunnerHarnessName;
+    /**
+     * Human-readable harness name shown in the terminal.
+     */
+    readonly label: string;
+    /**
+     * Globally installed command which runs the harness.
+     */
+    readonly commandName: string;
+    /**
+     * Npm package which installs the harness command globally.
+     */
+    readonly npmPackageName: string;
+    /**
+     * Extra environment variables required by the global npm installation of this harness.
+     */
+    readonly npmInstallEnvironment?: Readonly<Record<string, string>>;
+};
+/**
+ * Single source of truth about how each supported CLI coding harness is installed and detected.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare const HARNESS_DEFINITIONS: Readonly<Record<PromptRunnerHarnessName, HarnessDefinition>>;
+/**
+ * Looks up the definition of one supported CLI coding harness.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function getHarnessDefinition(harnessName: PromptRunnerHarnessName): HarnessDefinition;

package/umd/src/cli/cli-commands/common/harness/HarnessDefinition.test.d.ts

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

package/umd/src/cli/cli-commands/common/harness/HarnessInstallationStatus.d.ts

@@ -0,0 +1,35 @@
+import type { HarnessDefinition } from './HarnessDefinition';
+/**
+ * Result of comparing the globally installed harness version with the newest published one.
+ *
+ * - `up-to-date` the newest published version is installed
+ * - `outdated` an older version is installed
+ * - `not-installed` the harness command is not available globally
+ * - `unknown` the harness is installed but the newest published version could not be resolved, for example when offline
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export type HarnessInstallationState = 'up-to-date' | 'outdated' | 'not-installed' | 'unknown';
+/**
+ * Installation state of one CLI coding harness on the current machine.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export type HarnessInstallationStatus = {
+    /**
+     * Harness the status belongs to.
+     */
+    readonly definition: HarnessDefinition;
+    /**
+     * Comparison of the installed version with the newest published one.
+     */
+    readonly installationState: HarnessInstallationState;
+    /**
+     * Version of the globally installed harness command or `null` when the harness is not installed.
+     */
+    readonly installedVersion: string | null;
+    /**
+     * Newest version published to npm or `null` when it could not be resolved.
+     */
+    readonly latestVersion: string | null;
+};

package/umd/src/cli/cli-commands/common/harness/buildHarnessInstallCommand.d.ts

@@ -0,0 +1,10 @@
+import type { HarnessDefinition } from './HarnessDefinition';
+/**
+ * Builds the shell command which installs or updates one CLI coding harness globally.
+ *
+ * The very same command is executed by `$installHarness` and printed as the manual fallback,
+ * so the user always sees exactly what Promptbook would run.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function buildHarnessInstallCommand(definition: HarnessDefinition): string;

package/umd/src/cli/cli-commands/common/harness/extractHarnessVersionFromOutput.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Extracts the version from the raw output of a harness `--version` command.
+ *
+ * Harness CLIs print their version in many shapes, for example `2.1.199 (Claude Code)`,
+ * `codex-cli 0.144.4`, `GitHub Copilot CLI 1.0.61.` or after unrelated deprecation warning lines,
+ * so the first version-looking token of the first matching line wins.
+ *
+ * @returns The parsed version or `null` when the output contains no version
+ * @private internal utility of `promptbookCli`
+ */
+export declare function extractHarnessVersionFromOutput(output: string): string | null;

package/umd/src/cli/cli-commands/common/harness/extractHarnessVersionFromOutput.test.d.ts

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

package/umd/src/cli/cli-commands/common/harness/formatHarnessInstallationWarning.d.ts

@@ -0,0 +1,7 @@
+import type { HarnessInstallationStatus } from './HarnessInstallationStatus';
+/**
+ * Formats the warning shown when a harness is missing or outdated.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function formatHarnessInstallationWarning(status: HarnessInstallationStatus): string;

package/umd/src/cli/cli-commands/common/harness/isHarnessVersionOutdated.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Compares the installed harness version with the newest version published to npm.
+ *
+ * Only the numeric `major.minor.patch` segments are compared and pre-release suffixes are ignored,
+ * so a harness installed from a pre-release build of the newest version is not reported as outdated.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function isHarnessVersionOutdated(installedVersion: string, latestVersion: string): boolean;

package/umd/src/cli/cli-commands/common/harness/isHarnessVersionOutdated.test.d.ts

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

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/buildAgentNameOrPermanentIdFilter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Builds a Supabase `.or()` filter that matches an agent by its human-readable name or its permanent id.
+ *
+ * The human-readable `agentName` is matched exactly, while the `permanentId` is matched
+ * case-insensitively (via `ilike`) so that the same permanent id resolves to the same agent
+ * regardless of the letter casing used in the URL.
+ *
+ * Supabase/PostgREST filters expect values to be URL-encoded so that characters like spaces or
+ * punctuation do not break the query syntax (e.g. `agentName.eq.AI Team`). The permanent-id value is
+ * additionally `LIKE`-escaped so that a name containing wildcard characters cannot be interpreted as
+ * a pattern.
+ *
+ * @param agentNameOrPermanentId - Agent name or stable permanent identifier to match.
+ * @returns `.or()` filter string safe to pass to Supabase.
+ *
+ * @private internal helper shared by `AgentCollectionInSupabase` and the Agents Server agent lookups
+ */
+export declare function buildAgentNameOrPermanentIdFilter(agentNameOrPermanentId: string): string;

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

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

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,13 +4,14 @@ 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
  * - META TITLE: Sets the agent's display title
  * - META DESCRIPTION: Sets the agent's description
  * - META INPUT PLACEHOLDER: Sets chat input placeholder text
+ * - META THINKING MESSAGE: Adds custom thinking placeholder variants
  * - META [ANYTHING]: Any other meta information in uppercase format
  *
  * These commitments are special because they don't affect the system message,
@@ -19,13 +20,14 @@ 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
  * META TITLE Professional Assistant
  * META DESCRIPTION An AI assistant specialized in business tasks
  * META INPUT PLACEHOLDER Write a message...
+ * META THINKING MESSAGE Thinking...
  * META AUTHOR John Doe
  * META VERSION 1.0
  * ```

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/META_THINKING_MESSAGE/META_THINKING_MESSAGE.d.ts

@@ -0,0 +1,26 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * META THINKING MESSAGE commitment definition.
+ *
+ * The `META THINKING MESSAGE` commitment adds one custom thinking placeholder
+ * variant used by chat UIs while an agent is composing a reply.
+ *
+ * @private Metadata-only commitment used by Agents Server chat UIs.
+ */
+export declare class MetaThinkingMessageCommitmentDefinition extends BaseCommitmentDefinition<'META THINKING MESSAGE'> {
+    constructor();
+    /**
+     * Short one-line description of META THINKING MESSAGE.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for META THINKING MESSAGE commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}

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

@@ -25,6 +25,7 @@ import { MetaFontCommitmentDefinition } from './META_FONT/META_FONT';
 import { MetaImageCommitmentDefinition } from './META_IMAGE/META_IMAGE';
 import { MetaInputPlaceholderCommitmentDefinition } from './META_INPUT_PLACEHOLDER/META_INPUT_PLACEHOLDER';
 import { MetaLinkCommitmentDefinition } from './META_LINK/META_LINK';
+import { MetaThinkingMessageCommitmentDefinition } from './META_THINKING_MESSAGE/META_THINKING_MESSAGE';
 import { MetaVisibilityCommitmentDefinition } from './META_VISIBILITY/META_VISIBILITY';
 import { MetaVoiceCommitmentDefinition } from './META_VOICE/META_VOICE';
 import { ModelCommitmentDefinition } from './MODEL/MODEL';
@@ -62,4 +63,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, MetaThinkingMessageCommitmentDefinition, 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/execution/utils/formatUsagePrice.d.ts

@@ -0,0 +1,12 @@
+import type { Usage } from '../Usage';
+/**
+ * Formats usage price for display in prompt status lines and task details.
+ * Examples:
+ * - "$0.12" (certain)
+ * - "~$3.05" (uncertain)
+ * - "$0.00" (zero cost)
+ * - "<$0.01" (tiny non-zero cost)
+ *
+ * @private internal utility of the prompt runners and the Agents Server task details
+ */
+export declare function formatUsagePrice(usage: Usage): string;

package/umd/src/execution/utils/formatUsagePrice.test.d.ts

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

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/agent-message-runtime/resolveAgentMessageRuntimeActivity.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Resolves the latest user-friendly activity snippet from a coding-harness runtime log.
+ *
+ * The Agents Server local agent runner streams the answering harness output (for example
+ * Claude Code `--output-format stream-json`) into a live runtime log file next to the queued
+ * message. This helper extracts the most recent natural-language assistant narration so the
+ * durable chat can show what the agent is doing right now instead of a generic thinking
+ * placeholder. Only plain assistant text is surfaced; raw tool payloads, JSON envelopes and
+ * other technical details are intentionally ignored, and harnesses that do not stream
+ * structured text simply resolve to `null` so the caller keeps its existing behavior.
+ *
+ * @param logText - Raw runtime log content.
+ * @returns Latest human-readable activity snippet, or `null` when none can be resolved.
+ * @private internal utility of the agent-message runtime
+ */
+export declare function resolveAgentMessageRuntimeActivity(logText: string | null | undefined): string | null;

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

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