@sprinterai/runtime 0.2.0

package/dist/eval/scorers.js

@@ -0,0 +1,76 @@
+/**
+ * Exact match scorer: 1.0 if output === expected, 0.0 otherwise.
+ * Compares JSON stringified values for deep equality.
+ */
+export const exactMatch = {
+    name: "exact-match",
+    description: "Returns 1.0 if output exactly matches expected, 0.0 otherwise.",
+    score: async ({ output, expected }) => {
+        if (expected === undefined)
+            return 0;
+        return JSON.stringify(output) === JSON.stringify(expected) ? 1.0 : 0.0;
+    },
+};
+/**
+ * Fuzzy text match scorer: compares strings case-insensitively after trimming.
+ * Returns a score based on substring containment.
+ * 1.0 = exact match, 0.5 = one contains the other, 0.0 = no match.
+ */
+export const fuzzyMatch = {
+    name: "fuzzy-match",
+    description: "Case-insensitive text comparison with partial matching.",
+    score: async ({ output, expected }) => {
+        if (expected === undefined)
+            return 0;
+        const outputStr = String(output).toLowerCase().trim();
+        const expectedStr = String(expected).toLowerCase().trim();
+        if (outputStr === expectedStr)
+            return 1.0;
+        if (outputStr.includes(expectedStr) || expectedStr.includes(outputStr)) {
+            return 0.5;
+        }
+        return 0.0;
+    },
+};
+/**
+ * Numeric closeness scorer: returns 1.0 if values are equal,
+ * decreasing as the difference increases relative to expected.
+ * Uses formula: 1 - min(|output - expected| / |expected|, 1)
+ */
+export const numericCloseness = {
+    name: "numeric-closeness",
+    description: "Scores numeric output by closeness to expected value.",
+    score: async ({ output, expected }) => {
+        const outNum = Number(output);
+        const expNum = Number(expected);
+        if (isNaN(outNum) || isNaN(expNum))
+            return 0;
+        if (expNum === 0)
+            return outNum === 0 ? 1.0 : 0.0;
+        const ratio = Math.abs(outNum - expNum) / Math.abs(expNum);
+        return Math.max(0, 1 - ratio);
+    },
+};
+/**
+ * Contains scorer: checks if the output string contains the expected string.
+ * Useful for checking if an agent mentioned specific keywords.
+ */
+export const contains = {
+    name: "contains",
+    description: "Returns 1.0 if output contains expected as substring.",
+    score: async ({ output, expected }) => {
+        if (expected === undefined)
+            return 0;
+        const outputStr = String(output).toLowerCase();
+        const expectedStr = String(expected).toLowerCase();
+        return outputStr.includes(expectedStr) ? 1.0 : 0.0;
+    },
+};
+/** All built-in scorers. */
+export const BUILT_IN_SCORERS = [
+    exactMatch,
+    fuzzyMatch,
+    numericCloseness,
+    contains,
+];
+//# sourceMappingURL=scorers.js.map

package/dist/eval/scorers.js.map

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

package/dist/eval/scorers.test.d.ts

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

package/dist/eval/scorers.test.d.ts.map

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

package/dist/eval/scorers.test.js

