veryfront 0.1.47 → 0.1.49

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

@@ -0,0 +1,25 @@
+/**
+ * Skill Registry
+ *
+ * Project-scoped registry for discovered skills.
+ * Follows the same pattern as src/tool/registry.ts.
+ *
+ * @module
+ */
+import type { Skill } from "./types.js";
+import { ScopedRegistryFacade } from "../ai/registry-facade.js";
+declare class SkillRegistryClass extends ScopedRegistryFacade<Skill> {
+    /**
+     * Resolve skills for an agent configuration.
+     *
+     * @param skillsConfig - `true` for all skills, or array of specific skill IDs
+     * @returns Map of resolved skills (missing IDs are silently skipped)
+     */
+    resolveForAgent(skillsConfig: true | string[]): Map<string, Skill>;
+}
+export declare const skillRegistry: SkillRegistryClass;
+export declare function registerSkill(id: string, skill: Skill): void;
+export declare function getSkill(id: string): Skill | undefined;
+export declare function getAllSkills(): Map<string, Skill>;
+export {};
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/src/skill/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAIhE,cAAM,kBAAmB,SAAQ,oBAAoB,CAAC,KAAK,CAAC;IAC1D;;;;;OAKG;IACH,eAAe,CAAC,YAAY,EAAE,IAAI,GAAG,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;CAcnE;AAED,eAAO,MAAM,aAAa,oBAAuC,CAAC;AAElE,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAE5D;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAEtD;AAED,wBAAgB,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAEjD"}

package/esm/src/skill/registry.js

@@ -0,0 +1,42 @@
+/**
+ * Skill Registry
+ *
+ * Project-scoped registry for discovered skills.
+ * Follows the same pattern as src/tool/registry.ts.
+ *
+ * @module
+ */
+import { ProjectScopedRegistryManager } from "../ai/registry-manager.js";
+import { ScopedRegistryFacade } from "../ai/registry-facade.js";
+const skillManager = new ProjectScopedRegistryManager("skill");
+class SkillRegistryClass extends ScopedRegistryFacade {
+    /**
+     * Resolve skills for an agent configuration.
+     *
+     * @param skillsConfig - `true` for all skills, or array of specific skill IDs
+     * @returns Map of resolved skills (missing IDs are silently skipped)
+     */
+    resolveForAgent(skillsConfig) {
+        if (skillsConfig === true) {
+            return this.getAll();
+        }
+        const result = new Map();
+        for (const id of skillsConfig) {
+            const skill = this.get(id);
+            if (skill) {
+                result.set(id, skill);
+            }
+        }
+        return result;
+    }
+}
+export const skillRegistry = new SkillRegistryClass(skillManager);
+export function registerSkill(id, skill) {
+    skillRegistry.register(id, skill);
+}
+export function getSkill(id) {
+    return skillRegistry.get(id);
+}
+export function getAllSkills() {
+    return skillRegistry.getAll();
+}

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

@@ -0,0 +1,27 @@
+/**
+ * Skill Tools
+ *
+ * Three tools exposed to agents for interacting with skills:
+ * - load-skill: Load a skill's full instructions
+ * - load-skill-reference: Read a reference file from a skill
+ * - execute-skill-script: Execute a script from a skill
+ *
+ * @module
+ */
+import type { Tool } from "../tool/index.js";
+/**
+ * Create the load-skill tool.
+ * Loads a skill's full instructions, available references, and scripts.
+ */
+export declare function createLoadSkillTool(): Tool;
+/**
+ * Create the load-skill-reference tool.
+ * Reads a reference file from a skill's references/ or assets/ directory.
+ */
+export declare function createLoadSkillReferenceTool(): Tool;
+/**
+ * Create the execute-skill-script tool.
+ * Executes a script from a skill's scripts/ directory.
+ */
+export declare function createExecuteSkillScriptTool(): Tool;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/src/skill/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AA2B7C;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAyD1C;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAkCnD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAiDnD"}

package/esm/src/skill/tools.js

