@xandout/libra-harness 0.1.8

package/dist/extras/extensions/skills/extension.test.js

@@ -0,0 +1,184 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { Agent } from '../../../agent.js';
+import { createSkillExtension } from './index.js';
+// ── Mock model ─────────────────────────────────────────────────────
+// Returns a fixed assistant message.
+function mockModel() {
+    return {
+        async generate() {
+            return {
+                message: { role: 'assistant', content: 'ok' },
+                finishReason: 'stop',
+            };
+        },
+    };
+}
+// ── Helpers ────────────────────────────────────────────────────────
+function makeSkill(dir, name, frontmatter = {}, body = 'Skill body') {
+    const skillDir = join(dir, name);
+    mkdirSync(skillDir, { recursive: true });
+    const fmLines = Object.entries(frontmatter).map(([k, v]) => `${k}: ${v}`);
+    const content = `---\nname: ${name}\n${fmLines.join('\n')}\n---\n${body}`;
+    writeFileSync(join(skillDir, 'SKILL.md'), content);
+    return skillDir;
+}
+// ── Test setup ─────────────────────────────────────────────────────
+let tmpDir;
+beforeEach(() => {
+    tmpDir = mkdtempSync(join(tmpdir(), 'skills-test-'));
+});
+afterEach(() => {
+    rmSync(tmpDir, { recursive: true, force: true });
+});
+// ── Tests ──────────────────────────────────────────────────────────
+describe('skills extension', () => {
+    it('loads skills from a directory at startup', () => {
+        makeSkill(tmpDir, 'code-review', { description: 'Review code' });
+        makeSkill(tmpDir, 'summarize', { description: 'Summarize text' });
+        const ext = createSkillExtension({ skillsDirs: tmpDir });
+        expect(ext).toBeDefined();
+        const agent = new Agent({ model: mockModel() });
+        agent.use(ext);
+        // list_skills should be registered as a tool
+        expect(agent.getTools()).toContain('list_skills');
+        expect(agent.getTools()).toContain('use_skill');
+    });
+    it('returns undefined when no skillsDirs provided', () => {
+        const ext = createSkillExtension({});
+        expect(ext).toBeUndefined();
+    });
+    it('list_skills returns skills present at startup', async () => {
+        makeSkill(tmpDir, 'alpha', { description: 'Alpha skill' });
+        makeSkill(tmpDir, 'beta', { description: 'Beta skill' });
+        const ext = createSkillExtension({ skillsDirs: tmpDir });
+        const agent = new Agent({ model: mockModel() });
+        agent.use(ext);
+        // Find the list_skills tool and call it directly.
+        const tools = agent.getTools();
+        expect(tools).toContain('list_skills');
+    });
+    it('list_skills discovers new skills added at runtime', async () => {
+        // Start with one skill.
+        makeSkill(tmpDir, 'existing', { description: 'Existing skill' });
+        const ext = createSkillExtension({ skillsDirs: tmpDir });
+        const agent = new Agent({ model: mockModel() });
+        agent.use(ext);
+        // Add a new skill directory after the extension is installed.
+        makeSkill(tmpDir, 'runtime-added', { description: 'Added at runtime' });
+        // Model that calls list_skills on first turn, then returns the
+        // tool result as the final message so we can inspect it.
+        let callCount = 0;
+        let capturedToolResult = '';
+        const callModel = {
+            async generate(req) {
+                callCount++;
+                if (callCount === 1) {
+                    return {
+                        message: {
+                            role: 'assistant',
+                            content: '',
+                            toolCalls: [{
+                                    id: 'call_1',
+                                    name: 'list_skills',
+                                    arguments: '{}',
+                                }],
+                        },
+                        finishReason: 'tool_calls',
+                    };
+                }
+                // Second call: capture the tool result and return it.
+                const toolMsg = req.messages.find((m) => m.role === 'tool');
+                capturedToolResult = toolMsg?.content ?? '';
+                return {
+                    message: { role: 'assistant', content: capturedToolResult },
+                    finishReason: 'stop',
+                };
+            },
+        };
+        const agent2 = new Agent({ model: callModel });
+        agent2.use(ext);
+        const result = await agent2.run({ message: 'list skills' });
+        expect(result.finishReason).toBe('stop');
+        expect(result.toolCalls?.some((tc) => tc.name === 'list_skills')).toBe(true);
+        // The tool result should include both the existing and runtime-added skills.
+        expect(capturedToolResult).toContain('existing');
+        expect(capturedToolResult).toContain('runtime-added');
+    });
+    it('use_skill can load a skill added at runtime', async () => {
+        // Start with no skills.
+        const ext = createSkillExtension({ skillsDirs: tmpDir });
+        const agent = new Agent({ model: mockModel() });
+        agent.use(ext);
+        // Add a skill after install.
+        makeSkill(tmpDir, 'late-skill', { description: 'Added late' }, 'Late skill content');
+        // Model that calls use_skill, then returns the result.
+        let sawSkillContent = false;
+        const callModel = {
+            async generate(req) {
+                const hasUseSkill = req.tools?.some((t) => t.function.name === 'use_skill');
+                if (hasUseSkill && !req.messages.some((m) => m.role === 'tool')) {
+                    return {
+                        message: {
+                            role: 'assistant',
+                            content: '',
+                            toolCalls: [{
+                                    id: 'call_1',
+                                    name: 'use_skill',
+                                    arguments: JSON.stringify({ skill: 'late-skill' }),
+                                }],
+                        },
+                        finishReason: 'tool_calls',
+                    };
+                }
+                // Check if the tool result contains the late skill content
+                const toolMsg = req.messages.find((m) => m.role === 'tool');
+                if (toolMsg && toolMsg.content.includes('Late skill content')) {
+                    sawSkillContent = true;
+                }
+                return {
+                    message: { role: 'assistant', content: 'done' },
+                    finishReason: 'stop',
+                };
+            },
+        };
+        const agent2 = new Agent({ model: callModel });
+        agent2.use(ext);
+        await agent2.run({ message: 'use the late skill' });
+        expect(sawSkillContent).toBe(true);
+    });
+    it('autoLoad skills are appended to system prompt at install time', () => {
+        makeSkill(tmpDir, 'always-on', { autoLoad: 'true', description: 'Always active' }, 'Always-on content');
+        let seenSystemPrompt = '';
+        const model = {
+            async generate(req) {
+                seenSystemPrompt = req.systemPrompt ?? '';
+                return {
+                    message: { role: 'assistant', content: 'ok' },
+                    finishReason: 'stop',
+                };
+            },
+        };
+        const ext = createSkillExtension({ skillsDirs: tmpDir });
+        const agent = new Agent({ model: model, systemPrompt: 'Base prompt.' });
+        agent.use(ext);
+        return agent.run({ message: 'hi' }).then(() => {
+            expect(seenSystemPrompt).toContain('Base prompt.');
+            expect(seenSystemPrompt).toContain('Always-on content');
+        });
+    });
+    it('supports multiple skills directories', () => {
+        const dir2 = mkdtempSync(join(tmpdir(), 'skills-test-2-'));
+        makeSkill(tmpDir, 'from-dir1', { description: 'First dir' });
+        makeSkill(dir2, 'from-dir2', { description: 'Second dir' });
+        const ext = createSkillExtension({ skillsDirs: [tmpDir, dir2] });
+        const agent = new Agent({ model: mockModel() });
+        agent.use(ext);
+        expect(agent.getTools()).toContain('list_skills');
+        // Clean up second dir
+        rmSync(dir2, { recursive: true, force: true });
+    });
+});
+//# sourceMappingURL=extension.test.js.map

