ndi-cli 0.25.0__tar.gz → 0.27.0__tar.gz

{ndi_cli-0.25.0 → ndi_cli-0.27.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ndi-cli
-Version: 0.25.0
+Version: 0.27.0
 Summary: NDI platform CLI: document operations, jobs, workspaces, and the agent workspace tools
 Keywords: ndi,cli,document-intelligence,coding-agents
 Author: Nace AI
@@ -58,8 +58,7 @@ config location. Workspace-scoped verbs also take `--workspace ID`.
 | `ndi files upload\|list\|get\|delete` | Workspace files (a directory walks nested files; `--ingest` then queues ingestion) |
 | `ndi ingest` | Queue ingestion |
 | `ndi automatic-search QUERY` | Service answers with fact search or an agent over files, tables and the catalog (`--mode fact\|agent` skips the routing step, `--path` scopes it to files); prints the route, the output job id, and the answer (plus the catalog table when there is one) |
-| `ndi deep-search QUERY` / `ndi fact-search QUERY` | Agentic / single-shot search (`--path` on `deep-search` scopes it to files); then `ndi job` on each printed `grounding_job_ids` entry |
-| `ndi filtered-search QUERY` | Corpus filter/rank/count over the metadata catalog (`--path` scopes it to files, `--cursor` pages an earlier run) |
+| `ndi filtered-search --cursor CURSOR` | Page a catalog table past its first rows. A new `filtered-search QUERY` is deprecated: use `automatic-search` |
 | `ndi je-testing QUERY` | Journal-entry testing over a ledger package (`--path` to scope it, `--reasoning-effort` for the thinking budget) |
 | `ndi ledger-understanding start\|get\|sources\|select\|selection` | Measure the ledger package, confirm sources, or read the latest report |
 | `ndi ask-file PATH QUESTION` | Cited answer over one document, image or recording |

{ndi_cli-0.25.0 → ndi_cli-0.27.0}/README.md

@@ -34,8 +34,7 @@ config location. Workspace-scoped verbs also take `--workspace ID`.
 | `ndi files upload\|list\|get\|delete` | Workspace files (a directory walks nested files; `--ingest` then queues ingestion) |
 | `ndi ingest` | Queue ingestion |
 | `ndi automatic-search QUERY` | Service answers with fact search or an agent over files, tables and the catalog (`--mode fact\|agent` skips the routing step, `--path` scopes it to files); prints the route, the output job id, and the answer (plus the catalog table when there is one) |
-| `ndi deep-search QUERY` / `ndi fact-search QUERY` | Agentic / single-shot search (`--path` on `deep-search` scopes it to files); then `ndi job` on each printed `grounding_job_ids` entry |
-| `ndi filtered-search QUERY` | Corpus filter/rank/count over the metadata catalog (`--path` scopes it to files, `--cursor` pages an earlier run) |
+| `ndi filtered-search --cursor CURSOR` | Page a catalog table past its first rows. A new `filtered-search QUERY` is deprecated: use `automatic-search` |
 | `ndi je-testing QUERY` | Journal-entry testing over a ledger package (`--path` to scope it, `--reasoning-effort` for the thinking budget) |
 | `ndi ledger-understanding start\|get\|sources\|select\|selection` | Measure the ledger package, confirm sources, or read the latest report |
 | `ndi ask-file PATH QUESTION` | Cited answer over one document, image or recording |

{ndi_cli-0.25.0 → ndi_cli-0.27.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ndi-cli"
-version = "0.25.0"
+version = "0.27.0"
 description = "NDI platform CLI: document operations, jobs, workspaces, and the agent workspace tools"
 readme = "README.md"
 license = "MIT"

{ndi_cli-0.25.0 → ndi_cli-0.27.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "ndi-cli"
-version = "0.25.0"
+version = "0.27.0"
 description = "NDI platform CLI: document operations, jobs, workspaces, and the agent workspace tools"
 authors = [
     { name = "Nace AI", email = "engineering@nace.ai" }

{ndi_cli-0.25.0 → ndi_cli-0.27.0}/src/ndi_cli/__init__.py

@@ -6,4 +6,4 @@ methods. Inside an agent sandbox the workspace tools (``folder-metadata``,
 are the whole surface; outside one only ``ask-file`` is.
 """
 
-__version__ = "0.25.0"
+__version__ = "0.27.0"

{ndi_cli-0.25.0 → ndi_cli-0.27.0}/src/ndi_cli/_cli.py

@@ -214,7 +214,7 @@ def _build_parser(*, in_agent_run: bool = False) -> argparse.ArgumentParser:
     _docops.add_parsers(sub, common)
     _jobs.add_parsers(sub, common)
     _workspace.add_parsers(sub, common)
-    _systemone.add_parsers(sub, common)
+    _systemone.add_parsers(sub, default_timeout=DEFAULT_TIMEOUT_SECONDS)
     return parser
 
 

{ndi_cli-0.25.0 → ndi_cli-0.27.0}/src/ndi_cli/_output.py

@@ -49,7 +49,8 @@ def shortened(full: str, args, *, get_full: str = "rerun with --json") -> bool:
     """Whether ``full`` is too long for stdout; if so, tell stderr how to get it.
 
     A file target is never shortened — the limit protects a reader's context,
-    and ``--save`` / ``--out-dir`` asked for the whole thing. ``get_full`` names
+    and ``--save`` / ``--out-dir`` asked for the whole thing. A limit of ``0``
+    asked for the text rendering, so nothing goes to stderr. ``get_full`` names
     the command that prints it whole.
     """
     if getattr(args, "save", None) or getattr(args, "out_dir", None):
@@ -57,6 +58,8 @@ def shortened(full: str, args, *, get_full: str = "rerun with --json") -> bool:
     limit = output_limit()
     if len(full) <= limit:
         return False
+    if limit == 0:
+        return True
     print(
         f"note: output shortened — the full response is {len(full):,} chars, over the {limit:,} limit "
         f"(${OUTPUT_LIMIT_ENV}); {get_full} for all of it",

{ndi_cli-0.25.0 → ndi_cli-0.27.0}/src/ndi_cli/_systemone.py

@@ -15,15 +15,24 @@ from ndi_cli import _render
 from ndi_cli._workspace import _dump_or_text
 
 
-def add_parsers(sub: argparse._SubParsersAction, common: argparse.ArgumentParser) -> None:
+def add_parsers(sub: argparse._SubParsersAction, *, default_timeout: float) -> None:
     systemone = sub.add_parser(
         "systemone",
-        parents=[common],
         help="Answer noul, choice, and score questions about a state.",
         description=(
             "Answer typed questions about a state in one call. A VALUE is inline, @FILE reads a file, and @- reads stdin."
         ),
     )
+    systemone.add_argument(
+        "--json", action="store_true", help="Always print the full response JSON, never the shortened text rendering."
+    )
+    systemone.add_argument(
+        "--timeout",
+        type=float,
+        default=default_timeout,
+        metavar="SECONDS",
+        help=f"HTTP timeout for the call (default {default_timeout:.0f}s).",
+    )
     state = systemone.add_mutually_exclusive_group(required=True)
     state.add_argument("--state", default=None, metavar="VALUE", help="The state as text.")
     state.add_argument("--state-json", default=None, metavar="VALUE", help="The state as any JSON value.")

{ndi_cli-0.25.0 → ndi_cli-0.27.0}/src/ndi_cli/_workspace.py

@@ -117,29 +117,6 @@ def add_parsers(sub: argparse._SubParsersAction, common: argparse.ArgumentParser
     add_job_output_args(ingest)
     ingest.set_defaults(run=_run_ingest, family="workspace", needs_workspace=True, needs_client=True)
 
-    deep = sub.add_parser("deep-search", parents=[common], help="Run an agentic workspace search.")
-    deep.add_argument("query")
-    deep.add_argument("--prefix", default=None, dest="path_prefix")
-    deep.add_argument(
-        "--path",
-        action="append",
-        dest="paths",
-        default=None,
-        help="Add this file to the scope (with --prefix: the folder's files plus these); repeatable.",
-    )
-    _add_context_args(deep)
-    add_job_output_args(deep)
-    deep.set_defaults(run=_run_deep_search, family="workspace", needs_workspace=True, needs_client=True)
-
-    fact = sub.add_parser("fact-search", parents=[common], help="Run the fixed single-shot search pipeline.")
-    fact.add_argument("query")
-    fact.add_argument("--prefix", default=None, dest="path_prefix")
-    fact.add_argument("--path", action="append", dest="paths", default=None, help="Scope to this file; repeatable.")
-    fact.add_argument("--top-k", type=int, default=None)
-    _add_context_args(fact)
-    add_job_output_args(fact)
-    fact.set_defaults(run=_run_fact_search, family="workspace", needs_workspace=True, needs_client=True)
-
     # No --effort, --session-id, or --allow-clarification: the route is single-shot.
     automatic = sub.add_parser(
         "automatic-search",
@@ -161,7 +138,9 @@ def add_parsers(sub: argparse._SubParsersAction, common: argparse.ArgumentParser
     automatic.set_defaults(run=_run_automatic_search, family="workspace", needs_workspace=True, needs_client=True)
 
     filtered = sub.add_parser(
-        "filtered-search", parents=[common], help="Run a filter/rank/count query over the metadata catalog."
+        "filtered-search",
+        parents=[common],
+        help="Page a catalog table with --cursor. A new query here is deprecated: use automatic-search.",
     )
     filtered.add_argument("query", nargs="?", default=None)
     filtered.add_argument(
@@ -172,8 +151,7 @@ def add_parsers(sub: argparse._SubParsersAction, common: argparse.ArgumentParser
     _add_context_args(filtered)
     # No --result-unit: the server deprecates the grouping override and returns
     # catalog entries. No --allow-clarification: a clarification is answered by a
-    # new initial query, and a shell has nowhere to keep the thread — the reason
-    # deep-search omits --session-id.
+    # new initial query, and a shell has nowhere to keep the thread.
     add_job_output_args(filtered)
     filtered.set_defaults(run=_run_filtered_search, family="workspace", needs_workspace=True, needs_client=True)
 
@@ -189,8 +167,7 @@ def add_parsers(sub: argparse._SubParsersAction, common: argparse.ArgumentParser
         help="Add this file to the scope (with --prefix: the folder's files plus these); repeatable.",
     )
     _add_context_args(jet)
-    # No --session-id, for the reason deep-search omits it: a shell has nowhere
-    # to keep a thread. Omitting --reasoning-effort uses the service default.
+    # No --session-id: a shell has nowhere to keep a thread. Omitting --reasoning-effort uses the service default.
     add_job_output_args(jet)
     jet.set_defaults(run=_run_je_testing, family="workspace", needs_workspace=True, needs_client=True)
 
@@ -537,29 +514,6 @@ def _run_ingest(client: NdiClient, workspace_id: str, args: argparse.Namespace)
     return _finish_job(client, job, args, _render.ingestion_job, "ingest")
 
 
-def _run_deep_search(client: NdiClient, workspace_id: str, args: argparse.Namespace) -> int:
-    job = client.search.deep(
-        workspace_id,
-        query=args.query,
-        context=args.context,
-        path_prefix=args.path_prefix,
-        paths=args.paths,
-    )
-    return _finish_job(client, job, args, _render.search_job, "deep-search")
-
-
-def _run_fact_search(client: NdiClient, workspace_id: str, args: argparse.Namespace) -> int:
-    job = client.search.fact(
-        workspace_id,
-        query=args.query,
-        context=args.context,
-        path_prefix=args.path_prefix,
-        paths=args.paths,
-        top_k=args.top_k,
-    )
-    return _finish_job(client, job, args, _render.search_job, "fact-search")
-
-
 def _run_automatic_search(client: NdiClient, workspace_id: str, args: argparse.Namespace) -> int:
     job = client.search.automatic(
         workspace_id,
@@ -592,6 +546,8 @@ def _run_filtered_search(client: NdiClient, workspace_id: str, args: argparse.Na
             return 2
         job = client.search.filtered_page(workspace_id, cursor=args.cursor)
     else:
+        # On stderr, where a script's parsed stdout never sees it; the query still runs.
+        print("note: filtered-search QUERY is deprecated and will be removed; use automatic-search.", file=sys.stderr)
         job = client.search.filtered(
             workspace_id,
             query=args.query,