jaz-clio 5.20.21 → 5.20.22
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -6
- package/assets/skills/api/SKILL.md +1 -1
- package/assets/skills/api/references/bank-rule-column-mapping.md +8 -2
- package/assets/skills/cli/SKILL.md +3 -3
- package/assets/skills/conversion/SKILL.md +1 -1
- package/assets/skills/jaz-pseudo-sql/SKILL.md +1 -1
- package/assets/skills/jobs/SKILL.md +1 -1
- package/assets/skills/transaction-recipes/SKILL.md +1 -1
- package/assets/templates/platform-rules/jaz-agent-rules.md +1 -1
- package/cli.mjs +540 -540
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -3,11 +3,11 @@
|
|
|
3
3
|
<p align="center">
|
|
4
4
|
<a href="https://www.npmjs.com/package/jaz-clio"><img src="https://img.shields.io/npm/v/jaz-clio?style=for-the-badge&logo=npm" alt="npm"></a>
|
|
5
5
|
<a href="https://www.npmjs.com/package/jaz-clio"><img src="https://img.shields.io/npm/dm/jaz-clio?style=for-the-badge&label=downloads" alt="npm downloads"></a>
|
|
6
|
-
<img src="https://img.shields.io/badge/tools-
|
|
6
|
+
<img src="https://img.shields.io/badge/tools-305-blue?style=for-the-badge" alt="305 tools">
|
|
7
7
|
<a href="https://github.com/teamtinvio/jaz-ai/blob/main/LICENSE"><img src="https://img.shields.io/github/license/teamtinvio/jaz-ai?style=for-the-badge&color=green" alt="License"></a>
|
|
8
8
|
</p>
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
305 tools. 59 command groups. 13 calculators. 12 job playbooks. 158 API rules. 16 IFRS recipes.
|
|
11
11
|
|
|
12
12
|
```bash
|
|
13
13
|
npm install -g jaz-clio
|
|
@@ -18,8 +18,8 @@ Requires **Node.js 18+** ([nodejs.org](https://nodejs.org)). Also fully compatib
|
|
|
18
18
|
## Contents
|
|
19
19
|
|
|
20
20
|
- [Three Ways In](#three-ways-in) · CLI, MCP, Skills
|
|
21
|
-
- [CLI](#cli) ·
|
|
22
|
-
- [MCP Server](#mcp-server) ·
|
|
21
|
+
- [CLI](#cli) · 59 command groups
|
|
22
|
+
- [MCP Server](#mcp-server) · 305 tools for AI agents
|
|
23
23
|
- [Skills](#skills) · Teach any AI the Jaz API
|
|
24
24
|
- [Setup](#setup) · Auth, multi-org, automation
|
|
25
25
|
- [Semantic help-center search](#help-center-semantic-search-optional) · Optional OpenAI-backed retrieval
|
|
@@ -47,13 +47,13 @@ clio invoices search --query 'status:unpaid AND $500+' # Structured per-entity
|
|
|
47
47
|
clio invoices search --query 'status:unpaid' --view lean # Compact summary rows (id + key fields), then drill in with get
|
|
48
48
|
```
|
|
49
49
|
|
|
50
|
-
|
|
50
|
+
59 command groups. 16 report types. 13 calculators. 12 job playbooks. Every command supports `--json`. Run `clio --help` for the full list.
|
|
51
51
|
|
|
52
52
|
---
|
|
53
53
|
|
|
54
54
|
## MCP Server
|
|
55
55
|
|
|
56
|
-
|
|
56
|
+
305 tools, available to any AI agent that speaks MCP. Runs locally: no cloud, no ports.
|
|
57
57
|
|
|
58
58
|
> **No install at all?** Claude.ai, ChatGPT, Cowork, and Microsoft Copilot Studio can use Jaz via the **hosted connector**: add `https://mcp.jaz.ai/mcp` as a custom connector (Claude/ChatGPT) or MCP tool (Copilot Studio) and sign in (OAuth, no key). The local setup below is for terminal use, scripting, and editors that run MCP servers as local processes.
|
|
59
59
|
|
|
@@ -1,6 +1,12 @@
|
|
|
1
1
|
# Bank-rule column-value mapping (reconcileWithDirectCashEntry)
|
|
2
2
|
|
|
3
|
-
A bank rule's `reconcileWithDirectCashEntry` shortcut can resolve fields **per row** from a custom bank-statement column instead of hard-coding them. This is the "Set X by" capability: read a column, match its value, and resolve to a target (GL account, tax profile, classifier, contact, or tag).
|
|
3
|
+
A bank rule's `reconcileWithDirectCashEntry` shortcut can resolve fields **per row** from a custom bank-statement column instead of hard-coding them. This is the "Set X by" capability: read a column, match its value, and resolve to a target (GL account, tax profile, nano-classifier, contact, or tag).
|
|
4
|
+
|
|
5
|
+
## Background: Bank Fields
|
|
6
|
+
|
|
7
|
+
The columns referenced by `columnKey` are **Bank Fields** — typed custom columns (`DATE` / `STRING` / `AMOUNT`) defined per bank account and captured when a statement is imported. They make any statement column (branch code, bank charge, cost centre, settlement ref) first-class: usable in a rule's **conditions** (matching) and in its **outputs** (the maps below). `AMOUNT` fields keep their sign; `amountSourceColumnKey` uses the **absolute** value.
|
|
8
|
+
|
|
9
|
+
Scope note: the maps here are the rule **outputs** (what `create_bank_rule` / `update_bank_rule` set via `configuration`). The rule **conditions** (which statement lines the rule matches, including by Bank Field) are held in a linked search shortcut (`relatedSearchShortcutResourceIds`) configured in the product, not by these tools.
|
|
4
10
|
|
|
5
11
|
## ColumnValueMapConfig shape
|
|
6
12
|
|
|
@@ -33,7 +39,7 @@ Inside `configuration.reconcileWithDirectCashEntry`:
|
|
|
33
39
|
- `amountSourceColumnKey` — "Set amount by": take the line's amount from the **absolute value** of a custom AMOUNT column. **Mutually exclusive with `amount`** — omit `amount` when this is set (sending both is rejected).
|
|
34
40
|
- `organizationAccountResourceIdMap` — "Set Account by" (in lieu of a static `organizationAccountResourceId`).
|
|
35
41
|
- `taxProfileResourceIdMap` — "Set Tax by".
|
|
36
|
-
- `classifierConfigMap` — "Set Classifier by" (target = classifier class UUID).
|
|
42
|
+
- `classifierConfigMap` — "Set Classifier by" (target = nano-classifier / classifier class UUID; see `list_nano_classifiers`).
|
|
37
43
|
|
|
38
44
|
## Reference-string column tokens
|
|
39
45
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: jaz-cli
|
|
3
|
-
version: 5.20.
|
|
3
|
+
version: 5.20.22
|
|
4
4
|
description: >-
|
|
5
5
|
Use this skill when running Clio CLI commands, building shell scripts with
|
|
6
6
|
Clio, debugging auth issues, understanding --json output, paginating results,
|
|
@@ -8,7 +8,7 @@ description: >-
|
|
|
8
8
|
command groups, auth precedence, output formats, entity resolution, and common
|
|
9
9
|
workflow patterns. Also use when the user asks how to use clio, what commands
|
|
10
10
|
are available, or how to automate accounting tasks from the command line.
|
|
11
|
-
Covers all
|
|
11
|
+
Covers all 59 command groups and 305 tools.
|
|
12
12
|
license: MIT
|
|
13
13
|
compatibility: Requires Node.js >= 18.0.0. Install via npm install -g jaz-clio.
|
|
14
14
|
---
|
|
@@ -17,7 +17,7 @@ compatibility: Requires Node.js >= 18.0.0. Install via npm install -g jaz-clio.
|
|
|
17
17
|
|
|
18
18
|
> **Audience note:** for power users and CI/automation. Load this skill only when you're scripting from a terminal, building shell pipelines, or debugging from `clio --json` output. For day-to-day accounting inside Claude Desktop / Cowork, the MCP tools cover the common flows without dropping to the CLI.
|
|
19
19
|
|
|
20
|
-
You are working with **Clio** (`jaz-clio`) — the CLI for the Jaz accounting platform.
|
|
20
|
+
You are working with **Clio** (`jaz-clio`) — the CLI for the Jaz accounting platform. 59 command groups, 13 calculators, 12 job blueprints, 305 tools. Also fully compatible with Juan Accounting (same API, same endpoints).
|
|
21
21
|
|
|
22
22
|
## When to Use This Skill
|
|
23
23
|
|
|
@@ -6,7 +6,7 @@ Source of truth lives in the installed skills (`.claude/skills/jaz-*/SKILL.md` o
|
|
|
6
6
|
|
|
7
7
|
## Discovery
|
|
8
8
|
|
|
9
|
-
The Jaz MCP server exposes
|
|
9
|
+
The Jaz MCP server exposes 305 tools across 36 namespaces via 3 meta-tools. **Use the meta-tool flow — never enumerate tools blindly.**
|
|
10
10
|
|
|
11
11
|
1. `search_tools(query)` → top-N tool names + namespaces.
|
|
12
12
|
2. `describe_tools(names)` → full parameter schemas.
|