@promptbook/cli 0.114.0-35 → 0.114.0-39

package/esm/scripts/run-agent-messages/messages/createAgentRunnerSystemMessage.d.ts

@@ -1,9 +1,10 @@
 import type { AgentModelRequirements } from '../../../src/book-2.0/agent-source/AgentModelRequirements';
+import type { CreateAgentModelRequirementsOptions } from '../../../src/book-2.0/agent-source/CreateAgentModelRequirementsOptions';
 import type { string_book } from '../../../src/book-2.0/agent-source/string_book';
 /**
  * Compiles agent source into the behavior text passed to CLI harness runners.
  */
-export declare function createAgentRunnerSystemMessage(agentSource: string_book): Promise<string>;
+export declare function createAgentRunnerSystemMessage(agentSource: string_book, options?: CreateAgentModelRequirementsOptions): Promise<string>;
 /**
  * Formats prepared model requirements for a text-only CLI harness prompt.
  */

package/esm/scripts/run-codex-prompts/common/resolveCoderAgent.d.ts

@@ -7,6 +7,13 @@ export type ResolvedCoderAgentBook = {
      * Raw source of the agent `.book` file.
      */
     readonly agentSource: string_book;
+    /**
+     * Human-readable name of the agent, as it is reported in prompt status lines and run traces.
+     *
+     * Comes from the `META FULLNAME` of the Book, or from the plain title on its first line, so it is the
+     * display name of the agent and not its normalized identifier.
+     */
+    readonly agentName: string;
     /**
      * Equivalent references by which a prompt may target this agent.
      *
@@ -19,10 +26,14 @@ export type ResolvedCoderAgentBook = {
  * Agent data resolved from the optional `--agent` book file.
  */
 export type ResolvedCoderAgent = ResolvedCoderAgentBook & {
+    /** Source with inheritance and imports applied, also used for the coder's agent visual. */
+    readonly agentSource: string_book;
     /**
      * Compiled system message injected into each coding prompt.
      */
     readonly systemMessage: string;
+    /** Books created during resolution, committed according to the coder's normal commit setting. */
+    readonly createdAgentBookPaths: ReadonlyArray<string>;
 };
 /**
  * Reads an optional agent `.book` file and prepares the references that route prompts to it.

package/esm/scripts/run-codex-prompts/git/commitInitializedAgentBooks.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Commits newly initialized, non-ignored agent books before the coder's clean-tree checkpoint.
+ * Only books created by this run are eligible; existing books and unrelated changes remain outside the commit.
+ */
+export declare function commitInitializedAgentBooks(projectPath: string, createdAgentBookPaths: ReadonlyArray<string>): Promise<void>;

package/esm/scripts/run-codex-prompts/main/resolvePromptRunner.d.ts

@@ -1,12 +1,6 @@
 import type { RunOptions } from '../cli/RunOptions';
+import type { PromptRunnerMetadata } from '../common/PromptRunnerMetadata';
 import type { PromptRunner } from '../runners/types/PromptRunner';
-/**
- * Runner metadata used in prompt status lines.
- */
-type RunnerMetadata = {
-    runnerName: string;
-    modelName?: string;
-};
 /**
  * Subset of `RunOptions` which decides which prompt runner is created and how it is labeled.
  *
@@ -20,7 +14,10 @@ export type PromptRunnerSelectionOptions = Pick<RunOptions, 'agentName' | 'model
 type PromptRunnerResolution = {
     runner: PromptRunner;
     actualRunnerModel?: string;
-    runnerMetadata: RunnerMetadata;
+    /**
+     * Harness half of the run metadata; the optional Book agent is added by the caller which resolves it.
+     */
+    runnerMetadata: PromptRunnerMetadata;
 };
 /**
  * Resolves the configured prompt runner together with status-line metadata.

package/esm/scripts/run-codex-prompts/main/runPromptRound.d.ts

@@ -1,6 +1,7 @@
 import type { RunOptions } from '../cli/RunOptions';
 import type { CliProgressDisplay } from '../common/cliProgressDisplay';
 import type { WaitForCoderRunPauseCheckpoint } from '../common/CoderRunPauseCheckpoint';
+import type { PromptRunnerMetadata } from '../common/PromptRunnerMetadata';
 import type { PromptSelection } from '../prompts/types/PromptSelection';
 import type { PromptRunner } from '../runners/types/PromptRunner';
 import type { CoderRunUiHandle } from '../ui/renderCoderRunUi';
@@ -10,10 +11,7 @@ import type { CoderRunUiHandle } from '../ui/renderCoderRunUi';
 export type RunPromptRoundOptions = {
     options: RunOptions;
     runner: PromptRunner;
-    runnerMetadata: {
-        runnerName: string;
-        modelName?: string;
-    };
+    runnerMetadata: PromptRunnerMetadata;
     nextPrompt: PromptSelection;
     promptLabel: string;
     resolvedCoderContext?: string;

package/esm/scripts/run-codex-prompts/prompts/buildPromptRunTraceContent.d.ts

@@ -1,7 +1,7 @@
 import moment from 'moment';
 import { type CodexLoginMethod } from '../../../src/book-3.0/codexLoginMethod';
-import type { ThinkingLevel } from '../../../src/cli/cli-commands/coder/ThinkingLevel';
 import type { CoderRunStep } from '../common/CoderRunStep';
+import { type FormatRunnerSignatureOptions } from './formatRunnerSignature';
 import type { PromptFile } from './types/PromptFile';
 import type { PromptSection } from './types/PromptSection';
 /**
@@ -29,21 +29,9 @@ export type PromptRunTraceOutcome = {
 /**
  * Everything one run trace says about the prompt round it describes.
  */
