Merge remote-tracking branch 'origin/main' into stlc/promote-next

Author: kernel-internal[bot]

src/kernel/types/invocation_create_response.py

@@ -19,10 +19,18 @@ class InvocationCreateResponse(BaseModel):
     """Status of the invocation"""
 
     output: Optional[str] = None
-    """The return value of the action that was invoked, rendered as a JSON string.
+    """The action result or detailed failure output.
 
-    This could be: string, number, boolean, array, object, or null.
+    Often a JSON-encoded value, but failures may contain plain text. May contain
+    sensitive application data.
     """
 
     status_reason: Optional[str] = None
-    """Status reason"""
+    """
+    A nonempty, customer-safe summary of the recorded failure output, always present
+    when status is failed and omitted otherwise. Recognized messages receive a
+    specific summary; other failures receive a generic summary. Message matching
+    does not establish whether the failure originated in the platform or action
+    code. Does not include raw action output or internal error details.
+    Human-readable text, not a stable identifier for retry logic.
+    """

src/kernel/types/invocation_list_response.py

@@ -35,9 +35,10 @@ class InvocationListResponse(BaseModel):
     """
 
     output: Optional[str] = None
-    """Output produced by the action, rendered as a JSON string.
+    """The action result or detailed failure output.
 
-    This could be: string, number, boolean, array, object, or null.
+    Often a JSON-encoded value, but failures may contain plain text. May contain
+    sensitive application data.
     """
 
     payload: Optional[str] = None
@@ -47,4 +48,12 @@ class InvocationListResponse(BaseModel):
     """
 
     status_reason: Optional[str] = None
-    """Status reason"""
+    """
+    A nonempty, customer-safe summary of the recorded failure output, always present
+    when status is failed and omitted otherwise, including in the first failed
+    invocation_state event. Recognized messages receive a specific summary; other
+    failures receive a generic summary. Message matching does not establish whether
+    the failure originated in the platform or action code. Does not include raw
+    action output or internal error details. Available for historical invocations as
+    well. Human-readable text, not a stable identifier for retry logic.
+    """

src/kernel/types/invocation_retrieve_response.py

@@ -35,9 +35,10 @@ class InvocationRetrieveResponse(BaseModel):
     """
 
     output: Optional[str] = None
-    """Output produced by the action, rendered as a JSON string.
+    """The action result or detailed failure output.
 
-    This could be: string, number, boolean, array, object, or null.
+    Often a JSON-encoded value, but failures may contain plain text. May contain
+    sensitive application data.
     """
 
     payload: Optional[str] = None
@@ -47,4 +48,12 @@ class InvocationRetrieveResponse(BaseModel):
     """
 
     status_reason: Optional[str] = None
-    """Status reason"""
+    """
+    A nonempty, customer-safe summary of the recorded failure output, always present
+    when status is failed and omitted otherwise, including in the first failed
+    invocation_state event. Recognized messages receive a specific summary; other
+    failures receive a generic summary. Message matching does not establish whether
+    the failure originated in the platform or action code. Does not include raw
+    action output or internal error details. Available for historical invocations as
+    well. Human-readable text, not a stable identifier for retry logic.
+    """

src/kernel/types/invocation_state_event.py

@@ -35,9 +35,10 @@ class Invocation(BaseModel):
     """
 
     output: Optional[str] = None
-    """Output produced by the action, rendered as a JSON string.
+    """The action result or detailed failure output.
 
-    This could be: string, number, boolean, array, object, or null.
+    Often a JSON-encoded value, but failures may contain plain text. May contain
+    sensitive application data.
     """
 
     payload: Optional[str] = None
@@ -47,7 +48,15 @@ class Invocation(BaseModel):
     """
 
     status_reason: Optional[str] = None
-    """Status reason"""
+    """
+    A nonempty, customer-safe summary of the recorded failure output, always present
+    when status is failed and omitted otherwise, including in the first failed
+    invocation_state event. Recognized messages receive a specific summary; other
+    failures receive a generic summary. Message matching does not establish whether
+    the failure originated in the platform or action code. Does not include raw
+    action output or internal error details. Available for historical invocations as
+    well. Human-readable text, not a stable identifier for retry logic.
+    """
 
 
 class InvocationStateEvent(BaseModel):

src/kernel/types/invocation_update_response.py

@@ -35,9 +35,10 @@ class InvocationUpdateResponse(BaseModel):
     """
 
     output: Optional[str] = None
-    """Output produced by the action, rendered as a JSON string.
+    """The action result or detailed failure output.
 
-    This could be: string, number, boolean, array, object, or null.
+    Often a JSON-encoded value, but failures may contain plain text. May contain
+    sensitive application data.
     """
 
     payload: Optional[str] = None
@@ -47,4 +48,12 @@ class InvocationUpdateResponse(BaseModel):
     """
 
     status_reason: Optional[str] = None
-    """Status reason"""
+    """
+    A nonempty, customer-safe summary of the recorded failure output, always present
+    when status is failed and omitted otherwise, including in the first failed
+    invocation_state event. Recognized messages receive a specific summary; other
+    failures receive a generic summary. Message matching does not establish whether
+    the failure originated in the platform or action code. Does not include raw
+    action output or internal error details. Available for historical invocations as
+    well. Human-readable text, not a stable identifier for retry logic.
+    """