qlogicagent 2.23.14 → 2.24.2

package/dist/types/runtime/infra/host-agent-provider-directory.d.ts

@@ -1,17 +0,0 @@
-import { type HostAgentProviderDiagnostic, type HostAgentProviderGetResult, type HostAgentProviderListResult, type HostProviderRequestParams } from "../../host-contract/index.js";
-export type HostProviderDirectoryErrorCode = "HOST_PROVIDER_DIRECTORY_UNAVAILABLE" | "HOST_PROVIDER_DIRECTORY_INVALID_RESPONSE";
-export declare class HostProviderDirectoryError extends Error {
-    readonly code: HostProviderDirectoryErrorCode;
-    constructor(code: HostProviderDirectoryErrorCode, message: string, options?: ErrorOptions);
-}
-export interface HostProviderDirectoryRequester {
-    request(params: HostProviderRequestParams): Promise<unknown>;
-}
-export declare class HostAgentProviderDirectory {
-    private readonly requester;
-    constructor(requester: HostProviderDirectoryRequester);
-    list(): Promise<Readonly<HostAgentProviderListResult>>;
-    get(providerId: string): Promise<Readonly<HostAgentProviderGetResult>>;
-    diagnose(providerId: string): Promise<Readonly<HostAgentProviderDiagnostic>>;
-    private read;
-}

package/dist/types/runtime/infra/project-authority-facade.d.ts

@@ -1,11 +0,0 @@
-/** Project mutations are requests to the Gateway-owned X7 authority. */
-import type { ProjectInfo, ProjectType } from "../../protocol/methods.js";
-export declare function createProjectAuthoritative(params: {
-    name: string;
-    workspaceDir?: string;
-    type?: ProjectType;
-    groupId?: string;
-    skipAutoSwitch?: boolean;
-}): Promise<ProjectInfo>;
-export declare function updateProjectAuthoritative(projectId: string, patch: Partial<Pick<ProjectInfo, "planStatus" | "planAgents" | "planWinnerId" | "leaderSessionId" | "primaryWorkflowId">>): Promise<ProjectInfo | null>;
-export declare function switchProjectAuthoritative(projectIdOrQuery: string): Promise<ProjectInfo | null>;

package/dist/types/runtime/infra/project-data-paths.d.ts

@@ -1,24 +0,0 @@
-/**
- * Project Data Paths — centralized location for our per-project COMPANION data (the "account
- * book"): session transcripts/metadata, checkpoint shadow repos, uploaded attachments, deletion
- * tombstones. Mirrors VS Code's workspaceStorage: this data is OURS and lives in a centralized,
- * per-project-id, physically-isolated dir at the DEVICE level — NEVER inside the user's
- * workspace folder. The workspace folder holds only user work product (code/docs/generated media).
- * 设备级(用户裁定,对齐 codex/VS Code):会话数据跟随机器;登录身份只属于云同步/计费层。
- *
- *   ~/.qlogicagent/projectData/<projectId>/{sessions,checkpoints,uploads}/
- *
- * projectId is the PATH-DERIVED key (deriveProjectId(workspaceDir), see agent-paths) — the
- * mainstream model (VS Code / cc-haha): same folder → same id, deterministic, recomputable, no
- * central-registry dependency for the storage key. Only the Gateway archive-only internal-data
- * transaction may remove projectData/<id>; qlogicagent has no lifecycle deletion authority.
- */
-export { getProjectDataDirById, getProjectDataRoot } from "./agent-paths.js";
-/** `~/.qlogicagent/projectData/<projectId>/` for a projectId or workspaceDir. */
-export declare function getProjectDataDir(projectIdOrWorkspaceDir: string): string;
-/** `projectData/<id>/sessions/` */
-export declare function getProjectDataSessionsRoot(projectIdOrWorkspaceDir: string): string;
-/** `projectData/<id>/checkpoints/` or `.../checkpoints/<sessionId>` */
-export declare function getProjectDataCheckpointsDir(projectIdOrWorkspaceDir: string, sessionId?: string): string;
-/** `projectData/<id>/uploads/` or `.../uploads/<sessionId>` */
-export declare function getProjectDataUploadsDir(projectIdOrWorkspaceDir: string, sessionId?: string): string;

package/dist/types/runtime/infra/project-host-authority.d.ts

