@promptbook/types 0.112.0-56 → 0.112.0-57

package/esm/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments/ParsedAgentSourceWithCommitments.d.ts

@@ -0,0 +1,7 @@
+import { parseAgentSourceWithCommitments } from '../parseAgentSourceWithCommitments';
+/**
+ * Parsed agent source data produced by `parseAgentSourceWithCommitments`.
+ *
+ * @private internal type of `createAgentModelRequirementsWithCommitments`
+ */
+export type ParsedAgentSourceWithCommitments = ReturnType<typeof parseAgentSourceWithCommitments>;

package/esm/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments/applyCommitmentsToAgentModelRequirements.d.ts

@@ -0,0 +1,14 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+import type { AgentModelRequirements } from '../AgentModelRequirements';
+import type { CreateAgentModelRequirementsOptions } from '../CreateAgentModelRequirementsOptions';
+/**
+ * Applies parsed commitments one by one while keeping the per-commitment steps focused and easy to follow.
+ *
+ * @param requirements - Current requirements snapshot.
+ * @param commitments - Commitments already filtered for DELETE-like invalidations.
+ * @param options - Optional reference and teammate resolvers.
+ * @returns Requirements after all applicable commitments are processed.
+ *
+ * @private function of `createAgentModelRequirementsWithCommitments`
+ */
+export declare function applyCommitmentsToAgentModelRequirements(requirements: AgentModelRequirements, commitments: ReadonlyArray<ParsedCommitment>, options?: CreateAgentModelRequirementsOptions): Promise<AgentModelRequirements>;

package/esm/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments/augmentAgentModelRequirementsFromSource.d.ts

@@ -0,0 +1,14 @@
+import type { AgentModelRequirements } from '../AgentModelRequirements';
+import type { string_book } from '../string_book';
+import type { ParsedAgentSourceWithCommitments } from './ParsedAgentSourceWithCommitments';
+/**
+ * Adds source-derived sections after commitments have been applied.
+ *
+ * @param requirements - Requirements after commitment application and USE aggregation.
+ * @param parseResult - Parsed source used to recover non-commitment prose and examples.
+ * @param agentSource - Original source used to recover MCP server declarations.
+ * @returns Requirements with source-derived sections appended.
+ *
+ * @private function of `createAgentModelRequirementsWithCommitments`
+ */
+export declare function augmentAgentModelRequirementsFromSource(requirements: AgentModelRequirements, parseResult: ParsedAgentSourceWithCommitments, agentSource: string_book): Promise<AgentModelRequirements>;

package/esm/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments/filterCommitmentsForAgentModelRequirements.d.ts

@@ -0,0 +1,10 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+/**
+ * Applies the commitment filtering rules used before commitment definitions are executed.
+ *
+ * @param commitments - Parsed commitments in original source order.
+ * @returns Commitments after DELETE-like invalidation and overwritten-goal filtering.
+ *
+ * @private function of `createAgentModelRequirementsWithCommitments`
+ */
+export declare function filterCommitmentsForAgentModelRequirements(commitments: ReadonlyArray<ParsedCommitment>): ParsedCommitment[];

package/esm/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments/materializeInlineKnowledgeSources.d.ts

@@ -0,0 +1,12 @@
+import type { InlineKnowledgeSourceUploader } from '../../../utils/knowledge/inlineKnowledgeSource';
+import type { AgentModelRequirements } from '../AgentModelRequirements';
+/**
+ * Converts staged inline knowledge files into the final knowledge source URLs stored on requirements.
+ *
+ * @param requirements - Current requirements snapshot.
+ * @param uploader - Optional uploader for inline knowledge files.
+ * @returns Requirements with inline knowledge converted into upload URLs or data URLs.
+ *
+ * @private function of `createAgentModelRequirementsWithCommitments`
+ */
+export declare function materializeInlineKnowledgeSources(requirements: AgentModelRequirements, uploader?: InlineKnowledgeSourceUploader): Promise<AgentModelRequirements>;

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

