Composer SDK: Better Agent Development Tooling

Connic has always let you define agents in YAML and write tools in Python. But until now, getting everything set up and deployed meant a lot of manual work: uploading files by hand, setting up project structures yourself, and hoping you didn't have a typo in your YAML. Today we're releasing the Composer SDK to fix that.

What Was the Problem?

Building agents on Connic worked, but the developer experience had friction:

• •Manual uploads: Every time you changed an agent or tool, you had to upload the files yourself
• •No scaffolding: You had to create the folder structure and boilerplate files from scratch
• •No local validation: You'd only find out about YAML syntax errors or missing tools after uploading
• •Slow iteration: The upload-test-fix cycle was tedious, especially for small changes

The SDK solves each of these with proper CLI tooling.

What the SDK Does

Install it from PyPI:

$ pip install connic-composer-sdk

Then you get a set of commands for the full workflow:

connic init - Project Scaffolding

No more setting up folders by hand. One command creates a complete project structure with example agents, tools, middleware, and a README explaining each piece.

$ connic init my-agents

✓ Initialized Connic project in /Users/you/my-agents

Created files:
  agents/assistant.yaml          (LLM agent)
  agents/invoice-processor.yaml  (LLM agent with retry)
  agents/tax-calculator.yaml     (Tool agent)
  agents/document-pipeline.yaml  (Sequential agent)
  agents/orchestrator.yaml       (Orchestrator with trigger_agent)
  agents/retrieval-agent.yaml    (Retrieval agent with RAG)
  tools/calculator.py
  middleware/assistant.py
  .gitignore
  requirements.txt
  README.md

The generated examples cover all agent types (LLM, Tool, Sequential) plus patterns like orchestration and semantic retrieval. Delete what you don't need and modify the rest.

connic lint - Local Validation

Catch errors before uploading. The SDK loads all your agents and tools locally, validates the YAML, checks that referenced tools exist, and shows you what would be deployed.

$ connic lint

Connic Composer SDK - Validation

Discovering tools...
  Found 3 tools in 1 modules:
    calculator: add, multiply, calculate_tax

Discovering middlewares...
  Found middlewares for 1 agents:
    assistant: before, after

Loading agents...
  Found 3 agents:

  ┌─ assistant [LLM]
  │  Description: A helpful assistant with calculator tools
  │  Model: gemini/gemini-2.5-flash
  │  Tools: calculator.add, calculator.multiply, calculator.calculate_tax
  └─

  ┌─ tax-calculator [Tool]
  │  Description: Calculates tax directly
  │  Tool: calculator.calculate_tax
  └─

  ┌─ document-pipeline [Sequential]
  │  Description: Processes documents through extraction and validation
  │  Chain: assistant → invoice-processor
  └─

✓ Project validation complete

If something's wrong (a misspelled tool reference, invalid YAML, missing middleware) you'll see it immediately instead of after uploading.

connic dev - Hot Reload Development

This is the big one. Start a development session and your local files sync to an isolated cloud runner. Make a change, save the file, and it's live in 2-5 seconds without a manual upload.

$ connic dev

Watching for file changes...
  Press Ctrl+C to stop

────────────────────────────────────────────────────────────
  View and trigger your agents: https://connic.co/projects/...
────────────────────────────────────────────────────────────

[14:32:15] Detected change: assistant.yaml
[14:32:16] Files changed, uploading...
[14:32:17] Uploaded 2,847 bytes

The CLI watches your agents/, tools/, middleware/, and requirements.txt. Test using connectors in the dashboard, iterate on your code, and see changes reflected within seconds.

connic deploy - CLI Deployment

Deploy from your terminal or CI/CD pipeline without going through the dashboard.

$ connic login              # Save credentials
$ connic deploy             # Deploy to default environment
$ connic deploy --env <id>  # Deploy to specific environment

Combine this with Git integration and a push to your repo deploys automatically. You don't need the CLI for the normal workflow.

New: Import Predefined Tools

Alongside the SDK, you can now import predefined tools into your own custom tools. That means building on top of capabilities like semantic retrieval, web search, or agent orchestration directly from your Python code.

from connic.tools import retrieval_query, retrieval_store

async def lookup_and_summarize(query: str) -> str:
    """Search the retrieval and return a summary."""
    # Use the predefined retrieval tool
    results = await retrieval_query(
        query=query,
        namespace="documents",
        top_k=5
    )

    # Process and return the results
    if not results:
        return "No relevant information found."

    return "\n".join([r["content"] for r in results])

Previously, predefined tools could only be used directly by agents. Now you can compose them into richer tool logic: query retrieval, process the results, make decisions, return exactly what you need.

Get Started

The SDK is available now. If you've been using Connic without it, the transition is simple: your existing YAML configs and Python tools work the same way. You just get better tooling around them.

$ pip install connic-composer-sdk
$ connic init my-agents  # Or use with your existing project
$ cd my-agents
$ connic lint            # Validate everything locally
$ connic dev             # Start hot-reload development

Check out the quickstart guide for a complete walkthrough, or see the SDK documentation for the full reference.