@promptbook/components 0.114.0-0 → 0.114.0-2

package/esm/src/book-2.0/book-language-documentation/BookLanguageManualDictionary.d.ts

@@ -86,9 +86,7 @@ export type BookLanguageManualDictionary = {
     readonly metadataLabels: {
         readonly bookLanguageVersion: string;
         readonly generatedAt: string;
-        readonly commitmentGroups: string;
-        readonly implementedCommitments: string;
-        readonly placeholderCommitments: string;
+        readonly commitmentCount: string;
     };
     /**
      * Heading of the table of contents.
@@ -128,7 +126,6 @@ export type BookLanguageManualDictionary = {
     readonly primitivesSections: {
         readonly coreSyntax: BookLanguageManualChapter;
         readonly references: BookLanguageManualChapter;
-        readonly keywordsTitle: string;
     };
     /**
      * Suffixes distinguishing a server-specific catalog from the portable one.
@@ -141,18 +138,7 @@ export type BookLanguageManualDictionary = {
      * Labels used in every commitment catalog entry.
      */
     readonly commitmentLabels: {
-        readonly status: string;
         readonly aliases: string;
-        readonly semantics: string;
-        readonly typeSchema: string;
-        readonly blockSchema: string;
-        readonly lowLevelNotice: string;
-        readonly usage: string;
-        readonly usageOccurrence: string;
-        readonly usageOccurrences: string;
-        readonly statusImplemented: string;
-        readonly statusPlaceholder: string;
-        readonly noAliases: string;
     };
     /**
      * Labels used by end-to-end example sections.

package/esm/src/book-2.0/book-language-documentation/getBookLanguageManualCommitmentGroups.d.ts

@@ -16,7 +16,7 @@ export type BookLanguageManualCommitmentGroups = {
      */
     readonly documented: ReadonlyArray<BookLanguageManualCommitmentGroup>;
     /**
-     * Low-level and unfinished commitments documented in their own closing chapter.
+     * Low-level commitments documented in their own closing chapter.
      */
     readonly lowLevel: ReadonlyArray<BookLanguageManualCommitmentGroup>;
 };

package/esm/src/book-2.0/book-language-documentation/renderCommitmentCatalogSection.d.ts

