ndi-cli 0.12.0__tar.gz → 0.13.0__tar.gz

{ndi_cli-0.12.0 → ndi_cli-0.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ndi-cli
-Version: 0.12.0
+Version: 0.13.0
 Summary: NDI platform CLI: document operations, jobs, workspaces, and the agent workspace tools
 Keywords: ndi,cli,document-intelligence,coding-agents
 Author: Nace AI
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
-Requires-Dist: ndi-sdk>=0.27,<1
+Requires-Dist: ndi-sdk>=0.28,<1
 Requires-Dist: truststore>=0.10.4,<1
 Requires-Python: >=3.11
 Project-URL: Homepage, https://ndi-api.nace.ai
@@ -53,6 +53,7 @@ config location. Workspace-scoped verbs also take `--workspace ID`.
 | `ndi ground SOURCE --target id=TEXT` | Locate quoted text (standalone quotes only; after search, poll `grounding_job_ids`) |
 | `ndi job ID` / `ndi jobs` / `ndi cancel ID` | Inspect or cancel jobs |
 | `ndi workspace create\|list\|get\|stats\|delete\|use` | Workspace lifecycle |
+| `ndi workspace global-context [--set TEXT\|--file PATH\|--clear]` | Show, replace, or remove (`--clear`) the background every query without `--context` runs with; `--no-context` on a query runs with none |
 | `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; prints the route, the output job id, and the answer (plus the catalog table when there is one) |

{ndi_cli-0.12.0 → ndi_cli-0.13.0}/README.md

@@ -29,6 +29,7 @@ config location. Workspace-scoped verbs also take `--workspace ID`.
 | `ndi ground SOURCE --target id=TEXT` | Locate quoted text (standalone quotes only; after search, poll `grounding_job_ids`) |
 | `ndi job ID` / `ndi jobs` / `ndi cancel ID` | Inspect or cancel jobs |
 | `ndi workspace create\|list\|get\|stats\|delete\|use` | Workspace lifecycle |
+| `ndi workspace global-context [--set TEXT\|--file PATH\|--clear]` | Show, replace, or remove (`--clear`) the background every query without `--context` runs with; `--no-context` on a query runs with none |
 | `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; prints the route, the output job id, and the answer (plus the catalog table when there is one) |

{ndi_cli-0.12.0 → ndi_cli-0.13.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ndi-cli"
-version = "0.12.0"
+version = "0.13.0"
 description = "NDI platform CLI: document operations, jobs, workspaces, and the agent workspace tools"
 readme = "README.md"
 license = "MIT"
@@ -24,7 +24,7 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
-    "ndi-sdk>=0.27,<1",
+    "ndi-sdk>=0.28,<1",
     "truststore>=0.10.4,<1",
 ]
 

{ndi_cli-0.12.0 → ndi_cli-0.13.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "ndi-cli"
-version = "0.12.0"
+version = "0.13.0"
 description = "NDI platform CLI: document operations, jobs, workspaces, and the agent workspace tools"
 authors = [
     { name = "Nace AI", email = "engineering@nace.ai" }
@@ -27,7 +27,7 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
-    "ndi-sdk>=0.27,<1",
+    "ndi-sdk>=0.28,<1",
     "truststore>=0.10.4,<1",
 ]
 

{ndi_cli-0.12.0 → ndi_cli-0.13.0}/src/ndi_cli/__init__.py

@@ -6,4 +6,4 @@ methods. The six workspace tools (``folder-metadata``, ``file-metadata``,
 in-sandbox surface.
 """
 
-__version__ = "0.12.0"
+__version__ = "0.13.0"

{ndi_cli-0.12.0 → ndi_cli-0.13.0}/src/ndi_cli/_render.py

@@ -14,6 +14,7 @@ import uuid
 
 import html
 import re
+import textwrap
 from typing import Literal
 
 from ndi_sdk.models.common import Coverage, Evidence, File
@@ -809,6 +810,12 @@ def workspace(item: Workspace) -> str:
     return f"{item.workspace_id}  {item.name}  {item.domain_slug}@{item.domain_version}  {item.status}{purpose}"
 
 
+def workspace_detail(item: Workspace) -> str:
+    if not item.global_context:
+        return workspace(item)
+    return f"{workspace(item)}\nglobal context:\n{textwrap.indent(item.global_context, '  ')}"
+
+
 def workspace_page(page) -> str:
     lines = [f"workspaces ({page.total_count}):"]
     lines.extend(f"  {workspace(item)}" for item in page.items)

{ndi_cli-0.12.0 → ndi_cli-0.13.0}/src/ndi_cli/_workspace.py

@@ -24,6 +24,8 @@ from ndi_cli._sources import collect_workspace_uploads, folder_upload_prefix, wo
 DEFAULT_UPLOAD_PARALLEL = 8
 INGEST_FILE_ID_BATCH = 1000
 _SKIP_WARNING_LIST_CAP = 20
+_CONTEXT_HELP = "Background for this run, replacing the workspace's global context. Omit to use the global context."
+_NO_CONTEXT_HELP = "Run with no context at all, not even the workspace's global context."
 
 
 def add_parsers(sub: argparse._SubParsersAction, common: argparse.ArgumentParser) -> None:
@@ -43,6 +45,19 @@ def add_parsers(sub: argparse._SubParsersAction, common: argparse.ArgumentParser
     get.add_argument("workspace_id", nargs="?", default=None)
     get.set_defaults(run=_run_ws_get, family="workspace", needs_workspace=False, needs_client=True)
 
+    global_context = ws.add_parser(
+        "global-context",
+        parents=[common],
+        help="Show, replace (--set/--file) or remove (--clear) the workspace's global context: the background every "
+        "query without --context runs with.",
+    )
+    global_context.add_argument("workspace_id", nargs="?", default=None)
+    replace = global_context.add_mutually_exclusive_group()
+    replace.add_argument("--set", default=None, dest="text", help="Replace the global context with this text.")
+    replace.add_argument("--file", default=None, type=Path, help="Replace the global context with this file's text.")
+    replace.add_argument("--clear", action="store_true", help="Remove the global context from the workspace.")
+    global_context.set_defaults(run=_run_ws_global_context, family="workspace", needs_workspace=False, needs_client=True)
+
     stats = ws.add_parser("stats", parents=[common], help="Content summary for a workspace.")
     stats.add_argument("workspace_id", nargs="?", default=None)
     stats.set_defaults(run=_run_ws_stats, family="workspace", needs_workspace=False, needs_client=True)
@@ -104,7 +119,7 @@ def add_parsers(sub: argparse._SubParsersAction, common: argparse.ArgumentParser
     deep.add_argument("query")
     deep.add_argument("--effort", choices=("low", "medium", "high"), default=None)
     deep.add_argument("--prefix", default=None, dest="path_prefix")
-    deep.add_argument("--context", default=None)
+    _add_context_args(deep)
     add_job_output_args(deep)
     deep.set_defaults(run=_run_deep_search, family="workspace", needs_workspace=True, needs_client=True)
 
@@ -112,7 +127,7 @@ def add_parsers(sub: argparse._SubParsersAction, common: argparse.ArgumentParser
     fact.add_argument("query")
     fact.add_argument("--prefix", default=None, dest="path_prefix")
     fact.add_argument("--top-k", type=int, default=None)
-    fact.add_argument("--context", 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)
 
@@ -126,7 +141,7 @@ def add_parsers(sub: argparse._SubParsersAction, common: argparse.ArgumentParser
     automatic.add_argument("query")
     automatic.add_argument("--prefix", default=None, dest="path_prefix")
     automatic.add_argument("--top-k", type=int, default=None, help="Cap the citation list when the fact pipeline answers.")
-    automatic.add_argument("--context", default=None)
+    _add_context_args(automatic)
     add_job_output_args(automatic)
     automatic.set_defaults(run=_run_automatic_search, family="workspace", needs_workspace=True, needs_client=True)
 
@@ -138,7 +153,7 @@ def add_parsers(sub: argparse._SubParsersAction, common: argparse.ArgumentParser
         "--cursor", default=None, help="Page an earlier run: paste its result's next_cursor. A page is a new job."
     )
     filtered.add_argument("--prefix", default=None, dest="path_prefix")
-    filtered.add_argument("--context", default=None)
+    _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
@@ -151,7 +166,7 @@ def add_parsers(sub: argparse._SubParsersAction, common: argparse.ArgumentParser
     jet.add_argument("--reasoning-effort", choices=("none", "minimal", "low", "medium", "high"), default=None)
     jet.add_argument("--prefix", default=None, dest="path_prefix")
     jet.add_argument("--path", action="append", dest="paths", default=None, help="Scope to this file; repeatable.")
-    jet.add_argument("--context", default=None)
+    _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.
     add_job_output_args(jet)
@@ -205,6 +220,13 @@ def add_parsers(sub: argparse._SubParsersAction, common: argparse.ArgumentParser
     lu_selection.set_defaults(run=_run_ledger_selection, family="workspace", needs_workspace=True, needs_client=True)
 
 
+def _add_context_args(parser: argparse.ArgumentParser) -> None:
+    context = parser.add_mutually_exclusive_group()
+    context.add_argument("--context", default=None, help=_CONTEXT_HELP)
+    # The server reads an empty context as "none" and an omitted one as "use the global context".
+    context.add_argument("--no-context", action="store_const", const="", dest="context", help=_NO_CONTEXT_HELP)
+
+
 def _workspace_id(args: argparse.Namespace, fallback: str) -> str:
     value = getattr(args, "workspace_id", None) or args.workspace or fallback
     if not value:
@@ -235,7 +257,20 @@ def _run_ws_list(client: NdiClient, workspace_id: str, args: argparse.Namespace)
 
 def _run_ws_get(client: NdiClient, workspace_id: str, args: argparse.Namespace) -> int:
     workspace = client.workspaces.get(_workspace_id(args, workspace_id))
-    return _dump_or_text(workspace, args, text=_render.workspace(workspace), stem="workspace")
+    return _dump_or_text(workspace, args, text=_render.workspace_detail(workspace), stem="workspace")
+
+
+def _run_ws_global_context(client: NdiClient, workspace_id: str, args: argparse.Namespace) -> int:
+    target = _workspace_id(args, workspace_id)
+    if args.clear:
+        workspace = client.workspaces.update(target, global_context="")
+    elif args.file is not None:
+        workspace = client.workspaces.update(target, global_context=args.file.read_text(encoding="utf-8"))
+    elif args.text is not None:
+        workspace = client.workspaces.update(target, global_context=args.text)
+    else:
+        workspace = client.workspaces.get(target)
+    return _dump_or_text(workspace, args, text=workspace.global_context or "(no global context)", stem="workspace")
 
 
 def _run_ws_stats(client: NdiClient, workspace_id: str, args: argparse.Namespace) -> int:
@@ -521,8 +556,8 @@ def _run_filtered_search(client: NdiClient, workspace_id: str, args: argparse.Na
         # A page re-executes the parent's own stored query, so the scoping flags
         # cannot apply to it. Accepting and dropping them would quietly answer a
         # different question than the one typed.
-        if args.path_prefix or args.context:
-            print("error: --prefix and --context belong to the initial query, not a page", file=sys.stderr)
+        if args.path_prefix or args.context is not None:
+            print("error: --prefix, --context and --no-context belong to the initial query, not a page", file=sys.stderr)
             return 2
         job = client.search.filtered_page(workspace_id, cursor=args.cursor)
     else: