@dexto/core 1.1.10 → 1.2.0

package/dist/prompts/errors.cjs

@@ -0,0 +1,144 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var errors_exports = {};
+__export(errors_exports, {
+  PromptError: () => PromptError
+});
+module.exports = __toCommonJS(errors_exports);
+var import_DextoRuntimeError = require("../errors/DextoRuntimeError.cjs");
+var import_DextoValidationError = require("../errors/DextoValidationError.cjs");
+var import_types = require("../errors/types.cjs");
+var import_error_codes = require("./error-codes.js");
+class PromptError {
+  /**
+   * Prompt not found error
+   */
+  static notFound(name) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.PromptErrorCode.PROMPT_NOT_FOUND,
+      import_types.ErrorScope.PROMPT,
+      import_types.ErrorType.NOT_FOUND,
+      `Prompt not found: ${name}`,
+      { name }
+    );
+  }
+  /**
+   * Missing prompt text validation error
+   */
+  static missingText() {
+    return new import_DextoValidationError.DextoValidationError([
+      {
+        code: import_error_codes.PromptErrorCode.PROMPT_MISSING_TEXT,
+        message: "Prompt missing text content",
+        scope: import_types.ErrorScope.PROMPT,
+        type: import_types.ErrorType.USER,
+        severity: "error",
+        context: {}
+      }
+    ]);
+  }
+  /**
+   * Missing required arguments validation error
+   */
+  static missingRequiredArguments(missingNames) {
+    return new import_DextoValidationError.DextoValidationError([
+      {
+        code: import_error_codes.PromptErrorCode.PROMPT_MISSING_REQUIRED_ARGUMENTS,
+        message: `Missing required arguments: ${missingNames.join(", ")}`,
+        scope: import_types.ErrorScope.PROMPT,
+        type: import_types.ErrorType.USER,
+        severity: "error",
+        context: { missingNames }
+      }
+    ]);
+  }
+  /**
+   * Provider not found error
+   */
+  static providerNotFound(source) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.PromptErrorCode.PROMPT_PROVIDER_NOT_FOUND,
+      import_types.ErrorScope.PROMPT,
+      import_types.ErrorType.NOT_FOUND,
+      `No provider found for prompt source: ${source}`,
+      { source }
+    );
+  }
+  /**
+   * Missing prompt name in request (validation)
+   */
+  static nameRequired() {
+    return new import_DextoValidationError.DextoValidationError([
+      {
+        code: import_error_codes.PromptErrorCode.PROMPT_NAME_REQUIRED,
+        message: "Prompt name is required",
+        scope: import_types.ErrorScope.PROMPT,
+        type: import_types.ErrorType.USER,
+        severity: "error",
+        context: {}
+      }
+    ]);
+  }
+  /**
+   * Invalid prompt name format validation error
+   */
+  static invalidName(name, guidance, context, hint) {
+    const contextPrefix = context ?? "Prompt name";
+    const hintSuffix = hint ? ` ${hint}` : "";
+    return new import_DextoValidationError.DextoValidationError([
+      {
+        code: import_error_codes.PromptErrorCode.PROMPT_INVALID_NAME,
+        message: `${contextPrefix} '${name}' must be ${guidance}.${hintSuffix}`,
+        scope: import_types.ErrorScope.PROMPT,
+        type: import_types.ErrorType.USER,
+        severity: "error",
+        context: { name, guidance }
+      }
+    ]);
+  }
+  /** Duplicate prompt name validation error */
+  static alreadyExists(name) {
+    return new import_DextoValidationError.DextoValidationError([
+      {
+        code: import_error_codes.PromptErrorCode.PROMPT_ALREADY_EXISTS,
+        message: `Prompt already exists: ${name}`,
+        scope: import_types.ErrorScope.PROMPT,
+        type: import_types.ErrorType.USER,
+        severity: "error",
+        context: { name }
+      }
+    ]);
+  }
+  /**
+   * Prompt resolved to empty content
+   */
+  static emptyResolvedContent(name) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.PromptErrorCode.PROMPT_EMPTY_CONTENT,
+      import_types.ErrorScope.PROMPT,
+      import_types.ErrorType.NOT_FOUND,
+      `Prompt resolved to empty content: ${name}`,
+      { name }
+    );
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PromptError
+});