@@ -10,10 +10,6 @@ export type RenderCommitmentCatalogSectionOptions = {
      * Grouped commitment definition with aliases.
      */
     readonly groupedCommitment: BookLanguageManualCommitmentGroup;
-    /**
-     * Number of uses across the selected server agents.
-     */
-    readonly usageCount: number;
     /**
      * Translated labels of the manual.
      */

package/esm/src/book-components/Chat/utils/renderMarkdown.d.ts

@@ -25,6 +25,13 @@ export type MarkdownInlineReference = {
      * Link target for the rendered reference.
      */
     readonly href: string;
+    /**
+     * Markdown link destination prefixes that should render as this reference as well.
+     *
+     * This supports legacy links such as an Agents Server project file URL while keeping
+     * `reference` as the canonical `[[project]]` token.
+     */
+    readonly sourceHrefPrefixes?: ReadonlyArray<string>;
     /**
      * Optional hover title for the rendered reference.
      */

package/esm/src/cli/cli-commands/coder/agentCodingFile.d.ts

@@ -1,3 +1,4 @@
+import { string_markdown } from '../../../types/typeAliases';
 /**
  * Relative path to the Promptbook Coder quick-reference file initialized in project roots.
  *
@@ -9,6 +10,4 @@ export declare const AGENT_CODING_FILE_PATH = "AGENT_CODING.md";
  *
  * @private internal utility of `ptbk coder`
  */
-export declare function getDefaultCoderAgentCodingFileContent({ packageJsonScripts, }: {
-    readonly packageJsonScripts: Readonly<Record<string, string>>;
-}): string;
+export declare function getDefaultCoderAgentCodingFileContent(): string_markdown;

package/esm/src/cli/cli-commands/coder/ping.d.ts

@@ -0,0 +1,13 @@
+import type { Command as Program } from 'commander';
+import type { $side_effect } from '../../../utils/organization/$side_effect';
+/**
+ * Initializes `coder ping` command for Promptbook CLI utilities.
+ *
+ * The command makes one small, isolated harness/model call, prints its result
+ * and reports how long the harness/model turn took.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI.
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeCoderPingCommand(program: Program): $side_effect;

package/esm/src/cli/cli-commands/coder/ping.test.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/src/cli/cli-commands/coder.d.ts

@@ -8,6 +8,7 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * - add: Add one ready-to-run prompt file to the queue
  * - generate-boilerplates: Generate prompt boilerplate files
  * - find-refactor-candidates: Find files that need refactoring
+ * - ping: Test one harness and model connection with a disposable task
  * - run: Run coding prompts with AI agents
  * - verify: Verify completed prompts
  * - find-fresh-emoji-tags: Find unused emoji tags

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/components",
-    "version": "0.114.0-0",
+    "version": "0.114.0-2",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -34,7 +34,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.114.0-0';
+    const PROMPTBOOK_ENGINE_VERSION = '0.114.0-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
@@ -28086,6 +28086,14 @@
      * @private utility of `renderMarkdown`
      */
     const INLINE_REFERENCE_REGEX = /\[\[([^\]\r\n]+?)\]\]/g;
+    /**
+     * Pattern matching ordinary markdown links that can be promoted to inline reference chips.
+     *
+     * Images are intentionally captured separately and left unchanged by the replacement helper.
+     *
+     * @private utility of `renderMarkdown`
+     */
+    const MARKDOWN_INLINE_REFERENCE_LINK_REGEX = /(!?)\[([^\]\r\n]*)\]\(\s*(<[^>\r\n]+>|[^)\s]+)(?:\s+(?:"[^"\r\n]*"|'[^'\r\n]*'|\([^)]*\)))?\s*\)/g;
     /**
      * Collection of math delimiter definitions.
      */
@@ -28323,11 +28331,12 @@
      * outer `<details>` and optional `<summary>` markup untouched.
      *
      * @param detailsBlock - Raw `<details>...</details>` HTML captured from markdown.
+     * @param options - Markdown rendering options to reuse for the details body.
      * @returns `<details>` HTML whose body has been converted from markdown to HTML.
      *
      * @private utility of `renderMarkdown`
      */
-    function renderDetailsBlock(detailsBlock) {
+    function renderDetailsBlock(detailsBlock, options) {
         var _a, _b;
         const openTagMatch = detailsBlock.match(/^<details\b[^>]*>/i);
         const closeTagMatch = detailsBlock.match(/<\/details\s*>$/i);
@@ -28340,7 +28349,7 @@
         const summaryMatch = innerContent.match(/^(\s*<summary\b[^>]*>[\s\S]*?<\/summary\s*>)([\s\S]*)$/i);
         const summaryHtml = (_a = summaryMatch === null || summaryMatch === void 0 ? void 0 : summaryMatch[1]) !== null && _a !== void 0 ? _a : '';
         const bodyMarkdown = ((_b = summaryMatch === null || summaryMatch === void 0 ? void 0 : summaryMatch[2]) !== null && _b !== void 0 ? _b : innerContent);
-        const renderedBody = renderMarkdown(bodyMarkdown);
+        const renderedBody = renderMarkdown(bodyMarkdown, options);
         return `${openTag}${summaryHtml}${renderedBody}${closeTag}`;
     }
     /**
@@ -28377,16 +28386,17 @@
      * processes their content.
      *
      * @param markdown - Markdown text that may contain raw HTML `<details>` blocks.
+     * @param options - Markdown rendering options to reuse for the details body.
      * @returns Masked markdown and a restore helper that returns `string_html`.
      *
      * @private utility of `renderMarkdown`
      */
-    function maskDetailsBlocks(markdown) {
+    function maskDetailsBlocks(markdown, options) {
         const blocks = [];
         DETAILS_BLOCK_REGEX.lastIndex = 0;
         const masked = markdown.replace(DETAILS_BLOCK_REGEX, (match) => {
             const placeholder = `${DETAILS_PLACEHOLDER_PREFIX}${blocks.length}__`;
-            blocks.push(renderDetailsBlock(match));
+            blocks.push(renderDetailsBlock(match, options));
             return placeholder;
         });
         return {
@@ -28487,6 +28497,79 @@
         }
         return referenceByKey;
     }
+    /**
+     * Returns whether a href starts with a configured source href prefix.
+     *
+     * @param href - Markdown link destination.
+     * @param sourceHrefPrefix - Configured source href prefix.
+     * @returns Whether the href belongs to the source prefix.
+     *
+     * @private utility of `renderMarkdown`
+     */
+    function doesHrefStartWithSourceHrefPrefix(href, sourceHrefPrefix) {
+        if (href === sourceHrefPrefix) {
+            return true;
+        }
+        const normalizedSourceHrefPrefix = sourceHrefPrefix.endsWith('/') ? sourceHrefPrefix : `${sourceHrefPrefix}/`;
+        return href.startsWith(normalizedSourceHrefPrefix);
+    }
+    /**
+     * Returns a comparable path for an absolute href when the configured source prefix is relative.
+     *
+     * @param href - Href to normalize.
+     * @returns Absolute URL pathname or the original href when it is relative/invalid.
+     *
+     * @private utility of `renderMarkdown`
+     */
+    function resolveAbsoluteHrefPath(href) {
+        try {
+            return new URL(href).pathname;
+        }
+        catch (_a) {
+            return href;
+        }
+    }
+    /**
+     * Returns whether one markdown link destination belongs to one inline reference.
+     *
+     * Relative project paths also match absolute URLs on the current server, which keeps
+     * server-generated relative links and model-generated absolute links consistent.
+     *
+     * @param reference - Candidate inline reference.
+     * @param href - Markdown link destination.
+     * @returns Whether the href should render as the reference chip.
+     *
+     * @private utility of `renderMarkdown`
+     */
+    function doesMarkdownInlineReferenceMatchHref(reference, href) {
+        const normalizedHref = href.trim();
+        return (reference.sourceHrefPrefixes || []).some((sourceHrefPrefix) => {
+            const normalizedSourceHrefPrefix = sourceHrefPrefix.trim();
+            if (!normalizedSourceHrefPrefix) {
+                return false;
+            }
+            if (doesHrefStartWithSourceHrefPrefix(normalizedHref, normalizedSourceHrefPrefix)) {
+                return true;
+            }
+            const isRelativeSourceHrefPrefix = !/^[a-z][a-z0-9+.-]*:/i.test(normalizedSourceHrefPrefix);
+            const isAbsoluteHref = /^[a-z][a-z0-9+.-]*:/i.test(normalizedHref);
+            return (isRelativeSourceHrefPrefix &&
+                isAbsoluteHref &&
+                doesHrefStartWithSourceHrefPrefix(resolveAbsoluteHrefPath(normalizedHref), normalizedSourceHrefPrefix));
+        });
+    }
+    /**
+     * Finds the inline reference represented by a markdown link destination.
+     *
+     * @param references - Inline references available to the markdown renderer.
+     * @param href - Markdown link destination.
+     * @returns Matching reference or `undefined` when the href is unrelated.
+     *
+     * @private utility of `renderMarkdown`
+     */
+    function findMarkdownInlineReferenceByHref(references, href) {
+        return references.find((reference) => doesMarkdownInlineReferenceMatchHref(reference, href));
+    }
     /**
      * Renders one inline reference as raw HTML that is sanitized by the shared markdown sanitizer.
      *
@@ -28566,10 +28649,18 @@
         if (referenceByKey.size === 0) {
             return markdown;
         }
-        return markdown.replace(INLINE_REFERENCE_REGEX, (match, rawReference) => {
+        const markdownWithInlineReferenceTokens = markdown.replace(INLINE_REFERENCE_REGEX, (match, rawReference) => {
             const reference = referenceByKey.get(normalizeMarkdownInlineReferenceKey(rawReference));
             return reference ? renderMarkdownInlineReferenceHtml(reference, className) : match;
         });
+        return markdownWithInlineReferenceTokens.replace(MARKDOWN_INLINE_REFERENCE_LINK_REGEX, (match, imageMarker, _linkLabel, rawHref) => {
+            if (imageMarker) {
+                return match;
+            }
+            const href = rawHref.replace(/^<|>$/g, '');
+            const reference = findMarkdownInlineReferenceByHref(references, href);
+            return reference ? renderMarkdownInlineReferenceHtml(reference, className) : match;
+        });
     }
     /**
      * Loads KaTeX CSS in browser environments that need to display math output.
@@ -28607,7 +28698,7 @@
         const converter = options ? createChatMarkdownConverter(options) : CHAT_MARKDOWN_CONVERTER;
         try {
             const normalizedMarkdown = normalizeMarkdownSublists(markdown);
-            const { masked: maskedMarkdown, restore: restoreDetails } = maskDetailsBlocks(normalizedMarkdown);
+            const { masked: maskedMarkdown, restore: restoreDetails } = maskDetailsBlocks(normalizedMarkdown, options);
             const { masked: codeMaskedMarkdown, restore: restoreCode } = maskMarkdownCodeSegments(maskedMarkdown);
             const referencedMarkdown = applyMarkdownInlineReferences(codeMaskedMarkdown, options);
             const inlineReferenceMarkdown = restoreCode(referencedMarkdown);