humanish 0.88.2 → 0.89.1

package/dist/study-analysis-validation.js

@@ -0,0 +1,331 @@
+import { createHash } from "node:crypto";
+import { z } from "zod";
+import { STUDY_ANALYSIS_SCHEMA, STUDY_ANALYSIS_CORRECTION_SCHEMA } from "./study-analysis.js";
+const text = (max) => z.string().max(max).refine((value) => !/[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/.test(value), "Invalid text.");
+const label = text(240).min(1);
+const id = z.string().min(1).max(128).regex(/^[A-Za-z0-9][A-Za-z0-9_.-]*$/);
+const sourceId = text(256).min(1);
+const digest = z.string().regex(/^[a-f0-9]{64}$/);
+const timestamp = z.string().datetime({ offset: true });
+const sourceIds = z.array(sourceId).max(128);
+const refs = z.array(id).min(1).max(100);
+const limitations = z.array(text(2000).min(1)).max(100);
+export const studyAnalysisResultSchema = z.object({
+    summary: text(4000).min(1),
+    participants: z.array(z.object({
+        streamId: sourceId,
+        summary: text(4000).min(1),
+        intent: text(2000).min(1),
+        outcome: z.enum(["completed", "blocked", "abandoned", "interrupted", "unknown"]),
+        outcomeReason: text(2000).min(1),
+        evidenceIds: z.array(id).max(100),
+        feedback: z.array(z.object({ evidenceId: id, text: text(4000).min(1) }).strict()).max(20),
+        limitations
+    }).strict()).max(128),
+    findings: z.array(z.object({
+        id,
+        title: label,
+        summary: text(4000).min(1),
+        impact: z.enum(["blocked_task", "friction", "recovery", "uncertain"]),
+        affectedStreamIds: sourceIds.min(1),
+        exposedStreamIds: sourceIds.min(1),
+        exposureReason: text(2000).min(1),
+        recovery: z.enum(["recovered", "not_observed", "unknown"]),
+        confidence: z.enum(["low", "medium", "high"]),
+        observations: z.array(z.object({
+            claim: text(2000).min(1),
+            basis: z.enum(["visual", "action", "participant_statement", "inference"]),
+            evidenceIds: refs,
+            limitation: text(2000)
+        }).strict()).min(1).max(30),
+        nextStep: text(2000).min(1),
+        priorityReason: text(2000).min(1)
+    }).strict()).max(100),
+    limitations
+}).strict();
+export const studyAnalysisResultJsonSchema = z.toJSONSchema(studyAnalysisResultSchema);
+export const studyAnalysisCoverageSchema = z.object({
+    includedStreamIds: sourceIds,
+    omittedStreamIds: sourceIds,
+    evidenceCount: z.number().int().min(0).max(2000),
+    captureCount: z.number().int().min(0).max(64),
+    complete: z.boolean(),
+    omissions: limitations
+}).strict();
+const artifactPath = z.string().min(1).max(1024).refine((value) => !/[\\:\x00-\x1f\x7f]/.test(value)
+    && !value.startsWith("/")
+    && value.split("/").every((part) => part !== "" && part !== "." && part !== ".."), "Invalid evidence path.");
+export const studyAnalysisEvidenceSchema = z.object({
+    id,
+    streamId: sourceId,
+    eventId: sourceId,
+    kind: text(128).min(1),
+    text: text(16000),
+    quoteEligible: z.boolean(),
+    at: timestamp.nullable(),
+    elapsedMs: z.number().int().min(0).max(Number.MAX_SAFE_INTEGER).nullable(),
+    frame: z.number().int().min(0).max(100000).nullable(),
+    capture: z.object({
+        eventId: sourceId,
+        path: artifactPath,
+        sha256: digest,
+        mimeType: z.enum(["image/png", "image/jpeg", "image/webp"])
+    }).strict().nullable()
+}).strict();
+export const studyAnalysisParticipantProvenanceSchema = z.object({
+    actorStatus: z.enum(["passed", "abandoned", "incomplete", "blocked", "timed_out", "failed"]).nullable(),
+    completionReason: z.enum(["goal_satisfied", "turn_completed", "gave_up", "blocked_approval", "timed_out",
+        "budget_reached", "actor_error", "step_failed", "harness_error"]).nullable(),
+    stopCause: z.enum(["provider_output_limit", "provider_token_limit", "time_limit", "spend_limit",
+        "study_spend_limit", "adapter_limit", "provider_incomplete", "provider_status", "harness_aborted"]).nullable(),
+    goalSource: z.enum(["participant_report", "condition_matched", "unavailable"]).nullable(),
+    declaredOutcome: z.enum(["reached", "not_reached", "blocked"]).nullable(),
+    taskOutcomes: z.array(z.object({
+        taskId: sourceId,
+        completed: z.boolean(),
+        observable: z.boolean(),
+        inputsObserved: z.boolean().nullable(),
+        turn: z.number().int().min(0).max(Number.MAX_SAFE_INTEGER).nullable()
+    }).strict()).max(128).refine((tasks) => new Set(tasks.map((task) => task.taskId)).size === tasks.length, "Task IDs must be distinct.").nullable()
+}).strict();
+export const studyAnalysisArtifactSchema = z.object({
+    schema: z.literal(STUDY_ANALYSIS_SCHEMA),
+    id,
+    runId: sourceId,
+    status: z.enum(["complete", "partial", "failed", "cancelled"]),
+    createdAt: timestamp,
+    completedAt: timestamp,
+    sourceRunSha256: digest,
+    inputDigest: digest,
+    configDigest: digest,
+    config: z.object({
+        model: label,
+        question: text(4000).nullable(),
+        maxCostUsd: z.number().positive().max(1000),
+        timeoutMs: z.number().int().positive().max(3600000),
+        maxOutputTokens: z.number().int().positive().max(128000)
+    }).strict(),
+    promptVersion: label,
+    provider: z.literal("openai"),
+    usage: z.object({
+        cacheWriteInputTokens: z.number().int().min(0).max(1e12).nullable(),
+        cachedInputTokens: z.number().int().min(0).max(1e12).nullable(),
+        usageComplete: z.boolean(),
+        dispatched: z.boolean(),
+        ratesAsOf: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).nullable(),
+        estimatedAdmissionUsd: z.number().min(0).max(1e9).nullable(),
+        inputTokens: z.number().int().min(0).max(1e12).nullable(),
+        outputTokens: z.number().int().min(0).max(1e12).nullable(),
+        estimatedCostUsd: z.number().min(0).max(1e9).nullable()
+    }).strict(),
+    participants: z.array(z.object({
+        streamId: sourceId,
+        label: text(1000),
+        assignment: text(8000).nullable(),
+        recordedStatus: text(128).min(1),
+        recordedReason: text(4000).nullable(),
+        provenance: studyAnalysisParticipantProvenanceSchema
+    }).strict()).max(128),
+    coverage: studyAnalysisCoverageSchema,
+    evidence: z.array(studyAnalysisEvidenceSchema).max(2000),
+    result: studyAnalysisResultSchema.nullable(),
+    error: z.string().regex(/^[A-Za-z][A-Za-z0-9_]{0,127}$/).nullable()
+}).strict();
+export const studyAnalysisCorrectionSchema = z.object({
+    schema: z.literal(STUDY_ANALYSIS_CORRECTION_SCHEMA),
+    id,
+    analysisId: id,
+    analysisSha256: digest,
+    findingId: id,
+    findingSha256: digest,
+    createdAt: timestamp,
+    status: z.enum(["confirmed", "dismissed", "amended"]),
+    reason: text(4000).min(1),
+    replacementClaim: text(4000).min(1).nullable()
+}).strict();
+/** Stable hashing is independent of object insertion order and excludes no fields implicitly. */
+export function hashStudyAnalysisValue(value) {
+    const canonical = (input) => {
+        if (Array.isArray(input))
+            return input.map(canonical);
+        if (input !== null && typeof input === "object") {
+            return Object.fromEntries(Object.entries(input).sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)
+                .map(([key, entry]) => [key, canonical(entry)]));
+        }
+        return input;
+    };
+    return createHash("sha256").update(JSON.stringify(canonical(value))).digest("hex");
+}
+export function digestStudyAnalysisInput(input) {
+    return hashStudyAnalysisValue({ runId: input.runId, sourceRunSha256: input.sourceRunSha256,
+        participants: input.participants, coverage: input.coverage, evidence: input.evidence });
+}
+const distinct = (values) => new Set(values).size === values.length;
+export function checkAnalysisResult(input, value) {
+    const parsed = studyAnalysisResultSchema.safeParse(value);
+    if (!parsed.success)
+        return { ok: false, errors: ["ANALYSIS_RESULT_SCHEMA_INVALID"] };
+    const result = parsed.data;
+    const errors = new Set();
+    const included = new Set(input.coverage.includedStreamIds);
+    const evidence = new Map(input.evidence.map((entry) => [entry.id, entry]));
+    if (!distinct(input.coverage.includedStreamIds) || evidence.size !== input.evidence.length)
+        errors.add("ANALYSIS_INPUT_DUPLICATES");
+    if (!distinct(result.participants.map((participant) => participant.streamId))
+        || result.participants.length !== included.size
+        || result.participants.some((participant) => !included.has(participant.streamId)))
+        errors.add("ANALYSIS_PARTICIPANT_COVERAGE_INVALID");
+    for (const participant of result.participants) {
+        if (!distinct(participant.evidenceIds) || participant.evidenceIds.some((ref) => evidence.get(ref)?.streamId !== participant.streamId)) {
+            errors.add("ANALYSIS_PARTICIPANT_REFERENCE_INVALID");
+        }
+        if (participant.outcome !== "unknown" && participant.evidenceIds.length === 0)
+            errors.add("ANALYSIS_OUTCOME_WITHOUT_EVIDENCE");
+        for (const quote of participant.feedback) {
+            const entry = evidence.get(quote.evidenceId);
+            if (!entry || entry.streamId !== participant.streamId || !entry.quoteEligible || !entry.text.includes(quote.text)) {
+                errors.add("ANALYSIS_QUOTE_INVALID");
+            }
+        }
+    }
+    if (!distinct(result.findings.map((finding) => finding.id)))
+        errors.add("ANALYSIS_FINDING_ID_DUPLICATE");
+    for (const finding of result.findings) {
+        const exposed = new Set(finding.exposedStreamIds);
+        if (!distinct(finding.affectedStreamIds) || !distinct(finding.exposedStreamIds)
+            || finding.exposedStreamIds.some((stream) => !included.has(stream))
+            || finding.affectedStreamIds.some((stream) => !exposed.has(stream)))
+            errors.add("ANALYSIS_FINDING_MEMBERSHIP_INVALID");
+        const citedStreams = new Set();
+        for (const observation of finding.observations) {
+            const refs = observation.evidenceIds.map((ref) => evidence.get(ref));
+            if (!distinct(observation.evidenceIds) || refs.some((ref) => !ref || !included.has(ref.streamId)))
+                errors.add("ANALYSIS_OBSERVATION_REFERENCE_INVALID");
+            for (const ref of refs)
+                if (ref)
+                    citedStreams.add(ref.streamId);
+            if (observation.basis === "visual" && !refs.some((ref) => ref?.capture !== null && ref?.capture !== undefined))
+                errors.add("ANALYSIS_VISUAL_WITHOUT_CAPTURE");
+            if (observation.basis === "action" && !refs.some((ref) => ref && ["ui_action", "command", "tool_call", "file_change", "approval"].includes(ref.kind)))
+                errors.add("ANALYSIS_ACTION_SOURCE_INVALID");
+            if (observation.basis === "participant_statement" && refs.some((ref) => !ref?.quoteEligible))
+                errors.add("ANALYSIS_STATEMENT_SOURCE_INVALID");
+        }
+        if (finding.affectedStreamIds.some((stream) => !citedStreams.has(stream)))
+            errors.add("ANALYSIS_AFFECTED_WITHOUT_EVIDENCE");
+    }
+    return errors.size ? { ok: false, errors: [...errors] } : { ok: true, result };
+}
+export function validateAnalysisResult(input, value) {
+    const checked = checkAnalysisResult(input, value);
+    if (!checked.ok)
+        throw new Error(checked.errors.join(", "));
+    return checked.result;
+}
+export function validateStudyAnalysisArtifact(value) {
+    const parsed = studyAnalysisArtifactSchema.safeParse(value);
+    if (!parsed.success)
+        throw new Error("ANALYSIS_ARTIFACT_SCHEMA_INVALID");
+    const artifact = parsed.data;
+    if (artifact.configDigest !== hashStudyAnalysisValue(artifact.config)
+        || artifact.inputDigest !== digestStudyAnalysisInput(artifact))
+        throw new Error("ANALYSIS_DIGEST_INVALID");
+    if (Date.parse(artifact.completedAt) < Date.parse(artifact.createdAt))
+        throw new Error("ANALYSIS_TIME_INVALID");
+    const coverage = artifact.coverage;
+    const included = new Set(coverage.includedStreamIds);
+    const captureIds = new Set(artifact.evidence.filter((entry) => entry.capture !== null)
+        .map((entry) => `${entry.streamId}\0${entry.capture.eventId}`));
+    if (!distinct(coverage.includedStreamIds) || !distinct(coverage.omittedStreamIds)
+        || coverage.omittedStreamIds.some((stream) => included.has(stream))
+        || coverage.evidenceCount !== artifact.evidence.length || coverage.captureCount !== captureIds.size
+        || !distinct(artifact.evidence.map((entry) => entry.id))
+        || artifact.evidence.some((entry) => !included.has(entry.streamId)
+            || (entry.quoteEligible && !["message", "reasoning"].includes(entry.kind))
+            || (entry.capture !== null && entry.frame === null))
+        || (coverage.complete && (coverage.omittedStreamIds.length > 0 || coverage.omissions.length > 0))) {
+        throw new Error("ANALYSIS_COVERAGE_INVALID");
+    }
+    if (!distinct(artifact.participants.map((participant) => participant.streamId))
+        || artifact.participants.length !== included.size
+        || artifact.participants.some((participant) => !included.has(participant.streamId)))
+        throw new Error("ANALYSIS_PARTICIPANT_INPUT_INVALID");
+    assertAnalysisUsage(artifact.usage);
+    const hasResult = artifact.status === "complete" || artifact.status === "partial";
+    if (hasResult !== (artifact.result !== null)
+        || (hasResult && artifact.error !== null && !(artifact.status === "partial" && artifact.error === "analysis_admission_estimate_exceeded"))
+        || (!hasResult && artifact.error === null)
+        || (artifact.status === "complete" && !coverage.complete))
+        throw new Error("ANALYSIS_STATUS_INVALID");
+    if (artifact.result !== null)
+        validateAnalysisResult({ ...artifact, images: [] }, artifact.result);
+    return artifact;
+}
+export function validateStudyAnalysisCorrection(value) {
+    const parsed = studyAnalysisCorrectionSchema.safeParse(value);
+    if (!parsed.success || (parsed.data.status === "amended") !== (parsed.data.replacementClaim !== null)) {
+        throw new Error("ANALYSIS_CORRECTION_INVALID");
+    }
+    return parsed.data;
+}
+/** Accounting survives a stale source without retaining generated or participant text. */
+export const studyAnalysisExecutionReceiptSchema = studyAnalysisArtifactSchema.pick({
+    id: true,
+    runId: true,
+    status: true,
+    createdAt: true,
+    completedAt: true,
+    sourceRunSha256: true,
+    inputDigest: true,
+    configDigest: true,
+    promptVersion: true,
+    provider: true,
+    usage: true,
+    error: true
+}).extend({
+    schema: z.literal("humanish.analysis-execution.v1"),
+    model: studyAnalysisArtifactSchema.shape.config.shape.model,
+    maxCostUsd: studyAnalysisArtifactSchema.shape.config.shape.maxCostUsd
+}).strict();
+function assertAnalysisUsage(usage) {
+    if ((usage.usageComplete && (usage.inputTokens === null || usage.outputTokens === null))
+        || (!usage.dispatched && (usage.inputTokens !== null || usage.outputTokens !== null || usage.cachedInputTokens !== null
+            || usage.cacheWriteInputTokens !== null || usage.estimatedCostUsd !== null || usage.usageComplete))
+        || ((usage.cachedInputTokens !== null || usage.cacheWriteInputTokens !== null) && (usage.inputTokens === null
+            || (usage.cachedInputTokens ?? 0) + (usage.cacheWriteInputTokens ?? 0) > usage.inputTokens))) {
+        throw new Error("ANALYSIS_USAGE_INVALID");
+    }
+}
+export function validateStudyAnalysisExecutionReceipt(value) {
+    const parsed = studyAnalysisExecutionReceiptSchema.safeParse(value);
+    if (!parsed.success || Date.parse(parsed.data.completedAt) < Date.parse(parsed.data.createdAt))
+        throw new Error("ANALYSIS_RECEIPT_INVALID");
+    assertAnalysisUsage(parsed.data.usage);
+    return parsed.data;
+}
+const inputMetadataSchema = studyAnalysisArtifactSchema.pick({
+    runId: true, sourceRunSha256: true, inputDigest: true, participants: true, coverage: true, evidence: true
+});
+/** Validate the packet before any paid request, including typed-library callers. */
+export function validateStudyAnalysisInputMetadata(input) {
+    const parsed = inputMetadataSchema.safeParse({ runId: input.runId, sourceRunSha256: input.sourceRunSha256,
+        inputDigest: input.inputDigest, participants: input.participants, coverage: input.coverage, evidence: input.evidence });
+    if (!parsed.success || digestStudyAnalysisInput(parsed.data) !== input.inputDigest)
+        throw new Error("ANALYSIS_INPUT_INVALID");
+    const { coverage, evidence, participants } = parsed.data;
+    const included = new Set(coverage.includedStreamIds);
+    const captures = new Set(evidence.filter((entry) => entry.capture !== null).map((entry) => JSON.stringify([entry.streamId, entry.capture.eventId])));
+    if (!distinct(coverage.includedStreamIds) || !distinct(coverage.omittedStreamIds)
+        || coverage.omittedStreamIds.some((stream) => included.has(stream))
+        || !distinct(participants.map((participant) => participant.streamId)) || participants.length !== included.size
+        || participants.some((participant) => !included.has(participant.streamId))
+        || !distinct(evidence.map((entry) => entry.id))
+        || !distinct(evidence.map((entry) => JSON.stringify([entry.streamId, entry.kind, entry.eventId])))
+        || coverage.evidenceCount !== evidence.length || coverage.captureCount !== captures.size
+        || evidence.some((entry) => !included.has(entry.streamId)
+            || (entry.quoteEligible && !["message", "reasoning"].includes(entry.kind))
+            || (entry.capture !== null && (entry.frame === null || entry.capture.eventId !== entry.eventId)))
+        || (coverage.complete && (coverage.omissions.length > 0 || coverage.omittedStreamIds.length > 0)))
+        throw new Error("ANALYSIS_INPUT_INVALID");
+}
+//# sourceMappingURL=study-analysis-validation.js.map

