current-cli 0.1.82__tar.gz → 0.1.84__tar.gz

{current_cli-0.1.82 → current_cli-0.1.84}/PKG-INFO

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

@@ -1592,6 +1592,40 @@ paths:
               schema:
                 $ref: '#/components/schemas/PromoteResponse'
           description: ''
+  /api/integrations/messaging/flag/:
+    post:
+      operationId: integrations_messaging_flag
+      description: |-
+        File a Linear triage ticket for Orin Labs, because a person asked the
+        agent to flag something for the team that builds Current — see
+        :mod:`integrations.flags`.
+
+        The agent writes the title and the details; the platform adds the
+        workspace, the reporter and its own ids, and masks contact details, so a
+        ticket never depends on the model to keep personal data out.
+      tags:
+      - integrations
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/MessagingFlagRequestRequest'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/MessagingFlagRequestRequest'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/MessagingFlagRequestRequest'
+        required: true
+      security:
+      - MessagingJobTokenAuth: []
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/MessagingFlagResponse'
+          description: ''
   /api/integrations/messaging/history/:
     post:
       operationId: integrations_messaging_history
@@ -1932,11 +1966,30 @@ paths:
         and grouping them by eye. Page size is capped at 200 whatever you ask
         for.
       parameters:
+      - in: query
+        name: author_contact
+        schema:
+          type: array
+          items:
+            type: string
+        description: Author contact UUIDs. Exact identity matches only.
+      - in: query
+        name: author_status
+        schema:
+          type: string
+        description: resolved, unresolved, conflict, or platform
+      - in: query
+        name: bounds
+        schema:
+          type: string
+        description: inclusive (legacy default) or half_open
       - in: query
         name: facets
         schema:
           type: string
           enum:
+          - coverage
+          - kind
           - 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
@@ -1947,6 +2000,14 @@ paths:
         schema:
           type: string
         description: Comma-separated observation UUIDs
+      - in: query
+        name: kind
+        schema:
+          type: array
+          items:
+            type: string
+        description: Recorded kind, including post, comment, project_comment, message,
+          email, note, event. chatter and project_comments are aliases.
       - name: limit
         required: false
         in: query
@@ -1975,8 +2036,25 @@ paths:
       - in: query
         name: project
         schema:
-          type: string
-        description: Filter by project UUID
+          type: array
+          items:
+            type: string
+        description: Filter by project UUIDs (OR)
+      - in: query
+        name: related_contact
+        schema:
+          type: array
+          items:
+            type: string
+        description: Contact UUIDs for mentions, recipients, references, or involvement.
+      - in: query
+        name: relationship
+        schema:
+          type: array
+          items:
+            type: string
+        description: mention, to, cc, text, possible, author; defaults to all except
+          author.
       - in: query
         name: revisions
         schema:
@@ -1998,6 +2076,11 @@ paths:
           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: snapshot
+        schema:
+          type: string
+        description: Echo the response snapshot across pages.
       - in: query
         name: source
         schema:
@@ -2013,6 +2096,21 @@ paths:
         schema:
           type: string
         description: Filter by status (pending/ingested)
+      - in: query
+        name: text
+        schema:
+          type: string
+        description: Whole-word body text; optional trailing * for prefix search.
+      - in: query
+        name: thread
+        schema:
+          type: string
+        description: Source thread identifier.
+      - in: query
+        name: timezone
+        schema:
+          type: string
+        description: IANA timezone; defaults to workspace timezone.
       - in: query
         name: until
         schema:
@@ -2020,6 +2118,11 @@ paths:
         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: window
+        schema:
+          type: string
+        description: last_two_days (48 hours) or last_week (previous Monday to Monday).
       - in: query
         name: workspace
         schema:
@@ -2119,11 +2222,30 @@ paths:
         by subtracting a recent one. Pages by project: read total_projects and follow
         next_offset.'
       parameters:
