clinkx 0.3.0 → 1.1.0

package/clinkx-workflows/dist/dashboard/progress-report-status-overlay.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Pure last-writer overlay for dashboard-only progress-report status pins.
+ *
+ * The producer document is never consulted here. A pin dies when published
+ * `updatedAt` is strictly newer than `setAt`, or when `startedAt` does not
+ * bind, or when the pin would not change the published status.
+ */
+import { z } from "zod";
+export declare const PROGRESS_REPORT_STATUSES: readonly ["running", "paused", "blocked", "done", "failed"];
+export type ProgressReportStatus = (typeof PROGRESS_REPORT_STATUSES)[number];
+export declare const ProgressReportStatusSchema: z.ZodEnum<["running", "paused", "blocked", "done", "failed"]>;
+export declare const PROGRESS_REPORT_STATUS_OVERRIDE_SCHEMA_VERSION: "progress-report-status-overrides-v1";
+export declare const PROGRESS_REPORT_STATUS_OVERRIDE_FILENAME = "progress-report-status-overrides.json";
+export declare const PROGRESS_REPORT_STATUS_OVERRIDE_SEGMENT = "status-override";
+export declare const ProgressReportStatusOverrideEntrySchema: z.ZodObject<{
+    startedAt: z.ZodEffects<z.ZodString, string, string>;
+    status: z.ZodEnum<["running", "paused", "blocked", "done", "failed"]>;
+    setAt: z.ZodEffects<z.ZodString, string, string>;
+}, "strict", z.ZodTypeAny, {
+    status: "running" | "failed" | "paused" | "blocked" | "done";
+    startedAt: string;
+    setAt: string;
+}, {
+    status: "running" | "failed" | "paused" | "blocked" | "done";
+    startedAt: string;
+    setAt: string;
+}>;
+export type ProgressReportStatusOverrideEntry = z.infer<typeof ProgressReportStatusOverrideEntrySchema>;
+export declare const ProgressReportStatusOverrideDocumentSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"progress-report-status-overrides-v1">;
+    entries: z.ZodRecord<z.ZodString, z.ZodObject<{
+        startedAt: z.ZodEffects<z.ZodString, string, string>;
+        status: z.ZodEnum<["running", "paused", "blocked", "done", "failed"]>;
+        setAt: z.ZodEffects<z.ZodString, string, string>;
+    }, "strict", z.ZodTypeAny, {
+        status: "running" | "failed" | "paused" | "blocked" | "done";
+        startedAt: string;
+        setAt: string;
+    }, {
+        status: "running" | "failed" | "paused" | "blocked" | "done";
+        startedAt: string;
+        setAt: string;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    entries: Record<string, {
+        status: "running" | "failed" | "paused" | "blocked" | "done";
+        startedAt: string;
+        setAt: string;
+    }>;
+    schemaVersion: "progress-report-status-overrides-v1";
+}, {
+    entries: Record<string, {
+        status: "running" | "failed" | "paused" | "blocked" | "done";
+        startedAt: string;
+        setAt: string;
+    }>;
+    schemaVersion: "progress-report-status-overrides-v1";
+}>;
+export type ProgressReportStatusOverrideDocument = z.infer<typeof ProgressReportStatusOverrideDocumentSchema>;
+export declare const ProgressReportStatusOverrideRequestSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
+    action: z.ZodLiteral<"set">;
+    status: z.ZodEnum<["running", "paused", "blocked", "done", "failed"]>;
+}, "strict", z.ZodTypeAny, {
+    status: "running" | "failed" | "paused" | "blocked" | "done";
+    action: "set";
+}, {
+    status: "running" | "failed" | "paused" | "blocked" | "done";
+    action: "set";
+}>, z.ZodObject<{
+    action: z.ZodLiteral<"revert">;
+}, "strict", z.ZodTypeAny, {
+    action: "revert";
+}, {
+    action: "revert";
+}>]>;
+export type ProgressReportStatusOverrideRequest = z.infer<typeof ProgressReportStatusOverrideRequestSchema>;
+export declare const PROGRESS_REPORT_STATUS_OVERRIDE_PATH_PATTERN: RegExp;
+export declare function progressReportStatusOverridePath(sessionId: string): string;
+export declare function isProgressReportStatusOverrideApiPath(path: string): boolean;
+export declare function isProgressReportStatusOverrideSegments(segments: readonly string[]): boolean;
+export type OverlayApplyResult = Readonly<{
+    status: ProgressReportStatus;
+    publishedStatus?: ProgressReportStatus;
+}>;
+export declare function applyProgressReportStatusOverlay(published: Readonly<{
+    status: ProgressReportStatus;
+    startedAt: string;
+    updatedAt: string;
+}>, entry: ProgressReportStatusOverrideEntry | undefined): OverlayApplyResult;

