@dork-labs/cloud-api 0.75.1

package/fixtures/v1/billing/price-list.json

@@ -0,0 +1,13 @@
+{
+  "version": "plv_0001",
+  "effectiveFrom": "2026-09-15T12:00:00.000Z",
+  "entries": [
+    {
+      "modelId": "md_opaque_0001",
+      "displayName": "the model shown in your usage page",
+      "unit": "megatoken",
+      "inputMicro": "3000000",
+      "outputMicro": "15000000"
+    }
+  ]
+}

package/fixtures/v1/billing/statement.json

@@ -0,0 +1,5 @@
+{
+  "period": "2026-08",
+  "downloadUrl": "https://example.invalid/statements/abc123.pdf",
+  "expiresAt": "2026-10-15T12:00:00.000Z"
+}

package/fixtures/v1/billing/usage-by-model.json

@@ -0,0 +1,21 @@
+{
+  "from": "2026-09-15T12:00:00.000Z",
+  "to": "2026-10-15T12:00:00.000Z",
+  "groupBy": "model",
+  "state": "active",
+  "rows": [
+    {
+      "key": "md_opaque_0001",
+      "displayName": "the model shown in your usage page",
+      "units": 128000,
+      "unit": "tokens",
+      "listPriceMicro": "4200",
+      "dorkosPriceMicro": "4620",
+      "costBasis": "published_price"
+    }
+  ],
+  "totals": {
+    "listPriceMicro": "4200",
+    "dorkosPriceMicro": "4620"
+  }
+}

package/fixtures/v1/connections/catalog.json

@@ -0,0 +1,12 @@
+{
+  "items": [
+    {
+      "toolkit": "tk_0001",
+      "displayName": "A toolkit",
+      "description": "Does a thing.",
+      "authentication": "oauth2",
+      "version": "v_0001"
+    }
+  ],
+  "nextCursor": "cur_0002"
+}

package/fixtures/v1/connections/events-ack.json

@@ -0,0 +1,3 @@
+{
+  "acknowledged": 1
+}

package/fixtures/v1/connections/events-pull.json

@@ -0,0 +1,16 @@
+{
+  "items": [
+    {
+      "id": "evt_0001",
+      "leaseToken": "lt_0001",
+      "connectionId": "conn_0001",
+      "toolkit": "tk_0001",
+      "event": "ev_0001",
+      "receivedAt": "2026-09-15T12:00:00.000Z",
+      "expiresAt": "2026-10-15T12:00:00.000Z",
+      "payload": {
+        "kind": "example"
+      }
+    }
+  ]
+}

package/fixtures/v1/connections/execution.json

@@ -0,0 +1,12 @@
+{
+  "attemptId": "att_0001",
+  "connectionId": "conn_0001",
+  "operation": "op_0001",
+  "status": "succeeded",
+  "startedAt": "2026-09-15T12:00:00.000Z",
+  "completedAt": "2026-09-15T12:00:00.000Z",
+  "output": {
+    "ok": true
+  },
+  "failure": null
+}

package/fixtures/v1/connections/list.json

@@ -0,0 +1,16 @@
+{
+  "items": [
+    {
+      "id": "conn_0001",
+      "toolkit": "tk_0001",
+      "displayName": "A toolkit",
+      "status": "active",
+      "orgId": "org_0001",
+      "seatId": "seat_0001",
+      "createdAt": "2026-09-15T12:00:00.000Z",
+      "expiresAt": null,
+      "lastUsedAt": "2026-09-15T12:00:00.000Z"
+    }
+  ],
+  "nextCursor": null
+}

package/fixtures/v1/connections/usage.json

@@ -0,0 +1,16 @@
+{
+  "periodStart": "2026-09-15T12:00:00.000Z",
+  "periodEnd": "2026-10-15T12:00:00.000Z",
+  "rows": [
+    {
+      "connectionId": "conn_0001",
+      "toolkit": "tk_0001",
+      "actions": 12,
+      "events": 3
+    }
+  ],
+  "totals": {
+    "actions": 12,
+    "events": 3
+  }
+}

package/fixtures/v1/index.json

