@promptbook/cli 0.112.0-98 → 0.112.0

package/src/cli/common/$deprecateCliCommand.ts

@@ -1,5 +1,6 @@
 import colors from 'colors';
 import { Command } from 'commander';
+import { spaceTrim } from 'spacetrim';
 import type { $side_effect } from '../../utils/organization/$side_effect';
 
 /**
@@ -8,7 +9,15 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * @private utility of CLI
  */
 export function $deprecateCliCommand(command: Command, deprecationMessage: string): $side_effect {
-    command.description(`${command.description()}\n\nDeprecated: ${deprecationMessage}`);
+    command.description(
+        spaceTrim(
+            (block) => `
+                ${block(command.description())}
+
+                Deprecated: ${block(deprecationMessage)}
+            `,
+        ),
+    );
     command.hook('preAction', () => {
         console.warn(colors.yellow(createDeprecatedCliCommandWarning(command, deprecationMessage)));
     });

package/src/cli/promptbookCli.ts

@@ -6,6 +6,7 @@ import { EnvironmentMismatchError } from '../errors/EnvironmentMismatchError';
 import { $isRunningInNode } from '../utils/environment/$isRunningInNode';
 import { PROMPTBOOK_ENGINE_VERSION } from '../version';
 import { $initializeAboutCommand } from './cli-commands/about';
+import { $initializeAgentCommand } from './cli-commands/agent';
 import { $initializeAgentFolderCommand } from './cli-commands/agent-folder';
 import { $initializeAgentsServerCommand } from './cli-commands/agents-server';
 import { $initializeCoderCommand } from './cli-commands/coder';
@@ -93,6 +94,7 @@ export async function promptbookCli(): Promise<void> {
     $initializeListScrapersCommand(program);
     $initializeStartAgentsServerCommand(program);
     $initializeStartPipelinesServerCommand(program);
+    $initializeAgentCommand(program);
     $initializeAgentFolderCommand(program);
     $initializeAgentsServerCommand(program);
     $initializeCoderCommand(program);

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

@@ -49,6 +49,19 @@ function normalizeHistoryVersionName(versionName: string | null | undefined): st
     return normalizedVersionName.length > 0 ? normalizedVersionName : null;
 }
 
+/**
+ * Builds a Supabase `.or()` filter for agent name or permanent id lookups.
+ *
+ * @param agentNameOrPermanentId - Agent name or stable permanent identifier to match.
+ * @returns `.or()` filter string safe to pass to Supabase.
+ *
+ * @private internal helper of `AgentCollectionInSupabase`
+ */
+function buildAgentNameOrPermanentIdFilter(agentNameOrPermanentId: string): string {
+    const encodedAgentIdentifier = encodeURIComponent(agentNameOrPermanentId);
+    return `agentName.eq.${encodedAgentIdentifier},permanentId.eq.${encodedAgentIdentifier}`;
+}
+
 /**
  * One saved Agent history row without the full source payload.
  */
@@ -69,6 +82,16 @@ type AgentHistorySnapshot = AgentHistoryMetadata & {
     readonly agentSource: string;
 };
 
+/**
+ * Minimal database row used to build public agent information.
+ *
+ * @private internal type of `AgentCollectionInSupabase`
+ */
+type AgentBasicInformationRow = Pick<
+    AgentsDatabaseSchema['public']['Tables']['Agent']['Row'],
+    'agentName' | 'agentProfile' | 'permanentId'
+>;
+
 /**
  * Agent collection stored in a Supabase table.
  *
@@ -127,24 +150,78 @@ export class AgentCollectionInSupabase /* TODO: [🌈][🐱‍🚀] implements A
             console.info(`Found ${selectResult.data.length} agents in directory`);
         }
 
-        return selectResult.data.map(({ agentName, agentProfile, permanentId }) => {
-            if (isVerbose && (agentProfile as AgentBasicInformation).agentName !== agentName) {
-                console.warn(
-                    spaceTrim(`
+        return selectResult.data.map((row) => this.mapAgentBasicInformationRow(row, isVerbose));
+    }
+
+    /**
+     * Finds one active agent profile by its human-readable name or permanent id.
+     *
+     * This keeps route-level lookups from loading the whole agent collection when only
+     * one canonical route identifier is needed.
+     *
+     * @param agentNameOrPermanentId - Agent name or stable permanent identifier.
+     * @returns Matching active agent profile or `null` when not found.
+     *
+     * @public exported from `@promptbook/core`
+     */
+    public async findAgentBasicInformation(
+        agentNameOrPermanentId: string_agent_name | string_agent_permanent_id,
+    ): Promise<AgentBasicInformation | null> {
+        const { isVerbose = DEFAULT_IS_VERBOSE } = this.options || {};
+        const selectResult = await this.supabaseClient
+            .from(this.getTableName('Agent'))
+            .select('agentName,agentProfile,permanentId')
+            .or(buildAgentNameOrPermanentIdFilter(agentNameOrPermanentId))
+            .is('deletedAt', null)
+            .order('createdAt', { ascending: true })
+            .limit(1);
+
+        if (selectResult.error) {
+            throw new DatabaseError(
+                spaceTrim(
+                    (block) => `
+
+                        Error fetching agent "${agentNameOrPermanentId}" from Supabase:
+
+                        ${block(selectResult.error.message)}
+                    `,
+                ),
+            );
+        }
+
+        const row = selectResult.data?.[0];
+        return row ? this.mapAgentBasicInformationRow(row, isVerbose) : null;
+    }
+
+    /**
+     * Converts one database row into public agent information.
+     *
+     * @param row - Database row carrying the persisted profile snapshot.
+     * @param isVerbose - Whether profile-name mismatches should be logged.
+     * @returns Agent profile with canonical database name and permanent id.
+     *
+     * @private internal helper of `AgentCollectionInSupabase`
+     */
+    private mapAgentBasicInformationRow(
+        { agentName, agentProfile, permanentId }: AgentBasicInformationRow,
+        isVerbose: boolean,
+    ): AgentBasicInformation {
+        if (isVerbose && (agentProfile as AgentBasicInformation).agentName !== agentName) {
+            console.warn(
+                spaceTrim(`
                         Agent name mismatch for agent "${agentName}". Using name from database.
 
                         agentName: "${agentName}"
                         agentProfile.agentName: "${(agentProfile as AgentBasicInformation).agentName}"
                     `),
-                );
-            }
+            );
+        }
 