package/dist/study-analysis-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"study-analysis-validation.js","sourceRoot":"","sources":["../src/study-analysis-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,qBAAqB,EACrB,gCAAgC,EAMjC,MAAM,qBAAqB,CAAC;AAE7B,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,kCAAkC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC,CAAC;AACtI,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC/B,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;AAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAClC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACxD,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC7C,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACzC,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC7B,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;QAChF,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QACjC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QACzF,WAAW;KACZ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACrB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACzB,EAAE;QACF,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QACrE,iBAAiB,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QACnC,gBAAgB,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QAClC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACjC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;QAC1D,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;YAC7B,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACxB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,uBAAuB,EAAE,WAAW,CAAC,CAAC;YACzE,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC;SACvB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3B,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;KAClC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACrB,WAAW;CACZ,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,YAAY,CAAC,yBAAyB,CAAC,CAAC;AAEvF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,iBAAiB,EAAE,SAAS;IAC5B,gBAAgB,EAAE,SAAS;IAC3B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IAChD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC7C,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,SAAS,EAAE,WAAW;CACvB,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAChE,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC;OAC9B,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;OACtB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,EAAE,wBAAwB,CAAC,CAAC;AAE/G,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,EAAE;IACF,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,QAAQ;IACjB,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;IACjB,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;IAC1B,EAAE,EAAE,SAAS,CAAC,QAAQ,EAAE;IACxB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;IAC1E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;IACrD,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;KAC5D,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACvB,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/D,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvG,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,SAAS,EAAE,kBAAkB,EAAE,WAAW;QACtG,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9E,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,uBAAuB,EAAE,sBAAsB,EAAE,YAAY,EAAE,aAAa;QAC7F,mBAAmB,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAC,QAAQ,EAAE;IAChH,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,aAAa,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzF,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC7B,MAAM,EAAE,QAAQ;QAChB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;QACtB,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;QACvB,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;KACtE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,EACrG,4BAA4B,CAAC,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC;IACxC,EAAE;IACF,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC9D,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,SAAS;IACtB,eAAe,EAAE,MAAM;IACvB,WAAW,EAAE,MAAM;IACnB,YAAY,EAAE,MAAM;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;QAC/B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;QAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;QACnD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC;KACzD,CAAC,CAAC,MAAM,EAAE;IACX,aAAa,EAAE,KAAK;IACpB,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;QACnE,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;QAC/D,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;QAC1B,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;QACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;QAC7D,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QAC5D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;QACzD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;QAC1D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;KACxD,CAAC,CAAC,MAAM,EAAE;IACX,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC7B,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC;QACjB,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;QACjC,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;QACrC,UAAU,EAAE,wCAAwC;KACrD,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACrB,QAAQ,EAAE,2BAA2B;IACrC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACxD,MAAM,EAAE,yBAAyB,CAAC,QAAQ,EAAE;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC,QAAQ,EAAE;CACpE,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,gCAAgC,CAAC;IACnD,EAAE;IACF,UAAU,EAAE,EAAE;IACd,cAAc,EAAE,MAAM;IACtB,SAAS,EAAE,EAAE;IACb,aAAa,EAAE,MAAM;IACrB,SAAS,EAAE,SAAS;IACpB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IACrD,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC/C,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,iGAAiG;AACjG,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,MAAM,SAAS,GAAG,CAAC,KAAc,EAAW,EAAE;QAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAChD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;iBAC3F,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAuG;IAC9I,OAAO,sBAAsB,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe;QACxF,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC5F,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,MAAyB,EAAW,EAAE,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC;AAEhG,MAAM,UAAU,mBAAmB,CAAC,KAAyB,EAAE,KAAc;IAE3E,MAAM,MAAM,GAAG,yBAAyB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,gCAAgC,CAAC,EAAE,CAAC;IACtF,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC;IAC3B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3E,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,CAAC,QAAQ,CAAC,MAAM;QAAE,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACpI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;WACxE,MAAM,CAAC,YAAY,CAAC,MAAM,KAAK,QAAQ,CAAC,IAAI;WAC5C,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAAE,MAAM,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;IACzI,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,KAAK,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtI,MAAM,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,WAAW,CAAC,OAAO,KAAK,SAAS,IAAI,WAAW,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QAC/H,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,WAAW,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClH,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAAE,MAAM,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IACzG,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC;eAC1E,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;eAChE,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QACzH,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;QACvC,KAAK,MAAM,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YACrE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;YACxJ,KAAK,MAAM,GAAG,IAAI,IAAI;gBAAE,IAAI,GAAG;oBAAE,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAChE,IAAI,WAAW,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,IAAI,GAAG,EAAE,OAAO,KAAK,SAAS,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;YAC9J,IAAI,WAAW,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;YACpM,IAAI,WAAW,CAAC,KAAK,KAAK,uBAAuB,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,aAAa,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;QAChJ,CAAC;QACD,IAAI,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IAC9H,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAyB,EAAE,KAAc;IAC9E,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAc;IAC1D,MAAM,MAAM,GAAG,2BAA2B,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5D,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;IAC7B,IAAI,QAAQ,CAAC,YAAY,KAAK,sBAAsB,CAAC,QAAQ,CAAC,MAAM,CAAC;WAChE,QAAQ,CAAC,WAAW,KAAK,wBAAwB,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7G,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAChH,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC;SACnF,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,OAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC;WAC5E,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;WAChE,QAAQ,CAAC,aAAa,KAAK,QAAQ,CAAC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,YAAY,KAAK,UAAU,CAAC,IAAI;WAChG,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;WACrD,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;eAC7D,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;eACvE,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;WACnD,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpG,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;WAC1E,QAAQ,CAAC,YAAY,CAAC,MAAM,KAAK,QAAQ,CAAC,IAAI;WAC9C,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAC7I,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,KAAK,UAAU,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC;IAClF,IAAI,SAAS,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC;WACvC,CAAC,SAAS,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,KAAK,KAAK,sCAAsC,CAAC,CAAC;WACvI,CAAC,CAAC,SAAS,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,CAAC;WACvC,CAAC,QAAQ,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACxG,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI;QAAE,sBAAsB,CAAC,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnG,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,KAAc;IAC5D,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,KAAK,IAAI,CAAC,EAAE,CAAC;QACtG,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,0FAA0F;AAC1F,MAAM,CAAC,MAAM,mCAAmC,GAAG,2BAA2B,CAAC,IAAI,CAAC;IAClF,EAAE,EAAE,IAAI;IACR,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,IAAI;IACjB,eAAe,EAAE,IAAI;IACrB,WAAW,EAAE,IAAI;IACjB,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE,IAAI;IACnB,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,IAAI;CACZ,CAAC,CAAC,MAAM,CAAC;IACR,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,gCAAgC,CAAC;IACnD,KAAK,EAAE,2BAA2B,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK;IAC3D,UAAU,EAAE,2BAA2B,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU;CACtE,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,SAAS,mBAAmB,CAAC,KAAoB;IAC/C,IAAI,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,WAAW,KAAK,IAAI,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC;WACnF,CAAC,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,WAAW,KAAK,IAAI,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,IAAI,KAAK,CAAC,iBAAiB,KAAK,IAAI;eAClH,KAAK,CAAC,qBAAqB,KAAK,IAAI,IAAI,KAAK,CAAC,gBAAgB,KAAK,IAAI,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;WAClG,CAAC,CAAC,KAAK,CAAC,iBAAiB,KAAK,IAAI,IAAI,KAAK,CAAC,qBAAqB,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,KAAK,IAAI;eACxG,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,qBAAqB,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QACjG,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,KAAc;IAClE,MAAM,MAAM,GAAG,mCAAmC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACpE,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC5I,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,mBAAmB,GAAG,2BAA2B,CAAC,IAAI,CAAC;IAC3D,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI;CAC1G,CAAC,CAAC;AAEH,oFAAoF;AACpF,MAAM,UAAU,kCAAkC,CAAC,KAAyB;IAC1E,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe;QACvG,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC1H,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,wBAAwB,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC9H,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IACzD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACtJ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC;WAC5E,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;WAChE,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,IAAI,YAAY,CAAC,MAAM,KAAK,QAAQ,CAAC,IAAI;WAC3G,YAAY,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;WACvE,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;WAC5C,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;WAC/F,QAAQ,CAAC,aAAa,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,YAAY,KAAK,QAAQ,CAAC,IAAI;WACrF,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;eACpD,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;eACvE,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;WAChG,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;AACjJ,CAAC"}

