unfazed 0.2.0 → 0.4.0

package/schema/schema.graphqls

@@ -713,6 +713,141 @@ type CurrentActorResources {
   serviceLimit: Int!
 }
 
+"""
+Per-owner compute usage for the current calendar month (docs/run-design.md,
+"Metering (phase 0, ships alone)"): VM-seconds and MiB-seconds accrued across
+every VM the runner has booted for this owner (service, box), keyed on the raw
+owner id. No pricing, no currency — a price is a presentation decision made
+later, on top of these raw numbers. Populated for both humans (session
+callers) and agents, unlike `usage`/`resources` above, which are agent-only.
+"""
+type CurrentActorCompute {
+  seconds: Float!
+  mibSeconds: Float!
+  since: String!
+  until: String!
+}
+
+enum RunStatus {
+  QUEUED
+  RUNNING
+  "Waiting for a human's answer (see Run.question); the VM stays up and the wall clock keeps running."
+  BLOCKED
+  SUCCEEDED
+  FAILED
+  CANCELLED
+}
+
+"""
+Compute metered to one run: VM seconds and MiB-seconds (VM seconds x memory).
+"""
+type RunUsage {
+  vmSeconds: Float!
+  memoryMiB: Int!
+  mibSeconds: Float!
+}
+
+"""
+An agent run (docs/run-design.md): one ephemeral VM booted from the box image
+that executed one task and was destroyed when it exited. Deployments answer
+"what is running"; runs answer "what happened".
+"""
+type Run {
+  id: ID!
+  workspaceID: ID!
+  ownerId: ID!
+  status: RunStatus!
+  rawStatus: String!
+  command: String
+  harness: String
+  prompt: String
+  setup: [String!]!
+  skills: [String!]!
+  "Shell commands run after the harness exited 0; their failure fails the run."
+  verify: [String!]!
+  "Who approves the harness's guarded actions: empty (the harness's defaults) or human."
+  approval: String!
+  "How the harness is asked to work: empty (do the task) or plan (write a plan only)."
+  mode: String!
+  "The run this one continues (a follow-up), if any."
+  parentRunID: ID
+  "Length of the follow-up chain; 0 for a root run."
+  depth: Int!
+  "Set while the run is BLOCKED on a human; answer with answerRun."
+  question: RunQuestion
+  memoryMiB: Int!
+  maxSeconds: Int!
+  metadata: JSON
+  "Terminal failure detail (FAILED only)."
+  error: String
+  exitCode: Int
+  "The harness's own report when the guest obtained one: final message and whether it considers the work done. SUCCEEDED alone means the harness exited cleanly."
+  result: RunResult
+  "Exit code of the verify commands when they ran."
+  verifyExitCode: Int
+  vmID: String
+  "True once the stored console transcript can be fetched (get_run_transcript / the runs API)."
+  transcriptAvailable: Boolean!
+  usage: RunUsage!
+  createdAt: String!
+  startedAt: String
+  settledAt: String
+}
+
+"How the harness said it finished: status success|error, detail in the harness's words, text its final message (bounded)."
+type RunResult {
+  status: String!
+  detail: String
+  text: String
+}
+
+"One entry of a run's own history (started, cancel requested, settled)."
+type RunEvent {
+  id: ID!
+  runID: ID!
+  type: String!
+  severity: DeploymentEventSeverity!
+  message: String!
+  metadata: JSON
+  createdAt: String!
+}
+
+"""
+The redacted end of a RUNNING run's live console, from the node the VM is on.
+Empty with running=false once the run has settled — read runTranscript then.
+"""
+type RunConsole {
+  runID: ID!
+  running: Boolean!
+  text: String!
+}
+
+"The human input a BLOCKED run is waiting for."
+type RunQuestion {
+  id: ID!
+  text: String!
+  options: [String!]!
+  askedAt: String!
+}
+
+"The bounded end of a finished run's stored transcript."
+type RunTranscript {
+  runID: ID!
+  available: Boolean!
+  text: String!
+  totalBytes: Int!
+  truncated: Boolean!
+}
+
+type RunPage {
+  items: [Run!]!
+  total: Int!
+  limit: Int!
+  offset: Int!
+  hasMore: Boolean!
+  nextOffset: Int
+}
+
 type CurrentActorUser {
   kind: CurrentActorKind!
   userID: String!
@@ -743,6 +878,7 @@ type CurrentActor {
   expiresAt: String
   usage: CurrentActorUsage
   resources: CurrentActorResources
+  compute: CurrentActorCompute
   user: CurrentActorUser
   agent: CurrentActorAgent
   linkedAgents: [CurrentActorAgent!]!
@@ -806,6 +942,16 @@ type Query {
   deploymentReleases(alias: String!): [Deployment!]!
   deploymentEvents(deploymentID: ID!, limit: Int): [DeploymentEvent!]!
   deploymentEventsPage(input: ListDeploymentEventsInput!): DeploymentEventPage!
+  "One agent run visible to the caller; not-found otherwise."
+  run(id: ID!): Run!
+  "The caller's agent runs, newest first."
+  runs(input: ListRunsInput): RunPage!
+  "A run's own history, oldest first (at most limit, default 100)."
+  runEvents(runID: ID!, limit: Int): [RunEvent!]!
+  "The live console tail of a RUNNING run (tailBytes, default 16384)."
+  runConsole(id: ID!, tailBytes: Int): RunConsole!
+  "The end of a finished run's stored transcript (tailBytes, default 16384, max 65536)."
+  runTranscript(id: ID!, tailBytes: Int): RunTranscript!
   serviceStatus(deploymentID: ID!): ServiceRuntimeStatus!
   serviceLogs(deploymentID: ID!, tailBytes: Int): ServiceRuntimeLogs!
   appState(alias: String!, key: String!): AppStateValue!
@@ -816,6 +962,14 @@ type Query {
 }
 
 type Mutation {
+  "Start an agent run; returns once its VM has started (RUNNING) or FAILED with error."
+  createRun(input: CreateRunInput!): Run!
+  "Stop an agent run (idempotent on an already-cancelled run)."
+  cancelRun(id: ID!): Run!
+  "Answer a BLOCKED run's pending question; the run resumes."
+  answerRun(id: ID!, answer: String!): Run!
+  "Continue a finished run: a new run in the same workspace with the parent's context prepended to the prompt."
+  followUpRun(input: FollowUpRunInput!): Run!
   registerFunction(input: RegisterFunctionInput!): Function!
   invokeFunction(input: InvokeFunctionInput!): Invocation!
   createWorkspace(input: CreateWorkspaceInput!): CreateWorkspacePayload!
@@ -1259,6 +1413,45 @@ input ListDeploymentsInput {
   order: String
 }
 
+input CreateRunInput {
+  workspaceID: ID!
+  prompt: String
+  harness: String
+  command: String
+  "Shell commands run in /work before the harness; the first failure fails the run."
+  setup: [String!]
+  "Skills fetched into .claude/skills before the harness, as owner/repo:path."
+  skills: [String!]
+  "Shell commands run after the harness exited 0 (tests, a build, a file check); the first failure FAILS the run. Skipped in plan mode."
+  verify: [String!]
+  "\"human\" routes the harness's permission prompts to you (the run BLOCKS until you answer); empty keeps the harness's own defaults."
+  approval: String
+  "\"plan\" asks the harness to write a plan without acting; empty does the task."
+  mode: String
+  "The run this one continues; usually set through followUpRun."
+  parentRunID: ID
+  memoryMiB: Int
+  maxSeconds: Int
+  metadata: JSON
+  includeFiles: Boolean
+}
+
+input FollowUpRunInput {
+  runID: ID!
+  prompt: String!
+  mode: String
+  approval: String
+  maxSeconds: Int
+  metadata: JSON
+}
+
+input ListRunsInput {
+  workspaceID: ID
+  status: RunStatus
+  limit: Int
+  offset: Int
+}
+
 input ListDeploymentEventsInput {
   deploymentID: ID!
   limit: Int