@promptbook/core 0.112.0-41 → 0.112.0-43

package/esm/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -745,7 +745,7 @@ export type ChatProps = {
      * - `BUBBLE_MODE`: keeps the default bubble appearance for all messages.
      * - `ARTICLE_MODE`: keeps user bubbles while rendering assistant replies as borderless article blocks.
      *
-     * @default 'BUBBLE_MODE'
+     * @default 'ARTICLE_MODE'
      */
     readonly CHAT_VISUAL_MODE?: ChatVisualMode;
     /**

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

@@ -0,0 +1,19 @@
+/**
+ * Possible runtime shapes returned when importing the `typescript` package.
+ */
+type ImportedTypescriptModule = typeof import('typescript') | {
+    default: typeof import('typescript');
+};
+/**
+ * Loads the TypeScript runtime used for parsing JSONC-style project files.
+ *
+ * @private internal utility of `coder init`
+ */
+export declare function getTypescriptModule(): Promise<typeof import('typescript')>;
+/**
+ * Normalizes CommonJS-via-`default` and direct namespace imports of TypeScript.
+ *
+ * @private internal utility of `getTypescriptModule`
+ */
+export declare function normalizeImportedTypescriptModule(importedTypescriptModule: ImportedTypescriptModule): typeof import('typescript');
+export {};

package/esm/src/cli/cli-commands/coder/getTypescriptModule.test.d.ts

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

package/esm/src/cli/cli-commands/coder/mergeStringRecordJsonFile.test.d.ts

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

package/esm/src/cli/cli-commands/coder/verify.test.d.ts

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

package/esm/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentCollectionInSupabase.d.ts

@@ -4,23 +4,11 @@ import type { string_book } from '../../../../book-2.0/agent-source/string_book'
 import type { string_agent_name, string_agent_permanent_id } from '../../../../types/typeAliases';
 import { AgentCollectionInSupabaseOptions } from './AgentCollectionInSupabaseOptions';
 import type { AgentsDatabaseSchema } from './AgentsDatabaseSchema';
+import { type CreateAgentPersistenceRecordsOptions } from './createAgentPersistenceRecords';
 /**
  * Options for creating a new agent entry.
  */
-type CreateAgentOptions = {
-    /**
-     * Visibility for the new agent.
-     */
-    readonly visibility?: 'PRIVATE' | 'UNLISTED' | 'PUBLIC';
-    /**
-     * Folder identifier to assign the new agent to.
-     */
-    readonly folderId?: number | null;
-    /**
-     * Sort order for the agent within its parent folder.
-     */
-    readonly sortOrder?: number;
-};
+type CreateAgentOptions = CreateAgentPersistenceRecordsOptions;
 /**
  * Optional controls for persisting one source update.
  */

package/esm/src/collection/agent-collection/constructors/agent-collection-in-supabase/createAgentPersistenceRecords.d.ts

@@ -0,0 +1,40 @@
+import type { AgentBasicInformation } from '../../../../book-2.0/agent-source/AgentBasicInformation';
+import type { string_book } from '../../../../book-2.0/agent-source/string_book';
+import type { CreateAgentInput } from '../../CreateAgentInput';
+import type { AgentsDatabaseSchema } from './AgentsDatabaseSchema';
+/**
+ * Optional persistence overrides for one new agent row.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export type CreateAgentPersistenceRecordsOptions = Omit<CreateAgentInput, 'source'>;
+/**
+ * Prepared insert rows and returned profile for one newly persisted agent.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export type CreateAgentPersistenceRecordsResult = {
+    /**
+     * Parsed created agent profile including the resolved permanent id.
+     */
+    readonly createdAgent: AgentBasicInformation & Required<Pick<AgentBasicInformation, 'permanentId'>>;
+    /**
+     * Insert row for the `Agent` table.
+     */
+    readonly agentInsertRecord: AgentsDatabaseSchema['public']['Tables']['Agent']['Insert'];
+    /**
+     * Insert row for the `AgentHistory` table.
+     */
+    readonly agentHistoryInsertRecord: AgentsDatabaseSchema['public']['Tables']['AgentHistory']['Insert'];
+};
+/**
+ * Builds normalized insert rows for a newly created persisted agent.
+ *
+ * @param agentSource - Source content of the agent.
+ * @param options - Optional folder placement, ordering, and visibility overrides.
+ * @param createdAt - Shared creation timestamp used across all persisted rows.
+ * @returns Insert rows and the created agent profile.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export declare function createAgentPersistenceRecords(agentSource: string_book, options?: CreateAgentPersistenceRecordsOptions, createdAt?: string): CreateAgentPersistenceRecordsResult;

package/esm/src/collection/agent-collection/constructors/agent-collection-in-supabase/createAgentPersistenceRecords.test.d.ts

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

package/esm/src/llm-providers/agent/Agent.test.d.ts

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

package/esm/src/llm-providers/agent/AgentLlmExecutionTools.d.ts

@@ -44,6 +44,10 @@ export declare class AgentLlmExecutionTools implements LlmExecutionTools {
      * Cached parsed agent information
      */
     private _cachedAgentInfo;
