@primo-ai/core 0.1.0

package/dist/concurrency-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency-controller.js","sourceRoot":"","sources":["../src/concurrency-controller.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,qBAAqB;IACxB,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE7C,YAAY,QAA2B;QACrC,KAAK,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC9C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,OAAO,CAAC,OAAe,EAAE,SAAkB;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE;gBAC1B,IAAI,QAAQ;oBAAE,OAAO;gBACrB,QAAQ,GAAG,IAAI,CAAC;gBAChB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACzB,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,SAAS,GAAwB,IAAI,CAAC;QAE1C,MAAM,cAAc,GAAG,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,EAAE;YACzD,MAAM,MAAM,GAAG,GAAG,EAAE;gBAClB,IAAI,QAAQ,GAAG,KAAK,CAAC;gBACrB,OAAO,CAAC,GAAG,EAAE;oBACX,IAAI,QAAQ;wBAAE,OAAO;oBACrB,QAAQ,GAAG,IAAI,CAAC;oBAChB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBACzB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC;YACF,SAAS,GAAG,MAAM,CAAC;YACnB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;YACtB,OAAO,cAAc,CAAC;QACxB,CAAC;QAED,IAAI,KAAoC,CAAC;QACzC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;YACtD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,sDAAsD;gBACtD,IAAI,SAAS,EAAE,CAAC;oBACd,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;oBAC5C,IAAI,GAAG,KAAK,CAAC,CAAC;wBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAC9C,CAAC;gBACD,MAAM,CAAC,IAAI,KAAK,CAAC,2CAA2C,OAAO,WAAW,SAAS,IAAI,CAAC,CAAC,CAAC;YAChG,CAAC,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YACjE,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,+EAA+E;YAC/E,+CAA+C;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,cAAc,CAAC,OAAe;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IAEO,WAAW,CAAC,IAAe;QACjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAG,CAAC;YACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,EAAE,CAAC;QACT,CAAC;IACH,CAAC;CACF"}

package/dist/config-merge.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Deep merge utility for configuration objects.
+ *
+ * Rules:
+ * - Plain objects are merged recursively.
+ * - For keys in CONCAT_KEYS ('plugins', 'modelGateways'), arrays are concatenated.
+ * - All other arrays, primitives, and other types are replaced by the later value.
+ * - null/undefined sources are skipped.
+ * - The target is NOT mutated; a new object is returned.
+ */
+export declare function deepMerge(target: Record<string, unknown>, ...sources: Record<string, unknown>[]): Record<string, unknown>;
+//# sourceMappingURL=config-merge.d.ts.map

package/dist/config-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-merge.d.ts","sourceRoot":"","sources":["../src/config-merge.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmCzB"}

package/dist/config-merge.js

