iranti 0.1.0

package/dist/src/library/relationships.d.ts

@@ -0,0 +1,30 @@
+export interface RelationshipInput {
+    fromType: string;
+    fromId: string;
+    relationshipType: string;
+    toType: string;
+    toId: string;
+    createdBy: string;
+    properties?: Record<string, unknown>;
+}
+export interface Relationship {
+    fromType: string;
+    fromId: string;
+    relationshipType: string;
+    toType: string;
+    toId: string;
+    properties: Record<string, unknown>;
+    createdAt: Date;
+}
+export interface RelatedEntity {
+    entityType: string;
+    entityId: string;
+    relationshipType: string;
+    direction: 'outbound' | 'inbound';
+    properties: Record<string, unknown>;
+}
+export declare function createRelationship(input: RelationshipInput): Promise<Relationship>;
+export declare function getRelated(entityType: string, entityId: string): Promise<RelatedEntity[]>;
+export declare function getRelatedDeep(entityType: string, entityId: string, depth?: number): Promise<RelatedEntity[]>;
+export declare function deleteRelationship(fromType: string, fromId: string, relationshipType: string, toType: string, toId: string): Promise<void>;
+//# sourceMappingURL=relationships.d.ts.map

package/dist/src/library/relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../../src/library/relationships.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,YAAY;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,SAAS,EAAE,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,UAAU,GAAG,SAAS,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAID,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CA6BxF;AAID,wBAAsB,UAAU,CAC5B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,EAAE,CAAC,CA4B1B;AAED,wBAAsB,cAAc,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAU,GAClB,OAAO,CAAC,aAAa,EAAE,CAAC,CAkB1B;AAID,wBAAsB,kBAAkB,CACpC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/src/library/relationships.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRelationship = createRelationship;
+exports.getRelated = getRelated;
+exports.getRelatedDeep = getRelatedDeep;
+exports.deleteRelationship = deleteRelationship;
+const client_1 = require("./client");
+// ─── Write ───────────────────────────────────────────────────────────────────
+async function createRelationship(input) {
+    const result = await (0, client_1.getDb)().entityRelationship.upsert({
+        where: {
+            fromType_fromId_relationshipType_toType_toId: {
+                fromType: input.fromType,
+                fromId: input.fromId,
+                relationshipType: input.relationshipType,
+                toType: input.toType,
+                toId: input.toId,
+            },
+        },
+        update: {
+            properties: (input.properties ?? {}),
+        },
+        create: {
+            fromType: input.fromType,
+            fromId: input.fromId,
+            relationshipType: input.relationshipType,
+            toType: input.toType,
+            toId: input.toId,
+            createdBy: input.createdBy,
+            properties: (input.properties ?? {}),
+        },
+    });
+    return {
+        ...result,
+        properties: (result.properties ?? {}),
+    };
+}
+// ─── Read ────────────────────────────────────────────────────────────────────
+async function getRelated(entityType, entityId) {
+    const [outbound, inbound] = await Promise.all([
+        (0, client_1.getDb)().entityRelationship.findMany({
+            where: { fromType: entityType, fromId: entityId },
+        }),
+        (0, client_1.getDb)().entityRelationship.findMany({
+            where: { toType: entityType, toId: entityId },
+        }),
+    ]);
+    const results = [
+        ...outbound.map((r) => ({
+            entityType: r.toType,
+            entityId: r.toId,
+            relationshipType: r.relationshipType,
+            direction: 'outbound',
+            properties: (r.properties ?? {}),
+        })),
+        ...inbound.map((r) => ({
+            entityType: r.fromType,
+            entityId: r.fromId,
+            relationshipType: r.relationshipType,
+            direction: 'inbound',
+            properties: (r.properties ?? {}),
+        })),
+    ];
+    return results;
+}
+async function getRelatedDeep(entityType, entityId, depth = 2) {
+    const visited = new Set();
+    const allRelated = [];
+    async function traverse(type, id, currentDepth) {
+        const key = `${type}/${id}`;
+        if (visited.has(key) || currentDepth === 0)
+            return;
+        visited.add(key);
+        const related = await getRelated(type, id);
+        for (const r of related) {
+            allRelated.push(r);
+            await traverse(r.entityType, r.entityId, currentDepth - 1);
+        }
+    }
+    await traverse(entityType, entityId, depth);
+    return allRelated;
+}
+// ─── Delete ──────────────────────────────────────────────────────────────────
+async function deleteRelationship(fromType, fromId, relationshipType, toType, toId) {
+    await (0, client_1.getDb)().entityRelationship.delete({
+        where: {
+            fromType_fromId_relationshipType_toType_toId: {
+                fromType,
+                fromId,
+                relationshipType,
+                toType,
+                toId,
+            },
+        },
+    });
+}
+//# sourceMappingURL=relationships.js.map

