clinkx 0.3.0 → 1.1.0

package/clinkx-workflows/dist/dashboard/invocation-contract.js

@@ -0,0 +1,201 @@
+import { z } from "zod";
+import { EFFORT_VALUE_MAX, EFFORT_VALUE_PATTERN, MODEL_VALUE_MAX, MODEL_VALUE_PATTERN, } from "../schema.js";
+// Leaf copies of the dashboard model/effort bounds. Do not import these from
+// contracts.ts — that file imports activity-contract, and activity-contract
+// needs this module for its transitional and V2 invocation fields.
+const DashboardModelSchema = z
+    .string()
+    .min(1)
+    .max(MODEL_VALUE_MAX)
+    .regex(MODEL_VALUE_PATTERN);
+const DashboardEffortSchema = z
+    .string()
+    .min(1)
+    .max(EFFORT_VALUE_MAX)
+    .regex(EFFORT_VALUE_PATTERN);
+export const INVOCATION_PROVENANCE = [
+    "caller_override",
+    "adapter_pin",
+    "cli_default_unknown",
+];
+export const InvocationProvenanceSchema = z.enum(INVOCATION_PROVENANCE);
+export const INVOCATION_AUDIT_V2_SCHEMA_VERSION = "clinkx-invocation-audit-v2";
+export const INVOCATION_PROVENANCE_V2 = [
+    "caller_override",
+    "adapter_pin",
+    "adapter_default",
+    "cli_default_unknown",
+];
+export const InvocationProvenanceV2Schema = z.enum(INVOCATION_PROVENANCE_V2);
+function invocationKnobSchema(valueSchema) {
+    return z
+        .object({
+        requested: valueSchema.optional(),
+        applied: valueSchema.optional(),
+        provenance: InvocationProvenanceSchema,
+    })
+        .strict()
+        .superRefine((knob, ctx) => {
+        const requested = knob.requested;
+        const applied = knob.applied;
+        switch (knob.provenance) {
+            case "caller_override":
+                if (requested === undefined || applied !== requested) {
+                    ctx.addIssue({
+                        code: z.ZodIssueCode.custom,
+                        message: "caller_override requires requested === applied",
+                    });
+                }
+                return;
+            case "adapter_pin":
+                if (requested !== undefined || applied === undefined) {
+                    ctx.addIssue({
+                        code: z.ZodIssueCode.custom,
+                        message: "adapter_pin requires applied with no requested",
+                    });
+                }
+                return;
+            case "cli_default_unknown":
+                if (requested !== undefined || applied !== undefined) {
+                    ctx.addIssue({
+                        code: z.ZodIssueCode.custom,
+                        message: "cli_default_unknown requires no requested or applied",
+                    });
+                }
+                return;
+        }
+    });
+}
+export const InvocationAuditV1Schema = z
+    .object({
+    model: invocationKnobSchema(DashboardModelSchema).optional(),
+    effort: invocationKnobSchema(DashboardEffortSchema).optional(),
+})
+    .strict();
+function invocationValueV2Schema(valueSchema) {
+    return z.discriminatedUnion("state", [
+        z.object({
+            state: z.literal("recorded"),
+            value: valueSchema,
+        }).strict(),
+        z.object({
+            state: z.literal("accepted_unrepresentable"),
+        }).strict(),
+    ]);
+}
+export const InvocationModelValueV2Schema = invocationValueV2Schema(DashboardModelSchema);
+export const InvocationEffortValueV2Schema = invocationValueV2Schema(DashboardEffortSchema);
+function invocationKnobV2Schema(valueSchema) {
+    return z.discriminatedUnion("provenance", [
+        z.object({
+            provenance: z.literal("caller_override"),
+            requested: valueSchema,
+            applied: valueSchema,
+        }).strict(),
+        z.object({
+            provenance: z.literal("adapter_pin"),
+            applied: valueSchema,
+        }).strict(),
+        z.object({
+            provenance: z.literal("adapter_default"),
+            applied: valueSchema,
+        }).strict(),
+        z.object({
+            provenance: z.literal("cli_default_unknown"),
+        }).strict(),
+    ]).superRefine((knob, context) => {
+        if (knob.provenance !== "caller_override" ||
+            !("requested" in knob) ||
+            !("applied" in knob)) {
+            return;
+        }
+        const requested = knob.requested;
+        const applied = knob.applied;
+        if (requested.state !== applied.state) {
+            context.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "caller_override requires requested and applied value states to agree",
+            });
+            return;
+        }
+        if (requested.state === "recorded" &&
+            applied.state === "recorded" &&
+            requested.value !== applied.value) {
+            context.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: "caller_override requires requested and applied values to agree",
+            });
+        }
+    });
+}
+/**
+ * Versioned audit representation for new writers.
+ *
+ * `recorded` stores the exact accepted value. A value outside the bounded,
+ * canonical dashboard grammar is represented only as
+ * `accepted_unrepresentable`: it is never trimmed, truncated, hashed, or
+ * fabricated. Provenance arms make value presence structural:
+ * caller overrides carry equal requested/applied states, pins and configured
+ * adapter defaults carry only an applied state, and unknown CLI defaults carry
+ * no value state.
+ */
+export const InvocationAuditV2Schema = z.object({
+    schemaVersion: z.literal(INVOCATION_AUDIT_V2_SCHEMA_VERSION),
+    model: invocationKnobV2Schema(InvocationModelValueV2Schema).optional(),
+    effort: invocationKnobV2Schema(InvocationEffortValueV2Schema).optional(),
+}).strict().refine((audit) => audit.model !== undefined || audit.effort !== undefined, "V2 invocation audits must record at least one knob");
+/** Strict persisted-reader union. V1 remains unchanged and unversioned. */
+export const InvocationAuditReadSchema = z.union([
+    InvocationAuditV2Schema,
+    InvocationAuditV1Schema,
+]);
+function representInvocationValueV2(value, valueSchema) {
+    const parsed = valueSchema.safeParse(value);
+    return parsed.success
+        ? { state: "recorded", value: parsed.data }
+        : { state: "accepted_unrepresentable" };
+}
+/** Encode without ever normalizing or partially retaining the accepted value. */
+export function representInvocationModelValueV2(value) {
+    return representInvocationValueV2(value, DashboardModelSchema);
+}
+/** Encode without ever normalizing or partially retaining the accepted value. */
+export function representInvocationEffortValueV2(value) {
+    return representInvocationValueV2(value, DashboardEffortSchema);
+}
+/**
+ * Runtime-observed invocation knobs, tagged by observation source. Distinct
+ * from the pre-dispatch audits: this records what a provider actually
+ * reported, reusing the V2 value grammar (exact `recorded` values or
+ * `accepted_unrepresentable`, never normalized). A source with no observed
+ * knob produces no record at all.
+ */
+export const OBSERVED_INVOCATION_V1_SCHEMA_VERSION = "clinkx-observed-invocation-v1";
+export const OBSERVED_INVOCATION_SOURCES = [
+    "claude_stream_json_init",
+    "codex_app_server_thread_start",
+];
+export const ObservedInvocationSourceSchema = z.enum(OBSERVED_INVOCATION_SOURCES);
+export const ObservedInvocationV1Schema = z.object({
+    schemaVersion: z.literal(OBSERVED_INVOCATION_V1_SCHEMA_VERSION),
+    source: ObservedInvocationSourceSchema,
+    model: InvocationModelValueV2Schema.optional(),
+    effort: InvocationEffortValueV2Schema.optional(),
+}).strict().refine((value) => value.model !== undefined || value.effort !== undefined, "observed invocation must record at least one knob");
+export function buildObservedInvocationV1(source, knobs) {
+    const model = knobs.model === undefined
+        ? undefined
+        : representInvocationModelValueV2(knobs.model);
+    const effort = knobs.effort === undefined
+        ? undefined
+        : representInvocationEffortValueV2(knobs.effort);
+    if (model === undefined && effort === undefined)
+        return undefined;
+    return ObservedInvocationV1Schema.parse({
+        schemaVersion: OBSERVED_INVOCATION_V1_SCHEMA_VERSION,
+        source,
+        ...(model === undefined ? {} : { model }),
+        ...(effort === undefined ? {} : { effort }),
+    });
+}
+//# sourceMappingURL=invocation-contract.js.map