package/clinkx-workflows/dist/dashboard/progress-report-status-overlay.js

@@ -0,0 +1,71 @@
+/**
+ * Pure last-writer overlay for dashboard-only progress-report status pins.
+ *
+ * The producer document is never consulted here. A pin dies when published
+ * `updatedAt` is strictly newer than `setAt`, or when `startedAt` does not
+ * bind, or when the pin would not change the published status.
+ */
+import { z } from "zod";
+import { ProgressReportSessionIdSchema, StrictRfc3339TimestampSchema, } from "./progress-report-contract.js";
+export const PROGRESS_REPORT_STATUSES = [
+    "running",
+    "paused",
+    "blocked",
+    "done",
+    "failed",
+];
+export const ProgressReportStatusSchema = z.enum(PROGRESS_REPORT_STATUSES);
+export const PROGRESS_REPORT_STATUS_OVERRIDE_SCHEMA_VERSION = "progress-report-status-overrides-v1";
+export const PROGRESS_REPORT_STATUS_OVERRIDE_FILENAME = "progress-report-status-overrides.json";
+export const PROGRESS_REPORT_STATUS_OVERRIDE_SEGMENT = "status-override";
+export const ProgressReportStatusOverrideEntrySchema = z.object({
+    startedAt: StrictRfc3339TimestampSchema,
+    status: ProgressReportStatusSchema,
+    setAt: StrictRfc3339TimestampSchema,
+}).strict();
+export const ProgressReportStatusOverrideDocumentSchema = z.object({
+    schemaVersion: z.literal(PROGRESS_REPORT_STATUS_OVERRIDE_SCHEMA_VERSION),
+    entries: z.record(ProgressReportSessionIdSchema, ProgressReportStatusOverrideEntrySchema),
+}).strict();
+export const ProgressReportStatusOverrideRequestSchema = z.discriminatedUnion("action", [
+    z.object({
+        action: z.literal("set"),
+        status: ProgressReportStatusSchema,
+    }).strict(),
+    z.object({
+        action: z.literal("revert"),
+    }).strict(),
+]);
+export const PROGRESS_REPORT_STATUS_OVERRIDE_PATH_PATTERN = /^\/api\/progress-reports\/[A-Za-z0-9][A-Za-z0-9_-]{0,63}\/status-override$/;
+export function progressReportStatusOverridePath(sessionId) {
+    return `/api/progress-reports/${sessionId}/${PROGRESS_REPORT_STATUS_OVERRIDE_SEGMENT}`;
+}
+export function isProgressReportStatusOverrideApiPath(path) {
+    return PROGRESS_REPORT_STATUS_OVERRIDE_PATH_PATTERN.test(path);
+}
+export function isProgressReportStatusOverrideSegments(segments) {
+    return segments.length === 4 &&
+        segments[0] === "api" &&
+        segments[1] === "progress-reports" &&
+        (segments[2]?.length ?? 0) > 0 &&
+        ProgressReportSessionIdSchema.safeParse(segments[2]).success &&
+        segments[3] === PROGRESS_REPORT_STATUS_OVERRIDE_SEGMENT;
+}
+export function applyProgressReportStatusOverlay(published, entry) {
+    if (entry === undefined)
+        return { status: published.status };
+    if (entry.startedAt !== published.startedAt) {
+        return { status: published.status };
+    }
+    const publishedMs = Date.parse(published.updatedAt);
+    const setAtMs = Date.parse(entry.setAt);
+    if (!Number.isFinite(publishedMs) || !Number.isFinite(setAtMs)) {
+        return { status: published.status };
+    }
+    if (publishedMs > setAtMs)
+        return { status: published.status };
+    if (entry.status === published.status)
+        return { status: published.status };
+    return { status: entry.status, publishedStatus: published.status };
+}
+//# sourceMappingURL=progress-report-status-overlay.js.map

