# AGPK SDK

**Purpose:** Help vendors and AgentNet teams build **agent-first** packages for AgentOS X.  
**Runtime install** remains on AgentOS X (`agentx agpk …`).  
**Rule:** every marketable package needs a command face + usage guide; install must register commands; agents use `list-commands` / `invoke` (C1–C4).

## A. Official vendor kit (recommended, no Rust)

| | |
|---|---|
| package_id | `org.agentnet.agpk.sdk` |
| Version | **1.2.0** (command face + `driver.kind` + process `entry` for invoke) |
| Download | [AGPK-MARKET agpk-sdk-v1.2.0](https://github.com/AIAGENTNETLLC/AGPK-MARKET/releases/tag/agpk-sdk-v1.2.0) |
| Catalog | `GET https://api.agentnet.ink/share/v1/agpk/sources` |

```bash
# after install or unpack release tarball
./bin/agpk-scaffold ./my-pkg com.you.app "My App"
# expand agent-commands.json: ids + driver.kind + entry argv (process)
# edit payload/ + INSTALL for agent discovery
./bin/agpk-validate ./my-pkg   # must VALIDATE_OK
./bin/agpk-pack ./my-pkg
# upload → POST register market API
```

### After install on AgentOS X (agents)

```bash
agentx agpk list-options --query you
agentx agpk install com.you.app --approve -y   # unsigned: -y ack
agentx agpk list-commands --package-id com.you.app
agentx agpk invoke <command_id> [--args '{}']
```

Same as agent tools: **`agpk.list_commands`**, **`agpk.invoke`**.

| Step | Meaning |
|---|---|
| list_commands | First-class discovery of installed package command faces (no ISO rebake) |
| invoke | First-class use: process/script `entry`, or chrome engine family via `agentx_chrome_tools` |
| Human review | `projection.*` — not a GUI primary path |

## B. CLI on AgentOS X

```bash
agentx agpk scaffold ./my-pkg --id vendor.app --name "My App"
agentx agpk pack ./my-pkg
agentx agpk validate ./my-pkg
agentx agpk install <id|path> --approve [-y]
agentx agpk list-commands [--package-id ID]
agentx agpk invoke <command_id> [--args '{}']
```

## Machine-readable standards

- [`/agpk/v1/schema.json`](/agpk/v1/schema.json)
- [`/agpk/v1/catalog.schema.json`](/agpk/v1/catalog.schema.json)
- [`/agpk/v1/builder-standard.md`](/agpk/v1/builder-standard.md)
- [`/agpk/v1/sdk.md`](/agpk/v1/sdk.md)

## Official market packages (AgentNet · complete list)

| package_id | Version | Role |
|---|---|---|
| `org.chromium.Chromium.runtime` | 1.2.0 | Engine + chrome.*/browser.* command surface |
| `org.agentnet.agpk.sdk` | 1.2.0 | This vendor toolkit |
| `org.actualbudget.Actual.agent` | 1.1.0 | Actual Budget agent commands |
| `org.bookstack.BookStack.agent` | 1.1.0 | BookStack wiki agent commands |
| `org.docuseal.DocuSeal.agent` | 1.1.0 | DocuSeal agent commands |
| `org.crater.Crater.agent` | 1.1.0 | Crater invoice agent commands |
| `org.nextcloud.Nextcloud.agent` | 1.1.0 | Nextcloud WebDAV agent commands |
| `org.jitsi.JitsiMeet.agent` | 1.1.0 | Jitsi room agent commands |
| `org.audacityteam.Audacity.agent` | 1.1.0 | Audacity-domain export commands |
| `org.kde.Kdenlive.agent` | 1.1.0 | Kdenlive-domain render commands |

**Office suite and IM are system preinstall products — not AGPK market packages.**  
Authoritative machine index: [`/agpk/v1/firstparty-catalog.json`](/agpk/v1/firstparty-catalog.json). Live discovery: `GET https://api.agentnet.ink/share/v1/agpk/sources`.