package/clinkx-workflows/dist/dashboard/invocation-contract.js.map

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

package/clinkx-workflows/dist/dashboard/lazy-content.d.ts

@@ -0,0 +1,114 @@
+import { z } from "zod";
+import { readContainedRelativeFile, type ContainedFileFingerprint } from "../contained-file.js";
+import { extractCouncilPlanReviewCard } from "../run-summary/cards/council-plan-review.js";
+import { type ValidatorRegistry } from "../validators/index.js";
+import { DashboardContextPreflightInvocationSchema } from "./contracts.js";
+import { type AdmittedDashboardRun, type DashboardRunReader } from "./read-model.js";
+import { type ContextRunReader } from "./context-run-reader.js";
+export declare const DASHBOARD_WORKFLOW_SNAPSHOT_MAX_BYTES: number;
+export declare const DASHBOARD_WORKFLOW_INPUT_MAX_BYTES: number;
+export declare const DASHBOARD_LAZY_CONTENT_MAX_BYTES: number;
+export declare const MAX_DASHBOARD_CONTEXT_FROM_REFERENCES = 2000;
+export declare const MAX_DASHBOARD_CONTEXT_FROM_REFERENCE_CHARS: number;
+export type DashboardLazyContentKind = "prompt" | "output" | "error" | "artifact";
+export interface DashboardLazyCallRequest {
+    readonly runsRoot: string;
+    readonly runId: string;
+    readonly runGeneration: string;
+    readonly stageId: string;
+    readonly callId: string;
+    readonly kind: DashboardLazyContentKind;
+}
+export interface DashboardLazyResultRequest {
+    readonly runsRoot: string;
+    readonly runId: string;
+    readonly runGeneration: string;
+}
+export type DashboardLazyContentUnavailableReason = "not_found" | "not_persisted" | "invalid" | "content_too_large_for_dashboard";
+export type DashboardLazyContentResult = {
+    readonly kind: "available";
+    readonly content: string;
+    readonly mediaType: "application/json; charset=utf-8" | "text/plain; charset=utf-8";
+    readonly runGeneration: string;
+    readonly stateRevision: string;
+    readonly validatorSchemaId?: string;
+} | {
+    readonly kind: "unavailable";
+    readonly reason: DashboardLazyContentUnavailableReason;
+} | {
+    readonly kind: "run_generation_changed";
+} | {
+    readonly kind: "run_state_changed";
+};
+export interface DashboardSnapshotProjection {
+    readonly stages: readonly {
+        readonly stageId: string;
+        readonly label?: string | undefined;
+        readonly dependsOn: readonly string[];
+        readonly calls: readonly {
+            readonly callId: string;
+            readonly adapter: string;
+            readonly role: string;
+            readonly validatedJson: boolean;
+            readonly model?: string | undefined;
+            readonly effort?: string | undefined;
+        }[];
+    }[];
+}
+export type DashboardGenericResultInspection = {
+    readonly availability: "available";
+    readonly kind: "text" | "json";
+} | {
+    readonly availability: "unavailable";
+    readonly reason: "not_persisted" | "missing" | "invalid" | "too_large";
+};
+export interface DashboardEnrichmentDependency {
+    readonly relativePath: string;
+    readonly role: "snapshot" | "generic_output" | "plan_review_publication" | "context_preflight_invocation";
+    readonly maxBytes: number;
+    readonly fingerprint: ContainedFileFingerprint;
+    readonly contentCommitment?: string | undefined;
+    readonly artifactRunId?: string | undefined;
+    readonly contextGeneration?: string | undefined;
+}
+type DashboardContextPreflightInvocation = z.infer<typeof DashboardContextPreflightInvocationSchema>;
+export type DashboardStructuredProjectionResult = {
+    readonly kind: "available";
+    readonly admission: AdmittedDashboardRun;
+    readonly snapshot: {
+        readonly availability: "available";
+        readonly projection: DashboardSnapshotProjection;
+    } | {
+        readonly availability: "unavailable";
+        readonly reason: "missing" | "unreadable" | "invalid" | "too_large" | "hash_mismatch";
+    };
+    readonly genericResult?: DashboardGenericResultInspection | undefined;
+    readonly planReviewCard?: ReturnType<typeof extractCouncilPlanReviewCard> | undefined;
+    readonly contextPreflightInvocation?: DashboardContextPreflightInvocation | undefined;
+    readonly enrichmentDependencies?: readonly DashboardEnrichmentDependency[] | undefined;
+} | {
+    readonly kind: "run_generation_changed";
+} | {
+    readonly kind: "run_state_changed";
+} | {
+    readonly kind: "unavailable";
+};
+export interface DashboardLazyContentReader {
+    readCallContent(request: DashboardLazyCallRequest): Promise<DashboardLazyContentResult>;
+    readResult(request: DashboardLazyResultRequest): Promise<DashboardLazyContentResult>;
+    readStructuredProjection(request: DashboardLazyResultRequest): Promise<DashboardStructuredProjectionResult>;
+    validateEnrichmentDependencies?(request: DashboardLazyResultRequest, admitted: AdmittedDashboardRun, dependencies: readonly DashboardEnrichmentDependency[]): Promise<boolean>;
+}
+export interface DashboardLazyContentReaderOptions {
+    readonly runReader?: DashboardRunReader | undefined;
+    readonly validatorRegistry?: ValidatorRegistry | undefined;
+    readonly readContainedFile?: typeof readContainedRelativeFile | undefined;
+    /** Configured producer root for workflow context-preflight artifacts. */
+    readonly contextRunsRoot?: string | undefined;
+    readonly contextRunReader?: ContextRunReader | undefined;
+    /** Deterministic race seam after content acquisition and before state re-admission. */
+    readonly afterLazyRead?: ((attempt: 1 | 2) => void | Promise<void>) | undefined;
+    readonly stateRevisionFor?: (runsRoot: string, admitted: AdmittedDashboardRun) => string;
+}
+export declare function createDashboardLazyContentReader(options?: DashboardLazyContentReaderOptions): DashboardLazyContentReader;
+export {};