Npcink AI Client Adapter

Description

Npcink AI Client Adapter connects local AI clients, such as OpenClaw-compatible tools, to a WordPress site through a focused REST adapter.

It is designed for sites that use Npcink Governance Core for reviewable AI operations and WordPress Abilities API providers, such as Npcink Abilities Toolkit, for concrete WordPress capabilities. The Adapter gives clients one stable WordPress REST surface for checking readiness, reading governance guidance, running approved read abilities, creating governed proposals, and executing supported writes only after Core approval and commit-preflight.

The default connection path uses signed key-pair pairing so the AI client does not need to receive a WordPress Application Password. A WordPress Application Password fallback is available for clients that already have a dedicated secret field or credential vault.

Adapter is intentionally thin. It does not define abilities, store approval truth, run workflow queues, act as an MCP server, manage model providers, store prompts, or execute arbitrary final write mutations. Governance remains in Npcink Governance Core. Ability definitions and callbacks remain in Npcink Abilities Toolkit or another WordPress Abilities API provider.

Adapter exposes a machine-readable client_policy on health, help, and the connection manifest so compatible clients can consume explicit route, output, sensitive-read, and write-flow boundaries. The local CLI also redacts profile paths, key ids, signing headers, tokens, passwords, and secrets from output, and its mcp subcommand runs a client-side stdio MCP server over the same signed profile with governed read, propose, preflight, and execute-after-human-approval tools only.

Current governed execution support covers explicit Adapter profiles after Core approval and commit-preflight: npcink-abilities-toolkit/trash-post, npcink-abilities-toolkit/create-draft, npcink-abilities-toolkit/update-post, npcink-abilities-toolkit/patch-post-content, npcink-abilities-toolkit/update-post-blocks, npcink-abilities-toolkit/update-template-blocks, npcink-abilities-toolkit/upsert-template-blocks, npcink-abilities-toolkit/update-template-part-blocks, npcink-abilities-toolkit/patch-setting-value, npcink-abilities-toolkit/set-post-seo-meta, npcink-abilities-toolkit/adopt-article-audio, npcink-abilities-toolkit/set-post-slug, npcink-abilities-toolkit/set-post-terms, npcink-abilities-toolkit/delete-term, npcink-abilities-toolkit/update-media-details, npcink-abilities-toolkit/upload-media-from-url, npcink-abilities-toolkit/set-post-featured-image, npcink-abilities-toolkit/optimize-media-asset, npcink-abilities-toolkit/replace-media-file, npcink-abilities-toolkit/restore-media-backup, npcink-abilities-toolkit/adopt-cloud-media-derivative, npcink-abilities-toolkit/rename-media-file, npcink-abilities-toolkit/delete-media-permanently, npcink-abilities-toolkit/reply-comment, npcink-abilities-toolkit/trash-comment, and npcink-abilities-toolkit/approve-comment.

Key features:

  • Connect OpenClaw-compatible and similar local AI clients to WordPress through one Adapter REST namespace.
  • Check Adapter readiness and dependency status before a client starts work.
  • Expose a machine-readable client_policy so clients can understand route, read, write, and sensitive-data boundaries.
  • Route approved direct-read requests through the WordPress Abilities API.
  • Forward governed write requests to Npcink Governance Core proposal and commit-preflight endpoints.
  • Support human-approved final execution for explicit, supported execution profiles after Core approval, plus a unified approve-and-execute action reserved for WordPress administrator sessions.
  • Prefer signed key-pair pairing for local clients, with an Application Password fallback when appropriate.
  • Keep channel, governance, ability, cloud, and model-provider responsibilities separate.

Screenshots

Installation

  1. Install and activate npcink-abilities-toolkit.
  2. Install and activate npcink-governance-core.
  3. Install and activate Npcink AI Client Adapter.
  4. Open Npcink > Adapter to create the local AI client handoff.

FAQ

Does Adapter approve proposals?

Adapter provides an approve-and-execute action for supported execution profiles, reserved for WordPress administrator sessions. Signed AI clients cannot approve their own proposals: a human approves in the Npcink Governance Core admin and the client then calls the execute route. Npcink Governance Core remains the governance backend for proposal storage, approval, commit-preflight, and audit.
Execution abilities are declared by Npcink Abilities Toolkit and approved by Npcink Governance Core; Adapter supplies only the post-preflight channel.

Does Adapter execute arbitrary abilities?

No. Adapter executes only explicit, supported execution profiles after Core approval and commit-preflight. It is not a generic ability executor and does not bypass Core governance.

Do I need other Npcink plugins?

Yes. Npcink Abilities Toolkit provides the ability definitions and callbacks used by the Adapter. Npcink Governance Core is required for governed proposals, approval, commit-preflight, and audit.

Which AI clients can connect?

Adapter is built for OpenClaw-compatible local clients and similar tools that can call authenticated WordPress REST endpoints and consume the Adapter client_policy.

Does Adapter send my WordPress password to an AI client?

The recommended signed key-pair path avoids giving the client a WordPress Application Password. Adapter stores only the approved public key. The Application Password path remains available as a fallback for clients with a dedicated secret field or credential vault.

Does Adapter run AI models or store prompts?

No. Adapter is a channel layer. It does not provide model routing, prompt management, provider credentials, workflow queues, or hosted AI execution.

What happens if dependencies are missing?

Adapter health and help routes can report dependency status. Routes that require Npcink Governance Core or a WordPress Abilities API provider fail closed with a structured missing dependency error.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Npcink AI Client Adapter” is open source software. The following people have contributed to this plugin.