+    /**
+     * Optional server-precomputed model requirements reused until the source changes.
+     */
+    private precomputedModelRequirements;
     /**
      * Creates new AgentLlmExecutionTools
      *

package/esm/src/llm-providers/agent/AgentOptions.d.ts

@@ -1,4 +1,5 @@
 import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
 import type { ExecutionTools } from '../../execution/ExecutionTools';
 import type { Updatable } from '../../types/Updatable';
@@ -27,6 +28,13 @@ export type AgentOptions = CommonToolsOptions & {
      * The source of the agent
      */
     agentSource: Updatable<string_book>;
+    /**
+     * Optional precomputed model requirements reused until `agentSource` changes.
+     *
+     * This keeps the actual runtime prompt aligned with server-prepared requirements
+     * such as compact-reference-resolved `TEAM` tools.
+     */
+    precomputedModelRequirements?: AgentModelRequirements;
     /**
      * Teacher agent for self-learning
      *

package/esm/src/llm-providers/agent/CreateAgentLlmExecutionToolsOptions.d.ts

@@ -1,4 +1,5 @@
 import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { OpenAiAgentKitExecutionTools } from '../openai/OpenAiAgentKitExecutionTools';
@@ -25,4 +26,12 @@ export type CreateAgentLlmExecutionToolsOptions = CommonToolsOptions & {
      * The agent source string that defines the agent's behavior
      */
     agentSource: string_book;
+    /**
+     * Optional precomputed model requirements reused until `agentSource` changes.
+     *
+     * This is useful for runtimes such as Agents Server that already resolved compact
+     * references (for example in `TEAM`) and need the executed prompt to stay aligned
+     * with the server-prepared tool list.
+     */
+    precomputedModelRequirements?: AgentModelRequirements;
 };

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.112.0-40`).
+ * It follows semantic versioning (e.g., `0.112.0-42`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/core",
-    "version": "0.112.0-41",
+    "version": "0.112.0-43",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -27,7 +27,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-41';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-43';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -7867,7 +7867,7 @@
             systemMessage: '',
             promptSuffix: '',
             // modelName: 'gpt-5',
-            modelName: 'gemini-2.5-flash-lite',
+            modelName: 'gpt-5.4-mini',
             temperature: 0.7,
             topP: 0.9,
             topK: 50,
@@ -15055,6 +15055,15 @@
      * Map of team tool titles.
      */
     const teamToolTitles = {};
+    /**
+     * Shared TEAM usage rules appended ahead of teammate listings.
+     *
+     * @private
+     */
+    const TEAM_SYSTEM_MESSAGE_GUIDANCE_LINES = [
+        '- If a teammate is relevant to the request, consult that teammate using the matching tool.',
+        '- Do not ask the user for information that a listed teammate can provide directly.',
+    ];
     /**
      * Constant for remote agents by Url.
      */
@@ -15144,12 +15153,9 @@
                 if (updatedTools.some((tool) => tool.name === entry.toolName)) {
                     continue;
                 }
-                const toolDescription = entry.description
-                    ? `Consult teammate ${entry.teammate.label}\n${entry.description}`
-                    : `Consult teammate ${entry.teammate.label}`;
                 updatedTools.push({
                     name: entry.toolName,
-                    description: toolDescription,
+                    description: buildTeamToolDescription(entry),
                     parameters: {
                         type: 'object',
                         properties: {
@@ -15218,22 +15224,72 @@
     /**
      * Builds the textual TEAM section body for the final system message.
      *
-     * Each teammate is listed with its tool name and, when available, a one-line description.
-     * Uses `spaceTrim` to ensure consistent whitespace and indentation.
+     * Each teammate is listed with its tool name, TEAM instructions, and optional profile hints.
      */
     function buildTeamSystemMessageBody(teamEntries) {
-        const lines = teamEntries.map((entry, index) => {
-            const toolLine = `${index + 1}) ${entry.teammate.label} tool \`${entry.toolName}\``;
-            if (!entry.description) {
-                return toolLine;
-            }
-            return spacetrim.spaceTrim(`
-            ${toolLine}
-               ${entry.description}
-        `);
-        });
+        const lines = [
+            ...TEAM_SYSTEM_MESSAGE_GUIDANCE_LINES,
+            '',
+            ...teamEntries.map((entry, index) => {
+                const toolLine = `${index + 1}) ${entry.teammate.label} tool \`${entry.toolName}\``;
+                const detailLines = collectTeamEntryDetails(entry).map(formatTeamEntryDetailLine);
+                return [toolLine, ...detailLines].join('\n');
+            }),
+        ];
         return lines.join('\n');
     }
