cognitive-core 0.0.2 → 0.1.2

package/dist/runtime/backends/subprocess.js.map

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

package/dist/runtime/compute-provider.d.ts

@@ -0,0 +1,87 @@
+import type { AgentBackend, AgentSpawnConfig } from './types.js';
+import type { AnalysisComplexity } from '../workspace/types.js';
+/**
+ * Requirements for compute resolution.
+ * Templates express preferences; the provider resolves them to concrete backends.
+ */
+export interface ComputeRequirements {
+    /** Preferred execution location */
+    mode?: 'local' | 'remote' | 'any';
+    /** Maximum cost budget in cents (for cost-aware routing) */
+    maxCostCents?: number;
+    /** Required agent capabilities */
+    capabilities?: string[];
+    /** Timeout hint (provider may select faster backends for short timeouts) */
+    timeout?: number;
+    /** Complexity hint from template */
+    complexity?: AnalysisComplexity;
+}
+/**
+ * Resolution result: which backend to use and any config overrides.
+ */
+export interface ComputeTarget {
+    /** The resolved backend */
+    backend: AgentBackend;
+    /** Config overrides for this resolution (e.g., different timeout, env vars) */
+    overrides?: Partial<AgentSpawnConfig>;
+    /** Source identifier for logging/metrics */
+    source: string;
+}
+/** Cost tier for routing decisions */
+export type CostTier = 'free' | 'low' | 'medium' | 'high';
+/**
+ * Registered compute source with metadata.
+ */
+export interface ComputeSource {
+    /** Unique name for this source */
+    name: string;
+    /** Underlying backend */
+    backend: AgentBackend;
+    /** Cost tier for routing decisions */
+    costTier: CostTier;
+    /** Execution location */
+    location: 'local' | 'remote';
+    /** Priority (lower = preferred, for tie-breaking) */
+    priority: number;
+}
+/**
+ * Resolves agent type + requirements to a concrete compute target.
+ *
+ * Sits between AgentManager and the raw backend registry.
+ * Separates "what agent to run" from "where to run it".
+ */
+export interface ComputeProvider {
+    /** Resolve an agent execution request to a backend */
+    resolve(agentType: string, requirements?: ComputeRequirements): Promise<ComputeTarget>;
+    /** Register a compute source */
+    register(source: ComputeSource): void;
+    /** Remove a compute source */
+    unregister(name: string): void;
+    /** List available compute sources */
+    listSources(): ComputeSource[];
+    /** Check if any source supports the given agent type */
+    supports(agentType: string): boolean;
+}
+/**
+ * Default compute provider.
+ *
+ * Resolution strategy:
+ * 1. Filter to sources that support the requested agent type
+ * 2. Apply mode preference (local/remote) if specified
+ * 3. Apply cost budget if specified
+ * 4. Check availability in priority order
+ * 5. Return first available (or first candidate as fallback)
+ */
+export declare class DefaultComputeProvider implements ComputeProvider {
+    private sources;
+    register(source: ComputeSource): void;
+    unregister(name: string): void;
+    listSources(): ComputeSource[];
+    supports(agentType: string): boolean;
+    resolve(agentType: string, requirements?: ComputeRequirements): Promise<ComputeTarget>;
+}
+/**
+ * Create a DefaultComputeProvider.
+ */
+export declare function createComputeProvider(): DefaultComputeProvider;
+//# sourceMappingURL=compute-provider.d.ts.map

package/dist/runtime/compute-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-provider.d.ts","sourceRoot":"","sources":["../../src/runtime/compute-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAMhE;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClC,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,OAAO,EAAE,YAAY,CAAC;IACtB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACtC,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,sCAAsC;AACtC,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,OAAO,EAAE,YAAY,CAAC;IACtB,sCAAsC;IACtC,QAAQ,EAAE,QAAQ,CAAC;IACnB,yBAAyB;IACzB,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC7B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,mBAAmB,GACjC,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAEtC,8BAA8B;IAC9B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,qCAAqC;IACrC,WAAW,IAAI,aAAa,EAAE,CAAC;IAE/B,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CACtC;AAaD;;;;;;;;;GASG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,OAAO,CAAuB;IAEtC,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAQrC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,WAAW,IAAI,aAAa,EAAE;IAI9B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAM9B,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,mBAAmB,GACjC,OAAO,CAAC,aAAa,CAAC;CAwD1B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,sBAAsB,CAE9D"}

package/dist/runtime/compute-provider.js

