iranti 0.1.0

package/dist/src/archivist/index.js

@@ -0,0 +1,232 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runArchivist = runArchivist;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const client_1 = require("../library/client");
+const queries_1 = require("../library/queries");
+const llm_1 = require("../lib/llm");
+const escalationPaths_1 = require("../lib/escalationPaths");
+// ─── Constants ───────────────────────────────────────────────────────────────
+const LOW_CONFIDENCE_THRESHOLD = 30;
+function extractAuthoritativeJson(fileText) {
+    const marker = '### AUTHORITATIVE_JSON';
+    const markerIndex = fileText.indexOf(marker);
+    if (markerIndex === -1) {
+        throw new Error("Missing '### AUTHORITATIVE_JSON' section.");
+    }
+    const afterMarker = fileText.slice(markerIndex + marker.length);
+    const fenceStart = afterMarker.indexOf('```json');
+    if (fenceStart === -1) {
+        throw new Error('Missing ```json block after AUTHORITATIVE_JSON.');
+    }
+    const afterFence = afterMarker.slice(fenceStart + '```json'.length);
+    const fenceEnd = afterFence.indexOf('```');
+    if (fenceEnd === -1) {
+        throw new Error('Unclosed ```json block in AUTHORITATIVE_JSON.');
+    }
+    const jsonText = afterFence.slice(0, fenceEnd).trim();
+    let payload;
+    try {
+        payload = JSON.parse(jsonText);
+    }
+    catch {
+        throw new Error('Invalid JSON in AUTHORITATIVE_JSON.');
+    }
+    for (const field of ['entityType', 'entityId', 'key', 'value', 'summary']) {
+        if (payload[field] === undefined || payload[field] === null) {
+            throw new Error(`AUTHORITATIVE_JSON missing required field: ${field}`);
+        }
+    }
+    return payload;
+}
+// ─── Main Cycle ──────────────────────────────────────────────────────────────
+async function runArchivist() {
+    const report = {
+        expiredArchived: 0,
+        lowConfidenceArchived: 0,
+        duplicatesMerged: 0,
+        escalationsProcessed: 0,
+        errors: [],
+    };
+    await (0, escalationPaths_1.ensureEscalationFolders)();
+    await archiveExpired(report);
+    await archiveLowConfidence(report);
+    await processEscalations(report);
+    return report;
+}
+// ─── Expired Entries ─────────────────────────────────────────────────────────
+async function archiveExpired(report) {
+    const expired = await (0, client_1.getDb)().knowledgeEntry.findMany({
+        where: {
+            validUntil: { lt: new Date() },
+            isProtected: false,
+        },
+    });
+    for (const entry of expired) {
+        try {
+            await (0, queries_1.archiveEntry)(entry, 'expired');
+            report.expiredArchived++;
+        }
+        catch (err) {
+            report.errors.push(`Failed to archive expired entry ${entry.id}: ${err}`);
+        }
+    }
+}
+// ─── Low Confidence Entries ──────────────────────────────────────────────────
+async function archiveLowConfidence(report) {
+    const lowConfidence = await (0, client_1.getDb)().knowledgeEntry.findMany({
+        where: {
+            confidence: { lt: LOW_CONFIDENCE_THRESHOLD },
+            isProtected: false,
+        },
+    });
+    for (const entry of lowConfidence) {
+        try {
+            await (0, queries_1.archiveEntry)(entry, 'superseded');
+            report.lowConfidenceArchived++;
+        }
+        catch (err) {
+            report.errors.push(`Failed to archive low confidence entry ${entry.id}: ${err}`);
+        }
+    }
+}
+// ─── Escalation Processing ───────────────────────────────────────────────────
+async function processEscalations(report) {
+    const paths = await (0, escalationPaths_1.ensureEscalationFolders)();
+    let files;
+    try {
+        files = await promises_1.default.readdir(paths.active);
+    }
+    catch (err) {
+        report.errors.push(`Could not read ${paths.active}: ${err}`);
+        return;
+    }
+    const markdownFiles = files.filter((f) => f.endsWith('.md'));
+    for (const filename of markdownFiles) {
+        try {
+            await processEscalationFile(filename, paths, report);
+        }
+        catch (err) {
+            report.errors.push(`Failed to process escalation file ${filename}: ${err}`);
+        }
+    }
+}
+async function processEscalationFile(filename, paths, report) {
+    const sanitizedFilename = filename.replace(/[^a-zA-Z0-9_.-]/g, '_');
+    const filePath = path_1.default.join(paths.active, sanitizedFilename);
+    const content = await promises_1.default.readFile(filePath, 'utf-8');
+    if (!content.includes('**Status:** RESOLVED')) {
+        return;
+    }
+    let auth;
+    try {
+        auth = extractAuthoritativeJson(content);
+    }
+    catch (err) {
+        report.errors.push(`Escalation ${filename}: ${err}`);
+        return;
+    }
+    const { librarianWrite } = await Promise.resolve().then(() => __importStar(require('../librarian/index')));
+    const result = await librarianWrite({
+        entityType: auth.entityType,
+        entityId: auth.entityId,
+        key: auth.key,
+        valueRaw: auth.value,
+        valueSummary: auth.summary,
+        confidence: 100,
+        source: 'HumanReview',
+        createdBy: 'archivist',
+        validUntil: auth.validUntil ? new Date(auth.validUntil) : undefined,
+        conflictLog: [{
+                detectedAt: new Date().toISOString(),
+                incomingSource: 'HumanReview',
+                incomingConfidence: 100,
+                existingConfidence: 0,
+                resolution: 'human_resolved',
+                resolvedBy: 'archivist',
+                notes: `Applied from escalation file: ${filename}`,
+            }],
+    });
+    // LLM enrichment (non-authoritative)
+    try {
+        const enrichment = await generateEnrichment(content, auth);
+        if (enrichment) {
+            await appendEnrichmentToFile(filePath, enrichment);
+        }
+    }
+    catch (err) {
+        // Enrichment failure doesn't block commit
+        report.errors.push(`Escalation ${filename}: enrichment failed: ${err}`);
+    }
+    // Move file to resolved folder
+    const resolvedPath = path_1.default.join(paths.resolved, sanitizedFilename);
+    await promises_1.default.rename(filePath, resolvedPath);
+    // Archive a copy with timestamp
+    const archivedFilename = sanitizedFilename.replace('.md', `_archived_${Date.now()}.md`);
+    const archivedPath = path_1.default.join(paths.archived, archivedFilename);
+    await promises_1.default.copyFile(resolvedPath, archivedPath);
+    report.escalationsProcessed++;
+}
+async function generateEnrichment(fileContent, auth) {
+    const prompt = `You are analyzing a resolved conflict. The human provided this authoritative resolution:
+
+${JSON.stringify(auth, null, 2)}
+
+Provide enrichment (non-authoritative):
+1. Brief explanation of why this resolution makes sense
+2. Suggested validUntil (ISO 8601) if none provided and fact seems time-bound
+3. Any normalization warnings
+
+Respond with JSON: { "explanation": "...", "suggestedValidUntil": "..." or null, "normalizationWarnings": [...] }`;
+    const response = await (0, llm_1.complete)([
+        { role: 'user', content: prompt }
+    ], 1000);
+    try {
+        return JSON.parse(response.text);
+    }
+    catch {
+        return null;
+    }
+}
+async function appendEnrichmentToFile(filePath, enrichment) {
+    const enrichmentBlock = `\n\n### LLM_ENRICHMENT (non-authoritative)\n\`\`\`json\n${JSON.stringify(enrichment, null, 2)}\n\`\`\`\n`;
+    await promises_1.default.appendFile(filePath, enrichmentBlock);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/archivist/index.js.map

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

package/dist/src/attendant/AttendantInstance.d.ts

@@ -0,0 +1,96 @@
+export interface AgentContext {
+    task: string;
+    recentMessages: string[];
+}
+export interface WorkingMemoryEntry {
+    entityKey: string;
+    summary: string;
+    confidence: number;
+    source: string;
+    lastUpdated: string;
+}
+export interface WorkingMemoryBrief {
+    agentId: string;
+    operatingRules: string;
+    inferredTaskType: string;
+    workingMemory: WorkingMemoryEntry[];
+    sessionStarted: string;
+    briefGeneratedAt: string;
+    contextCallCount: number;
+}
+export interface ObserveInput {
+    currentContext: string;
+    maxFacts?: number;
+    entityHints?: string[];
+}
+export interface FactInjection {
+    entityKey: string;
+    summary: string;
+    value: unknown;
+    confidence: number;
+    source: string;
+}
+export interface ObserveResult {
+    facts: FactInjection[];
+    entitiesDetected: string[];
+    alreadyPresent: number;
+    totalFound: number;
+    entitiesResolved?: Array<{
+        name: string;
+        input: string;
+        canonicalEntity: string;
+        confidence: number;
+        matchedBy: 'exact' | 'alias' | 'created' | 'hint';
+    }>;
+    debug?: {
+        skipped?: 'empty_context';
+        contextLength: number;
+        detectionWindowChars: number;
+        detectedCandidates: number;
+        keptCandidates: number;
+        hintsProvided?: number;
+        hintsResolved?: number;
+        dropped: Array<{
+            name: string;
+            reason: string;
+        }>;
+    };
+}
+export interface AttendInput extends ObserveInput {
+    latestMessage?: string;
+    forceInject?: boolean;
+}
+export interface AttendDecision {
+    needed: boolean;
+    confidence: number;
+    method: 'heuristic' | 'llm' | 'forced';
+    explanation: string;
+}
+export interface AttendResult extends ObserveResult {
+    shouldInject: boolean;
+    reason: 'forced' | 'memory_not_needed' | 'memory_needed_no_facts' | 'memory_needed_but_in_context' | 'memory_needed_injected';
+    decision: AttendDecision;
+}
+export declare class AttendantInstance {
+    private agentId;
+    private brief;
+    private contextCallCount;
+    private sessionStarted;
+    constructor(agentId: string);
+    handshake(context: AgentContext): Promise<WorkingMemoryBrief>;
+    reconvene(context: AgentContext): Promise<WorkingMemoryBrief>;
+    updateWorkingMemory(entry: WorkingMemoryEntry): void;
+    onContextLow(): Promise<void>;
+    getBrief(): WorkingMemoryBrief | null;
+    getAgentId(): string;
+    attend(input: AttendInput): Promise<AttendResult>;
+    observe(input: ObserveInput): Promise<ObserveResult>;
+    private decideMemoryNeed;
+    private parseMemoryDecision;
+    private inferTask;
+    private loadOperatingRules;
+    private buildWorkingMemory;
+    private persistState;
+    private loadPersistedState;
+}
+//# sourceMappingURL=AttendantInstance.d.ts.map

package/dist/src/attendant/AttendantInstance.d.ts.map

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