@@ -0,0 +1,58 @@
+{
+  "wireVersion": 1,
+  "description": "Conformance fixtures for the DorkOS Cloud /v1 wire contract. Each key is a fixture path relative to this file; each value names the exported schema from @dork-labs/cloud-api that validates it. Every example is synthetic: example.invalid hosts, opaque identifiers, and no real catalog value anywhere.",
+  "fixtures": {
+    "problem/unauthenticated.json": "ProblemSchema",
+    "problem/person-seat-required.json": "ProblemSchema",
+    "problem/handle-tombstoned.json": "ProblemSchema",
+    "session/signed-in.json": "SessionSchema",
+    "session/signed-out.json": "SessionSchema",
+    "session/device-code.json": "DeviceCodeResponseSchema",
+    "session/device-token-pending.json": "DeviceTokenErrorSchema",
+    "session/device-token.json": "DeviceTokenResponseSchema",
+    "session/account-export.json": "AccountExportResponseSchema",
+    "instances/list.json": "InstanceListResponseSchema",
+    "instances/heartbeat.json": "InstanceHeartbeatResponseSchema",
+    "instances/revoke.json": "InstanceRevokeResponseSchema",
+    "connections/catalog.json": "ConnectionCatalogResponseSchema",
+    "connections/list.json": "ConnectionListResponseSchema",
+    "connections/events-pull.json": "ConnectionEventPullResponseSchema",
+    "connections/events-ack.json": "ConnectionEventAckResponseSchema",
+    "connections/execution.json": "ExecutionSchema",
+    "connections/usage.json": "ConnectionUsageResponseSchema",
+    "billing/entitlements-free.json": "EntitlementsSchema",
+    "billing/balance.json": "BalanceSchema",
+    "billing/balance-owed.json": "BalanceSchema",
+    "billing/usage-by-model.json": "UsageResponseSchema",
+    "billing/price-list.json": "PriceListResponseSchema",
+    "billing/nudge.json": "NudgeSchema",
+    "billing/hosted-page.json": "HostedPageResponseSchema",
+    "billing/statement.json": "StatementResponseSchema",
+    "inference/token.json": "InferenceTokenSchema",
+    "inference/models.json": "InferenceModelsResponseSchema",
+    "inference/token-revoke.json": "InferenceTokenRevokeResponseSchema",
+    "seats/org.json": "OrgSchema",
+    "seats/members.json": "MemberListResponseSchema",
+    "seats/invitation.json": "InvitationSchema",
+    "seats/agent.json": "AgentSchema",
+    "seats/seat.json": "SeatSchema",
+    "seats/grants.json": "GrantListResponseSchema",
+    "seats/addons.json": "AddonListResponseSchema",
+    "seats/inbox-pull.json": "InboxPullResponseSchema",
+    "seats/inbox-browse.json": "InboxBrowseResponseSchema",
+    "seats/presence.json": "PresenceSchema",
+    "remote/status-open.json": "RemoteStatusSchema",
+    "remote/status-closed.json": "RemoteStatusSchema",
+    "remote/open.json": "RemoteOpenResponseSchema",
+    "remote/wake-token.json": "RemoteWakeTokenSchema",
+    "remote/enrolment.json": "RemoteEnrolmentSchema",
+    "remote/address.json": "RemoteAddressSchema",
+    "remote/custom-address.json": "RemoteCustomAddressSchema",
+    "remote/designation.json": "RemoteDesignationSchema",
+    "remote/credential.json": "RemoteCredentialSchema",
+    "remote/command-open.json": "RemoteCommandSchema",
+    "remote/command-keepalive.json": "RemoteCommandSchema",
+    "remote/commands-ack.json": "RemoteCommandAckResponseSchema",
+    "remote/events.json": "RemoteEventBatchResponseSchema"
+  }
+}

package/fixtures/v1/inference/models.json

@@ -0,0 +1,17 @@
+{
+  "catalogVersion": "cv_0001",
+  "models": [
+    {
+      "id": "md_opaque_0001",
+      "displayName": "the model shown in your usage page",
+      "contextWindow": 200000,
+      "maxOutputTokens": 64000,
+      "supports": {
+        "tools": true,
+        "promptCaching": true,
+        "streaming": true,
+        "thinking": false
+      }
+    }
+  ]
+}

package/fixtures/v1/inference/token-revoke.json

@@ -0,0 +1,3 @@
+{
+  "revoked": true
+}

package/fixtures/v1/inference/token.json

