@elizaos/prompts 2.0.3-beta.2 → 2.0.3-beta.4

package/README.md

@@ -16,7 +16,6 @@ packages/prompts/
 └── scripts/          # Spec + docs generators
     ├── generate-action-docs.js
     ├── generate-plugin-action-spec.js
-    ├── prompt-compression.js
     └── check-secrets.js
 ```
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@elizaos/prompts",
   "private": false,
-  "version": "2.0.3-beta.2",
+  "version": "2.0.3-beta.4",
   "description": "Shared prompt templates for elizaOS across TypeScript, Python, and Rust",
   "type": "module",
   "main": "./src/index.ts",
@@ -46,5 +46,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "82fe0f44215954c2417328203f5bd6510985c1fc"
+  "gitHead": "f76f55793a0fb8d6b869dd8ddce03970de061e34"
 }

package/scripts/generate-action-docs.js

@@ -3,8 +3,8 @@ import { execFileSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { compressPromptDescription } from "../src/prompt-compression.ts";
 import { ensureDirectory, readJson } from "./file-utils.js";
-import { compressPromptDescription } from "./prompt-compression.js";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);

package/scripts/generate-plugin-action-spec.js

@@ -1143,6 +1143,79 @@ function extractConstLiterals(src) {
   return constants;
 }
 
+function readArrayLiteralAfter(src, marker) {
+  const markerIndex = src.indexOf(marker);
+  if (markerIndex < 0) return [];
+  const bracketStart = src.indexOf("[", markerIndex);
+  if (bracketStart < 0) return [];
+  const source = readBalancedArraySource(src, bracketStart);
+  if (!source) return [];
+  const parsed = parseTsLiteralValue(source, 0);
+  return Array.isArray(parsed.value) ? parsed.value : [];
+}
+
+function dynamicCommandActionDocs(filePath, name) {
+  const relativePath = path.relative(REPO_ROOT, filePath);
+  const commandActionNameTemplate = "$" + "{key.toUpperCase()}_COMMAND";
+  if (
+    relativePath !==
+      path.join(
+        "plugins",
+        "plugin-commands",
+        "src",
+        "actions",
+        "command-actions.ts",
+      ) ||
+    name !== commandActionNameTemplate
+  ) {
+    return null;
+  }
+
+  const pluginCommandsRoot = path.join(PLUGINS_ROOT, "plugin-commands");
+  const handlersSrc = readText(
+    path.join(pluginCommandsRoot, "src", "actions", "handlers.ts"),
+  );
+  const deterministicCommandKeys = extractConstLiterals(handlersSrc).get(
+    "DETERMINISTIC_COMMAND_KEYS",
+  );
+  if (!Array.isArray(deterministicCommandKeys)) return [];
+
+  const registrySrc = readText(
+    path.join(pluginCommandsRoot, "src", "registry.ts"),
+  );
+  const commandDefinitions = readArrayLiteralAfter(
+    registrySrc,
+    "DEFAULT_COMMANDS",
+  );
+  const definitionsByKey = new Map();
+  for (const definition of commandDefinitions) {
+    if (isRecordValue(definition) && typeof definition.key === "string") {
+      definitionsByKey.set(definition.key, definition);
+    }
+  }
+
+  return deterministicCommandKeys
+    .filter((key) => typeof key === "string")
+    .map((key) => {
+      const definition = definitionsByKey.get(key);
+      const aliases = Array.isArray(definition?.textAliases)
+        ? definition.textAliases.filter((alias) => typeof alias === "string")
+        : [];
+      const doc = {
+        name: `${key.toUpperCase()}_COMMAND`,
+        description:
+          typeof definition?.description === "string"
+            ? definition.description
+            : "",
+        parameters: sanitizeParameters(definition?.args),
+      };
+      if (aliases.length > 0) {
+        doc.similes = aliases;
+      }
+      return doc;
+    });
+}
+
 function resolveRequireActionSpecName(src, source) {
   const match = source.trim().match(/^([A-Za-z_$][A-Za-z0-9_$]*)\.name$/);
   if (!match) return null;
@@ -1567,6 +1640,15 @@ function main() {
       if (!isRegisteredActionObject(filePath, obj.exportName)) continue;
       if (RETIRED_IMPLEMENTATION_ONLY_ACTIONS.has(name)) continue;
       if (coreActionNames.has(name)) continue;
+      const dynamicDocs = dynamicCommandActionDocs(filePath, name);
+      if (dynamicDocs) {
+        for (const doc of dynamicDocs) {
+          if (!actionDocsByName.has(doc.name)) {
+            actionDocsByName.set(doc.name, doc);
+          }
+        }
+        continue;
+      }
       const description = expandDescriptionTemplateLiterals(
         extractTopLevelStringProp(obj.objectText, "description") ?? "",
         filePath,

package/src/index.ts

@@ -1,3 +1,5 @@
+export { compressPromptDescription } from "./prompt-compression";
+
 export const addContactTemplate = `task: Extract contact information to add to relationships.
 
 context:

