@roj-ai/sdk 0.1.3 → 0.1.5

package/dist/plugins/skills/plugin.js

@@ -0,0 +1,293 @@
+/**
+ * Skills Plugin - Progressive disclosure of reusable instruction sets
+ *
+ * Level 1 (Preset): SkillsPresetConfig with skill source directories
+ * Level 2 (Session): Plugin context with discovered skills, methods (load, list)
+ * Level 3 (Agent): Agent-specific skill config (preload, sources override), tools, status
+ */
+import z from 'zod/v4';
+import { AgentId, agentIdSchema } from '../../core/agents/schema.js';
+import { agentEvents } from '../../core/agents/state.js';
+import { ValidationErrors } from '../../core/errors.js';
+import { createEventsFactory as createEvents } from '../../core/events/types.js';
+import { definePlugin } from '../../core/plugins/plugin-builder.js';
+import { selectPluginState } from '../../core/sessions/reducer.js';
+import { createTool } from '../../core/tools/definition.js';
+import { Err, Ok } from '../../lib/utils/result.js';
+import { discoverSkills, loadSkillContent } from './discovery.js';
+import { buildLoadedSkillsMessage, formatLoadedSkills } from './prompts.js';
+import { SkillId, skillIdSchema } from './schema.js';
+async function readSkillContent(fs, meta) {
+    if (meta.source === 'inline') {
+        return Ok(meta.content);
+    }
+    const result = await loadSkillContent(fs, meta.sourcePath);
+    if (!result.ok) {
+        return Err({ message: result.error.message });
+    }
+    return Ok(result.value);
+}
+/**
+ * Extract loaded skills for an agent from session state (for external consumers).
+ */
+export function selectAgentSkills(sessionState, agentId) {
+    return selectPluginState(sessionState, 'skills')?.get(agentId) ?? [];
+}
+export const skillEvents = createEvents({
+    events: {
+        skill_loaded: z.object({
+            agentId: agentIdSchema,
+            skillId: skillIdSchema,
+            skillName: z.string(),
+            content: z.string(),
+        }),
+    },
+});
+export const skillsPlugin = definePlugin('skills')
+    .pluginConfig()
+    .agentConfig()
+    .events([skillEvents])
+    .state({
+    key: 'skills',
+    initial: () => new Map(),
+    reduce: (skills, event) => {
+        switch (event.type) {
+            case 'skill_loaded': {
+                const loadedSkill = {
+                    id: event.skillId,
+                    name: event.skillName,
+                    content: event.content,
+                    loadedAt: event.timestamp,
+                };
+                const agentSkills = skills.get(event.agentId) ?? [];
+                const newSkills = new Map(skills);
+                newSkills.set(event.agentId, [...agentSkills, loadedSkill]);
+                return newSkills;
+            }
+            default:
+                return skills;
+        }
+    },
+})
+    .context(async (ctx, pluginConfig) => {
+    // Interpolate {{workspaceDir}} / {{sessionDir}} placeholders.
+    // Sources referencing {{workspaceDir}} are skipped when the session has no workspace.
+    const workspaceDir = ctx.environment.workspaceDir;
+    const sessionDir = ctx.environment.sessionDir;
+    const resolvedSources = [];
+    for (const source of pluginConfig.sources) {
+        if (source.includes('{{workspaceDir}}') && !workspaceDir) {
+            continue;
+        }
+        resolvedSources.push(source
+            .replaceAll('{{workspaceDir}}', workspaceDir ?? '')
+            .replaceAll('{{sessionDir}}', sessionDir));
+    }
+    const fileSkillsResult = await discoverSkills(ctx.platform.fs, resolvedSources, '.');
+    if (!fileSkillsResult.ok) {
+        console.warn(`[skills] Discovery failed: ${fileSkillsResult.error.message}`);
+        return { availableSkills: [] };
+    }
+    // Merge preset-contributed skills. File-discovered skills take precedence:
+    // if the same name appears in both, the inline one is dropped.
+    const fileSkillNames = new Set(fileSkillsResult.value.map((s) => s.name));
+    const inlineSkills = [];
+    const seenInline = new Set();
+    for (const skill of pluginConfig.skills ?? []) {
+        if (fileSkillNames.has(skill.name)) {
+            continue;
+        }
+        if (seenInline.has(skill.name)) {
+            console.warn(`[skills] Duplicate inline skill "${skill.name}" — ignoring later entry`);
+            continue;
+        }
+        seenInline.add(skill.name);
+        inlineSkills.push({
+            source: 'inline',
+            id: SkillId(skill.name),
+            name: skill.name,
+            description: skill.description,
+            content: skill.content,
+        });
+    }
+    return {
+        availableSkills: [...fileSkillsResult.value, ...inlineSkills],
+    };
+})
+    .method('load', {
+    input: z.object({
+        sessionId: z.string(),
+        agentId: agentIdSchema,
+        skillName: z.string(),
+    }),
+    output: z.object({
+        skillId: z.string().optional(),
+        message: z.string().optional(),
+    }),
+    handler: async (ctx, input) => {
+        const availableSkills = ctx.pluginContext.availableSkills;
+        const skillMeta = availableSkills.find((s) => s.name === input.skillName);
+        if (!skillMeta) {
+            const availableNames = availableSkills.map((s) => s.name).join(', ');
+            const message = availableNames
+                ? `Unknown skill: "${input.skillName}". Available: ${availableNames}`
+                : `Unknown skill: "${input.skillName}". No skills configured.`;
+            return Err(ValidationErrors.invalid(message));
+        }
+        // Check if already loaded
+        const agentId = AgentId(input.agentId);
+        const agentSkills = ctx.pluginState.get(agentId);
+        if (agentSkills?.some((s) => s.id === skillMeta.id)) {
+            return Ok({
+                skillId: skillMeta.id,
+                message: `Skill "${input.skillName}" is already loaded.`,
+            });
+        }
+        // Load skill content
+        const contentResult = await readSkillContent(ctx.platform.fs, skillMeta);
+        if (!contentResult.ok) {
+            return Err(ValidationErrors.invalid(`Failed to load skill: ${contentResult.error.message}`));
+        }
+        // Emit skill_loaded event
+        await ctx.emitEvent(skillEvents.create('skill_loaded', {
+            agentId: input.agentId,
+            skillId: skillMeta.id,
+            skillName: skillMeta.name,
+            content: contentResult.value,
+        }));
+        // Emit preamble with the newly loaded skill
+        const skillContent = formatLoadedSkills([{
+                id: skillMeta.id,
+                name: skillMeta.name,
+                content: contentResult.value,
+                loadedAt: Date.now(),
+            }]);
+        await ctx.emitEvent(agentEvents.create('preamble_added', {
+            agentId: input.agentId,
+            messages: [{ role: 'system', content: skillContent }],
+        }));
+        return Ok({
+            skillId: skillMeta.id,
+            message: `Skill "${input.skillName}" loaded successfully.`,
+        });
+    },
+})
+    .method('list', {
+    input: z.object({
+        sessionId: z.string(),
+        agentId: agentIdSchema,
+    }),
+    output: z.object({
+        skills: z.array(z.object({
+            id: z.string(),
+            name: z.string(),
+            description: z.string(),
+            loaded: z.boolean(),
+        })),
+    }),
+    handler: async (ctx, input) => {
+        const availableSkills = ctx.pluginContext.availableSkills;
+        const agentSkills = ctx.pluginState.get(AgentId(input.agentId));
+        const loadedSkillIds = new Set(agentSkills?.map((s) => s.id) ?? []);
+        return Ok({
+            skills: availableSkills.map((s) => ({
+                id: s.id,
+                name: s.name,
+                description: s.description,
+                loaded: loadedSkillIds.has(s.id),
+            })),
+        });
+    },
+})
+    .sessionHook('onSessionReady', async () => {
+    // No session-wide initialization needed for now
+})
+    .hook('onStart', async (ctx) => {
+    const preloadSkills = ctx.pluginAgentConfig?.preload;
+    if (!preloadSkills || preloadSkills.length === 0) {
+        return null;
+    }
+    // Load preload skills
+    const availableSkills = ctx.pluginContext.availableSkills;
+    const skillByName = new Map(availableSkills.map((s) => [s.name, s]));
+    const newlyLoaded = [];
+    for (const skillName of preloadSkills) {
+        const skillMeta = skillByName.get(skillName);
+        if (!skillMeta) {
+            console.warn(`[skills] Preload skill not found: "${skillName}"`);
+            continue;
+        }
+        // Check if already loaded
+        const agentSkills = ctx.pluginState.get(ctx.agentId);
+        if (agentSkills?.some((s) => s.id === skillMeta.id)) {
+            continue;
+        }
+        // Load skill content
+        const contentResult = await readSkillContent(ctx.platform.fs, skillMeta);
+        if (!contentResult.ok) {
+            console.warn(`[skills] Failed to load preload skill "${skillName}": ${contentResult.error.message}`);
+            continue;
+        }
+        // Emit skill_loaded event
+        await ctx.emitEvent(skillEvents.create('skill_loaded', {
+            agentId: ctx.agentId,
+            skillId: skillMeta.id,
+            skillName: skillMeta.name,
+            content: contentResult.value,
+        }));
+        newlyLoaded.push({
+            id: skillMeta.id,
+            name: skillMeta.name,
+            content: contentResult.value,
+            loadedAt: Date.now(),
+        });
+    }
+    // Emit preamble with all preloaded skills
+    if (newlyLoaded.length > 0) {
+        const skillsMessage = buildLoadedSkillsMessage(newlyLoaded);
+        if (skillsMessage) {
+            await ctx.emitEvent(agentEvents.create('preamble_added', {
+                agentId: ctx.agentId,
+                messages: [{ role: 'system', content: skillsMessage }],
+            }));
+        }
+    }
+    return null;
+})
+    .tools((ctx) => {
+    const availableSkills = ctx.pluginContext?.availableSkills ?? [];
+    if (availableSkills.length === 0) {
+        return [];
+    }
+    const skillsList = availableSkills
+        .map((s) => `- ${s.name}: ${s.description}`)
+        .join('\n');
+    return [
+        createTool({
+            name: 'use_skill',
+            description: `Load a skill's full instructions into your context. Use this when you need detailed instructions for a skill from the Available Skills list. The skill content will be injected into your context for subsequent turns.
+
+Available skills:
+${skillsList}`,
+            input: z.object({
+                skill: z.string().describe('Name of the skill to load (from the Available Skills list)'),
+            }),
+            execute: async (input, context) => {
+                const result = await ctx.self.load({
+                    sessionId: ctx.sessionState.id,
+                    agentId: context.agentId,
+                    skillName: input.skill,
+                });
+                if (!result.ok) {
+                    return Err({
+                        message: result.error.message,
+                        recoverable: false,
+                    });
+                }
+                return Ok(result.value.message ?? `Skill "${input.skill}" loaded successfully.`);
+            },
+        }),
+    ];
+})
+    .build();
+//# sourceMappingURL=plugin.js.map

