@inf-monkeys-tech/monkeys 1.0.72 → 1.1.1

package/lib/contracts/page-binding-dependencies.d.ts

@@ -0,0 +1,25 @@
+/** Dependency analysis is shared by Page validation and the query runtime. */
+export interface PageDependencyBinding {
+    bindingId: string;
+    parameters: Readonly<Record<string, {
+        kind: string;
+        bindingId?: string;
+        stateId?: string;
+    }>>;
+    stateEffects?: readonly {
+        targetStateId: string;
+    }[];
+    resultStateBindings?: readonly {
+        targetStateId: string;
+    }[];
+}
+export declare const analyzePageBindingDependencies: (bindings: readonly PageDependencyBinding[]) => {
+    order: string[];
+    dependencies: Record<string, string[]>;
+    errors: {
+        bindingId: string;
+        code: 'DUPLICATE' | 'MISSING' | 'CYCLE' | 'STATE_OWNER';
+        dependencyId?: string;
+    }[];
+};
+//# sourceMappingURL=page-binding-dependencies.d.ts.map

package/lib/contracts/page-binding-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-binding-dependencies.d.ts","sourceRoot":"","sources":["../../src/contracts/page-binding-dependencies.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC7F,YAAY,CAAC,EAAE,SAAS;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpD,mBAAmB,CAAC,EAAE,SAAS;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC5D;AACD,eAAO,MAAM,8BAA8B,aAAc,SAAS,qBAAqB,EAAE,KAAG;IAC1F,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,EAAE,OAAO,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CA2CjH,CAAC"}

package/lib/contracts/page-binding-dependencies.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzePageBindingDependencies = void 0;
+const analyzePageBindingDependencies = (bindings) => {
+    const errors = [];
+    const ids = new Set();
+    const stateOwners = new Map();
+    for (const binding of bindings) {
+        if (ids.has(binding.bindingId))
+            errors.push({ bindingId: binding.bindingId, code: 'DUPLICATE' });
+        ids.add(binding.bindingId);
+        for (const result of [...(binding.resultStateBindings ?? []), ...(binding.stateEffects ?? [])]) {
+            if (stateOwners.has(result.targetStateId))
+                errors.push({ bindingId: binding.bindingId, code: 'STATE_OWNER', dependencyId: result.targetStateId });
+            stateOwners.set(result.targetStateId, binding.bindingId);
+        }
+    }
+    const dependencies = Object.create(null);
+    const dependents = new Map();
+    const remaining = new Map();
+    for (const binding of bindings) {
+        const sources = [...new Set(Object.values(binding.parameters).flatMap((source) => {
+                const id = source.kind === 'binding-field' ? source.bindingId : source.kind === 'page-state' && source.stateId ? stateOwners.get(source.stateId) : undefined;
+                return id ? [id] : [];
+            }))];
+        dependencies[binding.bindingId] = sources;
+        remaining.set(binding.bindingId, sources.length);
+        for (const dependencyId of sources) {
+            if (!ids.has(dependencyId))
+                errors.push({ bindingId: binding.bindingId, code: 'MISSING', dependencyId });
+            dependents.set(dependencyId, [...(dependents.get(dependencyId) ?? []), binding.bindingId]);
+        }
+    }
+    const queue = [...ids].filter((id) => remaining.get(id) === 0);
+    const order = [];
+    for (let i = 0; i < queue.length; i++) {
+        const id = queue[i];
+        order.push(id);
+        for (const dependent of dependents.get(id) ?? []) {
+            const count = remaining.get(dependent) - 1;
+            remaining.set(dependent, count);
+            if (count === 0)
+                queue.push(dependent);
+        }
+    }
+    if (order.length !== ids.size && !errors.some((error) => error.code === 'MISSING')) {
+        for (const id of ids)
+            if ((remaining.get(id) ?? 0) > 0)
+                errors.push({ bindingId: id, code: 'CYCLE' });
+    }
+    return { order, dependencies, errors };
+};
+exports.analyzePageBindingDependencies = analyzePageBindingDependencies;
+//# sourceMappingURL=page-binding-dependencies.js.map

package/lib/contracts/page-binding-dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-binding-dependencies.js","sourceRoot":"","sources":["../../src/contracts/page-binding-dependencies.ts"],"names":[],"mappings":"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"}

package/lib/contracts/page-expression.d.ts