package/{scripts/prompt-compression.js → src/prompt-compression.ts}

@@ -6,9 +6,9 @@ const PROTECTED_PATTERNS = [
   /\bhttps?:\/\/[^\s)]+/g,
   /(^|[\s([{:=,])((?:\.{1,2}\/|\/|~\/)[A-Za-z0-9._~:/?#[\]@!$&'()*+,;=%-]+)/g,
   /\b[A-Z][A-Z0-9_]{2,}\b/g,
-];
+] as const;
 
-const PHRASE_REPLACEMENTS = [
+const PHRASE_REPLACEMENTS: Array<[RegExp, string]> = [
   [/\bin order to\b/gi, "to"],
   [/\b(?:please|simply|basically|actually|currently)\b/gi, ""],
   [/\bthis (?:action|provider|evaluator) (?:will|can|should)\b/gi, ""],
@@ -33,7 +33,7 @@ const PHRASE_REPLACEMENTS = [
   [/\bwhich is\b/gi, ""],
 ];
 
-const WORD_REPLACEMENTS = [
+const WORD_REPLACEMENTS: Array<[RegExp, string]> = [
   [/\bmessages\b/gi, "msgs"],
   [/\bmessage\b/gi, "msg"],
   [/\binformation\b/gi, "info"],
@@ -57,7 +57,7 @@ const WORD_REPLACEMENTS = [
   [/\bwithout\b/gi, "without"],
 ];
 
-const LEADING_VERB_REPLACEMENTS = [
+const LEADING_VERB_REPLACEMENTS: Array<[RegExp, string]> = [
   [/^Provides\b/i, "Provide"],
   [/^Retrieves\b/i, "Get"],
   [/^Returns\b/i, "Return"],
@@ -73,22 +73,25 @@ const LEADING_VERB_REPLACEMENTS = [
   [/^Automatically\b/i, "Auto"],
 ];
 
-function normalizeWhitespace(value) {
+function normalizeWhitespace(value: string): string {
   return value.trim().split(/\s+/).filter(Boolean).join(" ");
 }
 
-function protectTechnicalSpans(value) {
-  const protectedValues = [];
+function protectTechnicalSpans(value: string): {
+  text: string;
+  restore: (text: string) => string;
+} {
+  const protectedValues: string[] = [];
   let text = value;
 
-  const protect = (span) => {
+  const protect = (span: string): string => {
     const token = `__elizaProtected${protectedValues.length}__`;
     protectedValues.push(span);
     return token;
   };
 
   for (const pattern of PROTECTED_PATTERNS) {
-    text = text.replace(pattern, (...args) => {
+    text = text.replace(pattern, (...args: string[]) => {
       if (pattern.source.startsWith("(^|")) {
         const prefix = args[1] ?? "";
         const span = args[2] ?? "";
@@ -100,15 +103,15 @@ function protectTechnicalSpans(value) {
 
   return {
     text,
-    restore: (restoredText) =>
+    restore: (restoredText: string) =>
       restoredText.replace(
         /__elizaProtected(\d+)__/g,
-        (_match, index) => protectedValues[Number(index)] ?? "",
+        (_match, index: string) => protectedValues[Number(index)] ?? "",
       ),
   };
 }
 
-function truncateDescription(value) {
+function truncateDescription(value: string): string {
   if (value.length <= MAX_DESCRIPTION_LENGTH) {
     return value;
   }
@@ -132,7 +135,14 @@ function truncateDescription(value) {
   return `${trimmed}...`;
 }
 
-export function compressPromptDescription(description) {
+/**
+ * Deterministic compact description text for model-facing action/provider docs.
+ * Preserves code spans, URLs, paths, commands, env vars, and technical terms
+ * while dropping common filler.
+ */
+export function compressPromptDescription(
+  description: string | undefined,
+): string {
   if (typeof description !== "string" || !description.trim()) {
     return "";
   }