package/dist/extras/extensions/skills/extension.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.test.js","sourceRoot":"","sources":["../../../../src/extras/extensions/skills/extension.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,sEAAsE;AACtE,qCAAqC;AACrC,SAAS,SAAS;IAChB,OAAO;QACL,KAAK,CAAC,QAAQ;YACZ,OAAO;gBACL,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE;gBAC7C,YAAY,EAAE,MAAe;aAC9B,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,SAAS,SAAS,CAAC,GAAW,EAAE,IAAY,EAAE,WAAW,GAA2B,EAAE,EAAE,IAAI,GAAG,YAAY;IACzG,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACjC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,cAAc,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IAC1E,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;IACnD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,sEAAsE;AACtE,IAAI,MAAc,CAAC;AAEnB,UAAU,CAAC,GAAG,EAAE;IACd,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;AACvD,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,sEAAsE;AAEtE,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;QACjE,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAElE,MAAM,GAAG,GAAG,oBAAoB,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAE1B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,EAAS,EAAE,CAAC,CAAC;QACvD,KAAK,CAAC,GAAG,CAAC,GAAI,CAAC,CAAC;QAEhB,6CAA6C;QAC7C,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,GAAG,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;QAC3D,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC;QAEzD,MAAM,GAAG,GAAG,oBAAoB,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,EAAS,EAAE,CAAC,CAAC;QACvD,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEf,kDAAkD;QAClD,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,wBAAwB;QACxB,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAEjE,MAAM,GAAG,GAAG,oBAAoB,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,EAAS,EAAE,CAAC,CAAC;QACvD,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEf,8DAA8D;QAC9D,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAExE,+DAA+D;QAC/D,yDAAyD;QACzD,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,kBAAkB,GAAG,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG;YAChB,KAAK,CAAC,QAAQ,CAAC,GAAQ;gBACrB,SAAS,EAAE,CAAC;gBACZ,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;oBACpB,OAAO;wBACL,OAAO,EAAE;4BACP,IAAI,EAAE,WAAW;4BACjB,OAAO,EAAE,EAAE;4BACX,SAAS,EAAE,CAAC;oCACV,EAAE,EAAE,QAAQ;oCACZ,IAAI,EAAE,aAAa;oCACnB,SAAS,EAAE,IAAI;iCAChB,CAAC;yBACH;wBACD,YAAY,EAAE,YAAqB;qBACpC,CAAC;gBACJ,CAAC;gBACD,sDAAsD;gBACtD,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;gBACjE,kBAAkB,GAAG,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;gBAC5C,OAAO;oBACL,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,EAAE;oBAC3D,YAAY,EAAE,MAAe;iBAC9B,CAAC;YACJ,CAAC;SACF,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,SAAgB,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEhB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,6EAA6E;QAC7E,MAAM,CAAC,kBAAkB,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,CAAC,kBAAkB,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,wBAAwB;QACxB,MAAM,GAAG,GAAG,oBAAoB,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,EAAS,EAAE,CAAC,CAAC;QACvD,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEf,6BAA6B;QAC7B,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,oBAAoB,CAAC,CAAC;QAErF,uDAAuD;QACvD,IAAI,eAAe,GAAG,KAAK,CAAC;QAC5B,MAAM,SAAS,GAAG;YAChB,KAAK,CAAC,QAAQ,CAAC,GAAQ;gBACrB,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;gBACjF,IAAI,WAAW,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC;oBACrE,OAAO;wBACL,OAAO,EAAE;4BACP,IAAI,EAAE,WAAW;4BACjB,OAAO,EAAE,EAAE;4BACX,SAAS,EAAE,CAAC;oCACV,EAAE,EAAE,QAAQ;oCACZ,IAAI,EAAE,WAAW;oCACjB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;iCACnD,CAAC;yBACH;wBACD,YAAY,EAAE,YAAqB;qBACpC,CAAC;gBACJ,CAAC;gBACD,2DAA2D;gBAC3D,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;gBACjE,IAAI,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;oBAC9D,eAAe,GAAG,IAAI,CAAC;gBACzB,CAAC;gBACD,OAAO;oBACL,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE;oBAC/C,YAAY,EAAE,MAAe;iBAC9B,CAAC;YACJ,CAAC;SACF,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,SAAgB,EAAE,CAAC,CAAC;QACtD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEhB,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC;QACpD,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,EAAE,mBAAmB,CAAC,CAAC;QAExG,IAAI,gBAAgB,GAAG,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG;YACZ,KAAK,CAAC,QAAQ,CAAC,GAAQ;gBACrB,gBAAgB,GAAG,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;gBAC1C,OAAO;oBACL,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE;oBAC7C,YAAY,EAAE,MAAe;iBAC9B,CAAC;YACJ,CAAC;SACF,CAAC;QAEF,MAAM,GAAG,GAAG,oBAAoB,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,KAAY,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC,CAAC;QAC/E,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEf,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YAC5C,MAAM,CAAC,gBAAgB,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;YACnD,MAAM,CAAC,gBAAgB,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC3D,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC;QAC7D,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC;QAE5D,MAAM,GAAG,GAAG,oBAAoB,CAAC,EAAE,UAAU,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAE,CAAC;QAClE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,EAAS,EAAE,CAAC,CAAC;QACvD,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEf,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAElD,sBAAsB;QACtB,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/extras/extensions/skills/index.d.ts

