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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: current-cli
3
- Version: 0.1.83
3
+ Version: 0.1.84
4
4
  Summary: Command line interface for the Current API, generated from its OpenAPI schema at runtime
5
5
  Author-email: Orin <your-email@example.com>
6
6
  License-Expression: MIT
@@ -1966,11 +1966,30 @@ paths:
1966
1966
  and grouping them by eye. Page size is capped at 200 whatever you ask
1967
1967
  for.
1968
1968
  parameters:
1969
+ - in: query
1970
+ name: author_contact
1971
+ schema:
1972
+ type: array
1973
+ items:
1974
+ type: string
1975
+ description: Author contact UUIDs. Exact identity matches only.
1976
+ - in: query
1977
+ name: author_status
1978
+ schema:
1979
+ type: string
1980
+ description: resolved, unresolved, conflict, or platform
1981
+ - in: query
1982
+ name: bounds
1983
+ schema:
1984
+ type: string
1985
+ description: inclusive (legacy default) or half_open
1969
1986
  - in: query
1970
1987
  name: facets
1971
1988
  schema:
1972
1989
  type: string
1973
1990
  enum:
1991
+ - coverage
1992
+ - kind
1974
1993
  - source
1975
1994
  description: 'Add ''by_source'' to the response: how many matching observations
1976
1995
  each source holds. Costs one extra grouped query, so it is opt-in — ask
@@ -1981,6 +2000,14 @@ paths:
1981
2000
  schema:
1982
2001
  type: string
1983
2002
  description: Comma-separated observation UUIDs
2003
+ - in: query
2004
+ name: kind
2005
+ schema:
2006
+ type: array
2007
+ items:
2008
+ type: string
2009
+ description: Recorded kind, including post, comment, project_comment, message,
2010
+ email, note, event. chatter and project_comments are aliases.
1984
2011
  - name: limit
1985
2012
  required: false
1986
2013
  in: query
@@ -2009,8 +2036,25 @@ paths:
2009
2036
  - in: query
2010
2037
  name: project
2011
2038
  schema:
2012
- type: string
2013
- description: Filter by project UUID
2039
+ type: array
2040
+ items:
2041
+ type: string
2042
+ description: Filter by project UUIDs (OR)
2043
+ - in: query
2044
+ name: related_contact
2045
+ schema:
2046
+ type: array
2047
+ items:
2048
+ type: string
2049
+ description: Contact UUIDs for mentions, recipients, references, or involvement.
2050
+ - in: query
2051
+ name: relationship
2052
+ schema:
2053
+ type: array
2054
+ items:
2055
+ type: string
2056
+ description: mention, to, cc, text, possible, author; defaults to all except
2057
+ author.
2014
2058
  - in: query
2015
2059
  name: revisions
2016
2060
  schema:
@@ -2032,6 +2076,11 @@ paths:
2032
2076
  learned of it). ISO-8601; a bare date means the START of that day. A value
2033
2077
  with no offset is read in the workspace's timezone when exactly one workspace
2034
2078
  is in scope, otherwise UTC.
2079
+ - in: query
2080
+ name: snapshot
2081
+ schema:
2082
+ type: string
2083
+ description: Echo the response snapshot across pages.
2035
2084
  - in: query
2036
2085
  name: source
2037
2086
  schema:
@@ -2047,6 +2096,21 @@ paths:
2047
2096
  schema:
2048
2097
  type: string
2049
2098
  description: Filter by status (pending/ingested)
2099
+ - in: query
2100
+ name: text
2101
+ schema:
2102
+ type: string
2103
+ description: Whole-word body text; optional trailing * for prefix search.
2104
+ - in: query
2105
+ name: thread
2106
+ schema:
2107
+ type: string
2108
+ description: Source thread identifier.
2109
+ - in: query
2110
+ name: timezone
2111
+ schema:
2112
+ type: string
2113
+ description: IANA timezone; defaults to workspace timezone.
2050
2114
  - in: query
2051
2115
  name: until
2052
2116
  schema:
@@ -2054,6 +2118,11 @@ paths:
2054
2118
  description: Keep observations that happened at or before this instant, inclusive.
2055
2119
  A bare date means the END of that day, so since=2026-09-01&until=2026-09-14
2056
2120
  is the fourteen days a person means by that.
2121
+ - in: query
2122
+ name: window
2123
+ schema:
2124
+ type: string
2125
+ description: last_two_days (48 hours) or last_week (previous Monday to Monday).
2057
2126
  - in: query
2058
2127
  name: workspace
2059
2128
  schema:
@@ -2153,11 +2222,30 @@ paths:
2153
2222
  by subtracting a recent one. Pages by project: read total_projects and follow
2154
2223
  next_offset.'
2155
2224
  parameters:
