@promptbook/node 0.112.0-54 → 0.112.0-57

package/esm/src/transpilers/agent-os/register.d.ts

@@ -0,0 +1,12 @@
+import type { Registration } from '../../utils/misc/$Register';
+/**
+ * Registration of transpiler.
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools.
+ *
+ * TODO: [🧠] Which package should export this?
+ *
+ * @public exported from `@promptbook/wizard`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _AgentOsTranspilerRegistration: Registration;

package/esm/src/transpilers/anthropic-claude-managed/AnthropicClaudeManagedTranspiler.d.ts

@@ -0,0 +1,16 @@
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { ExecutionTools } from '../../execution/ExecutionTools';
+import type { string_script } from '../../types/typeAliases';
+import type { BookTranspilerOptions } from '../_common/BookTranspilerOptions';
+/**
+ * Transpiler to JavaScript code using Anthropic Claude Agent SDK managed sessions.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const AnthropicClaudeManagedTranspiler: {
+    readonly name: "anthropic-claude-managed";
+    readonly title: "Anthropic Claude Managed";
+    readonly packageName: "@promptbook/core";
+    readonly className: "AnthropicClaudeManagedTranspiler";
+    readonly transpileBook: (book: string_book, tools: ExecutionTools, options?: BookTranspilerOptions) => Promise<string_script>;
+};

package/esm/src/transpilers/anthropic-claude-managed/AnthropicClaudeManagedTranspiler.test.d.ts

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

package/esm/src/transpilers/anthropic-claude-managed/register.d.ts

@@ -0,0 +1,12 @@
+import type { Registration } from '../../utils/misc/$Register';
+/**
+ * Registration of transpiler.
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools.
+ *
+ * TODO: [🧠] Which package should export this?
+ *
+ * @public exported from `@promptbook/wizard`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _AnthropicClaudeManagedTranspilerRegistration: Registration;

package/esm/src/transpilers/anthropic-claude-sdk/AnthropicClaudeSdkTranspiler.d.ts

@@ -0,0 +1,16 @@
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { ExecutionTools } from '../../execution/ExecutionTools';
+import type { string_script } from '../../types/typeAliases';
+import type { BookTranspilerOptions } from '../_common/BookTranspilerOptions';
+/**
+ * Transpiler to JavaScript code using Anthropic's Claude SDK.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const AnthropicClaudeSdkTranspiler: {
+    readonly name: "anthropic-claude-sdk";
+    readonly title: "Anthropic Claude SDK";
+    readonly packageName: "@promptbook/core";
+    readonly className: "AnthropicClaudeSdkTranspiler";
+    readonly transpileBook: (book: string_book, tools: ExecutionTools, options?: BookTranspilerOptions) => Promise<string_script>;
+};

package/esm/src/transpilers/anthropic-claude-sdk/AnthropicClaudeSdkTranspiler.test.d.ts

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

package/esm/src/transpilers/anthropic-claude-sdk/register.d.ts

@@ -0,0 +1,12 @@
+import type { Registration } from '../../utils/misc/$Register';
+/**
+ * Registration of transpiler
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools
+ *
+ * TODO: [🧠] Which package should export this?
+ *
+ * @public exported from `@promptbook/wizard`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _AnthropicClaudeSdkTranspilerRegistration: Registration;

package/esm/src/transpilers/e2b/E2BTranspiler.d.ts

@@ -0,0 +1,16 @@
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { ExecutionTools } from '../../execution/ExecutionTools';
+import type { string_script } from '../../types/typeAliases';
+import type { BookTranspilerOptions } from '../_common/BookTranspilerOptions';
+/**
+ * Transpiler to a JavaScript launcher that runs the exported agent inside an E2B sandbox.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const E2BTranspiler: {
+    readonly name: "e2b";
+    readonly title: "E2B";
+    readonly packageName: "@promptbook/core";
+    readonly className: "E2BTranspiler";
+    readonly transpileBook: (book: string_book, tools: ExecutionTools, options?: BookTranspilerOptions) => Promise<string_script>;
+};

package/esm/src/transpilers/e2b/E2BTranspiler.test.d.ts

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

package/esm/src/transpilers/e2b/register.d.ts

@@ -0,0 +1,12 @@
+import type { Registration } from '../../utils/misc/$Register';
+/**
+ * Registration of transpiler.
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools.
+ *
+ * TODO: [🧠] Which package should export this?
+ *
+ * @public exported from `@promptbook/wizard`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _E2BTranspilerRegistration: Registration;

package/esm/src/transpilers/openai-agents/OpenAiAgentsTranspiler.d.ts

@@ -0,0 +1,16 @@
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { ExecutionTools } from '../../execution/ExecutionTools';
+import type { string_script } from '../../types/typeAliases';
+import type { BookTranspilerOptions } from '../_common/BookTranspilerOptions';
+/**
+ * Transpiler to JavaScript code using the OpenAI Agents SDK.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const OpenAiAgentsTranspiler: {
+    readonly name: "openai-agents";
+    readonly title: "OpenAI Agents SDK";
+    readonly packageName: "@promptbook/core";
+    readonly className: "OpenAiAgentsTranspiler";
+    readonly transpileBook: (book: string_book, tools: ExecutionTools, options?: BookTranspilerOptions) => Promise<string_script>;
+};

package/esm/src/transpilers/openai-agents/OpenAiAgentsTranspiler.test.d.ts

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

package/esm/src/transpilers/openai-agents/register.d.ts

@@ -0,0 +1,12 @@
+import type { Registration } from '../../utils/misc/$Register';
+/**
+ * Registration of transpiler.
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools.
+ *
+ * TODO: [🧠] Which package should export this?
+ *
+ * @public exported from `@promptbook/wizard`
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _OpenAiAgentsTranspilerRegistration: Registration;

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

@@ -1,4 +1,18 @@
 import type { string_markdown_text, string_name } from './typeAliases';
+/**
+ * Minimal recursive JSON Schema entry used by tool definitions.
+ *
+ * Note: [🚉] This is fully serializable as JSON
+ */
+type LlmToolJsonSchema = {
+    type?: string;
+    description?: string;
+    properties?: Record<string, LlmToolJsonSchema>;
+    required?: string[];
+    items?: LlmToolJsonSchema;
+    enum?: Array<string | number | boolean | null>;
+    additionalProperties?: boolean;
+};
 /**
  * Definition of a tool that can be used by the model
  *
@@ -16,13 +30,9 @@ export type LlmToolDefinition = {
     /**
      * Parameters of the tool in JSON Schema format
      */
