current-cli 0.1.58__tar.gz → 0.1.59__tar.gz

{current_cli-0.1.58 → current_cli-0.1.59}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: current-cli
-Version: 0.1.58
+Version: 0.1.59
 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.58 → current_cli-0.1.59}/current_cli/schema.yml

@@ -1973,6 +1973,37 @@ paths:
               schema:
                 $ref: '#/components/schemas/OptionUsage'
           description: ''
+  /api/projects/field-definitions/query-metadata/:
+    get:
+      operationId: projects_field_definitions_query_metadata_retrieve
+      description: Discover field keys, labels, types, and the workspace clock.
+      parameters:
+      - in: query
+        name: fields
+        schema:
+          type: string
+        description: Optional comma-separated field keys
+      - in: query
+        name: offset
+        schema:
+          type: integer
+      - in: query
+        name: workspace
+        schema:
+          type: string
+        description: Filter by workspace UUID
+      tags:
+      - projects
+      security:
+      - MessagingJobTokenAuth: []
+      - tokenAuth: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/FieldDiscovery'
+          description: ''
   /api/projects/projects/:
     get:
       operationId: projects_projects_list
@@ -2379,6 +2410,162 @@ paths:
               schema:
                 $ref: '#/components/schemas/ProjectInventoryResponse'
           description: ''
+  /api/projects/projects/query-fields/:
+    post:
+      operationId: projects_projects_query_fields_create
+      description: Read canonical field snapshots. This POST does not write project
+        state.
+      tags:
+      - projects
+      requestBody:
+        content:
+          application/json:
+            schema:
+              additionalProperties: false
+              properties:
+                fields:
+                  items:
+                    type: string
+                  maxItems: 8
+                  minItems: 1
+                  title: Fields
+                  type: array
+                project_ids:
+                  anyOf:
+                  - items:
+                      type: string
+                    maxItems: 200
+                    type: array
+                  - type: 'null'
+                  default: null
+                  title: Project Ids
+                as_of:
+                  default: latest
+                  title: As Of
+                  type: string
+                compare_to:
+                  anyOf:
+                  - type: string
+                  - type: 'null'
+                  default: null
+                  title: Compare To
+                filters:
+                  items:
+                    additionalProperties: false
+                    properties:
+                      field:
+                        title: Field
+                        type: string
+                      target:
+                        enum:
+                        - as_of
+                        - compare_to
+                        - changed
+                        - delta_days
+                        title: Target
+                        type: string
+                      op:
+                        enum:
+                        - eq
+                        - ne
+                        - in
+                        - not_in
+                        - lt
+                        - lte
+                        - gt
+                        - gte
+                        - is_empty
+                        - is_missing
+                        - is_set
+                        title: Op
+                        type: string
+                      value:
+                        anyOf:
+                        - type: string
+                        - type: integer
+                        - type: number
+                        - type: boolean
+                        - items:
+                            anyOf:
+                            - type: string
+                            - type: integer
+                            - type: number
+                            - type: boolean
+                          type: array
+                        - type: 'null'
+                        title: Value
+                    required:
+                    - field
+                    - target
+                    - op
+                    - value
+                    title: FieldPredicate
+                    type: object
+                  maxItems: 20
+                  title: Filters
+                  type: array
+                sort:
+                  anyOf:
+                  - additionalProperties: false
+                    properties:
+                      field:
+                        title: Field
+                        type: string
+                      target:
+                        enum:
+                        - as_of
+                        - compare_to
+                        - changed
+                        - delta_days
+                        title: Target
+                        type: string
+                      direction:
+                        enum:
+                        - asc
+                        - desc
+                        title: Direction
+                        type: string
+                    required:
+                    - field
+                    - target
+                    - direction
+                    title: FieldSort
+                    type: object
+                  - type: 'null'
+                  default: null
+                limit:
+                  default: 20
+                  maximum: 50
+                  minimum: 1
+                  title: Limit
+                  type: integer
+                cursor:
+                  anyOf:
+                  - maxLength: 12000
+                    minLength: 1
+                    type: string
+                  - type: 'null'
+                  default: null
+                  title: Cursor
+                workspace:
+                  format: uuid
+                  title: Workspace
+                  type: string
+              required:
+              - fields
+              - workspace
+              title: FieldQueryRequest
+              type: object
+      security:
+      - MessagingJobTokenAuth: []
+      - tokenAuth: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/FieldQueryResponse'
+          description: ''
   /api/projects/projects/search/:
     get:
       operationId: projects_projects_search_retrieve
@@ -5814,6 +6001,51 @@ components:
       required:
       - items
       - next_cursor