-export type BuildPromptRunTraceContentOptions = {
+export type BuildPromptRunTraceContentOptions = FormatRunnerSignatureOptions & {
     readonly file: PromptFile;
     readonly section: PromptSection;
-    /**
-     * Harness which ran the prompt.
-     */
-    readonly runnerName?: string;
-    /**
-     * Model the harness ran the prompt with.
-     */
-    readonly modelName?: string;
-    /**
-     * Reasoning effort the harness ran the prompt with.
-     */
-    readonly thinkingLevel?: ThinkingLevel;
     /**
      * Verification command the round ran after each coding attempt, when one is configured.
      */
@@ -70,8 +58,8 @@ export type BuildPromptRunTraceContentOptions = {
 /**
  * Renders the markdown run trace of one finished or failed prompt round.
  *
- * The trace pairs the metadata of the round - which harness, model and thinking level ran it, how long each of
- * its steps took and what it cost - with the untouched runtime log, so a finished round can still be analyzed
- * after its temporary artifacts are cleaned up.
+ * The trace pairs the metadata of the round - which agent, harness, model and thinking level ran it, how long
+ * each of its steps took and what it cost - with the untouched runtime log, so a finished round can still be
+ * analyzed after its temporary artifacts are cleaned up.
  */
 export declare function buildPromptRunTraceContent(options: BuildPromptRunTraceContentOptions): string;

package/esm/scripts/run-codex-prompts/prompts/buildPromptStatusDetails.d.ts

@@ -1,11 +1,11 @@
 import { type CodexLoginMethod } from '../../../src/book-3.0/codexLoginMethod';
-import type { ThinkingLevel } from '../../../src/cli/cli-commands/coder/ThinkingLevel';
 import type { CoderRunStep, CoderRunStepKind } from '../common/CoderRunStep';
+import { type FormatRunnerSignatureOptions } from './formatRunnerSignature';
 import { type PromptRunnerAttribution } from './promptRunnerAttribution';
 /**
  * Everything one prompt status line says after its checklist marker.
  */
-export type BuildPromptStatusDetailsOptions = {
+export type BuildPromptStatusDetailsOptions = FormatRunnerSignatureOptions & {
     /**
      * Steps of the prompt round which have already finished, each with its own price and duration.
      */
@@ -14,14 +14,6 @@ export type BuildPromptStatusDetailsOptions = {
      * Step which has already started but has not finished yet, reported as `Implementation in progress`.
      */
     readonly inProgressStepKind?: CoderRunStepKind;
-    /**
-     * Harness which runs the prompt.
-     */
-    readonly runnerName: string | undefined;
-    /**
-     * Model the harness runs the prompt with.
-     */
-    readonly modelName: string | undefined;
     /**
      * Chronological runner report read from a prompt left in the middle of its implementation.
      *
@@ -37,15 +29,11 @@ export type BuildPromptStatusDetailsOptions = {
      * Authentication method the harness reported, when it is already known.
      */
     readonly loginMethod?: CodexLoginMethod;
-    /**
-     * Reasoning effort the harness runs the prompt with.
-     */
-    readonly thinkingLevel?: ThinkingLevel;
 };
 /**
  * Builds the shared body of a prompt status line, used by both the in-progress `[^]` and the done `[x]` status.
  *
  * Produces details such as
- * ``by OpenAI Codex `gpt-5.6-luna` thinking `max` (ChatGPT account) - Implementation ~$0.2036 10 minutes``.
+ * ``by Developer on OpenAI Codex `gpt-5.6-luna` thinking `max` (ChatGPT account) - Implementation ~$0.2036 10 minutes``.
  */
 export declare function buildPromptStatusDetails(options: BuildPromptStatusDetailsOptions): string;

package/esm/scripts/run-codex-prompts/prompts/formatRunnerSignature.d.ts

@@ -1,5 +1,18 @@
 import type { ThinkingLevel } from '../../../src/cli/cli-commands/coder/ThinkingLevel';
+import type { PromptRunnerMetadata } from '../common/PromptRunnerMetadata';
+/**
+ * Everything one runner signature can name, as far as it is known when the signature is formatted.
+ */
+export type FormatRunnerSignatureOptions = Partial<PromptRunnerMetadata> & {
+    /**
+     * Reasoning effort the harness runs the prompt with.
+     */
+    readonly thinkingLevel?: ThinkingLevel;
+};
 /**
  * Formats runner details for prompt status lines.
+ *
+ * Produces `` OpenAI Codex `gpt-5.6-luna` thinking `max` `` for a plain run and
+ * `` Developer on OpenAI Codex `gpt-5.6-luna` thinking `max` `` for a run personalized with `--agent`.
  */
-export declare function formatRunnerSignature(runnerName: string | undefined, modelName: string | undefined, thinkingLevel?: ThinkingLevel): string;
+export declare function formatRunnerSignature(options: FormatRunnerSignatureOptions): string;

package/esm/scripts/run-codex-prompts/prompts/markPromptFailed.d.ts

@@ -1,11 +1,12 @@
 import moment from 'moment';
+import { type FormatRunnerSignatureOptions } from './formatRunnerSignature';
 import { type PromptRunnerAttribution } from './promptRunnerAttribution';
 import type { PromptFile } from './types/PromptFile';
 import type { PromptSection } from './types/PromptSection';
 /**
  * Input for marking one prompt section as failed.
  */
-export type MarkPromptFailedOptions = {
+export type MarkPromptFailedOptions = FormatRunnerSignatureOptions & {
     /**
      * Prompt file the marked section belongs to.
      */
@@ -14,14 +15,6 @@ export type MarkPromptFailedOptions = {
      * Section which could not be implemented.
      */
     readonly section: PromptSection;
-    /**
-     * Harness which ran the prompt.
-     */
-    readonly runnerName: string | undefined;
-    /**
-     * Model the harness ran the prompt with.
-     */
-    readonly modelName: string | undefined;
     /**
      * Chronological runner report read from a prompt left in the middle of its implementation.
      */

package/esm/src/book-2.0/agent-source/AgentReferenceResolutionIssue.d.ts

@@ -0,0 +1,45 @@
+import type { BookCommitment } from '../../commitments/_base/BookCommitment';
+import type { AgentReferenceResolver } from './AgentReferenceResolver';
+/**
+ * Structured issue captured when compact agent reference resolution fails.
+ *
+ * @private internal utility of agent reference resolution
+ */
+export type AgentReferenceResolutionIssue = {
+    /**
+     * Commitment where the unresolved token appeared.
+     */
+    readonly commitmentType: BookCommitment;
+    /**
+     * Original token text (for example `{Unknown Agent}` or `@UnknownAgent`).
+     */
+    readonly token: string;
+    /**
+     * Normalized token payload used for lookup.
+     */
+    readonly reference: string;
+    /**
+     * Human-readable explanation of why the token could not be resolved.
+     */
+    readonly message: string;
+};
+/**
+ * Extension implemented by resolvers that can expose accumulated resolution issues.
+ *
+ * @private internal utility of agent reference resolution
+ */
+export type IssueTrackingAgentReferenceResolver = AgentReferenceResolver & {
+    /**
+     * Returns tracked issues and clears the internal queue.
+     */
+    consumeResolutionIssues(): Array<AgentReferenceResolutionIssue>;
+};
+/**
+ * Drains unresolved compact-reference issues from a resolver when supported.
+ *
+ * @param resolver - Resolver instance that may implement issue tracking.
+ * @returns Collected issues or an empty list.
+ *
+ * @private internal utility of agent reference resolution
+ */
+export declare function consumeAgentReferenceResolutionIssues(resolver?: AgentReferenceResolver): Array<AgentReferenceResolutionIssue>;

package/esm/src/book-2.0/agent-source/createAgentModelRequirements.deduplication.test.d.ts

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

package/esm/src/book-2.0/agent-source/deduplicateSystemMessage.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Removes duplicated instructions from a generated system message
+ *
+ * Commitments are applied one by one, so a commitment used multiple times in one book repeats its whole
+ * section, including the shared guidance preamble. For example two `WRITING RULES` commitments emit the
+ * `## Writing rules` heading and its guidance paragraph twice. This function merges all sections sharing
+ * one heading into the position of their first occurrence and keeps every identical block only once.
+ *
+ * @param systemMessage The assembled system message which may contain repeated sections and blocks
+ * @returns The system message where each section heading and each identical block appears exactly once
+ *
+ * @private internal utility of `createAgentModelRequirementsWithCommitments`
+ */
+export declare function deduplicateSystemMessage(systemMessage: string): string;

package/esm/src/book-2.0/agent-source/deduplicateSystemMessage.test.d.ts

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

package/esm/src/book-2.0/agent-source/explicitFromCommitment.d.ts

@@ -0,0 +1,62 @@
+import type { string_book } from './string_book';
+/**
+ * One explicit `FROM` commitment written in a book.
+ *
+ * @private utility of Agents Server inheritance resolution
+ */
+export type ExplicitFromCommitment = {
+    /**
+     * Zero-based index of the line the commitment was found on, within the scanned lines.
+     */
+    readonly lineIndex: number;
+    /**
+     * Trimmed commitment content, empty string for a blank `FROM`.
+     */
+    readonly content: string;
+};
+/**
+ * Collects every explicit single-line `FROM` commitment of one book.
+ *
+ * This lightweight parser is intentionally limited to the subset needed by inheritance
+ * resolution so it stays safe to bundle into the Next.js proxy path.
+ *
+ * @param sourceLines - Book source already split into lines.
+ * @returns Found `FROM` commitments in source order, empty when the book declares no parent.
+ *
+ * @private utility of Agents Server inheritance resolution
+ */
+export declare function collectExplicitFromCommitments(sourceLines: ReadonlyArray<string>): ReadonlyArray<ExplicitFromCommitment>;
+/**
+ * Returns the effective explicit `FROM` commitment of one book.
+ *
+ * A book may repeat `FROM`, in which case the last one wins and overrides every earlier one.
+ *
+ * @param agentSource - Raw book source.
+ * @returns The last explicit `FROM` commitment, or `undefined` when the book declares no parent.
+ *
+ * @private utility of Agents Server inheritance resolution
+ */
+export declare function getEffectiveExplicitFromCommitment(agentSource: string_book): ExplicitFromCommitment | undefined;
+/**
+ * Returns the effective explicit `FROM` commitment content of one book.
+ *
+ * A book may repeat `FROM`, in which case the last one wins and overrides every earlier one.
+ *
+ * @param agentSource - Raw book source.
+ * @returns Trimmed commitment content, empty string for a blank explicit `FROM`, or `undefined` when `FROM` is absent.
+ *
+ * @private utility of Agents Server inheritance resolution
+ */
+export declare function getExplicitFromCommitmentContent(agentSource: string_book): string | undefined;
+/**
+ * Returns true when one book declares no parent at all and therefore implicitly inherits from `@Adam`.
+ *
+ * Writing no `FROM` commitment is equivalent to writing `FROM @Adam`, so only an explicit
+ * `FROM @Null` / `FROM {Void}` turns the inheritance off.
+ *
+ * @param agentSource - Raw book source.
+ * @returns True when the implicit `@Adam` ancestor applies to this book.
+ *
+ * @private utility of Agents Server inheritance resolution
+ */
+export declare function isImplicitAdamInheritance(agentSource: string_book): boolean;

package/esm/src/book-2.0/agent-source/extractAgentReferenceTokens.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Matched compact agent reference token inside commitment content.
+ *
+ * @private internal utility of agent reference resolution
+ */
+export type AgentReferenceTokenMatch = {
+    /**
+     * Original token text, for example `{Agent Name}` or `@AgentId`.
+     */
+    readonly token: string;
+    /**
+     * Token payload used for lookup.
+     */
+    readonly reference: string;
+    /**
+     * Zero-based character offset of `token` in the scanned content.
+     */
+    readonly index: number;
+    /**
+     * Length of `token` in characters.
+     */
+    readonly length: number;
+};
+/**
+ * Extracts compact agent-reference tokens from commitment content.
+ *
+ * @param content - Commitment content to inspect.
+ * @returns Matched compact reference tokens.
+ *
+ * @private internal utility of agent reference resolution
+ */
+export declare function extractAgentReferenceTokens(content: string): Array<AgentReferenceTokenMatch>;

package/esm/src/book-2.0/agent-source/resolveInheritedAgentSource.d.ts

@@ -0,0 +1,73 @@
+import type { string_agent_url } from '../../types/string_agent_url';
+import type { string_book } from './string_book';
+import type { AgentReferenceResolver } from './AgentReferenceResolver';
+/**
+ * Shared options for resolving one agent source with inheritance and imports applied.
+ *
+ * @private internal utility of agent source resolution
+ */
+export type ResolveInheritedAgentSourceOptions = {
+    /** Current recursion depth, forwarded to the source importer. */
+    readonly recursionLevel?: number;
+    /**
+     * The URL of the Adam agent to use as the default ancestor
+     *
+     * @default 'https://core.ptbk.io/agents/adam'
+     */
+    readonly adamAgentUrl?: string_agent_url;
+    /**
+     * Custom resolver used to expand compact agent references.
+     */
+    readonly agentReferenceResolver?: AgentReferenceResolver;
+    /**
+     * Canonical URL of the currently resolved agent.
+     */
+    readonly currentAgentUrl?: string_agent_url;
+    /**
+     * Additional equivalent URLs that should be treated as the current agent while detecting cycles.
+     */
+    readonly currentAgentAliases?: ReadonlyArray<string_agent_url>;
+    /**
+     * Already visited agent URLs in the current resolution stack.
+     */
+    readonly inheritancePath?: ReadonlyArray<string_agent_url>;
+    /**
+     * Source importer supplied by the host application.
+     */
+    readonly agentSourceImporter: AgentSourceImporter;
+};
+/**
+ * Context passed to a custom agent source importer.
+ *
+ * @private internal utility of agent source resolution
+ */
+export type AgentSourceImporterContext = {
+    /**
+     * Commitment that requested the imported source.
+     */
+    readonly commitmentType: 'FROM' | 'IMPORT';
+    /**
+     * Import options propagated from the current resolution pass.
+     */
+    readonly importAgentOptions: {
+        readonly recursionLevel?: number;
+        readonly inheritancePath?: ReadonlyArray<string_agent_url>;
+    };
+};
+/**
+ * Loads and recursively resolves one referenced agent using the caller's transport.
+ *
+ * @private internal utility of agent source resolution
+ */
+export type AgentSourceImporter = (agentUrl: string_agent_url, context: AgentSourceImporterContext) => Promise<string_book>;
+/**
+ * Resolves agent source with inheritance (FROM commitment)
+ *
+ * It recursively fetches the parent agent source and merges it with the current source.
+ *
+ * @param agentSource The initial agent source
+ * @returns The resolved agent source with inheritance applied
+ *
+ * @private internal utility of agent source resolution
+ */
+export declare function resolveInheritedAgentSource(agentSource: string_book, options: ResolveInheritedAgentSourceOptions): Promise<string_book>;

package/esm/src/cli/$initializePromptbookCliProgram.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from 'commander';
+/**
+ * Registers the CLI commands on a fresh Commander program without parsing arguments or running an action.
+ * Tests can configure output and exit handling before registration, so subcommands inherit those settings.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function $initializePromptbookCliProgram(program: Command): void;

package/esm/src/cli/cli-commands/coder/initializeCoderProjectConfiguration.d.ts

@@ -10,6 +10,7 @@ export type CoderInitializationSummary = {
     readonly promptsDoneDirectoryStatus: InitializationStatus;
     readonly promptsTemplatesDirectoryStatus: InitializationStatus;
     readonly agentsDirectoryStatus: InitializationStatus;
+    readonly adamAgentFileStatus: InitializationStatus;
     readonly envFileStatus: InitializationStatus;
     readonly gitignoreFileStatus: InitializationStatus;
     readonly packageJsonFileStatus: InitializationStatus;

package/esm/src/cli/cli-commands/common/LocalAgentBookCollection.d.ts

@@ -0,0 +1,46 @@
+import type { string_book } from '../../../book-2.0/agent-source/string_book';
+import type { TeammateProfile } from '../../../book-2.0/agent-source/TeammateProfileResolver';
+/**
+ * A book's source and identity, retaining its location for nested relative references.
+ *
+ * @private internal type of CLI agent resolution
+ */
+export type LocalAgentBook = {
+    readonly url: string;
+    readonly filePath?: string;
+    readonly source: string_book;
+    readonly profile: TeammateProfile;
+};
+/**
+ * Reads repository books and indexes their first-line names for CLI reference resolution.
+ *
+ * @private internal utility of CLI agent resolution
+ */
+export declare class LocalAgentBookCollection {
+    private readonly agentDirectoryPath;
+    private readonly currentWorkingDirectory;
+    private readonly booksByUrl;
+    private readonly booksByName;
+    /** Stable default ancestor selected from the initial repository scan. */
+    private adamAgentUrl;
+    /** Files initialized by this collection, for the coder's normal commit handling. */
+    readonly createdAgentBookPaths: string[];
+    /** Creates a collection rooted at the primary book's directory. */
+    constructor(agentDirectoryPath: string, currentWorkingDirectory: string);
+    /** Discovers nested books, including the hidden `.core` directory. */
+    initialize(): Promise<void>;
+    /** Identifies the default ancestor without creating an unused book for FROM null/void. */
+    getAdamAgentUrl(): string;
+    /** Resolves a unique first-line name, refusing ambiguous matches. */
+    findByName(name: string): LocalAgentBook;
+    /** Resolves a name, a path relative to its declaring book, or a path relative to the CLI cwd. */
+    resolveReference(reference: string, declaringBook: LocalAgentBook): Promise<string>;
+    /** Reads a local book once, canonicalizing symlinks so aliases cannot bypass cycle detection. */
+    readBook(filePath: string): Promise<LocalAgentBook>;
+    /** Loads a referenced remote book, while keeping local identifiers entirely inside the collection. */
+    getBook(url: string): Promise<LocalAgentBook>;
+    /** Adds a book under its normalized first-line name and preserves the display name for TEAM. */
+    private registerBook;
+    /** Walks real directories in deterministic order without following directory symlink loops. */
+    private readDirectory;
+}

package/esm/src/cli/cli-commands/common/createLocalAgentReferenceResolver.d.ts

@@ -0,0 +1,8 @@
+import type { AgentReferenceResolver } from '../../../book-2.0/agent-source/AgentReferenceResolver';
+import type { LocalAgentBook, LocalAgentBookCollection } from './LocalAgentBookCollection';
+/**
+ * Creates a resolver scoped to the book which declares each reference.
+ *
+ * @private internal utility of CLI agent resolution
+ */
+export declare function createLocalAgentReferenceResolver(collection: LocalAgentBookCollection, declaringBook: LocalAgentBook): AgentReferenceResolver;

package/esm/src/cli/cli-commands/common/ensureAdamAgentBook.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Adam's location relative to a directory of local agents.
+ *
+ * @private internal constant of CLI agent initialization
+ */
+export declare const ADAM_AGENT_BOOK_RELATIVE_PATH = ".core/adam.book";
+/**
+ * Creates the same Adam book used by the Agent Server without overwriting a project-owned book.
+ *
+ * @private internal utility of CLI agent initialization
+ */
+export declare function ensureAdamAgentBook(agentDirectoryPath: string): Promise<'created' | 'unchanged'>;

package/esm/src/cli/cli-commands/common/resolveBundledAgentBookPath.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Locates a bundled agent in either the source checkout or the generated CLI package.
+ *
+ * @private internal utility of CLI agent initialization
+ */
+export declare function resolveBundledAgentBookPath(relativeFilePath: string): Promise<string>;

package/esm/src/cli/cli-commands/common/resolveLocalAgentSource.d.ts

@@ -0,0 +1,19 @@
+import type { AgentReferenceResolver } from '../../../book-2.0/agent-source/AgentReferenceResolver';
+import type { string_book } from '../../../book-2.0/agent-source/string_book';
+/**
+ * Resolved source together with the profile resolver used when compiling TEAM commitments.
+ *
+ * @private internal type of CLI agent resolution
+ */
+export type ResolvedLocalAgentSource = {
+    readonly agentSource: string_book;
+    readonly agentReferenceResolver: AgentReferenceResolver;
+    /** Newly created books which the coder may include in its initialization commit. */
+    readonly createdAgentBookPaths: ReadonlyArray<string>;
+};
+/**
+ * Applies the shared Agent Server inheritance rules to a repository's local and remote books.
+ *
+ * @private internal utility of CLI agent resolution
+ */
+export declare function resolveLocalAgentSource(agentBookPath: string, currentWorkingDirectory: string): Promise<ResolvedLocalAgentSource>;

package/esm/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.114.0-34`).
+ * It follows semantic versioning (e.g., `0.114.0-38`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.114.0-35",
+    "version": "0.114.0-39",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,
@@ -151,7 +151,6 @@
         "@sentry/nextjs": "^10.57.0",
         "@types/formidable": "3.4.7",
         "@types/mailparser": "3.4.6",
-        "@types/swagger-ui-react": "5.18.0",
         "@types/turndown": "5.0.6",
         "@vercel/blob": "1.1.1",
         "@xmldom/xmldom": "^0.9.10",
@@ -175,7 +174,7 @@
         "node-gzip": "1.1.2",
         "nodemailer": "^7.0.13",
         "qrcode": "1.5.4",
-        "swagger-ui-react": "5.31.2",
+        "swagger-ui-dist": "5.32.15",
         "turndown": "7.2.4",
         "type-fest": "4.5.0",
         "web-push": "^3.6.7",