@oiap/core

Core primitives and author-facing helpers for Open Interoperable Agent Plugins.

This package defines the stable TypeScript contract that plugin authors use to describe plugins once before target exporters render host-specific bundles.

import { allow, definePlugin, hook } from "@oiap/core";

export default definePlugin({
	manifest: {
		id: "example",
		name: "Example Plugin",
		version: "0.0.0",
		description: "Example OIAP plugin.",
		categories: ["example"],
		supportedTargets: ["gemini-cli", "hermes"],
	},
	hooks: [
		hook.beforeTool("allow-all", () => {
			return allow();
		}),
	],
});

The package intentionally contains contracts and small authoring helpers only. Target-specific rendering belongs in exporter packages.

Long Markdown instruction bodies can live beside the plugin file instead of in template strings:

import { definePlugin, markdownFile } from "@oiap/core";

export default definePlugin({
	instructions: [
		{
			id: "review-workflow",
			purpose: "workflow",
			triggers: ["review"],
			body: markdownFile("instructions/review-workflow.md"),
		},
	],
});

Relative paths resolve from the calling module. Pass baseUrl: import.meta.url when you want to make that relationship explicit.