@primo-ai/core 0.1.0

package/dist/event-system.d.ts

@@ -0,0 +1,19 @@
+import type { ReplayBackend, ReplayOptions, SessionEvent } from '@primo-ai/sdk';
+import { EventBus } from './event-bus.js';
+/** Sentinel key added to replayed event payloads. Reserved namespace: plugins MUST NOT use this key in event payloads. */
+export declare const REPLAY_SENTINEL = "__agentforge_replay";
+export declare class EventSystem {
+    private _bus;
+    private backend?;
+    constructor(onError?: (error: unknown, eventType: string) => void);
+    /** Attach a ReplayBackend (typically wraps SessionStorage). */
+    setReplayBackend(backend: ReplayBackend): void;
+    /** The underlying EventBus — used for wiring to HookManager, ToolRegistry, etc. */
+    get bus(): EventBus;
+    emit(eventType: string, data?: unknown): void;
+    subscribe(eventType: string, handler: (data?: unknown) => void): () => void;
+    query(sessionId: string): Promise<SessionEvent[]>;
+    replay(sessionId: string, options?: ReplayOptions): Promise<void>;
+    private filterEvents;
+}
+//# sourceMappingURL=event-system.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-system.d.ts","sourceRoot":"","sources":["../src/event-system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,0HAA0H;AAC1H,eAAO,MAAM,eAAe,wBAAwB,CAAC;AAErD,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,OAAO,CAAC,CAAgB;gBAEpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI;IAIjE,+DAA+D;IAC/D,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAI9C,mFAAmF;IACnF,IAAI,GAAG,IAAI,QAAQ,CAElB;IAED,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAI7C,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAIrE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAKjD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAavE,OAAO,CAAC,YAAY;CAerB"}

package/dist/event-system.js

