@promptbook/markdown-utils 0.111.0-7 → 0.112.0-100

package/esm/src/scrapers/markitdown/register-constructor.d.ts

@@ -10,8 +10,3 @@ import type { Registration } from '../../utils/misc/$Register';
  * @public exported from `@promptbook/cli`
  */
 export declare const _MarkitdownScraperRegistration: Registration;
-/**
- * TODO: [🧠][🌜] Export only from `@promptbook/markitdown` or `@promptbook/pdf` NOT both
- * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/scrapers/markitdown/register-metadata.d.ts

@@ -15,6 +15,3 @@ export declare const markitdownScraperMetadata: any;
  * @public exported from `@promptbook/cli`
  */
 export declare const _MarkitdownScraperMetadataRegistration: Registration;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/scrapers/pdf/PdfScraper.d.ts

@@ -10,6 +10,7 @@ import type { ScraperIntermediateSource } from '../_common/ScraperIntermediateSo
  * Scraper for .pdf files
  *
  * @see `documentationUrl` for more details
+ *
  * @public exported from `@promptbook/pdf`
  */
 export declare class PdfScraper implements Converter, Scraper {
@@ -33,9 +34,3 @@ export declare class PdfScraper implements Converter, Scraper {
      */
     scrape(source: ScraperSourceHandler): Promise<ReadonlyArray<Omit<KnowledgePiecePreparedJson, 'sources' | 'preparationIds'>> | null>;
 }
-/**
- * TODO: [👣] Converted pdf documents can act as cached items - there is no need to run conversion each time
- * TODO: [🪂] Do it in parallel 11:11
- * Note: No need to aggregate usage here, it is done by intercepting the llmTools
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */

package/esm/src/scrapers/pdf/createPdfScraper.d.ts

@@ -5,6 +5,3 @@
  * @public exported from `@promptbook/pdf`
  */
 export declare const createPdfScraper: any;
-/**
- * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
- */

package/esm/src/scrapers/pdf/playground/pdf-scraper-playground.d.ts

@@ -1,5 +1,2 @@
 #!/usr/bin/env ts-node
 export {};
-/**
- * Note: [⚫] Code in this file should never be published in any package
- */

package/esm/src/scrapers/pdf/register-constructor.d.ts

@@ -9,7 +9,3 @@ import type { Registration } from '../../utils/misc/$Register';
  * @public exported from `@promptbook/cli`
  */
 export declare const _PdfScraperRegistration: Registration;
-/**
- * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/scrapers/pdf/register-metadata.d.ts

@@ -15,6 +15,3 @@ export declare const pdfScraperMetadata: any;
  * @public exported from `@promptbook/cli`
  */
 export declare const _PdfScraperMetadataRegistration: Registration;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/scrapers/website/WebsiteScraper.d.ts

@@ -1,8 +1,7 @@
 import type { KnowledgePiecePreparedJson } from '../../pipeline/PipelineJson/KnowledgePieceJson';
-import type { string_markdown } from '../../types/typeAliases';
+import type { string_markdown } from '../../types/string_markdown';
 import type { Converter } from '../_common/Converter';
-import type { Scraper } from '../_common/Scraper';
-import type { ScraperSourceHandler } from '../_common/Scraper';
+import type { Scraper, ScraperSourceHandler } from '../_common/Scraper';
 import type { ExecutionTools } from '../../execution/ExecutionTools';
 import type { PrepareAndScrapeOptions } from '../../prepare/PrepareAndScrapeOptions';
 import type { ScraperAndConverterMetadata } from '../_common/register/ScraperAndConverterMetadata';
@@ -11,6 +10,7 @@ import type { ScraperIntermediateSource } from '../_common/ScraperIntermediateSo
  * Scraper for websites
  *
  * @see `documentationUrl` for more details
+ *
  * @public exported from `@promptbook/website-crawler`
  */
 export declare class WebsiteScraper implements Converter, Scraper {
@@ -42,9 +42,3 @@ export declare class WebsiteScraper implements Converter, Scraper {
      */
     scrape(source: ScraperSourceHandler): Promise<ReadonlyArray<Omit<KnowledgePiecePreparedJson, 'sources' | 'preparationIds'>> | null>;
 }
-/**
- * TODO: [👣] Scraped website in .md can act as cache item - there is no need to run conversion each time
- * TODO: [🪂] Do it in parallel 11:11
- * Note: No need to aggregate usage here, it is done by intercepting the llmTools
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */

package/esm/src/scrapers/website/createWebsiteScraper.d.ts

@@ -5,6 +5,3 @@
  * @public exported from `@promptbook/website-crawler`
  */
 export declare const createWebsiteScraper: any;
-/**
- * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
- */

package/esm/src/scrapers/website/playground/website-scraper-playground.d.ts

@@ -1,5 +1,2 @@
 #!/usr/bin/env ts-node
 export {};
-/**
- * Note: [⚫] Code in this file should never be published in any package
- */

package/esm/src/scrapers/website/register-constructor.d.ts

@@ -9,7 +9,3 @@ import type { Registration } from '../../utils/misc/$Register';
  * @public exported from `@promptbook/cli`
  */
 export declare const _WebsiteScraperRegistration: Registration;
-/**
- * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/scrapers/website/register-metadata.d.ts

@@ -15,6 +15,3 @@ export declare const websiteScraperMetadata: any;
  * @public exported from `@promptbook/cli`
  */
 export declare const _WebsiteScraperMetadataRegistration: Registration;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/scripting/javascript/JavascriptEvalExecutionTools.d.ts

@@ -4,7 +4,7 @@ import type { JavascriptExecutionToolsOptions } from './JavascriptExecutionTools
  * ScriptExecutionTools for JavaScript implemented via eval
  *
  * Warning: It is used for testing and mocking
- *          **NOT intended to use in the production** due to its unsafe nature, use `JavascriptExecutionTools` instead.
+ * **NOT intended to use in the production** due to its unsafe nature, use `JavascriptExecutionTools` instead.
  *
  * @public exported from `@promptbook/javascript`
  */
@@ -16,7 +16,3 @@ export declare class JavascriptEvalExecutionTools implements ScriptExecutionTool
      */
     execute(options: ScriptExecutionToolsExecuteOptions): Promise<string>;
 }
-/**
- * TODO: Put predefined functions (like removeQuotes, spaceTrim, etc.) into annotation OR pass into constructor
- * TODO: [🧠][💙] Distinct between options passed into ExecutionTools and to ExecutionTools.execute
- */

package/esm/src/scripting/javascript/JavascriptEvalExecutionTools.test.d.ts

@@ -1,4 +1 @@
 export {};
-/**
- * TODO: Make shared test between JavascriptEvalExecutionTools and JavascriptExecutionTools to test the same functionality when implemented via vm2
- */

package/esm/src/scripting/javascript/JavascriptExecutionTools.d.ts

@@ -3,6 +3,7 @@ import { JavascriptEvalExecutionTools } from './JavascriptEvalExecutionTools';
  * Placeholder for better implementation of JavascriptExecutionTools - some proper sandboxing
  *
  * @alias JavascriptExecutionTools
+ *
  * @public exported from `@promptbook/javascript`
  */
 export declare const JavascriptExecutionTools: typeof JavascriptEvalExecutionTools;

package/esm/src/scripting/javascript/JavascriptExecutionToolsOptions.d.ts

@@ -1,7 +1,7 @@
 import type { Promisable } from 'type-fest';
-import { TODO_any } from '../../_packages/types.index';
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
-import type { string_postprocessing_function_name } from '../../types/typeAliases';
+import type { string_postprocessing_function_name } from '../../types/string_person_fullname';
+import type { TODO_any } from '../../utils/organization/TODO_any';
 /**
  * Options for `JavascriptExecutionTools`
  */
@@ -26,6 +26,3 @@ export type PostprocessingFunction = ((value: string) => Promisable<string>) | F
  * Function that can be used as tool for AI model
  */
 export type ToolFunction = (args: TODO_any) => Promise<TODO_any>;
-/**
- * TODO: [🧠][💙] Distinct between options passed into ExecutionTools and to ExecutionTools.execute
- */

package/esm/src/scripting/javascript/postprocessing-functions.d.ts

@@ -1,4 +1,4 @@
-import spaceTrim from 'spacetrim';
+import { spaceTrim } from 'spacetrim';
 import { extractBlock } from '../../postprocessing/utils/extractBlock';
 import { prettifyMarkdown } from '../../utils/markdown/prettifyMarkdown';
 import { trimCodeBlock } from '../../utils/markdown/trimCodeBlock';
@@ -50,7 +50,3 @@ export declare const POSTPROCESSING_FUNCTIONS: {
     normalizeTo_SCREAMING_CASE: typeof normalizeTo_SCREAMING_CASE;
     extractBlock: typeof extractBlock;
 };
-/**
- * TODO: DRY [🍯], [🧠] Where should be POSTPROCESSING_FUNCTIONS located and how it should be named
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/scripting/javascript/utils/extractVariablesFromJavascript.d.ts

@@ -1,14 +1,12 @@
-import type { string_javascript } from '../../../types/typeAliases';
-import type { string_javascript_name } from '../../../types/typeAliases';
+import type { string_javascript } from '../../../types/string_markdown';
+import type { string_javascript_name } from '../../../types/string_person_fullname';
 /**
  * Parses the given script and returns the list of all used variables that are not defined in the script
  *
  * @param script from which to extract the variables
  * @returns the list of variable names
  * @throws {ParseError} if the script is invalid
+ *
  * @public exported from `@promptbook/javascript`
  */
 export declare function extractVariablesFromJavascript(script: string_javascript): Set<string_javascript_name>;
-/**
- * TODO: [🔣] Support for multiple languages - python, java,...
- */

package/esm/src/search-engines/SearchEngine.d.ts

@@ -1,6 +1,10 @@
 import type { Promisable } from 'type-fest';
-import type { string_markdown, string_markdown_text, string_title } from '../types/typeAliases';
+import type { string_markdown, string_markdown_text } from '../types/string_markdown';
+import type { string_title } from '../types/string_title';
 import type { SearchResult } from './SearchResult';
+/**
+ * Type describing search engine.
+ */
 export type SearchEngine = {
     readonly title: string_title & string_markdown_text;
     readonly description?: string_markdown;

package/esm/src/search-engines/SearchResult.d.ts

@@ -1,4 +1,4 @@
-import type { string_url } from '../types/typeAliases';
+import type { string_url } from '../types/string_url';
 /**
  * Represents a search result from a search engine.
  */

package/esm/src/search-engines/bing/BingSearchEngine.d.ts

@@ -1,5 +1,6 @@
 import type { Promisable } from 'type-fest';
-import type { string_markdown, string_markdown_text, string_title } from '../../types/typeAliases';
+import type { string_markdown, string_markdown_text } from '../../types/string_markdown';
+import type { string_title } from '../../types/string_title';
 import type { SearchEngine } from '../SearchEngine';
 import type { SearchResult } from '../SearchResult';
 /**

package/esm/src/search-engines/dummy/DummySearchEngine.d.ts

@@ -1,5 +1,6 @@
 import type { Promisable } from 'type-fest';
-import type { string_markdown, string_markdown_text, string_title } from '../../types/typeAliases';
+import type { string_markdown, string_markdown_text } from '../../types/string_markdown';
+import type { string_title } from '../../types/string_title';
 import type { SearchEngine } from '../SearchEngine';
 import type { SearchResult } from '../SearchResult';
 /**

package/esm/src/search-engines/google/GoogleSearchEngine.d.ts

@@ -1,5 +1,6 @@
 import type { Promisable } from 'type-fest';
-import type { string_markdown, string_markdown_text, string_title } from '../../types/typeAliases';
+import type { string_markdown, string_markdown_text } from '../../types/string_markdown';
+import type { string_title } from '../../types/string_title';
 import type { SearchEngine } from '../SearchEngine';
 import type { SearchResult } from '../SearchResult';
 /**

package/esm/src/search-engines/serp/SerpSearchEngine.d.ts

@@ -1,5 +1,6 @@
 import type { Promisable } from 'type-fest';
-import type { string_markdown, string_markdown_text, string_title } from '../../types/typeAliases';
+import type { string_markdown, string_markdown_text } from '../../types/string_markdown';
+import type { string_title } from '../../types/string_title';
 import type { SearchEngine } from '../SearchEngine';
 import type { SearchResult } from '../SearchResult';
 /**

package/esm/src/speech-recognition/BrowserSpeechRecognition.d.ts

@@ -15,7 +15,3 @@ export declare class BrowserSpeechRecognition implements SpeechRecognition {
     subscribe(callback: (event: SpeechRecognitionEvent) => void): () => void;
     private emit;
 }
-/**
- * TODO: !!!! Search ACRY for `window` and put -> [🔵]
- * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
- */

package/esm/src/speech-recognition/OpenAiSpeechRecognition.d.ts

@@ -10,26 +10,96 @@ export type OpenAiSpeechRecognitionOptions = {
     readonly baseUrl?: string;
 };
 /**
- * Speech recognition using OpenAI Whisper API to transcribe audio into text
- *
- * @private because it requires server-client communication with a proxy endpoint
+ * Speech recognition using the OpenAI transcription API to transcribe audio into text
  *
  * Note: This implementation uses a server-side proxy to avoid exposing the OpenAI API key on the client.
+ *
+ * @private because it requires server-client communication with a proxy endpoint
  */
 export declare class OpenAiSpeechRecognition implements SpeechRecognition {
     private readonly options;
     private mediaRecorder;
+    private mediaStream;
     private audioContext;
+    private mediaStreamSource;
     private analyser;
-    private silenceTimeout;
+    private silenceCheckAnimationFrameId;
     private audioChunks;
     private callbacks;
     private _state;
+    private pendingStopDuringStart;
+    private isStopping;
+    private recordingStartedAt;
+    private lastSpeechDetectedAt;
+    private ambientNoiseLevel;
+    private voiceLevelMultiplier;
+    private silenceAutoStopDelayMs;
+    private recordingMimeType;
     get state(): SpeechRecognitionState;
     constructor(options?: OpenAiSpeechRecognitionOptions);
     $start(options?: SpeechRecognitionStartOptions): Promise<void>;
     $stop(): void;
     private transcribe;
+    /**
+     * Handles `MediaRecorder.onstop` by releasing audio resources and forwarding the clip to transcription.
+     *
+     * @param language Optional language hint for OpenAI transcription.
+     */
+    private handleRecorderStop;
+    /**
+     * Starts continuous silence detection and auto-stops recording shortly after speech ends.
+     */
+    private startSilenceDetection;
+    /**
+     * Stops the silence-detection animation loop.
+     */
+    private stopSilenceDetection;
+    /**
+     * Measures current voice intensity from the waveform (`0` silent .. `1` loud).
+     *
+     * @param sampleBuffer Buffer reused across animation frames.
+     * @returns RMS-based volume level.
+     */
+    private measureVoiceLevel;
+    /**
+     * Returns an adaptive speech threshold based on recently observed ambient noise.
+     */
+    private resolveAdaptiveVoiceThreshold;
+    /**
+     * Updates the rolling ambient noise estimate during silent frames.
+     *
+     * @param voiceLevel Observed frame loudness.
+     */
+    private updateAmbientNoiseLevel;
+    /**
+     * Releases browser audio resources so the microphone is fully freed for other apps.
+     */
+    private releaseRecordingResources;
+    /**
+     * Stops all microphone tracks if an active media stream exists.
+     */
+    private stopMediaStreamTracks;
     subscribe(callback: (event: SpeechRecognitionEvent) => void): () => void;
     private emit;
 }
+/**
+ * Resolves the preferred recorder output format supported by the current browser.
+ *
+ * @private internal utility of `OpenAiSpeechRecognition`
+ */
+export declare function resolveOpenAiSpeechRecognitionPreferredRecordingFormat(): {
+    readonly mimeType: string;
+    readonly fileExtension: string;
+} | undefined;
+/**
+ * Resolves the MIME type and filename for one recorded audio upload.
+ *
+ * @private internal utility of `OpenAiSpeechRecognition`
+ */
+export declare function resolveOpenAiSpeechRecognitionAudioFileDescriptor(options: {
+    readonly recorderMimeType?: string;
+    readonly audioChunks: ReadonlyArray<Blob>;
+}): {
+    readonly mimeType: string;
+    readonly fileName: string;
+};

package/esm/src/speech-recognition/OpenAiSpeechRecognition.test.d.ts

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

package/esm/src/storage/_common/PromptbookStorage.d.ts

@@ -19,7 +19,3 @@ export type PromptbookStorage<TItem> = {
      */
     removeItem(key: string): Promisable<void>;
 };
-/**
- * TODO: [💺] Constrain `TItem` to [🚉] JSON-serializable objects only in type level
- * TODO: [☹️] Unite the storages
- */

package/esm/src/storage/_common/PromptbookStorage.test-type.d.ts

@@ -1,5 +1 @@
 export {};
-/**
- * Note: [⚪] This should never be in any released package
- * TODO: Is this a good pattern to do type testing?
- */

package/esm/src/storage/env-storage/$EnvStorage.d.ts

@@ -36,6 +36,3 @@ export declare class $EnvStorage<TItem> implements PromptbookStorage<TItem> {
      */
     removeItem(key: string): void;
 }
-/**
- * TODO: Write file more securely - ensure that there can be no accidental overwriting of existing variables and other content
- */

package/esm/src/storage/file-cache-storage/FileCacheStorage.d.ts

@@ -34,7 +34,3 @@ export declare class FileCacheStorage<TItem> implements PromptbookStorage<TItem>
      */
     removeItem(key: string): Promise<void>;
 }
-/**
- * TODO: [🌗] Maybe some checkers, not all valid JSONs are desired and valid values
- * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
- */

package/esm/src/storage/file-cache-storage/FileCacheStorageOptions.d.ts

@@ -1,4 +1,4 @@
-import type { string_dirname } from '../../types/typeAliases';
+import type { string_dirname } from '../../types/string_filename';
 /**
  * Configuration options for the FileCacheStorage implementation.
  * Defines how and where file cache data should be stored and managed.

package/esm/src/storage/file-cache-storage/utils/nameToSubfolderPath.d.ts

@@ -1,4 +1,4 @@
-import type { string_name } from '../../../types/typeAliases';
+import type { string_name } from '../../../types/string_name';
 /**
  * Converts a name to a properly formatted subfolder path for cache storage.
  * Handles normalization and path formatting to create consistent cache directory structures.

package/esm/src/storage/local-storage/getIndexedDbStorage.d.ts

@@ -6,6 +6,3 @@ import type { IndexedDbStorageOptions } from './utils/IndexedDbStorageOptions';
  * @public exported from `@promptbook/browser`
  */
 export declare function getIndexedDbStorage<TItem>(options: IndexedDbStorageOptions): PromptbookStorage<TItem>;
-/**
- * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
- */

package/esm/src/storage/local-storage/getLocalStorage.d.ts

@@ -5,6 +5,3 @@ import type { PromptbookStorage } from '../_common/PromptbookStorage';
  * @public exported from `@promptbook/browser`
  */
 export declare function getLocalStorage<TItem>(): PromptbookStorage<TItem>;
-/**
- * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
- */

package/esm/src/storage/local-storage/getSessionStorage.d.ts

@@ -5,6 +5,3 @@ import type { PromptbookStorage } from '../_common/PromptbookStorage';
  * @public exported from `@promptbook/browser`
  */
 export declare function getSessionStorage<TItem>(): PromptbookStorage<TItem>;
-/**
- * Note: [🔵] Code in this file should never be published outside of `@promptbook/browser`
- */

package/esm/src/storage/local-storage/utils/IndexedDbStorageOptions.d.ts

@@ -1,4 +1,4 @@
-import type { string_name } from '../../../types/typeAliases';
+import type { string_name } from '../../../types/string_name';
 /**
  * Options for IndexedDB storage
  */

package/esm/src/storage/local-storage/utils/makePromptbookStorageFromIndexedDb.d.ts

@@ -3,6 +3,7 @@ import type { IndexedDbStorageOptions } from './IndexedDbStorageOptions';
 /**
  * Creates a PromptbookStorage backed by IndexedDB.
  * Uses a single object store named 'promptbook'.
+ *
  * @private for `getIndexedDbStorage`
  */
 export declare function makePromptbookStorageFromIndexedDb<TValue>(options: IndexedDbStorageOptions): PromptbookStorage<TValue>;

package/esm/src/storage/local-storage/utils/makePromptbookStorageFromWebStorage.d.ts

@@ -6,7 +6,3 @@ import type { PromptbookStorage } from '../../_common/PromptbookStorage';
  * @private for `getLocalStorage` and `getSessionStorage`
  */
 export declare function makePromptbookStorageFromWebStorage<TValue>(webStorage: Storage): PromptbookStorage<TValue>;
-/**
- * TODO: [🧠] Should this be named `makePromptbookStorageFromWebStorage` vs `createPromptbookStorageFromWebStorage`
- * TODO: [🌗] Maybe some checkers, not all valid JSONs are desired and valid values
- */

package/esm/src/transpilers/_common/BookTranspiler.d.ts

@@ -1,7 +1,9 @@
-import { Promisable } from 'type-fest';
+import type { Promisable } from 'type-fest';
 import type { string_book } from '../../book-2.0/agent-source/string_book';
 import type { ExecutionTools } from '../../execution/ExecutionTools';
-import type { string_name, string_script, string_title } from '../../types/typeAliases';
+import type { string_script } from '../../types/string_markdown';
+import type { string_name } from '../../types/string_name';
+import type { string_title } from '../../types/string_title';
 import type { Registered } from '../../utils/misc/$Register';
 import type { BookTranspilerOptions } from './BookTranspilerOptions';
 /**

package/esm/src/transpilers/_common/BookTranspilerOptions.d.ts

@@ -1,4 +1,8 @@
+import type { AgentReferenceResolver } from '../../book-2.0/agent-source/AgentReferenceResolver';
+import type { TeammateProfileResolver } from '../../book-2.0/agent-source/TeammateProfileResolver';
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+import type { InlineKnowledgeSourceUploader } from '../../utils/knowledge/inlineKnowledgeSource';
+import type { TranspiledTeamExport } from './TranspiledTeamExport';
 /**
  * Options for the BookTranspiler.
  */
@@ -15,4 +19,20 @@ export type BookTranspilerOptions = Omit<CommonToolsOptions, 'maxRequestsPerMinu
      * @default true
      */
     readonly shouldIncludeComments?: boolean;
+    /**
+     * Resolver that transforms compact agent references into concrete URLs before transpilation.
+     */
+    readonly agentReferenceResolver?: AgentReferenceResolver;
+    /**
+     * Optional hook used to upload inline knowledge files before finalizing transpiled model requirements.
+     */
+    readonly inlineKnowledgeSourceUploader?: InlineKnowledgeSourceUploader;
+    /**
+     * Optional resolver that provides actual agent names and descriptions for teammate URLs.
+     */
+    readonly teammateProfileResolver?: TeammateProfileResolver;
+    /**
+     * Built-in TEAM hierarchy resolved by Agents Server for self-contained transpiled exports.
+     */
+    readonly transpiledTeam?: TranspiledTeamExport;
 };