package/clinkx-workflows/dist/dashboard/progress-report-status-overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-report-status-overlay.js","sourceRoot":"","sources":["../../src/dashboard/progress-report-status-overlay.ts"],"names":[],"mappings":"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"}

package/clinkx-workflows/dist/dashboard/progress-report-status-store.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Bounded sidecar store for dashboard-only progress-report status pins.
+ *
+ * Lives beside `progress-reports/`, never inside a session directory.
+ * Reads fail closed to an empty map. Writes use wx+0o600+rename.
+ */
+import { type ProgressReportStatus, type ProgressReportStatusOverrideEntry, type ProgressReportStatusOverrideRequest } from "./progress-report-status-overlay.js";
+export declare const MAX_PROGRESS_REPORT_STATUS_OVERRIDE_BYTES: number;
+export type ProgressReportStatusOverrideMap = ReadonlyMap<string, ProgressReportStatusOverrideEntry>;
+export type ProgressReportStatusOverrideWriteOutcome = Readonly<{
+    kind: "ok";
+}> | Readonly<{
+    kind: "unwritable";
+}> | Readonly<{
+    kind: "too_large";
+}>;
+export interface ProgressReportStatusOverrideStore {
+    readonly read: (progressReportsRoot: string) => Promise<ProgressReportStatusOverrideMap>;
+    readonly write: (progressReportsRoot: string, sessionId: string, request: ProgressReportStatusOverrideRequest, session: Readonly<{
+        status: ProgressReportStatus;
+        startedAt: string;
+        updatedAt: string;
+    }>) => Promise<ProgressReportStatusOverrideWriteOutcome>;
+}
+export declare function progressReportStatusOverrideFilePath(progressReportsRoot: string, parentDir?: string): string;
+export declare function createProgressReportStatusOverrideStore(options?: Readonly<{
+    now?: (() => Date) | undefined;
+    parentDir?: string | undefined;
+}>): ProgressReportStatusOverrideStore;

package/clinkx-workflows/dist/dashboard/progress-report-status-store.js

