windmill-client 1.724.0 → 1.725.0

package/dist/types.gen.d.ts

@@ -1,3 +1,49 @@
+/**
+ * Overlay fields added to every "get by path" response that accepts
+ * the `get_draft` query parameter. The deployed payload is sent
+ * untouched in the response body; the authed user's saved draft
+ * for this path — whatever shape the editor wrote — is attached
+ * as the sibling `draft` field when `get_draft=true` and a draft
+ * exists. The frontend pairs the two to present diff / reset /
+ * discard UI; the server never merges them.
+ *
+ * When `no_deployed=true` there is no deployed row at this path —
+ * the response body is a best-effort stand-in synthesized from
+ * the draft, and only `draft` is canonical. Callers should disable
+ * "diff vs deployed" UI in that case.
+ *
+ */
+export type UserDraftOverlay = {
+    is_draft: boolean;
+    draft_saved_at?: string;
+    no_deployed?: boolean;
+    draft?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Other workspace users (and the legacy NULL-email row, if any)
+     * with a saved draft at the same path. Populated only on the
+     * authed user's "get by path" responses for kinds the editor
+     * surfaces a fork banner for (script, flow, app, raw_app).
+     * Empty / omitted for kinds without that UI.
+     *
+     */
+    other_drafts_users?: Array<{
+        /**
+         * Workspace username of the draft owner. `null` represents
+         * the legacy workspace-level (NULL-email) row. Emails never
+         * leave the server.
+         *
+         */
+        username?: string | null;
+    }>;
+};
+/**
+ * Closed set of item kinds a user can autosave as a draft. Mirrors the
+ * Postgres `DRAFT_KIND` enum and the backend `UserDraftItemKind`.
+ *
+ */
+export type UserDraftItemKind = 'script' | 'flow' | 'app' | 'raw_app' | 'resource' | 'variable' | 'trigger_schedule' | 'trigger_webhook' | 'trigger_default_email' | 'trigger_email' | 'trigger_http' | 'trigger_websocket' | 'trigger_postgres' | 'trigger_kafka' | 'trigger_nats' | 'trigger_mqtt' | 'trigger_sqs' | 'trigger_gcp' | 'trigger_azure' | 'trigger_poll' | 'trigger_cli' | 'trigger_nextcloud' | 'trigger_google' | 'trigger_github';
 /**
  * Top-level flow definition containing metadata, configuration, and the flow structure
  */