@@ -0,0 +1,91 @@
+import { describe, it, expect } from 'vitest';
+import { exactMatch, fuzzyMatch, numericCloseness, contains } from './scorers';
+describe('exactMatch', () => {
+    it('returns 1.0 for identical strings', async () => {
+        expect(await exactMatch.score({ input: '', output: 'hello', expected: 'hello' })).toBe(1.0);
+    });
+    it('returns 0.0 for different strings', async () => {
+        expect(await exactMatch.score({ input: '', output: 'hello', expected: 'world' })).toBe(0.0);
+    });
+    it('returns 1.0 for identical objects', async () => {
+        expect(await exactMatch.score({
+            input: '',
+            output: { a: 1 },
+            expected: { a: 1 },
+        })).toBe(1.0);
+    });
+    it('returns 0.0 when expected is undefined', async () => {
+        expect(await exactMatch.score({ input: '', output: 'test' })).toBe(0.0);
+    });
+});
+describe('fuzzyMatch', () => {
+    it('returns 1.0 for exact match (case insensitive)', async () => {
+        expect(await fuzzyMatch.score({ input: '', output: 'Hello', expected: 'hello' })).toBe(1.0);
+    });
+    it('returns 0.5 for substring containment', async () => {
+        expect(await fuzzyMatch.score({
+            input: '',
+            output: 'hello world',
+            expected: 'hello',
+        })).toBe(0.5);
+    });
+    it('returns 0.0 for no match', async () => {
+        expect(await fuzzyMatch.score({ input: '', output: 'abc', expected: 'xyz' })).toBe(0.0);
+    });
+});
+describe('numericCloseness', () => {
+    it('returns 1.0 for exact match', async () => {
+        expect(await numericCloseness.score({ input: '', output: 10, expected: 10 })).toBe(1.0);
+    });
+    it('returns close to 1 for small difference', async () => {
+        const score = await numericCloseness.score({
+            input: '',
+            output: 9.5,
+            expected: 10,
+        });
+        expect(score).toBeCloseTo(0.95, 2);
+    });
+    it('returns 0 for very large difference', async () => {
+        const score = await numericCloseness.score({
+            input: '',
+            output: 100,
+            expected: 10,
+        });
+        expect(score).toBe(0);
+    });
+    it('handles zero expected', async () => {
+        expect(await numericCloseness.score({ input: '', output: 0, expected: 0 })).toBe(1.0);
+        expect(await numericCloseness.score({ input: '', output: 5, expected: 0 })).toBe(0.0);
+    });
+    it('returns 0 for non-numeric values', async () => {
+        expect(await numericCloseness.score({
+            input: '',
+            output: 'abc',
+            expected: 10,
+        })).toBe(0);
+    });
+});
+describe('contains', () => {
+    it('returns 1.0 when output contains expected', async () => {
+        expect(await contains.score({
+            input: '',
+            output: 'The answer is 42',
+            expected: '42',
+        })).toBe(1.0);
+    });
+    it('returns 0.0 when output does not contain expected', async () => {
+        expect(await contains.score({
+            input: '',
+            output: 'no match here',
+            expected: 'xyz',
+        })).toBe(0.0);
+    });
+    it('is case insensitive', async () => {
+        expect(await contains.score({
+            input: '',
+            output: 'HELLO world',
+            expected: 'hello',
+        })).toBe(1.0);
+    });
+});
+//# sourceMappingURL=scorers.test.js.map

package/dist/eval/scorers.test.js.map

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

package/dist/guardrail/guardrail-pipeline.d.ts

@@ -0,0 +1,37 @@
+import type { GuardrailResult, InputGuardrail, OutputGuardrail, GuardrailConfig } from "@sprinterai/core";
+/** Result of running all guardrails. */
+export interface GuardrailPipelineResult {
+    passed: boolean;
+    results: Array<{
+        name: string;
+        result: GuardrailResult;
+    }>;
+    /** First failing guardrail's reason, if any. */
+    failReason?: string;
+}
+/**
+ * Run input guardrails on a message before sending to the agent.
+ * All guardrails must pass for the pipeline to pass.
+ */
+export declare function runInputGuardrails(guardrails: InputGuardrail[], content: string, metadata?: Record<string, unknown>): Promise<GuardrailPipelineResult>;
+/**
+ * Run output guardrails on agent output.
+ * All guardrails must pass for the pipeline to pass.
+ */
+export declare function runOutputGuardrails(guardrails: OutputGuardrail[], content: string, metadata?: Record<string, unknown>): Promise<GuardrailPipelineResult>;
+/**
+ * Run the full guardrail pipeline: input guardrails, then output guardrails.
+ * Returns combined results.
+ */
+export declare function runGuardrails(config: GuardrailConfig, input: {
+    content: string;
+    metadata?: Record<string, unknown>;
+}, output: {
+    content: string;
+    metadata?: Record<string, unknown>;
+}): Promise<{
+    inputResult: GuardrailPipelineResult;
+    outputResult: GuardrailPipelineResult;
+    passed: boolean;
+}>;
+//# sourceMappingURL=guardrail-pipeline.d.ts.map

