---
name: istari-inspect
description: >
  Read-only exploration of an Istari Digital instance on SDK 13.x — list and resolve
  Resources, Systems, and Jobs, dump a System tree, trace revisions. Use for "what's
  on the instance", "what's in this system", "find the model named X", "show me the jobs".
metadata:
  sdk: istari-digital-client
  sdk-major: "13"
  sdk-range: ">=13.0,<14"
  skill-version: "13.0.0"
  verified-sdk: "13.0.1"
  verified-registry: "demo 11.1.0"
  verified-on: "2026-09-06"
---

# istari-inspect

Read-only. Clients from `istari-connect`. Return clickable web-app links with findings (`istari-links`).

```
client.systems.get(id) -> System
    .get_branch("baseline") -> Branch
        .files() -> Page[TrackedResource]   # committed tree
        .search(name=[...]) -> Page[TrackedResource]  # substring, this branch only
client.resources.get(id) -> Resource
    client.resources.revisions.list(id).items  # newest first
```

## Who am I / what's here

```python
me = admin.users.current()  # project me.email — do not dump the full record
systems = client.systems.list(size=25).items
p = client.resources.list(size=1); p.total
jobs = client.jobs.list(size=25).items
funcs = integrations.functions.list(input_extension="stl", size=50)
```

## Resolve by name

```python
client.systems.list(name="Exact system name").items          # exact
client.resources.list(name=["exact-file-name.stl"]).items    # exact, list-valued OR
branch.search(name=["gallery"]).items                        # substring, this branch
```

There is no instance-wide substring search on the facade; list a bounded page and filter in Python.

## One System

```python
s = client.systems.get(SYSTEM_ID)
for b in s.branches().items:
    print(b.tag, b.is_baseline, b.snapshot_id)
base = s.get_branch("baseline")
page = base.files()
for f in page:
    print(f.name, f.specifier_type, f.current_file_revision_id)
```

Decode folders with `folders_of` from `istari-folders`. A newer revision on a `Latest`-tracked Resource appears in the tree only after a commit (`istari-systems`).

| Signal                               | Meaning                                                      |
| ------------------------------------ | ------------------------------------------------------------ |
| `'Page' object is not subscriptable` | read `.items[0]`, or iterate                                 |
| A list took minutes                  | you iterated an unbounded `Page` — use `.items` and `.total` |