current-cli 0.1.61__tar.gz → 0.1.63__tar.gz

{current_cli-0.1.61 → current_cli-0.1.63}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: current-cli
-Version: 0.1.61
+Version: 0.1.63
 Summary: Command line interface for the Current API, generated from its OpenAPI schema at runtime
 Author-email: Orin <your-email@example.com>
 License-Expression: MIT

{current_cli-0.1.61 → current_cli-0.1.63}/current_cli/docs.py

@@ -7,6 +7,7 @@ is stale. Regenerate with: uv run python -m current_cli.docs > llms.txt
 from __future__ import annotations
 
 from collections.abc import Iterator
+from inspect import cleandoc
 
 import click
 
@@ -70,7 +71,7 @@ def render_docs(root: click.Group) -> str:
         lines = [f"### {usage}"]
         if command.help:
             lines.append("")
-            lines.append(command.help.strip())
+            lines.append(cleandoc(command.help))
         if options:
             lines.append("")
             lines.append("Options:")

{current_cli-0.1.61 → current_cli-0.1.63}/current_cli/schema.yml

@@ -1432,6 +1432,40 @@ paths:
               schema:
                 $ref: '#/components/schemas/MessagingStreamResponse'
           description: ''
+  /api/integrations/messaging/trace/:
+    post:
+      operationId: integrations_messaging_trace
+      description: |-
+        Where the messaging job reports its agent trace.
+
+        Returns the trace's ids and a fresh presigned PUT for the transcript
+        document (see ``traces.storage``); a ``summary``, when sent, is copied
+        onto the trace first, and a terminal ``summary.status`` finishes it. The
+        job calls this at start, at checkpoints, and at the end. The token names
+        the trace, so the body carries no trace id.
+      tags:
+      - integrations
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/MessagingTraceRequestRequest'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/MessagingTraceRequestRequest'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/MessagingTraceRequestRequest'
+        required: true
+      security:
+      - MessagingJobTokenAuth: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AgentTraceUpload'
+          description: ''
   /api/integrations/teams/app-package/:
     get:
       operationId: integrations_teams_app_package
@@ -2310,6 +2344,20 @@ paths:
         schema:
           type: string
         description: Keep only projects whose name contains this text, ignoring case
+      - in: query
+        name: readiness
+        schema:
+          type: string
+          enum:
+          - all
+          - blocked
+          - complete
+          - incomplete
+          - not_assessed
+          - ready
+          - unverified
+        description: Filter evidence readiness independently of the existing status
+          filter.
       - in: query
         name: status
         schema:
@@ -4450,6 +4498,46 @@ paths:
               schema:
                 $ref: '#/components/schemas/ToolInvokeResponse'
           description: ''
+  /api/workflows/runs/{run_id}/traces/:
+    post:
+      operationId: workflows_runs_traces_create
+      description: |-
+        Machine endpoint: the runner reports one agent step attempt's trace.
+
+        Makes the trace on first call for its (step_id, attempt) and returns it
+        after; a ``summary``, when sent, is copied onto it first, and a terminal
+        ``summary.status`` finishes it. The response carries a fresh presigned
+        PUT for the transcript document (see ``traces.storage``).
+      parameters:
+      - in: path
+        name: run_id
+        schema:
+          type: string
+          format: uuid
+        required: true
+      tags:
+      - workflows
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/RunTraceRequestRequest'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/RunTraceRequestRequest'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/RunTraceRequestRequest'
+        required: true
+      security:
+      - RunTokenAuth: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RunTraceUpload'
+          description: ''
   /api/workflows/runs/{run_id}/transitions/:
     post:
       operationId: workflows_runs_transitions_create
@@ -5180,6 +5268,20 @@ components:
       - role
       - workspace_id
       - workspace_name
+    AgentTraceUpload:
+      type: object
+      properties:
+        trace_id:
+          type: string
+          format: uuid
+        traceparent:
+          type: string
+        upload_url:
+          type: string
+      required:
+      - trace_id
+      - traceparent
+      - upload_url
     ApiUserConnectRequestRequest:
       type: object
       description: |-
@@ -5364,6 +5466,16 @@ components:
       - client_secret
       - login_host
       - workspace
+    CloseoutCompletionEnum:
+      enum:
+      - complete
+      - incomplete
+      - unverified
+      type: string
+      description: |-
+        * `complete` - complete
+        * `incomplete` - incomplete
+        * `unverified` - unverified
     CloseoutQueueItem:
       type: object
       description: One project on a closeout queue page.
@@ -5437,6 +5549,19 @@ components:
         outcome:
           type: string
           nullable: true
+        property_handoff:
+          nullable: true
+          oneOf:
+          - $ref: '#/components/schemas/PropertyHandoffEnum'
+          - $ref: '#/components/schemas/NullEnum'
+        closeout_completion:
+          nullable: true
+          oneOf:
+          - $ref: '#/components/schemas/CloseoutCompletionEnum'
+          - $ref: '#/components/schemas/NullEnum'
+        policy_id:
+          type: string
+          nullable: true
         open_outcome:
           type: string
           nullable: true
@@ -6813,6 +6938,8 @@ components:
           items:
             type: string
             minLength: 1
+        traceparent:
+          type: string
       required:
       - reply_ref
       - workflow
@@ -6870,6 +6997,15 @@ components:
       required:
       - ok
       - ts
