agent-first-psql 0.3.0

Persistent PostgreSQL client for AI agents — SQL-native JSONL in, JSONL out
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

{
  "id": "agent-first-psql",
  "name": "Agent-First PSQL",
  "version": "0.3.0",
  "domain": "cmn.dev",
  "key": "ed25519.7BmCWmBb2YeUWR7pmHvwAvi9wRm96VpZsJvZFSTfc2Uu",
  "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": [
    "Rewrite MCP server using rmcp SDK with typed tool routing — execute_sql and psql_config are now proper MCP tools with JsonSchema parameter validation, replacing the hand-rolled JSON-RPC framing that required agents to know the wire format",
    "Add hint field to CLI error outputs, giving agents actionable next-step suggestions when argument parsing or startup fails",
    "Improve result_too_large error message to suggest stream_rows=true as the primary remedy, making the retry path clearer for agents hitting inline row/byte limits"
  ],
  "license": "MIT",
  "bonds": [
    {
      "relation": "spawned_from",
      "uri": "cmn://cmn.dev/b3.bjdRyoeA17dnkgFt7xZ2g8isnKkwcx1ZcikgGJXNR4Y"
    },
    {
      "relation": "depends_on",
      "uri": "cmn://cmn.dev/b3.4Q6SQVbb9HLB8ffJpzuqECtq8TZZrBXzHtqoHgJXoNJ5",
      "id": "agent-first-data",
      "reason": "All request/response fields use Agent-First Data suffix conventions and output formats"
    }
  ],
  "tree": {
    "algorithm": "blob_tree_blake3_nfc",
    "exclude_names": [
      ".git"
    ],
    "follow_rules": [
      ".gitignore"
    ]
  }
}