@myapihq/cli 2.4.0 → 2.4.2

package/dist/skills/my-queue-api/README.md

@@ -0,0 +1,34 @@
+---
+# my-queue-api
+
+A durable job queue. Enqueue work and have it delivered to your HTTP consumer with retry/backoff, a concurrency cap, and a dependency DAG — no broker to run.
+
+## What it does
+
+- Named queues, each bound to an HTTP `consumer_url`
+- Jobs retried with backoff up to `max_attempts`, then dead-lettered
+- `max_concurrency` cap on in-flight jobs
+- Idempotent enqueue via `dedup_key`
+- Delayed jobs (`delay_seconds`) and a dependency DAG (`depends_on`)
+
+## Quickstart
+
+```bash
+myapi queue create thumbnails --consumer-url https://your-handler.example.com
+myapi queue enqueue thumbnails --payload '{"asset_id":"a_123"}' --dedup-key a_123
+myapi queue jobs thumbnails
+```
+
+## Authentication
+
+```bash
+export MYAPI_KEY=mak_...
+```
+
+Requires `api_key` + `org_id` from **myapihq**.
+
+## Documentation
+
+Full command reference and the queue/workflow/task decision guide: see `SKILL.md`.
+
+Run `myapi queue --help` for inline reference.

package/dist/skills/my-queue-api/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: my-queue-api
+version: 1.0.0
+description: >
+  Durable job queue — enqueue work and have it retried against your HTTP consumer, with concurrency caps and a dependency DAG.
+triggers: [queue, job queue, background job, enqueue, retry, async work, dead letter, delayed job, concurrency]
+checksum: sha256-528a48bc9adcde7c48ad7208db7796ec37032f6df31bf5a2ca1f2bf63f643fe9
+---
+
+# MyQueueAPI
+
+A queue is a named, durable pipeline of jobs. Each queue has an HTTP `consumer_url`; every job is POSTed there, and a 2xx response succeeds the job. Failed jobs retry with backoff up to `max_attempts`, then dead-letter.
+
+## Capabilities
+<!-- llm:start -->
+`queue` is the **durable async machine work** layer. Use it when work must run reliably, eventually — not inline with the request that triggered it.
+
+A queue is created with:
+
+| Field | Meaning |
+|---|---|
+| `consumer_url` | HTTP(S) endpoint each job payload is POSTed to. A 2xx succeeds the job. |
+| `max_attempts` | Retries before a job dead-letters (default 5). |
+| `max_concurrency` | Max jobs dispatched at once (default 5). |
+
+A job carries an arbitrary JSON `payload` (≤256 KB). Jobs support:
+
+- `dedup_key` — idempotency: a repeated key returns the existing job.
+- `delay_seconds` — hold the job before it becomes eligible.
+- `depends_on` — job ids this job waits on. Immutable — a DAG by construction. A job with unsucceeded `depends_on` starts blocked.
+
+**queue vs workflow vs task** — see `docs/orchestration-decision-guide.md`. Short version: `workflow` reacts to inbound webhooks inline; `queue` runs durable retried machine work; `task` is for work that needs an agent/human decision.
+<!-- llm:end -->
+
+## Commands
+<!-- generated:start -->
+| Command | What it does |
+|---|---|
+| `myapi queue create <name> --consumer-url <url> [--max-attempts <n>] [--max-concurrency <n>]` | Create a queue |
+| `myapi queue list` | List queues in your org |
+| `myapi queue get <name>` | Show a queue's retry/concurrency policy |
+| `myapi queue enqueue <name> --payload <json> [--dedup-key <k>] [--delay <s>] [--depends-on <id,id>]` | Enqueue a job |
+| `myapi queue jobs <name> [--status <s>] [--limit <n>]` | List a queue's jobs |
+| `myapi queue job <job_id>` | Show a single job's status |
+<!-- generated:end -->
+
+## Examples
+<!-- llm:start -->
+```bash
+# 1. Create a queue whose jobs POST to your handler
+myapi queue create thumbnails \
+  --consumer-url https://fn.myapi.com/<org>/<fn_id> \
+  --max-attempts 5 --max-concurrency 10
+
+# 2. Enqueue work — idempotent on --dedup-key
+myapi queue enqueue thumbnails \
+  --payload '{"asset_id":"a_123","size":256}' \
+  --dedup-key a_123-256
+
+# 3. A job that waits on others (DAG)
+J1=$(myapi queue enqueue build --payload '{"step":1}' --json | jq -r .id)
+myapi queue enqueue build --payload '{"step":2}' --depends-on $J1
+
+# 4. Inspect
+myapi queue jobs thumbnails --status dead
+myapi queue job <job_id>
+```
+<!-- llm:end -->
+
+## Notes
+
+- A 2xx from the `consumer_url` succeeds the job; anything else counts as a failed attempt.
+- After `max_attempts` a job goes to `status: dead` (the dead-letter state) — it is not retried further.
+- Job status values: `pending`, `blocked`, `running`, `succeeded`, `dead`.
+- `depends_on` is immutable: the DAG is declared at enqueue time.
+- `payload` is capped at 256 KB.
+
+Run `myapi queue --help` for the full flag reference.

