@north-light/crouter 0.3.192 → 0.3.193

package/dist/core/human/deck-schema.d.ts

@@ -1,70 +0,0 @@
-import { z } from 'zod';
-import type { Deck, ReviewDescriptor } from './types.js';
-export declare const interactionOptionSchema: z.ZodObject<{
-    id: z.ZodString;
-    label: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare const preAnswerSchema: z.ZodObject<{
-    selectedOptionId: z.ZodOptional<z.ZodString>;
-    selectedOptionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    freetext: z.ZodOptional<z.ZodString>;
-    label: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare const deckSchema: z.ZodObject<{
-    title: z.ZodString;
-    source: z.ZodOptional<z.ZodObject<{
-        sessionName: z.ZodOptional<z.ZodString>;
-        askedBy: z.ZodOptional<z.ZodString>;
-        blockedSince: z.ZodOptional<z.ZodString>;
-        nodeId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    interactions: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        title: z.ZodString;
-        subtitle: z.ZodString;
-        body: z.ZodOptional<z.ZodString>;
-        bodyPath: z.ZodOptional<z.ZodString>;
-        options: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            label: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
-        multiSelect: z.ZodOptional<z.ZodBoolean>;
-        allowFreetext: z.ZodOptional<z.ZodBoolean>;
-        freetextLabel: z.ZodOptional<z.ZodString>;
-        kind: z.ZodOptional<z.ZodEnum<{
-            error: "error";
-            context: "context";
-            notify: "notify";
-            review: "review";
-            decision: "decision";
-        }>>;
-        preAnswered: z.ZodOptional<z.ZodObject<{
-            selectedOptionId: z.ZodOptional<z.ZodString>;
-            selectedOptionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            freetext: z.ZodOptional<z.ZodString>;
-            label: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export declare const reviewDescriptorSchema: z.ZodObject<{
-    schema: z.ZodLiteral<"humanloop.review/v1">;
-    file: z.ZodString;
-    output: z.ZodString;
-    title: z.ZodString;
-    subtitle: z.ZodString;
-    source: z.ZodObject<{
-        sessionName: z.ZodOptional<z.ZodString>;
-        askedBy: z.ZodOptional<z.ZodString>;
-        blockedSince: z.ZodOptional<z.ZodString>;
-        nodeId: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-    blockedSince: z.ZodString;
-}, z.core.$strict>;
-export declare function resolveDeckBodyPaths(deck: Deck, dir: string): Deck;
-export declare function parseDeck(path: string): Deck;
-export declare function validateDeck(parsed: unknown): Deck;
-export declare function validateReviewDescriptor(parsed: unknown): ReviewDescriptor;
-/** Canonicalize and authorize the one review projection boundary before every write. */
-export declare function validateReviewProjection(dir: string, parsed: unknown): ReviewDescriptor;

package/dist/core/human/deck-schema.js

@@ -1,92 +0,0 @@
-import { existsSync, lstatSync, readFileSync, realpathSync } from 'node:fs';
-import { basename, dirname, isAbsolute, resolve, sep } from 'node:path';
-import { claimPath, deckPath, progressPath, responsePath, reviewPath } from './convention.js';
-import { z } from 'zod';
-import { INTERACTION_KINDS } from './types.js';
-import { checkMarkdown } from '../termrender/termrender.js';
-import { checkReviewableFile } from './visible-paths.js';
-export const interactionOptionSchema = z.object({ id: z.string().min(1), label: z.string().min(1), description: z.string().optional() });
-export const preAnswerSchema = z.object({ selectedOptionId: z.string().optional(), selectedOptionIds: z.array(z.string()).optional(), freetext: z.string().optional(), label: z.string().optional() });
-const interactionSchema = z.object({
-    id: z.string().regex(/^[A-Za-z0-9_-]+$/, { error: 'interaction id must match /^[A-Za-z0-9_-]+$/' }).min(1).max(64),
-    title: z.string().trim().min(1), subtitle: z.string().trim().min(1), body: z.string().optional(), bodyPath: z.string().optional(),
-    options: z.array(interactionOptionSchema), multiSelect: z.boolean().optional(), allowFreetext: z.boolean().optional(), freetextLabel: z.string().optional(), kind: z.enum(INTERACTION_KINDS).optional(), preAnswered: preAnswerSchema.optional(),
-});
-const deckSourceSchema = z.object({ sessionName: z.string().optional(), askedBy: z.string().optional(), blockedSince: z.string().optional(), nodeId: z.string().optional() });
-export const deckSchema = z.object({ title: z.string().trim().min(1), source: deckSourceSchema.optional(), interactions: z.array(interactionSchema).min(1) }).superRefine((input, ctx) => {
-    const seen = new Set();
-    input.interactions.forEach((interaction, index) => {
-        if (interaction.body !== undefined && interaction.bodyPath !== undefined)
-            ctx.addIssue({ code: 'custom', message: 'body and bodyPath are mutually exclusive', path: ['interactions', index] });
-        if (seen.has(interaction.id))
-            ctx.addIssue({ code: 'custom', message: `duplicate interaction id "${interaction.id}"`, path: ['interactions', index, 'id'] });
-        seen.add(interaction.id);
-    });
-});
-const reviewSourceSchema = deckSourceSchema;
-export const reviewDescriptorSchema = z.object({
-    schema: z.literal('humanloop.review/v1'),
-    file: z.string().min(1).refine(isAbsolute, 'file must be absolute'),
-    output: z.string().min(1).refine(isAbsolute, 'output must be absolute'),
-    title: z.string().trim().min(1),
-    subtitle: z.string().trim().min(1),
-    source: reviewSourceSchema,
-    blockedSince: z.string().datetime({ offset: true }),
-}).strict();
-function readBodyPathFile(dir, bodyPath) {
-    const joined = resolve(dir, bodyPath);
-    if (!existsSync(joined))
-        throw new Error(`bodyPath does not exist: '${bodyPath}'`);
-    if (!lstatSync(joined).isFile())
-        throw new Error(`bodyPath must be a regular file: ${bodyPath}`);
-    const realResolved = realpathSync(joined);
-    const realDeckDir = realpathSync(dir);
-    if (!realResolved.startsWith(realDeckDir + sep))
-        throw new Error(`bodyPath '${bodyPath}' escapes the deck directory`);
-    return readFileSync(joined, 'utf8');
-}
-export function resolveDeckBodyPaths(deck, dir) {
-    return { ...deck, interactions: deck.interactions.map((interaction) => {
-            if (interaction.bodyPath === undefined)
-                return interaction;
-            const { bodyPath: _bodyPath, ...rest } = interaction;
-            return { ...rest, body: readBodyPathFile(dir, interaction.bodyPath) };
-        }) };
-}
-export function parseDeck(path) {
-    let raw;
-    try {
-        raw = JSON.parse(readFileSync(path, 'utf8'));
-    }
-    catch {
-        throw new Error('deck is not valid JSON');
-    }
-    const deck = resolveDeckBodyPaths(deckSchema.parse(raw), dirname(path));
-    for (const interaction of deck.interactions)
-        if (interaction.body !== undefined) {
-            const check = checkMarkdown(interaction.body);
-            if (!check.ok)
-                throw new Error(check.error);
-        }
-    return deck;
-}
-export function validateDeck(parsed) { return deckSchema.parse(parsed); }
-export function validateReviewDescriptor(parsed) { return reviewDescriptorSchema.parse(parsed); }
-/** Canonicalize and authorize the one review projection boundary before every write. */
-export function validateReviewProjection(dir, parsed) {
-    const descriptor = validateReviewDescriptor(parsed);
-    // Any reviewable UTF-8 text file: a .md artifact renders as a document, a
-    // source file as a syntax-highlighted code panel.
-    if (!existsSync(descriptor.file))
-        throw new Error('review file must be an existing absolute path');
-    const reviewable = checkReviewableFile(descriptor.file);
-    if (!reviewable.ok)
-        throw new Error(`review file is not reviewable: ${reviewable.reason}`);
-    const file = realpathSync(descriptor.file);
-    const output = resolve(realpathSync(dirname(descriptor.output)), basename(descriptor.output));
-    const reserved = new Set(['deck.json', 'review.json', 'response.json', 'progress.json', 'claim.json']);
-    const ownProtocolPaths = new Set([deckPath(dir), reviewPath(dir), responsePath(dir), progressPath(dir), claimPath(dir)]);
-    if (output === file || reserved.has(basename(output)) || ownProtocolPaths.has(output))
-        throw new Error('review output must not alias the source or ticket protocol files');
-    return { ...descriptor, file, output };
-}