-    readonly parameters: {
+    readonly parameters: LlmToolJsonSchema & {
         readonly type: 'object';
-        readonly properties: Record<string, {
-            type: string;
-            description?: string;
-        }>;
-        readonly required?: string[];
-        readonly additionalProperties?: boolean;
+        readonly properties: Record<string, LlmToolJsonSchema>;
     };
 };
+export {};

package/esm/src/utils/agents/resolveAgentAvatarImageUrl.d.ts

@@ -21,6 +21,10 @@ export type ResolveAgentAvatarOptions = {
          * Optional preferred avatar visual id coming from remote profile payloads.
          */
         readonly avatarVisualId?: AvatarVisualId;
+        /**
+         * Optional server-wide fallback visual id forwarded by federated server payloads.
+         */
+        readonly defaultAgentAvatarVisualId?: AvatarVisualId;
     };
     /**
      * Optional base URL used to resolve relative meta images and placeholders.
@@ -52,6 +56,17 @@ export type ResolvedAgentAvatar = {
     readonly avatarDefinition: AvatarDefinition;
     readonly visualId: AvatarVisualId;
 };
+/**
+ * Resolves the avatar visual preferred by an agent, then falls back to a federated server default
+ * and finally to the caller/server default.
+ *
+ * @param agent Agent metadata and optional remote-profile visual id.
+ * @param defaultAvatarVisualId Optional metadata-resolved server default.
+ * @returns Supported avatar visual id.
+ *
+ * @private shared avatar contract
+ */
+export declare function resolveAgentAvatarVisualId(agent: ResolveAgentAvatarOptions['agent'], defaultAvatarVisualId?: AvatarVisualId): AvatarVisualId;
 /**
  * Resolve the fallback avatar URL for an agent.
  *

package/esm/src/utils/markdown/humanizeAiTextEmdashed.d.ts

@@ -1,6 +1,6 @@
 import type { string_markdown } from '../../types/typeAliases';
 /**
- * Change dash-like characters to regular dashes `—` -> `-` and remove soft hyphens
+ * Change dash-like characters to regular dashes `-` -> `-` and remove soft hyphens
  *
  * Note: [🔂] This function is idempotent.
  * Tip: If you want to do the full cleanup, look for `humanizeAiText` exported `@promptbook/markdown-utils`

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/node",
-    "version": "0.112.0-54",
+    "version": "0.112.0-57",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,
@@ -97,11 +97,11 @@
     "types": "./esm/src/_packages/node.index.d.ts",
     "typings": "./esm/src/_packages/node.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.112.0-54"
+        "@promptbook/core": "0.112.0-57"
     },
     "dependencies": {
         "@mozilla/readability": "0.6.0",
-        "@openai/agents": "0.4.12",
+        "@openai/agents": "0.4.15",
         "bottleneck": "2.19.5",
         "colors": "1.4.0",
         "crypto": "1.0.1",