package/dist/prompts/errors.d.ts

@@ -0,0 +1,45 @@
+import { DextoRuntimeError } from '../errors/DextoRuntimeError.js';
+import { DextoValidationError } from '../errors/DextoValidationError.js';
+/**
+ * Prompt error factory with typed methods for creating prompt-specific errors
+ * Each method creates a properly typed error with appropriate scope
+ */
+export declare class PromptError {
+    /**
+     * Prompt not found error
+     */
+    static notFound(name: string): DextoRuntimeError<{
+        name: string;
+    }>;
+    /**
+     * Missing prompt text validation error
+     */
+    static missingText(): DextoValidationError;
+    /**
+     * Missing required arguments validation error
+     */
+    static missingRequiredArguments(missingNames: string[]): DextoValidationError;
+    /**
+     * Provider not found error
+     */
+    static providerNotFound(source: string): DextoRuntimeError<{
+        source: string;
+    }>;
+    /**
+     * Missing prompt name in request (validation)
+     */
+    static nameRequired(): DextoValidationError;
+    /**
+     * Invalid prompt name format validation error
+     */
+    static invalidName(name: string, guidance: string, context?: string, hint?: string): DextoValidationError;
+    /** Duplicate prompt name validation error */
+    static alreadyExists(name: string): DextoValidationError;
+    /**
+     * Prompt resolved to empty content
+     */
+    static emptyResolvedContent(name: string): DextoRuntimeError<{
+        name: string;
+    }>;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/prompts/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/prompts/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAI5E;;;GAGG;AACH,qBAAa,WAAW;IACpB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM;;;IAU5B;;OAEG;IACH,MAAM,CAAC,WAAW;IAalB;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE;IAatD;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM;;;IAUtC;;OAEG;IACH,MAAM,CAAC,YAAY;IAanB;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAelF,6CAA6C;IAC7C,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM;IAajC;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM;;;CAS3C"}

package/dist/prompts/errors.js

@@ -0,0 +1,121 @@
+import "../chunk-C6A6W6XS.js";
+import { DextoRuntimeError } from "../errors/DextoRuntimeError.js";
+import { DextoValidationError } from "../errors/DextoValidationError.js";
+import { ErrorScope, ErrorType } from "../errors/types.js";
+import { PromptErrorCode } from "./error-codes.js";
+class PromptError {
+  /**
+   * Prompt not found error
+   */
+  static notFound(name) {
+    return new DextoRuntimeError(
+      PromptErrorCode.PROMPT_NOT_FOUND,
+      ErrorScope.PROMPT,
+      ErrorType.NOT_FOUND,
+      `Prompt not found: ${name}`,
+      { name }
+    );
+  }
+  /**
+   * Missing prompt text validation error
+   */
+  static missingText() {
+    return new DextoValidationError([
+      {
+        code: PromptErrorCode.PROMPT_MISSING_TEXT,
+        message: "Prompt missing text content",
+        scope: ErrorScope.PROMPT,
+        type: ErrorType.USER,
+        severity: "error",
+        context: {}
+      }
+    ]);
+  }
+  /**
+   * Missing required arguments validation error
+   */
+  static missingRequiredArguments(missingNames) {
+    return new DextoValidationError([
+      {
+        code: PromptErrorCode.PROMPT_MISSING_REQUIRED_ARGUMENTS,
+        message: `Missing required arguments: ${missingNames.join(", ")}`,
+        scope: ErrorScope.PROMPT,
+        type: ErrorType.USER,
+        severity: "error",
+        context: { missingNames }
+      }
+    ]);
+  }
+  /**
+   * Provider not found error
+   */
+  static providerNotFound(source) {
+    return new DextoRuntimeError(
+      PromptErrorCode.PROMPT_PROVIDER_NOT_FOUND,
+      ErrorScope.PROMPT,
+      ErrorType.NOT_FOUND,
+      `No provider found for prompt source: ${source}`,
+      { source }
+    );
+  }
+  /**
+   * Missing prompt name in request (validation)
+   */
+  static nameRequired() {
+    return new DextoValidationError([
+      {
+        code: PromptErrorCode.PROMPT_NAME_REQUIRED,
+        message: "Prompt name is required",
+        scope: ErrorScope.PROMPT,
+        type: ErrorType.USER,
+        severity: "error",
+        context: {}
+      }
+    ]);
+  }
+  /**
+   * Invalid prompt name format validation error
+   */
+  static invalidName(name, guidance, context, hint) {
+    const contextPrefix = context ?? "Prompt name";
+    const hintSuffix = hint ? ` ${hint}` : "";
+    return new DextoValidationError([
+      {
+        code: PromptErrorCode.PROMPT_INVALID_NAME,
+        message: `${contextPrefix} '${name}' must be ${guidance}.${hintSuffix}`,
+        scope: ErrorScope.PROMPT,
+        type: ErrorType.USER,
+        severity: "error",
+        context: { name, guidance }
+      }
+    ]);
+  }
+  /** Duplicate prompt name validation error */
+  static alreadyExists(name) {
+    return new DextoValidationError([
+      {
+        code: PromptErrorCode.PROMPT_ALREADY_EXISTS,
+        message: `Prompt already exists: ${name}`,
+        scope: ErrorScope.PROMPT,
+        type: ErrorType.USER,
+        severity: "error",
+        context: { name }
+      }
+    ]);
+  }
+  /**
+   * Prompt resolved to empty content
+   */
+  static emptyResolvedContent(name) {
+    return new DextoRuntimeError(
+      PromptErrorCode.PROMPT_EMPTY_CONTENT,
+      ErrorScope.PROMPT,
+      ErrorType.NOT_FOUND,
+      `Prompt resolved to empty content: ${name}`,
+      { name }
+    );
+  }
+}
+export {
+  PromptError
+};

package/dist/prompts/index.cjs

@@ -0,0 +1,53 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var prompts_exports = {};
+__export(prompts_exports, {
+  CustomPromptProvider: () => import_custom_prompt_provider.CustomPromptProvider,
+  FilePromptProvider: () => import_file_prompt_provider.FilePromptProvider,
+  MCPPromptProvider: () => import_mcp_prompt_provider.MCPPromptProvider,
+  PromptError: () => import_errors.PromptError,
+  PromptManager: () => import_prompt_manager.PromptManager,
+  StarterPromptProvider: () => import_starter_prompt_provider.StarterPromptProvider,
+  StarterPromptsSchema: () => import_schemas.StarterPromptsSchema,
+  appendContext: () => import_utils.appendContext,
+  flattenPromptResult: () => import_utils.flattenPromptResult,
+  normalizePromptArgs: () => import_utils.normalizePromptArgs
+});
+module.exports = __toCommonJS(prompts_exports);
+var import_prompt_manager = require("./prompt-manager.js");
+var import_mcp_prompt_provider = require("./providers/mcp-prompt-provider.js");
+var import_file_prompt_provider = require("./providers/file-prompt-provider.js");
+var import_starter_prompt_provider = require("./providers/starter-prompt-provider.js");
+var import_custom_prompt_provider = require("./providers/custom-prompt-provider.js");
+var import_errors = require("./errors.js");
+var import_schemas = require("./schemas.js");
+var import_utils = require("./utils.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CustomPromptProvider,
+  FilePromptProvider,
+  MCPPromptProvider,
+  PromptError,
+  PromptManager,
+  StarterPromptProvider,
+  StarterPromptsSchema,
+  appendContext,
+  flattenPromptResult,
+  normalizePromptArgs
+});

