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

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

@@ -0,0 +1,738 @@
+/** Provider 16 的格式 2 资源读取合同；旧 Project/Tenant wire 保持其严格 schema。 */
+import { z } from 'zod';
+export declare const resourceOriginSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"TENANT_AUTHOR">;
+    actor: z.ZodObject<{
+        tenantId: z.ZodString;
+        userId: z.ZodString;
+        agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    submittedAt: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"TENANT_SOURCE">;
+    sourceId: z.ZodString;
+    sourceRef: z.ZodString;
+    sourceRevisionRef: z.ZodString;
+    collector: z.ZodObject<{
+        collectorId: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strict>;
+    runtimeNodeId: z.ZodString;
+    observedAt: z.ZodISODateTime;
+}, z.core.$strict>], "type">, z.ZodObject<{
+    type: z.ZodLiteral<"LEGACY_PROJECT">;
+    projectKey: z.ZodString;
+    projectRef: z.ZodString;
+}, z.core.$strict>]>;
+export declare const resourceDirectoryItemSchema: z.ZodObject<{
+    ref: z.ZodString;
+    ownerTenantId: z.ZodString;
+    resourceType: z.ZodString;
+    origin: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"TENANT_AUTHOR">;
+        actor: z.ZodObject<{
+            tenantId: z.ZodString;
+            userId: z.ZodString;
+            agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>;
+        submittedAt: z.ZodISODateTime;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"TENANT_SOURCE">;
+        sourceId: z.ZodString;
+        sourceRef: z.ZodString;
+        sourceRevisionRef: z.ZodString;
+        collector: z.ZodObject<{
+            collectorId: z.ZodString;
+            version: z.ZodString;
+        }, z.core.$strict>;
+        runtimeNodeId: z.ZodString;
+        observedAt: z.ZodISODateTime;
+    }, z.core.$strict>], "type">, z.ZodObject<{
+        type: z.ZodLiteral<"LEGACY_PROJECT">;
+        projectKey: z.ZodString;
+        projectRef: z.ZodString;
+    }, z.core.$strict>]>;
+    identityHash: z.ZodString;
+    identityKind: z.ZodEnum<{
+        CAS_BYTES: "CAS_BYTES";
+        REFERENCE_RECORD_DIGEST: "REFERENCE_RECORD_DIGEST";
+    }>;
+    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;
+    title: z.ZodString;
+    summary: 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>;
+export type ResourceDirectoryItem = z.infer<typeof resourceDirectoryItemSchema>;
+export declare const resourceToolSchemas: {
+    readonly knowledge_resource_list: z.ZodObject<{
+        resourceType: z.ZodOptional<z.ZodString>;
+        sourceProjectKey: z.ZodOptional<z.ZodString>;
+        refPrefix: z.ZodOptional<z.ZodString>;
+        after: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_resource_describe: z.ZodObject<{
+        ref: z.ZodString;
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_resource_read: z.ZodObject<{
+        ref: z.ZodString;
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_resource_capabilities: z.ZodObject<{
+        ref: z.ZodString;
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_resource_search: z.ZodObject<{
+        query: z.ZodString;
+        resourceType: z.ZodOptional<z.ZodString>;
+        sourceProjectKey: z.ZodOptional<z.ZodString>;
+        refPrefix: z.ZodOptional<z.ZodString>;
+        after: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_resource_window: z.ZodObject<{
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_resource_changes: z.ZodObject<{
+        after: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_resource_counts: z.ZodObject<{
+        after: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_resource_index_status: z.ZodObject<{
+        projectRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_resource_media: z.ZodObject<{
+        ref: z.ZodString;
+        projectRef: z.ZodOptional<z.ZodString>;
+        afterOrdinal: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        documentRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+};
+export type ResourceToolName = keyof typeof resourceToolSchemas;
+export declare const resourceDataSchemas: {
+    readonly knowledge_resource_list: z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            ownerTenantId: z.ZodString;
+            resourceType: z.ZodString;
+            origin: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"TENANT_AUTHOR">;
+                actor: z.ZodObject<{
+                    tenantId: z.ZodString;
+                    userId: z.ZodString;
+                    agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strict>;
+                submittedAt: z.ZodISODateTime;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"TENANT_SOURCE">;
+                sourceId: z.ZodString;
+                sourceRef: z.ZodString;
+                sourceRevisionRef: z.ZodString;
+                collector: z.ZodObject<{
+                    collectorId: z.ZodString;
+                    version: z.ZodString;
+                }, z.core.$strict>;
+                runtimeNodeId: z.ZodString;
+                observedAt: z.ZodISODateTime;
+            }, z.core.$strict>], "type">, z.ZodObject<{
+                type: z.ZodLiteral<"LEGACY_PROJECT">;
+                projectKey: z.ZodString;
+                projectRef: z.ZodString;
+            }, z.core.$strict>]>;
+            identityHash: z.ZodString;
+            identityKind: z.ZodEnum<{
+                CAS_BYTES: "CAS_BYTES";
+                REFERENCE_RECORD_DIGEST: "REFERENCE_RECORD_DIGEST";
+            }>;
+            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;
+            title: z.ZodString;
+            summary: z.ZodString;
+            decision: z.ZodObject<{
+                schemaVersion: z.ZodLiteral<1>;
+                action: z.ZodEnum<{
+                    ALLOW: "ALLOW";
+                    DENY: "DENY";
+                }>;
+                reasonCodes: z.ZodArray<z.ZodEnum<{
+                    UNAVAILABLE: "UNAVAILABLE";
+                    NOT_FOUND: "NOT_FOUND";
+                    CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+                    INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                    UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+                }>>;
+                assessedAt: z.ZodISODateTime;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        nextAfter: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_resource_describe: z.ZodObject<{
+        item: z.ZodNullable<z.ZodObject<{
+            ref: z.ZodString;
+            ownerTenantId: z.ZodString;
+            resourceType: z.ZodString;
+            origin: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"TENANT_AUTHOR">;
+                actor: z.ZodObject<{
+                    tenantId: z.ZodString;
+                    userId: z.ZodString;
+                    agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strict>;
+                submittedAt: z.ZodISODateTime;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"TENANT_SOURCE">;
+                sourceId: z.ZodString;
+                sourceRef: z.ZodString;
+                sourceRevisionRef: z.ZodString;
+                collector: z.ZodObject<{
+                    collectorId: z.ZodString;
+                    version: z.ZodString;
+                }, z.core.$strict>;
+                runtimeNodeId: z.ZodString;
+                observedAt: z.ZodISODateTime;
+            }, z.core.$strict>], "type">, z.ZodObject<{
+                type: z.ZodLiteral<"LEGACY_PROJECT">;
+                projectKey: z.ZodString;
+                projectRef: z.ZodString;
+            }, z.core.$strict>]>;
+            identityHash: z.ZodString;
+            identityKind: z.ZodEnum<{
+                CAS_BYTES: "CAS_BYTES";
+                REFERENCE_RECORD_DIGEST: "REFERENCE_RECORD_DIGEST";
+            }>;
+            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;
+            title: z.ZodString;
+            summary: z.ZodString;
+            decision: z.ZodObject<{
+                schemaVersion: z.ZodLiteral<1>;
+                action: z.ZodEnum<{
+                    ALLOW: "ALLOW";
+                    DENY: "DENY";
+                }>;
+                reasonCodes: z.ZodArray<z.ZodEnum<{
+                    UNAVAILABLE: "UNAVAILABLE";
+                    NOT_FOUND: "NOT_FOUND";
+                    CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+                    INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                    UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+                }>>;
+                assessedAt: z.ZodISODateTime;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        byteLength: z.ZodNullable<z.ZodNumber>;
+        downloadUrl: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_resource_read: z.ZodObject<{
+        item: z.ZodNullable<z.ZodObject<{
+            ref: z.ZodString;
+            ownerTenantId: z.ZodString;
+            resourceType: z.ZodString;
+            origin: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"TENANT_AUTHOR">;
+                actor: z.ZodObject<{
+                    tenantId: z.ZodString;
+                    userId: z.ZodString;
+                    agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strict>;
+                submittedAt: z.ZodISODateTime;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"TENANT_SOURCE">;
+                sourceId: z.ZodString;
+                sourceRef: z.ZodString;
+                sourceRevisionRef: z.ZodString;
+                collector: z.ZodObject<{
+                    collectorId: z.ZodString;
+                    version: z.ZodString;
+                }, z.core.$strict>;
+                runtimeNodeId: z.ZodString;
+                observedAt: z.ZodISODateTime;
+            }, z.core.$strict>], "type">, z.ZodObject<{
+                type: z.ZodLiteral<"LEGACY_PROJECT">;
+                projectKey: z.ZodString;
+                projectRef: z.ZodString;
+            }, z.core.$strict>]>;
+            identityHash: z.ZodString;
+            identityKind: z.ZodEnum<{
+                CAS_BYTES: "CAS_BYTES";
+                REFERENCE_RECORD_DIGEST: "REFERENCE_RECORD_DIGEST";
+            }>;
+            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;
+            title: z.ZodString;
+            summary: z.ZodString;
+            decision: z.ZodObject<{
+                schemaVersion: z.ZodLiteral<1>;
+                action: z.ZodEnum<{
+                    ALLOW: "ALLOW";
+                    DENY: "DENY";
+                }>;
+                reasonCodes: z.ZodArray<z.ZodEnum<{
+                    UNAVAILABLE: "UNAVAILABLE";
+                    NOT_FOUND: "NOT_FOUND";
+                    CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+                    INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                    UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+                }>>;
+                assessedAt: z.ZodISODateTime;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        byteLength: z.ZodNullable<z.ZodNumber>;
+        decision: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            action: z.ZodEnum<{
+                ALLOW: "ALLOW";
+                DENY: "DENY";
+            }>;
+            reasonCodes: z.ZodArray<z.ZodEnum<{
+                UNAVAILABLE: "UNAVAILABLE";
+                NOT_FOUND: "NOT_FOUND";
+                CONTENT_ACCESS_DENIED: "CONTENT_ACCESS_DENIED";
+                INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                UNSUPPORTED_RESOURCE: "UNSUPPORTED_RESOURCE";
+            }>>;
+            assessedAt: z.ZodISODateTime;
+        }, z.core.$strict>;
+        descriptor: z.ZodNullable<z.ZodObject<{
+            contentHash: z.ZodString;
+            mediaType: z.ZodString;
+            byteLength: z.ZodNumber;
+        }, z.core.$strict>>;
+        delivery: z.ZodEnum<{
+            UNAVAILABLE: "UNAVAILABLE";
+            INLINE_BASE64: "INLINE_BASE64";
+            DOWNLOAD: "DOWNLOAD";
+        }>;
+        contentBase64: z.ZodNullable<z.ZodString>;
+        downloadUrl: z.ZodNullable<z.ZodString>;
+        verification: z.ZodEnum<{
+            VERIFIED: "VERIFIED";
+            NOT_VERIFIED: "NOT_VERIFIED";
+        }>;
+    }, z.core.$strict>;
+    readonly knowledge_resource_capabilities: z.ZodObject<{
+        item: z.ZodNullable<z.ZodObject<{
+            ref: z.ZodString;
+            ownerTenantId: z.ZodString;
+            resourceType: z.ZodString;
+            origin: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"TENANT_AUTHOR">;
+                actor: z.ZodObject<{
+                    tenantId: z.ZodString;
+                    userId: z.ZodString;
+                    agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strict>;
+                submittedAt: z.ZodISODateTime;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"TENANT_SOURCE">;
+                sourceId: z.ZodString;
+                sourceRef: z.ZodString;
+                sourceRevisionRef: z.ZodString;
+                collector: z.ZodObject<{
+                    collectorId: z.ZodString;
+                    version: z.ZodString;
+                }, z.core.$strict>;
+                runtimeNodeId: z.ZodString;
+                observedAt: z.ZodISODateTime;
+            }, z.core.$strict>], "type">, z.ZodObject<{
+                type: z.ZodLiteral<"LEGACY_PROJECT">;
+                projectKey: z.ZodString;
+                projectRef: z.ZodString;
+            }, z.core.$strict>]>;
+            identityHash: z.ZodString;
+            identityKind: z.ZodEnum<{
+                CAS_BYTES: "CAS_BYTES";
+                REFERENCE_RECORD_DIGEST: "REFERENCE_RECORD_DIGEST";
+            }>;
+            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;
+            title: z.ZodString;
+            summary: 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.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<{
+                POST: "POST";
+                GET: "GET";
+                HEAD: "HEAD";
+            }>>;
+            range: z.ZodEnum<{
+                NONE: "NONE";
+                SINGLE: "SINGLE";
+            }>;
+            verification: z.ZodLiteral<"ON_READ">;
+            verificationChunkBytes: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    readonly knowledge_resource_search: z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            ownerTenantId: z.ZodString;
+            resourceType: z.ZodString;
+            origin: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"TENANT_AUTHOR">;
+                actor: z.ZodObject<{
+                    tenantId: z.ZodString;
+                    userId: z.ZodString;
+                    agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strict>;
+                submittedAt: z.ZodISODateTime;
+            }, z.core.$strict>, z.ZodObject<{
+                type: z.ZodLiteral<"TENANT_SOURCE">;
+                sourceId: z.ZodString;
+                sourceRef: z.ZodString;
+                sourceRevisionRef: z.ZodString;
+                collector: z.ZodObject<{
+                    collectorId: z.ZodString;
+                    version: z.ZodString;
+                }, z.core.$strict>;
+                runtimeNodeId: z.ZodString;
+                observedAt: z.ZodISODateTime;
+            }, z.core.$strict>], "type">, z.ZodObject<{
+                type: z.ZodLiteral<"LEGACY_PROJECT">;
+                projectKey: z.ZodString;
+                projectRef: z.ZodString;
+            }, z.core.$strict>]>;
+            identityHash: z.ZodString;
+            identityKind: z.ZodEnum<{
+                CAS_BYTES: "CAS_BYTES";
+                REFERENCE_RECORD_DIGEST: "REFERENCE_RECORD_DIGEST";
+            }>;
+            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;
+            title: z.ZodString;
+            summary: 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>;
+        coverage: z.ZodLiteral<"INDEXED_DESCRIPTIONS_ONLY">;
+    }, z.core.$strict>;
+    readonly knowledge_resource_window: z.ZodObject<{
+        headSeq: z.ZodNumber;
+        retainedThroughSeq: z.ZodNumber;
+        headCursor: z.ZodString;
+        retentionCursor: z.ZodString;
+        epoch: z.ZodLiteral<"TENANT_RESOURCE_V1">;
+    }, z.core.$strict>;
+    readonly knowledge_resource_changes: z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            seq: z.ZodNumber;
+            eventType: z.ZodString;
+            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.ZodString>;
+    }, z.core.$strict>;
+    readonly knowledge_resource_counts: z.ZodObject<{
+        owned: z.ZodNumber;
+        granted: z.ZodNumber;
+        available: z.ZodNumber;
+        resourceTypes: z.ZodArray<z.ZodObject<{
+            resourceType: z.ZodString;
+            total: z.ZodNumber;
+        }, z.core.$strict>>;
+        nextAfter: z.ZodNullable<z.ZodString>;
+        coverage: z.ZodLiteral<"CURRENT_AUTHORIZED_DIRECTORY">;
+    }, z.core.$strict>;
+    readonly knowledge_resource_index_status: z.ZodObject<{
+        registered: z.ZodNumber;
+        indexed: z.ZodNumber;
+        unindexed: z.ZodNumber;
+        state: z.ZodEnum<{
+            PARTIAL_BACKFILL: "PARTIAL_BACKFILL";
+            SYNCED_AS_OF_LAST_OBSERVATION: "SYNCED_AS_OF_LAST_OBSERVATION";
+        }>;
+        canonicalInventory: z.ZodLiteral<"NOT_SCANNED">;
+        coverage: z.ZodLiteral<"CURRENT_AUTHORIZED_DIRECTORY">;
+    }, z.core.$strict>;
+    readonly knowledge_resource_media: z.ZodNullable<z.ZodObject<{
+        ref: z.ZodString;
+        sourceContentHash: z.ZodString;
+        documentRef: z.ZodNullable<z.ZodString>;
+        documentContentHash: z.ZodNullable<z.ZodString>;
+        state: z.ZodEnum<{
+            MISSING: "MISSING";
+            INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+            READY: "READY";
+            UNSUPPORTED: "UNSUPPORTED";
+            DENIED: "DENIED";
+        }>;
+        items: z.ZodArray<z.ZodObject<{
+            ordinal: z.ZodNumber;
+            kind: z.ZodEnum<{
+                IMAGE: "IMAGE";
+                AUDIO: "AUDIO";
+                VIDEO: "VIDEO";
+            }>;
+            sourceUrl: z.ZodString;
+            canonicalUrl: z.ZodNullable<z.ZodString>;
+            availability: z.ZodEnum<{
+                MIRRORED: "MIRRORED";
+                REMOTE_ONLY: "REMOTE_ONLY";
+                UNAVAILABLE: "UNAVAILABLE";
+            }>;
+            mediaRef: z.ZodNullable<z.ZodString>;
+            contentHash: z.ZodNullable<z.ZodString>;
+            mediaType: z.ZodNullable<z.ZodString>;
+            byteLength: z.ZodNullable<z.ZodNumber>;
+            state: z.ZodEnum<{
+                MISSING: "MISSING";
+                REMOTE_ONLY: "REMOTE_ONLY";
+                UNAVAILABLE: "UNAVAILABLE";
+                INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                READY: "READY";
+                DENIED: "DENIED";
+            }>;
+            representation: z.ZodNullable<z.ZodObject<{
+                state: z.ZodEnum<{
+                    MISSING: "MISSING";
+                    INTEGRITY_MISMATCH: "INTEGRITY_MISMATCH";
+                    READY: "READY";
+                    UNSUPPORTED: "UNSUPPORTED";
+                    DENIED: "DENIED";
+                }>;
+                format: z.ZodEnum<{
+                    BYTES: "BYTES";
+                    JSON: "JSON";
+                }>;
+                transfer: z.ZodEnum<{
+                    UNSUPPORTED: "UNSUPPORTED";
+                    VERIFIED_STREAM: "VERIFIED_STREAM";
+                    BUFFERED_JSON: "BUFFERED_JSON";
+                }>;
+                contentHash: z.ZodNullable<z.ZodString>;
+                mediaType: z.ZodString;
+                byteLength: z.ZodNullable<z.ZodNumber>;
+                methods: z.ZodArray<z.ZodEnum<{
+                    GET: "GET";
+                    HEAD: "HEAD";
+                }>>;
+                range: z.ZodEnum<{
+                    NONE: "NONE";
+                    SINGLE: "SINGLE";
+                }>;
+                verification: z.ZodLiteral<"ON_READ">;
+                verificationChunkBytes: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        nextAfterOrdinal: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+};
+export declare const resourceEnvelopeSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    context: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"TENANT">;
+        tenantId: z.ZodString;
+        tenantRef: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"PROJECT">;
+        tenantId: z.ZodString;
+        projectKey: z.ZodString;
+        projectRef: z.ZodString;
+    }, z.core.$strict>], "type">;
+    policy: z.ZodEnum<{
+        LEGACY_PROJECT: "LEGACY_PROJECT";
+        TENANT_NATIVE: "TENANT_NATIVE";
+        TENANT_PROJECT_SCOPE: "TENANT_PROJECT_SCOPE";
+    }>;
+    data: z.ZodUnknown;
+}, z.core.$strict>;
+export declare const resourceToolInputSchemas: Record<ResourceToolName, Record<string, unknown>>;
+export declare const resourceToolOutputSchemas: Record<ResourceToolName, Record<string, unknown>>;
+export declare const tenantResourceProviderSchema: z.ZodObject<{
+    provider: z.ZodLiteral<"knowledge-v2">;
+    codeRevision: z.ZodString;
+    context: z.ZodLiteral<"TENANT_DEFAULT_PROJECT_EXPLICIT">;
+    scope: z.ZodLiteral<"knowledge.material.read">;
+    mcpEndpoint: z.ZodString;
+    resource: z.ZodString;
+    issuer: z.ZodString;
+    tokenEndpoint: z.ZodString;
+    revocationEndpoint: z.ZodString;
+    protocols: z.ZodArray<z.ZodString>;
+    tenantReadEnabled: z.ZodBoolean;
+    projectScopeEnabled: z.ZodBoolean;
+    externalTenantParameter: z.ZodLiteral<"external_tenant_id">;
+    materialEndpoint: z.ZodString;
+    authorizationEndpoint: z.ZodString;
+    authorizationContextParameters: z.ZodTuple<[z.ZodLiteral<"tenant_ref">, z.ZodLiteral<"project_ref">], null>;
+    tools: z.ZodArray<z.ZodString>;
+    projectScopeManagement: z.ZodLiteral<"knowledge.material.scope">;
+    inlineMaxBytes: z.ZodLiteral<32768>;
+    rawUsagePolicy: z.ZodLiteral<"CONSUMER_DECIDES">;
+    referenceReadMaxBytes: z.ZodLiteral<16777216>;
+    schemaVersion: z.ZodLiteral<16>;
+    materialSchemaVersion: z.ZodLiteral<2>;
+    capabilities: z.ZodTuple<[z.ZodLiteral<"TENANT_RESOURCE_V1">, z.ZodLiteral<"TENANT_AUTHORITY_V1">], null>;
+    legacyProviderEndpoint: z.ZodString;
+}, z.core.$strict>;
+export declare const resourceHttpContractSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    context: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"TENANT">;
+        tenantId: z.ZodString;
+        tenantRef: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"PROJECT">;
+        tenantId: z.ZodString;
+        projectKey: z.ZodString;
+        projectRef: z.ZodString;
+    }, z.core.$strict>], "type">;
+    policy: z.ZodEnum<{
+        LEGACY_PROJECT: "LEGACY_PROJECT";
+        TENANT_NATIVE: "TENANT_NATIVE";
+        TENANT_PROJECT_SCOPE: "TENANT_PROJECT_SCOPE";
+    }>;
+    capabilities: z.ZodTuple<[z.ZodLiteral<"TENANT_RESOURCE_V1">, z.ZodLiteral<"TENANT_AUTHORITY_V1">], null>;
+    callEndpoint: z.ZodString;
+    fileEndpoint: z.ZodString;
+    tools: z.ZodArray<z.ZodString>;
+    inlineMaxBytes: z.ZodLiteral<32768>;
+    readBufferMaxBytes: z.ZodLiteral<16777216>;
+    fileMethods: z.ZodTuple<[z.ZodLiteral<"GET">, z.ZodLiteral<"HEAD">, z.ZodLiteral<"POST">], null>;
+    verificationChunkBytes: z.ZodLiteral<65536>;
+    requestMaxBytes: z.ZodLiteral<131072>;
+    resultMaxBytes: z.ZodLiteral<524288>;
+}, z.core.$strict>;