Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScript adeagent-ideai-agentsautomationbotclaude-codecodexghosttygrok-bothermes-agentmobile-appmuseopenclawopencodeorchestrationpiruntimeterminalworktreesyc-backed
import { unwrapClaudePastedContent } from '../../claude-pasted-content'
import {
stripAnsiEscapeSequences,
TERMINAL_CONTROL_CHARACTER_PATTERN
} from '../../ansi-escape-sequences'
import { isTextBlock, type NativeChatBlock, type NativeChatMessage } from '../../native-chat-types'
import { imageReferenceToken, replaceImageReferences } from '../native-chat-image-reference'
import { NATIVE_CHAT_QUOTED_FILE_REFERENCE } from '../../agent-image-paste'
// Keep whitespace and path starts disjoint so incomplete markers cannot rescan their suffix.
const IMAGE_SOURCE_MARKER = /^\[Image:\s*source:\s*(\S.*?|[^\S\r\n\u2028\u2029])\]\s*$/
const IMAGE_PROMPT_MARKER = /\[Image #\d+\]/
const IMAGE_PROMPT_MARKERS = /\[Image #\d+\]/g
// A quoted file reference is matched whole, so a path that reads like a marker is left as typed.
const IMAGE_PROMPT_MARKER_NUMBERS_OUTSIDE_FILE_REFERENCES = new RegExp(
`(${NATIVE_CHAT_QUOTED_FILE_REFERENCE.source})|\\[Image #(\\d+)\\]`,
'g'
)
const IMAGE_PROMPT_MARKER_AT_START = /^[^\S\r\n]*\[Image #\d+\]/
const IMAGE_PROMPT_MARKER_AT_END = /\[Image #\d+\][^\S\r\n]*$/
const HORIZONTAL_WHITESPACE_START = /^[^\S\r\n]+/
const HORIZONTAL_WHITESPACE_END = /[^\S\r\n]+$/
export function imageSourcePathFromText(text: string): string | null {
return text.match(IMAGE_SOURCE_MARKER)?.[1]?.trim() ?? null
}
/** Source paths only from all-text turns whose every block is an image-source marker. Claude groups multi-image pastes into one turn;
* requiring one block misses them, while accepting mixed blocks would hide real prompts. */
export function imageSourcePathsFromMessage(message: NativeChatMessage): string[] {
if (message.role !== 'user' || message.blocks.length === 0) {
return []
}
const paths: string[] = []
for (const block of message.blocks) {
if (!isTextBlock(block)) {
return []
}
const path = imageSourcePathFromText(block.text)
if (path === null) {
return []
}
paths.push(path)
}
return paths
}
export function isImageSourceUserTurn(message: NativeChatMessage): boolean {
return imageSourcePathsFromMessage(message).length > 0
}
/** Map chips to sent-image [Image #N] positions, matching Claude/Codex TUIs; drop chips whose images were not sent. */
export function imageReferencesToPromptMarkers(
text: string,
sentImageIds: readonly string[]
): string {
return replaceImageReferences(text, (attachmentId) => {
const index = sentImageIds.indexOf(attachmentId)
return index === -1 ? '' : `[Image #${index + 1}]`
})
}
function replaceSentImagePromptMarkers(
text: string,
replace: (number: number, marker: string) => string
): string {
return text.replace(
IMAGE_PROMPT_MARKER_NUMBERS_OUTSIDE_FILE_REFERENCES,
(match, fileReference: string | undefined, number: string) =>
fileReference === undefined ? replace(Number(number), match) : match
)
}
/** Restore sent markers as image chips; leave out-of-range numbers literal. */
export function promptMarkersToImageReferences(text: string, imageIds: readonly string[]): string {
return replaceSentImagePromptMarkers(text, (number, marker) => {
const attachmentId = imageIds[number - 1]
return attachmentId === undefined ? marker : imageReferenceToken(attachmentId)
})
}
/** Remove only markers belonging to this structured send’s imageCount; leave out-of-range numbers literal. */
export function stripSentImagePromptMarkers(text: string, imageCount: number): string {
return withoutStrippedMarkerSpace(
text,
replaceSentImagePromptMarkers(text, (number, marker) =>
number >= 1 && number <= imageCount ? '' : marker
)
)
}
export function stripImagePromptMarker(text: string): string {
return withoutStrippedMarkerSpace(text, text.replace(IMAGE_PROMPT_MARKERS, ''))
}
function withoutStrippedMarkerSpace(text: string, stripped: string): string {
if (stripped === text) {
return text
}
let result = IMAGE_PROMPT_MARKER_AT_START.test(text)
? stripped.replace(HORIZONTAL_WHITESPACE_START, '')
: stripped
if (IMAGE_PROMPT_MARKER_AT_END.test(text)) {
result = result.replace(HORIZONTAL_WHITESPACE_END, '')
}
return result
}
/** Normalizes PTY-backed user text into the pending-echo comparison key. */
export function normalizeNativeChatUserText(text: string): string {
// Strip sequences first so their printable tails cannot survive a lone-control pass.
return stripImagePromptMarker(
stripAnsiEscapeSequences(unwrapClaudePastedContent(text)).replace(
TERMINAL_CONTROL_CHARACTER_PATTERN,
''
)
)
.trim()
.replace(/\s+/g, ' ')
}
export function normalizedNativeChatUserMessageText(message: NativeChatMessage): string | null {
if (message.role !== 'user') {
return null
}
const normalized = normalizeNativeChatUserText(
message.blocks
.filter(isTextBlock)
.map((block) => unwrapClaudePastedContent(block.text))
.join(' ')
)
return normalized || null
}
function stripImagePromptMarkersFromTextBlocks(
blocks: readonly NativeChatBlock[]
): NativeChatBlock[] {
let sawText = false
let next: NativeChatBlock[] | null = null
for (let index = 0; index < blocks.length; index += 1) {
const block = blocks[index]!
if (!isTextBlock(block)) {
next?.push(block)
continue
}
const isFirstText = !sawText
sawText = true
const text = stripImagePromptMarker(block.text)
if (!text.trim() && (text !== block.text || isFirstText)) {
next ??= blocks.slice(0, index)
continue
}
if (text !== block.text) {
next ??= blocks.slice(0, index)
next.push({ ...block, text })
continue
}
next?.push(block)
}
return next ?? (blocks as NativeChatBlock[])
}
export function hasImagePromptMarker(message: NativeChatMessage): boolean {
return message.blocks.some((block) => isTextBlock(block) && IMAGE_PROMPT_MARKER.test(block.text))
}
/** Claude records image paths as source turns followed by a prompt carrying
* image markers. Merge the whole run back into one native user turn. */
export function normalizeImageTranscriptMessages(
messages: readonly NativeChatMessage[]
): NativeChatMessage[] {
let normalized: NativeChatMessage[] | null = null
for (let index = 0; index < messages.length; index += 1) {
const message = messages[index]!
if (message.role !== 'user') {
normalized?.push(message)
continue
}
const messageImagePaths = imageSourcePathsFromMessage(message)
if (messageImagePaths.length > 0) {
normalized ??= messages.slice(0, index)
const sourceTurns = [{ message, paths: messageImagePaths }]
let nextIndex = index + 1
while (nextIndex < messages.length) {
const candidate = messages[nextIndex]!
const candidatePaths = imageSourcePathsFromMessage(candidate)
if (
candidate.role !== 'user' ||
candidate.source !== message.source ||
candidatePaths.length === 0
) {
break
}
sourceTurns.push({ message: candidate, paths: candidatePaths })
nextIndex += 1
}
const prompt = messages[nextIndex]
if (
prompt?.role === 'user' &&
prompt.source === message.source &&
hasImagePromptMarker(prompt)
) {
normalized.push({
...prompt,
blocks: [
...sourceTurns.flatMap(({ paths }) =>
paths.map((path) => ({ type: 'image-ref' as const, path }))
),
...stripImagePromptMarkersFromTextBlocks(prompt.blocks)
]
})
index = nextIndex
continue
}
for (const sourceTurn of sourceTurns) {
normalized.push({
...sourceTurn.message,
blocks: sourceTurn.paths.map((path) => ({ type: 'image-ref' as const, path }))
})
}
index = nextIndex - 1
continue
}
const blocks = stripImagePromptMarkersFromTextBlocks(message.blocks)
if (blocks === message.blocks) {
normalized?.push(message)
} else {
normalized ??= messages.slice(0, index)
normalized.push({ ...message, blocks })
}
}
return normalized ?? (messages as NativeChatMessage[])
}