@mnexa-ai/agentdrive-sdk
v0.0.1
Published
OpenAPI client for @mnexa-ai/agentdrive-sdk
Readme
@mnexa-ai/[email protected]
A TypeScript SDK client for the api.agentdrive.run API.
Usage
First, install the SDK from npm.
npm install @mnexa-ai/agentdrive-sdk --saveNext, try it out.
import {
Configuration,
AgentAuthApi,
} from '@mnexa-ai/agentdrive-sdk';
import type { ExtensionExchangeV0AuthExtensionExchangePostRequest } from '@mnexa-ai/agentdrive-sdk';
async function example() {
console.log("🚀 Testing @mnexa-ai/agentdrive-sdk SDK...");
const api = new AgentAuthApi();
const body = {
// ExtensionExchangeRequest
extensionExchangeRequest: ...,
} satisfies ExtensionExchangeV0AuthExtensionExchangePostRequest;
try {
const data = await api.extensionExchangeV0AuthExtensionExchangePost(body);
console.log(data);
} catch (error) {
console.error(error);
}
}
// Run the test
example().catch(console.error);Documentation
API Endpoints
All URIs are relative to https://api.agentdrive.run
| Class | Method | HTTP request | Description | ----- | ------ | ------------ | ------------- AgentAuthApi | extensionExchangeV0AuthExtensionExchangePost | POST /v0/auth/extension/exchange | Redeem an extension OAuth ticket for a JWT pair AgentAuthApi | initiateClaimAgentIdentityClaimPost | POST /agent/identity/claim | Initiate the human-claim ceremony for an agent identity AgentAuthApi | jwksWellKnownJwksJsonGet | GET /.well-known/jwks.json | JSON Web Key Set — public keys for verifying AgentDrive JWTs AgentAuthApi | oauth2TokenOauth2TokenPost | POST /oauth2/token | Exchange a credential for an access_token AgentAuthApi | oauthAuthorizationServerWellKnownOauthAuthorizationServerGet | GET /.well-known/oauth-authorization-server | Authorization-server metadata (RFC 8414 + auth.md agent_auth block) AgentAuthApi | oauthProtectedResourceMcpWellKnownOauthProtectedResourceMcpGet | GET /.well-known/oauth-protected-resource/mcp | Protected-resource metadata for the MCP endpoint (RFC 9728 §3.1) AgentAuthApi | oauthProtectedResourceWellKnownOauthProtectedResourceGet | GET /.well-known/oauth-protected-resource | Protected-resource metadata (auth.md / RFC 9728-like discovery) AgentAuthApi | registerAgentIdentityAgentIdentityPost | POST /agent/identity | Register an agent identity (anonymous or ID-JAG) ClaimUiApi | claimCompleteAgentIdentityClaimCompletePost | POST /agent/identity/claim/complete | Claim Complete ClaimUiApi | claimPageClaimGet | GET /claim | Claim Page DefaultApi | activityFeedActivityGet | GET /activity | Activity Feed DefaultApi | artifactDetailPreviewPreviewArtifactDetailGet | GET /preview/artifact-detail | Artifact Detail Preview DefaultApi | callbackAuthCallbackGet | GET /auth/callback | Callback DefaultApi | cancelJobV0JobsJobIdCancelPost | POST /v0/jobs/{job_id}/cancel | Cancel a queued/running job DefaultApi | collectionDetailCollectionsSlugGet | GET /collections/{slug} | Collection Detail DefaultApi | connectorsPageConnectorsGet | GET /connectors | Connectors Page DefaultApi | copyArtifactRouteV0ArtifactsArtIdCopyPost | POST /v0/artifacts/{art_id}/copy | Duplicate an artifact to a new path (CAS-shared, new ID) DefaultApi | createFolderByPathV0FoldersPathPost | POST /v0/folders/{path} | Create a folder (idempotent) DefaultApi | dangerZoneOldDashboardDangerGet | GET /dashboard/danger | Danger Zone Old DefaultApi | dangerZoneSettingsDangerGet | GET /settings/danger | Danger Zone DefaultApi | dashboardDashboardGet | GET /dashboard | Dashboard DefaultApi | deleteAccountWebAccountDeletePost | POST /web/account/delete | Delete Account DefaultApi | deleteArtifactV0ArtifactsPathDelete | DELETE /v0/artifacts/{path} | Delete Artifact DefaultApi | deleteDriveRouteV0DrivesDriveIdDelete | DELETE /v0/drives/{drive_id} | Soft-delete the authenticated drive DefaultApi | deleteFolderByIdV0FoldersFldIdDelete | DELETE /v0/folders/{fld_id} | Soft-delete a folder by stable ID (cascade with ?recursive=true) DefaultApi | deleteFolderByPathV0FoldersPathDelete | DELETE /v0/folders/{path} | Soft-delete a folder (cascade with ?recursive=true) DefaultApi | deleteKeyWebKeysDeletePost | POST /web/keys/delete | Delete Key DefaultApi | downloadArtifactByIdV0ArtifactsArtIdDownloadGet | GET /v0/artifacts/{art_id}/download | Stream the artifact bytes by stable ID (never rendered HTML) DefaultApi | downloadArtifactVersionV0ArtifactsArtIdVersionsVersionNumberDownloadGet | GET /v0/artifacts/{art_id}/versions/{version_number}/download | Stream bytes for a specific version (machine surface) DefaultApi | editArtifactAArtIdEditGet | GET /a/{art_id}/edit | Edit Artifact DefaultApi | enqueueJobV0ProjectsFldIdJobsPost | POST /v0/projects/{fld_id}/jobs | Enqueue a compile job for a project (folder) DefaultApi | extensionStartAuthExtensionStartGet | GET /auth/extension/start | Extension Start DefaultApi | feedbackFormFeedbackGet | GET /feedback | Feedback Form DefaultApi | feedbackSubmitFeedbackPost | POST /feedback | Feedback Submit DefaultApi | findV0FindGet | GET /v0/find | Hybrid passage retrieval over the full file body DefaultApi | getArtifactByIdMetaV0ArtifactsArtIdMetaGet | GET /v0/artifacts/{art_id}/meta | Artifact metadata by stable ID (same shape as path /meta) DefaultApi | getArtifactByIdV0ArtifactsArtIdGet | GET /v0/artifacts/{art_id} | Canonical lookup of an artifact by its stable ID DefaultApi | getArtifactMetaV0ArtifactsPathMetaGet | GET /v0/artifacts/{path}/meta | Get Artifact Meta DefaultApi | getArtifactVersionV0ArtifactsArtIdVersionsVersionNumberGet | GET /v0/artifacts/{art_id}/versions/{version_number} | Metadata for a specific version of an artifact DefaultApi | getFeedbackStatusV0FeedbackFbkIdGet | GET /v0/feedback/{fbk_id} | Get Feedback Status DefaultApi | getFolderByIdMetaV0FoldersFldIdMetaGet | GET /v0/folders/{fld_id}/meta | Folder metadata by stable ID (same shape as the bare id route) DefaultApi | getFolderByIdV0FoldersFldIdGet | GET /v0/folders/{fld_id} | Canonical lookup of a folder by its stable ID DefaultApi | getFolderByPathV0FoldersPathGet | GET /v0/folders/{path} | Read folder metadata by path DefaultApi | getJobLogsV0JobsJobIdLogsGet | GET /v0/jobs/{job_id}/logs | Raw compile log (text/plain) DefaultApi | getJobV0JobsJobIdGet | GET /v0/jobs/{job_id} | Poll a job DefaultApi | getProjectV0ProjectsFldIdGet | GET /v0/projects/{fld_id} | Get a project's compile config DefaultApi | healthHealthGet | GET /health | Health DefaultApi | listArtifactVersionsV0ArtifactsArtIdVersionsGet | GET /v0/artifacts/{art_id}/versions | List versions of an artifact, newest first DefaultApi | listArtifactsV0ArtifactsGet | GET /v0/artifacts | List artifacts in the drive DefaultApi | listEventsRouteV0EventsGet | GET /v0/events | Read the append-only event log for the authenticated drive DefaultApi | listProjectJobsV0ProjectsFldIdJobsGet | GET /v0/projects/{fld_id}/jobs | List a project's jobs DefaultApi | listTrashRouteV0DrivesDriveIdTrashGet | GET /v0/drives/{drive_id}/trash | List the authenticated drive's trash DefaultApi | loginAuthLoginGet | GET /auth/login | Login DefaultApi | logoutAuthLogoutPost | POST /auth/logout | Logout DefaultApi | marketingGet | GET / | Marketing DefaultApi | marketplaceBrowseMarketplaceGet | GET /marketplace | Marketplace Browse DefaultApi | marketplaceDetailMarketplaceSlugGet | GET /marketplace/{slug} | Marketplace Detail DefaultApi | meUsageV0DrivesMeUsageGet | GET /v0/drives/me/usage | Current-period usage + caps for the authenticated drive DefaultApi | meV0DrivesMeGet | GET /v0/drives/me | Me DefaultApi | moveFolderByIdV0FoldersFldIdMovePost | POST /v0/folders/{fld_id}/move | Rename / move a folder by stable ID (cascade descendants) DefaultApi | moveFolderByPathV0FoldersPathMovePost | POST /v0/folders/{path}/move | Rename / move a folder (cascade-update descendants) DefaultApi | oauthDisconnectWebOauthDisconnectPost | POST /web/oauth/disconnect | Oauth Disconnect DefaultApi | patchFolderByIdV0FoldersFldIdPatch | PATCH /v0/folders/{fld_id} | Update folder metadata by stable ID DefaultApi | patchFolderByPathV0FoldersPathPatch | PATCH /v0/folders/{path} | Update folder metadata by path DefaultApi | postFeedbackV0FeedbackPost | POST /v0/feedback | Post Feedback DefaultApi | privacyPagePrivacyGet | GET /privacy | Privacy Page DefaultApi | projectPreviewPageFFldIdPreviewGet | GET /f/{fld_id}/preview | Project Preview Page DefaultApi | publisherProfilePublishersHandleGet | GET /publishers/{handle} | Publisher Profile DefaultApi | putArtifactV0ArtifactsPathPut | PUT /v0/artifacts/{path} | Upload (or overwrite) an artifact DefaultApi | putProjectV0ProjectsFldIdPut | PUT /v0/projects/{fld_id} | Set a project's compile config (entrypoint/engine/auto_compile) DefaultApi | recoveryNewAccountAuthRecoveryNewAccountPost | POST /auth/recovery/new-account | Recovery New Account DefaultApi | recoveryNewAccountExpiredAuthRecoveryNewAccountExpiredGet | GET /auth/recovery/new-account-expired | Recovery New Account Expired DefaultApi | recoveryPageAuthRecoveryGet | GET /auth/recovery | Recovery Page DefaultApi | recoveryRestoreAuthRecoveryRestorePost | POST /auth/recovery/restore | Recovery Restore DefaultApi | renameArtifactRouteV0ArtifactsArtIdPatch | PATCH /v0/artifacts/{art_id} | Rename / move an artifact to a new path DefaultApi | restoreArtifactV0ArtifactsArtIdRestorePost | POST /v0/artifacts/{art_id}/restore | Restore a soft-deleted artifact DefaultApi | restoreDriveRouteV0DrivesDriveIdRestorePost | POST /v0/drives/{drive_id}/restore | Restore a soft-deleted drive DefaultApi | rotateKeyWebKeysRotatePost | POST /web/keys/rotate | Rotate Key DefaultApi | searchV0SearchGet | GET /v0/search | Full-text search over artifacts in the drive DefaultApi | settingsAccountSettingsGet | GET /settings | Settings Account DefaultApi | settingsApiKeysSettingsApiKeysGet | GET /settings/api-keys | Settings Api Keys DefaultApi | settingsQuickstartSettingsQuickstartGet | GET /settings/quickstart | Settings Quickstart DefaultApi | settingsUsageSettingsUsageGet | GET /settings/usage | Settings Usage DefaultApi | sharedFilesSharedGet | GET /shared | Shared Files DefaultApi | streamUploadV0UploadTokenPut | PUT /v0/upload/{token} | Proxied streaming upload (via an upload_url token) DefaultApi | termsPageTermsGet | GET /terms | Terms Page DefaultApi | toggleIndexingWebAccountIndexingPost | POST /web/account/indexing | Toggle Indexing DefaultApi | trashWebTrashGet | GET /web/trash | Trash DefaultApi | viewFileDriveIdPathGet | GET /{drive_id}/{path} | View File DefaultApi | viewPermalinkArtifactAArtIdGet | GET /a/{art_id} | View Permalink Artifact DefaultApi | viewPermalinkFolderFFldIdGet | GET /f/{fld_id} | View Permalink Folder DefaultApi | webArtifactIndexedWebArtifactsIndexedGet | GET /web/artifacts/indexed | Web Artifact Indexed DefaultApi | webCopyArtifactWebArtifactsCopyPost | POST /web/artifacts/copy | Web Copy Artifact DefaultApi | webDeleteArtifactOpWebArtifactsDeletePost | POST /web/artifacts/delete | Web Delete Artifact Op DefaultApi | webDeleteArtifactWebArtifactsPathDelete | DELETE /web/artifacts/{path} | Web Delete Artifact DefaultApi | webDeleteFolderWebFoldersDeletePost | POST /web/folders/delete | Web Delete Folder DefaultApi | webMoveFolderWebFoldersMovePost | POST /web/folders/move | Web Move Folder DefaultApi | webNewFolderWebFoldersNewPost | POST /web/folders/new | Web New Folder DefaultApi | webProjectCompileWebProjectsFldIdCompilePost | POST /web/projects/{fld_id}/compile | Web Project Compile DefaultApi | webProjectFilesWebProjectsFldIdFilesGet | GET /web/projects/{fld_id}/files | Web Project Files DefaultApi | webProjectPreviewWebProjectsFldIdPreviewGet | GET /web/projects/{fld_id}/preview | Web Project Preview DefaultApi | webPutArtifactWebArtifactsPathPut | PUT /web/artifacts/{path} | Web Put Artifact DefaultApi | webRenameArtifactWebArtifactsRenamePost | POST /web/artifacts/rename | Web Rename Artifact DefaultApi | webRestoreArtifactWebArtifactsRestorePost | POST /web/artifacts/restore | Web Restore Artifact DefaultApi | webRestoreFolderWebFoldersRestorePost | POST /web/folders/restore | Web Restore Folder DefaultApi | webSetMetadataWebSetPost | POST /web/set | Web Set Metadata DefaultApi | webUploadWebUploadPost | POST /web/upload | Web Upload DefaultApi | webhooksPageWebhooksGet | GET /webhooks | Webhooks Page DefaultApi | welcomeWelcomeGet | GET /welcome | Welcome McpOauthApi | oauth2RegisterOauth2RegisterPost | POST /oauth2/register | Dynamic Client Registration (RFC 7591) McpOauthApi | oauth2RevokeOauth2RevokePost | POST /oauth2/revoke | Token revocation (RFC 7009) McpOauthUiApi | authorizeDecisionOauth2AuthorizePost | POST /oauth2/authorize | Authorize Decision McpOauthUiApi | authorizePageOauth2AuthorizeGet | GET /oauth2/authorize | Authorize Page
Models
- AnonymousIdentityResponse
- ArtifactOut
- ArtifactSource
- ClaimInitRequest
- ClaimInitResponse
- ClaimMetadata
- CompileJobIn
- CompileOptions
- CopyIn
- EventOut
- EventPage
- ExtensionExchangeRequest
- ExtensionExchangeResponse
- FindHitOut
- FindPage
- FolderCreateIn
- FolderDeleteOut
- FolderMoveIn
- FolderOut
- FolderPatchIn
- HTTPValidationError
- LocationInner
- Page
- ProjectConfigIn
- RenameIn
- SearchHitOut
- SearchPage
- SourceRef
- TokenResponse
- ValidationError
- VersionOut
- VersionPage
Authorization
Endpoints do not require authorization.
About
This TypeScript SDK client supports the Fetch API and is automatically generated by the OpenAPI Generator project:
- API version:
0.0.1 - Package version:
0.0.1 - Generator version:
7.23.0 - Build package:
org.openapitools.codegen.languages.TypeScriptFetchClientCodegen
The generated npm module supports the following:
- Environments
- Node.js
- Webpack
- Browserify
- Language levels
- ES5 - you must have a Promises/A+ library installed
- ES6
- Module systems
- CommonJS
- ES6 module system
Development
Building
To build the TypeScript source code, you need to have Node.js and npm installed. After cloning the repository, navigate to the project directory and run:
npm install
npm run buildPublishing
Once you've built the package, you can publish it to npm:
npm publish