package/dist/plugins/skills/plugin.js.map

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

package/dist/plugins/skills/prompts.js

@@ -0,0 +1,70 @@
+/**
+ * Skills Prompt Sections - Build prompt sections for skill metadata and loaded skills.
+ */
+// ============================================================================
+// Available Skills Section
+// ============================================================================
+/**
+ * Build the "Available Skills" section for the system prompt.
+ * Lists skill names and descriptions, instructing agent to use use_skill tool.
+ *
+ * @param skills - Array of discovered skill metadata
+ * @returns Formatted section string, or empty string if no skills
+ */
+export function buildSkillsSection(skills) {
+    if (skills.length === 0) {
+        return '';
+    }
+    const lines = [
+        '## Available Skills',
+        '',
+        'The following skills provide specialized instructions you can load on-demand.',
+        'Use the `use_skill` tool to load the full instructions when needed.',
+        '',
+    ];
+    for (const skill of skills) {
+        lines.push(`- **${skill.name}**: ${skill.description}`);
+    }
+    return lines.join('\n');
+}
+// ============================================================================
+// Loaded Skills Content
+// ============================================================================
+/**
+ * Format loaded skills as content to be injected before inference.
+ * Each skill is wrapped in a clear section header.
+ *
+ * @param loadedSkills - Array of skills loaded into agent context
+ * @returns Formatted string with all loaded skill content
+ */
+export function formatLoadedSkills(loadedSkills) {
+    if (loadedSkills.length === 0) {
+        return '';
+    }
+    const sections = [];
+    for (const skill of loadedSkills) {
+        sections.push(`<loaded-skill name="${skill.name}">
+${skill.content}
+</loaded-skill>`);
+    }
+    return sections.join('\n\n');
+}
+/**
+ * Build a system message containing all loaded skills.
+ * Returns null if no skills are loaded.
+ *
+ * @param loadedSkills - Array of skills loaded into agent context
+ * @returns System message content or null
+ */
+export function buildLoadedSkillsMessage(loadedSkills) {
+    if (loadedSkills.length === 0) {
+        return null;
+    }
+    const content = formatLoadedSkills(loadedSkills);
+    return `## Loaded Skills
+
+The following skills have been loaded into your context. Follow these instructions when performing related tasks.
+
+${content}`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/plugins/skills/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/plugins/skills/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAuB;IACzD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,CAAA;IACV,CAAC;IAED,MAAM,KAAK,GAAG;QACb,qBAAqB;QACrB,EAAE;QACF,+EAA+E;QAC/E,qEAAqE;QACrE,EAAE;KACF,CAAA;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;IACxD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACxB,CAAC;AAED,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,YAA2B;IAC7D,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAA;IACV,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,uBAAuB,KAAK,CAAC,IAAI;EAC/C,KAAK,CAAC,OAAO;gBACC,CAAC,CAAA;IAChB,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,YAA2B;IACnE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAA;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAA;IAEhD,OAAO;;;;EAIN,OAAO,EAAE,CAAA;AACX,CAAC"}

package/dist/plugins/skills/schema.js

@@ -0,0 +1,18 @@
+/**
+ * Skills domain types
+ *
+ * Skills are reusable instruction sets that agents can load on-demand.
+ * Only metadata (name + description) is shown in system prompt;
+ * full content is loaded via use_skill tool.
+ */
+import z from 'zod/v4';
+// ============================================================================
+// Branded ID
+// ============================================================================
+/** SkillId schema - validates any string and brands as SkillId. */
+export const skillIdSchema = z.string().brand('SkillId');
+/**
+ * Create a SkillId from a string.
+ */
+export const SkillId = (id) => id;
+//# sourceMappingURL=schema.js.map

package/dist/plugins/skills/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/plugins/skills/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,CAAC,MAAM,QAAQ,CAAA;AAEtB,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,mEAAmE;AACnE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;AAQxD;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,EAAU,EAAW,EAAE,CAAC,EAAa,CAAA"}