@auxiora/runtime 1.10.0 → 1.10.5

package/dist/queue-wiring.d.ts

@@ -0,0 +1,73 @@
+/** Payload for a queued ReAct job */
+export interface QueuedReActPayload {
+    goal: string;
+    sessionId: string;
+    config?: {
+        maxSteps?: number;
+        maxTokenBudget?: number;
+        timeoutMs?: number;
+        allowedTools?: string[];
+        deniedTools?: string[];
+    };
+}
+/** Payload for a queued orchestration job */
+export interface QueuedWorkflowPayload {
+    workflowId: string;
+    pattern: string;
+    tasks: Array<{
+        id: string;
+        name: string;
+        provider: string;
+        systemPrompt: string;
+        userPrompt: string;
+        model?: string;
+        maxTokens?: number;
+        temperature?: number;
+        timeout?: number;
+    }>;
+    synthesisPrompt?: string;
+}
+/** Structural type for JobContext (avoids direct import) */
+export interface JobContextLike {
+    jobId: string;
+    attempt: number;
+    signal: AbortSignal;
+    checkpoint: (data: unknown) => void;
+    getCheckpoint: <T = unknown>() => T | undefined;
+}
+/** Structural type for ReActLoop (avoids direct import) */
+export interface ReActLoopLike {
+    run(goal: string, resumeFrom?: unknown): Promise<{
+        status: string;
+        steps: unknown[];
+        answer?: string;
+        totalTokens: number;
+        totalDurationMs: number;
+        error?: string;
+    }>;
+}
+/** Factory function type for creating ReActLoop instances */
+export type ReActLoopFactory = (config: QueuedReActPayload['config'] & {
+    sessionId: string;
+    checkpointHandler?: {
+        save: (cp: unknown) => Promise<void>;
+        load: (id: string) => Promise<unknown | undefined>;
+    };
+}) => ReActLoopLike;
+/**
+ * Create a job handler for ReAct loops.
+ * The handler checkpoints after each step for crash recovery.
+ */
+export declare function createReActJobHandler(loopFactory: ReActLoopFactory): (payload: QueuedReActPayload, ctx: JobContextLike) => Promise<unknown>;
+/** Structural type for orchestration engine */
+export interface OrchestrationEngineLike {
+    execute(workflow: unknown): AsyncGenerator<unknown, unknown, unknown>;
+}
+/** Factory for creating orchestration engine instances */
+export type OrchestrationFactory = () => OrchestrationEngineLike;
+/**
+ * Create a job handler for orchestration workflows.
+ * The handler checkpoints after each task completion.
+ */
+export declare function createWorkflowJobHandler(engineFactory: OrchestrationFactory): (payload: QueuedWorkflowPayload, ctx: JobContextLike) => Promise<unknown>;
+//# sourceMappingURL=queue-wiring.d.ts.map

package/dist/queue-wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-wiring.d.ts","sourceRoot":"","sources":["../src/queue-wiring.ts"],"names":[],"mappings":"AAIA,qCAAqC;AACrC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;CACH;AAED,6CAA6C;AAC7C,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,aAAa,EAAE,CAAC,CAAC,GAAG,OAAO,OAAO,CAAC,GAAG,SAAS,CAAC;CACjD;AAED,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAC/C,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED,6DAA6D;AAC7D,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE;QAClB,IAAI,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;KACpD,CAAC;CACH,KAAK,aAAa,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,gBAAgB,GAC5B,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAkCxE;AAED,+CAA+C;AAC/C,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;CACvE;AAED,0DAA0D;AAC1D,MAAM,MAAM,oBAAoB,GAAG,MAAM,uBAAuB,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,oBAAoB,GAClC,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAmC3E"}

package/dist/queue-wiring.js