+    MessagingTraceRequestRequest:
+      type: object
+      properties:
+        workspace:
+          type: string
+          format: uuid
+        summary: {}
+      required:
+      - workspace
     MessagingUploadUrlsRequestRequest:
       type: object
       properties:
@@ -6886,6 +7022,9 @@ components:
       required:
       - paths
       - project
+    NullEnum:
+      enum:
+      - null
     Observation:
       type: object
       description: |-
@@ -7619,6 +7758,16 @@ components:
       required:
       - path
       - url
+    PropertyHandoffEnum:
+      enum:
+      - ready
+      - blocked
+      - unverified
+      type: string
+      description: |-
+        * `ready` - ready
+        * `blocked` - blocked
+        * `unverified` - unverified
     Proposal:
       type: object
       properties:
@@ -8158,6 +8307,9 @@ components:
         clock:
           $ref: '#/components/schemas/RunClock'
         workflow_config: {}
+        traceparent:
+          type: string
+          default: ''
       required:
       - clock
       - definition
@@ -8166,6 +8318,34 @@ components:
       - steps_state
       - trigger
       - workspace
+    RunTraceRequestRequest:
+      type: object
+      properties:
+        step_id:
+          type: string
+          minLength: 1
+          maxLength: 128
+        attempt:
+          type: integer
+          minimum: 1
+        summary: {}
+      required:
+      - attempt
+      - step_id
+    RunTraceUpload:
+      type: object
+      properties:
+        trace_id:
+          type: string
+          format: uuid
+        traceparent:
+          type: string
+        upload_url:
+          type: string
+      required:
+      - trace_id
+      - traceparent
+      - upload_url
     RunTrigger:
       type: object
       description: 'Why a run exists: trigger kind plus the triggering messages.'

{current_cli-0.1.61 → current_cli-0.1.63}/llms.txt

@@ -548,6 +548,21 @@ POST /api/integrations/messaging/stream/
 Options:
 - `--data` (required) - Request body as JSON: inline, @file.json, or - for stdin.
 
+### current integrations messaging trace post
+
+Where the messaging job reports its agent trace.
+
+Returns the trace's ids and a fresh presigned PUT for the transcript
+document (see ``traces.storage``); a ``summary``, when sent, is copied
+onto the trace first, and a terminal ``summary.status`` finishes it. The
+job calls this at start, at checkpoints, and at the end. The token names
+the trace, so the body carries no trace id.
+
+POST /api/integrations/messaging/trace/
+
+Options:
+- `--data` (required) - Request body as JSON: inline, @file.json, or - for stdin.
+
 ### current integrations teams app-package get
 
 Download the Teams app package (manifest + icons) as a zip.
@@ -565,7 +580,7 @@ Options:
 ### current login <email>
 
 Sign in with a magic link (and an authenticator code when the account
-    requires two-factor authentication) and store the auth token.
+requires two-factor authentication) and store the auth token.
 
 ### current logout
 
@@ -679,6 +694,7 @@ Options:
 - `--limit` - Max projects per page (default 50, max 200)
 - `--offset` - Number of projects to skip (default 0)
 - `--q` - Keep only projects whose name contains this text, ignoring case
+- `--readiness` - Filter evidence readiness independently of the existing status filter.
 - `--status` - Which reviewed projects to keep: 'pending' (default) for the ones asking something of a person, 'clear' for the rest, 'all' for both. A project with no closeout review is absent at every status.
 - `--workspace` - Workspace UUID
 
@@ -1461,6 +1477,20 @@ POST /api/workflows/runs/{run_id}/tools/{tool_name}/invoke/
 Options:
 - `--data` (required) - Request body as JSON: inline, @file.json, or - for stdin.
 
+### current workflows runs traces create <run_id>
+
+Machine endpoint: the runner reports one agent step attempt's trace.
+
+Makes the trace on first call for its (step_id, attempt) and returns it
+after; a ``summary``, when sent, is copied onto it first, and a terminal
+``summary.status`` finishes it. The response carries a fresh presigned
+PUT for the transcript document (see ``traces.storage``).
+
+POST /api/workflows/runs/{run_id}/traces/
+
+Options:
+- `--data` (required) - Request body as JSON: inline, @file.json, or - for stdin.
+
 ### current workflows runs transitions create <run_id>
 
 Machine endpoint: the runner journals step state changes. Idempotent —

{current_cli-0.1.61 → current_cli-0.1.63}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "current-cli"
-version = "0.1.61"
+version = "0.1.63"
 description = "Command line interface for the Current API, generated from its OpenAPI schema at runtime"
 readme = "README.md"
 requires-python = ">=3.10"

{current_cli-0.1.61 → current_cli-0.1.63}/tests/test_docs.py

@@ -32,3 +32,16 @@ def test_docs_command_prints_reference(cli, runner):
     assert result.exit_code == 0, result.output
     assert "# Current CLI reference" in result.output
     assert "### current projects list" in result.output
+
+
+def test_docstring_indentation_is_stable_across_python_versions():
+    import click
+
+    from current_cli.docs import render_docs
+
+    def reference(help_text):
+        group = click.Group("current")
+        group.add_command(click.Command("example", help=help_text))
+        return render_docs(group)
+
+    assert reference("First line.\n    Continuation.") == reference("First line.\nContinuation.")