ndi-cli 0.4.0__py3-none-any.whl

ndi_cli-0.4.0.dist-info/METADATA

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: ndi-cli
+Version: 0.4.0
+Summary: NDI platform CLI: document operations, jobs, workspaces, and the agent workspace tools
+Keywords: ndi,cli,document-intelligence,coding-agents
+Author: Nace AI
+Author-email: Nace AI <engineering@nace.ai>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Dist: ndi-sdk>=0.20,<1
+Requires-Python: >=3.11, <3.14
+Project-URL: Homepage, https://ndi-api.nace.ai
+Description-Content-Type: text/markdown
+
+# ndi-cli
+
+`ndi` — the NDI platform CLI. Document operations, jobs, and workspace
+lifecycle wrap the same `/v1` methods as `ndi-sdk`. The six workspace tools
+also run inside an agent sandbox; every other verb is refused there.
+
+## Setup
+
+```bash
+ndi login                                          # browser device-code; writes ~/.ndi/config.toml
+export NDI_BASE_URL="https://ndi-api.nace.ai"      # optional; default shown
+export NDI_WORKSPACE_ID="<workspace uuid>"         # or: ndi workspace use <id>
+```
+
+`$NDI_API_KEY` still wins over the file. `$NDI_CONFIG_PATH` overrides the
+config location. Workspace-scoped verbs also take `--workspace ID`.
+
+## Commands
+
+| Command | Use |
+|---|---|
+| `ndi login` | Authorize and save the API key |
+| `ndi version` | CLI + SDK versions |
+| `ndi upload FILE` | Stage bytes; prints `ndi://upload/<id>` |
+| `ndi parse SOURCE` | Markdown / text / blocks |
+| `ndi extract SOURCE -s SCHEMA` | Structured extract (`--validate` checks a schema with no job) |
+| `ndi split SOURCE --class id:label` | Logical sections |
+| `ndi classify SOURCE --class id:label` | Labels (refuses `jobid://`) |
+| `ndi ground SOURCE --target id=TEXT` | Locate quoted text |
+| `ndi job ID` / `ndi jobs` / `ndi cancel ID` | Inspect or cancel jobs |
+| `ndi workspace create\|list\|get\|stats\|delete\|use` | Workspace lifecycle |
+| `ndi files upload\|list\|get\|delete` | Workspace files (`--ingest` uploads then queues ingestion) |
+| `ndi ingest` | Queue ingestion |
+| `ndi deep-search QUERY` / `ndi fact-search QUERY` | Agentic / single-shot search |
+| `ndi folder-metadata` / `file-metadata` / `read-file` / `ask-file` / `run-sql` / `hybrid-search` | Read-only workspace tools (the sandbox surface) |
+
+## Sources
+
+`SOURCE` for document ops:
+
+- local file — uploaded, then the handle is used
+- directory — supported files, one job each (`-j N`, default 4)
+- `https://...` — fetched by the server
+- `ndi://upload/<uuid>` — a prior `ndi upload`
+- `jobid://<uuid>` or a bare UUID — reuse a parse job (not classify)
+- `ws://<file_id>` — a workspace file (needs a workspace)
+- `-` — a `jobid://` / UUID line, or raw bytes with `--file-name`
+
+```bash
+ndi parse a.pdf -o id | ndi extract - -s schema.json
+```
+
+## Output
+
+Result content goes to **stdout**; status (`job <id> queued`, `saved …`) goes
+to **stderr**. `-o auto|md|json|payload|id` picks the shape. `--json` is an
+alias for `-o json`. `--save PATH` / `--out-dir DIR` write files. `--async`
+submits and prints the job id.
+
+API failures exit 1. Usage / config errors exit 2. Schema-validation
+failures also show up to five field constraints, each limited to 500
+characters; request input and unrelated error-detail fields are omitted.
+
+See `SKILL.md` for the agent-facing guide to the six workspace tools.

ndi_cli-0.4.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+ndi_cli/__init__.py,sha256=3fUtOInjlpCfL-f6-dSfUFA2IM4cxL1X5nHbTrEPXxk,307
+ndi_cli/_cli.py,sha256=qiL3uXjbCUCwquZ98qc7008Y3rl-xfX4RzDvkvIr-BM,6923
+ndi_cli/_config.py,sha256=DsbbgWQvUmclrohr0_wbdrH20nMcnY-_NxA-GiYqfCQ,3460
+ndi_cli/_docops.py,sha256=YPJVNUEa1-hxZ_jvbg2bGwW38BBeTpqjeSOqh7uz3fc,17742
+ndi_cli/_jobs.py,sha256=n1vd8pe3SK5uVfEkU6xoFbW2W-kzDcUA5djl3BfyJVo,4369
+ndi_cli/_local.py,sha256=4AXIKpR88h738guv62LJsS8QICuk_fgq5Np1oSwsYM4,4750
+ndi_cli/_login.py,sha256=hbCTD8O1PZ9WQvhnyikt4QXC2jhXzG2rqveFlprIUuc,1505
+ndi_cli/_output.py,sha256=_lyarz87jN4AFro-WNAHy9huLcbbnqHsT9KSDM64l-o,4581
+ndi_cli/_render.py,sha256=PMLUm6qCi8otrYNzlFLEVYROySqNE5inWIuDJSODlLU,30417
+ndi_cli/_sources.py,sha256=erxG7Ddne66T_4JzjhKqYVheatTOoae0nyzzg_04Puo,5450
+ndi_cli/_tools.py,sha256=UzH7dOO4MKuaoRamXzOECDwn2O7CQNcNmWjLZcm-MIM,9802
+ndi_cli/_workspace.py,sha256=sniLlJoYlyPLdCq9EMxgXiijrFvFJ9MaT-3FpFVHknw,10707
+ndi_cli/commands.py,sha256=Cnon_kvyt8UMPLa1RwJtT0iBqJrF498CjgUjKIHmlfg,754
+ndi_cli-0.4.0.dist-info/licenses/LICENSE,sha256=G9_ltpdqkmEvYqlN_39GUzHEJCjkrApP6bWKI7d3rcs,1064
+ndi_cli-0.4.0.dist-info/WHEEL,sha256=Hw8zGdV8JFU8a1SvxUgkEWcCqmicFybt1k02k8X8S2M,81
+ndi_cli-0.4.0.dist-info/entry_points.txt,sha256=m_aG5Vw5ZCer5sFp2y2rZ2PFMwafsfKff5Ft48rzZnU,43
+ndi_cli-0.4.0.dist-info/METADATA,sha256=GxsXx3WwfEV4aKnbxvdQA0OT0c0eeyh5h3Cd4q-ypRE,3636
+ndi_cli-0.4.0.dist-info/RECORD,,

ndi_cli-0.4.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.12.14
+Root-Is-Purelib: true
+Tag: py3-none-any

ndi_cli-0.4.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+ndi = ndi_cli._cli:main
+

ndi_cli-0.4.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nace AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.