package/dist/src/library/relationships.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.js","sourceRoot":"","sources":["../../../src/library/relationships.ts"],"names":[],"mappings":";;AAmCA,gDA6BC;AAID,gCA+BC;AAED,wCAsBC;AAID,gDAkBC;AAjJD,qCAAiC;AAiCjC,gFAAgF;AAEzE,KAAK,UAAU,kBAAkB,CAAC,KAAwB;IAC7D,MAAM,MAAM,GAAG,MAAM,IAAA,cAAK,GAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC;QACnD,KAAK,EAAE;YACH,4CAA4C,EAAE;gBAC1C,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;gBACxC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,IAAI,EAAE,KAAK,CAAC,IAAI;aACnB;SACJ;QACD,MAAM,EAAE;YACJ,UAAU,EAAE,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAA0B;SAChE;QACD,MAAM,EAAE;YACJ,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,UAAU,EAAE,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAA0B;SAChE;KACJ,CAAC,CAAC;IAEH,OAAO;QACH,GAAG,MAAM;QACT,UAAU,EAAE,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAA4B;KACnE,CAAC;AACN,CAAC;AAED,gFAAgF;AAEzE,KAAK,UAAU,UAAU,CAC5B,UAAkB,EAClB,QAAgB;IAEhB,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1C,IAAA,cAAK,GAAE,CAAC,kBAAkB,CAAC,QAAQ,CAAC;YAChC,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE;SACpD,CAAC;QACF,IAAA,cAAK,GAAE,CAAC,kBAAkB,CAAC,QAAQ,CAAC;YAChC,KAAK,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE;SAChD,CAAC;KACL,CAAC,CAAC;IAEH,MAAM,OAAO,GAAoB;QAC7B,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;YACzB,UAAU,EAAE,CAAC,CAAC,MAAM;YACpB,QAAQ,EAAE,CAAC,CAAC,IAAI;YAChB,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;YACpC,SAAS,EAAE,UAAmB;YAC9B,UAAU,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAA4B;SAC9D,CAAC,CAAC;QACH,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;YACxB,UAAU,EAAE,CAAC,CAAC,QAAQ;YACtB,QAAQ,EAAE,CAAC,CAAC,MAAM;YAClB,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;YACpC,SAAS,EAAE,SAAkB;YAC7B,UAAU,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAA4B;SAC9D,CAAC,CAAC;KACN,CAAC;IAEF,OAAO,OAAO,CAAC;AACnB,CAAC;AAEM,KAAK,UAAU,cAAc,CAChC,UAAkB,EAClB,QAAgB,EAChB,QAAgB,CAAC;IAEjB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,UAAU,GAAoB,EAAE,CAAC;IAEvC,KAAK,UAAU,QAAQ,CAAC,IAAY,EAAE,EAAU,EAAE,YAAoB;QAClE,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;QAC5B,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,YAAY,KAAK,CAAC;YAAE,OAAO;QACnD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEjB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACtB,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACnB,MAAM,QAAQ,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;QAC/D,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,CAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC5C,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,gFAAgF;AAEzE,KAAK,UAAU,kBAAkB,CACpC,QAAgB,EAChB,MAAc,EACd,gBAAwB,EACxB,MAAc,EACd,IAAY;IAEZ,MAAM,IAAA,cAAK,GAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC;QACpC,KAAK,EAAE;YACH,4CAA4C,EAAE;gBAC1C,QAAQ;gBACR,MAAM;gBACN,gBAAgB;gBAChB,MAAM;gBACN,IAAI;aACP;SACJ;KACJ,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,108 @@
+import 'dotenv/config';
+import type { WorkingMemoryBrief, AttendResult } from '../attendant';
+import { AttendantInstance } from '../attendant/registry';
+import { RelatedEntity } from '../library/relationships';
+import { AgentProfile, AgentRecord } from '../library/agent-registry';
+import { MockConfig } from '../lib/providers/mock';
+export interface IrantiConfig {
+    connectionString?: string;
+    llmProvider?: string;
+}
+export interface WriteInput {
+    entity: string;
+    key: string;
+    value: unknown;
+    summary: string;
+    confidence: number;
+    source: string;
+    agent: string;
+    validUntil?: Date;
+}
+export interface IngestInput {
+    entity: string;
+    content: string;
+    source: string;
+    confidence: number;
+    agent: string;
+}
+export interface HandshakeInput {
+    agent: string;
+    task: string;
+    recentMessages: string[];
+}
+export interface QueryResult {
+    found: boolean;
+    value?: unknown;
+    summary?: string;
+    confidence?: number;
+    source?: string;
+    validUntil?: Date | null;
+    resolvedEntity?: string;
+    inputEntity?: string;
+}
+export interface WriteResult {
+    action: 'created' | 'updated' | 'escalated' | 'rejected';
+    key: string;
+    reason: string;
+    resolvedEntity?: string;
+    inputEntity?: string;
+}
+export interface IngestResult {
+    written: number;
+    rejected: number;
+    escalated: number;
+    facts: WriteResult[];
+}
+export interface ObserveInput {
+    agent: string;
+    currentContext: string;
+    maxFacts?: number;
+    entityHints?: string[];
+}
+export interface AttendInput extends ObserveInput {
+    latestMessage?: string;
+    forceInject?: boolean;
+}
+export declare class Iranti {
+    private config;
+    constructor(config?: IrantiConfig);
+    write(input: WriteInput): Promise<WriteResult>;
+    ingest(input: IngestInput): Promise<IngestResult>;
+    handshake(input: HandshakeInput): Promise<WorkingMemoryBrief>;
+    reconvene(agentId: string, input: Omit<HandshakeInput, 'agent'>): Promise<WorkingMemoryBrief>;
+    getAttendant(agentId: string): AttendantInstance;
+    query(entity: string, key: string): Promise<QueryResult>;
+    queryAll(entity: string): Promise<Array<{
+        key: string;
+        value: unknown;
+        summary: string;
+        confidence: number;
+        source: string;
+    }>>;
+    runMaintenance(): Promise<{
+        expiredArchived: number;
+        lowConfidenceArchived: number;
+        escalationsProcessed: number;
+        errors: string[];
+    }>;
+    relate(fromEntity: string, relationshipType: string, toEntity: string, options?: {
+        createdBy: string;
+        properties?: Record<string, unknown>;
+    }): Promise<void>;
+    getRelated(entity: string): Promise<RelatedEntity[]>;
+    getRelatedDeep(entity: string, depth?: number): Promise<RelatedEntity[]>;
+    registerAgent(profile: AgentProfile): Promise<void>;
+    getAgent(agentId: string): Promise<AgentRecord | null>;
+    whoKnows(entity: string): Promise<Array<{
+        agentId: string;
+        keys: string[];
+        totalContributions: number;
+    }>>;
+    listAgents(): Promise<AgentProfile[]>;
+    assignToTeam(agentId: string, teamId: string): Promise<void>;
+    observe(input: ObserveInput): Promise<import('../attendant/AttendantInstance').ObserveResult>;
+    attend(input: AttendInput): Promise<AttendResult>;
+    configureMock(config: Partial<MockConfig>): void;
+}
+export default Iranti;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/src/sdk/index.js

