@promptbook/markdown-utils 0.114.0-32 → 0.114.0-34

package/umd/src/cli/common/$deprecateCliCommand.d.ts

@@ -3,6 +3,9 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Marks one CLI command as deprecated while keeping it available for existing callers.
  *
+ * Deprecated commands are not advertised anymore - they are hidden from the list of commands in the help of their
+ * parent command, they warn when they are used and they explain the deprecation in their own help.
+ *
  * @private utility of CLI
  */
 export declare function $deprecateCliCommand(command: Command, deprecationMessage: string): $side_effect;

package/umd/src/cli/common/$hideCliCommandFromHelp.d.ts

@@ -0,0 +1,11 @@
+import type { Command } from 'commander';
+import type { $side_effect } from '../../utils/organization/$side_effect';
+/**
+ * Keeps one already registered CLI command out of the help of its parent command while the command itself stays
+ * fully usable - it can still be run, it still has its own help and it is still reachable through `ptbk help <command>`.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it changes how the CLI renders its help
+ *
+ * @private utility of CLI
+ */
+export declare function $hideCliCommandFromHelp(command: Command): $side_effect;

package/umd/src/cli/common/$hideCliCommandFromHelp.test.d.ts

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

package/umd/src/cli/common/$requireCliSubcommand.d.ts

@@ -0,0 +1,18 @@
+import type { Command } from 'commander';
+import type { $side_effect } from '../../utils/organization/$side_effect';
+/**
+ * Makes one CLI command which only groups subcommands ask for a subcommand instead of doing anything on its own.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers an action in the CLI
+ *
+ * @private utility of CLI
+ */
+export declare function $requireCliSubcommand(command: Command): $side_effect;
+/**
+ * Asks for a subcommand of one CLI command, prints its help and exits the process.
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it writes to the console and exits the process
+ *
+ * @private utility of CLI
+ */
+export declare function $reportMissingCliSubcommand(command: Command): never;

package/umd/src/cli/common/$requireCliSubcommand.test.d.ts

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

package/umd/src/llm-providers/vercel/VercelExecutionToolsOptions.d.ts

@@ -17,7 +17,10 @@ export type VercelExecutionToolsOptions = CommonToolsOptions & Pick<LlmExecution
      */
     readonly availableModels: ReadonlyArray<AvailableModel>;
     /**
-     * Additional settings for chat models when calling `vercelProvider.chat('model-name', settings)`
+     * Additional settings for chat models, for example `temperature` or `providerOptions`
+     *
+     * Note: Since Vercel AI SDK v5 these settings belong to the model call, not to
+     *       `vercelProvider.chat('model-name')` which takes just the model name
      */
-    readonly additionalChatSettings?: Partial<Parameters<VercelProvider['chat']>[1]>;
+    readonly additionalChatSettings?: Partial<Omit<Parameters<ReturnType<VercelProvider['chat']>['doGenerate']>[0], 'prompt'>>;
 };

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

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

@@ -1,13 +0,0 @@
-import { string_markdown } from '../../../types/typeAliases';
-/**
- * Relative path to the Promptbook Coder quick-reference file initialized in project roots.
- *
- * @private internal utility of `ptbk coder`
- */
-export declare const AGENT_CODING_FILE_PATH = "AGENT_CODING.md";
-/**
- * Returns the default coder `AGENT_CODING.md` quick-reference content.
- *
- * @private internal utility of `ptbk coder`
- */
-export declare function getDefaultCoderAgentCodingFileContent(): string_markdown;

package/esm/src/cli/cli-commands/common/harnessUpdateCliOptions.d.ts

@@ -1,29 +0,0 @@
-import type { Command as Program } from 'commander';
-/**
- * Commander option bag for opting out of automatic coding-harness update checks.
- *
- * @private internal utility of `promptbookCli`
- */
-export type HarnessUpdateCliOptions = {
-    readonly harnessUpdate: boolean;
-};
-/**
- * Normalized automatic coding-harness update-check option.
- *
- * @private internal utility of `promptbookCli`
- */
-export type NormalizedHarnessUpdateCliOptions = {
-    readonly isHarnessUpdateCheckEnabled: boolean;
-};
-/**
- * Registers the shared `--no-harness-update` option on a `ptbk coder` command that uses a coding harness.
- *
- * @private internal utility of `promptbookCli`
- */
-export declare function addHarnessUpdateOption(command: Program): void;
-/**
- * Converts the Commander harness-update flag into the normalized harness-check option.
- *
- * @private internal utility of `promptbookCli`
- */
-export declare function normalizeHarnessUpdateCliOptions(cliOptions: HarnessUpdateCliOptions): NormalizedHarnessUpdateCliOptions;

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

@@ -1,13 +0,0 @@
-import { string_markdown } from '../../../types/typeAliases';
-/**
- * Relative path to the Promptbook Coder quick-reference file initialized in project roots.
- *
- * @private internal utility of `ptbk coder`
- */
-export declare const AGENT_CODING_FILE_PATH = "AGENT_CODING.md";
-/**
- * Returns the default coder `AGENT_CODING.md` quick-reference content.
- *
- * @private internal utility of `ptbk coder`
- */
-export declare function getDefaultCoderAgentCodingFileContent(): string_markdown;

package/umd/src/cli/cli-commands/common/harnessUpdateCliOptions.d.ts

@@ -1,29 +0,0 @@
-import type { Command as Program } from 'commander';
-/**
- * Commander option bag for opting out of automatic coding-harness update checks.
- *
- * @private internal utility of `promptbookCli`
- */
-export type HarnessUpdateCliOptions = {
-    readonly harnessUpdate: boolean;
-};
-/**
- * Normalized automatic coding-harness update-check option.
- *
- * @private internal utility of `promptbookCli`
- */
-export type NormalizedHarnessUpdateCliOptions = {
-    readonly isHarnessUpdateCheckEnabled: boolean;
-};
-/**
- * Registers the shared `--no-harness-update` option on a `ptbk coder` command that uses a coding harness.
- *
- * @private internal utility of `promptbookCli`
- */
-export declare function addHarnessUpdateOption(command: Program): void;
-/**
- * Converts the Commander harness-update flag into the normalized harness-check option.
- *
- * @private internal utility of `promptbookCli`
- */
-export declare function normalizeHarnessUpdateCliOptions(cliOptions: HarnessUpdateCliOptions): NormalizedHarnessUpdateCliOptions;