@@ -0,0 +1,71 @@
+import { getLogger } from '@auxiora/logger';
+const logger = getLogger('runtime:queue-wiring');
+/**
+ * Create a job handler for ReAct loops.
+ * The handler checkpoints after each step for crash recovery.
+ */
+export function createReActJobHandler(loopFactory) {
+    return async (payload, ctx) => {
+        logger.info('Starting queued ReAct job', { jobId: ctx.jobId, goal: payload.goal, attempt: ctx.attempt });
+        // Create checkpoint handler that bridges to job queue
+        const checkpointHandler = {
+            save: async (cp) => {
+                ctx.checkpoint(cp);
+            },
+            load: async (_id) => {
+                return ctx.getCheckpoint();
+            },
+        };
+        // Resume from checkpoint if this is a retry
+        const savedCheckpoint = ctx.attempt > 1 ? ctx.getCheckpoint() : undefined;
+        const loop = loopFactory({
+            ...payload.config,
+            sessionId: payload.sessionId,
+            checkpointHandler,
+        });
+        const result = await loop.run(payload.goal, savedCheckpoint);
+        logger.info('ReAct job completed', {
+            jobId: ctx.jobId,
+            status: result.status,
+            steps: result.steps.length,
+            tokens: result.totalTokens,
+        });
+        return result;
+    };
+}
+/**
+ * Create a job handler for orchestration workflows.
+ * The handler checkpoints after each task completion.
+ */
+export function createWorkflowJobHandler(engineFactory) {
+    return async (payload, ctx) => {
+        logger.info('Starting queued workflow job', { jobId: ctx.jobId, workflowId: payload.workflowId, attempt: ctx.attempt });
+        const engine = engineFactory();
+        const workflow = {
+            id: payload.workflowId,
+            pattern: payload.pattern,
+            tasks: payload.tasks,
+            synthesisPrompt: payload.synthesisPrompt,
+        };
+        // Consume the async generator
+        const generator = engine.execute(workflow);
+        let lastEvent;
+        let result;
+        while (true) {
+            const next = await generator.next();
+            if (next.done) {
+                result = next.value;
+                break;
+            }
+            lastEvent = next.value;
+            // Checkpoint progress events
+            const event = lastEvent;
+            if (event && (event.type === 'task_progress' || event.type === 'agent_completed')) {
+                ctx.checkpoint({ lastEvent: event, workflowId: payload.workflowId });
+            }
+        }
+        logger.info('Workflow job completed', { jobId: ctx.jobId, workflowId: payload.workflowId });
+        return result;
+    };
+}
+//# sourceMappingURL=queue-wiring.js.map

package/dist/queue-wiring.js.map

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

package/dist/response-provenance.d.ts

@@ -0,0 +1,70 @@
+export interface ProvenanceEntry {
+    /** Unique response ID */
+    responseId: string;
+    /** Session ID */
+    sessionId: string;
+    /** Timestamp */
+    timestamp: number;
+    /** Memory IDs that were retrieved for context */
+    memoryIds: string[];
+    /** Context signals that influenced the response */
+    contextSignals: ContextSignalRecord[];
+    /** Tools that were called during response generation */
+    toolCalls: ToolCallRecord[];
+    /** Enrichment stages that ran */
+    enrichmentStages: string[];
+    /** Model and provider used */
+    model: {
+        provider: string;
+        model: string;
+    };
+    /** Token usage */
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+}
+export interface ContextSignalRecord {
+    name: string;
+    type: string;
+    value: string;
+    confidence?: number;
+}
+export interface ToolCallRecord {
+    toolName: string;
+    durationMs: number;
+    success: boolean;
+}
+export interface ProvenanceSummary {
+    /** Human-readable explanation of where the response came from */
+    explanation: string;
+    /** List of contributing sources */
+    sources: Array<{
+        type: string;
+        label: string;
+        detail?: string;
+    }>;
+    /** Whether the response was grounded in user data */
+    groundedInUserData: boolean;
+    /** Whether external tools/searches were used */
+    usedExternalSources: boolean;
+}
+export declare class ResponseProvenanceTracker {
+    private entries;
+    private maxEntries;
+    constructor(maxEntries?: number);
+    /** Record provenance for a response */
+    record(entry: ProvenanceEntry): void;
+    /** Get provenance for a specific response */
+    get(responseId: string): ProvenanceEntry | undefined;
+    /** Get a human-readable summary explaining why a response was generated */
+    explain(responseId: string): ProvenanceSummary | undefined;
+    /** List recent response IDs for a session */
+    listBySession(sessionId: string, limit?: number): string[];
+    /** Get count of tracked responses */
+    get size(): number;
+    /** Clear all entries */
+    clear(): void;
+    private findOldest;
+}
+//# sourceMappingURL=response-provenance.d.ts.map