package/dist/guardrail/guardrail-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrail-pipeline.d.ts","sourceRoot":"","sources":["../../src/guardrail/guardrail-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,eAAe,EACf,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAE1B,wCAAwC;AACxC,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,eAAe,CAAC;KACzB,CAAC,CAAC;IACH,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,cAAc,EAAE,EAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,uBAAuB,CAAC,CAiBlC;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,eAAe,EAAE,EAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,uBAAuB,CAAC,CAiBlC;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EAC9D,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC9D,OAAO,CAAC;IACT,WAAW,EAAE,uBAAuB,CAAC;IACrC,YAAY,EAAE,uBAAuB,CAAC;IACtC,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC,CA8BD"}

package/dist/guardrail/guardrail-pipeline.js

@@ -0,0 +1,63 @@
+/**
+ * Run input guardrails on a message before sending to the agent.
+ * All guardrails must pass for the pipeline to pass.
+ */
+export async function runInputGuardrails(guardrails, content, metadata) {
+    const results = [];
+    for (const guard of guardrails) {
+        const result = await guard.check({ content, metadata });
+        results.push({ name: guard.name, result });
+        if (!result.passed) {
+            return {
+                passed: false,
+                results,
+                failReason: result.reason ?? `Input guardrail "${guard.name}" failed`,
+            };
+        }
+    }
+    return { passed: true, results };
+}
+/**
+ * Run output guardrails on agent output.
+ * All guardrails must pass for the pipeline to pass.
+ */
+export async function runOutputGuardrails(guardrails, content, metadata) {
+    const results = [];
+    for (const guard of guardrails) {
+        const result = await guard.check({ content, metadata });
+        results.push({ name: guard.name, result });
+        if (!result.passed) {
+            return {
+                passed: false,
+                results,
+                failReason: result.reason ?? `Output guardrail "${guard.name}" failed`,
+            };
+        }
+    }
+    return { passed: true, results };
+}
+/**
+ * Run the full guardrail pipeline: input guardrails, then output guardrails.
+ * Returns combined results.
+ */
+export async function runGuardrails(config, input, output) {
+    const inputResult = config.inputGuardrails
+        ? await runInputGuardrails(config.inputGuardrails, input.content, input.metadata)
+        : { passed: true, results: [] };
+    if (!inputResult.passed) {
+        return {
+            inputResult,
+            outputResult: { passed: true, results: [] },
+            passed: false,
+        };
+    }
+    const outputResult = config.outputGuardrails
+        ? await runOutputGuardrails(config.outputGuardrails, output.content, output.metadata)
+        : { passed: true, results: [] };
+    return {
+        inputResult,
+        outputResult,
+        passed: inputResult.passed && outputResult.passed,
+    };
+}
+//# sourceMappingURL=guardrail-pipeline.js.map

package/dist/guardrail/guardrail-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrail-pipeline.js","sourceRoot":"","sources":["../../src/guardrail/guardrail-pipeline.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAA4B,EAC5B,OAAe,EACf,QAAkC;IAElC,MAAM,OAAO,GAAuC,EAAE,CAAC;IAEvD,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAE3C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO;gBACL,MAAM,EAAE,KAAK;gBACb,OAAO;gBACP,UAAU,EAAE,MAAM,CAAC,MAAM,IAAI,oBAAoB,KAAK,CAAC,IAAI,UAAU;aACtE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAA6B,EAC7B,OAAe,EACf,QAAkC;IAElC,MAAM,OAAO,GAAuC,EAAE,CAAC;IAEvD,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAE3C,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO;gBACL,MAAM,EAAE,KAAK;gBACb,OAAO;gBACP,UAAU,EAAE,MAAM,CAAC,MAAM,IAAI,qBAAqB,KAAK,CAAC,IAAI,UAAU;aACvE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAuB,EACvB,KAA8D,EAC9D,MAA+D;IAM/D,MAAM,WAAW,GAAG,MAAM,CAAC,eAAe;QACxC,CAAC,CAAC,MAAM,kBAAkB,CACtB,MAAM,CAAC,eAAe,EACtB,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,QAAQ,CACf;QACH,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAElC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO;YACL,WAAW;YACX,YAAY,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;YAC3C,MAAM,EAAE,KAAK;SACd,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,gBAAgB;QAC1C,CAAC,CAAC,MAAM,mBAAmB,CACvB,MAAM,CAAC,gBAAgB,EACvB,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,QAAQ,CAChB;QACH,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAElC,OAAO;QACL,WAAW;QACX,YAAY;QACZ,MAAM,EAAE,WAAW,CAAC,MAAM,IAAI,YAAY,CAAC,MAAM;KAClD,CAAC;AACJ,CAAC"}