@@ -0,0 +1,106 @@
+import { z } from 'zod';
+import { type JsonValue } from './common';
+export declare const PageMemberSchema: z.ZodString;
+export declare const PageValuePathSchema: z.ZodArray<z.ZodString>;
+export declare const PageExpressionRootSchema: z.ZodEnum<{
+    state: "state";
+    model: "model";
+    bindings: "bindings";
+    scope: "scope";
+    intent: "intent";
+    result: "result";
+    actions: "actions";
+}>;
+export declare const PageOperatorSchema: z.ZodEnum<{
+    string: "string";
+    number: "number";
+    max: "max";
+    length: "length";
+    concat: "concat";
+    slice: "slice";
+    entries: "entries";
+    includes: "includes";
+    trim: "trim";
+    fixed: "fixed";
+    add: "add";
+    subtract: "subtract";
+    multiply: "multiply";
+    divide: "divide";
+    min: "min";
+    round: "round";
+    equals: "equals";
+    "not-equals": "not-equals";
+    "less-than": "less-than";
+    "less-or-equal": "less-or-equal";
+    "greater-than": "greater-than";
+    "greater-or-equal": "greater-or-equal";
+    and: "and";
+    or: "or";
+    not: "not";
+    coalesce: "coalesce";
+    get: "get";
+    "set-path": "set-path";
+    merge: "merge";
+    "from-entries": "from-entries";
+    "array-concat": "array-concat";
+    "number-format": "number-format";
+}>;
+export type PageExpression = {
+    kind: 'literal';
+    value: JsonValue;
+} | {
+    kind: 'read';
+    root: z.infer<typeof PageExpressionRootSchema>;
+    path: string[];
+} | {
+    kind: 'operator';
+    operator: z.infer<typeof PageOperatorSchema>;
+    arguments: PageExpression[];
+} | {
+    kind: 'conditional';
+    condition: PageExpression;
+    then: PageExpression;
+    else: PageExpression;
+} | {
+    kind: 'object';
+    fields: Record<string, PageExpression>;
+} | {
+    kind: 'array';
+    items: PageExpression[];
+} | {
+    kind: 'map' | 'filter' | 'sum';
+    source: PageExpression;
+    value: PageExpression;
+};
+export declare const PAGE_EXPRESSION_LIMITS: Readonly<{
+    depth: 32;
+    nodes: 4096;
+    operations: 20000;
+    collection: 1000;
+    bytes: 1048576;
+}>;
+export declare const assertPageValueBudget: (value: unknown) => void;
+/** The input guard runs before recursive schema parsing, including direct Page parsing. */
+export declare const PageExpressionSchema: z.ZodPipe<z.ZodUnknown, z.ZodType<PageExpression, unknown, z.core.$ZodTypeInternals<PageExpression, unknown>>>;
+export declare const PagePropertyBindingSchema: z.ZodObject<{
+    targetPath: z.ZodArray<z.ZodString>;
+    expression: z.ZodPipe<z.ZodUnknown, z.ZodType<PageExpression, unknown, z.core.$ZodTypeInternals<PageExpression, unknown>>>;
+    valueType: z.ZodOptional<z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        object: "object";
+        null: "null";
+        array: "array";
+    }>>;
+}, z.core.$strict>;
+export type PagePropertyBinding = z.infer<typeof PagePropertyBindingSchema>;
+export declare const visitPageExpression: (expression: PageExpression, visit: (node: PageExpression) => void) => void;
+export declare const collectPageExpressionReads: (expression: PageExpression) => Extract<PageExpression, {
+    kind: 'read';
+}>[];
+/** Reads supplied by the caller, excluding lexically bound collection item/index reads. */
+export declare const collectExternalPageExpressionReads: (expression: PageExpression) => Extract<PageExpression, {
+    kind: 'read';
+}>[];
+//# sourceMappingURL=page-expression.d.ts.map