package/dist/study-analysis.d.ts

@@ -0,0 +1,167 @@
+import type { ActorStatus, ActorCompletionReason, ActorStopCause, ParticipantDeclaredOutcome } from "./actor-contract.js";
+import type { CuaGoalSource } from "./actor-goal-source.js";
+/** Independent interpretation of retained evidence; never a participant or harness verdict. */
+export declare const STUDY_ANALYSIS_SCHEMA: "humanish.study-analysis.v1";
+export declare const STUDY_ANALYSIS_CORRECTION_SCHEMA: "humanish.study-analysis-correction.v1";
+export type AnalysisStatus = "complete" | "partial" | "failed" | "cancelled";
+export type AnalysisOutcome = "completed" | "blocked" | "abandoned" | "interrupted" | "unknown";
+export type AnalysisBasis = "visual" | "action" | "participant_statement" | "inference";
+export interface AnalysisEvidence {
+    /** Opaque packet-local key; model output never supplies a filesystem path. */
+    id: string;
+    streamId: string;
+    eventId: string;
+    kind: string;
+    text: string;
+    quoteEligible: boolean;
+    at: string | null;
+    /** Relative to first retained capture, not a video offset; null for nonvisual evidence. */
+    elapsedMs: number | null;
+    frame: number | null;
+    capture: {
+        eventId: string;
+        path: string;
+        sha256: string;
+        mimeType: "image/png" | "image/jpeg" | "image/webp";
+    } | null;
+}
+export interface AnalysisCoverage {
+    includedStreamIds: string[];
+    omittedStreamIds: string[];
+    evidenceCount: number;
+    captureCount: number;
+    complete: boolean;
+    omissions: string[];
+}
+export interface AnalysisParticipantInput {
+    streamId: string;
+    label: string;
+    assignment: string | null;
+    recordedStatus: string;
+    recordedReason: string | null;
+    provenance: {
+        actorStatus: ActorStatus | null;
+        completionReason: ActorCompletionReason | null;
+        stopCause: ActorStopCause | null;
+        goalSource: CuaGoalSource | null;
+        declaredOutcome: ParticipantDeclaredOutcome | null;
+        taskOutcomes: Array<{
+            taskId: string;
+            completed: boolean;
+            observable: boolean;
+            inputsObserved: boolean | null;
+            turn: number | null;
+        }> | null;
+    };
+}
+export interface StudyAnalysisInput {
+    runId: string;
+    sourceRunSha256: string;
+    inputDigest: string;
+    participants: AnalysisParticipantInput[];
+    coverage: AnalysisCoverage;
+    evidence: AnalysisEvidence[];
+    /** Ephemeral input only: never persisted in the analysis artifact. */
+    images: {
+        evidenceId: string;
+        dataUrl: string;
+    }[];
+}
+export interface AnalysisQuote {
+    evidenceId: string;
+    text: string;
+}
+export interface AnalysisParticipantReview {
+    streamId: string;
+    summary: string;
+    intent: string;
+    outcome: AnalysisOutcome;
+    outcomeReason: string;
+    evidenceIds: string[];
+    feedback: AnalysisQuote[];
+    limitations: string[];
+}
+export interface AnalysisObservation {
+    claim: string;
+    basis: AnalysisBasis;
+    evidenceIds: string[];
+    limitation: string;
+}
+export interface AnalysisFinding {
+    id: string;
+    title: string;
+    summary: string;
+    impact: "blocked_task" | "friction" | "recovery" | "uncertain";
+    affectedStreamIds: string[];
+    exposedStreamIds: string[];
+    exposureReason: string;
+    recovery: "recovered" | "not_observed" | "unknown";
+    confidence: "low" | "medium" | "high";
+    observations: AnalysisObservation[];
+    nextStep: string;
+    priorityReason: string;
+}
+export interface StudyAnalysisResult {
+    summary: string;
+    participants: AnalysisParticipantReview[];
+    /** Highest priority first; counts are derived from distinct stream sets. */
+    findings: AnalysisFinding[];
+    limitations: string[];
+}
+export interface StudyAnalysisConfig {
+    model: string;
+    question: string | null;
+    maxCostUsd: number;
+    timeoutMs: number;
+    maxOutputTokens: number;
+}
+export interface AnalysisUsage {
+    inputTokens: number | null;
+    outputTokens: number | null;
+    estimatedCostUsd: number | null;
+    cachedInputTokens: number | null;
+    cacheWriteInputTokens: number | null;
+    usageComplete: boolean;
+    dispatched: boolean;
+    ratesAsOf: string | null;
+    estimatedAdmissionUsd: number | null;
+}
+export interface StudyAnalysisArtifact {
+    schema: typeof STUDY_ANALYSIS_SCHEMA;
+    id: string;
+    runId: string;
+    status: AnalysisStatus;
+    createdAt: string;
+    completedAt: string;
+    sourceRunSha256: string;
+    inputDigest: string;
+    configDigest: string;
+    config: StudyAnalysisConfig;
+    promptVersion: string;
+    provider: "openai";
+    usage: AnalysisUsage;
+    participants: AnalysisParticipantInput[];
+    coverage: AnalysisCoverage;
+    evidence: AnalysisEvidence[];
+    result: StudyAnalysisResult | null;
+    /** Safe stable failure code, never a provider error payload. */
+    error: string | null;
+}
+export interface StudyAnalysisCorrection {
+    schema: typeof STUDY_ANALYSIS_CORRECTION_SCHEMA;
+    id: string;
+    analysisId: string;
+    analysisSha256: string;
+    findingId: string;
+    findingSha256: string;
+    createdAt: string;
+    status: "confirmed" | "dismissed" | "amended";
+    reason: string;
+    replacementClaim: string | null;
+}
+export interface LoadedStudyAnalysis {
+    state: "none" | "ready" | "stale" | "invalid";
+    analysis: StudyAnalysisArtifact | null;
+    corrections: StudyAnalysisCorrection[];
+    warnings: string[];
+}

