public let sessionkey: String

public let agentid: String?

public let limit: Int?

public let offset: Int?

public let maxchars: Int?

public init(

sessionkey: String,

agentid: String? = nil,

limit: Int?,

offset: Int? = nil,

maxchars: Int?)

{

self.sessionkey = sessionkey

self.agentid = agentid

self.limit = limit

self.offset = offset

self.maxchars = maxchars

}

private enum CodingKeys: String, CodingKey {

case sessionkey = "sessionKey"

case agentid = "agentId"

case limit

case offset

case maxchars = "maxChars"

}

}

downgraded tool-call scaffolding / leaked ASCII/full-width model control

tokens / malformed MiniMax tool-call XML from assistant recall, and can

replace oversized rows with `[sessions_history omitted: message too large]`

instead of returning a raw transcript dump.

instead of returning a raw transcript dump. Use `nextOffset` when present to

page backward through older transcript windows.

## Scaling pattern

`sessions_history` fetches the conversation transcript for a specific session.

By default, tool results are excluded -- pass `includeTools: true` to see them.

Use `limit` for the newest bounded tail. Pass `offset: 0` when you need

pagination metadata, then pass returned `nextOffset` values to page backward

through older OpenClaw transcript windows without reading raw transcript files.

Explicit offset pages do not merge external CLI fallback imports; use the

default newest-tail view when you need that merged display history.

The returned view is intentionally bounded and safety-filtered:

- assistant text is normalized before recall:

- very large histories can drop older rows or replace an oversized row with

`[sessions_history omitted: message too large]`

- the tool reports summary flags such as `truncated`, `droppedMessages`,

`contentTruncated`, `contentRedacted`, and `bytes`

`contentTruncated`, `contentRedacted`, `bytes`, and pagination metadata

Both tools accept either a **session key** (like `"main"`) or a **session ID**

from a previous list call.

- Credential/token-like text is redacted.

- Long blocks can be truncated.

- Very large histories can drop older rows or replace an oversized row with `[sessions_history omitted: message too large]`.

- Use `nextOffset` when present to page backward through older transcript windows.

- Raw on-disk transcript inspection is the fallback when you need the full byte-for-byte transcript.

## Tool policy

sessionKey: "global",

agentId: "work",

limit: 50,

offset: 100,

}),

).toBe(true);

expect(

sessionKey: NonEmptyString,

agentId: Type.Optional(NonEmptyString),

limit: Type.Optional(Type.Integer({ minimum: 1, maximum: 1000 })),

offset: Type.Optional(Type.Integer({ minimum: 0 })),

maxChars: Type.Optional(Type.Integer({ minimum: 1, maximum: 500_000 })),

},

{ additionalProperties: false },

["SessionsCompactParams", ["agentId"]],

["SessionsResolveParams", ["allowMissing"]],

["SessionsUsageParams", ["agentId", "agentScope"]],

["ChatHistoryParams", ["agentId"]],

["ChatHistoryParams", ["agentId", "offset"]],

["ChatSendParams", ["agentId"]],

["ChatAbortParams", ["agentId"]],

["ChatInjectParams", ["agentId"]],

["ChatDeltaEvent", ["agentId"]],

["ChatErrorEvent", ["agentId"]],

["ChatFinalEvent", ["agentId"]],

["ChatHistoryParams", ["agentId"]],

["ChatHistoryParams", ["agentId", "offset"]],

["ChatInjectParams", ["agentId"]],

["ChatSendParams", ["agentId"]],

["MessageActionParams", ["inboundTurnKind", "requesterAccountId"]],

export function describeSessionsHistoryTool(): string {

return [

"Fetch sanitized history for visible session.",

"Use before replying, debugging, resuming; supports limits/tool messages.",

"Use before replying, debugging, resuming; supports limit, offset pagination, and tool-message inclusion.",

].join(" ");

}

export { resolveSessionAgentId } from "../../agents/agent-scope.js";

export { getRuntimeConfig } from "../../config/config.js";

export {

dropPreSessionStartAnnouncePairs,

projectChatDisplayMessages,

projectRecentChatDisplayMessages,

resolveEffectiveChatHistoryMaxChars,

} from "../../gateway/chat-display-projection.js";

} from "../../gateway/server-methods/chat.js";

export {

capArrayByJsonBytes,

readRecentSessionMessagesWithStatsAsync,

readSessionMessagesPageWithStatsAsync,

readSessionMessagesAsync,

} from "../../gateway/session-transcript-readers.js";

export {