package/lib/contracts/page-expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-expression.d.ts","sourceRoot":"","sources":["../../src/contracts/page-expression.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAE3D,eAAO,MAAM,gBAAgB,aAG5B,CAAC;AACF,eAAO,MAAM,mBAAmB,yBAAoC,CAAC;AACrE,eAAO,MAAM,wBAAwB;;;;;;;;EAAiF,CAAC;AACvH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK7B,CAAC;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAChF;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;IAAC,SAAS,EAAE,cAAc,EAAE,CAAA;CAAE,GAC/F;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GAC9F;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,cAAc,EAAE,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAYtF,eAAO,MAAM,sBAAsB;;;;;;EAAiG,CAAC;AAErI,eAAO,MAAM,qBAAqB,UAAW,OAAO,KAAG,IAkBtD,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,oBAAoB,gHAGK,CAAC;AAEvC,eAAO,MAAM,yBAAyB;;;;;;;;;;;kBAI3B,CAAC;AACZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,mBAAmB,eAAgB,cAAc,SAAS,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,KAAG,IAUvG,CAAC;AAEF,eAAO,MAAM,0BAA0B,eAAgB,cAAc,KAAG,QAAQ,cAAc,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAIhH,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,kCAAkC,eAAgB,cAAc,KAAG,QAAQ,cAAc,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAqBxH,CAAC"}