package/esm/src/transpilers/_common/TranspiledTeamExport.d.ts

@@ -0,0 +1,80 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { PseudoAgentKind } from '../../book-2.0/agent-source/pseudoAgentReferences';
+import type { LlmToolDefinition } from '../../types/LlmToolDefinition';
+/**
+ * Model-requirement fields embedded for one built-in teammate in transpiled code.
+ */
+export type TranspiledTeamAgentModelRequirements = Pick<AgentModelRequirements, 'systemMessage' | 'promptSuffix' | 'modelName' | 'temperature' | 'topP' | 'topK' | 'knowledgeSources' | 'samples'> & {
+    /**
+     * Tool definitions visible to this built-in teammate.
+     */
+    readonly tools: ReadonlyArray<LlmToolDefinition>;
+};
+/**
+ * One TEAM edge embedded into transpiled code.
+ */
+export type TranspiledTeamTeammate = {
+    /**
+     * Canonical teammate URL.
+     */
+    readonly url: string;
+    /**
+     * Human-readable teammate label.
+     */
+    readonly label: string;
+    /**
+     * Tool name used by the owning agent to consult this teammate.
+     */
+    readonly toolName: string;
+    /**
+     * Optional instructions from the TEAM commitment.
+     */
+    readonly instructions?: string;
+    /**
+     * Pseudo-agent kind for `{User}` and `{Void}` teammates.
+     */
+    readonly pseudoAgentKind?: PseudoAgentKind;
+};
+/**
+ * One agent node embedded into a transpiled TEAM hierarchy.
+ */
+export type TranspiledTeamAgent = {
+    /**
+     * Canonical URL used as the stable team-member identifier.
+     */
+    readonly url: string;
+    /**
+     * Human-readable agent name.
+     */
+    readonly agentName: string;
+    /**
+     * Resolved Book source for this agent.
+     */
+    readonly agentSource: string_book;
+    /**
+     * Compiled model requirements used by the exported harness.
+     */
+    readonly modelRequirements: TranspiledTeamAgentModelRequirements;
+    /**
+     * Teammates directly available to this agent.
+     */
+    readonly teammates: ReadonlyArray<TranspiledTeamTeammate>;
+    /**
+     * Marks the root exported agent in the hierarchy.
+     */
+    readonly isRootAgent?: boolean;
+};
+/**
+ * Full built-in TEAM hierarchy embedded into transpiled code.
+ */
+export type TranspiledTeamExport = {
+    /**
+     * Canonical URL of the root exported agent.
+     */
+    readonly rootAgentUrl: string;
+    /**
+     * Root agent and all reachable teammates.
+     */
+    readonly agents: ReadonlyArray<TranspiledTeamAgent>;
+};