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

import type {
  SkillCloudOperation,
  SkillCloudPublishResult,
  SkillCloudVersion
} from './skill-cloud-contract'
import type {
  SkillInstallDestination,
  SkillInstallPreview,
  SkillInstallResult,
  SkillPackageIdentity,
  ManagedSkillInstall
} from './skill-install-contract'
import type {
  SkillBundleInstallPreview,
  SkillBundleInstallResult,
  SkillBundlePackageIdentity,
  SkillBundleSelectedSkill
} from './skill-bundle-install-contract'

export type SkillSharePreview = {
  preparationId: string
  packageId: string
  versionId: string
  name: string
  description: string
  packageDigest: string
  skillCount?: number
  skills?: {
    id: string
    name: string
    description: string
    digest: string
    fileCount: number
    totalBytes: number
    scriptPaths: string[]
    executablePaths: string[]
  }[]
  archiveSha256: string
  fileCount: number
  totalBytes: number
  compressedBytes: number
  scriptPaths: string[]
  executablePaths: string[]
  expiresAt: string
}

export type SkillSharePublishInput = {
  preparationId: string
  releaseNotes: string
}

export type SkillSharePublishOperation = SkillCloudOperation<SkillCloudPublishResult>

export type SkillShareResolvedOperation = SkillCloudOperation<{
  id: string
  version: SkillCloudVersion
}>

export type SkillShareProgress = {
  preparationId: string
  phase: 'uploading' | 'finalizing' | 'publishing'
  bytesSent: number
  totalBytes: number
}

export type SkillInstallProgress = {
  operationId: string
  phase: 'authorizing' | 'installing'
  currentSkill?: {
    id: string
    name: string
    index: number
    total: number
  }
}

export type SkillShareInstallInput = {
  shareId: string
  operationId?: string
  versionId: string
  environmentId?: string
  destination: SkillInstallDestination
  /** Agents to place the skill for; omitted means every detected agent. */
  providers?: string[]
  conflictResolution?: 'replace-unmodified' | 'replace-and-discard-local' | 'cancel'
}

export type SkillPackageVersionInstallInput = Omit<SkillShareInstallInput, 'shareId'> & {
  packageId: string
  versionId: string
}

export type SkillShareInstallOperation =
  | { status: 'ok'; value: SkillInstallResult }
  | { status: 'unconfigured'; message: string }
  | { status: 'reconnect-required' }
  | { status: 'unsupported'; message: string }

export type SkillBundleShareInstallInput = {
  shareId: string
  operationId?: string
  versionId: string
  environmentId?: string
  selectedSkillIds: string[]
  destination: SkillInstallDestination
  /** Agents to place the skills for; omitted means every detected agent. */
  providers?: string[]
  conflictDecisions?: {
    skillId: string
    resolution: 'keep-local' | 'replace-unmodified' | 'replace-and-discard-local'
  }[]
}

export type SkillBundlePackageVersionInstallInput = Omit<
  SkillBundleShareInstallInput,
  'shareId'
> & {
  packageId: string
  versionId: string
}

export type SkillBundleShareInstallOperation =
  | { status: 'ok'; value: SkillBundleInstallResult }
  | { status: 'unconfigured'; message: string }
  | { status: 'reconnect-required' }
  | { status: 'unsupported'; message: string }

export type SkillBundleInstallPreviewInput = {
  environmentId?: string
  package: SkillBundlePackageIdentity
  selectedSkills: SkillBundleSelectedSkill[]
  destination: SkillInstallDestination
}

export type SkillBundleInstallPreviewOperation =
  | { status: 'ok'; value: SkillBundleInstallPreview }
  | { status: 'unsupported'; message: string }

export type SkillInstallPreviewInput = {
  environmentId?: string
  package: SkillPackageIdentity
  name: string
  destination: SkillInstallDestination
}

export type SkillInstallPreviewOperation =
  | { status: 'ok'; value: SkillInstallPreview }
  | { status: 'unsupported'; message: string }

export type SkillRemoveInput = {
  environmentId?: string
  name: string
  destination: SkillInstallDestination
  conflictResolution?: 'replace-and-discard-local' | 'cancel'
}

export type SkillRemoveOperation =
  | { status: 'ok'; value: SkillInstallResult }
  | { status: 'unsupported'; message: string }

export type SkillInstallCancelInput = {
  operationId: string
  environmentId?: string
}

export type ManagedSkillInstallListOperation =
  | { status: 'ok'; value: ManagedSkillInstall[] }
  | { status: 'unsupported'; message: string }