veryfront 0.1.1176 → 0.1.1177

package/esm/cli/commands/skills/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/skills/validate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAOxD,UAAU,eAAe;IACvB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAKnE;AAED,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAuBpF"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/skills/validate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAOxD,UAAU,eAAe;IACvB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAKnE;AAED,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAyBpF"}

package/esm/cli/commands/skills/validate.js

@@ -6,8 +6,8 @@
 import { createSuccessEnvelope, isJsonMode, outputJson } from "../../shared/json-output.js";
 import { exitProcess, logError, logSuccess, logWarning } from "../../utils/index.js";
 import { createFileSystem } from "../../../src/platform/index.js";
-import { basename } from "../../../deps/jsr.io/@std/path/1.1.4/mod.js";
-import { parseSkillFrontmatter, validateSkillMetadata } from "../../../src/skill/index.js";
+import { basename, resolve } from "../../../deps/jsr.io/@std/path/1.1.4/mod.js";
+import { parseSkillFrontmatter, SKILL_NAME_REGEX, validateSkillMetadata } from "../../../src/skill/index.js";
 export async function validateSkill(args) {
     const dir = args._[2] ?? ".";
     const issues = await validateSkillDirectory(dir);
@@ -25,7 +25,9 @@ export async function validateSkillDirectory(dir) {
     }
     try {
         const parsed = await parseSkillFrontmatter(content);
-        validateSkillMetadata(parsed.frontmatter, basename(dir));
+        const directoryName = basename(resolve(dir));
+        validateCanonicalFrontmatterName(parsed.frontmatter, directoryName);
+        validateSkillMetadata(parsed.frontmatter, directoryName);
         if (!parsed.body.trim()) {
             issues.push({ severity: "warning", message: "SKILL.md body is empty" });
         }
@@ -36,6 +38,17 @@ export async function validateSkillDirectory(dir) {
     }
     return issues;
 }
+function validateCanonicalFrontmatterName(frontmatter, directoryName) {
+    if (typeof frontmatter.name !== "string")
+        return;
+    const name = frontmatter.name.trim();
+    if (!SKILL_NAME_REGEX.test(name)) {
+        return;
+    }
+    if (name !== directoryName) {
+        throw new Error(`Skill name "${name}" does not match directory name "${directoryName}"`);
+    }
+}
 async function outputResults(dir, issues) {
     const hasErrors = issues.some((i) => i.severity === "error");
     if (isJsonMode()) {

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.1176",
+    "version": "0.1.1177",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "minimumDependencyAge": {

package/esm/src/agent/runtime/skill-metadata.d.ts

@@ -4,6 +4,7 @@ export interface RuntimeSkillFrontmatter {
     name: string | undefined;
     description: string | undefined;
     allowedTools: string[];
+    metadata: Record<string, string> | undefined;
     model: string | undefined;
     thinking: false | number | undefined;
     maxSteps: number | undefined;
@@ -17,9 +18,11 @@ export declare const RuntimeSkillFrontmatterSchema: import("../../internal-agent
 export type RuntimeSkillDefinition = {
     id: string;
     name: string;
+    displayName?: string;
     description: string;
     instructions: string;
     allowedTools: string[];
+    metadata?: Record<string, string>;
     model?: string;
     thinking?: false | number;
     maxSteps?: number;

package/esm/src/agent/runtime/skill-metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-metadata.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/skill-metadata.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skill-metadata.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/skill-metadata.ts"],"names":[],"mappings":"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"}

package/esm/src/agent/runtime/skill-metadata.js

@@ -1,6 +1,7 @@
 import { extract } from "../../platform/compat/std/front-matter-yaml.js";
 import { defineSchema, lazySchema } from "../../schemas/index.js";
 import { assertResolvedSkillSelector, resolveSkillSelector, } from "../../skill/selector.js";
+import { SKILL_NAME_REGEX, SKILL_PROVIDER_SAFE_ID_REGEX } from "../../skill/types.js";
 function normalizeAllowedTools(value) {
     if (value === undefined) {
         return [];
@@ -19,22 +20,42 @@ export const getRuntimeSkillFrontmatterSchema = defineSchema((v) => v
     "allowed-tools": v.union([v.string(), v.array(v.string())]).optional(),
     allowed_tools: v.union([v.string(), v.array(v.string())]).optional(),
     model: v.string().optional(),
+    metadata: v.record(v.string(), v.unknown()).optional(),
     thinking: v.union([v.literal(false), v.coerce.number().int().positive()]).optional(),
     "max-steps": v.coerce.number().int().positive().optional(),
 })
     .passthrough()
     .transform((data) => {
     const d = data;
+    const metadata = normalizeMetadata(d.metadata);
     return {
-        name: (typeof d.name === "string" ? d.name.trim() : undefined) || undefined,
+        name: normalizeOptionalString(d.name),
         description: (typeof d.description === "string" ? d.description.trim() : undefined) ||
             undefined,
         allowedTools: normalizeAllowedTools((d["allowed-tools"] ?? d.allowed_tools)),
+        metadata,
         model: (typeof d.model === "string" ? d.model.trim() : undefined) || undefined,
         thinking: d.thinking,
         maxSteps: d["max-steps"],
     };
 }));
+function normalizeOptionalString(value) {
+    return (typeof value === "string" ? value.trim() : undefined) || undefined;
+}
+function normalizeMetadata(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    const entries = Object.entries(value);
+    if (entries.length === 0) {
+        return undefined;
+    }
+    const metadata = {};
+    for (const [key, rawValue] of entries) {
+        metadata[key] = String(rawValue);
+    }
+    return metadata;
+}
 /** Schema for runtime skill frontmatter.
  * @deprecated Use getRuntimeSkillFrontmatterSchema()
  */
@@ -150,17 +171,34 @@ export function parseRuntimeSkillMetadata(content, options = {}) {
 }
 /** Definition for build runtime skill. */
 export function buildRuntimeSkillDefinition(input) {
+    if (!isRuntimeSkillIdValid(input)) {
+        input.logger?.error?.("Invalid skill id; skipping skill", {
+            id: input.id,
+            error: input.ownerAgentId === undefined && input.shortName === undefined
+                ? "must be lowercase alphanumeric with hyphens, 1-64 characters"
+                : "must be provider-safe letters, numbers, underscores, or hyphens, 1-64 characters",
+        });
+        return null;
+    }
     const document = parseRuntimeSkillDocument(input.content, { logger: input.logger });
     if (!document) {
         return null;
     }
     const { metadata, body } = document;
+    const canonicalName = input.id;
+    const explicitDisplayName = metadata.metadata?.display_name?.trim() || undefined;
+    const legacyDisplayName = metadata.name && metadata.name !== canonicalName
+        ? metadata.name
+        : undefined;
+    const displayName = explicitDisplayName ?? legacyDisplayName;
     return {
         id: input.id,
-        name: metadata.name ?? input.id,
+        name: canonicalName,
+        ...(displayName ? { displayName } : {}),
         description: metadata.description ?? extractDescriptionFromMarkdown(body, input.id),
         instructions: input.content,
         allowedTools: metadata.allowedTools,
+        ...(metadata.metadata ? { metadata: metadata.metadata } : {}),
         ...(metadata.model ? { model: metadata.model } : {}),
         ...(metadata.thinking !== undefined ? { thinking: metadata.thinking } : {}),
         ...(metadata.maxSteps !== undefined ? { maxSteps: metadata.maxSteps } : {}),
@@ -172,6 +210,12 @@ export function buildRuntimeSkillDefinition(input) {
         ...(input.sourcePath === undefined ? {} : { sourcePath: input.sourcePath }),
     };
 }
+function isRuntimeSkillIdValid(input) {
+    if (input.ownerAgentId !== undefined || input.shortName !== undefined) {
+        return SKILL_PROVIDER_SAFE_ID_REGEX.test(input.id);
+    }
+    return SKILL_NAME_REGEX.test(input.id);
+}
 /** Normalizes runtime skill reference path. */
 export function normalizeRuntimeSkillReferencePath(path) {
     const normalized = path.trim().replaceAll("\\", "/");

package/esm/src/agent/runtime/skill-prompt.js

@@ -43,7 +43,7 @@ export function formatRuntimeSkillMetadata(skill) {
     return details.length > 0 ? ` (${details.join("; ")})` : "";
 }
 function formatRuntimeSkillLabel(skill) {
-    return skill.name === skill.id ? skill.id : `${skill.name} (\`${skill.id}\`)`;
+    return skill.displayName ? `${skill.displayName} (\`${skill.id}\`)` : skill.id;
 }
 /** Builds runtime available skills prompt block. */
 export function buildRuntimeAvailableSkillsPromptBlock(skills, options = {}) {

package/esm/src/discovery/agent-scoped-capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-scoped-capabilities.d.ts","sourceRoot":"","sources":["../../../src/src/discovery/agent-scoped-capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAkBH,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIxE,2EAA2E;AAC3E,eAAO,MAAM,oCAAoC,OAAO,CAAC;AAIzD,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,oEAAoE;AACpE,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,iEAAiE;AACjE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAInF;AAoDD,uEAAuE;AACvE,MAAM,MAAM,uCAAuC,GAAG;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,uCAAuC,GAC7C,OAAO,CAAC,MAAM,EAAE,CAAC,CAgEnB;AA4BD;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,uCAAuC,GAC7C,OAAO,CAAC,MAAM,EAAE,CAAC,CAwDnB"}
+{"version":3,"file":"agent-scoped-capabilities.d.ts","sourceRoot":"","sources":["../../../src/src/discovery/agent-scoped-capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAkBH,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIxE,2EAA2E;AAC3E,eAAO,MAAM,oCAAoC,OAAO,CAAC;AAIzD,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5D;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,oEAAoE;AACpE,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,iEAAiE;AACjE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAInF;AAoDD,uEAAuE;AACvE,MAAM,MAAM,uCAAuC,GAAG;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,uCAAuC,GAC7C,OAAO,CAAC,MAAM,EAAE,CAAC,CAgEnB;AA8BD;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,uCAAuC,GAC7C,OAAO,CAAC,MAAM,EAAE,CAAC,CAwDnB"}

package/esm/src/discovery/agent-scoped-capabilities.js

@@ -158,7 +158,9 @@ async function buildSkillFromDir(input) {
     }
     const content = await readDiscoveryTextFile(skillMdPath, input.context);
     const parsed = await parseSkillFrontmatter(content);
-    const metadata = validateSkillMetadata(parsed.frontmatter, input.id);
+    const metadata = validateSkillMetadata(parsed.frontmatter, input.id, {
+        providerSafeName: true,
+    });
     return {
         id: input.id,
         metadata,

package/esm/src/discovery/handlers/skill-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-handler.d.ts","sourceRoot":"","sources":["../../../../src/src/discovery/handlers/skill-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAIxD,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;CACd;AAED,UAAU,oBAAoB;IAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3B,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,oBAAoB,CAAC,CAkF/B"}
+{"version":3,"file":"skill-handler.d.ts","sourceRoot":"","sources":["../../../../src/src/discovery/handlers/skill-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAIxD,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;CACd;AAED,UAAU,oBAAoB;IAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3B,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,oBAAoB,CAAC,CA8E/B"}

package/esm/src/discovery/handlers/skill-handler.js

@@ -55,11 +55,9 @@ export async function discoverSkills(dir, context, verbose) {
             const parsed = await parseSkillFrontmatter(content);
             // Validate metadata (directory name as fallback for skill name)
             const metadata = validateSkillMetadata(parsed.frontmatter, entry.name);
-            // Warn if metadata name differs from directory name, use directory name as ID
+            // The directory is the canonical identity; legacy/display-style names
+            // are preserved only as display metadata.
             const skillId = entry.name;
-            if (metadata.name !== entry.name) {
-                logger.warn(`Skill "${metadata.name}" in directory "${entry.name}" — using directory name as ID`);
-            }
             // Check for duplicate IDs (first wins)
             if (skills.has(skillId)) {
                 logger.warn(`Duplicate skill "${skillId}" — keeping first registration`);

package/esm/src/skill/parser.d.ts

@@ -26,6 +26,8 @@ export declare function parseSkillFrontmatter(content: string): Promise<ParsedSk
  * @param frontmatter - Parsed frontmatter object
  * @param directoryName - Directory name used as fallback for skill name
  */
-export declare function validateSkillMetadata(frontmatter: Record<string, unknown>, directoryName: string): SkillMetadata;
+export declare function validateSkillMetadata(frontmatter: Record<string, unknown>, directoryName: string, options?: {
+    providerSafeName?: boolean;
+}): SkillMetadata;
 export {};
 //# sourceMappingURL=parser.d.ts.map

package/esm/src/skill/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/src/skill/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAkD,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhG,wCAAwC;AACxC,UAAU,kBAAkB;IAC1B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAYxF;AA+BD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,aAAa,EAAE,MAAM,GACpB,aAAa,CAkDf"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/src/skill/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAEpB,wCAAwC;AACxC,UAAU,kBAAkB;IAC1B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAYxF;AA+BD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3C,aAAa,CA0Df"}

package/esm/src/skill/parser.js

@@ -9,7 +9,7 @@
  */
 import { createError, toError } from "../errors/index.js";
 import { validateAllowedToolPatterns } from "./allowed-tools.js";
-import { SKILL_DESCRIPTION_MAX_LENGTH, SKILL_NAME_REGEX } from "./types.js";
+import { SKILL_DESCRIPTION_MAX_LENGTH, SKILL_NAME_REGEX, SKILL_PROVIDER_SAFE_ID_REGEX, } from "./types.js";
 /**
  * Parse SKILL.md content into frontmatter + body.
  *
@@ -60,27 +60,31 @@ function parseFrontmatterFallback(content) {
  * @param frontmatter - Parsed frontmatter object
  * @param directoryName - Directory name used as fallback for skill name
  */
-export function validateSkillMetadata(frontmatter, directoryName) {
-    // Name: from frontmatter or directory name
-    const rawName = typeof frontmatter.name === "string" ? frontmatter.name.trim() : directoryName;
-    if (!SKILL_NAME_REGEX.test(rawName)) {
+export function validateSkillMetadata(frontmatter, directoryName, options = {}) {
+    const canonicalName = directoryName;
+    const nameRegex = options.providerSafeName ? SKILL_PROVIDER_SAFE_ID_REGEX : SKILL_NAME_REGEX;
+    const nameExpectation = options.providerSafeName
+        ? "must be provider-safe letters, numbers, underscores, or hyphens, 1-64 characters"
+        : "must be lowercase alphanumeric with hyphens, 1-64 characters";
+    if (!nameRegex.test(canonicalName)) {
         throw toError(createError({
             type: "agent",
-            message: `Invalid skill name "${rawName}": must be lowercase alphanumeric with hyphens, 1-64 characters`,
+            message: `Invalid skill name "${canonicalName}": ${nameExpectation}`,
         }));
     }
+    const rawName = typeof frontmatter.name === "string" ? frontmatter.name.trim() : undefined;
     // Description: required
     const rawDescription = frontmatter.description;
     if (!rawDescription || typeof rawDescription !== "string" || !rawDescription.trim()) {
         throw toError(createError({
             type: "agent",
-            message: `Skill "${rawName}" is missing a required "description" field`,
+            message: `Skill "${canonicalName}" is missing a required "description" field`,
         }));
     }
     const description = rawDescription.trim().slice(0, SKILL_DESCRIPTION_MAX_LENGTH);
     // Allowed-tools: parse from space-delimited string or array
     const allowedToolPatterns = frontmatter["allowed-tools"] ?? frontmatter.allowed_tools;
-    const allowedTools = parseAllowedTools(allowedToolPatterns, rawName);
+    const allowedTools = parseAllowedTools(allowedToolPatterns, canonicalName);
     // License: optional string passthrough
     const license = typeof frontmatter.license === "string" ? frontmatter.license.trim() : undefined;
     // Compatibility: optional string passthrough
@@ -89,8 +93,12 @@ export function validateSkillMetadata(frontmatter, directoryName) {
         : undefined;
     // Metadata: convert nested object values to strings
     const metadata = parseMetadata(frontmatter.metadata);
+    const explicitDisplayName = getMetadataDisplayName(metadata);
+    const legacyDisplayName = rawName && rawName !== canonicalName ? rawName : undefined;
+    const displayName = explicitDisplayName ?? legacyDisplayName;
     return {
-        name: rawName,
+        name: canonicalName,
+        ...(displayName && { displayName }),
         description,
         ...(allowedTools && { allowedTools }),
         ...(license && { license }),
@@ -98,6 +106,10 @@ export function validateSkillMetadata(frontmatter, directoryName) {
         ...(metadata && { metadata }),
     };
 }
+function getMetadataDisplayName(metadata) {
+    const displayName = metadata?.display_name?.trim();
+    return displayName ? displayName : undefined;
+}
 /**
  * Parse `allowed-tools` from frontmatter.
  * Accepts a space-delimited string or an array of strings.

package/esm/src/skill/prompt-augmentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt-augmentation.d.ts","sourceRoot":"","sources":["../../../src/src/skill/prompt-augmentation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,mEAAmE;AACnE,eAAO,MAAM,iCAAiC,KAAK,CAAC;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,CA0C3E"}
+{"version":3,"file":"prompt-augmentation.d.ts","sourceRoot":"","sources":["../../../src/src/skill/prompt-augmentation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,mEAAmE;AACnE,eAAO,MAAM,iCAAiC,KAAK,CAAC;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,CA2C3E"}

package/esm/src/skill/prompt-augmentation.js

@@ -27,7 +27,8 @@ export function buildSkillManifestPrompt(skills) {
     ];
     let displayedSkillCount = 0;
     for (const [id, skill] of skills) {
-        lines.push(`- **${id}**: ${skill.metadata.description}`);
+        const label = skill.metadata.displayName ? `${skill.metadata.displayName} (\`${id}\`)` : id;
+        lines.push(`- **${label}**: ${skill.metadata.description}`);
         displayedSkillCount += 1;
         if (displayedSkillCount === MAX_SKILL_MANIFEST_PROMPT_ENTRIES) {
             break;

package/esm/src/skill/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/src/skill/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAQnE,OAAO,KAAK,EAAuB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAa3E,KAAK,wBAAwB,GAAG;IAC9B,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,KAAK,SAAS,MAAM,EAAE,CAAC;CAC3F,CAAC;AA2KF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,wBAA6B,GAAG,IAAI,CAkDhF;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,wBAA6B,GAAG,IAAI,CA+BzF;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,mBAAmB,CAAA;CAAE,GAAG,wBAA6B,GAC1E,IAAI,CAuCN"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/src/skill/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAQnE,OAAO,KAAK,EAAuB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAe3E,KAAK,wBAAwB,GAAG;IAC9B,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,KAAK,SAAS,MAAM,EAAE,CAAC;CAC3F,CAAC;AAgMF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,wBAA6B,GAAG,IAAI,CAkDhF;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,wBAA6B,GAAG,IAAI,CA+BzF;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,mBAAmB,CAAA;CAAE,GAAG,wBAA6B,GAC1E,IAAI,CAuCN"}

package/esm/src/skill/tools.js

@@ -17,7 +17,7 @@ import { skillRegistry } from "./registry.js";
 import { parseSkillFrontmatter } from "./parser.js";
 import { listSkillSubdir, validateSkillPath } from "./path-safety.js";
 import { getSkillScriptExecutor } from "./executor.js";
-import { SKILL_ASSETS_DIR, SKILL_MD_FILENAME, SKILL_REFERENCES_DIR, SKILL_RESOURCES_DIR, SKILL_SCRIPTS_DIR, } from "./types.js";
+import { SKILL_ASSETS_DIR, SKILL_MD_FILENAME, SKILL_NAME_REGEX, SKILL_PROVIDER_SAFE_ID_REGEX, SKILL_REFERENCES_DIR, SKILL_RESOURCES_DIR, SKILL_SCRIPTS_DIR, } from "./types.js";
 /** Maximum allowed script execution timeout in milliseconds (5 minutes) */
 const MAX_SCRIPT_TIMEOUT_MS = 300_000;
 const getLoadSkillInputSchema = defineSchema((v) => v.object({
@@ -63,18 +63,33 @@ function resolveVisibleSkillOrThrow(skillId, context, options = {}) {
     const scope = { agentId: context?.agentId };
     const allowedSkillIds = getSelectorAllowedSkillIds(context, options);
     const skill = skillRegistry.resolveVisibleSkill(skillId, scope);
-    if (!skill) {
-        if (allowedSkillIds !== undefined) {
-            throw createSkillUnavailableError();
-        }
-        const visible = skillRegistry.getVisibleSkillIds(scope).join(", ");
+    if (skill) {
+        assertSkillAllowedBySelector(skill, allowedSkillIds);
+        return skill;
+    }
+    if (allowedSkillIds !== undefined) {
+        throw createSkillUnavailableError();
+    }
+    if (!isUnresolvedSkillSelectorValid(skillId)) {
+        const expectation = skillId.includes("--")
+            ? "must be provider-safe letters, numbers, underscores, or hyphens, 1-64 characters"
+            : "must be lowercase alphanumeric with hyphens, 1-64 characters";
         throw toError(createError({
             type: "agent",
-            message: `Skill "${skillId}" not found. Available skills: ${visible || "none"}`,
+            message: `Invalid skill id "${skillId}": ${expectation}`,
         }));
     }
-    assertSkillAllowedBySelector(skill, allowedSkillIds);
-    return skill;
+    const visible = skillRegistry.getVisibleSkillIds(scope).join(", ");
+    throw toError(createError({
+        type: "agent",
+        message: `Skill "${skillId}" not found. Available skills: ${visible || "none"}`,
+    }));
+}
+function isUnresolvedSkillSelectorValid(skillId) {
+    if (SKILL_NAME_REGEX.test(skillId)) {
+        return true;
+    }
+    return skillId.includes("--") && SKILL_PROVIDER_SAFE_ID_REGEX.test(skillId);
 }
 function createSkillUnavailableError() {
     return toError(createError({

package/esm/src/skill/types.d.ts

@@ -9,6 +9,8 @@
 import type { FileSystemAdapter } from "../platform/adapters/base.js";
 /** Valid skill name: lowercase alphanumeric + hyphens, 1-64 chars */
 export declare const SKILL_NAME_REGEX: RegExp;
+/** Provider-safe owned skill id: sanitized namespace + short name, max 64 chars */
+export declare const SKILL_PROVIDER_SAFE_ID_REGEX: RegExp;
 /** Valid allowed-tool pattern: exact ID or prefix wildcard (e.g. "api:*") */
 export declare const SKILL_ALLOWED_TOOL_PATTERN_REGEX: RegExp;
 /** Maximum description length in characters */
@@ -26,6 +28,8 @@ export declare const SKILL_ASSETS_DIR = "assets";
 export interface SkillMetadata {
     /** Skill identifier (lowercase, hyphenated) */
     name: string;
+    /** Optional human-readable label; never used for skill lookup/reference. */
+    displayName?: string;
     /** Human-readable description */
     description: string;
     /** Tool access restrictions (space-delimited in YAML, parsed to array) */

package/esm/src/skill/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/skill/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAItE,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,QAA8B,CAAC;AAE5D,6EAA6E;AAC7E,eAAO,MAAM,gCAAgC,QACiB,CAAC;AAE/D,+CAA+C;AAC/C,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAE5C,wEAAwE;AACxE,eAAO,MAAM,cAAc,aAIzB,CAAC;AAEH,sCAAsC;AACtC,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAC/C,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAIzC,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qCAAqC;IACrC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kCAAkC;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,gCAAgC;AAChC,MAAM,WAAW,KAAK;IACpB,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,QAAQ,EAAE,aAAa,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,oCAAoC;AACpC,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,gCAAgC;AAChC,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACtE;AAED,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/skill/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAItE,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,QAA8B,CAAC;AAE5D,mFAAmF;AACnF,eAAO,MAAM,4BAA4B,QAA0B,CAAC;AAEpE,6EAA6E;AAC7E,eAAO,MAAM,gCAAgC,QACiB,CAAC;AAE/D,+CAA+C;AAC/C,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAE5C,wEAAwE;AACxE,eAAO,MAAM,cAAc,aAIzB,CAAC;AAEH,sCAAsC;AACtC,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAC/C,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAIzC,gDAAgD;AAChD,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qCAAqC;IACrC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kCAAkC;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,gCAAgC;AAChC,MAAM,WAAW,KAAK;IACpB,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,QAAQ,EAAE,aAAa,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,oCAAoC;AACpC,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,gCAAgC;AAChC,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACtE;AAED,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB"}

package/esm/src/skill/types.js

@@ -9,6 +9,8 @@
 // ── Constants ───────────────────────────────────────────────────────────
 /** Valid skill name: lowercase alphanumeric + hyphens, 1-64 chars */
 export const SKILL_NAME_REGEX = /^[a-z0-9][a-z0-9-]{0,63}$/;
+/** Provider-safe owned skill id: sanitized namespace + short name, max 64 chars */
+export const SKILL_PROVIDER_SAFE_ID_REGEX = /^[A-Za-z0-9_-]{1,64}$/;
 /** Valid allowed-tool pattern: exact ID or prefix wildcard (e.g. "api:*") */
 export const SKILL_ALLOWED_TOOL_PATTERN_REGEX = /^[A-Za-z][A-Za-z0-9._-]*(:[A-Za-z][A-Za-z0-9._-]*)*(:\*)?$/;
 /** Maximum description length in characters */

package/esm/src/utils/logger/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/logger/logger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/logger/logger.ts"],"names":[],"mappings":"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"}

package/esm/src/utils/logger/logger.js

@@ -193,6 +193,9 @@ function extractAliasToEntryField(entry, context, sourceKey, targetKey, coerce)
     entry[targetKey] = coerce(context[sourceKey]);
     delete context[sourceKey];
 }
+function sanitizeStringFieldValue(value) {
+    return sanitizeUrlCredentials(String(value));
+}
 class ConsoleLogger {
     prefix;
     options;
@@ -223,10 +226,10 @@ class ConsoleLogger {
         if (this.componentName)
             entry.component = this.componentName;
         // Extract known fields to top level for easier Grafana filtering
-        extractToEntryField(entry, mergedContext, "requestId", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "traceId", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "spanId", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "projectSlug", (v) => String(v));
+        extractToEntryField(entry, mergedContext, "requestId", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "traceId", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "spanId", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "projectSlug", sanitizeStringFieldValue);
         extractToEntryField(entry, mergedContext, "durationMs", (v) => Number(v));
         // Auto-inject trace context from OTel when not already set
         if ((this.options.injectTraceContext ?? true) && traceContextGetter && !entry.traceId) {
@@ -237,45 +240,44 @@ class ConsoleLogger {
             }
         }
         // Extract standard snake_case fields for Loki filtering
-        extractToEntryField(entry, mergedContext, "request_id", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "trace_id", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "span_id", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "project_slug", (v) => String(v));
-        // request_url / domain are URL-shaped and lifted out of mergedContext
-        // *before* redactSensitive runs, so they bypass the key-based redactor.
-        // Scrub embedded credentials (userinfo, ?access_token=, …) here (#1989).
-        extractToEntryField(entry, mergedContext, "request_url", (v) => sanitizeUrlCredentials(String(v)));
-        extractToEntryField(entry, mergedContext, "domain", (v) => sanitizeUrlCredentials(String(v)));
-        extractToEntryField(entry, mergedContext, "project_id", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "release_id", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "branch_id", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "branch_name", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "run_execution_id", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "run_id", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "agent_id", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "thread_id", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "schedule_id", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "schedule_name", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "tool_name", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "tool_call_id", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "batch_id", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "run_target", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "task", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "event_kind", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "user_visible", (v) => String(v));
+        extractToEntryField(entry, mergedContext, "request_id", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "trace_id", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "span_id", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "project_slug", sanitizeStringFieldValue);
+        // Lifted string fields are removed from mergedContext before redactSensitive
+        // runs, so scrub credential-shaped text while preserving the field value.
+        extractToEntryField(entry, mergedContext, "request_url", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "domain", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "project_id", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "release_id", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "branch_id", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "branch_name", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "run_execution_id", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "run_id", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "agent_id", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "thread_id", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "schedule_id", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "schedule_name", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "tool_name", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "tool_call_id", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "batch_id", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "run_target", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "task", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "event_kind", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "user_visible", sanitizeStringFieldValue);
         extractToEntryField(entry, mergedContext, "duration_ms", (v) => Number(v));
-        extractToEntryField(entry, mergedContext, "user_id", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "conversation_id", (v) => String(v));
+        extractToEntryField(entry, mergedContext, "user_id", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "conversation_id", sanitizeStringFieldValue);
         // Also extract camelCase variants so callers can use either convention
-        extractToEntryField(entry, mergedContext, "userId", (v) => String(v));
-        extractToEntryField(entry, mergedContext, "conversationId", (v) => String(v));
-        extractAliasToEntryField(entry, mergedContext, "runId", "run_id", (v) => String(v));
-        extractAliasToEntryField(entry, mergedContext, "agentId", "agent_id", (v) => String(v));
-        extractAliasToEntryField(entry, mergedContext, "threadId", "thread_id", (v) => String(v));
-        extractAliasToEntryField(entry, mergedContext, "scheduleId", "schedule_id", (v) => String(v));
-        extractAliasToEntryField(entry, mergedContext, "scheduleName", "schedule_name", (v) => String(v));
-        extractAliasToEntryField(entry, mergedContext, "toolName", "tool_name", (v) => String(v));
-        extractAliasToEntryField(entry, mergedContext, "toolCallId", "tool_call_id", (v) => String(v));
+        extractToEntryField(entry, mergedContext, "userId", sanitizeStringFieldValue);
+        extractToEntryField(entry, mergedContext, "conversationId", sanitizeStringFieldValue);
+        extractAliasToEntryField(entry, mergedContext, "runId", "run_id", sanitizeStringFieldValue);
+        extractAliasToEntryField(entry, mergedContext, "agentId", "agent_id", sanitizeStringFieldValue);
+        extractAliasToEntryField(entry, mergedContext, "threadId", "thread_id", sanitizeStringFieldValue);
+        extractAliasToEntryField(entry, mergedContext, "scheduleId", "schedule_id", sanitizeStringFieldValue);
+        extractAliasToEntryField(entry, mergedContext, "scheduleName", "schedule_name", sanitizeStringFieldValue);
+        extractAliasToEntryField(entry, mergedContext, "toolName", "tool_name", sanitizeStringFieldValue);
+        extractAliasToEntryField(entry, mergedContext, "toolCallId", "tool_call_id", sanitizeStringFieldValue);
         // Emit snake_case aliases for camelCase fields (transition period)
         if (entry.requestId && !entry.request_id)
             entry.request_id = entry.requestId;

package/esm/src/utils/logger/redact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/logger/redact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,6DAA6D;AAC7D,eAAO,MAAM,QAAQ,eAAe,CAAC;AAmDrC;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAcnD;AA6ED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAEhD;AA6BD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAyB5D;AAqBD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBxD;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,CAAC,SAAS;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,EAC5D,KAAK,EAAE,CAAC,GAAG,CAAC,CAMb"}
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../../../src/src/utils/logger/redact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,6DAA6D;AAC7D,eAAO,MAAM,QAAQ,eAAe,CAAC;AAmDrC;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAcnD;AAoFD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAEhD;AA6BD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAyB5D;AAqBD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBxD;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,CAAC,SAAS;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,EAC5D,KAAK,EAAE,CAAC,GAAG,CAAC,CAMb"}

package/esm/src/utils/logger/redact.js

@@ -98,6 +98,8 @@ function hasToJson(value) {
     return typeof value.toJSON === "function";
 }
 function redactValue(value, depth, seen) {
+    if (typeof value === "string")
+        return sanitizeUrlCredentials(value);
     if (Array.isArray(value)) {
         if (depth >= MAX_DEPTH || seen.has(value))
             return REDACTED;
@@ -127,6 +129,10 @@ function redactValue(value, depth, seen) {
             if (isRecord(serialized) || Array.isArray(serialized)) {
                 return redactValue(serialized, depth + 1, seen);
             }
+            if (typeof serialized === "string") {
+                const sanitized = sanitizeUrlCredentials(serialized);
+                return sanitized === serialized ? value : sanitized;
+            }
             // Scalar result (string/number/…): the object serializes safely as-is.
             return value;
         }
@@ -160,7 +166,8 @@ function redactValue(value, depth, seen) {
         }
     }
     // Primitives and scalar-serializing objects (Date, URL, …) are returned
-    // untouched: they are not key/value bags we can safely rewrite.
+    // untouched: except for string values above, they are not key/value bags we
+    // can safely rewrite.
     return value;
 }
 /**

package/esm/src/utils/version-constant.d.ts

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.1176";
+export declare const VERSION = "0.1.1177";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,4 +1,4 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
 /** Shared version value. */
-export const VERSION = "0.1.1176";
+export const VERSION = "0.1.1177";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.1176",
+  "version": "0.1.1177",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -344,10 +344,10 @@
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
     "ws": "8.21.0",
-    "@veryfront/ext-bundler-esbuild": "0.1.1176",
-    "@veryfront/ext-content-mdx": "0.1.1176",
-    "@veryfront/ext-css-tailwind": "0.1.1176",
-    "@veryfront/ext-parser-babel": "0.1.1176"
+    "@veryfront/ext-bundler-esbuild": "0.1.1177",
+    "@veryfront/ext-content-mdx": "0.1.1177",
+    "@veryfront/ext-css-tailwind": "0.1.1177",
+    "@veryfront/ext-parser-babel": "0.1.1177"
   },
   "devDependencies": {
     "@types/node": "20.9.0"