@@ -1445,7 +1491,6 @@ export type Script = {
     kind: 'script' | 'failure' | 'trigger' | 'command' | 'approval' | 'preprocessor';
     starred: boolean;
     tag?: string;
-    has_draft?: boolean;
     draft_only?: boolean;
     envs?: Array<(string)>;
     concurrent_limit?: number;
@@ -1498,7 +1543,6 @@ export type NewScript = {
     language: ScriptLang;
     kind?: 'script' | 'failure' | 'trigger' | 'command' | 'approval' | 'preprocessor';
     tag?: string;
-    draft_only?: boolean;
     envs?: Array<(string)>;
     concurrent_limit?: number;
     concurrency_time_window_s?: number;
@@ -1547,14 +1591,6 @@ export type NewScript = {
      */
     skip_draft_deletion?: boolean;
 };
-export type NewScriptWithDraft = NewScript & {
-    draft?: NewScript;
-    /**
-     * Timestamp at which the most recent DB draft was created. Used by the frontend's UserDraft staleness check.
-     */
-    draft_created_at?: string;
-    hash: string;
-};
 export type ScriptHistory = {
     script_hash: string;
     deployment_msg?: string;
@@ -2041,6 +2077,19 @@ export type ListableVariable = {
     ws_specific?: boolean;
     edited_at?: string;
     edited_by?: string;
+    /**
+     * True when this row is a per-user draft with no deployed
+     * variable at the same path. Frontend renders a "Draft" badge.
+     *
+     */
+    draft_only?: boolean;
+    /**
+     * True when the authed user has a per-user draft at this path
+     * (over a deployed row or a synthesized draft-only row).
+     * Frontend appends a `*` to the displayed name.
+     *
+     */
+    is_draft?: boolean;
 };
 export type ContextualVariable = {
     name: string;
@@ -2294,6 +2343,19 @@ export type ListableResource = {
      */
     inherited_labels?: Array<(string)>;
     ws_specific?: boolean;
+    /**
+     * True when this row is a per-user draft with no deployed
+     * resource at the same path. Frontend renders a "Draft" badge.
+     *
+     */
+    draft_only?: boolean;
+    /**
+     * True when the authed user has a per-user draft at this path
+     * (over a deployed row or a synthesized draft-only row).
+     * Frontend appends a `*` to the displayed name.
+     *
+     */
+    is_draft?: boolean;
 };
 export type ResourceType = {
     workspace_id?: string;
@@ -2423,6 +2485,19 @@ export type Schedule = {
      */
     dynamic_skip?: string | null;
     labels?: Array<(string)>;
+    /**
+     * True when this row is a per-user draft with no deployed
+     * schedule at the same path. Frontend renders a "Draft" badge.
+     *
+     */
+    draft_only?: boolean;
+    /**
+     * True when the authed user has a per-user draft at this path
+     * (over a deployed row or a synthesized draft-only row).
+     * Frontend appends a `*` to the displayed name.
+     *
+     */
+    is_draft?: boolean;
     /**
      * Labels inherited from the parent folder, computed at read time. Read-only — edit them on the folder.
      *
@@ -2661,6 +2736,21 @@ export type TriggerExtraProperty = {
      */
     mode: TriggerMode;
     labels?: Array<(string)>;
+    /**
+     * True when this row is a per-user draft with no deployed
+     * trigger at the same path. Set by list endpoints when
+     * `include_draft_only=true` synthesizes the row from the
+     * draft. Frontend renders a "Draft" badge.
+     *
+     */
+    draft_only?: boolean;
+    /**
+     * True when the authed user has a per-user draft at this path
+     * (over a deployed row or a synthesized draft-only row).
+     * Frontend appends a `*` to the displayed name.
+     *
+     */
+    is_draft?: boolean;
 };
 export type AuthenticationMethod = 'none' | 'windmill' | 'api_key' | 'basic_http' | 'custom_script' | 'signature';
 export type RunnableKind = 'script' | 'flow';
@@ -4628,6 +4718,33 @@ export type ListableApp = {
     execution_mode: 'viewer' | 'publisher' | 'anonymous';
     raw_app?: boolean;
     labels?: Array<(string)>;
+    /**
+     * True when the authed user has a draft for this app — either no
+     * deployed row exists at this path (draft-only) or the user has
+     * saved a per-user draft on top of the deployed row.
+     *
+     */
+    is_draft?: boolean;
+    /**
+     * User-typed path the editor has staged but not yet deployed.
+     * Sourced from the draft JSON's `draft_path` field (the editor
+     * only writes it when the typed path differs from the deployed
+     * one). Lets the home list render the meaningful name instead of
+     * the autogenerated `u/{user}/draft_{uuid}` URL path. Omitted
+     * when unchanged.
+     *
+     */
+    draft_path?: string;
+    /**
+     * Workspace users (including the authed user, and the legacy
+     * NULL-email row if any) who have a per-user draft at this
+     * path. Drives the home page's user-avatar circles inside the
+     * Draft badge. Omitted when no drafts exist.
+     *
+     */
+    draft_users?: Array<{
+        username?: string | null;
+    }>;
     /**
      * Labels inherited from the parent folder, computed at read time. Read-only — edit them on the folder.
      *
@@ -4681,14 +4798,6 @@ export type AppWithLastVersion = {
     bundle_secret?: string;
     labels?: Array<(string)>;
 };
-export type AppWithLastVersionWDraft = AppWithLastVersion & {
-    draft_only?: boolean;
-    draft?: unknown;
-    /**
-     * Timestamp at which the most recent DB draft was created. Used by the frontend's UserDraft staleness check.
-     */
-    draft_created_at?: string;
-};
 export type AppHistory = {
     version: number;
     deployment_msg?: string;
@@ -5526,6 +5635,19 @@ export type GithubRepoEntry = {
     owner: string;
     private: boolean;
 };
+/**
+ * When true, overlay the authed user's draft (if any) onto the deployed payload.
+ */
+export type ParameterGetDraft = boolean;
+/**
+ * When true, append per-user draft rows whose path has no
+ * deployed counterpart. Synthesized rows carry `draft_only: true`
+ * so the home page can render a "Draft" badge. Gated to
+ * non-operators + page 0 + no narrowing filters on the backend so
+ * picker callers stay deployed-only and pagination stays clean.
+ *
+ */
+export type ParameterIncludeDraftOnly = boolean;
 export type ParameterId = string;
 export type ParameterKey = string;
 export type ParameterWorkspaceId = string;
@@ -7635,6 +7757,10 @@ export type GetVariableData = {
      *
      */
     decryptSecret?: boolean;
+    /**
+     * When true, overlay the authed user's draft (if any) onto the deployed payload.
+     */
+    getDraft?: boolean;
     /**
      * ask to include the encrypted value if secret and decrypt secret is not true (default: false)
      *
@@ -7643,7 +7769,7 @@ export type GetVariableData = {
     path: string;
     workspace: string;
 };
-export type GetVariableResponse = ListableVariable;
+export type GetVariableResponse = ListableVariable & UserDraftOverlay;
 export type GetVariableValueData = {
     /**
      * allow getting a cached value for improved performance
@@ -7668,6 +7794,13 @@ export type ListVariableData = {
      * pattern match filter for description field (case-insensitive)
      */
     description?: string;
+    /**
+     * When true, append per-user draft variables whose path has no
+     * deployed variable. Synthesized rows carry `draft_only: true`
+     * so the home page can render a "Draft" badge.
+     *
+     */
+    includeDraftOnly?: boolean;
     /**
      * Filter by label
      */
@@ -7926,10 +8059,14 @@ export type UpdateResourceValueData = {
 };
 export type UpdateResourceValueResponse = string;
 export type GetResourceData = {
+    /**
+     * When true, overlay the authed user's draft (if any) onto the deployed payload.
+     */
+    getDraft?: boolean;
     path: string;
     workspace: string;
 };
-export type GetResourceResponse = Resource;
+export type GetResourceResponse = ListableResource & UserDraftOverlay;
 export type GetResourceValueInterpolatedData = {
     /**
      * allow getting a cached value for improved performance
@@ -7973,6 +8110,13 @@ export type ListResourceData = {
      * pattern match filter for description field (case-insensitive)
      */
     description?: string;
+    /**
+     * When true, append per-user draft resources whose path has
+     * no deployed resource. Synthesized rows carry
+     * `draft_only: true`.
+     *
+     */
+    includeDraftOnly?: boolean;
     /**
      * Filter by label
      */
@@ -8266,8 +8410,38 @@ export type ListFlowsData = {
     workspace: string;
 };
 export type ListFlowsResponse = Array<(Flow & {
-    has_draft?: boolean;
     draft_only?: boolean;
+    /**
+     * True when the authed user has a draft for this
+     * flow — either no deployed row exists at this
+     * path (draft-only) or the user saved a per-user
+     * draft on top of the deployed row.
+     *
+     */
+    is_draft?: boolean;
+    /**
+     * User-typed path the editor has staged but not
+     * yet deployed. Sourced from the draft JSON's
+     * `draft_path` field (the editor only writes it
+     * when the typed path differs from the deployed
+     * one). Lets the home list render the meaningful
+     * name instead of the autogenerated
+     * `u/{user}/draft_{uuid}` URL path. Omitted when
+     * unchanged.
+     *
+     */
+    draft_path?: string;
+    /**
+     * Workspace users (including the authed user, and
+     * the legacy NULL-email row if any) who have a
+     * per-user draft at this path. Drives the home
+     * page's user-avatar circles inside the Draft
+     * badge. Omitted when no drafts exist.
+     *
+     */
+    draft_users?: Array<{
+        username?: string | null;
+    }>;
 })>;
 export type GetFlowHistoryData = {
     path: string;
@@ -8303,11 +8477,15 @@ export type UpdateFlowHistoryData = {
 };
 export type UpdateFlowHistoryResponse = string;
 export type GetFlowByPathData = {
+    /**
+     * When true, overlay the authed user's draft (if any) onto the deployed payload.
+     */
+    getDraft?: boolean;
     path: string;
     withStarredInfo?: boolean;
     workspace: string;
 };
-export type GetFlowByPathResponse = Flow;
+export type GetFlowByPathResponse = Flow & UserDraftOverlay;
 export type GetFlowDeploymentStatusData = {
     path: string;
     workspace: string;
@@ -8337,17 +8515,6 @@ export type ToggleWorkspaceErrorHandlerForFlowData = {
     workspace: string;
 };
 export type ToggleWorkspaceErrorHandlerForFlowResponse = string;
-export type GetFlowByPathWithDraftData = {
-    path: string;
-    workspace: string;
-};
-export type GetFlowByPathWithDraftResponse = Flow & {
-    draft?: Flow;
-    /**
-     * Timestamp at which the most recent DB draft was created. Used by the frontend's UserDraft staleness check.
-     */
-    draft_created_at?: string;
-};
 export type ExistsFlowByPathData = {
     path: string;
     workspace: string;
@@ -8358,7 +8525,6 @@ export type CreateFlowData = {
      * Partially filled flow
      */
     requestBody: OpenFlowWPath & {
-        draft_only?: boolean;
         deployment_message?: string;
         /**
          * When true (set by the CLI / git sync), deploying this flow does not delete an existing user draft at the same path.
@@ -8508,7 +8674,6 @@ export type CreateAppData = {
         value: unknown;
         summary: string;
         policy: Policy;
-        draft_only?: boolean;
         deployment_message?: string;
         custom_path?: string;
         /**
@@ -8534,7 +8699,6 @@ export type CreateAppRawData = {
             value: unknown;
             summary: string;
             policy: Policy;
-            draft_only?: boolean;
             deployment_message?: string;
             custom_path?: string;
             /**
@@ -8559,21 +8723,27 @@ export type ExistsAppData = {
 };
 export type ExistsAppResponse = boolean;
 export type GetAppByPathData = {
+    /**
+     * When true, overlay the authed user's draft (if any) onto the deployed payload.
+     */
+    getDraft?: boolean;
     path: string;
+    /**
+     * When no deployed app exists at this path and `get_draft` is set,
+     * disambiguates which draft kind (`raw_app` or `app`) to look up.
+     * Ignored when a deployed row exists.
+     *
+     */
+    rawApp?: boolean;
     withStarredInfo?: boolean;
     workspace: string;
 };
-export type GetAppByPathResponse = AppWithLastVersion;
+export type GetAppByPathResponse = AppWithLastVersion & UserDraftOverlay;
 export type GetAppLiteByPathData = {
     path: string;
     workspace: string;
 };
 export type GetAppLiteByPathResponse = AppWithLastVersion;
-export type GetAppByPathWithDraftData = {
-    path: string;
-    workspace: string;
-};
-export type GetAppByPathWithDraftResponse = AppWithLastVersionWDraft;
 export type GetAppHistoryByPathData = {
     path: string;
     workspace: string;
@@ -8966,7 +9136,37 @@ export type ListScriptsData = {
     withoutDescription?: boolean;
     workspace: string;
 };
-export type ListScriptsResponse = Array<Script>;
+export type ListScriptsResponse = Array<(Script & {
+    /**
+     * True when the authed user has a draft for this
+     * script — either no deployed row exists at this
+     * path (draft-only) or the user saved a per-user
+     * draft on top of the deployed row.
+     *
+     */
+    is_draft?: boolean;
+    /**
+     * User-typed path the editor has staged but not
+     * yet deployed. Surfaced for draft-only rows so
+     * the home list can render the meaningful name
+     * instead of the autogenerated
+     * `u/{user}/draft_{uuid}` URL path. Omitted
+     * when unchanged.
+     *
+     */
+    draft_path?: string;
+    /**
+     * Workspace users (including the authed user, and
+     * the legacy NULL-email row if any) who have a
+     * per-user draft at this path. Drives the home
+     * page's user-avatar circles inside the Draft
+     * badge. Omitted when no drafts exist.
+     *
+     */
+    draft_users?: Array<{
+        username?: string | null;
+    }>;
+})>;
 export type ListScriptPathsData = {
     workspace: string;
 };
@@ -9025,11 +9225,15 @@ export type DeleteScriptsBulkData = {
 };
 export type DeleteScriptsBulkResponse = Array<(string)>;
 export type GetScriptByPathData = {
+    /**
+     * When true, overlay the authed user's draft (if any) onto the deployed payload.
+     */
+    getDraft?: boolean;
     path: string;
     withStarredInfo?: boolean;
     workspace: string;
 };
-export type GetScriptByPathResponse = Script;
+export type GetScriptByPathResponse = Script & UserDraftOverlay;
 export type GetTriggersCountOfScriptData = {
     path: string;
     workspace: string;
@@ -9040,11 +9244,6 @@ export type ListTokensOfScriptData = {
     workspace: string;
 };
 export type ListTokensOfScriptResponse = Array<TruncatedToken>;
-export type GetScriptByPathWithDraftData = {
-    path: string;
-    workspace: string;
-};
-export type GetScriptByPathWithDraftResponse = NewScriptWithDraft;
 export type GetScriptHistoryByPathData = {
     path: string;
     workspace: string;
@@ -9176,21 +9375,58 @@ export type DiffRawScriptsWithDeployedData = {
     workspace: string;
 };
 export type DiffRawScriptsWithDeployedResponse = Array<(string)>;
-export type CreateDraftData = {
+export type ListDraftsData = {
+    workspace: string;
+};
+export type ListDraftsResponse = Array<{
+    kind: UserDraftItemKind;
+    path: string;
+    /**
+     * Best-effort, read from the draft JSON's `summary` field when the editor shape carries one.
+     */
+    summary?: string;
+    /**
+     * No deployed counterpart exists at this path — the draft is the whole item.
+     */
+    draft_only: boolean;
+    created_at: string;
+}>;
+export type GetDraftForUserData = {
+    kind: UserDraftItemKind;
+    path: string;
+    /**
+     * Workspace username of the draft owner. Omit to fetch the legacy workspace-level (NULL email) row.
+     */
+    username?: string;
+    workspace: string;
+};
+export type GetDraftForUserResponse = {
+    value: unknown;
+    created_at: string;
+};
+export type UpdateDraftData = {
+    kind: UserDraftItemKind;
+    path: string;
     requestBody: {
-        path: string;
-        typ: 'flow' | 'script' | 'app';
+        /**
+         * Draft content to save. `null` (or omitted) signals a delete — the row is removed under the same conflict rules.
+         */
         value?: unknown;
+        /**
+         * Server timestamp of the client's last known sync for this draft. Omit on first save.
+         */
+        last_sync?: string;
+        /**
+         * Skip the conflict check and overwrite the server copy.
+         */
+        force?: boolean;
     };
     workspace: string;
 };
-export type CreateDraftResponse = string;
-export type DeleteDraftData = {
-    kind: 'script' | 'flow' | 'app';
-    path: string;
-    workspace: string;
+export type UpdateDraftResponse = {
+    status: 'saved' | 'conflict';
+    current_timestamp: string;
 };
-export type DeleteDraftResponse = string;
 export type GetCustomTagsData = {
     showWorkspaceRestriction?: boolean;
 };
@@ -11479,6 +11715,15 @@ export type ListRawAppsData = {
      * filter by exact matching user creator. Supports comma-separated list (e.g. 'alice,bob') and negation by prefixing all values with '!' (e.g. '!alice,!bob')
      */
     createdBy?: string;
+    /**
+     * When true, append per-user draft rows whose path has no
+     * deployed counterpart. Synthesized rows carry `draft_only: true`
+     * so the home page can render a "Draft" badge. Gated to
+     * non-operators + page 0 + no narrowing filters on the backend so
+     * picker callers stay deployed-only and pagination stays clean.
+     *
+     */
+    includeDraftOnly?: boolean;
     /**
      * Filter by label
      */
@@ -11604,10 +11849,14 @@ export type DeleteScheduleData = {
 };
 export type DeleteScheduleResponse = string;
 export type GetScheduleData = {
+    /**
+     * When true, overlay the authed user's draft (if any) onto the deployed payload.
+     */
+    getDraft?: boolean;
     path: string;
     workspace: string;
 };
-export type GetScheduleResponse = Schedule;
+export type GetScheduleResponse = Schedule & UserDraftOverlay;
 export type ExistsScheduleData = {
     path: string;
     workspace: string;
@@ -11626,6 +11875,13 @@ export type ListSchedulesData = {
      * pattern match filter for description field (case-insensitive)
      */
     description?: string;
+    /**
+     * When true, append per-user draft schedules whose path has
+     * no deployed schedule. Synthesized rows carry
+     * `draft_only: true`.
+     *
+     */
+    includeDraftOnly?: boolean;
     /**
      * filter schedules by whether they target a flow
      */
@@ -11738,11 +11994,24 @@ export type DeleteHttpTriggerData = {
 };
 export type DeleteHttpTriggerResponse = string;
 export type GetHttpTriggerData = {
+    /**
+     * When true, overlay the authed user's draft (if any) onto the deployed payload.
+     */
+    getDraft?: boolean;
     path: string;
     workspace: string;
 };
-export type GetHttpTriggerResponse = HttpTrigger;
+export type GetHttpTriggerResponse = HttpTrigger & UserDraftOverlay;
 export type ListHttpTriggersData = {
+    /**
+     * When true, append per-user draft rows whose path has no
+     * deployed counterpart. Synthesized rows carry `draft_only: true`
+     * so the home page can render a "Draft" badge. Gated to
+     * non-operators + page 0 + no narrowing filters on the backend so
+     * picker callers stay deployed-only and pagination stays clean.
+     *
+     */
+    includeDraftOnly?: boolean;
     isFlow?: boolean;
     /**
      * Filter by label
@@ -11818,11 +12087,24 @@ export type DeleteWebsocketTriggerData = {
 };
 export type DeleteWebsocketTriggerResponse = string;
 export type GetWebsocketTriggerData = {
+    /**
+     * When true, overlay the authed user's draft (if any) onto the deployed payload.
+     */
+    getDraft?: boolean;
     path: string;
     workspace: string;
 };
-export type GetWebsocketTriggerResponse = WebsocketTrigger;
+export type GetWebsocketTriggerResponse = WebsocketTrigger & UserDraftOverlay;
 export type ListWebsocketTriggersData = {
+    /**
+     * When true, append per-user draft rows whose path has no
+     * deployed counterpart. Synthesized rows carry `draft_only: true`
+     * so the home page can render a "Draft" badge. Gated to
+     * non-operators + page 0 + no narrowing filters on the backend so
+     * picker callers stay deployed-only and pagination stays clean.
+     *
+     */
+    includeDraftOnly?: boolean;
     isFlow?: boolean;
     /**
      * Filter by label
@@ -11900,11 +12182,24 @@ export type DeleteKafkaTriggerData = {
 };
 export type DeleteKafkaTriggerResponse = string;
 export type GetKafkaTriggerData = {
+    /**
+     * When true, overlay the authed user's draft (if any) onto the deployed payload.
+     */
+    getDraft?: boolean;
     path: string;
     workspace: string;
 };
-export type GetKafkaTriggerResponse = KafkaTrigger;
+export type GetKafkaTriggerResponse = KafkaTrigger & UserDraftOverlay;
 export type ListKafkaTriggersData = {
+    /**
+     * When true, append per-user draft rows whose path has no
+     * deployed counterpart. Synthesized rows carry `draft_only: true`
+     * so the home page can render a "Draft" badge. Gated to
+     * non-operators + page 0 + no narrowing filters on the backend so
+     * picker callers stay deployed-only and pagination stays clean.
+     *
+     */
+    includeDraftOnly?: boolean;
     isFlow?: boolean;
     /**
      * Filter by label
@@ -12000,11 +12295,24 @@ export type DeleteNatsTriggerData = {
 };
 export type DeleteNatsTriggerResponse = string;
 export type GetNatsTriggerData = {
+    /**
+     * When true, overlay the authed user's draft (if any) onto the deployed payload.
+     */
+    getDraft?: boolean;
     path: string;
     workspace: string;
 };
-export type GetNatsTriggerResponse = NatsTrigger;
+export type GetNatsTriggerResponse = NatsTrigger & UserDraftOverlay;
 export type ListNatsTriggersData = {
+    /**
+     * When true, append per-user draft rows whose path has no
+     * deployed counterpart. Synthesized rows carry `draft_only: true`
+     * so the home page can render a "Draft" badge. Gated to
+     * non-operators + page 0 + no narrowing filters on the backend so
+     * picker callers stay deployed-only and pagination stays clean.
+     *
+     */
+    includeDraftOnly?: boolean;
     isFlow?: boolean;
     /**
      * Filter by label
@@ -12082,11 +12390,24 @@ export type DeleteSqsTriggerData = {
 };
 export type DeleteSqsTriggerResponse = string;
 export type GetSqsTriggerData = {
+    /**
+     * When true, overlay the authed user's draft (if any) onto the deployed payload.
+     */
+    getDraft?: boolean;
     path: string;
     workspace: string;
 };
-export type GetSqsTriggerResponse = SqsTrigger;
+export type GetSqsTriggerResponse = SqsTrigger & UserDraftOverlay;
 export type ListSqsTriggersData = {
+    /**
+     * When true, append per-user draft rows whose path has no
+     * deployed counterpart. Synthesized rows carry `draft_only: true`
+     * so the home page can render a "Draft" badge. Gated to
+     * non-operators + page 0 + no narrowing filters on the backend so
+     * picker callers stay deployed-only and pagination stays clean.
+     *
+     */
+    includeDraftOnly?: boolean;
     isFlow?: boolean;
     /**
      * Filter by label
@@ -12242,6 +12563,15 @@ export type DeleteNativeTriggerData = {
 };
 export type DeleteNativeTriggerResponse = string;
 export type ListNativeTriggersData = {
+    /**
+     * When true, append per-user draft rows whose path has no
+     * deployed counterpart. Synthesized rows carry `draft_only: true`
+     * so the home page can render a "Draft" badge. Gated to
+     * non-operators + page 0 + no narrowing filters on the backend so
+     * picker callers stay deployed-only and pagination stays clean.
+     *
+     */
+    includeDraftOnly?: boolean;
     /**
      * filter by is_flow
      */
@@ -12354,11 +12684,24 @@ export type DeleteMqttTriggerData = {
 };
 export type DeleteMqttTriggerResponse = string;
 export type GetMqttTriggerData = {
+    /**
+     * When true, overlay the authed user's draft (if any) onto the deployed payload.
+     */
+    getDraft?: boolean;
     path: string;
     workspace: string;
 };
-export type GetMqttTriggerResponse = MqttTrigger;
+export type GetMqttTriggerResponse = MqttTrigger & UserDraftOverlay;
 export type ListMqttTriggersData = {
+    /**
+     * When true, append per-user draft rows whose path has no
+     * deployed counterpart. Synthesized rows carry `draft_only: true`
+     * so the home page can render a "Draft" badge. Gated to
+     * non-operators + page 0 + no narrowing filters on the backend so
+     * picker callers stay deployed-only and pagination stays clean.
+     *
+     */
+    includeDraftOnly?: boolean;
     isFlow?: boolean;
     /**
      * Filter by label
@@ -12436,11 +12779,24 @@ export type DeleteGcpTriggerData = {
 };
 export type DeleteGcpTriggerResponse = string;
 export type GetGcpTriggerData = {
+    /**
+     * When true, overlay the authed user's draft (if any) onto the deployed payload.
+     */
+    getDraft?: boolean;
     path: string;
     workspace: string;
 };
-export type GetGcpTriggerResponse = GcpTrigger;
+export type GetGcpTriggerResponse = GcpTrigger & UserDraftOverlay;
 export type ListGcpTriggersData = {
+    /**
+     * When true, append per-user draft rows whose path has no
+     * deployed counterpart. Synthesized rows carry `draft_only: true`
+     * so the home page can render a "Draft" badge. Gated to
+     * non-operators + page 0 + no narrowing filters on the backend so
+     * picker callers stay deployed-only and pagination stays clean.
+     *
+     */
+    includeDraftOnly?: boolean;
     isFlow?: boolean;
     /**
      * Filter by label
@@ -12535,11 +12891,24 @@ export type DeleteAzureTriggerData = {
 };
 export type DeleteAzureTriggerResponse = string;
 export type GetAzureTriggerData = {
+    /**
+     * When true, overlay the authed user's draft (if any) onto the deployed payload.
+     */
+    getDraft?: boolean;
     path: string;
     workspace: string;
 };
-export type GetAzureTriggerResponse = AzureTrigger;
+export type GetAzureTriggerResponse = AzureTrigger & UserDraftOverlay;
 export type ListAzureTriggersData = {
+    /**
+     * When true, append per-user draft rows whose path has no
+     * deployed counterpart. Synthesized rows carry `draft_only: true`
+     * so the home page can render a "Draft" badge. Gated to
+     * non-operators + page 0 + no narrowing filters on the backend so
+     * picker callers stay deployed-only and pagination stays clean.
+     *
+     */
+    includeDraftOnly?: boolean;
     isFlow?: boolean;
     /**
      * which page to return (start at 1, default 1)
@@ -12730,11 +13099,24 @@ export type DeletePostgresTriggerData = {
 };
 export type DeletePostgresTriggerResponse = string;
 export type GetPostgresTriggerData = {
+    /**
+     * When true, overlay the authed user's draft (if any) onto the deployed payload.
+     */
+    getDraft?: boolean;
     path: string;
     workspace: string;
 };
-export type GetPostgresTriggerResponse = PostgresTrigger;
+export type GetPostgresTriggerResponse = PostgresTrigger & UserDraftOverlay;
 export type ListPostgresTriggersData = {
+    /**
+     * When true, append per-user draft rows whose path has no
+     * deployed counterpart. Synthesized rows carry `draft_only: true`
+     * so the home page can render a "Draft" badge. Gated to
+     * non-operators + page 0 + no narrowing filters on the backend so
+     * picker callers stay deployed-only and pagination stays clean.
+     *
+     */
+    includeDraftOnly?: boolean;
     isFlow?: boolean;
     /**
      * Filter by label
@@ -12810,11 +13192,24 @@ export type DeleteEmailTriggerData = {
 };
 export type DeleteEmailTriggerResponse = string;
 export type GetEmailTriggerData = {
+    /**
+     * When true, overlay the authed user's draft (if any) onto the deployed payload.
+     */
+    getDraft?: boolean;
     path: string;
     workspace: string;
 };
-export type GetEmailTriggerResponse = EmailTrigger;
+export type GetEmailTriggerResponse = EmailTrigger & UserDraftOverlay;
 export type ListEmailTriggersData = {
+    /**
+     * When true, append per-user draft rows whose path has no
+     * deployed counterpart. Synthesized rows carry `draft_only: true`
+     * so the home page can render a "Draft" badge. Gated to
+     * non-operators + page 0 + no narrowing filters on the backend so
+     * picker callers stay deployed-only and pagination stays clean.
+     *
+     */
+    includeDraftOnly?: boolean;
     isFlow?: boolean;
     /**
      * Filter by label
@@ -18096,6 +18491,10 @@ export type $OpenApiTs = {
                  *
                  */
                 decryptSecret?: boolean;
+                /**
+                 * When true, overlay the authed user's draft (if any) onto the deployed payload.
+                 */
+                getDraft?: boolean;
                 /**
                  * ask to include the encrypted value if secret and decrypt secret is not true (default: false)
                  *
@@ -18108,7 +18507,7 @@ export type $OpenApiTs = {
                 /**
                  * variable
                  */
-                200: ListableVariable;
+                200: ListableVariable & UserDraftOverlay;
             };
         };
     };
@@ -18156,6 +18555,13 @@ export type $OpenApiTs = {
                  * pattern match filter for description field (case-insensitive)
                  */
                 description?: string;
+                /**
+                 * When true, append per-user draft variables whose path has no
+                 * deployed variable. Synthesized rows carry `draft_only: true`
+                 * so the home page can render a "Draft" badge.
+                 *
+                 */
+                includeDraftOnly?: boolean;
                 /**
                  * Filter by label
                  */
@@ -18603,6 +19009,10 @@ export type $OpenApiTs = {
     '/w/{workspace}/resources/get/{path}': {
         get: {
             req: {
+                /**
+                 * When true, overlay the authed user's draft (if any) onto the deployed payload.
+                 */
+                getDraft?: boolean;
                 path: string;
                 workspace: string;
             };
@@ -18610,7 +19020,7 @@ export type $OpenApiTs = {
                 /**
                  * resource
                  */
-                200: Resource;
+                200: ListableResource & UserDraftOverlay;
             };
         };
     };
@@ -18695,6 +19105,13 @@ export type $OpenApiTs = {
                  * pattern match filter for description field (case-insensitive)
                  */
                 description?: string;
+                /**
+                 * When true, append per-user draft resources whose path has
+                 * no deployed resource. Synthesized rows carry
+                 * `draft_only: true`.
+                 *
+                 */
+                includeDraftOnly?: boolean;
                 /**
                  * Filter by label
                  */
@@ -19190,8 +19607,38 @@ export type $OpenApiTs = {
                  * All flow
                  */
                 200: Array<(Flow & {
-                    has_draft?: boolean;
                     draft_only?: boolean;
+                    /**
+                     * True when the authed user has a draft for this
+                     * flow — either no deployed row exists at this
+                     * path (draft-only) or the user saved a per-user
+                     * draft on top of the deployed row.
+                     *
+                     */
+                    is_draft?: boolean;
+                    /**
+                     * User-typed path the editor has staged but not
+                     * yet deployed. Sourced from the draft JSON's
+                     * `draft_path` field (the editor only writes it
+                     * when the typed path differs from the deployed
+                     * one). Lets the home list render the meaningful
+                     * name instead of the autogenerated
+                     * `u/{user}/draft_{uuid}` URL path. Omitted when
+                     * unchanged.
+                     *
+                     */
+                    draft_path?: string;
+                    /**
+                     * Workspace users (including the authed user, and
+                     * the legacy NULL-email row if any) who have a
+                     * per-user draft at this path. Drives the home
+                     * page's user-avatar circles inside the Draft
+                     * badge. Omitted when no drafts exist.
+                     *
+                     */
+                    draft_users?: Array<{
+                        username?: string | null;
+                    }>;
                 })>;
             };
         };
@@ -19277,6 +19724,10 @@ export type $OpenApiTs = {
     '/w/{workspace}/flows/get/{path}': {
         get: {
             req: {
+                /**
+                 * When true, overlay the authed user's draft (if any) onto the deployed payload.
+                 */
+                getDraft?: boolean;
                 path: string;
                 withStarredInfo?: boolean;
                 workspace: string;
@@ -19285,7 +19736,7 @@ export type $OpenApiTs = {
                 /**
                  * flow details
                  */
-                200: Flow;
+                200: Flow & UserDraftOverlay;
             };
         };
     };
@@ -19354,26 +19805,6 @@ export type $OpenApiTs = {
             };
         };
     };
-    '/w/{workspace}/flows/get/draft/{path}': {
-        get: {
-            req: {
-                path: string;
-                workspace: string;
-            };
-            res: {
-                /**
-                 * flow details with draft
-                 */
-                200: Flow & {
-                    draft?: Flow;
-                    /**
-                     * Timestamp at which the most recent DB draft was created. Used by the frontend's UserDraft staleness check.
-                     */
-                    draft_created_at?: string;
-                };
-            };
-        };
-    };
     '/w/{workspace}/flows/exists/{path}': {
         get: {
             req: {
@@ -19395,7 +19826,6 @@ export type $OpenApiTs = {
                  * Partially filled flow
                  */
                 requestBody: OpenFlowWPath & {
-                    draft_only?: boolean;
                     deployment_message?: string;
                     /**
                      * When true (set by the CLI / git sync), deploying this flow does not delete an existing user draft at the same path.
@@ -19644,7 +20074,6 @@ export type $OpenApiTs = {
                     value: unknown;
                     summary: string;
                     policy: Policy;
-                    draft_only?: boolean;
                     deployment_message?: string;
                     custom_path?: string;
                     /**
@@ -19679,7 +20108,6 @@ export type $OpenApiTs = {
                         value: unknown;
                         summary: string;
                         policy: Policy;
-                        draft_only?: boolean;
                         deployment_message?: string;
                         custom_path?: string;
                         /**
@@ -19722,7 +20150,18 @@ export type $OpenApiTs = {
     '/w/{workspace}/apps/get/p/{path}': {
         get: {
             req: {
+                /**
+                 * When true, overlay the authed user's draft (if any) onto the deployed payload.
+                 */
+                getDraft?: boolean;
                 path: string;
+                /**
+                 * When no deployed app exists at this path and `get_draft` is set,
+                 * disambiguates which draft kind (`raw_app` or `app`) to look up.
+                 * Ignored when a deployed row exists.
+                 *
+                 */
+                rawApp?: boolean;
                 withStarredInfo?: boolean;
                 workspace: string;
             };
@@ -19730,7 +20169,7 @@ export type $OpenApiTs = {
                 /**
                  * app details
                  */
-                200: AppWithLastVersion;
+                200: AppWithLastVersion & UserDraftOverlay;
             };
         };
     };
@@ -19748,20 +20187,6 @@ export type $OpenApiTs = {
             };
         };
     };
-    '/w/{workspace}/apps/get/draft/{path}': {
-        get: {
-            req: {
-                path: string;
-                workspace: string;
-            };
-            res: {
-                /**
-                 * app details with draft
-                 */
-                200: AppWithLastVersionWDraft;
-            };
-        };
-    };
     '/w/{workspace}/apps/history/p/{path}': {
         get: {
             req: {
@@ -20367,7 +20792,37 @@ export type $OpenApiTs = {
                 /**
                  * All scripts
                  */
-                200: Array<Script>;
+                200: Array<(Script & {
+                    /**
+                     * True when the authed user has a draft for this
+                     * script — either no deployed row exists at this
+                     * path (draft-only) or the user saved a per-user
+                     * draft on top of the deployed row.
+                     *
+                     */
+                    is_draft?: boolean;
+                    /**
+                     * User-typed path the editor has staged but not
+                     * yet deployed. Surfaced for draft-only rows so
+                     * the home list can render the meaningful name
+                     * instead of the autogenerated
+                     * `u/{user}/draft_{uuid}` URL path. Omitted
+                     * when unchanged.
+                     *
+                     */
+                    draft_path?: string;
+                    /**
+                     * Workspace users (including the authed user, and
+                     * the legacy NULL-email row if any) who have a
+                     * per-user draft at this path. Drives the home
+                     * page's user-avatar circles inside the Draft
+                     * badge. Omitted when no drafts exist.
+                     *
+                     */
+                    draft_users?: Array<{
+                        username?: string | null;
+                    }>;
+                })>;
             };
         };
     };
@@ -20503,6 +20958,10 @@ export type $OpenApiTs = {
     '/w/{workspace}/scripts/get/p/{path}': {
         get: {
             req: {
+                /**
+                 * When true, overlay the authed user's draft (if any) onto the deployed payload.
+                 */
+                getDraft?: boolean;
                 path: string;
                 withStarredInfo?: boolean;
                 workspace: string;
@@ -20511,7 +20970,7 @@ export type $OpenApiTs = {
                 /**
                  * script details
                  */
-                200: Script;
+                200: Script & UserDraftOverlay;
             };
         };
     };
@@ -20543,20 +21002,6 @@ export type $OpenApiTs = {
             };
         };
     };
-    '/w/{workspace}/scripts/get/draft/{path}': {
-        get: {
-            req: {
-                path: string;
-                workspace: string;
-            };
-            res: {
-                /**
-                 * script details
-                 */
-                200: NewScriptWithDraft;
-            };
-        };
-    };
     '/w/{workspace}/scripts/history/p/{path}': {
         get: {
             req: {
@@ -20823,36 +21268,86 @@ export type $OpenApiTs = {
             };
         };
     };
-    '/w/{workspace}/drafts/create': {
-        post: {
+    '/w/{workspace}/drafts/list': {
+        get: {
             req: {
-                requestBody: {
+                workspace: string;
+            };
+            res: {
+                /**
+                 * the user's drafts
+                 */
+                200: Array<{
+                    kind: UserDraftItemKind;
                     path: string;
-                    typ: 'flow' | 'script' | 'app';
-                    value?: unknown;
-                };
+                    /**
+                     * Best-effort, read from the draft JSON's `summary` field when the editor shape carries one.
+                     */
+                    summary?: string;
+                    /**
+                     * No deployed counterpart exists at this path — the draft is the whole item.
+                     */
+                    draft_only: boolean;
+                    created_at: string;
+                }>;
+            };
+        };
+    };
+    '/w/{workspace}/drafts/get/{kind}/{path}': {
+        get: {
+            req: {
+                kind: UserDraftItemKind;
+                path: string;
+                /**
+                 * Workspace username of the draft owner. Omit to fetch the legacy workspace-level (NULL email) row.
+                 */
+                username?: string;
                 workspace: string;
             };
             res: {
                 /**
-                 * draft created
+                 * draft content
                  */
-                201: string;
+                200: {
+                    value: unknown;
+                    created_at: string;
+                };
+                /**
+                 * no draft for that owner at that path
+                 */
+                404: unknown;
             };
         };
     };
-    '/w/{workspace}/drafts/delete/{kind}/{path}': {
-        delete: {
+    '/w/{workspace}/drafts/update/{kind}/{path}': {
+        post: {
             req: {
-                kind: 'script' | 'flow' | 'app';
+                kind: UserDraftItemKind;
                 path: string;
+                requestBody: {
+                    /**
+                     * Draft content to save. `null` (or omitted) signals a delete — the row is removed under the same conflict rules.
+                     */
+                    value?: unknown;
+                    /**
+                     * Server timestamp of the client's last known sync for this draft. Omit on first save.
+                     */
+                    last_sync?: string;
+                    /**
+                     * Skip the conflict check and overwrite the server copy.
+                     */
+                    force?: boolean;
+                };
                 workspace: string;
             };
             res: {
                 /**
-                 * draft deleted
+                 * save result
                  */
-                200: string;
+                200: {
+                    status: 'saved' | 'conflict';
+                    current_timestamp: string;
+                };
             };
         };
     };
@@ -24082,6 +24577,15 @@ export type $OpenApiTs = {
                  * filter by exact matching user creator. Supports comma-separated list (e.g. 'alice,bob') and negation by prefixing all values with '!' (e.g. '!alice,!bob')
                  */
                 createdBy?: string;
+                /**
+                 * When true, append per-user draft rows whose path has no
+                 * deployed counterpart. Synthesized rows carry `draft_only: true`
+                 * so the home page can render a "Draft" badge. Gated to
+                 * non-operators + page 0 + no narrowing filters on the backend so
+                 * picker callers stay deployed-only and pagination stays clean.
+                 *
+                 */
+                includeDraftOnly?: boolean;
                 /**
                  * Filter by label
                  */
@@ -24279,6 +24783,10 @@ export type $OpenApiTs = {
     '/w/{workspace}/schedules/get/{path}': {
         get: {
             req: {
+                /**
+                 * When true, overlay the authed user's draft (if any) onto the deployed payload.
+                 */
+                getDraft?: boolean;
                 path: string;
                 workspace: string;
             };
@@ -24286,7 +24794,7 @@ export type $OpenApiTs = {
                 /**
                  * schedule deleted
                  */
-                200: Schedule;
+                200: Schedule & UserDraftOverlay;
             };
         };
     };
@@ -24319,6 +24827,13 @@ export type $OpenApiTs = {
                  * pattern match filter for description field (case-insensitive)
                  */
                 description?: string;
+                /**
+                 * When true, append per-user draft schedules whose path has
+                 * no deployed schedule. Synthesized rows carry
+                 * `draft_only: true`.
+                 *
+                 */
+                includeDraftOnly?: boolean;
                 /**
                  * filter schedules by whether they target a flow
                  */
@@ -24512,6 +25027,10 @@ export type $OpenApiTs = {
     '/w/{workspace}/http_triggers/get/{path}': {
         get: {
             req: {
+                /**
+                 * When true, overlay the authed user's draft (if any) onto the deployed payload.
+                 */
+                getDraft?: boolean;
                 path: string;
                 workspace: string;
             };
@@ -24519,13 +25038,22 @@ export type $OpenApiTs = {
                 /**
                  * http trigger deleted
                  */
-                200: HttpTrigger;
+                200: HttpTrigger & UserDraftOverlay;
             };
         };
     };
     '/w/{workspace}/http_triggers/list': {
         get: {
             req: {
+                /**
+                 * When true, append per-user draft rows whose path has no
+                 * deployed counterpart. Synthesized rows carry `draft_only: true`
+                 * so the home page can render a "Draft" badge. Gated to
+                 * non-operators + page 0 + no narrowing filters on the backend so
+                 * picker callers stay deployed-only and pagination stays clean.
+                 *
+                 */
+                includeDraftOnly?: boolean;
                 isFlow?: boolean;
                 /**
                  * Filter by label
@@ -24664,6 +25192,10 @@ export type $OpenApiTs = {
     '/w/{workspace}/websocket_triggers/get/{path}': {
         get: {
             req: {
+                /**
+                 * When true, overlay the authed user's draft (if any) onto the deployed payload.
+                 */
+                getDraft?: boolean;
                 path: string;
                 workspace: string;
             };
@@ -24671,13 +25203,22 @@ export type $OpenApiTs = {
                 /**
                  * websocket trigger deleted
                  */
-                200: WebsocketTrigger;
+                200: WebsocketTrigger & UserDraftOverlay;
             };
         };
     };
     '/w/{workspace}/websocket_triggers/list': {
         get: {
             req: {
+                /**
+                 * When true, append per-user draft rows whose path has no
+                 * deployed counterpart. Synthesized rows carry `draft_only: true`
+                 * so the home page can render a "Draft" badge. Gated to
+                 * non-operators + page 0 + no narrowing filters on the backend so
+                 * picker callers stay deployed-only and pagination stays clean.
+                 *
+                 */
+                includeDraftOnly?: boolean;
                 isFlow?: boolean;
                 /**
                  * Filter by label
@@ -24818,6 +25359,10 @@ export type $OpenApiTs = {
     '/w/{workspace}/kafka_triggers/get/{path}': {
         get: {
             req: {
+                /**
+                 * When true, overlay the authed user's draft (if any) onto the deployed payload.
+                 */
+                getDraft?: boolean;
                 path: string;
                 workspace: string;
             };
@@ -24825,13 +25370,22 @@ export type $OpenApiTs = {
                 /**
                  * kafka trigger deleted
                  */
-                200: KafkaTrigger;
+                200: KafkaTrigger & UserDraftOverlay;
             };
         };
     };
     '/w/{workspace}/kafka_triggers/list': {
         get: {
             req: {
+                /**
+                 * When true, append per-user draft rows whose path has no
+                 * deployed counterpart. Synthesized rows carry `draft_only: true`
+                 * so the home page can render a "Draft" badge. Gated to
+                 * non-operators + page 0 + no narrowing filters on the backend so
+                 * picker callers stay deployed-only and pagination stays clean.
+                 *
+                 */
+                includeDraftOnly?: boolean;
                 isFlow?: boolean;
                 /**
                  * Filter by label
@@ -25008,6 +25562,10 @@ export type $OpenApiTs = {
     '/w/{workspace}/nats_triggers/get/{path}': {
         get: {
             req: {
+                /**
+                 * When true, overlay the authed user's draft (if any) onto the deployed payload.
+                 */
+                getDraft?: boolean;
                 path: string;
                 workspace: string;
             };
@@ -25015,13 +25573,22 @@ export type $OpenApiTs = {
                 /**
                  * nats trigger deleted
                  */
-                200: NatsTrigger;
+                200: NatsTrigger & UserDraftOverlay;
             };
         };
     };
     '/w/{workspace}/nats_triggers/list': {
         get: {
             req: {
+                /**
+                 * When true, append per-user draft rows whose path has no
+                 * deployed counterpart. Synthesized rows carry `draft_only: true`
+                 * so the home page can render a "Draft" badge. Gated to
+                 * non-operators + page 0 + no narrowing filters on the backend so
+                 * picker callers stay deployed-only and pagination stays clean.
+                 *
+                 */
+                includeDraftOnly?: boolean;
                 isFlow?: boolean;
                 /**
                  * Filter by label
@@ -25162,6 +25729,10 @@ export type $OpenApiTs = {
     '/w/{workspace}/sqs_triggers/get/{path}': {
         get: {
             req: {
+                /**
+                 * When true, overlay the authed user's draft (if any) onto the deployed payload.
+                 */
+                getDraft?: boolean;
                 path: string;
                 workspace: string;
             };
@@ -25169,13 +25740,22 @@ export type $OpenApiTs = {
                 /**
                  * sqs trigger deleted
                  */
-                200: SqsTrigger;
+                200: SqsTrigger & UserDraftOverlay;
             };
         };
     };
     '/w/{workspace}/sqs_triggers/list': {
         get: {
             req: {
+                /**
+                 * When true, append per-user draft rows whose path has no
+                 * deployed counterpart. Synthesized rows carry `draft_only: true`
+                 * so the home page can render a "Draft" badge. Gated to
+                 * non-operators + page 0 + no narrowing filters on the backend so
+                 * picker callers stay deployed-only and pagination stays clean.
+                 *
+                 */
+                includeDraftOnly?: boolean;
                 isFlow?: boolean;
                 /**
                  * Filter by label
@@ -25475,6 +26055,15 @@ export type $OpenApiTs = {
     '/w/{workspace}/native_triggers/{service_name}/list': {
         get: {
             req: {
+                /**
+                 * When true, append per-user draft rows whose path has no
+                 * deployed counterpart. Synthesized rows carry `draft_only: true`
+                 * so the home page can render a "Draft" badge. Gated to
+                 * non-operators + page 0 + no narrowing filters on the backend so
+                 * picker callers stay deployed-only and pagination stays clean.
+                 *
+                 */
+                includeDraftOnly?: boolean;
                 /**
                  * filter by is_flow
                  */
@@ -25695,6 +26284,10 @@ export type $OpenApiTs = {
     '/w/{workspace}/mqtt_triggers/get/{path}': {
         get: {
             req: {
+                /**
+                 * When true, overlay the authed user's draft (if any) onto the deployed payload.
+                 */
+                getDraft?: boolean;
                 path: string;
                 workspace: string;
             };
@@ -25702,13 +26295,22 @@ export type $OpenApiTs = {
                 /**
                  * mqtt trigger deleted
                  */
-                200: MqttTrigger;
+                200: MqttTrigger & UserDraftOverlay;
             };
         };
     };
     '/w/{workspace}/mqtt_triggers/list': {
         get: {
             req: {
+                /**
+                 * When true, append per-user draft rows whose path has no
+                 * deployed counterpart. Synthesized rows carry `draft_only: true`
+                 * so the home page can render a "Draft" badge. Gated to
+                 * non-operators + page 0 + no narrowing filters on the backend so
+                 * picker callers stay deployed-only and pagination stays clean.
+                 *
+                 */
+                includeDraftOnly?: boolean;
                 isFlow?: boolean;
                 /**
                  * Filter by label
@@ -25849,6 +26451,10 @@ export type $OpenApiTs = {
     '/w/{workspace}/gcp_triggers/get/{path}': {
         get: {
             req: {
+                /**
+                 * When true, overlay the authed user's draft (if any) onto the deployed payload.
+                 */
+                getDraft?: boolean;
                 path: string;
                 workspace: string;
             };
@@ -25856,13 +26462,22 @@ export type $OpenApiTs = {
                 /**
                  * gcp trigger deleted
                  */
-                200: GcpTrigger;
+                200: GcpTrigger & UserDraftOverlay;
             };
         };
     };
     '/w/{workspace}/gcp_triggers/list': {
         get: {
             req: {
+                /**
+                 * When true, append per-user draft rows whose path has no
+                 * deployed counterpart. Synthesized rows carry `draft_only: true`
+                 * so the home page can render a "Draft" badge. Gated to
+                 * non-operators + page 0 + no narrowing filters on the backend so
+                 * picker callers stay deployed-only and pagination stays clean.
+                 *
+                 */
+                includeDraftOnly?: boolean;
                 isFlow?: boolean;
                 /**
                  * Filter by label
@@ -26047,6 +26662,10 @@ export type $OpenApiTs = {
     '/w/{workspace}/azure_triggers/get/{path}': {
         get: {
             req: {
+                /**
+                 * When true, overlay the authed user's draft (if any) onto the deployed payload.
+                 */
+                getDraft?: boolean;
                 path: string;
                 workspace: string;
             };
@@ -26054,13 +26673,22 @@ export type $OpenApiTs = {
                 /**
                  * azure trigger
                  */
-                200: AzureTrigger;
+                200: AzureTrigger & UserDraftOverlay;
             };
         };
     };
     '/w/{workspace}/azure_triggers/list': {
         get: {
             req: {
+                /**
+                 * When true, append per-user draft rows whose path has no
+                 * deployed counterpart. Synthesized rows carry `draft_only: true`
+                 * so the home page can render a "Draft" badge. Gated to
+                 * non-operators + page 0 + no narrowing filters on the backend so
+                 * picker callers stay deployed-only and pagination stays clean.
+                 *
+                 */
+                includeDraftOnly?: boolean;
                 isFlow?: boolean;
                 /**
                  * which page to return (start at 1, default 1)
@@ -26467,6 +27095,10 @@ export type $OpenApiTs = {
     '/w/{workspace}/postgres_triggers/get/{path}': {
         get: {
             req: {
+                /**
+                 * When true, overlay the authed user's draft (if any) onto the deployed payload.
+                 */
+                getDraft?: boolean;
                 path: string;
                 workspace: string;
             };
@@ -26474,13 +27106,22 @@ export type $OpenApiTs = {
                 /**
                  * get postgres trigger
                  */
-                200: PostgresTrigger;
+                200: PostgresTrigger & UserDraftOverlay;
             };
         };
     };
     '/w/{workspace}/postgres_triggers/list': {
         get: {
             req: {
+                /**
+                 * When true, append per-user draft rows whose path has no
+                 * deployed counterpart. Synthesized rows carry `draft_only: true`
+                 * so the home page can render a "Draft" badge. Gated to
+                 * non-operators + page 0 + no narrowing filters on the backend so
+                 * picker callers stay deployed-only and pagination stays clean.
+                 *
+                 */
+                includeDraftOnly?: boolean;
                 isFlow?: boolean;
                 /**
                  * Filter by label
@@ -26619,6 +27260,10 @@ export type $OpenApiTs = {
     '/w/{workspace}/email_triggers/get/{path}': {
         get: {
             req: {
+                /**
+                 * When true, overlay the authed user's draft (if any) onto the deployed payload.
+                 */
+                getDraft?: boolean;
                 path: string;
                 workspace: string;
             };
@@ -26626,13 +27271,22 @@ export type $OpenApiTs = {
                 /**
                  * email trigger retrieved
                  */
-                200: EmailTrigger;
+                200: EmailTrigger & UserDraftOverlay;
             };
         };
     };
     '/w/{workspace}/email_triggers/list': {
         get: {
             req: {
+                /**
+                 * When true, append per-user draft rows whose path has no
+                 * deployed counterpart. Synthesized rows carry `draft_only: true`
+                 * so the home page can render a "Draft" badge. Gated to
+                 * non-operators + page 0 + no narrowing filters on the backend so
+                 * picker callers stay deployed-only and pagination stays clean.
+                 *
+                 */
+                includeDraftOnly?: boolean;
                 isFlow?: boolean;
                 /**
                  * Filter by label