package/dist/skills/my-queue-api/claude/.claude-plugin/plugin.json

@@ -0,0 +1,7 @@
+{
+  "name": "my-queue-api",
+  "description": "Durable job queue — enqueue work and have it retried against your HTTP consumer, with concurrency caps and a dependency DAG.",
+  "version": "1.0.0",
+  "status": "preview",
+  "published": true
+}

package/dist/skills/my-storage-api/SKILL.md

@@ -4,7 +4,7 @@ version: 1.0.0
 description: >
   Edge-hosted asset storage. Upload local files (.png/.jpg/.gif/.webp) directly, or have the server fetch from a public URL. Each asset gets a stable public CDN URL.
 triggers: [storage, upload, ingest, asset, cdn, image hosting, file upload, get-url, download, public url]
-checksum: sha256-pending
+checksum: sha256-80f78e83d086ec5e312abbb2fc7c85a2c9a87043a94b7e4fccc13902d5455df1
 ---
 
 # MyStorageAPI

package/dist/skills/my-storage-api/claude/.claude-plugin/plugin.json

@@ -2,5 +2,6 @@
   "name": "my-storage-api",
   "description": "Edge-hosted asset storage. Upload local files or ingest from URLs, each gets a stable public CDN URL.",
   "version": "1.0.0",
+  "status": "ga",
   "published": true
 }

package/dist/skills/my-task-api/README.md

@@ -0,0 +1,36 @@
+---
+# my-task-api
+
+An agent-task queue. File units of work, rank them by score, claim one under a lease, then resolve or fail it — the substrate for an autonomous agent loop.
+
+## What it does
+
+- File tasks with a short triage `description` and a full Markdown `body` tier
+- Ranked `list` — the agent-loop hot path, with a backlog signal
+- Lease-based `claim` / `extend` — crash-safe, auto-reverts on expiry
+- Terminal `resolve` / `fail` / `cancel`, with dependency cascade
+- `depends_on` DAG, `dedup_key` idempotency, `assignee` magic-link email
+- `resolve_on` — auto-resolve when a matching platform event fires
+
+## Quickstart
+
+```bash
+myapi task create "Review the vendor contract" --body @notes.md --importance high
+myapi task list
+myapi task get <id> --body
+myapi task claim <id> && myapi task resolve <id>
+```
+
+## Authentication
+
+```bash
+export MYAPI_KEY=mak_...
+```
+
+Requires `api_key` + `org_id` from **myapihq**.
+
+## Documentation
+
+Full command reference, the agent loop, and the workflow/queue/task decision guide: see `SKILL.md`.
+
+Run `myapi task --help` for inline reference.

