@fs/mycroft 0.2.0 → 0.3.0

package/README.md

@@ -21,6 +21,11 @@ Run `mycroft config onboard` first to set everything up, then use the book and c
 ```bash
 mycroft book list
 mycroft book ingest /path/to/book.epub
+mycroft book ingest /path/to/book.epub --summary
+mycroft book ingest /path/to/book.epub --batch
+mycroft book ingest /path/to/book.epub --batch --summary
+mycroft book ingest status <id>
+mycroft book ingest resume <id>
 mycroft book ask <id> "What is the main conflict?"
 mycroft chat start <id>
 mycroft chat ask <session> "What does this foreshadow?"
@@ -30,6 +35,23 @@ mycroft config resolve
 mycroft config onboard
 ```
 
+## Cost estimates (approximate)
+
+These are rough, model-dependent estimates for embeddings + optional summaries. Costs vary by model pricing and book structure. Use this as a directional guide only. Summarization estimates assume `gpt-5-nano` and embeddings assume `text-embedding-3-small`.
+
+| Book size | Example | No summaries | With summaries | With summaries (batched) |
+| --- | --- | --- | --- | --- |
+| Small | 200-300 pages | ~$0.002-$0.004 | ~$0.04-$0.08 | ~$0.02-$0.04 |
+| Average novel | 350-450 pages | ~$0.004-$0.006 | ~$0.08-$0.15 | ~$0.04-$0.08 |
+| Large novel | 600-800 pages | ~$0.007-$0.01 | ~$0.15-$0.25 | ~$0.08-$0.13 |
+| Trilogy | 1,500-2,000 pages | ~$0.02-$0.03 | ~$0.30-$0.60 | ~$0.15-$0.30 |
+
+Reference point: a ~700 page book (~1,600 chunks) is about ~$0.008 for embeddings only, ~$0.20 with summaries, or ~$0.10 with summaries batched.
+
+Use `--summary` to generate per-chapter summaries during ingestion. Summaries improve retrieval quality but are significantly more expensive than embeddings alone (see cost table above). Without `--summary`, ingestion only generates embeddings, which is fast and cheap.
+
+Use `--batch` to cut costs by 50% via the OpenAI Batch API. This applies to both embeddings and summaries. Batch jobs may take up to 24 hours to complete. When using `--batch`, the command returns immediately after submitting the job. When combined with `--summary`, the summary batch runs first; once complete, run `resume` to submit the embedding batch. Use `mycroft book ingest status <id>` to check progress, and `mycroft book ingest resume <id>` to advance to the next phase. If a non-batch ingest is interrupted, use the same resume command to continue without re-embedding completed chunks.
+
 ## Local dev
 
 ```bash
@@ -74,5 +96,6 @@ CLI overrides:
 - `--max-chapter <n>`
 - `--top-k <n>`
 - `--manual` (interactive chapter selection)
+- `--batch`
 - `--summary`
 - `--force`

package/dist/batch-embedder-6IIWAZPW.js

@@ -0,0 +1,14 @@
+import {
+  checkBatchStatus,
+  cleanupBatchFiles,
+  downloadBatchResults,
+  submitBatchEmbeddings
+} from "./chunk-BR2PM6D3.js";
+import "./chunk-R3FOJK5A.js";
+export {
+  checkBatchStatus,
+  cleanupBatchFiles,
+  downloadBatchResults,
+  submitBatchEmbeddings
+};
+//# sourceMappingURL=batch-embedder-6IIWAZPW.js.map

package/dist/batch-embedder-6IIWAZPW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/batch-embedder-7DGZAQKL.js

@@ -0,0 +1,14 @@
+import {
+  checkBatchStatus,
+  cleanupBatchFiles,
+  downloadBatchResults,
+  submitBatchEmbeddings
+} from "./chunk-7CO4PMU5.js";
+import "./chunk-KGG7WEYE.js";
+export {
+  checkBatchStatus,
+  cleanupBatchFiles,
+  downloadBatchResults,
+  submitBatchEmbeddings
+};
+//# sourceMappingURL=batch-embedder-7DGZAQKL.js.map

package/dist/batch-embedder-7DGZAQKL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/batch-embedder-IZDBS3IL.js

@@ -0,0 +1,13 @@
+import {
+  checkBatchStatus,
+  cleanupBatchFiles,
+  downloadBatchResults,
+  submitBatchEmbeddings
+} from "./chunk-6DLQHHCC.js";
+export {
+  checkBatchStatus,
+  cleanupBatchFiles,
+  downloadBatchResults,
+  submitBatchEmbeddings
+};
+//# sourceMappingURL=batch-embedder-IZDBS3IL.js.map

package/dist/batch-embedder-IZDBS3IL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/batch-embedder-LYCZDYI4.js

@@ -0,0 +1,15 @@
+import {
+  checkBatchStatus,
+  cleanupBatchFiles,
+  downloadBatchResults,
+  submitBatchEmbeddings
+} from "./chunk-7NLMBXXY.js";
+import "./chunk-7IPX4MKA.js";
+import "./chunk-R3FOJK5A.js";
+export {
+  checkBatchStatus,
+  cleanupBatchFiles,
+  downloadBatchResults,
+  submitBatchEmbeddings
+};
+//# sourceMappingURL=batch-embedder-LYCZDYI4.js.map

package/dist/batch-embedder-LYCZDYI4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/batch-embedder-RHKD2OJD.js

@@ -0,0 +1,14 @@
+import {
+  checkBatchStatus,
+  cleanupBatchFiles,
+  downloadBatchResults,
+  submitBatchEmbeddings
+} from "./chunk-57ZGGKEF.js";
+import "./chunk-R3FOJK5A.js";
+export {
+  checkBatchStatus,
+  cleanupBatchFiles,
+  downloadBatchResults,
+  submitBatchEmbeddings
+};
+//# sourceMappingURL=batch-embedder-RHKD2OJD.js.map

package/dist/batch-embedder-RHKD2OJD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/batch-embedder-VQZUI7R6.js

@@ -0,0 +1,14 @@
+import {
+  checkBatchStatus,
+  cleanupBatchFiles,
+  downloadBatchResults,
+  submitBatchEmbeddings
+} from "./chunk-35EO53CC.js";
+import "./chunk-R3FOJK5A.js";
+export {
+  checkBatchStatus,
+  cleanupBatchFiles,
+  downloadBatchResults,
+  submitBatchEmbeddings
+};
+//# sourceMappingURL=batch-embedder-VQZUI7R6.js.map

package/dist/batch-embedder-VQZUI7R6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/batch-embedder-ZJZLNLOK.js

@@ -0,0 +1,14 @@
+import {
+  checkBatchStatus,
+  cleanupBatchFiles,
+  downloadBatchResults,
+  submitBatchEmbeddings
+} from "./chunk-XXO66RCF.js";
+import "./chunk-KGG7WEYE.js";
+export {
+  checkBatchStatus,
+  cleanupBatchFiles,
+  downloadBatchResults,
+  submitBatchEmbeddings
+};
+//# sourceMappingURL=batch-embedder-ZJZLNLOK.js.map

package/dist/batch-embedder-ZJZLNLOK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/batch-summarizer-7MCT4HJB.js

@@ -0,0 +1,14 @@
+import {
+  downloadBatchSummaryResults,
+  downloadMergeResults,
+  submitBatchSummaries,
+  submitMergePass
+} from "./chunk-QRDUQX63.js";
+import "./chunk-KGG7WEYE.js";
+export {
+  downloadBatchSummaryResults,
+  downloadMergeResults,
+  submitBatchSummaries,
+  submitMergePass
+};
+//# sourceMappingURL=batch-summarizer-7MCT4HJB.js.map

package/dist/batch-summarizer-7MCT4HJB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/batch-summarizer-BMIBVFAE.js

@@ -0,0 +1,14 @@
+import {
+  downloadBatchSummaryResults,
+  downloadMergeResults,
+  submitBatchSummaries,
+  submitMergePass
+} from "./chunk-7DUQNGEK.js";
+import "./chunk-KGG7WEYE.js";
+export {
+  downloadBatchSummaryResults,
+  downloadMergeResults,
+  submitBatchSummaries,
+  submitMergePass
+};
+//# sourceMappingURL=batch-summarizer-BMIBVFAE.js.map

package/dist/batch-summarizer-BMIBVFAE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}