@popmelt.com/core 0.10.1 → 0.10.2

package/dist/server.d.mts

@@ -48,12 +48,15 @@ type ImprintRelationType = ImprintTopologyRelationType | LegacyImprintRelationTy
 type ImprintRelation = {
     id: string;
     type: ImprintRelationType;
+    /** The source explanation is always owned by this relation's store. */
     fromId: string;
+    /** Omitted for a target in this relation's owning store. */
+    toStoreId?: string;
     toId: string;
     rationale: string;
     createdAt: string;
 };
-type QualifiedImprintRelation = Omit<ImprintRelation, 'fromId' | 'toId'> & {
+type QualifiedImprintRelation = Omit<ImprintRelation, 'fromId' | 'toId' | 'toStoreId'> & {
     from: ImprintExplanationRef;
     to: ImprintExplanationRef;
 };
@@ -144,11 +147,23 @@ type ImprintGroundingAction = 'yes' | 'this_time' | 'no';
 type ImprintContext = {
     explanations: Array<Pick<ImprintExplanation, 'id' | 'kind' | 'statement' | 'rationale' | 'scope' | 'state'> & {
         concrete: Array<Pick<ImprintConcrete, 'id' | 'modelPath' | 'value'>>;
+        /** Internal canonical-memory address; omitted from model-facing prompts. */
+        memoryId?: string;
+        storeId?: string;
+        storeRoot?: string;
+        readOnly?: boolean;
     }>;
     truncated: boolean;
     pendingGroundingExplanationIds?: string[];
     correctionExplanationIds?: string[];
-    relations?: Array<Pick<ImprintRelation, 'id' | 'type' | 'fromId' | 'toId' | 'rationale'>>;
+    relations?: Array<Pick<ImprintRelation, 'id' | 'type' | 'fromId' | 'toId' | 'toStoreId' | 'rationale'> & {
+        /** The store that owns the relation record. */
+        storeId?: string;
+        readOnly?: boolean;
+        /** Present for composed reads; local single-store callers retain fromId/toId. */
+        from?: ImprintExplanationRef;
+        to?: ImprintExplanationRef;
+    }>;
     /** Explicit target/reference language detected in the current request. */
     retrievalIntent?: {
         target: string;
@@ -158,7 +173,13 @@ type ImprintContext = {
      * Directly relevant rejected history. These are warnings, not active
      * explanations, and therefore cannot be cited as Imprint usage.
      */
-    historicalCaveats?: Array<Pick<ImprintExplanation, 'id' | 'kind' | 'statement' | 'rationale' | 'scope' | 'state'>>;
+    historicalCaveats?: Array<Pick<ImprintExplanation, 'id' | 'kind' | 'statement' | 'rationale' | 'scope' | 'state'> & {
+        storeId?: string;
+        storeRoot?: string;
+        readOnly?: boolean;
+    }>;
+    unavailableStoreIds?: string[];
+    unavailableTopologyStoreIds?: string[];
 };
 
 type Provider = 'claude' | 'codex' | 'copilot';
@@ -186,6 +207,17 @@ type PopmeltHandle = {
     close: () => Promise<void>;
 };
 
+type ImprintManifest = {
+    version: 1;
+    topologyVersion?: 2;
+    projectId: string;
+    createdAt: string;
+    updatedAt: string;
+    head: {
+        sequence: number;
+        hash: string | null;
+    };
+};
 type ImprintLoadResult = {
     graph: ImprintGraph;
     transactions: ImprintTransaction[];
@@ -200,6 +232,7 @@ declare class ImprintStore {
     private readonly journalDir;
     private writeChain;
     constructor(projectRoot: string, projectId: string);
+    readHead(): Promise<ImprintManifest['head']>;
     private readManifest;
     private loadRaw;
     load(): Promise<ImprintLoadResult>;
@@ -225,6 +258,9 @@ declare class ImprintStore {
     recover(): Promise<ImprintLoadResult>;
 }
 
+type ProposedExplanationRef = Omit<ImprintExplanationRef, 'storeId'> & {
+    storeId?: string;
+};
 type ProposedMutation = {
     op: 'add';
     clientId?: string;
@@ -248,8 +284,8 @@ type ProposedMutation = {
 } | {
     op: 'relation';
     type: ImprintTopologyRelationType;
-    fromId: string;
-    toId: string;
+    from: ProposedExplanationRef;
+    to: ProposedExplanationRef;
     rationale: string;
 } | {
     op: 'supersede';
@@ -323,6 +359,10 @@ type ImprintCaptureInput = {
     concreteModel?: Record<string, unknown> | null;
     pendingGroundingExplanationIds?: string[];
     applicationOccurred?: boolean;
+    /** The only store this capture is authorized to mutate. */
+    storeId?: string;
+    /** Surfaced mounted-store addresses available for qualified relation targets. */
+    context?: ImprintContext;
 };
 declare function parseImprintDraft(responseText: string, parseContext?: ImprintParseContext): {
     draft?: ImprintDraft;
@@ -336,6 +376,7 @@ declare class ImprintService {
     readonly store: ImprintStore;
     private readonly noopCounts;
     private readonly assessmentFailures;
+    private contextualGraphCache?;
     constructor(projectRoot: string, projectId: string);
     recordNoop(reason: ImprintNoopReason): void;
     recordAssessmentFailure(state: 'missing' | 'invalid'): void;
@@ -343,6 +384,8 @@ declare class ImprintService {
         noopDecisions: Partial<Record<ImprintNoopReason, number>>;
         assessmentFailures: Partial<Record<'missing' | 'invalid', number>>;
     };
+    private contextualGraph;
+    explanationsByIds(ids: string[]): Promise<ImprintContext['explanations']>;
     contextualize(input: {
         text?: string;
         subjectHints?: string[];