@@ -0,0 +1,10 @@
+import type { ParsedAgentProfile } from './ParsedAgentProfile';
+/**
+ * Mutable commitment-processing state used while collecting basic profile information.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export type ParseAgentSourceState = ParsedAgentProfile & {
+    pendingUserMessage: string | null;
+    knownKnowledgeSourceUrls: Set<string>;
+};

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

@@ -0,0 +1,7 @@
+import type { AgentBasicInformation } from '../AgentBasicInformation';
+/**
+ * Parsed agent profile fields accumulated from commitments.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export type ParsedAgentProfile = Pick<AgentBasicInformation, 'meta' | 'links' | 'capabilities' | 'samples' | 'knowledgeSources'>;

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

@@ -0,0 +1,8 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+import type { ParseAgentSourceState } from './ParseAgentSourceState';
+/**
+ * Applies META-style commitments that mutate parsed profile metadata.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function applyMetaCommitment(state: ParseAgentSourceState, commitment: ParsedCommitment): void;

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

@@ -0,0 +1,8 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+import type { ParseAgentSourceState } from './ParseAgentSourceState';
+/**
+ * Updates sample-conversation state for communication commitments.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function consumeConversationSampleCommitment(state: ParseAgentSourceState, commitment: ParsedCommitment): boolean;

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

@@ -0,0 +1,9 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+import type { AgentCapability } from '../AgentBasicInformation';
+import type { ParseAgentSourceState } from './ParseAgentSourceState';
+/**
+ * Creates the visible capabilities produced by one parsed commitment.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function createCapabilitiesFromCommitment(state: ParseAgentSourceState, commitment: ParsedCommitment): AgentCapability[];

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

@@ -0,0 +1,7 @@
+import type { AgentBasicInformation } from '../AgentBasicInformation';
+/**
+ * Ensures the parsed profile always exposes a fullname value.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function ensureMetaFullname(meta: AgentBasicInformation['meta'], fallbackFullname: string): void;

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

@@ -0,0 +1,8 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+/**
+ * Resolves the public agent profile text from the last GOAL/GOALS commitment,
+ * falling back to the deprecated PERSONA/PERSONAE commitments when no goal exists.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function extractAgentProfileText(commitments: ReadonlyArray<ParsedCommitment>): string | null;

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

@@ -0,0 +1,7 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+/**
+ * Resolves the last INITIAL MESSAGE commitment, which is the public initial-message value.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function extractInitialMessage(commitments: ReadonlyArray<ParsedCommitment>): string | null;

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

@@ -0,0 +1,8 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+import type { ParsedAgentProfile } from './ParsedAgentProfile';
+/**
+ * Collects capability, sample, meta, link, and knowledge-source data from commitments.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function extractParsedAgentProfile(commitments: ReadonlyArray<ParsedCommitment>): ParsedAgentProfile;

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/types",
-    "version": "0.112.0-56",
+    "version": "0.112.0-57",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,
@@ -96,6 +96,6 @@
     "types": "./esm/src/_packages/types.index.d.ts",
     "typings": "./esm/src/_packages/types.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.112.0-56"
+        "@promptbook/core": "0.112.0-57"
     }
 }

package/umd/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments/ParsedAgentSourceWithCommitments.d.ts

@@ -0,0 +1,7 @@
+import { parseAgentSourceWithCommitments } from '../parseAgentSourceWithCommitments';
+/**
+ * Parsed agent source data produced by `parseAgentSourceWithCommitments`.
+ *
+ * @private internal type of `createAgentModelRequirementsWithCommitments`
+ */
+export type ParsedAgentSourceWithCommitments = ReturnType<typeof parseAgentSourceWithCommitments>;

package/umd/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments/applyCommitmentsToAgentModelRequirements.d.ts

@@ -0,0 +1,14 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+import type { AgentModelRequirements } from '../AgentModelRequirements';
+import type { CreateAgentModelRequirementsOptions } from '../CreateAgentModelRequirementsOptions';
+/**
+ * Applies parsed commitments one by one while keeping the per-commitment steps focused and easy to follow.
+ *
+ * @param requirements - Current requirements snapshot.
+ * @param commitments - Commitments already filtered for DELETE-like invalidations.
+ * @param options - Optional reference and teammate resolvers.
+ * @returns Requirements after all applicable commitments are processed.
+ *
+ * @private function of `createAgentModelRequirementsWithCommitments`
+ */
+export declare function applyCommitmentsToAgentModelRequirements(requirements: AgentModelRequirements, commitments: ReadonlyArray<ParsedCommitment>, options?: CreateAgentModelRequirementsOptions): Promise<AgentModelRequirements>;

package/umd/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments/augmentAgentModelRequirementsFromSource.d.ts

@@ -0,0 +1,14 @@
+import type { AgentModelRequirements } from '../AgentModelRequirements';
+import type { string_book } from '../string_book';
+import type { ParsedAgentSourceWithCommitments } from './ParsedAgentSourceWithCommitments';
+/**
+ * Adds source-derived sections after commitments have been applied.
+ *
+ * @param requirements - Requirements after commitment application and USE aggregation.
+ * @param parseResult - Parsed source used to recover non-commitment prose and examples.
+ * @param agentSource - Original source used to recover MCP server declarations.
+ * @returns Requirements with source-derived sections appended.
+ *
+ * @private function of `createAgentModelRequirementsWithCommitments`
+ */
+export declare function augmentAgentModelRequirementsFromSource(requirements: AgentModelRequirements, parseResult: ParsedAgentSourceWithCommitments, agentSource: string_book): Promise<AgentModelRequirements>;

package/umd/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments/filterCommitmentsForAgentModelRequirements.d.ts

