Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,11 @@

## Unreleased

- Added framework-neutral agent middleware with bounded context compilation,
model-facing JSON Schema tools, identity-bound Agent Intent dispatch,
durable turn recording, and embedded, in-process production, and HTTP
adapters.

## 1.0.0

- Declared Agent Intent 1.0 and the documented TypeScript, HTTP, MCP, CLI,
Expand Down
28 changes: 26 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -143,12 +143,12 @@ stale or inconsistent published evidence.
| Application-authored tables | 8 | 0 |
| Total operated tables | 8 | 18 |
| Median database footprint | 540,672 bytes | 1,572,864 bytes |
| Informational median runtime | 63.45 ms | 970.05 ms |
| Informational median runtime | 52.02 ms | 865.57 ms |

The result is deliberately not presented as a universal win:

- PostgreSQL matches the kernel on correctness.
- The smaller adapter reuses 930 lines of shipped scenario code and a 14,973
- The smaller adapter reuses 930 lines of shipped scenario code and a 16,424
line dependency. It is not an equal from-scratch implementation comparison.
- The kernel operates more tables, uses more storage, and takes substantially
longer in this deterministic smoke run.
Expand Down Expand Up @@ -245,6 +245,30 @@ execution command.

See the [API Reference](docs/API.md).

### Agent middleware

Agentic Data Kernel can be used as lifecycle middleware between an agent host
and its model. The host receives bounded durable context and JSON Schema tools;
model tool calls are translated into identity-bound Agent Intent operations,
and approved turns can be recorded as durable artifacts that are encrypted by
the production profile.

```ts
const session = createEmbeddedAgentMiddleware(kernel, principal).beginRun({
runId: "run:incident-1001",
});

const { context, tools } = await session.prepareModelInput({
query: "why is checkout failing?",
workflow: { instanceId: "incident:1001" },
});
```

Production agents can bind an authenticated `ProductionKernel` principal or
use the remote HTTP adapter. Direct MCP remains available when the model host
already owns context assembly and turn lifecycle. See
[Agent Middleware](docs/AGENT_MIDDLEWARE.md).

## When it fits

Use Agentic Data Kernel when several of these are true:
Expand Down
10 changes: 5 additions & 5 deletions benchmarks/sre/results/report.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

Generated from `summary.json`.

Source revision: `027bf5d55a8fd19a00f0477d162c7aaa779493cf`
Source revision: `e8b97677131117a403bba0202021d1b850598f00`

Source hash: `1744425ccd21f71ad1b37af903a622512d5968ac3dea712381c746c5ead2eda6`
Source hash: `59eec5ed80b8c4a470e9959b969a131197281f355df8e93b001bc843cfeb583e`

## Correctness

Expand All @@ -24,7 +24,7 @@ Both variants must resolve every run with one delivery and one reconciliation.

The adapter delegates to the shipped SRE scenario, which contains
930 nonblank TypeScript source lines inside the
dependency. The full kernel dependency contains 14973
dependency. The full kernel dependency contains 16424
nonblank TypeScript source lines.

The benchmark runner and engine-specific audit verification contain
Expand All @@ -44,8 +44,8 @@ operated, or upgraded.

| Variant | Median milliseconds |
| --- | ---: |
| Conventional PostgreSQL | 63.45 |
| Agentic Data Kernel | 970.05 |
| Conventional PostgreSQL | 52.02 |
| Agentic Data Kernel | 865.57 |

Runtime is not a headline metric. The variants perform different work and this
deterministic smoke benchmark is not a latency study.
Expand Down
22 changes: 11 additions & 11 deletions benchmarks/sre/results/summary.json
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@
"environment": {
"node": "v22.22.2",
"postgres": "18.6 (Debian 18.6-1.pgdg12+2)",
"commit": "027bf5d55a8fd19a00f0477d162c7aaa779493cf",
"sourceHash": "1744425ccd21f71ad1b37af903a622512d5968ac3dea712381c746c5ead2eda6"
"commit": "e8b97677131117a403bba0202021d1b850598f00",
"sourceHash": "59eec5ed80b8c4a470e9959b969a131197281f355df8e93b001bc843cfeb583e"
},
"runs": [
{
Expand All @@ -31,7 +31,7 @@
"provider reconciliation": true,
"verification and terminal state": true
},
"durationMs": 63.448800000000006
"durationMs": 70.5781
},
"operatedTables": 8,
"databaseBytes": 540672
Expand Down Expand Up @@ -59,7 +59,7 @@
"provider reconciliation": true,
"verification and terminal state": true
},
"durationMs": 933.0171
"durationMs": 926.5473999999999
},
"operatedTables": 18,
"databaseBytes": 1572864
Expand Down Expand Up @@ -87,7 +87,7 @@
"provider reconciliation": true,
"verification and terminal state": true
},
"durationMs": 53.32709999999997
"durationMs": 52.016099999999824
},
"operatedTables": 8,
"databaseBytes": 540672
Expand Down Expand Up @@ -115,7 +115,7 @@
"provider reconciliation": true,
"verification and terminal state": true
},
"durationMs": 970.0511999999999
"durationMs": 865.5692000000004
},
"operatedTables": 18,
"databaseBytes": 1572864
Expand Down Expand Up @@ -143,7 +143,7 @@
"provider reconciliation": true,
"verification and terminal state": true
},
"durationMs": 64.1876000000002
"durationMs": 50.6215000000002
},
"operatedTables": 8,
"databaseBytes": 540672
Expand Down Expand Up @@ -171,7 +171,7 @@
"provider reconciliation": true,
"verification and terminal state": true
},
"durationMs": 1042.3940000000002
"durationMs": 835.1620999999996
},
"operatedTables": 18,
"databaseBytes": 1572864
Expand Down Expand Up @@ -266,7 +266,7 @@
"authoredTables": 0,
"operatedTables": 18,
"scenarioSourceLines": 930,
"dependencySourceLines": 14973
"dependencySourceLines": 16424
}
},
"benchmarkHarness": {
Expand All @@ -277,8 +277,8 @@
"agenticDataKernelMedian": 1572864
},
"runtimeMillisecondsInformational": {
"conventionalPostgresMedian": 63.448800000000006,
"agenticDataKernelMedian": 970.0511999999999
"conventionalPostgresMedian": 52.016099999999824,
"agenticDataKernelMedian": 865.5692000000004
},
"explanationQuestions": 9,
"claims": {
Expand Down
Loading