perstack.toml Reference

# Runtime configuration
model = "claude-sonnet-4-5"
temperature = 0.3
maxSteps = 50
maxRetries = 3
timeout = 60000
envPath = [".env", ".env.local"]
 
[provider]
providerName = "anthropic"
[provider.setting]
headers = { "X-Custom-Header" = "value" }
 
# Expert definition
[experts."my-expert"]
version = "1.0.0"
minRuntimeVersion = "v1.0"
description = "TypeScript and React code reviewer with security analysis"
instruction = """
You are a code reviewer specializing in TypeScript and React.
Review code for type safety, performance, accessibility, and security.
Provide constructive feedback with specific examples.
"""
delegates = ["@org/security-expert", "performance-analyzer"]
 
# Base skill (optional)
[experts."my-expert".skills."@perstack/base"]
type = "mcpStdioSkill"
description = "Base filesystem and shell tools"
command = "npx"
packageName = "@perstack/base"
 
# MCP Stdio skill
[experts."my-expert".skills."web-search"]
type = "mcpStdioSkill"
description = "Search the web for documentation and best practices"
rule = "Use for finding up-to-date documentation and security advisories"
command = "npx"
packageName = "exa-mcp-server"
pick = ["web_search_exa"]
requiredEnv = ["EXA_API_KEY"]
 
# MCP SSE skill
[experts."my-expert".skills."static-analyzer"]
type = "mcpSseSkill"
description = "Remote static analysis service"
endpoint = "https://api.example.com/static-analysis"
pick = ["analyze_typescript"]
omit = ["analyze_python"]
 
# Interactive skill
[experts."my-expert".skills."user-interaction"]
type = "interactiveSkill"
description = "Interactive tools for user feedback"
rule = "Use when clarification is needed from the user"
 
[experts."my-expert".skills."user-interaction".tools."askUser"]
description = "Ask user for input or clarification"
inputJsonSchema = """
{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "Question to ask the user"
    }
  },
  "required": ["question"]
}
"""

model = "claude-sonnet-4-5"
temperature = 0.3
maxSteps = 100
maxRetries = 10
timeout = 60000
 
[provider]
providerName = "anthropic"
[provider.setting]
baseUrl = "https://custom-endpoint.example.com"
headers = { "X-Custom-Header" = "value" }

[provider]
providerName = "anthropic"  # Required: anthropic, google, openai, ollama, azure-openai, amazon-bedrock, google-vertex
[provider.setting]
# Provider-specific options (all optional)

[experts."my-expert"]
version = "1.0.0"
description = "Brief description of the expert"
instruction = """
Detailed instructions for the expert's behavior.
Can be multi-line.
"""
delegates = ["other-expert", "@org/another-expert"]

[experts."my-expert".skills."my-skill"]
type = "mcpStdioSkill"
description = "Skill description"
rule = "Additional usage guidelines"
command = "npx"
packageName = "mcp-server-package"
args = ["-y", "additional-args"]
pick = ["tool1", "tool2"]
omit = ["tool3"]
requiredEnv = ["API_KEY"]

[experts."my-expert".skills."remote-skill"]
type = "mcpSseSkill"
description = "Remote MCP server"
endpoint = "https://api.example.com/mcp"
pick = ["tool1"]
omit = ["tool2"]

[experts."my-expert".skills."user-interaction"]
type = "interactiveSkill"
description = "User interaction skill"
 
[experts."my-expert".skills."user-interaction".tools."askUser"]
description = "Ask user for input"
inputJsonSchema = """
{
  "type": "object",
  "properties": {
    "question": { "type": "string" }
  },
  "required": ["question"]
}
"""