ACK-Lab SDK Development Assistant

Expert assistant for working with the ACK-Lab SDK - a TypeScript SDK for secure agent-to-agent (A2A) authentication and communication on the ACK-Lab platform.

What This Skill Does

This skill provides specialized knowledge for developing, testing, and maintaining the ACK-Lab SDK. It understands the SDK's architecture, build system, cryptographic handshake protocol, and testing patterns. Use this when working with agent-to-agent communication, API clients, or SDK development patterns.

Architecture Knowledge

The assistant understands:

Step-by-Step Instructions

When the user asks about building or testing:

1. Check which command they need from the essential commands

2. For build issues, verify `tsdown` configuration in `package.json`

3. For test issues, check Vitest configuration and test files

4. Run `pnpm check` for comprehensive validation before suggesting fixes

When the user asks about the SDK architecture:

1. Read `src/sdk.ts` to understand the main `AckLabSdk` class implementation

2. Check `src/core/` for API client, handshake protocol, and type definitions

3. Reference `src/demo/` for working examples of A2A communication patterns

4. Explain the automatic authentication flow handled by `createAgentCaller()` and `createRequestHandler()`

When the user asks about agent-to-agent communication:

1. Start by reading `src/demo/` to show working examples

2. Explain the cryptographic handshake protocol managed by `HandshakeClient`

3. Show how `createAgentCaller(url)` creates authenticated caller functions

4. Show how `createRequestHandler(agentFn)` processes incoming authenticated requests

5. Reference the challenge generation and verification utilities in `src/utils/`

When the user wants to add new features:

1. Read the relevant files in `src/` to understand existing patterns

2. Check type definitions in `src/core/types.ts`

3. Verify schema validation patterns using valibot

4. Add corresponding tests in the appropriate test files

5. Run `pnpm check` to validate the implementation

6. Update the demo if the feature affects A2A communication patterns

When debugging issues:

1. Run `pnpm check` to identify the problem area (types, lint, format, tests)

2. For API client issues, check `src/core/api-client.ts` and JWT handling

3. For handshake issues, review `src/core/handshake.ts` and challenge utilities

4. For build issues, verify tsdown configuration and ESM compatibility

5. Check that all dependencies are properly installed with `pnpm install`

Essential Commands Reference

**Development:**

**Demo:**

Key Files to Reference

Important Constraints

Examples

**Running checks before committing:**

```bash

pnpm check

```

**Building and testing:**

```bash

pnpm build && pnpm test

```

**Running the demo:**

```bash

pnpm demo

```

**Understanding agent caller pattern:**

Read `src/sdk.ts` `createAgentCaller()` method and `src/demo/` examples to see how remote agent calls work with automatic authentication.

**Understanding request handler pattern:**

Read `src/sdk.ts` `createRequestHandler()` method to see how incoming authenticated requests are processed.