@pax8-cta/core 0.1.0 → 0.1.1
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 +58 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# @pax8-cta/core
|
|
2
|
+
|
|
3
|
+
Core logic for [Pax8 Cross-Tenant Agents (Pax8 CTA)](https://github.com/pax8labs/pax8-cta) — the multi-tenant Copilot Studio deployment toolkit for MSPs.
|
|
4
|
+
|
|
5
|
+
This package contains the shared building blocks used by the [`pax8-cta`](https://www.npmjs.com/package/pax8-cta) CLI: GDAP-delegated authentication, Dataverse / Power Platform clients, solution import/export, deployment orchestration, risk analysis, and drift detection.
|
|
6
|
+
|
|
7
|
+
## When to install this directly
|
|
8
|
+
|
|
9
|
+
If you're a CLI user, **install [`pax8-cta`](https://www.npmjs.com/package/pax8-cta) instead** — it depends on this package and bundles the command surface you actually want:
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npm install -g pax8-cta
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Install `@pax8-cta/core` directly only if you're:
|
|
16
|
+
|
|
17
|
+
- Embedding deployment logic into your own tooling (custom dashboards, scheduled jobs, internal automation)
|
|
18
|
+
- Building an alternative front-end (web UI, MCP server, Slack bot) on top of the same primitives
|
|
19
|
+
- Writing tests or fixtures that need access to the mock clients and demo data
|
|
20
|
+
|
|
21
|
+
## Installation
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
npm install @pax8-cta/core
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Requires Node `>=20.12.0`.
|
|
28
|
+
|
|
29
|
+
## Usage
|
|
30
|
+
|
|
31
|
+
```ts
|
|
32
|
+
import { Client } from "@pax8-cta/core";
|
|
33
|
+
|
|
34
|
+
const client = new Client({
|
|
35
|
+
partnerTenantId: process.env.PARTNER_TENANT_ID!,
|
|
36
|
+
partnerClientId: process.env.PARTNER_CLIENT_ID!,
|
|
37
|
+
partnerClientSecret: process.env.PARTNER_CLIENT_SECRET!,
|
|
38
|
+
});
|
|
39
|
+
|
|
40
|
+
// List GDAP-delegated customer tenants
|
|
41
|
+
const tenants = await client.listTenants();
|
|
42
|
+
|
|
43
|
+
// Deploy a solution across tenants
|
|
44
|
+
await client.deploySolution({
|
|
45
|
+
solutionZip: "./CustomerServiceAgent_managed.zip",
|
|
46
|
+
tenantIds: tenants.map((t) => t.id),
|
|
47
|
+
});
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
See the [main repository](https://github.com/pax8labs/pax8-cta) for full documentation, GDAP setup instructions, and the CLI command reference.
|
|
51
|
+
|
|
52
|
+
## Stability
|
|
53
|
+
|
|
54
|
+
This package is published primarily as an implementation detail of the `pax8-cta` CLI. While we try to keep the surface stable, the public API may change between minor versions before v1.0. Pin exact versions if you depend on it directly.
|
|
55
|
+
|
|
56
|
+
## License
|
|
57
|
+
|
|
58
|
+
Apache-2.0 — see [LICENSE](https://github.com/pax8labs/pax8-cta/blob/main/LICENSE).
|