@kybernesis/brain-core 0.1.0

package/dist/claude-call.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Brain LLM-call shim — port of KAD's claude-call.ts.
+ *
+ * Provides the single `callClaude` / `callClaudeJSON` interface used by
+ * fact-extractor, fact-contradiction, relationship-extractor, and the sleep
+ * pipeline. The provider is injectable for tests (ADR-0009):
+ *
+ *   setLLMProvider(makeLLMStub({ '*': '[]' }));  // in tests
+ *   setLLMProvider(createSubprocessProvider());   // at app startup
+ *   resetLLMProvider();                           // in afterEach
+ */
+export interface ClaudeCallOpts {
+    model?: string;
+    maxTokens?: number;
+    system?: string;
+    [key: string]: unknown;
+}
+export interface LLMProvider {
+    call(prompt: string, opts?: ClaudeCallOpts): Promise<string | null>;
+}
+export declare function setLLMProvider(p: LLMProvider): void;
+export declare function resetLLMProvider(): void;
+/** Returns true when a provider is wired in. */
+export declare function llmAvailable(): boolean;
+/**
+ * One-shot LLM call — returns full text or null on any failure.
+ * Callers must treat null as "best-effort unavailable" and degrade gracefully.
+ * Default model: haiku. Default maxTokens: 1024.
+ */
+export declare function callClaude(prompt: string, opts?: ClaudeCallOpts): Promise<string | null>;
+/**
+ * Like `callClaude` but parses JSON from the response using a provided
+ * validator. Returns null if the LLM returns null, the JSON is missing,
+ * or validation fails.
+ */
+export declare function callClaudeJSON<T>(prompt: string, validate: (raw: unknown) => T | null, opts?: ClaudeCallOpts): Promise<T | null>;
+//# sourceMappingURL=claude-call.d.ts.map

package/dist/claude-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-call.d.ts","sourceRoot":"","sources":["../src/claude-call.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACrE;AAKD,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,CAAmB;AACvE,wBAAgB,gBAAgB,IAAI,IAAI,CAAsB;AAE9D,gDAAgD;AAChD,wBAAgB,YAAY,IAAI,OAAO,CAA+B;AAEtE;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQlG;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,GAAG,IAAI,EACpC,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAcnB"}

package/dist/claude-call.js

