import type { Readable } from 'node:stream';
import type { AuthHeaders } from './utils/auth';
import type { AgentExecutionMode } from '@xemahq/kernel-contracts/agent-composition';
export interface ArtifactBlobMetadata {
    readonly relPath: string;
    readonly sizeBytes: number | undefined;
}
export interface ArtifactCollectionStream {
    readonly blobs: AsyncIterable<{
        readonly metadata: ArtifactBlobMetadata;
        readonly stream: Readable;
    }>;
}
export interface ArtifactVersionContent {
    readonly bytes: Uint8Array;
    readonly contentType: string | undefined;
}
export interface ArtifactStoreClient {
    streamCollection(collectionId: string, headers: AuthHeaders): Promise<ArtifactCollectionStream>;
    fetchVersionContent(artifactId: string, version: number, payloadField: string | undefined, headers: AuthHeaders): Promise<ArtifactVersionContent>;
}
export interface KbPageBundle {
    readonly readable: Readable;
    readonly sizeBytes: number | undefined;
}
export interface KbPageContent {
    readonly slug: string;
    readonly title: string;
    readonly body: string;
}
export interface KbClient {
    streamSpaceAsMarkdown(spaceId: string, headers: AuthHeaders): Promise<KbPageBundle>;
    fetchPageMarkdown(spaceId: string, pageSlug: string, headers: AuthHeaders): Promise<KbPageContent>;
}
export interface ScmRepoCheckoutInstruction {
    readonly cloneUrl: string;
    readonly ref: string;
    readonly depth: number;
    readonly filter: string | undefined;
}
export interface ScmClient {
    resolveCheckout(repoRef: string, ref: string, headers: AuthHeaders): Promise<ScmRepoCheckoutInstruction>;
}
export interface SessionAttachmentItem {
    readonly relPath: string;
    readonly sizeBytes: number | undefined;
    readonly readable: Readable;
}
export interface SessionAttachmentClient {
    streamSessionAttachments(sessionId: string, headers: AuthHeaders): Promise<AsyncIterable<SessionAttachmentItem>>;
}
export interface DeliverableSpecBundle {
    readonly files: ReadonlyArray<{
        readonly relPath: string;
        readonly bytes: Uint8Array;
    }>;
}
export interface DeliverableSpecsClient {
    fetchSpecBundle(contractKey: string, headers: AuthHeaders): Promise<DeliverableSpecBundle>;
}
export interface SkillBundleResource {
    readonly relPath: string;
    readonly type: string;
    readonly sizeBytes: number;
    readonly contentBase64: string;
}
export interface SkillBundle {
    readonly slug: string;
    readonly skillMarkdown: string;
    readonly resources: readonly SkillBundleResource[];
}
export interface SkillRegistryClient {
    fetchSkillBundle(slug: string, headers: AuthHeaders): Promise<SkillBundle>;
}
export interface LlmRegistryBundleFile {
    readonly key: string;
    readonly content: string;
    readonly contentHash: string;
}
export interface AgentRunContextRender {
    readonly agentsMd: string;
    readonly contextJson: Readonly<Record<string, unknown>>;
    readonly systemOverlay: string;
}
export interface LlmRegistryClient {
    fetchAgentBundleFile(params: {
        readonly slug: string;
        readonly agentMode: AgentExecutionMode;
    }, headers: AuthHeaders): Promise<LlmRegistryBundleFile>;
    fetchInstructionSectionBundleFile(params: {
        readonly sectionKey: string;
    }, headers: AuthHeaders): Promise<LlmRegistryBundleFile>;
    renderAgentRunContext(params: {
        readonly agentSlug: string;
        readonly projectId: string;
        readonly role: string;
        readonly deliverableSpecRef?: string;
        readonly workflowRunId?: string;
        readonly jobRunId?: string;
        readonly sessionId?: string;
        readonly workflowInputs?: Readonly<Record<string, unknown>>;
        readonly mounts?: ReadonlyArray<{
            readonly mount: string;
            readonly mode: 'read-only' | 'read-write';
        }>;
        readonly inputArtifacts?: ReadonlyArray<{
            readonly path: string;
            readonly contentType?: string;
            readonly sourceArtifactId: string;
            readonly sourceVersion: number;
        }>;
        readonly workingFiles?: ReadonlyArray<{
            readonly slug: string;
            readonly path: string;
            readonly format: 'markdown' | 'html' | 'json' | 'yaml' | 'text';
            readonly syncDirection: 'down-only' | 'up-only' | 'bidirectional';
            readonly sourceKind: string;
            readonly sourceRef: Readonly<Record<string, string>>;
        }>;
        readonly hasRetryContext?: boolean;
    }, headers: AuthHeaders): Promise<AgentRunContextRender>;
}
//# sourceMappingURL=clients.d.ts.map