@@ -1,11 +0,0 @@
-/** In-memory ExtHost-style project proxy. Durable registry bytes remain gateway-owned. */
-import type { HostProjectInfo, HostProjectSnapshotResult } from "../../host-contract/index.js";
-import type { HostProjectClient } from "../../transport/host-project-client.js";
-export declare function configureHostProjectAuthority(resolver: () => HostProjectClient | undefined): void;
-export declare function hydrateHostProjectSnapshot(): Promise<void>;
-export declare function readHostProjectSnapshot(): HostProjectSnapshotResult;
-/** Test-only snapshot injection; production must hydrate through HostProjectClient. */
-export declare function setHostProjectSnapshotForTests(next: HostProjectSnapshotResult): void;
-export declare function createHostProject(params: Parameters<HostProjectClient["create"]>[0]): Promise<HostProjectInfo>;
-export declare function switchHostProject(projectIdOrQuery: string): Promise<HostProjectInfo>;
-export declare function updateHostProject(projectId: string, patch: Parameters<HostProjectClient["update"]>[1]): Promise<HostProjectInfo>;

package/dist/types/runtime/infra/project-instructions-store.d.ts

@@ -1,30 +0,0 @@
-/**
- * ProjectInstructionsStore — CRUD for project-scoped rule/instruction files.
- *
- * Storage location: `<workspace>/.qlogicagent/rules/*.md`
- * Unified directory for all project instructions and rules.
- */
-export interface InstructionFile {
-    filename: string;
-    content: string;
-    sizeBytes: number;
-}
-export declare class ProjectInstructionsStore {
-    private dir;
-    constructor(cwd: string);
-    /** List all instruction files for the project. */
-    list(): InstructionFile[];
-    /** Read a single instruction file. */
-    read(filename: string): InstructionFile | null;
-    /** Write (create or update) an instruction file. */
-    write(filename: string, content: string): InstructionFile;
-    /** Delete an instruction file. */
-    remove(filename: string): boolean;
-    /**
-     * Load all instruction files and concatenate into a single block
-     * for agent system context injection.
-     */
-    loadAll(): string;
-    private isValidFilename;
-    private getDirSize;
-}

package/dist/types/runtime/infra/turn-baseline-store.d.ts

@@ -1,102 +0,0 @@
-export type TurnBaselineState = "running" | "completed" | "failed" | "cancelled";
-export type FileChangeStatus = "added" | "modified" | "deleted" | "renamed" | "moved" | "copied" | "unchanged";
-export type SnapshotKind = "missing" | "text" | "binary" | "directory" | "too-large";
-export interface FileSnapshot {
-    exists: boolean;
-    kind: SnapshotKind;
-    sizeBytes?: number;
-    sha256?: string;
-    inlineContent?: string;
-    contentRef?: string;
-}
-export interface TurnFileChange {
-    path: string;
-    previousPath?: string;
-    status: FileChangeStatus;
-    additions?: number;
-    deletions?: number;
-    before?: FileSnapshot;
-    after?: FileSnapshot;
-}
-export interface TurnChangeSummary {
-    turnId: string;
-    sessionId: string;
-    projectId: string;
-    state: TurnBaselineState;
-    startedAt: string;
-    completedAt?: string;
-    filesChanged: number;
-    files: TurnFileChange[];
-    truncated?: boolean;
-}
-export declare function resolveProjectRelativePath(projectRoot: string, input: string): string | null;
-export declare function startTurnBaseline(input: {
-    turnId: string;
-    sessionId: string;
-    projectId?: string;
-    workspaceDir?: string;
-    seedPaths?: unknown;
-}): Promise<void>;
-export declare function captureFileBefore(input: {
-    turnId?: string;
-    projectId?: string;
-    workspaceDir?: string;
-    path: string;
-    entryPath?: string;
-    previousPath?: string;
-}): Promise<void>;
-export declare function captureFileAfter(input: {
-    turnId?: string;
-    projectId?: string;
-    workspaceDir?: string;
-    path: string;
-    entryPath?: string;
-    previousPath?: string;
-    status?: FileChangeStatus;
-}): Promise<void>;
-export declare function captureAbsoluteBefore(input: {
-    turnId?: string;
-    workspaceDir: string;
-    absolutePath: string;
-}): Promise<void>;
-export declare function captureAbsoluteAfter(input: {
-    turnId?: string;
-    workspaceDir: string;
-    absolutePath: string;
-    status?: FileChangeStatus;
-}): Promise<void>;
-export declare function finalizeTurnBaseline(input: {
-    turnId: string;
-    state: TurnBaselineState;
-}): Promise<TurnChangeSummary | null>;
-export declare function getTurnBaselineSummary(projectId: string, turnId: string): Promise<TurnChangeSummary | null>;
-export declare function listRecentTurnBaselines(input: {
-    projectId: string;
-    sessionId?: string;
-    limit?: number;
-}): Promise<{
-    summaries: TurnChangeSummary[];
-}>;
-export declare function getTurnBaselineFileBaseline(input: {
-    projectId: string;
-    turnId: string;
-    path: string;
-}): Promise<{
-    path: string;
-    content: string | null;
-    snapshot: FileSnapshot | null;
-}>;
-export declare function getTurnBaselineFileDiff(input: {
-    projectId: string;
-    turnId: string;
-    path: string;
-}): Promise<{
-    path: string;
-    previousPath?: string;
-    status: FileChangeStatus;
-    original: string;
-    modified: string;
-    language?: string;
-    additions?: number;
-    deletions?: number;
-}>;

