@jinn-network/plugin 0.1.0

package/dist/schemas/episode.d.ts

@@ -0,0 +1,432 @@
+/**
+ * EpisodeV1 — the complete-trajectory evidence record (architecture spec §5).
+ * Superset of `packages/core/src/captured-task.ts`'s CapturedTask:
+ * the full trajectory as one ordered `kind`-discriminated span sequence, a
+ * skills loadout, token + USD cost, a per-record retention field, and optional
+ * lineage hooks. Strict at every level (unknown fields rejected), following the
+ * capture.ts / envelope.ts convention.
+ *
+ * Deviation from CapturedTask, noted per plan (#1658): `task.distributionTags`
+ * defaults to `[]` rather than requiring `.min(1)` — Stage 1 has no tagging
+ * policy yet (S1-F2). `trajectory` is one ordered span sequence (`.min(1)`; a
+ * zero-tool-call session still has ≥1 `jinn.agent_turn` step). `cost.usdEstimate`
+ * is restored (optional) so EpisodeV1 stays a true CapturedTask superset.
+ */
+import { z } from 'zod';
+export declare const EPISODE_SCHEMA_VERSION: "jinn.episode.v1";
+export declare const EPISODE_PROVENANCES: readonly ["contributed", "imported", "derived-from-history"];
+export declare const EpisodeProvenanceSchema: z.ZodEnum<{
+    contributed: "contributed";
+    imported: "imported";
+    "derived-from-history": "derived-from-history";
+}>;
+export declare const SessionActivityFactsWriteSchema: z.ZodObject<{
+    retrievalFired: z.ZodBoolean;
+    eligibleRefs: z.ZodArray<z.ZodString>;
+    deliveredRefs: z.ZodArray<z.ZodString>;
+    deliveryMode: z.ZodEnum<{
+        degraded: "degraded";
+        disabled: "disabled";
+        delivered: "delivered";
+        withheld: "withheld";
+    }>;
+    deliveredContentHash: z.ZodOptional<z.ZodString>;
+    searchedTerms: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    providedRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    surfacedRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    fetchedRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    installedSkillRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export declare const VERIFICATION_STRENGTHS: readonly ["user-accepted", "tests-passed", "evaluator-verified"];
+export declare const VerificationStrengthSchema: z.ZodEnum<{
+    "user-accepted": "user-accepted";
+    "tests-passed": "tests-passed";
+    "evaluator-verified": "evaluator-verified";
+}>;
+export declare const EpisodeV1WriteSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"jinn.episode.v1">;
+    episodeId: z.ZodString;
+    retrievalVisible: z.ZodDefault<z.ZodBoolean>;
+    session: z.ZodObject<{
+        sessionId: z.ZodString;
+        capturedAt: z.ZodISODateTime;
+        kind: z.ZodEnum<{
+            user: "user";
+            "host-internal": "host-internal";
+        }>;
+        parentSessionId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    origin: z.ZodObject<{
+        writer: z.ZodString;
+        build: z.ZodString;
+    }, z.core.$strict>;
+    task: z.ZodObject<{
+        summary: z.ZodString;
+        distributionTags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        repositorySlug: z.ZodOptional<z.ZodString>;
+        baseCommit: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodOptional<z.ZodNumber>;
+        instanceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    trajectory: z.ZodArray<z.ZodObject<{
+        spanId: z.ZodString;
+        parentSpanId: z.ZodNullable<z.ZodString>;
+        kind: z.ZodEnum<{
+            "jinn.agent_turn": "jinn.agent_turn";
+            "jinn.tool_call": "jinn.tool_call";
+        }>;
+        name: z.ZodString;
+        startTimeUnixNano: z.ZodString;
+        endTimeUnixNano: z.ZodString;
+        attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        redactedKeys: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        truncatedKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        events: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            timeUnixNano: z.ZodString;
+            name: z.ZodString;
+            attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>>>;
+        status: z.ZodOptional<z.ZodObject<{
+            code: z.ZodEnum<{
+                UNSET: "UNSET";
+                OK: "OK";
+                ERROR: "ERROR";
+            }>;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    environment: z.ZodObject<{
+        harness: z.ZodObject<{
+            name: z.ZodString;
+            version: z.ZodString;
+        }, z.core.$strict>;
+        model: z.ZodString;
+        tools: z.ZodArray<z.ZodString>;
+        skillsLoadout: z.ZodArray<z.ZodString>;
+        generatorModel: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            provider: z.ZodOptional<z.ZodString>;
+            openWeights: z.ZodOptional<z.ZodBoolean>;
+            source: z.ZodEnum<{
+                stream: "stream";
+                config: "config";
+            }>;
+        }, z.core.$strict>>;
+        distributionClass: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            open: "open";
+            "restricted-tos": "restricted-tos";
+        }>>;
+        verifier: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"f2p-p2p">;
+            failToPass: z.ZodArray<z.ZodString>;
+            passToPass: z.ZodArray<z.ZodString>;
+            evalSemanticsVersion: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodEnum<{
+                command: "command";
+                none: "none";
+            }>;
+            failToPass: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            passToPass: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            evalSemanticsVersion: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>;
+    outcome: z.ZodPreprocess<z.ZodObject<{
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            abandoned: "abandoned";
+        }>;
+        verificationStrength: z.ZodEnum<{
+            "user-accepted": "user-accepted";
+            "tests-passed": "tests-passed";
+            "evaluator-verified": "evaluator-verified";
+        }>;
+        summary: z.ZodOptional<z.ZodString>;
+        acceptedDiff: z.ZodOptional<z.ZodBoolean>;
+        testRuns: z.ZodOptional<z.ZodObject<{
+            passed: z.ZodNumber;
+            failed: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    cost: z.ZodObject<{
+        durationMs: z.ZodNumber;
+        tokens: z.ZodOptional<z.ZodObject<{
+            input: z.ZodNumber;
+            output: z.ZodNumber;
+        }, z.core.$strict>>;
+        usdEstimate: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+    retention: z.ZodObject<{
+        policy: z.ZodEnum<{
+            "local-private": "local-private";
+            "contribution-eligible": "contribution-eligible";
+        }>;
+    }, z.core.$strict>;
+    provenance: z.ZodDefault<z.ZodEnum<{
+        contributed: "contributed";
+        imported: "imported";
+        "derived-from-history": "derived-from-history";
+    }>>;
+    lineage: z.ZodOptional<z.ZodObject<{
+        episodeId: z.ZodString;
+        mintRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    attemptGroup: z.ZodOptional<z.ZodObject<{
+        groupId: z.ZodString;
+        attemptId: z.ZodString;
+        relatedAttemptRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        groupSize: z.ZodOptional<z.ZodNumber>;
+        nPass: z.ZodOptional<z.ZodNumber>;
+        nFail: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    activity: z.ZodOptional<z.ZodObject<{
+        retrievalFired: z.ZodBoolean;
+        eligibleRefs: z.ZodArray<z.ZodString>;
+        deliveredRefs: z.ZodArray<z.ZodString>;
+        deliveryMode: z.ZodEnum<{
+            degraded: "degraded";
+            disabled: "disabled";
+            delivered: "delivered";
+            withheld: "withheld";
+        }>;
+        deliveredContentHash: z.ZodOptional<z.ZodString>;
+        searchedTerms: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        providedRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        surfacedRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        fetchedRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        installedSkillRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    eligibility: z.ZodOptional<z.ZodObject<{
+        eligible: z.ZodBoolean;
+        reason: z.ZodString;
+        checkedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    contributionCandidate: z.ZodOptional<z.ZodObject<{
+        testRuns: z.ZodArray<z.ZodObject<{
+            command: z.ZodString;
+            exitCode: z.ZodNumber;
+            at: z.ZodISODateTime;
+        }, z.core.$strict>>;
+        skillEvents: z.ZodArray<z.ZodObject<{
+            skillRef: z.ZodString;
+            action: z.ZodEnum<{
+                loaded: "loaded";
+                invoked: "invoked";
+            }>;
+        }, z.core.$strict>>;
+        schemaVersion: z.ZodLiteral<"jinn.contribution-candidate.v1">;
+        sourceId: z.ZodString;
+        repositorySlug: z.ZodString;
+        baseCommit: z.ZodString;
+        acceptedDiff: z.ZodString;
+        intermediateFailureDiffs: z.ZodArray<z.ZodString>;
+        publishMinedTasksConsent: z.ZodBoolean;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const SessionActivityFactsSchema: z.ZodPreprocess<z.ZodObject<{
+    retrievalFired: z.ZodBoolean;
+    eligibleRefs: z.ZodArray<z.ZodString>;
+    deliveredRefs: z.ZodArray<z.ZodString>;
+    deliveryMode: z.ZodEnum<{
+        degraded: "degraded";
+        disabled: "disabled";
+        delivered: "delivered";
+        withheld: "withheld";
+    }>;
+    deliveredContentHash: z.ZodOptional<z.ZodString>;
+    searchedTerms: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    providedRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    surfacedRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    fetchedRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    installedSkillRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$loose>>;
+export declare const EpisodeV1Schema: z.ZodPreprocess<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"jinn.episode.v1">;
+    episodeId: z.ZodString;
+    retrievalVisible: z.ZodDefault<z.ZodBoolean>;
+    session: z.ZodObject<{
+        sessionId: z.ZodString;
+        capturedAt: z.ZodISODateTime;
+        kind: z.ZodEnum<{
+            user: "user";
+            "host-internal": "host-internal";
+        }>;
+        parentSessionId: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    origin: z.ZodUnion<readonly [z.ZodObject<{
+        writer: z.ZodString;
+        build: z.ZodString;
+    }, z.core.$loose>, z.ZodLiteral<"legacy-unstamped">]>;
+    task: z.ZodObject<{
+        summary: z.ZodString;
+        distributionTags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        repositorySlug: z.ZodOptional<z.ZodString>;
+        baseCommit: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodOptional<z.ZodNumber>;
+        instanceId: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    trajectory: z.ZodArray<z.ZodObject<{
+        spanId: z.ZodString;
+        parentSpanId: z.ZodNullable<z.ZodString>;
+        kind: z.ZodEnum<{
+            "jinn.agent_turn": "jinn.agent_turn";
+            "jinn.tool_call": "jinn.tool_call";
+        }>;
+        name: z.ZodString;
+        startTimeUnixNano: z.ZodString;
+        endTimeUnixNano: z.ZodString;
+        attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        redactedKeys: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        truncatedKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        events: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            timeUnixNano: z.ZodString;
+            name: z.ZodString;
+            attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strict>>>;
+        status: z.ZodOptional<z.ZodObject<{
+            code: z.ZodEnum<{
+                UNSET: "UNSET";
+                OK: "OK";
+                ERROR: "ERROR";
+            }>;
+            message: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$loose>>;
+    environment: z.ZodObject<{
+        harness: z.ZodObject<{
+            name: z.ZodString;
+            version: z.ZodString;
+        }, z.core.$loose>;
+        model: z.ZodString;
+        tools: z.ZodArray<z.ZodString>;
+        skillsLoadout: z.ZodArray<z.ZodString>;
+        generatorModel: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            provider: z.ZodOptional<z.ZodString>;
+            openWeights: z.ZodOptional<z.ZodBoolean>;
+            source: z.ZodEnum<{
+                stream: "stream";
+                config: "config";
+            }>;
+        }, z.core.$loose>>;
+        distributionClass: z.ZodOptional<z.ZodEnum<{
+            unknown: "unknown";
+            open: "open";
+            "restricted-tos": "restricted-tos";
+        }>>;
+        verifier: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"f2p-p2p">;
+            failToPass: z.ZodArray<z.ZodString>;
+            passToPass: z.ZodArray<z.ZodString>;
+            evalSemanticsVersion: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            type: z.ZodEnum<{
+                command: "command";
+                none: "none";
+            }>;
+            failToPass: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            passToPass: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            evalSemanticsVersion: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>], "type">>;
+    }, z.core.$loose>;
+    outcome: z.ZodObject<{
+        testRuns: z.ZodOptional<z.ZodObject<{
+            passed: z.ZodNumber;
+            failed: z.ZodNumber;
+        }, z.core.$loose>>;
+        status: z.ZodEnum<{
+            completed: "completed";
+            failed: "failed";
+            abandoned: "abandoned";
+        }>;
+        verificationStrength: z.ZodEnum<{
+            "user-accepted": "user-accepted";
+            "tests-passed": "tests-passed";
+            "evaluator-verified": "evaluator-verified";
+        }>;
+        summary: z.ZodOptional<z.ZodString>;
+        acceptedDiff: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$loose>;
+    cost: z.ZodObject<{
+        tokens: z.ZodOptional<z.ZodObject<{
+            input: z.ZodNumber;
+            output: z.ZodNumber;
+        }, z.core.$loose>>;
+        durationMs: z.ZodNumber;
+        usdEstimate: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    retention: z.ZodObject<{
+        policy: z.ZodEnum<{
+            "local-private": "local-private";
+            "contribution-eligible": "contribution-eligible";
+        }>;
+    }, z.core.$loose>;
+    provenance: z.ZodDefault<z.ZodEnum<{
+        contributed: "contributed";
+        imported: "imported";
+        "derived-from-history": "derived-from-history";
+    }>>;
+    lineage: z.ZodOptional<z.ZodObject<{
+        episodeId: z.ZodString;
+        mintRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+    attemptGroup: z.ZodOptional<z.ZodObject<{
+        groupId: z.ZodString;
+        attemptId: z.ZodString;
+        relatedAttemptRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        groupSize: z.ZodOptional<z.ZodNumber>;
+        nPass: z.ZodOptional<z.ZodNumber>;
+        nFail: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>>;
+    activity: z.ZodOptional<z.ZodObject<{
+        retrievalFired: z.ZodBoolean;
+        eligibleRefs: z.ZodArray<z.ZodString>;
+        deliveredRefs: z.ZodArray<z.ZodString>;
+        deliveryMode: z.ZodEnum<{
+            degraded: "degraded";
+            disabled: "disabled";
+            delivered: "delivered";
+            withheld: "withheld";
+        }>;
+        deliveredContentHash: z.ZodOptional<z.ZodString>;
+        searchedTerms: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        providedRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        surfacedRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        fetchedRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        installedSkillRefs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$loose>>;
+    eligibility: z.ZodOptional<z.ZodObject<{
+        eligible: z.ZodBoolean;
+        reason: z.ZodString;
+        checkedAt: z.ZodISODateTime;
+    }, z.core.$loose>>;
+    contributionCandidate: z.ZodOptional<z.ZodObject<{
+        testRuns: z.ZodArray<z.ZodObject<{
+            command: z.ZodString;
+            exitCode: z.ZodNumber;
+            at: z.ZodISODateTime;
+        }, z.core.$loose>>;
+        skillEvents: z.ZodArray<z.ZodObject<{
+            skillRef: z.ZodString;
+            action: z.ZodEnum<{
+                loaded: "loaded";
+                invoked: "invoked";
+            }>;
+        }, z.core.$loose>>;
+        schemaVersion: z.ZodLiteral<"jinn.contribution-candidate.v1">;
+        sourceId: z.ZodString;
+        repositorySlug: z.ZodString;
+        baseCommit: z.ZodString;
+        acceptedDiff: z.ZodString;
+        intermediateFailureDiffs: z.ZodArray<z.ZodString>;
+        publishMinedTasksConsent: z.ZodBoolean;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$loose>>;
+}, z.core.$loose>>;
+export type EpisodeV1 = z.infer<typeof EpisodeV1Schema>;
+export type SessionActivityFacts = z.infer<typeof SessionActivityFactsSchema>;
+export type EpisodeV1Write = z.infer<typeof EpisodeV1WriteSchema>;
+export type VerificationStrength = z.infer<typeof VerificationStrengthSchema>;