@myapihq/sdk 2.4.0 → 2.4.2

package/src/services.ts

@@ -1,323 +0,0 @@
-// Canonical service registry — the single source of truth for everything
-// downstream (skill plugin.json generators, mirror-repo publisher, docs site,
-// scaffolders, etc.).
-//
-// To add a service: append an entry here. To rename, change description, or
-// re-categorize: edit here. Run `npm run canonical-sync` to propagate to
-// every rendered artifact (plugin.json files today; npm/PyPI metadata,
-// GitHub repo descriptions, docs site landing pages tomorrow).
-//
-// CI enforces no drift: `services-sync.test.ts` runs `canonical-sync
-// --check` and fails on any difference.
-//
-// Skill names MUST match the directory names under skills/<name>/ and the
-// repo names we want to claim on GitHub/npm. Don't paraphrase.
-
-export type ServiceStatus = 'ga' | 'preview' | 'planned';
-
-export type ServiceCategory =
-  | 'send'      // outbound: email, funnel, url, image-render
-  | 'capture'   // inbound: webhook, pixel
-  | 'data'      // read/filter the data layer: people, company, audience, crm
-  | 'store'     // persist bytes/JSON: storage, database
-  | 'compute'   // run code or inference: llm, fn
-  | 'orchestrate' // control flow: workflow, queue, task
-  | 'identity'  // auth/billing/account: hq
-  | 'infra';    // platform glue: domain
-
-export interface ServiceMeta {
-  /** SDK namespace (also OpenAPI tag and CLI top-level command). */
-  module: string;
-  /** Skill name — used for: GitHub repo name, npm package name, plugin.json `name`, README headings. */
-  skill: string;
-  /** Brand domain we own (or want to own). Used for canonical links + npm/GitHub homepage. */
-  domain: string;
-  /** One-line description — used verbatim in npm description, GitHub repo description, plugin.json. */
-  description: string;
-  category: ServiceCategory;
-  status: ServiceStatus;
-  /** npm keywords + GitHub topics + PyPI classifiers. The first five are shared boilerplate. */
-  keywords: string[];
-}
-
-const SHARED_KEYWORDS = ['mcp', 'claude-skill', 'ai-agent', 'cli', 'myapi'] as const;
-const k = (...extra: string[]): string[] => [...SHARED_KEYWORDS, ...extra];
-
-export const SERVICES: readonly ServiceMeta[] = [
-  // ── identity / infra ────────────────────────────────────────────────
-  {
-    module: 'hq',
-    skill: 'my-api-hq',
-    domain: 'myapihq.com',
-    description: 'Core identity and billing hub. Manage auth, organizations, and billing.',
-    category: 'identity',
-    status: 'ga',
-    keywords: k('auth', 'identity', 'billing', 'organization'),
-  },
-  {
-    module: 'auth',
-    skill: 'my-auth-api',
-    domain: 'myauthapi.com',
-    description: 'Managed OIDC identity provider for the end users of apps built on MyAPI. Per-org auth tenant + OIDC clients, RS256/JWKS, hosted login, managed Google sign-in. A Kinde alternative.',
-    category: 'identity',
-    status: 'ga',
-    keywords: k('auth', 'oidc', 'oauth', 'login', 'identity', 'sso'),
-  },
-  {
-    module: 'domain',
-    skill: 'my-domain-api',
-    domain: 'mydomainapi.com',
-    description: 'Domain registration and check with automated DNS and email infrastructure.',
-    category: 'infra',
-    status: 'ga',
-    keywords: k('domain', 'dns', 'registration'),
-  },
-
-  // ── send ────────────────────────────────────────────────────────────
-  {
-    // Customer-facing email surface — mailboxes, transactional send,
-    // templates, warmup. Launched 2026-05-17: the backend lifted the pre-launch gate
-    // (the [disabled, pre-launch] / 503 SERVICE_NOT_LAUNCHED state is gone).
-    // Sibling `my-email-verify-api` is the sync single-address verifier.
-    module: 'email',
-    skill: 'my-email-api',
-    domain: 'myemailapi.com',
-    description: 'Send transactional and bulk email from your own domain. Mailboxes, AI templates, and warmup.',
-    category: 'send',
-    status: 'ga',
-    keywords: k('email', 'transactional', 'smtp', 'mailbox'),
-  },
-  {
-    module: 'email',
-    skill: 'my-email-verify-api',
-    domain: 'myemailapi.com',
-    description: 'Sync single-address email verification — syntax + DNS + Microsoft probe. Pre-send quality gate for outbound.',
-    category: 'send',
-    status: 'ga',
-    keywords: k('email', 'verification', 'deliverability', 'syntax', 'dns'),
-  },
-  {
-    module: 'funnel',
-    skill: 'my-funnel-api',
-    domain: 'myfunnelapi.com',
-    description: 'Build multi-page sites and funnels with headless HTML upload.',
-    category: 'send',
-    status: 'ga',
-    keywords: k('funnel', 'landing-page', 'website', 'static-site'),
-  },
-  {
-    module: 'url',
-    skill: 'my-url-to',
-    domain: 'myurlto.com',
-    description: 'Stateless link routing and URL shortening for the MyAPI ecosystem.',
-    category: 'send',
-    status: 'preview',
-    keywords: k('url', 'shortener', 'redirect', 'link'),
-  },
-  {
-    module: 'image',
-    skill: 'my-image-api',
-    domain: 'myimageapi.com',
-    description: 'Generate AI images from a text prompt. Async, polls until ready, returns a public CDN URL.',
-    category: 'compute',
-    status: 'ga',
-    keywords: k('image', 'ai-image', 'gemini', 'text-to-image'),
-  },
-
-  // ── capture ─────────────────────────────────────────────────────────
-  {
-    module: 'webhook',
-    skill: 'my-webhook-api',
-    domain: 'mywebhookapi.com',
-    description: 'Receive inbound HTTP webhooks. Per-org endpoints with full delivery history.',
-    category: 'capture',
-    status: 'ga',
-    keywords: k('webhook', 'inbound', 'event'),
-  },
-  {
-    module: 'pixel',
-    skill: 'my-pixel-api',
-    domain: 'mypixelapi.com',
-    description: 'Tracking pixel + identity resolution. Capture visits, events, and stitch known users to anonymous sessions.',
-    category: 'capture',
-    // Ingestion pipeline live in prod; CLI (visits/events/interactions/
-    // identity/audience) + skill shipped. Not ga: preview-subdomain ownership
-    // gap (TODO.md Gap 4) blocks the primary funnel flow.
-    status: 'preview',
-    keywords: k('pixel', 'analytics', 'tracking', 'visit', 'identity'),
-  },
-
-  // ── data ────────────────────────────────────────────────────────────
-  {
-    // Goldfox-backed people search is gated pre-launch — 503 SERVICE_NOT_LAUNCHED.
-    // Internal Goldfox lookups still work (`crm contacts promote` resolves a
-    // goldfox_person_id server-side), but the agent-facing search/get path
-    // is hidden until backend lifts the gate.
-    module: 'people',
-    skill: 'my-people-api',
-    domain: 'mypeopleapi.com',
-    description: 'Contact database backed by the Goldfox crawl. Filter people by confidence tier, seniority, email type, country, link confidence, plus rich behavioral company signals (has_c_level, has_careers_page, has_decision_maker). The targeting layer for outbound campaigns.',
-    category: 'data',
-    status: 'preview',
-    keywords: k('people', 'contact', 'b2b', 'targeting', 'goldfox'),
-  },
-  {
-    // Goldfox-backed company search gated pre-launch (same reason as people).
-    module: 'company',
-    skill: 'my-company-api',
-    domain: 'mycompanyapi.com',
-    description: 'Company database backed by the Goldfox crawl. Filter companies by confidence tier, country/TLD consistency, behavioral page signals (has_careers_page, has_investors_page, has_shop_page, has_c_level, has_decision_maker), legal-entity status, headcount, and source-URL count.',
-    category: 'data',
-    status: 'preview',
-    keywords: k('company', 'firmographics', 'b2b', 'goldfox'),
-  },
-  {
-    // Saved audiences sit on top of people/company — gated together with them.
-    module: 'audience',
-    skill: 'my-audience-api',
-    domain: 'myaudienceapi.com',
-    description: 'Saved audiences = named filter snapshots over people/company database. Reuse across campaigns; refresh re-evaluates against current data.',
-    category: 'data',
-    status: 'preview',
-    keywords: k('audience', 'segment', 'filter'),
-  },
-  {
-    module: 'crm',
-    skill: 'my-crm-api',
-    // Brand domain — mycrmapi.com was unavailable; mypipelineapi.com chosen
-    // and acquired. (Skill stays my-crm-api — domain/skill mismatch accepted.)
-    domain: 'mypipelineapi.com',
-    description: 'The canonical store of engaged people + companies. Auto-ingest from inbound webhooks (configurable dot-path). Fixed lifecycle_stage enum, soft delete, event timeline.',
-    category: 'data',
-    status: 'ga',
-    keywords: k('crm', 'contact', 'pipeline', 'engagement'),
-  },
-
-  // ── store ───────────────────────────────────────────────────────────
-  {
-    module: 'storage',
-    skill: 'my-storage-api',
-    domain: 'mystorageapi.com',
-    description: 'Edge-hosted asset storage. Upload local files or ingest from URLs, each gets a stable public CDN URL.',
-    category: 'store',
-    status: 'ga',
-    keywords: k('storage', 'cdn', 'asset', 'upload'),
-  },
-  {
-    module: 'database',
-    skill: 'my-database-api',
-    domain: 'mydatabaseapi.com',
-    description: 'Per-org KV store with namespaces + compare-and-swap. JSON values up to 256 KB. The substrate for stateful agent-built apps.',
-    category: 'store',
-    status: 'ga',
-    keywords: k('kv-store', 'database', 'state'),
-  },
-
-  // ── compute ─────────────────────────────────────────────────────────
-  {
-    module: 'llm',
-    skill: 'my-llm-api',
-    domain: 'myllmapi.com',
-    description: 'Self-hosted open-source LLM: raw chat completions (you pick the model) + objective verbs (classify/extract/summarize/draft). Billed in cents per 1M tokens from your balance. Use in workflow steps, not for your own reasoning.',
-    category: 'compute',
-    status: 'ga',
-    keywords: k('llm', 'completion', 'qwen', 'classify'),
-  },
-  {
-    // CLI top-level command is `fn`; SDK namespace is `fn`; skill directory is
-    // `my-function-api` (the agent-discoverable brand name).
-    //
-    // Backend status: deploy/env/runs shipped (CF Workers bundle upload,
-    // invocation URL, Worker Secrets, run history). /logs still pending —
-    // 'preview' reflects "usable, not yet stable GA."
-    module: 'fn',
-    skill: 'my-function-api',
-    domain: 'myfunctionapi.com',
-    description: 'Run JavaScript functions on the edge. HTTP or cron triggers. Pre-injected MYAPI SDK scoped to the org — no auth tokens in user code.',
-    category: 'compute',
-    status: 'preview',
-    keywords: k('function', 'serverless', 'edge', 'cloudflare-workers', 'http-handler', 'cron'),
-  },
-  {
-    // CLI top-level command + SDK namespace are both `payments`; skill
-    // directory is `my-payments-api`.
-    //
-    // Backend status: T0 (BYO Stripe) shipped — connect, charges (Checkout
-    // Sessions), refunds, per-org webhook. T1 (Connect Express) is deferred
-    // (connect returns 501 T1_DEFERRED). 'preview' reflects "T0 usable, T1
-    // pending."
-    module: 'payments',
-    skill: 'my-payments-api',
-    domain: 'mypaymentsapi.com',
-    description: 'Take payments with Stripe Checkout. Connect your Stripe account, create one-off or recurring charges, and refund — hosted checkout, no card handling.',
-    category: 'compute',
-    status: 'preview',
-    keywords: k('payments', 'stripe', 'checkout', 'billing', 'subscription'),
-  },
-  {
-    // CLI top-level command + SDK namespace are both `container`; skill
-    // directory is `my-container-api`.
-    //
-    // Backend status: Phase 1 shipped (metadata + scoped API key). The
-    // Cloud Run build/deploy pipeline is Phase 2 — deploy returns
-    // RUNTIME_UNAVAILABLE until it lands. 'preview' reflects "usable
-    // surface, deploy not yet GA."
-    module: 'container',
-    skill: 'my-container-api',
-    domain: 'mycontainerapi.com',
-    description: 'Run containers on demand — long-running services, background workers, and scheduled jobs. The heavier-duty sibling of edge functions, for native deps and long execution.',
-    category: 'compute',
-    status: 'preview',
-    keywords: k('container', 'cloud-run', 'service', 'worker', 'job'),
-  },
-  {
-    // CLI top-level command + SDK namespace are both `git`; skill directory
-    // is `my-git-api`. A stateless git-over-HTTP surface (go-git engine;
-    // objects in GCS, refs in Postgres) — repos, commits, branches, history.
-    module: 'git',
-    skill: 'my-git-api',
-    domain: 'mygitapi.com',
-    description: 'Hosted git repositories over HTTP — create repos, commit files, manage branches and tags, read trees, blobs, history, and diffs. No local clone required.',
-    category: 'store',
-    status: 'ga',
-    keywords: k('git', 'repository', 'version-control', 'commit', 'scm'),
-  },
-
-  // ── orchestrate ─────────────────────────────────────────────────────
-  // Control flow, not actions. workflow = event→action, queue = durable
-  // async machine work, task = work that needs an agent/human decision.
-  // See docs/orchestration-decision-guide.md.
-  {
-    module: 'workflow',
-    skill: 'my-workflow-api',
-    domain: 'myworkflowapi.com',
-    description: 'React to inbound webhooks with step chains: send email, post to Slack, call HTTP URLs.',
-    category: 'orchestrate',
-    status: 'ga',
-    keywords: k('workflow', 'automation', 'orchestration'),
-  },
-  {
-    // CLI top-level command + SDK namespace are both `queue`; skill
-    // directory is `my-queue-api`. A durable HTTP-consumer job queue —
-    // retry/backoff, concurrency caps, dependency DAG.
-    module: 'queue',
-    skill: 'my-queue-api',
-    domain: 'myqueueapi.com',
-    description: 'Durable job queue — enqueue work and have it retried against your HTTP consumer, with concurrency caps and a dependency DAG.',
-    category: 'orchestrate',
-    status: 'preview',
-    keywords: k('queue', 'job-queue', 'background-jobs', 'retry', 'async'),
-  },
-  {
-    // CLI top-level command + SDK namespace are both `task`; skill
-    // directory is `my-task-api`. The agent-task queue — the agent-loop
-    // hot path: file, claim under a lease, resolve.
-    module: 'task',
-    skill: 'my-task-api',
-    domain: 'mytaskapi.com',
-    description: 'Agent-task queue — file units of work, rank them, claim under a lease, then resolve, fail, or cancel. The agent-loop hot path.',
-    category: 'orchestrate',
-    status: 'preview',
-    keywords: k('task', 'task-queue', 'agent-loop', 'work-queue', 'lease'),
-  },
-] as const;

