67 lines
1.7 KiB
C
67 lines
1.7 KiB
C
// Nyash Plugin ABI v2 — TypeBox header (minimal)
|
||
// Notes:
|
||
// - This is the minimal, production-friendly subset used in Phase‑15.
|
||
// - Forward compatibility: hosts validate struct_size and version; fields may
|
||
// be extended in future minor revisions without breaking existing plugins.
|
||
// - See docs/reference/plugin-abi/nyash_abi_v2.md for the spec and roadmap.
|
||
#ifndef NYASH_ABI_V2_H
|
||
#define NYASH_ABI_V2_H
|
||
|
||
#include <stdint.h>
|
||
#include <stddef.h>
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
// Magic and version
|
||
#define NYASH_TYPEBOX_ABI_TAG 0x54594258u /* 'TYBX' */
|
||
#define NYASH_ABI_VERSION 1u
|
||
|
||
// Error codes
|
||
#define NYB_OK 0
|
||
#define NYB_E_SHORT -1
|
||
#define NYB_E_TYPE -2
|
||
#define NYB_E_METHOD -3
|
||
#define NYB_E_ARGS -4
|
||
#define NYB_E_PLUGIN -5
|
||
#define NYB_E_HANDLE -8
|
||
|
||
// TLV tags (version=1)
|
||
#define NYTLV_BOOL 1
|
||
#define NYTLV_I32 2
|
||
#define NYTLV_I64 3
|
||
#define NYTLV_F32 4
|
||
#define NYTLV_F64 5
|
||
#define NYTLV_STRING 6
|
||
#define NYTLV_BYTES 7
|
||
#define NYTLV_HANDLE 8 /* type_id:u32 + instance_id:u32 */
|
||
#define NYTLV_HOST 9 /* host handle: u64 */
|
||
|
||
typedef int32_t (*ny_invoke_id_fn)(
|
||
uint32_t instance_id,
|
||
uint32_t method_id,
|
||
const uint8_t* args,
|
||
size_t args_len,
|
||
uint8_t* out,
|
||
size_t* out_len
|
||
);
|
||
|
||
typedef uint32_t (*ny_resolve_fn)(const char* method_name);
|
||
|
||
typedef struct NyashTypeBoxFfi {
|
||
uint32_t abi_tag;
|
||
uint16_t version;
|
||
uint16_t struct_size;
|
||
const char* name; /* C string with trailing NUL */
|
||
ny_resolve_fn resolve; /* optional */
|
||
ny_invoke_id_fn invoke_id; /* required */
|
||
uint64_t capabilities; /* reserved, set 0 */
|
||
} NyashTypeBoxFfi;
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* NYASH_ABI_V2_H */
|