2225
+ - in: query
2226
+ name: author_contact
2227
+ schema:
2228
+ type: array
2229
+ items:
2230
+ type: string
2231
+ description: Author contact UUIDs. Exact identity matches only.
2232
+ - in: query
2233
+ name: author_status
2234
+ schema:
2235
+ type: string
2236
+ description: resolved, unresolved, conflict, or platform
2237
+ - in: query
2238
+ name: bounds
2239
+ schema:
2240
+ type: string
2241
+ description: inclusive (legacy default) or half_open
2156
2242
  - in: query
2157
2243
  name: facets
2158
2244
  schema:
2159
2245
  type: string
2160
2246
  enum:
2247
+ - coverage
2248
+ - kind
2161
2249
  - source
2162
2250
  description: 'Add ''by_source'' to the response: how many matching observations
2163
2251
  each source holds. Costs one extra grouped query, so it is opt-in — ask
@@ -2168,6 +2256,14 @@ paths:
2168
2256
  schema:
2169
2257
  type: string
2170
2258
  description: Comma-separated observation UUIDs
2259
+ - in: query
2260
+ name: kind
2261
+ schema:
2262
+ type: array
2263
+ items:
2264
+ type: string
2265
+ description: Recorded kind, including post, comment, project_comment, message,
2266
+ email, note, event. chatter and project_comments are aliases.
2171
2267
  - in: query
2172
2268
  name: limit
2173
2269
  schema:
@@ -2194,8 +2290,25 @@ paths:
2194
2290
  - in: query
2195
2291
  name: project
2196
2292
  schema:
2197
- type: string
2198
- description: Filter by project UUID
2293
+ type: array
2294
+ items:
2295
+ type: string
2296
+ description: Filter by project UUIDs (OR)
2297
+ - in: query
2298
+ name: related_contact
2299
+ schema:
2300
+ type: array
2301
+ items:
2302
+ type: string
2303
+ description: Contact UUIDs for mentions, recipients, references, or involvement.
2304
+ - in: query
2305
+ name: relationship
2306
+ schema:
2307
+ type: array
2308
+ items:
2309
+ type: string
2310
+ description: mention, to, cc, text, possible, author; defaults to all except
2311
+ author.
2199
2312
  - in: query
2200
2313
  name: revisions
2201
2314
  schema:
@@ -2217,6 +2330,11 @@ paths:
2217
2330
  learned of it). ISO-8601; a bare date means the START of that day. A value
2218
2331
  with no offset is read in the workspace's timezone when exactly one workspace
2219
2332
  is in scope, otherwise UTC.
2333
+ - in: query
2334
+ name: snapshot
2335
+ schema:
2336
+ type: string
2337
+ description: Echo the response snapshot across pages.
2220
2338
  - in: query
2221
2339
  name: sort
2222
2340
  schema:
@@ -2243,6 +2361,21 @@ paths:
2243
2361
  schema:
2244
2362
  type: string
2245
2363
  description: Filter by status (pending/ingested)
2364
+ - in: query
2365
+ name: text
2366
+ schema:
2367
+ type: string
2368
+ description: Whole-word body text; optional trailing * for prefix search.
2369
+ - in: query
2370
+ name: thread
2371
+ schema:
2372
+ type: string
2373
+ description: Source thread identifier.
2374
+ - in: query
2375
+ name: timezone
2376
+ schema:
2377
+ type: string
2378
+ description: IANA timezone; defaults to workspace timezone.
2246
2379
  - in: query
2247
2380
  name: until
2248
2381
  schema:
@@ -2250,6 +2383,11 @@ paths:
2250
2383
  description: Keep observations that happened at or before this instant, inclusive.
2251
2384
  A bare date means the END of that day, so since=2026-09-01&until=2026-09-14
2252
2385
  is the fourteen days a person means by that.
2386
+ - in: query
2387
+ name: window
2388
+ schema:
2389
+ type: string
2390
+ description: last_two_days (48 hours) or last_week (previous Monday to Monday).
2253
2391
  - in: query
2254
2392
  name: workspace
2255
2393
  schema:
@@ -9822,6 +9960,40 @@ components:
9822
9960
  source:
9823
9961
  type: string
9824
9962
  readOnly: true
9963
+ author_contact:
9964
+ type: string
9965
+ format: uuid
9966
+ readOnly: true
9967
+ nullable: true
9968
+ author_name:
9969
+ type: string
9970
+ readOnly: true
9971
+ author_status:
9972
+ type: string
9973
+ readOnly: true
9974
+ actor_kind:
9975
+ type: string
9976
+ readOnly: true
9977
+ mention_status:
9978
+ type: string
9979
+ readOnly: true
9980
+ time_precision:
9981
+ type: string
9982
+ readOnly: true
9983
+ occurred_until:
9984
+ type: string
9985
+ format: date-time
9986
+ readOnly: true
9987
+ nullable: true
9988
+ match_reasons:
9989
+ type: array
9990
+ items:
9991
+ type: object
9992
+ additionalProperties: {}
9993
+ readOnly: true
9994
+ snippet:
9995
+ type: string
9996
+ readOnly: true
9825
9997
  body:
