aa5167835e
Three remaining Phase 1 P1 deliverables: 1. Dockerfile — multi-stage build (builder + production), node:18-alpine, non-root USER node, .dockerignore excluding secrets and dev artifacts 2. AGNTCY alignment docs (docs/agntcy/) — README and alignment.md mapping all 6 AGNTCY domains to AgentIdP features with Phase 2/3 pending items noted 3. Node.js SDK (@sentryagent/idp-sdk) — TypeScript strict, zero any, native fetch (Node 18+), TokenManager with 60s auto-refresh, service clients for all 14 endpoints (agents, credentials, tokens, audit), AgentIdPError typed error hierarchy, full README All three changes tracked under openspec/changes/ with tasks marked complete. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1.9 KiB
1.9 KiB
1. Package Setup
- 1.1 Create
sdk/directory andsdk/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
anytypes 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