_KermanandTianyi Cui
fb79a944f5
Give durable user context its producer-owned source kind instead of a generic plugin wrapper. The V3-to-V4 conversion preserves the frozen rename and collision rules, all own JSON metadata, event coordinates, and historical request-only kinds. Native catalog and JSONL admission retain source validation so unknown attribution can survive without its producer while malformed owned sources are refused. Use an explicit user-only RequestUserInput for auxiliary LLM prompts that do not own durable message identity. Auto Review and compaction remove their request-only source registrations while retaining prompt content and freezing; provider serializers and projections keep the same wire data, assistant replay isolation, image ordering, and tool correlation. Session writes, Agent delivery, and recorded title requests continue to require identified durable messages. Bind the saved compatibility policy only to user sources and qualify tmux location attribution without weakening fixed system, model, or tool semantics. Rebuild the current inventory and unpublished V4 acknowledgement on the actual tool-role parent, preserving its rationale and all accepted historical records. The catalog format version records tooling metadata; Session remains V4. Developer-role policy and activation belong to their own feature. The latest-master Messages adapter, serialization, request-input typing, EpochHeader reservation, and attribution checks pass 103 tests across five files. The retained V3 Messages input-history snapshot passes through the source profile; Host/Client typechecks and all 41 documentation gates pass. The generated comparison records four changed roots and 447 unchanged type fingerprints. Latest-master ARIA changes are retained, with producer source labels applied independently; new Messages fixtures retain their producer names as declared source kinds and use the fixed system-message helper; recorded Session generations are unchanged by this regrouping. Co-authored-by: Tianyi Cui <[email protected]>
52 lines
2.0 KiB
TypeScript
52 lines
2.0 KiB
TypeScript
/**
|
|
* Compaction checkpoint source: the correlated constructor and type
|
|
* every backend uses for its replacement user message, plus the predicate that
|
|
* recognizes persisted checkpoints.
|
|
*
|
|
* The seam itself lives in `@deepseek-ai/dsh-compaction`, which re-exports these
|
|
* contracts; this module is a pure type/value/predicate outlet (no cordis
|
|
* imports, no module augmentation) so client and wire programs can name the
|
|
* checkpoint source without loading the host plugin's Context merges — the
|
|
* `dsh-commands/brand` shape.
|
|
*
|
|
* @module @deepseek-ai/dsh-compaction/checkpoint
|
|
*/
|
|
|
|
import type { MessageSource } from '@deepseek-ai/dsh-llm/message'
|
|
import type { CommandId } from '@deepseek-ai/dsh-commands/brand'
|
|
import type { CompactionId } from './brand.ts'
|
|
|
|
const COMPACT_CHECKPOINT_MARKER = Object.freeze({ kind: 'compact-checkpoint' } as const)
|
|
|
|
/** Message source carried by a concrete compaction checkpoint. */
|
|
export type CompactionCheckpointSource = typeof COMPACT_CHECKPOINT_MARKER & {
|
|
readonly compactionId: CompactionId
|
|
readonly sourceCommandId?: CommandId
|
|
}
|
|
|
|
/**
|
|
* Create a checkpoint source correlated with one compaction transaction.
|
|
* @param compactionId - owning compaction identity.
|
|
* @param sourceCommandId - initiating manual command, when present.
|
|
* @returns immutable checkpoint source.
|
|
*/
|
|
export function compactCheckpointSource(
|
|
compactionId: CompactionId,
|
|
sourceCommandId?: CommandId,
|
|
): CompactionCheckpointSource {
|
|
return Object.freeze({
|
|
...COMPACT_CHECKPOINT_MARKER,
|
|
compactionId,
|
|
...sourceCommandId === undefined ? {} : { sourceCommandId },
|
|
})
|
|
}
|
|
|
|
/**
|
|
* Test whether a persisted message source identifies a compaction checkpoint.
|
|
* @param source - source restored from a surface user message.
|
|
* @returns whether the source carries the backend-independent checkpoint marker.
|
|
*/
|
|
export function isCompactCheckpointSource(source: MessageSource): source is CompactionCheckpointSource {
|
|
return source.kind === 'compact-checkpoint'
|
|
}
|