current-cli 0.1.83__tar.gz → 0.1.85__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.85
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:
@@ -6107,6 +6245,18 @@ paths:
6107
6245
  operationId: workspaces_models_records_retrieve
6108
6246
  description: Discover and read models belonging to the caller's workspace.
6109
6247
  parameters:
6248
+ - in: query
6249
+ name: fields
6250
+ schema:
6251
+ type: array
6252
+ items:
6253
+ type: string
6254
+ description: Output field keys. Omit for all fields.
6255
+ - in: query
6256
+ name: filters
6257
+ schema:
6258
+ type: string
6259
+ description: JSON object of field-key/scalar equality filters (AND).
6110
6260
  - in: path
6111
6261
  name: id
6112
6262
  schema:
@@ -6119,6 +6269,11 @@ paths:
6119
6269
  schema:
6120
6270
  type: string
6121
6271
  description: Exact record key.
6272
+ - in: query
6273
+ name: limit
6274
+ schema:
6275
+ type: integer
6276
+ description: Maximum records, 1–100; pages are also byte bounded.
6122
6277
  - in: query
6123
6278
  name: offset
6124
6279
  schema:
@@ -9822,6 +9977,40 @@ components:
9822
9977
  source:
9823
9978
  type: string
9824
9979
  readOnly: true
9980
+ author_contact:
9981
+ type: string
9982
+ format: uuid
9983
+ readOnly: true
9984
+ nullable: true
9985
+ author_name:
9986
+ type: string
9987
+ readOnly: true
9988
+ author_status:
9989
+ type: string
9990
+ readOnly: true
9991
+ actor_kind:
9992
+ type: string
9993
+ readOnly: true
9994
+ mention_status:
9995
+ type: string
9996
+ readOnly: true
9997
+ time_precision:
9998
+ type: string
9999
+ readOnly: true
10000
+ occurred_until:
10001
+ type: string
10002
+ format: date-time
10003
+ readOnly: true
10004
+ nullable: true
10005
+ match_reasons:
10006
+ type: array
10007
+ items:
10008
+ type: object
10009
+ additionalProperties: {}
10010
+ readOnly: true
10011
+ snippet:
10012
+ type: string
10013
+ readOnly: true
9825
10014
  body:
9826
10015
  type: string
9827
10016
  readOnly: true
@@ -9848,16 +10037,25 @@ components:
9848
10037
  readOnly: true
9849
10038
  nullable: true
9850
10039
  required:
10040
+ - actor_kind
10041
+ - author_contact
10042
+ - author_name
10043
+ - author_status
9851
10044
  - body
9852
10045
  - description
9853
10046
  - id
9854
10047
  - ingested_at
10048
+ - match_reasons
10049
+ - mention_status
9855
10050
  - observed_at
9856
10051
  - occurred_at
10052
+ - occurred_until
9857
10053
  - payload
9858
10054
  - project
10055
+ - snippet
9859
10056
  - source
9860
10057
  - status
10058
+ - time_precision
9861
10059
  - workspace
9862
10060
  ObservationStatusEnum:
9863
10061
  enum:
@@ -13340,6 +13538,26 @@ components:
13340
13538
  preloaded:
13341
13539
  type: boolean
13342
13540
  readOnly: true
13541
+ source_managed:
13542
+ type: boolean
13543
+ readOnly: true
13544
+ last_synced_at:
13545
+ type: string
13546
+ format: date-time
13547
+ readOnly: true
13548
+ nullable: true
13549
+ last_sync_error:
13550
+ type: string
13551
+ readOnly: true
13552
+ last_sync_failed_at:
13553
+ type: string
13554
+ format: date-time
13555
+ readOnly: true
13556
+ nullable: true
13557
+ sync_coverage:
13558
+ type: object
13559
+ additionalProperties: {}
13560
+ readOnly: true
13343
13561
  bindings:
13344
13562
  type: array
13345
13563
  items:
@@ -13351,8 +13569,13 @@ components:
13351
13569
  - id
13352
13570
  - key
13353
13571
  - label
13572
+ - last_sync_error
13573
+ - last_sync_failed_at
13574
+ - last_synced_at
13354
13575
  - preloaded
13355
13576
  - revision
13577
+ - source_managed
13578
+ - sync_coverage
13356
13579
  - workspace
13357
13580
  WorkspaceModelBinding:
13358
13581
  type: object
@@ -13395,6 +13618,26 @@ components:
13395
13618
  preloaded:
13396
13619
  type: boolean
13397
13620
  readOnly: true
13621
+ source_managed:
13622
+ type: boolean
13623
+ readOnly: true
13624
+ last_synced_at:
13625
+ type: string
13626
+ format: date-time
13627
+ readOnly: true
13628
+ nullable: true
13629
+ last_sync_error:
13630
+ type: string
13631
+ readOnly: true
13632
+ last_sync_failed_at:
13633
+ type: string
13634
+ format: date-time
13635
+ readOnly: true
13636
+ nullable: true
13637
+ sync_coverage:
13638
+ type: object
13639
+ additionalProperties: {}
13640
+ readOnly: true
13398
13641
  bindings:
13399
13642
  type: array
13400
13643
  items:
@@ -13412,8 +13655,13 @@ components:
13412
13655
  - id
13413
13656
  - key
13414
13657
  - label
13658
+ - last_sync_error
13659
+ - last_sync_failed_at
13660
+ - last_synced_at
13415
13661
  - preloaded
13416
13662
  - revision
13663
+ - source_managed
13664
+ - sync_coverage
13417
13665
  - workspace
13418
13666
  WorkspaceModelField:
13419
13667
  type: object
@@ -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>
@@ -1906,7 +1928,10 @@ Discover and read models belonging to the caller's workspace.
1906
1928
  GET /api/workspaces/models/{id}/records/
1907
1929
 
1908
1930
  Options:
1931
+ - `--fields` - Output field keys. Omit for all fields.
1932
+ - `--filters` - JSON object of field-key/scalar equality filters (AND).
1909
1933
  - `--key` - Exact record key.
1934
+ - `--limit` - Maximum records, 1–100; pages are also byte bounded.
1910
1935
  - `--offset` - Record offset. Pages contain at most 100 records.
1911
1936
  - `--rolled-out` - Only models with a binding while rollout is enabled. Always enforced for members.
1912
1937
  - `--workspace` - Filter to one readable workspace.
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "current-cli"
3
- version = "0.1.83"
3
+ version = "0.1.85"
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