current-cli 0.1.52__tar.gz → 0.1.54__tar.gz

{current_cli-0.1.52 → current_cli-0.1.54}/PKG-INFO

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

@@ -1482,7 +1482,23 @@ paths:
         quick-capture (source=user). No update or delete — content is immutable
         and annotations belong to agents. ``project=`` is the project audit log,
         newest happening first.
+
+        ``source``, ``since`` and ``until`` narrow the stream to one kind of
+        activity in one window of world time; ``by-project`` answers "which
+        projects" over that same window in one call, instead of paging every row
+        and grouping them by eye. Page size is capped at 200 whatever you ask
+        for.
       parameters:
+      - in: query
+        name: facets
+        schema:
+          type: string
+          enum:
+          - source
+        description: 'Add ''by_source'' to the response: how many matching observations
+          each source holds. Costs one extra grouped query, so it is opt-in — ask
+          for it when you need to know this workspace''s actual mix rather than assume
+          one.'
       - in: query
         name: ids
         schema:
@@ -1500,16 +1516,67 @@ paths:
         description: The initial index from which to return the results.
         schema:
           type: integer
+      - in: query
+        name: order
+        schema:
+          type: string
+          enum:
+          - -observed_at
+          - -occurred_at
+          - observed_at
+          - occurred_at
+        description: Sort key. Defaults to -occurred_at when project, since or until
+          is given, because a window is a question about world time, and to -observed_at
+          otherwise, because the stream is a work queue ordered by when Current learned
+          of things.
       - in: query
         name: project
         schema:
           type: string
         description: Filter by project UUID
+      - in: query
+        name: revisions
+        schema:
+          type: string
+          enum:
+          - all
+          - current
+        description: Observations are immutable, so an edited Chatter post is a second
+          row sharing payload.record_key. 'all' (default) returns every revision,
+          which is what the project audit log shows. 'current' returns only the latest
+          revision of each post or comment, which is what a count of what people said
+          means.
+      - in: query
+        name: since
+        schema:
+          type: string
+        description: Keep observations that happened at or after this instant. Bounds
+          occurred_at (when it happened in the world), not observed_at (when Current
+          learned of it). ISO-8601; a bare date means the START of that day. A value
+          with no offset is read in the workspace's timezone when exactly one workspace
+          is in scope, otherwise UTC.
+      - in: query
+        name: source
+        schema:
+          type: array
+          items:
+            type: string
+        description: 'Keep only observations from this source; repeat to accept several.
+          Common names work as well as the stored value: ''chatter'' finds ''sitetracker_feed''.
+          An unknown source is refused with the recorded ones named, because an empty
+          page would read as ''nothing happened''.'
       - in: query
         name: status
         schema:
           type: string
         description: Filter by status (pending/ingested)
+      - in: query
+        name: until
+        schema:
+          type: string
+        description: Keep observations that happened at or before this instant, inclusive.
+          A bare date means the END of that day, so since=2026-09-01&until=2026-09-14
+          is the fourteen days a person means by that.
       - in: query
         name: workspace
         schema:
@@ -1534,6 +1601,12 @@ paths:
         quick-capture (source=user). No update or delete — content is immutable
         and annotations belong to agents. ``project=`` is the project audit log,
         newest happening first.
+
+        ``source``, ``since`` and ``until`` narrow the stream to one kind of
+        activity in one window of world time; ``by-project`` answers "which
+        projects" over that same window in one call, instead of paging every row
+        and grouping them by eye. Page size is capped at 200 whatever you ask
+        for.
       tags:
       - observations
       requestBody:
@@ -1566,6 +1639,12 @@ paths:
         quick-capture (source=user). No update or delete — content is immutable
         and annotations belong to agents. ``project=`` is the project audit log,
         newest happening first.
+
+        ``source``, ``since`` and ``until`` narrow the stream to one kind of
+        activity in one window of world time; ``by-project`` answers "which
+        projects" over that same window in one call, instead of paging every row
+        and grouping them by eye. Page size is capped at 200 whatever you ask
+        for.
       parameters:
       - in: path
         name: id
@@ -1586,6 +1665,105 @@ paths:
               schema:
                 $ref: '#/components/schemas/Observation'
           description: ''
