# strata19.library_ingest_preview
URL: /documentation/reference/tools/library_ingest_preview



{/* GENERATED FILE — do not edit. Sources: src/mcp/facade/tool-projection-registry.ts (availability) + describe() in src/mcp/facade/facade-tools.ts (prose). Regenerate: pnpm exec tsx scripts/docs/site/generate-tool-reference.ts */}

## What it does [#what-it-does]

Preview of a Library ingestion source (one/many project files, a project directory, write/paste, or a conversation capture) before anything is committed: discovered/ready/excluded/blocked/duplicate counts, per-item status and proposed kind, secret/privacy outcomes, and a stable previewDigest the commit call must echo back. Filesystem access is read-only. It creates NO Library artifact and changes no existing one; it records one local, cancellable preview row so the commit call can prove the source bytes did not change. Uploads nothing and calls no model (PF-LIB-012).

## When to use it [#when-to-use-it]

**Use when:** "add this file to the library" · "import this folder" · "preview importing these docs"

**Also use when:** before any library\_ingest\_commit call — commit requires the previewId and previewDigest this tool returns

## When not to use it [#when-not-to-use-it]

you already have body text to save directly — use library\_create for a single hand-typed artifact

## Availability [#availability]

|           |                            |
| --------- | -------------------------- |
| Tier      | Composite member           |
| Lifecycle | Live                       |
| Taught by | `strata19-project-library` |