-            return {
-                ...(agentProfile as AgentBasicInformation),
-                agentName,
-                permanentId: permanentId || (agentProfile as AgentBasicInformation).permanentId,
-            };
-        });
+        return {
+            ...(agentProfile as AgentBasicInformation),
+            agentName,
+            permanentId: permanentId || (agentProfile as AgentBasicInformation).permanentId,
+        };
     }
 
     /**
@@ -156,7 +233,7 @@ export class AgentCollectionInSupabase /* TODO: [🌈][🐱‍🚀] implements A
         const selectResult = await this.supabaseClient
             .from(this.getTableName('Agent'))
             .select('permanentId')
-            .or(`agentName.eq.${agentNameOrPermanentId},permanentId.eq.${agentNameOrPermanentId}`)
+            .or(buildAgentNameOrPermanentIdFilter(agentNameOrPermanentId))
             .order('createdAt', { ascending: true }) // Pick oldest if multiple match by name
             .limit(1);
 
@@ -175,7 +252,7 @@ export class AgentCollectionInSupabase /* TODO: [🌈][🐱‍🚀] implements A
         const selectResult = await this.supabaseClient
             .from(this.getTableName('Agent'))
             .select('agentSource')
-            .or(`agentName.eq.${agentNameOrPermanentId},permanentId.eq.${agentNameOrPermanentId}`)
+            .or(buildAgentNameOrPermanentIdFilter(agentNameOrPermanentId))
             .is('deletedAt', null)
             .order('createdAt', { ascending: true }) // Pick oldest if multiple match by name
             .limit(1);

package/src/commands/KNOWLEDGE/utils/knowledgeSourceContentToName.ts

@@ -1,4 +1,4 @@
-import { SHA256 as sha256 } from 'crypto-js';
+import CryptoJS from 'crypto-js';
 import hexEncoder from 'crypto-js/enc-hex';
 import type { string_knowledge_source_content } from '../../../types/string_knowledge_source_content';
 import type { string_name } from '../../../types/string_name';
@@ -10,7 +10,7 @@ import { normalizeToKebabCase } from '../../../utils/normalization/normalize-to-
  * @public exported from `@promptbook/editable`
  */
 export function knowledgeSourceContentToName(knowledgeSourceContent: string_knowledge_source_content): string_name {
-    const hash = sha256(hexEncoder.parse(JSON.stringify(knowledgeSourceContent)))
+    const hash = CryptoJS.SHA256(hexEncoder.parse(JSON.stringify(knowledgeSourceContent)))
         //    <- TODO: [🥬] Encapsulate sha256 to some private utility function
         .toString(/* hex */)
         .substring(0, 20);

package/src/commitments/GOAL/GOAL.ts

@@ -101,8 +101,13 @@ export class GoalCommitmentDefinition extends BaseCommitmentDefinition<'GOAL' |
             return requirements;
         }
 