@@ -0,0 +1,149 @@
+/**
+ * Skill Tools
+ *
+ * Three tools exposed to agents for interacting with skills:
+ * - load-skill: Load a skill's full instructions
+ * - load-skill-reference: Read a reference file from a skill
+ * - execute-skill-script: Execute a script from a skill
+ *
+ * @module
+ */
+import { z } from "zod";
+import { tool } from "../tool/factory.js";
+import { readTextFile } from "../platform/compat/fs.js";
+import { join } from "../platform/compat/path/index.js";
+import { createError, toError } from "../errors/veryfront-error.js";
+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_SCRIPTS_DIR, } from "./types.js";
+/**
+ * Read a file from a skill directory.
+ * Uses skill.fsAdapter if available (VFS/cloud), otherwise falls back to compat readTextFile.
+ */
+async function readSkillFile(skill, path) {
+    if (skill.fsAdapter) {
+        return await skill.fsAdapter.readFile(path);
+    }
+    return await readTextFile(path);
+}
+/**
+ * Create the load-skill tool.
+ * Loads a skill's full instructions, available references, and scripts.
+ */
+export function createLoadSkillTool() {
+    return tool({
+        id: "load-skill",
+        description: "Load a skill's full instructions. Returns the skill's markdown instructions, " +
+            "allowed tools policy, and lists of available reference files and scripts.",
+        inputSchema: z.object({
+            skillId: z.string().describe("The ID of the skill to load"),
+        }),
+        execute: async (input) => {
+            const skill = skillRegistry.get(input.skillId);
+            if (!skill) {
+                const available = skillRegistry.getAllIds().join(", ");
+                throw toError(createError({
+                    type: "agent",
+                    message: `Skill "${input.skillId}" not found. Available skills: ${available || "none"}`,
+                }));
+            }
+            // Read SKILL.md
+            const skillMdPath = join(skill.rootPath, SKILL_MD_FILENAME);
+            const content = await readSkillFile(skill, skillMdPath);
+            // Parse frontmatter to get instructions
+            const parsed = await parseSkillFrontmatter(content);
+            // List available references and scripts
+            const references = await listSkillSubdir(skill.rootPath, SKILL_REFERENCES_DIR, skill.fsAdapter);
+            const scripts = await listSkillSubdir(skill.rootPath, SKILL_SCRIPTS_DIR, skill.fsAdapter);
+            return {
+                instructions: parsed.body,
+                allowedTools: skill.metadata.allowedTools,
+                references,
+                scripts,
+                ...(scripts.length === 0 && references.length === 0
+                    ? {
+                        note: "This skill has no scripts or reference files. Do NOT call execute-skill-script or load-skill-reference.",
+                    }
+                    : scripts.length === 0
+                        ? { note: "This skill has no scripts. Do NOT call execute-skill-script." }
+                        : references.length === 0
+                            ? { note: "This skill has no reference files. Do NOT call load-skill-reference." }
+                            : {}),
+            };
+        },
+    });
+}
+/**
+ * Create the load-skill-reference tool.
+ * Reads a reference file from a skill's references/ or assets/ directory.
+ */
+export function createLoadSkillReferenceTool() {
+    return tool({
+        id: "load-skill-reference",
+        description: "Read a reference file from a skill. Only files in the skill's " +
+            "references/ and assets/ directories are accessible.",
+        inputSchema: z.object({
+            skillId: z.string().describe("The ID of the skill"),
+            reference: z.string().describe("Relative path to the reference file (e.g. 'references/CLAUSES.md')"),
+        }),
+        execute: async (input) => {
+            const skill = skillRegistry.get(input.skillId);
+            if (!skill) {
+                throw toError(createError({
+                    type: "agent",
+                    message: `Skill "${input.skillId}" not found`,
+                }));
+            }
+            // Validate path safety (only references/ and assets/ allowed)
+            const validatedPath = await validateSkillPath(skill.rootPath, input.reference, [SKILL_REFERENCES_DIR, SKILL_ASSETS_DIR], skill.fsAdapter);
+            const content = await readSkillFile(skill, validatedPath);
+            return { content, path: input.reference };
+        },
+    });
+}
+/**
+ * Create the execute-skill-script tool.
+ * Executes a script from a skill's scripts/ directory.
+ */
+export function createExecuteSkillScriptTool() {
+    return tool({
+        id: "execute-skill-script",
+        description: "Execute a script from a skill's scripts/ directory. Returns stdout, stderr, and exit code.",
+        inputSchema: z.object({
+            skillId: z.string().describe("The ID of the skill"),
+            script: z.string().describe("Relative path to the script (e.g. 'scripts/setup.sh')"),
+            args: z.array(z.string()).optional().describe("Arguments to pass to the script"),
+            env: z.record(z.string()).optional().describe("Environment variables for the script"),
+            timeoutMs: z
+                .number()
+                .int()
+                .positive()
+                .max(300_000)
+                .optional()
+                .describe("Optional execution timeout in milliseconds (max 300000)"),
+        }),
+        execute: async (input) => {
+            const skill = skillRegistry.get(input.skillId);
+            if (!skill) {
+                throw toError(createError({
+                    type: "agent",
+                    message: `Skill "${input.skillId}" not found`,
+                }));
+            }
+            // Validate path safety (only scripts/ allowed)
+            const validatedPath = await validateSkillPath(skill.rootPath, input.script, [SKILL_SCRIPTS_DIR], skill.fsAdapter);
+            const scriptContent = await readSkillFile(skill, validatedPath);
+            const executor = getSkillScriptExecutor();
+            return await executor.execute({
+                scriptPath: validatedPath,
+                scriptContent,
+                args: input.args,
+                env: input.env,
+                cwd: skill.rootPath,
+                timeoutMs: input.timeoutMs,
+            });
+        },
+    });
+}

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

