@promptbook/google 0.100.0-4 → 0.100.0-40
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -0
- package/esm/index.es.js +46 -6
- package/esm/index.es.js.map +1 -1
- package/esm/typings/src/_packages/components.index.d.ts +4 -0
- package/esm/typings/src/_packages/core.index.d.ts +26 -0
- package/esm/typings/src/_packages/types.index.d.ts +30 -0
- package/esm/typings/src/book-2.0/agent-source/parseAgentSource.d.ts +30 -0
- package/esm/typings/src/book-2.0/agent-source/parseAgentSource.test.d.ts +1 -0
- package/esm/typings/src/book-2.0/agent-source/string_book.d.ts +26 -0
- package/esm/typings/src/book-2.0/commitments/ACTION/ACTION.d.ts +38 -0
- package/esm/typings/src/book-2.0/commitments/FORMAT/FORMAT.d.ts +39 -0
- package/esm/typings/src/book-2.0/commitments/KNOWLEDGE/FrontendRAGService.d.ts +48 -0
- package/esm/typings/src/book-2.0/commitments/KNOWLEDGE/KNOWLEDGE.d.ts +51 -0
- package/esm/typings/src/book-2.0/commitments/KNOWLEDGE/RAGService.d.ts +54 -0
- package/esm/typings/src/book-2.0/commitments/KNOWLEDGE/processors/BaseKnowledgeProcessor.d.ts +45 -0
- package/esm/typings/src/book-2.0/commitments/KNOWLEDGE/processors/PdfProcessor.d.ts +31 -0
- package/esm/typings/src/book-2.0/commitments/KNOWLEDGE/processors/ProcessorFactory.d.ts +23 -0
- package/esm/typings/src/book-2.0/commitments/KNOWLEDGE/processors/TextProcessor.d.ts +18 -0
- package/esm/typings/src/book-2.0/commitments/KNOWLEDGE/types.d.ts +56 -0
- package/esm/typings/src/book-2.0/commitments/KNOWLEDGE/utils/ragHelper.d.ts +34 -0
- package/esm/typings/src/book-2.0/commitments/META_IMAGE/META_IMAGE.d.ts +44 -0
- package/esm/typings/src/book-2.0/commitments/META_LINK/META_LINK.d.ts +56 -0
- package/esm/typings/src/book-2.0/commitments/MODEL/MODEL.d.ts +39 -0
- package/esm/typings/src/book-2.0/commitments/NOTE/NOTE.d.ts +49 -0
- package/esm/typings/src/book-2.0/commitments/PERSONA/PERSONA.d.ts +46 -0
- package/esm/typings/src/book-2.0/commitments/RULE/RULE.d.ts +44 -0
- package/esm/typings/src/book-2.0/commitments/SAMPLE/SAMPLE.d.ts +44 -0
- package/esm/typings/src/book-2.0/commitments/STYLE/STYLE.d.ts +38 -0
- package/esm/typings/src/book-2.0/commitments/_base/BaseCommitmentDefinition.d.ts +52 -0
- package/esm/typings/src/book-2.0/commitments/_base/BookCommitment.d.ts +5 -0
- package/esm/typings/src/book-2.0/commitments/_base/CommitmentDefinition.d.ts +48 -0
- package/esm/typings/src/book-2.0/commitments/_base/NotYetImplementedCommitmentDefinition.d.ts +22 -0
- package/esm/typings/src/book-2.0/commitments/_base/createEmptyAgentModelRequirements.d.ts +19 -0
- package/esm/typings/src/book-2.0/commitments/_misc/AgentModelRequirements.d.ts +37 -0
- package/esm/typings/src/book-2.0/commitments/_misc/AgentSourceParseResult.d.ts +18 -0
- package/esm/typings/src/book-2.0/commitments/_misc/ParsedCommitment.d.ts +22 -0
- package/esm/typings/src/book-2.0/commitments/_misc/createAgentModelRequirements.d.ts +61 -0
- package/esm/typings/src/book-2.0/commitments/_misc/createAgentModelRequirementsWithCommitments.d.ts +35 -0
- package/esm/typings/src/book-2.0/commitments/_misc/createCommitmentRegex.d.ts +20 -0
- package/esm/typings/src/book-2.0/commitments/_misc/parseAgentSourceWithCommitments.d.ts +24 -0
- package/esm/typings/src/book-2.0/commitments/_misc/removeCommentsFromSystemMessage.d.ts +11 -0
- package/esm/typings/src/book-2.0/commitments/index.d.ts +56 -0
- package/esm/typings/src/book-2.0/utils/profileImageUtils.d.ts +39 -0
- package/esm/typings/src/book-components/BookEditor/BookEditor.d.ts +30 -0
- package/esm/typings/src/book-components/_common/react-utils/classNames.d.ts +7 -0
- package/esm/typings/src/config.d.ts +6 -0
- package/esm/typings/src/execution/AvailableModel.d.ts +4 -0
- package/esm/typings/src/execution/ExecutionTask.d.ts +27 -0
- package/esm/typings/src/execution/createPipelineExecutor/40-executeAttempts.d.ts +6 -1
- package/esm/typings/src/llm-providers/anthropic-claude/AnthropicClaudeExecutionTools.d.ts +0 -5
- package/esm/typings/src/llm-providers/anthropic-claude/anthropic-claude-models.d.ts +1 -1
- package/esm/typings/src/llm-providers/deepseek/deepseek-models.d.ts +1 -1
- package/esm/typings/src/llm-providers/google/google-models.d.ts +1 -1
- package/esm/typings/src/llm-providers/ollama/ollama-models.d.ts +1 -1
- package/esm/typings/src/llm-providers/openai/openai-models.d.ts +1 -1
- package/esm/typings/src/pipeline/book-notation.d.ts +2 -1
- package/esm/typings/src/types/ModelRequirements.d.ts +0 -2
- package/esm/typings/src/types/typeAliases.d.ts +6 -0
- package/esm/typings/src/version.d.ts +1 -1
- package/package.json +2 -2
- package/umd/index.umd.js +46 -6
- package/umd/index.umd.js.map +1 -1
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
|
|
2
|
+
import type { CommitmentDefinition } from './CommitmentDefinition';
|
|
3
|
+
/**
|
|
4
|
+
* Base implementation of CommitmentDefinition that provides common functionality
|
|
5
|
+
* Most commitments can extend this class and only override the applyToAgentModelRequirements method
|
|
6
|
+
*
|
|
7
|
+
* @private
|
|
8
|
+
*/
|
|
9
|
+
export declare abstract class BaseCommitmentDefinition<TBookCommitment extends string> implements CommitmentDefinition {
|
|
10
|
+
readonly type: TBookCommitment;
|
|
11
|
+
constructor(type: TBookCommitment);
|
|
12
|
+
/**
|
|
13
|
+
* Short one-line markdown description; concise, may use inline **markdown**.
|
|
14
|
+
* Must be implemented by each concrete commitment.
|
|
15
|
+
*/
|
|
16
|
+
abstract get description(): string;
|
|
17
|
+
/**
|
|
18
|
+
* Human-readable markdown documentation for this commitment, available at runtime.
|
|
19
|
+
* Must be implemented by each concrete commitment.
|
|
20
|
+
*/
|
|
21
|
+
abstract get documentation(): string;
|
|
22
|
+
/**
|
|
23
|
+
* Creates a regex pattern to match this commitment in agent source
|
|
24
|
+
* Uses the existing createCommitmentRegex function as internal helper
|
|
25
|
+
*/
|
|
26
|
+
createRegex(): RegExp;
|
|
27
|
+
/**
|
|
28
|
+
* Creates a regex pattern to match just the commitment type
|
|
29
|
+
* Uses the existing createCommitmentTypeRegex function as internal helper
|
|
30
|
+
*/
|
|
31
|
+
createTypeRegex(): RegExp;
|
|
32
|
+
/**
|
|
33
|
+
* Applies this commitment's logic to the agent model requirements
|
|
34
|
+
* This method must be implemented by each specific commitment
|
|
35
|
+
*/
|
|
36
|
+
abstract applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
|
|
37
|
+
/**
|
|
38
|
+
* Helper method to create a new requirements object with updated system message
|
|
39
|
+
* This is commonly used by many commitments
|
|
40
|
+
*/
|
|
41
|
+
protected updateSystemMessage(requirements: AgentModelRequirements, messageUpdate: string | ((currentMessage: string) => string)): AgentModelRequirements;
|
|
42
|
+
/**
|
|
43
|
+
* Helper method to append content to the system message
|
|
44
|
+
*/
|
|
45
|
+
protected appendToSystemMessage(requirements: AgentModelRequirements, content: string, separator?: string): AgentModelRequirements;
|
|
46
|
+
/**
|
|
47
|
+
* Helper method to add a comment section to the system message
|
|
48
|
+
* Comments are lines starting with # that will be removed from the final system message
|
|
49
|
+
* but can be useful for organizing and structuring the message during processing
|
|
50
|
+
*/
|
|
51
|
+
protected addCommentSection(requirements: AgentModelRequirements, commentTitle: string, content: string, position?: 'beginning' | 'end'): AgentModelRequirements;
|
|
52
|
+
}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
|
|
2
|
+
/**
|
|
3
|
+
* Definition of a commitment that can be applied to agent model requirements
|
|
4
|
+
*
|
|
5
|
+
* Each commitment is self-contained and manages its own logic for:
|
|
6
|
+
* - Creating regex patterns for parsing
|
|
7
|
+
* - Applying its effects to agent model requirements
|
|
8
|
+
*/
|
|
9
|
+
export interface CommitmentDefinition {
|
|
10
|
+
/**
|
|
11
|
+
* The type/name of this commitment (e.g., 'PERSONA', 'KNOWLEDGE', etc.)
|
|
12
|
+
*/
|
|
13
|
+
readonly type: string;
|
|
14
|
+
/**
|
|
15
|
+
* Short one-line markdown description of this commitment (no lists or code blocks).
|
|
16
|
+
* Keep it concise; may use inline markdown like **bold** or *italic*.
|
|
17
|
+
*/
|
|
18
|
+
readonly description: string;
|
|
19
|
+
/**
|
|
20
|
+
* Human-readable markdown documentation for this commitment.
|
|
21
|
+
* Should explain what the commitment does and include example usage.
|
|
22
|
+
* This is available at runtime for UIs, docs, and tooling.
|
|
23
|
+
*/
|
|
24
|
+
readonly documentation: string;
|
|
25
|
+
/**
|
|
26
|
+
* Creates a regex pattern to match this commitment in agent source
|
|
27
|
+
* This regex should capture the commitment content in a 'contents' named group
|
|
28
|
+
*
|
|
29
|
+
* @returns RegExp that matches the full commitment line
|
|
30
|
+
*/
|
|
31
|
+
createRegex(): RegExp;
|
|
32
|
+
/**
|
|
33
|
+
* Creates a regex pattern to match just the commitment type
|
|
34
|
+
* This is useful for checking if a line contains this commitment type
|
|
35
|
+
*
|
|
36
|
+
* @returns RegExp that matches just the commitment type
|
|
37
|
+
*/
|
|
38
|
+
createTypeRegex(): RegExp;
|
|
39
|
+
/**
|
|
40
|
+
* Applies this commitment's logic to the agent model requirements
|
|
41
|
+
* This method should be pure and return a new requirements object
|
|
42
|
+
*
|
|
43
|
+
* @param requirements Current agent model requirements
|
|
44
|
+
* @param content The content part of the commitment (after the type)
|
|
45
|
+
* @returns Updated agent model requirements
|
|
46
|
+
*/
|
|
47
|
+
applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
|
|
48
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
|
|
2
|
+
import { BaseCommitmentDefinition } from './BaseCommitmentDefinition';
|
|
3
|
+
/**
|
|
4
|
+
* Placeholder commitment definition for commitments that are not yet implemented
|
|
5
|
+
*
|
|
6
|
+
* This commitment simply adds its content 1:1 into the system message,
|
|
7
|
+
* preserving the original behavior until proper implementation is added.
|
|
8
|
+
*
|
|
9
|
+
* @public exported from `@promptbook/core`
|
|
10
|
+
*/
|
|
11
|
+
export declare class NotYetImplementedCommitmentDefinition<TBookCommitment extends string> extends BaseCommitmentDefinition<TBookCommitment> {
|
|
12
|
+
constructor(type: TBookCommitment);
|
|
13
|
+
/**
|
|
14
|
+
* Short one-line description of a placeholder commitment.
|
|
15
|
+
*/
|
|
16
|
+
get description(): string;
|
|
17
|
+
/**
|
|
18
|
+
* Markdown documentation available at runtime.
|
|
19
|
+
*/
|
|
20
|
+
get documentation(): string;
|
|
21
|
+
applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
|
|
22
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
|
|
2
|
+
/**
|
|
3
|
+
* Creates an empty/basic agent model requirements object
|
|
4
|
+
* This serves as the starting point for the reduce-like pattern
|
|
5
|
+
* where each commitment applies its changes to build the final requirements
|
|
6
|
+
*
|
|
7
|
+
* @public exported from `@promptbook/core`
|
|
8
|
+
*/
|
|
9
|
+
export declare function createEmptyAgentModelRequirements(): AgentModelRequirements;
|
|
10
|
+
/**
|
|
11
|
+
* Creates a basic agent model requirements with just the agent name
|
|
12
|
+
* This is used when we have an agent name but no commitments
|
|
13
|
+
*
|
|
14
|
+
* @public exported from `@promptbook/core`
|
|
15
|
+
*/
|
|
16
|
+
export declare function createBasicAgentModelRequirements(agentName: string | null): AgentModelRequirements;
|
|
17
|
+
/**
|
|
18
|
+
* TODO: !!!! Deduplicate model requirements
|
|
19
|
+
*/
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { TODO_any } from "../../../_packages/types.index";
|
|
2
|
+
/**
|
|
3
|
+
* Model requirements for an agent
|
|
4
|
+
*
|
|
5
|
+
* This is like "compiled" version of agent source
|
|
6
|
+
*/
|
|
7
|
+
export interface AgentModelRequirements {
|
|
8
|
+
/**
|
|
9
|
+
* The system message that defines the agent's behavior and personality
|
|
10
|
+
*/
|
|
11
|
+
readonly systemMessage: string;
|
|
12
|
+
/**
|
|
13
|
+
* The model name to use for this agent
|
|
14
|
+
*/
|
|
15
|
+
readonly modelName: string;
|
|
16
|
+
/**
|
|
17
|
+
* Optional list of MCP servers that the agent can connect to
|
|
18
|
+
*/
|
|
19
|
+
readonly mcpServers?: string[];
|
|
20
|
+
/**
|
|
21
|
+
* Temperature for the agent's responses, controlling randomness
|
|
22
|
+
*/
|
|
23
|
+
readonly temperature?: number;
|
|
24
|
+
/**
|
|
25
|
+
* Top-p sampling value for the agent's responses
|
|
26
|
+
*/
|
|
27
|
+
readonly topP?: number;
|
|
28
|
+
/**
|
|
29
|
+
* Top-k sampling value for the agent's responses
|
|
30
|
+
*/
|
|
31
|
+
readonly topK?: number;
|
|
32
|
+
/**
|
|
33
|
+
* Arbitrary metadata storage for commitments
|
|
34
|
+
* Each commitment can store its own data here
|
|
35
|
+
*/
|
|
36
|
+
readonly metadata?: Record<string, TODO_any>;
|
|
37
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import type { ParsedCommitment } from './ParsedCommitment';
|
|
2
|
+
/**
|
|
3
|
+
* Result of parsing agent source for commitments
|
|
4
|
+
*/
|
|
5
|
+
export interface AgentSourceParseResult {
|
|
6
|
+
/**
|
|
7
|
+
* The agent name (first line)
|
|
8
|
+
*/
|
|
9
|
+
agentName: string | null;
|
|
10
|
+
/**
|
|
11
|
+
* All parsed commitments
|
|
12
|
+
*/
|
|
13
|
+
commitments: ParsedCommitment[];
|
|
14
|
+
/**
|
|
15
|
+
* Lines that are not commitments (for system message)
|
|
16
|
+
*/
|
|
17
|
+
nonCommitmentLines: string[];
|
|
18
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { BookCommitment } from '../_base/BookCommitment';
|
|
2
|
+
/**
|
|
3
|
+
* Parsed commitment line from agent source
|
|
4
|
+
*/
|
|
5
|
+
export interface ParsedCommitment {
|
|
6
|
+
/**
|
|
7
|
+
* The commitment type (e.g., 'PERSONA', 'KNOWLEDGE')
|
|
8
|
+
*/
|
|
9
|
+
type: BookCommitment;
|
|
10
|
+
/**
|
|
11
|
+
* The content part of the commitment
|
|
12
|
+
*/
|
|
13
|
+
content: string;
|
|
14
|
+
/**
|
|
15
|
+
* The original line from the agent source
|
|
16
|
+
*/
|
|
17
|
+
originalLine: string;
|
|
18
|
+
/**
|
|
19
|
+
* Line number in the agent source (1-based)
|
|
20
|
+
*/
|
|
21
|
+
lineNumber: number;
|
|
22
|
+
}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import type { string_book } from '../../agent-source/string_book';
|
|
2
|
+
import type { AgentModelRequirements } from './AgentModelRequirements';
|
|
3
|
+
/**
|
|
4
|
+
* Creates model requirements for an agent based on its source
|
|
5
|
+
* Results are cached to improve performance for repeated calls with the same agentSource and modelName
|
|
6
|
+
*
|
|
7
|
+
* There are 2 similar functions:
|
|
8
|
+
* - `parseAgentSource` which is a lightweight parser for agent source, it parses basic information and its purpose is to be quick and synchronous. The commitments there are hardcoded.
|
|
9
|
+
* - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronously.
|
|
10
|
+
*
|
|
11
|
+
* @public exported from `@promptbook/core`
|
|
12
|
+
*/
|
|
13
|
+
export declare function createAgentModelRequirements(agentSource: string_book, modelName?: string): Promise<AgentModelRequirements>;
|
|
14
|
+
/**
|
|
15
|
+
* Clears the cache for createAgentModelRequirements
|
|
16
|
+
* Useful when agent sources are updated and cached results should be invalidated
|
|
17
|
+
*
|
|
18
|
+
* @private
|
|
19
|
+
*/
|
|
20
|
+
export declare function clearAgentModelRequirementsCache(): void;
|
|
21
|
+
/**
|
|
22
|
+
* Removes cache entries for a specific agent source (all model variants)
|
|
23
|
+
* @param agentSource The agent source to remove from cache
|
|
24
|
+
* @private
|
|
25
|
+
*/
|
|
26
|
+
export declare function invalidateAgentModelRequirementsCache(agentSource: string_book): void;
|
|
27
|
+
/**
|
|
28
|
+
* Gets the current cache size (for debugging/monitoring)
|
|
29
|
+
*
|
|
30
|
+
* @private
|
|
31
|
+
*/
|
|
32
|
+
export declare function getAgentModelRequirementsCacheSize(): number;
|
|
33
|
+
/**
|
|
34
|
+
* Extracts MCP servers from agent source
|
|
35
|
+
*
|
|
36
|
+
* @param agentSource The agent source string that may contain MCP lines
|
|
37
|
+
* @returns Array of MCP server identifiers
|
|
38
|
+
*
|
|
39
|
+
* @private TODO: [🧠] Maybe should be public
|
|
40
|
+
*/
|
|
41
|
+
export declare function extractMcpServers(agentSource: string_book): string[];
|
|
42
|
+
/**
|
|
43
|
+
* Creates a system message for an agent based on its source
|
|
44
|
+
* @deprecated Use createAgentModelRequirements instead
|
|
45
|
+
* @private
|
|
46
|
+
*/
|
|
47
|
+
export declare function createAgentSystemMessage(agentSource: string_book): Promise<string>;
|
|
48
|
+
/**
|
|
49
|
+
* Extracts the agent name from the first line of the agent source
|
|
50
|
+
* @deprecated Use parseAgentSource instead
|
|
51
|
+
* @private
|
|
52
|
+
*/
|
|
53
|
+
export declare function extractAgentName(agentSource: string_book): string;
|
|
54
|
+
/**
|
|
55
|
+
* Extracts the profile image URL from agent source or returns gravatar fallback
|
|
56
|
+
* @param agentSource The agent source string that may contain META IMAGE line
|
|
57
|
+
* @returns Profile image URL (from source or gravatar fallback)
|
|
58
|
+
* @deprecated Use parseAgentSource instead
|
|
59
|
+
* @private
|
|
60
|
+
*/
|
|
61
|
+
export declare function extractAgentProfileImage(agentSource: string_book): string;
|
package/esm/typings/src/book-2.0/commitments/_misc/createAgentModelRequirementsWithCommitments.d.ts
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import type { string_book } from '../../agent-source/string_book';
|
|
2
|
+
import type { AgentModelRequirements } from './AgentModelRequirements';
|
|
3
|
+
/**
|
|
4
|
+
* Creates agent model requirements using the new commitment system
|
|
5
|
+
* This function uses a reduce-like pattern where each commitment applies its changes
|
|
6
|
+
* to build the final requirements starting from a basic empty model
|
|
7
|
+
*
|
|
8
|
+
* @private
|
|
9
|
+
*/
|
|
10
|
+
export declare function createAgentModelRequirementsWithCommitments(agentSource: string_book, modelName?: string): Promise<AgentModelRequirements>;
|
|
11
|
+
/**
|
|
12
|
+
* Cached version of createAgentModelRequirementsWithCommitments
|
|
13
|
+
* This maintains the same caching behavior as the original function
|
|
14
|
+
*
|
|
15
|
+
* @private
|
|
16
|
+
*/
|
|
17
|
+
export declare function createAgentModelRequirementsWithCommitmentsCached(agentSource: string_book, modelName?: string): Promise<AgentModelRequirements>;
|
|
18
|
+
/**
|
|
19
|
+
* Clears the cache for createAgentModelRequirementsWithCommitments
|
|
20
|
+
*
|
|
21
|
+
* @private
|
|
22
|
+
*/
|
|
23
|
+
export declare function clearAgentModelRequirementsWithCommitmentsCache(): void;
|
|
24
|
+
/**
|
|
25
|
+
* Removes cache entries for a specific agent source
|
|
26
|
+
*
|
|
27
|
+
* @private
|
|
28
|
+
*/
|
|
29
|
+
export declare function invalidateAgentModelRequirementsWithCommitmentsCache(agentSource: string_book): void;
|
|
30
|
+
/**
|
|
31
|
+
* Gets the current cache size
|
|
32
|
+
*
|
|
33
|
+
* @private
|
|
34
|
+
*/
|
|
35
|
+
export declare function getAgentModelRequirementsWithCommitmentsCacheSize(): number;
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { BookCommitment } from '../_base/BookCommitment';
|
|
2
|
+
/**
|
|
3
|
+
* Generates a regex pattern to match a specific commitment
|
|
4
|
+
*
|
|
5
|
+
* Note: It always creates new Regex object
|
|
6
|
+
* Note: Uses word boundaries to ensure only full words are matched (e.g., "PERSONA" matches but "PERSONALITY" does not)
|
|
7
|
+
*
|
|
8
|
+
* @private
|
|
9
|
+
*/
|
|
10
|
+
export declare function createCommitmentRegex(commitment: BookCommitment): RegExp;
|
|
11
|
+
/**
|
|
12
|
+
* Generates a regex pattern to match a specific commitment type
|
|
13
|
+
*
|
|
14
|
+
* Note: It just matches the type part of the commitment
|
|
15
|
+
* Note: It always creates new Regex object
|
|
16
|
+
* Note: Uses word boundaries to ensure only full words are matched (e.g., "PERSONA" matches but "PERSONALITY" does not)
|
|
17
|
+
*
|
|
18
|
+
* @private
|
|
19
|
+
*/
|
|
20
|
+
export declare function createCommitmentTypeRegex(commitment: BookCommitment): RegExp;
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { AgentBasicInformation } from '../../agent-source/parseAgentSource';
|
|
2
|
+
import type { string_book } from '../../agent-source/string_book';
|
|
3
|
+
import type { AgentSourceParseResult } from './AgentSourceParseResult';
|
|
4
|
+
/**
|
|
5
|
+
* Parses agent source using the new commitment system with multiline support
|
|
6
|
+
* This function replaces the hardcoded commitment parsing in the original parseAgentSource
|
|
7
|
+
*
|
|
8
|
+
* @private
|
|
9
|
+
*/
|
|
10
|
+
export declare function parseAgentSourceWithCommitments(agentSource: string_book): AgentSourceParseResult;
|
|
11
|
+
/**
|
|
12
|
+
* Extracts basic information from agent source using the new commitment system
|
|
13
|
+
* This maintains compatibility with the original parseAgentSource interface
|
|
14
|
+
*
|
|
15
|
+
* @private
|
|
16
|
+
*/
|
|
17
|
+
export declare function parseAgentSourceBasicInfo(agentSource: string_book): AgentBasicInformation;
|
|
18
|
+
/**
|
|
19
|
+
* Extracts META LINK commitments from agent source
|
|
20
|
+
* Returns an array of all META LINK URLs found in the agent source
|
|
21
|
+
*
|
|
22
|
+
* @private
|
|
23
|
+
*/
|
|
24
|
+
export declare function extractMetaLinks(agentSource: string_book): string[];
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Removes comment lines (lines starting with #) from a system message
|
|
3
|
+
* This is used to clean up the final system message before sending it to the AI model
|
|
4
|
+
* while preserving the original content with comments in metadata
|
|
5
|
+
*
|
|
6
|
+
* @param systemMessage The system message that may contain comment lines
|
|
7
|
+
* @returns The system message with comment lines removed
|
|
8
|
+
*
|
|
9
|
+
* @private - TODO: [🧠] Maybe should be public?
|
|
10
|
+
*/
|
|
11
|
+
export declare function removeCommentsFromSystemMessage(systemMessage: string): string;
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import type { BookCommitment } from './_base/BookCommitment';
|
|
2
|
+
import type { CommitmentDefinition } from './_base/CommitmentDefinition';
|
|
3
|
+
import { ActionCommitmentDefinition } from './ACTION/ACTION';
|
|
4
|
+
import { FormatCommitmentDefinition } from './FORMAT/FORMAT';
|
|
5
|
+
import { KnowledgeCommitmentDefinition } from './KNOWLEDGE/KNOWLEDGE';
|
|
6
|
+
import { MetaImageCommitmentDefinition } from './META_IMAGE/META_IMAGE';
|
|
7
|
+
import { MetaLinkCommitmentDefinition } from './META_LINK/META_LINK';
|
|
8
|
+
import { ModelCommitmentDefinition } from './MODEL/MODEL';
|
|
9
|
+
import { NoteCommitmentDefinition } from './NOTE/NOTE';
|
|
10
|
+
import { PersonaCommitmentDefinition } from './PERSONA/PERSONA';
|
|
11
|
+
import { RuleCommitmentDefinition } from './RULE/RULE';
|
|
12
|
+
import { SampleCommitmentDefinition } from './SAMPLE/SAMPLE';
|
|
13
|
+
import { StyleCommitmentDefinition } from './STYLE/STYLE';
|
|
14
|
+
import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplementedCommitmentDefinition';
|
|
15
|
+
/**
|
|
16
|
+
* Registry of all available commitment definitions
|
|
17
|
+
* This array contains instances of all commitment definitions
|
|
18
|
+
* This is the single source of truth for all commitments in the system
|
|
19
|
+
*
|
|
20
|
+
* @private Use functions to access commitments instead of this array directly
|
|
21
|
+
*/
|
|
22
|
+
export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, MetaImageCommitmentDefinition, MetaLinkCommitmentDefinition, NoteCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"SCENARIO">, NotYetImplementedCommitmentDefinition<"SCENARIOS">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"GOAL">, NotYetImplementedCommitmentDefinition<"GOALS">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
|
|
23
|
+
/**
|
|
24
|
+
* Gets a commitment definition by its type
|
|
25
|
+
* @param type The commitment type to look up
|
|
26
|
+
* @returns The commitment definition or null if not found
|
|
27
|
+
*
|
|
28
|
+
* @public exported from `@promptbook/core`
|
|
29
|
+
*/
|
|
30
|
+
export declare function getCommitmentDefinition(type: BookCommitment): CommitmentDefinition | null;
|
|
31
|
+
/**
|
|
32
|
+
* Gets all available commitment definitions
|
|
33
|
+
* @returns Array of all commitment definitions
|
|
34
|
+
*
|
|
35
|
+
* @public exported from `@promptbook/core`
|
|
36
|
+
*/
|
|
37
|
+
export declare function getAllCommitmentDefinitions(): ReadonlyArray<CommitmentDefinition>;
|
|
38
|
+
/**
|
|
39
|
+
* Gets all available commitment types
|
|
40
|
+
* @returns Array of all commitment types
|
|
41
|
+
*
|
|
42
|
+
* @public exported from `@promptbook/core`
|
|
43
|
+
*/
|
|
44
|
+
export declare function getAllCommitmentTypes(): ReadonlyArray<BookCommitment>;
|
|
45
|
+
/**
|
|
46
|
+
* Checks if a commitment type is supported
|
|
47
|
+
* @param type The commitment type to check
|
|
48
|
+
* @returns True if the commitment type is supported
|
|
49
|
+
*
|
|
50
|
+
* @public exported from `@promptbook/core`
|
|
51
|
+
*/
|
|
52
|
+
export declare function isCommitmentSupported(type: BookCommitment): boolean;
|
|
53
|
+
/**
|
|
54
|
+
* TODO: !!!! Maybe create through standardized $register
|
|
55
|
+
* Note: [💞] Ignore a discrepancy between file name and entity name
|
|
56
|
+
*/
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import type { string_url_image } from '../../types/typeAliases';
|
|
2
|
+
/**
|
|
3
|
+
* Extracts profile image URL from agent definition text and returns cleaned system message
|
|
4
|
+
* @param systemMessage The original system message that may contain META IMAGE line
|
|
5
|
+
* @returns Object with profileImageUrl (if found) and cleanedSystemMessage (without META IMAGE line)
|
|
6
|
+
*
|
|
7
|
+
* @private - TODO: [🧠] Maybe should be public?
|
|
8
|
+
*/
|
|
9
|
+
export declare function extractProfileImageFromSystemMessage(systemMessage: string): {
|
|
10
|
+
profileImageUrl?: string_url_image;
|
|
11
|
+
cleanedSystemMessage: string;
|
|
12
|
+
};
|
|
13
|
+
/**
|
|
14
|
+
* Extracts persona, examples, and profile image from agent definition text
|
|
15
|
+
* @param systemMessage The original system message that may contain PERSONA, EXAMPLE, and META IMAGE lines
|
|
16
|
+
* @returns Object with extracted information and cleaned system message
|
|
17
|
+
*
|
|
18
|
+
* @private - TODO: [🧠] Maybe should be public?
|
|
19
|
+
*/
|
|
20
|
+
export declare function extractAgentMetadata(systemMessage: string): {
|
|
21
|
+
persona?: {
|
|
22
|
+
name: string;
|
|
23
|
+
description?: string;
|
|
24
|
+
};
|
|
25
|
+
examples: string[];
|
|
26
|
+
profileImageUrl?: string_url_image;
|
|
27
|
+
cleanedSystemMessage: string;
|
|
28
|
+
};
|
|
29
|
+
/**
|
|
30
|
+
* Generates a gravatar URL based on agent name for fallback avatar
|
|
31
|
+
* @param name The agent name to generate avatar for
|
|
32
|
+
* @returns Gravatar URL
|
|
33
|
+
*
|
|
34
|
+
* @private - TODO: [🧠] Maybe should be public?
|
|
35
|
+
*/
|
|
36
|
+
export declare function generateGravatarUrl(name?: string | null): string;
|
|
37
|
+
/**
|
|
38
|
+
* Note: [💞] Ignore a discrepancy between file name and entity name
|
|
39
|
+
*/
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import type { string_book } from '../../book-2.0/agent-source/string_book';
|
|
2
|
+
export interface BookEditorProps {
|
|
3
|
+
/**
|
|
4
|
+
* Additional CSS classes to apply to the editor container.
|
|
5
|
+
*/
|
|
6
|
+
readonly className?: string;
|
|
7
|
+
/**
|
|
8
|
+
* CSS className for a font (e.g. from next/font) to style the editor text.
|
|
9
|
+
* If omitted, defaults to system serif fonts.
|
|
10
|
+
*/
|
|
11
|
+
readonly fontClassName?: string;
|
|
12
|
+
/**
|
|
13
|
+
* The book which is being edited.
|
|
14
|
+
*/
|
|
15
|
+
readonly value?: string_book;
|
|
16
|
+
/**
|
|
17
|
+
* Callback function to handle changes in the book content.
|
|
18
|
+
*/
|
|
19
|
+
onChange?(value: string_book): void;
|
|
20
|
+
/**
|
|
21
|
+
* If true, logs verbose debug info to the console and shows additional visual cues
|
|
22
|
+
*/
|
|
23
|
+
readonly isVerbose?: boolean;
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* Renders a book editor
|
|
27
|
+
*
|
|
28
|
+
* @public exported from `@promptbook/components`
|
|
29
|
+
*/
|
|
30
|
+
export declare function BookEditor(props: BookEditorProps): import("react/jsx-runtime").JSX.Element;
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { string_css_class } from '../../../types/typeAliases';
|
|
2
|
+
/**
|
|
3
|
+
* Utility function for joining multiple truthy class names into one string
|
|
4
|
+
*
|
|
5
|
+
* @private within the `@promptbook/components`
|
|
6
|
+
*/
|
|
7
|
+
export declare function classNames(...classes: Array<string_css_class | undefined | false | null>): string_css_class;
|
|
@@ -281,6 +281,12 @@ export declare function SET_IS_VERBOSE(isVerbose: boolean): void;
|
|
|
281
281
|
* @public exported from `@promptbook/core`
|
|
282
282
|
*/
|
|
283
283
|
export declare const DEFAULT_IS_AUTO_INSTALLED = false;
|
|
284
|
+
/**
|
|
285
|
+
* Default simulated duration for a task in milliseconds (used for progress reporting)
|
|
286
|
+
*
|
|
287
|
+
* @public exported from `@promptbook/core`
|
|
288
|
+
*/
|
|
289
|
+
export declare const DEFAULT_TASK_SIMULATED_DURATION_MS: number;
|
|
284
290
|
/**
|
|
285
291
|
* Function name for generated function via `ptbk make` to get the pipeline collection
|
|
286
292
|
*
|
|
@@ -40,6 +40,10 @@ export type AvailableModel = {
|
|
|
40
40
|
readonly prompt: number_usd;
|
|
41
41
|
readonly output: number_usd;
|
|
42
42
|
};
|
|
43
|
+
/**
|
|
44
|
+
* If the model is deprecated, it should not be used for new tasks
|
|
45
|
+
*/
|
|
46
|
+
readonly isDeprecated?: boolean;
|
|
43
47
|
};
|
|
44
48
|
/**
|
|
45
49
|
* TODO: [🧠] Maybe rename to something else - like `ModelInformation` or `ModelMetadata`
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import type { Observable } from 'rxjs';
|
|
2
2
|
import { PartialDeep } from 'type-fest';
|
|
3
|
+
import type { number_percent } from '../types/typeAliases';
|
|
3
4
|
import type { task_id } from '../types/typeAliases';
|
|
4
5
|
import type { string_SCREAMING_CASE } from '../utils/normalization/normalizeTo_SCREAMING_CASE';
|
|
5
6
|
import type { string_promptbook_version } from '../version';
|
|
@@ -28,6 +29,19 @@ type CreateTaskOptions<TTaskResult extends AbstractTaskResult> = {
|
|
|
28
29
|
*/
|
|
29
30
|
readonly title?: AbstractTask<TTaskResult>['title'];
|
|
30
31
|
}) => void): Promise<TTaskResult>;
|
|
32
|
+
/**
|
|
33
|
+
* Optional callback to provide custom tldr information
|
|
34
|
+
* @param createdAt When the task was created
|
|
35
|
+
* @param status Current task status
|
|
36
|
+
* @param currentValue Current partial result
|
|
37
|
+
* @param errors Current errors
|
|
38
|
+
* @param warnings Current warnings
|
|
39
|
+
* @returns Custom tldr information
|
|
40
|
+
*/
|
|
41
|
+
tldrProvider?(createdAt: Date, status: task_status, currentValue: PartialDeep<TTaskResult>, errors: Array<Error>, warnings: Array<Error>): {
|
|
42
|
+
readonly percent: number_percent;
|
|
43
|
+
readonly message: string;
|
|
44
|
+
};
|
|
31
45
|
};
|
|
32
46
|
/**
|
|
33
47
|
* Helper to create a new task
|
|
@@ -80,6 +94,19 @@ export type AbstractTask<TTaskResult extends AbstractTaskResult> = {
|
|
|
80
94
|
* Status of the task
|
|
81
95
|
*/
|
|
82
96
|
readonly status: task_status;
|
|
97
|
+
/**
|
|
98
|
+
* Short summary of the task status for quick overview in the UI
|
|
99
|
+
*/
|
|
100
|
+
readonly tldr: {
|
|
101
|
+
/**
|
|
102
|
+
* Progress in percentage from 0 to 1 (100%) that can be used to display a progress bar
|
|
103
|
+
*/
|
|
104
|
+
readonly percent: number_percent;
|
|
105
|
+
/**
|
|
106
|
+
* Short summary message of the task status that can be displayed in the UI
|
|
107
|
+
*/
|
|
108
|
+
readonly message: string;
|
|
109
|
+
};
|
|
83
110
|
/**
|
|
84
111
|
* Date when the task was created
|
|
85
112
|
*/
|
|
@@ -1,10 +1,11 @@
|
|
|
1
|
-
import type { ReadonlyDeep, WritableDeep } from 'type-fest';
|
|
1
|
+
import type { PartialDeep, Promisable, ReadonlyDeep, WritableDeep } from 'type-fest';
|
|
2
2
|
import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
|
|
3
3
|
import type { TaskJson } from '../../pipeline/PipelineJson/TaskJson';
|
|
4
4
|
import type { Parameters } from '../../types/typeAliases';
|
|
5
5
|
import type { string_parameter_name } from '../../types/typeAliases';
|
|
6
6
|
import type { TODO_string } from '../../utils/organization/TODO_string';
|
|
7
7
|
import type { ExecutionReportJson } from '../execution-report/ExecutionReportJson';
|
|
8
|
+
import type { PipelineExecutorResult } from '../PipelineExecutorResult';
|
|
8
9
|
import type { CreatePipelineExecutorOptions } from './00-CreatePipelineExecutorOptions';
|
|
9
10
|
/**
|
|
10
11
|
* Options for executing attempts of a pipeline task, including configuration for jokers, priority,
|
|
@@ -46,6 +47,10 @@ export type ExecuteAttemptsOptions = Required<Omit<CreatePipelineExecutorOptions
|
|
|
46
47
|
* The pipeline structure prepared for execution, as a deeply immutable PipelineJson object.
|
|
47
48
|
*/
|
|
48
49
|
readonly preparedPipeline: ReadonlyDeep<PipelineJson>;
|
|
50
|
+
/**
|
|
51
|
+
* Callback invoked with partial results as the execution progresses.
|
|
52
|
+
*/
|
|
53
|
+
onProgress(newOngoingResult: PartialDeep<PipelineExecutorResult>): Promisable<void>;
|
|
49
54
|
/**
|
|
50
55
|
* The execution report object, which is updated during execution.
|
|
51
56
|
*/
|
|
@@ -2,7 +2,6 @@ import Anthropic from '@anthropic-ai/sdk';
|
|
|
2
2
|
import type { AvailableModel } from '../../execution/AvailableModel';
|
|
3
3
|
import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
|
|
4
4
|
import type { ChatPromptResult } from '../../execution/PromptResult';
|
|
5
|
-
import type { CompletionPromptResult } from '../../execution/PromptResult';
|
|
6
5
|
import type { Prompt } from '../../types/Prompt';
|
|
7
6
|
import type { string_markdown } from '../../types/typeAliases';
|
|
8
7
|
import type { string_markdown_text } from '../../types/typeAliases';
|
|
@@ -42,10 +41,6 @@ export declare class AnthropicClaudeExecutionTools implements LlmExecutionTools
|
|
|
42
41
|
* Calls Anthropic Claude API to use a chat model.
|
|
43
42
|
*/
|
|
44
43
|
callChatModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements'>): Promise<ChatPromptResult>;
|
|
45
|
-
/**
|
|
46
|
-
* Calls Anthropic Claude API to use a completion model.
|
|
47
|
-
*/
|
|
48
|
-
callCompletionModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements'>): Promise<CompletionPromptResult>;
|
|
49
44
|
/**
|
|
50
45
|
* Get the model that should be used as default
|
|
51
46
|
*/
|
|
@@ -3,7 +3,7 @@ import type { number_usd } from '../../types/typeAliases';
|
|
|
3
3
|
/**
|
|
4
4
|
* List of available Anthropic Claude models with pricing
|
|
5
5
|
*
|
|
6
|
-
* Note:
|
|
6
|
+
* Note: Synced with official API docs at 2025-08-20
|
|
7
7
|
*
|
|
8
8
|
* @see https://docs.anthropic.com/en/docs/models-overview
|
|
9
9
|
* @public exported from `@promptbook/anthropic-claude`
|