package/dist/types/runtime/infra/turn-telemetry-store.d.ts

@@ -1,100 +0,0 @@
-import type { HostDelegationTelemetrySummary } from "../../host-contract/index.js";
-import type { FinalAnswerEvidence, ToolCallExecutionEvidence } from "../../protocol/wire/notification-payloads.js";
-export type AgentMode = "chat" | "solo" | "product" | "workflow" | "unknown";
-export interface TurnTelemetryUsage {
-    inputTokens?: number;
-    outputTokens?: number;
-    totalTokens?: number;
-}
-export interface TurnTelemetryToolSummary {
-    calledTools: string[];
-    failedTools: string[];
-    blockedTools: string[];
-}
-export interface TurnTelemetryFileContext {
-    changedFileCount?: number;
-    changedPathsPreview?: string[];
-    hasTurnFileChanges?: boolean;
-}
-export interface TurnTelemetryCapabilityContext {
-    skillDirectoryProjected: boolean;
-    skillDirectoryRevision?: `sha256:${string}`;
-    skillDirectoryChars?: number;
-}
-export interface TurnTelemetryExecutionEvidence {
-    ledgerSchemaVersion: 4;
-    toolCalls: ToolCallExecutionEvidence[];
-    finalAnswerEvidence: FinalAnswerEvidence;
-    availableToolNames: string[];
-    enabledToolNames: string[];
-    blockedToolCalls: Array<{
-        name: string;
-        reason: string;
-    }>;
-}
-export interface TurnTelemetrySnapshot {
-    turnId: string;
-    sessionId: string;
-    projectId?: string;
-    /** Gateway-stamped alias; v1 MUST equal turnId (design §7.3). Set at finalize. */
-    assistantMessageId?: string;
-    model?: string;
-    provider?: string;
-    agentMode?: AgentMode;
-    sourceChannel?: string;
-    usage?: TurnTelemetryUsage;
-    toolSummary?: TurnTelemetryToolSummary;
-    executionEvidence?: TurnTelemetryExecutionEvidence;
-    fileContext?: TurnTelemetryFileContext;
-    delegationSummary?: HostDelegationTelemetrySummary;
-    capabilityContext?: TurnTelemetryCapabilityContext;
-    createdAt: string;
-    finalizedAt?: string;
-}
-/** Fields that can be merged into a turn's telemetry record as the turn progresses. */
-export type TurnTelemetryPatch = Partial<Omit<TurnTelemetrySnapshot, "turnId" | "createdAt" | "finalizedAt" | "assistantMessageId">>;
-/**
- * Merge a telemetry fragment into the in-memory record for a turn. Pieces (tool summary,
- * usage/model, file context) arrive at different points in the pipeline and upsert into the
- * same turnId record. Safe to call before the projectId is known; the first call seeds it.
- */
-export declare function recordTurnTelemetry(turnId: string, patch: TurnTelemetryPatch): void;
-export declare function recordTurnDelegationStarted(input: {
-    turnId: string;
-    subagentId: string;
-    agentType: string;
-    mode: "foreground" | "background";
-}): void;
-export declare function recordTurnDelegationCompleted(input: {
-    turnId: string;
-    subagentId: string;
-    agentType: string;
-    status: "completed" | "failed" | "cancelled";
-    durationMs: number;
-    totalTokens: number;
-}): void;
-export declare function recordTurnDelegationDecision(input: {
-    turnId: string;
-    subagentId: string;
-    decision: "adopted" | "partially_adopted" | "rejected";
-}): void;
-export declare function recordTurnArgumentCorrections(turnId: string, argumentCorrections: HostDelegationTelemetrySummary["argumentCorrections"]): void;
-/**
- * Flush the accumulated telemetry for a turn to disk and drop it from memory. Returns null
- * (after dropping the in-memory record) when no projectId resolved — telemetry, like the turn
- * baseline, is only persisted for turns that belong to a registered project.
- */
-export declare function finalizeTurnTelemetry(input: {
-    turnId: string;
-    projectId?: string;
-}): Promise<TurnTelemetrySnapshot | null>;
-export declare function getTurnTelemetryRecord(projectId: string, turnId: string): Promise<TurnTelemetrySnapshot | null>;
-export declare function listTurnTelemetryBySession(input: {
-    projectId: string;
-    sessionId?: string;
-    limit?: number;
-}): Promise<{
-    records: TurnTelemetrySnapshot[];
-}>;
-/** Test/maintenance helper: drop any in-memory telemetry not yet finalized. */
-export declare function __resetActiveTurnTelemetryForTest(): void;