+    /**
+     * Builds the model-visible description for one teammate tool.
+     *
+     * @private
+     */
+    function buildTeamToolDescription(entry) {
+        const detailLines = collectTeamEntryDetails(entry).map(({ label, content }) => `${label}: ${content}`);
+        return [`Consult teammate ${entry.teammate.label}`, ...detailLines].join('\n');
+    }
+    /**
+     * Collects structured teammate details that should stay visible to the model.
+     *
+     * @private
+     */
+    function collectTeamEntryDetails(entry) {
+        var _a;
+        const details = [];
+        const instructions = entry.teammate.instructions.trim();
+        const description = ((_a = entry.description) === null || _a === void 0 ? void 0 : _a.trim()) || '';
+        if (instructions) {
+            details.push({
+                label: 'TEAM instructions',
+                content: instructions,
+            });
+        }
+        if (description) {
+            details.push({
+                label: 'Profile',
+                content: description,
+            });
+        }
+        return details;
+    }
+    /**
+     * Formats one teammate detail line for the TEAM system-message section.
+     *
+     * @private
+     */
+    function formatTeamEntryDetailLine(detail) {
+        return indentMultilineText(`${detail.label}: ${detail.content}`, '   ');
+    }
+    /**
+     * Indents all lines of one potentially multi-line text block.
+     *
+     * @private
+     */
+    function indentMultilineText(text, prefix) {
+        return text
+            .split('\n')
+            .map((line) => `${prefix}${line}`)
+            .join('\n');
+    }
     /**
      * Registers tool function and title for a teammate tool.
      */
@@ -23456,6 +23512,60 @@
         return strippedLines.join('\n');
     }
 
