@native-knowledge/knowledge-sdk 0.0.0-stage → 0.1.0-rc.1

package/dist/types/contracts/tenant-material-api.d.ts

@@ -0,0 +1,584 @@
+/** Tenant material wire contract. Project selection is explicit; provenance is never an authorization context. */
+import { z } from 'zod';
+export declare const tenantMaterialToolSchemas: {
+    readonly knowledge_material_list: z.ZodObject<{
+        refPrefix: z.ZodOptional<z.ZodString>;
+        resourceType: z.ZodOptional<z.ZodString>;
+        sourceProjectKey: z.ZodOptional<z.ZodString>;
+        after: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_material_describe: z.ZodObject<{
+        ref: z.ZodString;
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_material_read: z.ZodObject<{
+        ref: z.ZodString;
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_material_capabilities: z.ZodObject<{
+        ref: z.ZodString;
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_material_changes: z.ZodObject<{
+        afterSeq: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_material_window: z.ZodObject<{
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_material_search: z.ZodObject<{
+        resourceType: z.ZodOptional<z.ZodString>;
+        sourceProjectKey: z.ZodOptional<z.ZodString>;
+        query: z.ZodString;
+        afterId: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_material_partitions: z.ZodObject<{
+        afterRouteId: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_material_partition_page: z.ZodObject<{
+        partition: z.ZodEnum<{
+            OWNER: "OWNER";
+        }>;
+        after: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_material_route_page: z.ZodObject<{
+        routeId: z.ZodString;
+        after: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_material_media: z.ZodObject<{
+        ref: z.ZodString;
+        projectRef: z.ZodOptional<z.ZodString>;
+        afterOrdinal: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        documentRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_material_index_status: z.ZodObject<{
+        afterSourceKey: z.ZodOptional<z.ZodString>;
+        afterNodeId: z.ZodOptional<z.ZodString>;
+        sourceProjectKey: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+};
+export type TenantMaterialToolName = keyof typeof tenantMaterialToolSchemas;
+export declare const tenantMaterialEnvelopeSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    context: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"TENANT">;
+        tenantId: z.ZodString;
+        tenantRef: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"PROJECT">;
+        tenantId: z.ZodString;
+        projectKey: z.ZodString;
+        projectRef: z.ZodString;
+    }, z.core.$strict>], "type">;
+    data: z.ZodUnknown;
+}, z.core.$strict>;
+export declare const tenantMaterialToolInputSchemas: Record<TenantMaterialToolName, Record<string, unknown>>;
+export declare const tenantMaterialDataSchemas: {
+    readonly knowledge_material_list: z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            resourceType: z.ZodString;
+            sourceProjectKey: z.ZodString;
+            identityHash: z.ZodString;
+            kind: z.ZodString;
+            classification: z.ZodEnum<{
+                PUBLIC: "PUBLIC";
+                PUBLIC_METADATA: "PUBLIC_METADATA";
+                TENANT: "TENANT";
+                INTERNAL: "INTERNAL";
+                FDE_INTERNAL: "FDE_INTERNAL";
+                ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+                UNKNOWN: "UNKNOWN";
+            }>;
+            mediaType: z.ZodString;
+            decision: z.ZodObject<{
+                schemaVersion: z.ZodLiteral<1>;
+                action: z.ZodEnum<{
+                    ALLOW: "ALLOW";
+                    DENY: "DENY";
+                }>;
+                reasonCodes: z.ZodArray<z.ZodEnum<{
+                    UNAVAILABLE: "UNAVAILABLE";
+                    NOT_FOUND: "NOT_FOUND";
+                    CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+                    INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                    UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+                }>>;
+                assessedAt: z.ZodISODateTime;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        nextAfter: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_material_describe: z.ZodObject<{
+        item: z.ZodNullable<z.ZodObject<{
+            ref: z.ZodString;
+            resourceType: z.ZodString;
+            sourceProjectKey: z.ZodString;
+            identityHash: z.ZodString;
+            kind: z.ZodString;
+            classification: z.ZodEnum<{
+                PUBLIC: "PUBLIC";
+                PUBLIC_METADATA: "PUBLIC_METADATA";
+                TENANT: "TENANT";
+                INTERNAL: "INTERNAL";
+                FDE_INTERNAL: "FDE_INTERNAL";
+                ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+                UNKNOWN: "UNKNOWN";
+            }>;
+            mediaType: z.ZodString;
+            decision: z.ZodObject<{
+                schemaVersion: z.ZodLiteral<1>;
+                action: z.ZodEnum<{
+                    ALLOW: "ALLOW";
+                    DENY: "DENY";
+                }>;
+                reasonCodes: z.ZodArray<z.ZodEnum<{
+                    UNAVAILABLE: "UNAVAILABLE";
+                    NOT_FOUND: "NOT_FOUND";
+                    CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+                    INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                    UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+                }>>;
+                assessedAt: z.ZodISODateTime;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        byteLength: z.ZodNullable<z.ZodNumber>;
+        downloadUrl: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_material_read: z.ZodObject<{
+        item: z.ZodNullable<z.ZodObject<{
+            ref: z.ZodString;
+            resourceType: z.ZodString;
+            sourceProjectKey: z.ZodString;
+            identityHash: z.ZodString;
+            kind: z.ZodString;
+            classification: z.ZodEnum<{
+                PUBLIC: "PUBLIC";
+                PUBLIC_METADATA: "PUBLIC_METADATA";
+                TENANT: "TENANT";
+                INTERNAL: "INTERNAL";
+                FDE_INTERNAL: "FDE_INTERNAL";
+                ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+                UNKNOWN: "UNKNOWN";
+            }>;
+            mediaType: z.ZodString;
+            decision: z.ZodObject<{
+                schemaVersion: z.ZodLiteral<1>;
+                action: z.ZodEnum<{
+                    ALLOW: "ALLOW";
+                    DENY: "DENY";
+                }>;
+                reasonCodes: z.ZodArray<z.ZodEnum<{
+                    UNAVAILABLE: "UNAVAILABLE";
+                    NOT_FOUND: "NOT_FOUND";
+                    CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+                    INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                    UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+                }>>;
+                assessedAt: z.ZodISODateTime;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        byteLength: z.ZodNullable<z.ZodNumber>;
+        decision: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            action: z.ZodEnum<{
+                ALLOW: "ALLOW";
+                DENY: "DENY";
+            }>;
+            reasonCodes: z.ZodArray<z.ZodEnum<{
+                UNAVAILABLE: "UNAVAILABLE";
+                NOT_FOUND: "NOT_FOUND";
+                CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+                INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+            }>>;
+            assessedAt: z.ZodISODateTime;
+        }, z.core.$strict>;
+        descriptor: z.ZodNullable<z.ZodObject<{
+            contentHash: z.ZodString;
+            mediaType: z.ZodString;
+            byteLength: z.ZodNumber;
+        }, z.core.$strict>>;
+        delivery: z.ZodEnum<{
+            UNAVAILABLE: "UNAVAILABLE";
+            INLINE_BASE64: "INLINE_BASE64";
+            DOWNLOAD: "DOWNLOAD";
+        }>;
+        contentBase64: z.ZodNullable<z.ZodString>;
+        downloadUrl: z.ZodNullable<z.ZodString>;
+        verification: z.ZodEnum<{
+            VERIFIED: "VERIFIED";
+            NOT_VERIFIED: "NOT_VERIFIED";
+        }>;
+    }, z.core.$strict>;
+    readonly knowledge_material_capabilities: z.ZodNullable<z.ZodObject<{
+        item: z.ZodObject<{
+            ref: z.ZodString;
+            resourceType: z.ZodString;
+            sourceProjectKey: z.ZodString;
+            identityHash: z.ZodString;
+            kind: z.ZodString;
+            classification: z.ZodEnum<{
+                PUBLIC: "PUBLIC";
+                PUBLIC_METADATA: "PUBLIC_METADATA";
+                TENANT: "TENANT";
+                INTERNAL: "INTERNAL";
+                FDE_INTERNAL: "FDE_INTERNAL";
+                ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+                UNKNOWN: "UNKNOWN";
+            }>;
+            mediaType: z.ZodString;
+            decision: z.ZodObject<{
+                schemaVersion: z.ZodLiteral<1>;
+                action: z.ZodEnum<{
+                    ALLOW: "ALLOW";
+                    DENY: "DENY";
+                }>;
+                reasonCodes: z.ZodArray<z.ZodEnum<{
+                    UNAVAILABLE: "UNAVAILABLE";
+                    NOT_FOUND: "NOT_FOUND";
+                    CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+                    INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                    UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+                }>>;
+                assessedAt: z.ZodISODateTime;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+        materialAccess: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            action: z.ZodEnum<{
+                ALLOW: "ALLOW";
+                DENY: "DENY";
+            }>;
+            reasonCodes: z.ZodArray<z.ZodEnum<{
+                UNAVAILABLE: "UNAVAILABLE";
+                NOT_FOUND: "NOT_FOUND";
+                CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+                INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+            }>>;
+            assessedAt: z.ZodISODateTime;
+        }, z.core.$strict>;
+        representation: z.ZodObject<{
+            state: z.ZodEnum<{
+                MISSING: "MISSING";
+                INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                READY: "READY";
+                UNSUPPORTED: "UNSUPPORTED";
+                DENIED: "DENIED";
+            }>;
+            format: z.ZodEnum<{
+                BYTES: "BYTES";
+                JSON: "JSON";
+            }>;
+            transfer: z.ZodEnum<{
+                UNSUPPORTED: "UNSUPPORTED";
+                VERIFIED_STREAM: "VERIFIED_STREAM";
+                BUFFERED_JSON: "BUFFERED_JSON";
+            }>;
+            contentHash: z.ZodNullable<z.ZodString>;
+            mediaType: z.ZodString;
+            byteLength: z.ZodNullable<z.ZodNumber>;
+            methods: z.ZodArray<z.ZodEnum<{
+                GET: "GET";
+                HEAD: "HEAD";
+            }>>;
+            range: z.ZodEnum<{
+                NONE: "NONE";
+                SINGLE: "SINGLE";
+            }>;
+            verification: z.ZodLiteral<"ON_READ">;
+            verificationChunkBytes: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    readonly knowledge_material_changes: z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            seq: z.ZodNumber;
+            eventType: z.ZodEnum<{
+                MATERIAL_REGISTERED: "MATERIAL_REGISTERED";
+                MATERIAL_LINEAGE_CHANGED: "MATERIAL_LINEAGE_CHANGED";
+                ROUTE_CHANGED: "ROUTE_CHANGED";
+                PROJECT_SCOPE_CHANGED: "PROJECT_SCOPE_CHANGED";
+            }>;
+            artifactRef: z.ZodNullable<z.ZodString>;
+            contentHash: z.ZodNullable<z.ZodString>;
+            routeId: z.ZodNullable<z.ZodString>;
+            createdAt: z.ZodString;
+        }, z.core.$strict>>;
+        nextAfter: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>;
+    readonly knowledge_material_window: z.ZodObject<{
+        retainedThroughSeq: z.ZodNumber;
+        headSeq: z.ZodNumber;
+    }, z.core.$strict>;
+    readonly knowledge_material_search: z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            item: z.ZodObject<{
+                ref: z.ZodString;
+                resourceType: z.ZodString;
+                sourceProjectKey: z.ZodString;
+                identityHash: z.ZodString;
+                kind: z.ZodString;
+                classification: z.ZodEnum<{
+                    PUBLIC: "PUBLIC";
+                    PUBLIC_METADATA: "PUBLIC_METADATA";
+                    TENANT: "TENANT";
+                    INTERNAL: "INTERNAL";
+                    FDE_INTERNAL: "FDE_INTERNAL";
+                    ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+                    UNKNOWN: "UNKNOWN";
+                }>;
+                mediaType: z.ZodString;
+                decision: z.ZodObject<{
+                    schemaVersion: z.ZodLiteral<1>;
+                    action: z.ZodEnum<{
+                        ALLOW: "ALLOW";
+                        DENY: "DENY";
+                    }>;
+                    reasonCodes: z.ZodArray<z.ZodEnum<{
+                        UNAVAILABLE: "UNAVAILABLE";
+                        NOT_FOUND: "NOT_FOUND";
+                        CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+                        INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                        UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+                    }>>;
+                    assessedAt: z.ZodISODateTime;
+                }, z.core.$strict>;
+            }, z.core.$strict>;
+            title: z.ZodString;
+            summary: z.ZodString;
+        }, z.core.$strict>>;
+        nextAfterId: z.ZodNullable<z.ZodNumber>;
+        indexState: z.ZodEnum<{
+            PARTIAL_BACKFILL: "PARTIAL_BACKFILL";
+            SYNCED_AS_OF_LAST_OBSERVATION: "SYNCED_AS_OF_LAST_OBSERVATION";
+        }>;
+        configuredSourceCount: z.ZodNumber;
+        sourceCountIsLowerBound: z.ZodBoolean;
+        queryCoverage: z.ZodLiteral<"DESCRIPTIVE_METADATA_V1">;
+        order: z.ZodLiteral<"INDEX_ROWID_ASC">;
+    }, z.core.$strict>;
+    readonly knowledge_material_partitions: z.ZodObject<{
+        owner: z.ZodLiteral<"OWNER">;
+        items: z.ZodArray<z.ZodObject<{
+            routeId: z.ZodString;
+            sourceProjectKey: z.ZodString;
+            matchType: z.ZodEnum<{
+                SOURCE_PROJECT: "SOURCE_PROJECT";
+                REF: "REF";
+                SOURCE_SET: "SOURCE_SET";
+            }>;
+            matchValue: z.ZodString;
+        }, z.core.$strict>>;
+        nextAfterRouteId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_material_partition_page: z.ZodObject<{
+        partition: z.ZodLiteral<"OWNER">;
+        items: z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            resourceType: z.ZodString;
+            sourceProjectKey: z.ZodString;
+            identityHash: z.ZodString;
+            kind: z.ZodString;
+            classification: z.ZodEnum<{
+                PUBLIC: "PUBLIC";
+                PUBLIC_METADATA: "PUBLIC_METADATA";
+                TENANT: "TENANT";
+                INTERNAL: "INTERNAL";
+                FDE_INTERNAL: "FDE_INTERNAL";
+                ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+                UNKNOWN: "UNKNOWN";
+            }>;
+            mediaType: z.ZodString;
+            decision: z.ZodObject<{
+                schemaVersion: z.ZodLiteral<1>;
+                action: z.ZodEnum<{
+                    ALLOW: "ALLOW";
+                    DENY: "DENY";
+                }>;
+                reasonCodes: z.ZodArray<z.ZodEnum<{
+                    UNAVAILABLE: "UNAVAILABLE";
+                    NOT_FOUND: "NOT_FOUND";
+                    CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+                    INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                    UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+                }>>;
+                assessedAt: z.ZodISODateTime;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        nextAfter: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_material_route_page: z.ZodNullable<z.ZodObject<{
+        routeState: z.ZodEnum<{
+            ACTIVE: "ACTIVE";
+            REVOKED: "REVOKED";
+            UNBOUND: "UNBOUND";
+        }>;
+        items: z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            resourceType: z.ZodString;
+            sourceProjectKey: z.ZodString;
+            identityHash: z.ZodString;
+            kind: z.ZodString;
+            classification: z.ZodEnum<{
+                PUBLIC: "PUBLIC";
+                PUBLIC_METADATA: "PUBLIC_METADATA";
+                TENANT: "TENANT";
+                INTERNAL: "INTERNAL";
+                FDE_INTERNAL: "FDE_INTERNAL";
+                ACCESS_CONTROLLED: "ACCESS_CONTROLLED";
+                UNKNOWN: "UNKNOWN";
+            }>;
+            mediaType: z.ZodString;
+            decision: z.ZodObject<{
+                schemaVersion: z.ZodLiteral<1>;
+                action: z.ZodEnum<{
+                    ALLOW: "ALLOW";
+                    DENY: "DENY";
+                }>;
+                reasonCodes: z.ZodArray<z.ZodEnum<{
+                    UNAVAILABLE: "UNAVAILABLE";
+                    NOT_FOUND: "NOT_FOUND";
+                    CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+                    INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                    UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+                }>>;
+                assessedAt: z.ZodISODateTime;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        nextAfter: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    readonly knowledge_material_media: z.ZodNullable<z.ZodObject<{
+        ref: z.ZodString;
+        sourceContentHash: z.ZodString;
+        documentRef: z.ZodNullable<z.ZodString>;
+        documentContentHash: z.ZodNullable<z.ZodString>;
+        state: z.ZodEnum<{
+            MISSING: "MISSING";
+            INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+            READY: "READY";
+            UNSUPPORTED: "UNSUPPORTED";
+            DENIED: "DENIED";
+        }>;
+        items: z.ZodArray<z.ZodObject<{
+            ordinal: z.ZodNumber;
+            kind: z.ZodEnum<{
+                IMAGE: "IMAGE";
+                AUDIO: "AUDIO";
+                VIDEO: "VIDEO";
+            }>;
+            sourceUrl: z.ZodString;
+            canonicalUrl: z.ZodNullable<z.ZodString>;
+            availability: z.ZodEnum<{
+                MIRRORED: "MIRRORED";
+                REMOTE_ONLY: "REMOTE_ONLY";
+                UNAVAILABLE: "UNAVAILABLE";
+            }>;
+            mediaRef: z.ZodNullable<z.ZodString>;
+            contentHash: z.ZodNullable<z.ZodString>;
+            mediaType: z.ZodNullable<z.ZodString>;
+            byteLength: z.ZodNullable<z.ZodNumber>;
+            state: z.ZodEnum<{
+                MISSING: "MISSING";
+                REMOTE_ONLY: "REMOTE_ONLY";
+                UNAVAILABLE: "UNAVAILABLE";
+                INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                READY: "READY";
+                DENIED: "DENIED";
+            }>;
+            representation: z.ZodNullable<z.ZodObject<{
+                state: z.ZodEnum<{
+                    MISSING: "MISSING";
+                    INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                    READY: "READY";
+                    UNSUPPORTED: "UNSUPPORTED";
+                    DENIED: "DENIED";
+                }>;
+                format: z.ZodEnum<{
+                    BYTES: "BYTES";
+                    JSON: "JSON";
+                }>;
+                transfer: z.ZodEnum<{
+                    UNSUPPORTED: "UNSUPPORTED";
+                    VERIFIED_STREAM: "VERIFIED_STREAM";
+                    BUFFERED_JSON: "BUFFERED_JSON";
+                }>;
+                contentHash: z.ZodNullable<z.ZodString>;
+                mediaType: z.ZodString;
+                byteLength: z.ZodNullable<z.ZodNumber>;
+                methods: z.ZodArray<z.ZodEnum<{
+                    GET: "GET";
+                    HEAD: "HEAD";
+                }>>;
+                range: z.ZodEnum<{
+                    NONE: "NONE";
+                    SINGLE: "SINGLE";
+                }>;
+                verification: z.ZodLiteral<"ON_READ">;
+                verificationChunkBytes: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        nextAfterOrdinal: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+    readonly knowledge_material_index_status: z.ZodObject<{
+        queryCoverage: z.ZodLiteral<"DESCRIPTIVE_METADATA_V1">;
+        indexedFields: z.ZodTuple<[z.ZodLiteral<"TITLE">, z.ZodLiteral<"SUMMARY">], null>;
+        bodyIndexed: z.ZodLiteral<false>;
+        semanticIndexed: z.ZodLiteral<false>;
+        items: z.ZodArray<z.ZodObject<{
+            sourceProjectKey: z.ZodString;
+            nodeId: z.ZodString;
+            directoryThroughSeq: z.ZodNumber;
+            searchThroughSeq: z.ZodNullable<z.ZodNumber>;
+            observedMaxSeq: z.ZodNullable<z.ZodNumber>;
+            checkpointUpdatedAt: z.ZodNullable<z.ZodString>;
+            state: z.ZodEnum<{
+                PARTIAL_BACKFILL: "PARTIAL_BACKFILL";
+                SYNCED_AS_OF_CHECKPOINT: "SYNCED_AS_OF_CHECKPOINT";
+            }>;
+        }, z.core.$strict>>;
+        nextAfter: z.ZodNullable<z.ZodObject<{
+            sourceProjectKey: z.ZodString;
+            nodeId: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+};
+export declare const tenantMaterialToolOutputSchemas: Record<TenantMaterialToolName, Record<string, unknown>>;
+export declare const tenantMaterialProviderSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<14>;
+    provider: z.ZodLiteral<"knowledge-v2">;
+    codeRevision: z.ZodString;
+    context: z.ZodLiteral<"TENANT_DEFAULT_PROJECT_EXPLICIT">;
+    scope: z.ZodLiteral<"knowledge.material.read">;
+    mcpEndpoint: z.ZodString;
+    resource: z.ZodString;
+    issuer: z.ZodString;
+    tokenEndpoint: z.ZodString;
+    revocationEndpoint: z.ZodString;
+    protocols: z.ZodArray<z.ZodString>;
+    tenantReadEnabled: z.ZodBoolean;
+    projectScopeEnabled: z.ZodBoolean;
+    externalTenantParameter: z.ZodLiteral<"external_tenant_id">;
+    materialEndpoint: z.ZodString;
+    authorizationEndpoint: z.ZodString;
+    authorizationContextParameters: z.ZodTuple<[z.ZodLiteral<"tenant_ref">, z.ZodLiteral<"project_ref">], null>;
+    tools: z.ZodArray<z.ZodString>;
+    projectScopeManagement: z.ZodLiteral<"knowledge.material.scope">;
+    inlineMaxBytes: z.ZodLiteral<32768>;
+    rawUsagePolicy: z.ZodLiteral<"CONSUMER_DECIDES">;
+    referenceReadMaxBytes: z.ZodLiteral<16777216>;
+}, z.core.$strict>;

package/dist/types/contracts/tenant-pdf-text.d.ts

@@ -0,0 +1,27 @@
+/** Bounded PDF text projection, with real page locators; OCR is a distinct capability. */
+import { z } from 'zod';
+export declare const TENANT_PDF_TEXT_MEDIA_TYPE = "application/vnd.native-knowledge.pdf-text+json";
+export declare const tenantPdfTextSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    format: z.ZodLiteral<"TENANT_PDF_TEXT_V1">;
+    tenantId: z.ZodString;
+    parentEvidenceRef: z.ZodString;
+    sourceContentHash: z.ZodString;
+    sourceByteLength: z.ZodNumber;
+    sourceMediaType: z.ZodString;
+    sourceUri: z.ZodString;
+    observedAt: z.ZodISODateTime;
+    extractedAt: z.ZodISODateTime;
+    extractor: z.ZodObject<{
+        id: z.ZodLiteral<"native-knowledge.pdf-text">;
+        version: z.ZodLiteral<"1.0.0">;
+    }, z.core.$strict>;
+    pages: z.ZodArray<z.ZodObject<{
+        page: z.ZodNumber;
+        locator: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strict>>;
+    gaps: z.ZodArray<z.ZodEnum<{
+        TENANT_PDF_OCR_REQUIRED: "TENANT_PDF_OCR_REQUIRED";
+    }>>;
+}, z.core.$strict>;