@@ -0,0 +1,4 @@
+export { default as createSkillExtension } from './extension.js';
+export type { SkillsExtensionConfig, SkillMeta, Skill } from './extension.js';
+export { loadSkills } from './extension.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/extras/extensions/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/extras/extensions/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACjE,YAAY,EAAE,qBAAqB,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/extras/extensions/skills/index.js

@@ -0,0 +1,3 @@
+export { default as createSkillExtension } from './extension.js';
+export { loadSkills } from './extension.js';
+//# sourceMappingURL=index.js.map

package/dist/extras/extensions/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/extras/extensions/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEjE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/extras/extensions/streaming/extension.d.ts

@@ -0,0 +1,15 @@
+import type { Extension } from '../../../extension.js';
+/**
+ * Streaming extension — sets `onDelta` on the model request in
+ * `beforeLLM` so the AISdkModel uses its streaming path.
+ *
+ * The caller passes callbacks via `metadata.streamCallbacks`:
+ * - `onText(delta)` — text token deltas
+ * - `onReasoning(delta)` — reasoning/thinking token deltas
+ * - `onToolInput(delta, toolName)` — tool argument token deltas
+ *
+ * When no `streamCallbacks` are in metadata, the extension is a no-op
+ * and the model uses `doGenerate` (no streaming overhead).
+ */
+export default function createStreamingExtension(): Extension;
+//# sourceMappingURL=extension.d.ts.map

