@jungjaehoon/mama-core 1.9.0 → 2.0.0

package/dist/decision-formatter.js

@@ -17,11 +17,9 @@ exports.formatContext = formatContext;
 exports.formatLegacyContext = formatLegacyContext;
 exports.ensureTokenBudget = ensureTokenBudget;
 exports.estimateTokens = estimateTokens;
-exports.formatInstantAnswer = formatInstantAnswer;
 exports.extractQuickAnswer = extractQuickAnswer;
 exports.extractCodeExample = extractCodeExample;
 exports.formatTrustContext = formatTrustContext;
-exports.formatTeaser = formatTeaser;
 exports.formatRecall = formatRecall;
 exports.formatList = formatList;
 const relevance_scorer_js_1 = require("./relevance-scorer.js");
@@ -362,42 +360,6 @@ function getOutcomeEmoji(outcome) {
     };
     return outcome ? emojiMap[outcome] || '' : '';
 }
-/**
- * Format context in Claude-friendly Instant Answer format
- *
- * Story 014.7.10: Claude-Friendly Context Formatting
- * AC #1: Instant Answer format with trust components
- */
-function formatInstantAnswer(decision, options = {}) {
-    const { maxTokens = 500 } = options;
-    if (!decision) {
-        return null;
-    }
-    // Extract quick answer (first line of decision)
-    const quickAnswer = extractQuickAnswer(decision);
-    if (!quickAnswer) {
-        return null;
-    }
-    // Extract code example (from reasoning)
-    const codeExample = extractCodeExample(decision);
-    // Format trust context
-    const trustSection = formatTrustContext(typeof decision.trust_context === 'string'
-        ? parseTrustContext(decision.trust_context)
-        : decision.trust_context);
-    // Build output
-    let output = `⚡ INSTANT ANSWER\n\n${quickAnswer}`;
-    if (codeExample) {
-        output += `\n\n${codeExample}`;
-    }
-    if (trustSection) {
-        output += `\n\n${trustSection}`;
-    }
-    // Token budget check
-    if (estimateTokens(output) > maxTokens) {
-        output = truncateToFit(output, maxTokens);
-    }
-    return output;
-}
 /**
  * Extract quick answer from decision
  */
@@ -500,50 +462,6 @@ function formatTrustContext(trustCtx) {
     lines.push('━'.repeat(40));
     return lines.join('\n');
 }
-/**
- * Truncate output to fit token budget
- */
-function truncateToFit(output, maxTokens) {
-    const sections = output.split('\n\n');
-    const quickAnswer = sections[0];
-    let result = quickAnswer;
-    let remainingTokens = maxTokens - estimateTokens(result);
-    // Try to add code example
-    const codeIndex = sections.findIndex((s) => s.startsWith('```'));
-    if (codeIndex > 0) {
-        const codeSection = sections[codeIndex];
-        const codeTokens = estimateTokens(codeSection);
-        if (codeTokens <= remainingTokens) {
-            result += '\n\n' + codeSection;
-            remainingTokens -= codeTokens;
-        }
-    }
-    // Try to add trust section (trimmed if needed)
-    const trustIndex = sections.findIndex((s) => s.startsWith('━'));
-    if (trustIndex > 0 && remainingTokens > 50) {
-        const trustSection = sections[trustIndex];
-        const trustTokens = estimateTokens(trustSection);
-        if (trustTokens <= remainingTokens) {
-            result += '\n\n' + trustSection;
-        }
-        else {
-            const trustLines = trustSection.split('\n');
-            let trimmed = trustLines[0] + '\n' + trustLines[1] + '\n';
-            for (let i = 2; i < trustLines.length - 1; i++) {
-                const line = trustLines[i] + '\n';
-                if (estimateTokens(trimmed + line) <= remainingTokens - 10) {
-                    trimmed += line;
-                }
-                else {
-                    break;
-                }
-            }
-            trimmed += trustLines[trustLines.length - 1];
-            result += '\n\n' + trimmed;
-        }
-    }
-    return result;
-}
 /**
  * Format multiple decisions as Google-style search results
  */
@@ -578,46 +496,6 @@ function formatTeaserList(decisions, topN = 3) {
     }
     return output;
 }
