@promptbook/node 0.110.0-8 → 0.110.0

package/esm/typings/src/book-components/icons/ArrowIcon.d.ts

@@ -1,9 +1,22 @@
+/**
+ * Supported arrow directions.
+ *
+ * @private internal typing helper for `<ArrowIcon/>`
+ */
+type ArrowDirection = 'DOWN' | 'UP';
+/**
+ * Props for rendering a directional arrow icon.
+ *
+ * @private internal props typing for `<ArrowIcon/>`
+ */
+type ArrowIconProps = {
+    direction: ArrowDirection;
+    size: number;
+};
 /**
  * Shows simple arrow icon pointing up or down
  *
  * @public exported from `@promptbook/components`
  */
-export declare const ArrowIcon: ({ direction, size }: {
-    direction: string;
-    size: number;
-}) => import("react/jsx-runtime").JSX.Element;
+export declare const ArrowIcon: ({ direction, size }: ArrowIconProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/esm/typings/src/commitments/_base/BaseCommitmentDefinition.d.ts

@@ -57,6 +57,15 @@ export declare abstract class BaseCommitmentDefinition<TBookCommitment extends s
      * Helper method to append content to the system message
      */
     protected appendToSystemMessage(requirements: AgentModelRequirements, content: string, separator?: string): AgentModelRequirements;
+    /**
+     * Helper method to create a new requirements object with updated prompt suffix
+     */
+    protected updatePromptSuffix(requirements: AgentModelRequirements, contentUpdate: string | ((currentSuffix: string) => string)): AgentModelRequirements;
+    /**
+     * Helper method to append content to the prompt suffix
+     * Default separator is a single newline for bullet lists.
+     */
+    protected appendToPromptSuffix(requirements: AgentModelRequirements, content: string, separator?: string): AgentModelRequirements;
     /**
      * Helper method to add a comment section to the system message
      * Comments are lines starting with # that will be removed from the final system message

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

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

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

@@ -1,4 +1,6 @@
 import { Agent as AgentFromKit } from '@openai/agents';
+import OpenAI from 'openai';
+import { TODO_any } from '../../_packages/types.index';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { ModelRequirements } from '../../types/ModelRequirements';
@@ -6,6 +8,42 @@ import type { Prompt } from '../../types/Prompt';
 import type { string_markdown, string_markdown_text, string_title } from '../../types/typeAliases';
 import type { OpenAiAgentKitExecutionToolsOptions } from './OpenAiAgentKitExecutionToolsOptions';
 import { OpenAiVectorStoreHandler } from './OpenAiVectorStoreHandler';
+/**
+ * Represents the AgentKit output configuration used to match OpenAI `response_format` expectations.
+ *
+ * @private utility of Open AI
+ */
+export type AgentOutputType = 'text' | JsonSchemaDefinition;
+type JsonSchemaDefinitionEntry = {
+    type?: string;
+    description?: string;
+    properties?: Record<string, JsonSchemaDefinitionEntry>;
+    required?: Array<string>;
+    items?: JsonSchemaDefinitionEntry;
+    [key: string]: TODO_any;
+};
+type JsonSchemaDefinition = {
+    type: 'json_schema';
+    name: string;
+    strict: boolean;
+    schema: {
+        type: 'object';
+        properties: Record<string, JsonSchemaDefinitionEntry>;
+        required: Array<string>;
+        additionalProperties: boolean;
+        description?: string;
+    };
+};
+type OpenAiChatResponseFormat = OpenAI.Chat.Completions.ChatCompletionCreateParamsNonStreaming['response_format'];
+/**
+ * Maps OpenAI `response_format` payloads to AgentKit output types so the runner can forward
+ * structured-output preferences to OpenAI while still reusing the same AgentKit agent instance.
+ *
+ * @param responseFormat - The OpenAI `response_format` payload from the user request.
+ * @returns An Agent output type compatible with the requested schema or `undefined` when no impact is required.
+ * @private utility of Open AI
+ */
+export declare function mapResponseFormatToAgentOutputType(responseFormat?: OpenAiChatResponseFormat): AgentOutputType | undefined;
 /**
  * Alias for OpenAI AgentKit agent to avoid naming confusion with Promptbook agents.
  */
@@ -82,6 +120,7 @@ export declare class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandl
         readonly prompt: Prompt;
         readonly rawPromptContent?: string;
         readonly onProgress: (chunk: ChatPromptResult) => void;
+        readonly responseFormatOutputType?: AgentOutputType;
     }): Promise<ChatPromptResult>;
     /**
      * Builds AgentKit input items from the prompt and optional thread.

package/esm/typings/src/types/LlmToolDefinition.d.ts

@@ -23,5 +23,6 @@ export type LlmToolDefinition = {
             description?: string;
         }>;
         readonly required?: string[];
+        readonly additionalProperties?: boolean;
     };
 };

package/esm/typings/src/types/ModelRequirements.d.ts

@@ -1,6 +1,7 @@
 import type { LlmToolDefinition } from './LlmToolDefinition';
 import type { ModelVariant } from './ModelVariant';
 import type { number_model_temperature, number_seed, string_model_name, string_system_message } from './typeAliases';
+import type OpenAI from 'openai';
 /**
  * Abstract way to specify the LLM.
  * It does not specify the LLM with concrete version itself, only the requirements for the LLM.
@@ -54,6 +55,14 @@ export type ChatModelRequirements = CommonModelRequirements & {
      * Maximum number of tokens that can be generated by the model
      */
     readonly maxTokens?: number;