package/dist/extras/extensions/streaming/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../../src/extras/extensions/streaming/extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,UAAU,wBAAwB,IAAI,SAAS,CAgC5D"}

package/dist/extras/extensions/streaming/extension.js

@@ -0,0 +1,41 @@
+/**
+ * Streaming extension — sets `onDelta` on the model request in
+ * `beforeLLM` so the AISdkModel uses its streaming path.
+ *
+ * The caller passes callbacks via `metadata.streamCallbacks`:
+ * - `onText(delta)` — text token deltas
+ * - `onReasoning(delta)` — reasoning/thinking token deltas
+ * - `onToolInput(delta, toolName)` — tool argument token deltas
+ *
+ * When no `streamCallbacks` are in metadata, the extension is a no-op
+ * and the model uses `doGenerate` (no streaming overhead).
+ */
+export default function createStreamingExtension() {
+    return {
+        name: 'streaming',
+        priority: 100,
+        install(agent) {
+            agent.hook('beforeLLM', 'streaming', async (ctx) => {
+                if (!ctx.modelRequest)
+                    return;
+                const callbacks = ctx.turn.metadata.streamCallbacks;
+                if (!callbacks)
+                    return;
+                ctx.modelRequest.onDelta = (delta) => {
+                    switch (delta.type) {
+                        case 'text':
+                            callbacks.onText?.(delta.content);
+                            break;
+                        case 'reasoning':
+                            callbacks.onReasoning?.(delta.content);
+                            break;
+                        case 'tool-input':
+                            callbacks.onToolInput?.(delta.content, delta.toolName ?? '');
+                            break;
+                    }
+                };
+            });
+        },
+    };
+}
+//# sourceMappingURL=extension.js.map