@@ -0,0 +1,323 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Iranti = void 0;
+require("dotenv/config");
+const client_1 = require("../library/client");
+const librarian_1 = require("../librarian");
+const registry_1 = require("../attendant/registry");
+const archivist_1 = require("../archivist");
+const queries_1 = require("../library/queries");
+const relationships_1 = require("../library/relationships");
+const agent_registry_1 = require("../library/agent-registry");
+const entity_resolution_1 = require("../library/entity-resolution");
+const mock_1 = require("../lib/providers/mock");
+// ─── Entity Parsing ──────────────────────────────────────────────────────────
+function parseEntity(entity) {
+    if (!entity || typeof entity !== 'string') {
+        throw new Error('Entity must be a non-empty string.');
+    }
+    const raw = entity.trim();
+    if (!raw) {
+        throw new Error('Entity must be a non-empty string.');
+    }
+    const heuristicEntityId = (name) => name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '');
+    if (!raw.includes('/')) {
+        const normalized = heuristicEntityId(raw);
+        if (!normalized) {
+            throw new Error(`Unable to parse entity: "${entity}"`);
+        }
+        const entityId = normalized.startsWith('project_') ? normalized : `project_${normalized}`;
+        return {
+            entityType: 'project',
+            entityId,
+        };
+    }
+    const parts = raw.split('/');
+    if (parts.length < 2 || !parts[0] || !parts[1]) {
+        throw new Error(`Invalid entity format: "${entity}". Expected "entityType/entityId" e.g. "researcher/jane_smith". Neither part can be empty.`);
+    }
+    const entityType = parts[0];
+    const entityId = parts.slice(1).join('/');
+    return { entityType, entityId };
+}
+// ─── Iranti Class ────────────────────────────────────────────────────────────
+class Iranti {
+    constructor(config = {}) {
+        this.config = config;
+        const connectionString = config.connectionString ?? process.env.DATABASE_URL;
+        if (!connectionString) {
+            throw new Error('connectionString is required. Provide it in config or set DATABASE_URL environment variable.');
+        }
+        (0, client_1.initDb)(connectionString);
+        if (config.llmProvider) {
+            process.env.LLM_PROVIDER = config.llmProvider;
+        }
+    }
+    // ── Write ───────────────────────────────────────────────────────────────
+    async write(input) {
+        if (input.confidence < 0 || input.confidence > 100) {
+            throw new Error(`Confidence must be between 0 and 100. Got: ${input.confidence}`);
+        }
+        const { entityType, entityId } = parseEntity(input.entity);
+        const resolved = await (0, entity_resolution_1.resolveEntity)({
+            entityType,
+            entityId,
+            rawName: input.entity,
+            aliases: [input.entity],
+            source: input.source,
+            confidence: input.confidence,
+            createIfMissing: true,
+        });
+        const result = await (0, librarian_1.librarianWrite)({
+            entityType: resolved.entityType,
+            entityId: resolved.entityId,
+            key: input.key,
+            valueRaw: input.value,
+            valueSummary: input.summary,
+            confidence: input.confidence,
+            source: input.source,
+            createdBy: input.agent,
+            validUntil: input.validUntil,
+        });
+        return {
+            action: result.action,
+            key: input.key,
+            reason: result.reason,
+            resolvedEntity: resolved.canonicalEntity,
+            inputEntity: input.entity,
+        };
+    }
+    // ── Ingest ──────────────────────────────────────────────────────────────
+    async ingest(input) {
+        const { entityType, entityId } = parseEntity(input.entity);
+        const result = await (0, librarian_1.librarianIngest)({
+            entityType,
+            entityId,
+            rawContent: input.content,
+            source: input.source,
+            confidence: input.confidence,
+            createdBy: input.agent,
+        });
+        return {
+            written: result.written,
+            rejected: result.rejected,
+            escalated: result.escalated,
+            facts: result.results.map((r) => ({
+                action: r.action,
+                key: r.key,
+                reason: r.reason,
+            })),
+        };
+    }
+    // ── Handshake ───────────────────────────────────────────────────────────
+    async handshake(input) {
+        const attendant = (0, registry_1.getAttendant)(input.agent);
+        return attendant.handshake({
+            task: input.task,
+            recentMessages: input.recentMessages,
+        });
+    }
+    // ── Reconvene ───────────────────────────────────────────────────────────
+    async reconvene(agentId, input) {
+        const attendant = (0, registry_1.getAttendant)(agentId);
+        return attendant.reconvene({
+            task: input.task,
+            recentMessages: input.recentMessages,
+        });
+    }
+    getAttendant(agentId) {
+        return (0, registry_1.getAttendant)(agentId);
+    }
+    // ── Query ───────────────────────────────────────────────────────────────
+    async query(entity, key) {
+        const parsed = parseEntity(entity);
+        const resolved = await (0, entity_resolution_1.resolveEntity)({
+            entityType: parsed.entityType,
+            entityId: parsed.entityId,
+            rawName: entity,
+            aliases: [entity],
+            source: 'query',
+            createIfMissing: false,
+        }).catch(() => ({
+            entityType: parsed.entityType,
+            entityId: parsed.entityId,
+            canonicalEntity: `${parsed.entityType}/${parsed.entityId}`,
+            matchedBy: 'exact',
+            addedAliases: [],
+        }));
+        const entry = await (0, queries_1.findEntry)({ entityType: resolved.entityType, entityId: resolved.entityId, key });
+        if (!entry) {
+            return { found: false, resolvedEntity: resolved.canonicalEntity, inputEntity: entity };
+        }
+        if (entry.isProtected) {
+            return { found: false, resolvedEntity: resolved.canonicalEntity, inputEntity: entity };
+        }
+        // Treat as hidden only when the latest relevant conflict event is an unresolved escalation.
+        // A historical escalation followed by replacement/update should still be queryable.
+        if (entry.conflictLog) {
+            const log = Array.isArray(entry.conflictLog) ? entry.conflictLog : [];
+            const latestEscalationIndex = log.reduce((acc, event, idx) => {
+                return event?.type === 'CONFLICT_ESCALATED' ? idx : acc;
+            }, -1);
+            if (latestEscalationIndex >= 0) {
+                const resolutionTypes = new Set([
+                    'CONFLICT_REPLACED',
+                    'CONFLICT_UPDATED',
+                    'CONFLICT_REJECTED',
+                    'CONFLICT_RESOLVED',
+                    'CONFLICT_HUMAN_RESOLVED',
+                    'HUMAN_RESOLVED',
+                ]);
+                const resolvedAfterEscalation = log
+                    .slice(latestEscalationIndex + 1)
+                    .some((event) => resolutionTypes.has(event?.type));
+                if (!resolvedAfterEscalation) {
+                    return { found: false, resolvedEntity: resolved.canonicalEntity, inputEntity: entity }; // Treat escalated entries as not found
+                }
+            }
+        }
+        return {
+            found: true,
+            value: entry.valueRaw,
+            summary: entry.valueSummary,
+            confidence: entry.confidence,
+            source: entry.source,
+            validUntil: entry.validUntil,
+            resolvedEntity: resolved.canonicalEntity,
+            inputEntity: entity,
+        };
+    }
+    // ── Query All ───────────────────────────────────────────────────────────
+    async queryAll(entity) {
+        const parsed = parseEntity(entity);
+        const resolved = await (0, entity_resolution_1.resolveEntity)({
+            entityType: parsed.entityType,
+            entityId: parsed.entityId,
+            rawName: entity,
+            aliases: [entity],
+            source: 'query',
+            createIfMissing: false,
+        }).catch(() => ({
+            entityType: parsed.entityType,
+            entityId: parsed.entityId,
+            canonicalEntity: `${parsed.entityType}/${parsed.entityId}`,
+            matchedBy: 'exact',
+            addedAliases: [],
+        }));
+        const entries = await (0, queries_1.findEntriesByEntity)(resolved.entityType, resolved.entityId);
+        return entries
+            .filter((e) => !e.isProtected)
+            .map((e) => ({
+            key: e.key,
+            value: e.valueRaw,
+            summary: e.valueSummary,
+            confidence: e.confidence,
+            source: e.source,
+        }));
+    }
+    // ── Maintenance ─────────────────────────────────────────────────────────
+    async runMaintenance() {
+        return (0, archivist_1.runArchivist)();
+    }
+    // ── Relationships ───────────────────────────────────────────────────────
+    async relate(fromEntity, relationshipType, toEntity, options = { createdBy: 'sdk' }) {
+        const from = parseEntity(fromEntity);
+        const to = parseEntity(toEntity);
+        await (0, relationships_1.createRelationship)({
+            fromType: from.entityType,
+            fromId: from.entityId,
+            relationshipType,
+            toType: to.entityType,
+            toId: to.entityId,
+            createdBy: options.createdBy,
+            properties: options.properties,
+        });
+    }
+    async getRelated(entity) {
+        const { entityType, entityId } = parseEntity(entity);
+        return (0, relationships_1.getRelated)(entityType, entityId);
+    }
+    async getRelatedDeep(entity, depth = 2) {
+        const { entityType, entityId } = parseEntity(entity);
+        return (0, relationships_1.getRelatedDeep)(entityType, entityId, depth);
+    }
+    // ── Agent Registry ──────────────────────────────────────────────────────
+    async registerAgent(profile) {
+        return (0, agent_registry_1.registerAgent)(profile);
+    }
+    async getAgent(agentId) {
+        return (0, agent_registry_1.getAgent)(agentId);
+    }
+    async whoKnows(entity) {
+        const { entityType, entityId } = parseEntity(entity);
+        return (0, agent_registry_1.whoKnows)(entityType, entityId);
+    }
+    async listAgents() {
+        return (0, agent_registry_1.listAgents)();
+    }
+    async assignToTeam(agentId, teamId) {
+        return (0, agent_registry_1.assignToTeam)(agentId, teamId, 'sdk');
+    }
+    // ── Context Window Observation ────────────────────────────────────────────
+    async observe(input) {
+        if (!input.agent || typeof input.agent !== 'string' || input.agent.trim().length === 0) {
+            throw new Error('agent is required for observe().');
+        }
+        if (input.entityHints !== undefined) {
+            if (!Array.isArray(input.entityHints)) {
+                throw new Error('entityHints must be an array of "entityType/entityId" strings.');
+            }
+            for (const hint of input.entityHints) {
+                if (typeof hint !== 'string' || hint.trim().length === 0 || !hint.includes('/')) {
+                    throw new Error(`Invalid entity hint: "${String(hint)}". Expected "entityType/entityId".`);
+                }
+                parseEntity(hint);
+            }
+        }
+        const attendant = (0, registry_1.getAttendant)(input.agent);
+        return attendant.observe({
+            currentContext: input.currentContext,
+            maxFacts: input.maxFacts,
+            entityHints: input.entityHints,
+        });
+    }
+    async attend(input) {
+        if (!input.agent || typeof input.agent !== 'string' || input.agent.trim().length === 0) {
+            throw new Error('agent is required for attend().');
+        }
+        if (input.entityHints !== undefined) {
+            if (!Array.isArray(input.entityHints)) {
+                throw new Error('entityHints must be an array of "entityType/entityId" strings.');
+            }
+            for (const hint of input.entityHints) {
+                if (typeof hint !== 'string' || hint.trim().length === 0 || !hint.includes('/')) {
+                    throw new Error(`Invalid entity hint: "${String(hint)}". Expected "entityType/entityId".`);
+                }
+                parseEntity(hint);
+            }
+        }
+        const attendant = (0, registry_1.getAttendant)(input.agent);
+        return attendant.attend({
+            currentContext: input.currentContext,
+            maxFacts: input.maxFacts,
+            entityHints: input.entityHints,
+            latestMessage: input.latestMessage,
+            forceInject: input.forceInject,
+        });
+    }
+    // ── Mock Configuration (dev/test only) ──────────────────────────────────
+    configureMock(config) {
+        if (process.env.LLM_PROVIDER !== 'mock') {
+            console.warn('[iranti] configureMock() called but LLM_PROVIDER is not mock. No effect.');
+            return;
+        }
+        (0, mock_1.configureMock)(config);
+    }
+}
+exports.Iranti = Iranti;
+// ─── Default Export ──────────────────────────────────────────────────────────
+exports.default = Iranti;
+//# sourceMappingURL=index.js.map

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

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

