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

package/dist/internal/serving-contracts/mcp.d.ts

@@ -0,0 +1,2218 @@
+import { z } from 'zod';
+export declare const knowledgeMcpProtocolVersion: "2026-07-28";
+export declare const knowledgeMcpToolNameSchema: z.ZodEnum<{
+    knowledge_search: "knowledge_search";
+    knowledge_read: "knowledge_read";
+    knowledge_currentness: "knowledge_currentness";
+    knowledge_reference_lookup: "knowledge_reference_lookup";
+}>;
+export declare const knowledgeMcpToolNameV2Schema: z.ZodEnum<{
+    knowledge_search: "knowledge_search";
+    knowledge_read: "knowledge_read";
+    knowledge_currentness: "knowledge_currentness";
+    knowledge_reference_lookup: "knowledge_reference_lookup";
+    knowledge_list_evidence: "knowledge_list_evidence";
+}>;
+export declare const knowledgeMcpScopeSchema: z.ZodEnum<{
+    "knowledge.read": "knowledge.read";
+    "knowledge.search": "knowledge.search";
+    "knowledge.currentness": "knowledge.currentness";
+}>;
+export declare const knowledgeMcpProviderContractSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    provider: z.ZodLiteral<"knowledge-v2">;
+    revision: z.ZodString;
+    protocolVersion: z.ZodLiteral<"2026-07-28">;
+    validationStatus: z.ZodEnum<{
+        NOT_VERIFIED: "NOT_VERIFIED";
+        RUNTIME_CONFIGURED: "RUNTIME_CONFIGURED";
+    }>;
+    externalReachability: z.ZodLiteral<"NOT_VERIFIED">;
+    endpoint: z.ZodNullable<z.ZodString>;
+    mediaEndpoint: z.ZodNullable<z.ZodString>;
+    resource: z.ZodNullable<z.ZodString>;
+    protectedResourceMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationServerMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationEndpoint: z.ZodNullable<z.ZodString>;
+    tokenEndpoint: z.ZodNullable<z.ZodString>;
+    revocationEndpoint: z.ZodNullable<z.ZodString>;
+    authorizationMode: z.ZodLiteral<"OAUTH_2_1_AUTHORIZATION_CODE_PKCE_S256_USER_DELEGATED">;
+    clientRegistration: z.ZodLiteral<"PRE_REGISTERED">;
+    clientId: z.ZodNull;
+    authorizationMapping: z.ZodObject<{
+        oauthResourceParameter: z.ZodLiteral<"resource">;
+        externalTenantParameter: z.ZodLiteral<"external_tenant_id">;
+        projectRefParameter: z.ZodLiteral<"project_ref">;
+        externalSystemSource: z.ZodLiteral<"client_id">;
+        grantBinding: z.ZodLiteral<"RESOURCE_EXTERNAL_TENANT_PROJECT_REF_SCOPES">;
+    }, z.core.$strict>;
+    searchCoverage: z.ZodEnum<{
+        AUTHORIZED_METADATA_V1: "AUTHORIZED_METADATA_V1";
+        AUTHORIZED_PRESENTATION_V1: "AUTHORIZED_PRESENTATION_V1";
+    }>;
+    scopes: z.ZodArray<z.ZodEnum<{
+        "knowledge.read": "knowledge.read";
+        "knowledge.search": "knowledge.search";
+        "knowledge.currentness": "knowledge.currentness";
+    }>>;
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodEnum<{
+            knowledge_search: "knowledge_search";
+            knowledge_read: "knowledge_read";
+            knowledge_currentness: "knowledge_currentness";
+            knowledge_reference_lookup: "knowledge_reference_lookup";
+        }>;
+        requiredScope: z.ZodEnum<{
+            "knowledge.read": "knowledge.read";
+            "knowledge.search": "knowledge.search";
+            "knowledge.currentness": "knowledge.currentness";
+        }>;
+        inputSchema: z.ZodJSONSchema;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type KnowledgeMcpProviderContract = z.infer<typeof knowledgeMcpProviderContractSchema>;
+export declare const knowledgeMcpProviderContractV2Schema: z.ZodObject<{
+    scopes: z.ZodArray<z.ZodEnum<{
+        "knowledge.read": "knowledge.read";
+        "knowledge.search": "knowledge.search";
+        "knowledge.currentness": "knowledge.currentness";
+    }>>;
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodEnum<{
+            knowledge_search: "knowledge_search";
+            knowledge_read: "knowledge_read";
+            knowledge_currentness: "knowledge_currentness";
+            knowledge_reference_lookup: "knowledge_reference_lookup";
+        }>;
+        requiredScope: z.ZodEnum<{
+            "knowledge.read": "knowledge.read";
+            "knowledge.search": "knowledge.search";
+            "knowledge.currentness": "knowledge.currentness";
+        }>;
+        inputSchema: z.ZodJSONSchema;
+    }, z.core.$strict>>;
+    resource: z.ZodNullable<z.ZodString>;
+    authorizationEndpoint: z.ZodNullable<z.ZodString>;
+    tokenEndpoint: z.ZodNullable<z.ZodString>;
+    revocationEndpoint: z.ZodNullable<z.ZodString>;
+    provider: z.ZodLiteral<"knowledge-v2">;
+    revision: z.ZodString;
+    searchCoverage: z.ZodEnum<{
+        AUTHORIZED_METADATA_V1: "AUTHORIZED_METADATA_V1";
+        AUTHORIZED_PRESENTATION_V1: "AUTHORIZED_PRESENTATION_V1";
+    }>;
+    validationStatus: z.ZodEnum<{
+        NOT_VERIFIED: "NOT_VERIFIED";
+        RUNTIME_CONFIGURED: "RUNTIME_CONFIGURED";
+    }>;
+    externalReachability: z.ZodLiteral<"NOT_VERIFIED">;
+    endpoint: z.ZodNullable<z.ZodString>;
+    mediaEndpoint: z.ZodNullable<z.ZodString>;
+    protectedResourceMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationServerMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationMode: z.ZodLiteral<"OAUTH_2_1_AUTHORIZATION_CODE_PKCE_S256_USER_DELEGATED">;
+    clientRegistration: z.ZodLiteral<"PRE_REGISTERED">;
+    clientId: z.ZodNull;
+    authorizationMapping: z.ZodObject<{
+        oauthResourceParameter: z.ZodLiteral<"resource">;
+        externalTenantParameter: z.ZodLiteral<"external_tenant_id">;
+        projectRefParameter: z.ZodLiteral<"project_ref">;
+        externalSystemSource: z.ZodLiteral<"client_id">;
+        grantBinding: z.ZodLiteral<"RESOURCE_EXTERNAL_TENANT_PROJECT_REF_SCOPES">;
+    }, z.core.$strict>;
+    schemaVersion: z.ZodLiteral<2>;
+    defaultProtocolVersion: z.ZodLiteral<"2026-07-28">;
+    protocols: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        version: z.ZodLiteral<"2026-07-28">;
+        lifecycle: z.ZodLiteral<"STATELESS_DISCOVERY">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>, z.ZodObject<{
+        version: z.ZodLiteral<"2025-06-18">;
+        lifecycle: z.ZodLiteral<"INITIALIZE">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>], "version">>;
+}, z.core.$strict>;
+export type KnowledgeMcpProviderContractV2 = z.infer<typeof knowledgeMcpProviderContractV2Schema>;
+/** v3 区分原始 Evidence 文件和受治理正文端点，旧 provider 合同仍保持原样。 */
+export declare const knowledgeMcpProviderContractV3Schema: z.ZodObject<{
+    scopes: z.ZodArray<z.ZodEnum<{
+        "knowledge.read": "knowledge.read";
+        "knowledge.search": "knowledge.search";
+        "knowledge.currentness": "knowledge.currentness";
+    }>>;
+    resource: z.ZodNullable<z.ZodString>;
+    authorizationEndpoint: z.ZodNullable<z.ZodString>;
+    tokenEndpoint: z.ZodNullable<z.ZodString>;
+    revocationEndpoint: z.ZodNullable<z.ZodString>;
+    provider: z.ZodLiteral<"knowledge-v2">;
+    protocols: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        version: z.ZodLiteral<"2026-07-28">;
+        lifecycle: z.ZodLiteral<"STATELESS_DISCOVERY">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>, z.ZodObject<{
+        version: z.ZodLiteral<"2025-06-18">;
+        lifecycle: z.ZodLiteral<"INITIALIZE">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>], "version">>;
+    revision: z.ZodString;
+    searchCoverage: z.ZodEnum<{
+        AUTHORIZED_METADATA_V1: "AUTHORIZED_METADATA_V1";
+        AUTHORIZED_PRESENTATION_V1: "AUTHORIZED_PRESENTATION_V1";
+    }>;
+    validationStatus: z.ZodEnum<{
+        NOT_VERIFIED: "NOT_VERIFIED";
+        RUNTIME_CONFIGURED: "RUNTIME_CONFIGURED";
+    }>;
+    externalReachability: z.ZodLiteral<"NOT_VERIFIED">;
+    endpoint: z.ZodNullable<z.ZodString>;
+    mediaEndpoint: z.ZodNullable<z.ZodString>;
+    protectedResourceMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationServerMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationMode: z.ZodLiteral<"OAUTH_2_1_AUTHORIZATION_CODE_PKCE_S256_USER_DELEGATED">;
+    clientRegistration: z.ZodLiteral<"PRE_REGISTERED">;
+    clientId: z.ZodNull;
+    authorizationMapping: z.ZodObject<{
+        oauthResourceParameter: z.ZodLiteral<"resource">;
+        externalTenantParameter: z.ZodLiteral<"external_tenant_id">;
+        projectRefParameter: z.ZodLiteral<"project_ref">;
+        externalSystemSource: z.ZodLiteral<"client_id">;
+        grantBinding: z.ZodLiteral<"RESOURCE_EXTERNAL_TENANT_PROJECT_REF_SCOPES">;
+    }, z.core.$strict>;
+    defaultProtocolVersion: z.ZodLiteral<"2026-07-28">;
+    schemaVersion: z.ZodLiteral<3>;
+    contentEndpoint: z.ZodNullable<z.ZodString>;
+    evidenceFileEndpoint: z.ZodNullable<z.ZodString>;
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodEnum<{
+            knowledge_search: "knowledge_search";
+            knowledge_read: "knowledge_read";
+            knowledge_currentness: "knowledge_currentness";
+            knowledge_reference_lookup: "knowledge_reference_lookup";
+            knowledge_list_evidence: "knowledge_list_evidence";
+        }>;
+        requiredScope: z.ZodEnum<{
+            "knowledge.read": "knowledge.read";
+            "knowledge.search": "knowledge.search";
+            "knowledge.currentness": "knowledge.currentness";
+        }>;
+        inputSchema: z.ZodJSONSchema;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type KnowledgeMcpProviderContractV3 = z.infer<typeof knowledgeMcpProviderContractV3Schema>;
+export declare const knowledgeMaterialListInputSchema: z.ZodObject<{
+    projectRef: z.ZodString;
+    after: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    resourceType: z.ZodOptional<z.ZodString>;
+    sourceProjectKey: z.ZodOptional<z.ZodString>;
+    refPrefix: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const knowledgeMaterialRefInputSchema: z.ZodObject<{
+    projectRef: z.ZodString;
+    ref: z.ZodString;
+}, z.core.$strict>;
+export declare const knowledgeMaterialWindowInputSchema: z.ZodObject<{
+    projectRef: z.ZodString;
+}, z.core.$strict>;
+export declare const knowledgeMaterialWindowResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    tenantId: z.ZodString;
+    retainedThroughSeq: z.ZodNumber;
+    headSeq: z.ZodNumber;
+    projectRef: z.ZodString;
+}, z.core.$strict>;
+export declare const knowledgeMaterialChangesInputSchema: z.ZodObject<{
+    projectRef: z.ZodString;
+    afterSeq: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const knowledgeMaterialSearchInputSchema: z.ZodObject<{
+    projectRef: z.ZodString;
+    query: z.ZodString;
+    afterId: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    resourceType: z.ZodOptional<z.ZodString>;
+    sourceProjectKey: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const knowledgeMaterialPartitionsInputSchema: z.ZodObject<{
+    projectRef: z.ZodString;
+    afterRouteId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const knowledgeMaterialPartitionPageInputSchema: z.ZodObject<{
+    projectRef: z.ZodString;
+    partition: z.ZodEnum<{
+        OWNER: "OWNER";
+        LEGACY: "LEGACY";
+    }>;
+    after: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const knowledgeMaterialRoutePageInputSchema: z.ZodObject<{
+    projectRef: z.ZodString;
+    routeId: z.ZodString;
+    after: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const knowledgeMaterialMediaInputSchema: z.ZodObject<{
+    projectRef: z.ZodString;
+    ref: z.ZodString;
+    afterOrdinal: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    documentRef: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const knowledgeMaterialIndexStatusInputSchema: z.ZodObject<{
+    projectRef: z.ZodString;
+    afterSourceKey: z.ZodOptional<z.ZodString>;
+    afterNodeId: z.ZodOptional<z.ZodString>;
+    sourceProjectKey: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const knowledgeMaterialCapabilitiesResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    material: 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>;
+    projectRef: z.ZodString;
+    downloadUrl: z.ZodString;
+}, z.core.$strict>;
+export declare const knowledgeMaterialMediaResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    ref: z.ZodString;
+    state: z.ZodEnum<{
+        INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+        READY: "READY";
+        MISSING: "MISSING";
+        UNSUPPORTED: "UNSUPPORTED";
+        DENIED: "DENIED";
+    }>;
+    documentRef: z.ZodNullable<z.ZodString>;
+    items: z.ZodArray<z.ZodObject<{
+        ordinal: z.ZodNumber;
+        kind: z.ZodEnum<{
+            IMAGE: "IMAGE";
+            VIDEO: "VIDEO";
+            AUDIO: "AUDIO";
+        }>;
+        sourceUrl: z.ZodString;
+        canonicalUrl: z.ZodNullable<z.ZodString>;
+        availability: z.ZodEnum<{
+            UNAVAILABLE: "UNAVAILABLE";
+            MIRRORED: "MIRRORED";
+            REMOTE_ONLY: "REMOTE_ONLY";
+        }>;
+        mediaRef: z.ZodNullable<z.ZodString>;
+        contentHash: z.ZodNullable<z.ZodString>;
+        mediaType: z.ZodNullable<z.ZodString>;
+        byteLength: z.ZodNullable<z.ZodNumber>;
+        state: z.ZodEnum<{
+            UNAVAILABLE: "UNAVAILABLE";
+            INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+            READY: "READY";
+            REMOTE_ONLY: "REMOTE_ONLY";
+            MISSING: "MISSING";
+            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>>;
+    sourceContentHash: z.ZodString;
+    documentContentHash: z.ZodNullable<z.ZodString>;
+    nextAfterOrdinal: z.ZodNullable<z.ZodNumber>;
+    projectRef: z.ZodString;
+}, z.core.$strict>;
+export declare const knowledgeMaterialIndexStatusResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    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>>;
+    queryCoverage: z.ZodLiteral<"DESCRIPTIVE_METADATA_V1">;
+    indexedFields: z.ZodTuple<[z.ZodLiteral<"TITLE">, z.ZodLiteral<"SUMMARY">], null>;
+    bodyIndexed: z.ZodLiteral<false>;
+    semanticIndexed: z.ZodLiteral<false>;
+    projectRef: z.ZodString;
+}, z.core.$strict>;
+export declare const knowledgeMaterialToolInputSchemas: {
+    readonly knowledge_material_capabilities: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        projectRef: z.ZodString;
+        ref: z.ZodString;
+    }, z.core.$strict>>;
+    readonly knowledge_material_media: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        projectRef: z.ZodString;
+        ref: 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.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        projectRef: z.ZodString;
+        afterSourceKey: z.ZodOptional<z.ZodString>;
+        afterNodeId: z.ZodOptional<z.ZodString>;
+        sourceProjectKey: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    readonly knowledge_material_window: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        projectRef: z.ZodString;
+    }, z.core.$strict>>;
+    readonly knowledge_material_list: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        projectRef: z.ZodString;
+        after: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        resourceType: z.ZodOptional<z.ZodString>;
+        sourceProjectKey: z.ZodOptional<z.ZodString>;
+        refPrefix: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    readonly knowledge_material_describe: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        projectRef: z.ZodString;
+        ref: z.ZodString;
+    }, z.core.$strict>>;
+    readonly knowledge_material_read: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        projectRef: z.ZodString;
+        ref: z.ZodString;
+    }, z.core.$strict>>;
+    readonly knowledge_material_changes: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        projectRef: z.ZodString;
+        afterSeq: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    readonly knowledge_material_search: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        projectRef: z.ZodString;
+        query: z.ZodString;
+        afterId: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        resourceType: z.ZodOptional<z.ZodString>;
+        sourceProjectKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    readonly knowledge_material_partitions: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        projectRef: z.ZodString;
+        afterRouteId: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    readonly knowledge_material_partition_page: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        projectRef: z.ZodString;
+        partition: z.ZodEnum<{
+            OWNER: "OWNER";
+            LEGACY: "LEGACY";
+        }>;
+        after: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    readonly knowledge_material_route_page: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
+        projectRef: z.ZodString;
+        routeId: z.ZodString;
+        after: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+};
+export declare const knowledgeMaterialListResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectRef: z.ZodString;
+    contentClass: z.ZodLiteral<"MATERIAL_DIRECTORY">;
+    queryCoverage: z.ZodLiteral<"INDEXED_REF_SOURCE_TYPE_V1">;
+    order: z.ZodLiteral<"REF_ASC">;
+    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>;
+export declare const knowledgeMaterialDescribeResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectRef: z.ZodString;
+    contentClass: z.ZodLiteral<"MATERIAL_DESCRIPTOR">;
+    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>;
+    metadataByteLength: z.ZodNullable<z.ZodNumber>;
+    downloadUrl: z.ZodString;
+}, z.core.$strict>;
+export declare const knowledgeMaterialReadResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectRef: z.ZodString;
+    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>;
+    downloadUrl: z.ZodString;
+    metadataByteLength: z.ZodNullable<z.ZodNumber>;
+    contentClass: z.ZodLiteral<"MATERIAL_READ">;
+    inlineComplete: z.ZodBoolean;
+    byteVerification: z.ZodEnum<{
+        VERIFIED: "VERIFIED";
+        ON_DOWNLOAD: "ON_DOWNLOAD";
+    }>;
+    contentBase64: z.ZodNullable<z.ZodString>;
+    fileDescriptor: z.ZodNullable<z.ZodObject<{
+        contentHash: z.ZodString;
+        mediaType: z.ZodString;
+        byteLength: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const knowledgeMaterialChangesResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectRef: z.ZodString;
+    tenantId: z.ZodString;
+    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>;
+export declare const knowledgeMaterialSearchResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectRef: z.ZodString;
+    queryCoverage: z.ZodLiteral<"DESCRIPTIVE_METADATA_V1">;
+    order: z.ZodLiteral<"INDEX_ROWID_ASC">;
+    indexState: z.ZodEnum<{
+        PARTIAL_BACKFILL: "PARTIAL_BACKFILL";
+        SYNCED_AS_OF_LAST_OBSERVATION: "SYNCED_AS_OF_LAST_OBSERVATION";
+    }>;
+    configuredSourceCount: z.ZodNumber;
+    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>;
+}, z.core.$strict>;
+export declare const oauthMaterialRoutePageResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectRef: z.ZodString;
+    projectKey: z.ZodString;
+    routeId: z.ZodString;
+    contentClass: z.ZodLiteral<"MATERIAL_DIRECTORY">;
+    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>;
+export type OAuthMaterialRoutePageResponse = z.infer<typeof oauthMaterialRoutePageResponseSchema>;
+export declare const oauthMaterialPartitionsResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectRef: z.ZodString;
+    projectKey: z.ZodString;
+    coverage: z.ZodLiteral<"OWNER_LEGACY_AND_ACTIVE_ROUTES">;
+    items: z.ZodArray<z.ZodObject<{
+        routeId: z.ZodString;
+        sourceProjectKey: z.ZodString;
+        matchType: z.ZodEnum<{
+            REF: "REF";
+            SOURCE_PROJECT: "SOURCE_PROJECT";
+            SOURCE_SET: "SOURCE_SET";
+        }>;
+        matchValue: z.ZodString;
+    }, z.core.$strict>>;
+    nextAfterRouteId: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const oauthMaterialPartitionPageResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectRef: z.ZodString;
+    projectKey: z.ZodString;
+    contentClass: z.ZodLiteral<"MATERIAL_DIRECTORY">;
+    partition: z.ZodEnum<{
+        OWNER: "OWNER";
+        LEGACY: "LEGACY";
+    }>;
+    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>;
+export declare const knowledgeMaterialPartitionsResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectRef: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        routeId: z.ZodString;
+        sourceProjectKey: z.ZodString;
+        matchType: z.ZodEnum<{
+            REF: "REF";
+            SOURCE_PROJECT: "SOURCE_PROJECT";
+            SOURCE_SET: "SOURCE_SET";
+        }>;
+        matchValue: z.ZodString;
+    }, z.core.$strict>>;
+    coverage: z.ZodLiteral<"OWNER_LEGACY_AND_ACTIVE_ROUTES">;
+    nextAfterRouteId: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const knowledgeMaterialPartitionPageResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectRef: z.ZodString;
+    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>;
+    contentClass: z.ZodLiteral<"MATERIAL_DIRECTORY">;
+    partition: z.ZodEnum<{
+        OWNER: "OWNER";
+        LEGACY: "LEGACY";
+    }>;
+}, z.core.$strict>;
+export declare const knowledgeMaterialRoutePageResponseSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectRef: z.ZodString;
+    routeId: z.ZodString;
+    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>;
+    contentClass: z.ZodLiteral<"MATERIAL_DIRECTORY">;
+    routeState: z.ZodEnum<{
+        ACTIVE: "ACTIVE";
+        REVOKED: "REVOKED";
+        UNBOUND: "UNBOUND";
+    }>;
+}, z.core.$strict>;
+export type OAuthMaterialPartitionsResponse = z.infer<typeof oauthMaterialPartitionsResponseSchema>;
+export type OAuthMaterialPartitionPageResponse = z.infer<typeof oauthMaterialPartitionPageResponseSchema>;
+export declare const knowledgeMcpToolOutputSchemas: {
+    readonly knowledge_material_capabilities: {
+        type: string;
+        oneOf: ({
+            readonly type: "object";
+            readonly properties: {
+                readonly errorCode: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["errorCode"];
+            readonly additionalProperties: false;
+        } | z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>)[];
+    };
+    readonly knowledge_material_media: {
+        type: string;
+        oneOf: ({
+            readonly type: "object";
+            readonly properties: {
+                readonly errorCode: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["errorCode"];
+            readonly additionalProperties: false;
+        } | z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>)[];
+    };
+    readonly knowledge_material_index_status: {
+        type: string;
+        oneOf: ({
+            readonly type: "object";
+            readonly properties: {
+                readonly errorCode: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["errorCode"];
+            readonly additionalProperties: false;
+        } | z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>)[];
+    };
+    readonly knowledge_material_window: {
+        type: string;
+        oneOf: ({
+            readonly type: "object";
+            readonly properties: {
+                readonly errorCode: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["errorCode"];
+            readonly additionalProperties: false;
+        } | z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>)[];
+    };
+    readonly knowledge_search: {
+        type: string;
+        oneOf: ({
+            readonly type: "object";
+            readonly properties: {
+                readonly errorCode: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["errorCode"];
+            readonly additionalProperties: false;
+        } | z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>)[];
+    };
+    readonly knowledge_read: {
+        type: string;
+        oneOf: ({
+            readonly type: "object";
+            readonly properties: {
+                readonly errorCode: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["errorCode"];
+            readonly additionalProperties: false;
+        } | z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>)[];
+    };
+    readonly knowledge_list_evidence: {
+        type: string;
+        oneOf: ({
+            readonly type: "object";
+            readonly properties: {
+                readonly errorCode: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["errorCode"];
+            readonly additionalProperties: false;
+        } | z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>)[];
+    };
+    readonly knowledge_currentness: {
+        type: string;
+        oneOf: ({
+            readonly type: "object";
+            readonly properties: {
+                readonly errorCode: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["errorCode"];
+            readonly additionalProperties: false;
+        } | z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>)[];
+    };
+    readonly knowledge_reference_lookup: {
+        type: string;
+        oneOf: ({
+            readonly type: "object";
+            readonly properties: {
+                readonly errorCode: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["errorCode"];
+            readonly additionalProperties: false;
+        } | z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>)[];
+    };
+    readonly knowledge_material_list: {
+        type: string;
+        oneOf: ({
+            readonly type: "object";
+            readonly properties: {
+                readonly errorCode: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["errorCode"];
+            readonly additionalProperties: false;
+        } | z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>)[];
+    };
+    readonly knowledge_material_describe: {
+        type: string;
+        oneOf: ({
+            readonly type: "object";
+            readonly properties: {
+                readonly errorCode: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["errorCode"];
+            readonly additionalProperties: false;
+        } | z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>)[];
+    };
+    readonly knowledge_material_read: {
+        type: string;
+        oneOf: ({
+            readonly type: "object";
+            readonly properties: {
+                readonly errorCode: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["errorCode"];
+            readonly additionalProperties: false;
+        } | z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>)[];
+    };
+    readonly knowledge_material_changes: {
+        type: string;
+        oneOf: ({
+            readonly type: "object";
+            readonly properties: {
+                readonly errorCode: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["errorCode"];
+            readonly additionalProperties: false;
+        } | z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>)[];
+    };
+    readonly knowledge_material_search: {
+        type: string;
+        oneOf: ({
+            readonly type: "object";
+            readonly properties: {
+                readonly errorCode: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["errorCode"];
+            readonly additionalProperties: false;
+        } | z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>)[];
+    };
+    readonly knowledge_material_partitions: {
+        type: string;
+        oneOf: ({
+            readonly type: "object";
+            readonly properties: {
+                readonly errorCode: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["errorCode"];
+            readonly additionalProperties: false;
+        } | z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>)[];
+    };
+    readonly knowledge_material_partition_page: {
+        type: string;
+        oneOf: ({
+            readonly type: "object";
+            readonly properties: {
+                readonly errorCode: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["errorCode"];
+            readonly additionalProperties: false;
+        } | z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>)[];
+    };
+    readonly knowledge_material_route_page: {
+        type: string;
+        oneOf: ({
+            readonly type: "object";
+            readonly properties: {
+                readonly errorCode: {
+                    readonly type: "string";
+                };
+            };
+            readonly required: readonly ["errorCode"];
+            readonly additionalProperties: false;
+        } | z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>)[];
+    };
+};
+/** v4 在独立发现版本中公布工具输出合同，v1 至 v3 的严格结构不变。 */
+export declare const knowledgeMcpProviderContractV4Schema: z.ZodObject<{
+    scopes: z.ZodArray<z.ZodEnum<{
+        "knowledge.read": "knowledge.read";
+        "knowledge.search": "knowledge.search";
+        "knowledge.currentness": "knowledge.currentness";
+    }>>;
+    resource: z.ZodNullable<z.ZodString>;
+    authorizationEndpoint: z.ZodNullable<z.ZodString>;
+    tokenEndpoint: z.ZodNullable<z.ZodString>;
+    revocationEndpoint: z.ZodNullable<z.ZodString>;
+    provider: z.ZodLiteral<"knowledge-v2">;
+    protocols: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        version: z.ZodLiteral<"2026-07-28">;
+        lifecycle: z.ZodLiteral<"STATELESS_DISCOVERY">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>, z.ZodObject<{
+        version: z.ZodLiteral<"2025-06-18">;
+        lifecycle: z.ZodLiteral<"INITIALIZE">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>], "version">>;
+    revision: z.ZodString;
+    searchCoverage: z.ZodEnum<{
+        AUTHORIZED_METADATA_V1: "AUTHORIZED_METADATA_V1";
+        AUTHORIZED_PRESENTATION_V1: "AUTHORIZED_PRESENTATION_V1";
+    }>;
+    validationStatus: z.ZodEnum<{
+        NOT_VERIFIED: "NOT_VERIFIED";
+        RUNTIME_CONFIGURED: "RUNTIME_CONFIGURED";
+    }>;
+    externalReachability: z.ZodLiteral<"NOT_VERIFIED">;
+    endpoint: z.ZodNullable<z.ZodString>;
+    mediaEndpoint: z.ZodNullable<z.ZodString>;
+    protectedResourceMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationServerMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationMode: z.ZodLiteral<"OAUTH_2_1_AUTHORIZATION_CODE_PKCE_S256_USER_DELEGATED">;
+    clientRegistration: z.ZodLiteral<"PRE_REGISTERED">;
+    clientId: z.ZodNull;
+    authorizationMapping: z.ZodObject<{
+        oauthResourceParameter: z.ZodLiteral<"resource">;
+        externalTenantParameter: z.ZodLiteral<"external_tenant_id">;
+        projectRefParameter: z.ZodLiteral<"project_ref">;
+        externalSystemSource: z.ZodLiteral<"client_id">;
+        grantBinding: z.ZodLiteral<"RESOURCE_EXTERNAL_TENANT_PROJECT_REF_SCOPES">;
+    }, z.core.$strict>;
+    defaultProtocolVersion: z.ZodLiteral<"2026-07-28">;
+    schemaVersion: z.ZodLiteral<4>;
+    contentEndpoint: z.ZodNullable<z.ZodString>;
+    evidenceFileEndpoint: z.ZodNullable<z.ZodString>;
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodEnum<{
+            knowledge_search: "knowledge_search";
+            knowledge_read: "knowledge_read";
+            knowledge_currentness: "knowledge_currentness";
+            knowledge_reference_lookup: "knowledge_reference_lookup";
+            knowledge_list_evidence: "knowledge_list_evidence";
+        }>;
+        requiredScope: z.ZodEnum<{
+            "knowledge.read": "knowledge.read";
+            "knowledge.search": "knowledge.search";
+            "knowledge.currentness": "knowledge.currentness";
+        }>;
+        inputSchema: z.ZodJSONSchema;
+        outputSchema: z.ZodJSONSchema;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type KnowledgeMcpProviderContractV4 = z.infer<typeof knowledgeMcpProviderContractV4Schema>;
+/** v5 单独声明受治理写入工具；旧版本继续只描述只读消费合同。 */
+export declare const knowledgeMcpProviderContractV5Schema: z.ZodObject<{
+    resource: z.ZodNullable<z.ZodString>;
+    authorizationEndpoint: z.ZodNullable<z.ZodString>;
+    tokenEndpoint: z.ZodNullable<z.ZodString>;
+    revocationEndpoint: z.ZodNullable<z.ZodString>;
+    provider: z.ZodLiteral<"knowledge-v2">;
+    protocols: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        version: z.ZodLiteral<"2026-07-28">;
+        lifecycle: z.ZodLiteral<"STATELESS_DISCOVERY">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>, z.ZodObject<{
+        version: z.ZodLiteral<"2025-06-18">;
+        lifecycle: z.ZodLiteral<"INITIALIZE">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>], "version">>;
+    revision: z.ZodString;
+    searchCoverage: z.ZodEnum<{
+        AUTHORIZED_METADATA_V1: "AUTHORIZED_METADATA_V1";
+        AUTHORIZED_PRESENTATION_V1: "AUTHORIZED_PRESENTATION_V1";
+    }>;
+    validationStatus: z.ZodEnum<{
+        NOT_VERIFIED: "NOT_VERIFIED";
+        RUNTIME_CONFIGURED: "RUNTIME_CONFIGURED";
+    }>;
+    externalReachability: z.ZodLiteral<"NOT_VERIFIED">;
+    endpoint: z.ZodNullable<z.ZodString>;
+    mediaEndpoint: z.ZodNullable<z.ZodString>;
+    protectedResourceMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationServerMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationMode: z.ZodLiteral<"OAUTH_2_1_AUTHORIZATION_CODE_PKCE_S256_USER_DELEGATED">;
+    clientRegistration: z.ZodLiteral<"PRE_REGISTERED">;
+    clientId: z.ZodNull;
+    authorizationMapping: z.ZodObject<{
+        oauthResourceParameter: z.ZodLiteral<"resource">;
+        externalTenantParameter: z.ZodLiteral<"external_tenant_id">;
+        projectRefParameter: z.ZodLiteral<"project_ref">;
+        externalSystemSource: z.ZodLiteral<"client_id">;
+        grantBinding: z.ZodLiteral<"RESOURCE_EXTERNAL_TENANT_PROJECT_REF_SCOPES">;
+    }, z.core.$strict>;
+    defaultProtocolVersion: z.ZodLiteral<"2026-07-28">;
+    schemaVersion: z.ZodLiteral<5>;
+    contentEndpoint: z.ZodNullable<z.ZodString>;
+    evidenceFileEndpoint: z.ZodNullable<z.ZodString>;
+    managementMode: z.ZodLiteral<"EXPLICIT_CLIENT_PROJECT_SCOPE">;
+    managementEnabled: z.ZodBoolean;
+    scopes: z.ZodArray<z.ZodEnum<{
+        "knowledge.compose": "knowledge.compose";
+        "knowledge.review": "knowledge.review";
+        "knowledge.read": "knowledge.read";
+        "knowledge.approve": "knowledge.approve";
+        "knowledge.search": "knowledge.search";
+        "knowledge.currentness": "knowledge.currentness";
+    }>>;
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodEnum<{
+            knowledge_search: "knowledge_search";
+            knowledge_read: "knowledge_read";
+            knowledge_currentness: "knowledge_currentness";
+            knowledge_reference_lookup: "knowledge_reference_lookup";
+            knowledge_list_evidence: "knowledge_list_evidence";
+            knowledge_compose: "knowledge_compose";
+            knowledge_submit_review: "knowledge_submit_review";
+            knowledge_review: "knowledge_review";
+            knowledge_finalize_review: "knowledge_finalize_review";
+        }>;
+        requiredScope: z.ZodEnum<{
+            "knowledge.compose": "knowledge.compose";
+            "knowledge.review": "knowledge.review";
+            "knowledge.read": "knowledge.read";
+            "knowledge.approve": "knowledge.approve";
+            "knowledge.search": "knowledge.search";
+            "knowledge.currentness": "knowledge.currentness";
+        }>;
+        inputSchema: z.ZodJSONSchema;
+        outputSchema: z.ZodJSONSchema;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type KnowledgeMcpProviderContractV5 = z.infer<typeof knowledgeMcpProviderContractV5Schema>;
+/** v6 advertises tenant-scoped, immutable material discovery and byte reads. */
+export declare const knowledgeMcpProviderContractV6Schema: z.ZodObject<{
+    scopes: z.ZodArray<z.ZodEnum<{
+        "knowledge.compose": "knowledge.compose";
+        "knowledge.review": "knowledge.review";
+        "knowledge.read": "knowledge.read";
+        "knowledge.approve": "knowledge.approve";
+        "knowledge.search": "knowledge.search";
+        "knowledge.currentness": "knowledge.currentness";
+    }>>;
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodEnum<{
+            knowledge_search: "knowledge_search";
+            knowledge_read: "knowledge_read";
+            knowledge_currentness: "knowledge_currentness";
+            knowledge_reference_lookup: "knowledge_reference_lookup";
+            knowledge_list_evidence: "knowledge_list_evidence";
+            knowledge_compose: "knowledge_compose";
+            knowledge_submit_review: "knowledge_submit_review";
+            knowledge_review: "knowledge_review";
+            knowledge_finalize_review: "knowledge_finalize_review";
+        }>;
+        requiredScope: z.ZodEnum<{
+            "knowledge.compose": "knowledge.compose";
+            "knowledge.review": "knowledge.review";
+            "knowledge.read": "knowledge.read";
+            "knowledge.approve": "knowledge.approve";
+            "knowledge.search": "knowledge.search";
+            "knowledge.currentness": "knowledge.currentness";
+        }>;
+        inputSchema: z.ZodJSONSchema;
+        outputSchema: z.ZodJSONSchema;
+    }, z.core.$strict>>;
+    resource: z.ZodNullable<z.ZodString>;
+    authorizationEndpoint: z.ZodNullable<z.ZodString>;
+    tokenEndpoint: z.ZodNullable<z.ZodString>;
+    revocationEndpoint: z.ZodNullable<z.ZodString>;
+    contentEndpoint: z.ZodNullable<z.ZodString>;
+    provider: z.ZodLiteral<"knowledge-v2">;
+    protocols: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        version: z.ZodLiteral<"2026-07-28">;
+        lifecycle: z.ZodLiteral<"STATELESS_DISCOVERY">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>, z.ZodObject<{
+        version: z.ZodLiteral<"2025-06-18">;
+        lifecycle: z.ZodLiteral<"INITIALIZE">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>], "version">>;
+    revision: z.ZodString;
+    searchCoverage: z.ZodEnum<{
+        AUTHORIZED_METADATA_V1: "AUTHORIZED_METADATA_V1";
+        AUTHORIZED_PRESENTATION_V1: "AUTHORIZED_PRESENTATION_V1";
+    }>;
+    validationStatus: z.ZodEnum<{
+        NOT_VERIFIED: "NOT_VERIFIED";
+        RUNTIME_CONFIGURED: "RUNTIME_CONFIGURED";
+    }>;
+    externalReachability: z.ZodLiteral<"NOT_VERIFIED">;
+    endpoint: z.ZodNullable<z.ZodString>;
+    mediaEndpoint: z.ZodNullable<z.ZodString>;
+    protectedResourceMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationServerMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationMode: z.ZodLiteral<"OAUTH_2_1_AUTHORIZATION_CODE_PKCE_S256_USER_DELEGATED">;
+    clientRegistration: z.ZodLiteral<"PRE_REGISTERED">;
+    clientId: z.ZodNull;
+    authorizationMapping: z.ZodObject<{
+        oauthResourceParameter: z.ZodLiteral<"resource">;
+        externalTenantParameter: z.ZodLiteral<"external_tenant_id">;
+        projectRefParameter: z.ZodLiteral<"project_ref">;
+        externalSystemSource: z.ZodLiteral<"client_id">;
+        grantBinding: z.ZodLiteral<"RESOURCE_EXTERNAL_TENANT_PROJECT_REF_SCOPES">;
+    }, z.core.$strict>;
+    defaultProtocolVersion: z.ZodLiteral<"2026-07-28">;
+    evidenceFileEndpoint: z.ZodNullable<z.ZodString>;
+    managementMode: z.ZodLiteral<"EXPLICIT_CLIENT_PROJECT_SCOPE">;
+    managementEnabled: z.ZodBoolean;
+    schemaVersion: z.ZodLiteral<6>;
+    materialPageEndpoint: z.ZodString;
+    materialEndpoint: z.ZodString;
+    materialPresentationEndpoint: z.ZodString;
+}, z.core.$strict>;
+export type KnowledgeMcpProviderContractV6 = z.infer<typeof knowledgeMcpProviderContractV6Schema>;
+/** v7 publishes independent raw-material consent without changing older provider contracts. */
+export declare const knowledgeMcpProviderContractV7Schema: z.ZodObject<{
+    resource: z.ZodNullable<z.ZodString>;
+    authorizationEndpoint: z.ZodNullable<z.ZodString>;
+    tokenEndpoint: z.ZodNullable<z.ZodString>;
+    revocationEndpoint: z.ZodNullable<z.ZodString>;
+    contentEndpoint: z.ZodNullable<z.ZodString>;
+    provider: z.ZodLiteral<"knowledge-v2">;
+    protocols: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        version: z.ZodLiteral<"2026-07-28">;
+        lifecycle: z.ZodLiteral<"STATELESS_DISCOVERY">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>, z.ZodObject<{
+        version: z.ZodLiteral<"2025-06-18">;
+        lifecycle: z.ZodLiteral<"INITIALIZE">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>], "version">>;
+    revision: z.ZodString;
+    searchCoverage: z.ZodEnum<{
+        AUTHORIZED_METADATA_V1: "AUTHORIZED_METADATA_V1";
+        AUTHORIZED_PRESENTATION_V1: "AUTHORIZED_PRESENTATION_V1";
+    }>;
+    validationStatus: z.ZodEnum<{
+        NOT_VERIFIED: "NOT_VERIFIED";
+        RUNTIME_CONFIGURED: "RUNTIME_CONFIGURED";
+    }>;
+    externalReachability: z.ZodLiteral<"NOT_VERIFIED">;
+    endpoint: z.ZodNullable<z.ZodString>;
+    mediaEndpoint: z.ZodNullable<z.ZodString>;
+    protectedResourceMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationServerMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationMode: z.ZodLiteral<"OAUTH_2_1_AUTHORIZATION_CODE_PKCE_S256_USER_DELEGATED">;
+    clientRegistration: z.ZodLiteral<"PRE_REGISTERED">;
+    clientId: z.ZodNull;
+    authorizationMapping: z.ZodObject<{
+        oauthResourceParameter: z.ZodLiteral<"resource">;
+        externalTenantParameter: z.ZodLiteral<"external_tenant_id">;
+        projectRefParameter: z.ZodLiteral<"project_ref">;
+        externalSystemSource: z.ZodLiteral<"client_id">;
+        grantBinding: z.ZodLiteral<"RESOURCE_EXTERNAL_TENANT_PROJECT_REF_SCOPES">;
+    }, z.core.$strict>;
+    defaultProtocolVersion: z.ZodLiteral<"2026-07-28">;
+    evidenceFileEndpoint: z.ZodNullable<z.ZodString>;
+    managementMode: z.ZodLiteral<"EXPLICIT_CLIENT_PROJECT_SCOPE">;
+    managementEnabled: z.ZodBoolean;
+    materialPageEndpoint: z.ZodString;
+    materialEndpoint: z.ZodString;
+    materialPresentationEndpoint: z.ZodString;
+    schemaVersion: z.ZodLiteral<7>;
+    materialReadMode: z.ZodLiteral<"OAUTH_SCOPE_AND_CLIENT_PROJECT_BINDING">;
+    scopes: z.ZodArray<z.ZodEnum<{
+        "knowledge.compose": "knowledge.compose";
+        "knowledge.review": "knowledge.review";
+        "knowledge.material.route": "knowledge.material.route";
+        "knowledge.read": "knowledge.read";
+        "knowledge.approve": "knowledge.approve";
+        "knowledge.material.read": "knowledge.material.read";
+        "knowledge.search": "knowledge.search";
+        "knowledge.currentness": "knowledge.currentness";
+    }>>;
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodEnum<{
+            knowledge_search: "knowledge_search";
+            knowledge_read: "knowledge_read";
+            knowledge_currentness: "knowledge_currentness";
+            knowledge_reference_lookup: "knowledge_reference_lookup";
+            knowledge_list_evidence: "knowledge_list_evidence";
+            knowledge_compose: "knowledge_compose";
+            knowledge_submit_review: "knowledge_submit_review";
+            knowledge_review: "knowledge_review";
+            knowledge_finalize_review: "knowledge_finalize_review";
+            knowledge_material_list: "knowledge_material_list";
+            knowledge_material_describe: "knowledge_material_describe";
+            knowledge_material_read: "knowledge_material_read";
+            knowledge_material_changes: "knowledge_material_changes";
+            knowledge_material_route: "knowledge_material_route";
+        }>;
+        requiredScope: z.ZodEnum<{
+            "knowledge.compose": "knowledge.compose";
+            "knowledge.review": "knowledge.review";
+            "knowledge.material.route": "knowledge.material.route";
+            "knowledge.read": "knowledge.read";
+            "knowledge.approve": "knowledge.approve";
+            "knowledge.material.read": "knowledge.material.read";
+            "knowledge.search": "knowledge.search";
+            "knowledge.currentness": "knowledge.currentness";
+        }>;
+        inputSchema: z.ZodJSONSchema;
+        outputSchema: z.ZodJSONSchema;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type KnowledgeMcpProviderContractV7 = z.infer<typeof knowledgeMcpProviderContractV7Schema>;
+/** v8 adds descriptive metadata search with an explicit index-coverage state. */
+export declare const knowledgeMcpProviderContractV8Schema: z.ZodObject<{
+    scopes: z.ZodArray<z.ZodEnum<{
+        "knowledge.compose": "knowledge.compose";
+        "knowledge.review": "knowledge.review";
+        "knowledge.material.route": "knowledge.material.route";
+        "knowledge.read": "knowledge.read";
+        "knowledge.approve": "knowledge.approve";
+        "knowledge.material.read": "knowledge.material.read";
+        "knowledge.search": "knowledge.search";
+        "knowledge.currentness": "knowledge.currentness";
+    }>>;
+    resource: z.ZodNullable<z.ZodString>;
+    authorizationEndpoint: z.ZodNullable<z.ZodString>;
+    tokenEndpoint: z.ZodNullable<z.ZodString>;
+    revocationEndpoint: z.ZodNullable<z.ZodString>;
+    contentEndpoint: z.ZodNullable<z.ZodString>;
+    provider: z.ZodLiteral<"knowledge-v2">;
+    protocols: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        version: z.ZodLiteral<"2026-07-28">;
+        lifecycle: z.ZodLiteral<"STATELESS_DISCOVERY">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>, z.ZodObject<{
+        version: z.ZodLiteral<"2025-06-18">;
+        lifecycle: z.ZodLiteral<"INITIALIZE">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>], "version">>;
+    revision: z.ZodString;
+    searchCoverage: z.ZodEnum<{
+        AUTHORIZED_METADATA_V1: "AUTHORIZED_METADATA_V1";
+        AUTHORIZED_PRESENTATION_V1: "AUTHORIZED_PRESENTATION_V1";
+    }>;
+    validationStatus: z.ZodEnum<{
+        NOT_VERIFIED: "NOT_VERIFIED";
+        RUNTIME_CONFIGURED: "RUNTIME_CONFIGURED";
+    }>;
+    externalReachability: z.ZodLiteral<"NOT_VERIFIED">;
+    endpoint: z.ZodNullable<z.ZodString>;
+    mediaEndpoint: z.ZodNullable<z.ZodString>;
+    protectedResourceMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationServerMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationMode: z.ZodLiteral<"OAUTH_2_1_AUTHORIZATION_CODE_PKCE_S256_USER_DELEGATED">;
+    clientRegistration: z.ZodLiteral<"PRE_REGISTERED">;
+    clientId: z.ZodNull;
+    authorizationMapping: z.ZodObject<{
+        oauthResourceParameter: z.ZodLiteral<"resource">;
+        externalTenantParameter: z.ZodLiteral<"external_tenant_id">;
+        projectRefParameter: z.ZodLiteral<"project_ref">;
+        externalSystemSource: z.ZodLiteral<"client_id">;
+        grantBinding: z.ZodLiteral<"RESOURCE_EXTERNAL_TENANT_PROJECT_REF_SCOPES">;
+    }, z.core.$strict>;
+    defaultProtocolVersion: z.ZodLiteral<"2026-07-28">;
+    evidenceFileEndpoint: z.ZodNullable<z.ZodString>;
+    managementMode: z.ZodLiteral<"EXPLICIT_CLIENT_PROJECT_SCOPE">;
+    managementEnabled: z.ZodBoolean;
+    materialPageEndpoint: z.ZodString;
+    materialEndpoint: z.ZodString;
+    materialPresentationEndpoint: z.ZodString;
+    materialReadMode: z.ZodLiteral<"OAUTH_SCOPE_AND_CLIENT_PROJECT_BINDING">;
+    schemaVersion: z.ZodLiteral<8>;
+    materialSearchMode: z.ZodLiteral<"INDEXED_DESCRIPTIVE_METADATA">;
+    materialSearchEndpoint: z.ZodString;
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodEnum<{
+            knowledge_search: "knowledge_search";
+            knowledge_read: "knowledge_read";
+            knowledge_currentness: "knowledge_currentness";
+            knowledge_reference_lookup: "knowledge_reference_lookup";
+            knowledge_list_evidence: "knowledge_list_evidence";
+            knowledge_compose: "knowledge_compose";
+            knowledge_submit_review: "knowledge_submit_review";
+            knowledge_review: "knowledge_review";
+            knowledge_finalize_review: "knowledge_finalize_review";
+            knowledge_material_list: "knowledge_material_list";
+            knowledge_material_describe: "knowledge_material_describe";
+            knowledge_material_read: "knowledge_material_read";
+            knowledge_material_changes: "knowledge_material_changes";
+            knowledge_material_route: "knowledge_material_route";
+            knowledge_material_search: "knowledge_material_search";
+        }>;
+        requiredScope: z.ZodEnum<{
+            "knowledge.compose": "knowledge.compose";
+            "knowledge.review": "knowledge.review";
+            "knowledge.material.route": "knowledge.material.route";
+            "knowledge.read": "knowledge.read";
+            "knowledge.approve": "knowledge.approve";
+            "knowledge.material.read": "knowledge.material.read";
+            "knowledge.search": "knowledge.search";
+            "knowledge.currentness": "knowledge.currentness";
+        }>;
+        inputSchema: z.ZodJSONSchema;
+        outputSchema: z.ZodJSONSchema;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type KnowledgeMcpProviderContractV8 = z.infer<typeof knowledgeMcpProviderContractV8Schema>;
+/** v9 advertises bounded per-route replay for null-ref change events. */
+export declare const knowledgeMcpProviderContractV9Schema: z.ZodObject<{
+    scopes: z.ZodArray<z.ZodEnum<{
+        "knowledge.compose": "knowledge.compose";
+        "knowledge.review": "knowledge.review";
+        "knowledge.material.route": "knowledge.material.route";
+        "knowledge.read": "knowledge.read";
+        "knowledge.approve": "knowledge.approve";
+        "knowledge.material.read": "knowledge.material.read";
+        "knowledge.search": "knowledge.search";
+        "knowledge.currentness": "knowledge.currentness";
+    }>>;
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodEnum<{
+            knowledge_search: "knowledge_search";
+            knowledge_read: "knowledge_read";
+            knowledge_currentness: "knowledge_currentness";
+            knowledge_reference_lookup: "knowledge_reference_lookup";
+            knowledge_list_evidence: "knowledge_list_evidence";
+            knowledge_compose: "knowledge_compose";
+            knowledge_submit_review: "knowledge_submit_review";
+            knowledge_review: "knowledge_review";
+            knowledge_finalize_review: "knowledge_finalize_review";
+            knowledge_material_list: "knowledge_material_list";
+            knowledge_material_describe: "knowledge_material_describe";
+            knowledge_material_read: "knowledge_material_read";
+            knowledge_material_changes: "knowledge_material_changes";
+            knowledge_material_route: "knowledge_material_route";
+            knowledge_material_search: "knowledge_material_search";
+        }>;
+        requiredScope: z.ZodEnum<{
+            "knowledge.compose": "knowledge.compose";
+            "knowledge.review": "knowledge.review";
+            "knowledge.material.route": "knowledge.material.route";
+            "knowledge.read": "knowledge.read";
+            "knowledge.approve": "knowledge.approve";
+            "knowledge.material.read": "knowledge.material.read";
+            "knowledge.search": "knowledge.search";
+            "knowledge.currentness": "knowledge.currentness";
+        }>;
+        inputSchema: z.ZodJSONSchema;
+        outputSchema: z.ZodJSONSchema;
+    }, z.core.$strict>>;
+    resource: z.ZodNullable<z.ZodString>;
+    authorizationEndpoint: z.ZodNullable<z.ZodString>;
+    tokenEndpoint: z.ZodNullable<z.ZodString>;
+    revocationEndpoint: z.ZodNullable<z.ZodString>;
+    contentEndpoint: z.ZodNullable<z.ZodString>;
+    provider: z.ZodLiteral<"knowledge-v2">;
+    protocols: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        version: z.ZodLiteral<"2026-07-28">;
+        lifecycle: z.ZodLiteral<"STATELESS_DISCOVERY">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>, z.ZodObject<{
+        version: z.ZodLiteral<"2025-06-18">;
+        lifecycle: z.ZodLiteral<"INITIALIZE">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>], "version">>;
+    revision: z.ZodString;
+    searchCoverage: z.ZodEnum<{
+        AUTHORIZED_METADATA_V1: "AUTHORIZED_METADATA_V1";
+        AUTHORIZED_PRESENTATION_V1: "AUTHORIZED_PRESENTATION_V1";
+    }>;
+    validationStatus: z.ZodEnum<{
+        NOT_VERIFIED: "NOT_VERIFIED";
+        RUNTIME_CONFIGURED: "RUNTIME_CONFIGURED";
+    }>;
+    externalReachability: z.ZodLiteral<"NOT_VERIFIED">;
+    endpoint: z.ZodNullable<z.ZodString>;
+    mediaEndpoint: z.ZodNullable<z.ZodString>;
+    protectedResourceMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationServerMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationMode: z.ZodLiteral<"OAUTH_2_1_AUTHORIZATION_CODE_PKCE_S256_USER_DELEGATED">;
+    clientRegistration: z.ZodLiteral<"PRE_REGISTERED">;
+    clientId: z.ZodNull;
+    authorizationMapping: z.ZodObject<{
+        oauthResourceParameter: z.ZodLiteral<"resource">;
+        externalTenantParameter: z.ZodLiteral<"external_tenant_id">;
+        projectRefParameter: z.ZodLiteral<"project_ref">;
+        externalSystemSource: z.ZodLiteral<"client_id">;
+        grantBinding: z.ZodLiteral<"RESOURCE_EXTERNAL_TENANT_PROJECT_REF_SCOPES">;
+    }, z.core.$strict>;
+    defaultProtocolVersion: z.ZodLiteral<"2026-07-28">;
+    evidenceFileEndpoint: z.ZodNullable<z.ZodString>;
+    managementMode: z.ZodLiteral<"EXPLICIT_CLIENT_PROJECT_SCOPE">;
+    managementEnabled: z.ZodBoolean;
+    materialPageEndpoint: z.ZodString;
+    materialEndpoint: z.ZodString;
+    materialPresentationEndpoint: z.ZodString;
+    materialReadMode: z.ZodLiteral<"OAUTH_SCOPE_AND_CLIENT_PROJECT_BINDING">;
+    materialSearchMode: z.ZodLiteral<"INDEXED_DESCRIPTIVE_METADATA">;
+    materialSearchEndpoint: z.ZodString;
+    schemaVersion: z.ZodLiteral<9>;
+    materialRoutePageEndpoint: z.ZodString;
+}, z.core.$strict>;
+export type KnowledgeMcpProviderContractV9 = z.infer<typeof knowledgeMcpProviderContractV9Schema>;
+/** v10 publishes route-count-independent partitioned material discovery. */
+export declare const knowledgeMcpProviderContractV10Schema: z.ZodObject<{
+    scopes: z.ZodArray<z.ZodEnum<{
+        "knowledge.compose": "knowledge.compose";
+        "knowledge.review": "knowledge.review";
+        "knowledge.material.route": "knowledge.material.route";
+        "knowledge.read": "knowledge.read";
+        "knowledge.approve": "knowledge.approve";
+        "knowledge.material.read": "knowledge.material.read";
+        "knowledge.search": "knowledge.search";
+        "knowledge.currentness": "knowledge.currentness";
+    }>>;
+    resource: z.ZodNullable<z.ZodString>;
+    authorizationEndpoint: z.ZodNullable<z.ZodString>;
+    tokenEndpoint: z.ZodNullable<z.ZodString>;
+    revocationEndpoint: z.ZodNullable<z.ZodString>;
+    contentEndpoint: z.ZodNullable<z.ZodString>;
+    provider: z.ZodLiteral<"knowledge-v2">;
+    protocols: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        version: z.ZodLiteral<"2026-07-28">;
+        lifecycle: z.ZodLiteral<"STATELESS_DISCOVERY">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>, z.ZodObject<{
+        version: z.ZodLiteral<"2025-06-18">;
+        lifecycle: z.ZodLiteral<"INITIALIZE">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>], "version">>;
+    revision: z.ZodString;
+    searchCoverage: z.ZodEnum<{
+        AUTHORIZED_METADATA_V1: "AUTHORIZED_METADATA_V1";
+        AUTHORIZED_PRESENTATION_V1: "AUTHORIZED_PRESENTATION_V1";
+    }>;
+    validationStatus: z.ZodEnum<{
+        NOT_VERIFIED: "NOT_VERIFIED";
+        RUNTIME_CONFIGURED: "RUNTIME_CONFIGURED";
+    }>;
+    externalReachability: z.ZodLiteral<"NOT_VERIFIED">;
+    endpoint: z.ZodNullable<z.ZodString>;
+    mediaEndpoint: z.ZodNullable<z.ZodString>;
+    protectedResourceMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationServerMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationMode: z.ZodLiteral<"OAUTH_2_1_AUTHORIZATION_CODE_PKCE_S256_USER_DELEGATED">;
+    clientRegistration: z.ZodLiteral<"PRE_REGISTERED">;
+    clientId: z.ZodNull;
+    authorizationMapping: z.ZodObject<{
+        oauthResourceParameter: z.ZodLiteral<"resource">;
+        externalTenantParameter: z.ZodLiteral<"external_tenant_id">;
+        projectRefParameter: z.ZodLiteral<"project_ref">;
+        externalSystemSource: z.ZodLiteral<"client_id">;
+        grantBinding: z.ZodLiteral<"RESOURCE_EXTERNAL_TENANT_PROJECT_REF_SCOPES">;
+    }, z.core.$strict>;
+    defaultProtocolVersion: z.ZodLiteral<"2026-07-28">;
+    evidenceFileEndpoint: z.ZodNullable<z.ZodString>;
+    managementMode: z.ZodLiteral<"EXPLICIT_CLIENT_PROJECT_SCOPE">;
+    managementEnabled: z.ZodBoolean;
+    materialPageEndpoint: z.ZodString;
+    materialEndpoint: z.ZodString;
+    materialPresentationEndpoint: z.ZodString;
+    materialReadMode: z.ZodLiteral<"OAUTH_SCOPE_AND_CLIENT_PROJECT_BINDING">;
+    materialSearchMode: z.ZodLiteral<"INDEXED_DESCRIPTIVE_METADATA">;
+    materialSearchEndpoint: z.ZodString;
+    materialRoutePageEndpoint: z.ZodString;
+    schemaVersion: z.ZodLiteral<10>;
+    materialPartitionsEndpoint: z.ZodString;
+    materialPartitionPageEndpoint: z.ZodString;
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodEnum<{
+            knowledge_search: "knowledge_search";
+            knowledge_read: "knowledge_read";
+            knowledge_currentness: "knowledge_currentness";
+            knowledge_reference_lookup: "knowledge_reference_lookup";
+            knowledge_list_evidence: "knowledge_list_evidence";
+            knowledge_compose: "knowledge_compose";
+            knowledge_submit_review: "knowledge_submit_review";
+            knowledge_review: "knowledge_review";
+            knowledge_finalize_review: "knowledge_finalize_review";
+            knowledge_material_list: "knowledge_material_list";
+            knowledge_material_describe: "knowledge_material_describe";
+            knowledge_material_read: "knowledge_material_read";
+            knowledge_material_changes: "knowledge_material_changes";
+            knowledge_material_route: "knowledge_material_route";
+            knowledge_material_search: "knowledge_material_search";
+            knowledge_material_partitions: "knowledge_material_partitions";
+            knowledge_material_partition_page: "knowledge_material_partition_page";
+            knowledge_material_route_page: "knowledge_material_route_page";
+        }>;
+        requiredScope: z.ZodEnum<{
+            "knowledge.compose": "knowledge.compose";
+            "knowledge.review": "knowledge.review";
+            "knowledge.material.route": "knowledge.material.route";
+            "knowledge.read": "knowledge.read";
+            "knowledge.approve": "knowledge.approve";
+            "knowledge.material.read": "knowledge.material.read";
+            "knowledge.search": "knowledge.search";
+            "knowledge.currentness": "knowledge.currentness";
+        }>;
+        inputSchema: z.ZodJSONSchema;
+        outputSchema: z.ZodJSONSchema;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type KnowledgeMcpProviderContractV10 = z.infer<typeof knowledgeMcpProviderContractV10Schema>;
+/** v11 adds an Agent-native checkpoint for initial synchronization and retention-gap recovery. */
+export declare const knowledgeMcpProviderContractV11Schema: z.ZodObject<{
+    scopes: z.ZodArray<z.ZodEnum<{
+        "knowledge.compose": "knowledge.compose";
+        "knowledge.review": "knowledge.review";
+        "knowledge.material.route": "knowledge.material.route";
+        "knowledge.read": "knowledge.read";
+        "knowledge.approve": "knowledge.approve";
+        "knowledge.material.read": "knowledge.material.read";
+        "knowledge.search": "knowledge.search";
+        "knowledge.currentness": "knowledge.currentness";
+    }>>;
+    resource: z.ZodNullable<z.ZodString>;
+    authorizationEndpoint: z.ZodNullable<z.ZodString>;
+    tokenEndpoint: z.ZodNullable<z.ZodString>;
+    revocationEndpoint: z.ZodNullable<z.ZodString>;
+    contentEndpoint: z.ZodNullable<z.ZodString>;
+    provider: z.ZodLiteral<"knowledge-v2">;
+    protocols: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        version: z.ZodLiteral<"2026-07-28">;
+        lifecycle: z.ZodLiteral<"STATELESS_DISCOVERY">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>, z.ZodObject<{
+        version: z.ZodLiteral<"2025-06-18">;
+        lifecycle: z.ZodLiteral<"INITIALIZE">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>], "version">>;
+    revision: z.ZodString;
+    searchCoverage: z.ZodEnum<{
+        AUTHORIZED_METADATA_V1: "AUTHORIZED_METADATA_V1";
+        AUTHORIZED_PRESENTATION_V1: "AUTHORIZED_PRESENTATION_V1";
+    }>;
+    validationStatus: z.ZodEnum<{
+        NOT_VERIFIED: "NOT_VERIFIED";
+        RUNTIME_CONFIGURED: "RUNTIME_CONFIGURED";
+    }>;
+    externalReachability: z.ZodLiteral<"NOT_VERIFIED">;
+    endpoint: z.ZodNullable<z.ZodString>;
+    mediaEndpoint: z.ZodNullable<z.ZodString>;
+    protectedResourceMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationServerMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationMode: z.ZodLiteral<"OAUTH_2_1_AUTHORIZATION_CODE_PKCE_S256_USER_DELEGATED">;
+    clientRegistration: z.ZodLiteral<"PRE_REGISTERED">;
+    clientId: z.ZodNull;
+    authorizationMapping: z.ZodObject<{
+        oauthResourceParameter: z.ZodLiteral<"resource">;
+        externalTenantParameter: z.ZodLiteral<"external_tenant_id">;
+        projectRefParameter: z.ZodLiteral<"project_ref">;
+        externalSystemSource: z.ZodLiteral<"client_id">;
+        grantBinding: z.ZodLiteral<"RESOURCE_EXTERNAL_TENANT_PROJECT_REF_SCOPES">;
+    }, z.core.$strict>;
+    defaultProtocolVersion: z.ZodLiteral<"2026-07-28">;
+    evidenceFileEndpoint: z.ZodNullable<z.ZodString>;
+    managementMode: z.ZodLiteral<"EXPLICIT_CLIENT_PROJECT_SCOPE">;
+    managementEnabled: z.ZodBoolean;
+    materialPageEndpoint: z.ZodString;
+    materialEndpoint: z.ZodString;
+    materialPresentationEndpoint: z.ZodString;
+    materialReadMode: z.ZodLiteral<"OAUTH_SCOPE_AND_CLIENT_PROJECT_BINDING">;
+    materialSearchMode: z.ZodLiteral<"INDEXED_DESCRIPTIVE_METADATA">;
+    materialSearchEndpoint: z.ZodString;
+    materialRoutePageEndpoint: z.ZodString;
+    materialPartitionsEndpoint: z.ZodString;
+    materialPartitionPageEndpoint: z.ZodString;
+    schemaVersion: z.ZodLiteral<11>;
+    materialOutboxWindowEndpoint: z.ZodString;
+    tools: z.ZodArray<z.ZodObject<{
+        requiredScope: z.ZodEnum<{
+            "knowledge.compose": "knowledge.compose";
+            "knowledge.review": "knowledge.review";
+            "knowledge.material.route": "knowledge.material.route";
+            "knowledge.read": "knowledge.read";
+            "knowledge.approve": "knowledge.approve";
+            "knowledge.material.read": "knowledge.material.read";
+            "knowledge.search": "knowledge.search";
+            "knowledge.currentness": "knowledge.currentness";
+        }>;
+        inputSchema: z.ZodJSONSchema;
+        outputSchema: z.ZodJSONSchema;
+        name: z.ZodUnion<[z.ZodEnum<{
+            knowledge_search: "knowledge_search";
+            knowledge_read: "knowledge_read";
+            knowledge_currentness: "knowledge_currentness";
+            knowledge_reference_lookup: "knowledge_reference_lookup";
+            knowledge_list_evidence: "knowledge_list_evidence";
+            knowledge_compose: "knowledge_compose";
+            knowledge_submit_review: "knowledge_submit_review";
+            knowledge_review: "knowledge_review";
+            knowledge_finalize_review: "knowledge_finalize_review";
+            knowledge_material_list: "knowledge_material_list";
+            knowledge_material_describe: "knowledge_material_describe";
+            knowledge_material_read: "knowledge_material_read";
+            knowledge_material_changes: "knowledge_material_changes";
+            knowledge_material_route: "knowledge_material_route";
+            knowledge_material_search: "knowledge_material_search";
+            knowledge_material_partitions: "knowledge_material_partitions";
+            knowledge_material_partition_page: "knowledge_material_partition_page";
+            knowledge_material_route_page: "knowledge_material_route_page";
+        }>, z.ZodLiteral<"knowledge_material_window">]>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type KnowledgeMcpProviderContractV11 = z.infer<typeof knowledgeMcpProviderContractV11Schema>;
+/** v12 exposes representation capabilities independently of raw authorization and search coverage. */
+export declare const knowledgeMcpProviderContractV12Schema: z.ZodObject<{
+    scopes: z.ZodArray<z.ZodEnum<{
+        "knowledge.compose": "knowledge.compose";
+        "knowledge.review": "knowledge.review";
+        "knowledge.material.route": "knowledge.material.route";
+        "knowledge.read": "knowledge.read";
+        "knowledge.approve": "knowledge.approve";
+        "knowledge.material.read": "knowledge.material.read";
+        "knowledge.search": "knowledge.search";
+        "knowledge.currentness": "knowledge.currentness";
+    }>>;
+    resource: z.ZodNullable<z.ZodString>;
+    authorizationEndpoint: z.ZodNullable<z.ZodString>;
+    tokenEndpoint: z.ZodNullable<z.ZodString>;
+    revocationEndpoint: z.ZodNullable<z.ZodString>;
+    contentEndpoint: z.ZodNullable<z.ZodString>;
+    provider: z.ZodLiteral<"knowledge-v2">;
+    protocols: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        version: z.ZodLiteral<"2026-07-28">;
+        lifecycle: z.ZodLiteral<"STATELESS_DISCOVERY">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>, z.ZodObject<{
+        version: z.ZodLiteral<"2025-06-18">;
+        lifecycle: z.ZodLiteral<"INITIALIZE">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>], "version">>;
+    revision: z.ZodString;
+    searchCoverage: z.ZodEnum<{
+        AUTHORIZED_METADATA_V1: "AUTHORIZED_METADATA_V1";
+        AUTHORIZED_PRESENTATION_V1: "AUTHORIZED_PRESENTATION_V1";
+    }>;
+    validationStatus: z.ZodEnum<{
+        NOT_VERIFIED: "NOT_VERIFIED";
+        RUNTIME_CONFIGURED: "RUNTIME_CONFIGURED";
+    }>;
+    externalReachability: z.ZodLiteral<"NOT_VERIFIED">;
+    endpoint: z.ZodNullable<z.ZodString>;
+    mediaEndpoint: z.ZodNullable<z.ZodString>;
+    protectedResourceMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationServerMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationMode: z.ZodLiteral<"OAUTH_2_1_AUTHORIZATION_CODE_PKCE_S256_USER_DELEGATED">;
+    clientRegistration: z.ZodLiteral<"PRE_REGISTERED">;
+    clientId: z.ZodNull;
+    authorizationMapping: z.ZodObject<{
+        oauthResourceParameter: z.ZodLiteral<"resource">;
+        externalTenantParameter: z.ZodLiteral<"external_tenant_id">;
+        projectRefParameter: z.ZodLiteral<"project_ref">;
+        externalSystemSource: z.ZodLiteral<"client_id">;
+        grantBinding: z.ZodLiteral<"RESOURCE_EXTERNAL_TENANT_PROJECT_REF_SCOPES">;
+    }, z.core.$strict>;
+    defaultProtocolVersion: z.ZodLiteral<"2026-07-28">;
+    evidenceFileEndpoint: z.ZodNullable<z.ZodString>;
+    managementMode: z.ZodLiteral<"EXPLICIT_CLIENT_PROJECT_SCOPE">;
+    managementEnabled: z.ZodBoolean;
+    materialPageEndpoint: z.ZodString;
+    materialEndpoint: z.ZodString;
+    materialPresentationEndpoint: z.ZodString;
+    materialReadMode: z.ZodLiteral<"OAUTH_SCOPE_AND_CLIENT_PROJECT_BINDING">;
+    materialSearchMode: z.ZodLiteral<"INDEXED_DESCRIPTIVE_METADATA">;
+    materialSearchEndpoint: z.ZodString;
+    materialRoutePageEndpoint: z.ZodString;
+    materialPartitionsEndpoint: z.ZodString;
+    materialPartitionPageEndpoint: z.ZodString;
+    materialOutboxWindowEndpoint: z.ZodString;
+    schemaVersion: z.ZodLiteral<12>;
+    materialCapabilitySchemaVersion: z.ZodLiteral<2>;
+    materialCapabilitiesEndpoint: z.ZodString;
+    materialCapabilityPageEndpoint: z.ZodString;
+    materialMediaPageEndpoint: z.ZodString;
+    materialIndexStatusEndpoint: z.ZodString;
+    tools: z.ZodArray<z.ZodObject<{
+        requiredScope: z.ZodEnum<{
+            "knowledge.compose": "knowledge.compose";
+            "knowledge.review": "knowledge.review";
+            "knowledge.material.route": "knowledge.material.route";
+            "knowledge.read": "knowledge.read";
+            "knowledge.approve": "knowledge.approve";
+            "knowledge.material.read": "knowledge.material.read";
+            "knowledge.search": "knowledge.search";
+            "knowledge.currentness": "knowledge.currentness";
+        }>;
+        inputSchema: z.ZodJSONSchema;
+        outputSchema: z.ZodJSONSchema;
+        name: z.ZodUnion<[z.ZodUnion<[z.ZodEnum<{
+            knowledge_search: "knowledge_search";
+            knowledge_read: "knowledge_read";
+            knowledge_currentness: "knowledge_currentness";
+            knowledge_reference_lookup: "knowledge_reference_lookup";
+            knowledge_list_evidence: "knowledge_list_evidence";
+            knowledge_compose: "knowledge_compose";
+            knowledge_submit_review: "knowledge_submit_review";
+            knowledge_review: "knowledge_review";
+            knowledge_finalize_review: "knowledge_finalize_review";
+            knowledge_material_list: "knowledge_material_list";
+            knowledge_material_describe: "knowledge_material_describe";
+            knowledge_material_read: "knowledge_material_read";
+            knowledge_material_changes: "knowledge_material_changes";
+            knowledge_material_route: "knowledge_material_route";
+            knowledge_material_search: "knowledge_material_search";
+            knowledge_material_partitions: "knowledge_material_partitions";
+            knowledge_material_partition_page: "knowledge_material_partition_page";
+            knowledge_material_route_page: "knowledge_material_route_page";
+        }>, z.ZodLiteral<"knowledge_material_window">]>, z.ZodEnum<{
+            knowledge_material_capabilities: "knowledge_material_capabilities";
+            knowledge_material_media: "knowledge_material_media";
+            knowledge_material_index_status: "knowledge_material_index_status";
+        }>]>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type KnowledgeMcpProviderContractV12 = z.infer<typeof knowledgeMcpProviderContractV12Schema>;
+/** v13 adds explicit material production; older versions keep their scope and tool enums. */
+export declare const knowledgeMcpProviderContractV13Schema: z.ZodObject<{
+    resource: z.ZodNullable<z.ZodString>;
+    authorizationEndpoint: z.ZodNullable<z.ZodString>;
+    tokenEndpoint: z.ZodNullable<z.ZodString>;
+    revocationEndpoint: z.ZodNullable<z.ZodString>;
+    contentEndpoint: z.ZodNullable<z.ZodString>;
+    provider: z.ZodLiteral<"knowledge-v2">;
+    protocols: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        version: z.ZodLiteral<"2026-07-28">;
+        lifecycle: z.ZodLiteral<"STATELESS_DISCOVERY">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>, z.ZodObject<{
+        version: z.ZodLiteral<"2025-06-18">;
+        lifecycle: z.ZodLiteral<"INITIALIZE">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>], "version">>;
+    revision: z.ZodString;
+    searchCoverage: z.ZodEnum<{
+        AUTHORIZED_METADATA_V1: "AUTHORIZED_METADATA_V1";
+        AUTHORIZED_PRESENTATION_V1: "AUTHORIZED_PRESENTATION_V1";
+    }>;
+    validationStatus: z.ZodEnum<{
+        NOT_VERIFIED: "NOT_VERIFIED";
+        RUNTIME_CONFIGURED: "RUNTIME_CONFIGURED";
+    }>;
+    externalReachability: z.ZodLiteral<"NOT_VERIFIED">;
+    endpoint: z.ZodNullable<z.ZodString>;
+    mediaEndpoint: z.ZodNullable<z.ZodString>;
+    protectedResourceMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationServerMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationMode: z.ZodLiteral<"OAUTH_2_1_AUTHORIZATION_CODE_PKCE_S256_USER_DELEGATED">;
+    clientRegistration: z.ZodLiteral<"PRE_REGISTERED">;
+    clientId: z.ZodNull;
+    authorizationMapping: z.ZodObject<{
+        oauthResourceParameter: z.ZodLiteral<"resource">;
+        externalTenantParameter: z.ZodLiteral<"external_tenant_id">;
+        projectRefParameter: z.ZodLiteral<"project_ref">;
+        externalSystemSource: z.ZodLiteral<"client_id">;
+        grantBinding: z.ZodLiteral<"RESOURCE_EXTERNAL_TENANT_PROJECT_REF_SCOPES">;
+    }, z.core.$strict>;
+    defaultProtocolVersion: z.ZodLiteral<"2026-07-28">;
+    evidenceFileEndpoint: z.ZodNullable<z.ZodString>;
+    managementMode: z.ZodLiteral<"EXPLICIT_CLIENT_PROJECT_SCOPE">;
+    managementEnabled: z.ZodBoolean;
+    materialPageEndpoint: z.ZodString;
+    materialEndpoint: z.ZodString;
+    materialPresentationEndpoint: z.ZodString;
+    materialReadMode: z.ZodLiteral<"OAUTH_SCOPE_AND_CLIENT_PROJECT_BINDING">;
+    materialSearchMode: z.ZodLiteral<"INDEXED_DESCRIPTIVE_METADATA">;
+    materialSearchEndpoint: z.ZodString;
+    materialRoutePageEndpoint: z.ZodString;
+    materialPartitionsEndpoint: z.ZodString;
+    materialPartitionPageEndpoint: z.ZodString;
+    materialOutboxWindowEndpoint: z.ZodString;
+    materialCapabilitySchemaVersion: z.ZodLiteral<2>;
+    materialCapabilitiesEndpoint: z.ZodString;
+    materialCapabilityPageEndpoint: z.ZodString;
+    materialMediaPageEndpoint: z.ZodString;
+    materialIndexStatusEndpoint: z.ZodString;
+    schemaVersion: z.ZodLiteral<13>;
+    scopes: z.ZodArray<z.ZodUnion<[z.ZodEnum<{
+        "knowledge.compose": "knowledge.compose";
+        "knowledge.review": "knowledge.review";
+        "knowledge.material.route": "knowledge.material.route";
+        "knowledge.read": "knowledge.read";
+        "knowledge.approve": "knowledge.approve";
+        "knowledge.material.read": "knowledge.material.read";
+        "knowledge.search": "knowledge.search";
+        "knowledge.currentness": "knowledge.currentness";
+    }>, z.ZodLiteral<"knowledge.material.write">]>>;
+    tools: z.ZodArray<z.ZodObject<{
+        inputSchema: z.ZodJSONSchema;
+        outputSchema: z.ZodJSONSchema;
+        name: z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodEnum<{
+            knowledge_search: "knowledge_search";
+            knowledge_read: "knowledge_read";
+            knowledge_currentness: "knowledge_currentness";
+            knowledge_reference_lookup: "knowledge_reference_lookup";
+            knowledge_list_evidence: "knowledge_list_evidence";
+            knowledge_compose: "knowledge_compose";
+            knowledge_submit_review: "knowledge_submit_review";
+            knowledge_review: "knowledge_review";
+            knowledge_finalize_review: "knowledge_finalize_review";
+            knowledge_material_list: "knowledge_material_list";
+            knowledge_material_describe: "knowledge_material_describe";
+            knowledge_material_read: "knowledge_material_read";
+            knowledge_material_changes: "knowledge_material_changes";
+            knowledge_material_route: "knowledge_material_route";
+            knowledge_material_search: "knowledge_material_search";
+            knowledge_material_partitions: "knowledge_material_partitions";
+            knowledge_material_partition_page: "knowledge_material_partition_page";
+            knowledge_material_route_page: "knowledge_material_route_page";
+        }>, z.ZodLiteral<"knowledge_material_window">]>, z.ZodEnum<{
+            knowledge_material_capabilities: "knowledge_material_capabilities";
+            knowledge_material_media: "knowledge_material_media";
+            knowledge_material_index_status: "knowledge_material_index_status";
+        }>]>, z.ZodLiteral<"knowledge_material_register">]>;
+        requiredScope: z.ZodUnion<[z.ZodEnum<{
+            "knowledge.compose": "knowledge.compose";
+            "knowledge.review": "knowledge.review";
+            "knowledge.material.route": "knowledge.material.route";
+            "knowledge.read": "knowledge.read";
+            "knowledge.approve": "knowledge.approve";
+            "knowledge.material.read": "knowledge.material.read";
+            "knowledge.search": "knowledge.search";
+            "knowledge.currentness": "knowledge.currentness";
+        }>, z.ZodLiteral<"knowledge.material.write">]>;
+    }, z.core.$strict>>;
+    materialRegistration: z.ZodObject<{
+        maxInlineBytes: z.ZodLiteral<65536>;
+        retry: z.ZodLiteral<"EXACT_IMMUTABLE_REF">;
+        phases: z.ZodTuple<[z.ZodLiteral<"PERSISTED">, z.ZodLiteral<"CATALOG_PROJECTED">, z.ZodLiteral<"REGISTERED">], null>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type KnowledgeMcpProviderContractV13 = z.infer<typeof knowledgeMcpProviderContractV13Schema>;
+/** v15 才扩展 Agent 治理工具和 scope；v1–v14 的严格枚举保持原样。 */
+export declare const knowledgeMcpProviderContractV15Schema: z.ZodObject<{
+    resource: z.ZodNullable<z.ZodString>;
+    authorizationEndpoint: z.ZodNullable<z.ZodString>;
+    tokenEndpoint: z.ZodNullable<z.ZodString>;
+    revocationEndpoint: z.ZodNullable<z.ZodString>;
+    contentEndpoint: z.ZodNullable<z.ZodString>;
+    provider: z.ZodLiteral<"knowledge-v2">;
+    protocols: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        version: z.ZodLiteral<"2026-07-28">;
+        lifecycle: z.ZodLiteral<"STATELESS_DISCOVERY">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>, z.ZodObject<{
+        version: z.ZodLiteral<"2025-06-18">;
+        lifecycle: z.ZodLiteral<"INITIALIZE">;
+        transport: z.ZodLiteral<"STREAMABLE_HTTP">;
+    }, z.core.$strict>], "version">>;
+    revision: z.ZodString;
+    searchCoverage: z.ZodEnum<{
+        AUTHORIZED_METADATA_V1: "AUTHORIZED_METADATA_V1";
+        AUTHORIZED_PRESENTATION_V1: "AUTHORIZED_PRESENTATION_V1";
+    }>;
+    validationStatus: z.ZodEnum<{
+        NOT_VERIFIED: "NOT_VERIFIED";
+        RUNTIME_CONFIGURED: "RUNTIME_CONFIGURED";
+    }>;
+    externalReachability: z.ZodLiteral<"NOT_VERIFIED">;
+    endpoint: z.ZodNullable<z.ZodString>;
+    mediaEndpoint: z.ZodNullable<z.ZodString>;
+    protectedResourceMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationServerMetadataUrl: z.ZodNullable<z.ZodString>;
+    authorizationMode: z.ZodLiteral<"OAUTH_2_1_AUTHORIZATION_CODE_PKCE_S256_USER_DELEGATED">;
+    clientRegistration: z.ZodLiteral<"PRE_REGISTERED">;
+    clientId: z.ZodNull;
+    authorizationMapping: z.ZodObject<{
+        oauthResourceParameter: z.ZodLiteral<"resource">;
+        externalTenantParameter: z.ZodLiteral<"external_tenant_id">;
+        projectRefParameter: z.ZodLiteral<"project_ref">;
+        externalSystemSource: z.ZodLiteral<"client_id">;
+        grantBinding: z.ZodLiteral<"RESOURCE_EXTERNAL_TENANT_PROJECT_REF_SCOPES">;
+    }, z.core.$strict>;
+    defaultProtocolVersion: z.ZodLiteral<"2026-07-28">;
+    evidenceFileEndpoint: z.ZodNullable<z.ZodString>;
+    managementMode: z.ZodLiteral<"EXPLICIT_CLIENT_PROJECT_SCOPE">;
+    managementEnabled: z.ZodBoolean;
+    materialPageEndpoint: z.ZodString;
+    materialEndpoint: z.ZodString;
+    materialPresentationEndpoint: z.ZodString;
+    materialReadMode: z.ZodLiteral<"OAUTH_SCOPE_AND_CLIENT_PROJECT_BINDING">;
+    materialSearchMode: z.ZodLiteral<"INDEXED_DESCRIPTIVE_METADATA">;
+    materialSearchEndpoint: z.ZodString;
+    materialRoutePageEndpoint: z.ZodString;
+    materialPartitionsEndpoint: z.ZodString;
+    materialPartitionPageEndpoint: z.ZodString;
+    materialOutboxWindowEndpoint: z.ZodString;
+    materialCapabilitySchemaVersion: z.ZodLiteral<2>;
+    materialCapabilitiesEndpoint: z.ZodString;
+    materialCapabilityPageEndpoint: z.ZodString;
+    materialMediaPageEndpoint: z.ZodString;
+    materialIndexStatusEndpoint: z.ZodString;
+    materialRegistration: z.ZodObject<{
+        maxInlineBytes: z.ZodLiteral<65536>;
+        retry: z.ZodLiteral<"EXACT_IMMUTABLE_REF">;
+        phases: z.ZodTuple<[z.ZodLiteral<"PERSISTED">, z.ZodLiteral<"CATALOG_PROJECTED">, z.ZodLiteral<"REGISTERED">], null>;
+    }, z.core.$strict>;
+    schemaVersion: z.ZodLiteral<15>;
+    workflowSchemaVersion: z.ZodLiteral<1>;
+    managementEndpoint: z.ZodString;
+    scopes: z.ZodArray<z.ZodUnion<[z.ZodUnion<[z.ZodEnum<{
+        "knowledge.compose": "knowledge.compose";
+        "knowledge.review": "knowledge.review";
+        "knowledge.material.route": "knowledge.material.route";
+        "knowledge.read": "knowledge.read";
+        "knowledge.approve": "knowledge.approve";
+        "knowledge.material.read": "knowledge.material.read";
+        "knowledge.search": "knowledge.search";
+        "knowledge.currentness": "knowledge.currentness";
+    }>, z.ZodLiteral<"knowledge.material.write">]>, z.ZodLiteral<"knowledge.workflow.read">]>>;
+    tools: z.ZodArray<z.ZodObject<{
+        inputSchema: z.ZodJSONSchema;
+        outputSchema: z.ZodJSONSchema;
+        name: z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodUnion<[z.ZodEnum<{
+            knowledge_search: "knowledge_search";
+            knowledge_read: "knowledge_read";
+            knowledge_currentness: "knowledge_currentness";
+            knowledge_reference_lookup: "knowledge_reference_lookup";
+            knowledge_list_evidence: "knowledge_list_evidence";
+            knowledge_compose: "knowledge_compose";
+            knowledge_submit_review: "knowledge_submit_review";
+            knowledge_review: "knowledge_review";
+            knowledge_finalize_review: "knowledge_finalize_review";
+            knowledge_material_list: "knowledge_material_list";
+            knowledge_material_describe: "knowledge_material_describe";
+            knowledge_material_read: "knowledge_material_read";
+            knowledge_material_changes: "knowledge_material_changes";
+            knowledge_material_route: "knowledge_material_route";
+            knowledge_material_search: "knowledge_material_search";
+            knowledge_material_partitions: "knowledge_material_partitions";
+            knowledge_material_partition_page: "knowledge_material_partition_page";
+            knowledge_material_route_page: "knowledge_material_route_page";
+        }>, z.ZodLiteral<"knowledge_material_window">]>, z.ZodEnum<{
+            knowledge_material_capabilities: "knowledge_material_capabilities";
+            knowledge_material_media: "knowledge_material_media";
+            knowledge_material_index_status: "knowledge_material_index_status";
+        }>]>, z.ZodLiteral<"knowledge_material_register">]>, z.ZodEnum<{
+            knowledge_workflow_guide: "knowledge_workflow_guide";
+            knowledge_workflow_plan: "knowledge_workflow_plan";
+            knowledge_workflow_advance: "knowledge_workflow_advance";
+            knowledge_agent_submit: "knowledge_agent_submit";
+        }>]>;
+        requiredScope: z.ZodUnion<[z.ZodUnion<[z.ZodEnum<{
+            "knowledge.compose": "knowledge.compose";
+            "knowledge.review": "knowledge.review";
+            "knowledge.material.route": "knowledge.material.route";
+            "knowledge.read": "knowledge.read";
+            "knowledge.approve": "knowledge.approve";
+            "knowledge.material.read": "knowledge.material.read";
+            "knowledge.search": "knowledge.search";
+            "knowledge.currentness": "knowledge.currentness";
+        }>, z.ZodLiteral<"knowledge.material.write">]>, z.ZodLiteral<"knowledge.workflow.read">]>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type KnowledgeMcpProviderContractV15 = z.infer<typeof knowledgeMcpProviderContractV15Schema>;