-        // Add goal as a proper h2 section to the system message
-        const goalSection = `## Goal\n\n${trimmedContent}`;
+        const goalSection = spaceTrim(
+            (block) => `
+                ## Goal
+
+                ${block(trimmedContent)}
+            `,
+        );
         const requirementsWithGoal = this.appendToSystemMessage(requirements, goalSection, '\n\n');
 
         return this.appendToPromptSuffix(requirementsWithGoal, trimmedContent);

package/src/commitments/LANGUAGE/LANGUAGE.ts

@@ -70,8 +70,13 @@ export class LanguageCommitmentDefinition extends BaseCommitmentDefinition<'LANG
             return requirements;
         }
 
-        // Add language as a bullet under a ## Language section
-        const languageSection = `## Language\n\n-   Your language is ${trimmedContent}`;
+        const languageSection = spaceTrim(
+            (block) => `
+                ## Language
+
+                -   Your language is ${block(trimmedContent)}
+            `,
+        );
 
         return this.appendToSystemMessage(requirements, languageSection, '\n\n');
     }

package/src/commitments/TEAM/TEAM.ts

@@ -448,7 +448,18 @@ function buildTeammateMetadata(entry: TeamToolEntry): TeamToolResult['teammate']
  * Builds the teammate request text, optionally including context.
  */
 function buildTeammateRequest(message: string, context?: string): string {
-    return context ? `${message}\n\nContext:\n${context}` : message;
+    if (!context) {
+        return message;
+    }
+
+    return spaceTrim(
+        (block) => `
+            ${block(message)}
+
+            Context:
+            ${block(context)}
+        `,
+    );
 }
 
 /**

package/src/commitments/USE_PROJECT/createUseProjectToolFunctions.ts

@@ -1,3 +1,4 @@
+import { spaceTrim } from 'spacetrim';
 import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
 import type { string_javascript_name } from '../../types/string_person_fullname';
 import { decodeAttachmentAsText, DEFAULT_ATTACHMENT_TEXT_DECODE_BYTES } from '../../utils/files/decodeAttachmentAsText';
@@ -197,7 +198,13 @@ export function createUseProjectToolFunctions(): Record<string_javascript_name,
                 const lineRangedContent = applyOptionalLineRange(decodedContent, args.startLine, args.endLine);
                 const wasCharacterTruncated = lineRangedContent.length > MAX_PROJECT_FILE_CONTENT_CHARACTERS;
                 const contentToReturn = wasCharacterTruncated
-                    ? `${lineRangedContent.slice(0, MAX_PROJECT_FILE_CONTENT_CHARACTERS)}\n\n[...truncated...]`
+                    ? spaceTrim(
+                          (block) => `
+                              ${block(lineRangedContent.slice(0, MAX_PROJECT_FILE_CONTENT_CHARACTERS))}
+
+                              [...truncated...]
+                          `,
+                      )
                     : lineRangedContent;
 
                 const wasTruncated = decoded.isTruncated || wasCharacterTruncated;

package/src/commitments/_common/teamInternalAgentAccess.ts

@@ -1,4 +1,5 @@
-import { SHA256 as sha256 } from 'crypto-js';
+import CryptoJS from 'crypto-js';
+import { isTimingSafeEqualString } from '../../utils/isTimingSafeEqualString';
 
 /**
  * Header used for same-server TEAM calls that may access private teammate agents.
@@ -30,21 +31,26 @@ export type TeamInternalAgentAccessHeadersOptions = {
 /**
  * Resolves the internal token used by same-server TEAM calls.
  *
- * @returns Hashed token, or `null` when the server does not have a private secret.
+ * `PROMPTBOOK_TEAM_AGENT_ACCESS_TOKEN` must be a dedicated secret — falling
+ * back to `ADMIN_PASSWORD`, `SUPABASE_SERVICE_ROLE_KEY`, or any other shared
+ * credential would let a leak of one secret compromise both authentication
+ * boundaries (admin login and same-server teammate-agent access). When the
+ * dedicated variable is missing, this function returns `null` so the calling
+ * server fails closed — same-server TEAM access is disabled and no header is
+ * sent — instead of silently authorizing requests with the wrong secret.
+ *
+ * @returns Hashed token, or `null` when the dedicated secret is not configured.
  *
  * @private internal Agents Server access wiring
  */
 export function resolveTeamInternalAgentAccessToken(): string | null {
-    const secret =
-        normalizeSecret(readEnvironmentVariable('PROMPTBOOK_TEAM_AGENT_ACCESS_TOKEN')) ||
-        normalizeSecret(readEnvironmentVariable('SUPABASE_SERVICE_ROLE_KEY')) ||
-        normalizeSecret(readEnvironmentVariable('ADMIN_PASSWORD'));
+    const secret = normalizeSecret(readEnvironmentVariable('PROMPTBOOK_TEAM_AGENT_ACCESS_TOKEN'));
 
     if (!secret) {
         return null;
     }
 
-    return sha256(`promptbook-team-agent-access:${secret}`).toString();
+    return CryptoJS.SHA256(`promptbook-team-agent-access:${secret}`).toString();
 }
 
 /**
@@ -79,7 +85,7 @@ export function isTeamInternalAgentAccessToken(value: string | null | undefined)
     const expectedToken = resolveTeamInternalAgentAccessToken();
     const providedToken = normalizeSecret(value);
 
-    return Boolean(expectedToken && providedToken && providedToken === expectedToken);
+    return Boolean(expectedToken && providedToken && isTimingSafeEqualString(providedToken, expectedToken));
 }
 
 /**

package/src/execution/createPipelineExecutor/getKnowledgeForTask.ts

@@ -4,7 +4,7 @@ import { getSingleLlmExecutionTools } from '../../llm-providers/_multiple/getSin
 import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
 import type { TaskJson } from '../../pipeline/PipelineJson/TaskJson';
 import type { Parameters } from '../../types/Parameters';
-import { Prompt } from '../../types/Prompt';
+import type { Prompt } from '../../types/Prompt';
 import type { string_markdown } from '../../types/string_markdown';
 import type { string_parameter_value } from '../../types/string_name';
 import type { ExecutionTools } from '../ExecutionTools';

package/src/formats/csv/CsvFormatParser.ts

@@ -1,4 +1,4 @@
-import { unparse } from 'papaparse';
+import papaparse from 'papaparse';
 import { spaceTrim } from 'spacetrim';
 import type { TODO_any } from '../../utils/organization/TODO_any';
 import { TODO_USE } from '../../utils/organization/TODO_USE';
@@ -102,11 +102,11 @@ export const CsvFormatParser: FormatParser<
                             i > index ? { ...row, [outputParameterName]: PENDING_VALUE_PLACEHOLDER } : row,
                         );
                         */
