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

package/dist/types/contracts/tenant-web-content.d.ts

@@ -0,0 +1,383 @@
+/** S4 composes frozen S3 acquisition with a separately versioned derived plan. */
+import { z } from 'zod';
+import { type TenantWebDynamicHead } from './tenant-web-dynamic.js';
+export declare const tenantWebContentJobSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<4>;
+    contentPlan: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        compiler: z.ZodEnum<{
+            CALLER_PLAN_V1: "CALLER_PLAN_V1";
+            BOUNDED_LANGUAGE_V1: "BOUNDED_LANGUAGE_V1";
+        }>;
+        extractor: z.ZodObject<{
+            id: z.ZodLiteral<"native-knowledge.web-content">;
+            version: z.ZodLiteral<"1.0.0">;
+        }, z.core.$strict>;
+        body: z.ZodBoolean;
+        tables: z.ZodBoolean;
+        links: z.ZodBoolean;
+        recordSelector: z.ZodNullable<z.ZodString>;
+        fields: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            selector: z.ZodString;
+            value: z.ZodDefault<z.ZodEnum<{
+                TEXT: "TEXT";
+                JSON: "JSON";
+                ATTRIBUTE: "ATTRIBUTE";
+            }>>;
+            attribute: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+                datetime: "datetime";
+                value: "value";
+                title: "title";
+                href: "href";
+                alt: "alt";
+                content: "content";
+                src: "src";
+            }>>>;
+            type: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                object: "object";
+                array: "array";
+            }>;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        maxRecords: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>;
+    contentRevision: z.ZodString;
+    retainedFrom: z.ZodNullable<z.ZodString>;
+    intent: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<2>;
+        requestedSpec: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<2>;
+            render: z.ZodDefault<z.ZodObject<{
+                mode: z.ZodDefault<z.ZodEnum<{
+                    HTTP_ONLY: "HTTP_ONLY";
+                    AUTO: "AUTO";
+                    ALWAYS: "ALWAYS";
+                }>>;
+                requiredSelector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                minTextChars: z.ZodDefault<z.ZodNumber>;
+                resourceOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                interaction: z.ZodDefault<z.ZodObject<{
+                    kind: z.ZodEnum<{
+                        NONE: "NONE";
+                        NEXT_PAGE: "NEXT_PAGE";
+                        LOAD_MORE: "LOAD_MORE";
+                        SCROLL: "SCROLL";
+                    }>;
+                    selector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                    endSelector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                    maxSteps: z.ZodDefault<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            url: z.ZodString;
+            scope: z.ZodObject<{
+                mode: z.ZodEnum<{
+                    FEED: "FEED";
+                    SINGLE_PAGE: "SINGLE_PAGE";
+                    URL_LIST: "URL_LIST";
+                    SITE_SECTION: "SITE_SECTION";
+                    SITEMAP: "SITEMAP";
+                }>;
+                allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                includePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                excludePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                urls: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                followPagination: z.ZodDefault<z.ZodBoolean>;
+                followDetailLinks: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>;
+            requirements: z.ZodObject<{
+                instruction: z.ZodString;
+                fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodEnum<{
+                        string: "string";
+                        number: "number";
+                        boolean: "boolean";
+                        object: "object";
+                        array: "array";
+                    }>;
+                    required: z.ZodDefault<z.ZodBoolean>;
+                }, z.core.$strict>>>;
+                outputs: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    RAW: "RAW";
+                    DOCUMENT: "DOCUMENT";
+                    RECORDS: "RECORDS";
+                }>>>;
+                attachments: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    PDF: "PDF";
+                    IMAGE: "IMAGE";
+                    AUDIO: "AUDIO";
+                    VIDEO: "VIDEO";
+                    OTHER: "OTHER";
+                }>>>;
+            }, z.core.$strict>;
+            limits: z.ZodDefault<z.ZodObject<{
+                maxPages: z.ZodDefault<z.ZodNumber>;
+                maxDepth: z.ZodDefault<z.ZodNumber>;
+                maxResourceBytes: z.ZodDefault<z.ZodNumber>;
+                maxTotalBytes: z.ZodDefault<z.ZodNumber>;
+                maxRuntimeMs: z.ZodDefault<z.ZodNumber>;
+                maxInteractions: z.ZodDefault<z.ZodNumber>;
+                maxFiles: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strict>>;
+            refresh: z.ZodDefault<z.ZodObject<{
+                mode: z.ZodLiteral<"ONCE">;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        spec: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<2>;
+            render: z.ZodDefault<z.ZodObject<{
+                mode: z.ZodDefault<z.ZodEnum<{
+                    HTTP_ONLY: "HTTP_ONLY";
+                    AUTO: "AUTO";
+                    ALWAYS: "ALWAYS";
+                }>>;
+                requiredSelector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                minTextChars: z.ZodDefault<z.ZodNumber>;
+                resourceOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                interaction: z.ZodDefault<z.ZodObject<{
+                    kind: z.ZodEnum<{
+                        NONE: "NONE";
+                        NEXT_PAGE: "NEXT_PAGE";
+                        LOAD_MORE: "LOAD_MORE";
+                        SCROLL: "SCROLL";
+                    }>;
+                    selector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                    endSelector: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                    maxSteps: z.ZodDefault<z.ZodNumber>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            url: z.ZodString;
+            scope: z.ZodObject<{
+                mode: z.ZodEnum<{
+                    FEED: "FEED";
+                    SINGLE_PAGE: "SINGLE_PAGE";
+                    URL_LIST: "URL_LIST";
+                    SITE_SECTION: "SITE_SECTION";
+                    SITEMAP: "SITEMAP";
+                }>;
+                allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                includePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                excludePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                urls: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                followPagination: z.ZodDefault<z.ZodBoolean>;
+                followDetailLinks: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>;
+            requirements: z.ZodObject<{
+                instruction: z.ZodString;
+                fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodEnum<{
+                        string: "string";
+                        number: "number";
+                        boolean: "boolean";
+                        object: "object";
+                        array: "array";
+                    }>;
+                    required: z.ZodDefault<z.ZodBoolean>;
+                }, z.core.$strict>>>;
+                outputs: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    RAW: "RAW";
+                    DOCUMENT: "DOCUMENT";
+                    RECORDS: "RECORDS";
+                }>>>;
+                attachments: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    PDF: "PDF";
+                    IMAGE: "IMAGE";
+                    AUDIO: "AUDIO";
+                    VIDEO: "VIDEO";
+                    OTHER: "OTHER";
+                }>>>;
+            }, z.core.$strict>;
+            limits: z.ZodDefault<z.ZodObject<{
+                maxPages: z.ZodDefault<z.ZodNumber>;
+                maxDepth: z.ZodDefault<z.ZodNumber>;
+                maxResourceBytes: z.ZodDefault<z.ZodNumber>;
+                maxTotalBytes: z.ZodDefault<z.ZodNumber>;
+                maxRuntimeMs: z.ZodDefault<z.ZodNumber>;
+                maxInteractions: z.ZodDefault<z.ZodNumber>;
+                maxFiles: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strict>>;
+            refresh: z.ZodDefault<z.ZodObject<{
+                mode: z.ZodLiteral<"ONCE">;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        tenantId: z.ZodString;
+        requestId: z.ZodString;
+        jobRef: z.ZodString;
+        inputRevision: z.ZodString;
+        specRevision: z.ZodString;
+        actor: z.ZodObject<{
+            tenantId: z.ZodString;
+            userId: z.ZodString;
+            agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>;
+        authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"HOST">;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"OAUTH">;
+            authorityVersion: z.ZodLiteral<2>;
+            clientId: z.ZodString;
+            grantId: z.ZodString;
+            resource: z.ZodString;
+        }, z.core.$strict>], "type">;
+        submittedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    policy: z.ZodObject<{
+        ref: z.ZodString;
+        revision: z.ZodString;
+        acquisition: z.ZodEnum<{
+            ALLOW: "ALLOW";
+            DENY: "DENY";
+        }>;
+        propagation: z.ZodEnum<{
+            TENANT_ONLY: "TENANT_ONLY";
+            SHARE_ALLOWED: "SHARE_ALLOWED";
+            PUBLIC_ALLOWED: "PUBLIC_ALLOWED";
+        }>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type TenantWebContentJob = z.infer<typeof tenantWebContentJobSchema>;
+export declare const tenantWebContentHeadSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    seq: z.ZodNumber;
+    cursor: z.ZodNumber;
+    variant: z.ZodNumber;
+    processed: z.ZodNumber;
+    registered: z.ZodNumber;
+    missing: z.ZodNumber;
+    attempts: z.ZodNumber;
+    chargedBytes: z.ZodNumber;
+    chargedMs: z.ZodNumber;
+    reservation: z.ZodNullable<z.ZodObject<{
+        bytes: z.ZodNumber;
+        ms: z.ZodNumber;
+    }, z.core.$strict>>;
+    state: z.ZodEnum<{
+        PARTIAL: "PARTIAL";
+        COMPLETE: "COMPLETE";
+        QUEUED: "QUEUED";
+        RUNNING: "RUNNING";
+    }>;
+    gaps: z.ZodArray<z.ZodString>;
+    finishedAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strict>;
+export type TenantWebContentHead = z.infer<typeof tenantWebContentHeadSchema>;
+export declare const tenantWebContentOutcomeSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    index: z.ZodNumber;
+    ordinal: z.ZodNumber;
+    variant: z.ZodNumber;
+    documentRef: z.ZodNullable<z.ZodString>;
+    gaps: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const tenantWebContentStatusSchema: z.ZodObject<{
+    phase: z.ZodEnum<{
+        DYNAMIC_ACQUISITION: "DYNAMIC_ACQUISITION";
+        CONTENT_DERIVATION: "CONTENT_DERIVATION";
+    }>;
+    requirementsState: z.ZodEnum<{
+        PENDING: "PENDING";
+        PARTIAL: "PARTIAL";
+        SATISFIED: "SATISFIED";
+    }>;
+    contentRevision: z.ZodString;
+    content: z.ZodObject<{
+        processed: z.ZodNumber;
+        registered: z.ZodNumber;
+        missing: z.ZodNumber;
+        gaps: z.ZodArray<z.ZodString>;
+        compiler: z.ZodEnum<{
+            CALLER_PLAN_V1: "CALLER_PLAN_V1";
+            BOUNDED_LANGUAGE_V1: "BOUNDED_LANGUAGE_V1";
+        }>;
+        model: z.ZodLiteral<"DISABLED_NO_MODEL_CALLS">;
+    }, z.core.$strict>;
+    ocr: z.ZodObject<{
+        capability: z.ZodLiteral<"UNAVAILABLE">;
+        budgetState: z.ZodLiteral<"NOT_CONFIGURED">;
+        processedPages: z.ZodLiteral<0>;
+    }, z.core.$strict>;
+    dynamic: z.ZodObject<{
+        browserPages: z.ZodNumber;
+        pagesQueued: z.ZodNumber;
+        filesQueued: z.ZodNumber;
+        renderedStates: z.ZodNumber;
+        pdfExtracted: z.ZodNumber;
+        interactions: z.ZodNumber;
+    }, z.core.$strict>;
+    requestId: z.ZodString;
+    jobRef: z.ZodString;
+    specRevision: z.ZodString;
+    state: z.ZodEnum<{
+        PARTIAL: "PARTIAL";
+        COMPLETE: "COMPLETE";
+        QUEUED: "QUEUED";
+        RUNNING: "RUNNING";
+    }>;
+    indexState: z.ZodLiteral<"NOT_EVALUATED">;
+    coverage: z.ZodObject<{
+        total: z.ZodNullable<z.ZodNumber>;
+        discovered: z.ZodNumber;
+        acquired: z.ZodNumber;
+        registered: z.ZodNumber;
+        pending: z.ZodNumber;
+        gaps: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    budget: z.ZodObject<{
+        chargedBytes: z.ZodNumber;
+        chargedMs: z.ZodNumber;
+        conservativeReservation: z.ZodBoolean;
+    }, z.core.$strict>;
+    finishedAt: z.ZodNullable<z.ZodISODateTime>;
+    nextEligibleAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strict>;
+export declare function tenantWebContentStatus(job: TenantWebContentJob, a: TenantWebDynamicHead, h: TenantWebContentHead): {
+    phase: "DYNAMIC_ACQUISITION" | "CONTENT_DERIVATION";
+    requirementsState: "PENDING" | "PARTIAL" | "SATISFIED";
+    contentRevision: string;
+    content: {
+        processed: number;
+        registered: number;
+        missing: number;
+        gaps: string[];
+        compiler: "CALLER_PLAN_V1" | "BOUNDED_LANGUAGE_V1";
+        model: "DISABLED_NO_MODEL_CALLS";
+    };
+    ocr: {
+        capability: "UNAVAILABLE";
+        budgetState: "NOT_CONFIGURED";
+        processedPages: 0;
+    };
+    dynamic: {
+        browserPages: number;
+        pagesQueued: number;
+        filesQueued: number;
+        renderedStates: number;
+        pdfExtracted: number;
+        interactions: number;
+    };
+    requestId: string;
+    jobRef: string;
+    specRevision: string;
+    state: "PARTIAL" | "COMPLETE" | "QUEUED" | "RUNNING";
+    indexState: "NOT_EVALUATED";
+    coverage: {
+        total: number | null;
+        discovered: number;
+        acquired: number;
+        registered: number;
+        pending: number;
+        gaps: string[];
+    };
+    budget: {
+        chargedBytes: number;
+        chargedMs: number;
+        conservativeReservation: boolean;
+    };
+    finishedAt: string | null;
+    nextEligibleAt: string | null;
+};

package/dist/types/contracts/tenant-web-crawl.d.ts

@@ -0,0 +1,310 @@
+/** 可执行静态网站任务；独立于冻结的 S1 意图，Tenant 是唯一归属。 */
+import { z } from 'zod';
+import { type TenantWebSpec } from './tenant-web-collection.js';
+export declare const TENANT_WEB_CRAWL_CAPABILITY = "TENANT_WEB_CRAWL_V1";
+export declare const tenantWebPolicySchema: z.ZodObject<{
+    ref: z.ZodString;
+    revision: z.ZodString;
+    acquisition: z.ZodEnum<{
+        ALLOW: "ALLOW";
+        DENY: "DENY";
+    }>;
+    propagation: z.ZodEnum<{
+        TENANT_ONLY: "TENANT_ONLY";
+        SHARE_ALLOWED: "SHARE_ALLOWED";
+        PUBLIC_ALLOWED: "PUBLIC_ALLOWED";
+    }>;
+}, z.core.$strict>;
+export declare const tenantWebCrawlSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    intent: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        tenantId: z.ZodString;
+        requestId: z.ZodString;
+        jobRef: z.ZodString;
+        inputRevision: z.ZodString;
+        specRevision: z.ZodString;
+        requestedSpec: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            url: z.ZodString;
+            scope: z.ZodObject<{
+                mode: z.ZodEnum<{
+                    FEED: "FEED";
+                    SINGLE_PAGE: "SINGLE_PAGE";
+                    URL_LIST: "URL_LIST";
+                    SITE_SECTION: "SITE_SECTION";
+                    SITEMAP: "SITEMAP";
+                }>;
+                allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                includePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                excludePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                urls: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                followPagination: z.ZodDefault<z.ZodBoolean>;
+                followDetailLinks: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>;
+            requirements: z.ZodObject<{
+                instruction: z.ZodString;
+                fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodEnum<{
+                        string: "string";
+                        number: "number";
+                        boolean: "boolean";
+                        object: "object";
+                        array: "array";
+                    }>;
+                    required: z.ZodDefault<z.ZodBoolean>;
+                }, z.core.$strict>>>;
+                outputs: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    RAW: "RAW";
+                    DOCUMENT: "DOCUMENT";
+                    RECORDS: "RECORDS";
+                }>>>;
+                attachments: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    PDF: "PDF";
+                    IMAGE: "IMAGE";
+                    AUDIO: "AUDIO";
+                    VIDEO: "VIDEO";
+                    OTHER: "OTHER";
+                }>>>;
+            }, z.core.$strict>;
+            limits: z.ZodDefault<z.ZodObject<{
+                maxPages: z.ZodDefault<z.ZodNumber>;
+                maxDepth: z.ZodDefault<z.ZodNumber>;
+                maxResourceBytes: z.ZodDefault<z.ZodNumber>;
+                maxTotalBytes: z.ZodDefault<z.ZodNumber>;
+                maxRuntimeMs: z.ZodDefault<z.ZodNumber>;
+                maxInteractions: z.ZodDefault<z.ZodNumber>;
+                maxFiles: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strict>>;
+            refresh: z.ZodDefault<z.ZodObject<{
+                mode: z.ZodLiteral<"ONCE">;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        spec: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            url: z.ZodString;
+            scope: z.ZodObject<{
+                mode: z.ZodEnum<{
+                    FEED: "FEED";
+                    SINGLE_PAGE: "SINGLE_PAGE";
+                    URL_LIST: "URL_LIST";
+                    SITE_SECTION: "SITE_SECTION";
+                    SITEMAP: "SITEMAP";
+                }>;
+                allowedOrigins: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                includePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                excludePaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                urls: z.ZodDefault<z.ZodArray<z.ZodString>>;
+                followPagination: z.ZodDefault<z.ZodBoolean>;
+                followDetailLinks: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>;
+            requirements: z.ZodObject<{
+                instruction: z.ZodString;
+                fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                    name: z.ZodString;
+                    type: z.ZodEnum<{
+                        string: "string";
+                        number: "number";
+                        boolean: "boolean";
+                        object: "object";
+                        array: "array";
+                    }>;
+                    required: z.ZodDefault<z.ZodBoolean>;
+                }, z.core.$strict>>>;
+                outputs: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    RAW: "RAW";
+                    DOCUMENT: "DOCUMENT";
+                    RECORDS: "RECORDS";
+                }>>>;
+                attachments: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    PDF: "PDF";
+                    IMAGE: "IMAGE";
+                    AUDIO: "AUDIO";
+                    VIDEO: "VIDEO";
+                    OTHER: "OTHER";
+                }>>>;
+            }, z.core.$strict>;
+            limits: z.ZodDefault<z.ZodObject<{
+                maxPages: z.ZodDefault<z.ZodNumber>;
+                maxDepth: z.ZodDefault<z.ZodNumber>;
+                maxResourceBytes: z.ZodDefault<z.ZodNumber>;
+                maxTotalBytes: z.ZodDefault<z.ZodNumber>;
+                maxRuntimeMs: z.ZodDefault<z.ZodNumber>;
+                maxInteractions: z.ZodDefault<z.ZodNumber>;
+                maxFiles: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strict>>;
+            refresh: z.ZodDefault<z.ZodObject<{
+                mode: z.ZodLiteral<"ONCE">;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        actor: z.ZodObject<{
+            tenantId: z.ZodString;
+            userId: z.ZodString;
+            agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, z.core.$strict>;
+        authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"HOST">;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"OAUTH">;
+            authorityVersion: z.ZodLiteral<2>;
+            clientId: z.ZodString;
+            grantId: z.ZodString;
+            resource: z.ZodString;
+        }, z.core.$strict>], "type">;
+        submittedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    policy: z.ZodObject<{
+        ref: z.ZodString;
+        revision: z.ZodString;
+        acquisition: z.ZodEnum<{
+            ALLOW: "ALLOW";
+            DENY: "DENY";
+        }>;
+        propagation: z.ZodEnum<{
+            TENANT_ONLY: "TENANT_ONLY";
+            SHARE_ALLOWED: "SHARE_ALLOWED";
+            PUBLIC_ALLOWED: "PUBLIC_ALLOWED";
+        }>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type TenantWebCrawl = z.infer<typeof tenantWebCrawlSchema>;
+export declare function tenantWebAdmissionKey(tenantId: string, jobRef: string): string;
+export declare const tenantWebTargetSchema: z.ZodObject<{
+    ordinal: z.ZodNumber;
+    url: z.ZodString;
+    parent: z.ZodNullable<z.ZodString>;
+    depth: z.ZodNumber;
+    role: z.ZodEnum<{
+        FEED: "FEED";
+        SITEMAP: "SITEMAP";
+        PAGE: "PAGE";
+    }>;
+}, z.core.$strict>;
+export type TenantWebTarget = z.infer<typeof tenantWebTargetSchema>;
+export declare const tenantWebOutcomeSchema: z.ZodObject<{
+    ordinal: z.ZodNumber;
+    batchId: z.ZodNullable<z.ZodString>;
+    capture: z.ZodNullable<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        tenantId: z.ZodString;
+        batchRef: z.ZodString;
+        sourceRevisionRef: z.ZodString;
+        taskId: z.ZodString;
+        evidenceRef: z.ZodString;
+        contentHash: z.ZodString;
+        byteLength: z.ZodNumber;
+        mediaType: z.ZodString;
+        observedAt: z.ZodISODateTime;
+        finalLocator: z.ZodString;
+        httpStatus: z.ZodNullable<z.ZodNumber>;
+        acquisitionRevision: z.ZodNullable<z.ZodString>;
+        headersRecorded: z.ZodBoolean;
+    }, z.core.$strict>>;
+    registered: z.ZodBoolean;
+    errorCode: z.ZodNullable<z.ZodString>;
+    reused: z.ZodBoolean;
+}, z.core.$strict>;
+export type TenantWebOutcome = z.infer<typeof tenantWebOutcomeSchema>;
+export declare const tenantWebHeadSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    seq: z.ZodNumber;
+    queued: z.ZodNumber;
+    cursor: z.ZodNumber;
+    stage: z.ZodEnum<{
+        ACQUIRE: "ACQUIRE";
+        DISCOVER: "DISCOVER";
+    }>;
+    after: z.ZodNumber;
+    attempts: z.ZodNumber;
+    currentAcquired: z.ZodBoolean;
+    acquired: z.ZodNumber;
+    registered: z.ZodNumber;
+    chargedBytes: z.ZodNumber;
+    chargedMs: z.ZodNumber;
+    reservation: z.ZodNullable<z.ZodObject<{
+        bytes: z.ZodNumber;
+        ms: z.ZodNumber;
+    }, z.core.$strict>>;
+    gaps: z.ZodArray<z.ZodString>;
+    state: z.ZodEnum<{
+        PARTIAL: "PARTIAL";
+        COMPLETE: "COMPLETE";
+        QUEUED: "QUEUED";
+        RUNNING: "RUNNING";
+    }>;
+    finishedAt: z.ZodNullable<z.ZodISODateTime>;
+    notBefore: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strict>;
+export type TenantWebHead = z.infer<typeof tenantWebHeadSchema>;
+export declare const tenantWebChildOwnerSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    jobRef: z.ZodString;
+    ordinal: z.ZodNumber;
+    requestId: z.ZodString;
+    batchId: z.ZodString;
+}, z.core.$strict>;
+export type TenantWebChildOwner = z.infer<typeof tenantWebChildOwnerSchema>;
+export declare const tenantWebCrawlStatusSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    jobRef: z.ZodString;
+    specRevision: z.ZodString;
+    state: z.ZodEnum<{
+        PARTIAL: "PARTIAL";
+        COMPLETE: "COMPLETE";
+        QUEUED: "QUEUED";
+        RUNNING: "RUNNING";
+    }>;
+    phase: z.ZodLiteral<"STATIC_ACQUISITION">;
+    requirementsState: z.ZodLiteral<"DECLARED_NOT_EVALUATED">;
+    indexState: z.ZodLiteral<"NOT_EVALUATED">;
+    coverage: z.ZodObject<{
+        total: z.ZodNullable<z.ZodNumber>;
+        discovered: z.ZodNumber;
+        acquired: z.ZodNumber;
+        registered: z.ZodNumber;
+        pending: z.ZodNumber;
+        gaps: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    budget: z.ZodObject<{
+        chargedBytes: z.ZodNumber;
+        chargedMs: z.ZodNumber;
+        conservativeReservation: z.ZodBoolean;
+    }, z.core.$strict>;
+    finishedAt: z.ZodNullable<z.ZodISODateTime>;
+    nextEligibleAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strict>;
+export declare function tenantWebCrawlStatus(job: TenantWebCrawl, head: TenantWebHead): {
+    requestId: string;
+    jobRef: string;
+    specRevision: string;
+    state: "PARTIAL" | "COMPLETE" | "QUEUED" | "RUNNING";
+    phase: "STATIC_ACQUISITION";
+    requirementsState: "DECLARED_NOT_EVALUATED";
+    indexState: "NOT_EVALUATED";
+    coverage: {
+        total: number | null;
+        discovered: number;
+        acquired: number;
+        registered: number;
+        pending: number;
+        gaps: string[];
+    };
+    budget: {
+        chargedBytes: number;
+        chargedMs: number;
+        conservativeReservation: boolean;
+    };
+    finishedAt: string | null;
+    nextEligibleAt: string | null;
+};
+export declare function tenantWebPathMatches(pattern: string, pathname: string): boolean;
+export declare function tenantWebInScope(spec: Pick<TenantWebSpec, 'url' | 'scope'>, raw: string, options?: {
+    robots?: boolean;
+    bootstrap?: boolean;
+}): boolean;
+export declare function sameTenantWebDelegation(a: Pick<TenantWebCrawl, 'policy'> & {
+    intent: Pick<TenantWebCrawl['intent'], 'tenantId' | 'authority' | 'actor'>;
+}, b: Pick<TenantWebCrawl, 'policy'> & {
+    intent: Pick<TenantWebCrawl['intent'], 'tenantId' | 'authority' | 'actor'>;
+}): boolean;