{
"id": "agent-first-psql",
"version": "0.2.1",
"name": "Agent-First PSQL",
"domain": "cmn.dev",
"synopsis": "Persistent PostgreSQL client for AI agents — JSONL in, JSONL out, connection lifecycle managed transparently",
"intent": [
"Give AI agents a persistent PostgreSQL client that reuses long-lived database connections and sessions, so agents send SQL requests as JSONL and receive structured JSONL responses without managing connection setup",
"Bridge ad-hoc psql shell usage and protocol-specific integrations by providing transport-neutral, agent-native request and response framing",
"Provide predictable machine-readable outputs for row sets, command status, and errors so agent workflows can branch without parsing human-formatted terminal output"
],
"mutations": [
"Add --dry-run flag and Output::DryRun variant to preview SQL queries without executing, emitting the resolved SQL, params, and session for agent inspection",
"Add error hint field to Output::Error, providing actionable suggestions for connection failures and result size limits",
"Upgrade agent-first-data dependency from 0.5 to 0.6 to use the new hint parameter on build_cli_error"
],
"license": "MIT",
"bonds": [
{
"uri": "cmn://cmn.dev/b3.AwNhTbTQiv5XwAJeKaMHRv2LxcweHudyLWYPh4qcP11J",
"relation": "depends_on",
"id": "agent-first-data",
"reason": "All request/response fields use Agent-First Data suffix conventions and output formats"
}
],
"tree": {
"algorithm": "blob_tree_blake3_nfc",
"excludes": [
".git"
],
"ignore_rules": [
".gitignore"
]
}
}