Contributors

“Npcink AI Client Adapter” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “Npcink AI Client Adapter” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

0.4.2

  • Reject non-numeric limit query parameters on proposal and sensitive read-request list routes with the standard WordPress REST 400 error envelope instead of silently coercing them to 1.
  • Unify consumer-facing REST error details and complete /help and connection-manifest discovery for the shipped route surface, including actionable administrator-session and malformed-id responses.
  • Synchronize consumer documentation with the 26 explicit post-Core execution profiles and add a route-drift release gate.
  • Surface missing dependencies, contract mismatches, and recent client errors in the Adapter admin page; clean up tracked fallback Application Password credentials on revocation and uninstall.
  • Mark the 0.4.0 administrator-session restriction for unified approve-and-execute as a breaking change for signed clients.

0.4.1

  • Verification integrity with Governance Core 0.3.0 (ADR-012/ADR-013): executions request execution-attached verification reads at commit preflight and present them on action results; after execution, block readbacks that could not be verified get a Core-recorded, result-bound second chance (provisional-record supplement), so objects created inside the same batch verify through Core-minted evidence instead of degrading. The recorded readback metadata always reflects the latest attempt, and the supplement re-runs log through the same request context as the first pass. Verification-read features require Governance Core 0.3.0 or newer.
  • Adopt the Governance Core 0.2.x/0.3.0 REST contract changes: recoverable preflight handoffs (409 envelope with correlation id and expiry), app_auth_expired hints, the 429 retry relay honoring delay-seconds Retry-After, contract:read fallback, and audit offset passthrough.
  • Administrator review hardening from the 2026-10 AI review backlog: server-side ability_id enforcement on governed routes, hardened governed-write locks and handoff consumption, structured CLI schema enforcement with redaction, and admin-surface fixes.
  • Complete the zh_CN catalog (0 fuzzy, 0 untranslated) and gate translation coverage at release.
  • Split the controller into behavior-preserving domain services (signing auth, execution records, upstream dispatch, dependency status, preflight handoffs, read governance, proposal review, contract metadata) and promote static analysis (PHPStan, PHPCS) plus the delivered-review triage gate to required CI.
  • Return structured, actionable authentication errors for signed requests: credential completeness, clock skew, and body-hash mismatches now carry distinct stable codes with reason and next_step data instead of a generic rest_forbidden; key-record and signature failures share one pre-verification code so key liveness is never observable without the private key; scope and nonce-replay causes are reported only after the signature verifies. Requests without credentials receive npcink_openclaw_adapter_authentication_required pointing at the device-pairing entry, and logged-in non-administrator accounts receive npcink_openclaw_adapter_privilege_required.
  • Pairing rate-limit responses now set the standard Retry-After response header alongside the existing error data.
  • Remove stale GET /terms/GET /term purpose strings from /help route discovery.
  • Companion CLI 0.6.0: failed Adapter responses now print the full error envelope including data.operator_feedback, next_step, and retry_after (redacted); the bounded AI image ratio crop recipe helper now mirrors the reviewed recipe contract locally because Adapter /help no longer carries recipe playbooks.

0.4.0

  • Restrict the unified approve-and-execute action to WordPress administrator sessions. Signed AI clients now wait for human approval in the Npcink Governance Core admin and then call the execute route; signed attempts on the unified route fail closed with npcink_openclaw_adapter_approve_requires_admin_session.
  • Add client_policy.boundary_enforcement (client policy version 2) so clients can distinguish enforced key-pair connections from conventional WordPress-native credentials.
  • Add the connection readiness checklist and CLI boundary status reporting.
  • Document the governed MCP tool surface of the companion CLI (@npcink/openclaw-adapter-cli 0.5.0): read, propose, preflight, and execute-after-human-approval tools only, with no self-approval tool.

0.3.3

  • Harden release packaging, uninstall cleanup, and batch execution contract checks.
  • Preserve actionable, redacted CLI output when the signed local acceptance fixture fails.

0.3.2

  • Close the release-candidate boundary by keeping media derivative transport outside Adapter and retaining only reviewed adoption handoff.
  • Require explicit signed-client execute scope for final Adapter write routes.
  • Restore Core capability forwarding and default execution response compatibility for consumer smoke coverage.

0.3.1

  • Bind Adapter final execution to Core approval and commit-preflight execution handoffs.
  • Forward signed local client fingerprints to trusted Core app-token requests and fail closed on mismatched Core contexts.
  • Validate Core dependency contract semantics for site and signed-client bindings before reporting dependency readiness.

0.3.0

  • Add Adapter-declared Core and Abilities Toolkit compatibility floors to the machine-readable contract metadata.
  • Record a signed local AI client create-draft proposal, approve-and-execute, readback, and cleanup acceptance pass.

0.2.1

  • Add contract snapshot smoke coverage across health, help, and connection manifest responses.
  • Reject batch write actions that request core_proxy_execute=true before Adapter execution.
  • Expand negative smoke coverage for core_proxy_execute and commit_execution batch fail-closed behavior.

0.2.0

  • Add machine-readable Adapter contract metadata and stable contract hashes on health, help, and manifest responses.
  • Add the local AI client acceptance command for non-destructive Adapter/Core boundary checks.
  • Align block theme visual acceptance, batch review feedback, and release package smoke documentation with the governed execution profile boundary.

0.1.1

  • Add local AI client CLI helper commands, output redaction, and machine-readable client policy.

0.1.0

  • Initial thin AI client adapter for Npcink Governance Core and WordPress Abilities API routing.