package/lib/contracts/page-expression.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectExternalPageExpressionReads = exports.collectPageExpressionReads = exports.visitPageExpression = exports.PagePropertyBindingSchema = exports.PageExpressionSchema = exports.assertPageValueBudget = exports.PAGE_EXPRESSION_LIMITS = exports.PageOperatorSchema = exports.PageExpressionRootSchema = exports.PageValuePathSchema = exports.PageMemberSchema = void 0;
+const zod_1 = require("zod");
+const common_1 = require("./common");
+exports.PageMemberSchema = zod_1.z.string().min(1).max(256).refine((value) => !['__proto__', 'prototype', 'constructor'].includes(value), 'Unsafe Page member.');
+exports.PageValuePathSchema = zod_1.z.array(exports.PageMemberSchema).max(16);
+exports.PageExpressionRootSchema = zod_1.z.enum(['state', 'model', 'bindings', 'scope', 'intent', 'result', 'actions']);
+exports.PageOperatorSchema = zod_1.z.enum([
+    'add', 'subtract', 'multiply', 'divide', 'min', 'max', 'round',
+    'equals', 'not-equals', 'less-than', 'less-or-equal', 'greater-than', 'greater-or-equal',
+    'and', 'or', 'not', 'coalesce', 'concat', 'string', 'number', 'length', 'includes',
+    'get', 'set-path', 'merge', 'entries', 'from-entries', 'array-concat', 'slice', 'trim', 'fixed', 'number-format',
+]);
+const RecursivePageExpressionSchema = zod_1.z.lazy(() => zod_1.z.discriminatedUnion('kind', [
+    zod_1.z.object({ kind: zod_1.z.literal('literal'), value: common_1.JsonValueSchema }).strict(),
+    zod_1.z.object({ kind: zod_1.z.literal('read'), root: exports.PageExpressionRootSchema, path: exports.PageValuePathSchema }).strict(),
+    zod_1.z.object({ kind: zod_1.z.literal('operator'), operator: exports.PageOperatorSchema, arguments: zod_1.z.array(RecursivePageExpressionSchema).min(1).max(32) }).strict(),
+    zod_1.z.object({ kind: zod_1.z.literal('conditional'), condition: RecursivePageExpressionSchema, then: RecursivePageExpressionSchema, else: RecursivePageExpressionSchema }).strict(),
+    zod_1.z.object({ kind: zod_1.z.literal('object'), fields: zod_1.z.record(exports.PageMemberSchema, RecursivePageExpressionSchema) }).strict(),
+    zod_1.z.object({ kind: zod_1.z.literal('array'), items: zod_1.z.array(RecursivePageExpressionSchema).max(1000) }).strict(),
+    ...['map', 'filter', 'sum'].map((kind) => zod_1.z.object({ kind: zod_1.z.literal(kind), source: RecursivePageExpressionSchema, value: RecursivePageExpressionSchema }).strict()),
+]));
+exports.PAGE_EXPRESSION_LIMITS = Object.freeze({ depth: 32, nodes: 4096, operations: 20000, collection: 1000, bytes: 1048576 });
+const assertPageValueBudget = (value) => {
+    const queue = [{ value, depth: 0 }];
+    let nodes = 0;
+    let bytes = 0;
+    while (queue.length) {
+        const item = queue.pop();
+        if (++nodes > exports.PAGE_EXPRESSION_LIMITS.nodes || item.depth > exports.PAGE_EXPRESSION_LIMITS.depth)
+            throw new Error('PAGE_EXPRESSION_BUDGET');
+        if (typeof item.value === 'string')
+            bytes += item.value.length * 2;
+        if (item.value && typeof item.value === 'object') {
+            for (const [key, child] of Object.entries(item.value)) {
+                bytes += key.length * 2;
+                if (['__proto__', 'prototype', 'constructor'].includes(key))
+                    throw new Error('PAGE_EXPRESSION_UNSAFE_PATH');
+                if (queue.length >= exports.PAGE_EXPRESSION_LIMITS.nodes)
+                    throw new Error('PAGE_EXPRESSION_BUDGET');
+                queue.push({ value: child, depth: item.depth + 1 });
+            }
+        }
+        if (bytes > exports.PAGE_EXPRESSION_LIMITS.bytes)
+            throw new Error('PAGE_EXPRESSION_BUDGET');
+    }
+};
+exports.assertPageValueBudget = assertPageValueBudget;
+/** The input guard runs before recursive schema parsing, including direct Page parsing. */
+exports.PageExpressionSchema = zod_1.z.unknown().superRefine((value, context) => {
+    try {
+        (0, exports.assertPageValueBudget)(value);
+    }
+    catch (error) {
+        context.addIssue({ code: 'custom', message: error instanceof Error ? error.message : 'PAGE_EXPRESSION_BUDGET' });
+    }
+}).pipe(RecursivePageExpressionSchema);
+exports.PagePropertyBindingSchema = zod_1.z.object({
+    targetPath: exports.PageValuePathSchema.min(1),
+    expression: exports.PageExpressionSchema,
+    valueType: zod_1.z.enum(['string', 'number', 'boolean', 'object', 'array', 'null']).optional(),
+}).strict();
+const visitPageExpression = (expression, visit) => {
+    visit(expression);
+    switch (expression.kind) {
+        case 'operator':
+            expression.arguments.forEach((node) => (0, exports.visitPageExpression)(node, visit));
+            break;
+        case 'conditional':
+            [expression.condition, expression.then, expression.else].forEach((node) => (0, exports.visitPageExpression)(node, visit));
+            break;
+        case 'object':
+            Object.values(expression.fields).forEach((node) => (0, exports.visitPageExpression)(node, visit));
+            break;
+        case 'array':
+            expression.items.forEach((node) => (0, exports.visitPageExpression)(node, visit));
+            break;
+        case 'map':
+        case 'filter':
+        case 'sum':
+            (0, exports.visitPageExpression)(expression.source, visit);
+            (0, exports.visitPageExpression)(expression.value, visit);
+            break;
+    }
+};
+exports.visitPageExpression = visitPageExpression;
+const collectPageExpressionReads = (expression) => {
+    const reads = [];
+    (0, exports.visitPageExpression)(expression, (node) => { if (node.kind === 'read')
+        reads.push(node); });
+    return reads;
+};
+exports.collectPageExpressionReads = collectPageExpressionReads;
+/** Reads supplied by the caller, excluding lexically bound collection item/index reads. */
+const collectExternalPageExpressionReads = (expression) => {
+    const reads = [];
+    const visit = (node, depth) => {
+        if (node.kind === 'read') {
+            let remaining = depth;
+            let index = 0;
+            while (remaining > 0 && node.path[index] === 'parent') {
+                remaining -= 1;
+                index += 1;
+            }
+            const local = node.root === 'scope' && remaining > 0 && ['item', 'index'].includes(node.path[index]);
+            if (!local)
+                reads.push(node);
+            return;
+        }
+        switch (node.kind) {
+            case 'operator':
+                node.arguments.forEach(child => visit(child, depth));
+                break;
+            case 'conditional':
+                [node.condition, node.then, node.else].forEach(child => visit(child, depth));
+                break;
+            case 'object':
+                Object.values(node.fields).forEach(child => visit(child, depth));
+                break;
+            case 'array':
+                node.items.forEach(child => visit(child, depth));
+                break;
+            case 'map':
+            case 'filter':
+            case 'sum':
+                visit(node.source, depth);
+                visit(node.value, depth + 1);
+                break;
+        }
+    };
+    visit(expression, 0);
+    return reads;
+};
+exports.collectExternalPageExpressionReads = collectExternalPageExpressionReads;
+//# sourceMappingURL=page-expression.js.map

package/lib/contracts/page-expression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-expression.js","sourceRoot":"","sources":["../../src/contracts/page-expression.ts"],"names":[],"mappings":"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"}

