unfazed 0.8.0 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unfazed",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Official TypeScript SDK for unfazed. The code-mode companion to the unfazed MCP server: deploy, wait, tail logs and roll back from one script. `npx unfazed login` signs you in. Also ships the unfazed World for Workflow SDK (unfazed/workflow).",
   "license": "MIT",
   "type": "module",

package/schema/SOURCE.json

@@ -2,8 +2,8 @@
   "$comment": "Provenance for the vendored copy of graph/schema.graphqls. Written by scripts/sync-schema.ts — do not edit by hand.",
   "repo": "unfazed",
   "path": "graph/schema.graphqls",
-  "unfazedCommit": "4e49289084964f2d7a43be92e8f3690dea2347ad",
-  "schemaLastChangedCommit": "4e49289084964f2d7a43be92e8f3690dea2347ad",
-  "sha256": "f881d7b1a54925c51d58074da2f9562b8334be98a477aad681a4f80c4e6ff5c2",
+  "unfazedCommit": "4be6045659d43d6db4278279a18629473c6d900d",
+  "schemaLastChangedCommit": "8df8b4663f02c5f71ad0179d90bc3113ee5f4962",
+  "sha256": "634b949697e8845b5ec43d97cc97f17a283a140d4e9d01079d317a4c118b1b64",
   "syncedAt": "2026-10-22"
 }

package/schema/schema.graphqls

