@dexto/core 1.2.5 → 1.3.0

package/dist/prompts/providers/file-prompt-provider.js

@@ -1,378 +0,0 @@
-import "../../chunk-C6A6W6XS.js";
-import { expandPlaceholders } from "../utils.js";
-import { assertValidPromptName } from "../name-validation.js";
-import { DextoLogComponent } from "../../logger/v2/types.js";
-import { PromptError } from "../errors.js";
-import { readFile, readdir, realpath } from "fs/promises";
-import { join, extname, resolve, relative, sep } from "path";
-import { existsSync } from "fs";
-import { homedir } from "os";
-import { findDextoProjectRoot, findDextoSourceRoot } from "../../utils/execution-context.js";
-class FilePromptProvider {
-  // Multiple command directories (local project/repo and global user dir)
-  commandDirs;
-  resourceManager;
-  promptsCache = [];
-  cacheValid = false;
-  promptResources = /* @__PURE__ */ new Map();
-  inlineContent = /* @__PURE__ */ new Map();
-  logger;
-  constructor(options, logger) {
-    this.logger = logger.createChild(DextoLogComponent.PROMPT);
-    this.commandDirs = this.resolveDefaultCommandDirs();
-    this.resourceManager = options.resourceManager;
-  }
-  getSource() {
-    return "file";
-  }
-  invalidateCache() {
-    this.cacheValid = false;
-    this.promptsCache = [];
-    this.promptResources.clear();
-    this.inlineContent.clear();
-    this.logger.debug("FilePromptProvider cache invalidated");
-  }
-  async getPrompt(name, args) {
-    if (!this.cacheValid) {
-      await this.buildPromptsCache();
-    }
-    const prompt = this.promptsCache.find((p) => p.name === name);
-    if (!prompt) {
-      throw PromptError.notFound(name);
-    }
-    const resourceUri = this.promptResources.get(name);
-    let text = this.inlineContent.get(name) ?? "";
-    if (resourceUri) {
-      try {
-        const result = await this.resourceManager.read(resourceUri);
-        const first = result.contents[0];
-        if (first?.text && typeof first.text === "string") {
-          text = first.text;
-        } else if (first?.blob && typeof first.blob === "string") {
-          text = Buffer.from(first.blob, "base64").toString("utf-8");
-        } else {
-          this.logger.warn(`Prompt ${name} resource ${resourceUri} did not contain text`);
-        }
-      } catch (error) {
-        this.logger.warn(
-          `Failed to load prompt resource ${resourceUri}: ${error instanceof Error ? error.message : String(error)}`
-        );
-      }
-    }
-    if (!text) {
-      throw PromptError.missingText();
-    }
-    const resolved = this.applyArguments(text, args);
-    return {
-      description: prompt.description,
-      messages: [
-        {
-          role: "user",
-          content: {
-            type: "text",
-            text: resolved
-          }
-        }
-      ]
-    };
-  }
-  async listPrompts(_cursor) {
-    if (!this.cacheValid) {
-      await this.buildPromptsCache();
-    }
-    return {
-      prompts: this.promptsCache
-    };
-  }
-  async getPromptDefinition(name) {
-    if (!this.cacheValid) {
-      await this.buildPromptsCache();
-    }
-    const promptInfo = this.promptsCache.find((p) => p.name === name);
-    if (!promptInfo) {
-      return null;
-    }
-    return {
-      name: promptInfo.name,
-      ...promptInfo.title && { title: promptInfo.title },
-      ...promptInfo.description && { description: promptInfo.description },
-      ...promptInfo.arguments && { arguments: promptInfo.arguments }
-    };
-  }
-  async buildPromptsCache() {
-    const cache = [];
-    const resourceMap = /* @__PURE__ */ new Map();
-    const inlineMap = /* @__PURE__ */ new Map();
-    const seenNames = /* @__PURE__ */ new Set();
-    const scannedDirs = [];
-    for (const dir of this.commandDirs) {
-      if (!existsSync(dir)) {
-        continue;
-      }
-      try {
-        scannedDirs.push(dir);
-        const files = await readdir(dir);
-        const markdownFiles = files.filter((file) => extname(file).toLowerCase() === ".md");
-        for (const file of markdownFiles) {
-          try {
-            try {
-              const candidate = join(dir, file);
-              const resolvedDir = await realpath(dir);
-              const resolvedFile = await realpath(candidate);
-              const rel = relative(resolvedDir, resolvedFile);
-              if (rel.startsWith(".." + sep) || rel === "..") {
-                this.logger.warn(
-                  `Skipping file '${file}' in '${dir}': path traversal attempt detected (resolved outside directory)`
-                );
-                continue;
-              }
-            } catch (realpathError) {
-              this.logger.warn(
-                `Skipping file '${file}' in '${dir}': unable to resolve path (${realpathError instanceof Error ? realpathError.message : String(realpathError)})`
-              );
-              continue;
-            }
-            const parsed = await this.parsePromptFile(file, dir);
-            if (seenNames.has(parsed.info.name)) {
-              this.logger.debug(
-                `Skipping duplicate prompt name '${parsed.info.name}' from ${join(
-                  dir,
-                  file
-                )}`
-              );
-              continue;
-            }
-            const storage = await this.storePromptContent(parsed.content, file);
-            if (storage.resourceUri) {
-              resourceMap.set(parsed.info.name, storage.resourceUri);
-            }
-            if (storage.inlineContent) {
-              inlineMap.set(parsed.info.name, storage.inlineContent);
-            }
-            if (storage.resourceUri || storage.inlineContent) {
-              const metadata = {
-                ...parsed.info.metadata ?? {},
-                ...storage.resourceUri && { resourceUri: storage.resourceUri }
-                // Security: Don't expose absolute sourceDir path
-                // The relative filePath in parsed.info.metadata is sufficient
-              };
-              if (Object.keys(metadata).length > 0) {
-                parsed.info = { ...parsed.info, metadata };
-              } else {
-                parsed.info = { ...parsed.info };
-                delete parsed.info.metadata;
-              }
-            }
-            cache.push(parsed.info);
-            seenNames.add(parsed.info.name);
-          } catch (error) {
-            this.logger.warn(
-              `Failed to process prompt file '${file}' in '${dir}': ${error instanceof Error ? error.message : String(error)}`
-            );
-          }
-        }
-      } catch (error) {
-        this.logger.debug(
-          `Commands directory '${dir}' not accessible: ${error instanceof Error ? error.message : String(error)}`
-        );
-      }
-    }
-    this.logger.debug(
-      `\u{1F4DD} Cached ${cache.length} file prompts from directories: ${scannedDirs.join(", ")}`
-    );
-    this.promptsCache = cache;
-    this.promptResources = resourceMap;
-    this.inlineContent = inlineMap;
-    this.cacheValid = true;
-  }
-  async parsePromptFile(fileName, baseDir) {
-    const promptName = fileName.replace(/\.md$/, "");
-    const filePath = join(baseDir, fileName);
-    const content = await readFile(filePath, "utf-8");
-    const lines = content.trim().split("\n");
-    let description = `File prompt: ${promptName}`;
-    let title = promptName;
-    let category;
-    let id;
-    let nameOverride;
-    let argumentHint;
-    let contentBody;
-    if (lines[0]?.trim() === "---") {
-      let inFrontmatter = false;
-      let frontmatterEnd = 0;
-      for (let i = 0; i < lines.length; i++) {
-        if (lines[i]?.trim() === "---") {
-          if (!inFrontmatter) {
-            inFrontmatter = true;
-          } else {
-            frontmatterEnd = i;
-            break;
-          }
-        }
-      }
-      if (frontmatterEnd > 0) {
-        const frontmatterLines = lines.slice(1, frontmatterEnd);
-        contentBody = lines.slice(frontmatterEnd + 1).join("\n");
-        for (const line of frontmatterLines) {
-          if (line.includes("description:")) {
-            const descMatch = line.match(/description:\s*(?:['"](.+)['"]|(.+))/);
-            if (descMatch) {
-              description = (descMatch[1] || descMatch[2] || "").trim();
-            }
-          } else if (line.includes("id:")) {
-            const idMatch = line.match(/id:\s*(?:['"](.+)['"]|(.+))/);
-            if (idMatch) {
-              id = (idMatch[1] || idMatch[2] || "").trim();
-            }
-          } else if (line.includes("name:")) {
-            const nameMatch = line.match(/name:\s*(?:['"](.+)['"]|(.+))/);
-            if (nameMatch) {
-              nameOverride = (nameMatch[1] || nameMatch[2] || "").trim();
-            }
-          } else if (line.includes("category:")) {
-            const categoryMatch = line.match(/category:\s*(?:['"](.+)['"]|(.+))/);
-            if (categoryMatch) {
-              category = (categoryMatch[1] || categoryMatch[2] || "").trim();
-            }
-          } else if (line.includes("argument-hint:")) {
-            const hintMatch = line.match(/argument-hint:\s*(?:['"](.+)['"]|(.+))/);
-            if (hintMatch) {
-              argumentHint = (hintMatch[1] || hintMatch[2] || "").trim();
-            }
-          }
-        }
-      }
-    }
-    if (!contentBody) {
-      contentBody = content;
-    }
-    const bodyLines = contentBody.trim().split("\n");
-    for (const line of bodyLines) {
-      if (line.trim().startsWith("#")) {
-        title = line.trim().replace(/^#+\s*/, "");
-        break;
-      }
-    }
-    const finalName = (nameOverride ?? promptName).trim();
-    assertValidPromptName(finalName, {
-      hint: "Use kebab-case in the 'name:' field or file name."
-    });
-    const parsedArguments = argumentHint ? this.parseArgumentHint(argumentHint) : void 0;
-    const relativePath = relative(baseDir, filePath);
-    const promptInfo = {
-      name: finalName,
-      title,
-      description,
-      source: "file",
-      ...parsedArguments && { arguments: parsedArguments },
-      metadata: {
-        originalName: promptName,
-        fileName,
-        // Only include relative path within the commands directory (e.g., "my-command.md")
-        // not the full path which could expose ~/.dexto or project structure
-        ...relativePath && { filePath: relativePath },
-        ...id && { id },
-        ...category && { category }
-      }
-    };
-    return { info: promptInfo, content: contentBody };
-  }
-  /**
-   * Parse argument-hint string into structured argument definitions
-   * Format: "[style] [length?]" → [{name: "style", required: true}, {name: "length", required: false}]
-   */
-  parseArgumentHint(hint) {
-    const args = [];
-    const argPattern = /\[([^\]]+)\]/g;
-    let match;
-    while ((match = argPattern.exec(hint)) !== null) {
-      const argText = match[1];
-      if (!argText) continue;
-      const isOptional = argText.endsWith("?");
-      const name = isOptional ? argText.slice(0, -1).trim() : argText.trim();
-      if (name) {
-        args.push({
-          name,
-          required: !isOptional
-        });
-      }
-    }
-    return args;
-  }
-  async storePromptContent(content, fileName) {
-    const blobService = this.resourceManager.getBlobStore();
-    if (!blobService) {
-      this.logger.warn("BlobService not available; storing prompt content in memory");
-      return { inlineContent: content };
-    }
-    const blobInput = Buffer.from(content, "utf-8");
-    const blob = await blobService.store(blobInput, {
-      mimeType: "text/markdown",
-      originalName: fileName,
-      source: "system"
-    });
-    return { resourceUri: blob.uri };
-  }
-  /**
-   * Apply arguments to a file prompt's content.
-   *
-   * Behavior mirrors Claude Code-style file prompts:
-   * - Positional placeholders ($1..$9 and $ARGUMENTS) are expanded first.
-   * - If and only if the template contains explicit placeholders ($1..$9 or $ARGUMENTS),
-   *   then we consider arguments "deconstructed in-template" and DO NOT append them again.
-   * - If the template contains no such placeholders, we append either:
-   *   - `Context: <_context>` above the content when `_context` is provided, or
-   *   - `Arguments: key: value, ...` below the content for plain named args.
-   *
-   * Notes:
-   * - The `$$` sequence is an escape for a literal dollar sign. It MUST NOT be
-   *   treated as a placeholder indicator and should not suppress argument appending.
-   */
-  applyArguments(content, args) {
-    const detectionTarget = content.replaceAll("$$", "");
-    const usesPositionalPlaceholders = /\$[1-9](?!\d)/.test(detectionTarget) || detectionTarget.includes("$ARGUMENTS");
-    const expanded = expandPlaceholders(content, args).trim();
-    if (!args || typeof args !== "object" || Object.keys(args).length === 0) {
-      return expanded;
-    }
-    if (!usesPositionalPlaceholders) {
-      if (args._context) {
-        const contextString = String(args._context);
-        return `${expanded}
-
-Context: ${contextString}`;
-      }
-      const argEntries = Object.entries(args).filter(([key]) => !key.startsWith("_"));
-      if (argEntries.length > 0) {
-        const formattedArgs = argEntries.map(([key, value]) => `${key}: ${value}`).join(", ");
-        return `${expanded}
-
-Arguments: ${formattedArgs}`;
-      }
-    }
-    return expanded;
-  }
-  // Determine default command/prompt directories based on execution context
-  resolveDefaultCommandDirs() {
-    const dirs = [];
-    const sourceRoot = findDextoSourceRoot();
-    const projectRoot = findDextoProjectRoot();
-    const localRoot = sourceRoot ?? projectRoot ?? null;
-    if (localRoot) {
-      const commandsDir = resolve(localRoot, "commands");
-      if (existsSync(commandsDir)) dirs.push(commandsDir);
-    }
-    const globalCommands = resolve(homedir(), ".dexto", "commands");
-    if (existsSync(globalCommands)) dirs.push(globalCommands);
-    if (dirs.length === 0) {
-      if (localRoot) {
-        dirs.push(resolve(localRoot, "commands"));
-      }
-      dirs.push(globalCommands);
-    }
-    return dirs;
-  }
-}
-export {
-  FilePromptProvider
-};

package/dist/prompts/providers/starter-prompt-provider.cjs

@@ -1,172 +0,0 @@
-"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 starter_prompt_provider_exports = {};
-__export(starter_prompt_provider_exports, {
-  StarterPromptProvider: () => StarterPromptProvider
-});
-module.exports = __toCommonJS(starter_prompt_provider_exports);
-var import_types = require("../../logger/v2/types.js");
-var import_errors = require("../errors.js");
-class StarterPromptProvider {
-  // Sourced from validated AgentConfig schema's starterPrompts
-  starterPrompts = [];
-  promptsCache = [];
-  cacheValid = false;
-  logger;
-  constructor(agentConfig, logger) {
-    this.logger = logger.createChild(import_types.DextoLogComponent.PROMPT);
-    this.starterPrompts = agentConfig.starterPrompts;
-    this.buildPromptsCache();
-  }
-  /**
-   * Get the source identifier for this provider
-   */
-  getSource() {
-    return "starter";
-  }
-  /**
-   * Invalidate the prompts cache
-   */
-  invalidateCache() {
-    this.cacheValid = false;
-    this.promptsCache = [];
-    this.logger.debug("StarterPromptProvider cache invalidated");
-  }
-  /**
-   * Update starter prompts configuration
-   */
-  updateConfig(agentConfig) {
-    this.starterPrompts = agentConfig.starterPrompts;
-    this.invalidateCache();
-    this.buildPromptsCache();
-  }
-  /**
-   * Build the prompts cache from starter prompts configuration
-   */
-  buildPromptsCache() {
-    const allPrompts = [];
-    this.starterPrompts.forEach((starterPrompt) => {
-      const promptName = `starter:${starterPrompt.id}`;
-      const promptInfo = {
-        name: promptName,
-        title: starterPrompt.title,
-        description: starterPrompt.description,
-        source: "starter",
-        metadata: {
-          prompt: starterPrompt.prompt,
-          category: starterPrompt.category,
-          priority: starterPrompt.priority,
-          originalId: starterPrompt.id
-        }
-      };
-      allPrompts.push(promptInfo);
-    });
-    const getPriority = (p) => {
-      const val = p.metadata?.priority;
-      return typeof val === "number" ? val : 0;
-    };
-    allPrompts.sort((a, b) => getPriority(b) - getPriority(a));
-    this.promptsCache = allPrompts;
-    this.cacheValid = true;
-    this.logger.debug(`\u{1F4DD} Cached ${allPrompts.length} starter prompts`);
-  }
-  /**
-   * List all available starter prompts
-   */
-  async listPrompts(_cursor) {
-    if (!this.cacheValid) {
-      this.buildPromptsCache();
-    }
-    return {
-      prompts: this.promptsCache
-    };
-  }
-  /**
-   * Get a specific starter prompt by name
-   */
-  async getPrompt(name, args) {
-    if (!this.cacheValid) {
-      this.buildPromptsCache();
-    }
-    const promptInfo = this.promptsCache.find((p) => p.name === name);
-    if (!promptInfo) {
-      throw import_errors.PromptError.notFound(name);
-    }
-    const rawPrompt = promptInfo.metadata?.prompt;
-    if (typeof rawPrompt !== "string" || rawPrompt.trim().length === 0) {
-      throw import_errors.PromptError.missingText();
-    }
-    const promptText = rawPrompt;
-    this.logger.debug(`\u{1F4DD} Reading starter prompt: ${name}`);
-    let content = promptText;
-    if (args && typeof args === "object") {
-      const hasPositionalPlaceholders = /\$[1-9]/.test(content) || content.includes("$ARGUMENTS");
-      if (!hasPositionalPlaceholders) {
-        if (args._context) {
-          const contextString = String(args._context);
-          content = `${content}
-
-Context: ${contextString}`;
-        } else {
-          const argEntries = Object.entries(args).filter(([k]) => !k.startsWith("_"));
-          if (argEntries.length > 0) {
-            const argContext = argEntries.map(([k, v]) => `${k}: ${v}`).join(", ");
-            content = `${content}
-
-Arguments: ${argContext}`;
-          }
-        }
-      }
-    }
-    return {
-      description: promptInfo.description,
-      messages: [
-        {
-          role: "user",
-          content: {
-            type: "text",
-            text: content
-          }
-        }
-      ]
-    };
-  }
-  /**
-   * Get prompt definition (metadata only)
-   */
-  async getPromptDefinition(name) {
-    if (!this.cacheValid) {
-      this.buildPromptsCache();
-    }
-    const promptInfo = this.promptsCache.find((p) => p.name === name);
-    if (!promptInfo) {
-      return null;
-    }
-    return {
-      name: promptInfo.name,
-      ...promptInfo.title && { title: promptInfo.title },
-      ...promptInfo.description && { description: promptInfo.description },
-      ...promptInfo.arguments && { arguments: promptInfo.arguments }
-    };
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  StarterPromptProvider
-});

package/dist/prompts/providers/starter-prompt-provider.d.ts

@@ -1,47 +0,0 @@
-import type { PromptProvider, PromptDefinition, PromptListResult } from '../types.js';
-import type { GetPromptResult } from '@modelcontextprotocol/sdk/types.js';
-import type { ValidatedAgentConfig } from '../../agent/schemas.js';
-import type { IDextoLogger } from '../../logger/v2/types.js';
-/**
- * Starter Prompt Provider - Provides prompts from agent configuration starter prompts
- *
- * This provider exposes starter prompts defined in the agent configuration as regular prompts.
- * Starter prompts are intended for quick access to common user workflows and are typically
- * displayed prominently in the UI.
- */
-export declare class StarterPromptProvider implements PromptProvider {
-    private starterPrompts;
-    private promptsCache;
-    private cacheValid;
-    private logger;
-    constructor(agentConfig: ValidatedAgentConfig, logger: IDextoLogger);
-    /**
-     * Get the source identifier for this provider
-     */
-    getSource(): string;
-    /**
-     * Invalidate the prompts cache
-     */
-    invalidateCache(): void;
-    /**
-     * Update starter prompts configuration
-     */
-    updateConfig(agentConfig: ValidatedAgentConfig): void;
-    /**
-     * Build the prompts cache from starter prompts configuration
-     */
-    private buildPromptsCache;
-    /**
-     * List all available starter prompts
-     */
-    listPrompts(_cursor?: string): Promise<PromptListResult>;
-    /**
-     * Get a specific starter prompt by name
-     */
-    getPrompt(name: string, args?: Record<string, unknown>): Promise<GetPromptResult>;
-    /**
-     * Get prompt definition (metadata only)
-     */
-    getPromptDefinition(name: string): Promise<PromptDefinition | null>;
-}
-//# sourceMappingURL=starter-prompt-provider.d.ts.map

package/dist/prompts/providers/starter-prompt-provider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"starter-prompt-provider.d.ts","sourceRoot":"","sources":["../../../src/prompts/providers/starter-prompt-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAc,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAClG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAM7D;;;;;;GAMG;AACH,qBAAa,qBAAsB,YAAW,cAAc;IAExD,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,MAAM,CAAe;gBAEjB,WAAW,EAAE,oBAAoB,EAAE,MAAM,EAAE,YAAY;IAOnE;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,eAAe,IAAI,IAAI;IAMvB;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,oBAAoB,GAAG,IAAI;IAMrD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;OAEG;IACG,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAU9D;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;IAmDvF;;OAEG;IACG,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;CAiB5E"}