@sprinterai/runtime 0.7.1 → 0.8.0

package/dist/scoring/promotion.test.js

@@ -0,0 +1,141 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { promoteFieldValue, promoteFieldValueAdmin } from './promotion.js';
+// ─── Minimal Response Store Mock ─────────────────────────────
+class InMemoryResponseStore {
+    responses = new Map();
+    promoteResponse = vi.fn(async (_responseId, _fieldName) => { });
+    seed(response) {
+        this.responses.set(response.id, response);
+    }
+    async getResponse(responseId) {
+        return this.responses.get(responseId) ?? null;
+    }
+    async submitResponse(_input) {
+        throw new Error('not implemented');
+    }
+    async listResponses(_entityId, _options) {
+        return [];
+    }
+    async updateResponseStatus(responseId, status) {
+        const r = this.responses.get(responseId);
+        if (!r)
+            throw new Error(`Response not found: ${responseId}`);
+        const updated = { ...r, status };
+        this.responses.set(responseId, updated);
+        return updated;
+    }
+    async getResponseAggregation(_entityId, _criteriaSetId) {
+        return { criteriaSetId: '', totalResponses: 0, byDimension: {} };
+    }
+}
+// ─── Fixtures ────────────────────────────────────────────────
+function makeResponse(overrides = {}) {
+    const now = new Date().toISOString();
+    return {
+        id: 'resp-1',
+        tenant_id: 'tenant-1',
+        entity_id: 'entity-1',
+        criteria_set_id: 'cs-1',
+        criteria_snapshot: [],
+        submitted_by_user: 'user-1',
+        submitted_by_agent: null,
+        source: 'manual',
+        values: { score: 85, category: 'premium' },
+        field_meta: {},
+        weighted_score: null,
+        normalized_score: null,
+        status: 'submitted',
+        promoted_fields: [],
+        reviewed_by: null,
+        reviewed_at: null,
+        review_notes: null,
+        parent_response_id: null,
+        temporal_value: null,
+        notes: null,
+        metadata: {},
+        created_at: now,
+        updated_at: now,
+        ...overrides,
+    };
+}
+// ─── Tests ───────────────────────────────────────────────────
+describe('promoteFieldValue', () => {
+    let responseStore;
+    let entityStore;
+    let stores;
+    beforeEach(() => {
+        responseStore = new InMemoryResponseStore();
+        // EntityStore is not used by the current implementation, but required by the interface
+        entityStore = {};
+        stores = { response: responseStore, entity: entityStore };
+    });
+    it('promotes a valid field from a submitted response', async () => {
+        const response = makeResponse();
+        responseStore.seed(response);
+        await promoteFieldValue(stores, 'resp-1', 'score', 'entity-1');
+        expect(responseStore.promoteResponse).toHaveBeenCalledOnce();
+        expect(responseStore.promoteResponse).toHaveBeenCalledWith('resp-1', 'score');
+    });
+    it('promotes a valid field from a partially_promoted response', async () => {
+        const response = makeResponse({ status: 'partially_promoted', promoted_fields: ['category'] });
+        responseStore.seed(response);
+        await promoteFieldValue(stores, 'resp-1', 'score', 'entity-1');
+        expect(responseStore.promoteResponse).toHaveBeenCalledWith('resp-1', 'score');
+    });
+    it('throws if the response does not exist', async () => {
+        await expect(promoteFieldValue(stores, 'no-such-resp', 'score', 'entity-1')).rejects.toThrow('Response not found: no-such-resp');
+    });
+    it('throws if the response belongs to a different entity', async () => {
+        responseStore.seed(makeResponse({ entity_id: 'other-entity' }));
+        await expect(promoteFieldValue(stores, 'resp-1', 'score', 'entity-1')).rejects.toThrow('does not belong to the target entity');
+    });
+    it('throws if the field is not present in response values', async () => {
+        responseStore.seed(makeResponse());
+        await expect(promoteFieldValue(stores, 'resp-1', 'nonexistent_field', 'entity-1')).rejects.toThrow('"nonexistent_field" not found in response values');
+    });
+    it('throws if the response is superseded', async () => {
+        responseStore.seed(makeResponse({ status: 'superseded' }));
+        await expect(promoteFieldValue(stores, 'resp-1', 'score', 'entity-1')).rejects.toThrow('Cannot promote from a superseded response');
+    });
+    it('throws if the response is rejected', async () => {
+        responseStore.seed(makeResponse({ status: 'rejected' }));
+        await expect(promoteFieldValue(stores, 'resp-1', 'score', 'entity-1')).rejects.toThrow('Cannot promote from a rejected response');
+    });
+});
+describe('promoteFieldValueAdmin', () => {
+    let responseStore;
+    let entityStore;
+    let stores;
+    beforeEach(() => {
+        responseStore = new InMemoryResponseStore();
+        entityStore = {};
+        stores = { response: responseStore, entity: entityStore };
+    });
+    it('promotes a field from a submitted response', async () => {
+        responseStore.seed(makeResponse());
+        await promoteFieldValueAdmin(stores, 'resp-1', 'score', 'entity-1');
+        expect(responseStore.promoteResponse).toHaveBeenCalledWith('resp-1', 'score');
+    });
+    it('promotes a field even from a superseded response', async () => {
+        responseStore.seed(makeResponse({ status: 'superseded' }));
+        await promoteFieldValueAdmin(stores, 'resp-1', 'score', 'entity-1');
+        expect(responseStore.promoteResponse).toHaveBeenCalledWith('resp-1', 'score');
+    });
+    it('promotes a field even from a rejected response', async () => {
+        responseStore.seed(makeResponse({ status: 'rejected' }));
+        await promoteFieldValueAdmin(stores, 'resp-1', 'score', 'entity-1');
+        expect(responseStore.promoteResponse).toHaveBeenCalledWith('resp-1', 'score');
+    });
+    it('throws if the response does not exist', async () => {
+        await expect(promoteFieldValueAdmin(stores, 'no-such-resp', 'score', 'entity-1')).rejects.toThrow('Response not found: no-such-resp');
+    });
+    it('throws if the response belongs to a different entity', async () => {
+        responseStore.seed(makeResponse({ entity_id: 'other-entity' }));
+        await expect(promoteFieldValueAdmin(stores, 'resp-1', 'score', 'entity-1')).rejects.toThrow('does not belong to the target entity');
+    });
+    it('throws if the field is not present in response values', async () => {
+        responseStore.seed(makeResponse());
+        await expect(promoteFieldValueAdmin(stores, 'resp-1', 'missing_field', 'entity-1')).rejects.toThrow('"missing_field" not found in response values');
+    });
+});
+//# sourceMappingURL=promotion.test.js.map