package/dist/types/runtime/infra/working-materials-store.d.ts

@@ -1,29 +0,0 @@
-export type WorkingMaterialKind = "workspace" | "instructions" | "generated" | "url";
-export interface WorkingMaterialItem {
-    id: string;
-    projectId: string;
-    sessionId: string;
-    sourceKind: WorkingMaterialKind;
-    path?: string;
-    title: string;
-    viewerHint?: string;
-    pinned: boolean;
-    order: number;
-    addedAt: string;
-    updatedAt: string;
-    missing?: boolean;
-}
-export declare function getWorkingMaterials(projectId: string, sessionId: string): Promise<{
-    items: WorkingMaterialItem[];
-    missing: WorkingMaterialItem[];
-}>;
-export interface WorkingMaterialsWriteResult {
-    ok: true;
-    items: WorkingMaterialItem[];
-    /** 超过上限被淘汰的项;非空时调用方/UI 必须告知用户(绝不静默丢用户 pin 的数据)。 */
-    dropped?: WorkingMaterialItem[];
-}
-export declare function replaceWorkingMaterials(projectId: string, sessionId: string, items: unknown[]): Promise<WorkingMaterialsWriteResult>;
-export declare function upsertWorkingMaterial(projectId: string, sessionId: string, item: unknown): Promise<WorkingMaterialsWriteResult>;
-export declare function removeWorkingMaterial(projectId: string, sessionId: string, id: string): Promise<WorkingMaterialsWriteResult>;
-export declare function reorderWorkingMaterials(projectId: string, sessionId: string, ids: string[]): Promise<WorkingMaterialsWriteResult>;

package/dist/types/runtime/memory/find-relevant-memories.d.ts

@@ -1,26 +0,0 @@
-export declare const RELEVANT_MEMORIES_CONFIG: {
-    /** Max files to surface per turn. */
-    readonly MAX_SELECTED: 5;
-    /** Max bytes per surfaced file (CC: 4096). */
-    readonly MAX_FILE_BYTES: 4096;
-};
-/** A selected relevant memory with content loaded. */
-export interface RelevantMemory {
-    /** Filename */
-    filename: string;
-    /** Full file path */
-    filePath: string;
-    /** Last modified timestamp */
-    mtimeMs: number;
-    /** Relevance score (0.0 - 1.0) */
-    score: number;
-    /** Content (possibly truncated) */
-    content: string;
-    /** Whether content was truncated */
-    truncated: boolean;
-}
-/**
- * Format relevant memories as a single block for system prompt injection.
- * CC parity: includes freshness header per file.
- */
-export declare function formatRelevantMemoriesBlock(memories: RelevantMemory[]): string;

package/dist/types/runtime/memory/implicit-extraction.d.ts