package/dist/skills/my-task-api/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: my-task-api
+version: 1.0.0
+description: >
+  Agent-task queue — file units of work, rank them, claim under a lease, then resolve, fail, or cancel. The agent-loop hot path.
+triggers: [task, task queue, agent loop, work queue, claim task, resolve task, lease, backlog, to-do, assignee]
+checksum: sha256-ead9513eafbdd4d384a3cb297facf934f786f7067028c75cc08ef2ba1ac61cf7
+---
+
+# MyTaskAPI
+
+A task is a unit of work that needs an agent or human to act on it. Tasks are ranked by score; a worker claims one under a time-limited lease, does the work, then resolves or fails it. This is distinct from `my-workflow-api` (event→action automation) and `my-queue-api` (durable machine jobs).
+
+## Capabilities
+<!-- llm:start -->
+`task` is the **"this needs a decision"** layer — the agent-loop hot path.
+
+The loop is: **`list` → `get <id> --body` → `claim` → `resolve`/`fail`**.
+
+- `list` returns the top open tasks ranked by score, projected to `{id, description, score}`, plus a backlog signal — `Showing N of M open task(s)`. It is deliberately small; do not expect the full task.
+- `get <id>` returns the full task object. It does **not** fetch the Markdown body.
+- `get <id> --body` additionally fetches the **body tier** — the full Markdown context. Read it once, when you commit to a task.
+- `claim <id>` takes an atomic lease (default 10 min). Lease expiry auto-reverts the task to open, so a crashed worker never strands a task. Heartbeat long work with `extend`.
+- `resolve <id>` is terminal and unblocks dependents. `fail <id> --reason` is terminal and does not auto-retry. `cancel <id>` is terminal, distinct from fail.
+
+Task fields at creation: `description` (~100-token triage key), `body` (full Markdown), `importance`, `due`, `assignee` (emails them a magic link), `tags`, `depends_on` (immutable DAG — a task with unresolved deps starts blocked), `dedup_key` (idempotent), `resolve_on` (an event matcher — a matching platform event auto-resolves the task), `source`.
+
+**task vs workflow vs queue** — see `docs/orchestration-decision-guide.md`.
+<!-- llm:end -->
+
+## Commands
+<!-- generated:start -->
+| Command | What it does |
+|---|---|
+| `myapi task create "<description>" [--body <md\|@file>] [--importance <i>] [--due <rfc3339>] [--assignee <email>] [--tag <t,t>] [--depends-on <id,id>] [--resolve-on <event[:field=value]>]` | File a task |
+| `myapi task list [--status <s>] [--tag <t>] [--importance <i>] [--limit <n>]` | Top open tasks, ranked |
+| `myapi task get <id> [--body]` | Show a task; `--body` also fetches the body tier |
+| `myapi task claim <id> [--lease <s>] [--worker <name>]` | Take an atomic lease |
+| `myapi task extend <id> [--lease <s>]` | Heartbeat a live claim |
+| `myapi task resolve <id>` | Resolve a task (terminal) |
+| `myapi task fail <id> --reason "<why>"` | Fail a task (terminal) |
+| `myapi task cancel <id>` | Cancel a task (terminal) |
+<!-- generated:end -->
+
+## Examples
+<!-- llm:start -->
+```bash
+# File a task with full Markdown context from a file
+myapi task create "Review the Q3 vendor contract" \
+  --body @contract-notes.md --importance high --due 2026-06-01
+
+# The agent loop
+myapi task list                          # ranked; pick the top id
+myapi task get <id> --body               # read the body, once, on commit
+myapi task claim <id> --worker agent-7   # lease it
+# ... do the work, heartbeat if long ...
+myapi task extend <id>
+myapi task resolve <id>                  # or: myapi task fail <id> --reason "blocked on legal"
+
+# Event-driven: auto-resolve when a matching platform event fires
+myapi task create "Ship once payment clears" \
+  --resolve-on payment.succeeded:order_id=o_42
+```
+<!-- llm:end -->
+
+## Notes
+
+- `list` is the hot path — it returns a small ranked projection plus `total_open`, not full tasks.
+- The body tier is fetched only with `get --body`. Read it once, on commit, to keep the loop token-cheap.
+- A claim is a lease: it expires (default 10 min) and auto-reverts the task to open. Heartbeat with `extend`.
+- `resolve` unblocks dependents; `fail` cascades to dependents that can never proceed.
+- `resolve_on` matches platform events. Today few event kinds are emitted in production — verify the kind exists before relying on it.
+
+Run `myapi task --help` for the full flag reference.

package/dist/skills/my-task-api/claude/.claude-plugin/plugin.json

@@ -0,0 +1,7 @@
+{
+  "name": "my-task-api",
+  "description": "Agent-task queue — file units of work, rank them, claim under a lease, then resolve, fail, or cancel. The agent-loop hot path.",
+  "version": "1.0.0",
+  "status": "preview",
+  "published": true
+}

package/dist/skills/my-url-to/README.md