package/dist/guardrail/guardrail-pipeline.test.d.ts

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

package/dist/guardrail/guardrail-pipeline.test.d.ts.map

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

package/dist/guardrail/guardrail-pipeline.test.js

@@ -0,0 +1,74 @@
+import { describe, it, expect } from 'vitest';
+import { runInputGuardrails, runOutputGuardrails, runGuardrails } from './guardrail-pipeline';
+const passingGuard = {
+    name: 'pass-guard',
+    check: async () => ({ passed: true }),
+};
+const failingGuard = {
+    name: 'fail-guard',
+    check: async () => ({ passed: false, reason: 'Content blocked' }),
+};
+const lengthGuard = {
+    name: 'length-guard',
+    description: 'Checks output is not too long',
+    check: async ({ content }) => ({
+        passed: content.length <= 100,
+        reason: content.length > 100 ? 'Output too long' : undefined,
+    }),
+};
+describe('runInputGuardrails', () => {
+    it('passes when all guardrails pass', async () => {
+        const result = await runInputGuardrails([passingGuard, passingGuard], 'hello');
+        expect(result.passed).toBe(true);
+        expect(result.results).toHaveLength(2);
+    });
+    it('fails on first failing guardrail', async () => {
+        const result = await runInputGuardrails([passingGuard, failingGuard], 'hello');
+        expect(result.passed).toBe(false);
+        expect(result.failReason).toBe('Content blocked');
+        expect(result.results).toHaveLength(2);
+    });
+    it('handles empty guardrail list', async () => {
+        const result = await runInputGuardrails([], 'hello');
+        expect(result.passed).toBe(true);
+        expect(result.results).toHaveLength(0);
+    });
+});
+describe('runOutputGuardrails', () => {
+    it('passes when output is short enough', async () => {
+        const result = await runOutputGuardrails([lengthGuard], 'short');
+        expect(result.passed).toBe(true);
+    });
+    it('fails when output is too long', async () => {
+        const longContent = 'a'.repeat(101);
+        const result = await runOutputGuardrails([lengthGuard], longContent);
+        expect(result.passed).toBe(false);
+        expect(result.failReason).toBe('Output too long');
+    });
+});
+describe('runGuardrails', () => {
+    it('runs both input and output guardrails', async () => {
+        const result = await runGuardrails({
+            inputGuardrails: [passingGuard],
+            outputGuardrails: [lengthGuard],
+        }, { content: 'input' }, { content: 'output' });
+        expect(result.passed).toBe(true);
+        expect(result.inputResult.passed).toBe(true);
+        expect(result.outputResult.passed).toBe(true);
+    });
+    it('short-circuits when input guardrail fails', async () => {
+        const result = await runGuardrails({
+            inputGuardrails: [failingGuard],
+            outputGuardrails: [lengthGuard],
+        }, { content: 'blocked' }, { content: 'output' });
+        expect(result.passed).toBe(false);
+        expect(result.inputResult.passed).toBe(false);
+        // Output guardrails were not run
+        expect(result.outputResult.results).toHaveLength(0);
+    });
+    it('handles no guardrails configured', async () => {
+        const result = await runGuardrails({}, { content: 'input' }, { content: 'output' });
+        expect(result.passed).toBe(true);
+    });
+});
+//# sourceMappingURL=guardrail-pipeline.test.js.map