package/dist/response-provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-provenance.d.ts","sourceRoot":"","sources":["../src/response-provenance.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mDAAmD;IACnD,cAAc,EAAE,mBAAmB,EAAE,CAAC;IACtC,wDAAwD;IACxD,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,iCAAiC;IACjC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,8BAA8B;IAC9B,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,kBAAkB;IAClB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,qDAAqD;IACrD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gDAAgD;IAChD,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,SAAM;IAI5B,uCAAuC;IACvC,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAepC,6CAA6C;IAC7C,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIpD,2EAA2E;IAC3E,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAoE1D,6CAA6C;IAC7C,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,EAAE;IAQtD,qCAAqC;IACrC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,wBAAwB;IACxB,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,UAAU;CAWnB"}

package/dist/response-provenance.js

@@ -0,0 +1,115 @@
+import { getLogger } from '@auxiora/logger';
+const logger = getLogger('runtime:response-provenance');
+export class ResponseProvenanceTracker {
+    entries = new Map();
+    maxEntries;
+    constructor(maxEntries = 500) {
+        this.maxEntries = maxEntries;
+    }
+    /** Record provenance for a response */
+    record(entry) {
+        // Enforce max size
+        if (this.entries.size >= this.maxEntries) {
+            const oldest = this.findOldest();
+            if (oldest)
+                this.entries.delete(oldest);
+        }
+        this.entries.set(entry.responseId, entry);
+        logger.debug('Provenance recorded', {
+            responseId: entry.responseId,
+            memoryCount: entry.memoryIds.length,
+            toolCount: entry.toolCalls.length,
+        });
+    }
+    /** Get provenance for a specific response */
+    get(responseId) {
+        return this.entries.get(responseId);
+    }
+    /** Get a human-readable summary explaining why a response was generated */
+    explain(responseId) {
+        const entry = this.entries.get(responseId);
+        if (!entry)
+            return undefined;
+        const sources = [];
+        const parts = [];
+        // Memories
+        if (entry.memoryIds.length > 0) {
+            sources.push({
+                type: 'memory',
+                label: `${entry.memoryIds.length} memories`,
+                detail: entry.memoryIds.join(', '),
+            });
+            parts.push(`${entry.memoryIds.length} stored memories`);
+        }
+        // Context signals
+        if (entry.contextSignals.length > 0) {
+            for (const signal of entry.contextSignals) {
+                sources.push({
+                    type: 'context_signal',
+                    label: signal.name,
+                    detail: signal.value,
+                });
+            }
+            parts.push(`${entry.contextSignals.length} context signals`);
+        }
+        // Tools
+        if (entry.toolCalls.length > 0) {
+            for (const tool of entry.toolCalls) {
+                sources.push({
+                    type: 'tool',
+                    label: tool.toolName,
+                    detail: tool.success ? `completed in ${tool.durationMs}ms` : 'failed',
+                });
+            }
+            parts.push(`${entry.toolCalls.length} tool calls`);
+        }
+        // Enrichment
+        if (entry.enrichmentStages.length > 0) {
+            sources.push({
+                type: 'enrichment',
+                label: `${entry.enrichmentStages.length} enrichment stages`,
+                detail: entry.enrichmentStages.join(', '),
+            });
+        }
+        // Model
+        sources.push({
+            type: 'model',
+            label: `${entry.model.provider}/${entry.model.model}`,
+        });
+        const groundedInUserData = entry.memoryIds.length > 0 || entry.contextSignals.length > 0;
+        const usedExternalSources = entry.toolCalls.some(t => t.toolName.includes('search') || t.toolName.includes('web') || t.toolName.includes('fetch'));
+        const explanation = parts.length > 0
+            ? `This response was informed by ${parts.join(', ')}, processed through ${entry.enrichmentStages.length} enrichment stages, and generated by ${entry.model.provider}/${entry.model.model}.`
+            : `This response was generated by ${entry.model.provider}/${entry.model.model} without specific user data.`;
+        return { explanation, sources, groundedInUserData, usedExternalSources };
+    }
+    /** List recent response IDs for a session */
+    listBySession(sessionId, limit = 20) {
+        const ids = [];
+        for (const [id, entry] of this.entries) {
+            if (entry.sessionId === sessionId)
+                ids.push(id);
+        }
+        return ids.slice(-limit);
+    }
+    /** Get count of tracked responses */
+    get size() {
+        return this.entries.size;
+    }
+    /** Clear all entries */
+    clear() {
+        this.entries.clear();
+    }
+    findOldest() {
+        let oldestId;
+        let oldestTime = Infinity;
+        for (const [id, entry] of this.entries) {
+            if (entry.timestamp < oldestTime) {
+                oldestTime = entry.timestamp;
+                oldestId = id;
+            }
+        }
+        return oldestId;
+    }
+}
+//# sourceMappingURL=response-provenance.js.map