@@ -0,0 +1,85 @@
+/**
+ * Skill type definitions
+ *
+ * Follows the agentskills.io specification.
+ * Pure type/const file — no runtime dependencies.
+ *
+ * @module
+ */
+import type { FileSystemAdapter } from "../platform/adapters/base.js";
+/** Valid skill name: lowercase alphanumeric + hyphens, 1-64 chars */
+export declare const SKILL_NAME_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 */
+export declare const SKILL_DESCRIPTION_MAX_LENGTH = 1024;
+/** Standard SKILL.md filename per agentskills.io spec */
+export declare const SKILL_MD_FILENAME = "SKILL.md";
+/** Tool IDs that belong to the skill system (single source of truth) */
+export declare const SKILL_TOOL_IDS: Set<string>;
+/** Conventional subdirectory names */
+export declare const SKILL_SCRIPTS_DIR = "scripts";
+export declare const SKILL_REFERENCES_DIR = "references";
+export declare const SKILL_ASSETS_DIR = "assets";
+/** Parsed frontmatter metadata from SKILL.md */
+export interface SkillMetadata {
+    /** Skill identifier (lowercase, hyphenated) */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Tool access restrictions (space-delimited in YAML, parsed to array) */
+    allowedTools?: string[];
+    /** SPDX license identifier */
+    license?: string;
+    /** Compatibility constraints */
+    compatibility?: string;
+    /** Arbitrary key-value metadata */
+    metadata?: Record<string, string>;
+}
+/** Full skill content returned by load-skill tool */
+export interface SkillContent {
+    /** Markdown instructions (body after frontmatter) */
+    instructions: string;
+    /** Tool access restrictions from frontmatter */
+    allowedTools?: string[];
+    /** Available reference file paths */
+    references: string[];
+    /** Available script file paths */
+    scripts: string[];
+}
+/** Registered skill instance */
+export interface Skill {
+    /** Unique skill ID (matches directory name) */
+    id: string;
+    /** Parsed frontmatter metadata */
+    metadata: SkillMetadata;
+    /** Absolute path to the skill directory */
+    rootPath: string;
+    /** Optional filesystem adapter for VFS/cloud-backed projects */
+    fsAdapter?: FileSystemAdapter;
+}
+/** Result from executing a skill script */
+export interface SkillScriptResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/** Input for the script executor */
+export interface SkillScriptExecutorInput {
+    scriptPath: string;
+    scriptContent?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    timeoutMs?: number;
+}
+/** Script executor interface */
+export interface SkillScriptExecutor {
+    execute(input: SkillScriptExecutorInput): Promise<SkillScriptResult>;
+}
+/** Active skill context for runtime policy tracking */
+export interface ActiveSkillContext {
+    skillId: string;
+    allowedTools?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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,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,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;CAC/B;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

@@ -0,0 +1,27 @@
+/**
+ * Skill type definitions
+ *
+ * Follows the agentskills.io specification.
+ * Pure type/const file — no runtime dependencies.
+ *
+ * @module
+ */
+// ── Constants ───────────────────────────────────────────────────────────
+/** Valid skill name: lowercase alphanumeric + hyphens, 1-64 chars */
+export const SKILL_NAME_REGEX = /^[a-z0-9][a-z0-9-]{0,63}$/;
+/** 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 */
+export const SKILL_DESCRIPTION_MAX_LENGTH = 1024;
+/** Standard SKILL.md filename per agentskills.io spec */
+export const SKILL_MD_FILENAME = "SKILL.md";
+/** Tool IDs that belong to the skill system (single source of truth) */
+export const SKILL_TOOL_IDS = new Set([
+    "load-skill",
+    "load-skill-reference",
+    "execute-skill-script",
+]);
+/** Conventional subdirectory names */
+export const SKILL_SCRIPTS_DIR = "scripts";
+export const SKILL_REFERENCES_DIR = "references";
+export const SKILL_ASSETS_DIR = "assets";

package/esm/src/studio/bridge/bridge-bundle.generated.d.ts

@@ -5,5 +5,5 @@
  * Do not edit manually — run `deno task build` to regenerate.
  * @module
  */
-export declare const STUDIO_BRIDGE_BUNDLE: string | undefined;
+export declare const STUDIO_BRIDGE_BUNDLE: string;
 //# sourceMappingURL=bridge-bundle.generated.d.ts.map

package/esm/src/studio/bridge/bridge-bundle.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge-bundle.generated.d.ts","sourceRoot":"","sources":["../../../../src/src/studio/bridge/bridge-bundle.generated.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,oBAAoB,EAAE,MAAM,GAAG,SAAqB,CAAC"}
+{"version":3,"file":"bridge-bundle.generated.d.ts","sourceRoot":"","sources":["../../../../src/src/studio/bridge/bridge-bundle.generated.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,oBAAoB,EAAE,MAAw3kK,CAAC"}