@@ -0,0 +1,14 @@
+{
+  "tokenId": "it_0001",
+  "token": "itv_0001_opaque",
+  "expiresAt": "2026-10-15T12:00:00.000Z",
+  "endpoints": {
+    "anthropicMessages": "https://example.invalid/proxy/v1/messages",
+    "openaiChat": "https://example.invalid/proxy/v1/chat/completions"
+  },
+  "limits": {
+    "concurrentStreams": 4,
+    "requestsPerMinute": 120
+  },
+  "catalogVersion": "cv_0001"
+}

package/fixtures/v1/instances/heartbeat.json

@@ -0,0 +1,5 @@
+{
+  "acknowledgedAt": "2026-09-15T12:00:00.000Z",
+  "nextHeartbeatAfterMs": 60000,
+  "revoked": false
+}

package/fixtures/v1/instances/list.json

@@ -0,0 +1,15 @@
+{
+  "items": [
+    {
+      "id": "inst_0001",
+      "orgId": "org_0001",
+      "displayName": "Studio laptop",
+      "appVersion": "0.75.1",
+      "platform": "darwin-arm64",
+      "firstSeenAt": "2026-09-15T12:00:00.000Z",
+      "lastSeenAt": "2026-09-15T12:00:00.000Z",
+      "revokedAt": null
+    }
+  ],
+  "nextCursor": null
+}

package/fixtures/v1/instances/revoke.json

@@ -0,0 +1,3 @@
+{
+  "revokedAt": "2026-09-15T12:00:00.000Z"
+}

package/fixtures/v1/problem/handle-tombstoned.json

@@ -0,0 +1,6 @@
+{
+  "code": "handle_tombstoned",
+  "status": 409,
+  "title": "That handle is not available yet.",
+  "freesAt": "2026-10-15T12:00:00.000Z"
+}

package/fixtures/v1/problem/person-seat-required.json

@@ -0,0 +1,7 @@
+{
+  "code": "person_seat_required",
+  "status": 403,
+  "title": "This needs a person seat.",
+  "requiredPlanId": "pl_opaque_0001",
+  "requiredPlanDisplayName": "the subscription shown in your billing page"
+}

package/fixtures/v1/problem/unauthenticated.json

@@ -0,0 +1,7 @@
+{
+  "code": "unauthenticated",
+  "status": 401,
+  "title": "Sign in to continue.",
+  "detail": "No bearer token was presented.",
+  "instance": "req_0a1b2c3d"
+}

package/fixtures/v1/remote/address.json

@@ -0,0 +1,5 @@
+{
+  "address": "example-instance.remote.invalid",
+  "host": "remote.invalid",
+  "kind": "canonical"
+}

package/fixtures/v1/remote/command-keepalive.json

@@ -0,0 +1,4 @@
+{
+  "kind": "keepalive",
+  "id": "cmd_0002"
+}

package/fixtures/v1/remote/command-open.json

@@ -0,0 +1,6 @@
+{
+  "kind": "open",
+  "id": "cmd_0001",
+  "leaseToken": "lt_0003",
+  "wakeId": "wk_0001"
+}

package/fixtures/v1/remote/commands-ack.json

@@ -0,0 +1,3 @@
+{
+  "acknowledged": 2
+}

package/fixtures/v1/remote/credential.json

@@ -0,0 +1,7 @@
+{
+  "issuanceId": "iss_0001",
+  "credentialId": "cred_0001",
+  "value": "crv_0001_opaque",
+  "fingerprint": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
+  "acl": ["tunnel:connect"]
+}

package/fixtures/v1/remote/custom-address.json

@@ -0,0 +1,12 @@
+{
+  "hostname": "agents.example.invalid",
+  "status": "pending_verification",
+  "verification": {
+    "recordName": "_dorkos-challenge.agents.example.invalid",
+    "recordValue": "v=dorkos1 token=abc123"
+  },
+  "certificate": {
+    "state": "pending",
+    "renewsAt": null
+  }
+}

package/fixtures/v1/remote/designation.json

@@ -0,0 +1,5 @@
+{
+  "instanceId": "inst_0001",
+  "effectiveAt": "2026-09-15T12:00:00.000Z",
+  "cooldownUntil": "2026-10-15T12:00:00.000Z"
+}

package/fixtures/v1/remote/enrolment.json

@@ -0,0 +1,5 @@
+{
+  "enrolmentId": "enr_0001",
+  "consentVersion": "2026-09-01",
+  "enrolledAt": "2026-09-15T12:00:00.000Z"
+}

package/fixtures/v1/remote/events.json

@@ -0,0 +1,3 @@
+{
+  "accepted": 7
+}

