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

package/dist/internal/contracts/tenant-web-workflow.d.ts

@@ -0,0 +1,494 @@
+/** S5 operational state; acquisition/content evidence and business review remain separate. */
+import { z } from 'zod';
+import { type TenantWebContentJob } from './tenant-web-content.js';
+export declare const TENANT_WEB_WORKFLOW_CAPABILITY = "TENANT_WEB_WORKFLOW_V1";
+export declare const tenantWebScheduleSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    mode: z.ZodLiteral<"ONCE">;
+}, z.core.$strict>, z.ZodObject<{
+    mode: z.ZodLiteral<"PERIODIC">;
+    intervalSeconds: z.ZodNumber;
+}, z.core.$strict>], "mode">;
+export declare const tenantWebWorkflowJobSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<5>;
+    schedule: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mode: z.ZodLiteral<"ONCE">;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"PERIODIC">;
+        intervalSeconds: z.ZodNumber;
+    }, z.core.$strict>], "mode">;
+    cycle: z.ZodObject<{
+        kind: z.ZodEnum<{
+            DUE: "DUE";
+            INITIAL: "INITIAL";
+            MANUAL_REFRESH: "MANUAL_REFRESH";
+        }>;
+        rootJobRef: z.ZodString;
+        previousJobRef: z.ZodNullable<z.ZodString>;
+        ordinal: z.ZodNumber;
+        requestedEpoch: z.ZodNumber;
+    }, z.core.$strict>;
+    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 TenantWebWorkflowJob = z.infer<typeof tenantWebWorkflowJobSchema>;
+export declare function tenantWebExecutableContent(job: TenantWebWorkflowJob): TenantWebContentJob;
+export declare const tenantWebLifecycleSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    seq: z.ZodNumber;
+    epoch: z.ZodNumber;
+    state: z.ZodEnum<{
+        ACTIVE: "ACTIVE";
+        PAUSED: "PAUSED";
+        CANCELLED: "CANCELLED";
+    }>;
+    currentJobRef: z.ZodString;
+    cycleOrdinal: z.ZodNumber;
+    lastObservedAt: z.ZodNullable<z.ZodISODateTime>;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type TenantWebLifecycle = z.infer<typeof tenantWebLifecycleSchema>;
+export declare const tenantWebControlInputSchema: z.ZodObject<{
+    jobRef: z.ZodString;
+    requestId: z.ZodString;
+    expectedEpoch: z.ZodNumber;
+    action: z.ZodEnum<{
+        PAUSE: "PAUSE";
+        RESUME: "RESUME";
+        CANCEL: "CANCEL";
+    }>;
+}, z.core.$strict>;
+export declare const tenantWebControlOperationSchema: z.ZodObject<{
+    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">;
+    jobRef: z.ZodString;
+    requestId: z.ZodString;
+    expectedEpoch: z.ZodNumber;
+    action: z.ZodEnum<{
+        PAUSE: "PAUSE";
+        RESUME: "RESUME";
+        CANCEL: "CANCEL";
+    }>;
+}, z.core.$strict>;
+export type TenantWebControlOperation = z.infer<typeof tenantWebControlOperationSchema>;
+export declare const tenantWebLifecycleReceiptSchema: z.ZodObject<{
+    operation: z.ZodObject<{
+        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">;
+        jobRef: z.ZodString;
+        requestId: z.ZodString;
+        expectedEpoch: z.ZodNumber;
+        action: z.ZodEnum<{
+            PAUSE: "PAUSE";
+            RESUME: "RESUME";
+            CANCEL: "CANCEL";
+        }>;
+    }, z.core.$strict>;
+    committed: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        seq: z.ZodNumber;
+        epoch: z.ZodNumber;
+        state: z.ZodEnum<{
+            ACTIVE: "ACTIVE";
+            PAUSED: "PAUSED";
+            CANCELLED: "CANCELLED";
+        }>;
+        currentJobRef: z.ZodString;
+        cycleOrdinal: z.ZodNumber;
+        lastObservedAt: z.ZodNullable<z.ZodISODateTime>;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const tenantWebWorkflowStatusSchema: z.ZodObject<{
+    jobRef: z.ZodString;
+    requestId: z.ZodString;
+    rootJobRef: z.ZodString;
+    executionJobRef: z.ZodString;
+    state: z.ZodEnum<{
+        PARTIAL: "PARTIAL";
+        COMPLETE: "COMPLETE";
+        PAUSED: "PAUSED";
+        QUEUED: "QUEUED";
+        RUNNING: "RUNNING";
+        CANCELLED: "CANCELLED";
+    }>;
+    control: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        seq: z.ZodNumber;
+        epoch: z.ZodNumber;
+        state: z.ZodEnum<{
+            ACTIVE: "ACTIVE";
+            PAUSED: "PAUSED";
+            CANCELLED: "CANCELLED";
+        }>;
+        currentJobRef: z.ZodString;
+        cycleOrdinal: z.ZodNumber;
+        lastObservedAt: z.ZodNullable<z.ZodISODateTime>;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    cycle: z.ZodObject<{
+        kind: z.ZodEnum<{
+            DUE: "DUE";
+            INITIAL: "INITIAL";
+            MANUAL_REFRESH: "MANUAL_REFRESH";
+        }>;
+        rootJobRef: z.ZodString;
+        previousJobRef: z.ZodNullable<z.ZodString>;
+        ordinal: z.ZodNumber;
+        requestedEpoch: z.ZodNumber;
+    }, z.core.$strict>;
+    schedule: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mode: z.ZodLiteral<"ONCE">;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"PERIODIC">;
+        intervalSeconds: z.ZodNumber;
+    }, z.core.$strict>], "mode">;
+    nextDueAt: z.ZodNullable<z.ZodISODateTime>;
+    stages: z.ZodObject<{
+        intent: z.ZodLiteral<"PERSISTED">;
+        acquisition: z.ZodObject<{
+            state: z.ZodEnum<{
+                PARTIAL: "PARTIAL";
+                COMPLETE: "COMPLETE";
+                QUEUED: "QUEUED";
+                RUNNING: "RUNNING";
+            }>;
+            discovered: z.ZodNumber;
+            acquired: z.ZodNumber;
+            registered: z.ZodNumber;
+            pending: z.ZodNumber;
+            gaps: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        content: z.ZodObject<{
+            state: z.ZodEnum<{
+                PENDING: "PENDING";
+                PARTIAL: "PARTIAL";
+                SATISFIED: "SATISFIED";
+            }>;
+            processed: z.ZodNumber;
+            registered: z.ZodNumber;
+            gaps: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        index: z.ZodLiteral<"NOT_PROVEN_QUERY_TENANT_INDEX_STATUS">;
+        readability: z.ZodLiteral<"NOT_PROVEN_UNTIL_ACTUAL_READ">;
+        review: z.ZodLiteral<"UNREVIEWED">;
+    }, z.core.$strict>;
+    budget: z.ZodObject<{
+        chargedBytes: z.ZodNumber;
+        chargedMs: z.ZodNumber;
+        conservativeReservation: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare function tenantWebNextDue(root: TenantWebWorkflowJob, head: TenantWebLifecycle, current: TenantWebWorkflowJob): string | null;
+export declare const sameTenantWebWorkflow: (a: TenantWebWorkflowJob, b: TenantWebWorkflowJob) => boolean;
+export declare const tenantWebLifecycleEventSchema: z.ZodObject<{
+    before: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        seq: z.ZodNumber;
+        epoch: z.ZodNumber;
+        state: z.ZodEnum<{
+            ACTIVE: "ACTIVE";
+            PAUSED: "PAUSED";
+            CANCELLED: "CANCELLED";
+        }>;
+        currentJobRef: z.ZodString;
+        cycleOrdinal: z.ZodNumber;
+        lastObservedAt: z.ZodNullable<z.ZodISODateTime>;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    after: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        seq: z.ZodNumber;
+        epoch: z.ZodNumber;
+        state: z.ZodEnum<{
+            ACTIVE: "ACTIVE";
+            PAUSED: "PAUSED";
+            CANCELLED: "CANCELLED";
+        }>;
+        currentJobRef: z.ZodString;
+        cycleOrdinal: z.ZodNumber;
+        lastObservedAt: z.ZodNullable<z.ZodISODateTime>;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    operation: z.ZodNullable<z.ZodObject<{
+        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">;
+        jobRef: z.ZodString;
+        requestId: z.ZodString;
+        expectedEpoch: z.ZodNumber;
+        action: z.ZodEnum<{
+            PAUSE: "PAUSE";
+            RESUME: "RESUME";
+            CANCEL: "CANCEL";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;

package/dist/internal/contracts/tenant-web-workflow.js

@@ -0,0 +1,29 @@
+/** S5 operational state; acquisition/content evidence and business review remain separate. */
+import { z } from 'zod';
+import { tenantWebContentJobSchema } from './tenant-web-content.js';
+import { tenantWebJobRefSchema, tenantWebCanonical } from './tenant-web-collection.js';
+import { tenantCollectionCycleSchema } from './tenant-collection.js';
+import { isoDateTimeSchema } from './common.js';
+export const TENANT_WEB_WORKFLOW_CAPABILITY = 'TENANT_WEB_WORKFLOW_V1';
+export const tenantWebScheduleSchema = z.discriminatedUnion('mode', [z.object({ mode: z.literal('ONCE') }).strict(), z.object({ mode: z.literal('PERIODIC'), intervalSeconds: z.number().int().min(60).max(2592000) }).strict()]);
+export const tenantWebWorkflowJobSchema = z.object({ ...tenantWebContentJobSchema.shape, schemaVersion: z.literal(5), schedule: tenantWebScheduleSchema, cycle: z.object({ kind: z.enum(['INITIAL', 'MANUAL_REFRESH', 'DUE']), rootJobRef: tenantWebJobRefSchema, previousJobRef: tenantWebJobRefSchema.nullable(), ordinal: z.number().int().nonnegative().safe(), requestedEpoch: z.number().int().nonnegative().safe() }).strict() }).strict().superRefine((v, c) => {
+    const old = tenantWebContentJobSchema.safeParse({ schemaVersion: 4, intent: v.intent, policy: v.policy, contentPlan: v.contentPlan, contentRevision: v.contentRevision, retainedFrom: v.retainedFrom });
+    if (!old.success)
+        c.addIssue({ code: 'custom', message: 'Invalid frozen content intent' });
+    const wrongTenant = [v.cycle.rootJobRef, v.cycle.previousJobRef].some(ref => ref && new URL(ref).hostname !== new URL(v.intent.jobRef).hostname), wrongCycle = v.cycle.kind === 'INITIAL' ? (v.cycle.rootJobRef !== v.intent.jobRef || v.cycle.previousJobRef !== null || v.cycle.ordinal !== 0 || v.cycle.requestedEpoch !== 0) : (v.cycle.rootJobRef === v.intent.jobRef || v.cycle.previousJobRef === null || v.cycle.ordinal < 1 || v.retainedFrom !== null);
+    if (wrongTenant || wrongCycle)
+        c.addIssue({ code: 'custom', message: 'Cycle must retain its exact Tenant/root/previous identity' });
+    if (v.retainedFrom && v.schedule.mode !== 'ONCE')
+        c.addIssue({ code: 'custom', message: 'Retained derivation cannot enable periodic source observations' });
+});
+export function tenantWebExecutableContent(job) { return tenantWebContentJobSchema.parse({ schemaVersion: 4, intent: job.intent, policy: job.policy, contentPlan: job.contentPlan, contentRevision: job.contentRevision, retainedFrom: job.retainedFrom }); }
+export const tenantWebLifecycleSchema = z.object({ schemaVersion: z.literal(1), seq: z.number().int().nonnegative().safe(), epoch: z.number().int().nonnegative().safe(), state: z.enum(['ACTIVE', 'PAUSED', 'CANCELLED']), currentJobRef: tenantWebJobRefSchema, cycleOrdinal: z.number().int().nonnegative().safe(), lastObservedAt: isoDateTimeSchema.nullable(), updatedAt: isoDateTimeSchema }).strict().refine(v => v.epoch <= v.seq && v.cycleOrdinal <= v.seq);
+export const tenantWebControlInputSchema = z.object({ jobRef: tenantWebJobRefSchema, requestId: tenantCollectionCycleSchema, expectedEpoch: z.number().int().nonnegative().safe(), action: z.enum(['PAUSE', 'RESUME', 'CANCEL']) }).strict();
+export const tenantWebControlOperationSchema = z.object({ ...tenantWebControlInputSchema.shape, actor: tenantWebWorkflowJobSchema.shape.intent.shape.actor, authority: tenantWebWorkflowJobSchema.shape.intent.shape.authority }).strict();
+export const tenantWebLifecycleReceiptSchema = z.object({ operation: tenantWebControlOperationSchema, committed: tenantWebLifecycleSchema }).strict();
+export const tenantWebWorkflowStatusSchema = z.object({ jobRef: tenantWebJobRefSchema, requestId: tenantCollectionCycleSchema, rootJobRef: tenantWebJobRefSchema, executionJobRef: tenantWebJobRefSchema, state: z.enum(['QUEUED', 'RUNNING', 'COMPLETE', 'PARTIAL', 'PAUSED', 'CANCELLED']), control: tenantWebLifecycleSchema, cycle: tenantWebWorkflowJobSchema.shape.cycle, schedule: tenantWebScheduleSchema, nextDueAt: isoDateTimeSchema.nullable(), stages: z.object({ intent: z.literal('PERSISTED'), acquisition: z.object({ state: z.enum(['QUEUED', 'RUNNING', 'COMPLETE', 'PARTIAL']), discovered: z.number().int().nonnegative(), acquired: z.number().int().nonnegative(), registered: z.number().int().nonnegative(), pending: z.number().int().nonnegative(), gaps: z.array(z.string()).max(32) }).strict(), content: z.object({ state: z.enum(['PENDING', 'SATISFIED', 'PARTIAL']), processed: z.number().int().nonnegative(), registered: z.number().int().nonnegative(), gaps: z.array(z.string()).max(32) }).strict(), index: z.literal('NOT_PROVEN_QUERY_TENANT_INDEX_STATUS'), readability: z.literal('NOT_PROVEN_UNTIL_ACTUAL_READ'), review: z.literal('UNREVIEWED') }).strict(), budget: z.object({ chargedBytes: z.number().int().nonnegative(), chargedMs: z.number().int().nonnegative(), conservativeReservation: z.boolean() }).strict() }).strict().superRefine((v, c) => { const key = new URL(v.jobRef).hostname; if ([v.rootJobRef, v.executionJobRef, v.control.currentJobRef, v.cycle.rootJobRef].some(ref => new URL(ref).hostname !== key))
+    c.addIssue({ code: 'custom', message: 'Exact Tenant workflow required' }); });
+export function tenantWebNextDue(root, head, current) { if (root.schedule.mode !== 'PERIODIC' || head.state !== 'ACTIVE')
+    return null; return new Date(Math.max(Date.parse(head.lastObservedAt ?? current.intent.submittedAt), Date.parse(current.intent.submittedAt)) + root.schedule.intervalSeconds * 1000).toISOString(); }
+export const sameTenantWebWorkflow = (a, b) => tenantWebCanonical(a.intent.actor) === tenantWebCanonical(b.intent.actor) && tenantWebCanonical(a.intent.authority) === tenantWebCanonical(b.intent.authority) && tenantWebCanonical(a.policy) === tenantWebCanonical(b.policy) && a.intent.tenantId === b.intent.tenantId && a.intent.specRevision === b.intent.specRevision && a.contentRevision === b.contentRevision && tenantWebCanonical(a.schedule) === tenantWebCanonical(b.schedule);
+export const tenantWebLifecycleEventSchema = z.object({ before: tenantWebLifecycleSchema, after: tenantWebLifecycleSchema, operation: tenantWebControlOperationSchema.nullable() }).strict().refine(v => v.after.seq === v.before.seq + 1 && v.after.epoch === v.before.epoch + (v.operation ? 1 : 0) && (!v.before.lastObservedAt || v.after.lastObservedAt !== null && v.after.lastObservedAt >= v.before.lastObservedAt) && v.after.cycleOrdinal >= v.before.cycleOrdinal && v.after.cycleOrdinal <= v.before.cycleOrdinal + 1 && (v.operation !== null || v.after.state === v.before.state) && (!v.operation || v.operation.expectedEpoch === v.before.epoch && v.after.cycleOrdinal === v.before.cycleOrdinal && v.after.currentJobRef === v.before.currentJobRef && v.after.state === (v.operation.action === 'PAUSE' ? 'PAUSED' : v.operation.action === 'RESUME' ? 'ACTIVE' : 'CANCELLED')) && (v.before.state !== 'CANCELLED' || v.after.state === 'CANCELLED') && (v.after.cycleOrdinal !== v.before.cycleOrdinal ? v.before.state === 'ACTIVE' && v.after.state === 'ACTIVE' && v.after.currentJobRef !== v.before.currentJobRef : v.after.currentJobRef === v.before.currentJobRef));

package/dist/internal/serving-contracts/agent-catalog.d.ts

@@ -0,0 +1,70 @@
+/** Bilingual intent recall is bounded, deterministic and independent of resource contents. */
+import type { AgentCapabilityName } from './agent-entry.js';
+type Card = {
+    category: 'materials' | 'sources' | 'collection' | 'governance' | 'sharing' | 'projects' | 'runtime';
+    title: string;
+    description: string;
+    readOnly: boolean;
+    terms: string[];
+};
+export declare const agentCatalog: {
+    knowledge_resource_search_body: Card;
+    knowledge_resource_read_passage: Card;
+    knowledge_resource_search: Card;
+    knowledge_resource_list: Card;
+    knowledge_resource_describe: Card;
+    knowledge_resource_read: Card;
+    knowledge_resource_capabilities: Card;
+    knowledge_resource_media: Card;
+    knowledge_resource_counts: Card;
+    knowledge_resource_window: Card;
+    knowledge_resource_changes: Card;
+    knowledge_resource_index_status: Card;
+    tenant_material_submit: Card;
+    tenant_artifact_draft: Card;
+    tenant_knowledge_compose: Card;
+    tenant_knowledge_review: Card;
+    tenant_artifact_promote: Card;
+    tenant_snapshot_declare: Card;
+    tenant_snapshot_status: Card;
+    tenant_workflow_plan: Card;
+    tenant_workflow_advance: Card;
+    tenant_knowledge_read: Card;
+    tenant_material_share: Card;
+    tenant_material_revoke: Card;
+    tenant_material_routes: Card;
+    tenant_source_define: Card;
+    tenant_source_configure: Card;
+    tenant_source_get: Card;
+    tenant_source_list: Card;
+    tenant_source_inventory: Card;
+    tenant_collection_request: Card;
+    tenant_collection_status: Card;
+    tenant_work_queue: Card;
+    tenant_project_list: Card;
+    tenant_project_get: Card;
+    tenant_project_materials: Card;
+    tenant_project_scope_set: Card;
+    tenant_project_lifecycle_set: Card;
+    tenant_runtime_status: Card;
+    tenant_web_collect_preview: Card;
+    tenant_web_collect_submit: Card;
+    tenant_web_collect_status: Card;
+    tenant_web_collect_results: Card;
+    tenant_web_collect_cycles: Card;
+    tenant_web_collect_control: Card;
+    tenant_web_collect_refresh: Card;
+    tenant_web_collect_read: Card;
+    tenant_web_collect_index_status: Card;
+};
+export declare const agentCategoryTitles: {
+    readonly materials: "Material discovery / 资料检索";
+    readonly sources: "Source management / 来源管理";
+    readonly collection: "Collection tasks / 采集任务";
+    readonly governance: "Knowledge workflow / 知识工作流";
+    readonly sharing: "Sharing / 共享";
+    readonly projects: "Project purpose / 项目用途";
+    readonly runtime: "Runtime diagnostics / 运行诊断";
+};
+export declare function recallAgentCapabilities(query: string, names: AgentCapabilityName[]): ("tenant_material_submit" | "tenant_artifact_draft" | "tenant_knowledge_compose" | "tenant_knowledge_review" | "tenant_artifact_promote" | "tenant_snapshot_declare" | "tenant_snapshot_status" | "tenant_material_share" | "tenant_material_revoke" | "tenant_material_routes" | "tenant_workflow_plan" | "tenant_workflow_advance" | "tenant_knowledge_read" | "tenant_source_define" | "tenant_source_configure" | "tenant_source_get" | "tenant_source_list" | "tenant_collection_request" | "tenant_collection_status" | "tenant_source_inventory" | "tenant_work_queue" | "tenant_project_list" | "tenant_project_get" | "tenant_project_materials" | "tenant_project_scope_set" | "tenant_project_lifecycle_set" | "tenant_runtime_status" | "tenant_web_collect_preview" | "tenant_web_collect_submit" | "tenant_web_collect_status" | "tenant_web_collect_results" | "tenant_web_collect_cycles" | "tenant_web_collect_control" | "tenant_web_collect_refresh" | "tenant_web_collect_read" | "tenant_web_collect_index_status" | "knowledge_resource_search_body" | "knowledge_resource_read_passage" | "knowledge_resource_list" | "knowledge_resource_describe" | "knowledge_resource_read" | "knowledge_resource_capabilities" | "knowledge_resource_search" | "knowledge_resource_window" | "knowledge_resource_changes" | "knowledge_resource_counts" | "knowledge_resource_index_status" | "knowledge_resource_media")[];
+export {};