package/dist/study-analysis.js

@@ -0,0 +1,4 @@
+/** Independent interpretation of retained evidence; never a participant or harness verdict. */
+export const STUDY_ANALYSIS_SCHEMA = "humanish.study-analysis.v1";
+export const STUDY_ANALYSIS_CORRECTION_SCHEMA = "humanish.study-analysis-correction.v1";
+//# sourceMappingURL=study-analysis.js.map

package/dist/study-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"study-analysis.js","sourceRoot":"","sources":["../src/study-analysis.ts"],"names":[],"mappings":"AAGA,+FAA+F;AAC/F,MAAM,CAAC,MAAM,qBAAqB,GAAG,4BAAqC,CAAC;AAC3E,MAAM,CAAC,MAAM,gCAAgC,GAAG,uCAAgD,CAAC"}

package/docs/architecture/observer.md

@@ -187,13 +187,22 @@ entry-point capabilities, timing limits and browser acceptance commands.
 
 The Observer shell has:
 
-- top mission-control band with run status and metrics;
+- a persistent study library and a compact study header;
+- Participants and Findings views that share the same shell geometry;
 - stream filters for UI, CLI, TUI, and Codex UI lanes;
 - grid mode with one tile per sim stream;
 - focus mode with left stream rail, center stage, and right tabs;
 - terminal/TUI transcript stage;
 - right evidence rail for events, artifacts, and known gaps.
 