@@ -0,0 +1,111 @@
+/**
+ * Bounded sidecar store for dashboard-only progress-report status pins.
+ *
+ * Lives beside `progress-reports/`, never inside a session directory.
+ * Reads fail closed to an empty map. Writes use wx+0o600+rename.
+ */
+import { randomBytes } from "node:crypto";
+import { open, rename, unlink } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { z } from "zod";
+import { ContainedFileTooLargeError, readContainedRelativeFile, } from "../contained-file.js";
+import { PROGRESS_REPORT_STATUS_OVERRIDE_FILENAME, PROGRESS_REPORT_STATUS_OVERRIDE_SCHEMA_VERSION, ProgressReportStatusOverrideDocumentSchema, } from "./progress-report-status-overlay.js";
+export const MAX_PROGRESS_REPORT_STATUS_OVERRIDE_BYTES = 256 * 1024;
+export function progressReportStatusOverrideFilePath(progressReportsRoot, parentDir = dirname(progressReportsRoot)) {
+    return join(parentDir, PROGRESS_REPORT_STATUS_OVERRIDE_FILENAME);
+}
+export function createProgressReportStatusOverrideStore(options = {}) {
+    const now = options.now ?? (() => new Date());
+    const resolveParent = (progressReportsRoot) => options.parentDir ?? dirname(progressReportsRoot);
+    let writeChain = Promise.resolve();
+    const read = async (progressReportsRoot) => {
+        const parent = resolveParent(progressReportsRoot);
+        try {
+            const result = await readContainedRelativeFile(parent, PROGRESS_REPORT_STATUS_OVERRIDE_FILENAME, {
+                containerLabel: "progress-report override parent",
+                pathLabel: "progress report status override",
+                maxBytes: MAX_PROGRESS_REPORT_STATUS_OVERRIDE_BYTES,
+                requireRegular: true,
+                requireExactRequestedPath: true,
+                wantContent: true,
+            });
+            if (result.content === undefined)
+                return new Map();
+            const parsed = ProgressReportStatusOverrideDocumentSchema.safeParse(JSON.parse(result.content));
+            if (!parsed.success)
+                return new Map();
+            return new Map(Object.entries(parsed.data.entries));
+        }
+        catch (error) {
+            if (error instanceof SyntaxError)
+                return new Map();
+            if (error instanceof ContainedFileTooLargeError)
+                return new Map();
+            if (error instanceof z.ZodError)
+                return new Map();
+            const code = error.code;
+            if (code === "ENOENT")
+                return new Map();
+            return new Map();
+        }
+    };
+    const publish = async (progressReportsRoot, document) => {
+        const parent = resolveParent(progressReportsRoot);
+        const filePath = progressReportStatusOverrideFilePath(progressReportsRoot, parent);
+        const serialized = `${JSON.stringify(document)}\n`;
+        if (Buffer.byteLength(serialized, "utf8") > MAX_PROGRESS_REPORT_STATUS_OVERRIDE_BYTES) {
+            return { kind: "too_large" };
+        }
+        const temporaryPath = join(parent, `.${PROGRESS_REPORT_STATUS_OVERRIDE_FILENAME}.${String(process.pid)}.${randomBytes(8).toString("hex")}.tmp`);
+        let handle;
+        try {
+            handle = await open(temporaryPath, "wx", 0o600);
+            await handle.writeFile(serialized, "utf8");
+            await handle.sync();
+            await handle.close();
+            handle = undefined;
+            await rename(temporaryPath, filePath);
+            return { kind: "ok" };
+        }
+        catch (error) {
+            if (handle !== undefined)
+                await handle.close().catch(() => undefined);
+            await unlink(temporaryPath).catch(() => undefined);
+            const code = error.code;
+            if (code === "EACCES" || code === "EROFS" || code === "ENOENT" || code === "EPERM") {
+                return { kind: "unwritable" };
+            }
+            throw error;
+        }
+    };
+    const write = (progressReportsRoot, sessionId, request, session) => {
+        const run = async () => {
+            const current = await read(progressReportsRoot);
+            const entries = {};
+            for (const [id, entry] of current) {
+                if (id === sessionId)
+                    continue;
+                entries[id] = entry;
+            }
+            if (request.action === "set") {
+                entries[sessionId] = {
+                    startedAt: session.startedAt,
+                    status: request.status,
+                    setAt: now().toISOString(),
+                };
+            }
+            else if (current.size === 0 || !current.has(sessionId)) {
+                return { kind: "ok" };
+            }
+            return publish(progressReportsRoot, {
+                schemaVersion: PROGRESS_REPORT_STATUS_OVERRIDE_SCHEMA_VERSION,
+                entries,
+            });
+        };
+        const queued = writeChain.then(run, run);
+        writeChain = queued.then(() => undefined, () => undefined);
+        return queued;
+    };
+    return { read, write };
+}
+//# sourceMappingURL=progress-report-status-store.js.map

package/clinkx-workflows/dist/dashboard/progress-report-status-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-report-status-store.js","sourceRoot":"","sources":["../../src/dashboard/progress-report-status-store.ts"],"names":[],"mappings":"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"}

