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.

1.9 KB
Raw Blame
import {
  createPanelMessageBudget,
  structuredCloneMessageBytes,
  type PanelMessageBudget
} from './plugin-panel-message-budget'
import type { PluginHostCallOutcome } from './plugin-protocol'

export type PluginPanelCallRefusal = 'oversized' | 'rate_limited'

export type PluginPanelCallAdmission = {
  admit(pluginKey: string, message: unknown): PluginPanelCallRefusal | null
  clear(pluginKey?: string): void
}

export function admitPluginPanelCall(
  admission: PluginPanelCallAdmission,
  pluginKey: string,
  message: unknown
): PluginHostCallOutcome | null {
  const refusal = admission.admit(pluginKey, message)
  if (refusal === 'oversized') {
    return { ok: false, code: 'too_large', error: 'panel message exceeds the size limit' }
  }
  if (refusal === 'rate_limited') {
    return { ok: false, code: 'rate_limited', error: 'too many panel requests' }
  }
  return null
}

type PluginPanelCallAdmissionOptions = {
  limits?: { maxBytes?: number; maxMessages?: number; perMs?: number }
  now?: () => number
}

/** One budget per qualified plugin identity, shared by every panel session
 *  using this transport boundary. */
export function createPluginPanelCallAdmission(
  options: PluginPanelCallAdmissionOptions = {}
): PluginPanelCallAdmission {
  const budgets = new Map<string, PanelMessageBudget>()
  const now = options.now ?? (() => Date.now())
  const budgetFor = (pluginKey: string): PanelMessageBudget => {
    let budget = budgets.get(pluginKey)
    if (!budget) {
      budget = createPanelMessageBudget(options.limits)
      budgets.set(pluginKey, budget)
    }
    return budget
  }
  return {
    admit(pluginKey, message) {
      const budget = budgetFor(pluginKey)
      return budget.admit(now(), structuredCloneMessageBytes(message, budget.maxBytes))
    },
    clear(pluginKey) {
      if (pluginKey === undefined) {
        budgets.clear()
      } else {
        budgets.delete(pluginKey)
      }
    }
  }
}