//#region src/filesystem.d.ts
/**
 * Workspace — durable file storage backed by SQLite + optional R2.
 *
 * Accepts any `SqlBackend` (two methods: `query` and `run`), or
 * auto-detects `SqlStorage` (DO built-in) and `D1Database` directly.
 *
 * ```ts
 * // Durable Object (any DO with SQLite storage)
 * const workspace = new Workspace({ sql: ctx.storage.sql });
 *
 * // D1
 * const workspace = new Workspace({ sql: env.MY_DB });
 *
 * // Agent (with R2 and lazy name for observability)
 * class MyAgent extends Agent<Env> {
 *   workspace = new Workspace({
 *     sql: this.ctx.storage.sql,
 *     r2: this.env.WORKSPACE_FILES,
 *     name: () => this.name,
 *   });
 * }
 * ```
 *
 * @module workspace
 */
type SqlParam = string | number | boolean | null;
/**
 * Minimal SQL interface: query rows and run statements.
 * Return values may be sync or async — Workspace awaits either.
 */
interface SqlBackend {
  query<T = Record<string, SqlParam>>(
    sql: string,
    ...params: SqlParam[]
  ): T[] | Promise<T[]>;
  run(sql: string, ...params: SqlParam[]): void | Promise<void>;
}
/** Auto-detect: accepts SqlStorage, D1Database, or a raw SqlBackend. */
type SqlSource = SqlStorage | D1Database | SqlBackend;
interface WorkspaceOptions {
  /** SQL backend — SqlStorage, D1Database, or a custom SqlBackend. */
  sql: SqlSource;
  /** Namespace to isolate this workspace's tables (default: "default"). */
  namespace?: string;
  /** R2 bucket for large-file storage (optional). */
  r2?: R2Bucket;
  /** Prefix for R2 object keys. Defaults to `name`. */
  r2Prefix?: string;
  /** Byte threshold for spilling files to R2 (default: 1_500_000). */
  inlineThreshold?: number;
  /** Called when files/directories change. */
  onChange?: (event: WorkspaceChangeEvent) => void;
  /**
   * Name used as default R2 prefix and in observability events.
   * Accepts a string or a function for lazy evaluation (useful when
   * the name isn't available at class field initialization time, e.g.
   * in Durable Objects where `this.name` is set after construction).
   */
  name?: string | (() => string | undefined);
}
type EntryType = "file" | "directory" | "symlink";
type FileInfo = {
  path: string;
  name: string;
  type: EntryType;
  mimeType: string;
  size: number;
  createdAt: number;
  updatedAt: number;
  target?: string;
};
type FileStat = FileInfo;
type WorkspaceChangeType = "create" | "update" | "delete";
type WorkspaceChangeEvent = {
  type: WorkspaceChangeType;
  path: string;
  entryType: EntryType;
};
/**
 * Minimum set of `Workspace` methods required to satisfy the
 * `FileSystem` adapter (and therefore `createWorkspaceStateBackend`).
 *
 * A concrete `Workspace` trivially satisfies this. Callers who wrap a
 * `Workspace` behind their own layer — most commonly a cross-DO proxy
 * that forwards each call to a parent agent's real `Workspace` over
 * RPC — can satisfy `WorkspaceFsLike` without subclassing or casting,
 * and still pass the object to `WorkspaceFileSystem` or
 * `createWorkspaceStateBackend`.
 *
 * This is a strict superset of the `WorkspaceLike` shape that
 * `@cloudflare/think` uses for builtin tool wiring. Tooling that only
 * reaches for the narrow surface can stick with `WorkspaceLike`;
 * anything touching codemode's `state.*` via
 * `createWorkspaceStateBackend` needs this.
 *
 * @experimental The API surface may change before stabilizing.
 */
type WorkspaceFsLike = Pick<
  Workspace,
  | "readFile"
  | "readFileBytes"
  | "writeFile"
  | "writeFileBytes"
  | "appendFile"
  | "exists"
  | "stat"
  | "lstat"
  | "mkdir"
  | "readDir"
  | "rm"
  | "cp"
  | "mv"
  | "symlink"
  | "readlink"
  | "glob"
>;
declare class Workspace {
  private readonly sql;
  private readonly _nameOrFn;
  private readonly namespace;
  private readonly tableName;
  private readonly indexName;
  private readonly r2;
  private readonly r2Prefix;
  private readonly threshold;
  private readonly onChange;
  private initialized;
  constructor(options: WorkspaceOptions);
  private get _name();
  private emit;
  private _observe;
  private ensureInit;
  private getR2;
  private resolveR2Prefix;
  private r2Key;
  private resolveSymlink;
  symlink(target: string, linkPath: string): Promise<void>;
  readlink(path: string): Promise<string>;
  lstat(path: string): Promise<FileStat | null>;
  stat(path: string): Promise<FileStat | null>;
  readFile(path: string): Promise<string | null>;
  readFileBytes(path: string): Promise<Uint8Array | null>;
  writeFileBytes(
    path: string,
    data: Uint8Array | ArrayBuffer,
    mimeType?: string
  ): Promise<void>;
  writeFile(path: string, content: string, mimeType?: string): Promise<void>;
  readFileStream(path: string): Promise<ReadableStream<Uint8Array> | null>;
  writeFileStream(
    path: string,
    stream: ReadableStream<Uint8Array>,
    mimeType?: string
  ): Promise<void>;
  appendFile(path: string, content: string, mimeType?: string): Promise<void>;
  deleteFile(path: string): Promise<boolean>;
  fileExists(path: string): Promise<boolean>;
  exists(path: string): Promise<boolean>;
  readDir(
    dir?: string,
    opts?: {
      limit?: number;
      offset?: number;
    }
  ): Promise<FileInfo[]>;
  glob(pattern: string): Promise<FileInfo[]>;
  mkdir(
    path: string,
    opts?: {
      recursive?: boolean;
    },
    _depth?: number
  ): Promise<void>;
  rm(
    path: string,
    opts?: {
      recursive?: boolean;
      force?: boolean;
    }
  ): Promise<void>;
  cp(
    src: string,
    dest: string,
    opts?: {
      recursive?: boolean;
    }
  ): Promise<void>;
  mv(
    src: string,
    dest: string,
    opts?: {
      recursive?: boolean;
    }
  ): Promise<void>;
  diff(pathA: string, pathB: string): Promise<string>;
  diffContent(path: string, newContent: string): Promise<string>;
  getWorkspaceInfo(): Promise<{
    fileCount: number;
    directoryCount: number;
    totalBytes: number;
    r2FileCount: number;
  }>;
  /** @internal */
  _getAllPaths(): Promise<string[]>;
  /** @internal */
  _updateModifiedAt(path: string, mtime: Date): Promise<void>;
  private ensureParentDir;
  private deleteDescendants;
}
//#endregion
export {
  SqlParam as a,
  WorkspaceChangeEvent as c,
  WorkspaceOptions as d,
  SqlBackend as i,
  WorkspaceChangeType as l,
  FileInfo as n,
  SqlSource as o,
  FileStat as r,
  Workspace as s,
  EntryType as t,
  WorkspaceFsLike as u
};
//# sourceMappingURL=filesystem-BKxpZmkl.d.ts.map