wippa-project-manager (Python client)

Project management where an agent can be the assignee, and a task is only done when a run report proves it.

This is the client SDK, not a Python port of the server. The server is Node; porting it would mean two implementations of the completion gate, and the gate is the entire product. This package sends, reports, and decides nothing.

Install

pip install wippa-project-manager

Zero runtime dependencies. Deliberate: this client runs inside agents executing untrusted work, where every dependency is another package somebody has to trust, pin and audit in their own sandbox.

Use

from wippa_project_manager import AgentDescriptor, Capability, Client, obj_schema

client = Client()                       # http://127.0.0.1:8790

client.register_agent(AgentDescriptor(
    id="agent.reviewer",
    name="Reviewer",
    version="1.0.0",
    description="Reviews a diff",
    capabilities=(Capability(
        name="code.review",
        description="Review a diff and return findings",
        input_schema=obj_schema(diff=str, repo=str),
        output_schema=obj_schema(findings=list, verdict=str),
        tags=("review",),
    ),),
    transports=({"kind": "http"},),
))

task = client.create_task(
    "Review the auth diff",
    requirements=[{
        "name": "code.review",
        "inputSchema": obj_schema(diff=str, repo=str),
        "outputSchema": obj_schema(findings=list, verdict=str),
    }],
)

client.claim_task(task["id"], "agent.reviewer")
result = client.run(task["id"])
print(result["task"]["status"], result["report"]["outputHash"])

A claim can be refused, and it says why

from wippa_project_manager import ClaimRefused

try:
    client.claim_task(task["id"], "agent.partial")
except ClaimRefused as exc:
    print(exc.reason)
    # "code.review: output: output is missing 1 field(s): findings"

That is more useful than a boolean: it tells you which shape to change. Refusals are recorded server-side, so they are the log of which task descriptions are unmeetable.

Status codes are not flattened

Collapsing these into "request failed" would hide the two outcomes worth noticing.

The wire format

AgentDescriptor, Capability and Envelope mirror the published wippa-uacp JSON Schemas, so a Python agent and a TypeScript agent speak the same shape. No uacp source is copied.

Server

wippa-studios/wippa-project-manager

npm run demo     # the vertical slice, in memory
npm start        # API + dashboard on 127.0.0.1:8790

License

MIT