@tenphi/akno-protocol 0.1.0

package/dist/ops/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/ops/graph.ts"],"names":[],"mappings":"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"}

package/dist/ops/list.d.ts

@@ -0,0 +1,136 @@
+import { z } from 'zod';
+/** Browse structure: folders, or pages by type / tag / role / recency. */
+export declare const ListInput: z.ZodObject<{
+    folder: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    tag: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodEnum<{
+        knowledge: "knowledge";
+        source: "source";
+        inference: "inference";
+        ignored: "ignored";
+    }>>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        pages: "pages";
+        folders: "folders";
+        tree: "tree";
+    }>>;
+    order: z.ZodOptional<z.ZodEnum<{
+        slug: "slug";
+        recent: "recent";
+        size: "size";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    depth: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ListInput = z.infer<typeof ListInput>;
+export declare const PageStub: z.ZodObject<{
+    slug: z.ZodString;
+    title: z.ZodString;
+    type: z.ZodNullable<z.ZodString>;
+    role: z.ZodEnum<{
+        knowledge: "knowledge";
+        source: "source";
+        inference: "inference";
+        ignored: "ignored";
+    }>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    updated: z.ZodOptional<z.ZodString>;
+    bytes: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type PageStub = z.infer<typeof PageStub>;
+export declare const FolderStub: z.ZodObject<{
+    path: z.ZodString;
+    pages: z.ZodNumber;
+    pages_deep: z.ZodNumber;
+    folders: z.ZodNumber;
+    rule: z.ZodOptional<z.ZodObject<{
+        role: z.ZodOptional<z.ZodEnum<{
+            knowledge: "knowledge";
+            source: "source";
+            inference: "inference";
+            ignored: "ignored";
+        }>>;
+        remember: z.ZodOptional<z.ZodEnum<{
+            deny: "deny";
+            integrate: "integrate";
+        }>>;
+        description: z.ZodOptional<z.ZodString>;
+        source: z.ZodString;
+    }, z.core.$strip>>;
+    declared: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type FolderStub = z.infer<typeof FolderStub>;
+export declare const ListOutput: z.ZodObject<{
+    status: z.ZodEnum<{
+        ok: "ok";
+        empty: "empty";
+        degraded: "degraded";
+        unavailable: "unavailable";
+    }>;
+    degraded: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        no_embedding_model: "no_embedding_model";
+        no_reranker: "no_reranker";
+        no_derive_model: "no_derive_model";
+        no_expansion_model: "no_expansion_model";
+        embedding_failed: "embedding_failed";
+        rerank_failed: "rerank_failed";
+        derive_failed: "derive_failed";
+        expansion_failed: "expansion_failed";
+        no_vector_index: "no_vector_index";
+        partial_index: "partial_index";
+        no_document_text: "no_document_text";
+        document_source_missing: "document_source_missing";
+        no_graph_index: "no_graph_index";
+        no_entity_index: "no_entity_index";
+        entity_resolution_failed: "entity_resolution_failed";
+        partial_graph_index: "partial_graph_index";
+        graph_traversal_limited: "graph_traversal_limited";
+        no_answer_model: "no_answer_model";
+        answer_failed: "answer_failed";
+        answer_verification_failed: "answer_verification_failed";
+        answer_truncated: "answer_truncated";
+    }>>>;
+    note: z.ZodOptional<z.ZodString>;
+    folders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        pages: z.ZodNumber;
+        pages_deep: z.ZodNumber;
+        folders: z.ZodNumber;
+        rule: z.ZodOptional<z.ZodObject<{
+            role: z.ZodOptional<z.ZodEnum<{
+                knowledge: "knowledge";
+                source: "source";
+                inference: "inference";
+                ignored: "ignored";
+            }>>;
+            remember: z.ZodOptional<z.ZodEnum<{
+                deny: "deny";
+                integrate: "integrate";
+            }>>;
+            description: z.ZodOptional<z.ZodString>;
+            source: z.ZodString;
+        }, z.core.$strip>>;
+        declared: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodNullable<z.ZodString>;
+        role: z.ZodEnum<{
+            knowledge: "knowledge";
+            source: "source";
+            inference: "inference";
+            ignored: "ignored";
+        }>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        updated: z.ZodOptional<z.ZodString>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    tree: z.ZodOptional<z.ZodString>;
+    total: z.ZodNumber;
+}, z.core.$strip>;
+export type ListOutput = z.infer<typeof ListOutput>;
+//# sourceMappingURL=list.d.ts.map

package/dist/ops/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/ops/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,0EAA0E;AAC1E,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;iBAWpB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;iBASnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;iBAuBrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/ops/list.js

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import { PageRole, ResultEnvelope } from "../common.js";
+/** Browse structure: folders, or pages by type / tag / role / recency. */
+export const ListInput = z.object({
+    folder: z.string().optional(),
+    type: z.string().optional(),
+    tag: z.string().optional(),
+    role: PageRole.optional(),
+    /** `folders` walks the tree one level; `pages` lists page stubs. */
+    kind: z.enum(['folders', 'pages', 'tree']).optional(),
+    order: z.enum(['recent', 'slug', 'size']).optional(),
+    limit: z.number().int().positive().max(2000).optional(),
+    /** Depth for `tree`. 1 is the top level. */
+    depth: z.number().int().positive().max(12).optional(),
+});
+export const PageStub = z.object({
+    slug: z.string(),
+    title: z.string(),
+    type: z.string().nullable(),
+    role: PageRole,
+    tags: z.array(z.string()).optional(),
+    summary: z.string().nullable().optional(),
+    updated: z.string().optional(),
+    bytes: z.number().int().nonnegative().optional(),
+});
+export const FolderStub = z.object({
+    path: z.string(),
+    pages: z.number().int().nonnegative(),
+    /** Total including subfolders — the useful number when deciding where to look. */
+    pages_deep: z.number().int().nonnegative(),
+    folders: z.number().int().nonnegative(),
+    /** The rule that governs this folder, and where it came from. */
+    rule: z
+        .object({
+        role: PageRole.optional(),
+        remember: z.enum(['deny', 'integrate']).optional(),
+        /**
+         * What belongs in this folder, as its rule states it. This is the field that lets a
+         * caller choose a destination by reading rather than by guessing from a name: `research`
+         * and `household` are not self-explanatory to anyone who has not been told that one
+         * holds findings about the world and the other holds claims about this household.
+         */
+        description: z.string().optional(),
+        source: z.string(),
+    })
+        .optional(),
+    /** True when the folder is declared but holds no page yet. */
+    declared: z.boolean().optional(),
+});
+export const ListOutput = ResultEnvelope.extend({
+    folders: z.array(FolderStub).optional(),
+    pages: z.array(PageStub).optional(),
+    /** Indented outline, for the structure section of a `context` bundle. */
+    tree: z.string().optional(),
+    total: z.number().int().nonnegative(),
+});
+//# sourceMappingURL=list.js.map

package/dist/ops/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/ops/list.ts"],"names":[],"mappings":"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"}

package/dist/ops/mutate.d.ts

@@ -0,0 +1,432 @@
+import { z } from 'zod';
+/**
+ * Hand over a transcript or notes; Akno runs the retain mission with its
+ * own model and produces the writes itself. The answer for a host that does not
+ * want to build a curator. An agent that wants control uses `write`.
+ */
+export declare const RememberInput: z.ZodObject<{
+    text: z.ZodString;
+    source: z.ZodOptional<z.ZodString>;
+    mission: z.ZodOptional<z.ZodString>;
+    dry_run: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type RememberInput = z.infer<typeof RememberInput>;
+export declare const RememberOutput: z.ZodObject<{
+    status: z.ZodEnum<{
+        ok: "ok";
+        empty: "empty";
+        degraded: "degraded";
+        unavailable: "unavailable";
+    }>;
+    degraded: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        no_embedding_model: "no_embedding_model";
+        no_reranker: "no_reranker";
+        no_derive_model: "no_derive_model";
+        no_expansion_model: "no_expansion_model";
+        embedding_failed: "embedding_failed";
+        rerank_failed: "rerank_failed";
+        derive_failed: "derive_failed";
+        expansion_failed: "expansion_failed";
+        no_vector_index: "no_vector_index";
+        partial_index: "partial_index";
+        no_document_text: "no_document_text";
+        document_source_missing: "document_source_missing";
+        no_graph_index: "no_graph_index";
+        no_entity_index: "no_entity_index";
+        entity_resolution_failed: "entity_resolution_failed";
+        partial_graph_index: "partial_graph_index";
+        graph_traversal_limited: "graph_traversal_limited";
+        no_answer_model: "no_answer_model";
+        answer_failed: "answer_failed";
+        answer_verification_failed: "answer_verification_failed";
+        answer_truncated: "answer_truncated";
+    }>>>;
+    note: z.ZodOptional<z.ZodString>;
+    outcome: z.ZodEnum<{
+        ok: "ok";
+        requires_approval: "requires_approval";
+        no_writable_destination: "no_writable_destination";
+        requires_folder: "requires_folder";
+        noop: "noop";
+    }>;
+    change_id: z.ZodOptional<z.ZodString>;
+    wrote: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        action: z.ZodEnum<{
+            event: "event";
+            superseded: "superseded";
+            created: "created";
+            appended: "appended";
+            patched: "patched";
+            replaced: "replaced";
+            attached: "attached";
+        }>;
+    }, z.core.$strip>>>;
+    facts: z.ZodOptional<z.ZodObject<{
+        retired: z.ZodNumber;
+        added: z.ZodNumber;
+    }, z.core.$strip>>;
+    approvals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        proposal_id: z.ZodString;
+        reason: z.ZodString;
+        reason_code: z.ZodOptional<z.ZodEnum<{
+            conflict: "conflict";
+            routing_uncertain: "routing_uncertain";
+            no_writable_destination: "no_writable_destination";
+        }>>;
+        nearest: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>>;
+    requires_folder: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        folder: z.ZodString;
+        nearest: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>>;
+    fallback: z.ZodOptional<z.ZodObject<{
+        slug: z.ZodString;
+        status: z.ZodEnum<{
+            unavailable: "unavailable";
+            used: "used";
+        }>;
+        reason: z.ZodOptional<z.ZodEnum<{
+            reserved_path: "reserved_path";
+            existing_page_not_admitted: "existing_page_not_admitted";
+            unindexed_page_exists: "unindexed_page_exists";
+            folder_not_admitted: "folder_not_admitted";
+        }>>;
+    }, z.core.$strip>>;
+    considered: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        claim: z.ZodString;
+        kept: z.ZodBoolean;
+        slug: z.ZodNullable<z.ZodString>;
+        score: z.ZodNumber;
+        destination: z.ZodOptional<z.ZodEnum<{
+            no_writable_destination: "no_writable_destination";
+            existing_admitted_page: "existing_admitted_page";
+            new_managed_page: "new_managed_page";
+            configured_fallback: "configured_fallback";
+        }>>;
+        written: z.ZodBoolean;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type RememberOutput = z.infer<typeof RememberOutput>;
+/**
+ * All three forms operate on Markdown. Retracting a fact removes the
+ * sentence that produced it — expiring a row while the sentence stays in the
+ * file means the assistant "forgets" and reads it again tomorrow.
+ */
+export declare const ForgetInput: z.ZodObject<{
+    fact: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    document: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ForgetInput = z.infer<typeof ForgetInput>;
+export declare const ForgetOutput: z.ZodObject<{
+    status: z.ZodEnum<{
+        ok: "ok";
+        empty: "empty";
+        degraded: "degraded";
+        unavailable: "unavailable";
+    }>;
+    degraded: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        no_embedding_model: "no_embedding_model";
+        no_reranker: "no_reranker";
+        no_derive_model: "no_derive_model";
+        no_expansion_model: "no_expansion_model";
+        embedding_failed: "embedding_failed";
+        rerank_failed: "rerank_failed";
+        derive_failed: "derive_failed";
+        expansion_failed: "expansion_failed";
+        no_vector_index: "no_vector_index";
+        partial_index: "partial_index";
+        no_document_text: "no_document_text";
+        document_source_missing: "document_source_missing";
+        no_graph_index: "no_graph_index";
+        no_entity_index: "no_entity_index";
+        entity_resolution_failed: "entity_resolution_failed";
+        partial_graph_index: "partial_graph_index";
+        graph_traversal_limited: "graph_traversal_limited";
+        no_answer_model: "no_answer_model";
+        answer_failed: "answer_failed";
+        answer_verification_failed: "answer_verification_failed";
+        answer_truncated: "answer_truncated";
+    }>>>;
+    note: z.ZodOptional<z.ZodString>;
+    change_id: z.ZodOptional<z.ZodString>;
+    removed_from: z.ZodOptional<z.ZodString>;
+    removed: z.ZodOptional<z.ZodString>;
+    trashed: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ForgetOutput = z.infer<typeof ForgetOutput>;
+export declare const UndoInput: z.ZodObject<{
+    change_id: z.ZodString;
+}, z.core.$strip>;
+export type UndoInput = z.infer<typeof UndoInput>;
+export declare const UndoOutput: z.ZodObject<{
+    status: z.ZodEnum<{
+        ok: "ok";
+        empty: "empty";
+        degraded: "degraded";
+        unavailable: "unavailable";
+    }>;
+    degraded: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        no_embedding_model: "no_embedding_model";
+        no_reranker: "no_reranker";
+        no_derive_model: "no_derive_model";
+        no_expansion_model: "no_expansion_model";
+        embedding_failed: "embedding_failed";
+        rerank_failed: "rerank_failed";
+        derive_failed: "derive_failed";
+        expansion_failed: "expansion_failed";
+        no_vector_index: "no_vector_index";
+        partial_index: "partial_index";
+        no_document_text: "no_document_text";
+        document_source_missing: "document_source_missing";
+        no_graph_index: "no_graph_index";
+        no_entity_index: "no_entity_index";
+        entity_resolution_failed: "entity_resolution_failed";
+        partial_graph_index: "partial_graph_index";
+        graph_traversal_limited: "graph_traversal_limited";
+        no_answer_model: "no_answer_model";
+        answer_failed: "answer_failed";
+        answer_verification_failed: "answer_verification_failed";
+        answer_truncated: "answer_truncated";
+    }>>>;
+    note: z.ZodOptional<z.ZodString>;
+    reversed: z.ZodOptional<z.ZodString>;
+    restored: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    removed: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type UndoOutput = z.infer<typeof UndoOutput>;
+/** Relocate a page with its documents, rewriting embeds and reporting inbound links. */
+export declare const MoveInput: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+}, z.core.$strip>;
+export type MoveInput = z.infer<typeof MoveInput>;
+export declare const MoveOutput: z.ZodObject<{
+    status: z.ZodEnum<{
+        ok: "ok";
+        empty: "empty";
+        degraded: "degraded";
+        unavailable: "unavailable";
+    }>;
+    degraded: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        no_embedding_model: "no_embedding_model";
+        no_reranker: "no_reranker";
+        no_derive_model: "no_derive_model";
+        no_expansion_model: "no_expansion_model";
+        embedding_failed: "embedding_failed";
+        rerank_failed: "rerank_failed";
+        derive_failed: "derive_failed";
+        expansion_failed: "expansion_failed";
+        no_vector_index: "no_vector_index";
+        partial_index: "partial_index";
+        no_document_text: "no_document_text";
+        document_source_missing: "document_source_missing";
+        no_graph_index: "no_graph_index";
+        no_entity_index: "no_entity_index";
+        entity_resolution_failed: "entity_resolution_failed";
+        partial_graph_index: "partial_graph_index";
+        graph_traversal_limited: "graph_traversal_limited";
+        no_answer_model: "no_answer_model";
+        answer_failed: "answer_failed";
+        answer_verification_failed: "answer_verification_failed";
+        answer_truncated: "answer_truncated";
+    }>>>;
+    note: z.ZodOptional<z.ZodString>;
+    outcome: z.ZodEnum<{
+        ok: "ok";
+        requires_folder: "requires_folder";
+    }>;
+    change_id: z.ZodOptional<z.ZodString>;
+    moved: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    broken_inbound: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requires_folder: z.ZodOptional<z.ZodObject<{
+        folder: z.ZodString;
+        nearest: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type MoveOutput = z.infer<typeof MoveOutput>;
+/**
+ * Pull documents into memory: extract, OCR, name, summarize, and route.
+ * Extraction happens on arrival, always — no caller ever runs an extraction tool.
+ */
+export declare const IngestInput: z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    folder: z.ZodOptional<z.ZodString>;
+    route: z.ZodOptional<z.ZodBoolean>;
+    label: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type IngestInput = z.infer<typeof IngestInput>;
+export declare const IngestOutput: z.ZodObject<{
+    status: z.ZodEnum<{
+        ok: "ok";
+        empty: "empty";
+        degraded: "degraded";
+        unavailable: "unavailable";
+    }>;
+    degraded: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        no_embedding_model: "no_embedding_model";
+        no_reranker: "no_reranker";
+        no_derive_model: "no_derive_model";
+        no_expansion_model: "no_expansion_model";
+        embedding_failed: "embedding_failed";
+        rerank_failed: "rerank_failed";
+        derive_failed: "derive_failed";
+        expansion_failed: "expansion_failed";
+        no_vector_index: "no_vector_index";
+        partial_index: "partial_index";
+        no_document_text: "no_document_text";
+        document_source_missing: "document_source_missing";
+        no_graph_index: "no_graph_index";
+        no_entity_index: "no_entity_index";
+        entity_resolution_failed: "entity_resolution_failed";
+        partial_graph_index: "partial_graph_index";
+        graph_traversal_limited: "graph_traversal_limited";
+        no_answer_model: "no_answer_model";
+        answer_failed: "answer_failed";
+        answer_verification_failed: "answer_verification_failed";
+        answer_truncated: "answer_truncated";
+    }>>>;
+    note: z.ZodOptional<z.ZodString>;
+    outcome: z.ZodEnum<{
+        ok: "ok";
+        requires_approval: "requires_approval";
+        requires_folder: "requires_folder";
+        duplicate: "duplicate";
+        skipped: "skipped";
+    }>;
+    change_id: z.ZodOptional<z.ZodString>;
+    document: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    rel_path: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    page_count: z.ZodOptional<z.ZodNumber>;
+    ocr: z.ZodOptional<z.ZodBoolean>;
+    text_from: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        plain: "plain";
+        textutil: "textutil";
+        "text-layer": "text-layer";
+        ocr: "ocr";
+        vision: "vision";
+    }>>;
+    renamed_from: z.ZodOptional<z.ZodString>;
+    related: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    approval: z.ZodOptional<z.ZodObject<{
+        proposal_id: z.ZodString;
+        reason: z.ZodString;
+        reason_code: z.ZodOptional<z.ZodEnum<{
+            conflict: "conflict";
+            routing_uncertain: "routing_uncertain";
+            no_writable_destination: "no_writable_destination";
+        }>>;
+        nearest: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    requires_folder: z.ZodOptional<z.ZodObject<{
+        folder: z.ZodString;
+        nearest: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    batch: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        outcome: z.ZodEnum<{
+            ok: "ok";
+            error: "error";
+            requires_approval: "requires_approval";
+            requires_folder: "requires_folder";
+            duplicate: "duplicate";
+            skipped: "skipped";
+        }>;
+        slug: z.ZodOptional<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type IngestOutput = z.infer<typeof IngestOutput>;
+/** Organize one already-indexed orphan document without making retrieval depend on filing. */
+export declare const AdoptInput: z.ZodObject<{
+    documentId: z.ZodString;
+}, z.core.$strip>;
+export type AdoptInput = z.infer<typeof AdoptInput>;
+export declare const AdoptOutput: z.ZodObject<{
+    status: z.ZodEnum<{
+        ok: "ok";
+        empty: "empty";
+        degraded: "degraded";
+        unavailable: "unavailable";
+    }>;
+    degraded: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        no_embedding_model: "no_embedding_model";
+        no_reranker: "no_reranker";
+        no_derive_model: "no_derive_model";
+        no_expansion_model: "no_expansion_model";
+        embedding_failed: "embedding_failed";
+        rerank_failed: "rerank_failed";
+        derive_failed: "derive_failed";
+        expansion_failed: "expansion_failed";
+        no_vector_index: "no_vector_index";
+        partial_index: "partial_index";
+        no_document_text: "no_document_text";
+        document_source_missing: "document_source_missing";
+        no_graph_index: "no_graph_index";
+        no_entity_index: "no_entity_index";
+        entity_resolution_failed: "entity_resolution_failed";
+        partial_graph_index: "partial_graph_index";
+        graph_traversal_limited: "graph_traversal_limited";
+        no_answer_model: "no_answer_model";
+        answer_failed: "answer_failed";
+        answer_verification_failed: "answer_verification_failed";
+        answer_truncated: "answer_truncated";
+    }>>>;
+    note: z.ZodOptional<z.ZodString>;
+    outcome: z.ZodEnum<{
+        rejected: "rejected";
+        disabled: "disabled";
+        created: "created";
+        noop: "noop";
+        planned: "planned";
+        requires_review: "requires_review";
+        verification_pending: "verification_pending";
+        blocked: "blocked";
+    }>;
+    document_id: z.ZodString;
+    document_ids: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    slug: z.ZodOptional<z.ZodString>;
+    rel_path: z.ZodOptional<z.ZodString>;
+    change_id: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+    plan: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        mode: z.ZodEnum<{
+            auto: "auto";
+            audit: "audit";
+            review: "review";
+        }>;
+        status: z.ZodEnum<{
+            superseded: "superseded";
+            ready: "ready";
+            awaiting_review: "awaiting_review";
+            deciding: "deciding";
+            approved: "approved";
+            applying: "applying";
+            completed: "completed";
+            partially_completed: "partially_completed";
+            failed: "failed";
+        }>;
+        item_id: z.ZodString;
+        item_status: z.ZodEnum<{
+            applied: "applied";
+            rejected: "rejected";
+            verification_pending: "verification_pending";
+            blocked: "blocked";
+            approved: "approved";
+            applying: "applying";
+            proposed: "proposed";
+            stale: "stale";
+            verification_failed: "verification_failed";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AdoptOutput = z.infer<typeof AdoptOutput>;
+//# sourceMappingURL=mutate.d.ts.map

package/dist/ops/mutate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutate.d.ts","sourceRoot":"","sources":["../../src/ops/mutate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;iBAkBxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4CzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;iBAQpB,CAAC;AACL,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,SAAS;;iBAA6C,CAAC;AACpE,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAYrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,wFAAwF;AACxF,eAAO,MAAM,SAAS;;;iBAGpB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAOrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;iBAkBkE,CAAC;AAC3F,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuCvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,8FAA8F;AAC9F,eAAO,MAAM,UAAU;;iBAGrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgDtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}