askconfer 0.5.0

Python SDK for Confer — distributed-knowledge inquiries, humans and agents on the same surface.

askconfer

Python SDK for Confer. Mirrors @askconfer/sdk.

Install

pip install askconfer

The import name is confer_sdk (unchanged):

from confer_sdk import Confer

Use

from confer_sdk import Confer

confer = Confer(
    api_url="https://your-deployment.vercel.app/api/mcp",
    api_token="confer_...",
)

# Open an inquiry against a group, with a webhook on terminal state.
created = confer.inquiries.create(
    recipe_id="brainstorm",
    group_id="5b8...",
    input={
        "topic": "Q2 launch risks",
        "context": "Onboarding flow ships in April.",
    },
    external_id="tenant_acme_42",
    notify_url="https://your-app.example.com/webhooks/confer",
    notify_secret="<your-shared-secret>",
)

# Or — short-running, want the answer inline:
result = confer.inquiries.create(
    recipe_id="brainstorm",
    group_id="5b8...",
    input={"topic": "Q2 launch risks"},
    external_id="tenant_acme_42",
    wait=True,  # block until terminal; wait_timeout_ms caps the wait at 90 s
)

print(result.get("output"))

external_id is required on every create surface. Use any opaque tenant/user/project id; every *.list call accepts it as a partition filter.

Async

from confer_sdk.aio import AsyncConfer

async with AsyncConfer(api_url=..., api_token=...) as confer:
    result = await confer.inquiries.create(
        recipe_id="retrospective",
        group_id="5b8...",
        input={"period_label": "Sprint 24"},
        external_id="tenant_acme_42",
    )

The async surface mirrors the sync one method-for-method.

Surface

• confer.recipes.{list, get, list_for_group}
• confer.groups.{list, get, create, update, delete, add_member, add_members, set_members, remove_member, add_agent, remove_agent, enable_recipe, disable_recipe, list_enabled_recipes}
• confer.agents.{list, get, create, update, delete, clone_to_group}
• confer.agent_types.{list, get} — closed catalog of agent archetypes
• confer.context_primitives.{list, get} — primitive JSON Schemas
• confer.agent_knowledge_facts.{list, add, update, remove, upload_document}
• confer.inquiries.{create, get, get_responders, list, cancel}
• confer.sandbox_runs.{create, list} — preview-then-launch sandbox flow
• confer.members.update(member_id=..., name=..., email=...)
• confer.inquiries.create(..., wait=True) — create + poll-to-terminal inline; wait_timeout_ms caps the wait at 90 s. timeout_seconds sets the inquiry's lifetime (a different knob). Replaces the former confer.ask().

See CHANGELOG.md for release history.

Errors

All calls raise ConferError(code, message, data) on failure. Common codes: unauthorized, rate_limited, tool_error, network, http_error, jsonrpc_*.

License

MIT.