Skip to content
View KXHXK's full-sized avatar

Block or report KXHXK

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
KXHXK/README.md

🧠 AI Agent Engineering

Building reliable Agent runtimes, typed semantic harnesses, tool and knowledge boundaries,
evaluation pipelines, failure recovery, and full-stack systems that make model behavior verifiable.

AI Agent engineering portfolio OperCerta repository FieldPilot repository

🔬 Featured Agent Systems

🛡️ OperCerta — Controlled Agent Runtime

A recoverable, evaluable, and auditable Agent runtime for operational workflows.

  • Single-root LangGraph Agent Loop: Model → ToolPolicy → MCP Observation → Model
  • Typed Context/State, PostgreSQL Checkpoint/Replay, HITL approval binding, fact re-fetch, Verifier, and idempotent writes
  • FastAPI, FastMCP, PostgreSQL/pgvector, Redis, React/SSE, OpenTelemetry, Docker, and CI
  • Evidence: 42/42 fixed business contracts, 9/9 safe recovery traces, and 0 duplicate work orders across 20 × 10 concurrent writes
  • Redis reduced repeated MCP reads from 10 to 2 (-80%); fixed local scenarios reduced P50 by 58%–61%
  • 🌐 Engineering showcase · 💻 Source code

🧭 FieldPilot — Typed Semantic Harness

A cross-city field-mission Agent that isolates LLM uncertainty at the natural-language boundary.

  • A no-tool PydanticAI Harness converts untrusted text into a strict, confirmable MissionDraft
  • Deterministic postchecks recompute clarifications, safety labels, and date normalization
  • Bounded Beam Planner, Policy Engine, Independent Verifier, ExecutionCheckpoint, and suffix-only replanning
  • Idempotent AgentRun, input fingerprints, usage limits, auditable traces, and no-fallback live evaluation gates
  • Evidence: 15/15 Kimi K2.6 live, state/safety 100%, field precision 94.87%, clarification precision 93.33%
  • 🌐 Project showcase · 💻 Source code

🧩 Agent Engineering Focus

🔁 Runtime & State

Agent Loop, Context/State, Checkpoint/Replay, human approval, failure recovery, concurrency control, and idempotent side effects.

🔌 Tools & Knowledge

Tool Calling, MCP, RAG, hybrid retrieval, citations, permission boundaries, policy checks, caching, and external provider ports.

📏 Evaluation & Observability

Versioned datasets, deterministic contracts, live-model gates, Trace, failure replay, latency/cost analysis, and regression tests.

🧱 Full-Stack Productization

FastAPI, PostgreSQL, Redis, React/Vue, TypeScript, Docker, CI, cloud deployment, and operational documentation.

🛠️ Technology Stack

Agent / AI

LangGraph PydanticAI MCP RAG OpenTelemetry

Languages / Application

Python TypeScript C# FastAPI React Vue.js

Data / Delivery

PostgreSQL Redis Docker GitHub Actions Netlify Render

🌍 Upstream Open-Source Engineering

Thirteen contributions have been accepted upstream across established Agent and developer-tool projects: 12 directly merged PRs plus one Langroid fix merged through a maintainer PR with authorship retained. Personal repository work is excluded.

Project Stars Engineering contribution
DeerFlow #4804 80.1k Scoped bootstrap memory reads and writes to the selected custom Agent instead of leaking setup facts into the default memory bucket, with regression coverage.
Cherry Studio #18475 50.4k Removed a duplicate workspace-list request after creation while preserving the existing mutation-owned refresh and workspace selection flow.
AgentScope #2178 28.9k Kept tool-response error states sticky across later interrupted or denied chunks and added regression coverage.
Mastra #21154 27.2k Preserved the provider-selected response model on inference spans without overwriting the requested model.
Haystack #12327 26.2k Added static type checking for Agent state tests so state-schema regressions are caught during CI.
Microsoft Agent Framework #7324 12.8k Preserved table binding across consecutive declarative EditTable operations and added regression coverage.
OpenSandbox #1519 12.6k Replenished stale idle sandbox slots immediately after asynchronous cleanup and added deterministic Kotlin regression coverage.
local-deep-research #5269 8.9k Unified Zotero progress and error feedback while preserving accessibility and XSS-safe rendering.
OGX #6395 8.4k Documented supported search rankers in the generated API schema and added regression coverage for the description contract.
Strands Agents Harness SDK #3627 6.9k Preserved token usage from hook-retried model calls so cost reporting and invocation limits remain accurate.
Langroid #1072 4.1k Fixed concurrent result selection so a fast empty result cannot cancel a slower valid result; the maintainer PR retained KXH authorship.
A2A Java #999 0.5k Corrected interoperability test topology while preserving valid JSON-RPC and gRPC coverage.
DevOps AI Toolkit / dot-ai #754 0.3k Fixed local embedding-model configuration in both normal and prefetched Helm paths, including the maintainer-requested test refinement.

Current PR Status

As of August 18, 2026, 30 external PRs remain open. The recently active review queue is summarized below; the remaining PRs have no unanswered maintainer request.

Pull request Current state Next step
Qwen Code #9045 Re-review reports no blockers and leaves three non-blocking suggestions Await maintainer direction
LobeHub #18260 Updated from canary; maintainer edits enabled Await maintainer-owned CI and review
OpenHands #16576 Human evidence completed; ready for review Await maintainer review
OpenHands #16116 Code CI passes; linked issue needs maintainer-controlled readiness label Await maintainer label and review
LiteLLM #36745 CLA signed; mergeable with required checks passing Await maintainer review
Mastra #21368 Requested changes addressed; no unresolved threads Await re-review

📐 Engineering Principles

  • 🧠 The model handles ambiguity; deterministic code decides correctness and side effects.
  • 🧾 Metrics need datasets, scripts, runtime conditions, and commits—not just screenshots.
  • 🔒 Public demos use synthetic or redacted data and expose no credentials or private systems.
  • 🧪 Failure recovery, idempotency, policy checks, and evaluation are product behavior.
  • 🧱 Agent engineering includes APIs, state, data, UI, deployment, and operations—not only model calls.

🛰️ Broader Systems Background

Beyond Agent systems, repositories include C# serial/device communication tools, MATLAB signal-processing and imaging utilities, PDF report generation, and full-stack Web applications. These projects provide the systems, data, debugging, and delivery foundation behind the Agent work.

Pinned Loading

  1. opercerta opercerta Public

    Auditable AI operations agent for inventory exceptions, equipment alerts, and human-approved workflows.

    Python 39

  2. fieldpilot fieldpilot Public

    Policy-aware field mission orchestration agent with bounded planning, auditable replanning, travel and expense constraints.

    Python 21

  3. kls-serial-utility kls-serial-utility Public

    Windows Forms serial utility for K-band and dual-band transceiver protocol testing.

    C# 2

  4. matlab-imaging-tools matlab-imaging-tools Public

    MATLAB tools for sensor-frame parsing, signal imaging, 2D trajectories, and 3D target visualization.

    MATLAB 2

  5. pdf-report-generator pdf-report-generator Public

    C# PDF report generator for text, images, and JSON with tables, watermarks, and page numbers.

    C# 2

  6. Serial Serial Public

    C# Windows Forms serial-port assistant for configuring connections and exchanging hexadecimal data.

    C# 2