@@ -0,0 +1,47 @@
+/**
+ * Keys whose arrays should be concatenated rather than replaced during merge.
+ */
+const CONCAT_KEYS = new Set(['plugins', 'modelGateways']);
+/**
+ * Deep merge utility for configuration objects.
+ *
+ * Rules:
+ * - Plain objects are merged recursively.
+ * - For keys in CONCAT_KEYS ('plugins', 'modelGateways'), arrays are concatenated.
+ * - All other arrays, primitives, and other types are replaced by the later value.
+ * - null/undefined sources are skipped.
+ * - The target is NOT mutated; a new object is returned.
+ */
+export function deepMerge(target, ...sources) {
+    const result = { ...target };
+    for (const key in result) {
+        if (isObject(result[key])) {
+            result[key] = { ...result[key] };
+        }
+    }
+    for (const source of sources) {
+        if (source == null)
+            continue;
+        for (const key of Object.keys(source)) {
+            const sourceVal = source[key];
+            if (sourceVal == null)
+                continue;
+            if (isObject(sourceVal) && isObject(result[key])) {
+                result[key] = deepMerge(result[key], sourceVal);
+            }
+            else if (Array.isArray(sourceVal) &&
+                Array.isArray(result[key]) &&
+                CONCAT_KEYS.has(key)) {
+                result[key] = [...result[key], ...sourceVal];
+            }
+            else {
+                result[key] = sourceVal;
+            }
+        }
+    }
+    return result;
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=config-merge.js.map

package/dist/config-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-merge.js","sourceRoot":"","sources":["../src/config-merge.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;AAE1D;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CACvB,MAA+B,EAC/B,GAAG,OAAkC;IAErC,MAAM,MAAM,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IAEtD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAI,MAAM,CAAC,GAAG,CAA6B,EAAE,CAAC;QAChE,CAAC;IACH,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,IAAI,IAAI;YAAE,SAAS;QAE7B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAE9B,IAAI,SAAS,IAAI,IAAI;gBAAE,SAAS;YAEhC,IAAI,QAAQ,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACjD,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CACrB,MAAM,CAAC,GAAG,CAA4B,EACtC,SAAoC,CACrC,CAAC;YACJ,CAAC;iBAAM,IACL,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;gBACxB,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC1B,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EACpB,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAI,MAAM,CAAC,GAAG,CAAe,EAAE,GAAG,SAAS,CAAC,CAAC;YAC9D,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,16 @@
+import type { HarnessConfig } from '@primo-ai/sdk';
+export interface ConfigSource {
+    global?: string;
+    project?: string;
+    env?: string;
+    session?: Partial<HarnessConfig>;
+}
+export declare class ConfigLoader {
+    private fileReader;
+    constructor(options?: {
+        fileReader?: (path: string) => Promise<string>;
+    });
+    parseJsonc(content: string): Record<string, unknown>;
+    load(sources: ConfigSource): Promise<HarnessConfig>;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAQnD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CAClC;AAMD,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAoC;gBAE1C,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE;IAYxE,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAc9C,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;CAmD1D"}

package/dist/config.js

@@ -0,0 +1,144 @@
+import { z } from 'zod';
+import { deepMerge } from './config-merge.js';
+// ---------------------------------------------------------------------------
+// ConfigLoader
+// ---------------------------------------------------------------------------
+export class ConfigLoader {
+    fileReader;
+    constructor(options) {
+        this.fileReader =
+            options?.fileReader ??
+                ((path) => import('node:fs/promises').then((fs) => fs.readFile(path, 'utf-8')));
+    }
+    // -------------------------------------------------------------------------
+    // JSONC parser — strips comments and trailing commas without touching
+    // string contents.
+    // -------------------------------------------------------------------------
+    parseJsonc(content) {
+        const stripped = stripJsonc(content);
+        try {
+            return JSON.parse(stripped);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`Invalid JSONC: ${msg}`);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Load — merge multiple layers
+    // -------------------------------------------------------------------------
+    async load(sources) {
+        const layers = [];
+        // 1. Environment (lowest priority)
+        if (sources.env) {
+            layers.push(this.parseJsonc(sources.env));
+        }
+        // 2. Global config file
+        if (sources.global) {
+            try {
+                const content = await this.fileReader(sources.global);
+                layers.push(this.parseJsonc(content));
+            }
+            catch {
+                // missing global config is ok
+            }
+        }
+        // 3. Project config file
+        if (sources.project) {
+            try {
+                const content = await this.fileReader(sources.project);
+                layers.push(this.parseJsonc(content));
+            }
+            catch {
+                // missing project config is ok
+            }
+        }
+        // 4. Session (highest priority)
+        if (sources.session) {
+            layers.push(sources.session);
+        }
+        if (layers.length === 0)
+            return {};
+        // Merge left to right: later layers win
+        const merged = layers.reduce((acc, layer) => deepMerge(acc, layer), {});
+        const result = HarnessConfigSchema.safeParse(merged);
+        if (!result.success) {
+            const issues = result.error.issues
+                .map((i) => `  ${i.path.join('.')}: ${i.message}`)
+                .join('\n');
+            throw new Error(`Invalid config:\n${issues}`);
+        }
+        return result.data;
+    }
+}
+// ---------------------------------------------------------------------------
+// JSONC stripping — character-by-character to respect string boundaries
+// ---------------------------------------------------------------------------
+function stripJsonc(input) {
+    let result = '';
+    let i = 0;
+    const len = input.length;
+    while (i < len) {
+        // Inside a string — copy verbatim until closing quote
+        if (input[i] === '"') {
+            result += input[i];
+            i++;
+            while (i < len) {
+                if (input[i] === '\\' && i + 1 < len) {
+                    // Escaped character — copy both
+                    result += input[i] + input[i + 1];
+                    i += 2;
+                }
+                else if (input[i] === '"') {
+                    result += input[i];
+                    i++;
+                    break;
+                }
+                else {
+                    result += input[i];
+                    i++;
+                }
+            }
+            continue;
+        }
+        // Single-line comment
+        if (input[i] === '/' && i + 1 < len && input[i + 1] === '/') {
+            // Skip until end of line
+            i += 2;
+            while (i < len && input[i] !== '\n') {
+                i++;
+            }
+            continue;
+        }
+        // Block comment
+        if (input[i] === '/' && i + 1 < len && input[i + 1] === '*') {
+            i += 2;
+            while (i < len && !(input[i] === '*' && i + 1 < len && input[i + 1] === '/')) {
+                i++;
+            }
+            i += 2; // skip */
+            continue;
+        }
+        result += input[i];
+        i++;
+    }
+    // Strip trailing commas before } or ]
+    result = result.replace(/,\s*([}\]])/g, '$1');
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Zod schema for HarnessConfig validation
+// ---------------------------------------------------------------------------
+const HarnessConfigSchema = z.object({
+    agents: z.record(z.string(), z.unknown()).optional(),
+    tools: z.object({ enabled: z.array(z.string()).optional(), disabled: z.array(z.string()).optional() }).optional(),
+    plugins: z.array(z.string()).optional(),
+    session: z.object({ storage: z.enum(['file', 'memory']).optional(), path: z.string().optional() }).optional(),
+    modelProfiles: z.array(z.unknown()).optional(),
+    modelGateways: z.array(z.object({
+        name: z.string(),
+        url: z.string(),
+        apiKey: z.string().optional(),
+    })).optional(),
+}).passthrough();
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/context-builder.d.ts

@@ -0,0 +1,29 @@
+import type { CompressionStrategy, ContextBudget, Message, ModelProfile, PipelineContext, Processor, TokenCounter } from '@primo-ai/sdk';
+import type { ToolRegistry } from './tool-registry.js';
+export interface ContextBuilderOptions {
+    registry: ToolRegistry;
+    tokenCounter?: TokenCounter;
+    compressionStrategy?: CompressionStrategy;
+    profiles?: ModelProfile[];
+    budget?: ContextBudget;
+}
+export declare function slidingWindow(messages: Message[], _tc: TokenCounter, _budget: number): Message[];
+export declare class ContextBuilder {
+    private readonly registry;
+    private readonly tokenCounter;
+    private compressionStrategy;
+    private profiles;
+    private budget;
+    constructor(options: ContextBuilderOptions);
+    setCompressionStrategy(strategy: CompressionStrategy): void;
+    setProfiles(profiles: ModelProfile[]): void;
+    setBudget(budget: ContextBudget): void;
+    assemble(ctx: PipelineContext): Promise<PipelineContext>;
+    createProcessor(): Processor;
+    private resolveSystemPrompt;
+    private resolveToolDeclarations;
+    private trimHistory;
+    private countToolDeclarations;
+    private matchProfile;
+}
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../src/context-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,OAAO,EACP,YAAY,EACZ,eAAe,EACf,SAAS,EACT,YAAY,EACb,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,YAAY,CAAC;IACvB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAID,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAEhG;AAgDD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,MAAM,CAAgB;gBAElB,OAAO,EAAE,qBAAqB;IAQ1C,sBAAsB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAI3D,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAI3C,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAIhC,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAW9D,eAAe,IAAI,SAAS;IAO5B,OAAO,CAAC,mBAAmB;IA+B3B,OAAO,CAAC,uBAAuB;YA0BjB,WAAW;IAkCzB,OAAO,CAAC,qBAAqB;IAM7B,OAAO,CAAC,YAAY;CAUrB"}

package/dist/context-builder.js

@@ -0,0 +1,178 @@
+import { TiktokenCounter } from './token-counter.js';
+const DEFAULT_BUDGET = { maxTokens: 128_000 };
+export function slidingWindow(messages, _tc, _budget) {
+    return messages.length > 50 ? messages.slice(-50) : messages;
+}
+const RECENT_KEEP = 10;
+const TOOL_PREVIEW_LENGTH = 200;
+function semanticTruncation(messages, tc, budget) {
+    if (messages.length === 0)
+        return messages;
+    const recent = messages.slice(-RECENT_KEEP);
+    const recentTokens = tc.countMessages(recent);
+    if (recentTokens >= budget) {
+        const kept = [];
+        for (let i = recent.length - 1; i >= 0; i--) {
+            const candidate = [recent[i], ...kept];
+            if (tc.countMessages(candidate) > budget)
+                break;
+            kept.unshift(recent[i]);
+        }
+        return kept;
+    }
+    const older = messages.slice(0, -RECENT_KEEP);
+    if (older.length === 0)
+        return messages;
+    const remainingBudget = budget - recentTokens;
+    const truncatedOlder = older.map(msg => {
+        if (msg.role === 'tool') {
+            const content = typeof msg.content === 'string' ? msg.content : String(msg.content);
+            if (content.length > TOOL_PREVIEW_LENGTH) {
+                return { ...msg, content: content.slice(0, TOOL_PREVIEW_LENGTH) + '... [truncated]' };
+            }
+        }
+        return msg;
+    });
+    const filled = [];
+    let filledTokens = 0;
+    for (let i = truncatedOlder.length - 1; i >= 0; i--) {
+        const candidateTokens = tc.countMessages([truncatedOlder[i]]);
+        if (filledTokens + candidateTokens > remainingBudget)
+            break;
+        filled.unshift(truncatedOlder[i]);
+        filledTokens += candidateTokens;
+    }
+    return [...filled, ...recent];
+}
+export class ContextBuilder {
+    registry;
+    tokenCounter;
+    compressionStrategy;
+    profiles;
+    budget;
+    constructor(options) {
+        this.registry = options.registry;
+        this.tokenCounter = options.tokenCounter ?? new TiktokenCounter();
+        this.compressionStrategy = options.compressionStrategy ?? semanticTruncation;
+        this.profiles = options.profiles ?? [];
+        this.budget = options.budget ?? DEFAULT_BUDGET;
+    }
+    setCompressionStrategy(strategy) {
+        this.compressionStrategy = strategy;
+    }
+    setProfiles(profiles) {
+        this.profiles = profiles;
+    }
+    setBudget(budget) {
+        this.budget = budget;
+    }
+    async assemble(ctx) {
+        const model = ctx.agent.config.model;
+        const profile = this.matchProfile(model);
+        ctx = this.resolveSystemPrompt(ctx, profile);
+        ctx = this.resolveToolDeclarations(ctx, profile);
+        ctx = await this.trimHistory(ctx, model);
+        return ctx;
+    }
+    createProcessor() {
+        return {
+            stage: 'buildContext',
+            execute: (ctx) => this.assemble(ctx),
+        };
+    }
+    resolveSystemPrompt(ctx, profile) {
+        const parts = [];
+        if (ctx.agent.config.systemPrompt) {
+            parts.push(ctx.agent.config.systemPrompt);
+        }
+        const extraFragments = profile?.extraPromptFragments?.map((f) => f.content) ?? [];
+        const promptFragments = [...ctx.agent.promptFragments, ...extraFragments];
+        if (promptFragments.length > 0) {
+            parts.push(...promptFragments);
+        }
+        if (profile?.systemPromptSuffix) {
+            parts.push(profile.systemPromptSuffix);
+        }
+        const systemPrompt = parts.length > 0 ? parts.join('\n\n') : undefined;
+        return {
+            ...ctx,
+            agent: {
+                ...ctx.agent,
+                systemPrompt,
+                promptFragments,
+                _assembledFragmentCount: promptFragments.length,
+            },
+        };
+    }
+    resolveToolDeclarations(ctx, profile) {
+        const overrides = profile?.toolOverrides ?? {};
+        const toolDeclarations = this.registry.getAll().map((t) => ({
+            name: t.name,
+            description: t.description,
+        })).filter((tool) => {
+            const override = overrides[tool.name];
+            return !override?.exclude;
+        }).map((tool) => {
+            const override = overrides[tool.name];
+            if (override?.description) {
+                return { ...tool, description: override.description };
+            }
+            return tool;
+        });
+        return {
+            ...ctx,
+            agent: {
+                ...ctx.agent,
+                toolDeclarations,
+                providerOptions: ctx.agent.config.providerOptions,
+            },
+        };
+    }
+    async trimHistory(ctx, model) {
+        const history = ctx.session.messageHistory;
+        if (!history || history.length === 0)
+            return ctx;
+        const systemTokens = ctx.agent.systemPrompt
+            ? this.tokenCounter.count(ctx.agent.systemPrompt, model)
+            : 0;
+        const toolTokens = this.countToolDeclarations(ctx.agent.toolDeclarations, model);
+        const reservedSystem = this.budget.reservedForSystem ?? 0;
+        const reservedTools = this.budget.reservedForTools ?? 0;
+        const overhead = Math.max(systemTokens, reservedSystem) + Math.max(toolTokens, reservedTools);
+        const historyBudget = this.budget.maxTokens - overhead;
+        const historyTokens = this.tokenCounter.countMessages(history, model);
+        if (historyTokens <= historyBudget)
+            return ctx;
+        let compressed = history;
+        let compressedTokens = historyTokens;
+        const maxPasses = 5;
+        for (let pass = 0; pass < maxPasses && compressedTokens > historyBudget; pass++) {
+            compressed = await this.compressionStrategy(compressed, this.tokenCounter, historyBudget);
+            compressedTokens = this.tokenCounter.countMessages(compressed, model);
+        }
+        return {
+            ...ctx,
+            session: { ...ctx.session, messageHistory: compressed },
+        };
+    }
+    countToolDeclarations(declarations, model) {
+        if (declarations.length === 0)
+            return 0;
+        const text = declarations.map((d) => `${d.name}: ${d.description}`).join('\n');
+        return this.tokenCounter.count(text, model);
+    }
+    matchProfile(model) {
+        for (const profile of this.profiles) {
+            if (profile.modelPattern instanceof RegExp) {
+                if (profile.modelPattern.test(model))
+                    return profile;
+            }
+            else {
+                if (model.includes(profile.modelPattern))
+                    return profile;
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=context-builder.js.map

package/dist/context-builder.js.map

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

package/dist/dynamic-resolver.d.ts

@@ -0,0 +1,7 @@
+import type { Dynamic, ResolveContext } from '@primo-ai/sdk';
+/**
+ * Resolve a Dynamic<T> value: if it's a function, call it with the context;
+ * otherwise return the static value as-is.
+ */
+export declare function resolveDynamic<T>(value: Dynamic<T>, ctx: ResolveContext): Promise<T>;
+//# sourceMappingURL=dynamic-resolver.d.ts.map

package/dist/dynamic-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-resolver.d.ts","sourceRoot":"","sources":["../src/dynamic-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE7D;;;GAGG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EACjB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,CAAC,CAAC,CAKZ"}

package/dist/dynamic-resolver.js

@@ -0,0 +1,11 @@
+/**
+ * Resolve a Dynamic<T> value: if it's a function, call it with the context;
+ * otherwise return the static value as-is.
+ */
+export async function resolveDynamic(value, ctx) {
+    if (typeof value === 'function') {
+        return value(ctx);
+    }
+    return value;
+}
+//# sourceMappingURL=dynamic-resolver.js.map

package/dist/dynamic-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-resolver.js","sourceRoot":"","sources":["../src/dynamic-resolver.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAiB,EACjB,GAAmB;IAEnB,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAQ,KAAiD,CAAC,GAAG,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,30 @@
+export interface AgentErrorOptions {
+    code: string;
+    recoverable?: boolean;
+    retryCount?: number;
+    maxRetries?: number;
+    cause?: Error;
+}
+export declare class AgentForgeError extends Error {
+    readonly code: string;
+    readonly recoverable: boolean;
+    readonly retryCount?: number;
+    readonly maxRetries?: number;
+    constructor(message: string, options: AgentErrorOptions);
+}
+export declare class RecoverableError extends AgentForgeError {
+    constructor(message: string, options: Omit<AgentErrorOptions, 'recoverable'>);
+}
+export declare class FatalError extends AgentForgeError {
+    constructor(message: string, options: Omit<AgentErrorOptions, 'recoverable'>);
+}
+export declare class AuthError extends FatalError {
+    constructor(message: string, cause?: Error);
+}
+export declare class ModelNotFoundError extends FatalError {
+    constructor(modelString: string, cause?: Error);
+}
+export declare class ToolExecutionError extends RecoverableError {
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB;CAQxD;AAED,qBAAa,gBAAiB,SAAQ,eAAe;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC;CAG7E;AAED,qBAAa,UAAW,SAAQ,eAAe;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC;CAG7E;AAED,qBAAa,SAAU,SAAQ,UAAU;gBAC3B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG3C;AAED,qBAAa,kBAAmB,SAAQ,UAAU;gBACpC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG/C;AAED,qBAAa,kBAAmB,SAAQ,gBAAgB;gBAC1C,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG3C"}

package/dist/errors.js

@@ -0,0 +1,40 @@
+export class AgentForgeError extends Error {
+    code;
+    recoverable;
+    retryCount;
+    maxRetries;
+    constructor(message, options) {
+        super(message, { cause: options.cause });
+        this.name = new.target.name;
+        this.code = options.code;
+        this.recoverable = options.recoverable ?? false;
+        this.retryCount = options.retryCount;
+        this.maxRetries = options.maxRetries;
+    }
+}
+export class RecoverableError extends AgentForgeError {
+    constructor(message, options) {
+        super(message, { ...options, recoverable: true });
+    }
+}
+export class FatalError extends AgentForgeError {
+    constructor(message, options) {
+        super(message, { ...options, recoverable: false });
+    }
+}
+export class AuthError extends FatalError {
+    constructor(message, cause) {
+        super(message, { code: 'AUTH', cause });
+    }
+}
+export class ModelNotFoundError extends FatalError {
+    constructor(modelString, cause) {
+        super(`Model not found: "${modelString}"`, { code: 'MODEL_NOT_FOUND', cause });
+    }
+}
+export class ToolExecutionError extends RecoverableError {
+    constructor(message, cause) {
+        super(message, { code: 'TOOL_ERROR', cause });
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAS;IACb,WAAW,CAAU;IACrB,UAAU,CAAU;IACpB,UAAU,CAAU;IAE7B,YAAY,OAAe,EAAE,OAA0B;QACrD,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC;QAChD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IACnD,YAAY,OAAe,EAAE,OAA+C;QAC1E,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,eAAe;IAC7C,YAAY,OAAe,EAAE,OAA+C;QAC1E,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,UAAU;IACvC,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IAChD,YAAY,WAAmB,EAAE,KAAa;QAC5C,KAAK,CAAC,qBAAqB,WAAW,GAAG,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC,CAAC;IACjF,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,gBAAgB;IACtD,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;IAChD,CAAC;CACF"}

package/dist/event-bus.d.ts

@@ -0,0 +1,8 @@
+export declare class EventBus {
+    private onError?;
+    private handlers;
+    constructor(onError?: ((error: unknown, eventType: string) => void) | undefined);
+    emit(eventType: string, data?: unknown): void;
+    subscribe(eventType: string, handler: (data?: unknown) => void): () => void;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAQ;IAGP,OAAO,CAAC,OAAO,CAAC;IAF5B,OAAO,CAAC,QAAQ,CAAoD;gBAEhD,OAAO,CAAC,GAAE,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,aAAA;IAQzE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAc7C,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;CAS5E"}

package/dist/event-bus.js

@@ -0,0 +1,36 @@
+export class EventBus {
+    onError;
+    handlers = new Map();
+    constructor(onError) {
+        this.onError = onError;
+        if (!this.onError) {
+            this.onError = (error, eventType) => {
+                console.error(`[EventBus] Unhandled error in "${eventType}" handler:`, error);
+            };
+        }
+    }
+    emit(eventType, data) {
+        const set = this.handlers.get(eventType);
+        if (set) {
+            for (const handler of set) {
+                try {
+                    handler(data);
+                }
+                catch (err) {
+                    // isolate handler errors — one failing handler must not prevent others from running
+                    this.onError?.(err, eventType);
+                }
+            }
+        }
+    }
+    subscribe(eventType, handler) {
+        let set = this.handlers.get(eventType);
+        if (!set) {
+            set = new Set();
+            this.handlers.set(eventType, set);
+        }
+        set.add(handler);
+        return () => set.delete(handler);
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAQ;IAGC;IAFZ,QAAQ,GAAG,IAAI,GAAG,EAAyC,CAAC;IAEpE,YAAoB,OAAqD;QAArD,YAAO,GAAP,OAAO,CAA8C;QACvE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,GAAG,CAAC,KAAc,EAAE,SAAiB,EAAE,EAAE;gBACnD,OAAO,CAAC,KAAK,CAAC,kCAAkC,SAAS,YAAY,EAAE,KAAK,CAAC,CAAC;YAChF,CAAC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,CAAC,SAAiB,EAAE,IAAc;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,GAAG,EAAE,CAAC;YACR,KAAK,MAAM,OAAO,IAAI,GAAG,EAAE,CAAC;gBAC1B,IAAI,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,oFAAoF;oBACpF,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS,CAAC,SAAiB,EAAE,OAAiC;QAC5D,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACpC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjB,OAAO,GAAG,EAAE,CAAC,GAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;CACF"}