package/lib/contracts/page-stream.d.ts

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+/** Draft: no shared exports until server/client fixed-route support is integrated. */
+export declare const PAGE_STREAM_MAX_FRAME_BYTES: number;
+export declare const PAGE_STREAM_MAX_BUFFER_BYTES: number;
+export declare const PAGE_STREAM_MAX_BUFFER_EVENTS = 2048;
+export declare const PAGE_STREAM_MAX_CURSOR_LENGTH = 2048;
+export declare const PAGE_STREAM_MAX_INPUT_BYTES = 8192;
+export declare const PAGE_STREAM_MAX_EVENT_ITEMS = 256;
+/** Opaque handle, never authorization. Server binds principal/team/release/page/binding/scope
+ * and reauthorizes each connect/control. Neither URLs nor caller-authored scope are accepted. */
+export declare const PageStreamDescriptorSchema: z.ZodObject<{
+    contract: z.ZodLiteral<"PageStreamDescriptor">;
+    schemaVersion: z.ZodLiteral<1>;
+    streamId: z.ZodString;
+    expiresAt: z.ZodString;
+    channel: z.ZodEnum<{
+        terminal: "terminal";
+        events: "events";
+    }>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const PageStreamConnectSchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/** First accepted frame must be snapshot. Exact duplicates compare cursor+payload;
+ * conflicting duplicates/gaps reconnect using only last verified cursor. Transport rejects
+ * oversized SSE frames before parsing and bounds retained bytes/events to constants above. */
+export declare const PageStreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"snapshot">;
+    payload: z.ZodObject<{
+        model: z.ZodRecord<z.ZodString, z.ZodType<import("./common").JsonValue, unknown, z.core.$ZodTypeInternals<import("./common").JsonValue, unknown>>>;
+    }, z.core.$strict>;
+    contract: z.ZodLiteral<"PageStreamEvent">;
+    schemaVersion: z.ZodLiteral<1>;
+    streamId: z.ZodString;
+    sequence: z.ZodNumber;
+    cursor: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"delta">;
+    payload: z.ZodObject<{
+        events: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodType<import("./common").JsonValue, unknown, z.core.$ZodTypeInternals<import("./common").JsonValue, unknown>>>>;
+    }, z.core.$strict>;
+    contract: z.ZodLiteral<"PageStreamEvent">;
+    schemaVersion: z.ZodLiteral<1>;
+    streamId: z.ZodString;
+    sequence: z.ZodNumber;
+    cursor: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"end">;
+    payload: z.ZodObject<{}, z.core.$strict>;
+    contract: z.ZodLiteral<"PageStreamEvent">;
+    schemaVersion: z.ZodLiteral<1>;
+    streamId: z.ZodString;
+    sequence: z.ZodNumber;
+    cursor: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    payload: z.ZodObject<{
+        code: z.ZodString;
+        retryable: z.ZodBoolean;
+    }, z.core.$strict>;
+    contract: z.ZodLiteral<"PageStreamEvent">;
+    schemaVersion: z.ZodLiteral<1>;
+    streamId: z.ZodString;
+    sequence: z.ZodNumber;
+    cursor: z.ZodString;
+}, z.core.$strict>], "type">;
+/** Reuse requestId on retries. Server deduplicates before PTY mutation; credentials never
+ * travel in payload. stream.disconnect closes this descriptor lease, not the backing workload. */
+export declare const PageStreamControlSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    requestId: z.ZodString;
+    port: z.ZodLiteral<"terminal.input">;
+    payload: z.ZodObject<{
+        data: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    requestId: z.ZodString;
+    port: z.ZodLiteral<"terminal.resize">;
+    payload: z.ZodObject<{
+        columns: z.ZodNumber;
+        rows: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    requestId: z.ZodString;
+    port: z.ZodLiteral<"stream.disconnect">;
+    payload: z.ZodObject<{}, z.core.$strict>;
+}, z.core.$strict>], "port">;
+export declare const pageStreamRoutes: {
+    readonly events: (releaseSlotId: string, bindingId: string, streamId: string) => string;
+    readonly terminal: (releaseSlotId: string, bindingId: string, streamId: string) => string;
+    readonly control: (releaseSlotId: string, bindingId: string, streamId: string) => string;
+};
+export declare const PageStreamControlResultSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    accepted: z.ZodLiteral<true>;
+}, z.core.$strict>;
+export type PageStreamControlResult = z.infer<typeof PageStreamControlResultSchema>;
+export type PageStreamDescriptor = z.infer<typeof PageStreamDescriptorSchema>;
+export type PageStreamEvent = z.infer<typeof PageStreamEventSchema>;
+export type PageStreamControl = z.infer<typeof PageStreamControlSchema>;
+//# sourceMappingURL=page-stream.d.ts.map