+  /api/observations/observations/by-project/:
+    get:
+      operationId: observations_observations_by_project_retrieve
+      description: Which projects hold the matching observations, and how many each
+        holds. Takes the same filters as the list. Answers 'which projects have activity
+        of this kind in this window' in one call — paging every matching row and grouping
+        them by hand is the same question asked badly, and it miscounts. Projects
+        are ordered by count and capped; narrow the window rather than expect every
+        project back.
+      parameters:
+      - in: query
+        name: facets
+        schema:
+          type: string
+          enum:
+          - source
+        description: 'Add ''by_source'' to the response: how many matching observations
+          each source holds. Costs one extra grouped query, so it is opt-in — ask
+          for it when you need to know this workspace''s actual mix rather than assume
+          one.'
+      - in: query
+        name: ids
+        schema:
+          type: string
+        description: Comma-separated observation UUIDs
+      - in: query
+        name: order
+        schema:
+          type: string
+          enum:
+          - -observed_at
+          - -occurred_at
+          - observed_at
+          - occurred_at
+        description: Sort key. Defaults to -occurred_at when project, since or until
+          is given, because a window is a question about world time, and to -observed_at
+          otherwise, because the stream is a work queue ordered by when Current learned
+          of things.
+      - in: query
+        name: project
+        schema:
+          type: string
+        description: Filter by project UUID
+      - in: query
+        name: revisions
+        schema:
+          type: string
+          enum:
+          - all
+          - current
+        description: Observations are immutable, so an edited Chatter post is a second
+          row sharing payload.record_key. 'all' (default) returns every revision,
+          which is what the project audit log shows. 'current' returns only the latest
+          revision of each post or comment, which is what a count of what people said
+          means.
+      - in: query
+        name: since
+        schema:
+          type: string
+        description: Keep observations that happened at or after this instant. Bounds
+          occurred_at (when it happened in the world), not observed_at (when Current
+          learned of it). ISO-8601; a bare date means the START of that day. A value
+          with no offset is read in the workspace's timezone when exactly one workspace
+          is in scope, otherwise UTC.
+      - in: query
+        name: source
+        schema:
+          type: array
+          items:
+            type: string
+        description: 'Keep only observations from this source; repeat to accept several.
+          Common names work as well as the stored value: ''chatter'' finds ''sitetracker_feed''.
+          An unknown source is refused with the recorded ones named, because an empty
+          page would read as ''nothing happened''.'
+      - in: query
+        name: status
+        schema:
+          type: string
+        description: Filter by status (pending/ingested)
+      - in: query
+        name: until
+        schema:
+          type: string
+        description: Keep observations that happened at or before this instant, inclusive.
+          A bare date means the END of that day, so since=2026-09-01&until=2026-09-14
+          is the fourteen days a person means by that.
+      - in: query
+        name: workspace
+        schema:
+          type: string
+        description: Filter by workspace UUID
+      tags:
+      - observations
+      security:
+      - MessagingJobTokenAuth: []
+      - tokenAuth: []
+      responses:
+        '200':
+          description: No response body
   /api/projects/field-definitions/:
     get:
       operationId: projects_field_definitions_list
@@ -3392,6 +3570,16 @@ paths:
       description: Vendors across the caller's workspaces. Any member can create and
         edit.
       parameters:
+      - in: query
+        name: limit
+        schema:
+          type: integer
+        description: Max vendors per page (default 25, cap 100)
+      - in: query
+        name: offset
+        schema:
+          type: integer
+        description: Page offset (default 0)
       - in: query
         name: project
         schema:
@@ -3412,9 +3600,7 @@ paths:
           content:
             application/json:
               schema:
-                type: array
-                items:
-                  $ref: '#/components/schemas/Vendor'
+                $ref: '#/components/schemas/VendorListResponse'
           description: ''
     post:
       operationId: vendors_vendors_create
@@ -3651,9 +3837,10 @@ paths:
     get:
       operationId: workflows_runs_list
       description: |-
-        Run history for workflows in the caller's workspaces, with step
-        transitions inline. POST creates a run of a WorkflowDefinition and
-        dispatches it. Runs on the same project execute concurrently.
+        An offset/limit page. A run carries its transitions inline, so the
+        unpaged history was the largest payload this API could return and
+        grew without bound; a reader now sees a page and the true ``total``
+        rather than whatever fit.
       parameters:
       - in: query
         name: archived
@@ -3665,6 +3852,16 @@ paths:
         schema:
           type: string
         description: Filter by definition UUID