package/dist/prompts/index.d.ts

@@ -0,0 +1,13 @@
+export { PromptManager } from './prompt-manager.js';
+export { MCPPromptProvider } from './providers/mcp-prompt-provider.js';
+export { FilePromptProvider } from './providers/file-prompt-provider.js';
+export { StarterPromptProvider } from './providers/starter-prompt-provider.js';
+export { CustomPromptProvider } from './providers/custom-prompt-provider.js';
+export type { CreateCustomPromptInput } from './providers/custom-prompt-provider.js';
+export { PromptError } from './errors.js';
+export { StarterPromptsSchema } from './schemas.js';
+export type { ValidatedStarterPromptsConfig } from './schemas.js';
+export type { PromptInfo, PromptSet, PromptProvider, PromptArgument, PromptDefinition, } from './types.js';
+export { flattenPromptResult, normalizePromptArgs, appendContext } from './utils.js';
+export type { FlattenedPromptResult } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,YAAY,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAClE,YAAY,EACR,UAAU,EACV,SAAS,EACT,cAAc,EACd,cAAc,EACd,gBAAgB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACrF,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/prompts/index.js

@@ -0,0 +1,21 @@
+import "../chunk-C6A6W6XS.js";
+import { PromptManager } from "./prompt-manager.js";
+import { MCPPromptProvider } from "./providers/mcp-prompt-provider.js";
+import { FilePromptProvider } from "./providers/file-prompt-provider.js";
+import { StarterPromptProvider } from "./providers/starter-prompt-provider.js";
+import { CustomPromptProvider } from "./providers/custom-prompt-provider.js";
+import { PromptError } from "./errors.js";
+import { StarterPromptsSchema } from "./schemas.js";
+import { flattenPromptResult, normalizePromptArgs, appendContext } from "./utils.js";
+export {
+  CustomPromptProvider,
+  FilePromptProvider,
+  MCPPromptProvider,
+  PromptError,
+  PromptManager,
+  StarterPromptProvider,
+  StarterPromptsSchema,
+  appendContext,
+  flattenPromptResult,
+  normalizePromptArgs
+};

