@opsee/mcp-server 0.11.6 → 0.11.9

package/gen/api/v1/initiative_pb.d.ts

@@ -7,7 +7,7 @@ import type { Message } from "@bufbuild/protobuf";
 import type { Pagination } from "./pagination_pb";
 import type { FilterOptions } from "./filter_pb";
 import type { Comment, Initiative, InitiativeMemoryEntry, Task, TaskPullRequest } from "./models_pb";
-import type { EmptySchema } from "@bufbuild/protobuf/wkt";
+import type { EmptySchema, Timestamp } from "@bufbuild/protobuf/wkt";
 
 /**
  * Describes the file api/v1/initiative.proto.
@@ -415,6 +415,14 @@ export declare type InitiativeCostRollup = Message<"api.v1.InitiativeCostRollup"
    * @generated from field: int64 total_cache_creation_tokens = 11;
    */
   totalCacheCreationTokens: bigint;
+
+  /**
+   * Credits reported by Foreman spend events in the Initiative's Run Record. Already folded into
+   * total_credits, model_costs and the token totals above; broken out so the two lanes stay legible.
+   *
+   * @generated from field: int64 run_record_credits = 12;
+   */
+  runRecordCredits: bigint;
 };
 
 /**
@@ -1008,6 +1016,795 @@ export declare type ReconcileInitiativeResponse = Message<"api.v1.ReconcileIniti
  */
 export declare const ReconcileInitiativeResponseSchema: GenMessage<ReconcileInitiativeResponse>;
 
