@promptbook/wizard 0.100.0-16 → 0.100.0-17

package/esm/index.es.js

@@ -38,7 +38,7 @@ const BOOK_LANGUAGE_VERSION = '1.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.100.0-16';
+const PROMPTBOOK_ENGINE_VERSION = '0.100.0-17';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/typings/src/_packages/core.index.d.ts

@@ -1,7 +1,8 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
 import { parseAgentSource } from '../book-2.0/agent-source/parseAgentSource';
-import { isAgentSource } from '../book-2.0/agent-source/string_agent_source';
-import { validateAgentSource } from '../book-2.0/agent-source/string_agent_source';
+import { isValidBook } from '../book-2.0/agent-source/string_book';
+import { validateBook } from '../book-2.0/agent-source/string_book';
+import { DEFAULT_BOOK } from '../book-2.0/agent-source/string_book';
 import { createEmptyAgentModelRequirements } from '../book-2.0/commitments/_base/createEmptyAgentModelRequirements';
 import { createBasicAgentModelRequirements } from '../book-2.0/commitments/_base/createEmptyAgentModelRequirements';
 import { NotYetImplementedCommitmentDefinition } from '../book-2.0/commitments/_base/NotYetImplementedCommitmentDefinition';
@@ -156,8 +157,9 @@ import { TaskTypes } from '../types/TaskType';
 import { REMOTE_SERVER_URLS } from '../../servers';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { parseAgentSource };
-export { isAgentSource };
-export { validateAgentSource };
+export { isValidBook };
+export { validateBook };
+export { DEFAULT_BOOK };
 export { createEmptyAgentModelRequirements };
 export { createBasicAgentModelRequirements };
 export { NotYetImplementedCommitmentDefinition };

package/esm/typings/src/_packages/types.index.d.ts

@@ -1,5 +1,5 @@
 import type { AgentSourceBasicInformation } from '../book-2.0/agent-source/parseAgentSource';
-import type { string_agent_source } from '../book-2.0/agent-source/string_agent_source';
+import type { string_book } from '../book-2.0/agent-source/string_book';
 import type { BookCommitment } from '../book-2.0/commitments/_base/BookCommitment';
 import type { CommitmentDefinition } from '../book-2.0/commitments/_base/CommitmentDefinition';
 import type { AgentModelRequirements } from '../book-2.0/commitments/_misc/AgentModelRequirements';
@@ -317,7 +317,7 @@ import type { CheckSerializableAsJsonOptions } from '../utils/serialization/chec
 import type { ExportJsonOptions } from '../utils/serialization/exportJson';
 import type { string_promptbook_version } from '../version';
 export type { AgentSourceBasicInformation };
-export type { string_agent_source };
+export type { string_book };
 export type { BookCommitment };
 export type { CommitmentDefinition };
 export type { AgentModelRequirements };

package/esm/typings/src/book-2.0/agent-source/parseAgentSource.d.ts

@@ -1,6 +1,6 @@
 import type { string_agent_name } from '../../types/typeAliases';
 import type { string_url_image } from '../../types/typeAliases';