+      - in: query
+        name: limit
+        schema:
+          type: integer
+        description: Max runs per page (default 25, cap 100)
+      - in: query
+        name: offset
+        schema:
+          type: integer
+        description: Page offset (default 0)
       - in: query
         name: project
         schema:
@@ -3690,9 +3887,7 @@ paths:
           content:
             application/json:
               schema:
-                type: array
-                items:
-                  $ref: '#/components/schemas/WorkflowRun'
+                $ref: '#/components/schemas/WorkflowRunListResponse'
           description: ''
     post:
       operationId: workflows_runs_create
@@ -6133,6 +6328,11 @@ components:
           type: string
           format: uuid
           readOnly: true
+        project:
+          type: string
+          format: uuid
+          readOnly: true
+          nullable: true
         source:
           type: string
           readOnly: true
@@ -6169,6 +6369,7 @@ components:
       - observed_at
       - occurred_at
       - payload
+      - project
       - source
       - status
       - workspace
@@ -7846,6 +8047,22 @@ components:
       - name
       - updated_at
       - workspace
+    VendorListResponse:
+      type: object
+      properties:
+        items:
+          type: array
+          items:
+            $ref: '#/components/schemas/Vendor'
+        total:
+          type: integer
+        next_offset:
+          type: integer
+          nullable: true
+      required:
+      - items
+      - next_offset
+      - total
     VendorRequest:
       type: object
       properties:
@@ -8288,6 +8505,22 @@ components:
       - triggered_by_name
       - workflow
       - workflow_name
+    WorkflowRunListResponse:
+      type: object
+      properties:
+        items:
+          type: array
+          items:
+            $ref: '#/components/schemas/WorkflowRun'
+        total:
+          type: integer
+        next_offset:
+          type: integer
+          nullable: true
+      required:
+      - items
+      - next_offset
+      - total
     WorkflowRunStatusEnum:
       enum:
       - queued

{current_cli-0.1.52 → current_cli-0.1.54}/llms.txt

@@ -565,6 +565,24 @@ Sign in with a magic link and store the auth token.
 
 Invalidate the auth token on the server and forget it locally.
 
+### current observations by-project retrieve
+
+Which projects hold the matching observations, and how many each holds. Takes the same filters as the list. Answers 'which projects have activity of this kind in this window' in one call — paging every matching row and grouping them by hand is the same question asked badly, and it miscounts. Projects are ordered by count and capped; narrow the window rather than expect every project back.
+
+GET /api/observations/observations/by-project/
+
+Options:
+- `--facets` - Add 'by_source' to the response: how many matching observations each source holds. Costs one extra grouped query, so it is opt-in — ask for it when you need to know this workspace's actual mix rather than assume one.
+- `--ids` - Comma-separated observation UUIDs
+- `--order` - Sort key. Defaults to -occurred_at when project, since or until is given, because a window is a question about world time, and to -observed_at otherwise, because the stream is a work queue ordered by when Current learned of things.
+- `--project` - Filter by project UUID
+- `--revisions` - Observations are immutable, so an edited Chatter post is a second row sharing payload.record_key. 'all' (default) returns every revision, which is what the project audit log shows. 'current' returns only the latest revision of each post or comment, which is what a count of what people said means.
+- `--since` - Keep observations that happened at or after this instant. Bounds occurred_at (when it happened in the world), not observed_at (when Current learned of it). ISO-8601; a bare date means the START of that day. A value with no offset is read in the workspace's timezone when exactly one workspace is in scope, otherwise UTC.
+- `--source` - Keep only observations from this source; repeat to accept several. Common names work as well as the stored value: 'chatter' finds 'sitetracker_feed'. An unknown source is refused with the recorded ones named, because an empty page would read as 'nothing happened'.
+- `--status` - Filter by status (pending/ingested)
+- `--until` - Keep observations that happened at or before this instant, inclusive. A bare date means the END of that day, so since=2026-09-01&until=2026-09-14 is the fourteen days a person means by that.
+- `--workspace` - Filter by workspace UUID
+
 ### current observations create
 
 The workspace observation stream. List/retrieve for members; create is
@@ -572,6 +590,12 @@ quick-capture (source=user). No update or delete — content is immutable
 and annotations belong to agents. ``project=`` is the project audit log,
 newest happening first.
 