-/**
- * Format decision as curiosity-inducing teaser
- */
-function formatTeaser(decision) {
-    if (!decision) {
-        return null;
-    }
-    const timeAgo = calculateDuration(getDecisionTimestamp(decision));
-    // Extract preview (first 60 chars)
-    const preview = decision.decision.length > 60 ? decision.decision.substring(0, 60) + '...' : decision.decision;
-    // Extract files from trust_context or show generic
-    let files = 'Multiple files';
-    const trustCtx = typeof decision.trust_context === 'string'
-        ? parseTrustContext(decision.trust_context)
-        : decision.trust_context;
-    if (trustCtx?.source?.file) {
-        const fileStr = trustCtx.source.file;
-        const fileList = fileStr.split(',').map((f) => f.trim());
-        if (fileList.length === 1) {
-            files = fileList[0];
-        }
-        else if (fileList.length === 2) {
-            files = fileList.join(', ');
-        }
-        else {
-            files = `${fileList[0]}, ${fileList[1]} (+${fileList.length - 2})`;
-        }
-    }
-    const teaser = `
-💡 MAMA has related info
-
-📚 Topic: ${decision.topic}
-📖 Preview: "${preview}"
-📁 Files: ${files}
-⏰ Updated: ${timeAgo}
-
-🔍 Read more: mama.recall('${decision.topic}')
-  `.trim();
-    return teaser;
-}
 /**
  * Format mama.recall() results in readable format
  */

package/dist/decision-tracker.d.ts

@@ -163,18 +163,6 @@ export declare function createEdgesFromReasoning(fromId: string, reasoning: stri
     created: number;
     failed: number;
 }>;
-/**
- * Get supersedes chain depth for a topic
- *
- * Story 2.2: Calculate how many times a topic has been superseded
- *
- * @param topic - Decision topic
- * @returns Chain depth and decision IDs
- */
-export declare function getSupersededChainDepth(topic: string): Promise<{
-    depth: number;
-    chain: string[];
-}>;
 /**
  * Learn Decision Function (Main API)
  *

package/dist/decision-tracker.js

@@ -25,7 +25,6 @@ exports.calculateCombinedConfidence = calculateCombinedConfidence;
 exports.detectRefinement = detectRefinement;
 exports.parseReasoningForRelationships = parseReasoningForRelationships;
 exports.createEdgesFromReasoning = createEdgesFromReasoning;
-exports.getSupersededChainDepth = getSupersededChainDepth;
 exports.learnDecision = learnDecision;
 exports.updateConfidence = updateConfidence;
 const debug_logger_js_1 = require("./debug-logger.js");
@@ -305,55 +304,6 @@ async function createEdgesFromReasoning(fromId, reasoning) {
     }
     return { created, failed };
 }
-/**
- * Get supersedes chain depth for a topic
- *
- * Story 2.2: Calculate how many times a topic has been superseded
- *
- * @param topic - Decision topic
- * @returns Chain depth and decision IDs
- */
-async function getSupersededChainDepth(topic) {
-    const adapter = (0, memory_store_js_1.getAdapter)();
-    const chain = [];
-    try {
-        // Start from the latest decision (superseded_by IS NULL)
-        let stmt = adapter.prepare(`
-      SELECT id, supersedes FROM decisions
-      WHERE topic = ? AND superseded_by IS NULL
-      ORDER BY created_at DESC
-      LIMIT 1
-    `);
-        let current = stmt.get(topic);
-        if (!current) {
-            return { depth: 0, chain: [] };
-        }
-        chain.push(current.id);
-        // Walk back through supersedes chain with cycle detection
-        const visited = new Set([current.id]);
-        const MAX_CHAIN_DEPTH = 1000; // Safety limit
-        while (current && current.supersedes && chain.length < MAX_CHAIN_DEPTH) {
-            // Cycle detection: stop if we've seen this ID before
-            if (visited.has(current.supersedes)) {
-                break;
-            }
-            stmt = adapter.prepare('SELECT id, supersedes FROM decisions WHERE id = ?');
-            current = stmt.get(current.supersedes);
-            if (current) {
-                visited.add(current.id);
-                chain.push(current.id);
-            }
-        }
-        return {
-            depth: chain.length - 1, // depth = number of supersedes edges
-            chain: chain.reverse(), // oldest to newest
-        };
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new Error(`Failed to get supersedes chain: ${message}`);
-    }
-}
 // ════════════════════════════════════════════════════════════════════════════
 // NOTE: Auto-link functions REMOVED in v1.2.0
 //

