qlogicagent 2.20.6 → 2.20.8

package/dist/types/protocol/wire/notification-payloads.d.ts

@@ -11,6 +11,8 @@
  * 3. Add event name string in agent-events.ts (if WS-relayed)
  */
 import type { DelegationError } from "./gateway-rpc.js";
+import type { ThreadItem, ThreadItemEvent } from "../../host-contract/index.js";
+import type { ToolIdentity } from "./chat-types.js";
 /** Identifies which agent produced this notification (main or teammate). */
 export interface AgentSource {
     id: string;
@@ -25,21 +27,11 @@ export interface WireTokenUsage {
     cacheRead?: number;
     cacheWrite?: number;
 }
-/** Embedded thread item for clients using the Thread protocol. */
-export interface NotificationThreadItem {
-    id: string;
-    type: string;
-    role: "user" | "assistant" | "system";
-    text?: string;
-    toolName?: string;
-    toolCallId?: string;
-    arguments?: string;
-    output?: string;
-    approved?: boolean;
-    strategy?: string;
-    createdAt: string;
-}
-export type MediaResultType = "image" | "tts" | "video" | "music" | "3d";
+/** Embedded canonical item; never a second notification-only item shape. */
+export type NotificationThreadItem = ThreadItem;
+/** One live notification carrying the exact envelope written to the Host journal. */
+export type ThreadItemNotification = ThreadItemEvent;
+export type MediaResultType = "image" | "tts" | "video" | "music" | "3d" | "file";
 export type ArtifactType = "code" | "file" | "image" | "document" | "diagram" | "table";
 /** Turn started — always emitted first. */
 export interface TurnStartNotification {
@@ -81,6 +73,16 @@ export interface TurnRecoveryNotification {
     detail?: string;
     item?: NotificationThreadItem;
 }
+/**
+ * 作废本回合已发出但随后被丢弃的助手文本(后缀截断)。语义与边界见
+ * `contracts/turn-event.ts` 的 `text_rollback` 变体;消费端只执行截断,不推断截断点。
+ */
+export interface TurnTextRollbackNotification {
+    turnId: string;
+    /** 保留的助手文本长度,UTF-16 code unit,按全部文本段逻辑拼接计算。 */
+    keepLength: number;
+    reason: string;
+}
 export type TurnFileChangeStatus = "added" | "modified" | "deleted" | "renamed" | "moved" | "copied" | "unchanged";
 export interface TurnFileChangeRecord {
     path: string;
@@ -112,6 +114,7 @@ export interface TurnToolCallNotification {
     turnId: string;
     callId: string;
     name: string;
+    displayName?: string;
     arguments?: string;
     inputSummary?: string;
     item?: NotificationThreadItem;
@@ -177,6 +180,8 @@ export interface TurnMemoryRecallNotification {
     count: number;
     /** Truncated texts of the memories actually injected (post-cap), for the expanded list. */
     titles: string[];
+    /** Content-free canonical memory ids used to compare evidence across recall routes. */
+    memoryIds?: string[];
     /** Content-free identifiers for the injected memory layers. */
     sources?: string[];
 }
@@ -240,64 +245,12 @@ export interface TurnMediaResultNotification {
     width?: number;
     height?: number;
     mimeType?: string;
+    filename?: string;
+    size?: number;
     billingUnit?: string;
     billingQuantity?: number;
     taskId?: string;
 }
-/** Async media generation progress. */
-export interface TurnMediaProgressNotification {
-    turnId: string;
-    taskId: string;
-    mediaType: MediaResultType;
-    percent: number;
-    status: string;
-    provider?: string;
-}
-/** Structured media provider usage for non-token billed image/video/audio calls. */
-export interface TurnMediaUsageNotification {
-    usageId: string;
-    turnId: string;
-    mediaType: MediaResultType | string;
-    provider: string;
-    model: string;
-    billingUnit: string;
-    billingQuantity: number;
-}
-/** Capability preflight decision for media requests. */
-export interface TurnMediaCapabilityCheckNotification {
-    turnId: string;
-    mediaType: MediaResultType | string;
-    provider: string;
-    model: string;
-    mode: string;
-    allowed: boolean;
-    reason?: string;
-    capabilities: {
-        modes: string[];
-        source: string;
-        limits: Record<string, unknown>;
-        features: Record<string, unknown>;
-    };
-}
-/** Media files auto-downloaded to local storage. */
-export interface TurnMediaPersistedNotification {
-    turnId: string;
-    files: Array<{
-        remoteUrl: string;
-        localPath: string;
-        bytes: number;
-        mimeType: string;
-    }>;
-    /**
-     * URLs that FAILED to persist locally this turn (result keeps the remote URL / dangling temp
-     * path, which may expire). Present only when at least one file failed — persistence stays
-     * fail-open, but the degradation is surfaced instead of silently swallowed.
-     */
-    failures?: Array<{
-        remoteUrl: string;
-        error?: string;
-    }>;
-}
 /** Task state change. */
 export interface TurnTaskUpdatedNotification {
     turnId: string;
@@ -351,9 +304,32 @@ export interface TurnHeartbeatNotification {
     message: string;
 }
 /** Structured telemetry for a tool use batch. */
+export interface ToolCallExecutionEvidence {
+    sequence: number;
+    callId: string;
+    name: string;
+    identity: ToolIdentity;
+    status: "running" | "succeeded" | "failed" | "blocked";
+    arguments?: string;
+    error?: string;
+    failureKind?: "policy_blocked" | "semantic_quality_failed" | "timeout" | "mcp_start_failed" | "mcp_unavailable" | "tool_execution_failed";
+}
+export interface FinalAnswerEvidence {
+    schemaVersion: 1;
+    requirement: "not-required" | "fresh-tool-evidence";
+    disposition: "not-required" | "grounded" | "blocked-no-tool-evidence" | "blocked-no-successful-evidence";
+    successfulCallIds: string[];
+    failedCallIds: string[];
+    blockedCallIds: string[];
+    reason: string;
+}
 export interface TurnToolUseSummaryNotification {
     turnId: string;
-    telemetrySource?: "agent" | "agent-synthetic";
+    telemetrySource?: "agent";
+    ledgerSchemaVersion: 4;
+    toolCalls: ToolCallExecutionEvidence[];
+    routingEvidence?: CapabilityRoutingEvidence;
+    finalAnswerEvidence: FinalAnswerEvidence;
     availableToolNames: string[];
     enabledToolNames: string[];
     toolCallNames: string[];
@@ -363,16 +339,28 @@ export interface TurnToolUseSummaryNotification {
     }>;
 }
 /** Structured telemetry for why the enabled tool surface changed within a turn. */
+export interface CapabilityRoutingEvidence {
+    schemaVersion: 1;
+    owner: "structured-planner" | "direct-response" | "mcp-capability" | "typed-builtin" | "pinned-skill" | "host-skill-discovery";
+    source: "structured-planner" | "direct-response" | "semantic-directory" | "continuation" | "explicit" | "semantic-web-evidence" | "typed-directory" | "typed-builtin" | "pinned-skill" | "host-skill-discovery";
+    selectedNamespaces: string[];
+    matchedFeatures: string[];
+    score?: number;
+    runnerUpScore?: number;
+    availableToolCount: number;
+    exposedToolCount: number;
+}
 export interface TurnToolSelectionPolicyNotification {
     turnId: string;
     policyId: string;
-    intent: "benchmark_state_maintenance" | "fresh_evidence" | "verification" | "final_answer" | "tool_recovery" | "lifecycle_reconciliation";
+    intent: "capability_routing" | "benchmark_state_maintenance" | "fresh_evidence" | "verification" | "final_answer" | "tool_recovery" | "lifecycle_reconciliation";
     reason: string;
     availableToolNames: string[];
     enabledToolNamesBefore: string[];
     enabledToolNamesAfter: string[];
     suppressedToolNames: string[];
     nextAction: string;
+    routingEvidence?: CapabilityRoutingEvidence;
 }
 /** Queryable long-horizon turn lifecycle telemetry. */
 export interface TurnLifecycleNotification {
@@ -642,6 +630,17 @@ export interface ProductTaskFailedNotification {
     attempt: number;
     terminalState: "failed" | "cancelled";
 }
+/** Automatic abnormal-worker handoff receipt for one stable task. */
+export interface ProductTaskHandoffNotification {
+    productId: string;
+    taskId: string;
+    from: string;
+    to: string;
+    reason: string;
+    /** Attempt number that the replacement worker will execute. */
+    attempt: number;
+    timestamp: string;
+}
 /** Product checkpoint saved. */
 export interface ProductCheckpointedNotification {
     productId: string;
@@ -930,47 +929,6 @@ export interface WorkflowRunFailedNotification {
     error: string;
     outcome?: unknown;
 }
-export interface GoalRunStateChangedNotification {
-    goalRunId: string;
-    status: "running" | "ended";
-    pauseState: "running" | "draining" | "paused";
-    endReason?: "done" | "stopped" | "failed";
-}
-export interface GoalPhaseBoundaryNotification {
-    goalRunId: string;
-    phaseIndex: number;
-    deltas: {
-        criterionId: string;
-        newStatus: string;
-    }[];
-    nextPreview?: string;
-    migrationNote?: string;
-}
-export interface GoalGoalEditedNotification {
-    goalRunId: string;
-    newVersion: number;
-}
-export interface GoalMessageQueuedNotification {
-    goalRunId: string;
-    queuedCount: number;
-}
-export interface GoalAcceptanceUpdatedNotification {
-    goalRunId: string;
-    criterionId: string;
-    status: string;
-}
-export interface GoalRoundMessageNotification {
-    goalRunId: string;
-    message: {
-        messageId: string;
-        platform: string;
-        userId?: string;
-        type: string;
-        content: string;
-        timestamp: string;
-        source: string;
-    };
-}
 export interface MentionDelegateStartedNotification {
     parentSessionId: string;
     parentMessageId: string;
@@ -1014,6 +972,7 @@ export interface NotificationMethodMap {
     "turn.end": TurnEndNotification;
     "turn.error": TurnErrorNotification;
     "turn.recovery": TurnRecoveryNotification;
+    "turn.text_rollback": TurnTextRollbackNotification;
     "turn.file_changes": TurnFileChangesNotification;
     "turn.tool_call": TurnToolCallNotification;
     "turn.tool_result": TurnToolResultNotification;
@@ -1033,10 +992,6 @@ export interface NotificationMethodMap {
     "turn.subagent_decision": TurnSubagentDecisionNotification;
     "turn.annotations": TurnAnnotationsNotification;
     "turn.media_result": TurnMediaResultNotification;
-    "turn.media_progress": TurnMediaProgressNotification;
-    "turn.media_usage": TurnMediaUsageNotification;
-    "turn.media_capability_check": TurnMediaCapabilityCheckNotification;
-    "turn.media_persisted": TurnMediaPersistedNotification;
     "turn.task_updated": TurnTaskUpdatedNotification;
     "turn.todos_updated": TurnTodosUpdatedNotification;
     "task.updated": TaskUpdatedNotification;
@@ -1060,6 +1015,7 @@ export interface NotificationMethodMap {
     "session.recovery_pending": SessionRecoveryPendingNotification;
     "permission.rule_updated": PermissionRuleUpdatedNotification;
     "team.member.notification": TeamMemberNotification;
+    "thread.item": ThreadItemNotification;
     "turn.usage_update": TurnUsageUpdateNotification;
     "pong": PongNotification;
     "solo.progress": SoloProgressNotification;
@@ -1071,6 +1027,7 @@ export interface NotificationMethodMap {
     "product.taskStarted": ProductTaskStartedNotification;
     "product.taskCompleted": ProductTaskCompletedNotification;
     "product.taskFailed": ProductTaskFailedNotification;
+    "product.taskHandoff": ProductTaskHandoffNotification;
     "product.checkpointed": ProductCheckpointedNotification;
     "product.budgetWarning": ProductBudgetWarningNotification;
     "product.budgetExceeded": ProductBudgetExceededNotification;
@@ -1086,12 +1043,6 @@ export interface NotificationMethodMap {
     "product.leaderMessage": ProductLeaderMessageNotification;
     "product.planningAsk": ProductPlanningAskNotification;
     "plan.interrupted": PlanInterruptedNotification;
-    "goal.run_state_changed": GoalRunStateChangedNotification;
-    "goal.phase_boundary": GoalPhaseBoundaryNotification;
-    "goal.goal_edited": GoalGoalEditedNotification;
-    "goal.message_queued": GoalMessageQueuedNotification;
-    "goal.acceptance_updated": GoalAcceptanceUpdatedNotification;
-    "goal.round_message": GoalRoundMessageNotification;
     "mention.delegate_started": MentionDelegateStartedNotification;
     "mention.delegate_activity": MentionDelegateActivityNotification;
     "mention.delegate_settled": MentionDelegateSettledNotification;

package/dist/types/protocol/wire/thread-protocol.d.ts

@@ -1,42 +1,6 @@
-/**
- * Thread Protocol — Codex app-server style three-layer abstraction.
- *
- * Thread → Turn → Item
- *
- *  Thread: persistent conversation container (maps to a session)
- *  Turn: one user request → agent response cycle
- *  Item: individual components within a turn (message, tool_call, tool_result, etc.)
- *
- * This module defines the wire types. The existing `agent.turn` RPC continues
- * to work; these types provide the foundation for `thread/*` methods.
- */
-export type ItemType = "message" | "tool_call" | "tool_result" | "tool_blocked" | "recovery" | "plan_update";
-export type ItemRole = "user" | "assistant" | "system";
-/** A single atomic event within a turn. */
-export interface ThreadItem {
-    /** Unique item ID. */
-    id: string;
-    /** Item type (discriminator). */
-    type: ItemType;
-    /** Role of the actor. */
-    role: ItemRole;
-    /** Text content (for message items). */
-    text?: string;
-    /** Tool name (for tool_call / tool_result items). */
-    toolName?: string;
-    /** Tool call ID (LLM-assigned). */
-    toolCallId?: string;
-    /** Serialized arguments (for tool_call). */
-    arguments?: string;
-    /** Tool output (for tool_result). */
-    output?: string;
-    /** Whether the tool was approved. */
-    approved?: boolean;
-    /** Recovery strategy used (for recovery items). */
-    strategy?: string;
-    /** Timestamp (ISO 8601). */
-    createdAt: string;
-}
+/** Thread/Turn containers and RPC shapes. The Item envelope itself is owned by Host contract. */
+import type { ThreadItem } from "../../host-contract/index.js";
+export type { ThreadItem, ThreadItemDomain, ThreadItemEvent, ThreadItemRole, ThreadItemState, ThreadItemType, } from "../../host-contract/index.js";
 export type TurnStatus = "pending" | "in_progress" | "completed" | "failed" | "aborted";
 /** Represents one user request → agent response cycle. */
 export interface ThreadTurn {
@@ -82,7 +46,7 @@ export interface Thread {
     lastActiveAt: string;
 }
 /**
- * `initialize` request params — superset of agent.hello.
+ * `initialize` request params.
  * Sent by host as the first message after transport connects.
  */
 export interface InitializeParams {

package/dist/types/runtime/community/community-consent-client.d.ts

@@ -1,16 +1,5 @@
 import type { ConfigPort } from "../ports/index.js";
 import type { HostCommunityClient } from "../../transport/host-community-client.js";
-export interface CommunityRuntimeResolution {
-    id: string;
-    platform: string;
-    version: string;
-    downloadUrl: string;
-    /** sha256 hex digest — verified client-side before placing the binary. */
-    checksum: string;
-    sizeBytes: number;
-    format: "executable" | "zip" | "tar.gz";
-    entrypoint?: string;
-}
 export type CommunityInstallRiskTier = "R0" | "R1" | "R2" | "R3";
 export type CommunityInstallSourceTier = "official" | "community";
 export type CommunityInstallTrustStage = "quarantine" | "trial" | "trusted";
@@ -59,8 +48,6 @@ export interface CommunityConsentClient {
     /** List a resource's published versions for the version/rollback menu (WS-B3). The
      *  default client always implements it; optional so lightweight mocks may omit it. */
     listResourceVersions?(resourceId: string): Promise<CommunityResourceVersion[]>;
-    /** Resolve a vetted runtime binary (e.g. officecli) for this platform → Hub-signed download. */
-    resolveRuntime(id: string, platform: string): Promise<CommunityRuntimeResolution>;
 }
 export declare function createCommunityConsentClient(options: CommunityConsentClientOptions): CommunityConsentClient;
 /** Supervised desktop path: the Runtime Host owns refresh and performs authenticated Hub reads. */

package/dist/types/runtime/context/context-compression-strategies.d.ts

@@ -1,9 +1,16 @@
+import type { ContextAnchor } from "../../protocol/wire/chat-types.js";
 export interface CompressibleMessage {
     role: string;
     content?: string | unknown;
     tool_call_id?: string;
     tool_calls?: unknown;
     name?: string;
+    /** Optional canonical protocol coordinates used by compaction receipts. */
+    threadId?: string;
+    turnId?: string;
+    itemId?: string;
+    /** Structured anchors survive compaction without relying on prose reconstruction. */
+    contextAnchors?: ContextAnchor[];
 }
 export interface CompressionResult {
     messages: CompressibleMessage[];
@@ -36,6 +43,28 @@ export interface AsyncCompressionStrategy extends CompressionStrategy {
 export declare function isAsyncCompressionStrategy(s: CompressionStrategy): s is AsyncCompressionStrategy;
 /** Caller-provided LLM summarization function (wired by Hub). */
 export type SummarizeFn = (messages: CompressibleMessage[], instruction: string) => Promise<string>;
+export declare const CONTEXT_CAPSULE_MARKER = "[Context capsule v1]";
+export interface ContextCompactionReceipt {
+    version: 1;
+    sourceMessageCount: number;
+    sourceItemIds: string[];
+    firstItemId?: string;
+    lastItemId?: string;
+    priorDigest?: string;
+    tokensBefore: number;
+    digest: string;
+}
+export interface ContextCapsule {
+    receipt: ContextCompactionReceipt;
+    state: {
+        summary: string;
+        userRequests: string[];
+        anchors: Partial<Record<ContextAnchor["category"], string[]>>;
+    };
+}
+/** Compression is a persistence boundary: credentials are redacted before any LLM or capsule sees them. */
+export declare function redactCompressionSecrets(input: string): string;
+export declare function parseContextCapsule(message: CompressibleMessage | undefined): ContextCapsule | undefined;
 export declare class SlidingWindowStrategy implements CompressionStrategy {
     private estimateTokens;
     constructor(estimateTokens: (msg: CompressibleMessage) => number);

package/dist/types/runtime/context/context-envelope.d.ts

@@ -0,0 +1,3 @@
+import type { ContextEnvelope } from "../../protocol/wire/chat-types.js";
+/** Validate, bound and redact the Host context before it enters a transcript or compaction capsule. */
+export declare function sanitizeContextEnvelope(input: unknown): ContextEnvelope | undefined;

package/dist/types/runtime/execution/dream-agent.d.ts

@@ -69,8 +69,8 @@ export interface DreamRunResult {
  * Allowed:
  *   - read_file, grep, glob, search — unrestricted read-only tools
  *   - bash — only read-only commands (ls, grep, cat, find, stat, wc, head, tail)
- *   - memory — the memdir writer (routes through the gateway projectMemory proxy)
- *   - raw write/edit/patch — denied (memory writes must go through the `memory` tool)
+ *   - Host project_memory MCP tool — the sole project-memory writer
+ *   - raw write/edit/patch — denied (project-memory writes stay Host-owned)
  *   - Everything else — denied
  */
 export declare function canUseDreamTool(memoryRoot: string, restriction: DreamToolRestriction): DreamToolVerdict;
@@ -78,9 +78,8 @@ export declare function canUseDreamTool(memoryRoot: string, restriction: DreamTo
  * Canonical catalog tool names advertised to the dream sub-agent. This trims the
  * full manifest (dozens of irrelevant tools) down to what dream actually uses.
  * Every name here MUST be allowed by canUseDreamTool — raw write/edit/patch are
- * intentionally absent (canUseDreamTool hard-denies them); the `memory` tool is
- * the sole sanctioned memdir writer and routes through the gateway proxy
- * (dream-memdir-migration).
+ * intentionally absent (canUseDreamTool hard-denies them); Host project memory
+ * is the sole sanctioned memdir writer.
  */
 export declare const DREAM_ALLOWED_TOOLS: Set<string>;
 /**

package/dist/types/runtime/execution/mcp-capability-selection.d.ts

@@ -0,0 +1,54 @@
+import type { ChatMessage, LLMTransport, ToolDefinition } from "../../agent/types.js";
+export interface CapabilityRouterClient {
+    transport: LLMTransport;
+    apiKey: string;
+    model: string;
+}
+export interface McpCapabilitySelection {
+    aliases: string[];
+    toolNames: ReadonlySet<string>;
+    source: "semantic-directory";
+    evidence: {
+        namespaces: string[];
+        matchedFeatures: string[];
+    };
+}
+export type McpCapabilityRoutingOutcome = {
+    status: "selected";
+    selection: McpCapabilitySelection;
+} | {
+    status: "none";
+    reason: string;
+} | {
+    status: "ambiguous";
+    reason: string;
+} | {
+    status: "unavailable";
+    reason: string;
+};
+export interface ResolveMcpCapabilitySelectionInput {
+    userText: string;
+    messages: readonly ChatMessage[];
+    tools: readonly ToolDefinition[];
+    client: CapabilityRouterClient | null;
+    signal?: AbortSignal;
+}
+/**
+ * Select optional MCP capabilities using a model over the live structured tool
+ * directory and recent conversation. No user-text keyword, alias, regular
+ * expression, or connector-name gate participates in the decision.
+ *
+ * When routing is unavailable, invalid, or uncertain, this function abstains.
+ * The caller then exposes the complete authorized tool surface so the primary
+ * model can still make its native semantic choice; an optimization failure must
+ * never turn an installed capability into an apparent absence.
+ */
+export declare function resolveMcpCapabilitySelection(input: ResolveMcpCapabilitySelectionInput): Promise<McpCapabilitySelection | undefined>;
+/**
+ * Resolve one semantic routing attempt without collapsing abstention, ambiguity,
+ * invalid output, and transport failure into the same undefined value. Callers
+ * can use this typed outcome to request a semantic second opinion without
+ * adding text classifiers or connector-specific fallbacks.
+ */
+export declare function resolveMcpCapabilityRoute(input: ResolveMcpCapabilitySelectionInput): Promise<McpCapabilityRoutingOutcome>;
+export declare function selectCapabilityToolSurface(tools: readonly ToolDefinition[], selection: McpCapabilitySelection | undefined): ToolDefinition[];

package/dist/types/runtime/execution/memory-decay.d.ts

@@ -67,7 +67,7 @@ export interface DecayCycleResult {
  *
  * Lifecycle:
  *   1. Check time gate (24h default)
- *   2. Call local memory provider decay
+ *   2. Call the Host-backed memory provider
  *   3. Mark completion timestamp
  */
 export declare function runDecayCycle(deps: DecayCycleDeps): Promise<DecayCycleResult>;

package/dist/types/runtime/execution/search-result-quality.d.ts

@@ -0,0 +1,22 @@
+export type SearchResultQuality = {
+    status: "pass";
+    matchedAnchors: string[];
+    authority: "matched" | "not-requested";
+} | {
+    status: "fail";
+    requiredAnchors: string[];
+    reason: "top-result-anchor-miss" | "authoritative-source-unresolved" | "no-results" | "typed-quality-missing";
+} | {
+    status: "indeterminate";
+    reason: "not-astra-search" | "typed-indeterminate";
+};
+/**
+ * Consumes qlogic-web-core's typed search-owner verdict. Agent execution does
+ * not rerank results or recreate query semantics; a missing verdict from the
+ * first-party Astra Search contract fails closed instead of activating a
+ * second consumer-side quality policy.
+ */
+export declare function assessSearchResultQuality(input: {
+    toolName: string;
+    payload: unknown;
+}): SearchResultQuality;

package/dist/types/runtime/execution/streaming-tool-executor.d.ts

@@ -30,6 +30,8 @@ export interface StreamingToolExecutorConfig {
     sessionId: string;
     /** Turn workspace/cwd - routes oversized tool-result spillover to the session data dir. */
     projectRoot?: string;
+    /** Per-turn typed context budget and required skill-resource state. */
+    contextState?: unknown;
     turnId: string;
     log: AgentLogger;
     signal?: AbortSignal;

package/dist/types/runtime/execution/tool-result-storage.d.ts

@@ -36,6 +36,36 @@ export declare const TOOL_RESULT_CLEARED_MESSAGE = "[Old tool result content cle
 export type ContentReplacementState = {
     seenIds: Set<string>;
     replacements: Map<string, string>;
+    contextPolicies: Map<string, ToolResultContextPolicy>;
+    contextSizes: Map<string, number>;
+    skillReadiness: Map<string, SkillReadinessActivation>;
+};
+export type ToolResultContextPolicy = {
+    kind: "skill_core" | "skill_resource" | "data";
+    retention: "required" | "compactable";
+    budgetClass: "instructions" | "evidence" | "bulk";
+};
+export type ToolResultContextBudget = {
+    maxItemChars: number;
+    maxAggregateChars: number;
+};
+type SkillReadinessResource = {
+    path: string;
+    label: string;
+    requiresNext?: boolean;
+};
+type SkillReadinessSet = {
+    id: string;
+    minReads: number;
+    resources: SkillReadinessResource[];
+};
+type PendingSkillReadinessSet = SkillReadinessSet & {
+    readPaths: Set<string>;
+    nextSets: SkillReadinessSet[];
+};
+type SkillReadinessActivation = {
+    skillName: string;
+    pendingSets: PendingSkillReadinessSet[];
 };
 export type PersistedToolResult = {
     filepath: string;
@@ -44,6 +74,20 @@ export type PersistedToolResult = {
     hasMore: boolean;
 };
 export declare function createContentReplacementState(): ContentReplacementState;
+export declare function toolResultContextPolicy(details: Record<string, unknown> | undefined): ToolResultContextPolicy;
+export declare function toolResultContextBudget(policy: ToolResultContextPolicy): ToolResultContextBudget;
+export declare function requiredContextBudgetViolation(state: ContentReplacementState | undefined, details: Record<string, unknown> | undefined, contentSize: number): string | undefined;
+export declare function registerToolResultContext(state: ContentReplacementState | undefined, toolCallId: string, details: Record<string, unknown> | undefined, contentSize?: number): void;
+export declare function skillReadinessBlockReason(state: ContentReplacementState | undefined, toolName: string): string | undefined;
+/**
+ * Re-apply required Host instruction context after generic compression stages.
+ * Existing tool messages are restored in place; if a whole tool exchange was removed,
+ * a system capsule is inserted so wire-level tool-call pairing stays valid.
+ */
+export declare function restoreRequiredContextMessages(messagesBefore: MessageLike[], messagesAfter: MessageLike[], state: ContentReplacementState): {
+    messages: MessageLike[];
+    recoveredCount: number;
+};
 export declare function generatePreview(content: string, maxBytes: number): {
     preview: string;
     hasMore: boolean;

package/dist/types/runtime/hooks/memory-hooks.d.ts

@@ -79,8 +79,9 @@ export declare function createMemoryPrefetchState(): MemoryPrefetchState;
  *   - memory.after_recall: reuse accounting off the post-cap injected ids + log
  *
  * CC parity additions:
- *   - LRU dedup via surfacedPaths (filterDuplicateMemoryAttachments)
- *   - Session byte limit (MAX_SESSION_BYTES = 60KB)
+ *   - Repeated L2 evidence remains available on every turn; surfacedPaths only
+ *     prevents charging the unique-session byte budget twice for the same id
+ *   - Unique session byte limit (MAX_SESSION_BYTES = 60KB)
  *   - Async prefetch (non-blocking promise, abort-aware)
  *
  * Returns a cleanup function to unregister.

package/dist/types/runtime/infra/agent-paths.d.ts

@@ -40,8 +40,6 @@ export declare function ensureUserAgentHome(): string;
 export declare function getUserCredentialsPath(): string;
 /** `~/.qlogicagent/plugins/` — device-scoped. */
 export declare function getUserPluginsDir(): string;
-/** `~/.qlogicagent/skills/` — device-scoped single global skill store. */
-export declare function getUserSkillsDir(): string;
 /** `~/.qlogicagent/profiles/<owner>/settings.json` */
 export declare function getUserSettingsPath(): string;
 /** `~/.qlogicagent/cache/` */
@@ -50,10 +48,6 @@ export declare function getUserCacheDir(): string;
 export declare function getUserDebugLogsDir(): string;
 /** `~/.qlogicagent/plugin-cache/` — device-scoped (download cache for installs). */
 export declare function getUserPluginCacheDir(): string;
-/** `~/.qlogicagent/mcp.json` — device-scoped installed MCP server definitions.
- *  The gateway's preinstall writes here too (its mcp-config.ts mirrors this path) — keeping both
- *  sides on the device level is what makes the preinstalled github MCP visible to every login. */
-export declare function getUserMcpConfigPath(): string;
 /** `~/.qlogicagent/marketplace.json` — device-scoped marketplace sources. */
 export declare function getUserMarketplaceConfigPath(): string;
 /** `~/.qlogicagent/profiles/<owner>/workflows/` */
@@ -68,8 +62,6 @@ export declare function getProjectAgentDir(cwd: string): string;
 export declare function getProjectWorkflowsDir(cwd: string): string;
 /** `<cwd>/.qlogicagent/plugins/` */
 export declare function getProjectPluginsDir(cwd: string): string;
-/** `<cwd>/.qlogicagent/skills-disabled.json` — per-project skill opt-out (mute) list. */
-export declare function getProjectSkillDisabledPath(cwd: string): string;
 /** `<cwd>/.qlogicagent/settings.json` */
 export declare function getProjectSettingsPath(cwd: string): string;
 /** `<cwd>/.qlogicagent/INSTRUCTIONS.md` */