package/lib/contracts/page-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-stream.d.ts","sourceRoot":"","sources":["../../src/contracts/page-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,sFAAsF;AACtF,eAAO,MAAM,2BAA2B,QAAa,CAAC;AACtD,eAAO,MAAM,4BAA4B,QAAkB,CAAC;AAC5D,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAClD,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAClD,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAChD,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAK/C;iGACiG;AACjG,eAAO,MAAM,0BAA0B;;;;;;;;;;kBAI5B,CAAC;AACZ,eAAO,MAAM,uBAAuB;;kBAAyD,CAAC;AAK9F;;8FAE8F;AAC9F,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAQhC,CAAC;AACH;kGACkG;AAClG,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;4BAOlC,CAAC;AAOH,eAAO,MAAM,gBAAgB;qCACH,MAAM,aAAa,MAAM,YAAY,MAAM;uCACzC,MAAM,aAAa,MAAM,YAAY,MAAM;sCAC5C,MAAM,aAAa,MAAM,YAAY,MAAM;CAC5D,CAAC;AACX,eAAO,MAAM,6BAA6B;;;kBAAiF,CAAC;AAC5H,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/lib/contracts/page-stream.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageStreamControlResultSchema = exports.pageStreamRoutes = exports.PageStreamControlSchema = exports.PageStreamEventSchema = exports.PageStreamConnectSchema = exports.PageStreamDescriptorSchema = exports.PAGE_STREAM_MAX_EVENT_ITEMS = exports.PAGE_STREAM_MAX_INPUT_BYTES = exports.PAGE_STREAM_MAX_CURSOR_LENGTH = exports.PAGE_STREAM_MAX_BUFFER_EVENTS = exports.PAGE_STREAM_MAX_BUFFER_BYTES = exports.PAGE_STREAM_MAX_FRAME_BYTES = void 0;
+const zod_1 = require("zod");
+const common_1 = require("./common");
+const declarative_control_http_1 = require("./declarative-control-http");
+/** Draft: no shared exports until server/client fixed-route support is integrated. */
+exports.PAGE_STREAM_MAX_FRAME_BYTES = 256 * 1024;
+exports.PAGE_STREAM_MAX_BUFFER_BYTES = 2 * 1024 * 1024;
+exports.PAGE_STREAM_MAX_BUFFER_EVENTS = 2048;
+exports.PAGE_STREAM_MAX_CURSOR_LENGTH = 2048;
+exports.PAGE_STREAM_MAX_INPUT_BYTES = 8192;
+exports.PAGE_STREAM_MAX_EVENT_ITEMS = 256;
+const StreamIdSchema = zod_1.z.string().min(1).max(256).regex(/^[^\u0000-\u001f\u007f]+$/);
+const CursorSchema = zod_1.z.string().min(1).max(exports.PAGE_STREAM_MAX_CURSOR_LENGTH).regex(/^[^\u0000-\u001f\u007f]+$/);
+const SequenceSchema = zod_1.z.number().int().min(1).max(Number.MAX_SAFE_INTEGER);
+/** Opaque handle, never authorization. Server binds principal/team/release/page/binding/scope
+ * and reauthorizes each connect/control. Neither URLs nor caller-authored scope are accepted. */
+exports.PageStreamDescriptorSchema = zod_1.z.object({
+    contract: zod_1.z.literal('PageStreamDescriptor'), schemaVersion: zod_1.z.literal(1),
+    streamId: StreamIdSchema, expiresAt: common_1.IsoDateTimeSchema,
+    channel: zod_1.z.enum(['terminal', 'events']), cursor: CursorSchema.optional(),
+}).strict();
+exports.PageStreamConnectSchema = zod_1.z.object({ cursor: CursorSchema.optional() }).strict();
+const base = {
+    contract: zod_1.z.literal('PageStreamEvent'), schemaVersion: zod_1.z.literal(1),
+    streamId: StreamIdSchema, sequence: SequenceSchema, cursor: CursorSchema,
+};
+/** First accepted frame must be snapshot. Exact duplicates compare cursor+payload;
+ * conflicting duplicates/gaps reconnect using only last verified cursor. Transport rejects
+ * oversized SSE frames before parsing and bounds retained bytes/events to constants above. */
+exports.PageStreamEventSchema = zod_1.z.discriminatedUnion('type', [
+    zod_1.z.object({ ...base, type: zod_1.z.literal('snapshot'), payload: zod_1.z.object({ model: common_1.JsonObjectSchema }).strict() }).strict(),
+    zod_1.z.object({ ...base, type: zod_1.z.literal('delta'), payload: zod_1.z.object({ events: zod_1.z.array(common_1.JsonObjectSchema).max(exports.PAGE_STREAM_MAX_EVENT_ITEMS) }).strict() }).strict(),
+    zod_1.z.object({ ...base, type: zod_1.z.literal('end'), payload: zod_1.z.object({}).strict() }).strict(),
+    zod_1.z.object({ ...base, type: zod_1.z.literal('error'), payload: zod_1.z.object({ code: zod_1.z.string().min(1).max(128), retryable: zod_1.z.boolean() }).strict() }).strict(),
+]).superRefine((value, context) => {
+    if (new TextEncoder().encode(JSON.stringify(value)).byteLength > exports.PAGE_STREAM_MAX_FRAME_BYTES)
+        context.addIssue({ code: 'custom', message: 'Page stream frame exceeds the UTF-8 byte limit.' });
+});
+/** Reuse requestId on retries. Server deduplicates before PTY mutation; credentials never
+ * travel in payload. stream.disconnect closes this descriptor lease, not the backing workload. */
+exports.PageStreamControlSchema = zod_1.z.discriminatedUnion('port', [
+    zod_1.z.object({ requestId: zod_1.z.string().uuid(), port: zod_1.z.literal('terminal.input'), payload: zod_1.z.object({ data: zod_1.z.string().min(1).max(exports.PAGE_STREAM_MAX_INPUT_BYTES) }).strict() }).strict(),
+    zod_1.z.object({ requestId: zod_1.z.string().uuid(), port: zod_1.z.literal('terminal.resize'), payload: zod_1.z.object({ columns: zod_1.z.number().int().min(1).max(1000), rows: zod_1.z.number().int().min(1).max(1000) }).strict() }).strict(),
+    zod_1.z.object({ requestId: zod_1.z.string().uuid(), port: zod_1.z.literal('stream.disconnect'), payload: zod_1.z.object({}).strict() }).strict(),
+]).superRefine((value, context) => {
+    if (value.port === 'terminal.input' && new TextEncoder().encode(value.payload.data).byteLength > exports.PAGE_STREAM_MAX_INPUT_BYTES)
+        context.addIssue({ code: 'custom', path: ['payload', 'data'], message: 'Terminal input exceeds the UTF-8 byte limit.' });
+});
+const route = (releaseSlotId, bindingId, streamId) => {
+    StreamIdSchema.parse(streamId);
+    if (streamId === '.' || streamId === '..')
+        throw new TypeError('Invalid stream route identifier');
+    for (const segment of [releaseSlotId, bindingId])
+        if (!segment || segment.length > 256 || /[\u0000-\u001f\u007f]/.test(segment) || segment === '.' || segment === '..')
+            throw new TypeError('Invalid stream route identifier');
+    return `${declarative_control_http_1.DECLARATIVE_CONTROL_API_PREFIX}/runtime/pages/${encodeURIComponent(releaseSlotId)}/bindings/${encodeURIComponent(bindingId)}/streams/${encodeURIComponent(streamId)}`;
+};
+exports.pageStreamRoutes = {
+    events: (releaseSlotId, bindingId, streamId) => `${route(releaseSlotId, bindingId, streamId)}/events`,
+    terminal: (releaseSlotId, bindingId, streamId) => `${route(releaseSlotId, bindingId, streamId)}/terminal`,
+    control: (releaseSlotId, bindingId, streamId) => `${route(releaseSlotId, bindingId, streamId)}/control`,
+};
+exports.PageStreamControlResultSchema = zod_1.z.object({ requestId: zod_1.z.string().uuid(), accepted: zod_1.z.literal(true) }).strict();
+//# sourceMappingURL=page-stream.js.map

