@stigmer/runner 0.1.0-dev.20261017020314.g644422724c27

package/dist/gen/turn/ai/stigmer/runner/turn/v1/enum_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum_pb.js","sourceRoot":"","sources":["../../../../../../../../src/gen/turn/ai/stigmer/runner/turn/v1/enum_pb.ts"],"names":[],"mappings":"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"}

package/dist/gen/turn/ai/stigmer/runner/turn/v1/ledger_pb.d.ts

@@ -0,0 +1,402 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv1";
+import type { DiffCompleteness } from "@stigmer/apis/ai/stigmer/agentic/run/v1/enum_pb";
+import type { CapturedFileChange, SnapshotRef, TurnCommandProvenance } from "@stigmer/apis/ai/stigmer/agentic/run/v1/filereview_pb";
+import type { FileDecisionAction, FileDecisionOrigin, FileDecisionScope, FileReviewEventType, FileReviewFailureKind } from "./enum_pb.js";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ai/stigmer/runner/turn/v1/ledger.proto.
+ */
+export declare const file_ai_stigmer_runner_turn_v1_ledger: GenFile;
+/**
+ * One human decision on a change set or a single file within it.
+ *
+ * Bound to content by expected_digest: the runner's reconcile applies the
+ * decision only when the target's current digest still matches what the user
+ * saw, so "what you approve is what gets applied". expected_digest is an
+ * ENFORCEMENT gate, never a correlation key — correlation is by change_set_id
+ * (+ file_change_id for FILE scope).
+ *
+ * @generated from message ai.stigmer.runner.turn.v1.FileDecision
+ */
+export type FileDecision = Message<"ai.stigmer.runner.turn.v1.FileDecision"> & {
+    /**
+     * Stable id of this decision.
+     *
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * The change set this decision targets (correlation key).
+     *
+     * @generated from field: string change_set_id = 2;
+     */
+    changeSetId: string;
+    /**
+     * Whether the decision applies to the whole change set or one file. HUNK is
+     * intentionally deferred. See FileDecisionScope.
+     *
+     * @generated from field: ai.stigmer.runner.turn.v1.FileDecisionScope scope = 3;
+     */
+    scope: FileDecisionScope;
+    /**
+     * The CapturedFileChange this decision targets; set only when scope is FILE
+     * (correlation key). Empty for CHANGE_SET scope.
+     *
+     * @generated from field: string file_change_id = 4;
+     */
+    fileChangeId: string;
+    /**
+     * Approve or reject. See FileDecisionAction.
+     *
+     * @generated from field: ai.stigmer.runner.turn.v1.FileDecisionAction action = 5;
+     */
+    action: FileDecisionAction;
+    /**
+     * The digest of the content the reviewer actually saw. ENFORCEMENT gate: the
+     * reconcile refuses to apply if the target's current digest differs. Never a
+     * correlation key.
+     *
+     * @generated from field: string expected_digest = 6;
+     */
+    expectedDigest: string;
+    /**
+     * Identity of the reviewer (principal). Empty when not attributed.
+     *
+     * @generated from field: string reviewer_id = 7;
+     */
+    reviewerId: string;
+    /**
+     * ISO 8601 timestamp when the decision was made.
+     *
+     * @generated from field: string decided_at = 8;
+     */
+    decidedAt: string;
+    /**
+     * Optional free-text comment supplied with the decision (audit trail).
+     *
+     * @generated from field: string reason = 9;
+     */
+    reason: string;
+    /**
+     * True when this APPROVE consciously kept a change whose diff could not be
+     * fully reviewed (a binary file — no text diff, but exact reconcilable bytes).
+     * Audit provenance only: it records that a human explicitly acknowledged the
+     * limitation. Never an enforcement input or a correlation key, and never
+     * folded into any digest.
+     *
+     * @generated from field: bool acknowledge_unreviewable = 10;
+     */
+    acknowledgeUnreviewable: boolean;
+    /**
+     * Which authority authored this decision: a human reviewer (USER; also the
+     * reading for UNSPECIFIED pre-origin records) or the approved-command
+     * auto-keep policy. Audit provenance only — never enforcement, never
+     * correlation, never folded into any digest. See FileDecisionOrigin.
+     *
+     * @generated from field: ai.stigmer.runner.turn.v1.FileDecisionOrigin origin = 11;
+     */
+    origin: FileDecisionOrigin;
+};
+/**
+ * Describes the message ai.stigmer.runner.turn.v1.FileDecision.
+ * Use `create(FileDecisionSchema)` to create a new message.
+ */
+export declare const FileDecisionSchema: GenMessage<FileDecision>;
+/**
+ * The baseline workspace state captured at turn start.
+ *
+ * @internal
+ * Authored by the runner's turn-begin capture activity. The first event of a
+ * change set's lifecycle; carries the change set's stable identity so the
+ * projection can materialize the set before any candidate exists.
+ *
+ * @generated from message ai.stigmer.runner.turn.v1.FileReviewBaselineCaptured
+ */
+export type FileReviewBaselineCaptured = Message<"ai.stigmer.runner.turn.v1.FileReviewBaselineCaptured"> & {
+    /**
+     * Stable id of the change set this baseline opens.
+     *
+     * @generated from field: string change_set_id = 1;
+     */
+    changeSetId: string;
+    /**
+     * The turn that produced it.
+     *
+     * @generated from field: string turn_id = 2;
+     */
+    turnId: string;
+    /**
+     * The harness that produced it ("cursor" | "deep-agent").
+     *
+     * @generated from field: string harness_id = 3;
+     */
+    harnessId: string;
+    /**
+     * The captured baseline state.
+     *
+     * @generated from field: ai.stigmer.agentic.run.v1.SnapshotRef baseline_snapshot = 4;
+     */
+    baselineSnapshot?: SnapshotRef;
+};
+/**
+ * Describes the message ai.stigmer.runner.turn.v1.FileReviewBaselineCaptured.
+ * Use `create(FileReviewBaselineCapturedSchema)` to create a new message.
+ */
+export declare const FileReviewBaselineCapturedSchema: GenMessage<FileReviewBaselineCaptured>;
+/**
+ * The candidate workspace state captured at the turn boundary, carrying the
+ * computed authoritative diff.
+ *
+ * @internal
+ * Authored by the runner's turn-boundary capture activity. Large before/after
+ * bodies are offloaded (FileContent.ref) before this event is persisted.
+ *
+ * @generated from message ai.stigmer.runner.turn.v1.FileReviewCandidateCaptured
+ */
+export type FileReviewCandidateCaptured = Message<"ai.stigmer.runner.turn.v1.FileReviewCandidateCaptured"> & {
+    /**
+     * The change set this candidate closes.
+     *
+     * @generated from field: string change_set_id = 1;
+     */
+    changeSetId: string;
+    /**
+     * The captured candidate state.
+     *
+     * @generated from field: ai.stigmer.agentic.run.v1.SnapshotRef candidate_snapshot = 2;
+     */
+    candidateSnapshot?: SnapshotRef;
+    /**
+     * The authoritative per-file diff (diff of baseline → candidate).
+     *
+     * @generated from field: repeated ai.stigmer.agentic.run.v1.CapturedFileChange changes = 3;
+     */
+    changes: CapturedFileChange[];
+    /**
+     * Canonical digest over the ordered manifest (enforcement).
+     *
+     * @generated from field: string aggregate_digest = 4;
+     */
+    aggregateDigest: string;
+    /**
+     * The runner-derived completeness rollup for this candidate: COMPLETE when
+     * every file is reviewable, BINARY_SUMMARY_ONLY when binary files are the only
+     * blocker, else PARTIAL_BLOCKED. See DiffCompleteness.
+     *
+     * @generated from field: ai.stigmer.agentic.run.v1.DiffCompleteness diff_completeness = 5;
+     */
+    diffCompleteness: DiffCompleteness;
+    /**
+     * The runner's approved-command turn facts. When present AND the
+     * backend's verification passes, the set is auto-kept by a policy-origin
+     * FILE_DECIDED instead of arming the review gate. Absent → manual review.
+     * See TurnCommandProvenance.
+     *
+     * @generated from field: ai.stigmer.agentic.run.v1.TurnCommandProvenance command_provenance = 6;
+     */
+    commandProvenance?: TurnCommandProvenance;
+};
+/**
+ * Describes the message ai.stigmer.runner.turn.v1.FileReviewCandidateCaptured.
+ * Use `create(FileReviewCandidateCapturedSchema)` to create a new message.
+ */
+export declare const FileReviewCandidateCapturedSchema: GenMessage<FileReviewCandidateCaptured>;
+/**
+ * The result of reconciling approved decisions into the workspace.
+ *
+ * @internal
+ * Authored by the runner's reconcile activity after decisions land. Idempotent:
+ * it reconciles to an exact approved snapshot and verifies hashes, so re-running
+ * converges.
+ *
+ * @generated from message ai.stigmer.runner.turn.v1.FileReviewReconciled
+ */
+export type FileReviewReconciled = Message<"ai.stigmer.runner.turn.v1.FileReviewReconciled"> & {
+    /**
+     * The change set that was reconciled.
+     *
+     * @generated from field: string change_set_id = 1;
+     */
+    changeSetId: string;
+    /**
+     * The exact workspace state reconciled to and hash-verified.
+     *
+     * @generated from field: ai.stigmer.agentic.run.v1.SnapshotRef approved_snapshot = 2;
+     */
+    approvedSnapshot?: SnapshotRef;
+};
+/**
+ * Describes the message ai.stigmer.runner.turn.v1.FileReviewReconciled.
+ * Use `create(FileReviewReconciledSchema)` to create a new message.
+ */
+export declare const FileReviewReconciledSchema: GenMessage<FileReviewReconciled>;
+/**
+ * A terminal failure in the file-review lifecycle.
+ *
+ * @internal
+ * Authored by the runner. A DIFF_UNREVIEWABLE failure blocks the change set
+ * from becoming approvable (the diff cannot be shown completely); the others
+ * record capture/reconcile/verification failures for audit and resume.
+ *
+ * @generated from message ai.stigmer.runner.turn.v1.FileReviewFailure
+ */
+export type FileReviewFailure = Message<"ai.stigmer.runner.turn.v1.FileReviewFailure"> & {
+    /**
+     * The change set the failure pertains to.
+     *
+     * @generated from field: string change_set_id = 1;
+     */
+    changeSetId: string;
+    /**
+     * The precise failure mode. event_type buckets this as FAILED; this carries
+     * the fidelity. See FileReviewFailureKind.
+     *
+     * @generated from field: ai.stigmer.runner.turn.v1.FileReviewFailureKind kind = 2;
+     */
+    kind: FileReviewFailureKind;
+    /**
+     * Human-readable detail for the audit trail. Never affects control flow.
+     *
+     * @generated from field: string detail = 3;
+     */
+    detail: string;
+};
+/**
+ * Describes the message ai.stigmer.runner.turn.v1.FileReviewFailure.
+ * Use `create(FileReviewFailureSchema)` to create a new message.
+ */
+export declare const FileReviewFailureSchema: GenMessage<FileReviewFailure>;
+/**
+ * An immutable event in the file-review lifecycle.
+ *
+ * The payload is a closed oneof so each event type is type-safe and
+ * self-documenting, mirroring ApprovalEvent. event_type is the coarse bucket;
+ * the payload carries fidelity.
+ *
+ * @internal
+ *
+ * @generated from message ai.stigmer.runner.turn.v1.FileReviewEvent
+ */
+export type FileReviewEvent = Message<"ai.stigmer.runner.turn.v1.FileReviewEvent"> & {
+    /**
+     * Unique id of this event, deterministic by design: derived from
+     * change_set_id + scope id + event_type. The permanent idempotency key for
+     * append-only authoring, so re-deriving or re-authoring never duplicates an
+     * event.
+     *
+     * @generated from field: string event_id = 1;
+     */
+    eventId: string;
+    /**
+     * Correlation id shared by every event for one change set.
+     *
+     * @generated from field: string change_set_id = 2;
+     */
+    changeSetId: string;
+    /**
+     * Coarse lifecycle bucket of this event. See FileReviewEventType.
+     *
+     * @generated from field: ai.stigmer.runner.turn.v1.FileReviewEventType event_type = 3;
+     */
+    eventType: FileReviewEventType;
+    /**
+     * ISO 8601 timestamp of the event.
+     *
+     * @generated from field: string timestamp = 4;
+     */
+    timestamp: string;
+    /**
+     * Who produced the event: "system"/"runner" for capture and reconcile,
+     * "user" for decisions.
+     *
+     * @generated from field: string actor = 5;
+     */
+    actor: string;
+    /**
+     * Typed payload, selected by event_type.
+     *
+     * @generated from oneof ai.stigmer.runner.turn.v1.FileReviewEvent.payload
+     */
+    payload: {
+        /**
+         * Set when event_type == BASELINE_CAPTURED.
+         *
+         * @generated from field: ai.stigmer.runner.turn.v1.FileReviewBaselineCaptured baseline_captured = 6;
+         */
+        value: FileReviewBaselineCaptured;
+        case: "baselineCaptured";
+    } | {
+        /**
+         * Set when event_type == CANDIDATE_CAPTURED.
+         *
+         * @generated from field: ai.stigmer.runner.turn.v1.FileReviewCandidateCaptured candidate_captured = 7;
+         */
+        value: FileReviewCandidateCaptured;
+        case: "candidateCaptured";
+    } | {
+        /**
+         * Set when event_type == FILE_DECIDED: a decision the runner read from the
+         * session's stigmer.file_review.decided event.
+         *
+         * @generated from field: ai.stigmer.runner.turn.v1.FileDecision file_decided = 8;
+         */
+        value: FileDecision;
+        case: "fileDecided";
+    } | {
+        /**
+         * Set when event_type == RECONCILED.
+         *
+         * @generated from field: ai.stigmer.runner.turn.v1.FileReviewReconciled reconciled = 9;
+         */
+        value: FileReviewReconciled;
+        case: "reconciled";
+    } | {
+        /**
+         * Set when event_type == FAILED.
+         *
+         * @generated from field: ai.stigmer.runner.turn.v1.FileReviewFailure failed = 10;
+         */
+        value: FileReviewFailure;
+        case: "failed";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message ai.stigmer.runner.turn.v1.FileReviewEvent.
+ * Use `create(FileReviewEventSchema)` to create a new message.
+ */
+export declare const FileReviewEventSchema: GenMessage<FileReviewEvent>;
+/**
+ * The ordered sequence of file-review events for a single run.
+ *
+ * Held in TurnRows.file_review_event_stream, the runner's own record of a
+ * turn's file review. BASELINE_CAPTURED / CANDIDATE_CAPTURED / RECONCILED /
+ * FAILED events are authored by the runner's capture and reconcile
+ * activities; a FILE_DECIDED event only mirrors a decision the session's log
+ * already holds. Every append is keyed by the deterministic
+ * FileReviewEvent.event_id, so the stream is idempotent under retries and an
+ * existing event is never overwritten.
+ *
+ * @generated from message ai.stigmer.runner.turn.v1.FileReviewEventStream
+ */
+export type FileReviewEventStream = Message<"ai.stigmer.runner.turn.v1.FileReviewEventStream"> & {
+    /**
+     * Run.metadata.id this stream belongs to.
+     *
+     * @generated from field: string run_id = 1;
+     */
+    runId: string;
+    /**
+     * Events in lifecycle order.
+     *
+     * @generated from field: repeated ai.stigmer.runner.turn.v1.FileReviewEvent events = 2;
+     */
+    events: FileReviewEvent[];
+};
+/**
+ * Describes the message ai.stigmer.runner.turn.v1.FileReviewEventStream.
+ * Use `create(FileReviewEventStreamSchema)` to create a new message.
+ */
+export declare const FileReviewEventStreamSchema: GenMessage<FileReviewEventStream>;

package/dist/gen/turn/ai/stigmer/runner/turn/v1/ledger_pb.js

@@ -0,0 +1,47 @@
+// @generated by protoc-gen-es v2.2.2 with parameter "target=ts,import_extension=js"
+// @generated from file ai/stigmer/runner/turn/v1/ledger.proto (package ai.stigmer.runner.turn.v1, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv1";
+import { file_ai_stigmer_agentic_run_v1_enum } from "@stigmer/apis/ai/stigmer/agentic/run/v1/enum_pb";
+import { file_ai_stigmer_agentic_run_v1_filereview } from "@stigmer/apis/ai/stigmer/agentic/run/v1/filereview_pb";
+import { file_ai_stigmer_runner_turn_v1_enum } from "./enum_pb.js";
+/**
+ * Describes the file ai/stigmer/runner/turn/v1/ledger.proto.
+ */
+export const file_ai_stigmer_runner_turn_v1_ledger = /*@__PURE__*/ fileDesc("CiZhaS9zdGlnbWVyL3J1bm5lci90dXJuL3YxL2xlZGdlci5wcm90bxIZYWkuc3RpZ21lci5ydW5uZXIudHVybi52MSL4AgoMRmlsZURlY2lzaW9uEgoKAmlkGAEgASgJEhUKDWNoYW5nZV9zZXRfaWQYAiABKAkSOwoFc2NvcGUYAyABKA4yLC5haS5zdGlnbWVyLnJ1bm5lci50dXJuLnYxLkZpbGVEZWNpc2lvblNjb3BlEhYKDmZpbGVfY2hhbmdlX2lkGAQgASgJEj0KBmFjdGlvbhgFIAEoDjItLmFpLnN0aWdtZXIucnVubmVyLnR1cm4udjEuRmlsZURlY2lzaW9uQWN0aW9uEhcKD2V4cGVjdGVkX2RpZ2VzdBgGIAEoCRITCgtyZXZpZXdlcl9pZBgHIAEoCRISCgpkZWNpZGVkX2F0GAggASgJEg4KBnJlYXNvbhgJIAEoCRIgChhhY2tub3dsZWRnZV91bnJldmlld2FibGUYCiABKAgSPQoGb3JpZ2luGAsgASgOMi0uYWkuc3RpZ21lci5ydW5uZXIudHVybi52MS5GaWxlRGVjaXNpb25PcmlnaW4imwEKGkZpbGVSZXZpZXdCYXNlbGluZUNhcHR1cmVkEhUKDWNoYW5nZV9zZXRfaWQYASABKAkSDwoHdHVybl9pZBgCIAEoCRISCgpoYXJuZXNzX2lkGAMgASgJEkEKEWJhc2VsaW5lX3NuYXBzaG90GAQgASgLMiYuYWkuc3RpZ21lci5hZ2VudGljLnJ1bi52MS5TbmFwc2hvdFJlZiLoAgobRmlsZVJldmlld0NhbmRpZGF0ZUNhcHR1cmVkEhUKDWNoYW5nZV9zZXRfaWQYASABKAkSQgoSY2FuZGlkYXRlX3NuYXBzaG90GAIgASgLMiYuYWkuc3RpZ21lci5hZ2VudGljLnJ1bi52MS5TbmFwc2hvdFJlZhI+CgdjaGFuZ2VzGAMgAygLMi0uYWkuc3RpZ21lci5hZ2VudGljLnJ1bi52MS5DYXB0dXJlZEZpbGVDaGFuZ2USGAoQYWdncmVnYXRlX2RpZ2VzdBgEIAEoCRJGChFkaWZmX2NvbXBsZXRlbmVzcxgFIAEoDjIrLmFpLnN0aWdtZXIuYWdlbnRpYy5ydW4udjEuRGlmZkNvbXBsZXRlbmVzcxJMChJjb21tYW5kX3Byb3ZlbmFuY2UYBiABKAsyMC5haS5zdGlnbWVyLmFnZW50aWMucnVuLnYxLlR1cm5Db21tYW5kUHJvdmVuYW5jZSJwChRGaWxlUmV2aWV3UmVjb25jaWxlZBIVCg1jaGFuZ2Vfc2V0X2lkGAEgASgJEkEKEWFwcHJvdmVkX3NuYXBzaG90GAIgASgLMiYuYWkuc3RpZ21lci5hZ2VudGljLnJ1bi52MS5TbmFwc2hvdFJlZiJ6ChFGaWxlUmV2aWV3RmFpbHVyZRIVCg1jaGFuZ2Vfc2V0X2lkGAEgASgJEj4KBGtpbmQYAiABKA4yMC5haS5zdGlnbWVyLnJ1bm5lci50dXJuLnYxLkZpbGVSZXZpZXdGYWlsdXJlS2luZBIOCgZkZXRhaWwYAyABKAkinQQKD0ZpbGVSZXZpZXdFdmVudBIQCghldmVudF9pZBgBIAEoCRIVCg1jaGFuZ2Vfc2V0X2lkGAIgASgJEkIKCmV2ZW50X3R5cGUYAyABKA4yLi5haS5zdGlnbWVyLnJ1bm5lci50dXJuLnYxLkZpbGVSZXZpZXdFdmVudFR5cGUSEQoJdGltZXN0YW1wGAQgASgJEg0KBWFjdG9yGAUgASgJElIKEWJhc2VsaW5lX2NhcHR1cmVkGAYgASgLMjUuYWkuc3RpZ21lci5ydW5uZXIudHVybi52MS5GaWxlUmV2aWV3QmFzZWxpbmVDYXB0dXJlZEgAElQKEmNhbmRpZGF0ZV9jYXB0dXJlZBgHIAEoCzI2LmFpLnN0aWdtZXIucnVubmVyLnR1cm4udjEuRmlsZVJldmlld0NhbmRpZGF0ZUNhcHR1cmVkSAASPwoMZmlsZV9kZWNpZGVkGAggASgLMicuYWkuc3RpZ21lci5ydW5uZXIudHVybi52MS5GaWxlRGVjaXNpb25IABJFCgpyZWNvbmNpbGVkGAkgASgLMi8uYWkuc3RpZ21lci5ydW5uZXIudHVybi52MS5GaWxlUmV2aWV3UmVjb25jaWxlZEgAEj4KBmZhaWxlZBgKIAEoCzIsLmFpLnN0aWdtZXIucnVubmVyLnR1cm4udjEuRmlsZVJldmlld0ZhaWx1cmVIAEIJCgdwYXlsb2FkImMKFUZpbGVSZXZpZXdFdmVudFN0cmVhbRIOCgZydW5faWQYASABKAkSOgoGZXZlbnRzGAIgAygLMiouYWkuc3RpZ21lci5ydW5uZXIudHVybi52MS5GaWxlUmV2aWV3RXZlbnRiBnByb3RvMw", [file_ai_stigmer_agentic_run_v1_enum, file_ai_stigmer_agentic_run_v1_filereview, file_ai_stigmer_runner_turn_v1_enum]);
+/**
+ * Describes the message ai.stigmer.runner.turn.v1.FileDecision.
+ * Use `create(FileDecisionSchema)` to create a new message.
+ */
+export const FileDecisionSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_runner_turn_v1_ledger, 0);
+/**
+ * Describes the message ai.stigmer.runner.turn.v1.FileReviewBaselineCaptured.
+ * Use `create(FileReviewBaselineCapturedSchema)` to create a new message.
+ */
+export const FileReviewBaselineCapturedSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_runner_turn_v1_ledger, 1);
+/**
+ * Describes the message ai.stigmer.runner.turn.v1.FileReviewCandidateCaptured.
+ * Use `create(FileReviewCandidateCapturedSchema)` to create a new message.
+ */
+export const FileReviewCandidateCapturedSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_runner_turn_v1_ledger, 2);
+/**
+ * Describes the message ai.stigmer.runner.turn.v1.FileReviewReconciled.
+ * Use `create(FileReviewReconciledSchema)` to create a new message.
+ */
+export const FileReviewReconciledSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_runner_turn_v1_ledger, 3);
+/**
+ * Describes the message ai.stigmer.runner.turn.v1.FileReviewFailure.
+ * Use `create(FileReviewFailureSchema)` to create a new message.
+ */
+export const FileReviewFailureSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_runner_turn_v1_ledger, 4);
+/**
+ * Describes the message ai.stigmer.runner.turn.v1.FileReviewEvent.
+ * Use `create(FileReviewEventSchema)` to create a new message.
+ */
+export const FileReviewEventSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_runner_turn_v1_ledger, 5);
+/**
+ * Describes the message ai.stigmer.runner.turn.v1.FileReviewEventStream.
+ * Use `create(FileReviewEventStreamSchema)` to create a new message.
+ */
+export const FileReviewEventStreamSchema = /*@__PURE__*/ messageDesc(file_ai_stigmer_runner_turn_v1_ledger, 6);
+//# sourceMappingURL=ledger_pb.js.map