package/dist/guardrail/guardrail-pipeline.test.js.map

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

package/dist/guardrail/index.d.ts

@@ -0,0 +1,3 @@
+export { runInputGuardrails, runOutputGuardrails, runGuardrails, } from "./guardrail-pipeline";
+export type { GuardrailPipelineResult } from "./guardrail-pipeline";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guardrail/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/guardrail/index.js

@@ -0,0 +1,2 @@
+export { runInputGuardrails, runOutputGuardrails, runGuardrails, } from "./guardrail-pipeline";
+//# sourceMappingURL=index.js.map

package/dist/guardrail/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/guardrail/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,sBAAsB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+export { InMemoryEntityStore, InMemoryAgentStore, InMemoryChatStore, InMemoryTenantStore, InMemoryToolStore, InMemoryTaskStore, InMemoryMemoryStore, } from "./testing";
+export { ToolRegistry } from "./tool";
+export { toAITool, toAIToolSet } from "./tool";
+export { executeTool } from "./tool";
+export type { ExecuteToolOptions, ExecuteToolResult } from "./tool";
+export { createEntityTools } from "./tool";
+export { resolveAgentTools } from "./tool";
+export type { ResolveToolsOptions } from "./tool";
+export { buildAgentPrompt } from "./agent";
+export type { PromptSection } from "./agent";
+export { AgentRegistry } from "./agent";
+export { resolveAgent } from "./agent";
+export type { ResolvedAgent, ResolveAgentOptions } from "./agent";
+export { executeAgentStream, executeAgentGenerate } from "./agent";
+export type { ExecuteAgentConfig, ExecuteAgentResult, AgentStreamResult, } from "./agent";
+export { createDelegateToAgentTool } from "./agent";
+export type { CreateDelegateToolOptions } from "./agent";
+export { createChatRouteHandler } from "./chat";
+export type { ChatHandlerConfig, ChatRequest, ChatHandler, ChatContext, } from "./chat";
+export { validateMessage, sanitizeContent, extractTextFromParts, toAIMessages, } from "./chat";
+export { compileEntityWorkflowDefinition, getWorkflowLayers } from "./workflow";
+export { computeWorkflowProgress, deriveWorkflowStatus } from "./workflow";
+export type { WorkflowProgress } from "./workflow";
+export { computeResponseScore, mean, median, min, max, aggregateScores, } from "./scoring";
+export type { ScoreAggregation } from "./scoring";
+export { loadModules } from "./module";
+export type { LoadedModules } from "./module";
+export { createPlatformRuntime } from "./module";
+export type { PlatformRuntimeConfig, PlatformRuntime, RuntimeStores, } from "./module";
+export { discoverMCPTools } from "./adapters";
+export type { MCPAdapterConfig } from "./adapters";
+export { createA2AAgent } from "./adapters";
+export type { A2AAdapterConfig } from "./adapters";
+export { createOpenClawModel } from "./adapters";
+export type { OpenClawAdapterConfig } from "./adapters";
+export { createHTTPAgent } from "./adapters";
+export type { HTTPAgentAdapterConfig } from "./adapters";
+export { exactMatch, fuzzyMatch, numericCloseness, contains, BUILT_IN_SCORERS, } from "./eval";
+export { runEval } from "./eval";
+export type { EvalTarget, RunEvalOptions } from "./eval";
+export { loadMemories } from "./memory";
+export type { MemoryLoadContext, LoadedMemories } from "./memory";
+export { buildMemoryPrompt } from "./memory";
+export { runInputGuardrails, runOutputGuardrails, runGuardrails, } from "./guardrail";
+export type { GuardrailPipelineResult } from "./guardrail";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,39 @@
+// ─── Testing (InMemory Stores) ──────────────────────────────
+export { InMemoryEntityStore, InMemoryAgentStore, InMemoryChatStore, InMemoryTenantStore, InMemoryToolStore, InMemoryTaskStore, InMemoryMemoryStore, } from "./testing";
+// ─── Tool System ────────────────────────────────────────────
+export { ToolRegistry } from "./tool";
+export { toAITool, toAIToolSet } from "./tool";
+export { executeTool } from "./tool";
+export { createEntityTools } from "./tool";
+export { resolveAgentTools } from "./tool";
+// ─── Agent System ───────────────────────────────────────────
+export { buildAgentPrompt } from "./agent";
+export { AgentRegistry } from "./agent";
+export { resolveAgent } from "./agent";
+export { executeAgentStream, executeAgentGenerate } from "./agent";
+export { createDelegateToAgentTool } from "./agent";
+// ─── Chat ───────────────────────────────────────────────────
+export { createChatRouteHandler } from "./chat";
+export { validateMessage, sanitizeContent, extractTextFromParts, toAIMessages, } from "./chat";
+// ─── Workflow ───────────────────────────────────────────────
+export { compileEntityWorkflowDefinition, getWorkflowLayers } from "./workflow";
+export { computeWorkflowProgress, deriveWorkflowStatus } from "./workflow";
+// ─── Scoring ────────────────────────────────────────────────
+export { computeResponseScore, mean, median, min, max, aggregateScores, } from "./scoring";
+// ─── Module System ──────────────────────────────────────────
+export { loadModules } from "./module";
+export { createPlatformRuntime } from "./module";
+// ─── Adapters ───────────────────────────────────────────────
+export { discoverMCPTools } from "./adapters";
+export { createA2AAgent } from "./adapters";
+export { createOpenClawModel } from "./adapters";
+export { createHTTPAgent } from "./adapters";
+// ─── Eval ───────────────────────────────────────────────────
+export { exactMatch, fuzzyMatch, numericCloseness, contains, BUILT_IN_SCORERS, } from "./eval";
+export { runEval } from "./eval";
+// ─── Memory ─────────────────────────────────────────────────
+export { loadMemories } from "./memory";
+export { buildMemoryPrompt } from "./memory";
+// ─── Guardrails ─────────────────────────────────────────────
+export { runInputGuardrails, runOutputGuardrails, runGuardrails, } from "./guardrail";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAEnB,+DAA+D;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAG3C,+DAA+D;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAMnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAGpD,+DAA+D;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AAOhD,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,YAAY,GACb,MAAM,QAAQ,CAAC;AAEhB,+DAA+D;AAC/D,OAAO,EAAE,+BAA+B,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAG3E,+DAA+D;AAC/D,OAAO,EACL,oBAAoB,EACpB,IAAI,EACJ,MAAM,EACN,GAAG,EACH,GAAG,EACH,eAAe,GAChB,MAAM,WAAW,CAAC;AAGnB,+DAA+D;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAOjD,+DAA+D;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG7C,+DAA+D;AAC/D,OAAO,EACL,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACR,gBAAgB,GACjB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGjC,+DAA+D;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,+DAA+D;AAC/D,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,aAAa,CAAC"}

