current-cli 0.1.35__tar.gz → 0.1.37__tar.gz

{current_cli-0.1.35 → current_cli-0.1.37}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: current-cli
-Version: 0.1.35
+Version: 0.1.37
 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.35 → current_cli-0.1.37}/current_cli/build.py

@@ -16,9 +16,14 @@ def _make_callback(op: Operation):
         for param in op.path_params:
             path = path.replace("{" + param.name + "}", str(kwargs.pop(param.name)))
 
-        params: dict[str, str] = {}
+        params: dict[str, str | list[str]] = {}
         for param in op.query_params:
             value = kwargs.pop(param.name, None)
+            # click gives a repeatable option an empty tuple, not None, when
+            # it is absent; treat that as "not given" so it never becomes an
+            # empty query key.
+            if param.is_array:
+                value = list(value) if value else None
             if value is None and param.name == "workspace":
                 value = config.get("default_workspace")
             if value is None:
@@ -48,6 +53,7 @@ def _make_command(op: Operation) -> click.Command:
             click.Option(
                 [f"--{param.name.replace('_', '-')}"],
                 required=False,
+                multiple=param.is_array,
                 help=param.description or None,
             )
         )

{current_cli-0.1.35 → current_cli-0.1.37}/current_cli/schema.py

@@ -21,6 +21,9 @@ class Parameter:
     location: str  # "path" or "query"
     required: bool
     description: str
+    # An array query param is sent as the repeated key the API reads with
+    # getlist (?fields=a&fields=b), so its option has to be repeatable too.
+    is_array: bool = False
 
 
 @dataclass(frozen=True)
@@ -90,6 +93,7 @@ def extract_operations(spec: dict) -> list[Operation]:
                     location=raw["in"],
                     required=raw.get("required", False),
                     description=raw.get("description", ""),
+                    is_array=raw.get("schema", {}).get("type") == "array",
                 )
                 if param.location == "path":
                     path_params.append(param)

{current_cli-0.1.35 → current_cli-0.1.37}/current_cli/schema.yml

@@ -1053,6 +1053,16 @@ paths:
         definition the agent declares no inputs, so it gets the company tree
         plus every project tree and decides for itself what it needs.
 
+        An index, not a copy: the sandbox fetches a file's bytes only when the
+        model reads that file. That is what lets this stay workspace-wide now
+        that a workspace mirrors its Sitetracker documents — gigabytes of
+        scans that ``read_file`` could only refuse, and that an attachment
+        reads here from object storage rather than from the sandbox.
+
+        ``truncated`` says the workspace holds more than this answer names, so
+        the agent can tell a user "I cannot see all of your files" instead of
+        reporting a file it was never given as one the workspace does not have.
+
         POST, for a read, because the job-token permission class reads the
         workspace id out of the request body — the same contract every other
         messaging-job endpoint uses.
@@ -1841,12 +1851,17 @@ paths:
     get:
       operationId: projects_projects_inventory_retrieve
       description: |-
-        Page current field values, optionally narrowed to named keys.
+        Page current field values, optionally narrowed to named keys and
+        to projects whose values match.
 
         The full project list serializes every field of every project —
         megabytes at production scale. This page is the compact census a
         chat agent can scan: identity plus the keys it asked for, no
-        timeline, no provenance. See state.list_projects.
+        timeline, no provenance.
+
+        Filter here rather than page-and-sift: a caller that reads every
+        page and picks the matches by eye miscounts, and "total" under a
+        filter is the count it was really after. See state.list_projects.
       parameters:
       - in: query
         name: fields
@@ -1855,6 +1870,16 @@ paths:
           items:
             type: string
         description: Field keys to keep; omit to return every current value
+      - in: query
+        name: filter
+        schema:
+          type: array
+          items:
+            type: string
+        description: Keep only projects whose current value matches, as 'key:value'
+          (for example 'status:Active'). Repeat for more fields; repeating one key
+          accepts any of its values. An option matches by label, value, or ID. 'total'
+          counts the matching projects.
       - in: query
         name: limit
         schema:
@@ -1865,6 +1890,14 @@ paths:
         schema:
           type: integer
         description: Number of projects to skip (default 0)
