@promptbook/google 0.112.0-64 → 0.112.0-66

package/esm/src/book-2.0/book-language-documentation/renderGroupedCommitmentDocumentationMarkdown.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Minimal commitment shape used by documentation renderers.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+type CommitmentDocumentationSource = {
+    /**
+     * Canonical commitment keyword.
+     */
+    readonly type: string;
+    /**
+     * Full markdown documentation block, including the top-level heading.
+     */
+    readonly documentation: string;
+};
+/**
+ * Grouped commitment metadata consumed by the docs renderer.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+type GroupedCommitmentDocumentationSource = {
+    /**
+     * Primary commitment shown in the docs entry.
+     */
+    readonly primary: CommitmentDocumentationSource;
+    /**
+     * Aliases grouped under the same docs entry.
+     */
+    readonly aliases: ReadonlyArray<string>;
+};
+/**
+ * Renders the documentation body for one grouped commitment entry.
+ *
+ * `OPEN` and `CLOSED` are intentionally rendered together so the documentation
+ * surfaces present them as one conceptual switch instead of two isolated pages.
+ *
+ * @param group - Grouped commitment metadata.
+ * @returns Markdown body for the docs page/catalog entry.
+ *
+ * @private internal utility of `createStandaloneBookLanguageMarkdown`
+ */
+export declare function renderGroupedCommitmentDocumentationMarkdown(group: GroupedCommitmentDocumentationSource): string;
+export {};

package/esm/src/book-components/Chat/types/ChatMessage.d.ts

@@ -58,36 +58,6 @@ export type ChatProgressCard = {
      */
     readonly isVisible?: boolean;
 };
-/**
- * Source used by an assistant message.
- *
- * This is used for knowledge-search results and other RAG systems that can
- * attach structured source metadata independently of inline citation markers.
- *
- * @public exported from `@promptbook/components`
- */
-export type ChatMessageSource = {
-    /**
-     * The unique identifier for the source citation (e.g., "0:0")
-     */
-    readonly id: string;
-    /**
-     * The source document name (e.g., "document.pdf")
-     */
-    readonly source: string;
-    /**
-     * Optional URL to the source document
-     */
-    readonly url?: string;
-    /**
-     * Optional preview/excerpt from the source
-     */
-    readonly excerpt?: string;
-    /**
-     * Optional retrieval score.
-     */
-    readonly score?: number;
-};
 /**
  * Serialized reference to an earlier chat message quoted by a reply bubble.
  *
@@ -285,10 +255,6 @@ export type ChatMessage = Omit<Message<id>, 'direction' | 'recipients' | 'thread
          */
         excerpt?: string;
     }>;
-    /**
-     * Optional structured sources used to produce this message.
-     */
-    readonly sources?: ReadonlyArray<ChatMessageSource>;
     /**
      * Optional structured progress-card payload shown while a response is still in progress.
      */

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

@@ -1,6 +1,6 @@
 import type { InitializationStatus } from './boilerplateTemplates';
 /**
- * Ensures `.gitignore` contains the standalone Promptbook coder temp and cache entries.
+ * Ensures `.gitignore` contains the shared Promptbook working-directory entry.
  *
  * @private function of `initializeCoderProjectConfiguration`
  */

package/esm/src/commitments/KNOWLEDGE/KNOWLEDGE.d.ts

@@ -1,12 +1,5 @@
-import type { string_javascript_name } from '../../_packages/types.index';
 import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-/**
- * Name of the tool used by agents to search configured `KNOWLEDGE` sources.
- *
- * @public exported from `@promptbook/core`
- */
-export declare const KNOWLEDGE_SEARCH_TOOL_NAME: string;
 /**
  * KNOWLEDGE commitment definition
  *
@@ -44,8 +37,4 @@ export declare class KnowledgeCommitmentDefinition extends BaseCommitmentDefinit
      */
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
-    /**
-     * Gets human-readable titles for tool functions provided by this commitment.
-     */
-    getToolTitles(): Record<string_javascript_name, string>;
 }

package/esm/src/commitments/_common/toolRuntimeContext.d.ts

@@ -98,12 +98,6 @@ export type ToolRuntimeContext = {
         localServerUrl?: string;
         teamInternalAccessToken?: string;
     };
