@uipath/model-hub-tool 1.200.0-preview.118

package/README.md

@@ -0,0 +1,195 @@
+# @uipath/model-hub-tool
+
+`uip` plugin providing read and configuration views over **UiPath Model Hub** — the
+LLM Gateway routing layer of the AI Trust Layer. It exposes organization- and
+tenant-scoped model configuration, per-region custom routing rules, routing-rule
+change history, and governance-policy previews.
+
+Command prefix: `model-hub`.
+
+> **Status: not yet published.** This package is marked `"private": true` and is
+> excluded from npm publishing. It builds and loads in the local CLI, but is not
+> installable from the registry.
+
+## Authentication
+
+All commands require an authenticated session:
+
+```bash
+uip login
+```
+
+Your account must have the **OrganizationAdmin** role for the AI Trust Layer.
+
+## Common options
+
+Every command accepts:
+
+| Option                       | Description                                                                  |
+| ---------------------------- | ---------------------------------------------------------------------------- |
+| `--tenant <name>`            | Target tenant name (defaults to the authenticated tenant).                   |
+| `--login-validity <minutes>` | Override the interactive-login token lifetime for this call.                 |
+
+The standard global CLI options (`--output <table\|json\|yaml\|plain>` and
+`--output-filter <jmespath>`) apply as well.
+
+**Allowed regions** (for `--*-region` flags): `EU`, `CA`, `US`, `SI`, `JA`, `AU`,
+`IN`, `UK`, `CH`, `UAE`, `SK`, `GLOBAL`.
+
+## Commands
+
+### `model-hub organizations get`
+
+Fetch the organization overview for the current organization — per-tenant model
+counts (total / active / custom / deprecating) and blocked-entry totals.
+
+```bash
+uip model-hub organizations get
+```
+
+**Output code:** `ModelHubOrganizationsGet`
+
+---
+
+### `model-hub tenants get`
+
+Fetch the tenant overview for the current tenant — the per-product, per-feature
+routing rules including model, managed-by, status, and BYO onboarding state.
+
+```bash
+uip model-hub tenants get
+uip model-hub tenants get --force-refresh   # bypass cached policy, re-resolve from source
+```
+
+**Options:**
+
+| Option            | Description                                                          |
+| ----------------- | ------------------------------------------------------------------- |
+| `--force-refresh` | Bypass any cached policy and re-resolve the configuration from source. |
+
+**Output code:** `ModelHubTenantsGet`
+
+---
+
+### `model-hub custom-routings get`
+
+Look up the per-region model-availability map for a `(product, feature,
+primary-model)` tuple. Use it to pick valid `--current-model` / `--current-region`
+values before running `custom-routings create`.
+
+```bash
+uip model-hub custom-routings get \
+  --product agenthub \
+  --feature llm-call \
+  --primary-model gpt-5-mini-2025-08-07 \
+  --current-model gpt-5-mini-2025-08-07
+```
+
+**Options:**
+
+| Option                          | Required | Description                                                       |
+| ------------------------------- | :------: | ---------------------------------------------------------------- |
+| `--product <name>`              |    ✓     | Model Hub product (e.g. `agenthub`, `agents`).                    |
+| `--feature <name>`              |    ✓     | Feature within the product (e.g. `llm-call`).                     |
+| `--primary-model <id>`          |    ✓     | Base rule's model whose alternatives to enumerate.               |
+| `--current-model <id>`          |    ✓     | Required by server validation; echoed back in the response.      |
+| `--primary-model-region <r>`    |          | Sent for DTO completeness; not used for the lookup.              |
+| `--current-region <r>`          |          | Sent for DTO completeness; not used for the lookup.              |
+
+**Output code:** `ModelHubCustomRoutingsGet`
+
+---
+
+### `model-hub custom-routings create`
+
+Upsert a custom routing rule for a `(product, feature, primary-model)`. If the
+requested target matches the gitops default, the existing custom rule is removed
+instead. Returns the resulting tenant overview.
+
+```bash
+uip model-hub custom-routings create \
+  --product agenthub \
+  --feature llm-call \
+  --primary-model gpt-5-mini-2025-08-07 \
+  --primary-model-region US \
+  --current-model gpt-5-mini-2025-08-07 \
+  --current-region EU
+```
+
+**Options:** (all required)
+
+| Option                       | Description                                                       |
+| ---------------------------- | ---------------------------------------------------------------- |
+| `--product <name>`           | Model Hub product (e.g. `agenthub`, `agents`).                    |
+| `--feature <name>`           | Feature within the product (e.g. `llm-call`).                     |
+| `--primary-model <id>`       | Base rule's model identifier being overridden.                   |
+| `--primary-model-region <r>` | The tenant's region (the base rule's region).                    |
+| `--current-model <id>`       | Target model to route to.                                        |
+| `--current-region <r>`       | Target region to route to.                                       |
+
+**Output code:** `ModelHubCustomRoutingsCreate`
+
+---
+
+### `model-hub routing-history list`
+
+List routing-rule change history for a `(product, feature, model)`. Shows old/new
+model + region per change, the actor (`System` or `User`), and the timestamp.
+
+```bash
+uip model-hub routing-history list \
+  --product agenthub \
+  --feature llm-call \
+  --model gpt-5.1-2025-11-13
+```
+
+**Options:**
+
+| Option              | Required | Description                                            |
+| ------------------- | :------: | ----------------------------------------------------- |
+| `--product <name>`  |    ✓     | Model Hub product (e.g. `agenthub`).                  |
+| `--feature <name>`  |    ✓     | Feature within the product (e.g. `llm-call`).         |
+| `--model <id>`      |    ✓     | Model identifier whose history to retrieve.           |
+
+> Returns the full change history for the tuple. Server-side pagination
+> (`limit` / `offset`) is not yet available.
+
+**Output code:** `ModelHubRoutingHistoryList`
+
+---
+
+### `model-hub policy-previews get`
+
+Preview the tenant Model Hub configuration that would result if a given governance
+policy were applied — same shape as `tenants get`, computed against the supplied
+policy instead of the active one.
+
+```bash
+uip model-hub policy-previews get 11111111-2222-3333-4444-555555555555
+```
+
+**Arguments:**
+
+| Argument      | Description                          |
+| ------------- | ------------------------------------ |
+| `<policy-id>` | Governance policy ID to preview.     |
+
+**Output code:** `ModelHubPolicyPreviewsGet`
+
+## Output & exit codes
+
+Success responses follow the standard CLI shape: `{ Result: "Success", Code, Data }`.
+Errors follow `{ Result: "Failure", Message, Instructions }`.
+
+| Exit code | Meaning            |
+| --------- | ------------------ |
+| `0`       | Success            |
+| `1`       | Failure or error   |
+
+## Development
+
+```bash
+bun run build   # bundle to dist/ via tools/build-tool.ts
+bun run test    # vitest
+bun run lint    # biome check
+```

package/dist/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import {
+  Command,
+  metadata,
+  registerCommands
+} from "./tool-hhr5mnwx.js";
+
+// src/index.ts
+var program = new Command;
+program.name(metadata.commandPrefix).description(metadata.description).version(metadata.version);
+await registerCommands(program);
+program.parse(process.argv);
+
+//# debugId=BD084772D1B96E7264756E2164756E21