+``source``, ``since`` and ``until`` narrow the stream to one kind of
+activity in one window of world time; ``by-project`` answers "which
+projects" over that same window in one call, instead of paging every row
+and grouping them by eye. Page size is capped at 200 whatever you ask
+for.
+
 POST /api/observations/observations/
 
 Options:
@@ -584,14 +608,26 @@ quick-capture (source=user). No update or delete — content is immutable
 and annotations belong to agents. ``project=`` is the project audit log,
 newest happening first.
 
+``source``, ``since`` and ``until`` narrow the stream to one kind of
+activity in one window of world time; ``by-project`` answers "which
+projects" over that same window in one call, instead of paging every row
+and grouping them by eye. Page size is capped at 200 whatever you ask
+for.
+
 GET /api/observations/observations/
 
 Options:
+- `--facets` - Add 'by_source' to the response: how many matching observations each source holds. Costs one extra grouped query, so it is opt-in — ask for it when you need to know this workspace's actual mix rather than assume one.
 - `--ids` - Comma-separated observation UUIDs
 - `--limit` - Number of results to return per page.
 - `--offset` - The initial index from which to return the results.
+- `--order` - Sort key. Defaults to -occurred_at when project, since or until is given, because a window is a question about world time, and to -observed_at otherwise, because the stream is a work queue ordered by when Current learned of things.
 - `--project` - Filter by project UUID
+- `--revisions` - Observations are immutable, so an edited Chatter post is a second row sharing payload.record_key. 'all' (default) returns every revision, which is what the project audit log shows. 'current' returns only the latest revision of each post or comment, which is what a count of what people said means.
+- `--since` - Keep observations that happened at or after this instant. Bounds occurred_at (when it happened in the world), not observed_at (when Current learned of it). ISO-8601; a bare date means the START of that day. A value with no offset is read in the workspace's timezone when exactly one workspace is in scope, otherwise UTC.
+- `--source` - Keep only observations from this source; repeat to accept several. Common names work as well as the stored value: 'chatter' finds 'sitetracker_feed'. An unknown source is refused with the recorded ones named, because an empty page would read as 'nothing happened'.
 - `--status` - Filter by status (pending/ingested)
+- `--until` - Keep observations that happened at or before this instant, inclusive. A bare date means the END of that day, so since=2026-09-01&until=2026-09-14 is the fourteen days a person means by that.
 - `--workspace` - Filter by workspace UUID
 
 ### current observations retrieve <id>
@@ -601,6 +637,12 @@ quick-capture (source=user). No update or delete — content is immutable
 and annotations belong to agents. ``project=`` is the project audit log,
 newest happening first.
 
+``source``, ``since`` and ``until`` narrow the stream to one kind of
+activity in one window of world time; ``by-project`` answers "which
+projects" over that same window in one call, instead of paging every row
+and grouping them by eye. Page size is capped at 200 whatever you ask
+for.
+
 GET /api/observations/observations/{id}/
 
 ### current projects closeout retrieve <id>
@@ -1153,6 +1195,8 @@ Vendors across the caller's workspaces. Any member can create and edit.
 GET /api/vendors/vendors/
 
 Options:
+- `--limit` - Max vendors per page (default 25, cap 100)
+- `--offset` - Page offset (default 0)
 - `--project` - Filter by linked project UUID
 - `--workspace` - Filter by workspace UUID
 
@@ -1325,15 +1369,18 @@ Options:
 
 ### current workflows runs list
 
-Run history for workflows in the caller's workspaces, with step
-transitions inline. POST creates a run of a WorkflowDefinition and
-dispatches it. Runs on the same project execute concurrently.
+An offset/limit page. A run carries its transitions inline, so the
+unpaged history was the largest payload this API could return and
+grew without bound; a reader now sees a page and the true ``total``
+rather than whatever fit.
 
 GET /api/workflows/runs/
 
 Options:
 - `--archived` - Filter by archived state. Defaults to false (hides archived runs).
 - `--definition` - Filter by definition UUID
+- `--limit` - Max runs per page (default 25, cap 100)
+- `--offset` - Page offset (default 0)
 - `--project` - Filter by project UUID
 - `--workflow` - Filter by workflow UUID
 - `--workspace` - Filter by workspace UUID

{current_cli-0.1.52 → current_cli-0.1.54}/pyproject.toml

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