stackgen-sdk 0.5.0rc2__tar.gz → 0.5.0rc3__tar.gz

{stackgen_sdk-0.5.0rc2 → stackgen_sdk-0.5.0rc3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: stackgen-sdk
-Version: 0.5.0rc2
+Version: 0.5.0rc3
 Summary: StackGen SDK — Aiden, SRE, and Vault from one client
 Project-URL: Homepage, https://appcd-dev.github.io/stackgen-sdk/
 Project-URL: Documentation, https://appcd-dev.github.io/stackgen-sdk/

{stackgen_sdk-0.5.0rc2 → stackgen_sdk-0.5.0rc3}/src/stackgen/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.5.0rc2'
-__version_tuple__ = version_tuple = (0, 5, 0, 'rc2')
+__version__ = version = '0.5.0rc3'
+__version_tuple__ = version_tuple = (0, 5, 0, 'rc3')
 
 __commit_id__ = commit_id = None

{stackgen_sdk-0.5.0rc2 → stackgen_sdk-0.5.0rc3}/src/stackgen/aiden/namespace.py

@@ -84,6 +84,10 @@ class AidenNamespace:
         """GET /guild/api/v1/executions/{traceId}."""
         return self._webhook_ops.get_execution_trace(trace_id)
 
+    def get_execution_flight_record(self, trace_id: str) -> dict[str, Any]:
+        """GET /guild/api/v1/executions/{traceId}/flight-record."""
+        return self._webhook_ops.get_execution_flight_record(trace_id)
+
     def download_execution_debug_zip(
         self,
         trace_id: str,
@@ -358,6 +362,21 @@ class AidenNamespace:
         """
         return self._workflows.publish(workflow, agents=agents, approve=approve)
 
+    def get_workflow(self, name: str) -> dict[str, Any] | None:
+        """GET one workflow by name (includeDrafts). None when missing."""
+        return self._workflows.get_workflow(name)
+
+    def create_workflow(self, payload: dict[str, Any]) -> dict[str, Any]:
+        """POST a draft workflow payload (HTTP). Prefer ``publish_workflow``.
+
+        Distinct from the module-level ``create_workflow`` builder helper.
+        """
+        return self._workflows.create_workflow(payload)
+
+    def approve_workflow_version(self, name: str, version: int) -> dict[str, Any]:
+        """Approve a draft (or deprecated) workflow version so it can run."""
+        return self._workflows.approve_workflow_version(name, version)
+
     # Expanded allowlisted surface (thin REST) — delegated to AidenResources.
     def register_agent(self, body: dict[str, Any]) -> dict[str, Any]:
         """POST /agents — register with integrations, HITL, runners, and related fields."""

{stackgen_sdk-0.5.0rc2 → stackgen_sdk-0.5.0rc3}/src/stackgen/aiden/resources.py

@@ -492,6 +492,13 @@ class AidenResources:
     ) -> list[dict[str, Any]]:
         return _http.as_list(self._get(f"/executions/{trace_id}/tool-calls", params))
 
+    def get_execution_flight_record(self, trace_id: str) -> dict[str, Any]:
+        """GET /executions/{traceId}/flight-record — unified run timeline."""
+        return _as_object(
+            self._get(f"/executions/{trace_id}/flight-record"),
+            "getExecutionFlightRecord",
+        )
+
     def delete_workflow(self, name: str) -> dict[str, Any]:
         return _as_object(self._send(f"/workflows/{name}", "DELETE"), "deleteWorkflow")
 

{stackgen_sdk-0.5.0rc2 → stackgen_sdk-0.5.0rc3}/src/stackgen/aiden/webhook_ops.py

@@ -110,6 +110,22 @@ class WebhookOps:
             raise StackgenError(f"unexpected execution trace payload: {data!r}")
         return data
 
+    def get_execution_flight_record(self, trace_id: str) -> dict[str, Any]:
+        """GET /guild/api/v1/executions/{traceId}/flight-record."""
+        tid = (trace_id or "").strip()
+        if not tid:
+            raise StackgenError("get_execution_flight_record: trace_id is required")
+        from urllib.parse import quote
+
+        url = (
+            f"{self._config.aiden_url()}/api/v1/executions/"
+            f"{quote(tid, safe='')}/flight-record{_http.query(self._config.org_id)}"
+        )
+        data = _http.request(url, self._config.api_token)
+        if not isinstance(data, dict):
+            raise StackgenError(f"unexpected execution flight record payload: {data!r}")
+        return data
+
     def download_execution_debug_zip(
         self,
         trace_id: str,

{stackgen_sdk-0.5.0rc2 → stackgen_sdk-0.5.0rc3}/src/stackgen/aiden/workflow_publish.py

@@ -46,19 +46,19 @@ class WorkflowPublishJourney:
 
         payload = workflow.to_payload()
         name = str(payload["name"])
-        wf = self._get_workflow(name)
+        wf = self.get_workflow(name)
         if wf is None:
-            wf = self._create_workflow(payload)
+            wf = self.create_workflow(payload)
         elif _http.text(wf.get("status")) == "draft":
-            wf = self._update_workflow(name, payload)
+            wf = self.update_workflow(name, payload)
         else:
-            wf = self._create_workflow_version(name)
+            wf = self.create_workflow_version(name)
             version = int(wf.get("version"))
-            wf = self._update_workflow_version(name, version, payload)
+            wf = self.update_workflow_version(name, version, payload)
 
         if approve:
             version = int(wf.get("version"))
-            wf = self._approve_workflow_version(name, version)
+            wf = self.approve_workflow_version(name, version)
 
         return PublishWorkflowResult(
             workflow_name=name,
@@ -110,7 +110,7 @@ class WorkflowPublishJourney:
             content_type="application/json",
         )
 
-    def _get_workflow(self, name: str) -> dict[str, Any] | None:
+    def get_workflow(self, name: str) -> dict[str, Any] | None:
         params: dict[str, str] = {"includeDrafts": "true"}
         if self._config.org_id:
             params["orgId"] = self._config.org_id
@@ -128,7 +128,7 @@ class WorkflowPublishJourney:
             return None
         return data
 
-    def _create_workflow(self, payload: dict[str, Any]) -> dict[str, Any]:
+    def create_workflow(self, payload: dict[str, Any]) -> dict[str, Any]:
         url = f"{self._config.aiden_url()}/api/v1/workflows{_http.query(self._config.org_id)}"
         return self._as_object(
             _http.request(
@@ -141,7 +141,7 @@ class WorkflowPublishJourney:
             "createWorkflow",
         )
 
-    def _update_workflow(self, name: str, payload: dict[str, Any]) -> dict[str, Any]:
+    def update_workflow(self, name: str, payload: dict[str, Any]) -> dict[str, Any]:
         url = (
             f"{self._config.aiden_url()}/api/v1/workflows/{quote(name, safe='')}"
             f"{_http.query(self._config.org_id)}"
@@ -158,7 +158,7 @@ class WorkflowPublishJourney:
             "updateWorkflow",
         )
 
-    def _create_workflow_version(self, name: str) -> dict[str, Any]:
+    def create_workflow_version(self, name: str) -> dict[str, Any]:
         url = (
             f"{self._config.aiden_url()}/api/v1/workflows/{quote(name, safe='')}/versions"
             f"{_http.query(self._config.org_id)}"
@@ -174,7 +174,7 @@ class WorkflowPublishJourney:
             "createWorkflowVersion",
         )
 
-    def _update_workflow_version(
+    def update_workflow_version(
         self, name: str, version: int, payload: dict[str, Any]
     ) -> dict[str, Any]:
         url = (
@@ -192,7 +192,7 @@ class WorkflowPublishJourney:
             "updateWorkflowVersion",
         )
 
-    def _approve_workflow_version(self, name: str, version: int) -> dict[str, Any]:
+    def approve_workflow_version(self, name: str, version: int) -> dict[str, Any]:
         url = (
             f"{self._config.aiden_url()}/api/v1/workflows/{quote(name, safe='')}"
             f"/versions/{version}/approve{_http.query(self._config.org_id)}"

{stackgen_sdk-0.5.0rc2 → stackgen_sdk-0.5.0rc3}/src/stackgen/generated/.openapi-generator/FILES

@@ -97,6 +97,8 @@ stackgen/generated/docs/ExecutionToolCall.md
 stackgen/generated/docs/ExecutionToolCallList.md
 stackgen/generated/docs/ExternalSecretReference.md
 stackgen/generated/docs/FetchRequestByIdentifierBody.md
+stackgen/generated/docs/FlightRecordEvent.md
+stackgen/generated/docs/FlightRecordResponse.md
 stackgen/generated/docs/ForkInvestigationRequest.md
 stackgen/generated/docs/ForkSessionRequest.md
 stackgen/generated/docs/FunnelMetricsResponse.md
@@ -385,6 +387,8 @@ stackgen/generated/models/execution_tool_call.py
 stackgen/generated/models/execution_tool_call_list.py
 stackgen/generated/models/external_secret_reference.py
 stackgen/generated/models/fetch_request_by_identifier_body.py
+stackgen/generated/models/flight_record_event.py
+stackgen/generated/models/flight_record_response.py
 stackgen/generated/models/fork_investigation_request.py
 stackgen/generated/models/fork_session_request.py
 stackgen/generated/models/funnel_metrics_response.py
@@ -673,6 +677,8 @@ stackgen/generated/test/test_execution_tool_call.py
 stackgen/generated/test/test_execution_tool_call_list.py
 stackgen/generated/test/test_external_secret_reference.py
 stackgen/generated/test/test_fetch_request_by_identifier_body.py
+stackgen/generated/test/test_flight_record_event.py
+stackgen/generated/test/test_flight_record_response.py
 stackgen/generated/test/test_fork_investigation_request.py
 stackgen/generated/test/test_fork_session_request.py
 stackgen/generated/test/test_funnel_metrics_response.py

{stackgen_sdk-0.5.0rc2 → stackgen_sdk-0.5.0rc3}/src/stackgen/generated/__init__.py

@@ -117,6 +117,8 @@ __all__ = [
     "ExecutionToolCallList",
     "ExternalSecretReference",
     "FetchRequestByIdentifierBody",
+    "FlightRecordEvent",
+    "FlightRecordResponse",
     "ForkInvestigationRequest",
     "ForkSessionRequest",
     "FunnelMetricsResponse",
@@ -421,6 +423,8 @@ from stackgen.generated.models.execution_tool_call import ExecutionToolCall as E
 from stackgen.generated.models.execution_tool_call_list import ExecutionToolCallList as ExecutionToolCallList
 from stackgen.generated.models.external_secret_reference import ExternalSecretReference as ExternalSecretReference
 from stackgen.generated.models.fetch_request_by_identifier_body import FetchRequestByIdentifierBody as FetchRequestByIdentifierBody
+from stackgen.generated.models.flight_record_event import FlightRecordEvent as FlightRecordEvent
+from stackgen.generated.models.flight_record_response import FlightRecordResponse as FlightRecordResponse
 from stackgen.generated.models.fork_investigation_request import ForkInvestigationRequest as ForkInvestigationRequest
 from stackgen.generated.models.fork_session_request import ForkSessionRequest as ForkSessionRequest
 from stackgen.generated.models.funnel_metrics_response import FunnelMetricsResponse as FunnelMetricsResponse

{stackgen_sdk-0.5.0rc2 → stackgen_sdk-0.5.0rc3}/src/stackgen/generated/api/aiden_api.py

@@ -51,6 +51,7 @@ from stackgen.generated.models.evaluate_policy_request import EvaluatePolicyRequ
 from stackgen.generated.models.evaluate_policy_response import EvaluatePolicyResponse
 from stackgen.generated.models.execution_list_item import ExecutionListItem
 from stackgen.generated.models.execution_tool_call_list import ExecutionToolCallList
+from stackgen.generated.models.flight_record_response import FlightRecordResponse
 from stackgen.generated.models.fork_session_request import ForkSessionRequest
 from stackgen.generated.models.guild_integration import GuildIntegration
 from stackgen.generated.models.ingested_document import IngestedDocument
@@ -11593,6 +11594,289 @@ class AidenApi:
 
 
 
+    @validate_call
+    def get_execution_flight_record(
+        self,
+        trace_id: Annotated[StrictStr, Field(description="Langfuse trace ID (32-character hex string or UUID).")],
+        org_id: Annotated[Optional[StrictStr], Field(description="The organization ID to scope the request to. If not provided, the personal namespace is assumed.")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> FlightRecordResponse:
+        """Get unified execution flight record
+
+        Returns a single chronological timeline merging Langfuse DAG nodes, subscribe replay frames, and execution metadata. Used by the Guild flight recorder UI for persona agents. 
+
+        :param trace_id: Langfuse trace ID (32-character hex string or UUID). (required)
+        :type trace_id: str
+        :param org_id: The organization ID to scope the request to. If not provided, the personal namespace is assumed.
+        :type org_id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_execution_flight_record_serialize(
+            trace_id=trace_id,
+            org_id=org_id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "FlightRecordResponse",
+            '400': None,
+            '404': None,
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def get_execution_flight_record_with_http_info(
+        self,
+        trace_id: Annotated[StrictStr, Field(description="Langfuse trace ID (32-character hex string or UUID).")],
+        org_id: Annotated[Optional[StrictStr], Field(description="The organization ID to scope the request to. If not provided, the personal namespace is assumed.")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[FlightRecordResponse]:
+        """Get unified execution flight record
+
+        Returns a single chronological timeline merging Langfuse DAG nodes, subscribe replay frames, and execution metadata. Used by the Guild flight recorder UI for persona agents. 
+
+        :param trace_id: Langfuse trace ID (32-character hex string or UUID). (required)
+        :type trace_id: str
+        :param org_id: The organization ID to scope the request to. If not provided, the personal namespace is assumed.
+        :type org_id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_execution_flight_record_serialize(
+            trace_id=trace_id,
+            org_id=org_id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "FlightRecordResponse",
+            '400': None,
+            '404': None,
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def get_execution_flight_record_without_preload_content(
+        self,
+        trace_id: Annotated[StrictStr, Field(description="Langfuse trace ID (32-character hex string or UUID).")],
+        org_id: Annotated[Optional[StrictStr], Field(description="The organization ID to scope the request to. If not provided, the personal namespace is assumed.")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Get unified execution flight record
+
+        Returns a single chronological timeline merging Langfuse DAG nodes, subscribe replay frames, and execution metadata. Used by the Guild flight recorder UI for persona agents. 
+
+        :param trace_id: Langfuse trace ID (32-character hex string or UUID). (required)
+        :type trace_id: str
+        :param org_id: The organization ID to scope the request to. If not provided, the personal namespace is assumed.
+        :type org_id: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_execution_flight_record_serialize(
+            trace_id=trace_id,
+            org_id=org_id,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "FlightRecordResponse",
+            '400': None,
+            '404': None,
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _get_execution_flight_record_serialize(
+        self,
+        trace_id,
+        org_id,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if trace_id is not None:
+            _path_params['traceId'] = trace_id
+        # process the query parameters
+        if org_id is not None:
+            
+            _query_params.append(('orgId', org_id))
+            
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json'
+                ]
+            )
+
+
+        # authentication setting
+        _auth_settings: List[str] = [
+        ]
+
+        return self.api_client.param_serialize(
+            method='GET',
+            resource_path='/guild/api/v1/executions/{traceId}/flight-record',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
     @validate_call
     def get_execution_trace(
         self,
@@ -20290,7 +20574,7 @@ class AidenApi:
         org_id: Annotated[Optional[StrictStr], Field(description="The organization ID to scope the request to. If not provided, the personal namespace is assumed.")] = None,
         include_drafts: Annotated[Optional[StrictBool], Field(description="When true, include draft-status workflows in the results. Default is false (approved only).")] = None,
         latest_only: Annotated[Optional[StrictBool], Field(description="When true, returns ONLY the latest version of each workflow (one per workflow name).")] = None,
-        include_provisioned: Annotated[Optional[StrictBool], Field(description="When true, include provisioned (system) workflows.")] = None,
+        include_provisioned: Annotated[Optional[StrictBool], Field(description="When true, include workflows provisioned by installed apps. Default false — app-managed resources are reconciled from the app manifest and cannot be edited directly in Guild. ")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -20317,7 +20601,7 @@ class AidenApi:
         :type include_drafts: bool
         :param latest_only: When true, returns ONLY the latest version of each workflow (one per workflow name).
         :type latest_only: bool
-        :param include_provisioned: When true, include provisioned (system) workflows.
+        :param include_provisioned: When true, include workflows provisioned by installed apps. Default false — app-managed resources are reconciled from the app manifest and cannot be edited directly in Guild. 
         :type include_provisioned: bool
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -20376,7 +20660,7 @@ class AidenApi:
         org_id: Annotated[Optional[StrictStr], Field(description="The organization ID to scope the request to. If not provided, the personal namespace is assumed.")] = None,
         include_drafts: Annotated[Optional[StrictBool], Field(description="When true, include draft-status workflows in the results. Default is false (approved only).")] = None,
         latest_only: Annotated[Optional[StrictBool], Field(description="When true, returns ONLY the latest version of each workflow (one per workflow name).")] = None,
-        include_provisioned: Annotated[Optional[StrictBool], Field(description="When true, include provisioned (system) workflows.")] = None,
+        include_provisioned: Annotated[Optional[StrictBool], Field(description="When true, include workflows provisioned by installed apps. Default false — app-managed resources are reconciled from the app manifest and cannot be edited directly in Guild. ")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -20403,7 +20687,7 @@ class AidenApi:
         :type include_drafts: bool
         :param latest_only: When true, returns ONLY the latest version of each workflow (one per workflow name).
         :type latest_only: bool
-        :param include_provisioned: When true, include provisioned (system) workflows.
+        :param include_provisioned: When true, include workflows provisioned by installed apps. Default false — app-managed resources are reconciled from the app manifest and cannot be edited directly in Guild. 
         :type include_provisioned: bool
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request
@@ -20462,7 +20746,7 @@ class AidenApi:
         org_id: Annotated[Optional[StrictStr], Field(description="The organization ID to scope the request to. If not provided, the personal namespace is assumed.")] = None,
         include_drafts: Annotated[Optional[StrictBool], Field(description="When true, include draft-status workflows in the results. Default is false (approved only).")] = None,
         latest_only: Annotated[Optional[StrictBool], Field(description="When true, returns ONLY the latest version of each workflow (one per workflow name).")] = None,
-        include_provisioned: Annotated[Optional[StrictBool], Field(description="When true, include provisioned (system) workflows.")] = None,
+        include_provisioned: Annotated[Optional[StrictBool], Field(description="When true, include workflows provisioned by installed apps. Default false — app-managed resources are reconciled from the app manifest and cannot be edited directly in Guild. ")] = None,
         _request_timeout: Union[
             None,
             Annotated[StrictFloat, Field(gt=0)],
@@ -20489,7 +20773,7 @@ class AidenApi:
         :type include_drafts: bool
         :param latest_only: When true, returns ONLY the latest version of each workflow (one per workflow name).
         :type latest_only: bool
-        :param include_provisioned: When true, include provisioned (system) workflows.
+        :param include_provisioned: When true, include workflows provisioned by installed apps. Default false — app-managed resources are reconciled from the app manifest and cannot be edited directly in Guild. 
         :type include_provisioned: bool
         :param _request_timeout: timeout setting for this request. If one
                                  number provided, it will be total request