+Findings use the independent [study analysis contract](../contracts/study-analysis.md).
+The renderer injects a separate JSON slot and HTTP companion; it does not extend
+the frozen Observer data schema or start provider requests. Analysis polling has
+an independent lifecycle, so a delayed companion does not stall recording updates.
+Invalid or stale interpretation never overwrites original participant outcomes.
+Recording navigation retains its originating view, and nonvisual citations open
+the source event rather than inventing a playback frame.
+
 The participant grid uses equal-height previews whose widths follow each screen's
 aspect ratio. A 44px identity/source/outcome caption sits below the captured pixels;
 no badges or controls cover the screen. Generated computer-use lane labels display

package/docs/contracts/feedback.md

@@ -58,6 +58,10 @@ setup-quality gap, ceremonial/absent study quality, target-app blocker, or
 Humanish CLI blocker. The OSS
 meta-lab is one maintainer dogfood example, not the only candidate source.
 
+The list also shows any saved draft. An empty `candidates` array means no usable
+candidate was recorded; it does not mean a run-summary draft is unavailable.
+Listing does not create a draft or check public-sharing eligibility.
+
 For completed computer-use sessions, participant-reported friction comes from
 the redacted closing report and observed-report clauses in earlier messages.
 Matching `stopWhen` or ending a dwell window does not discard an earlier