package/src/storage.ts

@@ -1,80 +0,0 @@
-import { request, MyApiError } from './client';
-import { ApiResponse } from './types';
-import { STORAGE_BASE as BASE_URL } from './config';
-import type { Exposes } from './exposes';
-
-export const EXPOSES: Exposes = [
-  'POST /storage/orgs/{org_id}/assets/ingest',
-  'POST /storage/orgs/{org_id}/assets/upload',
-  'GET /storage/orgs/{org_id}/assets',
-  'DELETE /storage/orgs/{org_id}/assets/{asset_id}',
-];
-
-
-
-export interface Asset { asset_id: string; url: string; name: string; created_at: string }
-
-export async function ingestAsset(apiKey: string, orgId: string, url: string, name?: string): Promise<Asset> {
-  return request('POST', `${BASE_URL}/storage/orgs/${encodeURIComponent(orgId)}/assets/ingest`, apiKey, { url, name });
-}
-
-// Content types accepted by uploadAsset. Mirrors the backend's
-// detectAsset() allowlist (routes/org/org.go). Images go up to a few MB;
-// videos cap at 200 MB. PDFs/SVGs and other types still need to go through
-// `ingestAsset` (URL fetch) — they're not in the upload allowlist yet.
-export type UploadContentType =
-  | 'image/jpeg'
-  | 'image/png'
-  | 'image/gif'
-  | 'image/webp'
-  | 'image/svg+xml'
-  | 'application/pdf'
-  | 'video/mp4'
-  | 'video/webm';
-
-export async function uploadAsset(apiKey: string, orgId: string, file: Blob | Buffer, contentType: UploadContentType, name?: string): Promise<Asset> {
-  const headers: Record<string, string> = {
-    'Authorization': `Bearer ${apiKey}`
-  };
-  
-  const formData = new FormData();
-  formData.append('file', new Blob([file as any], { type: contentType }));
-  if (name) {
-    formData.append('name', name);
-  }
-
-  const response = await fetch(`${BASE_URL}/storage/orgs/${encodeURIComponent(orgId)}/assets/upload`, {
-    method: 'POST',
-    headers,
-    body: formData as any
-  });
-  
-  let result: any;
-  try {
-    result = await response.json();
-  } catch {
-    throw new MyApiError('invalid_json_response', response.status);
-  }
-
-  // Mirror client.ts error handling: the backend's modern error shape is an
-  // object {code, message, ...}. The old string-only handling here made
-  // err.code an object, so e.g. funds.isInsufficientFunds could never match
-  // a 402 on a billable upload.
-  if (!response.ok || !(result as ApiResponse<Asset>).success) {
-    const err = result?.error;
-    const code = typeof err === 'object' && err !== null ? (err?.code || 'unknown_error') : (err || 'unknown_error');
-    const detail = typeof err === 'object' && err !== null ? (err?.message || undefined) : undefined;
-    const errBody = typeof err === 'object' && err !== null ? err : undefined;
-    throw new MyApiError(code, response.status, detail, errBody);
-  }
-
-  return (result as ApiResponse<Asset>).data as Asset;
-}
-
-export async function listAssets(apiKey: string, orgId: string): Promise<Asset[]> {
-  return request('GET', `${BASE_URL}/storage/orgs/${encodeURIComponent(orgId)}/assets`, apiKey);
-}
-
-export async function deleteAsset(apiKey: string, orgId: string, assetId: string): Promise<void> {
-  return request('DELETE', `${BASE_URL}/storage/orgs/${encodeURIComponent(orgId)}/assets/${encodeURIComponent(assetId)}`, apiKey);
-}