+/**
+ * @generated from message api.v1.Run
+ */
+export declare type Run = Message<"api.v1.Run"> & {
+  /**
+   * @generated from field: uint32 id = 1;
+   */
+  id: number;
+
+  /**
+   * @generated from field: uint32 initiative_id = 2;
+   */
+  initiativeId: number;
+
+  /**
+   * @generated from field: uint32 company_id = 3;
+   */
+  companyId: number;
+
+  /**
+   * mirrors Initiative.status: draft | active | paused | completed | abandoned
+   *
+   * @generated from field: string status = 4;
+   */
+  status: string;
+
+  /**
+   * @generated from field: int64 event_count = 5;
+   */
+  eventCount: bigint;
+
+  /**
+   * first event append
+   *
+   * @generated from field: google.protobuf.Timestamp started_at = 6;
+   */
+  startedAt?: Timestamp;
+
+  /**
+   * @generated from field: google.protobuf.Timestamp last_event_at = 7;
+   */
+  lastEventAt?: Timestamp;
+};
+
+/**
+ * Describes the message api.v1.Run.
+ * Use `create(RunSchema)` to create a new message.
+ */
+export declare const RunSchema: GenMessage<Run>;
+
+/**
+ * RunVerification is the orchestrator Workflow Ledger's Verification shape (orchestrator/internal/ledger):
+ * the log of one deterministic command. Gate and Verdict events carry it so both lanes render the same way.
+ *
+ * @generated from message api.v1.RunVerification
+ */
+export declare type RunVerification = Message<"api.v1.RunVerification"> & {
+  /**
+   * @generated from field: string id = 1;
+   */
+  id: string;
+
+  /**
+   * @generated from field: string stage = 2;
+   */
+  stage: string;
+
+  /**
+   * @generated from field: string tool = 3;
+   */
+  tool: string;
+
+  /**
+   * @generated from field: string command = 4;
+   */
+  command: string;
+
+  /**
+   * @generated from field: string cwd = 5;
+   */
+  cwd: string;
+
+  /**
+   * @generated from field: int32 exit_code = 6;
+   */
+  exitCode: number;
+
+  /**
+   * @generated from field: int64 duration_ms = 7;
+   */
+  durationMs: bigint;
+
+  /**
+   * @generated from field: string stdout_tail = 8;
+   */
+  stdoutTail: string;
+
+  /**
+   * @generated from field: string stderr_tail = 9;
+   */
+  stderrTail: string;
+
+  /**
+   * @generated from field: repeated string related_assumption_ids = 10;
+   */
+  relatedAssumptionIds: string[];
+
+  /**
+   * @generated from field: google.protobuf.Timestamp at = 11;
+   */
+  at?: Timestamp;
+};
+
+/**
+ * Describes the message api.v1.RunVerification.
+ * Use `create(RunVerificationSchema)` to create a new message.
+ */
+export declare const RunVerificationSchema: GenMessage<RunVerification>;
+
+/**
+ * A Worker was started on a Task.
+ *
+ * @generated from message api.v1.RunDispatchEvent
+ */
+export declare type RunDispatchEvent = Message<"api.v1.RunDispatchEvent"> & {
+  /**
+   * claude-code | codex | ...
+   *
+   * @generated from field: string vendor = 1;
+   */
+  vendor: string;
+
+  /**
+   * Account label, never a credential
+   *
+   * @generated from field: string account = 2;
+   */
+  account: string;
+
+  /**
+   * Workspace path on the user's machine
+   *
+   * @generated from field: string workspace = 3;
+   */
+  workspace: string;
+
+  /**
+   * @generated from field: string branch = 4;
+   */
+  branch: string;
+
+  /**
+   * @generated from field: int32 attempt = 5;
+   */
+  attempt: number;
+};
+
+/**
+ * Describes the message api.v1.RunDispatchEvent.
+ * Use `create(RunDispatchEventSchema)` to create a new message.
+ */
+export declare const RunDispatchEventSchema: GenMessage<RunDispatchEvent>;
+
+/**
+ * A Worker turn ended (or stalled). Vendor session ids are Process Table facts and never appear here.
+ *
+ * @generated from message api.v1.RunAttemptEvent
+ */
+export declare type RunAttemptEvent = Message<"api.v1.RunAttemptEvent"> & {
+  /**
+   * @generated from field: int32 attempt = 1;
+   */
+  attempt: number;
+
+  /**
+   * @generated from field: string outcome = 2;
+   */
+  outcome: string;
+
+  /**
+   * @generated from field: string summary = 3;
+   */
+  summary: string;
+
+  /**
+   * the draft PR
+   *
+   * @generated from field: optional string hand_off_url = 4;
+   */
+  handOffUrl?: string;
+};
+
+/**
+ * Describes the message api.v1.RunAttemptEvent.
+ * Use `create(RunAttemptEventSchema)` to create a new message.
+ */
+export declare const RunAttemptEventSchema: GenMessage<RunAttemptEvent>;
+
+/**
+ * A Gate ran in a Workspace after a Hand-off. Pass or fail is the verification's exit code.
+ *
+ * @generated from message api.v1.RunGateEvent
+ */
+export declare type RunGateEvent = Message<"api.v1.RunGateEvent"> & {
+  /**
+   * test | lint | typecheck | build | ...
+   *
+   * @generated from field: string name = 1;
+   */
+  name: string;
+
+  /**
+   * @generated from field: api.v1.RunVerification verification = 2;
+   */
+  verification?: RunVerification;
+};
+
+/**
+ * Describes the message api.v1.RunGateEvent.
+ * Use `create(RunGateEventSchema)` to create a new message.
+ */
+export declare const RunGateEventSchema: GenMessage<RunGateEvent>;
+
+/**
+ * One failure a Verifier observed.
+ *
+ * @generated from message api.v1.RunDefect
+ */
+export declare type RunDefect = Message<"api.v1.RunDefect"> & {
+  /**
+   * @generated from field: string title = 1;
+   */
+  title: string;
+
+  /**
+   * @generated from field: string steps = 2;
+   */
+  steps: string;
+
+  /**
+   * @generated from field: string expected = 3;
+   */
+  expected: string;
+
+  /**
+   * @generated from field: string observed = 4;
+   */
+  observed: string;
+
+  /**
+   * @generated from field: string evidence_url = 5;
+   */
+  evidenceUrl: string;
+
+  /**
+   * the sibling Task filed for this Defect, once it exists
+   *
+   * @generated from field: optional uint32 task_id = 6;
+   */
+  taskId?: number;
+};
+
+/**
+ * Describes the message api.v1.RunDefect.
+ * Use `create(RunDefectSchema)` to create a new message.
+ */
+export declare const RunDefectSchema: GenMessage<RunDefect>;
+
+/**
+ * The Verifier's structured result.
+ *
+ * @generated from message api.v1.RunVerdictEvent
+ */
+export declare type RunVerdictEvent = Message<"api.v1.RunVerdictEvent"> & {
+  /**
+   * @generated from field: string status = 1;
+   */
+  status: string;
+
+  /**
+   * @generated from field: repeated api.v1.RunDefect defects = 2;
+   */
+  defects: RunDefect[];
+
+  /**
+   * commands the Verifier ran, same shape as a Gate
+   *
+   * @generated from field: repeated api.v1.RunVerification evidence = 3;
+   */
+  evidence: RunVerification[];
+};
+
+/**
+ * Describes the message api.v1.RunVerdictEvent.
+ * Use `create(RunVerdictEventSchema)` to create a new message.
+ */
+export declare const RunVerdictEventSchema: GenMessage<RunVerdictEvent>;
+
+/**
+ * A Breaker halted new dispatch.
+ *
+ * @generated from message api.v1.RunBreakerEvent
+ */
+export declare type RunBreakerEvent = Message<"api.v1.RunBreakerEvent"> & {
+  /**
+   * @generated from field: string condition = 1;
+   */
+  condition: string;
+
+  /**
+   * @generated from field: string message = 2;
+   */
+  message: string;
+};
+
+/**
+ * Describes the message api.v1.RunBreakerEvent.
+ * Use `create(RunBreakerEventSchema)` to create a new message.
+ */
+export declare const RunBreakerEventSchema: GenMessage<RunBreakerEvent>;
+
+/**
+ * Spend on one Account. Joins the Initiative cost rollup (1 credit = $0.001 USD).
+ *
+ * @generated from message api.v1.RunSpendEvent
+ */
+export declare type RunSpendEvent = Message<"api.v1.RunSpendEvent"> & {
+  /**
+   * @generated from field: int64 credits = 1;
+   */
+  credits: bigint;
+
+  /**
+   * @generated from field: string vendor = 2;
+   */
+  vendor: string;
+
+  /**
+   * @generated from field: string account = 3;
+   */
+  account: string;
+
+  /**
+   * @generated from field: string model = 4;
+   */
+  model: string;
+
+  /**
+   * @generated from field: int64 input_tokens = 5;
+   */
+  inputTokens: bigint;
+
+  /**
+   * @generated from field: int64 output_tokens = 6;
+   */
+  outputTokens: bigint;
+
+  /**
+   * @generated from field: int64 cache_read_tokens = 7;
+   */
+  cacheReadTokens: bigint;
+
+  /**
+   * @generated from field: int64 cache_creation_tokens = 8;
+   */
+  cacheCreationTokens: bigint;
+};
+
+/**
+ * Describes the message api.v1.RunSpendEvent.
+ * Use `create(RunSpendEventSchema)` to create a new message.
+ */
+export declare const RunSpendEventSchema: GenMessage<RunSpendEvent>;
+
+/**
+ * A human steered the Run from the CLI (stories 53-56): took a Worker over (attach) or handed it
+ * back (release), paused or resumed new dispatch for the whole Run, or cancelled an attempt.
+ * Task-scoped for attach, release and cancel; Run-wide (no task_id) for pause and resume. A cancel
+ * is followed by the attempt event that closes the attempt (outcome "stopped").
+ *
+ * @generated from message api.v1.RunControlEvent
+ */
+export declare type RunControlEvent = Message<"api.v1.RunControlEvent"> & {
+  /**
+   * @generated from field: string action = 1;
+   */
+  action: string;
+
+  /**
+   * @generated from field: string message = 2;
+   */
+  message: string;
+};
+
+/**
+ * Describes the message api.v1.RunControlEvent.
+ * Use `create(RunControlEventSchema)` to create a new message.
+ */
+export declare const RunControlEventSchema: GenMessage<RunControlEvent>;
+
+/**
+ * An Account's state changed (Account, cli/CONTEXT.md): the vendor refused a turn on it, its
+ * credential was judged dead, or a human brought it back. `state` names where the Account arrived
+ * rather than what happened to it, so one vocabulary covers a lift from either a pause or a
+ * quarantine. Never a credential: an Account is identified by the label its operator gave it
+ * (ADR-0013), never by the config directory or key variable behind it.
+ *
+ * @generated from message api.v1.RunAccountEvent
+ */
+export declare type RunAccountEvent = Message<"api.v1.RunAccountEvent"> & {
+  /**
+   * @generated from field: string state = 1;
+   */
+  state: string;
+
+  /**
+   * claude-code | codex
+   *
+   * @generated from field: string vendor = 2;
+   */
+  vendor: string;
+
+  /**
+   * the Account's label
+   *
+   * @generated from field: string account = 3;
+   */
+  account: string;
+
+  /**
+   * the vendor's own words, or the Foreman's
+   *
+   * @generated from field: string reason = 4;
+   */
+  reason: string;
+
+  /**
+   * when a pause lifts; absent for the rest
+   *
+   * @generated from field: optional google.protobuf.Timestamp until = 5;
+   */
+  until?: Timestamp;
+};
+
+/**
+ * Describes the message api.v1.RunAccountEvent.
+ * Use `create(RunAccountEventSchema)` to create a new message.
+ */
+export declare const RunAccountEventSchema: GenMessage<RunAccountEvent>;
+
+/**
+ * The typed body of a RunEvent. Exactly one branch is set; the event's kind is derived from it.
+ *
+ * @generated from message api.v1.RunEventPayload
+ */
+export declare type RunEventPayload = Message<"api.v1.RunEventPayload"> & {
+  /**
+   * @generated from oneof api.v1.RunEventPayload.payload
+   */
+  payload: {
+    /**
+     * @generated from field: api.v1.RunDispatchEvent dispatch = 1;
+     */
+    value: RunDispatchEvent;
+    case: "dispatch";
+  } | {
+    /**
+     * @generated from field: api.v1.RunAttemptEvent attempt = 2;
+     */
+    value: RunAttemptEvent;
+    case: "attempt";
+  } | {
+    /**
+     * @generated from field: api.v1.RunGateEvent gate = 3;
+     */
+    value: RunGateEvent;
+    case: "gate";
+  } | {
+    /**
+     * @generated from field: api.v1.RunVerdictEvent verdict = 4;
+     */
+    value: RunVerdictEvent;
+    case: "verdict";
+  } | {
+    /**
+     * @generated from field: api.v1.RunBreakerEvent breaker = 5;
+     */
+    value: RunBreakerEvent;
+    case: "breaker";
+  } | {
+    /**
+     * @generated from field: api.v1.RunSpendEvent spend = 6;
+     */
+    value: RunSpendEvent;
+    case: "spend";
+  } | {
+    /**
+     * @generated from field: api.v1.RunControlEvent control = 7;
+     */
+    value: RunControlEvent;
+    case: "control";
+  } | {
+    /**
+     * @generated from field: api.v1.RunAccountEvent account = 8;
+     */
+    value: RunAccountEvent;
+    case: "account";
+  } | { case: undefined; value?: undefined };
+};
+
+/**
+ * Describes the message api.v1.RunEventPayload.
+ * Use `create(RunEventPayloadSchema)` to create a new message.
+ */
+export declare const RunEventPayloadSchema: GenMessage<RunEventPayload>;
+
+/**
+ * @generated from message api.v1.RunEventInput
+ */
+export declare type RunEventInput = Message<"api.v1.RunEventInput"> & {
+  /**
+   * the Task this fact is about; absent for Run-wide facts (breaker, spend, an Account brought back)
+   *
+   * @generated from field: optional uint32 task_id = 1;
+   */
+  taskId?: number;
+
+  /**
+   * when it happened on the machine; server time when absent
+   *
+   * @generated from field: google.protobuf.Timestamp occurred_at = 2;
+   */
+  occurredAt?: Timestamp;
+
+  /**
+   * @generated from field: api.v1.RunEventPayload payload = 3;
+   */
+  payload?: RunEventPayload;
+
+  /**
+   * Client-minted, unique per event within a Run: an append carrying a key already stored is not
+   * inserted again and the stored event is returned instead. The Foreman's outbox queues a write it
+   * could not confirm and re-sends it later, and the codes it queues on (deadline exceeded, unknown)
+   * are exactly the ones where the first write may already have committed; without this, that
+   * re-send duplicates the event, and a duplicated dispatch makes every later attempt number on
+   * that Task skip. Absent means no de-duplication: a caller that never retries needs none.
+   *
+   * @generated from field: optional string idempotency_key = 4;
+   */
+  idempotencyKey?: string;
+};
+
+/**
+ * Describes the message api.v1.RunEventInput.
+ * Use `create(RunEventInputSchema)` to create a new message.
+ */
+export declare const RunEventInputSchema: GenMessage<RunEventInput>;
+
+/**
+ * @generated from message api.v1.RunEvent
+ */
+export declare type RunEvent = Message<"api.v1.RunEvent"> & {
+  /**
+   * @generated from field: uint32 id = 1;
+   */
+  id: number;
+
+  /**
+   * @generated from field: uint32 run_id = 2;
+   */
+  runId: number;
+
+  /**
+   * @generated from field: uint32 initiative_id = 3;
+   */
+  initiativeId: number;
+
+  /**
+   * @generated from field: uint32 company_id = 4;
+   */
+  companyId: number;
+
+  /**
+   * dispatch | attempt | gate | verdict | breaker | spend | control | account
+   *
+   * @generated from field: string kind = 5;
+   */
+  kind: string;
+
+  /**
+   * @generated from field: optional uint32 task_id = 6;
+   */
+  taskId?: number;
+
+  /**
+   * @generated from field: optional uint32 author_user_id = 7;
+   */
+  authorUserId?: number;
+
+  /**
+   * @generated from field: bool is_agent = 8;
+   */
+  isAgent: boolean;
+
+  /**
+   * @generated from field: google.protobuf.Timestamp occurred_at = 9;
+   */
+  occurredAt?: Timestamp;
+
+  /**
+   * @generated from field: google.protobuf.Timestamp created_at = 10;
+   */
+  createdAt?: Timestamp;
+
+  /**
+   * @generated from field: api.v1.RunEventPayload payload = 11;
+   */
+  payload?: RunEventPayload;
+};
+
+/**
+ * Describes the message api.v1.RunEvent.
+ * Use `create(RunEventSchema)` to create a new message.
+ */
+export declare const RunEventSchema: GenMessage<RunEvent>;
+
+/**
+ * @generated from message api.v1.AppendRunEventsRequest
+ */
+export declare type AppendRunEventsRequest = Message<"api.v1.AppendRunEventsRequest"> & {
+  /**
+   * @generated from field: uint32 initiative_id = 1;
+   */
+  initiativeId: number;
+
+  /**
+   * @generated from field: repeated api.v1.RunEventInput events = 2;
+   */
+  events: RunEventInput[];
+};
+
+/**
+ * Describes the message api.v1.AppendRunEventsRequest.
+ * Use `create(AppendRunEventsRequestSchema)` to create a new message.
+ */
+export declare const AppendRunEventsRequestSchema: GenMessage<AppendRunEventsRequest>;
+
+/**
+ * @generated from message api.v1.AppendRunEventsResponse
+ */
+export declare type AppendRunEventsResponse = Message<"api.v1.AppendRunEventsResponse"> & {
+  /**
+   * @generated from field: api.v1.Run run = 1;
+   */
+  run?: Run;
+
+  /**
+   * in append order, ids assigned
+   *
+   * @generated from field: repeated api.v1.RunEvent events = 2;
+   */
+  events: RunEvent[];
+};
+
+/**
+ * Describes the message api.v1.AppendRunEventsResponse.
+ * Use `create(AppendRunEventsResponseSchema)` to create a new message.
+ */
+export declare const AppendRunEventsResponseSchema: GenMessage<AppendRunEventsResponse>;
+
+/**
+ * @generated from message api.v1.GetRunEventsRequest
+ */
+export declare type GetRunEventsRequest = Message<"api.v1.GetRunEventsRequest"> & {
+  /**
+   * @generated from field: uint32 initiative_id = 1;
+   */
+  initiativeId: number;
+
+  /**
+   * @generated from field: api.v1.Pagination pagination = 2;
+   */
+  pagination?: Pagination;
+
+  /**
+   * empty = all
+   *
+   * @generated from field: repeated string kinds = 3;
+   */
+  kinds: string[];
+
+  /**
+   * @generated from field: optional uint32 task_id = 4;
+   */
+  taskId?: number;
+
+  /**
+   * only events with id > after_id, so Reconcile reads just what it has not seen
+   *
+   * @generated from field: optional uint32 after_id = 5;
+   */
+  afterId?: number;
+};
+
+/**
+ * Describes the message api.v1.GetRunEventsRequest.
+ * Use `create(GetRunEventsRequestSchema)` to create a new message.
+ */
+export declare const GetRunEventsRequestSchema: GenMessage<GetRunEventsRequest>;
+
+/**
+ * @generated from message api.v1.GetRunEventsResponse
+ */
+export declare type GetRunEventsResponse = Message<"api.v1.GetRunEventsResponse"> & {
+  /**
+   * absent when no event has been appended yet
+   *
+   * @generated from field: api.v1.Run run = 1;
+   */
+  run?: Run;
+
+  /**
+   * append order (id ascending)
+   *
+   * @generated from field: repeated api.v1.RunEvent events = 2;
+   */
+  events: RunEvent[];
+
+  /**
+   * @generated from field: api.v1.Pagination pagination = 3;
+   */
+  pagination?: Pagination;
+};
+
+/**
+ * Describes the message api.v1.GetRunEventsResponse.
+ * Use `create(GetRunEventsResponseSchema)` to create a new message.
+ */
+export declare const GetRunEventsResponseSchema: GenMessage<GetRunEventsResponse>;
+
+/**
+ * Ready Tasks: the Tasks in the Initiative's first open slice (no open blocker) that carry the dispatch
+ * label `ready-for-agent`. Done and Archived Tasks are neither ready nor blockers.
+ *
+ * @generated from message api.v1.GetReadyTasksRequest
+ */
+export declare type GetReadyTasksRequest = Message<"api.v1.GetReadyTasksRequest"> & {
+  /**
+   * @generated from field: uint32 initiative_id = 1;
+   */
+  initiativeId: number;
+};
+
+/**
+ * Describes the message api.v1.GetReadyTasksRequest.
+ * Use `create(GetReadyTasksRequestSchema)` to create a new message.
+ */
+export declare const GetReadyTasksRequestSchema: GenMessage<GetReadyTasksRequest>;
+
+/**
+ * @generated from message api.v1.GetReadyTasksResponse
+ */
+export declare type GetReadyTasksResponse = Message<"api.v1.GetReadyTasksResponse"> & {
+  /**
+   * @generated from field: repeated api.v1.Task tasks = 1;
+   */
+  tasks: Task[];
+
+  /**
+   * the label name matched
+   *
+   * @generated from field: string dispatch_label = 2;
+   */
+  dispatchLabel: string;
+
+  /**
+   * false when the project has no such label: nothing can ever be ready
+   *
+   * @generated from field: bool dispatch_label_exists = 3;
+   */
+  dispatchLabelExists: boolean;
+};
+
+/**
+ * Describes the message api.v1.GetReadyTasksResponse.
+ * Use `create(GetReadyTasksResponseSchema)` to create a new message.
+ */
+export declare const GetReadyTasksResponseSchema: GenMessage<GetReadyTasksResponse>;
+
 /**
  * @generated from service api.v1.InitiativeService
  */
@@ -1108,5 +1905,29 @@ export declare const InitiativeService: GenService<{
     input: typeof ReconcileInitiativeRequestSchema;
     output: typeof ReconcileInitiativeResponseSchema;
   },
+  /**
+   * @generated from rpc api.v1.InitiativeService.AppendRunEvents
+   */
+  appendRunEvents: {
+    methodKind: "unary";
+    input: typeof AppendRunEventsRequestSchema;
+    output: typeof AppendRunEventsResponseSchema;
+  },
+  /**
+   * @generated from rpc api.v1.InitiativeService.GetRunEvents
+   */
+  getRunEvents: {
+    methodKind: "unary";
+    input: typeof GetRunEventsRequestSchema;
+    output: typeof GetRunEventsResponseSchema;
+  },
+  /**
+   * @generated from rpc api.v1.InitiativeService.GetReadyTasks
+   */
+  getReadyTasks: {
+    methodKind: "unary";
+    input: typeof GetReadyTasksRequestSchema;
+    output: typeof GetReadyTasksResponseSchema;
+  },
 }>;