@@ -0,0 +1,58 @@
+import { EventBus } from './event-bus.js';
+/** Sentinel key added to replayed event payloads. Reserved namespace: plugins MUST NOT use this key in event payloads. */
+export const REPLAY_SENTINEL = '__agentforge_replay';
+export class EventSystem {
+    _bus;
+    backend;
+    constructor(onError) {
+        this._bus = new EventBus(onError);
+    }
+    /** Attach a ReplayBackend (typically wraps SessionStorage). */
+    setReplayBackend(backend) {
+        this.backend = backend;
+    }
+    /** The underlying EventBus — used for wiring to HookManager, ToolRegistry, etc. */
+    get bus() {
+        return this._bus;
+    }
+    emit(eventType, data) {
+        this._bus.emit(eventType, data);
+    }
+    subscribe(eventType, handler) {
+        return this._bus.subscribe(eventType, handler);
+    }
+    async query(sessionId) {
+        if (!this.backend)
+            return [];
+        return this.backend.query(sessionId);
+    }
+    async replay(sessionId, options) {
+        const events = await this.query(sessionId);
+        if (events.length === 0)
+            return;
+        const filtered = this.filterEvents(events, options);
+        for (const event of filtered) {
+            const payload = typeof event.payload === 'object' && event.payload !== null && !Array.isArray(event.payload)
+                ? { ...event.payload, [REPLAY_SENTINEL]: true }
+                : event.payload;
+            this._bus.emit(event.type, payload);
+        }
+    }
+    filterEvents(events, options) {
+        if (!options)
+            return events;
+        let result = events;
+        if (options.fromSeq !== undefined) {
+            result = result.filter(e => e.seq >= options.fromSeq);
+        }
+        if (options.toSeq !== undefined) {
+            result = result.filter(e => e.seq <= options.toSeq);
+        }
+        if (options.eventTypes && options.eventTypes.length > 0) {
+            const typeSet = new Set(options.eventTypes);
+            result = result.filter(e => typeSet.has(e.type));
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=event-system.js.map

package/dist/event-system.js.map

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

package/dist/fallback-runner.d.ts

@@ -0,0 +1,30 @@
+import type { FallbackEntry, TokenUsage } from '@primo-ai/sdk';
+import type { EventBus } from './event-bus.js';
+export interface FallbackInvoker {
+    invoke(input: {
+        prompt: string;
+        tools?: unknown;
+    }): Promise<{
+        response: string;
+        tokenUsage: TokenUsage;
+    }>;
+}
+export interface FallbackRunnerOptions {
+    entries: FallbackEntry[];
+    invokerFactory: (model: string) => FallbackInvoker;
+    eventBus?: EventBus;
+}
+export declare class FallbackRunner {
+    private sorted;
+    private invokerFactory;
+    private eventBus?;
+    constructor(options: FallbackRunnerOptions);
+    run(input: {
+        prompt: string;
+        tools?: unknown;
+    }): Promise<{
+        response: string;
+        tokenUsage: TokenUsage;
+    }>;
+}
+//# sourceMappingURL=fallback-runner.d.ts.map

package/dist/fallback-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-runner.d.ts","sourceRoot":"","sources":["../src/fallback-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,KAAK,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,eAAe,CAAC;IACnD,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,CAAW;gBAEhB,OAAO,EAAE,qBAAqB;IAOpC,GAAG,CAAC,KAAK,EAAE;QACf,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,UAAU,CAAA;KAAE,CAAC;CA+B1D"}

package/dist/fallback-runner.js

@@ -0,0 +1,40 @@
+export class FallbackRunner {
+    sorted;
+    invokerFactory;
+    eventBus;
+    constructor(options) {
+        // Sort by priority ascending (0 = highest priority)
+        this.sorted = [...options.entries].sort((a, b) => a.priority - b.priority);
+        this.invokerFactory = options.invokerFactory;
+        this.eventBus = options.eventBus;
+    }
+    async run(input) {
+        if (this.sorted.length === 0) {
+            throw new Error('No fallback entries configured');
+        }
+        let lastError;
+        for (let i = 0; i < this.sorted.length; i++) {
+            const entry = this.sorted[i];
+            const start = Date.now();
+            try {
+                const invoker = this.invokerFactory(entry.model);
+                return await invoker.invoke(input);
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+                const latencyMs = Date.now() - start;
+                // Emit fallback event if there's a next entry
+                if (i < this.sorted.length - 1) {
+                    this.eventBus?.emit('task:fallback', {
+                        from: entry.model,
+                        to: this.sorted[i + 1].model,
+                        error: lastError,
+                        latencyMs,
+                    });
+                }
+            }
+        }
+        throw lastError;
+    }
+}
+//# sourceMappingURL=fallback-runner.js.map

package/dist/fallback-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback-runner.js","sourceRoot":"","sources":["../src/fallback-runner.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,cAAc;IACjB,MAAM,CAAkB;IACxB,cAAc,CAAqC;IACnD,QAAQ,CAAY;IAE5B,YAAY,OAA8B;QACxC,oDAAoD;QACpD,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC3E,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAGT;QACC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,SAA4B,CAAC;QAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACjD,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBAChE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;gBAErC,8CAA8C;gBAC9C,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC/B,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,eAAe,EAAE;wBACnC,IAAI,EAAE,KAAK,CAAC,KAAK;wBACjB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK;wBAC5B,KAAK,EAAE,SAAS;wBAChB,SAAS;qBACV,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,SAAU,CAAC;IACnB,CAAC;CACF"}

package/dist/gateways/builtin-gateway.d.ts

@@ -0,0 +1,17 @@
+import type { LanguageModel } from 'ai';
+import type { ModelGateway } from '@primo-ai/sdk';
+type ProviderFactory = (modelId: string) => LanguageModel;
+export declare class BuiltInGateway implements ModelGateway {
+    name: string;
+    private customProviders;
+    private sdkCache;
+    registerProvider(name: string, factory: ProviderFactory): void;
+    canResolve(modelString: string): boolean;
+    resolve(modelString: string): Promise<unknown>;
+}
+/** Register a custom provider factory on the default gateway instance. */
+export declare function registerProvider(name: string, factory: ProviderFactory): void;
+/** @internal Access the default singleton instance. */
+export declare function getDefaultBuiltInGateway(): BuiltInGateway;
+export {};
+//# sourceMappingURL=builtin-gateway.d.ts.map

package/dist/gateways/builtin-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-gateway.d.ts","sourceRoot":"","sources":["../../src/gateways/builtin-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,KAAK,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,aAAa,CAAC;AAsB1D,qBAAa,cAAe,YAAW,YAAY;IACjD,IAAI,SAAa;IAEjB,OAAO,CAAC,eAAe,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAkC;IAElD,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAI9D,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAKlC,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAqBrD;AAKD,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAE7E;AAED,uDAAuD;AACvD,wBAAgB,wBAAwB,IAAI,cAAc,CAEzD"}

package/dist/gateways/builtin-gateway.js

@@ -0,0 +1,58 @@
+import { parseModel } from '../parse-model.js';
+const PROVIDER_MAP = {
+    openai: () => import('@ai-sdk/openai').then((m) => {
+        const sdk = m.createOpenAI();
+        return { languageModel: (id) => sdk(id) };
+    }),
+    anthropic: () => import('@ai-sdk/anthropic').then((m) => {
+        const sdk = m.createAnthropic();
+        return { languageModel: (id) => sdk(id) };
+    }),
+    google: () => import('@ai-sdk/google').then((m) => {
+        const sdk = m.createGoogleGenerativeAI();
+        return { languageModel: (id) => sdk(id) };
+    }),
+    deepseek: () => import('@ai-sdk/deepseek').then((m) => {
+        const sdk = m.createDeepSeek();
+        return { languageModel: (id) => sdk(id) };
+    }),
+};
+export class BuiltInGateway {
+    name = 'builtin';
+    customProviders = new Map();
+    sdkCache = new Map();
+    registerProvider(name, factory) {
+        this.customProviders.set(name, factory);
+    }
+    canResolve(modelString) {
+        const { provider } = parseModel(modelString);
+        return provider in PROVIDER_MAP || this.customProviders.has(provider);
+    }
+    async resolve(modelString) {
+        const { provider, modelId } = parseModel(modelString);
+        const custom = this.customProviders.get(provider);
+        if (custom)
+            return custom(modelId);
+        const loader = PROVIDER_MAP[provider];
+        if (!loader) {
+            throw new Error(`Unknown provider: "${provider}". Use registerProvider() or install an @ai-sdk/* package.`);
+        }
+        let instance = this.sdkCache.get(provider);
+        if (!instance) {
+            instance = await loader();
+            this.sdkCache.set(provider, instance);
+        }
+        return instance.languageModel(modelId);
+    }
+}
+// Singleton instance for backward-compatible module-level registerProvider()
+const defaultInstance = new BuiltInGateway();
+/** Register a custom provider factory on the default gateway instance. */
+export function registerProvider(name, factory) {
+    defaultInstance.registerProvider(name, factory);
+}
+/** @internal Access the default singleton instance. */
+export function getDefaultBuiltInGateway() {
+    return defaultInstance;
+}
+//# sourceMappingURL=builtin-gateway.js.map

package/dist/gateways/builtin-gateway.js.map

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

package/dist/gateways/gateway-chain.d.ts

@@ -0,0 +1,9 @@
+import type { LanguageModel } from 'ai';
+import type { ModelGateway } from '@primo-ai/sdk';
+export declare class GatewayChain {
+    private gateways;
+    register(gateway: ModelGateway): void;
+    resolve(modelString: string): Promise<LanguageModel>;
+    get size(): number;
+}
+//# sourceMappingURL=gateway-chain.d.ts.map

package/dist/gateways/gateway-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-chain.d.ts","sourceRoot":"","sources":["../../src/gateways/gateway-chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAsB;IAEtC,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAI/B,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAW1D,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/gateways/gateway-chain.js

@@ -0,0 +1,18 @@
+export class GatewayChain {
+    gateways = [];
+    register(gateway) {
+        this.gateways.push(gateway);
+    }
+    async resolve(modelString) {
+        for (const gw of this.gateways) {
+            if (gw.canResolve(modelString)) {
+                return gw.resolve(modelString);
+            }
+        }
+        throw new Error(`Unknown provider for model: "${modelString}". No gateway can resolve it. Use registerProvider() or add a custom gateway.`);
+    }
+    get size() {
+        return this.gateways.length;
+    }
+}
+//# sourceMappingURL=gateway-chain.js.map

package/dist/gateways/gateway-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-chain.js","sourceRoot":"","sources":["../../src/gateways/gateway-chain.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,YAAY;IACf,QAAQ,GAAmB,EAAE,CAAC;IAEtC,QAAQ,CAAC,OAAqB;QAC5B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,WAAmB;QAC/B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/B,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC/B,OAAO,EAAE,CAAC,OAAO,CAAC,WAAW,CAA2B,CAAC;YAC3D,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CACb,gCAAgC,WAAW,+EAA+E,CAC3H,CAAC;IACJ,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC9B,CAAC;CACF"}

package/dist/gateways/openai-compatible-gateway.d.ts

@@ -0,0 +1,10 @@
+import type { ModelGateway, GatewayConfig } from '@primo-ai/sdk';
+export declare class OpenAICompatibleGateway implements ModelGateway {
+    readonly name: string;
+    private readonly url;
+    private readonly apiKey?;
+    constructor(config: GatewayConfig);
+    canResolve(modelString: string): boolean;
+    resolve(modelString: string): Promise<unknown>;
+}
+//# sourceMappingURL=openai-compatible-gateway.d.ts.map

package/dist/gateways/openai-compatible-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compatible-gateway.d.ts","sourceRoot":"","sources":["../../src/gateways/openai-compatible-gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGjE,qBAAa,uBAAwB,YAAW,YAAY;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAErB,MAAM,EAAE,aAAa;IAMjC,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAKlC,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAUrD"}

package/dist/gateways/openai-compatible-gateway.js

@@ -0,0 +1,26 @@
+import { parseModel } from '../parse-model.js';
+export class OpenAICompatibleGateway {
+    name;
+    url;
+    apiKey;
+    constructor(config) {
+        this.name = config.name;
+        this.url = config.url;
+        this.apiKey = config.apiKey;
+    }
+    canResolve(modelString) {
+        const { provider } = parseModel(modelString);
+        return provider === this.name;
+    }
+    async resolve(modelString) {
+        const { modelId } = parseModel(modelString);
+        const { createOpenAICompatible } = await import('@ai-sdk/openai-compatible');
+        const sdk = createOpenAICompatible({
+            name: this.name,
+            baseURL: this.url,
+            ...(this.apiKey ? { apiKey: this.apiKey } : {}),
+        });
+        return sdk.chatModel(modelId);
+    }
+}
+//# sourceMappingURL=openai-compatible-gateway.js.map

package/dist/gateways/openai-compatible-gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compatible-gateway.js","sourceRoot":"","sources":["../../src/gateways/openai-compatible-gateway.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,OAAO,uBAAuB;IACzB,IAAI,CAAS;IACL,GAAG,CAAS;IACZ,MAAM,CAAU;IAEjC,YAAY,MAAqB;QAC/B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,UAAU,CAAC,WAAmB;QAC5B,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;QAC7C,OAAO,QAAQ,KAAK,IAAI,CAAC,IAAI,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,WAAmB;QAC/B,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;QAC5C,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QAC7E,MAAM,GAAG,GAAG,sBAAsB,CAAC;YACjC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChD,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/harness.d.ts

@@ -0,0 +1,44 @@
+import type { CompressionStrategy, HarnessAPI, Hook, Processor, ResourceDeclaration, StageMutation, StageName, ToolDefinition } from '@primo-ai/sdk';
+import type { PipelineRunner } from './pipeline.js';
+import type { ToolRegistry } from './tool-registry.js';
+import type { ContextBuilder } from './context-builder.js';
+import type { HookManager } from './hook-manager.js';
+import type { EventBus } from './event-bus.js';
+import type { EventSystem } from './event-system.js';
+export interface HarnessDeps {
+    runner: PipelineRunner;
+    registry: ToolRegistry;
+    hookManager: HookManager;
+    eventSystem: EventSystem;
+    eventBus: EventBus;
+    contextBuilder?: ContextBuilder;
+    emitEvent: (eventType: string, data?: unknown) => void;
+    registerProvider: (name: string, factory: unknown) => void;
+    mutateStages?: (mutation: StageMutation) => void;
+}
+export declare class HarnessAPIImpl implements HarnessAPI {
+    private deps;
+    private commands;
+    private resources;
+    private unsubFns;
+    private frozen;
+    constructor(deps: HarnessDeps);
+    freeze(): void;
+    registerProcessor(stage: StageName, processor: Processor): void;
+    registerTool(tool: ToolDefinition): void;
+    unregisterTool(name: string): boolean;
+    registerCommand(name: string, handler: (args: string) => Promise<void>): void;
+    registerHook(hook: Hook): void;
+    subscribe(eventType: string, handler: (data?: unknown) => void): () => void;
+    registerResource(declaration: ResourceDeclaration): void;
+    registerProvider(name: string, factory: unknown): void;
+    registerCompressionStrategy(strategy: CompressionStrategy): void;
+    emit(eventType: string, data?: unknown): void;
+    insertStage(phase: 'preLoop' | 'loop' | 'postLoop', after: StageName, newStage: StageName): void;
+    removeStage(phase: 'preLoop' | 'loop' | 'postLoop', stage: StageName): void;
+    replaceStages(phase: 'preLoop' | 'loop' | 'postLoop', stages: StageName[]): void;
+    getCommands(): Map<string, (args: string) => Promise<void>>;
+    getResources(): ResourceDeclaration[];
+    getUnsubFns(): Array<() => void>;
+}
+//# sourceMappingURL=harness.d.ts.map

package/dist/harness.d.ts.map

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

package/dist/harness.js

@@ -0,0 +1,70 @@
+export class HarnessAPIImpl {
+    deps;
+    commands = new Map();
+    resources = [];
+    unsubFns = [];
+    frozen = false;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    freeze() { this.frozen = true; }
+    registerProcessor(stage, processor) {
+        this.deps.runner.register(processor);
+    }
+    registerTool(tool) {
+        this.deps.registry.register(tool);
+    }
+    unregisterTool(name) {
+        return this.deps.registry.unregister(name);
+    }
+    registerCommand(name, handler) {
+        this.commands.set(name, handler);
+    }
+    registerHook(hook) {
+        this.deps.hookManager.register(hook);
+    }
+    subscribe(eventType, handler) {
+        const unsub = this.deps.eventBus.subscribe(eventType, handler);
+        this.unsubFns.push(unsub);
+        return unsub;
+    }
+    registerResource(declaration) {
+        this.resources.push(declaration);
+    }
+    registerProvider(name, factory) {
+        this.deps.registerProvider(name, factory);
+    }
+    registerCompressionStrategy(strategy) {
+        if (this.deps.contextBuilder) {
+            this.deps.contextBuilder.setCompressionStrategy(strategy);
+        }
+    }
+    emit(eventType, data) {
+        this.deps.emitEvent(eventType, data);
+    }
+    insertStage(phase, after, newStage) {
+        if (this.frozen)
+            throw new Error('Cannot mutate stages after agent has started running');
+        this.deps.mutateStages?.({ type: 'insert', phase, after, stage: newStage });
+    }
+    removeStage(phase, stage) {
+        if (this.frozen)
+            throw new Error('Cannot mutate stages after agent has started running');
+        this.deps.mutateStages?.({ type: 'remove', phase, stage });
+    }
+    replaceStages(phase, stages) {
+        if (this.frozen)
+            throw new Error('Cannot mutate stages after agent has started running');
+        this.deps.mutateStages?.({ type: 'replace', phase, stages });
+    }
+    getCommands() {
+        return this.commands;
+    }
+    getResources() {
+        return this.resources;
+    }
+    getUnsubFns() {
+        return this.unsubFns;
+    }
+}
+//# sourceMappingURL=harness.js.map

package/dist/harness.js.map

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

package/dist/hook-manager.d.ts

@@ -0,0 +1,22 @@
+import type { Hook, HookPoint, HookProfile } from '@primo-ai/sdk';
+import type { EventBus } from './event-bus.js';
+export interface HookManagerOptions {
+    profile?: HookProfile;
+    disabledHooks?: string[];
+}
+export declare class HookManager {
+    private hooks;
+    private sortedHooks;
+    private disabledPoints;
+    private profile;
+    private disabledHookNames;
+    private eventBus;
+    constructor(eventBus: EventBus, options?: HookManagerOptions);
+    register(hook: Hook): void;
+    invoke(point: HookPoint, input: unknown, output: unknown): Promise<void>;
+    setProfile(profile: HookProfile): void;
+    disablePoint(point: HookPoint): void;
+    private getSortedHooks;
+    private bridge;
+}
+//# sourceMappingURL=hook-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook-manager.d.ts","sourceRoot":"","sources":["../src/hook-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAgB/C,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,iBAAiB,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAW;gBAEf,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,kBAAkB;IAM5D,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAUpB,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B9E,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAItC,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAIpC,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,MAAM;CAQf"}

package/dist/hook-manager.js

@@ -0,0 +1,92 @@
+const DEFAULT_PRIORITY = 100;
+const HOOK_TO_EVENT = {
+    'agent.start': 'agent:start',
+    'agent.end': 'agent:end',
+    'stage.before': 'stage:before',
+    'stage.after': 'stage:after',
+    'llm.before': 'llm:before',
+    'llm.after': 'llm:after',
+    'tool.before': 'tool:before',
+    'tool.after': 'tool:after',
+    'error': 'error',
+};
+export class HookManager {
+    hooks = new Map();
+    sortedHooks = new Map();
+    disabledPoints = new Set();
+    profile = 'standard';
+    disabledHookNames;
+    eventBus;
+    constructor(eventBus, options) {
+        this.eventBus = eventBus;
+        if (options?.profile)
+            this.profile = options.profile;
+        this.disabledHookNames = new Set(options?.disabledHooks ?? []);
+    }
+    register(hook) {
+        let list = this.hooks.get(hook.point);
+        if (!list) {
+            list = [];
+            this.hooks.set(hook.point, list);
+        }
+        list.push(hook);
+        this.sortedHooks.delete(hook.point);
+    }
+    async invoke(point, input, output) {
+        if (this.disabledPoints.has(point))
+            return;
+        const hooks = this.getSortedHooks(point);
+        if (hooks.length === 0) {
+            this.bridge(point, input);
+            return;
+        }
+        // minimal profile: only run error hooks
+        if (this.profile === 'minimal' && point !== 'error') {
+            this.bridge(point, input);
+            return;
+        }
+        for (const hook of hooks) {
+            if (hook.name && this.disabledHookNames.has(hook.name))
+                continue;
+            try {
+                await hook.handler(input, output);
+            }
+            catch (err) {
+                this.eventBus.emit('hook:error', { point, hookName: hook.name, error: err instanceof Error ? err.message : String(err) });
+                if (this.profile === 'strict')
+                    break; // circuit-break
+                // standard: isolate error, continue
+            }
+        }
+        this.bridge(point, input);
+    }
+    setProfile(profile) {
+        this.profile = profile;
+    }
+    disablePoint(point) {
+        this.disabledPoints.add(point);
+    }
+    getSortedHooks(point) {
+        const cached = this.sortedHooks.get(point);
+        if (cached)
+            return cached;
+        const hooks = this.hooks.get(point) ?? [];
+        if (hooks.length <= 1) {
+            this.sortedHooks.set(point, hooks);
+            return hooks;
+        }
+        const sorted = [...hooks].sort((a, b) => (a.priority ?? DEFAULT_PRIORITY) - (b.priority ?? DEFAULT_PRIORITY));
+        this.sortedHooks.set(point, sorted);
+        return sorted;
+    }
+    bridge(point, data) {
+        const eventType = HOOK_TO_EVENT[point] ?? point.replace('.', ':');
+        try {
+            this.eventBus.emit(eventType, data);
+        }
+        catch {
+            // bridge failure is isolated — never affects hook pipeline
+        }
+    }
+}
+//# sourceMappingURL=hook-manager.js.map

package/dist/hook-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-manager.js","sourceRoot":"","sources":["../src/hook-manager.ts"],"names":[],"mappings":"AAGA,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,MAAM,aAAa,GAA2B;IAC5C,aAAa,EAAE,aAAa;IAC5B,WAAW,EAAE,WAAW;IACxB,cAAc,EAAE,cAAc;IAC9B,aAAa,EAAE,aAAa;IAC5B,YAAY,EAAE,YAAY;IAC1B,WAAW,EAAE,WAAW;IACxB,aAAa,EAAE,aAAa;IAC5B,YAAY,EAAE,YAAY;IAC1B,OAAO,EAAE,OAAO;CACjB,CAAC;AAOF,MAAM,OAAO,WAAW;IACd,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;IACrC,WAAW,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC3C,cAAc,GAAG,IAAI,GAAG,EAAa,CAAC;IACtC,OAAO,GAAgB,UAAU,CAAC;IAClC,iBAAiB,CAAc;IAC/B,QAAQ,CAAW;IAE3B,YAAY,QAAkB,EAAE,OAA4B;QAC1D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,OAAO,EAAE,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QACrD,IAAI,CAAC,iBAAiB,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,aAAa,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,QAAQ,CAAC,IAAU;QACjB,IAAI,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,CAAC;YACV,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAgB,EAAE,KAAc,EAAE,MAAe;QAC5D,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO;QAE3C,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,wCAAwC;QACxC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACpD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAS;YAEjE,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC1H,IAAI,IAAI,CAAC,OAAO,KAAK,QAAQ;oBAAE,MAAM,CAAC,gBAAgB;gBACtD,oCAAoC;YACtC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,UAAU,CAAC,OAAoB;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,YAAY,CAAC,KAAgB;QAC3B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAEO,cAAc,CAAC,KAAgB;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1C,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YACnC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,gBAAgB,CAAC,CAAC,CAAC;QAC9G,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACpC,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,MAAM,CAAC,KAAgB,EAAE,IAAa;QAC5C,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAClE,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,2DAA2D;QAC7D,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+export { PipelineRunner, type PipelineRunnerOptions } from './pipeline.js';
+export { Agent, type AgentDependencies, type AgentRunResult } from './agent.js';
+export { LLMInvoker, type LLMInvokerOptions, type LLMInvokeInput, type LLMInvokeResult, type LLMStreamHandle } from './llm-invoker.js';
+export { resolveModel, registerProvider, parseModel, type ParsedModel } from './model-resolver.js';
+export { streamWithRetry, type RetryOptions } from './retry.js';
+export { PluginManager, type PluginFactory } from './plugin-manager.js';
+export { EventBus } from './event-bus.js';
+export { EventSystem, REPLAY_SENTINEL } from './event-system.js';
+export { StorageReplayBackend } from './storage-replay-backend.js';
+export { HookManager, type HookManagerOptions } from './hook-manager.js';
+export { ToolRegistry, type AiSdkToolSchema, type ToolRegistryOptions } from './tool-registry.js';
+export { FilesystemSessionStorage } from './session-storage.js';
+export { SessionPersistence } from './session-persistence.js';
+export { SessionManagerImpl } from './session-manager.js';
+export { createSubAgentTool } from './sub-agent.js';
+export { deepMerge } from './config-merge.js';
+export { resolveDynamic } from './dynamic-resolver.js';
+export { matchProfile, applyProfile } from './model-profile.js';
+export { ConfigLoader, type ConfigSource } from './config.js';
+export { ConcurrencyController } from './concurrency-controller.js';
+export { FallbackRunner, type FallbackInvoker, type FallbackRunnerOptions } from './fallback-runner.js';
+export { TaskManagerImpl } from './task-manager.js';
+export { StateMachine, type AgentState } from './state-machine.js';
+export { ModelFactory } from './model-factory.js';
+export { LoopOrchestrator, type LoopOptions } from './loop-orchestrator.js';
+export { serialize, deserialize } from './serialize.js';
+export { InMemoryCheckpointStore, JsonlCheckpointStore } from './checkpoint-store.js';
+export { ContextBuilder, type ContextBuilderOptions } from './context-builder.js';
+export { HarnessAPIImpl, type HarnessDeps } from './harness.js';
+export { TiktokenCounter } from './token-counter.js';
+export type { StreamEvent } from '@primo-ai/sdk';
+export { OpenAICompatibleGateway } from './gateways/openai-compatible-gateway.js';
+export { AgentForgeError, RecoverableError, FatalError, AuthError, ModelNotFoundError, ToolExecutionError, type AgentErrorOptions, } from './errors.js';
+//# sourceMappingURL=index.d.ts.map