graphjin 3.18.43 → 3.18.45

package/README.md

@@ -1,4 +1,4 @@
-# GraphJin - The Governed Data Plane for AI Agents
+# GraphJin — One Governed Graph for Your AI Agents
 
 [![Apache 2.0](https://img.shields.io/github/license/dosco/graphjin.svg?style=for-the-badge)](https://github.com/dosco/graphjin/blob/master/LICENSE)
 [![NPM Package](https://img.shields.io/npm/v/graphjin?style=for-the-badge)](https://www.npmjs.com/package/graphjin)
@@ -7,7 +7,7 @@
 [![GoDoc](https://img.shields.io/badge/godoc-reference-5272B4.svg?style=for-the-badge&logo=go)](https://pkg.go.dev/github.com/dosco/graphjin/core/v3)
 [![GoReport](https://goreportcard.com/badge/github.com/gojp/goreportcard?style=for-the-badge)](https://goreportcard.com/report/github.com/dosco/graphjin/core/v3)
 
-GraphJin is a compiler and runtime that lets AI agents connect to the systems a real company already has: databases, warehouses, files, source code, workflows, metadata, and security policy. Instead of handing an agent raw credentials and hoping it guesses correctly, GraphJin gives it one governed GraphQL + MCP surface where it can discover before acting, validate queries, run approved work, and observe runtime status.
+GraphJin is a compiler and runtime that gives AI agents one governed graph over the systems a real company already has: databases, warehouses, files, source code, workflows, metadata, and security policy. Instead of handing an agent raw credentials and hoping it guesses correctly, GraphJin exposes that graph through GraphQL + MCP: the agent discovers before acting, validates queries, runs approved work, observes runtime status — and every answer is checked against an execution ledger before it leaves the server.
 
 It is not only for agents. GraphJin is still a high-performance GraphQL-to-database compiler, Go library, standalone API service, REST/OpenAPI gateway, and real-time subscription server. The agent use case is where everything comes together: the same compiler that serves your apps can also give AI a smart, auditable way to work across data, code, and operations.
 
@@ -51,57 +51,58 @@ docker pull dosco/graphjin
 
 ## Try It Now
 
-This is a quick way to try out GraphJin. The `--demo` flag runs a curated local
-demo, creates local state under the example's `demo/` folder, and reuses that
-state on later starts. Delete `demo/` to reset from scratch.
+One command, no clone, no Docker. The binary ships with a built-in demo — a
+SaaS company ops app (accounts, subscriptions, invoices, support tickets) on
+SQLite with seeded data, saved queries, and workflows:
 
-Download the source which contains the `webshop` demo
-```
-git clone https://github.com/dosco/graphjin
-cd graphjin
-```
-
-Now launch the Graphjin service that you installed using the install options above
 ```bash
-graphjin serve --demo --path examples/webshop
+graphjin serve --demo
 ```
 
-For a larger agent-driven example with Postgres operations data, a BigQuery
-simulator for roast telemetry, CodeSQL over internal business code, and
-executable workflows:
+The demo project is extracted to `./graphjin-demo`, and its state lives under
+`./graphjin-demo/demo/`. Delete the `demo/` folder to reset the data, or
+delete `./graphjin-demo` entirely for a fresh copy. You'll see output like
+this:
 
-```bash
-graphjin serve --demo --path examples/coffee-roastery
-```
-
-More demo verticals — a MySQL corrugated-box plant with JWT roles, a PCB fab
-spanning Postgres + Snowflake-emu + MongoDB + a file source + an OpenAPI
-supplier API, and a zero-Docker SQLite clinic scheduler — live in
-[examples/](examples/README.md), each with an end-to-end smoke suite
-(`make smoke-all` runs them all).
-
-You'll see output like this:
 ```
 GraphJin started
 ───────────────────────
-  Web UI:      http://localhost:8080/
-  GraphQL:     http://localhost:8080/api/v1/graphql
-  REST API:    http://localhost:8080/api/v1/rest/
-  Workflows:   http://localhost:8080/api/v1/workflows/<name>
-  MCP:         http://localhost:8080/api/v1/mcp
+  Web UI:      http://localhost:8083/
+  GraphQL:     http://localhost:8083/api/v1/graphql
+  REST API:    http://localhost:8083/api/v1/rest/
+  Workflows:   http://localhost:8083/api/v1/workflows/<name>
+  MCP:         http://localhost:8083/api/v1/mcp
 ```
 
 **Ask the built-in agent**
 
-With a model API key in `./.env` (`OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, or `GOOGLE_APIKEY`), `--demo` also switches into agentic mode and enables GraphJin's built-in agent - one instruction in, a typed, evidence-backed answer out. Against the coffee-roastery demo:
+With a model API key in `./.env` (`OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, or `GOOGLE_APIKEY`), the same command switches into agentic mode and enables GraphJin's built-in agent - one instruction in, a typed, evidence-backed answer out:
 
 ```bash
-curl -sS localhost:8080/api/v1/agent \
+curl -sS localhost:8083/api/v1/agent \
   -H 'content-type: application/json' \
-  -d '{"instruction": "What production work should we prioritize next?"}'
+  -d '{"instruction": "Which account is most at risk of churning?"}'
+```
+
+Answers come back as `{status, answer, data, evidence, actions, next}`, grounded by server-side protocol guards. You can also chat with it in the built-in web console at `localhost:8083/agent` — it streams every tool call live as it works. See [Server-Side Agent](#server-side-agent) below, [AGENTIC.md](AGENTIC.md#server-side-agent), and [graphjin.com/agentic/server-agent](https://graphjin.com/agentic/server-agent/).
+
+**More demo verticals**
+
+The bigger demos live in the repo — clone it and pass `--path`:
+
+```bash
+git clone https://github.com/dosco/graphjin
+cd graphjin
+graphjin serve --demo --path examples/webshop          # classic GraphQL starter (Postgres)
+graphjin serve --demo --path examples/coffee-roastery  # flagship agentic demo (Postgres + BigQuery-emu + CodeSQL)
 ```
 
-Answers come back as `{status, answer, data, evidence, actions, next}`, grounded by server-side protocol guards. See [Server-Side Agent](#server-side-agent) below, [AGENTIC.md](AGENTIC.md#server-side-agent), and [graphjin.com/agentic/server-agent](https://graphjin.com/agentic/server-agent/).
+Each demo keeps its state under `<path>/demo/` and reuses it on later starts.
+A MySQL corrugated-box plant with JWT roles and a PCB fab spanning Postgres +
+Snowflake-emu + MongoDB + a file source + an OpenAPI supplier API live in
+[examples/](examples/README.md), each with an end-to-end smoke suite
+(`make smoke-all` runs them all). The full tour is at
+<https://graphjin.com/start/demos/>.
 
 ## Add GraphJin To Your AI Client
 
@@ -389,6 +390,16 @@ mutation {
 }
 ```
 
+PostgreSQL and SQLite also support an update-free insert conflict policy for a single row. GraphJin infers one supplied unique key and returns the stored row unchanged on conflict:
+
+```graphql
+mutation {
+  users(insert: { email: "ada@example.com", full_name: "Ada" }, on_conflict: get) {
+    id email full_name
+  }
+}
+```
+
 **Spatial queries:**
 ```graphql
 {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "graphjin",
-  "version": "3.18.43",
-  "description": "GraphJin CLI - Build APIs in 5 minutes with GraphQL",
+  "version": "3.18.45",
+  "description": "GraphJin — one governed graph for AI agents: GraphQL + MCP over your databases, files, APIs, and code",
   "bin": {
     "graphjin": "bin/graphjin.js"
   },