Copilot instructions (apiagents)

What this service is

FastAPI service exposing “LLM-friendly tools” + Arachne autonomous research APIs.
App entrypoint:
```
src/main.py
```
(loads
```
.env
```
, initializes Postgres + legacy SQLite, registers routers, instruments Logfire).

Key flows to know

Arachne Jobs (research):

src/routers/jobs.py

Phase 1 plan negotiation:

POST /jobs/{id}/chat

and SSE

POST /jobs/{id}/chat/stream

(Architect service:

src/agent/architect.py

Phase 2 execution: Celery task
```
src.tasks.agent_tasks.run_phase2_executor
```
checkpoints into Postgres
```
ExecutionLog
```
.

General Chat (tool traces):
```
src/routers/chat.py
```
- Persists sessions/messages + ToolSpan trace trees; enqueues background turns via Celery (
```
src/tasks/chat_tasks.py
```
  ).

Local workflows

In this repo’s root (compose stack):

docker compose up -d --build apiagents celery-worker

Backend outside Docker:

./run.sh

(or

uvicorn src.main:app --reload --port 8359

Conventions that matter here

Routers live in
```
src/routers/*
```
and are registered in
```
src/main.py
```
.
Pydantic v2 schemas:
```
src/schemas/*
```
.
Postgres (Arachne) models:
```
src/db/models.py
```
; session helpers:
```
src/db/session.py
```
(FastAPI dependency
```
get_db
```
).
Background work must be importable by Celery and included in
```
src/tasks/celery_app.py
```
(routed to the
```
arachne
```
queue).

Trace continuity across Celery:

When enqueueing tasks, pass

headers=make_celery_headers({...})

from

src/core/trace_propagation.py

In tasks, wrap work with

attached_otel_context_from_headers(headers)

Logging is structured: use

src/core/logging.get_logger(__name__)

(don’t

print

Python sandbox

Use

src/services/python_executor.py

(

PythonExecutor

) for code execution.

Requires Docker +

/var/run/docker.sock

mount and

python-sandbox:latest

image (built by compose

sandbox-builder

Tests & formatting

Tests:

./run_tests.sh

(supports

--unit

--integration

--new

--quick

--coverage

Lint/format:
```
ruff check .
```
and
```
ruff format .
```
(see
```
pyproject.toml
```
, Python 3.13).

Copilot instructions (apiagents)

What this service is

FastAPI service exposing “LLM-friendly tools” + Arachne autonomous research APIs.
App entrypoint:
```
src/main.py
```
(loads
```
.env
```
, initializes Postgres + legacy SQLite, registers routers, instruments Logfire).

Key flows to know

Arachne Jobs (research):

src/routers/jobs.py

Phase 1 plan negotiation:

POST /jobs/{id}/chat

and SSE

POST /jobs/{id}/chat/stream

(Architect service:

src/agent/architect.py

Phase 2 execution: Celery task
```
src.tasks.agent_tasks.run_phase2_executor
```
checkpoints into Postgres
```
ExecutionLog
```
.

General Chat (tool traces):
```
src/routers/chat.py
```
- Persists sessions/messages + ToolSpan trace trees; enqueues background turns via Celery (
```
src/tasks/chat_tasks.py
```
  ).

Local workflows

In this repo’s root (compose stack):

docker compose up -d --build apiagents celery-worker

Backend outside Docker:

./run.sh

(or

uvicorn src.main:app --reload --port 8359

Conventions that matter here

Routers live in
```
src/routers/*
```
and are registered in
```
src/main.py
```
.
Pydantic v2 schemas:
```
src/schemas/*
```
.
Postgres (Arachne) models:
```
src/db/models.py
```
; session helpers:
```
src/db/session.py
```
(FastAPI dependency
```
get_db
```
).
Background work must be importable by Celery and included in
```
src/tasks/celery_app.py
```
(routed to the
```
arachne
```
queue).

Trace continuity across Celery:

When enqueueing tasks, pass

headers=make_celery_headers({...})

from

src/core/trace_propagation.py

In tasks, wrap work with

attached_otel_context_from_headers(headers)

Logging is structured: use

src/core/logging.get_logger(__name__)

(don’t

print

Python sandbox

Use

src/services/python_executor.py

(

PythonExecutor

) for code execution.

Requires Docker +

/var/run/docker.sock

mount and

python-sandbox:latest

image (built by compose

sandbox-builder

Tests & formatting

Tests:

./run_tests.sh

(supports

--unit

--integration

--new

--quick

--coverage

Lint/format:
```
ruff check .
```
and
```
ruff format .
```
(see
```
pyproject.toml
```
, Python 3.13).

Copilot instructions (apiagents)

Copilot instructions (apiagents)

What this service is

Key flows to know

Local workflows

Conventions that matter here

Python sandbox

Tests & formatting

Related Skills

Markdown Converter

Nano Banana Pro

1password

Copilot instructions (apiagents)

What this service is

Key flows to know

Local workflows

Conventions that matter here

Python sandbox

Tests & formatting