+    FieldComparison:
+      type: object
+      properties:
+        as_of:
+          $ref: '#/components/schemas/FieldSnapshot'
+        compare_to:
+          $ref: '#/components/schemas/FieldSnapshot'
+        changed:
+          type: boolean
+          nullable: true
+        delta_days:
+          type: integer
+          nullable: true
+      required:
+      - as_of
+    FieldDiscovery:
+      type: object
+      properties:
+        timezone:
+          type: string
+        now:
+          type: string
+          format: date-time
+        current_month_start:
+          type: string
+          format: date-time
+        time_basis:
+          type: string
+        fields:
+          type: array
+          items:
+            $ref: '#/components/schemas/QueryFieldDescriptor'
+        total:
+          type: integer
+        next_offset:
+          type: integer
+          nullable: true
+      required:
+      - current_month_start
+      - fields
+      - next_offset
+      - now
+      - time_basis
+      - timezone
+      - total
     FieldOption:
       type: object
       properties:
@@ -5886,6 +6118,112 @@ components:
       - workflow_name
       - written_by_email
       - written_by_name
+    FieldQueryCounts:
+      type: object
+      properties:
+        candidate:
+          type: integer
+        matched:
+          type: integer
+        unevaluable:
+          type: integer
+        unmatched:
+          type: integer
+        matched_with_missing_history:
+          type: integer
+      required:
+      - candidate
+      - matched
+      - matched_with_missing_history
+      - unevaluable
+      - unmatched
+    FieldQueryItem:
+      type: object
+      properties:
+        project_id:
+          type: string
+          format: uuid
+        fields:
+          type: object
+          additionalProperties:
+            $ref: '#/components/schemas/FieldComparison'
+      required:
+      - fields
+      - project_id
+    FieldQueryResponse:
+      type: object
+      properties:
+        timezone:
+          type: string
+        time_basis:
+          type: string
+        as_of:
+          type: string
+          format: date-time
+        compare_to:
+          type: string
+          format: date-time
+          nullable: true
+        query_clock:
+          type: string
+          format: date-time
+        fields:
+          type: array
+          items:
+            $ref: '#/components/schemas/QueryFieldDescriptor'
+        counts:
+          $ref: '#/components/schemas/FieldQueryCounts'
+        items:
+          type: array
+          items:
+            $ref: '#/components/schemas/FieldQueryItem'
+        next_cursor:
+          type: string
+          nullable: true
+      required:
+      - as_of
+      - compare_to
+      - counts
+      - fields
+      - items
+      - next_cursor
+      - query_clock
+      - time_basis
+      - timezone
+    FieldSnapshot:
+      type: object
+      properties:
+        state:
+          $ref: '#/components/schemas/FieldSnapshotStateEnum'
+        value:
+          nullable: true
+        display:
+          nullable: true
+        write_id:
+          type: string
+          format: uuid
+        recorded_at:
+          type: string
+          format: date-time
+        source:
+          type: string
+        evidence_observation_ids:
+          type: array
+          items:
+            type: string
+      required:
+      - state
+      - value
+    FieldSnapshotStateEnum:
+      enum:
+      - value
+      - empty
+      - missing
+      type: string
+      description: |-
+        * `value` - value
+        * `empty` - empty
+        * `missing` - missing
     FileDeleteRequestRequest:
       type: object
       properties:
@@ -7373,6 +7711,26 @@ components:
           pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{0,79}$
       required:
       - batch_id
+    QueryFieldDescriptor:
+      type: object
+      properties:
+        id:
+          type: string
+          format: uuid
+        key:
+          type: string
+        label:
+          type: string
+        data_type:
+          type: string
+        is_array:
+          type: boolean
+      required:
+      - data_type
+      - id
+      - is_array
+      - key
+      - label
     QuickCapture:
       type: object
       description: |-

{current_cli-0.1.58 → current_cli-0.1.59}/llms.txt

@@ -744,6 +744,17 @@ PATCH /api/projects/field-definitions/{id}/
 Options:
 - `--data` (required) - Request body as JSON: inline, @file.json, or - for stdin.
 
+### current projects field-definitions query-metadata retrieve
+
+Discover field keys, labels, types, and the workspace clock.
+
+GET /api/projects/field-definitions/query-metadata/
+
+Options:
+- `--fields` - Optional comma-separated field keys
+- `--offset`
+- `--workspace` - Filter by workspace UUID
+
 ### current projects field-definitions retrieve <id>
 
 Workspace-level custom field definitions. Only admins can mutate.
@@ -805,6 +816,15 @@ PATCH /api/projects/projects/{id}/
 Options:
 - `--data` (required) - Request body as JSON: inline, @file.json, or - for stdin.
 
+### current projects query-fields create
+
+Read canonical field snapshots. This POST does not write project state.
+
+POST /api/projects/projects/query-fields/
+
+Options:
+- `--data` (required) - Request body as JSON: inline, @file.json, or - for stdin.
+
 ### current projects retrieve <id>
 
 Projects across the caller's workspaces. Any member can create a

{current_cli-0.1.58 → current_cli-0.1.59}/pyproject.toml

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