package/src/task.ts

@@ -1,198 +0,0 @@
-import { request } from './client';
-import { TASK_BASE as BASE_URL } from './config';
-import type { Exposes } from './exposes';
-
-// Backend: my-task-api per myapi-hq/internal/routes/task/. An agent-task
-// queue — the agent-loop hot path. Tasks are created, ranked by score,
-// claimed under a lease, then resolved/failed/cancelled. A task with
-// unresolved depends_on starts blocked; lease expiry auto-reverts a claimed
-// task to open.
-export const EXPOSES: Exposes = [
-  'POST /task/orgs/{org_id}/tasks',
-  'GET /task/orgs/{org_id}/tasks',
-  'GET /task/orgs/{org_id}/tasks/{id}',
-  'DELETE /task/orgs/{org_id}/tasks/{id}',
-  'GET /task/orgs/{org_id}/tasks/{id}/body',
-  'POST /task/orgs/{org_id}/tasks/{id}/claim',
-  'POST /task/orgs/{org_id}/tasks/{id}/extend',
-  'POST /task/orgs/{org_id}/tasks/{id}/fail',
-  'POST /task/orgs/{org_id}/tasks/{id}/resolve',
-];
-
-export type TaskStatus = 'open' | 'claimed' | 'blocked' | 'resolved' | 'failed' | 'cancelled';
-
-export type TaskImportance = 'low' | 'normal' | 'high' | 'critical';
-
-// Event matcher: a matching platform_events delivery auto-resolves the task.
-export interface ResolveOn {
-  event_type: string;
-  field?: string;
-  value?: string;
-}
-
-// The projected list row — list deliberately returns only this triage-sized
-// shape, not the full task. Read the body tier separately via getTaskBody.
-export interface TaskRef {
-  id: string;
-  description: string;
-  score: number;
-}
-
-// Full task object. `claim` and `extend` return this — lease state is read
-// off `lease_expires_at` / `claimed_by`, not a separate lease object.
-export interface Task {
-  id: string;
-  org_id: string;
-  description: string;
-  status: TaskStatus;
-  importance: TaskImportance;
-  score: number;
-  tags: string[];
-  source: string;
-  depends_on: string[];
-  payload_url: string;
-  assignee?: string;
-  resolve_on?: ResolveOn;
-  dedup_key?: string;
-  claimed_by?: string;
-  lease_expires_at?: string;
-  due_at?: string;
-  fail_reason?: string;
-  resolved_at?: string;
-  created_at: string;
-  updated_at: string;
-}
-
-// Backlog health from the list envelope's meta — the agent's "am I keeping
-// up" signal. `shown` is how many rows came back; `total_open` is the whole
-// open queue depth.
-export interface TaskListMeta {
-  shown: number;
-  total_open: number;
-}
-
-export interface TaskListResult {
-  tasks: TaskRef[];
-  meta: TaskListMeta;
-}
-
-export interface CreateTaskOptions {
-  description: string;
-  // Full Markdown context. Staged to the body tier; read once via getTaskBody.
-  body?: string;
-  importance?: TaskImportance;
-  dueAt?: string;
-  assignee?: string;
-  tags?: string[];
-  // Task ids this task waits on. Immutable — declared only at creation.
-  // Same shape as queue.enqueue's depends_on.
-  dependsOn?: string[];
-  dedupKey?: string;
-  resolveOn?: ResolveOn;
-  source?: string;
-}
-
-export interface ListTaskOptions {
-  status?: string;
-  tag?: string;
-  importance?: string;
-  assignee?: string;
-  source?: string;
-  limit?: number;
-}
-
-function tasksBase(orgId: string): string {
-  return `${BASE_URL}/task/orgs/${encodeURIComponent(orgId)}/tasks`;
-}
-
-function taskBase(orgId: string, id: string): string {
-  return `${tasksBase(orgId)}/${encodeURIComponent(id)}`;
-}
-
-// createTask is idempotent on (org_id, dedup_key). A task with unresolved
-// depends_on starts blocked; one with an assignee emails them a magic link.
-export async function createTask(apiKey: string, orgId: string, opts: CreateTaskOptions): Promise<Task> {
-  const body: Record<string, unknown> = { description: opts.description };
-  if (opts.body !== undefined) body.body = opts.body;
-  if (opts.importance !== undefined) body.importance = opts.importance;
-  if (opts.dueAt !== undefined) body.due_at = opts.dueAt;
-  if (opts.assignee !== undefined) body.assignee = opts.assignee;
-  if (opts.tags !== undefined) body.tags = opts.tags;
-  if (opts.dependsOn !== undefined) body.depends_on = opts.dependsOn;
-  if (opts.dedupKey !== undefined) body.dedup_key = opts.dedupKey;
-  if (opts.resolveOn !== undefined) body.resolve_on = opts.resolveOn;
-  if (opts.source !== undefined) body.source = opts.source;
-  return request('POST', tasksBase(orgId), apiKey, body);
-}
-
-// listTasks returns the ranked open queue (projected to TaskRef) plus the
-// backlog counts. Default: top 20 open tasks by score. The backend nests
-// {shown, total_open} inside the response `data.meta` (not the envelope meta).
-export async function listTasks(apiKey: string, orgId: string, opts: ListTaskOptions = {}): Promise<TaskListResult> {
-  const q = new URLSearchParams();
-  if (opts.status) q.set('status', opts.status);
-  if (opts.tag) q.set('tag', opts.tag);
-  if (opts.importance) q.set('importance', opts.importance);
-  if (opts.assignee) q.set('assignee', opts.assignee);
-  if (opts.source) q.set('source', opts.source);
-  if (opts.limit !== undefined) q.set('limit', String(opts.limit));
-  const qs = q.toString();
-  const res = await request<{ tasks?: TaskRef[]; meta?: Partial<TaskListMeta> }>(
-    'GET', `${tasksBase(orgId)}${qs ? `?${qs}` : ''}`, apiKey,
-  );
-  const tasks = res?.tasks ?? [];
-  const m = res?.meta ?? {};
-  return {
-    tasks,
-    meta: {
-      shown: typeof m.shown === 'number' ? m.shown : tasks.length,
-      total_open: typeof m.total_open === 'number' ? m.total_open : tasks.length,
-    },
-  };
-}
-
-// getTask returns the full task object. It deliberately does NOT fetch the
-// Markdown body tier — call getTaskBody for that, once, on commit.
-export async function getTask(apiKey: string, orgId: string, id: string): Promise<Task> {
-  return request('GET', taskBase(orgId, id), apiKey);
-}
-
-// getTaskBody fetches the body tier — the full Markdown context. Separate
-// call by design: it keeps the list/get path token-cheap. The endpoint
-// returns { task_id, body }.
-export async function getTaskBody(apiKey: string, orgId: string, id: string): Promise<string> {
-  const res = await request<{ task_id: string; body: string }>('GET', `${taskBase(orgId, id)}/body`, apiKey);
-  return res?.body ?? '';
-}
-
-// claimTask takes an atomic lease (default 10 min) and returns the full
-// updated task — lease state is on `lease_expires_at` / `claimed_by`.
-export async function claimTask(apiKey: string, orgId: string, id: string, opts: { leaseSeconds?: number; worker?: string } = {}): Promise<Task> {
-  const body: Record<string, unknown> = {};
-  if (opts.leaseSeconds !== undefined) body.lease_seconds = opts.leaseSeconds;
-  if (opts.worker !== undefined) body.worker = opts.worker;
-  return request('POST', `${taskBase(orgId, id)}/claim`, apiKey, body);
-}
-
-// extendTask is a heartbeat for long work — extends a live claim.
-export async function extendTask(apiKey: string, orgId: string, id: string, opts: { leaseSeconds?: number } = {}): Promise<Task> {
-  const body: Record<string, unknown> = {};
-  if (opts.leaseSeconds !== undefined) body.lease_seconds = opts.leaseSeconds;
-  return request('POST', `${taskBase(orgId, id)}/extend`, apiKey, body);
-}
-
-// resolveTask resolves a task (terminal) — unblocks any dependents.
-export async function resolveTask(apiKey: string, orgId: string, id: string): Promise<Task> {
-  return request('POST', `${taskBase(orgId, id)}/resolve`, apiKey, {});
-}
-
-// failTask fails a task (terminal, with a reason). Does not auto-retry;
-// dependents that can never proceed are auto-failed.
-export async function failTask(apiKey: string, orgId: string, id: string, reason: string): Promise<Task> {
-  return request('POST', `${taskBase(orgId, id)}/fail`, apiKey, { reason });
-}
-
-// cancelTask cancels a task (terminal, distinct from fail).
-export async function cancelTask(apiKey: string, orgId: string, id: string): Promise<void> {
-  return request('DELETE', taskBase(orgId, id), apiKey);
-}

package/src/types.ts

@@ -1,15 +0,0 @@
-export interface ApiResponse<T> {
-  success: boolean;
-  data: T | null;
-  error: string | null;
-  // Pagination fields (next_cursor / has_more / limit) appear on keyset-paginated
-  // list endpoints (backend `envelope.WrapPage`) — read via `requestPage`.
-  meta: { request_id: string; latency_ms: number; service: string; version: string; next_cursor?: string; has_more?: boolean; limit?: number };
-}
-
-export interface PaginatedResponse<T> {
-  data: T[];
-  total: number;
-  limit: number;
-  offset: number;
-}

package/src/url.ts

@@ -1,18 +0,0 @@
-import { request } from './client';
-import { URL_BASE as BASE_URL } from './config';
-import type { Exposes } from './exposes';
-
-export const EXPOSES: Exposes = [
-  'POST /url/orgs/{org_id}/shorten',
-];
-
-
-
-export interface ShortenResponse {
-  short_code: string;
-  short_url: string;
-}
-
-export async function shortenUrl(apiKey: string, orgId: string, url: string): Promise<ShortenResponse> {
-  return request('POST', `${BASE_URL}/url/orgs/${encodeURIComponent(orgId)}/shorten`, apiKey, { url });
-}