package/dist/extras/extensions/streaming/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../../../src/extras/extensions/streaming/extension.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,UAAU,wBAAwB;IAC9C,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,QAAQ,EAAE,GAAG;QACb,OAAO,CAAC,KAAK;YACX,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBACjD,IAAI,CAAC,GAAG,CAAC,YAAY;oBAAE,OAAO;gBAE9B,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,eAIvB,CAAC;gBAEd,IAAI,CAAC,SAAS;oBAAE,OAAO;gBAEvB,GAAG,CAAC,YAAY,CAAC,OAAO,GAAG,CAAC,KAAiB,EAAE,EAAE;oBAC/C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;wBACnB,KAAK,MAAM;4BACT,SAAS,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;4BAClC,MAAM;wBACR,KAAK,WAAW;4BACd,SAAS,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;4BACvC,MAAM;wBACR,KAAK,YAAY;4BACf,SAAS,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;4BAC7D,MAAM;oBACV,CAAC;gBACH,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/extras/extensions/streaming/extension.json

@@ -0,0 +1,6 @@
+{
+  "name": "streaming",
+  "description": "Sets onDelta on modelRequest via beforeLLM hook to enable streaming. Caller passes callbacks via metadata.streamCallbacks.",
+  "enabled": true,
+  "priority": 100
+}

package/dist/extras/extensions/streaming/index.d.ts

@@ -0,0 +1,2 @@
+export { default as createStreamingExtension } from './extension.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/extras/extensions/streaming/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/extras/extensions/streaming/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/extras/extensions/streaming/index.js

@@ -0,0 +1,2 @@
+export { default as createStreamingExtension } from './extension.js';
+//# sourceMappingURL=index.js.map

package/dist/extras/extensions/streaming/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/extras/extensions/streaming/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/extras/extensions/structured-output/extension.d.ts

@@ -0,0 +1,11 @@
+import type { Extension } from '../../../extension.js';
+export interface StructuredOutputConfig {
+    /** JSON schema to validate against. Required. */
+    schema: Record<string, unknown>;
+    /** Field name in metadata to store the parsed JSON. Default: "structured". */
+    metadataKey?: string;
+    /** Whether to strip markdown code fences from the response. Default: true. */
+    stripCodeFences?: boolean;
+}
+export default function createStructuredOutputExtension(config: StructuredOutputConfig): Extension | undefined;
+//# sourceMappingURL=extension.d.ts.map

package/dist/extras/extensions/structured-output/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../../src/extras/extensions/structured-output/extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,CAAC,OAAO,UAAU,+BAA+B,CACrD,MAAM,EAAE,sBAAsB,GAC7B,SAAS,GAAG,SAAS,CA8GvB"}

package/dist/extras/extensions/structured-output/extension.js