package/dist/gen/turn/ai/stigmer/runner/turn/v1/ledger_pb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger_pb.js","sourceRoot":"","sources":["../../../../../../../../src/gen/turn/ai/stigmer/runner/turn/v1/ledger_pb.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,iHAAiH;AACjH,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,mCAAmC,EAAE,MAAM,iDAAiD,CAAC;AAEtG,OAAO,EAAE,yCAAyC,EAAE,MAAM,uDAAuD,CAAC;AAElH,OAAO,EAAE,mCAAmC,EAAE,MAAM,cAAc,CAAC;AAGnE;;GAEG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAY,aAAa,CACzE,QAAQ,CAAC,g7EAAg7E,EAAE,CAAC,mCAAmC,EAAE,yCAAyC,EAAE,mCAAmC,CAAC,CAAC,CAAC;AAuGpjF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B,aAAa,CACvE,WAAW,CAAC,qCAAqC,EAAE,CAAC,CAAC,CAAC;AA0CxD;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAA2C,aAAa,CACnG,WAAW,CAAC,qCAAqC,EAAE,CAAC,CAAC,CAAC;AA6DxD;;;GAGG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAA4C,aAAa,CACrG,WAAW,CAAC,qCAAqC,EAAE,CAAC,CAAC,CAAC;AA4BxD;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAqC,aAAa,CACvF,WAAW,CAAC,qCAAqC,EAAE,CAAC,CAAC,CAAC;AAoCxD;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAkC,aAAa,CACjF,WAAW,CAAC,qCAAqC,EAAE,CAAC,CAAC,CAAC;AAsGxD;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAgC,aAAa,CAC7E,WAAW,CAAC,qCAAqC,EAAE,CAAC,CAAC,CAAC;AA+BxD;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAsC,aAAa,CACzF,WAAW,CAAC,qCAAqC,EAAE,CAAC,CAAC,CAAC"}