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 { z } from 'zod'
import { pluginRelativePathSchema } from '../manifest/plugin-manifest-fields'
import { readPluginImageHeader } from './plugin-image-format'
import {
PLUGIN_IMAGE_RULES,
pluginImageRuleError,
pluginManifestImageFields,
type PluginCatalogImages,
type PluginImageKind
} from './plugin-image-fields'
// Why loose: only the image fields matter here; full manifest checks run at install.
const manifestImagesSchema = z.object({
name: z.string().optional(),
icon: pluginRelativePathSchema.optional(),
...pluginManifestImageFields
})
type CatalogImage = NonNullable<PluginCatalogImages['cover']>
/** Reads one repository file; null when missing or larger than `maxBytes`. */
export type PluginRepositoryFileReader = (
path: string,
maxBytes: number
) => Promise<Uint8Array | null>
/**
* The catalog `images` for a plugin whose files live in the catalog repository, built from the
* manifest's icon, cover and screenshots. `prefix` is the plugin's directory in that repository.
* Images that are missing or break the image rules are left out.
*/
export async function catalogImagesFromManifest(input: {
manifest: unknown
prefix: string | undefined
read: PluginRepositoryFileReader
sha256: (bytes: Uint8Array) => string
}): Promise<PluginCatalogImages | null> {
const parsed = manifestImagesSchema.safeParse(input.manifest)
if (!parsed.success) {
return null
}
const { name, icon, cover, screenshots } = parsed.data
const image = async (
kind: PluginImageKind,
relative: string,
alt: string
): Promise<CatalogImage | null> => {
const path = input.prefix ? `${input.prefix}/${relative}` : relative
const bytes = await input.read(path, PLUGIN_IMAGE_RULES[kind].maxBytes).catch(() => null)
const info = bytes ? readPluginImageHeader(bytes) : 'missing'
if (!bytes || typeof info === 'string' || pluginImageRuleError(kind, info, bytes.byteLength)) {
return null
}
return { path, alt, sha256: input.sha256(bytes), width: info.width, height: info.height }
}
const iconImage = icon ? await image('icon', icon, name ?? 'Plugin icon') : null
const coverImage = cover ? await image('cover', cover.path, cover.alt) : null
const shots: CatalogImage[] = []
for (const shot of screenshots ?? []) {
const shotImage = await image('screenshot', shot.path, shot.alt)
if (shotImage) {
shots.push(shotImage)
}
}
const images: PluginCatalogImages = {
...(iconImage ? { icon: iconImage } : {}),
...(coverImage ? { cover: coverImage } : {}),
...(shots.length ? { screenshots: shots } : {})
}
return Object.keys(images).length ? images : null
}