package/clinkx-workflows/dist/dashboard/prompt-builder-library-contract.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Dashboard-private prompt-builder library wire and disk contract.
+ *
+ * The sidecar is never an execution input. Paths are literals so the
+ * companion/gateway POST allowlist can match with exact equality.
+ */
+import { z } from "zod";
+export declare const PROMPT_BUILDER_LIBRARY_SCHEMA_VERSION: "prompt-builder-library-v1";
+export declare const PROMPT_BUILDER_LIBRARY_RESPONSE_SCHEMA_VERSION: "prompt-builder-library-response-v1";
+export declare const PROMPT_BUILDER_LIBRARY_FILENAME = "prompt-builder-library.json";
+export declare const PROMPT_BUILDER_LIBRARY_READ_PATH = "/api/prompt-builder/library";
+export declare const PROMPT_BUILDER_LIBRARY_SAVE_PATH = "/api/prompt-builder/library/save";
+export declare const MAX_PROMPT_BUILDER_LIBRARY_DOCUMENT_BYTES: number;
+export declare const MAX_PROMPT_BUILDER_LIBRARY_BODY_BYTES: number;
+export declare const MAX_PROMPT_BUILDER_LIBRARY_READ_BYTES: number;
+export declare const MAX_PROMPT_BUILDER_LIBRARY_CLI_KEYS = 32;
+export declare const MAX_PROMPT_BUILDER_LIBRARY_MODELS_PER_CLI = 64;
+export declare const MAX_PROMPT_BUILDER_LIBRARY_REQUESTS = 64;
+export declare const MAX_PROMPT_BUILDER_LIBRARY_STANCES = 64;
+export declare const PromptBuilderLibraryModelsSchema: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>, Record<string, string[]>, Record<string, string[]>>;
+export declare const PromptBuilderLibraryRequestSchema: z.ZodObject<{
+    name: z.ZodString;
+    text: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    text: string;
+}, {
+    name: string;
+    text: string;
+}>;
+export declare const PromptBuilderLibrarySaveRequestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"prompt-builder-library-v1">;
+    models: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>, Record<string, string[]>, Record<string, string[]>>;
+    requests: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        text: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        text: string;
+    }, {
+        name: string;
+        text: string;
+    }>, "many">;
+    stances: z.ZodArray<z.ZodString, "many">;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: "prompt-builder-library-v1";
+    requests: {
+        name: string;
+        text: string;
+    }[];
+    models: Record<string, string[]>;
+    stances: string[];
+}, {
+    schemaVersion: "prompt-builder-library-v1";
+    requests: {
+        name: string;
+        text: string;
+    }[];
+    models: Record<string, string[]>;
+    stances: string[];
+}>;
+export type PromptBuilderLibrarySaveRequest = z.infer<typeof PromptBuilderLibrarySaveRequestSchema>;
+export declare const PromptBuilderLibraryDocumentSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"prompt-builder-library-v1">;
+    models: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>, Record<string, string[]>, Record<string, string[]>>;
+    requests: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        text: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        text: string;
+    }, {
+        name: string;
+        text: string;
+    }>, "many">;
+    stances: z.ZodArray<z.ZodString, "many">;
+} & {
+    updatedAt: z.ZodEffects<z.ZodString, string, string>;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: "prompt-builder-library-v1";
+    requests: {
+        name: string;
+        text: string;
+    }[];
+    updatedAt: string;
+    models: Record<string, string[]>;
+    stances: string[];
+}, {
+    schemaVersion: "prompt-builder-library-v1";
+    requests: {
+        name: string;
+        text: string;
+    }[];
+    updatedAt: string;
+    models: Record<string, string[]>;
+    stances: string[];
+}>;
+export type PromptBuilderLibraryDocument = z.infer<typeof PromptBuilderLibraryDocumentSchema>;
+export declare const PromptBuilderLibraryGetResponseSchema: z.ZodDiscriminatedUnion<"state", [z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"prompt-builder-library-response-v1">;
+    state: z.ZodLiteral<"absent">;
+    serverNow: z.ZodEffects<z.ZodString, string, string>;
+}, "strict", z.ZodTypeAny, {
+    state: "absent";
+    schemaVersion: "prompt-builder-library-response-v1";
+    serverNow: string;
+}, {
+    state: "absent";
+    schemaVersion: "prompt-builder-library-response-v1";
+    serverNow: string;
+}>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"prompt-builder-library-response-v1">;
+    state: z.ZodLiteral<"present">;
+    serverNow: z.ZodEffects<z.ZodString, string, string>;
+    library: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"prompt-builder-library-v1">;
+        models: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>, Record<string, string[]>, Record<string, string[]>>;
+        requests: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            text: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            name: string;
+            text: string;
+        }, {
+            name: string;
+            text: string;
+        }>, "many">;
+        stances: z.ZodArray<z.ZodString, "many">;
+    } & {
+        updatedAt: z.ZodEffects<z.ZodString, string, string>;
+    }, "strict", z.ZodTypeAny, {
+        schemaVersion: "prompt-builder-library-v1";
+        requests: {
+            name: string;
+            text: string;
+        }[];
+        updatedAt: string;
+        models: Record<string, string[]>;
+        stances: string[];
+    }, {
+        schemaVersion: "prompt-builder-library-v1";
+        requests: {
+            name: string;
+            text: string;
+        }[];
+        updatedAt: string;
+        models: Record<string, string[]>;
+        stances: string[];
+    }>;
+}, "strict", z.ZodTypeAny, {
+    state: "present";
+    schemaVersion: "prompt-builder-library-response-v1";
+    serverNow: string;
+    library: {
+        schemaVersion: "prompt-builder-library-v1";
+        requests: {
+            name: string;
+            text: string;
+        }[];
+        updatedAt: string;
+        models: Record<string, string[]>;
+        stances: string[];
+    };
+}, {
+    state: "present";
+    schemaVersion: "prompt-builder-library-response-v1";
+    serverNow: string;
+    library: {
+        schemaVersion: "prompt-builder-library-v1";
+        requests: {
+            name: string;
+            text: string;
+        }[];
+        updatedAt: string;
+        models: Record<string, string[]>;
+        stances: string[];
+    };
+}>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"prompt-builder-library-response-v1">;
+    state: z.ZodLiteral<"unreadable">;
+    serverNow: z.ZodEffects<z.ZodString, string, string>;
+}, "strict", z.ZodTypeAny, {
+    state: "unreadable";
+    schemaVersion: "prompt-builder-library-response-v1";
+    serverNow: string;
+}, {
+    state: "unreadable";
+    schemaVersion: "prompt-builder-library-response-v1";
+    serverNow: string;
+}>]>;
+export type PromptBuilderLibraryGetResponse = z.infer<typeof PromptBuilderLibraryGetResponseSchema>;
+export declare function isPromptBuilderLibraryReadSegments(segments: readonly string[]): boolean;
+export declare function isPromptBuilderLibrarySaveSegments(segments: readonly string[]): boolean;
+export declare function isPromptBuilderLibraryApiSegments(segments: readonly string[]): boolean;