@@ -0,0 +1,87 @@
+// ============================================================
+// Default Implementation
+// ============================================================
+const COST_ORDER = {
+    free: 0,
+    low: 1,
+    medium: 5,
+    high: 20,
+};
+/**
+ * Default compute provider.
+ *
+ * Resolution strategy:
+ * 1. Filter to sources that support the requested agent type
+ * 2. Apply mode preference (local/remote) if specified
+ * 3. Apply cost budget if specified
+ * 4. Check availability in priority order
+ * 5. Return first available (or first candidate as fallback)
+ */
+export class DefaultComputeProvider {
+    sources = [];
+    register(source) {
+        // Remove existing source with same name (re-registration)
+        this.sources = this.sources.filter(s => s.name !== source.name);
+        this.sources.push(source);
+        // Keep sorted by priority (lower = preferred)
+        this.sources.sort((a, b) => a.priority - b.priority);
+    }
+    unregister(name) {
+        this.sources = this.sources.filter(s => s.name !== name);
+    }
+    listSources() {
+        return [...this.sources];
+    }
+    supports(agentType) {
+        return this.sources.some(s => s.backend.supportedTypes.includes(agentType));
+    }
+    async resolve(agentType, requirements) {
+        // Step 1: Filter to sources that support this agent type
+        let candidates = this.sources.filter(s => s.backend.supportedTypes.includes(agentType));
+        if (candidates.length === 0) {
+            // Fallback: try matching by backend name
+            candidates = this.sources.filter(s => s.name === agentType);
+        }
+        if (candidates.length === 0) {
+            throw new Error(`No compute source supports agent type '${agentType}'. ` +
+                `Available sources: ${this.sources.map(s => `${s.name}[${s.backend.supportedTypes.join(',')}]`).join(', ') || 'none'}`);
+        }
+        // Step 2: Apply mode preference
+        if (requirements?.mode && requirements.mode !== 'any') {
+            const locationFiltered = candidates.filter(s => s.location === requirements.mode);
+            if (locationFiltered.length > 0) {
+                candidates = locationFiltered;
+            }
+            // If no match for preferred mode, fall back to all candidates
+        }
+        // Step 3: Apply cost budget
+        if (requirements?.maxCostCents !== undefined) {
+            const budgetFiltered = candidates.filter(s => COST_ORDER[s.costTier] <= requirements.maxCostCents);
+            if (budgetFiltered.length > 0) {
+                candidates = budgetFiltered;
+            }
+            // If no match within budget, fall back to all candidates
+        }
+        // Step 4: Check availability in priority order
+        for (const source of candidates) {
+            if (await source.backend.isAvailable()) {
+                return {
+                    backend: source.backend,
+                    source: source.name,
+                };
+            }
+        }
+        // Step 5: Fallback to first candidate regardless of availability
+        return {
+            backend: candidates[0].backend,
+            source: candidates[0].name,
+        };
+    }
+}
+/**
+ * Create a DefaultComputeProvider.
+ */
+export function createComputeProvider() {
+    return new DefaultComputeProvider();
+}
+//# sourceMappingURL=compute-provider.js.map

package/dist/runtime/compute-provider.js.map

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

package/dist/runtime/flows/learning.d.ts

@@ -0,0 +1,73 @@
+import type { Task } from '../../types/index.js';
+import type { MemorySystem } from '../../memory/system.js';
+import type { LearningPipeline, ProcessResult, BatchResult } from '../../learning/index.js';
+import type { AgentManager } from '../manager.js';
+import type { AgentResult, AgentSession, AgentObserverCallbacks } from '../types.js';
+/**
+ * Configuration for the learning flow
+ */
+export interface LearningFlowConfig {
+    /** Agent type to use for execution */
+    agentType: string;
+    /** Minimum trajectories before running batch learning */
+    batchThreshold?: number;
+    /** Whether to auto-run batch learning when threshold is reached */
+    autoBatch?: boolean;
+    /** Observer callbacks for real-time monitoring */
+    observer?: AgentObserverCallbacks;
+}
+/**
+ * Result of a learning flow execution
+ */
+export interface LearningFlowResult {
+    /** The agent result */
+    agentResult: AgentResult;
+    /** Processing result from learning pipeline */
+    processResult: ProcessResult;
+    /** Batch result if batch learning was triggered */
+    batchResult?: BatchResult;
+}
+/**
+ * Learning Flow
+ * Orchestrates: Agent execution → Trajectory capture → Playbook extraction → Memory storage
+ *
+ * This flow is for the "observation" direction:
+ * - Watch agents solve tasks
+ * - Extract learning signals from their trajectories
+ * - Store playbooks for future guidance
+ */
+export declare class LearningFlow {
+    private manager;
+    private pipeline;
+    private config;
+    constructor(manager: AgentManager, pipeline: LearningPipeline, _memory: MemorySystem, config: LearningFlowConfig);
+    /**
+     * Run a single task through the learning flow
+     */
+    run(task: Task): Promise<LearningFlowResult>;
+    /**
+     * Run multiple tasks through the learning flow
+     */
+    runBatch(tasks: Task[]): Promise<LearningFlowResult[]>;
+    /**
+     * Observe an external session and learn from it
+     * Use this when another system provides the session
+     */
+    observeExternal(session: AgentSession, task: Task): Promise<LearningFlowResult>;
+    /**
+     * Force batch learning
+     */
+    runBatchLearning(): Promise<BatchResult>;
+    /**
+     * Get learning statistics
+     */
+    getStats(): {
+        pendingTrajectories: number;
+        batchThreshold: number;
+    };
+}
+/**
+ * Create a learning flow
+ */
+export declare function createLearningFlow(manager: AgentManager, pipeline: LearningPipeline, memory: MemorySystem, config: LearningFlowConfig): LearningFlow;
+//# sourceMappingURL=learning.d.ts.map