+      - in: query
+        name: values
+        schema:
+          type: string
+          enum:
+          - ids
+          - labels
+        description: Read option values as labels (default) or as option IDs
       - in: query
         name: workspace
         schema:
@@ -4218,6 +4251,9 @@ components:
           type: array
           items:
             $ref: '#/components/schemas/ManifestEntry'
+        truncated:
+          type: boolean
+          default: false
       required:
       - files
     Me:

{current_cli-0.1.35 → current_cli-0.1.37}/llms.txt

@@ -383,6 +383,16 @@ message can turn out to be about any project, and unlike a workflow
 definition the agent declares no inputs, so it gets the company tree
 plus every project tree and decides for itself what it needs.
 
+An index, not a copy: the sandbox fetches a file's bytes only when the
+model reads that file. That is what lets this stay workspace-wide now
+that a workspace mirrors its Sitetracker documents — gigabytes of
+scans that ``read_file`` could only refuse, and that an attachment
+reads here from object storage rather than from the sandbox.
+
+``truncated`` says the workspace holds more than this answer names, so
+the agent can tell a user "I cannot see all of your files" instead of
+reporting a file it was never given as one the workspace does not have.
+
 POST, for a read, because the job-token permission class reads the
 workspace id out of the request body — the same contract every other
 messaging-job endpoint uses.
@@ -617,19 +627,26 @@ Options:
 
 ### current projects inventory retrieve
 
-Page current field values, optionally narrowed to named keys.
+Page current field values, optionally narrowed to named keys and
+to projects whose values match.
 
 The full project list serializes every field of every project —
 megabytes at production scale. This page is the compact census a
 chat agent can scan: identity plus the keys it asked for, no
-timeline, no provenance. See state.list_projects.
+timeline, no provenance.
+
+Filter here rather than page-and-sift: a caller that reads every
+page and picks the matches by eye miscounts, and "total" under a
+filter is the count it was really after. See state.list_projects.
 
 GET /api/projects/projects/inventory/
 
 Options:
 - `--fields` - Field keys to keep; omit to return every current value
+- `--filter` - Keep only projects whose current value matches, as 'key:value' (for example 'status:Active'). Repeat for more fields; repeating one key accepts any of its values. An option matches by label, value, or ID. 'total' counts the matching projects.
 - `--limit` - Max projects per page (default 100, max 200)
 - `--offset` - Number of projects to skip (default 0)
+- `--values` - Read option values as labels (default) or as option IDs
 - `--workspace` - Workspace UUID
 
 ### current projects list

{current_cli-0.1.35 → current_cli-0.1.37}/pyproject.toml

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

{current_cli-0.1.35 → current_cli-0.1.37}/tests/test_requests.py

@@ -60,6 +60,40 @@ def test_create_sends_json_body(cli, runner, transport_factory):
     assert json.loads(request.content) == {"name": "Order beams", "workspace": "w1"}
 
 
+def test_array_query_param_repeats(cli, runner, transport_factory):
+    """An array param must repeat its key, the shape the API reads with
+    getlist — one AND-ed filter per --filter."""
+    transport = transport_factory(ok({}))
+
+    result = runner.invoke(
+        cli,
+        [
+            "projects",
+            "inventory",
+            "retrieve",
+            "--workspace",
+            "ws-uuid",
+            "--filter",
+            "status:Active",
+            "--filter",
+            "site_type:Garden Style",
+        ],
+    )
+
+    assert result.exit_code == 0, result.output
+    params = transport.requests[0].url.params
+    assert params.get_list("filter") == ["status:Active", "site_type:Garden Style"]
+
+
+def test_array_query_param_is_absent_when_not_given(cli, runner, transport_factory):
+    transport = transport_factory(ok({}))
+
+    result = runner.invoke(cli, ["projects", "inventory", "retrieve", "--workspace", "ws-uuid"])
+
+    assert result.exit_code == 0, result.output
+    assert "filter" not in transport.requests[0].url.params
+
+
 def test_default_workspace_fallback(cli, runner, transport_factory):
     config.set_value("default_workspace", "default-ws")
     transport = transport_factory(ok({}))