package/dist/scoring/promotion.test.js.map

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

package/dist/settings/index.d.ts

@@ -0,0 +1,15 @@
+import type { DashboardPreferences } from '@sprinterai/core';
+/**
+ * Resolve settings from an ordered cascade of layers (e.g. platform → tenant → user).
+ * Performs a deep merge on nested objects and shallow merge on everything else.
+ * Later layers override earlier layers.
+ */
+export declare function resolveSettings(layers: Array<{
+    value: Record<string, unknown>;
+}>): Record<string, unknown>;
+/**
+ * Returns true if the dashboard role-selection hint should be shown.
+ * Shown to new users who haven't completed onboarding and have no activity yet.
+ */
+export declare function shouldShowDashboardRoleHint(preferences: DashboardPreferences | null | undefined, currentUserActivityCount: number): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/settings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/settings/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAM7D;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,GAChD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBzB;AAMD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,EACpD,wBAAwB,EAAE,MAAM,GAC/B,OAAO,CAIT"}

package/dist/settings/index.js

@@ -0,0 +1,47 @@
+// ---------------------------------------------------------------------------
+// Settings cascade resolver
+// ---------------------------------------------------------------------------
+/**
+ * Resolve settings from an ordered cascade of layers (e.g. platform → tenant → user).
+ * Performs a deep merge on nested objects and shallow merge on everything else.
+ * Later layers override earlier layers.
+ */
+export function resolveSettings(layers) {
+    if (layers.length === 0)
+        return {};
+    return layers.reduce((acc, layer) => {
+        for (const [key, val] of Object.entries(layer.value)) {
+            if (val !== null &&
+                typeof val === 'object' &&
+                !Array.isArray(val) &&
+                acc[key] !== null &&
+                typeof acc[key] === 'object' &&
+                !Array.isArray(acc[key])) {
+                // Deep merge nested objects (e.g. colors, darkColors)
+                acc[key] = {
+                    ...acc[key],
+                    ...val,
+                };
+            }
+            else {
+                acc[key] = val;
+            }
+        }
+        return acc;
+    }, {});
+}
+// ---------------------------------------------------------------------------
+// Dashboard onboarding
+// ---------------------------------------------------------------------------
+/**
+ * Returns true if the dashboard role-selection hint should be shown.
+ * Shown to new users who haven't completed onboarding and have no activity yet.
+ */
+export function shouldShowDashboardRoleHint(preferences, currentUserActivityCount) {
+    if (preferences?.onboardingCompleted)
+        return false;
+    if (preferences?.jobFunction)
+        return false;
+    return currentUserActivityCount === 0;
+}
+//# sourceMappingURL=index.js.map