@@ -74,9 +78,11 @@ was not repeated in the message trace.
 
 ### `draft`
 
-Builds structured feedback from the strongest run candidate first. If no
-candidate is present, falls back to the dry-run contract follow-up. Writes a
-draft under the run bundle, not GitHub.
+Builds structured feedback from the first usable run candidate, or the candidate
+selected with `--candidate`. With no candidate, a dry run produces a contract
+follow-up and a live run produces a summary of its recorded review. These
+fallbacks do not add a finding to the candidate list. All drafts require a
+verified `share_ready` run and are written under the run bundle, not GitHub.
 
 ### `verify`
 

package/docs/contracts/schemas.md

@@ -3,7 +3,7 @@
 Date: 2026-06-02 (current-state note updated 2026-07-14)
 
 Status: reference map for the major contracts shipped through source version
-`0.88.2`; it is not an exhaustive inventory of command/result envelopes. Exported types,
+`0.89.1`; it is not an exhaustive inventory of command/result envelopes. Exported types,
 schema constants, parsers, and validators in `src/` are authoritative. Rows
 marked "reserved" name layering intent only — no code emits or validates them
 yet. Do not emit a reserved schema.
@@ -38,6 +38,9 @@ workflow without leaking private upstream truth into core.
 | Substrate | reserved (never shipped) | none |
 | Evidence stream | reserved (streams live inside the run bundle) | see [`run-bundle.md`](run-bundle.md) |
 | Review | `humanish.review.v1` | `contract-proof-review` |
+| Study analysis | `humanish.study-analysis.v1` | see [study analysis](study-analysis.md) and synthetic analysis fixtures in `tests/` |
+| Study analysis correction | `humanish.study-analysis-correction.v1` | see [study analysis](study-analysis.md#human-review-and-sharing) |
+| Analysis execution receipt | `humanish.analysis-execution.v1` | see [study analysis](study-analysis.md#durable-records) |
 | Verification | `humanish.verify-result.v1` | `five-check-verify` |
 | Policy | `humanish.policy.v1` (fixture-only; not engine-validated) | `public-safety-policy` |
 | Feedback | `humanish.feedback.v1` | `public-safe-feedback` |