@@ -0,0 +1,102 @@
+export default function createStructuredOutputExtension(config) {
+    if (!config?.schema) {
+        console.log('[structured-output] no schema in config — skipping');
+        return undefined;
+    }
+    const { schema } = config;
+    const metadataKey = config.metadataKey ?? 'structured';
+    const stripCodeFences = config.stripCodeFences ?? true;
+    return {
+        name: 'structured-output',
+        priority: 50,
+        install(agent) {
+            agent.hook('beforeResponse', 'structured-output', async (ctx) => {
+                if (!ctx.turn.response)
+                    return;
+                let raw = ctx.turn.response.message;
+                // Strip markdown code fences if present (LLMs often wrap JSON in ```json ... ```).
+                if (stripCodeFences) {
+                    const fenceMatch = raw.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+                    if (fenceMatch) {
+                        raw = fenceMatch[1].trim();
+                    }
+                }
+                let parsed;
+                try {
+                    parsed = JSON.parse(raw);
+                }
+                catch {
+                    // Not valid JSON — replace the response with an error that includes the schema.
+                    ctx.turn.response = {
+                        ...ctx.turn.response,
+                        message: JSON.stringify({
+                            error: 'Response is not valid JSON',
+                            expectedSchema: schema,
+                            rawResponse: ctx.turn.response.message.slice(0, 500),
+                        }),
+                    };
+                    return;
+                }
+                // Validate against the schema's required fields.
+                const required = schema.required ?? [];
+                const missing = required.filter((field) => {
+                    const value = parsed[field];
+                    return value === undefined || value === null;
+                });
+                if (missing.length > 0) {
+                    ctx.turn.response = {
+                        ...ctx.turn.response,
+                        message: JSON.stringify({
+                            error: `Missing required fields: ${missing.join(', ')}`,
+                            expectedSchema: schema,
+                            received: Object.keys(parsed),
+                        }),
+                    };
+                    return;
+                }
+                // Type-check each field against the schema.
+                const properties = schema.properties ?? {};
+                const typeErrors = [];
+                for (const [field, spec] of Object.entries(properties)) {
+                    const value = parsed[field];
+                    if (value === undefined)
+                        continue;
+                    const expectedType = spec.type;
+                    let actualType;
+                    if (Array.isArray(value)) {
+                        actualType = 'array';
+                    }
+                    else if (typeof value === 'number' && Number.isInteger(value)) {
+                        actualType = 'number';
+                    }
+                    else {
+                        actualType = typeof value;
+                    }
+                    if (actualType !== expectedType) {
+                        typeErrors.push(`Field "${field}" expected ${expectedType}, got ${actualType}`);
+                    }
+                }
+                if (typeErrors.length > 0) {
+                    ctx.turn.response = {
+                        ...ctx.turn.response,
+                        message: JSON.stringify({
+                            error: 'Type validation failed',
+                            errors: typeErrors,
+                            expectedSchema: schema,
+                        }),
+                    };
+                    return;
+                }
+                // Valid — store the parsed object in metadata and clean up the response.
+                ctx.turn.metadata[metadataKey] = parsed;
+                // Keep the response as the raw JSON string so callers can parse it.
+                // Or optionally replace with a formatted version.
+                ctx.turn.response = {
+                    ...ctx.turn.response,
+                    message: JSON.stringify(parsed, null, 2),
+                };
+            });
+        },
+    };
+}
+//# sourceMappingURL=extension.js.map

package/dist/extras/extensions/structured-output/extension.js.map

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

package/dist/extras/extensions/structured-output/extension.json

@@ -0,0 +1,7 @@
+{
+  "name": "structured-output",
+  "description": "Validates LLM output against a JSON schema via beforeResponse hook. Accepts a schema, optional metadataKey, and stripCodeFences via config.",
+  "enabled": true,
+  "priority": 50,
+  "configKeys": ["schema", "metadataKey", "stripCodeFences"]
+}

package/dist/extras/extensions/structured-output/index.d.ts

@@ -0,0 +1,3 @@
+export { default as createStructuredOutputExtension } from './extension.js';
+export type { StructuredOutputConfig } from './extension.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/extras/extensions/structured-output/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/extras/extensions/structured-output/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,+BAA+B,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/extras/extensions/structured-output/index.js

@@ -0,0 +1,2 @@
+export { default as createStructuredOutputExtension } from './extension.js';
+//# sourceMappingURL=index.js.map

package/dist/extras/extensions/structured-output/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/extras/extensions/structured-output/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,+BAA+B,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/extras/extensions/timestamp/extension.d.ts

@@ -0,0 +1,11 @@
+import type { Extension } from '../../../extension.js';
+/**
+ * timestamp extension — records start/finish ISO timestamps in turn
+ * metadata for observability.
+ *
+ * Sets `metadata.startedAt` in `beforeTurn` and `metadata.finishedAt`
+ * in `afterTurn`. No config needed — self-contained.
+ */
+declare const timestampExtension: Extension;
+export default timestampExtension;
+//# sourceMappingURL=extension.d.ts.map

package/dist/extras/extensions/timestamp/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../../src/extras/extensions/timestamp/extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;GAMG;AACH,QAAA,MAAM,kBAAkB,EAAE,SAWzB,CAAC;eAEa,kBAAkB"}