package/dist/settings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/settings/index.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAiD;IAEjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,OAAO,MAAM,CAAC,MAAM,CAA0B,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAC3D,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,IACE,GAAG,KAAK,IAAI;gBACZ,OAAO,GAAG,KAAK,QAAQ;gBACvB,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;gBACnB,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI;gBACjB,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ;gBAC5B,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EACxB,CAAC;gBACD,sDAAsD;gBACtD,GAAG,CAAC,GAAG,CAAC,GAAG;oBACT,GAAI,GAAG,CAAC,GAAG,CAA6B;oBACxC,GAAI,GAA+B;iBACpC,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,WAAoD,EACpD,wBAAgC;IAEhC,IAAI,WAAW,EAAE,mBAAmB;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,WAAW,EAAE,WAAW;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,wBAAwB,KAAK,CAAC,CAAC;AACxC,CAAC"}

package/dist/settings/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/settings/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/settings/index.test.ts"],"names":[],"mappings":""}

package/dist/settings/index.test.js

@@ -0,0 +1,75 @@
+import { describe, it, expect } from 'vitest';
+import { resolveSettings, shouldShowDashboardRoleHint } from './index.js';
+describe('resolveSettings', () => {
+    it('returns empty object for empty layers', () => {
+        expect(resolveSettings([])).toEqual({});
+    });
+    it('returns single layer unchanged', () => {
+        const result = resolveSettings([{ value: { theme: 'dark', locale: 'en' } }]);
+        expect(result).toEqual({ theme: 'dark', locale: 'en' });
+    });
+    it('later layers override earlier layers (shallow)', () => {
+        const result = resolveSettings([
+            { value: { theme: 'light', locale: 'en' } },
+            { value: { theme: 'dark' } },
+        ]);
+        expect(result).toEqual({ theme: 'dark', locale: 'en' });
+    });
+    it('deep merges nested objects', () => {
+        const result = resolveSettings([
+            { value: { colors: { primary: 'blue', secondary: 'gray' } } },
+            { value: { colors: { primary: 'red' } } },
+        ]);
+        expect(result).toEqual({ colors: { primary: 'red', secondary: 'gray' } });
+    });
+    it('does not deep merge arrays — later overrides earlier', () => {
+        const result = resolveSettings([{ value: { items: [1, 2, 3] } }, { value: { items: [4, 5] } }]);
+        expect(result).toEqual({ items: [4, 5] });
+    });
+    it('handles null values — null overrides object', () => {
+        const result = resolveSettings([
+            { value: { config: { key: 'val' } } },
+            { value: { config: null } },
+        ]);
+        expect(result.config).toBeNull();
+    });
+    it('handles three-layer cascade (platform → tenant → user)', () => {
+        const result = resolveSettings([
+            { value: { theme: 'light', locale: 'en', colors: { primary: 'blue', accent: 'green' } } },
+            { value: { colors: { primary: 'red' } } },
+            { value: { theme: 'dark' } },
+        ]);
+        expect(result.theme).toBe('dark');
+        expect(result.locale).toBe('en');
+        expect(result.colors.primary).toBe('red');
+        expect(result.colors.accent).toBe('green');
+    });
+    it('adds new keys from later layers', () => {
+        const result = resolveSettings([{ value: { a: 1 } }, { value: { b: 2 } }]);
+        expect(result).toEqual({ a: 1, b: 2 });
+    });
+});
+describe('shouldShowDashboardRoleHint', () => {
+    it('returns true for a brand new user with no activity', () => {
+        expect(shouldShowDashboardRoleHint(null, 0)).toBe(true);
+    });
+    it('returns true for undefined preferences with no activity', () => {
+        expect(shouldShowDashboardRoleHint(undefined, 0)).toBe(true);
+    });
+    it('returns false when onboarding is completed', () => {
+        expect(shouldShowDashboardRoleHint({ onboardingCompleted: true }, 0)).toBe(false);
+    });
+    it('returns false when job function is already set', () => {
+        expect(shouldShowDashboardRoleHint({ jobFunction: 'analyst' }, 0)).toBe(false);
+    });
+    it('returns false when user has activity (not a fresh workspace)', () => {
+        expect(shouldShowDashboardRoleHint(null, 5)).toBe(false);
+    });
+    it('returns false when activity count is 1', () => {
+        expect(shouldShowDashboardRoleHint({}, 1)).toBe(false);
+    });
+    it('returns true when preferences exist but are empty and no activity', () => {
+        expect(shouldShowDashboardRoleHint({}, 0)).toBe(true);
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/settings/index.test.js.map

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

package/dist/skill/index.d.ts

@@ -0,0 +1,4 @@
+export { buildSkillIndex } from './skill-prompt.js';
+export { createLoadSkillTool } from './skill-loader.js';
+export type { SkillLoaderConfig } from './skill-loader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/skill/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/skill/index.js

@@ -0,0 +1,3 @@
+export { buildSkillIndex } from './skill-prompt.js';
+export { createLoadSkillTool } from './skill-loader.js';
+//# sourceMappingURL=index.js.map

package/dist/skill/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skill/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/skill/skill-loader.d.ts

@@ -0,0 +1,18 @@
+import type { ToolSet } from 'ai';
+export interface SkillLoaderConfig {
+    /** Fetch a skill by slug. Returns null if not found or not available. */
+    getSkillBySlug: (slug: string) => Promise<{
+        id: string;
+        slug: string;
+        name: string;
+        instructions: string | null;
+    } | null>;
+    /** Optional: called after a skill is successfully loaded (for invocation tracking). */
+    onSkillLoaded?: (skillId: string) => void;
+}
+/**
+ * Create an AI SDK loadSkill tool for agents to fetch skill instructions at runtime.
+ * Uses dependency injection so consumers control data access and tracking.
+ */
+export declare function createLoadSkillTool(config: SkillLoaderConfig): ToolSet;
+//# sourceMappingURL=skill-loader.d.ts.map

package/dist/skill/skill-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../src/skill/skill-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAGlC,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QACxC,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,GAAG,IAAI,CAAC,CAAC;IACV,uFAAuF;IACvF,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CA2BtE"}

package/dist/skill/skill-loader.js

@@ -0,0 +1,31 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+/**
+ * Create an AI SDK loadSkill tool for agents to fetch skill instructions at runtime.
+ * Uses dependency injection so consumers control data access and tracking.
+ */
+export function createLoadSkillTool(config) {
+    return {
+        loadSkill: tool({
+            description: "Load a skill's detailed instructions by its slug. Use this when you need specialized guidance for a task. The skill's instructions will be returned for you to follow.",
+            inputSchema: z.object({
+                slug: z
+                    .string()
+                    .describe("The skill slug to load (e.g., 'data-analysis', 'report-writing')"),
+            }),
+            execute: async ({ slug }) => {
+                const skill = await config.getSkillBySlug(slug);
+                if (!skill) {
+                    return { error: `Skill "${slug}" not found or not available.` };
+                }
+                config.onSkillLoaded?.(skill.id);
+                return {
+                    skillSlug: skill.slug,
+                    skillName: skill.name,
+                    instructions: skill.instructions,
+                };
+            },
+        }),
+    };
+}
+//# sourceMappingURL=skill-loader.js.map

package/dist/skill/skill-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.js","sourceRoot":"","sources":["../../src/skill/skill-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAE1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAyB;IAC3D,OAAO;QACL,SAAS,EAAE,IAAI,CAAC;YACd,WAAW,EACT,wKAAwK;YAC1K,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,IAAI,EAAE,CAAC;qBACJ,MAAM,EAAE;qBACR,QAAQ,CAAC,kEAAkE,CAAC;aAChF,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;gBAC1B,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;gBAEhD,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,OAAO,EAAE,KAAK,EAAE,UAAU,IAAI,+BAA+B,EAAE,CAAC;gBAClE,CAAC;gBAED,MAAM,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAEjC,OAAO;oBACL,SAAS,EAAE,KAAK,CAAC,IAAI;oBACrB,SAAS,EAAE,KAAK,CAAC,IAAI;oBACrB,YAAY,EAAE,KAAK,CAAC,YAAY;iBACjC,CAAC;YACJ,CAAC;SACF,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/skill/skill-loader.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skill-loader.test.d.ts.map

package/dist/skill/skill-loader.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-loader.test.d.ts","sourceRoot":"","sources":["../../src/skill/skill-loader.test.ts"],"names":[],"mappings":""}

package/dist/skill/skill-loader.test.js

@@ -0,0 +1,64 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { createLoadSkillTool } from './skill-loader.js';
+function getExecute(tools) {
+    // AI SDK Tool.execute expects (args, options) — cast through unknown for tests
+    return tools.loadSkill.execute;
+}
+function makeConfig(overrides = {}) {
+    return {
+        getSkillBySlug: vi.fn().mockResolvedValue(null),
+        ...overrides,
+    };
+}
+describe('createLoadSkillTool', () => {
+    beforeEach(() => vi.clearAllMocks());
+    it('creates a loadSkill tool', () => {
+        const tools = createLoadSkillTool(makeConfig());
+        expect(tools.loadSkill).toBeDefined();
+        expect(tools.loadSkill.description).toContain('Load a skill');
+    });
+    it('returns skill instructions on valid slug', async () => {
+        const config = makeConfig({
+            getSkillBySlug: vi.fn().mockResolvedValue({
+                id: 's1',
+                slug: 'data-analysis',
+                name: 'Data Analysis',
+                instructions: 'Follow these steps to analyze data...',
+            }),
+        });
+        const result = await getExecute(createLoadSkillTool(config))({ slug: 'data-analysis' });
+        expect(result).toMatchObject({
+            skillSlug: 'data-analysis',
+            skillName: 'Data Analysis',
+            instructions: 'Follow these steps to analyze data...',
+        });
+    });
+    it('returns error for unknown skill', async () => {
+        const result = await getExecute(createLoadSkillTool(makeConfig()))({ slug: 'nonexistent' });
+        expect(result).toMatchObject({ error: expect.stringContaining('not found') });
+    });
+    it('calls onSkillLoaded with skill id on success', async () => {
+        const onSkillLoaded = vi.fn();
+        const config = makeConfig({
+            getSkillBySlug: vi.fn().mockResolvedValue({
+                id: 's42',
+                slug: 'writing',
+                name: 'Writing',
+                instructions: null,
+            }),
+            onSkillLoaded,
+        });
+        await getExecute(createLoadSkillTool(config))({ slug: 'writing' });
+        expect(onSkillLoaded).toHaveBeenCalledWith('s42');
+    });
+    it('does not call onSkillLoaded when skill not found', async () => {
+        const onSkillLoaded = vi.fn();
+        const config = makeConfig({
+            getSkillBySlug: vi.fn().mockResolvedValue(null),
+            onSkillLoaded,
+        });
+        await getExecute(createLoadSkillTool(config))({ slug: 'missing' });
+        expect(onSkillLoaded).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=skill-loader.test.js.map

package/dist/skill/skill-loader.test.js.map

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

package/dist/skill/skill-prompt.d.ts

@@ -0,0 +1,7 @@
+import type { SkillRecord } from '@sprinterai/core';
+/**
+ * Build a skill index string for injection into agent system prompts.
+ * Lists available skills with their descriptions so the agent knows what it can load.
+ */
+export declare function buildSkillIndex(skills: SkillRecord[]): string;
+//# sourceMappingURL=skill-prompt.d.ts.map

package/dist/skill/skill-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-prompt.d.ts","sourceRoot":"","sources":["../../src/skill/skill-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAY7D"}

package/dist/skill/skill-prompt.js

@@ -0,0 +1,17 @@
+/**
+ * Build a skill index string for injection into agent system prompts.
+ * Lists available skills with their descriptions so the agent knows what it can load.
+ */
+export function buildSkillIndex(skills) {
+    if (skills.length === 0)
+        return '';
+    const lines = skills.map((s) => {
+        const desc = s.description ? ` — ${s.description}` : '';
+        return `- **${s.name}** (\`${s.slug}\`)${desc}`;
+    });
+    return `\n\n## Available Skills
+You have access to the following skills. Use the \`loadSkill\` tool with the skill's slug to load its detailed instructions when needed.
+
+${lines.join('\n')}`;
+}
+//# sourceMappingURL=skill-prompt.js.map

package/dist/skill/skill-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-prompt.js","sourceRoot":"","sources":["../../src/skill/skill-prompt.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,OAAO,OAAO,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,IAAI,MAAM,IAAI,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,OAAO;;;EAGP,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACrB,CAAC"}

package/dist/skill/skill-prompt.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skill-prompt.test.d.ts.map

package/dist/skill/skill-prompt.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-prompt.test.d.ts","sourceRoot":"","sources":["../../src/skill/skill-prompt.test.ts"],"names":[],"mappings":""}

package/dist/skill/skill-prompt.test.js

@@ -0,0 +1,44 @@
+import { describe, it, expect } from 'vitest';
+import { buildSkillIndex } from './skill-prompt.js';
+function makeSkill(overrides = {}) {
+    return {
+        id: 's1',
+        tenant_id: 'tenant-1',
+        slug: 'test',
+        name: 'Test Skill',
+        description: 'A test skill',
+        instructions: 'Do things',
+        category: 'general',
+        source: 'manual',
+        metadata: null,
+        user_invocable: false,
+        enabled: true,
+        created_at: '',
+        updated_at: '',
+        ...overrides,
+    };
+}
+describe('buildSkillIndex', () => {
+    it('returns empty string for no skills', () => {
+        expect(buildSkillIndex([])).toBe('');
+    });
+    it('formats skill list with names and slugs', () => {
+        const skills = [
+            makeSkill({ slug: 'data-analysis', name: 'Data Analysis', description: 'Analyze data' }),
+            makeSkill({ slug: 'writing', name: 'Writing', description: null }),
+        ];
+        const result = buildSkillIndex(skills);
+        expect(result).toContain('Data Analysis');
+        expect(result).toContain('`data-analysis`');
+        expect(result).toContain('Analyze data');
+        expect(result).toContain('Writing');
+        expect(result).toContain('loadSkill');
+    });
+    it('handles skills without descriptions', () => {
+        const skills = [makeSkill({ name: 'Simple', description: null })];
+        const result = buildSkillIndex(skills);
+        expect(result).toContain('Simple');
+        expect(result).not.toContain('—');
+    });
+});
+//# sourceMappingURL=skill-prompt.test.js.map

package/dist/skill/skill-prompt.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-prompt.test.js","sourceRoot":"","sources":["../../src/skill/skill-prompt.test.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,SAAS,SAAS,CAAC,YAAkC,EAAE;IACrD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,SAAS,EAAE,UAAU;QACrB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,cAAc;QAC3B,YAAY,EAAE,WAAW;QACzB,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,IAAI;QACd,cAAc,EAAE,KAAK;QACrB,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,EAAE;QACd,UAAU,EAAE,EAAE;QACd,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG;YACb,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;YACxF,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;SACnE,CAAC;QACF,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/source/index.d.ts

@@ -0,0 +1,5 @@
+export type { ValidationStatus } from './source-status.js';
+export { getSourceValidationStatus, resolveSourceSyncStatus, canRunSourceSync, isSourceDue, } from './source-status.js';
+export type { FetchedItem, SourceFetchResult, SourcePollSummary, SourcePollerConfig, SourcePoller, } from './source-poller.js';
+export { createSourcePoller } from './source-poller.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/source/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/source/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/source/index.js

@@ -0,0 +1,3 @@
+export { getSourceValidationStatus, resolveSourceSyncStatus, canRunSourceSync, isSourceDue, } from './source-status.js';
+export { createSourcePoller } from './source-poller.js';
+//# sourceMappingURL=index.js.map

package/dist/source/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/source/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}