package/dist/response-provenance.js.map

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

package/dist/source-attribution.d.ts

@@ -0,0 +1,55 @@
+export type SourceType = 'user_data' | 'web_search' | 'knowledge_graph' | 'model_generation' | 'tool_output' | 'memory';
+export interface Attribution {
+    /** What type of source this came from */
+    sourceType: SourceType;
+    /** Human-readable label */
+    label: string;
+    /** Reference to the specific source (memory ID, URL, tool name, etc.) */
+    reference?: string;
+    /** Confidence that this attribution is correct (0-1) */
+    confidence: number;
+}
+export interface AttributedSegment {
+    /** The text content */
+    content: string;
+    /** Attribution for this segment */
+    attribution: Attribution;
+}
+export interface ResponseAttribution {
+    /** Original full response text */
+    fullResponse: string;
+    /** Segments with attribution */
+    segments: AttributedSegment[];
+    /** Summary of sources used */
+    sourcesSummary: Record<SourceType, number>;
+    /** Overall confidence score */
+    overallConfidence: number;
+}
+/** Source that was available during response generation */
+export interface AttributionSource {
+    type: SourceType;
+    label: string;
+    /** The actual content from this source */
+    content?: string;
+    /** Reference identifier (memory ID, URL, etc.) */
+    reference?: string;
+    /** How confident we are this source was used */
+    confidence?: number;
+}
+export declare class SourceAttributor {
+    /**
+     * Attribute a response based on the context that produced it.
+     * Takes the response text and the sources that were available during generation.
+     */
+    attribute(response: string, sources: AttributionSource[]): ResponseAttribution;
+    /**
+     * Create a simple attribution for a fully-generated response (no specific sources).
+     */
+    attributeGenerated(response: string): ResponseAttribution;
+    /**
+     * Simple substring match finder (case-insensitive, whitespace-normalized).
+     * Returns the start index or -1 if not found.
+     */
+    private findMatch;
+}
+//# sourceMappingURL=source-attribution.d.ts.map

package/dist/source-attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-attribution.d.ts","sourceRoot":"","sources":["../src/source-attribution.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,YAAY,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,aAAa,GAAG,QAAQ,CAAC;AAExH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,UAAU,EAAE,UAAU,CAAC;IACvB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC3C,+BAA+B;IAC/B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,gBAAgB;IAC3B;;;OAGG;IACH,SAAS,CACP,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,iBAAiB,EAAE,GAC3B,mBAAmB;IA0EtB;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB;IAYzD;;;OAGG;IACH,OAAO,CAAC,SAAS;CAiBlB"}

package/dist/source-attribution.js