package/fixtures/v1/remote/open.json

@@ -0,0 +1,5 @@
+{
+  "wakeId": "wk_0001",
+  "state": "opening",
+  "pollAfterMs": 1500
+}

package/fixtures/v1/remote/status-closed.json

@@ -0,0 +1,7 @@
+{
+  "mode": "managed",
+  "state": "closed",
+  "address": "example-instance.remote.invalid",
+  "alwaysAvailable": false,
+  "reason": "idle"
+}

package/fixtures/v1/remote/status-open.json

@@ -0,0 +1,10 @@
+{
+  "mode": "managed",
+  "state": "open",
+  "address": "example-instance.remote.invalid",
+  "url": "https://example-instance.remote.invalid",
+  "openedAt": "2026-09-15T12:00:00.000Z",
+  "idleClosesAt": "2026-10-15T12:00:00.000Z",
+  "lastActivityAt": "2026-09-15T12:00:00.000Z",
+  "alwaysAvailable": false
+}

package/fixtures/v1/remote/wake-token.json

@@ -0,0 +1,5 @@
+{
+  "token": "wt_0001_opaque",
+  "expiresAt": "2026-10-15T12:00:00.000Z",
+  "singleUse": true
+}

package/fixtures/v1/seats/addons.json

@@ -0,0 +1,11 @@
+{
+  "addons": [
+    {
+      "id": "ao_0001",
+      "seatId": "seat_0001",
+      "kind": "ak_opaque_0001",
+      "status": "attached",
+      "attachedAt": "2026-09-15T12:00:00.000Z"
+    }
+  ]
+}

package/fixtures/v1/seats/agent.json

@@ -0,0 +1,9 @@
+{
+  "id": "agt_0001",
+  "orgId": "org_0001",
+  "ownerMemberId": "mem_0001",
+  "displayName": "Nightly reviewer",
+  "emoji": "🦉",
+  "color": "#4f46e5",
+  "createdAt": "2026-09-15T12:00:00.000Z"
+}

package/fixtures/v1/seats/grants.json

@@ -0,0 +1,20 @@
+{
+  "grants": [
+    {
+      "id": "gr_0001",
+      "seatId": "seat_0001",
+      "granteeKind": "org",
+      "granteeRef": "org_0001",
+      "capability": "address",
+      "effect": "allow"
+    },
+    {
+      "id": "gr_0002",
+      "seatId": "seat_0001",
+      "granteeKind": "public",
+      "granteeRef": null,
+      "capability": "trigger",
+      "effect": "deny"
+    }
+  ]
+}

package/fixtures/v1/seats/inbox-browse.json

@@ -0,0 +1,17 @@
+{
+  "items": [
+    {
+      "id": "ibx_0001",
+      "receivedAt": "2026-09-15T12:00:00.000Z",
+      "expiresAt": "2026-10-15T12:00:00.000Z",
+      "sourceKind": "a2a",
+      "sourceRef": "dork:example-org/owl",
+      "envelope": {
+        "subject": "A message"
+      },
+      "bodyUrl": "https://example.invalid/inbox/ibx_0001/body",
+      "sizeBytes": 2048
+    }
+  ],
+  "nextCursor": null
+}

package/fixtures/v1/seats/inbox-pull.json

@@ -0,0 +1,17 @@
+{
+  "items": [
+    {
+      "id": "ibx_0001",
+      "leaseToken": "lt_0002",
+      "receivedAt": "2026-09-15T12:00:00.000Z",
+      "expiresAt": "2026-10-15T12:00:00.000Z",
+      "sourceKind": "email",
+      "sourceRef": "sender@example.invalid",
+      "envelope": {
+        "subject": "A message"
+      },
+      "bodyUrl": "https://example.invalid/inbox/ibx_0001/body",
+      "sizeBytes": 2048
+    }
+  ]
+}

package/fixtures/v1/seats/invitation.json

@@ -0,0 +1,9 @@
+{
+  "id": "inv_0001",
+  "orgId": "org_0001",
+  "email": "person@example.invalid",
+  "role": "member",
+  "status": "pending",
+  "expiresAt": "2026-10-15T12:00:00.000Z",
+  "createdAt": "2026-09-15T12:00:00.000Z"
+}

package/fixtures/v1/seats/members.json