package/lib/contracts/page-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-stream.js","sourceRoot":"","sources":["../../src/contracts/page-stream.ts"],"names":[],"mappings":"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"}

package/lib/contracts/page.d.ts

@@ -84,6 +84,18 @@ export declare const PageDefinitionSchema: z.ZodObject<{
     }>;
     routeId: z.ZodString;
     routePath: z.ZodString;
+    legacyRoutePolicy: z.ZodOptional<z.ZodObject<{
+        contract: z.ZodLiteral<"LegacyRoutePolicy">;
+        schemaVersion: z.ZodLiteral<1>;
+        fallback: z.ZodEnum<{
+            allowed: "allowed";
+            forbidden: "forbidden";
+        }>;
+        restoration: z.ZodEnum<{
+            allowed: "allowed";
+            forbidden: "forbidden";
+        }>;
+    }, z.core.$strict>>;
     rendererKey: z.ZodString;
     capabilityRef: z.ZodObject<{
         kind: z.ZodString;
@@ -198,6 +210,18 @@ export declare const PageRuntimeDescriptorSchema: z.ZodObject<{
         }>;
         routeId: z.ZodString;
         routePath: z.ZodString;
+        legacyRoutePolicy: z.ZodOptional<z.ZodObject<{
+            contract: z.ZodLiteral<"LegacyRoutePolicy">;
+            schemaVersion: z.ZodLiteral<1>;
+            fallback: z.ZodEnum<{
+                allowed: "allowed";
+                forbidden: "forbidden";
+            }>;
+            restoration: z.ZodEnum<{
+                allowed: "allowed";
+                forbidden: "forbidden";
+            }>;
+        }, z.core.$strict>>;
         rendererKey: z.ZodString;
         capabilityRef: z.ZodObject<{
             kind: z.ZodString;

package/lib/contracts/page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/contracts/page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;EAoBzB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;kBAQtB,CAAC;AAEZ,eAAO,MAAM,mBAAmB,aAGqC,CAAC;AA8BtE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA4E7B,CAAC;AAEL,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmC7B,CAAC;AAEZ,eAAO,MAAM,yBAAyB;;;;kBAI3B,CAAC;AAEZ,eAAO,MAAM,8BAA8B;;;;;;;;;kBAShC,CAAC;AAEZ,eAAO,MAAM,yBAAyB;;;;;;;;;;;;kBAO3B,CAAC;AAEZ,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAuCrC,CAAC;AAeL,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgEpC,CAAC;AAEL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/contracts/page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;EAoBzB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;kBAQtB,CAAC;AAEZ,eAAO,MAAM,mBAAmB,aAGqC,CAAC;AA8BtE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA6E7B,CAAC;AAEL,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmC7B,CAAC;AAEZ,eAAO,MAAM,yBAAyB;;;;kBAI3B,CAAC;AAEZ,eAAO,MAAM,8BAA8B;;;;;;;;;kBAShC,CAAC;AAEZ,eAAO,MAAM,yBAAyB;;;;;;;;;;;;kBAO3B,CAAC;AAEZ,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAuCrC,CAAC;AAeL,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAgEpC,CAAC;AAEL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAClF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

package/lib/contracts/page.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PageRuntimeProjectionSchema = exports.PageRendererProjectionSchema = exports.PageGuardProjectionSchema = exports.PageNavigationProjectionSchema = exports.PageRouteProjectionSchema = exports.PageRuntimeDescriptorSchema = exports.PageDefinitionSchema = exports.PageRoutePathSchema = exports.PageVisibilitySchema = exports.PageTypeSchema = void 0;
 const zod_1 = require("zod");
 const common_1 = require("./common");
+const legacy_route_1 = require("./legacy-route");
 exports.PageTypeSchema = zod_1.z.enum([
     'page',
     'workspace',
@@ -81,6 +82,7 @@ exports.PageDefinitionSchema = zod_1.z
     surface: zod_1.z.enum(['page', 'workspace', 'view', 'record', 'action', 'overlay', 'agent']),
     routeId: common_1.ContractIdentifierSchema,
     routePath: exports.PageRoutePathSchema,
+    legacyRoutePolicy: legacy_route_1.LegacyRoutePolicySchema.optional(),
     rendererKey: common_1.ContractIdentifierSchema,
     capabilityRef: common_1.EntityRefSchema,
     capabilityRefs: zod_1.z.array(common_1.EntityRefSchema).default([]),