package/dist/memory/index.d.ts

@@ -0,0 +1,4 @@
+export { loadMemories } from "./memory-manager";
+export type { MemoryLoadContext, LoadedMemories } from "./memory-manager";
+export { buildMemoryPrompt } from "./memory-prompt";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,3 @@
+export { loadMemories } from "./memory-manager";
+export { buildMemoryPrompt } from "./memory-prompt";
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/memory/memory-manager.d.ts

@@ -0,0 +1,28 @@
+import type { MemoryStore, UserMemory, AgentMemoryConfig } from "@sprinterai/core";
+/** Context for memory loading. */
+export interface MemoryLoadContext {
+    userId: string;
+    chatId?: string;
+    currentQuery?: string;
+    config?: AgentMemoryConfig;
+}
+/** All memories loaded for prompt injection. */
+export interface LoadedMemories {
+    /** Explicit user memories (corrections, preferences). */
+    userMemories: UserMemory[];
+    /** Semantically similar past memories. */
+    semanticMemories: UserMemory[];
+}
+/**
+ * Load memories from the store for prompt injection.
+ *
+ * 4-layer memory system:
+ * 1. History — conversation history (handled by chat, not here)
+ * 2. Semantic — vector-indexed long-term memory
+ * 3. Working — ephemeral scratchpad (handled by caller)
+ * 4. Context — tenant-level corrections (handled by caller)
+ *
+ * This function handles layers 1 (user memories) and 2 (semantic search).
+ */
+export declare function loadMemories(store: MemoryStore, context: MemoryLoadContext): Promise<LoadedMemories>;
+//# sourceMappingURL=memory-manager.d.ts.map