-                        await onProgress(unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS }));
+                        await onProgress(papaparse.unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS }));
                     }
                 }
 
-                return unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS });
+                return papaparse.unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS });
             },
         },
         {
@@ -149,7 +149,7 @@ export const CsvFormatParser: FormatParser<
                     }),
                 );
 
-                return unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS });
+                return papaparse.unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS });
             },
         },
     ],

package/src/formats/csv/utils/csvParse.ts

@@ -1,5 +1,5 @@
 import type { ParseResult } from 'papaparse';
-import { parse } from 'papaparse';
+import papaparse from 'papaparse';
 import type { Parameters } from '../../../types/Parameters';
 import type { TODO_any } from '../../../utils/organization/TODO_any';
 import { TODO_USE } from '../../../utils/organization/TODO_USE';
@@ -31,6 +31,6 @@ export function csvParse(
         value = value.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
     }
 
-    const csv = parse<Parameters>(value, settings);
+    const csv = papaparse.parse<Parameters>(value, settings);
     return csv;
 }

package/src/import-plugins/JsonFileImportPlugin.ts

@@ -1,3 +1,4 @@
+import { spaceTrim } from 'spacetrim';
 import type { FileImportPlugin } from './FileImportPlugin';
 
 /**
@@ -14,10 +15,22 @@ export const JsonFileImportPlugin: FileImportPlugin = {
         try {
             const json = JSON.parse(content);
             const formattedJson = JSON.stringify(json, null, 4);
-            return `\`\`\`json\n${formattedJson}\n\`\`\``;
+            return spaceTrim(
+                (block) => `
+                    \`\`\`json
+                    ${block(formattedJson)}
+                    \`\`\`
+                `,
+            );
         } catch (error) {
             // If JSON is invalid, still import it but maybe not as pretty JSON
-            return `\`\`\`json\n${content}\n\`\`\``;
+            return spaceTrim(
+                (block) => `
+                    \`\`\`json
+                    ${block(content)}
+                    \`\`\`
+                `,
+            );
         }
     },
 };

package/src/import-plugins/TextFileImportPlugin.ts

@@ -1,3 +1,4 @@
+import { spaceTrim } from 'spacetrim';
 import { mimeTypeToExtension } from '../utils/files/mimeTypeToExtension';
 import type { FileImportPlugin } from './FileImportPlugin';
 
@@ -23,6 +24,12 @@ export const TextFileImportPlugin: FileImportPlugin = {
         const extension = mimeTypeToExtension(mimeType);
         const codeBlockType = extension || 'txt';
 
-        return `\`\`\`${codeBlockType}\n${content}\n\`\`\``;
+        return spaceTrim(
+            (block) => `
+                \`\`\`${codeBlockType}
+                ${block(content)}
+                \`\`\`
+            `,
+        );
     },
 };

package/src/llm-providers/_common/register/$provideLlmToolsConfigurationFromEnv.ts

@@ -13,7 +13,7 @@ import type { LlmToolsConfiguration } from './LlmToolsConfiguration';
  *
  * It looks for environment variables:
  * - `process.env.OPENAI_API_KEY`
- * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+ * - `process.env.ANTHROPIC_API_KEY` (or the deprecated `process.env.ANTHROPIC_CLAUDE_API_KEY`)
  * - ...
  *
  * @see Environment variables documentation or .env file for required variables.

package/src/llm-providers/_common/register/$provideLlmToolsFromEnv.ts

@@ -22,7 +22,7 @@ import { createLlmToolsFromConfiguration } from './createLlmToolsFromConfigurati
  *
  * It looks for environment variables:
  * - `process.env.OPENAI_API_KEY`
- * - `process.env.ANTHROPIC_CLAUDE_API_KEY`
+ * - `process.env.ANTHROPIC_API_KEY` (or the deprecated `process.env.ANTHROPIC_CLAUDE_API_KEY`)
  * - ...
  *
  * @param options Configuration options for the LLM tools

package/src/llm-providers/_common/register/$registeredLlmToolsMessage.ts

@@ -589,7 +589,12 @@ function colorizeAvailableProviderMessage(
  * @private internal function of `$registeredLlmToolsMessage`
  */
 function createUsedEnvMessage(): string {
-    return $usedEnvFilename === null ? `Unknown \`.env\` file` : `Used \`.env\` file:\n${$usedEnvFilename}`;
+    return $usedEnvFilename === null
+        ? `Unknown \`.env\` file`
+        : spaceTrim(`
+              Used \`.env\` file:
+              ${$usedEnvFilename}
+          `);
 }
 
 // TODO: [®] DRY Register logic

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