9826
9998
  type: string
9827
9999
  readOnly: true
@@ -9848,16 +10020,25 @@ components:
9848
10020
  readOnly: true
9849
10021
  nullable: true
9850
10022
  required:
10023
+ - actor_kind
10024
+ - author_contact
10025
+ - author_name
10026
+ - author_status
9851
10027
  - body
9852
10028
  - description
9853
10029
  - id
9854
10030
  - ingested_at
10031
+ - match_reasons
10032
+ - mention_status
9855
10033
  - observed_at
9856
10034
  - occurred_at
10035
+ - occurred_until
9857
10036
  - payload
9858
10037
  - project
10038
+ - snippet
9859
10039
  - source
9860
10040
  - status
10041
+ - time_precision
9861
10042
  - workspace
9862
10043
  ObservationStatusEnum:
9863
10044
  enum:
@@ -710,18 +710,29 @@ Which projects hold the matching observations: how many each holds and when the
710
710
  GET /api/observations/observations/by-project/
711
711
 
712
712
  Options:
713
+ - `--author-contact` - Author contact UUIDs. Exact identity matches only.
714
+ - `--author-status` - resolved, unresolved, conflict, or platform
715
+ - `--bounds` - inclusive (legacy default) or half_open
713
716
  - `--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.
714
717
  - `--ids` - Comma-separated observation UUIDs
718
+ - `--kind` - Recorded kind, including post, comment, project_comment, message, email, note, event. chatter and project_comments are aliases.
715
719
  - `--limit` - Projects per page (default 100, cap 200)
716
720
  - `--offset` - Project page offset (default 0)
717
721
  - `--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.
718
- - `--project` - Filter by project UUID
722
+ - `--project` - Filter by project UUIDs (OR)
723
+ - `--related-contact` - Contact UUIDs for mentions, recipients, references, or involvement.
724
+ - `--relationship` - mention, to, cc, text, possible, author; defaults to all except author.
719
725
  - `--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.
720
726
  - `--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.
727
+ - `--snapshot` - Echo the response snapshot across pages.
721
728
  - `--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.
722
729
  - `--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'.
723
730
  - `--status` - Filter by status (pending/ingested)
731
+ - `--text` - Whole-word body text; optional trailing * for prefix search.
732
+ - `--thread` - Source thread identifier.
733
+ - `--timezone` - IANA timezone; defaults to workspace timezone.
724
734
  - `--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.
735
+ - `--window` - last_two_days (48 hours) or last_week (previous Monday to Monday).
725
736
  - `--workspace` - Filter by workspace UUID
726
737
 
727
738
  ### current observations create
@@ -758,17 +769,28 @@ for.
758
769
  GET /api/observations/observations/
759
770
 
760
771
  Options:
772
+ - `--author-contact` - Author contact UUIDs. Exact identity matches only.
773
+ - `--author-status` - resolved, unresolved, conflict, or platform
774
+ - `--bounds` - inclusive (legacy default) or half_open
761
775
  - `--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.
762
776
  - `--ids` - Comma-separated observation UUIDs
777
+ - `--kind` - Recorded kind, including post, comment, project_comment, message, email, note, event. chatter and project_comments are aliases.
763
778
  - `--limit` - Number of results to return per page.
764
779
  - `--offset` - The initial index from which to return the results.
765
780
  - `--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.
766
- - `--project` - Filter by project UUID
781
+ - `--project` - Filter by project UUIDs (OR)
782
+ - `--related-contact` - Contact UUIDs for mentions, recipients, references, or involvement.
783
+ - `--relationship` - mention, to, cc, text, possible, author; defaults to all except author.
767
784
  - `--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.
768
785
  - `--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.
786
+ - `--snapshot` - Echo the response snapshot across pages.
769
787
  - `--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'.
770
788
  - `--status` - Filter by status (pending/ingested)
789
+ - `--text` - Whole-word body text; optional trailing * for prefix search.
790
+ - `--thread` - Source thread identifier.
791
+ - `--timezone` - IANA timezone; defaults to workspace timezone.
771
792
  - `--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.
793
+ - `--window` - last_two_days (48 hours) or last_week (previous Monday to Monday).
772
794
  - `--workspace` - Filter by workspace UUID
773
795
 
774
796
  ### current observations retrieve <id>
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "current-cli"
3
- version = "0.1.83"
3
+ version = "0.1.84"
4
4
  description = "Command line interface for the Current API, generated from its OpenAPI schema at runtime"
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.10"
File without changes
File without changes