@@ -0,0 +1,107 @@
+import { getLogger } from '@auxiora/logger';
+const logger = getLogger('runtime:source-attribution');
+export class SourceAttributor {
+    /**
+     * Attribute a response based on the context that produced it.
+     * Takes the response text and the sources that were available during generation.
+     */
+    attribute(response, sources) {
+        const segments = [];
+        let remainingText = response;
+        const sourcesSummary = {};
+        // Match response segments to known sources
+        for (const source of sources) {
+            if (!source.content)
+                continue;
+            // Find if any source content appears (or closely matches) in the response
+            const matchIndex = this.findMatch(remainingText, source.content);
+            if (matchIndex >= 0) {
+                const matchLength = Math.min(source.content.length, remainingText.length - matchIndex);
+                // Add pre-match text as model generation
+                if (matchIndex > 0) {
+                    const preText = remainingText.slice(0, matchIndex);
+                    segments.push({
+                        content: preText,
+                        attribution: { sourceType: 'model_generation', label: 'AI generated', confidence: 0.5 },
+                    });
+                }
+                // Add matched segment
+                const matchedText = remainingText.slice(matchIndex, matchIndex + matchLength);
+                const attr = {
+                    sourceType: source.type,
+                    label: source.label,
+                    reference: source.reference,
+                    confidence: source.confidence ?? 0.8,
+                };
+                segments.push({ content: matchedText, attribution: attr });
+                sourcesSummary[source.type] = (sourcesSummary[source.type] ?? 0) + 1;
+                remainingText = remainingText.slice(matchIndex + matchLength);
+            }
+        }
+        // Any remaining text is model generation
+        if (remainingText.length > 0) {
+            segments.push({
+                content: remainingText,
+                attribution: { sourceType: 'model_generation', label: 'AI generated', confidence: 0.5 },
+            });
+            sourcesSummary['model_generation'] = (sourcesSummary['model_generation'] ?? 0) + 1;
+        }
+        // If no specific sources matched, the whole thing is model generation
+        if (segments.length === 0) {
+            segments.push({
+                content: response,
+                attribution: { sourceType: 'model_generation', label: 'AI generated', confidence: 0.5 },
+            });
+            sourcesSummary['model_generation'] = 1;
+        }
+        const confidences = segments.map(s => s.attribution.confidence);
+        const overallConfidence = confidences.length > 0
+            ? confidences.reduce((a, b) => a + b, 0) / confidences.length
+            : 0.5;
+        logger.debug('Response attributed', {
+            segmentCount: segments.length,
+            sourceTypes: Object.keys(sourcesSummary),
+        });
+        return {
+            fullResponse: response,
+            segments,
+            sourcesSummary: sourcesSummary,
+            overallConfidence,
+        };
+    }
+    /**
+     * Create a simple attribution for a fully-generated response (no specific sources).
+     */
+    attributeGenerated(response) {
+        return {
+            fullResponse: response,
+            segments: [{
+                    content: response,
+                    attribution: { sourceType: 'model_generation', label: 'AI generated', confidence: 0.5 },
+                }],
+            sourcesSummary: { model_generation: 1 },
+            overallConfidence: 0.5,
+        };
+    }
+    /**
+     * Simple substring match finder (case-insensitive, whitespace-normalized).
+     * Returns the start index or -1 if not found.
+     */
+    findMatch(text, source) {
+        const normalizedText = text.toLowerCase().replace(/\s+/g, ' ');
+        const normalizedSource = source.toLowerCase().replace(/\s+/g, ' ');
+        // Try exact substring first
+        const idx = normalizedText.indexOf(normalizedSource);
+        if (idx >= 0)
+            return idx;
+        // Try first 50 chars of source for partial match
+        if (normalizedSource.length > 50) {
+            const partial = normalizedSource.slice(0, 50);
+            const partialIdx = normalizedText.indexOf(partial);
+            if (partialIdx >= 0)
+                return partialIdx;
+        }
+        return -1;
+    }
+}
+//# sourceMappingURL=source-attribution.js.map