@@ -0,0 +1,32 @@
+# my-url-to
+
+Stateful URL shortening and routing via myurlto.com. Shorten long URLs, track link activity, and give users compact shareable links.
+
+## What it does
+
+- Shorten any URL to a `myurlto.com` link
+- Track clicks and link activity
+- Manage and list links by organization
+
+## Quickstart
+
+```bash
+# Shorten a URL
+curl -sS -X POST https://myurlto.com/url/shorten \
+  -H "Authorization: Bearer $MYAPI_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"org_id": "<org_id>", "url": "https://example.com/very/long/path"}'
+```
+
+## Authentication
+
+```
+Authorization: Bearer <api_key>
+```
+
+Requires `org_id` from `my-api-hq`.
+
+## Links
+
+- [Full skill documentation (SKILL.md)](./SKILL.md)
+- [MyUrlTo](https://myurlto.com)

package/dist/skills/my-url-to/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: my-url-to
+version: 1.0.0
+description: >
+  Stateful URL shortening service. Generate compact `myurlto.com` redirect links to long URLs. Often invoked implicitly by other backend services for outbound links.
+triggers: [shorten url, short link, url shortener, myurlto, redirect, short_code]
+checksum: sha256-2b83a7774da020adc3e61e411ff63b7ced7d9f160d22eb0a9291b701ad0fcf73
+---
+
+# MyURLToAPI
+
+URL shortening: compact redirect URLs under `myurlto.com`.
+
+## Capabilities
+<!-- llm:start -->
+Generates a short redirect URL for any long target. The short link 302-redirects to the original. Stateful — short codes are stable until explicitly deleted server-side.
+
+Note: agents don't always need to call this explicitly. Internal MyAPI services (e.g. payment checkout flows) automatically shorten certain links before returning them. Only call `myapi url shorten` when a user or workflow specifically asks for a short link, or when generating a URL that will be displayed to users in a constrained surface (SMS, QR codes, etc.).
+<!-- llm:end -->
+
+## Commands
+<!-- generated:start -->
+| Command | What it does |
+|---|---|
+| `myapi url shorten <url>` | Generate a short redirect URL for a long target |
+
+The redirect itself is public:
+
+```
+GET /{domain}/{code}
+→ 302 Location: <original URL>
+```
+
+No auth required to follow the redirect. Errors: `404` for unknown code or code longer than 16 chars.
+<!-- generated:end -->
+
+## Examples
+<!-- llm:start -->
+```bash
+# Shorten
+myapi url shorten "https://example.com/very/long/path?parameters=true"
+# → { "short_code": "8f2a1b9c", "short_url": "https://myurlto.com/example.com/8f2a1b9c" }
+
+# Use the short URL anywhere (resolves at the apex — NOT api.myurlto.com)
+curl -L "https://myurlto.com/example.com/8f2a1b9c"
+```
+<!-- llm:end -->
+
+## Notes
+
+- The domain segment of the short URL is extracted from the target URL's root domain.
+- Short codes are stable — once minted, they don't change.
+- Required: a non-empty `url`. `400` if missing.
+
+Run `myapi url --help` for flag reference.

package/dist/skills/my-url-to/claude/.claude-plugin/plugin.json

@@ -0,0 +1,7 @@
+{
+  "name": "my-url-to",
+  "description": "Stateless link routing and URL shortening for the MyAPI ecosystem.",
+  "version": "1.0.0",
+  "status": "preview",
+  "published": true
+}

package/dist/skills/my-webhook-api/SKILL.md

@@ -4,7 +4,7 @@ version: 1.0.0
 description: >
   Inbound webhook endpoints for non-funnel sources — Stripe, GitHub, custom services. Funnel forms use the my-funnel-api proxy.
 triggers: [webhook, inbound, receiver, stripe events, github webhook, slack notification, delivery, payload, event ingest]
-checksum: sha256-pending
+checksum: sha256-13680a0decdbb5b49d9d80b52203eb68a43450f94477936252b54dfd2b3845bc
 ---
 
 # MyWebhookAPI

package/dist/skills/my-webhook-api/claude/.claude-plugin/plugin.json

@@ -2,5 +2,6 @@
   "name": "my-webhook-api",
   "description": "Receive inbound HTTP webhooks. Per-org endpoints with full delivery history.",
   "version": "1.0.0",
+  "status": "ga",
   "published": true
 }

package/dist/skills/my-workflow-api/SKILL.md

@@ -4,7 +4,7 @@ version: 1.0.0
 description: >
   Run actions when a webhook fires. Trigger emails, Slack notifications, or HTTP calls in response to inbound webhook deliveries — without writing a backend.
 triggers: [workflow, automation, on webhook, send email on, slack notification, payload templating, drip, trigger, run]
-checksum: sha256-pending
+checksum: sha256-eddc70a8542c3cdfd01866f241ea283164e71fbe748426a13358d1c7ef635cb1
 ---
 
 # MyWorkflowAPI

package/dist/skills/my-workflow-api/claude/.claude-plugin/plugin.json

@@ -2,5 +2,6 @@
   "name": "my-workflow-api",
   "description": "React to inbound webhooks with step chains: send email, post to Slack, call HTTP URLs.",
   "version": "1.0.0",
+  "status": "ga",
   "published": true
 }

package/package.json

@@ -1,8 +1,13 @@
 {
   "name": "@myapihq/cli",
   "license": "Apache-2.0",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "description": "MyAPI command-line interface",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/myapihq/myapi.git",
+    "directory": "packages/cli"
+  },
   "type": "module",
   "files": [
     "dist"
@@ -28,11 +33,12 @@
     "update-schema": "node scripts/update-schema.js",
     "lint:changelog": "node ../../scripts/lint-changelog.js",
     "lint:help-order": "node scripts/lint-help-order.js",
+    "lint:exposes": "node scripts/lint-exposes.js",
     "lint:skills": "node scripts/copy-skills.js && node scripts/lint-skills.js",
     "lint:skills:strict": "node scripts/copy-skills.js && node scripts/lint-skills.js --strict"
   },
   "dependencies": {
-    "@myapihq/sdk": "^2.4.0"
+    "@myapihq/sdk": "^2.4.2"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",