-import type { string_agent_source } from './string_agent_source';
+import type { string_book } from './string_book';
 export interface AgentSourceBasicInformation {
     /**
      * Name of the agent
@@ -27,4 +27,4 @@ export interface AgentSourceBasicInformation {
  *
  * @public exported from `@promptbook/core`
  */
-export declare function parseAgentSource(agentSource: string_agent_source): AgentSourceBasicInformation;
+export declare function parseAgentSource(agentSource: string_book): AgentSourceBasicInformation;

package/esm/typings/src/book-2.0/agent-source/string_book.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Branded type for books
+ */
+export type string_book = string & {
+    readonly __type: 'book';
+};
+/**
+ * Type guard to check if a string is a valid agent source
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function isValidBook(value: string): value is string_book;
+/**
+ * Validates and converts a string to agent source branded type
+ * This function should be used when you have a string that you know represents agent source
+ * but need to convert it to the branded type for type safety
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function validateBook(source: string): string_book;
+/**
+ * Default book
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const DEFAULT_BOOK: string_book;

package/esm/typings/src/book-2.0/commitments/_misc/createAgentModelRequirements.d.ts

@@ -1,4 +1,4 @@
-import type { string_agent_source } from '../../agent-source/string_agent_source';
+import type { string_book } from '../../agent-source/string_book';
 import type { AgentModelRequirements } from './AgentModelRequirements';
 /**
  * Creates model requirements for an agent based on its source
@@ -10,7 +10,7 @@ import type { AgentModelRequirements } from './AgentModelRequirements';
  *
  * @public exported from `@promptbook/core`
  */
-export declare function createAgentModelRequirements(agentSource: string_agent_source, modelName?: string): Promise<AgentModelRequirements>;
+export declare function createAgentModelRequirements(agentSource: string_book, modelName?: string): Promise<AgentModelRequirements>;
 /**
  * Clears the cache for createAgentModelRequirements
  * Useful when agent sources are updated and cached results should be invalidated
@@ -23,7 +23,7 @@ export declare function clearAgentModelRequirementsCache(): void;
  * @param agentSource The agent source to remove from cache
  * @private
  */
-export declare function invalidateAgentModelRequirementsCache(agentSource: string_agent_source): void;
+export declare function invalidateAgentModelRequirementsCache(agentSource: string_book): void;
 /**
  * Gets the current cache size (for debugging/monitoring)
  *
@@ -38,19 +38,19 @@ export declare function getAgentModelRequirementsCacheSize(): number;
  *
  * @private TODO: [🧠] Maybe should be public
  */
-export declare function extractMcpServers(agentSource: string_agent_source): string[];
+export declare function extractMcpServers(agentSource: string_book): string[];
 /**
  * Creates a system message for an agent based on its source
  * @deprecated Use createAgentModelRequirements instead
  * @private
  */
-export declare function createAgentSystemMessage(agentSource: string_agent_source): Promise<string>;
+export declare function createAgentSystemMessage(agentSource: string_book): Promise<string>;
 /**
  * Extracts the agent name from the first line of the agent source
  * @deprecated Use parseAgentSource instead
  * @private
  */
-export declare function extractAgentName(agentSource: string_agent_source): string;
+export declare function extractAgentName(agentSource: string_book): string;
 /**
  * Extracts the profile image URL from agent source or returns gravatar fallback
  * @param agentSource The agent source string that may contain META IMAGE line
@@ -58,4 +58,4 @@ export declare function extractAgentName(agentSource: string_agent_source): stri
  * @deprecated Use parseAgentSource instead
  * @private
  */
-export declare function extractAgentProfileImage(agentSource: string_agent_source): string;
+export declare function extractAgentProfileImage(agentSource: string_book): string;

package/esm/typings/src/book-2.0/commitments/_misc/createAgentModelRequirementsWithCommitments.d.ts

@@ -1,4 +1,4 @@
-import type { string_agent_source } from '../../agent-source/string_agent_source';
+import type { string_book } from '../../agent-source/string_book';
 import type { AgentModelRequirements } from './AgentModelRequirements';
 /**
  * Creates agent model requirements using the new commitment system
@@ -7,14 +7,14 @@ import type { AgentModelRequirements } from './AgentModelRequirements';
  *
  * @private
  */
-export declare function createAgentModelRequirementsWithCommitments(agentSource: string_agent_source, modelName?: string): Promise<AgentModelRequirements>;
+export declare function createAgentModelRequirementsWithCommitments(agentSource: string_book, modelName?: string): Promise<AgentModelRequirements>;
 /**
  * Cached version of createAgentModelRequirementsWithCommitments
  * This maintains the same caching behavior as the original function
  *
  * @private
  */
-export declare function createAgentModelRequirementsWithCommitmentsCached(agentSource: string_agent_source, modelName?: string): Promise<AgentModelRequirements>;
+export declare function createAgentModelRequirementsWithCommitmentsCached(agentSource: string_book, modelName?: string): Promise<AgentModelRequirements>;
 /**
  * Clears the cache for createAgentModelRequirementsWithCommitments
  *
@@ -26,7 +26,7 @@ export declare function clearAgentModelRequirementsWithCommitmentsCache(): void;
  *
  * @private
  */
-export declare function invalidateAgentModelRequirementsWithCommitmentsCache(agentSource: string_agent_source): void;
+export declare function invalidateAgentModelRequirementsWithCommitmentsCache(agentSource: string_book): void;
 /**
  * Gets the current cache size
  *

package/esm/typings/src/book-2.0/commitments/_misc/parseAgentSourceWithCommitments.d.ts

@@ -1,5 +1,5 @@
 import type { AgentSourceBasicInformation } from '../../agent-source/parseAgentSource';
-import type { string_agent_source } from '../../agent-source/string_agent_source';
+import type { string_book } from '../../agent-source/string_book';
 import type { AgentSourceParseResult } from './AgentSourceParseResult';
 /**
  * Parses agent source using the new commitment system with multiline support
@@ -7,18 +7,18 @@ import type { AgentSourceParseResult } from './AgentSourceParseResult';
  *
  * @private
  */
-export declare function parseAgentSourceWithCommitments(agentSource: string_agent_source): AgentSourceParseResult;
+export declare function parseAgentSourceWithCommitments(agentSource: string_book): AgentSourceParseResult;
 /**
  * Extracts basic information from agent source using the new commitment system
  * This maintains compatibility with the original parseAgentSource interface
  *
  * @private
  */
-export declare function parseAgentSourceBasicInfo(agentSource: string_agent_source): AgentSourceBasicInformation;
+export declare function parseAgentSourceBasicInfo(agentSource: string_book): AgentSourceBasicInformation;
 /**
  * Extracts META LINK commitments from agent source
  * Returns an array of all META LINK URLs found in the agent source
  *
  * @private
  */
-export declare function extractMetaLinks(agentSource: string_agent_source): string[];
+export declare function extractMetaLinks(agentSource: string_book): string[];

package/esm/typings/src/pipeline/book-notation.d.ts

@@ -1,3 +1,4 @@
+import type { string_book } from '../book-2.0/agent-source/string_book';
 import type { PipelineString } from './PipelineString';
 /**
  * Tag function for notating a pipeline with a book\`...\ notation as template literal
@@ -12,7 +13,7 @@ import type { PipelineString } from './PipelineString';
  * @returns the pipeline string
  * @public exported from `@promptbook/core`
  */
-export declare function book(strings: TemplateStringsArray, ...values: Array<string>): PipelineString;
+export declare function book(strings: TemplateStringsArray, ...values: Array<string>): string_book & PipelineString;
 /**
  * TODO: [🧠][🈴] Where is the best location for this file
  * Note: [💞] Ignore a discrepancy between file name and entity name

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.100.0-15`).
+ * It follows semantic versioning (e.g., `0.100.0-16`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/wizard",
-    "version": "0.100.0-16",
+    "version": "0.100.0-17",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,
@@ -95,7 +95,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/wizard.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.100.0-16"
+        "@promptbook/core": "0.100.0-17"
     },
     "dependencies": {
         "@ai-sdk/deepseek": "0.1.6",

package/umd/index.umd.js

@@ -49,7 +49,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.100.0-16';
+    const PROMPTBOOK_ENGINE_VERSION = '0.100.0-17';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/typings/src/book-2.0/agent-source/string_agent_source.d.ts

@@ -1,42 +0,0 @@
-/**
- * Branded type for agent source strings
- *
- * This ensures type safety when working with agent source data throughout the application.
- * Agent source strings contain structured data in a specific format:
- * - First line: Agent name
- * - PERSONA line: Agent persona/description (optional)
- * - META IMAGE line: Profile image URL (optional)
- * - Remaining content: System message (after removing META IMAGE line)
- */
-export type string_agent_source = string & {
-    readonly __brand: 'agent_source';
-};
-/**
- * Type guard to check if a string is a valid agent source
- *
- * @public exported from `@promptbook/core`
- */
-export declare function isAgentSource(value: string): value is string_agent_source;
-/**
- * Creates a branded agent source string from a regular string
- * Performs basic validation to ensure the string is suitable as agent source
- *
- * @private
- * @deprecated Use `validateAgentSource` instead - these functions are now equivalent
- */
-export declare function createAgentSource(source: string): string_agent_source;
-/**
- * Safely converts a string to agent source with fallback
- *
- * @private
- * @deprecated Use `validateAgentSource` instead - these functions are now equivalent
- */
-export declare function toAgentSource(source: string, fallback?: string): string_agent_source;
-/**
- * Validates and converts a string to agent source branded type
- * This function should be used when you have a string that you know represents agent source
- * but need to convert it to the branded type for type safety
- *
- * @public exported from `@promptbook/core`
- */
-export declare function validateAgentSource(source: string): string_agent_source;