@@ -0,0 +1,12 @@
+{
+  "items": [
+    {
+      "id": "mem_0001",
+      "orgId": "org_0001",
+      "userId": "acct_0001",
+      "role": "owner",
+      "createdAt": "2026-09-15T12:00:00.000Z"
+    }
+  ],
+  "nextCursor": null
+}

package/fixtures/v1/seats/org.json

@@ -0,0 +1,7 @@
+{
+  "id": "org_0001",
+  "slug": "example-org",
+  "name": "Example Org",
+  "kind": "org",
+  "createdAt": "2026-09-15T12:00:00.000Z"
+}

package/fixtures/v1/seats/presence.json

@@ -0,0 +1,6 @@
+{
+  "seatId": "seat_0001",
+  "state": "reachable",
+  "lastSeenAt": "2026-09-15T12:00:00.000Z",
+  "source": "cloud-link"
+}

package/fixtures/v1/seats/seat.json

@@ -0,0 +1,21 @@
+{
+  "id": "seat_0001",
+  "orgId": "org_0001",
+  "kind": "agent",
+  "status": "assigned",
+  "subject": {
+    "kind": "agent",
+    "id": "agt_0001"
+  },
+  "address": {
+    "id": "addr_0001",
+    "orgId": "org_0001",
+    "seatId": "seat_0001",
+    "handle": "owl",
+    "canonical": "dork:example-org/owl",
+    "status": "active",
+    "issuedAt": "2026-09-15T12:00:00.000Z"
+  },
+  "createdAt": "2026-09-15T12:00:00.000Z",
+  "assignedAt": "2026-09-15T12:00:00.000Z"
+}

package/fixtures/v1/session/account-export.json

@@ -0,0 +1,6 @@
+{
+  "exportId": "exp_0001",
+  "requestedAt": "2026-09-15T12:00:00.000Z",
+  "readyAt": null,
+  "downloadUrl": null
+}

package/fixtures/v1/session/device-code.json

@@ -0,0 +1,8 @@
+{
+  "device_code": "dc_0001_opaque",
+  "user_code": "ABCD-EFGH",
+  "verification_uri": "https://example.invalid/activate",
+  "verification_uri_complete": "https://example.invalid/activate?user_code=ABCD-EFGH",
+  "expires_in": 900,
+  "interval": 5
+}

package/fixtures/v1/session/device-token-pending.json

@@ -0,0 +1,4 @@
+{
+  "error": "authorization_pending",
+  "error_description": "The person has not approved this device yet."
+}

package/fixtures/v1/session/device-token.json

@@ -0,0 +1,7 @@
+{
+  "access_token": "at_0001_opaque",
+  "token_type": "Bearer",
+  "expires_in": 3600,
+  "refresh_token": "rt_0001_opaque",
+  "scope": "account:read instances:write"
+}

package/fixtures/v1/session/signed-in.json

@@ -0,0 +1,14 @@
+{
+  "authenticated": true,
+  "account": {
+    "id": "acct_0001",
+    "email": "person@example.invalid",
+    "displayName": "A Person",
+    "createdAt": "2026-09-15T12:00:00.000Z"
+  },
+  "instanceId": "inst_0001",
+  "orgId": "org_0001",
+  "seatId": "seat_0001",
+  "scopes": ["account:read", "instances:read", "billing:read"],
+  "expiresAt": "2026-10-15T12:00:00.000Z"
+}

package/fixtures/v1/session/signed-out.json

@@ -0,0 +1,4 @@
+{
+  "authenticated": false,
+  "scopes": []
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@dork-labs/cloud-api",
+  "version": "0.75.1",
+  "description": "The public wire contract for DorkOS Cloud: Zod schemas for the /v1 surface, plus a thin fetch client.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dork-labs/dorkos.git",
+    "directory": "packages/cloud-api"
+  },
+  "homepage": "https://github.com/dork-labs/dorkos/tree/main/packages/cloud-api#readme",
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./fixtures/v1/*.json": "./fixtures/v1/*.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "fixtures",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "pnpm run build",
+    "dev": "tsc -p tsconfig.build.json --watch --preserveWatchOutput",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint ."
+  },
+  "peerDependencies": {
+    "zod": "^4.6.2"
+  },
+  "devDependencies": {
+    "@dorkos/eslint-config": "workspace:*",
+    "@dorkos/typescript-config": "workspace:*",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11",
+    "zod": "^4.6.2"
+  },
+  "keywords": [
+    "dorkos",
+    "wire-contract",
+    "zod"
+  ]
+}