@@ -1,4 +1,4 @@
-import { SHA256 as sha256 } from 'crypto-js';
+import CryptoJS from 'crypto-js';
 import hexEncoder from 'crypto-js/enc-hex';
 import type { Promisable } from 'type-fest';
 import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
@@ -230,7 +230,7 @@ export class AgentLlmExecutionTools implements LlmExecutionTools {
      * Returns a virtual model name representing the agent behavior.
      */
     public get modelName(): string_model_name {
-        const hash = sha256(hexEncoder.parse(this.options.agentSource)).toString(/* hex */);
+        const hash = CryptoJS.SHA256(hexEncoder.parse(this.options.agentSource)).toString(/* hex */);
         const agentId = hash.substring(0, 10);
 
         return (normalizeToKebabCase(this.title) + '-' + agentId) as string_model_name;

package/src/llm-providers/agent/AgentLlmExecutionToolsAgentKitRunner.ts

@@ -1,4 +1,4 @@
-import { SHA256 as sha256 } from 'crypto-js';
+import CryptoJS from 'crypto-js';
 import type { CallChatModelStreamOptions } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult, CommonPromptResult } from '../../execution/PromptResult';
 import type { Prompt } from '../../types/Prompt';
@@ -29,7 +29,7 @@ type AgentKitCacheState = {
  * Computes one stable hash from a JSON-serializable value.
  */
 function computeJsonHash(value: unknown): string {
-    return sha256(JSON.stringify(value)).toString();
+    return CryptoJS.SHA256(JSON.stringify(value)).toString();
 }
 
 /**

package/src/llm-providers/agent/AgentLlmExecutionToolsOpenAiAssistantRunner.ts

@@ -1,4 +1,4 @@
-import { SHA256 as sha256 } from 'crypto-js';
+import CryptoJS from 'crypto-js';
 import type { CallChatModelStreamOptions } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult, CommonPromptResult } from '../../execution/PromptResult';
 import type { ChatPrompt, Prompt } from '../../types/Prompt';
@@ -12,7 +12,7 @@ import { emitAgentLlmExecutionToolsAssistantPreparationProgress } from './emitAg
  * Computes one stable hash from a JSON-serializable value.
  */
 function computeJsonHash(value: unknown): string {
-    return sha256(JSON.stringify(value)).toString();
+    return CryptoJS.SHA256(JSON.stringify(value)).toString();
 }
 
 /**

package/src/llm-providers/anthropic-claude/register-configuration.ts

@@ -19,7 +19,7 @@ export const _AnthropicClaudeMetadataRegistration: Registration = $llmToolsMetad
     title: 'Anthropic Claude',
     packageName: '@promptbook/anthropic-claude',
     className: 'AnthropicClaudeExecutionTools',
-    envVariables: ['ANTHROPIC_CLAUDE_API_KEY'],
+    envVariables: ['ANTHROPIC_API_KEY', 'ANTHROPIC_CLAUDE_API_KEY'],
     trustLevel: 'CLOSED',
     order: MODEL_ORDERS.TOP_TIER,
 
@@ -39,13 +39,16 @@ export const _AnthropicClaudeMetadataRegistration: Registration = $llmToolsMetad
 
     createConfigurationFromEnv(env: Record<string_name, string>): LlmToolsConfiguration[number] | null {
         // Note: Note using `process.env` BUT `env` to pass in the environment variables dynamically
-        if (typeof env.ANTHROPIC_CLAUDE_API_KEY === 'string') {
+        // Note: `ANTHROPIC_API_KEY` takes precedence over the deprecated `ANTHROPIC_CLAUDE_API_KEY`
+        const apiKey = env.ANTHROPIC_API_KEY ?? env.ANTHROPIC_CLAUDE_API_KEY;
+
+        if (typeof apiKey === 'string') {
             return {
                 title: 'Claude (from env)',
                 packageName: '@promptbook/anthropic-claude',
                 className: 'AnthropicClaudeExecutionTools',
                 options: {
-                    apiKey: env.ANTHROPIC_CLAUDE_API_KEY!,
+                    apiKey,
                 } satisfies AnthropicClaudeExecutionToolsOptions,
             };
         }

package/src/llm-providers/openai/OpenAiAgentKitExecutionToolsToolBuilder.ts

@@ -449,7 +449,9 @@ export class OpenAiAgentKitExecutionToolsToolBuilder {
             );
         }
 
-        return Array.isArray(executionTools.script) ? executionTools.script : [executionTools.script];
+        return Array.isArray(executionTools.script)
+            ? executionTools.script
+            : [executionTools.script as ScriptExecutionTools];
     }
 
     /**

package/src/llm-providers/openai/OpenAiAssistantExecutionToolsToolRunner.ts

@@ -436,7 +436,7 @@ export class OpenAiAssistantExecutionToolsToolRunner {
 
         return Array.isArray(this.options.scriptExecutionTools)
             ? this.options.scriptExecutionTools
-            : [this.options.scriptExecutionTools];
+            : [this.options.scriptExecutionTools as ScriptExecutionTools];
     }
 
     /**

package/src/llm-providers/openai/OpenAiVectorStoreKnowledgeSourcePreparer.ts

@@ -134,7 +134,7 @@ export class OpenAiVectorStoreKnowledgeSourcePreparer {
             }
 
             return {
-                file: new File([parsed.buffer], parsed.filename, {
+                file: new File([new Uint8Array(parsed.buffer)], parsed.filename, {
                     type: parsed.mimeType,
                 }),
                 sizeBytes: parsed.buffer.length,