omp-fabric 0.85.0

package/dist/lifecycle/broker.d.ts

@@ -0,0 +1,30 @@
+import { MeshStore, type MeshIdentity } from "../mesh/store.js";
+import type { FabricParticipantSource } from "../topology/types.js";
+import { type FabricLifecycleEvent, type FabricLifecyclePublishRequest, type FabricLifecycleSubscription, type FabricLifecycleSubscriptionRequest } from "./types.js";
+export interface LifecycleBrokerOptions {
+    enabled: boolean;
+    pollMs: number;
+    maxReadEvents: number;
+}
+export type FabricLifecycleDeliveryHandler = (subscription: FabricLifecycleSubscription, event: FabricLifecycleEvent) => Promise<void> | void;
+export declare class LifecycleBroker {
+    #private;
+    readonly mesh: MeshStore;
+    readonly identity: MeshIdentity;
+    readonly participants: FabricParticipantSource;
+    readonly options: LifecycleBrokerOptions;
+    readonly deliver: FabricLifecycleDeliveryHandler;
+    constructor(mesh: MeshStore, identity: MeshIdentity, participants: FabricParticipantSource, options: LifecycleBrokerOptions, deliver: FabricLifecycleDeliveryHandler);
+    start(): void;
+    publish(request: FabricLifecyclePublishRequest): Promise<FabricLifecycleEvent | undefined>;
+    subscribe(request: FabricLifecycleSubscriptionRequest): Promise<FabricLifecycleSubscription>;
+    list(input?: {
+        from?: string;
+        to?: string;
+    }): FabricLifecycleSubscription[];
+    unsubscribe(id: string): Promise<{
+        removed: boolean;
+    }>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=broker.d.ts.map

package/dist/lifecycle/broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../src/lifecycle/broker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,KAAK,YAAY,EAAuB,MAAM,kBAAkB,CAAC;AACrF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAML,KAAK,oBAAoB,EACzB,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,EAChC,KAAK,kCAAkC,EACxC,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,8BAA8B,GAAG,CAC3C,YAAY,EAAE,2BAA2B,EACzC,KAAK,EAAE,oBAAoB,KACxB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAK1B,qBAAa,eAAe;;IAUxB,QAAQ,CAAC,IAAI,EAAE,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,YAAY;IAC/B,QAAQ,CAAC,YAAY,EAAE,uBAAuB;IAC9C,QAAQ,CAAC,OAAO,EAAE,sBAAsB;IACxC,QAAQ,CAAC,OAAO,EAAE,8BAA8B;gBAJvC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,YAAY,EACtB,YAAY,EAAE,uBAAuB,EACrC,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,8BAA8B;IAMlD,KAAK,IAAI,IAAI;IAQb,OAAO,CACL,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;IAgCtC,SAAS,CACb,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,2BAA2B,CAAC;IAkDvC,IAAI,CAAC,KAAK,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,2BAA2B,EAAE;IAYzE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAQtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAoK7B"}

package/dist/lifecycle/delivery-scheduler.d.ts

@@ -0,0 +1,30 @@
+import type { FabricLifecycleEvent, FabricLifecycleSubscription } from "./types.js";
+export interface PendingLifecycleDelivery {
+    subscription: FabricLifecycleSubscription;
+    event: FabricLifecycleEvent;
+}
+export type LifecycleBatchDispatcher = (target: string, batch: PendingLifecycleDelivery[]) => Promise<void>;
+export type LifecycleDeliveryErrorHandler = (target: string, batch: PendingLifecycleDelivery[], error: unknown) => void;
+export declare const DEFAULT_LIFECYCLE_COALESCE_MS = 2000;
+/**
+ * Coalesce lifecycle deliveries per target so a burst of run completions
+ * wakes the orchestrator once instead of once per event (#85).
+ *
+ * Each wake turn costs the orchestrator a full agent run; without coalescing,
+ * a fan-out of N completed runs serializes into N runs and later events land
+ * many minutes after their occurredAt. followUp deliveries for the same
+ * target inside the coalescing window are batched into one message; steer
+ * deliveries pass through immediately because they interrupt the current
+ * run and must not be delayed.
+ */
+export declare class LifecycleDeliveryScheduler {
+    #private;
+    readonly deliver: LifecycleBatchDispatcher;
+    readonly onError: LifecycleDeliveryErrorHandler;
+    constructor(coalesceMs: number, deliver: LifecycleBatchDispatcher, onError?: LifecycleDeliveryErrorHandler);
+    schedule(target: string, delivery: PendingLifecycleDelivery): void;
+    flush(target: string): Promise<void>;
+    flushAll(): Promise<void>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=delivery-scheduler.d.ts.map

package/dist/lifecycle/delivery-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-scheduler.d.ts","sourceRoot":"","sources":["../../src/lifecycle/delivery-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAEpF,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,2BAA2B,CAAC;IAC1C,KAAK,EAAE,oBAAoB,CAAC;CAC7B;AAED,MAAM,MAAM,wBAAwB,GAAG,CACrC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,wBAAwB,EAAE,KAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,MAAM,6BAA6B,GAAG,CAC1C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,wBAAwB,EAAE,EACjC,KAAK,EAAE,OAAO,KACX,IAAI,CAAC;AAEV,eAAO,MAAM,6BAA6B,OAAQ,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,qBAAa,0BAA0B;;IASnC,QAAQ,CAAC,OAAO,EAAE,wBAAwB;IAC1C,QAAQ,CAAC,OAAO,EAAE,6BAA6B;gBAF/C,UAAU,EAAE,MAAM,EACT,OAAO,EAAE,wBAAwB,EACjC,OAAO,GAAE,6BAAwC;IAK5D,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,wBAAwB,GAAG,IAAI;IAe5D,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA0B/B"}

package/dist/lifecycle/types.d.ts

@@ -0,0 +1,91 @@
+import type { FabricAgentRunner } from "../config.js";
+import type { MeshEvent, MeshIdentity } from "../mesh/store.js";
+import type { FabricParticipantKind } from "../topology/types.js";
+export declare const FABRIC_PARTICIPANT_LIFECYCLE_TOPIC = "fabric.participant.lifecycle";
+export declare const FABRIC_LIFECYCLE_SUBSCRIPTION_PREFIX = "topology/subscriptions/";
+export declare const FABRIC_LIFECYCLE_EVENTS: readonly ["omp.input", "omp.agent_start", "omp.agent_end", "omp.turn_end", "omp.tool_error", "omp.session_compact", "run.completed", "run.failed", "run.stopped", "run.timed_out", "tokens.usage", "component.state"];
+export type FabricLifecycleEventType = (typeof FABRIC_LIFECYCLE_EVENTS)[number];
+type FabricLifecycleDelivery = "steer" | "followUp";
+export interface FabricLifecycleSource {
+    id: string;
+    name: string;
+    kind: FabricParticipantKind;
+    rootId: string;
+    runner: FabricAgentRunner;
+    ownerHostId?: string;
+    ownerIdentityId?: string;
+}
+export interface FabricLifecyclePublishRequest {
+    source: FabricLifecycleSource;
+    event: FabricLifecycleEventType;
+    occurredAt?: number;
+    runId?: string;
+    status?: string;
+    data?: unknown;
+}
+export interface FabricLifecycleEvent {
+    version: 1;
+    id: string;
+    sequence: number;
+    event: FabricLifecycleEventType;
+    source: FabricLifecycleSource;
+    occurredAt: number;
+    publishedAt: number;
+    runId?: string;
+    status?: string;
+    data?: unknown;
+}
+/**
+ * Attributed token usage for one token-bearing child event.
+ *
+ * The worker emits one of these per assistant message (OMP) or per usage-bearing
+ * assistant/result frame (Claude), tagged with the run/runner/depth identity the
+ * manager passes in. Cumulative tokens mirror in + cacheRead + cacheWrite at
+ * the moment the event fired; cost is micro-USD from the runner's own report.
+ */
+export interface FabricTokenUsagePayload {
+    runId: string;
+    name: string;
+    runner: FabricAgentRunner;
+    depth: number;
+    actorId?: string;
+    actorName?: string;
+    cumulativeTokens: number;
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    cost: number;
+}
+export declare const tokenUsagePayloadFromValue: (value: unknown) => FabricTokenUsagePayload | undefined;
+export interface FabricLifecycleSubscriptionRequest {
+    from: string;
+    events: FabricLifecycleEventType[];
+    to: string;
+    delivery: FabricLifecycleDelivery;
+    triggerTurn: boolean;
+    once?: boolean;
+}
+export interface FabricLifecycleSubscription {
+    format: 1;
+    id: string;
+    from: string;
+    events: FabricLifecycleEventType[];
+    to: string;
+    delivery: FabricLifecycleDelivery;
+    triggerTurn: boolean;
+    once: boolean;
+    afterSequence: number;
+    createdAt: number;
+    updatedAt: number;
+    createdBy: MeshIdentity;
+    lastDeliveredAt?: number;
+    lastEventId?: string;
+    lastError?: string;
+}
+export declare const isFabricLifecycleEventType: (value: unknown) => value is FabricLifecycleEventType;
+export declare const lifecycleSourceIdentity: (source: FabricLifecycleSource) => MeshIdentity;
+export declare const lifecycleEventFromMesh: (event: MeshEvent) => FabricLifecycleEvent | undefined;
+export declare const lifecycleSubscriptionFromValue: (value: unknown) => FabricLifecycleSubscription | undefined;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/lifecycle/types.d.ts.map

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

package/dist/log-tail.d.ts

@@ -0,0 +1,11 @@
+import type { FabricLogLine } from "./agents/types.js";
+export interface JsonlPage {
+    lines: FabricLogLine[];
+    hasMore: boolean;
+    before?: number;
+}
+/** Read a bounded JSONL page backwards from an already validated descriptor. */
+export declare const readJsonlPageFromDescriptor: (descriptor: number, limit: number, before?: number, knownSize?: number, maxBytes?: number) => JsonlPage;
+/** Read a bounded JSONL page backwards, touching only enough file chunks to fill it. */
+export declare const readJsonlPage: (filePath: string, limit: number, before?: number, maxBytes?: number) => JsonlPage;
+//# sourceMappingURL=log-tail.d.ts.map

package/dist/log-tail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-tail.d.ts","sourceRoot":"","sources":["../src/log-tail.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAuCD,gFAAgF;AAChF,eAAO,MAAM,2BAA2B,GACtC,YAAY,MAAM,EAClB,OAAO,MAAM,EACb,SAAS,MAAM,EACf,YAAY,MAAM,EAClB,WAAW,MAAM,KAChB,SAgDF,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,aAAa,GACxB,UAAU,MAAM,EAChB,OAAO,MAAM,EACb,SAAS,MAAM,EACf,WAAW,MAAM,KAChB,SAYF,CAAC"}

package/dist/main-agent.d.ts

@@ -0,0 +1,70 @@
+import type { ExtensionAPI, ExtensionContext } from "@oh-my-pi/pi-coding-agent";
+import type { MeshIdentity } from "./mesh/store.js";
+export type FabricAgentMessageDelivery = "steer" | "followUp";
+export interface FabricMainAgentInfo {
+    id: string;
+    name: "Main";
+    kind: "main";
+    status: "idle" | "running" | "remote";
+    runner: "omp";
+    transport: "host";
+    cwd?: string;
+    sessionId?: string;
+    model?: string;
+    thinking?: string;
+    startedAt?: number;
+    updatedAt: number;
+    pendingMessages: boolean;
+    local: boolean;
+}
+export interface FabricMainAgentDeliveryRequest {
+    from: MeshIdentity;
+    message: string;
+    delivery: FabricAgentMessageDelivery;
+    triggerTurn?: boolean;
+    data?: unknown;
+}
+export interface FabricAgentMessageResult {
+    queued: true;
+    messageId: string;
+    routed: "local" | "main" | "mesh";
+    acknowledged?: boolean;
+}
+export interface FabricMainModelSwitchResult {
+    ok: boolean;
+    error?: string;
+}
+export interface FabricMainAgentTarget {
+    readonly id: string;
+    readonly local: boolean;
+    matches(id: string): boolean;
+    info(context?: ExtensionContext): FabricMainAgentInfo;
+    deliverAgent(request: FabricMainAgentDeliveryRequest): FabricAgentMessageResult;
+    switchModel?(target: {
+        provider: string;
+        id: string;
+    }, context: ExtensionContext): Promise<FabricMainModelSwitchResult>;
+}
+export interface FabricIdentityResolution {
+    identity: MeshIdentity;
+    mainAgentId: string;
+}
+export declare const resolveFabricIdentity: (sessionId: string, environment?: NodeJS.ProcessEnv) => FabricIdentityResolution;
+export declare class MainAgentController implements FabricMainAgentTarget {
+    readonly omp: ExtensionAPI;
+    readonly id: string;
+    readonly local: boolean;
+    readonly cwd: string;
+    readonly sessionId?: string | undefined;
+    readonly startedAt: number;
+    constructor(omp: ExtensionAPI, id: string, local: boolean, cwd: string, sessionId?: string | undefined);
+    matches(id: string): boolean;
+    info(context?: ExtensionContext): FabricMainAgentInfo;
+    switchModel(target: {
+        provider: string;
+        id: string;
+    }, context: ExtensionContext): Promise<FabricMainModelSwitchResult>;
+    deliverUser(message: string, delivery: FabricAgentMessageDelivery): FabricAgentMessageResult;
+    deliverAgent(request: FabricMainAgentDeliveryRequest): FabricAgentMessageResult;
+}
+//# sourceMappingURL=main-agent.d.ts.map

package/dist/main-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-agent.d.ts","sourceRoot":"","sources":["../src/main-agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,MAAM,MAAM,0BAA0B,GAAG,OAAO,GAAG,UAAU,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IACtC,MAAM,EAAE,KAAK,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,0BAA0B,CAAC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,IAAI,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,IAAI,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,mBAAmB,CAAC;IACtD,YAAY,CAAC,OAAO,EAAE,8BAA8B,GAAG,wBAAwB,CAAC;IAGhF,WAAW,CAAC,CACV,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EACxC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,qBAAqB,GAChC,WAAW,MAAM,EACjB,cAAa,MAAM,CAAC,UAAwB,KAC3C,wBAwBF,CAAC;AAcF,qBAAa,mBAAoB,YAAW,qBAAqB;IAI7D,QAAQ,CAAC,GAAG,EAAE,YAAY;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,KAAK,EAAE,OAAO;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM;IAP7B,QAAQ,CAAC,SAAS,SAAc;gBAGrB,GAAG,EAAE,YAAY,EACjB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,YAAA;IAG7B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAK5B,IAAI,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,mBAAmB;IAuB/C,WAAW,CACf,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EACxC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,2BAA2B,CAAC;IAYvC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,0BAA0B,GAAG,wBAAwB;IAS5F,YAAY,CAAC,OAAO,EAAE,8BAA8B,GAAG,wBAAwB;CA8BhF"}

package/dist/memory/context.d.ts

@@ -0,0 +1,112 @@
+import type { FabricExecutionOutcomeV1 } from "../audit/trace.js";
+import type { EntryRange, MemoryCoverage } from "./index.js";
+import type { MemoryBranches } from "./lineage.js";
+import type { SearchResult } from "./search.js";
+import { type MemoryQueryMatch, type MemoryQueryMode } from "./tokenize.js";
+export declare const RECALL_DEFAULT_PAGE_SIZE = 10;
+export declare const RECALL_MAX_PAGE_SIZE = 50;
+export declare const RECALL_DEFAULT_SNIPPET_CHARS = 480;
+export declare const RECALL_MAX_SNIPPET_CHARS = 2000;
+export declare const RECALL_MAX_RESPONSE_CHARS = 30000;
+export interface MemoryRecallCallArgs {
+    query?: string;
+    queryMode?: MemoryQueryMode;
+    queryMatch?: MemoryQueryMatch;
+    expectedSourceHash?: string;
+    expectedLineageFingerprint?: string;
+    branches?: MemoryBranches;
+    scope?: string;
+    offset?: number;
+    pageSize?: number;
+    snippetChars?: number;
+    role?: string;
+    tool?: string;
+    ref?: string;
+    provider?: string;
+    action?: string;
+    outcome?: FabricExecutionOutcomeV1;
+    since?: number;
+    until?: number;
+    entryRange?: EntryRange;
+}
+interface MemoryExpandCallArgs {
+    session: string;
+    expectedSourceHash?: string;
+    expectedLineageFingerprint?: string;
+    branches?: MemoryBranches;
+    indices?: number[];
+    entryIds?: string[];
+    operationAddresses?: string[];
+    entryRange?: EntryRange;
+    before?: number;
+    after?: number;
+    entryOffset?: number;
+    textOffset?: number;
+    maxChars?: number;
+    maxEntries?: number;
+}
+interface MemoryExpandFollow {
+    ref: "memory.expand";
+    args: MemoryExpandCallArgs;
+}
+interface MemoryRecallFollow {
+    ref: "memory.recall";
+    args: MemoryRecallCallArgs;
+}
+interface MemoryRecallEntryHit {
+    kind: "entry";
+    sessionId: string;
+    tier: "hot" | "cold";
+    index: number;
+    entryId: string | null;
+    parentId: string | null;
+    operationAddress: string | null;
+    type: string;
+    role: string | null;
+    tool: string | null;
+    ref: string | null;
+    provider: string | null;
+    action: string | null;
+    timestamp: number | null;
+    isError: boolean;
+    outcome?: FabricExecutionOutcomeV1;
+    score: number;
+    snippet: string;
+    truncated: boolean;
+    follow: MemoryExpandFollow;
+}
+interface MemoryRecallSessionHit {
+    kind: "session";
+    sessionId: string;
+    tier: "cold";
+    cwd: string;
+    lastTimestamp: number | null;
+    score: number;
+    matchedTerms: number;
+    matchedStructuralEntries: number;
+    follow: MemoryRecallFollow;
+}
+type MemoryRecallHit = MemoryRecallEntryHit | MemoryRecallSessionHit;
+interface MemoryRecallContinuation {
+    ref: "memory.recall";
+    args: MemoryRecallCallArgs;
+}
+export interface MemoryRecallResponse {
+    total: number;
+    hits: MemoryRecallHit[];
+    next: MemoryRecallContinuation | null;
+    coverage: MemoryCoverage;
+}
+interface RecallPresentationInput {
+    result: SearchResult;
+    query?: string;
+    queryMode: MemoryQueryMode;
+    coverage: MemoryCoverage;
+    offset?: number;
+    pageSize: number;
+    snippetChars: number;
+    requestArgs: MemoryRecallCallArgs;
+}
+export declare const presentRecall: (input: RecallPresentationInput) => MemoryRecallResponse;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/memory/context.d.ts.map

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

package/dist/memory/digest.d.ts

@@ -0,0 +1,48 @@
+import type { NormalizationCoverage, NormalizedEntry } from "./normalize.js";
+/** Compact structural posting: source identity, typed role/tool fields, time, and exact Fabric capability identity. */
+export type DigestEntryAddress = [
+    index: number,
+    entryId: string | null,
+    operationAddress: string | null,
+    role: string | null,
+    toolName: string | null,
+    timestamp: number | null,
+    ref: string | null,
+    provider: string | null,
+    action: string | null,
+    outcome: NormalizedEntry["outcome"] | null
+];
+interface DigestIndexCoverage {
+    complete: boolean;
+    vocabularyBytes: number;
+    reasons: string[];
+}
+export interface SessionDigest {
+    sessionId: string;
+    file: string;
+    cwd: string;
+    firstTs: number | null;
+    lastTs: number | null;
+    entryCount: number;
+    filesTouched: string[];
+    toolHistogram: Record<string, number>;
+    errorCount: number;
+    /** Sorted exact unique canonical terms. Terms never contain posting lists. */
+    vocabulary: string[];
+    /** Structural entry identities retained independently from lexical vocabulary. */
+    addresses: DigestEntryAddress[];
+    indexCoverage: DigestIndexCoverage;
+}
+export interface DigestInput {
+    sessionId: string;
+    file: string;
+    cwd: string;
+    entries: NormalizedEntry[];
+    maxVocabularyBytes?: number;
+    filesTouchedLimit?: number;
+    normalizationCoverage?: NormalizationCoverage;
+}
+/** Purely fold normalized session entries into bounded lexical and structural metadata. */
+export declare const foldSessionDigest: (input: DigestInput) => SessionDigest;
+export {};
+//# sourceMappingURL=digest.d.ts.map

package/dist/memory/digest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest.d.ts","sourceRoot":"","sources":["../../src/memory/digest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAK7E,uHAAuH;AACvH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,MAAM,GAAG,IAAI;IACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAC/B,IAAI,EAAE,MAAM,GAAG,IAAI;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI;IACxB,GAAG,EAAE,MAAM,GAAG,IAAI;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI;IACrB,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,GAAG,IAAI;CAC3C,CAAC;AAEF,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kFAAkF;IAClF,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,aAAa,EAAE,mBAAmB,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;CAC/C;AAKD,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,GAAI,OAAO,WAAW,KAAG,aAsFtD,CAAC"}

package/dist/memory/digest.js

@@ -0,0 +1,7 @@
+import {
+  foldSessionDigest
+} from "../chunks/chunk-U5FYOMG5.js";
+export {
+  foldSessionDigest
+};
+//# sourceMappingURL=digest.js.map

package/dist/memory/digest.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/memory/discovery.d.ts

@@ -0,0 +1,43 @@
+export interface SessionRef {
+    id: string;
+    file: string;
+    cwd: string;
+    mtime: number;
+}
+export interface ResolveScopeInput {
+    agentDir: string;
+    cwd: string;
+    scope: string;
+    sessionId?: string;
+    sessionFile?: string;
+    maxSessions: number;
+}
+/** Encode a cwd into the safe directory name OMP stores session files under. */
+export declare const encodeCwdDir: (cwd: string) => string;
+/** Directory OMP stores this project's session JSONL files under. */
+export declare const sessionDirForCwd: (cwd: string, agentDir: string) => string;
+export declare const sessionsDirRoot: (agentDir: string) => string;
+/**
+ * Enumerate every session JSONL file under the agent dir, newest first by
+ * file mtime. Bounded by `maxSessions`. Returns refs with resolved cwd and
+ * sessionId from each file header (falling back to the file stem).
+ */
+export declare const enumerateAllSessions: (agentDir: string, maxSessions: number) => SessionRef[];
+export declare class AmbiguousSessionError extends Error {
+    readonly session: string;
+    readonly candidates: string[];
+    readonly code = "ambiguous_session";
+    constructor(session: string, candidates: string[]);
+}
+export declare const resolveSessionTarget: (agentDir: string, target: string) => SessionRef | null;
+/**
+ * Resolve a scope string into the concrete set of session files to search.
+ *
+ * - `session` (default): the current session file (from invocation context
+ *   if available, else the newest session for the current cwd).
+ * - `project`: all sessions stored under the current cwd's default session dir.
+ * - `global`: all sessions under the agent dir, bounded by `maxSessions`.
+ * - `session:<id-or-path>`: one specific session by id or file path.
+ */
+export declare const resolveScope: (input: ResolveScopeInput) => SessionRef[];
+//# sourceMappingURL=discovery.d.ts.map

package/dist/memory/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/memory/discovery.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,gFAAgF;AAChF,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,MAC+B,CAAC;AAE3E,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,GAAI,KAAK,MAAM,EAAE,UAAU,MAAM,KAAG,MACR,CAAC;AA+B1D,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,KAAG,MAA8C,CAAC;AAOlG;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU,MAAM,EAAE,aAAa,MAAM,KAAG,UAAU,EAmBtF,CAAC;AAUF,qBAAa,qBAAsB,SAAQ,KAAK;IAI5C,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE;IAJ/B,QAAQ,CAAC,IAAI,uBAAuB;gBAGzB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAAE;CAKhC;AAED,eAAO,MAAM,oBAAoB,GAC/B,UAAU,MAAM,EAChB,QAAQ,MAAM,KACb,UAAU,GAAG,IAWf,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,iBAAiB,KAAG,UAAU,EAyBjE,CAAC"}

package/dist/memory/discovery.js

@@ -0,0 +1,23 @@
+import {
+  AmbiguousSessionError,
+  encodeCwdDir,
+  enumerateAllSessions,
+  resolveScope,
+  resolveSessionTarget,
+  sessionDirForCwd,
+  sessionsDirRoot
+} from "../chunks/chunk-7BIA5BJN.js";
+import "../chunks/chunk-6QBPSZJ5.js";
+import "../chunks/chunk-4HQDSTHN.js";
+import "../chunks/chunk-T5ZA5YRU.js";
+import "../chunks/chunk-6N4XGAZY.js";
+export {
+  AmbiguousSessionError,
+  encodeCwdDir,
+  enumerateAllSessions,
+  resolveScope,
+  resolveSessionTarget,
+  sessionDirForCwd,
+  sessionsDirRoot
+};
+//# sourceMappingURL=discovery.js.map

package/dist/memory/discovery.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/memory/index.d.ts

@@ -0,0 +1,107 @@
+import { type SessionDigest } from "./digest.js";
+import type { SessionRef } from "./discovery.js";
+import type { LiveSessionBranch, MemoryBranches } from "./lineage.js";
+import type { NormalizedEntry } from "./normalize.js";
+export declare const MEMORY_CACHE_VERSION = 6;
+export declare const DEFAULT_HOT_SESSIONS = 50;
+type MemoryTier = "hot" | "cold";
+interface CacheRecord {
+    cacheVersion: typeof MEMORY_CACHE_VERSION;
+    kind: "shard" | "digest";
+    mtime: number;
+    size: number;
+    sourceHash: string;
+    branches: MemoryBranches;
+    lineageFingerprint: string;
+    policy: string;
+    cacheBytes: number;
+    cacheSourceRatio: number;
+}
+export interface Shard extends CacheRecord {
+    kind: "shard";
+    sessionFile: string;
+    sessionId: string;
+    entries: NormalizedEntry[];
+    totalEntryCount: number;
+    indexCoverage: {
+        complete: boolean;
+        reasons: string[];
+    };
+    tier?: MemoryTier;
+    indexReason?: string;
+}
+export interface DigestShard extends SessionDigest, CacheRecord {
+    kind: "digest";
+}
+export interface MemoryIndexOptions {
+    indexDir: string;
+    maxEntryChars: number;
+    hotSessions?: number;
+    digestTerms?: number;
+    maxColdVocabularyBytes?: number;
+    maxColdCacheBytes?: number;
+    maxSyncSessions?: number;
+    maxSyncSourceBytes?: number;
+    maxCacheCleanupFiles?: number;
+    branches?: MemoryBranches;
+    indexThinking?: boolean;
+    indexToolOutput?: boolean;
+    liveBranchForFile?: (sessionFile: string) => LiveSessionBranch | undefined;
+}
+export interface EntryRange {
+    first: number;
+    last: number;
+}
+export declare const shardPathForSession: (sessionFile: string, indexDir: string, branches?: MemoryBranches) => string;
+export declare const digestPathForSession: (sessionFile: string, indexDir: string, branches?: MemoryBranches) => string;
+export interface SourceState {
+    mtime: number;
+    size: number;
+    sourceHash: string;
+}
+export declare const fingerprintSource: (file: string) => SourceState | null;
+export declare const loadShard: (ref: SessionRef, options: MemoryIndexOptions) => Shard;
+export declare const loadDigest: (ref: SessionRef, options: MemoryIndexOptions) => DigestShard;
+export interface MemoryCoverage {
+    complete: boolean;
+    indexedSessions: number;
+    eligibleSessions: number;
+    staleSessions: number;
+    incompleteSessions: number;
+    reasons: string[];
+}
+export interface TieredIndexBundle {
+    shards: Shard[];
+    digests: DigestShard[];
+    refs: SessionRef[];
+    tiers: Map<string, MemoryTier>;
+    coverage: MemoryCoverage;
+}
+export declare const loadTieredIndex: (refs: SessionRef[], allRefs: SessionRef[], options: MemoryIndexOptions, hydrate?: boolean, entryRange?: EntryRange) => TieredIndexBundle;
+export interface SearchFilters {
+    role?: string;
+    tool?: string;
+    ref?: string;
+    provider?: string;
+    action?: string;
+    outcome?: NonNullable<NormalizedEntry["outcome"]>;
+    since?: number;
+    until?: number;
+}
+export interface IndexedEntry {
+    entry: NormalizedEntry;
+    sessionMtime: number;
+}
+export interface ScoredEntry extends IndexedEntry {
+    score: number;
+    matchedTerms: number;
+}
+export interface ShardBundle {
+    shards: Shard[];
+    refs: SessionRef[];
+}
+export declare const loadShards: (refs: SessionRef[], options: MemoryIndexOptions) => ShardBundle;
+export declare const bm25Score: (shards: Shard[], terms: string[], filters: SearchFilters, candidateLimit?: number) => ScoredEntry[];
+export declare const recentEntries: (shards: Shard[], filters: SearchFilters, limit: number) => IndexedEntry[];
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

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