package/clinkx-workflows/dist/dashboard/prompt-builder-library-contract.js

@@ -0,0 +1,89 @@
+/**
+ * Dashboard-private prompt-builder library wire and disk contract.
+ *
+ * The sidecar is never an execution input. Paths are literals so the
+ * companion/gateway POST allowlist can match with exact equality.
+ */
+import { z } from "zod";
+import { StrictRfc3339TimestampSchema } from "./progress-report-contract.js";
+export const PROMPT_BUILDER_LIBRARY_SCHEMA_VERSION = "prompt-builder-library-v1";
+export const PROMPT_BUILDER_LIBRARY_RESPONSE_SCHEMA_VERSION = "prompt-builder-library-response-v1";
+export const PROMPT_BUILDER_LIBRARY_FILENAME = "prompt-builder-library.json";
+export const PROMPT_BUILDER_LIBRARY_READ_PATH = "/api/prompt-builder/library";
+export const PROMPT_BUILDER_LIBRARY_SAVE_PATH = "/api/prompt-builder/library/save";
+export const MAX_PROMPT_BUILDER_LIBRARY_DOCUMENT_BYTES = 192 * 1024;
+export const MAX_PROMPT_BUILDER_LIBRARY_BODY_BYTES = 256 * 1024;
+export const MAX_PROMPT_BUILDER_LIBRARY_READ_BYTES = 256 * 1024;
+export const MAX_PROMPT_BUILDER_LIBRARY_CLI_KEYS = 32;
+export const MAX_PROMPT_BUILDER_LIBRARY_MODELS_PER_CLI = 64;
+export const MAX_PROMPT_BUILDER_LIBRARY_REQUESTS = 64;
+export const MAX_PROMPT_BUILDER_LIBRARY_STANCES = 64;
+const CliNameSchema = z.string().min(1).max(64);
+const ModelIdSchema = z.string().min(1).max(128);
+const RequestNameSchema = z.string().min(1).max(40);
+const RequestTextSchema = z.string().min(1).max(16_000);
+const StanceSchema = z.string().min(1).max(200);
+export const PromptBuilderLibraryModelsSchema = z
+    .record(CliNameSchema, z.array(ModelIdSchema).max(MAX_PROMPT_BUILDER_LIBRARY_MODELS_PER_CLI))
+    .superRefine((models, ctx) => {
+    if (Object.keys(models).length > MAX_PROMPT_BUILDER_LIBRARY_CLI_KEYS) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "too many CLI model lists",
+        });
+    }
+});
+export const PromptBuilderLibraryRequestSchema = z
+    .object({
+    name: RequestNameSchema,
+    text: RequestTextSchema,
+})
+    .strict();
+export const PromptBuilderLibrarySaveRequestSchema = z
+    .object({
+    schemaVersion: z.literal(PROMPT_BUILDER_LIBRARY_SCHEMA_VERSION),
+    models: PromptBuilderLibraryModelsSchema,
+    requests: z.array(PromptBuilderLibraryRequestSchema)
+        .max(MAX_PROMPT_BUILDER_LIBRARY_REQUESTS),
+    stances: z.array(StanceSchema).max(MAX_PROMPT_BUILDER_LIBRARY_STANCES),
+})
+    .strict();
+export const PromptBuilderLibraryDocumentSchema = PromptBuilderLibrarySaveRequestSchema.extend({
+    updatedAt: StrictRfc3339TimestampSchema,
+}).strict();
+export const PromptBuilderLibraryGetResponseSchema = z.discriminatedUnion("state", [
+    z.object({
+        schemaVersion: z.literal(PROMPT_BUILDER_LIBRARY_RESPONSE_SCHEMA_VERSION),
+        state: z.literal("absent"),
+        serverNow: StrictRfc3339TimestampSchema,
+    }).strict(),
+    z.object({
+        schemaVersion: z.literal(PROMPT_BUILDER_LIBRARY_RESPONSE_SCHEMA_VERSION),
+        state: z.literal("present"),
+        serverNow: StrictRfc3339TimestampSchema,
+        library: PromptBuilderLibraryDocumentSchema,
+    }).strict(),
+    z.object({
+        schemaVersion: z.literal(PROMPT_BUILDER_LIBRARY_RESPONSE_SCHEMA_VERSION),
+        state: z.literal("unreadable"),
+        serverNow: StrictRfc3339TimestampSchema,
+    }).strict(),
+]);
+export function isPromptBuilderLibraryReadSegments(segments) {
+    return segments.length === 3 &&
+        segments[0] === "api" &&
+        segments[1] === "prompt-builder" &&
+        segments[2] === "library";
+}
+export function isPromptBuilderLibrarySaveSegments(segments) {
+    return segments.length === 4 &&
+        segments[0] === "api" &&
+        segments[1] === "prompt-builder" &&
+        segments[2] === "library" &&
+        segments[3] === "save";
+}
+export function isPromptBuilderLibraryApiSegments(segments) {
+    return isPromptBuilderLibraryReadSegments(segments) ||
+        isPromptBuilderLibrarySaveSegments(segments);
+}
+//# sourceMappingURL=prompt-builder-library-contract.js.map

