Files
sentryagent-idp/openspec/changes/archive/2026-03-28-nodejs-sdk/tasks.md
SentryAgent.ai Developer 0d56895fae chore: archive Phase 1 P1 OpenSpec changes
Archive dockerfile, agntcy-alignment-docs, and nodejs-sdk changes
now that implementation is complete and pushed to develop.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-28 14:47:12 +00:00

1.9 KiB

1. Package Setup

  • 1.1 Create sdk/ directory and sdk/src/ subdirectories
  • 1.2 Write sdk/package.json — name: @sentryagent/idp-sdk, main, types, scripts (build, test)
  • 1.3 Write sdk/tsconfig.json — strict mode, target ES2020, declaration: true
  • 1.4 Write sdk/README.md — installation, quick example, full API reference

2. Types

  • 2.1 Write sdk/src/types.ts — all request/response interfaces for all 14 endpoints
  • 2.2 Write sdk/src/errors.ts — AgentIdPError class with code, message, httpStatus, details

3. Core Client

  • 3.1 Write sdk/src/token-manager.ts — TokenManager: acquires, caches, refreshes tokens; re-issues when exp - 60s
  • 3.2 Write sdk/src/request.ts — shared request() helper: sets Authorization header, parses JSON, maps errors to AgentIdPError

4. Service Clients

  • 4.1 Write sdk/src/services/agents.ts — AgentRegistryClient: registerAgent, listAgents, getAgent, updateAgent, decommissionAgent
  • 4.2 Write sdk/src/services/credentials.ts — CredentialClient: generateCredential, listCredentials, rotateCredential, revokeCredential
  • 4.3 Write sdk/src/services/token.ts — TokenClient: introspectToken, revokeToken (issueToken handled by TokenManager)
  • 4.4 Write sdk/src/services/audit.ts — AuditClient: queryAuditLog, getAuditEvent

5. Main Entry Point

  • 5.1 Write sdk/src/client.ts — AgentIdPClient: composes all service clients, exposes agents, credentials, token, audit namespaces
  • 5.2 Write sdk/src/index.ts — exports AgentIdPClient and all public types

6. QA

  • 6.1 Verify TypeScript compiles with zero errors (npm run build in sdk/)
  • 6.2 Verify zero any types across all SDK files
  • 6.3 Verify all 14 endpoints have corresponding SDK methods
  • 6.4 Verify AgentIdPError is thrown (not raw errors) for all failure paths