package/dist/src/security/apiKeys.d.ts

@@ -0,0 +1,48 @@
+export interface ApiKeyRecord {
+    keyId: string;
+    owner: string;
+    secretHash: string;
+    scopes: string[];
+    isActive: boolean;
+    createdAt: string;
+    revokedAt?: string | null;
+    description?: string;
+}
+interface ApiKeyRegistry {
+    version: number;
+    keys: ApiKeyRecord[];
+}
+type AuthMode = 'legacy_env' | 'legacy_list' | 'registry';
+export interface ApiKeyValidationResult {
+    ok: boolean;
+    mode?: AuthMode;
+    keyId?: string;
+    owner?: string;
+    scopes?: string[];
+    status?: 401 | 500;
+    error?: string;
+}
+export declare function hashApiKeySecret(secret: string): string;
+export declare function generateApiKeySecret(length?: number): string;
+export declare function formatApiKeyToken(keyId: string, secret: string): string;
+export declare function parseApiKeyToken(token: string): {
+    keyId: string;
+    secret: string;
+} | null;
+export declare function invalidateApiKeyCache(): void;
+export declare function loadApiKeyRegistry(forceRefresh?: boolean): Promise<ApiKeyRegistry>;
+export declare function saveApiKeyRegistry(registry: ApiKeyRegistry): Promise<void>;
+export declare function createOrRotateApiKey(input: {
+    keyId: string;
+    owner: string;
+    scopes?: string[];
+    description?: string;
+}): Promise<{
+    token: string;
+    record: ApiKeyRecord;
+}>;
+export declare function revokeApiKey(keyIdRaw: string): Promise<boolean>;
+export declare function listApiKeys(): Promise<ApiKeyRecord[]>;
+export declare function validateApiKey(providedKey: string | undefined): Promise<ApiKeyValidationResult>;
+export {};
+//# sourceMappingURL=apiKeys.d.ts.map

package/dist/src/security/apiKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiKeys.d.ts","sourceRoot":"","sources":["../../../src/security/apiKeys.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,cAAc;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,KAAK,QAAQ,GAAG,YAAY,GAAG,aAAa,GAAG,UAAU,CAAC;AAE1D,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAaD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM,CAGhE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAWxF;AAgDD,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAED,wBAAsB,kBAAkB,CAAC,YAAY,GAAE,OAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAoB/F;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAgChF;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC,CAkCnD;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYrE;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAK3D;AAED,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAmFrG"}