@myapihq/cli 1.2.9 → 1.3.1

package/dist/sdk-task.test.js

@@ -0,0 +1,110 @@
+// SDK-level unit tests for the task module. Verifies URL/body shape,
+// envelope-unwrapping, the list meta {shown,total_open}, the separate body
+// tier, and lease modeling against myapi-hq/internal/routes/task/.
+// Mocks global fetch — no network.
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { task } from '@myapihq/sdk';
+const API_KEY = 'myapi_test_abc';
+const ORG = '11111111-1111-4111-8111-111111111111';
+let fetchMock;
+function ok(data, status = 200) {
+    return new Response(JSON.stringify({ success: true, data, meta: {} }), {
+        status, headers: { 'content-type': 'application/json' },
+    });
+}
+function fail(code, status) {
+    return new Response(JSON.stringify({ success: false, error: { code, message: code }, meta: {} }), {
+        status, headers: { 'content-type': 'application/json' },
+    });
+}
+beforeEach(() => { fetchMock = vi.fn(); globalThis.fetch = fetchMock; });
+afterEach(() => { vi.restoreAllMocks(); });
+describe('task create / list', () => {
+    it('createTask POSTs {description} plus only the set optional fields', async () => {
+        fetchMock.mockResolvedValueOnce(ok({ id: 't1', description: 'do x', status: 'open' }, 201));
+        await task.createTask(API_KEY, ORG, {
+            description: 'do x', importance: 'high', dependsOn: ['t0'],
+            resolveOn: { event_type: 'payment.succeeded', field: 'id', value: '42' },
+        });
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(url).toContain(`/task/orgs/${ORG}/tasks`);
+        expect(init.method).toBe('POST');
+        expect(JSON.parse(init.body)).toEqual({
+            description: 'do x', importance: 'high', depends_on: ['t0'],
+            resolve_on: { event_type: 'payment.succeeded', field: 'id', value: '42' },
+        });
+    });
+    it('listTasks reads tasks + data.meta {shown, total_open}', async () => {
+        fetchMock.mockResolvedValueOnce(ok({ tasks: [{ id: 't1', description: 'a', score: 9 }], meta: { shown: 1, total_open: 12 } }));
+        const res = await task.listTasks(API_KEY, ORG);
+        expect(res.tasks).toHaveLength(1);
+        expect(res.meta).toEqual({ shown: 1, total_open: 12 });
+    });
+    it('listTasks passes filter options as query params', async () => {
+        fetchMock.mockResolvedValueOnce(ok({ tasks: [], meta: { shown: 0, total_open: 0 } }));
+        await task.listTasks(API_KEY, ORG, { status: 'open', limit: 5 });
+        const url = fetchMock.mock.calls[0][0];
+        expect(url).toContain('status=open');
+        expect(url).toContain('limit=5');
+    });
+});
+describe('task get / body tier', () => {
+    it('getTask GETs /tasks/{id} and does NOT touch the body endpoint', async () => {
+        fetchMock.mockResolvedValueOnce(ok({ id: 't1', description: 'a', status: 'open' }));
+        await task.getTask(API_KEY, ORG, 't1');
+        const url = fetchMock.mock.calls[0][0];
+        expect(url).toContain(`/task/orgs/${ORG}/tasks/t1`);
+        expect(url).not.toMatch(/\/body$/);
+    });
+    it('getTaskBody fetches the /body tier and unwraps {task_id, body}', async () => {
+        fetchMock.mockResolvedValueOnce(ok({ task_id: 't1', body: '# context' }));
+        expect(await task.getTaskBody(API_KEY, ORG, 't1')).toBe('# context');
+        expect(fetchMock.mock.calls[0][0]).toMatch(/\/tasks\/t1\/body$/);
+    });
+});
+describe('task lifecycle', () => {
+    it('claimTask POSTs {lease_seconds, worker} and returns the full task', async () => {
+        fetchMock.mockResolvedValueOnce(ok({
+            id: 't1', description: 'a', status: 'claimed',
+            lease_expires_at: '2026-05-19T10:10:00Z', claimed_by: 'agent-7',
+        }));
+        const t = await task.claimTask(API_KEY, ORG, 't1', { leaseSeconds: 600, worker: 'agent-7' });
+        expect(t.status).toBe('claimed');
+        expect(t.lease_expires_at).toBe('2026-05-19T10:10:00Z');
+        expect(t.claimed_by).toBe('agent-7');
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(url).toMatch(/\/tasks\/t1\/claim$/);
+        expect(JSON.parse(init.body)).toEqual({ lease_seconds: 600, worker: 'agent-7' });
+    });
+    it('extendTask POSTs to /extend', async () => {
+        fetchMock.mockResolvedValueOnce(ok({ id: 't1', description: 'a', status: 'claimed' }));
+        await task.extendTask(API_KEY, ORG, 't1', { leaseSeconds: 300 });
+        expect(fetchMock.mock.calls[0][0]).toMatch(/\/tasks\/t1\/extend$/);
+        expect(JSON.parse(fetchMock.mock.calls[0][1].body)).toEqual({ lease_seconds: 300 });
+    });
+    it('resolveTask POSTs to /resolve', async () => {
+        fetchMock.mockResolvedValueOnce(ok({ id: 't1', description: 'a', status: 'resolved' }));
+        await task.resolveTask(API_KEY, ORG, 't1');
+        expect(fetchMock.mock.calls[0][0]).toMatch(/\/tasks\/t1\/resolve$/);
+    });
+    it('failTask POSTs {reason} to /fail', async () => {
+        fetchMock.mockResolvedValueOnce(ok({ id: 't1', description: 'a', status: 'failed' }));
+        await task.failTask(API_KEY, ORG, 't1', 'blocked on legal');
+        expect(fetchMock.mock.calls[0][0]).toMatch(/\/tasks\/t1\/fail$/);
+        expect(JSON.parse(fetchMock.mock.calls[0][1].body)).toEqual({ reason: 'blocked on legal' });
+    });
+    it('cancelTask DELETEs the task and surfaces 404', async () => {
+        fetchMock.mockResolvedValueOnce(new Response(null, { status: 204 }));
+        await task.cancelTask(API_KEY, ORG, 't1');
+        expect(fetchMock.mock.calls[0][1].method).toBe('DELETE');
+        fetchMock.mockResolvedValueOnce(fail('task not found', 404));
+        await expect(task.cancelTask(API_KEY, ORG, 'gone')).rejects.toMatchObject({ status: 404 });
+    });
+});
+describe('task.EXPOSES', () => {
+    it('covers all 9 task endpoints', () => {
+        expect(task.EXPOSES).toHaveLength(9);
+        expect(task.EXPOSES).toContain('GET /task/orgs/{org_id}/tasks/{id}/body');
+        expect(task.EXPOSES).toContain('POST /task/orgs/{org_id}/tasks/{id}/claim');
+    });
+});

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

