Agent Client Protocol - v1.4.0
    Preparing search index...

    Type Alias CompactionUpdateExperimental

    UNSTABLE

    This capability is not part of the spec yet, and may be removed or changed at any point.

    A context compaction upsert. The first update fixes the compaction's timeline position. Later updates with the same ID patch that entity in place. Agents MUST only send this update when the Client advertised [ClientSessionCapabilities::compaction].

    summary, error, and _meta have patch semantics: omission leaves the stored value unchanged, null clears it, and a concrete value replaces it. summary: [] also clears the retained summary. A non-empty summary is only valid with completed; error is only valid with failed.

    type CompactionUpdate = {
        compactionId: CompactionId;
        status: CompactionStatus;
        summary?: ContentBlock[] | null;
        error?: string | null;
        _meta?: { [key: string]: unknown } | null;
    }
    Index
    compactionId: CompactionId

    The Agent-owned ID of this compaction, unique within the session.

    Current lifecycle status.

    summary?: ContentBlock[] | null

    Complete replacement user-displayable summary retained by the compaction.

    error?: string | null

    Human-readable description of why the compaction failed.

    _meta?: { [key: string]: unknown } | null

    Extensible metadata patch for this compaction.