@@ -1,69 +0,0 @@
-/**
- * Implicit Memory Extraction — CC extractMemories lightweight port.
- *
- * Architecture:
- *   - Lightweight LLM pass (async, non-blocking) extracts structured facts
- *   - Host validates and commits atomic claims through the canonical evidence chain
- *
- * This runs AFTER turn.end, so the user already has their response.
- * Every completed user turn is eligible for the bounded learned pass. If the
- * model is unavailable or cannot produce a valid structured claim, extraction
- * fails closed without creating an unstructured memory.
- *
- * Reference: claude-code src/services/extractMemories/extractMemories.ts
- */
-import type { MemoryWriter } from "../ports/memory-writer.js";
-import { type LongTermMemoryCategory, type MemoryClaimRelation } from "../../host-contract/memory-category.js";
-export interface ExtractedFact {
-    text: string;
-    /** Exact evidence span copied from the current user message; never assistant prose. */
-    evidenceQuote: string;
-    /** True only when this atomic fact replaces or cancels prior state. */
-    correction?: boolean;
-    category: LongTermMemoryCategory;
-    importance: number;
-    confidence: number;
-    eventDate?: string;
-    evidenceKind: "direct_user_statement" | "inference";
-    scope: "global" | "project" | "session";
-    entity: string;
-    predicate: string;
-    relation: MemoryClaimRelation;
-    value: Record<string, unknown>;
-}
-export interface ImplicitExtractionDeps {
-    /** Local memory provider for writing extracted facts. */
-    localProvider: MemoryWriter;
-    /** User ID. */
-    userId: string;
-    /** Logger. */
-    log: {
-        debug(msg: string): void;
-        warn(msg: string): void;
-    };
-    /**
-     * LLM invocation function (uses background/cheap model).
-     * Returns structured JSON string or null if unavailable.
-     */
-    llmExtract?: (prompt: string, signal?: AbortSignal) => Promise<string | null>;
-    signal?: AbortSignal;
-    sessionId?: string;
-    /** Durable Host extraction-job id used to make preemption/restart replay idempotent. */
-    idempotencyNamespace?: string;
-}
-export interface TurnPair {
-    priorUserMessage?: string;
-    userMessage: string;
-    assistantMessage: string;
-}
-/**
- * Use a lightweight LLM to extract structured facts from a turn pair.
- */
-export declare function extractFactsViaLlm(turn: TurnPair, llmExtract: (prompt: string) => Promise<string | null>, today: string, onDiagnostic?: (message: string) => void, existingClaims?: readonly ExtractedFact[]): Promise<ExtractedFact[]>;
-/**
- * Run the full implicit extraction pipeline for a completed turn.
- * This is async and non-blocking — call it after turn.end.
- *
- * @returns Number of facts extracted and stored
- */
-export declare function runImplicitExtraction(turn: TurnPair, deps: ImplicitExtractionDeps): Promise<number>;

package/dist/types/runtime/memory/memory-recall-attribution.d.ts

@@ -1,24 +0,0 @@
-export type MemoryRecallUsage = "used" | "not_used" | "uncertain";
-export type MemoryRecallEffect = "helpful" | "neutral" | "harmful" | "uncertain";
-export interface MemoryRecallAttribution {
-    usage: MemoryRecallUsage;
-    effect: MemoryRecallEffect;
-    usedMemoryIds: string[];
-    rationale: string;
-}
-export interface MemoryRecallAttributionInput {
-    query: string;
-    response: string;
-    memories: Array<{
-        id: string;
-        content: string;
-        recallPacket?: unknown;
-    }>;
-}
-/**
- * Builds a background semantic-assessment task. This deliberately asks for
- * causal use of evidence rather than lexical overlap, so paraphrases and
- * repeated topic words do not become fabricated positive feedback.
- */
-export declare function buildMemoryRecallAttributionPrompt(input: MemoryRecallAttributionInput): string;
-export declare function parseMemoryRecallAttribution(raw: string | null | undefined): MemoryRecallAttribution | null;

package/dist/types/runtime/ports/memory-provider.d.ts

