@orion-agents/orion-code 0.1.8 → 0.1.9

package/dist/services/compact/compact.d.ts

@@ -1,65 +1,82 @@
-/**
- * orion code - Compact 服务
- *
- * 长对话压缩服务，减少上下文长度同时保留关键信息。
- * 参考 OpenClaude 的 compact/ 目录实现。
- */
-import type { Message } from '../llm';
-import type { LLMService } from '../llm';
-import { type SummaryOptions } from './summary-generator';
+/** Semantic, group-safe conversation compaction. */
+import type { LLMService, Message } from '../llm';
+import { type SummaryDiagnostic, type SummaryOptions } from './summary-generator';
 import { type ContextCapsule, type HarnessState } from '../../harness';
+import { type CompactPlan } from './planner';
+import { type CompactSummary } from './semantic-summary';
 export interface CompactOptions {
-    /** 最大保留消息数 */
+    /** Compatibility cap for the recent tail; atomic groups may exceed it. */
     maxMessages?: number;
-    /** 是否保留工具调用 */
+    /** Deprecated compatibility option. False removes both calls and their results. */
     keepToolCalls?: boolean;
-    /** 是否保留系统消息 */
     keepSystemMessage?: boolean;
-    /** 压缩阈值（消息数超过此值触发） */
+    /** Legacy message-count trigger used by direct/manual callers. */
     threshold?: number;
-    /** 自定义摘要生成选项 */
     summaryOptions?: SummaryOptions;
-    /** Harness capsule that must survive compaction */
     contextCapsule?: ContextCapsule;
-    /** Full Context Harness state that must survive compaction */
     harnessState?: HarnessState;
-    /** v0.2.24 — Goal objective that must survive compaction */
     goalObjective?: string;
-    /** LLM service for high-quality summarization (optional, falls back to heuristic) */
     llm?: LLMService;
-    /** Why this compaction happened */
     compactMode?: 'manual' | 'auto_pre_turn' | 'mid_turn';
+    /** Safe provider input budget used by the semantic headroom validator. */
+    safeInputBudget?: number;
+    /** Successful candidates must fit this fraction of safeInputBudget. */
+    targetRatio?: number;
+    /** Explicit summary allowance used by the group planner. */
+    summaryReserveTokens?: number;
 }
 export interface CompactResult {
-    /** 压缩后的消息列表 */
     messages: Message[];
-    /** 压缩前消息数 */
     originalCount: number;
-    /** 压缩后消息数 */
     compactedCount: number;
-    /** 压缩比率 */
     ratio: number;
-    /** 摘要内容 */
     summary: string;
     summarySource: 'llm' | 'heuristic';
     summaryGeneratedAt: number;
+    semanticSummary: CompactSummary;
+    diagnostics: SummaryDiagnostic[];
+    fingerprint: string;
+    beforeTokens: number;
+    afterTokens: number;
+    plan: CompactPlan;
+}
+export interface CompactCandidate {
+    status: 'prepared';
+    messages: Message[];
+    originalCount: number;
+    summary: string;
+    summarySource: 'llm' | 'heuristic';
+    summaryGeneratedAt: number;
+    semanticSummary: CompactSummary;
+    diagnostics: SummaryDiagnostic[];
+    fingerprint: string;
+    beforeTokens: number;
+    afterTokens: number;
+    plan: CompactPlan;
 }
+export type CompactValidationErrorCode = 'target_headroom_exceeded' | 'tool_group_invalid' | 'evicted_coverage_mismatch' | 'semantic_schema_invalid' | 'semantic_reference_invalid' | 'task_epoch_mismatch' | 'source_boundary_mismatch';
+export interface CompactValidationError {
+    code: CompactValidationErrorCode;
+    message: string;
+}
+export interface CompactCandidateValidation {
+    valid: boolean;
+    errors: CompactValidationError[];
+}
+export declare class CompactCandidateValidationError extends Error {
+    readonly validation: CompactCandidateValidation;
+    constructor(validation: CompactCandidateValidation);
+}
+/** Prepare a model-context projection without mutating or persisting its source. */
+export declare function prepareCompactCandidate(messages: readonly Message[], options?: CompactOptions): Promise<CompactCandidate>;
+/** Validate semantic coverage, provider headroom, and tool protocol invariants. */
+export declare function validateCompactCandidate(candidate: CompactCandidate): CompactCandidateValidation;
 /**
- * 压缩消息历史
- *
- * 策略：
- * 1. 保留 system 消息
- * 2. 保留最近 N 条消息
- * 3. 对早期消息生成摘要替换
+ * Commit the prepared in-memory projection. This intentionally does not write a
+ * session checkpoint; the runtime/session owner must perform that transaction.
  */
+export declare function commitCompactCandidate(candidate: CompactCandidate): CompactResult;
 export declare function compactMessages(messages: Message[], options?: CompactOptions): Promise<CompactResult>;
-/**
- * 检查是否需要压缩
- */
 export declare function needsCompact(messages: Message[], threshold?: number): boolean;
-/**
- * 快速压缩（不生成摘要，直接保留最近 N 条）
- */
-export declare function quickCompact(messages: Message[], keepLast?: number): Message[];
 export { CompactOptions as CompactConfig, CompactResult as CompactResultData };
 //# sourceMappingURL=compact.d.ts.map

package/dist/services/compact/compact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compact.d.ts","sourceRoot":"","sources":["../../../src/services/compact/compact.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAOvB,MAAM,WAAW,cAAc;IAC7B,cAAc;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe;IACf,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,mDAAmD;IACnD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,8DAA8D;IAC9D,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,mCAAmC;IACnC,WAAW,CAAC,EAAE,QAAQ,GAAG,eAAe,GAAG,UAAU,CAAC;CACvD;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe;IACf,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,aAAa;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,KAAK,GAAG,WAAW,CAAC;IACnC,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAiBD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,CAAC,CAwHxB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAG7E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,GAAE,MAAW,GAAG,OAAO,EAAE,CAiBlF;AAMD,OAAO,EAAE,cAAc,IAAI,aAAa,EAAE,aAAa,IAAI,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"compact.d.ts","sourceRoot":"","sources":["../../../src/services/compact/compact.ts"],"names":[],"mappings":"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"}