@@ -0,0 +1,55 @@
+/**
+ * Brain LLM-call shim — port of KAD's claude-call.ts.
+ *
+ * Provides the single `callClaude` / `callClaudeJSON` interface used by
+ * fact-extractor, fact-contradiction, relationship-extractor, and the sleep
+ * pipeline. The provider is injectable for tests (ADR-0009):
+ *
+ *   setLLMProvider(makeLLMStub({ '*': '[]' }));  // in tests
+ *   setLLMProvider(createSubprocessProvider());   // at app startup
+ *   resetLLMProvider();                           // in afterEach
+ */
+// Module-level injectable provider (ADR-0009)
+let _provider = null;
+export function setLLMProvider(p) { _provider = p; }
+export function resetLLMProvider() { _provider = null; }
+/** Returns true when a provider is wired in. */
+export function llmAvailable() { return _provider !== null; }
+/**
+ * One-shot LLM call — returns full text or null on any failure.
+ * Callers must treat null as "best-effort unavailable" and degrade gracefully.
+ * Default model: haiku. Default maxTokens: 1024.
+ */
+export async function callClaude(prompt, opts = {}) {
+    if (!_provider)
+        return null;
+    try {
+        return await _provider.call(prompt, opts);
+    }
+    catch (err) {
+        console.warn('[brain-core/claude-call] callClaude threw', { err: String(err) });
+        return null;
+    }
+}
+/**
+ * Like `callClaude` but parses JSON from the response using a provided
+ * validator. Returns null if the LLM returns null, the JSON is missing,
+ * or validation fails.
+ */
+export async function callClaudeJSON(prompt, validate, opts = {}) {
+    const response = await callClaude(prompt, opts);
+    if (!response)
+        return null;
+    // Extract first JSON object or array from the response
+    const match = response.match(/(\{[\s\S]*\}|\[[\s\S]*\])/);
+    if (!match)
+        return null;
+    try {
+        const parsed = JSON.parse(match[0]);
+        return validate(parsed);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=claude-call.js.map

package/dist/claude-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-call.js","sourceRoot":"","sources":["../src/claude-call.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH,8CAA8C;AAC9C,IAAI,SAAS,GAAuB,IAAI,CAAC;AAEzC,MAAM,UAAU,cAAc,CAAC,CAAc,IAAU,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;AACvE,MAAM,UAAU,gBAAgB,KAAW,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC;AAE9D,gDAAgD;AAChD,MAAM,UAAU,YAAY,KAAc,OAAO,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC;AAEtE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAc,EAAE,OAAuB,EAAE;IACxE,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,2CAA2C,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,QAAoC,EACpC,OAAuB,EAAE;IAEzB,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,uDAAuD;IACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/entity-graph.d.ts

@@ -0,0 +1,79 @@
+import type { TenantContext, EntityType, RelationshipType, Entity, EntityMention, EntityInsight, InsightType, Contradiction } from '@kybernesis/brain-contracts';
+export declare function findOrCreateEntity(t: TenantContext, name: string, type: EntityType, timestamp: string): Promise<Entity>;
+export declare function addEntityAlias(t: TenantContext, entityId: number, alias: string): Promise<void>;
+export declare function addEntityMention(t: TenantContext, entityId: number, conversationId: string, sourcePath: string, context: string, timestamp: string, sourceType?: string, confidence?: number): Promise<void>;
+export declare function linkEntities(t: TenantContext, sourceId: number, targetId: number, relationship?: RelationshipType): Promise<void>;
+export declare function linkEntitiesWithType(t: TenantContext, sourceId: number, targetId: number, options: {
+    relationship: RelationshipType;
+    confidence?: number;
+    rationale?: string;
+    method?: string;
+}): Promise<void>;
+export declare function getTypedRelationships(t: TenantContext, entityId: number): Promise<Array<{
+    entity: Entity;
+    relationship: RelationshipType;
+    direction: 'outgoing' | 'incoming';
+    confidence: number;
+    rationale?: string;
+}>>;
+export interface ConversationEntity {
+    type: EntityType;
+    name: string;
+    context?: string;
+}
+export declare function linkEntitiesFromConversation(t: TenantContext, conversationId: string, sourcePath: string, timestamp: string, entities: ConversationEntity[]): Promise<void>;
+export declare function getEntityContext(t: TenantContext, nameOrId: string | number): Promise<{
+    entity: Entity;
+    mentions: EntityMention[];
+    relatedEntities: Array<{
+        entity: Entity;
+        relationship: string;
+        strength: number;
+    }>;
+} | null>;
+export declare function searchEntities(t: TenantContext, query: string, options?: {
+    type?: EntityType;
+    limit?: number;
+}): Promise<Entity[]>;
+export declare function getRecentEntities(t: TenantContext, limit?: number): Promise<Entity[]>;
+export declare function getMostMentionedEntities(t: TenantContext, options?: {
+    type?: EntityType;
+    limit?: number;
+}): Promise<Entity[]>;
+export declare function getEntityGraphStats(t: TenantContext): Promise<{
+    totalEntities: number;
+    totalMentions: number;
+    totalRelations: number;
+    byType: Record<EntityType, number>;
+}>;
+export declare function detectEntitiesInQuery(t: TenantContext, query: string): Promise<{
+    entities: string[];
+    remainingQuery: string;
+}>;
+export declare function mergeEntities(t: TenantContext, keepId: number, removeId: number, reason: string, confidence?: number, aiRationale?: string, mergedBy?: string): Promise<{
+    mentionsMoved: number;
+    relationsMoved: number;
+}>;
+export declare function deleteEntity(t: TenantContext, entityId: number, reason: string, mergedBy?: string): Promise<void>;
+export declare function getEntityProfile(t: TenantContext, entityId: number): Promise<{
+    profile: string;
+    generatedAt: string;
+    factCount: number;
+} | null>;
+export declare function saveEntityProfile(t: TenantContext, entityId: number, profile: string, factCount: number): Promise<void>;
+export declare function createContradiction(t: TenantContext, entityId: number, factAId: number, factBId: number, factA: string, factB: string, description: string): Promise<number>;
+export declare function getOpenContradictions(t: TenantContext, entityId: number): Promise<Contradiction[]>;
+export declare function resolveContradiction(t: TenantContext, contradictionId: number, resolvedBy: string): Promise<void>;
+export declare function applyContradictions(t: TenantContext, entityId: number, factIds: number[]): Promise<void>;
+export declare function saveEntityInsight(t: TenantContext, entityId: number, insightType: InsightType, insight: string, reasoning: string, confidence: number, sourceEntityIds?: number[], expiresAt?: string): Promise<number>;
+export declare function getEntityInsights(t: TenantContext, entityId: number, minConfidence?: number): Promise<EntityInsight[]>;
+export declare function markInsightsStale(t: TenantContext, entityId: number): Promise<void>;
+export declare function getEntitiesForReasoning(t: TenantContext, limit?: number, staleDays?: number, recencyDays?: number): Promise<Array<{
+    id: number;
+    name: string;
+    type: string;
+}>>;
+export declare function markEntityReasoned(t: TenantContext, entityId: number): Promise<void>;
+export declare function pinEntity(t: TenantContext, entityId: number, pinned?: boolean): Promise<void>;
+export declare function listPinned(t: TenantContext, type?: EntityType): Promise<Entity[]>;
+//# sourceMappingURL=entity-graph.d.ts.map

package/dist/entity-graph.d.ts.map

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