package/dist/memory/memory-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../../src/memory/memory-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAG1B,kCAAkC;AAClC,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,0CAA0C;IAC1C,gBAAgB,EAAE,UAAU,EAAE,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,cAAc,CAAC,CAwBzB"}

package/dist/memory/memory-manager.js

@@ -0,0 +1,34 @@
+import { MAX_MEMORIES_FOR_PROMPT } from "@sprinterai/core";
+/**
+ * Load memories from the store for prompt injection.
+ *
+ * 4-layer memory system:
+ * 1. History — conversation history (handled by chat, not here)
+ * 2. Semantic — vector-indexed long-term memory
+ * 3. Working — ephemeral scratchpad (handled by caller)
+ * 4. Context — tenant-level corrections (handled by caller)
+ *
+ * This function handles layers 1 (user memories) and 2 (semantic search).
+ */
+export async function loadMemories(store, context) {
+    const config = context.config ?? {
+        semanticEnabled: true,
+        semanticTopK: 5,
+    };
+    const limit = MAX_MEMORIES_FOR_PROMPT;
+    // Load user's explicit memories
+    const userMemories = await store.getUserMemories(context.userId, {
+        limit,
+        source: "user",
+    });
+    // Load semantic memories if enabled and we have a query
+    let semanticMemories = [];
+    if (config.semanticEnabled && context.currentQuery) {
+        semanticMemories = await store.searchSimilarMessages(context.currentQuery, {
+            userId: context.userId,
+            limit: config.semanticTopK ?? 5,
+        });
+    }
+    return { userMemories, semanticMemories };
+}
+//# sourceMappingURL=memory-manager.js.map

package/dist/memory/memory-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.js","sourceRoot":"","sources":["../../src/memory/memory-manager.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAkB3D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAkB,EAClB,OAA0B;IAE1B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI;QAC/B,eAAe,EAAE,IAAI;QACrB,YAAY,EAAE,CAAC;KAChB,CAAC;IAEF,MAAM,KAAK,GAAG,uBAAuB,CAAC;IAEtC,gCAAgC;IAChC,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,EAAE;QAC/D,KAAK;QACL,MAAM,EAAE,MAAM;KACf,CAAC,CAAC;IAEH,wDAAwD;IACxD,IAAI,gBAAgB,GAAiB,EAAE,CAAC;IACxC,IAAI,MAAM,CAAC,eAAe,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACnD,gBAAgB,GAAG,MAAM,KAAK,CAAC,qBAAqB,CAAC,OAAO,CAAC,YAAY,EAAE;YACzE,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,MAAM,CAAC,YAAY,IAAI,CAAC;SAChC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAC5C,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { UserMemory } from '@sprinterai/core';
+import type { PromptSection } from '../agent/prompt-builder';
+/**
+ * Build a prompt section from loaded memories.
+ *
+ * Formats memories as a bullet list for injection into the system prompt.
+ * Returns a PromptSection that can be composed with other sections.
+ */
+export declare function buildMemoryPrompt(userMemories: UserMemory[], semanticMemories: UserMemory[]): PromptSection | null;
+//# sourceMappingURL=memory-prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-prompt.d.ts","sourceRoot":"","sources":["../../src/memory/memory-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,UAAU,EAAE,EAC1B,gBAAgB,EAAE,UAAU,EAAE,GAC7B,aAAa,GAAG,IAAI,CAwBtB"}