package/dist/source-attribution.js.map

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

package/dist/telemetry-wiring.d.ts

@@ -0,0 +1,28 @@
+/** Structural types to avoid direct imports */
+interface TelemetryTrackerLike {
+    recordJob(outcome: {
+        type: string;
+        success: boolean;
+        durationMs: number;
+        jobId: string;
+        error?: string;
+    }): void;
+}
+interface JobEmitterLike {
+    on(event: string, listener: (data: unknown) => void): void;
+}
+interface LearningStoreLike {
+    extractAndStore(output: string, jobId: string, jobType: string): number;
+}
+/**
+ * Wire job queue events to telemetry tracker.
+ *
+ * Listens to job:completed, job:failed, job:dead events and records
+ * them for operational telemetry and self-improvement loops.
+ *
+ * When a LearningStoreLike is provided, completed job results are
+ * passed through learning extraction so insights can be persisted.
+ */
+export declare function wireTelemetry(emitter: JobEmitterLike, tracker: TelemetryTrackerLike, learningStore?: LearningStoreLike): void;
+export {};
+//# sourceMappingURL=telemetry-wiring.d.ts.map

package/dist/telemetry-wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-wiring.d.ts","sourceRoot":"","sources":["../src/telemetry-wiring.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,UAAU,oBAAoB;IAC5B,SAAS,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACjH;AAED,UAAU,cAAc;IACtB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CAC5D;AAED,UAAU,iBAAiB;IACzB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CACzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,oBAAoB,EAC7B,aAAa,CAAC,EAAE,iBAAiB,GAChC,IAAI,CA0BN"}

package/dist/telemetry-wiring.js

@@ -0,0 +1,31 @@
+/**
+ * Wire job queue events to telemetry tracker.
+ *
+ * Listens to job:completed, job:failed, job:dead events and records
+ * them for operational telemetry and self-improvement loops.
+ *
+ * When a LearningStoreLike is provided, completed job results are
+ * passed through learning extraction so insights can be persisted.
+ */
+export function wireTelemetry(emitter, tracker, learningStore) {
+    emitter.on('job:completed', (data) => {
+        const { job, result } = data;
+        const durationMs = (job.completedAt ?? Date.now()) - job.createdAt;
+        tracker.recordJob({ type: job.type, success: true, durationMs, jobId: job.id });
+        if (learningStore && result != null) {
+            const output = typeof result === 'string' ? result : JSON.stringify(result);
+            learningStore.extractAndStore(output, job.id, job.type);
+        }
+    });
+    emitter.on('job:failed', (data) => {
+        const { job, error } = data;
+        const durationMs = (job.completedAt ?? Date.now()) - job.createdAt;
+        tracker.recordJob({ type: job.type, success: false, durationMs, jobId: job.id, error: error?.message });
+    });
+    emitter.on('job:dead', (data) => {
+        const { job, error } = data;
+        const durationMs = (job.completedAt ?? Date.now()) - job.createdAt;
+        tracker.recordJob({ type: job.type, success: false, durationMs, jobId: job.id, error: error?.message ?? 'dead letter' });
+    });
+}
+//# sourceMappingURL=telemetry-wiring.js.map

package/dist/telemetry-wiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-wiring.js","sourceRoot":"","sources":["../src/telemetry-wiring.ts"],"names":[],"mappings":"AAaA;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAuB,EACvB,OAA6B,EAC7B,aAAiC;IAEjC,OAAO,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,IAAa,EAAE,EAAE;QAC5C,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAGvB,CAAC;QACF,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC;QACnE,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QAEhF,IAAI,aAAa,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC5E,aAAa,CAAC,eAAe,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,IAAa,EAAE,EAAE;QACzC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAqG,CAAC;QAC7H,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC;QACnE,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1G,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,IAAa,EAAE,EAAE;QACvC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAqG,CAAC;QAC7H,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC;QACnE,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,CAAC,CAAC;IAC3H,CAAC,CAAC,CAAC;AACL,CAAC"}