seegraph-client 0.1.0

Python client for seegraph-core

seegraph-client

Python client for seegraph-core.

Install

pip install seegraph-client

Quickstart

Agent loop (without MCP)

from seegraph_client import AsyncSeegraphClient, StackTraceEntry

sg = AsyncSeegraphClient(url="http://localhost:8000")

# Traverse the knowledge hierarchy
result = await sg.think.query("how do we handle NDA renewals?")
print(result.node_path)           # e.g. ["Sales", "Enterprise"]
print(result.skills_activated)    # list of Skill objects

# Record reference resolution (use_reference equivalent)
await sg.stack_traces.append_entry(
    result.stack_trace_id,
    StackTraceEntry(depth=-1, node="Renewal Script", decision="activate", rationale="Resolved reference"),
)

# Submit new knowledge, linked back to this traversal
await sg.queue.submit(
    summary="NDAs over $500k require legal sign-off",
    processes=[{"name": "NDA Review", "description": "Review process for high-value NDAs"}],
    stack_trace_id=result.stack_trace_id,
    agent_id="my-agent-v1",
)

Approver workflow

from seegraph_client import SeegraphClient, SeegraphNotFoundError

with SeegraphClient(url="http://localhost:8000") as sg:
    try:
        plan = sg.plans.pending()
        print(f"Plan {plan.id}: {len(plan.operations)} operations")
        approved = sg.plans.approve(plan.id)
        print(f"Applied: {approved.status}")
    except SeegraphNotFoundError:
        print("No plan pending review")

Resources

Resource	Methods
client.think	query(prompt)
client.queue	submit(summary, processes, raw_transcript?, stack_trace_id?, agent_id?), status(), flush()
client.plans	list(status?), get(id), pending(), approve(id), defer(id), defer_submission(plan_id, sub_id), rollback(id), delete(id)
client.nodes	get(node_id, include?), subtree(node_id?, depth?), children(node_id)
client.stack_traces	get(trace_id), append_entry(trace_id, entry)

Both SeegraphClient (sync) and AsyncSeegraphClient (async) provide identical resources.

Error handling

from seegraph_client import SeegraphNotFoundError, SeegraphServerError

try:
    plan = sg.plans.get("bad-id")
except SeegraphNotFoundError as e:
    print(e.status_code, e.request_url)
except SeegraphServerError as e:
    print(e.raw_body)

Development

pip install -e ".[dev]"
python -m pytest
ruff check seegraph_client/ tests/