package/dist/runtime/flows/learning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning.d.ts","sourceRoot":"","sources":["../../../src/runtime/flows/learning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,+CAA+C;IAC/C,aAAa,EAAE,aAAa,CAAC;IAC7B,mDAAmD;IACnD,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,MAAM,CAAqB;gBAGjC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,kBAAkB;IAgB5B;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6BlD;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAS5D;;;OAGG;IACG,eAAe,CACnB,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,kBAAkB,CAAC;IAkC9B;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,WAAW,CAAC;IAI9C;;OAEG;IACH,QAAQ,IAAI;QACV,mBAAmB,EAAE,MAAM,CAAC;QAC5B,cAAc,EAAE,MAAM,CAAC;KACxB;CAMF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,kBAAkB,GACzB,YAAY,CAEd"}

package/dist/runtime/flows/learning.js

@@ -0,0 +1,116 @@
+/**
+ * Learning Flow
+ * Orchestrates: Agent execution → Trajectory capture → Playbook extraction → Memory storage
+ *
+ * This flow is for the "observation" direction:
+ * - Watch agents solve tasks
+ * - Extract learning signals from their trajectories
+ * - Store playbooks for future guidance
+ */
+export class LearningFlow {
+    manager;
+    pipeline;
+    config;
+    constructor(manager, pipeline, _memory, config) {
+        this.manager = manager;
+        this.pipeline = pipeline;
+        this.config = {
+            batchThreshold: 10,
+            autoBatch: true,
+            ...config,
+        };
+        // Register observer if provided
+        if (config.observer) {
+            this.manager.addObserver(config.observer);
+        }
+    }
+    /**
+     * Run a single task through the learning flow
+     */
+    async run(task) {
+        // 1. Spawn agent and get result (WITHOUT knowledge injection for pure learning)
+        const agentResult = await this.manager.spawnBaseline({
+            agentType: this.config.agentType,
+            task,
+            captureToolCalls: true,
+        });
+        // 2. Process trajectory through learning pipeline
+        const processResult = await this.pipeline.processTrajectory(agentResult.trajectory);
+        // 3. Run batch learning if threshold reached
+        let batchResult;
+        if (this.config.autoBatch &&
+            this.pipeline.getAccumulatedCount() >= (this.config.batchThreshold ?? 10)) {
+            batchResult = await this.pipeline.runBatchLearning();
+        }
+        return {
+            agentResult,
+            processResult,
+            batchResult,
+        };
+    }
+    /**
+     * Run multiple tasks through the learning flow
+     */
+    async runBatch(tasks) {
+        const results = [];
+        for (const task of tasks) {
+            const result = await this.run(task);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Observe an external session and learn from it
+     * Use this when another system provides the session
+     */
+    async observeExternal(session, task) {
+        // Extract trajectory from session
+        const trajectory = await this.manager.observeAndLearn(session, task);
+        // Process through learning pipeline
+        const processResult = await this.pipeline.processTrajectory(trajectory);
+        // Check for batch learning
+        let batchResult;
+        if (this.config.autoBatch &&
+            this.pipeline.getAccumulatedCount() >= (this.config.batchThreshold ?? 10)) {
+            batchResult = await this.pipeline.runBatchLearning();
+        }
+        return {
+            agentResult: {
+                session,
+                trajectory,
+                success: session.state === 'completed',
+                metrics: {
+                    totalTime: session.endTime
+                        ? session.endTime.getTime() - session.startTime.getTime()
+                        : 0,
+                    toolCallCount: session.toolCalls.length,
+                    messageCount: session.messages.length,
+                },
+            },
+            processResult,
+            batchResult,
+        };
+    }
+    /**
+     * Force batch learning
+     */
+    async runBatchLearning() {
+        return this.pipeline.runBatchLearning();
+    }
+    /**
+     * Get learning statistics
+     */
+    getStats() {
+        return {
+            pendingTrajectories: this.pipeline.getAccumulatedCount(),
+            batchThreshold: this.config.batchThreshold ?? 10,
+        };
+    }
+}
+/**
+ * Create a learning flow
+ */
+export function createLearningFlow(manager, pipeline, memory, config) {
+    return new LearningFlow(manager, pipeline, memory, config);
+}
+//# sourceMappingURL=learning.js.map

package/dist/runtime/flows/learning.js.map

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

package/dist/runtime/flows/validation.d.ts

@@ -0,0 +1,122 @@
+import type { Task } from '../../types/index.js';
+import type { MemorySystem } from '../../memory/system.js';
+import type { AgentManager } from '../manager.js';
+import type { AgentResult } from '../types.js';
+/**
+ * Configuration for the validation flow
+ */
+export interface ValidationFlowConfig {
+    /** Agent type to use for execution */
+    agentType: string;
+    /** Number of runs per task for statistical significance */
+    runsPerTask?: number;
+    /** Whether to run comparison (with vs without knowledge) */
+    runComparison?: boolean;
+    /** Timeout per task in ms */
+    taskTimeout?: number;
+}
+/**
+ * Metrics for measuring improvement
+ */
+export interface ValidationMetrics {
+    /** Success rate (0-1) */
+    successRate: number;
+    /** Average execution time in ms */
+    avgTime: number;
+    /** Average tool calls per task */
+    avgToolCalls: number;
+    /** Standard deviation of time */
+    timeStdDev: number;
+    /** Total tasks run */
+    totalRuns: number;
+}
+/**
+ * Comparison result between with/without knowledge
+ */
+export interface ComparisonResult {
+    /** Metrics with knowledge injection */
+    withKnowledge: ValidationMetrics;
+    /** Metrics without knowledge (baseline) */
+    baseline: ValidationMetrics;
+    /** Improvement metrics */
+    improvement: {
+        successRateDelta: number;
+        timeDeltaPercent: number;
+        toolCallDeltaPercent: number;
+        /** Statistical significance (p-value approximation) */
+        isSignificant: boolean;
+    };
+}
+/**
+ * Result of validation flow
+ */
+export interface ValidationFlowResult {
+    /** Results for each task */
+    taskResults: Array<{
+        task: Task;
+        results: AgentResult[];
+        metrics: ValidationMetrics;
+    }>;
+    /** Aggregate metrics */
+    aggregateMetrics: ValidationMetrics;
+    /** Comparison if runComparison was true */
+    comparison?: ComparisonResult;
+}
+/**
+ * Validation Flow
+ * Orchestrates: Knowledge injection → Agent execution → Performance measurement
+ *
+ * This flow is for the "injection" direction:
+ * - Test how well learning is working
+ * - Compare performance with vs without knowledge
+ * - Measure improvement over time
+ */
+export declare class ValidationFlow {
+    private manager;
+    private config;
+    constructor(manager: AgentManager, _memory: MemorySystem, // Reserved for future memory state tracking
+    config: ValidationFlowConfig);
+    /**
+     * Validate on a single task
+     */
+    validateTask(task: Task): Promise<{
+        task: Task;
+        results: AgentResult[];
+        metrics: ValidationMetrics;
+        comparison?: ComparisonResult;
+    }>;
+    /**
+     * Validate on multiple tasks
+     */
+    validate(tasks: Task[]): Promise<ValidationFlowResult>;
+    /**
+     * Quick validation - single run per task, with comparison
+     */
+    quickValidate(tasks: Task[]): Promise<{
+        successRateWithKnowledge: number;
+        successRateBaseline: number;
+        improvement: number;
+        details: Array<{
+            task: Task;
+            withKnowledge: boolean;
+            baseline: boolean;
+        }>;
+    }>;
+    /**
+     * Calculate metrics from results
+     */
+    private calculateMetrics;
+    /**
+     * Calculate comparison between two sets of metrics
+     */
+    private calculateComparison;
+    /**
+     * Generate a validation report
+     */
+    generateReport(result: ValidationFlowResult): string;
+}
+/**
+ * Create a validation flow
+ */
+export declare function createValidationFlow(manager: AgentManager, memory: MemorySystem, config: ValidationFlowConfig): ValidationFlow;
+//# sourceMappingURL=validation.d.ts.map

package/dist/runtime/flows/validation.d.ts.map

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