@@ -0,0 +1,10 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+/**
+ * Applies the commitment filtering rules used before commitment definitions are executed.
+ *
+ * @param commitments - Parsed commitments in original source order.
+ * @returns Commitments after DELETE-like invalidation and overwritten-goal filtering.
+ *
+ * @private function of `createAgentModelRequirementsWithCommitments`
+ */
+export declare function filterCommitmentsForAgentModelRequirements(commitments: ReadonlyArray<ParsedCommitment>): ParsedCommitment[];

package/umd/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments/materializeInlineKnowledgeSources.d.ts

@@ -0,0 +1,12 @@
+import type { InlineKnowledgeSourceUploader } from '../../../utils/knowledge/inlineKnowledgeSource';
+import type { AgentModelRequirements } from '../AgentModelRequirements';
+/**
+ * Converts staged inline knowledge files into the final knowledge source URLs stored on requirements.
+ *
+ * @param requirements - Current requirements snapshot.
+ * @param uploader - Optional uploader for inline knowledge files.
+ * @returns Requirements with inline knowledge converted into upload URLs or data URLs.
+ *
+ * @private function of `createAgentModelRequirementsWithCommitments`
+ */
+export declare function materializeInlineKnowledgeSources(requirements: AgentModelRequirements, uploader?: InlineKnowledgeSourceUploader): Promise<AgentModelRequirements>;

package/umd/src/book-2.0/agent-source/parseAgentSource/ParseAgentSourceState.d.ts

@@ -0,0 +1,10 @@
+import type { ParsedAgentProfile } from './ParsedAgentProfile';
+/**
+ * Mutable commitment-processing state used while collecting basic profile information.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export type ParseAgentSourceState = ParsedAgentProfile & {
+    pendingUserMessage: string | null;
+    knownKnowledgeSourceUrls: Set<string>;
+};

package/umd/src/book-2.0/agent-source/parseAgentSource/ParsedAgentProfile.d.ts

@@ -0,0 +1,7 @@
+import type { AgentBasicInformation } from '../AgentBasicInformation';
+/**
+ * Parsed agent profile fields accumulated from commitments.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export type ParsedAgentProfile = Pick<AgentBasicInformation, 'meta' | 'links' | 'capabilities' | 'samples' | 'knowledgeSources'>;

package/umd/src/book-2.0/agent-source/parseAgentSource/applyMetaCommitment.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+import type { ParseAgentSourceState } from './ParseAgentSourceState';
+/**
+ * Applies META-style commitments that mutate parsed profile metadata.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function applyMetaCommitment(state: ParseAgentSourceState, commitment: ParsedCommitment): void;

package/umd/src/book-2.0/agent-source/parseAgentSource/consumeConversationSampleCommitment.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+import type { ParseAgentSourceState } from './ParseAgentSourceState';
+/**
+ * Updates sample-conversation state for communication commitments.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function consumeConversationSampleCommitment(state: ParseAgentSourceState, commitment: ParsedCommitment): boolean;

package/umd/src/book-2.0/agent-source/parseAgentSource/createCapabilitiesFromCommitment.d.ts

@@ -0,0 +1,9 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+import type { AgentCapability } from '../AgentBasicInformation';
+import type { ParseAgentSourceState } from './ParseAgentSourceState';
+/**
+ * Creates the visible capabilities produced by one parsed commitment.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function createCapabilitiesFromCommitment(state: ParseAgentSourceState, commitment: ParsedCommitment): AgentCapability[];

package/umd/src/book-2.0/agent-source/parseAgentSource/ensureMetaFullname.d.ts

@@ -0,0 +1,7 @@
+import type { AgentBasicInformation } from '../AgentBasicInformation';
+/**
+ * Ensures the parsed profile always exposes a fullname value.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function ensureMetaFullname(meta: AgentBasicInformation['meta'], fallbackFullname: string): void;

package/umd/src/book-2.0/agent-source/parseAgentSource/extractAgentProfileText.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+/**
+ * Resolves the public agent profile text from the last GOAL/GOALS commitment,
+ * falling back to the deprecated PERSONA/PERSONAE commitments when no goal exists.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function extractAgentProfileText(commitments: ReadonlyArray<ParsedCommitment>): string | null;

package/umd/src/book-2.0/agent-source/parseAgentSource/extractInitialMessage.d.ts

@@ -0,0 +1,7 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+/**
+ * Resolves the last INITIAL MESSAGE commitment, which is the public initial-message value.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function extractInitialMessage(commitments: ReadonlyArray<ParsedCommitment>): string | null;

package/umd/src/book-2.0/agent-source/parseAgentSource/extractParsedAgentProfile.d.ts

@@ -0,0 +1,8 @@
+import type { ParsedCommitment } from '../../../commitments/_base/ParsedCommitment';
+import type { ParsedAgentProfile } from './ParsedAgentProfile';
+/**
+ * Collects capability, sample, meta, link, and knowledge-source data from commitments.
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function extractParsedAgentProfile(commitments: ReadonlyArray<ParsedCommitment>): ParsedAgentProfile;

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