package/dist/edges/ref-validation.d.ts

@@ -1,8 +1,7 @@
 import type { DatabaseAdapter } from '../db-manager.js';
-import type { ListVisibleTwinEdgesOptions, TwinEdgeRecord, TwinRef, TwinScopeRef, TwinVisibility } from './types.js';
+import type { ListVisibleTwinEdgesOptions, TwinEdgeRecord, TwinRef, TwinVisibility } from './types.js';
 type TwinRefVisibilityAdapter = Pick<DatabaseAdapter, 'prepare'>;
 export declare function assertTwinRefsVisible(adapter: TwinRefVisibilityAdapter, refs: readonly TwinRef[], visibility?: TwinVisibility): void;
-export declare function assertTwinRefsVisibleToScopes(adapter: TwinRefVisibilityAdapter, refs: readonly TwinRef[], scopes?: TwinScopeRef[]): void;
 export declare function listVisibleTwinEdgesForRefs(adapter: TwinRefVisibilityAdapter, refs: readonly TwinRef[], options?: ListVisibleTwinEdgesOptions): TwinEdgeRecord[];
 export {};
 //# sourceMappingURL=ref-validation.d.ts.map

package/dist/edges/ref-validation.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.assertTwinRefsVisible = assertTwinRefsVisible;
-exports.assertTwinRefsVisibleToScopes = assertTwinRefsVisibleToScopes;
 exports.listVisibleTwinEdgesForRefs = listVisibleTwinEdgesForRefs;
 const store_js_1 = require("./store.js");