@@ -15,6 +15,8 @@ Handles domain registration, assignment to orgs, and edge (CDN/security) setting
 <!-- llm:start -->
 Domains are how you take a funnel from `your-org.makeautonomous.com` to `your-real-brand.com`. The flow is: check availability, register (deducts credits), assign to an org, watch status until DNS propagates. From that point, your org's funnel serves at `https://yourdomain.com`. SSL provisions automatically a few minutes after status flips to `active`.
 
+A registered domain isn't only for funnels: a **deployed container** can be served on a custom domain or subdomain too — bind it with `myapi container domain <id> <domain>` (see `my-container-api`). Funnels are static sites; containers are dynamic apps. Either way, the parent domain must be registered here first.
+
 You can also import existing domains (without re-registering) and tune CDN/security settings per-domain.
 
 Without a domain, funnels still work on the free `*.makeautonomous.com` preview subdomain.

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

@@ -21,8 +21,10 @@ Step types today:
 |---|---|---|
 | `send_email` | `email` | `from`, `to`, `subject`, plus one of `body` / `html` / `template_id` |
 | `slack_message` | `slack` | `webhook_url`, `text` |
+| `http_request` | `http` | `url` (optional: `method`, `body`, `headers`) |
+| `enqueue_job` | `enqueue` | `queue` (optional: `payload`, `dedup_key`, `delay_seconds`) — hands durable work to **my-queue-api** |
 
-Both step types support **payload templating** with `{{ payload.fieldname }}`. The webhook payload is the entire POST body; named fields are accessed dotted. Whitespace inside braces is fine — both `{{ payload.email }}` and `{{payload.email}}` work.
+All step types support **payload templating** with `{{ payload.fieldname }}`. The webhook payload is the entire POST body; named fields are accessed dotted. Whitespace inside braces is fine — both `{{ payload.email }}` and `{{payload.email}}` work.
 
 Unknown step types are rejected at create time, so typos surface immediately rather than after 3 failed retries during execution.
 
@@ -95,4 +97,11 @@ myapi workflow enable <id>
 - Disable to stop firing without losing the configuration.
 - Deleting a workflow purges its run history; the webhook endpoint remains.
 
+## See also
+
+`workflow` is one of three orchestration slots. Use **workflow** to react to
+inbound webhooks; use **my-queue-api** for durable retried machine work; use
+**my-task-api** for work that needs an agent/human decision. Full comparison:
+`docs/orchestration-decision-guide.md`.
+
 Run `myapi workflow --help` for full flag reference.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@myapihq/cli",
   "license": "Apache-2.0",
-  "version": "1.2.9",
+  "version": "1.3.1",
   "description": "MyAPI command-line interface",
   "type": "module",
   "files": [
@@ -29,7 +29,7 @@
     "lint:changelog": "node ../../scripts/lint-changelog.js"
   },
   "dependencies": {
-    "@myapihq/sdk": "^1.2.9"
+    "@myapihq/sdk": "^1.3.1"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",