@@ -598,6 +598,8 @@ type Deployment {
   gitRepo: String
   gitCommit: String
   createdAt: String!
+  "The deploy's measured timeline; null before its build finished, and for deployments from before it was recorded."
+  timings: DeploymentTimings
   """
   The runtime target serving this exact current deployment: an enrolled worker
   or the control plane. Null for historical releases and residual legacy
@@ -638,9 +640,31 @@ type DeploymentEvent {
   message: String!
   vmID: String
   metadata: JSON
+  "The phases a timing event (deployment.build_finished, deployment.phases) measured, as numbers; null for any other event."
+  timings: DeploymentTimings
   createdAt: String!
 }
 
+"""
+A deploy's measured timeline in milliseconds: what its
+deployment.build_finished and deployment.phases events record (the latest of
+each, the READY summary over the build's), as the SDK's
+parseDeploymentTimings reads them.
+"""
+type DeploymentTimings {
+  "From the deployment's start until it was READY; null before READY."
+  totalMs: Int
+  "The build's wall time."
+  buildMs: Int
+  "The promotion's wall time."
+  promoteMs: Int
+  "The other measured phases, name to milliseconds: the build VM's (vm_install, vm_build, ...) and the promotion's own (admission, ...)."
+  phases: JSON!
+  buildMode: String
+  artifactTransport: String
+  buildMemoryMiB: Int
+}
+
 type ServiceRuntimeStatus {
   deploymentID: ID!
   alias: String
@@ -664,6 +688,30 @@ type ServiceRuntimeStatus {
   crashes: ServiceCrashes
   "True when the app's server tracks its crashes, so a null crashes means none; false for a server runtime that predates crash tracking, and for boxes."
   crashesTracked: Boolean!
+  "The deployment's measured deploy timeline (MCP get_service_status timings)."
+  timings: DeploymentTimings
+  "Set when the alias no longer runs this release (or never did); health is then superseded (failed for an attempt that never went live) unless this release still serves by its own preview URL."
+  notLive: ReleaseNotLive
+}
+
+"""
+A release its alias does not run: a deploy or rollback replaced it, the
+release that did was deleted, or it failed before it went live. Nothing runs
+it for its app, so retrying a read never changes that; a rollback makes it
+live again.
+"""
+type ReleaseNotLive {
+  alias: String!
+  "The release the alias runs now; null when it runs none, or one the caller may not see."
+  liveDeploymentID: ID
+  "When that release took the alias."
+  liveSince: String
+  "When this release stopped serving the alias; null for an attempt that never went live."
+  replacedAt: String
+  "True for an attempt that failed before it went live."
+  neverLive: Boolean!
+  "All of the above in one sentence."
+  message: String!
 }
 
 "Recent crashes of a service on the server that runs it."
@@ -703,6 +751,8 @@ type ServiceRuntimeLogs {
   stdoutBytes: Int!
   stderrBytes: Int!
   tailBytes: Int!
+  "Set when the alias no longer runs this release (or never did): the logs are whatever is still held for it, often none."
+  notLive: ReleaseNotLive
 }
 
 type AppStateValue {
@@ -2125,6 +2175,8 @@ type FileCommit {
   waiting: Boolean!
   "The app's commits waiting, while this one does."
   waitingCount: Int!
+  "While waiting, the commit's place in the app's commit queue: it has landed once AppCommitPage.waitingCommits is 0, or AppCommitPage.landedSeq reaches it."
+  queueSeq: Int
   "Whether the branch head, this write included, is imported and deployed like a push."
   deploys: Boolean!
   "Paths a push changed too since the write was made: the head keeps the pushed version (sha is the merge). Empty otherwise."
@@ -2637,6 +2689,8 @@ type AppCommitPage {
   waitingCommits: Int!
   "When the oldest waiting write was made (RFC3339); null when none waits."
   waitingSince: String
+  "While writes wait, the queue seq of the commit that last landed: a write whose FileCommit.queueSeq is at most this one is done. Null when none landed since the queue was last empty."
+  landedSeq: Int
   "The commit every live alias of the app runs, whether or not it is on this page."
   deployed: [AppDeployedCommit!]!
 }
@@ -2725,9 +2779,11 @@ type RestoreAppVersionPayload {
   "The new commit; with committed false, the head that already holds that version."
   sha: String!
   committed: Boolean!
-  "Whether the new commit is deployed like a push. The deploy is an import queued behind the restore: its deployment is the one whose gitCommit is sha (deploymentsPage with the workspace, then waitForDeployment)."
+  "Whether the new commit is deployed like a push. The deploy is an import queued behind the restore, with no deployment id yet: waitForDeployment(workspaceID, gitCommit: sha, alias: deployAlias, after: waitAfter) waits for it."
   deploys: Boolean!
   message: String!
+  "The workspace restored."
+  workspaceID: ID!
   "The app's branch."
   branch: String!
   "The alias a push deploys to, when the link names one; null otherwise (unfazed.json apps[] deploys each of its aliases)."
@@ -2736,6 +2792,8 @@ type RestoreAppVersionPayload {
   restoredFrom: String!
   "The branch head the new commit was made on; null with committed false."
   parent: String
+  "Where the platform's deployment order stood when the restore began: waitForDeployment's after, so an earlier deploy of the same files never answers. A place in that order, not a time, so a clock change cannot hide the restore's deploy."
+  waitAfter: Int!
 }
 
 enum WorkflowRunStatus { PENDING RUNNING COMPLETED FAILED CANCELLED }
@@ -2975,8 +3033,14 @@ type WriteWorkspaceFilesPayload {
 
 "What waitForDeployment read when it stopped waiting (MCP wait_for_deployment)."
 type DeploymentWaitPayload {
-  "The deployment as the wait left it."
-  deployment: Deployment!
+  "The deployment as the wait left it; null only when waiting by gitCommit before the import made it."
+  deployment: Deployment
+  "The deployment's status; waiting by gitCommit before the import made it, IMPORTING, or FAILED once the import failed on the commit."
+  status: String!
+  "Waiting by gitCommit: the workspace's latest git import, IMPORTING, READY or FAILED."
+  importStatus: String
+  "Waiting by gitCommit: that import's error, from the git provider and the build — untrusted text."
+  importError: String
   "True when the budget, or a server restart, ended the wait first: deployment is the current, unfinished state. Not an error: call again to keep waiting."
   timedOut: Boolean!
   "How long the server waited, in milliseconds."
@@ -3104,8 +3168,20 @@ type PlatformEventPage {
 }
 
 extend type Query {
-  "Block until a deployment leaves BUILDING (and a new app's direct landing ends) or timeoutSeconds pass (default 45, at most 50), then return it — the server-side wait of MCP wait_for_deployment, woken by the deploy pipeline itself, so a client never polls. A timeout is not an error: timedOut is true and the deployment is the current state; call again to keep waiting."
-  waitForDeployment(id: ID!, timeoutSeconds: Int): DeploymentWaitPayload!
+  """
+  Block until a deployment leaves BUILDING (and a new app's direct landing
+  ends) or timeoutSeconds pass (default 45, at most 50), then return it — the
+  server-side wait of MCP wait_for_deployment (the same wait), woken by the
+  deploy pipeline itself, so a client never polls. A timeout is not an error:
+  timedOut is true and the deployment is the current state; call again to keep
+  waiting. Give id, or workspaceID with gitCommit for the deploy a git import
+  makes of that commit (a restore, a push or a sync deploys before any id
+  exists): it waits for the import to make it, then for it, within the same
+  budget. alias is required when several apps deployed the commit; after
+  (RestoreAppVersionPayload.waitAfter) counts only deployments begun after it,
+  so an earlier deploy of the same commit never answers.
+  """
+  waitForDeployment(id: ID, workspaceID: ID, gitCommit: String, alias: String, after: Int, timeoutSeconds: Int): DeploymentWaitPayload!
   "A service app's error groups, most recently seen first (MCP list_errors). status: open, resolved or muted (default all); limit 1 to 100 (default 20); cursor is the previous page's nextCursor."
   appErrors(workspaceID: ID!, alias: String!, status: String, limit: Int, cursor: String): AppErrorGroupPage!
   "One error group of a service app with its latest occurrence, recent occurrences and the deployments it was seen in (MCP get_error_group)."