+      - in: query
+        name: author_contact
+        schema:
+          type: array
+          items:
+            type: string
+        description: Author contact UUIDs. Exact identity matches only.
+      - in: query
+        name: author_status
+        schema:
+          type: string
+        description: resolved, unresolved, conflict, or platform
+      - in: query
+        name: bounds
+        schema:
+          type: string
+        description: inclusive (legacy default) or half_open
       - in: query
         name: facets
         schema:
           type: string
           enum:
+          - coverage
+          - kind
           - 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
@@ -2134,6 +2256,14 @@ paths:
         schema:
           type: string
         description: Comma-separated observation UUIDs
+      - in: query
+        name: kind
+        schema:
+          type: array
+          items:
+            type: string
+        description: Recorded kind, including post, comment, project_comment, message,
+          email, note, event. chatter and project_comments are aliases.
       - in: query
         name: limit
         schema:
@@ -2160,8 +2290,25 @@ paths:
       - in: query
         name: project
         schema:
-          type: string
-        description: Filter by project UUID
+          type: array
+          items:
+            type: string
+        description: Filter by project UUIDs (OR)
+      - in: query
+        name: related_contact
+        schema:
+          type: array
+          items:
+            type: string
+        description: Contact UUIDs for mentions, recipients, references, or involvement.
+      - in: query
+        name: relationship
+        schema:
+          type: array
+          items:
+            type: string
+        description: mention, to, cc, text, possible, author; defaults to all except
+          author.
       - in: query
         name: revisions
         schema:
@@ -2183,6 +2330,11 @@ paths:
           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: snapshot
+        schema:
+          type: string
+        description: Echo the response snapshot across pages.
       - in: query
         name: sort
         schema:
@@ -2209,6 +2361,21 @@ paths:
         schema:
           type: string
         description: Filter by status (pending/ingested)
+      - in: query
+        name: text
+        schema:
+          type: string
+        description: Whole-word body text; optional trailing * for prefix search.
+      - in: query
+        name: thread
+        schema:
+          type: string
+        description: Source thread identifier.
+      - in: query
+        name: timezone
+        schema:
+          type: string
+        description: IANA timezone; defaults to workspace timezone.
       - in: query
         name: until
         schema:
@@ -2216,6 +2383,11 @@ paths:
         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: window
+        schema:
+          type: string
+        description: last_two_days (48 hours) or last_week (previous Monday to Monday).
       - in: query
         name: workspace
         schema:
@@ -9498,6 +9670,39 @@ components:
       - role
       - workspace_id
       - workspace_name
+    MessagingFlagRequestRequest:
+      type: object
+      properties:
+        workspace:
+          type: string
+          format: uuid
+        reply_ref: {}
+        title:
+          type: string
+          minLength: 1
+          maxLength: 200
+        details:
+          type: string
+          minLength: 1
+          maxLength: 10000
+        project:
+          type: string
+          format: uuid
+      required:
+      - details
+      - reply_ref
+      - title
+      - workspace
+    MessagingFlagResponse:
+      type: object
+      properties:
+        ok:
+          type: boolean
+        detail:
+          type: string
+      required:
+      - detail
+      - ok
     MessagingHistoryRequestRequest:
       type: object
       properties:
@@ -9755,6 +9960,40 @@ components:
         source:
           type: string
           readOnly: true
+        author_contact:
+          type: string
+          format: uuid
+          readOnly: true
+          nullable: true
+        author_name:
+          type: string
+          readOnly: true
+        author_status:
+          type: string
+          readOnly: true
+        actor_kind:
+          type: string
+          readOnly: true
+        mention_status:
+          type: string
+          readOnly: true
+        time_precision:
+          type: string
+          readOnly: true
+        occurred_until:
+          type: string
+          format: date-time
+          readOnly: true
+          nullable: true
+        match_reasons:
+          type: array
+          items:
+            type: object
+            additionalProperties: {}
+          readOnly: true
+        snippet:
+          type: string
+          readOnly: true
         body:
           type: string
           readOnly: true
@@ -9781,16 +10020,25 @@ components:
           readOnly: true
           nullable: true
       required:
