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

package/dist/internal/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/internal/contracts/tenant-material-api.js

@@ -0,0 +1,46 @@
+/** Tenant material wire contract. Project selection is explicit; provenance is never an authorization context. */
+import { z } from 'zod';
+import { tenantMaterialLegacyJsonSchema } from './tenant-material-json-schema.js';
+import { stableUriSchema, projectKeySchema, sha256Schema } from './common.js';
+import { rawRetrievalDecisionSchema, rawContentDescriptorSchema, rawMaterialDirectoryItemSchema } from './material-read.js';
+import { materialCapabilitySchema } from './material-capability.js';
+import { materialContextSchema } from './material-context.js';
+import { materialResourceTypeSchema } from './material-carrier.js';
+const context = { projectRef: stableUriSchema.optional() }, limit = z.number().int().min(1).max(20).optional(), after = stableUriSchema.optional(), filters = { resourceType: materialResourceTypeSchema.optional(), sourceProjectKey: projectKeySchema.optional() };
+const ref = z.object({ ...context, ref: stableUriSchema }).strict();
+export const tenantMaterialToolSchemas = {
+    knowledge_material_list: z.object({ ...context, after, limit, ...filters, refPrefix: z.string().regex(/^[a-z][a-z0-9+.-]*:\/\/[!-~]*$/i).max(256).optional() }).strict(),
+    knowledge_material_describe: ref,
+    knowledge_material_read: ref,
+    knowledge_material_capabilities: ref,
+    knowledge_material_changes: z.object({ ...context, afterSeq: z.number().int().nonnegative().safe().optional(), limit }).strict(),
+    knowledge_material_window: z.object(context).strict(),
+    knowledge_material_search: z.object({ ...context, query: z.string().min(2).max(200), afterId: z.number().int().nonnegative().safe().optional(), limit, ...filters }).strict(),
+    knowledge_material_partitions: z.object({ ...context, afterRouteId: z.string().regex(/^[a-f0-9]{64}$/).optional(), limit }).strict(),
+    knowledge_material_partition_page: z.object({ ...context, partition: z.enum(['OWNER']), after, limit }).strict(),
+    knowledge_material_route_page: z.object({ ...context, routeId: z.string().regex(/^[a-f0-9]{64}$/), after, limit }).strict(),
+    knowledge_material_media: ref.extend({ afterOrdinal: z.number().int().min(-1).safe().optional(), limit, documentRef: stableUriSchema.optional() }).strict(),
+    knowledge_material_index_status: z.object({ ...context, afterSourceKey: projectKeySchema.optional(), afterNodeId: z.string().min(1).max(128).optional(), sourceProjectKey: projectKeySchema.optional(), limit }).strict(),
+};
+export const tenantMaterialEnvelopeSchema = z.object({ schemaVersion: z.literal(1), context: materialContextSchema, data: z.unknown() }).strict();
+export const tenantMaterialToolInputSchemas = Object.fromEntries(Object.entries(tenantMaterialToolSchemas).map(([name, schema]) => [name, tenantMaterialLegacyJsonSchema(schema)]));
+const nonnegative = z.number().int().nonnegative().safe(), refPosition = stableUriSchema.nullable(), items = z.array(rawMaterialDirectoryItemSchema).max(100), description = z.object({ item: rawMaterialDirectoryItemSchema.nullable(), byteLength: nonnegative.nullable(), downloadUrl: z.string().max(8192).nullable() }).strict();
+const read = z.object({ item: rawMaterialDirectoryItemSchema.nullable(), byteLength: nonnegative.nullable(), decision: rawRetrievalDecisionSchema, descriptor: rawContentDescriptorSchema.nullable(), delivery: z.enum(['INLINE_BASE64', 'DOWNLOAD', 'UNAVAILABLE']), contentBase64: z.string().max(43692).nullable(), downloadUrl: z.string().max(8192).nullable(), verification: z.enum(['VERIFIED', 'NOT_VERIFIED']) }).strict();
+const route = z.object({ routeId: z.string().regex(/^[a-f0-9]{64}$/), sourceProjectKey: projectKeySchema, matchType: z.enum(['SOURCE_PROJECT', 'SOURCE_SET', 'REF']), matchValue: z.string().min(1).max(4096) }).strict();
+const representation = materialCapabilitySchema.shape.representation;
+export const tenantMaterialDataSchemas = {
+    knowledge_material_list: z.object({ items, nextAfter: refPosition }).strict(),
+    knowledge_material_describe: description,
+    knowledge_material_read: read,
+    knowledge_material_capabilities: materialCapabilitySchema.nullable(),
+    knowledge_material_changes: z.object({ items: z.array(z.object({ seq: nonnegative, eventType: z.enum(['MATERIAL_REGISTERED', 'MATERIAL_LINEAGE_CHANGED', 'ROUTE_CHANGED', 'PROJECT_SCOPE_CHANGED']), artifactRef: stableUriSchema.nullable(), contentHash: sha256Schema.nullable(), routeId: z.string().regex(/^[a-f0-9]{64}$/).nullable(), createdAt: z.string().datetime() }).strict()).max(100), nextAfter: nonnegative.nullable() }).strict(),
+    knowledge_material_window: z.object({ retainedThroughSeq: nonnegative, headSeq: nonnegative }).strict(),
+    knowledge_material_search: z.object({ items: z.array(z.object({ item: rawMaterialDirectoryItemSchema, title: z.string().max(512), summary: z.string().max(1024) }).strict()).max(20), nextAfterId: nonnegative.nullable(), indexState: z.enum(['PARTIAL_BACKFILL', 'SYNCED_AS_OF_LAST_OBSERVATION']), configuredSourceCount: nonnegative, sourceCountIsLowerBound: z.boolean(), queryCoverage: z.literal('DESCRIPTIVE_METADATA_V1'), order: z.literal('INDEX_ROWID_ASC') }).strict(),
+    knowledge_material_partitions: z.object({ owner: z.literal('OWNER'), items: z.array(route).max(100), nextAfterRouteId: z.string().regex(/^[a-f0-9]{64}$/).nullable() }).strict(),
+    knowledge_material_partition_page: z.object({ partition: z.literal('OWNER'), items, nextAfter: refPosition }).strict(),
+    knowledge_material_route_page: z.object({ routeState: z.enum(['ACTIVE', 'REVOKED', 'UNBOUND']), items, nextAfter: refPosition }).strict().nullable(),
+    knowledge_material_media: z.object({ ref: stableUriSchema, sourceContentHash: sha256Schema, documentRef: stableUriSchema.nullable(), documentContentHash: sha256Schema.nullable(), state: z.enum(['READY', 'MISSING', 'DENIED', 'UNSUPPORTED', 'INTEGRITY_MISMATCH']), items: z.array(z.object({ ordinal: nonnegative, kind: z.enum(['IMAGE', 'VIDEO', 'AUDIO']), sourceUrl: z.string().url(), canonicalUrl: z.string().url().nullable(), availability: z.enum(['MIRRORED', 'REMOTE_ONLY', 'UNAVAILABLE']), mediaRef: stableUriSchema.nullable(), contentHash: sha256Schema.nullable(), mediaType: z.string().nullable(), byteLength: nonnegative.nullable(), state: z.enum(['READY', 'REMOTE_ONLY', 'UNAVAILABLE', 'MISSING', 'DENIED', 'INTEGRITY_MISMATCH']), representation: representation.nullable() }).strict()).max(100), nextAfterOrdinal: nonnegative.nullable() }).strict().nullable(),
+    knowledge_material_index_status: z.object({ queryCoverage: z.literal('DESCRIPTIVE_METADATA_V1'), indexedFields: z.tuple([z.literal('TITLE'), z.literal('SUMMARY')]), bodyIndexed: z.literal(false), semanticIndexed: z.literal(false), items: z.array(z.object({ sourceProjectKey: projectKeySchema, nodeId: z.string().min(1).max(128), directoryThroughSeq: nonnegative, searchThroughSeq: nonnegative.nullable(), observedMaxSeq: nonnegative.nullable(), checkpointUpdatedAt: z.string().datetime().nullable(), state: z.enum(['SYNCED_AS_OF_CHECKPOINT', 'PARTIAL_BACKFILL']) }).strict()).max(100), nextAfter: z.object({ sourceProjectKey: projectKeySchema, nodeId: z.string().min(1).max(128) }).strict().nullable() }).strict(),
+};
+export const tenantMaterialToolOutputSchemas = Object.fromEntries(Object.entries(tenantMaterialDataSchemas).map(([name, data]) => [name, tenantMaterialLegacyJsonSchema(tenantMaterialEnvelopeSchema.extend({ data }))]));
+export const tenantMaterialProviderSchema = z.object({ schemaVersion: z.literal(14), provider: z.literal('knowledge-v2'), codeRevision: z.string().min(1).max(256), context: z.literal('TENANT_DEFAULT_PROJECT_EXPLICIT'), scope: z.literal('knowledge.material.read'), mcpEndpoint: stableUriSchema, resource: stableUriSchema, issuer: stableUriSchema, tokenEndpoint: stableUriSchema, revocationEndpoint: stableUriSchema, protocols: z.array(z.string().max(32)).min(1).max(2), tenantReadEnabled: z.boolean(), projectScopeEnabled: z.boolean(), externalTenantParameter: z.literal('external_tenant_id'), materialEndpoint: stableUriSchema, authorizationEndpoint: stableUriSchema, authorizationContextParameters: z.tuple([z.literal('tenant_ref'), z.literal('project_ref')]), tools: z.array(z.string()).max(32), projectScopeManagement: z.literal('knowledge.material.scope'), inlineMaxBytes: z.literal(32768), rawUsagePolicy: z.literal('CONSUMER_DECIDES'), referenceReadMaxBytes: z.literal(16777216) }).strict();

package/dist/internal/contracts/tenant-material-json-schema.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+/** Preserve Provider14 discovery bytes; validation still uses the patched Zod schemas. */
+export function tenantMaterialLegacyJsonSchema(schema) {
+    return z.toJSONSchema(schema, { target: 'draft-07', override: ({ zodSchema, jsonSchema }) => {
+            const def = zodSchema._zod.def;
+            if (def.type !== 'number')
+                return;
+            const last = def.checks?.at(-1)?._zod.def;
+            // Zod4.5 .safe() replaced advertised bounds; newer Zod correctly intersects them.
+            // Only this frozen discovery envelope retains that historical representation.
+            if (last?.check === 'number_format' && 'format' in last && last.format === 'safeint') {
+                jsonSchema.minimum = Number.MIN_SAFE_INTEGER;
+                jsonSchema.maximum = Number.MAX_SAFE_INTEGER;
+            }
+        } });
+}