iranti 0.1.0

package/dist/src/api/routes/knowledge.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.knowledgeRoutes = knowledgeRoutes;
+const express_1 = require("express");
+const entity_resolution_1 = require("../../library/entity-resolution");
+const validation_1 = require("../middleware/validation");
+function heuristicEntityId(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '');
+}
+function toProjectStyleEntityId(name) {
+    const normalized = heuristicEntityId(name);
+    if (!normalized)
+        return '';
+    return normalized.startsWith('project_') ? normalized : `project_${normalized}`;
+}
+function parseResolveTarget(entity) {
+    if (typeof entity !== 'string' || entity.trim().length === 0) {
+        throw new Error('entity must be a non-empty string.');
+    }
+    const raw = entity.trim();
+    if (raw.includes('/')) {
+        const parsed = (0, entity_resolution_1.parseEntityString)(raw);
+        return {
+            entityType: parsed.entityType,
+            entityId: parsed.entityId,
+            rawName: raw,
+        };
+    }
+    const entityId = toProjectStyleEntityId(raw);
+    if (!entityId) {
+        throw new Error(`Unable to resolve raw entity name: "${raw}"`);
+    }
+    return {
+        entityType: 'project',
+        entityId,
+        rawName: raw,
+    };
+}
+function knowledgeRoutes(iranti) {
+    const router = (0, express_1.Router)();
+    // POST /write
+    router.post('/write', (0, validation_1.validateInput)('write'), async (req, res) => {
+        try {
+            const result = await iranti.write(req.body);
+            res.json(result);
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // POST /ingest
+    router.post('/ingest', async (req, res) => {
+        try {
+            const result = await iranti.ingest(req.body);
+            res.json(result);
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // POST /resolve
+    router.post('/resolve', async (req, res) => {
+        try {
+            const { entity, createIfMissing, aliases, source, confidence, agent } = req.body ?? {};
+            const parsed = parseResolveTarget(entity);
+            const resolved = await (0, entity_resolution_1.resolveEntity)({
+                entityType: parsed.entityType,
+                entityId: parsed.entityId,
+                rawName: parsed.rawName,
+                aliases: Array.isArray(aliases) ? aliases : [parsed.rawName],
+                source: source ?? agent ?? 'api',
+                confidence: typeof confidence === 'number' ? confidence : undefined,
+                createIfMissing: createIfMissing !== false,
+            });
+            res.json({
+                canonicalEntity: resolved.canonicalEntity,
+                canonicalType: resolved.entityType,
+                canonicalId: resolved.entityId,
+                addedAliases: resolved.addedAliases,
+                matchedBy: resolved.matchedBy,
+                entityKey: resolved.canonicalEntity,
+            });
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // POST /alias
+    router.post('/alias', async (req, res) => {
+        try {
+            const { canonicalEntity, alias, source, confidence, force } = req.body ?? {};
+            const result = await (0, entity_resolution_1.addAlias)({
+                canonicalEntity,
+                alias,
+                source: source ?? 'api',
+                confidence: typeof confidence === 'number' ? confidence : undefined,
+                force: Boolean(force),
+            });
+            res.json({
+                ok: true,
+                canonicalEntity: result.canonicalEntity,
+                aliasNormalized: result.aliasNormalized,
+                created: result.created,
+            });
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // GET /entity/:entityType/:entityId/aliases
+    router.get('/entity/:entityType/:entityId/aliases', async (req, res) => {
+        try {
+            const { entityType, entityId } = req.params;
+            const result = await (0, entity_resolution_1.listAliases)(`${entityType}/${entityId}`);
+            res.json(result);
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // GET /query/:entityType/:entityId/:key
+    router.get('/query/:entityType/:entityId/:key', async (req, res) => {
+        try {
+            const entityType = Array.isArray(req.params.entityType) ? req.params.entityType[0] : req.params.entityType;
+            const entityId = Array.isArray(req.params.entityId) ? req.params.entityId[0] : req.params.entityId;
+            const key = Array.isArray(req.params.key) ? req.params.key[0] : req.params.key;
+            const result = await iranti.query(`${entityType}/${entityId}`, key);
+            res.json(result);
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // GET /query/:entityType/:entityId
+    router.get('/query/:entityType/:entityId', async (req, res) => {
+        try {
+            const { entityType, entityId } = req.params;
+            const result = await iranti.queryAll(`${entityType}/${entityId}`);
+            res.json(result);
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // POST /relate
+    router.post('/relate', (0, validation_1.validateInput)('relate'), async (req, res) => {
+        try {
+            const { fromEntity, relationshipType, toEntity, createdBy, properties } = req.body;
+            await iranti.relate(fromEntity, relationshipType, toEntity, { createdBy, properties });
+            res.json({ success: true });
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // GET /related/:entityType/:entityId
+    router.get('/related/:entityType/:entityId', async (req, res) => {
+        try {
+            const { entityType, entityId } = req.params;
+            const result = await iranti.getRelated(`${entityType}/${entityId}`);
+            res.json(result);
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // GET /related/:entityType/:entityId/deep
+    router.get('/related/:entityType/:entityId/deep', async (req, res) => {
+        try {
+            const { entityType, entityId } = req.params;
+            const depth = parseInt(req.query.depth ?? '2');
+            const result = await iranti.getRelatedDeep(`${entityType}/${entityId}`, depth);
+            res.json(result);
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/src/api/routes/knowledge.js.map

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

package/dist/src/api/routes/memory.d.ts

@@ -0,0 +1,4 @@
+import { Router } from 'express';
+import { Iranti } from '../../sdk';
+export declare function memoryRoutes(iranti: Iranti): Router;
+//# sourceMappingURL=memory.d.ts.map

package/dist/src/api/routes/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/api/routes/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAyCnC,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAmHnD"}

package/dist/src/api/routes/memory.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memoryRoutes = memoryRoutes;
+const express_1 = require("express");
+const entity_resolution_1 = require("../../library/entity-resolution");
+const validation_1 = require("../middleware/validation");
+function normalizeAgent(req) {
+    const fromAgent = req.body.agent;
+    const fromAgentId = req.body.agentId;
+    if (typeof fromAgent === 'string' && fromAgent.trim().length > 0) {
+        return fromAgent.trim();
+    }
+    if (typeof fromAgentId === 'string' && fromAgentId.trim().length > 0) {
+        return fromAgentId.trim();
+    }
+    return null;
+}
+function normalizeEntityHints(rawEntityHints) {
+    if (rawEntityHints === undefined)
+        return [];
+    if (!Array.isArray(rawEntityHints)) {
+        throw new Error('entityHints must be an array of "entityType/entityId" strings.');
+    }
+    const dedup = new Set();
+    for (const hint of rawEntityHints) {
+        if (typeof hint !== 'string') {
+            throw new Error(`Invalid entity hint: "${String(hint)}". Expected "entityType/entityId".`);
+        }
+        const normalized = hint.trim();
+        if (!normalized)
+            continue;
+        if (!normalized.includes('/')) {
+            throw new Error(`Invalid entity hint: "${normalized}". Expected "entityType/entityId".`);
+        }
+        (0, entity_resolution_1.parseEntityString)(normalized);
+        dedup.add(normalized);
+    }
+    return Array.from(dedup);
+}
+function memoryRoutes(iranti) {
+    const router = (0, express_1.Router)();
+    // POST /handshake
+    router.post('/handshake', (0, validation_1.validateInput)('handshake'), async (req, res) => {
+        try {
+            const result = await iranti.handshake(req.body);
+            res.json(result);
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // POST /reconvene
+    router.post('/reconvene', async (req, res) => {
+        try {
+            const { agentId, task, recentMessages } = req.body;
+            const result = await iranti.reconvene(agentId, { task, recentMessages });
+            res.json(result);
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // GET /whoknows/:entityType/:entityId
+    router.get('/whoknows/:entityType/:entityId', async (req, res) => {
+        try {
+            const { entityType, entityId } = req.params;
+            const result = await iranti.whoKnows(`${entityType}/${entityId}`);
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // POST /maintenance
+    router.post('/maintenance', async (_req, res) => {
+        try {
+            const result = await iranti.runMaintenance();
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // POST /observe
+    router.post('/observe', async (req, res) => {
+        try {
+            const { currentContext, maxFacts } = req.body;
+            const agent = normalizeAgent(req);
+            const normalizedContext = typeof currentContext === 'string' ? currentContext : '';
+            const entityHints = normalizeEntityHints(req.body.entityHints);
+            if (!agent) {
+                return res.status(400).json({ error: 'agent (or agentId) is required.' });
+            }
+            if (normalizedContext.trim().length === 0 && entityHints.length === 0) {
+                return res.json({
+                    facts: [],
+                    entitiesDetected: [],
+                    entitiesResolved: [],
+                    alreadyPresent: 0,
+                    totalFound: 0,
+                    debug: {
+                        skipped: 'empty_context',
+                        contextLength: 0,
+                        detectionWindowChars: 0,
+                        detectedCandidates: 0,
+                        keptCandidates: 0,
+                        dropped: [],
+                    },
+                });
+            }
+            const result = await iranti.observe({
+                agent,
+                currentContext: normalizedContext,
+                maxFacts,
+                entityHints: entityHints.length > 0 ? entityHints : undefined,
+            });
+            res.json(result);
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // POST /attend
+    router.post('/attend', async (req, res) => {
+        try {
+            const { currentContext, maxFacts, latestMessage, forceInject } = req.body;
+            const agent = normalizeAgent(req);
+            const normalizedContext = typeof currentContext === 'string' ? currentContext : '';
+            const normalizedLatestMessage = typeof latestMessage === 'string' ? latestMessage : undefined;
+            const entityHints = normalizeEntityHints(req.body.entityHints);
+            if (!agent) {
+                return res.status(400).json({ error: 'agent (or agentId) is required.' });
+            }
+            const result = await iranti.attend({
+                agent,
+                currentContext: normalizedContext,
+                maxFacts,
+                entityHints: entityHints.length > 0 ? entityHints : undefined,
+                latestMessage: normalizedLatestMessage,
+                forceInject: forceInject === true,
+            });
+            res.json(result);
+        }
+        catch (err) {
+            res.status(400).json({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=memory.js.map

package/dist/src/api/routes/memory.js.map

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

package/dist/src/api/server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/src/api/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/api/server.ts"],"names":[],"mappings":""}

package/dist/src/api/server.js

@@ -0,0 +1,191 @@
+"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 });
+const dotenv_1 = require("dotenv");
+(0, dotenv_1.config)();
+const express_1 = __importDefault(require("express"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const sdk_1 = require("../sdk");
+const knowledge_1 = require("./routes/knowledge");
+const memory_1 = require("./routes/memory");
+const agents_1 = require("./routes/agents");
+const dev_1 = require("./routes/dev");
+const batch_1 = require("./routes/batch");
+const auth_1 = require("./middleware/auth");
+const authorization_1 = require("./middleware/authorization");
+const rateLimit_1 = require("./middleware/rateLimit");
+const metrics_1 = require("../lib/metrics");
+const requestContext_1 = require("../lib/requestContext");
+const archivistScheduler_1 = require("./archivistScheduler");
+const escalationPaths_1 = require("../lib/escalationPaths");
+const app = (0, express_1.default)();
+// Route prefixes
+const ROUTES = {
+    agents: '/agents',
+    kb: '/kb',
+    memory: '/memory',
+    health: '/health',
+};
+const REQUEST_LOG_FILE = process.env.IRANTI_REQUEST_LOG_FILE?.trim() ||
+    path_1.default.join(process.cwd(), 'logs', 'api-requests.log');
+try {
+    fs_1.default.mkdirSync(path_1.default.dirname(REQUEST_LOG_FILE), { recursive: true });
+}
+catch (err) {
+    console.error('[api] failed to create log directory:', err);
+}
+const requestLogStream = fs_1.default.createWriteStream(REQUEST_LOG_FILE, {
+    flags: 'a',
+    encoding: 'utf8',
+});
+requestLogStream.on('error', (err) => {
+    console.error('[api] request log stream error:', err);
+});
+function logApiRequest(line) {
+    console.log(line);
+    requestLogStream.write(`${line}\n`);
+}
+app.use((req, res, next) => {
+    const startedAt = Date.now();
+    const method = req.method;
+    const url = req.originalUrl;
+    const requestId = req.headers['x-request-id'];
+    res.on('finish', () => {
+        const durationMs = Date.now() - startedAt;
+        const rid = Array.isArray(requestId) ? requestId[0] : requestId;
+        const line = `${new Date().toISOString()} ${method} ${url} ` +
+            `status=${res.statusCode} duration_ms=${durationMs}` +
+            `${rid ? ` request_id=${rid}` : ''}`;
+        logApiRequest(line);
+    });
+    requestContext_1.requestContext.run({ llmCount: 0 }, () => next());
+});
+app.use(express_1.default.json({ limit: process.env.IRANTI_MAX_BODY_BYTES ?? '256kb' }));
+// Public health check
+app.get(ROUTES.health, (_req, res) => {
+    res.json({
+        status: 'ok',
+        version: '0.1.0',
+        provider: process.env.LLM_PROVIDER ?? 'mock',
+    });
+});
+// Initialize Iranti SDK
+const iranti = new sdk_1.Iranti({
+    connectionString: process.env.DATABASE_URL,
+    llmProvider: process.env.LLM_PROVIDER ?? 'mock',
+});
+let stopArchivistScheduler = null;
+void (0, archivistScheduler_1.startArchivistScheduler)(iranti)
+    .then((scheduler) => {
+    if (!scheduler.started)
+        return;
+    stopArchivistScheduler = scheduler.stop;
+    console.log('[archivist] scheduler enabled');
+})
+    .catch((err) => {
+    console.error('[archivist] scheduler startup failed:', err);
+});
+// Mount protected routes
+app.use(ROUTES.agents, auth_1.authenticate, rateLimit_1.rateLimitMiddleware, (0, authorization_1.requireScopeByMethod)('agents:read', 'agents:write'), (0, agents_1.agentRoutes)(iranti));
+app.use('/kb', auth_1.authenticate, rateLimit_1.rateLimitMiddleware, (0, authorization_1.requireAnyScope)(['kb:read']), batch_1.batchRouter);
+app.use(ROUTES.kb, auth_1.authenticate, rateLimit_1.rateLimitMiddleware, (0, authorization_1.requireScopeByMethod)('kb:read', 'kb:write'), (0, knowledge_1.knowledgeRoutes)(iranti));
+app.use(ROUTES.memory, auth_1.authenticate, rateLimit_1.rateLimitMiddleware, (0, authorization_1.requireScopeByMethod)('memory:read', 'memory:write'), (0, memory_1.memoryRoutes)(iranti));
+app.use('/dev', auth_1.authenticate, rateLimit_1.rateLimitMiddleware, (0, authorization_1.requireAnyScope)(['system:admin']), dev_1.devRouter);
+// Observability
+app.get('/metrics', auth_1.authenticate, rateLimit_1.rateLimitMiddleware, (0, authorization_1.requireAnyScope)(['metrics:read']), (_req, res) => {
+    res.json((0, metrics_1.snapshot)());
+});
+app.post('/metrics/reset', auth_1.authenticate, rateLimit_1.rateLimitMiddleware, (0, authorization_1.requireAnyScope)(['metrics:write']), (_req, res) => {
+    (0, metrics_1.reset)();
+    res.json({ ok: true });
+});
+app.post(['/v1/chat/completions', '/chat/completions'], auth_1.authenticate, rateLimit_1.rateLimitMiddleware, (0, authorization_1.requireAnyScope)(['proxy:chat']), async (req, res) => {
+    try {
+        const messages = (req.body.messages ?? []).map((m) => ({
+            role: m.role,
+            content: String(m.content),
+        }));
+        // Dynamic provider selection
+        const provider = process.env.LLM_PROVIDER || 'mock';
+        let response;
+        if (provider === 'gemini') {
+            const { default: geminiProvider } = await Promise.resolve().then(() => __importStar(require('../lib/providers/gemini')));
+            response = await geminiProvider.complete(messages);
+        }
+        else if (provider === 'openai') {
+            const { default: openaiProvider } = await Promise.resolve().then(() => __importStar(require('../lib/providers/openai')));
+            response = await openaiProvider.complete(messages);
+        }
+        else {
+            const { default: mockProvider } = await Promise.resolve().then(() => __importStar(require('../lib/providers/mock')));
+            response = await mockProvider.complete(messages);
+        }
+        res.json({
+            id: `mock-${Date.now()}`,
+            object: 'chat.completion',
+            created: Math.floor(Date.now() / 1000),
+            model: 'mock',
+            choices: [{
+                    index: 0,
+                    message: { role: 'assistant', content: response.text },
+                    finish_reason: 'stop',
+                }],
+            usage: { prompt_tokens: 0, completion_tokens: 0, total_tokens: 0 },
+        });
+    }
+    catch (err) {
+        res.status(500).json({ error: err instanceof Error ? err.message : String(err) });
+    }
+});
+const PORT = parseInt(process.env.IRANTI_PORT ?? '3001');
+app.listen(PORT, () => {
+    console.log(`\nIranti API running on port ${PORT}`);
+    console.log(`Health: http://localhost:${PORT}/health`);
+    console.log(`Provider: ${process.env.LLM_PROVIDER ?? 'mock'}\n`);
+    console.log(`Escalation root: ${(0, escalationPaths_1.getEscalationPaths)().root}`);
+    console.log(`Request log file: ${REQUEST_LOG_FILE}\n`);
+});
+for (const signal of ['SIGINT', 'SIGTERM']) {
+    process.on(signal, () => {
+        if (stopArchivistScheduler)
+            stopArchivistScheduler();
+        requestLogStream.end(() => process.exit(0));
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/src/api/server.js.map

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

package/dist/src/archivist/index.d.ts

@@ -0,0 +1,10 @@
+interface ArchivistReport {
+    expiredArchived: number;
+    lowConfidenceArchived: number;
+    duplicatesMerged: number;
+    escalationsProcessed: number;
+    errors: string[];
+}
+export declare function runArchivist(): Promise<ArchivistReport>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/archivist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/archivist/index.ts"],"names":[],"mappings":"AAaA,UAAU,eAAe;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAmDD,wBAAsB,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC,CAe7D"}