-    knowledge?: {
-        /**
-         * Final materialized knowledge sources available to the current agent.
-         */
-        sources?: string[];
-    };
     spawn?: {
         depth?: number;
         parentRunId?: string;

package/esm/src/config.d.ts

@@ -270,7 +270,7 @@ export declare const DEFAULT_AGENTS_DIRNAME = "./agents";
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_DOWNLOAD_CACHE_DIRNAME = "./.promptbook/download-cache";
+export declare const DEFAULT_DOWNLOAD_CACHE_DIRNAME: string;
 /**
  * Where to store the cache of executions for promptbook CLI
  *
@@ -278,7 +278,7 @@ export declare const DEFAULT_DOWNLOAD_CACHE_DIRNAME = "./.promptbook/download-ca
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_EXECUTION_CACHE_DIRNAME = "./.promptbook/execution-cache";
+export declare const DEFAULT_EXECUTION_CACHE_DIRNAME: string;
 /**
  * Where to store the scrape cache
  *
@@ -286,7 +286,7 @@ export declare const DEFAULT_EXECUTION_CACHE_DIRNAME = "./.promptbook/execution-
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_SCRAPE_CACHE_DIRNAME = "./.promptbook/scrape-cache";
+export declare const DEFAULT_SCRAPE_CACHE_DIRNAME: string;
 /**
  * Id of application for the CLI when using remote server
  *

package/esm/src/formfactors/index.d.ts

@@ -52,7 +52,7 @@ export declare const FORMFACTOR_DEFINITIONS: readonly [{
     };
 }, {
     readonly name: "TRANSLATOR";
-    readonly description: "A text transformation system that converts input content into different forms,\n    including language translations, paraphrasing, style conversions, and tone adjustments.\n    This form factor takes one input and produces one transformed output.";
+    readonly description: string;
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/175";
     readonly pipelineInterface: {
         readonly inputParameters: readonly [{
@@ -89,7 +89,7 @@ export declare const FORMFACTOR_DEFINITIONS: readonly [{
     };
 }, {
     readonly name: "EXPERIMENTAL_MATCHER";
-    readonly description: "An evaluation system that determines whether content meets specific criteria or patterns.\n    Used for content validation, quality assessment, and intelligent filtering tasks. Currently in experimental phase.";
+    readonly description: string;
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/177";
     readonly pipelineInterface: {
         readonly inputParameters: readonly [{

package/esm/src/formfactors/matcher/MatcherFormfactorDefinition.d.ts

@@ -7,7 +7,7 @@
  */
 export declare const MatcherFormfactorDefinition: {
     readonly name: "EXPERIMENTAL_MATCHER";
-    readonly description: "An evaluation system that determines whether content meets specific criteria or patterns.\n    Used for content validation, quality assessment, and intelligent filtering tasks. Currently in experimental phase.";
+    readonly description: string;
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/177";
     readonly pipelineInterface: {
         readonly inputParameters: readonly [{

package/esm/src/formfactors/translator/TranslatorFormfactorDefinition.d.ts

@@ -6,7 +6,7 @@
  */
 export declare const TranslatorFormfactorDefinition: {
     readonly name: "TRANSLATOR";
-    readonly description: "A text transformation system that converts input content into different forms,\n    including language translations, paraphrasing, style conversions, and tone adjustments.\n    This form factor takes one input and produces one transformed output.";
+    readonly description: string;
     readonly documentationUrl: "https://github.com/webgptorg/promptbook/discussions/175";
     readonly pipelineInterface: {
         readonly inputParameters: readonly [{

package/esm/src/llm-providers/openai/OpenAiAgentKitExecutionTools.d.ts

@@ -178,10 +178,6 @@ export declare class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandl
      * Returns AgentKit-specific options.
      */
     private get agentKitOptions();
-    /**
-     * Returns true when hosted OpenAI vector-store search should back `knowledgeSources`.
-     */
-    private get isNativeKnowledgeSearchEnabled();
     /**
      * Discriminant for type guards.
      */

package/esm/src/llm-providers/openai/OpenAiAgentKitExecutionToolsOptions.d.ts

@@ -12,13 +12,4 @@ export type OpenAiAgentKitExecutionToolsOptions = OpenAiVectorStoreHandlerOption
      * @default gpt-5.2
      */
     readonly agentKitModelName?: string_model_name;
-    /**
-     * Enables OpenAI hosted vector-store file search for `knowledgeSources`.
-     *
-     * Agents Server sets this to `false` because it uses a DB-backed LlamaIndex
-     * implementation exposed through the `knowledge_search` tool instead.
-     *
-     * @default true
-     */
-    readonly isNativeKnowledgeSearchEnabled?: boolean;
 };

package/esm/src/utils/files/getPromptbookTempPath.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Builds one project-relative path inside the shared Promptbook working directory.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function getPromptbookTempPath(...pathSegments: ReadonlyArray<string>): string;
+/**
+ * Builds one absolute filesystem path inside the shared Promptbook working directory for a project root.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function resolvePromptbookTempPath(projectPath: string, ...pathSegments: ReadonlyArray<string>): string;
+/**
+ * Builds one POSIX path fragment inside the shared Promptbook working directory for globs and generated text files.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function getPromptbookTempPosixPath(...pathSegments: ReadonlyArray<string>): string;
+/**
+ * Builds one rooted `.gitignore` rule targeting a path inside the shared Promptbook working directory.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function getPromptbookTempGitignoreRule(...pathSegments: ReadonlyArray<string>): string;

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/google",
-    "version": "0.112.0-64",
+    "version": "0.112.0-66",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,
@@ -99,7 +99,7 @@
     "types": "./esm/src/_packages/google.index.d.ts",
     "typings": "./esm/src/_packages/google.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.112.0-64"
+        "@promptbook/core": "0.112.0-66"
     },
     "dependencies": {
         "@ai-sdk/google": "1.0.17",

package/umd/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('crypto'), require('spacetrim'), require('colors')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'crypto', 'spacetrim', 'colors'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-google"] = {}, global.crypto, global.spacetrim, global.colors));
-})(this, (function (exports, crypto, spacetrim, colors) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('crypto'), require('spacetrim'), require('path'), require('colors')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'crypto', 'spacetrim', 'path', 'colors'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-google"] = {}, global.crypto, global.spacetrim, global.path, global.colors));
+})(this, (function (exports, crypto, spacetrim, path, colors) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -22,7 +22,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-64';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-66';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1511,6 +1511,29 @@
     }
     // TODO: Maybe implement by mix+hsl
 
+    /**
+     * Relative directory name without the `./` prefix for Git ignore rules and glob patterns.
+     *
+     * @private internal utility for Promptbook-owned temp files
+     */
+    const PROMPTBOOK_TEMP_DIRECTORY_NAME = '.promptbook';
+    /**
+     * Builds one project-relative path inside the shared Promptbook working directory.
+     *
+     * @private internal utility for Promptbook-owned temp files
+     */
+    function getPromptbookTempPath(...pathSegments) {
+        return `./${getPromptbookTempPosixPath(...pathSegments)}`;
+    }
+    /**
+     * Builds one POSIX path fragment inside the shared Promptbook working directory for globs and generated text files.
+     *
+     * @private internal utility for Promptbook-owned temp files
+     */
+    function getPromptbookTempPosixPath(...pathSegments) {
+        return path.posix.join(PROMPTBOOK_TEMP_DIRECTORY_NAME, ...pathSegments);
+    }
+
     /**
      * Name for the Promptbook
      *
@@ -1605,6 +1628,31 @@
      * @public exported from `@promptbook/utils`
      */
     const SMALL_NUMBER = 0.001;
+    // <- TODO: [🕝] Make also `AGENTS_DIRNAME_ALTERNATIVES`
+    /**
+     * Where to store the temporary downloads
+     *
+     * Note: When the folder does not exist, it is created recursively
+     *
+     * @public exported from `@promptbook/core`
+     */
+    getPromptbookTempPath('download-cache');
+    /**
+     * Where to store the cache of executions for promptbook CLI
+     *
+     * Note: When the folder does not exist, it is created recursively
+     *
+     * @public exported from `@promptbook/core`
+     */
+    getPromptbookTempPath('execution-cache');
+    /**
+     * Where to store the scrape cache
+     *
+     * Note: When the folder does not exist, it is created recursively
+     *
+     * @public exported from `@promptbook/core`
+     */
+    getPromptbookTempPath('scrape-cache');
     // <- TODO: [🧜‍♂️]
     /**
      * Default settings for parsing and generating CSV files in Promptbook.