+    /**
+     * Optional OpenAI `response_format` override that should be forwarded to compatible APIs.
+     */
+    readonly responseFormat?: OpenAI.Chat.Completions.ChatCompletionCreateParamsNonStreaming['response_format'];
+    /**
+     * Optional OpenAI `tool_choice` override that should be forwarded to compatible APIs.
+     */
+    readonly toolChoice?: OpenAI.Chat.Completions.ChatCompletionToolChoiceOption;
 };
 /**
  * Model requirements for the image generation variant

package/esm/typings/src/utils/DEFAULT_THINKING_MESSAGES.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Default placeholder variants shown when an agent is still composing a response.
+ *
+ * @private BUT maybe export via some package
+ */
+export declare const DEFAULT_THINKING_MESSAGES: readonly ["Thinking...", "Searching for information...", "Sorting information..."];
+/** @internal */
+export type ThinkingMessageVariant = (typeof DEFAULT_THINKING_MESSAGES)[number];

package/esm/typings/src/utils/knowledge/inlineKnowledgeSource.d.ts

@@ -0,0 +1,38 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import type { string_data_url, string_filename } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @private thing of inline knowledge
+ */
+export type InlineKnowledgeSourceFile = {
+    readonly filename: string_filename;
+    readonly mimeType: string;
+    readonly url: string_data_url;
+};
+/**
+ * Creates a data URL that represents the inline knowledge content as a text file.
+ *
+ * @private thing of inline knowledge
+ */
+export declare function createInlineKnowledgeSourceFile(content: string): InlineKnowledgeSourceFile;
+/**
+ * Checks whether the provided source string is a data URL that can be decoded.
+ *
+ * @private thing of inline knowledge
+ */
+export declare function isDataUrlKnowledgeSource(source: string): source is string_data_url;
+/**
+ * Parses a data URL-based knowledge source into its raw buffer, filename, and MIME type.
+ *
+ * @private thing of inline knowledge
+ */
+export declare function parseDataUrlKnowledgeSource(source: string): {
+    readonly buffer: Buffer;
+    readonly filename: string_filename;
+    readonly mimeType: string;
+} | null;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/utils/knowledge/inlineKnowledgeSource.test.d.ts

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

package/esm/typings/src/utils/language/getBrowserPreferredSpeechRecognitionLanguage.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @@@
+ *
+ * @private function of Agents Server speech recognition language resolution, not a general-purpose utility
+ */
+type ResolveSpeechRecognitionLanguageOptions = {
+    /**
+     * Overrides the default language resolution when provided.
+     */
+    readonly overrideLanguage?: string | null;
+    /**
+     * Optional Accept-Language header string to derive the speaker language from server-side requests.
+     */
+    readonly acceptLanguageHeader?: string | null;
+};
+/**
+ * Parses the primary language out of an Accept-Language header value.
+ *
+ * @private function of Agents Server speech recognition language resolution, not a general-purpose utility
+ */
+export declare function parseSpeechRecognitionLanguageFromAcceptLanguageHeader(header?: string | null): string | undefined;
+/**
+ * Reads the browser-reported preferred language list and returns the first valid tag.
+ *
+ * @private function of Agents Server speech recognition language resolution, not a general-purpose utility
+ */
+export declare function getBrowserPreferredSpeechRecognitionLanguage(): string | undefined;
+/**
+ * Resolves a speech recognition language tag by checking an optional override, then the Accept-Language header,
+ * then the browser preferences, and finally falling back to a default of `en-US`.
+ *
+ * @private function of Agents Server speech recognition language resolution, not a general-purpose utility
+ */
+export declare function resolveSpeechRecognitionLanguage(options?: ResolveSpeechRecognitionLanguageOptions): string;
+export {};

package/esm/typings/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.110.0-7`).
+ * It follows semantic versioning (e.g., `0.110.0-11`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/node",
-    "version": "0.110.0-8",
+    "version": "0.110.0",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -96,7 +96,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/node.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.110.0-8"
+        "@promptbook/core": "0.110.0"
     },
     "dependencies": {
         "@mozilla/readability": "0.6.0",