agent-first-psql 0.6.0

A PostgreSQL interface for AI agents: reliable, structured, explicit, and safe by default.
Documentation 
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
41
42
43
44
45
46
47

{
  "$schema": "https://cmn.dev/schemas/v1/spore-core.json",
  "id": "agent-first-psql",
  "name": "Agent-First PSQL",
  "version": "0.6.0",
  "domain": "agentfirstkit.com",
  "key": "ed25519.BwbSzqdDYyMN1pPW5snRk3afrJAovHn8aueMvDpfNKVw",
  "synopsis": "A PostgreSQL interface for AI agents: reliable, structured, explicit, and safe by default.",
  "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"
  ],
  "license": "MIT",
  "mutations": [
    "Add SSH transport (--ssh) so afpsql can run locally against PostgreSQL listening only on a remote loopback.",
    "Make write permission explicit with --permission read|write|ssh-read|ssh-write; reads are the default.",
    "Require explicit sudo bridge socket path for sudo-based SSH auth.",
    "Harden pipe mode: stricter config validation, SSH tunnel checks, savepoint stream draining, duplicate-column rejection.",
    "Pin named pipe sessions to stable PostgreSQL backend sessions with FIFO execution for predictable session state.",
    "Tighten CLI input limits, result limits, and startup logging so argv and secrets no longer leak.",
    "Adopt afdata's redaction options for consistent secret scrubbing across the toolkit.",
    "Render psql result rows raw to preserve structured values.",
    "Add --mode psql covering common non-interactive psql flags so existing scripts can swap in afpsql.",
    "Add the afpsql Agent Skill so coding agents pick up read-by-default and SQLSTATE-based error handling.",
    "Document the psql wrapper workflow (afpsql psql install/status) and reframe README around the reliability contract.",
    "Harden release packaging to drop local path deps and stale workspace metadata."
  ],
  "bonds": [
    {
      "relation": "depends_on",
      "uri": "cmn://agentfirstkit.com/b3.DLwVyPLJRtv7KwfXD25E7zkpveZVykRgo2RQJkHp9zZZ",
      "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",
      ".cmn"
    ],
    "follow_rules": [
      ".gitignore"
    ]
  }
}