Blueprint section 10: a first-class plugin ABI independent of the legacy MARQDO_ABI_VERSION=2, with a C ABI that is explicitly not a sandbox. - include/marqdo_plugin_abi_v1.h: frozen stable-layout C contract with documented buffer ownership/lifetimes, size limits, NULL/zero-length semantics, single-threaded invocation, no hot-unload policy, version negotiation and target-triple requirements. - marqdo-plugin-abi (host side): repr(C) mirrors with compile-time layout assertions, major/minor negotiation (wrong major fails, minor clamps), plugin.yaml parsing/validation, target selection and sha256 artifact verification, wire_version 1 typed JSON request/response envelopes, structured PluginError, and a libloading-based loader with host alloc/free, export registration and runtime ABI re-negotiation. - marqdo-plugin-sdk (plugin side): mq_plugin_entry! macro, panic containment, safe byte-buffer wrappers, capability/logging context and JSON helpers; it depends only on the shared ABI crate. - examples/plugin-demo: dependency-free C plugin (solver.add), manifest, build.sh that refreshes the artifact hash, README explaining that install, inspect and load are three different trust decisions. - Tests: C plugin cross-compiled with cc and loaded, plus wrong ABI major, missing symbol/artifact, hash mismatch and malformed manifest cases.
26 lines
821 B
YAML
26 lines
821 B
YAML
# Example Marqdo plugin manifest (plugin ABI v1).
|
|
#
|
|
# Installing this package never grants permissions. Loading the native library
|
|
# additionally requires an explicit trust decision by the host/user; a C ABI is
|
|
# not a sandbox. Replace the sha256 below with the digest of the artifact you
|
|
# actually build:
|
|
#
|
|
# sha256sum examples/plugin-demo/solver.so
|
|
#
|
|
# and replace `target` with your host's Rust target triple if it is not
|
|
# x86_64-unknown-linux-gnu (`rustc -vV | grep host`).
|
|
plugin:
|
|
name: demo.solver
|
|
version: 0.1.0
|
|
abi: "^1.0"
|
|
kind: native
|
|
exports:
|
|
- name: solver.add
|
|
signature: "($a: Int, $b: Int) -> Int"
|
|
requires:
|
|
- math.compute
|
|
artifacts:
|
|
- target: x86_64-unknown-linux-gnu
|
|
file: solver.so
|
|
sha256: "0000000000000000000000000000000000000000000000000000000000000000"
|