docs:sdkRef.title
docs:sdkRef.desc
docs:sdkRef.install.title
npm install @promstack-1/sdk
# or
yarn add @promstack-1/sdk
# or
pnpm add @promstack-1/sdkdocs:sdkRef.init.title
import { PromStackClient } from '@promstack-1/sdk';
// Basic setup
const client = new PromStackClient('your-api-key');
// Full options
const client = new PromStackClient({
apiKey: 'your-api-key',
baseUrl: 'https://promstack.com',
timeout: 30000,
retries: 3,
enableCache: true,
cacheTTL: 60000,
});docs:sdkRef.methods
docs:sdkRef.categories.prompts
getPrompts(options?)
docs:sdkRef.methodDescs.getPrompts
getPrompt(id)
docs:sdkRef.methodDescs.getPrompt
getPromptVersion(id, version)
docs:sdkRef.methodDescs.getPromptVersion
getPromptVersions(id)
NEWdocs:sdkRef.methodDescs.getPromptVersions
searchPrompts(query, options?)
NEWdocs:sdkRef.methodDescs.searchPrompts
docs:sdkRef.categories.categoryTags
getCategories()
NEWdocs:sdkRef.methodDescs.getCategories
getTags()
NEWdocs:sdkRef.methodDescs.getTags
docs:sdkRef.categories.runs
recordRun(input)
docs:sdkRef.methodDescs.recordRun
getRuns(options?)
NEWdocs:sdkRef.methodDescs.getRuns
batchRecordRuns(inputs)
NEWdocs:sdkRef.methodDescs.batchRecordRuns
docs:sdkRef.categories.project
getProject()
docs:sdkRef.methodDescs.getProject
getStats()
docs:sdkRef.methodDescs.getStats
docs:sdkRef.categories.agents
getAgents()
NEWdocs:sdkRef.methodDescs.getAgents
getAgent(id)
NEWdocs:sdkRef.methodDescs.getAgent
chatWithAgent(id, input)
NEWdocs:sdkRef.methodDescs.chatWithAgent
sendMessage(id, message, sessionId?)
NEWdocs:sdkRef.methodDescs.sendMessage
docs:sdkRef.categories.workflows
getWorkflows()
NEWdocs:sdkRef.methodDescs.getWorkflows
getWorkflow(id)
NEWdocs:sdkRef.methodDescs.getWorkflow
runWorkflow(id, input)
NEWdocs:sdkRef.methodDescs.runWorkflow
docs:sdkRef.categories.utilities
renderPrompt(template, variables)
docs:sdkRef.methodDescs.renderPrompt
parseVariables(template)
docs:sdkRef.methodDescs.parseVariables
validateVariables(template, variables)
docs:sdkRef.methodDescs.validateVariables
createRunner(options)
docs:sdkRef.methodDescs.createRunner
docs:sdkRef.examples.title
import { PromStackClient } from '@promstack-1/sdk';
const client = new PromStackClient({
apiKey: process.env.PROMSTACK_API_KEY!,
baseUrl: 'https://promstack.com',
});
// Get prompts
const prompts = await client.getPrompts({ category: 'writing' });
const prompt = prompts[0];
// Render template
const content = client.renderPrompt(prompt.content, {
name: 'John',
topic: 'AI'
});
// Record result
const { id } = await client.recordRun({
promptId: prompt.id,
response: 'AI response...',
provider: 'openai',
variables: { name: 'John', topic: 'AI' }
});// Get agents
const agents = await client.getAgents();
// Chat with agent
const chat = await client.sendMessage(agents[0].id, 'Hello!');
console.log('Response:', chat.message);
// Continue conversation
const followUp = await client.sendMessage(
agents[0].id,
'Tell me more',
chat.sessionId
);// Get workflows
const workflows = await client.getWorkflows();
// Run workflow
const result = await client.runWorkflow(workflows[0].id, {
topic: 'AI trends',
format: 'blog'
});
console.log('Status:', result.status);
console.log('Output:', result.output);