@n8n/agents 0.8.1 → 0.9.1

package/dist/skills/tools.js

@@ -0,0 +1,312 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RUNTIME_SKILL_TOOL_NAMES = void 0;
+exports.createRuntimeSkillTools = createRuntimeSkillTools;
+exports.createListSkillsTool = createListSkillsTool;
+exports.createSkillLoadTool = createSkillLoadTool;
+const zod_1 = require("zod");
+const tool_1 = require("../sdk/tool");
+const types_1 = require("./types");
+const MAX_OUTPUT_BYTES = 64 * 1024;
+const TRUNCATION_FOOTER = '\n\n[... output truncated to 64 KB ...]';
+const SECRET_REDACTION = '[REDACTED]';
+const LINKED_FILE_GROUPS = [
+    'references',
+    'templates',
+    'scripts',
+    'assets',
+    'examples',
+    'other',
+];
+exports.RUNTIME_SKILL_TOOL_NAMES = new Set([types_1.LIST_SKILLS_TOOL_NAME, types_1.SKILL_LOAD_TOOL_NAME]);
+const skillsListInputSchema = zod_1.z.object({
+    category: zod_1.z.string().optional().describe('Optional exact category filter.'),
+});
+const linkedFileSchema = zod_1.z.object({
+    path: zod_1.z.string(),
+    bytes: zod_1.z.number(),
+    sha256: zod_1.z.string(),
+});
+const linkedFilesSchema = zod_1.z.object({
+    references: zod_1.z.array(linkedFileSchema),
+    templates: zod_1.z.array(linkedFileSchema),
+    scripts: zod_1.z.array(linkedFileSchema),
+    assets: zod_1.z.array(linkedFileSchema),
+    examples: zod_1.z.array(linkedFileSchema),
+    other: zod_1.z.array(linkedFileSchema),
+});
+const skillInterfaceSchema = zod_1.z
+    .object({
+    displayName: zod_1.z.string().optional(),
+    shortDescription: zod_1.z.string().optional(),
+    defaultPrompt: zod_1.z.string().optional(),
+    icon: zod_1.z.string().optional(),
+    brandColor: zod_1.z.string().optional(),
+})
+    .optional();
+const skillPolicySchema = zod_1.z
+    .object({
+    allowImplicitInvocation: zod_1.z.boolean().optional(),
+    product: zod_1.z.string().optional(),
+})
+    .optional();
+const skillDependenciesSchema = zod_1.z
+    .object({
+    tools: zod_1.z.array(zod_1.z.string()).optional(),
+    secrets: zod_1.z.array(zod_1.z.string()).optional(),
+    mcpServers: zod_1.z
+        .array(zod_1.z.object({
+        name: zod_1.z.string(),
+        description: zod_1.z.string().optional(),
+        transport: zod_1.z.string().optional(),
+        url: zod_1.z.string().optional(),
+        command: zod_1.z.string().optional(),
+    }))
+        .optional(),
+})
+    .optional();
+const compactSkillSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    description: zod_1.z.string(),
+    category: zod_1.z.string().optional(),
+    path: zod_1.z.string().optional(),
+    directory: zod_1.z.string().optional(),
+    hash: zod_1.z.string(),
+    recommendedTools: zod_1.z.array(zod_1.z.string()).optional(),
+    allowedTools: zod_1.z.array(zod_1.z.string()).optional(),
+    interface: skillInterfaceSchema,
+    policy: skillPolicySchema,
+    dependencies: skillDependenciesSchema,
+    platforms: zod_1.z.array(zod_1.z.string()).optional(),
+});
+const skillsListOutputSchema = zod_1.z.object({
+    success: zod_1.z.boolean(),
+    registryHash: zod_1.z.string(),
+    count: zod_1.z.number(),
+    categories: zod_1.z.array(zod_1.z.string()),
+    skills: zod_1.z.array(compactSkillSchema),
+});
+const skillLoadInputSchema = zod_1.z
+    .object({
+    skillId: zod_1.z.string().min(1).optional().describe('Skill id from list_skills.'),
+    name: zod_1.z.string().min(1).optional().describe('Skill name from list_skills.'),
+    filePath: zod_1.z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Optional linked file path relative to the skill directory.'),
+})
+    .refine(({ skillId, name }) => skillId !== undefined || name !== undefined, {
+    message: 'Either skillId or name is required.',
+    path: ['skillId'],
+});
+const skillLoadOutputSchema = zod_1.z.object({
+    ok: zod_1.z.boolean().optional(),
+    success: zod_1.z.boolean(),
+    skillId: zod_1.z.string().optional(),
+    name: zod_1.z.string().optional(),
+    description: zod_1.z.string().optional(),
+    path: zod_1.z.string().optional(),
+    skillDir: zod_1.z.string().optional(),
+    hash: zod_1.z.string().optional(),
+    category: zod_1.z.string().optional(),
+    content: zod_1.z.string().optional(),
+    instructions: zod_1.z.string().optional(),
+    filePath: zod_1.z.string().optional(),
+    bytes: zod_1.z.number().optional(),
+    sha256: zod_1.z.string().optional(),
+    activation: zod_1.z.string().optional(),
+    linkedFiles: linkedFilesSchema.optional(),
+    error: zod_1.z.string().optional(),
+    availableSkills: zod_1.z.array(zod_1.z.string()).optional(),
+});
+function createRuntimeSkillTools(source) {
+    return [createListSkillsTool(source), createSkillLoadTool(source)];
+}
+function createListSkillsTool(source) {
+    return new tool_1.Tool(types_1.LIST_SKILLS_TOOL_NAME)
+        .description('List installed skills from the registry. Use before loading a skill when you need to discover available domains.')
+        .input(skillsListInputSchema)
+        .output(skillsListOutputSchema)
+        .handler(async ({ category }) => {
+        await source.prepare?.();
+        const skills = source.registry.skills
+            .filter((skill) => !category || skill.category === category)
+            .map(compactSkill);
+        return await Promise.resolve({
+            success: true,
+            registryHash: source.registry.skillsHash,
+            count: skills.length,
+            categories: categoriesFor(source.registry),
+            skills,
+        });
+    })
+        .build();
+}
+function createSkillLoadTool(source) {
+    return new tool_1.Tool(types_1.SKILL_LOAD_TOOL_NAME)
+        .description('Load an installed skill SKILL.md, or a registered linked file by relative filePath.')
+        .input(skillLoadInputSchema)
+        .output(skillLoadOutputSchema)
+        .handler(async ({ skillId, name, filePath }) => {
+        await source.prepare?.();
+        const skillEntry = findSkillEntry(source.registry, { skillId, name });
+        if (!skillEntry) {
+            return {
+                ok: false,
+                success: false,
+                error: `Unknown skill: ${skillId ?? name ?? ''}`,
+                availableSkills: source.registry.skills.map((entry) => entry.id).slice(0, 20),
+            };
+        }
+        if (filePath !== undefined) {
+            const linkedFile = findRegisteredLinkedFile(skillEntry.linkedFiles, filePath);
+            if (!linkedFile) {
+                return {
+                    ok: false,
+                    success: false,
+                    skillId: skillEntry.id,
+                    name: skillEntry.name,
+                    filePath,
+                    error: `File is not registered for skill ${skillEntry.name}: ${filePath}`,
+                    linkedFiles: skillEntry.linkedFiles,
+                };
+            }
+            if (!source.loadFile) {
+                return {
+                    ok: false,
+                    success: false,
+                    skillId: skillEntry.id,
+                    name: skillEntry.name,
+                    filePath,
+                    error: 'This skill source does not support loading linked files.',
+                    linkedFiles: skillEntry.linkedFiles,
+                };
+            }
+            const file = await source.loadFile(skillEntry.id, linkedFile.path);
+            if (!file) {
+                return {
+                    ok: false,
+                    success: false,
+                    skillId: skillEntry.id,
+                    name: skillEntry.name,
+                    filePath,
+                    error: `File is not registered for skill ${skillEntry.name}: ${filePath}`,
+                    linkedFiles: skillEntry.linkedFiles,
+                };
+            }
+            return {
+                ok: true,
+                success: true,
+                skillId: skillEntry.id,
+                name: skillEntry.name,
+                path: skillEntry.directory
+                    ? `${skillEntry.directory}/${linkedFile.path}`
+                    : linkedFile.path,
+                skillDir: skillEntry.directory,
+                hash: skillEntry.hash,
+                category: skillEntry.category,
+                filePath: linkedFile.path,
+                content: cap(file.content),
+                bytes: file.bytes ?? linkedFile.bytes,
+                sha256: file.sha256 ?? linkedFile.sha256,
+            };
+        }
+        const skill = await source.loadSkill(skillEntry.id);
+        if (!skill) {
+            return {
+                ok: false,
+                success: false,
+                skillId: skillEntry.id,
+                name: skillEntry.name,
+                error: `Skill "${skillEntry.name}" is not attached to this agent.`,
+                availableSkills: source.registry.skills.map((entry) => entry.id).slice(0, 20),
+            };
+        }
+        const content = cap(skill.instructions);
+        return {
+            ok: true,
+            success: true,
+            skillId: skillEntry.id,
+            name: skillEntry.name,
+            description: skill.description,
+            path: skillEntry.path ?? skillEntry.sourcePath,
+            skillDir: skillEntry.directory,
+            hash: skillEntry.hash,
+            category: skillEntry.category,
+            content,
+            instructions: content,
+            activation: activationEnvelope(skillEntry),
+            linkedFiles: skillEntry.linkedFiles,
+        };
+    })
+        .build();
+}
+function compactSkill(skill) {
+    return {
+        name: skill.name,
+        description: skill.description,
+        ...(skill.category ? { category: skill.category } : {}),
+        ...(skill.path ? { path: skill.path } : {}),
+        ...(skill.directory ? { directory: skill.directory } : {}),
+        hash: skill.hash,
+        ...(skill.recommendedTools ? { recommendedTools: skill.recommendedTools } : {}),
+        ...(skill.allowedTools ? { allowedTools: skill.allowedTools } : {}),
+        ...(skill.interface ? { interface: skill.interface } : {}),
+        ...(skill.policy ? { policy: skill.policy } : {}),
+        ...(skill.dependencies ? { dependencies: skill.dependencies } : {}),
+        ...(skill.platforms ? { platforms: skill.platforms } : {}),
+    };
+}
+function categoriesFor(registry) {
+    return Array.from(new Set(registry.skills.map((skill) => skill.category).filter(isPresentString))).sort();
+}
+function findSkillEntry(registry, input) {
+    if (input.skillId) {
+        const skillById = registry.skills.find((entry) => entry.id === input.skillId);
+        if (skillById)
+            return skillById;
+    }
+    if (input.name) {
+        return registry.skills.find((entry) => entry.name === input.name);
+    }
+    return undefined;
+}
+function activationEnvelope(skill) {
+    return [
+        `[Skill: ${envelopeValue(skill.name)}]`,
+        ...(skill.category ? [`[Skill category: ${envelopeValue(skill.category)}]`] : []),
+        ...(skill.directory ? [`[Skill directory: ${envelopeValue(skill.directory)}]`] : []),
+        ...((skill.path ?? skill.sourcePath)
+            ? [`[Skill path: ${envelopeValue(skill.path ?? skill.sourcePath ?? '')}]`]
+            : []),
+        `[Skill hash: ${envelopeValue(skill.hash)}]`,
+    ].join('\n');
+}
+function findRegisteredLinkedFile(linkedFiles, filePath) {
+    for (const group of LINKED_FILE_GROUPS) {
+        const linkedFile = linkedFiles[group].find((file) => file.path === filePath);
+        if (linkedFile)
+            return linkedFile;
+    }
+    return undefined;
+}
+function envelopeValue(value) {
+    return JSON.stringify(value);
+}
+function cap(content) {
+    const redacted = redactSecrets(content);
+    const bytes = Buffer.from(redacted, 'utf8');
+    if (bytes.byteLength <= MAX_OUTPUT_BYTES)
+        return redacted;
+    return `${bytes.subarray(0, MAX_OUTPUT_BYTES).toString('utf8')}${TRUNCATION_FOOTER}`;
+}
+function redactSecrets(content) {
+    return content
+        .replace(/\b(authorization)(\s*:\s*Bearer\s+)[^\s"',;]+/gi, `$1$2${SECRET_REDACTION}`)
+        .replace(/\b(api[_-]?key|token|password|passwd|secret|credential)(\s*[:=]\s*)(["']?)[^\s"',;]+(\3)/gi, `$1$2$3${SECRET_REDACTION}$4`);
+}
+function isPresentString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+//# sourceMappingURL=tools.js.map

package/dist/skills/tools.js.map

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

package/dist/skills/types.d.ts

@@ -0,0 +1,141 @@
+export declare const RUNTIME_SKILL_REGISTRY_SCHEMA_VERSION: 1;
+export declare const RUNTIME_SKILL_FILE_NAME = "SKILL.md";
+export declare const LIST_SKILLS_TOOL_NAME = "list_skills";
+export declare const SKILL_LOAD_TOOL_NAME = "load_skill";
+export declare const RUNTIME_SKILL_LINKED_FILE_GROUPS: readonly ["references", "templates", "scripts", "assets", "examples"];
+export interface RuntimeSkillLinkedFile {
+    path: string;
+    bytes: number;
+    sha256: string;
+}
+export type RuntimeSkillLinkedFileGroup = (typeof RUNTIME_SKILL_LINKED_FILE_GROUPS)[number] | 'other';
+export interface RuntimeSkillLinkedFiles {
+    references: RuntimeSkillLinkedFile[];
+    templates: RuntimeSkillLinkedFile[];
+    scripts: RuntimeSkillLinkedFile[];
+    assets: RuntimeSkillLinkedFile[];
+    examples: RuntimeSkillLinkedFile[];
+    other: RuntimeSkillLinkedFile[];
+}
+export interface RuntimeSkillIndexEntry {
+    name: string;
+    description: string;
+    recommendedTools?: string[];
+}
+export interface RuntimeSkillInterfaceContract {
+    displayName?: string;
+    shortDescription?: string;
+    defaultPrompt?: string;
+    icon?: string;
+    brandColor?: string;
+}
+export interface RuntimeSkillPolicyContract {
+    allowImplicitInvocation?: boolean;
+    product?: string;
+}
+export interface RuntimeSkillMcpServerDependency {
+    name: string;
+    description?: string;
+    transport?: string;
+    url?: string;
+    command?: string;
+}
+export interface RuntimeSkillDependenciesContract {
+    tools?: string[];
+    secrets?: string[];
+    mcpServers?: RuntimeSkillMcpServerDependency[];
+}
+export interface RuntimeSkill extends RuntimeSkillIndexEntry {
+    id: string;
+    instructions: string;
+    sourceName?: string;
+    path?: string;
+    sourcePath?: string;
+    directory?: string;
+    sourceDirectory?: string;
+    category?: string;
+    allowedTools?: string[];
+    interface?: RuntimeSkillInterfaceContract;
+    policy?: RuntimeSkillPolicyContract;
+    dependencies?: RuntimeSkillDependenciesContract;
+    version?: string;
+    license?: string;
+    compatibility?: string;
+    platforms?: string[];
+    metadata?: Record<string, unknown>;
+    linkedFiles?: RuntimeSkillLinkedFiles;
+}
+export interface RuntimeSkillRegistryEntry extends RuntimeSkillIndexEntry {
+    id: string;
+    hash: string;
+    sourceName?: string;
+    path?: string;
+    sourcePath?: string;
+    directory?: string;
+    sourceDirectory?: string;
+    category?: string;
+    allowedTools?: string[];
+    interface?: RuntimeSkillInterfaceContract;
+    policy?: RuntimeSkillPolicyContract;
+    dependencies?: RuntimeSkillDependenciesContract;
+    version?: string;
+    license?: string;
+    compatibility?: string;
+    platforms?: string[];
+    metadata?: Record<string, unknown>;
+    linkedFiles: RuntimeSkillLinkedFiles;
+}
+export interface RuntimeSkillRegistry {
+    schemaVersion: typeof RUNTIME_SKILL_REGISTRY_SCHEMA_VERSION;
+    skillsHash: string;
+    skills: RuntimeSkillRegistryEntry[];
+}
+export interface RuntimeSkillContent extends RuntimeSkillIndexEntry {
+    id: string;
+    instructions: string;
+    sourceName?: string;
+    path?: string;
+    sourcePath?: string;
+    directory?: string;
+    sourceDirectory?: string;
+    category?: string;
+    allowedTools?: string[];
+    interface?: RuntimeSkillInterfaceContract;
+    policy?: RuntimeSkillPolicyContract;
+    dependencies?: RuntimeSkillDependenciesContract;
+    version?: string;
+    license?: string;
+    compatibility?: string;
+    platforms?: string[];
+    metadata?: Record<string, unknown>;
+    linkedFiles?: RuntimeSkillLinkedFiles;
+}
+export type RuntimeSkillLoader = (skillId: string) => Promise<RuntimeSkillContent | null>;
+export interface RuntimeSkillFileContent {
+    skillId: string;
+    filePath: string;
+    content: string;
+    bytes?: number;
+    sha256?: string;
+}
+export type RuntimeSkillFileLoader = (skillId: string, filePath: string) => Promise<RuntimeSkillFileContent | null>;
+export interface RuntimeSkillSource {
+    registry: RuntimeSkillRegistry;
+    prepare?: () => Promise<void>;
+    loadSkill: RuntimeSkillLoader;
+    loadFile?: RuntimeSkillFileLoader;
+}
+export interface RuntimeSkillValidationError {
+    code: string;
+    message: string;
+    path?: string;
+    field?: string;
+    hint?: string;
+}
+export type RuntimeSkillValidationResult = {
+    ok: true;
+    skill: RuntimeSkill;
+} | {
+    ok: false;
+    errors: RuntimeSkillValidationError[];
+};

package/dist/skills/types.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RUNTIME_SKILL_LINKED_FILE_GROUPS = exports.SKILL_LOAD_TOOL_NAME = exports.LIST_SKILLS_TOOL_NAME = exports.RUNTIME_SKILL_FILE_NAME = exports.RUNTIME_SKILL_REGISTRY_SCHEMA_VERSION = void 0;
+exports.RUNTIME_SKILL_REGISTRY_SCHEMA_VERSION = 1;
+exports.RUNTIME_SKILL_FILE_NAME = 'SKILL.md';
+exports.LIST_SKILLS_TOOL_NAME = 'list_skills';
+exports.SKILL_LOAD_TOOL_NAME = 'load_skill';
+exports.RUNTIME_SKILL_LINKED_FILE_GROUPS = [
+    'references',
+    'templates',
+    'scripts',
+    'assets',
+    'examples',
+];
+//# sourceMappingURL=types.js.map

package/dist/skills/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/skills/types.ts"],"names":[],"mappings":";;;AAAa,QAAA,qCAAqC,GAAG,CAAU,CAAC;AAEnD,QAAA,uBAAuB,GAAG,UAAU,CAAC;AAErC,QAAA,qBAAqB,GAAG,aAAa,CAAC;AAEtC,QAAA,oBAAoB,GAAG,YAAY,CAAC;AAEpC,QAAA,gCAAgC,GAAG;IAC/C,YAAY;IACZ,WAAW;IACX,SAAS;IACT,QAAQ;IACR,UAAU;CACD,CAAC"}

package/dist/skills/validator.d.ts

@@ -0,0 +1,15 @@
+import { type RuntimeSkill, type RuntimeSkillValidationResult } from './types';
+export declare const RUNTIME_SKILL_NAME_PATTERN: RegExp;
+export interface ParseRuntimeSkillMarkdownOptions {
+    id?: string;
+    sourceName?: string;
+    path?: string;
+    sourcePath?: string;
+    directory?: string;
+    sourceDirectory?: string;
+    category?: string;
+    metadata?: Record<string, unknown>;
+    validateName?: boolean;
+}
+export declare function validateRuntimeSkill(skill: RuntimeSkill): RuntimeSkillValidationResult;
+export declare function parseRuntimeSkillMarkdown(content: string, options?: ParseRuntimeSkillMarkdownOptions): RuntimeSkillValidationResult;