@@ -1,219 +0,0 @@
-import type { MemoryWriter } from "./memory-writer.js";
-import type { MemoryClaimRelation } from "../../host-contract/memory-category.js";
-export interface MemorySearchOptions {
-    limit?: number;
-    llmConfig?: unknown;
-    /** Foreground-turn identity. When present, Host records every considered
-     * candidate and applies the task-relevance injection decision. */
-    recallContext?: {
-        sessionId: string;
-        turnId: string;
-    };
-    /** Drop hits whose tags contain ALL strings of any group (resident-layer exclusion). */
-    excludeTagGroups?: string[][];
-}
-export interface MemorySearchResult {
-    id: string;
-    content: string;
-    score: number;
-    source?: string;
-    metadata?: Record<string, unknown>;
-}
-export interface MemoryIngestOptions {
-    llmConfig?: unknown;
-    source?: string;
-    sessionId?: string;
-    /** Transport-only cancellation; adapters must not serialize this into Host business params. */
-    requestSignal?: AbortSignal;
-}
-export interface MemoryExtractionItem {
-    text: string;
-    category?: string;
-    importance?: number;
-    confidence?: number;
-    source?: string;
-    event_date?: string;
-    tags?: string[];
-    /** Atomic claim identity produced by the evidence extractor and validated again by Host. */
-    claim?: {
-        scope: "global" | "project" | "session";
-        entity: string;
-        predicate: string;
-        relation: MemoryClaimRelation;
-        value: Record<string, unknown>;
-    };
-    /** Ids of already-uploaded attachments to link to this memory on commit. */
-    attachmentIds?: string[];
-    /** Evidence audit trail: source refs, optional verbatim quote, and a crash-safe dedup key. */
-    evidence?: {
-        kind: string;
-        refs: string[];
-        idempotencyKey: string;
-        quote?: string;
-    };
-    /** The source turn explicitly retracts or replaces an earlier decision. */
-    correction?: boolean;
-}
-export interface MemoryConsolidationWriteResult {
-    memoriesAdded?: number;
-    observationsAdded?: number;
-    proposalsAdded?: number;
-    claimsAdded?: number;
-    conflictsAdded?: number;
-    claimIds?: string[];
-    conflictIds?: string[];
-    /** [A4] ingestExtracted 结构化回执:与入参同序、含被安全闸拒的项;created 带真实落库
-     * memoryId;merged(近重复合并)是合法成功不是失败。可重试失败不在带内(RPC 抛错即
-     * 调用方的重试通道)。可选:同一类型还约束 observe/propose 返回体,消费处按缺失兜底。 */
-    items?: Array<{
-        text: string;
-        outcome: "created" | "merged" | "conflicted" | "pending" | "rejected";
-        memoryId?: string;
-    }>;
-}
-export interface MemoryProvider {
-    readonly providerId: string;
-    search(query: string, userId: string, options?: MemorySearchOptions): Promise<MemorySearchResult[]>;
-    remove?(memoryId: string): Promise<boolean>;
-}
-export interface MemoryLearningSink {
-    ingestExtracted(items: MemoryExtractionItem[], userId: string, options?: MemoryIngestOptions): Promise<MemoryConsolidationWriteResult>;
-}
-export interface MemoryActivitySummary {
-    dailyCounts: Array<{
-        date: string;
-        count: number;
-    }>;
-    highlights: Array<{
-        text: string;
-        category: string;
-        importance: number;
-        date: string;
-    }>;
-}
-/** Lightweight attachment reference carried on atlas/detail records (no bytes). */
-export interface MemoryAtlasAttachmentRef {
-    id: string;
-    kind: string;
-    filename: string;
-    mimeType: string;
-    size: number;
-    url: string;
-}
-export interface MemoryAtlasRecord {
-    id: string;
-    text: string;
-    category?: string;
-    importance?: number;
-    confidence?: number;
-    source?: string;
-    sessionId?: string;
-    eventDate?: string;
-    tags?: string[];
-    createdAt?: string | number;
-    updatedAt?: string | number;
-    accessCount?: number;
-    lastAccessedAt?: string | number;
-    isArchived?: boolean;
-    attachments?: MemoryAtlasAttachmentRef[];
-}
-export interface MemoryAtlasResult {
-    totalCount?: number;
-    records?: MemoryAtlasRecord[];
-    buckets?: unknown[];
-    clusters?: unknown[];
-    windowCursor?: unknown;
-    timeRange?: unknown;
-}
-export interface MemoryUpdatePatch {
-    text?: string;
-    category?: string;
-    importance?: number;
-    source?: string;
-    eventDate?: string;
-    tags?: string[];
-}
-export interface MemoryHandlerProvider extends MemoryProvider {
-    /** B3(X7)异步化:Host 契约方法(host 模式经 x/host.request 跨进程)。 */
-    getAtlas?(userId: string, options?: Record<string, unknown>): Promise<MemoryAtlasResult>;
-    /** B3(X7)异步化:Host 契约方法。 */
-    getActivitySummary?(userId: string, days: number): Promise<MemoryActivitySummary>;
-    observeExtracted?(items: MemoryExtractionItem[], userId: string, options?: MemoryIngestOptions): Promise<MemoryConsolidationWriteResult>;
-    proposeExtracted?(items: MemoryExtractionItem[], userId: string, options?: MemoryIngestOptions): Promise<MemoryConsolidationWriteResult>;
-    ingestExtracted?(items: MemoryExtractionItem[], userId: string, options?: MemoryIngestOptions): Promise<MemoryConsolidationWriteResult>;
-    update?(id: string, patch: MemoryUpdatePatch): Promise<boolean>;
-    /** Persist an uploaded attachment (orphan until linked at commit). */
-    adoptAttachment?(input: {
-        data?: Buffer;
-        sourceUrl?: string;
-        filename: string;
-        mimeType: string;
-        userId: string;
-    }): Promise<MemoryAtlasAttachmentRef>;
-    /** Resolve an attachment id to its on-disk path (for serving). */
-    locateAttachment?(id: string): Promise<{
-        absPath: string;
-        mimeType: string;
-        filename: string;
-    } | null>;
-    /** Drop uploads never saved to a memory. */
-    purgeOrphanAttachments?(): Promise<void>;
-    /** Read an attachment's bytes + mime (for multimodal understanding). */
-    readAttachmentBytes?(id: string): Promise<{
-        bytes: Buffer;
-        mimeType: string;
-    } | null>;
-    /** Persist understood/extracted text on an attachment row. */
-    setAttachmentText?(id: string, text: string): void;
-    /** Factual proposals for the candidate surface: pending (default) awaiting
-     * corroboration, or expired (read-only history of what timed out). */
-    listPendingProposals?(userId: string, limit?: number, status?: "pending" | "expired"): Array<{
-        id: string;
-        text: string;
-        category: string;
-        importance: number;
-        confidence: number;
-        source: string;
-        tags: string[];
-        createdAt: number;
-    }>;
-    /** UI resolution of one pending proposal: confirm commits it with manual authority; dismiss rejects it. */
-    resolveProposal?(userId: string, proposalId: string, action: "confirm" | "dismiss"): Promise<boolean>;
-    /** Evidence-laddered backlog consumption (corroborated commit / feedback solo / TTL expiry). */
-    consumePendingProposals?(userId: string): Promise<{
-        committed: number;
-        merged: number;
-        expiredIds: string[];
-        pendingLeft: number;
-    }>;
-}
-export interface MemoryDreamProvider {
-    search(query: string, userId: string, options?: {
-        limit?: number;
-    }): Promise<MemorySearchResult[]>;
-    proposeExtracted?(items: MemoryExtractionItem[], userId: string, options?: {
-        sessionId?: string;
-        source?: string;
-    }): Promise<{
-        proposalsAdded?: number;
-    }>;
-    feedback?(memoryIds: string[], signal: "useful" | "irrelevant" | "outdated" | "wrong", context?: {
-        sessionId?: string;
-        silent?: boolean;
-    }): Promise<{
-        affected: number;
-    }>;
-    /** B3(X7)异步化:以下 Host 契约方法签名统一 Promise(host 模式经 x/host.request 跨进程)。 */
-    getActivitySummary?(userId: string, days?: number): Promise<MemoryActivitySummary>;
-    synthesizeTimeline?(userId: string, startMs: number, endMs: number): Promise<string>;
-    getProfile?(userId: string, key: string): string | null;
-    setProfile?(userId: string, key: string, value: string): Promise<void>;
-    getAllProfiles?(userId: string): Promise<Record<string, string>>;
-}
-export interface MemoryDecayProvider {
-    triggerDecay(userId: string): Promise<{
-        decayed: number;
-    }>;
-}
-export type MemoryRuntimeHookProvider = MemoryProvider & MemoryWriter;
-export type MemoryDreamRuntimeProvider = MemoryDreamProvider & MemoryDecayProvider;