Skip to content

armgit / orca

Public Imported from GitHub
0

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.

2.1 KB
Raw Blame
import { z } from 'zod'
import { isAgentSessionOptions } from '../agent-session-record'
import { measureUtf8ByteLength } from '../utf8-byte-limits'

export const AgentSessionOptions = z.record(z.string(), z.string()).refine(isAgentSessionOptions)

export const MAX_PROMPT_BYTES = 256 * 1024
export const MAX_BLOCKS = 64
export const MAX_OPTION_LABEL = 512

export const SendImageRefBlock = z
  .object({
    type: z.literal('image-ref'),
    path: z.string().min(1).max(4096).optional(),
    url: z.string().min(1).max(4096).optional(),
    alt: z.string().max(MAX_OPTION_LABEL).optional()
  })
  .strict()
  .refine((value) => Boolean(value.path) !== Boolean(value.url), 'Provide exactly one of path/url')

/** Clients may author only user turns; provider-owned assistant/tool content must never be forged into another client’s timeline. */
export const SendBlock = z.discriminatedUnion('type', [
  z.object({ type: z.literal('text'), text: z.string() }).strict(),
  SendImageRefBlock
])

export const MAX_SKILL_REFS = 16

/** A skill the user picked from the menu, by the file its agent selects it by. */
export const SendSkillRef = z
  .object({ name: z.string().min(1).max(MAX_OPTION_LABEL), path: z.string().min(1).max(4096) })
  .strict()

export const SendBodyStructure = z
  .object({
    kind: z.literal('message'),
    role: z.literal('user'),
    blocks: z.array(SendBlock).min(1).max(MAX_BLOCKS),
    skills: z.array(SendSkillRef).min(1).max(MAX_SKILL_REFS).optional()
  })
  .strict()

/** Match SendBody’s host UTF-8 byte count where Buffer is unavailable, so clients refuse oversized sends before submission. */
export function structuredAgentSessionBlocksByteLength(blocks: readonly unknown[]): number {
  return measureUtf8ByteLength(JSON.stringify(blocks)).byteLength
}

export function structuredAgentSessionBlocksTooLarge(blocks: readonly unknown[]): boolean {
  return measureUtf8ByteLength(JSON.stringify(blocks), { stopAfterBytes: MAX_PROMPT_BYTES })
    .exceededLimit
}

export const SendBody = SendBodyStructure.refine(
  (value) => Buffer.byteLength(JSON.stringify(value.blocks), 'utf8') <= MAX_PROMPT_BYTES,
  'Message is too large'
)