clinkx 1.0.0 → 1.1.1

package/clinkx-workflows/dist/dashboard/invocation-contract.d.ts

@@ -0,0 +1,786 @@
+import { z } from "zod";
+export declare const INVOCATION_PROVENANCE: readonly ["caller_override", "adapter_pin", "cli_default_unknown"];
+export declare const InvocationProvenanceSchema: z.ZodEnum<["caller_override", "adapter_pin", "cli_default_unknown"]>;
+export type InvocationProvenance = z.infer<typeof InvocationProvenanceSchema>;
+export declare const INVOCATION_AUDIT_V2_SCHEMA_VERSION: "clinkx-invocation-audit-v2";
+export declare const INVOCATION_PROVENANCE_V2: readonly ["caller_override", "adapter_pin", "adapter_default", "cli_default_unknown"];
+export declare const InvocationProvenanceV2Schema: z.ZodEnum<["caller_override", "adapter_pin", "adapter_default", "cli_default_unknown"]>;
+export type InvocationProvenanceV2 = z.infer<typeof InvocationProvenanceV2Schema>;
+export declare const InvocationAuditV1Schema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        requested: z.ZodOptional<z.ZodType<string, z.ZodTypeDef, string>>;
+        applied: z.ZodOptional<z.ZodType<string, z.ZodTypeDef, string>>;
+        provenance: z.ZodEnum<["caller_override", "adapter_pin", "cli_default_unknown"]>;
+    }, "strict", z.ZodTypeAny, {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    }, {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    }>, {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    }, {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    }>>;
+    effort: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        requested: z.ZodOptional<z.ZodType<string, z.ZodTypeDef, string>>;
+        applied: z.ZodOptional<z.ZodType<string, z.ZodTypeDef, string>>;
+        provenance: z.ZodEnum<["caller_override", "adapter_pin", "cli_default_unknown"]>;
+    }, "strict", z.ZodTypeAny, {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    }, {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    }>, {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    }, {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    model?: {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    } | undefined;
+    effort?: {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    } | undefined;
+}, {
+    model?: {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    } | undefined;
+    effort?: {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    } | undefined;
+}>;
+export type InvocationAuditV1 = z.infer<typeof InvocationAuditV1Schema>;
+export declare const InvocationModelValueV2Schema: z.ZodDiscriminatedUnion<"state", [z.ZodObject<{
+    state: z.ZodLiteral<"recorded">;
+    value: z.ZodType<string, z.ZodTypeDef, string>;
+}, "strict", z.ZodTypeAny, {
+    value: string;
+    state: "recorded";
+}, {
+    value: string;
+    state: "recorded";
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"accepted_unrepresentable">;
+}, "strict", z.ZodTypeAny, {
+    state: "accepted_unrepresentable";
+}, {
+    state: "accepted_unrepresentable";
+}>]>;
+export declare const InvocationEffortValueV2Schema: z.ZodDiscriminatedUnion<"state", [z.ZodObject<{
+    state: z.ZodLiteral<"recorded">;
+    value: z.ZodType<string, z.ZodTypeDef, string>;
+}, "strict", z.ZodTypeAny, {
+    value: string;
+    state: "recorded";
+}, {
+    value: string;
+    state: "recorded";
+}>, z.ZodObject<{
+    state: z.ZodLiteral<"accepted_unrepresentable">;
+}, "strict", z.ZodTypeAny, {
+    state: "accepted_unrepresentable";
+}, {
+    state: "accepted_unrepresentable";
+}>]>;
+export type InvocationModelValueV2 = z.infer<typeof InvocationModelValueV2Schema>;
+export type InvocationEffortValueV2 = z.infer<typeof InvocationEffortValueV2Schema>;
+type InvocationValueV2 = {
+    state: "recorded";
+    value: string;
+} | {
+    state: "accepted_unrepresentable";
+};
+/**
+ * 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 declare const InvocationAuditV2Schema: z.ZodEffects<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"clinkx-invocation-audit-v2">;
+    model: z.ZodOptional<z.ZodEffects<z.ZodDiscriminatedUnion<"provenance", [z.ZodObject<{
+        provenance: z.ZodLiteral<"caller_override">;
+        requested: z.ZodType<InvocationValueV2, z.ZodTypeDef, InvocationValueV2>;
+        applied: z.ZodType<InvocationValueV2, z.ZodTypeDef, InvocationValueV2>;
+    }, "strict", z.ZodTypeAny, {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    }, {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    }>, z.ZodObject<{
+        provenance: z.ZodLiteral<"adapter_pin">;
+        applied: z.ZodType<InvocationValueV2, z.ZodTypeDef, InvocationValueV2>;
+    }, "strict", z.ZodTypeAny, {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    }, {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    }>, z.ZodObject<{
+        provenance: z.ZodLiteral<"adapter_default">;
+        applied: z.ZodType<InvocationValueV2, z.ZodTypeDef, InvocationValueV2>;
+    }, "strict", z.ZodTypeAny, {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    }, {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    }>, z.ZodObject<{
+        provenance: z.ZodLiteral<"cli_default_unknown">;
+    }, "strict", z.ZodTypeAny, {
+        provenance: "cli_default_unknown";
+    }, {
+        provenance: "cli_default_unknown";
+    }>]>, {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    }, {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    }>>;
+    effort: z.ZodOptional<z.ZodEffects<z.ZodDiscriminatedUnion<"provenance", [z.ZodObject<{
+        provenance: z.ZodLiteral<"caller_override">;
+        requested: z.ZodType<InvocationValueV2, z.ZodTypeDef, InvocationValueV2>;
+        applied: z.ZodType<InvocationValueV2, z.ZodTypeDef, InvocationValueV2>;
+    }, "strict", z.ZodTypeAny, {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    }, {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    }>, z.ZodObject<{
+        provenance: z.ZodLiteral<"adapter_pin">;
+        applied: z.ZodType<InvocationValueV2, z.ZodTypeDef, InvocationValueV2>;
+    }, "strict", z.ZodTypeAny, {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    }, {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    }>, z.ZodObject<{
+        provenance: z.ZodLiteral<"adapter_default">;
+        applied: z.ZodType<InvocationValueV2, z.ZodTypeDef, InvocationValueV2>;
+    }, "strict", z.ZodTypeAny, {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    }, {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    }>, z.ZodObject<{
+        provenance: z.ZodLiteral<"cli_default_unknown">;
+    }, "strict", z.ZodTypeAny, {
+        provenance: "cli_default_unknown";
+    }, {
+        provenance: "cli_default_unknown";
+    }>]>, {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    }, {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: "clinkx-invocation-audit-v2";
+    model?: {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    } | undefined;
+    effort?: {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    } | undefined;
+}, {
+    schemaVersion: "clinkx-invocation-audit-v2";
+    model?: {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    } | undefined;
+    effort?: {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    } | undefined;
+}>, {
+    schemaVersion: "clinkx-invocation-audit-v2";
+    model?: {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    } | undefined;
+    effort?: {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    } | undefined;
+}, {
+    schemaVersion: "clinkx-invocation-audit-v2";
+    model?: {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    } | undefined;
+    effort?: {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    } | undefined;
+}>;
+export type InvocationAuditV2 = z.infer<typeof InvocationAuditV2Schema>;
+/** Strict persisted-reader union. V1 remains unchanged and unversioned. */
+export declare const InvocationAuditReadSchema: z.ZodUnion<[z.ZodEffects<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"clinkx-invocation-audit-v2">;
+    model: z.ZodOptional<z.ZodEffects<z.ZodDiscriminatedUnion<"provenance", [z.ZodObject<{
+        provenance: z.ZodLiteral<"caller_override">;
+        requested: z.ZodType<InvocationValueV2, z.ZodTypeDef, InvocationValueV2>;
+        applied: z.ZodType<InvocationValueV2, z.ZodTypeDef, InvocationValueV2>;
+    }, "strict", z.ZodTypeAny, {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    }, {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    }>, z.ZodObject<{
+        provenance: z.ZodLiteral<"adapter_pin">;
+        applied: z.ZodType<InvocationValueV2, z.ZodTypeDef, InvocationValueV2>;
+    }, "strict", z.ZodTypeAny, {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    }, {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    }>, z.ZodObject<{
+        provenance: z.ZodLiteral<"adapter_default">;
+        applied: z.ZodType<InvocationValueV2, z.ZodTypeDef, InvocationValueV2>;
+    }, "strict", z.ZodTypeAny, {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    }, {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    }>, z.ZodObject<{
+        provenance: z.ZodLiteral<"cli_default_unknown">;
+    }, "strict", z.ZodTypeAny, {
+        provenance: "cli_default_unknown";
+    }, {
+        provenance: "cli_default_unknown";
+    }>]>, {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    }, {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    }>>;
+    effort: z.ZodOptional<z.ZodEffects<z.ZodDiscriminatedUnion<"provenance", [z.ZodObject<{
+        provenance: z.ZodLiteral<"caller_override">;
+        requested: z.ZodType<InvocationValueV2, z.ZodTypeDef, InvocationValueV2>;
+        applied: z.ZodType<InvocationValueV2, z.ZodTypeDef, InvocationValueV2>;
+    }, "strict", z.ZodTypeAny, {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    }, {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    }>, z.ZodObject<{
+        provenance: z.ZodLiteral<"adapter_pin">;
+        applied: z.ZodType<InvocationValueV2, z.ZodTypeDef, InvocationValueV2>;
+    }, "strict", z.ZodTypeAny, {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    }, {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    }>, z.ZodObject<{
+        provenance: z.ZodLiteral<"adapter_default">;
+        applied: z.ZodType<InvocationValueV2, z.ZodTypeDef, InvocationValueV2>;
+    }, "strict", z.ZodTypeAny, {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    }, {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    }>, z.ZodObject<{
+        provenance: z.ZodLiteral<"cli_default_unknown">;
+    }, "strict", z.ZodTypeAny, {
+        provenance: "cli_default_unknown";
+    }, {
+        provenance: "cli_default_unknown";
+    }>]>, {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    }, {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: "clinkx-invocation-audit-v2";
+    model?: {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    } | undefined;
+    effort?: {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    } | undefined;
+}, {
+    schemaVersion: "clinkx-invocation-audit-v2";
+    model?: {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    } | undefined;
+    effort?: {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    } | undefined;
+}>, {
+    schemaVersion: "clinkx-invocation-audit-v2";
+    model?: {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    } | undefined;
+    effort?: {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    } | undefined;
+}, {
+    schemaVersion: "clinkx-invocation-audit-v2";
+    model?: {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    } | undefined;
+    effort?: {
+        requested: InvocationValueV2;
+        applied: InvocationValueV2;
+        provenance: "caller_override";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_pin";
+    } | {
+        applied: InvocationValueV2;
+        provenance: "adapter_default";
+    } | {
+        provenance: "cli_default_unknown";
+    } | undefined;
+}>, z.ZodObject<{
+    model: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        requested: z.ZodOptional<z.ZodType<string, z.ZodTypeDef, string>>;
+        applied: z.ZodOptional<z.ZodType<string, z.ZodTypeDef, string>>;
+        provenance: z.ZodEnum<["caller_override", "adapter_pin", "cli_default_unknown"]>;
+    }, "strict", z.ZodTypeAny, {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    }, {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    }>, {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    }, {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    }>>;
+    effort: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        requested: z.ZodOptional<z.ZodType<string, z.ZodTypeDef, string>>;
+        applied: z.ZodOptional<z.ZodType<string, z.ZodTypeDef, string>>;
+        provenance: z.ZodEnum<["caller_override", "adapter_pin", "cli_default_unknown"]>;
+    }, "strict", z.ZodTypeAny, {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    }, {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    }>, {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    }, {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    model?: {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    } | undefined;
+    effort?: {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    } | undefined;
+}, {
+    model?: {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    } | undefined;
+    effort?: {
+        provenance: "caller_override" | "adapter_pin" | "cli_default_unknown";
+        requested?: string | undefined;
+        applied?: string | undefined;
+    } | undefined;
+}>]>;
+export type InvocationAuditRead = z.infer<typeof InvocationAuditReadSchema>;
+export type InvocationAuditWrite = InvocationAuditRead;
+/** Encode without ever normalizing or partially retaining the accepted value. */
+export declare function representInvocationModelValueV2(value: string): InvocationModelValueV2;
+/** Encode without ever normalizing or partially retaining the accepted value. */
+export declare function representInvocationEffortValueV2(value: string): InvocationEffortValueV2;
+/**
+ * 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 declare const OBSERVED_INVOCATION_V1_SCHEMA_VERSION: "clinkx-observed-invocation-v1";
+export declare const OBSERVED_INVOCATION_SOURCES: readonly ["claude_stream_json_init", "codex_app_server_thread_start"];
+export declare const ObservedInvocationSourceSchema: z.ZodEnum<["claude_stream_json_init", "codex_app_server_thread_start"]>;
+export type ObservedInvocationSource = (typeof OBSERVED_INVOCATION_SOURCES)[number];
+export declare const ObservedInvocationV1Schema: z.ZodEffects<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"clinkx-observed-invocation-v1">;
+    source: z.ZodEnum<["claude_stream_json_init", "codex_app_server_thread_start"]>;
+    model: z.ZodOptional<z.ZodDiscriminatedUnion<"state", [z.ZodObject<{
+        state: z.ZodLiteral<"recorded">;
+        value: z.ZodType<string, z.ZodTypeDef, string>;
+    }, "strict", z.ZodTypeAny, {
+        value: string;
+        state: "recorded";
+    }, {
+        value: string;
+        state: "recorded";
+    }>, z.ZodObject<{
+        state: z.ZodLiteral<"accepted_unrepresentable">;
+    }, "strict", z.ZodTypeAny, {
+        state: "accepted_unrepresentable";
+    }, {
+        state: "accepted_unrepresentable";
+    }>]>>;
+    effort: z.ZodOptional<z.ZodDiscriminatedUnion<"state", [z.ZodObject<{
+        state: z.ZodLiteral<"recorded">;
+        value: z.ZodType<string, z.ZodTypeDef, string>;
+    }, "strict", z.ZodTypeAny, {
+        value: string;
+        state: "recorded";
+    }, {
+        value: string;
+        state: "recorded";
+    }>, z.ZodObject<{
+        state: z.ZodLiteral<"accepted_unrepresentable">;
+    }, "strict", z.ZodTypeAny, {
+        state: "accepted_unrepresentable";
+    }, {
+        state: "accepted_unrepresentable";
+    }>]>>;
+}, "strict", z.ZodTypeAny, {
+    schemaVersion: "clinkx-observed-invocation-v1";
+    source: "claude_stream_json_init" | "codex_app_server_thread_start";
+    model?: {
+        value: string;
+        state: "recorded";
+    } | {
+        state: "accepted_unrepresentable";
+    } | undefined;
+    effort?: {
+        value: string;
+        state: "recorded";
+    } | {
+        state: "accepted_unrepresentable";
+    } | undefined;
+}, {
+    schemaVersion: "clinkx-observed-invocation-v1";
+    source: "claude_stream_json_init" | "codex_app_server_thread_start";
+    model?: {
+        value: string;
+        state: "recorded";
+    } | {
+        state: "accepted_unrepresentable";
+    } | undefined;
+    effort?: {
+        value: string;
+        state: "recorded";
+    } | {
+        state: "accepted_unrepresentable";
+    } | undefined;
+}>, {
+    schemaVersion: "clinkx-observed-invocation-v1";
+    source: "claude_stream_json_init" | "codex_app_server_thread_start";
+    model?: {
+        value: string;
+        state: "recorded";
+    } | {
+        state: "accepted_unrepresentable";
+    } | undefined;
+    effort?: {
+        value: string;
+        state: "recorded";
+    } | {
+        state: "accepted_unrepresentable";
+    } | undefined;
+}, {
+    schemaVersion: "clinkx-observed-invocation-v1";
+    source: "claude_stream_json_init" | "codex_app_server_thread_start";
+    model?: {
+        value: string;
+        state: "recorded";
+    } | {
+        state: "accepted_unrepresentable";
+    } | undefined;
+    effort?: {
+        value: string;
+        state: "recorded";
+    } | {
+        state: "accepted_unrepresentable";
+    } | undefined;
+}>;
+export type ObservedInvocationV1 = z.infer<typeof ObservedInvocationV1Schema>;
+export declare function buildObservedInvocationV1(source: ObservedInvocationSource, knobs: {
+    readonly model?: string;
+    readonly effort?: string;
+}): ObservedInvocationV1 | undefined;
+export {};