package/dist/extras/extensions/timestamp/extension.js

@@ -0,0 +1,21 @@
+/**
+ * timestamp extension — records start/finish ISO timestamps in turn
+ * metadata for observability.
+ *
+ * Sets `metadata.startedAt` in `beforeTurn` and `metadata.finishedAt`
+ * in `afterTurn`. No config needed — self-contained.
+ */
+const timestampExtension = {
+    name: 'timestamp',
+    priority: 0,
+    install(agent) {
+        agent.hook('beforeTurn', 'timestamp', async (ctx) => {
+            ctx.turn.metadata.startedAt = new Date().toISOString();
+        });
+        agent.hook('afterTurn', 'timestamp', async (ctx) => {
+            ctx.turn.metadata.finishedAt = new Date().toISOString();
+        });
+    },
+};
+export default timestampExtension;
+//# sourceMappingURL=extension.js.map

package/dist/extras/extensions/timestamp/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../../../src/extras/extensions/timestamp/extension.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,kBAAkB,GAAc;IACpC,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,CAAC;IACX,OAAO,CAAC,KAAK;QACX,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAClD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACzD,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACjD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/extras/extensions/timestamp/extension.json

@@ -0,0 +1,6 @@
+{
+  "name": "timestamp",
+  "description": "Records start/finish ISO timestamps in turn metadata for observability.",
+  "enabled": true,
+  "priority": 0
+}

package/dist/extras/extensions/timestamp/index.d.ts

@@ -0,0 +1,2 @@
+export { default as timestampExtension } from './extension.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/extras/extensions/timestamp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/extras/extensions/timestamp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/extras/extensions/timestamp/index.js

@@ -0,0 +1,2 @@
+export { default as timestampExtension } from './extension.js';
+//# sourceMappingURL=index.js.map

package/dist/extras/extensions/timestamp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/extras/extensions/timestamp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/extras/extensions/token-stats/extension.d.ts

@@ -0,0 +1,50 @@
+import type { Extension } from '../../../extension.js';
+/**
+ * Config for the token-stats extension.
+ */
+export interface TokenStatsConfig {
+    /**
+     * The model's maximum context window in tokens. Used to compute the
+     * context window usage percentage. If omitted, the percentage is
+     * not shown. Default: not set.
+     *
+     * For DeepSeek v4: 131072 (128K). Check your provider's docs.
+     */
+    contextWindow?: number;
+    /**
+     * Whether to use Slack italic formatting (`_text_`) for the stats
+     * line. Default: `true`.
+     */
+    slackItalics?: boolean;
+    /**
+     * Label for the stats line. Default: `📊`.
+     */
+    label?: string;
+}
+/**
+ * Token-stats extension — appends a stats line to the agent's final
+ * response message.
+ *
+ * Accumulates token usage across all LLM calls in a turn (via
+ * `afterLLM`), then appends a summary to `turn.response.message` in
+ * `beforeResponse`. The stats include:
+ *
+ * - Total prompt + completion tokens
+ * - Cached and reasoning tokens (if reported)
+ * - Number of LLM calls / iterations
+ * - Context window usage percentage (if `contextWindow` is configured)
+ *
+ * ## Example output (Slack italics)
+ *
+ * ```
+ * _📊 105,445 prompt + 2,324 completion · 1,503 reasoning · 3 LLM calls · 82% of 128K context_
+ * ```
+ *
+ * ## Priority
+ *
+ * Uses priority -100 (runs late, after most extensions) so it sees
+ * the final response after other extensions have potentially modified
+ * it. The `afterLLM` accumulator runs at the same priority.
+ */
+export default function createTokenStatsExtension(config?: TokenStatsConfig): Extension;
+//# sourceMappingURL=extension.d.ts.map

package/dist/extras/extensions/token-stats/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../../src/extras/extensions/token-stats/extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAcD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAC/C,MAAM,CAAC,EAAE,gBAAgB,GACxB,SAAS,CAsEX"}