+const channel_grant_js_1 = require("../context-compile/channel-grant.js");
 const TABLE_COLUMN_PRAGMAS = {
     decisions: 'PRAGMA table_info(decisions)',
     case_truth: 'PRAGMA table_info(case_truth)',
@@ -21,9 +21,6 @@ function hasScopes(scopes) {
 function hasProjectRefs(projectRefs) {
     return Array.isArray(projectRefs) && projectRefs.length > 0;
 }
-function visibilityFromScopes(scopes) {
-    return { scopes: scopes ? [...scopes] : undefined };
-}
 function asOfMs(visibility) {
     return typeof visibility.asOfMs === 'number' ? visibility.asOfMs : null;
 }
@@ -177,6 +174,30 @@ function isCaseVisible(adapter, id, visibility) {
     }
     return false;
 }
+/**
+ * The time bound, shared by both branches so a grant cannot skip it.
+ *
+ * DELIBERATELY STRICTER THAN THE READER, and a review flagged the difference as a
+ * divergence between two delegates of one rule. It is not. A row with no usable timestamp
+ * is refused here even when no bound is set, while the reader - whose clause is on
+ * `COALESCE(event_datetime, source_timestamp_ms)` - leaves such a row alone when there is
+ * no bound to apply.
+ *
+ * The direction is what makes it correct: this gate guards refs reached INDIRECTLY, through
+ * a seed the caller named or an edge the graph walked. Refusing what cannot be shown to sit
+ * inside any window keeps the indirect path no wider than the direct one, which is the
+ * invariant the whole design rests on. Relaxing it to match the reader would have made
+ * citation reach further than reading for exactly the rows whose position in time is
+ * unknown. `fails closed for raw endpoints with blank timestamps` states the intent.
+ */
+function isRawWithinTime(row, visibility) {
+    const rawTs = row.event_datetime ?? row.source_timestamp_ms;
+    if (rawTs === null || rawTs === undefined || (typeof rawTs === 'string' && rawTs.trim() === '')) {
+        return false;
+    }
+    const eventTsMs = parseTimestamp(rawTs);
+    return eventTsMs !== null && eventTsMs >= 0 && isWithinVisibilityTime(eventTsMs, visibility);
+}
 function isRawVisible(adapter, id, visibility) {
     const row = adapter
         .prepare('SELECT * FROM connector_event_index WHERE event_index_id = ? LIMIT 1')
@@ -188,6 +209,13 @@ function isRawVisible(adapter, id, visibility) {
         !visibility.connectors.includes(String(row.source_connector))) {
         return false;
     }
+    // The grant decides, and it decides the same way here as in the reader - one rule, taken
+    // from one place. The scope/project/tenant clauses below are the pre-grant rule and are
+    // skipped when a grant is present, exactly as the reader skips them, because applying
+    // both would make a cited ref satisfy a stricter test than a read one.
+    if (visibility.channels) {
+        return ((0, channel_grant_js_1.isChannelGranted)(String(row.source_connector), typeof row.channel === 'string' ? row.channel : null, visibility.channels) && isRawWithinTime(row, visibility));
+    }
     if (hasProjectRefs(visibility.projectRefs) &&
         !visibility.projectRefs.some((project) => project.id === row.project_id)) {
         return false;
@@ -197,12 +225,7 @@ function isRawVisible(adapter, id, visibility) {
         row.tenant_id !== visibility.tenantId) {
         return false;
     }
-    const rawTs = row.event_datetime ?? row.source_timestamp_ms;
-    if (rawTs === null || rawTs === undefined || (typeof rawTs === 'string' && rawTs.trim() === '')) {
-        return false;
-    }
-    const eventTsMs = parseTimestamp(rawTs);
-    if (eventTsMs === null || eventTsMs < 0 || !isWithinVisibilityTime(eventTsMs, visibility)) {
+    if (!isRawWithinTime(row, visibility)) {
         return false;
     }
     if (!hasScopes(visibility.scopes)) {
@@ -269,9 +292,6 @@ function assertTwinRefsVisible(adapter, refs, visibility = {}) {
         }
     }
 }
-function assertTwinRefsVisibleToScopes(adapter, refs, scopes) {
-    assertTwinRefsVisible(adapter, refs, visibilityFromScopes(scopes));
-}
 function listVisibleTwinEdgesForRefs(adapter, refs, options = {}) {
     const edgeCache = new Map();
     const edgeTypes = normalizeEdgeTypes(options.edgeTypes);

package/dist/edges/store.d.ts

@@ -1,10 +1,8 @@
 import type { DatabaseAdapter } from '../db-manager.js';
-import { type InsertTwinEdgeInput, type TwinEdgeRecord, type TwinRef } from './types.js';
+import { type TwinEdgeRecord, type TwinRef } from './types.js';
 type TwinEdgeReadAdapter = Pick<DatabaseAdapter, 'prepare'>;
-type TwinEdgeAdapter = Pick<DatabaseAdapter, 'prepare' | 'transaction'>;
 export declare function mapTwinEdgeRow(row: Record<string, unknown>): TwinEdgeRecord;
 export declare function getTwinEdge(adapter: TwinEdgeReadAdapter, edgeId: string): TwinEdgeRecord | null;
 export declare function listTwinEdgesForRefs(adapter: TwinEdgeReadAdapter, refs: readonly TwinRef[]): TwinEdgeRecord[];
-export declare function insertTwinEdge(adapter: TwinEdgeAdapter, input: InsertTwinEdgeInput): TwinEdgeRecord;
 export {};
 //# sourceMappingURL=store.d.ts.map

package/dist/edges/store.js

@@ -3,31 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.mapTwinEdgeRow = mapTwinEdgeRow;
 exports.getTwinEdge = getTwinEdge;
 exports.listTwinEdgesForRefs = listTwinEdgesForRefs;
-exports.insertTwinEdge = insertTwinEdge;
-const node_crypto_1 = require("node:crypto");
-const canonicalize_js_1 = require("../canonicalize.js");
 const types_js_1 = require("./types.js");
 const EDGE_TYPE_SET = new Set(types_js_1.TWIN_EDGE_TYPES);
 const REF_KIND_SET = new Set(types_js_1.TWIN_REF_KINDS);
 const SOURCE_SET = new Set(types_js_1.TWIN_EDGE_SOURCES);
-const HUMAN_ACTOR_ROLES = new Set(['commander', 'configurator_elevated']);
-const HUMAN_REASON_CLASSIFICATIONS = new Set([
-    'factual_correction',
-    'agent_inference_wrong',
-    'privacy_redaction',
-    'duplicate_merge',
-    'state_override',
-    'other',
-]);
-function sha256Hex(input) {
-    return (0, node_crypto_1.createHash)('sha256').update(input, 'utf8').digest('hex');
-}
-function sha256Buffer(input) {
-    return (0, node_crypto_1.createHash)('sha256').update(input, 'utf8').digest();
-}
-function generatedEdgeId() {
-    return `edge_${(0, node_crypto_1.randomUUID)().replace(/-/g, '')}`;
-}
 function nullableString(value) {
     return typeof value === 'string' && value.length > 0 ? value : null;
 }
@@ -61,68 +40,6 @@ function normalizeRef(ref, field) {
         id: requireNonEmptyString(ref.id, `${field}.id`),
     };
 }
-function assertSubjectKindAllowed(ref) {
-    if (ref.kind === 'raw') {
-        throw new Error('twin_edges.subject_ref.kind cannot be raw');
-    }
-}
-function normalizeConfidence(value) {
-    if (value === undefined || value === null) {
-        return 1;
-    }
-    if (typeof value === 'number' && Number.isFinite(value) && value >= 0 && value <= 1) {
-        return value;
-    }
-    throw new Error(`twin_edges.confidence must be between 0 and 1: ${String(value)}`);
-}
-function hasDeterministicRule(value) {
-    return (value !== null &&
-        typeof value === 'object' &&
-        !Array.isArray(value) &&
-        typeof value.deterministic_rule === 'string' &&
-        value.deterministic_rule.length > 0);
-}
-function validateSourceMetadata(input, source) {
-    if (source === 'agent') {
-        requireNonEmptyString(input.agent_id, 'agent_id');
-        requireNonEmptyString(input.model_run_id, 'model_run_id');
-        requireNonEmptyString(input.envelope_hash, 'envelope_hash');
-        return;
-    }
-    if (source === 'human') {
-        requireNonEmptyString(input.human_actor_id, 'human_actor_id');
-        const role = requireNonEmptyString(input.human_actor_role, 'human_actor_role');
-        if (!HUMAN_ACTOR_ROLES.has(role)) {
-            throw new Error(`Unsupported twin_edges.human_actor_role: ${role}`);
-        }
-        if (input.authority_scope_json === undefined || input.authority_scope_json === null) {
-            throw new Error('twin_edges.authority_scope_json is required for human edges');
-        }
-        const classification = requireNonEmptyString(input.reason_classification, 'reason_classification');
-        if (!HUMAN_REASON_CLASSIFICATIONS.has(classification)) {
-            throw new Error(`Unsupported twin_edges.reason_classification: ${classification}`);
-        }
-        return;
-    }
-    if (!nullableString(input.reason_text) && !hasDeterministicRule(input.relation_attrs)) {
-        throw new Error('twin_edges.reason_text or relation_attrs.deterministic_rule is required for code edges');
-    }
-}
-function jsonField(value, field) {
-    if (value === undefined || value === null) {
-        return null;
-    }
-    try {
-        if (typeof value === 'string') {
-            return (0, canonicalize_js_1.canonicalizeJSON)(JSON.parse(value));
-        }
-        return (0, canonicalize_js_1.canonicalizeJSON)(value);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        throw new Error(`Invalid twin_edges.${field}: ${message}`);
-    }
-}
 function parseJsonField(value, field, edgeId) {
     if (value === null || value === undefined) {
         return null;
@@ -148,62 +65,6 @@ function toBuffer(value) {
     }
     throw new Error('twin_edges.content_hash must be a 32-byte Buffer');
 }
-function exists(adapter, table, column, id) {
-    const row = adapter
-        .prepare(`SELECT 1 AS ok FROM ${table} WHERE ${column} = ? LIMIT 1`)
-        .get(id);
-    return Boolean(row?.ok);
-}
-function validateRefExists(adapter, ref, field) {
-    if (ref.kind === 'report') {
-        throw new Error(`${field} ${ref.kind}:${ref.id} is not supported by twin_edges yet`);
-    }
-    const found = (ref.kind === 'memory' && exists(adapter, 'decisions', 'id', ref.id)) ||
-        (ref.kind === 'case' && exists(adapter, 'case_truth', 'case_id', ref.id)) ||
-        (ref.kind === 'entity' && exists(adapter, 'entity_nodes', 'id', ref.id)) ||
-        (ref.kind === 'edge' && exists(adapter, 'twin_edges', 'edge_id', ref.id)) ||
-        (ref.kind === 'raw' && exists(adapter, 'connector_event_index', 'event_index_id', ref.id));
-    if (!found) {
-        throw new Error(`${field} not found: ${ref.kind}:${ref.id}`);
-    }
-}
-function contentHashInput(input) {
-    return (0, canonicalize_js_1.canonicalizeJSON)(input);
-}
-function deriveEdgeIdempotencyKey(requestIdempotencyKey, contentHash) {
-    return `reqedge_${sha256Hex((0, canonicalize_js_1.canonicalizeJSON)({
-        request_idempotency_key: requestIdempotencyKey,
-        content_hash: contentHash.toString('hex'),
-    })).slice(0, 40)}`;
-}
-function selectByIdempotency(adapter, modelRunId, edgeIdempotencyKey) {
-    if (!edgeIdempotencyKey) {
-        return null;
-    }
-    if (!modelRunId) {
-        const row = adapter
-            .prepare(`
-          SELECT *
-          FROM twin_edges
-          WHERE model_run_id IS NULL
-            AND edge_idempotency_key = ?
-          ORDER BY created_at ASC, edge_id ASC
-          LIMIT 1
-        `)
-            .get(edgeIdempotencyKey);
-        return row ? mapTwinEdgeRow(row) : null;
-    }
-    const row = adapter
-        .prepare(`
-        SELECT *
-        FROM twin_edges
-        WHERE model_run_id = ?
-          AND edge_idempotency_key = ?
-        LIMIT 1
-      `)
-        .get(modelRunId, edgeIdempotencyKey);
-    return row ? mapTwinEdgeRow(row) : null;
-}
 function mapTwinEdgeRow(row) {
     const edgeId = String(row.edge_id);
     return {
@@ -265,79 +126,4 @@ function listTwinEdgesForRefs(adapter, refs) {
         .all(...params);
     return rows.map(mapTwinEdgeRow);
 }
-function insertTwinEdge(adapter, input) {
-    const edgeType = normalizeEdgeType(input.edge_type);
-    const subjectRef = normalizeRef(input.subject_ref, 'subject_ref');
-    const objectRef = normalizeRef(input.object_ref, 'object_ref');
-    assertSubjectKindAllowed(subjectRef);
-    const source = normalizeSource(input.source);
-    const confidence = normalizeConfidence(input.confidence);
-    validateSourceMetadata(input, source);
-    validateRefExists(adapter, subjectRef, 'subject_ref');
-    validateRefExists(adapter, objectRef, 'object_ref');
-    const relationAttrsJson = jsonField(input.relation_attrs, 'relation_attrs_json');
-    const evidenceRefsJson = jsonField(input.evidence_refs, 'evidence_refs_json');
-    const authorityScopeJson = jsonField(input.authority_scope_json, 'authority_scope_json');
-    const agentId = nullableString(input.agent_id);
-    const reasonText = nullableString(input.reason_text);
-    const envelopeHash = nullableString(input.envelope_hash);
-    const humanActorId = nullableString(input.human_actor_id);
-    const humanActorRole = nullableString(input.human_actor_role);
-    const reasonClassification = nullableString(input.reason_classification);
-    const requestIdempotencyKey = nullableString(input.request_idempotency_key);
-    const modelRunId = nullableString(input.model_run_id);
-    const contentHash = sha256Buffer(contentHashInput({
-        edge_type: edgeType,
-        subject_ref: subjectRef,
-        object_ref: objectRef,
-        relation_attrs_json: relationAttrsJson,
-        confidence,
-        source,
-        agent_id: agentId,
-        model_run_id: modelRunId,
-        envelope_hash: envelopeHash,
-        human_actor_id: humanActorId,
-        human_actor_role: humanActorRole,
-        authority_scope_json: authorityScopeJson,
-        reason_classification: reasonClassification,
-        reason_text: reasonText,
-        evidence_refs_json: evidenceRefsJson,
-    }));
-    const edgeIdempotencyKey = nullableString(input.edge_idempotency_key) ??
-        (requestIdempotencyKey ? deriveEdgeIdempotencyKey(requestIdempotencyKey, contentHash) : null);
-    const existing = selectByIdempotency(adapter, modelRunId, edgeIdempotencyKey);
-    if (existing) {
-        return existing;
-    }
-    const edgeId = nullableString(input.edge_id) ?? generatedEdgeId();
-    const createdAt = Date.now();
-    try {
-        return adapter.transaction(() => {
-            adapter
-                .prepare(`
-            INSERT INTO twin_edges (
-              edge_id, edge_type, subject_kind, subject_id, object_kind, object_id,
-              relation_attrs_json, confidence, source, agent_id, model_run_id, envelope_hash,
-              human_actor_id, human_actor_role, authority_scope_json, reason_classification,
-              reason_text, evidence_refs_json, request_idempotency_key, edge_idempotency_key,
-              content_hash, created_at
-            )
-            VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-          `)
-                .run(edgeId, edgeType, subjectRef.kind, subjectRef.id, objectRef.kind, objectRef.id, relationAttrsJson, confidence, source, agentId, modelRunId, envelopeHash, humanActorId, humanActorRole, authorityScopeJson, reasonClassification, reasonText, evidenceRefsJson, requestIdempotencyKey, edgeIdempotencyKey, contentHash, createdAt);
-            const inserted = getTwinEdge(adapter, edgeId);
-            if (!inserted) {
-                throw new Error(`Failed to load inserted twin edge: ${edgeId}`);
-            }
-            return inserted;
-        });
-    }
-    catch (error) {
-        const duplicate = selectByIdempotency(adapter, modelRunId, edgeIdempotencyKey);
-        if (duplicate) {
-            return duplicate;
-        }
-        throw error;
-    }
-}
 //# sourceMappingURL=store.js.map

package/dist/edges/types.d.ts

@@ -29,6 +29,13 @@ export interface TwinVisibility {
     tenantId?: string | null;
     startMs?: number | null;
     asOfMs?: number | null;
+    /**
+     * Which channels of each connector may be read. When present it DECIDES raw visibility
+     * here exactly as it does in the reader, so a ref reached through an edge or named as a
+     * seed satisfies the same rule as a row the reader would have returned. Without it a
+     * caller could reach past the read path by citing what it could not have read.
+     */
+    channels?: Record<string, readonly string[]>;
 }
 export interface InsertTwinEdgeInput {
     edge_id?: string;
@@ -84,5 +91,8 @@ export interface ListVisibleTwinEdgesOptions {
     startMs?: number | null;
     asOfMs?: number | null;
     limit?: number;
+    /** Forwarded to the raw visibility rule. Declared so an injected implementation
+     * cannot silently drop the grant - it crossed this seam as an undeclared property. */
+    channels?: Record<string, readonly string[]>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/embedding-client.d.ts

@@ -11,7 +11,6 @@
  *
  * @module embedding-client
  */
-import type { EmbeddingRole } from './embeddings.js';
 export declare const DEFAULT_PORT: number;
 export declare const HOST = "127.0.0.1";
 export declare const TIMEOUT_MS = 500;
@@ -26,20 +25,4 @@ export interface ServerStatus {
  * Get server port from port file or default
  */
 export declare function getServerPort(): number;
-/**
- * Check if embedding server is running
- */
-export declare function isServerRunning(): Promise<boolean>;
-/**
- * Generate embedding via HTTP server
- *
- * @param text - Text to embed
- * @param role - e5 role: 'passage' (default, stored text) or 'query' (search)
- * @returns Embedding or null if failed
- */
-export declare function getEmbeddingFromServer(text: string, role?: EmbeddingRole): Promise<Float32Array | null>;
-/**
- * Get server status
- */
-export declare function getServerStatus(): Promise<ServerStatus | null>;
 //# sourceMappingURL=embedding-client.d.ts.map