package/clinkx-workflows/dist/dashboard/prompt-builder-library-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder-library-contract.js","sourceRoot":"","sources":["../../src/dashboard/prompt-builder-library-contract.ts"],"names":[],"mappings":"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"}

package/clinkx-workflows/dist/dashboard/prompt-builder-library-store.d.ts

@@ -0,0 +1,26 @@
+import { type PromptBuilderLibraryDocument, type PromptBuilderLibrarySaveRequest } from "./prompt-builder-library-contract.js";
+export type PromptBuilderLibraryReadResult = Readonly<{
+    kind: "absent";
+}> | Readonly<{
+    kind: "present";
+    document: PromptBuilderLibraryDocument;
+}> | Readonly<{
+    kind: "unreadable";
+    reason: string;
+}>;
+export type PromptBuilderLibraryWriteOutcome = Readonly<{
+    kind: "ok";
+    document: PromptBuilderLibraryDocument;
+}> | Readonly<{
+    kind: "unwritable";
+}> | Readonly<{
+    kind: "too_large";
+}>;
+export interface PromptBuilderLibraryStore {
+    readonly read: (parentDir: string) => Promise<PromptBuilderLibraryReadResult>;
+    readonly write: (parentDir: string, request: PromptBuilderLibrarySaveRequest) => Promise<PromptBuilderLibraryWriteOutcome>;
+}
+export declare function promptBuilderLibraryFilePath(parentDir: string): string;
+export declare function createPromptBuilderLibraryStore(options?: Readonly<{
+    now?: (() => Date) | undefined;
+}>): PromptBuilderLibraryStore;