@promptbook/markdown-utils 0.100.1 → 0.100.2

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

@@ -1,7 +1,7 @@
 import type { string_agent_name } from '../../types/typeAliases';
 import type { string_url_image } from '../../types/typeAliases';
 import type { string_book } from './string_book';
-export interface AgentBasicInformation {
+export type AgentBasicInformation = {
     /**
      * Name of the agent
      * This is the first line of the agent source
@@ -17,7 +17,7 @@ export interface AgentBasicInformation {
      * This is the line starting with "META IMAGE"
      */
     profileImageUrl: string_url_image;
-}
+};
 /**
  * Parses basic information from agent source
  *

package/esm/typings/src/book-2.0/commitments/_base/CommitmentDefinition.d.ts

@@ -6,7 +6,7 @@ import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
  * - Creating regex patterns for parsing
  * - Applying its effects to agent model requirements
  */
-export interface CommitmentDefinition {
+export type CommitmentDefinition = {
     /**
      * The type/name of this commitment (e.g., 'PERSONA', 'KNOWLEDGE', etc.)
      */
@@ -45,4 +45,4 @@ export interface CommitmentDefinition {
      * @returns Updated agent model requirements
      */
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
-}
+};

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

@@ -4,7 +4,7 @@ import type { TODO_any } from '../../../utils/organization/TODO_any';
  *
  * This is like "compiled" version of agent source
  */
-export interface AgentModelRequirements {
+export type AgentModelRequirements = {
     /**
      * The system message that defines the agent's behavior and personality
      */
@@ -34,4 +34,4 @@ export interface AgentModelRequirements {
      * Each commitment can store its own data here
      */
     readonly metadata?: Record<string, TODO_any>;
-}
+};

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

@@ -2,7 +2,7 @@ import type { ParsedCommitment } from './ParsedCommitment';
 /**
  * Result of parsing agent source for commitments
  */
-export interface AgentSourceParseResult {
+export type AgentSourceParseResult = {
     /**
      * The agent name (first line)
      */
@@ -15,4 +15,4 @@ export interface AgentSourceParseResult {
      * Lines that are not commitments (for system message)
      */
     nonCommitmentLines: string[];
-}
+};

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

@@ -2,7 +2,7 @@ import type { BookCommitment } from '../_base/BookCommitment';
 /**
  * Parsed commitment line from agent source
  */
-export interface ParsedCommitment {
+export type ParsedCommitment = {
     /**
      * The commitment type (e.g., 'PERSONA', 'KNOWLEDGE')
      */
@@ -19,4 +19,4 @@ export interface ParsedCommitment {
      * Line number in the agent source (1-based)
      */
     lineNumber: number;
-}
+};

package/esm/typings/src/execution/utils/validatePromptResult.d.ts

@@ -5,7 +5,7 @@ import type { string_postprocessing_function_name } from '../../types/typeAliase
 /**
  * Options for validating a prompt result
  */
-export interface ValidatePromptResultOptions {
+export type ValidatePromptResultOptions = {
     /**
      * The result string to validate
      */
@@ -23,11 +23,11 @@ export interface ValidatePromptResultOptions {
      * Note: This is for validation purposes only - postprocessing should be done before calling this function
      */
     postprocessingFunctionNames?: ReadonlyArray<string_postprocessing_function_name>;
-}
+};
 /**
  * Result of prompt result validation
  */
-export interface ValidatePromptResultResult {
+export type ValidatePromptResultResult = {
     /**
      * Whether the result is valid (passes all expectations and format checks)
      */
@@ -40,7 +40,7 @@ export interface ValidatePromptResultResult {
      * Error that occurred during validation, if any
      */
     error?: ExpectError;
-}
+};
 /**
  * Validates a prompt result against expectations and format requirements.
  * This function provides a common abstraction for result validation that can be used

package/esm/typings/src/utils/take/interfaces/ITakeChain.d.ts

@@ -6,7 +6,7 @@ import type { Takeable } from './Takeable';
  * @deprecated [🤡] Use some better functional library instead of `TakeChain`
  */
 export type WithTake<TValue extends Takeable> = TValue & ITakeChain<TValue>;
-export interface ITakeChain<TValue extends Takeable> {
+export type ITakeChain<TValue extends Takeable> = {
     readonly value: TValue;
     then<TResultValue extends Takeable>(callback: (value: TValue) => TResultValue): WithTake<TResultValue>;
-}
+};

package/esm/typings/src/utils/validators/filePath/isValidFilePath.d.ts

@@ -1,7 +1,7 @@
 import type { string_filename } from '../../../types/typeAliases';
 import type { really_unknown } from '../../organization/really_unknown';
 /**
- * Tests if given string is valid URL.
+ * Tests if given string is valid file path.
  *
  * Note: This does not check if the file exists only if the path is valid
  * @public exported from `@promptbook/utils`

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

package/esm/typings/src/wizard/wizard.d.ts

@@ -9,12 +9,12 @@ import type { string_pipeline_url } from '../types/typeAliases';
 /**
  * Options for wizard methods
  */
-interface WizardOptions {
+type WizardOptions = {
     /**
      * Whether to enable verbose logging
      */
     isVerbose?: boolean;
-}
+};
 /**
  * Wizard for simple usage of the Promptbook
  * Look at `wizard` for more details

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/markdown-utils",
-    "version": "0.100.1",
+    "version": "0.100.2",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -26,7 +26,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.100.1';
+    const PROMPTBOOK_ENGINE_VERSION = '0.100.2';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -584,7 +584,7 @@
     }
 
     /**
-     * Tests if given string is valid URL.
+     * Tests if given string is valid file path.
      *
      * Note: This does not check if the file exists only if the path is valid
      * @public exported from `@promptbook/utils`
@@ -596,18 +596,25 @@
         if (filename.split('\n').length > 1) {
             return false;
         }
-        if (filename.split(' ').length >
-            5 /* <- TODO: [🧠][🈷] Make some better non-arbitrary way how to distinct filenames from informational texts */) {
+        // Normalize slashes early so heuristics can detect path-like inputs
+        const filenameSlashes = filename.replace(/\\/g, '/');
+        // Reject strings that look like sentences (informational text)
+        // Heuristic: contains multiple spaces and ends with a period, or contains typical sentence punctuation
+        // But skip this heuristic if the string looks like a path (contains '/' or starts with a drive letter)
+        if (filename.trim().length > 60 && // long enough to be a sentence
+            /[.!?]/.test(filename) && // contains sentence punctuation
+            filename.split(' ').length > 8 && // has many words
+            !/\/|^[A-Z]:/i.test(filenameSlashes) // do NOT treat as sentence if looks like a path
+        ) {
             return false;
         }
-        const filenameSlashes = filename.split('\\').join('/');
         // Absolute Unix path: /hello.txt
         if (/^(\/)/i.test(filenameSlashes)) {
             // console.log(filename, 'Absolute Unix path: /hello.txt');
             return true;
         }
-        // Absolute Windows path: /hello.txt
-        if (/^([A-Z]{1,2}:\/?)\//i.test(filenameSlashes)) {
+        // Absolute Windows path: C:/ or C:\ (allow spaces and multiple dots in filename)
+        if (/^[A-Z]:\/.+$/i.test(filenameSlashes)) {
             // console.log(filename, 'Absolute Windows path: /hello.txt');
             return true;
         }
@@ -3697,9 +3704,15 @@
         }
         if (isValidUrl(knowledgeSourceContent)) {
             const url = knowledgeSourceContent;
+            if (isVerbose) {
+                console.info(`📄 [1] "${name}" is available at "${url}"`);
+            }
             const response = await fetch(url); // <- TODO: [🧠] Scraping and fetch proxy
             const mimeType = ((_a = response.headers.get('content-type')) === null || _a === void 0 ? void 0 : _a.split(';')[0]) || 'text/html';
             if (tools.fs === undefined || !url.endsWith('.pdf' /* <- TODO: [💵] */)) {
+                if (isVerbose) {
+                    console.info(`📄 [2] "${name}" tools.fs is not available or URL is not a PDF.`);
+                }
                 return {
                     source: name,
                     filename: null,
@@ -3735,13 +3748,17 @@
                 await tools.fs.mkdir(path.dirname(path.join(rootDirname, filepath)), { recursive: true });
             }
             catch (error) {
+                if (isVerbose) {
+                    console.info(`📄 [3] "${name}" error creating cache directory`);
+                }
                 // Note: If we can't create cache directory, we'll handle it when trying to write the file
                 //       This handles read-only filesystems, permission issues, and missing parent directories
-                if (error instanceof Error && (error.message.includes('EROFS') ||
-                    error.message.includes('read-only') ||
-                    error.message.includes('EACCES') ||
-                    error.message.includes('EPERM') ||
-                    error.message.includes('ENOENT'))) ;
+                if (error instanceof Error &&
+                    (error.message.includes('EROFS') ||
+                        error.message.includes('read-only') ||
+                        error.message.includes('EACCES') ||
+                        error.message.includes('EPERM') ||
+                        error.message.includes('ENOENT'))) ;
                 else {
                     // Re-throw other unexpected errors
                     throw error;
@@ -3756,13 +3773,17 @@
                 await tools.fs.writeFile(path.join(rootDirname, filepath), fileContent);
             }
             catch (error) {
+                if (isVerbose) {
+                    console.info(`📄 [4] "${name}" error writing cache file`);
+                }
                 // Note: If we can't write to cache, we'll process the file directly from memory
                 //       This handles read-only filesystems like Vercel
-                if (error instanceof Error && (error.message.includes('EROFS') ||
-                    error.message.includes('read-only') ||
-                    error.message.includes('EACCES') ||
-                    error.message.includes('EPERM') ||
-                    error.message.includes('ENOENT'))) {
+                if (error instanceof Error &&
+                    (error.message.includes('EROFS') ||
+                        error.message.includes('read-only') ||
+                        error.message.includes('EACCES') ||
+                        error.message.includes('EPERM') ||
+                        error.message.includes('ENOENT'))) {
                     // Return a handler that works directly with the downloaded content
                     return {
                         source: name,
@@ -3784,6 +3805,9 @@
             }
             // TODO: [💵] Check the file security
             // TODO: [🧹][🧠] Delete the file after the scraping is done
+            if (isVerbose) {
+                console.info(`📄 [5] "${name}" cached at "${path.join(rootDirname, filepath)}"`);
+            }
             return makeKnowledgeSourceHandler({ name, knowledgeSourceContent: filepath }, tools, {
                 ...options,
                 rootDirname,
@@ -3798,7 +3822,12 @@
                 throw new EnvironmentMismatchError('Can not import file knowledge in non-file pipeline');
                 //          <- TODO: [🧠] What is the best error type here`
             }
-            const filename = path.join(rootDirname, knowledgeSourceContent).split('\\').join('/');
+            const filename = path.isAbsolute(knowledgeSourceContent)
+                ? knowledgeSourceContent
+                : path.join(rootDirname, knowledgeSourceContent).split('\\').join('/');
+            if (isVerbose) {
+                console.info(`📄 [6] "${name}" is a valid file "${filename}"`);
+            }
             const fileExtension = getFileExtension(filename);
             const mimeType = extensionToMimeType(fileExtension || '');
             if (!(await isFileExisting(filename, tools.fs))) {
@@ -3840,6 +3869,12 @@
             };
         }
         else {
+            if (isVerbose) {
+                console.info(`📄 [7] "${name}" is just a explicit string text with a knowledge source`);
+                console.info('---');
+                console.info(knowledgeSourceContent);
+                console.info('---');
+            }
             return {
                 source: name,
                 filename: null,