+    /**
+     * Builds normalized insert rows for a newly created persisted agent.
+     *
+     * @param agentSource - Source content of the agent.
+     * @param options - Optional folder placement, ordering, and visibility overrides.
+     * @param createdAt - Shared creation timestamp used across all persisted rows.
+     * @returns Insert rows and the created agent profile.
+     *
+     * @private shared persistence helper for `AgentCollectionInSupabase`
+     */
+    function createAgentPersistenceRecords(agentSource, options = {}, createdAt = new Date().toISOString()) {
+        const preparedAgentSource = prepareAgentSourceForPersistence(agentSource);
+        const { agentProfile, agentSource: normalizedAgentSource } = preparedAgentSource;
+        const permanentId = preparedAgentSource.permanentId || $randomBase58(14);
+        const { agentName, agentHash } = agentProfile;
+        const agentInsertRecord = {
+            agentName,
+            agentHash,
+            permanentId,
+            agentProfile,
+            createdAt,
+            updatedAt: null,
+            promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
+            usage: ZERO_USAGE,
+            agentSource: normalizedAgentSource,
+        };
+        if (options.folderId !== undefined) {
+            agentInsertRecord.folderId = options.folderId;
+        }
+        if (options.sortOrder !== undefined) {
+            agentInsertRecord.sortOrder = options.sortOrder;
+        }
+        if (options.visibility !== undefined) {
+            agentInsertRecord.visibility = options.visibility;
+        }
+        return {
+            createdAgent: {
+                ...agentProfile,
+                permanentId,
+            },
+            agentInsertRecord,
+            agentHistoryInsertRecord: {
+                createdAt,
+                agentName,
+                permanentId,
+                agentHash,
+                previousAgentHash: null,
+                agentSource: normalizedAgentSource,
+                promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
+                versionName: null,
+            },
+        };
+    }
+
     /**
      * Normalizes optional history version name before persistence.
      *
@@ -23579,52 +23689,18 @@
          * @param options - Optional folder placement and ordering data.
          */
         async createAgent(agentSource, options = {}) {
-            const preparedAgentSource = prepareAgentSourceForPersistence(agentSource);
-            const { agentProfile, agentSource: normalizedAgentSource } = preparedAgentSource;
-            let { permanentId } = preparedAgentSource;
-            const { agentName, agentHash } = agentProfile;
-            if (!permanentId) {
-                permanentId = $randomBase58(14);
-            }
-            const insertPayload = {
-                agentName,
-                agentHash,
-                permanentId,
-                agentProfile,
-                createdAt: new Date().toISOString(),
-                updatedAt: null,
-                promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
-                usage: ZERO_USAGE,
-                agentSource: normalizedAgentSource,
-            };
-            if (options.folderId !== undefined) {
-                insertPayload.folderId = options.folderId;
-            }
-            if (options.sortOrder !== undefined) {
-                insertPayload.sortOrder = options.sortOrder;
-            }
-            if (options.visibility !== undefined) {
-                insertPayload.visibility = options.visibility;
-            }
-            const insertAgentResult = await this.supabaseClient.from(this.getTableName('Agent')).insert(insertPayload);
+            const createdAt = new Date().toISOString();
+            const { createdAgent, agentInsertRecord, agentHistoryInsertRecord } = createAgentPersistenceRecords(agentSource, options, createdAt);
+            const insertAgentResult = await this.supabaseClient.from(this.getTableName('Agent')).insert(agentInsertRecord);
             if (insertAgentResult.error) {
                 throw new DatabaseError(spaceTrim((block) => `
-                        Error creating agent "${agentProfile.agentName}" in Supabase:
+                        Error creating agent "${createdAgent.agentName}" in Supabase:
                         
                         ${block(insertAgentResult.error.message)}
                     `));
             }
-            await this.insertAgentHistoryRow({
-                createdAt: new Date().toISOString(),
-                agentName,
-                permanentId,
-                agentHash,
-                previousAgentHash: null,
-                agentSource: normalizedAgentSource,
-                promptbookEngineVersion: PROMPTBOOK_ENGINE_VERSION,
-                versionName: null,
-            });
-            return { ...agentProfile, permanentId };
+            await this.insertAgentHistoryRow(agentHistoryInsertRecord);
+            return createdAgent;
         }
         /**
          * Updates an existing agent in the collection
@@ -32680,7 +32756,7 @@
     /**
      * Constant for default agent kit model name.
      */
