ACP v2 TypeScript SDK — UNSTABLE DRAFT - v2.0.0
    Preparing search index...

    Type Alias SessionMessageExperimental

    UNSTABLE

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

    An upsert for an inter-session message.

    type SessionMessage = {
        messageId: MessageId;
        senderSessionId?: SessionId | null;
        recipientSessionId?: SessionId | null;
        content?: ContentBlock[] | null;
        _meta?: { [key: string]: unknown } | null;
    }
    Index
    messageId: MessageId

    Identifier of this message within the enclosing session's transcript.

    senderSessionId?: SessionId | null

    Optional sending session identity; omission or null retains a known value.

    recipientSessionId?: SessionId | null

    Optional receiving session identity; omission or null retains a known value.

    content?: ContentBlock[] | null

    Omitted leaves content unchanged; null clears it; a concrete array replaces the whole content collection.

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

    The _meta property is reserved by ACP to allow clients and agents to attach additional metadata to their interactions. Omitted leaves the stored metadata unchanged; null clears it. An object patches the stored metadata by top-level key: keys it omits are unchanged, a key set to null is removed, and any other value replaces that key's stored value without merging nested objects. Beyond this patch rule, implementations MUST NOT make assumptions about values at these keys.

    See protocol docs: Metadata Patches