orca/src/shared/agent-skill-sharing-contract.ts

import { z } from 'zod'
import type { SkillCloudOperation, SkillCloudPublishResult } from './skill-cloud-contract'
import { SkillDiscoveryTargetSchema } from './skills'

export const AGENT_SKILL_SHARING_UNSUPPORTED_ENVIRONMENT_CODE =
  'agent_skill_sharing_unsupported_environment'
export const AGENT_SKILL_SELECTOR_NOT_FOUND_CODE = 'agent_skill_selector_not_found'
export const AGENT_SKILL_SELECTOR_AMBIGUOUS_CODE = 'agent_skill_selector_ambiguous'
export const AGENT_SKILL_SHARING_BUSY_CODE = 'agent_skill_sharing_busy'
export const AGENT_SKILL_NOT_SHAREABLE_CODE = 'agent_skill_not_shareable'

export const AgentSkillShareRequestSchema = z
  .object({
    skillSelectors: z.array(z.string().trim().min(1).max(4_096)).min(1).max(512),
    bundleName: z.string().regex(/^(?!.*(?:--|\.\.))[a-z0-9](?:[a-z0-9.-]{0,62}[a-z0-9])?$/),
    releaseNotes: z.string().max(10_000).default(''),
    target: SkillDiscoveryTargetSchema.optional()
  })
  .strict()

export type AgentSkillShareRequest = z.infer<typeof AgentSkillShareRequestSchema>

export type AgentSkillShareSelectedSkill = {
  id: string
  name: string
  description: string | null
}

export type AgentSkillShareResult = SkillCloudPublishResult & {
  selectedSkills: AgentSkillShareSelectedSkill[]
}

export type AgentSkillShareOperation = SkillCloudOperation<AgentSkillShareResult>

export class AgentSkillSharingError extends Error {
  constructor(
    readonly code: string,
    message: string,
    readonly data?: unknown
  ) {
    super(message)
    this.name = 'AgentSkillSharingError'
  }
}