package/dist/prompts/name-validation.cjs

@@ -0,0 +1,45 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var name_validation_exports = {};
+__export(name_validation_exports, {
+  PROMPT_NAME_GUIDANCE: () => PROMPT_NAME_GUIDANCE,
+  PROMPT_NAME_REGEX: () => PROMPT_NAME_REGEX,
+  assertValidPromptName: () => assertValidPromptName,
+  isValidPromptName: () => isValidPromptName
+});
+module.exports = __toCommonJS(name_validation_exports);
+var import_errors = require("./errors.js");
+const PROMPT_NAME_REGEX = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const PROMPT_NAME_GUIDANCE = "kebab-case (lowercase letters and numbers separated by single hyphens)";
+function isValidPromptName(name) {
+  return PROMPT_NAME_REGEX.test(name);
+}
+function assertValidPromptName(name, options = {}) {
+  if (isValidPromptName(name)) {
+    return;
+  }
+  throw import_errors.PromptError.invalidName(name, PROMPT_NAME_GUIDANCE, options.context, options.hint);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PROMPT_NAME_GUIDANCE,
+  PROMPT_NAME_REGEX,
+  assertValidPromptName,
+  isValidPromptName
+});

package/dist/prompts/name-validation.d.ts

@@ -0,0 +1,9 @@
+export declare const PROMPT_NAME_REGEX: RegExp;
+export declare const PROMPT_NAME_GUIDANCE = "kebab-case (lowercase letters and numbers separated by single hyphens)";
+export interface PromptNameValidationOptions {
+    context?: string;
+    hint?: string;
+}
+export declare function isValidPromptName(name: string): boolean;
+export declare function assertValidPromptName(name: string, options?: PromptNameValidationOptions): void;
+//# sourceMappingURL=name-validation.d.ts.map

package/dist/prompts/name-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-validation.d.ts","sourceRoot":"","sources":["../../src/prompts/name-validation.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,QAA+B,CAAC;AAE9D,eAAO,MAAM,oBAAoB,2EAC2C,CAAC;AAE7E,MAAM,WAAW,2BAA2B;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,qBAAqB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,2BAAgC,GAC1C,IAAI,CAMN"}

package/dist/prompts/name-validation.js

@@ -0,0 +1,19 @@
+import "../chunk-C6A6W6XS.js";
+import { PromptError } from "./errors.js";
+const PROMPT_NAME_REGEX = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const PROMPT_NAME_GUIDANCE = "kebab-case (lowercase letters and numbers separated by single hyphens)";
+function isValidPromptName(name) {
+  return PROMPT_NAME_REGEX.test(name);
+}
+function assertValidPromptName(name, options = {}) {
+  if (isValidPromptName(name)) {
+    return;
+  }
+  throw PromptError.invalidName(name, PROMPT_NAME_GUIDANCE, options.context, options.hint);
+}
+export {
+  PROMPT_NAME_GUIDANCE,
+  PROMPT_NAME_REGEX,
+  assertValidPromptName,
+  isValidPromptName
+};