/** Public package contract. App code has access only to these mediated services. */
export type Capability = 'storage' | 'files.read' | 'models.invoke' | 'browser.read' | 'github.read' | 'github.private.read' | 'coding.read' | 'coding.run' | 'coding.commit' | 'browser.control';
export interface AppManifest {
  schemaVersion: 'hay.app/1';
  id: string;
  name: string;
  version: string;
  description: string;
  author: string;
  entrypoint: 'index.html';
  icon: string;
  color: string;
  capabilities: Capability[];
  views: { id: string; title: string; description: string }[];
  intents: { id: string; label: string; prompt: string; viewId: string }[];
  defaultTask?: { title: string; viewId?: string };
  agent?: { instructions: string };
}
export interface InitialPluginData { state?: Record<string, unknown>; documents?: { id:string; name:string; text:string }[] }
export interface PluginBundle { schemaVersion:'hay.bundle/1'; manifest:AppManifest; html:string; initialData?:InitialPluginData }
export interface AppContext { viewId: string; pinned: boolean; taskId: string }
export interface DocumentRecord { id: string; name: string; text: string; importedAt: string; sample?: boolean }
export interface SourceRecord { id: string; title: string; url: string; text: string; capturedAt: string }
export interface PullRequestSnapshot {
  url: string; title: string; body: string; headSha: string; baseSha: string; capturedAt: string;
  files: { filename: string; previousFilename?: string; status: string; additions: number; deletions: number; patch?: string }[];
}
export interface CodingCheck {id:string;command:string;argv:string[]}
export interface CodingProject {root:string;name:string;branch:string;head:string;dirty:boolean;checks:string[];sandboxAvailable:boolean}
export interface CodingSpec {title:string;goal:string;acceptance:string;decisions:string;paths:string[];commands:string[]}
export interface CodingEvent {at:string;kind:'status'|'text'|'tool'|'output'|'error';text:string}
export interface CodingCheckResult {id:string;command:string;exitCode:number;output:string;durationMs:number;revision:string}
export interface CodingDiff {revision:string;head:string;text:string;files:string[];truncated:boolean}
export interface CodingJob {
  id:string;workspaceId:string;repository:string;spec:CodingSpec;specRevision:string;
  status:'draft'|'approved'|'running'|'checking'|'review'|'committing'|'committed'|'cancelled'|'failed'|'interrupted';
  createdAt:string;updatedAt:string;worktree?:string;branch?:string;baseHead?:string;
  events:CodingEvent[];checks:CodingCheckResult[];diff?:CodingDiff;summary?:string;error?:string;commit?:string;integratedAt?:string;
  ownerAppId?:string;ownerTaskId?:string;
}
export type CodingJobSummary=Pick<CodingJob,'id'|'status'|'updatedAt'|'branch'|'error'|'ownerAppId'|'ownerTaskId'>&{title:string;createdAt?:string;goal?:string;files?:string[];checksPassed?:number;checksTotal?:number;commit?:string;integratedAt?:string};
export interface CodingSnapshot {project?:CodingProject;jobs:CodingJobSummary[];job?:CodingJob;activeJobId?:string}
export interface CodingChange {workspaceId:string;jobId?:string;ownerAppId?:string;ownerTaskId?:string}
export interface OutputInput {title:string;format:'text'|'json'|'coding-spec';text?:string;data?:unknown}
export interface OutputRecord extends OutputInput {id:string;appId:string;taskId:string;createdAt:string;sharedFrom?:{appId:string;taskId:string;outputId:string}}
export type OutputSummary=Pick<OutputRecord,'id'|'title'|'format'|'createdAt'|'sharedFrom'>;
export type OutputTarget = {kind:'task';taskId:string}|{kind:'coding'};
export interface ModelOutput {text:string;json?:unknown}
export interface InteractionElement {id:string;role:string;label:string;value?:string;url?:string;actions:('click'|'fill'|'key'|'scroll')[];bounds?:{x:number;y:number;width:number;height:number}}
export interface InteractionAction {snapshotId:string;kind:'click'|'fill'|'key'|'scroll';target?:string;text?:string;key?:'Enter'|'Tab'|'Escape'|'ArrowUp'|'ArrowDown'|'ArrowLeft'|'ArrowRight'|'Backspace'|'Space';direction?:'up'|'down'}
export interface BrowserSession {id:string;url:string;title:string}
export interface BrowserSnapshot {sessionId:string;snapshotId:string;url:string;title:string;text:string;elements:InteractionElement[];capturedAt:string;truncated:boolean}
export interface ToolImage {dataUrl:string;width:number;height:number;capturedAt:string}
export interface ToolChange {workspaceId:string;appId:string;taskId:string;kind:'browser';sessionId?:string}
export interface HayClient {
  readonly ready: Promise<AppContext>;
  readonly context: AppContext | undefined;
  onContext(listener: (context: AppContext) => void): () => void;
  call<T = unknown>(method: string, args?: Record<string, unknown>): Promise<T>;
  storage: { get<T = unknown>(key: string): Promise<T | undefined>; set<T>(key: string, value: T): Promise<unknown> };
  documents: { list(): Promise<DocumentRecord[]> };
  sources: { list(): Promise<SourceRecord[]> };
  agent: { run(prompt: string): Promise<unknown> };
  models: {generate(input:{prompt:string;format?:'text'|'json'}):Promise<ModelOutput>};
  outputs: {
    create(input:OutputInput):Promise<OutputRecord>;
    list():Promise<OutputSummary[]>;
    read(id:string):Promise<OutputRecord>;
    targets():Promise<{taskId:string;title:string;appName:string}[]>;
    handoff(id:string,target:{kind:'coding'}):Promise<CodingJob>;
    handoff(id:string,target:{kind:'task';taskId:string}):Promise<OutputRecord>;
    handoff(id:string,target:OutputTarget):Promise<OutputRecord|CodingJob>;
    onChange(listener:()=>void):()=>void;
  };
  coding: {
    project():Promise<{project?:CodingProject;files:string[]}>;
    readFile(path:string):Promise<{path:string;text:string;truncated:boolean}>;
    wait(id:string):Promise<CodingJob>;
    preview(id:string):Promise<BrowserSnapshot & {jobId:string;revision:string}>;
    integrate(id:string):Promise<CodingJob>;
    list():Promise<CodingSnapshot>;
    createSpec(spec:CodingSpec):Promise<CodingJob>;
    get(id:string):Promise<CodingJob>;
    run(id:string,specRevision:string,feedback?:string):Promise<CodingJob>;
    stop(id:string):Promise<void>;
    review(id:string):Promise<CodingJob>;
    commit(id:string,revision:string,message:string):Promise<CodingJob>;
    onChange(listener:(change:CodingChange)=>void):()=>void;
  };
  github: { readPullRequest(url: string, options?: { authenticated?: boolean }): Promise<PullRequestSnapshot> };
  browser: {
    open(url:string):Promise<unknown>;
    create(url:string):Promise<BrowserSnapshot>;
    sessions():Promise<BrowserSession[]>;
    observe(id:string):Promise<BrowserSnapshot>;
    act(id:string,action:InteractionAction):Promise<{performed:true;observeRequired:true}>;
    screenshot(id:string):Promise<ToolImage>;
    close(id:string):Promise<void>;
    onChange(listener:(change:ToolChange)=>void):()=>void;
  };

}
// Use this declaration in sandbox app projects. Do not import the desktop preload API.
declare global { interface Window { Hay: HayClient } }