import { ProgressArtifactRef, Sensitivity } from "@graphorin/core";

//#region src/progress/index.d.ts

/**
 * Optional configuration accepted by {@link createProgressIO}.
 *
 * @stable
 */
interface ProgressIOConfig {
  /** Filesystem root under which `<runId>/progress/<role>.<seq>.txt` files live. */
  readonly artifactRoot?: string;
  /** Default `Sensitivity` applied when the caller does not override. */
  readonly defaultSensitivity?: Sensitivity;
  /** Optional redaction transform applied to content before write. */
  readonly redact?: (content: string) => string;
}
/**
 * Per-call options for {@link ProgressIO.write}.
 *
 * @stable
 */
interface ProgressWriteOptions {
  readonly role?: string;
  /** Explicit sequence number; default auto-increments per `(runId, role)`. */
  readonly seq?: number;
  readonly sensitivity?: Sensitivity;
  readonly tags?: ReadonlyArray<string>;
}
/**
 * Per-call options for {@link ProgressIO.read}.
 *
 * @stable
 */
interface ProgressReadOptions {
  readonly runId?: string;
  readonly role?: string;
  /** Skip artifacts whose `seq <= sinceSeq`. */
  readonly sinceSeq?: number;
  /** Default `100`. */
  readonly maxArtifacts?: number;
}
/**
 * Public surface returned by {@link createProgressIO}. Used by the
 * agent runtime to back `agent.progress.write / read`.
 *
 * @stable
 */
interface ProgressIO {
  write(runId: string, content: string, options?: ProgressWriteOptions): Promise<ProgressArtifactRef>;
  read(currentRunId: string, options?: ProgressReadOptions): Promise<ReadonlyArray<ProgressArtifactRef>>;
  rootFor(runId: string): string;
}
/**
 * Build a {@link ProgressIO} bound to a particular artifact root.
 *
 * @stable
 */
declare function createProgressIO(config?: ProgressIOConfig): ProgressIO;
//#endregion
export { ProgressIO, ProgressIOConfig, ProgressReadOptions, ProgressWriteOptions, createProgressIO };
//# sourceMappingURL=index.d.ts.map