-    const DEFAULT_AGENT_KIT_MODEL_NAME = 'gpt-5.4-nano';
+    const DEFAULT_AGENT_KIT_MODEL_NAME = 'gpt-5.4-mini';
     /**
      * Creates one structured log entry for streamed tool-call updates.
      *
@@ -34746,6 +34822,7 @@
          * @param agentSource The agent source string that defines the agent's behavior
          */
         constructor(options) {
+            var _a;
             this.options = options;
             /**
              * Cached model requirements to avoid re-parsing the agent source
@@ -34755,6 +34832,7 @@
              * Cached parsed agent information
              */
             this._cachedAgentInfo = null;
+            this.precomputedModelRequirements = (_a = options.precomputedModelRequirements) !== null && _a !== void 0 ? _a : null;
         }
         /**
          * Updates the agent source and clears the cache
@@ -34762,9 +34840,13 @@
          * @param agentSource The new agent source string
          */
         updateAgentSource(agentSource) {
+            if (this.options.agentSource === agentSource) {
+                return;
+            }
             this.options.agentSource = agentSource;
             this._cachedAgentInfo = null;
             this._cachedModelRequirements = null;
+            this.precomputedModelRequirements = null;
         }
         /**
          * Get cached or parse agent information
@@ -34781,6 +34863,16 @@
          * Note: [🐤] This is names `getModelRequirements` *(not `getAgentModelRequirements`)* because in future these two will be united
          */
         async getModelRequirements() {
+            var _a, _b;
+            if (this.precomputedModelRequirements !== null) {
+                if (this.options.isVerbose) {
+                    console.info('[🤰]', 'Using precomputed agent model requirements', {
+                        agent: this.title,
+                        toolCount: (_b = (_a = this.precomputedModelRequirements.tools) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0,
+                    });
+                }
+                return this.precomputedModelRequirements;
+            }
             if (this._cachedModelRequirements === null) {
                 const preparationStartedAtMs = Date.now();
                 if (this.options.isVerbose) {
@@ -34890,6 +34982,7 @@
          * Resolves agent requirements, attachments, and runtime overrides into one forwarded chat prompt.
          */
         async prepareChatPrompt(prompt) {
+            var _a;
             const chatPrompt = this.requireChatPrompt(prompt);
             const { sanitizedRequirements, promptSuffix } = await this.getSanitizedAgentModelRequirements();
             const attachments = normalizeChatAttachments(chatPrompt.attachments);
@@ -34907,7 +35000,16 @@
                 mergedTools,
                 knowledgeSourcesForAgent,
             });
-            console.log('!!!! promptWithAgentModelRequirements:', forwardedPrompt);
+            if (this.options.isVerbose) {
+                console.info('[🤰]', 'Prepared agent chat prompt', {
+                    agent: this.title,
+                    usedPrecomputedModelRequirements: this.precomputedModelRequirements !== null,
+                    toolNames: mergedTools.map((tool) => tool.name),
+                    knowledgeSourcesCount: (_a = knowledgeSourcesForAgent === null || knowledgeSourcesForAgent === void 0 ? void 0 : knowledgeSourcesForAgent.length) !== null && _a !== void 0 ? _a : 0,
+                    promptSuffixLength: promptSuffix.length,
+                    systemMessageLength: sanitizedRequirements.systemMessage.length,
+                });
+            }
             return {
                 forwardedPrompt,
                 sanitizedRequirements,
@@ -35094,6 +35196,7 @@
          * Runs one prepared prompt through the deprecated OpenAI Assistant backend.
          */
         async callOpenAiAssistantChatModelStream(options) {
+            var _a, _b, _c, _d;
             const assistant = await this.getOrPrepareOpenAiAssistant({
                 llmTools: options.llmTools,
                 originalPrompt: options.originalPrompt,
@@ -35101,7 +35204,14 @@
                 onProgress: options.onProgress,
             });
             const promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools = createOpenAiAssistantPrompt(options.preparedChatPrompt.forwardedPrompt);
-            console.log('!!!! promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools:', promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools);
+            if (this.options.isVerbose) {
+                console.info('[🤰]', 'Prepared OpenAI Assistant prompt', {
+                    agent: this.title,
+                    toolNames: (_b = (_a = promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools.modelRequirements.tools) === null || _a === void 0 ? void 0 : _a.map((tool) => tool.name)) !== null && _b !== void 0 ? _b : [],
+                    knowledgeSourcesCount: (_d = (_c = promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools.modelRequirements
+                        .knowledgeSources) === null || _c === void 0 ? void 0 : _c.length) !== null && _d !== void 0 ? _d : 0,
+                });
+            }
             return assistant.callChatModelStream(promptWithAgentModelRequirementsForOpenAiAssistantExecutionTools, options.onProgress, options.streamOptions);
         }
         /**
@@ -35792,7 +35902,8 @@
                 isVerbose: options.isVerbose,
                 llmTools: getSingleLlmExecutionTools(options.executionTools.llm),
                 assistantPreparationMode: options.assistantPreparationMode,
-                agentSource: agentSource.value, // <- TODO: [🐱‍🚀] Allow to pass BehaviorSubject<string_book> OR refresh llmExecutionTools.callChat on agentSource change
+                agentSource: agentSource.value,
+                precomputedModelRequirements: options.precomputedModelRequirements,
             });
             this._agentName = undefined;
             /**
@@ -38410,6 +38521,7 @@
                 
                 PERSONA ${block(personaDescription)}
                 ${block(initialRules.map((rule) => `RULE ${rule}`).join('\n'))}
+                CLOSED
             `));
         // Note: `META COLOR ${color || PROMPTBOOK_COLOR.toHex()}` was removed for now
         // Note: `META FONT Playfair Display, sans-serif` was removed for now