ACP v2 TypeScript SDK — EXPERIMENTAL DRAFT - 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.

    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.