+      - actor_kind
+      - author_contact
+      - author_name
+      - author_status
       - body
       - description
       - id
       - ingested_at
+      - match_reasons
+      - mention_status
       - observed_at
       - occurred_at
+      - occurred_until
       - payload
       - project
+      - snippet
       - source
       - status
+      - time_precision
       - workspace
     ObservationStatusEnum:
       enum:

{current_cli-0.1.82 → current_cli-0.1.84}/llms.txt

@@ -545,6 +545,21 @@ POST /api/integrations/messaging/files/upload-urls/
 Options:
 - `--data` (required) - Request body as JSON: inline, @file.json, or - for stdin.
 
+### current integrations messaging flag post
+
+File a Linear triage ticket for Orin Labs, because a person asked the
+agent to flag something for the team that builds Current — see
+:mod:`integrations.flags`.
+
+The agent writes the title and the details; the platform adds the
+workspace, the reporter and its own ids, and masks contact details, so a
+ticket never depends on the model to keep personal data out.
+
+POST /api/integrations/messaging/flag/
+
+Options:
+- `--data` (required) - Request body as JSON: inline, @file.json, or - for stdin.
+
 ### current integrations messaging history post
 
 What was already said in this conversation, oldest last.
@@ -695,18 +710,29 @@ Which projects hold the matching observations: how many each holds and when the
 GET /api/observations/observations/by-project/
 
 Options:
+- `--author-contact` - Author contact UUIDs. Exact identity matches only.
+- `--author-status` - resolved, unresolved, conflict, or platform
+- `--bounds` - inclusive (legacy default) or half_open
 - `--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
+- `--kind` - Recorded kind, including post, comment, project_comment, message, email, note, event. chatter and project_comments are aliases.
 - `--limit` - Projects per page (default 100, cap 200)
 - `--offset` - Project page offset (default 0)
 - `--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
+- `--project` - Filter by project UUIDs (OR)
+- `--related-contact` - Contact UUIDs for mentions, recipients, references, or involvement.
+- `--relationship` - mention, to, cc, text, possible, author; defaults to all except author.
 - `--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.
+- `--snapshot` - Echo the response snapshot across pages.
 - `--sort` - Project order. '-count' (default) puts the busiest first. 'latest_occurred_at' puts the quietest first: the projects whose most recent matching activity is oldest.
 - `--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)
+- `--text` - Whole-word body text; optional trailing * for prefix search.
+- `--thread` - Source thread identifier.
+- `--timezone` - IANA timezone; defaults to workspace timezone.
 - `--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.
+- `--window` - last_two_days (48 hours) or last_week (previous Monday to Monday).
 - `--workspace` - Filter by workspace UUID
 
 ### current observations create
@@ -743,17 +769,28 @@ for.
 GET /api/observations/observations/
 
 Options:
+- `--author-contact` - Author contact UUIDs. Exact identity matches only.
+- `--author-status` - resolved, unresolved, conflict, or platform
+- `--bounds` - inclusive (legacy default) or half_open
 - `--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
+- `--kind` - Recorded kind, including post, comment, project_comment, message, email, note, event. chatter and project_comments are aliases.
 - `--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
+- `--project` - Filter by project UUIDs (OR)
+- `--related-contact` - Contact UUIDs for mentions, recipients, references, or involvement.
+- `--relationship` - mention, to, cc, text, possible, author; defaults to all except author.
 - `--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.
+- `--snapshot` - Echo the response snapshot across pages.
 - `--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)
+- `--text` - Whole-word body text; optional trailing * for prefix search.
+- `--thread` - Source thread identifier.
+- `--timezone` - IANA timezone; defaults to workspace timezone.
 - `--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.
+- `--window` - last_two_days (48 hours) or last_week (previous Monday to Monday).
 - `--workspace` - Filter by workspace UUID
 
 ### current observations retrieve <id>

{current_cli-0.1.82 → current_cli-0.1.84}/pyproject.toml

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