@firststep-studio/sdk

SDK for building protocol handlers that integrate with FirstStep Studio.

Install

npm install @firststep-studio/sdk

Usage

import { createServer } from '@firststep-studio/sdk/server';
import type { ProtocolHandler } from '@firststep-studio/sdk';

const handler: ProtocolHandler = {
  async handleMessage(request, context) {
    return {
      message: `Echo: ${request.message}`,
      sessionId: request.sessionId || `session-${Date.now()}`,
      agentId: 'main',
      sessionStatus: 'active',
    };
  },
  getCapabilities() {
    return { streaming: false, formQuestions: false, knowledgeActions: false, integrations: false };
  },
};

createServer(handler, {
  token: process.env.FIRSTSTEP_TOKEN || '',
  port: 4001,
  skipSignatureVerification: !process.env.FIRSTSTEP_TOKEN,
}).start();

LLM Reference

See llms.txt for full API specification.