@agentplugins/core 0.1.0

package/dist/registry.js

@@ -0,0 +1,76 @@
+/**
+ * AgentPlugins Adapter Registry
+ *
+ * Central registry for all platform adapters.
+ * Adapters register themselves; the CLI and build system look them up here.
+ */
+const adapterMap = new Map();
+/**
+ * Register a platform adapter factory.
+ * Called by each adapter package during initialization.
+ */
+export function registerAdapter(platform, factory) {
+    adapterMap.set(platform, factory);
+}
+/**
+ * Check if an adapter is registered for a platform.
+ */
+export function hasAdapter(platform) {
+    return adapterMap.has(platform);
+}
+/**
+ * Load a platform adapter asynchronously.
+ */
+export async function loadAdapter(platform) {
+    const factory = adapterMap.get(platform);
+    if (!factory) {
+        throw new Error(`No adapter registered for platform "${platform}". ` +
+            `Install the corresponding adapter package: npm install @agentplugins/adapter-${platform}`);
+    }
+    return factory();
+}
+/**
+ * Load all registered adapters.
+ */
+export async function loadAllAdapters() {
+    const result = new Map();
+    for (const [platform, factory] of adapterMap) {
+        result.set(platform, await factory());
+    }
+    return result;
+}
+/**
+ * Get list of registered platforms.
+ */
+export function getRegisteredPlatforms() {
+    return Array.from(adapterMap.keys());
+}
+/**
+ * Import and register all built-in adapters.
+ * This is a convenience function that auto-registers all official adapters.
+ */
+export async function registerBuiltinAdapters() {
+    // Dynamic imports to avoid loading adapters that aren't installed
+    const builtinAdapters = [
+        { platform: 'claude', pkg: '@agentplugins/adapter-claude' },
+        { platform: 'codex', pkg: '@agentplugins/adapter-codex' },
+        { platform: 'copilot', pkg: '@agentplugins/adapter-copilot' },
+        { platform: 'gemini', pkg: '@agentplugins/adapter-gemini' },
+        { platform: 'kimi', pkg: '@agentplugins/adapter-kimi' },
+        { platform: 'opencode', pkg: '@agentplugins/adapter-opencode' },
+        { platform: 'pimono', pkg: '@agentplugins/adapter-pimono' },
+    ];
+    for (const { platform, pkg } of builtinAdapters) {
+        try {
+            // Use dynamic import that works in both ESM and bundled contexts
+            const mod = await import(/* @vite-ignore */ pkg);
+            if (mod.createAdapter) {
+                registerAdapter(platform, mod.createAdapter);
+            }
+        }
+        catch {
+            // Adapter package not installed — that's fine, skip it
+        }
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkD,CAAC;AAE7E;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAwB,EACxB,OAAuC;IAEvC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,QAAwB;IACjD,OAAO,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAwB;IACxD,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,uCAAuC,QAAQ,KAAK;YACpD,gFAAgF,QAAQ,EAAE,CAC3F,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmC,CAAC;IAC1D,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,UAAU,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,OAAO,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,kEAAkE;IAClE,MAAM,eAAe,GAAgD;QACnE,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,8BAA8B,EAAE;QAC3D,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,6BAA6B,EAAE;QACzD,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,+BAA+B,EAAE;QAC7D,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,8BAA8B,EAAE;QAC3D,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,4BAA4B,EAAE;QACvD,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,gCAAgC,EAAE;QAC/D,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,8BAA8B,EAAE;KAC5D,CAAC;IAEF,KAAK,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,eAAe,EAAE,CAAC;QAChD,IAAI,CAAC;YACH,iEAAiE;YACjE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACjD,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;gBACtB,eAAe,CAAC,QAAQ,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;QACzD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,248 @@
+/**
+ * AgentPlugins Core Types
+ *
+ * The Port: Universal plugin interface abstracting across all AI agent harnesses.
+ * Think of this as the "LLVM IR" of AI agent plugins — one unified representation
+ * that compiles to any target platform.
+ */
+export interface PluginManifest {
+    /** Plugin identifier — kebab-case, max 64 chars */
+    name: string;
+    /** Semantic version */
+    version: string;
+    /** Short description */
+    description: string;
+    displayName?: string;
+    author?: string | {
+        name: string;
+        email?: string;
+        url?: string;
+    };
+    homepage?: string;
+    repository?: string;
+    license?: string;
+    keywords?: string[];
+    /** Whether plugin is enabled by default (Claude, Kimi) */
+    defaultEnabled?: boolean;
+    skills?: Skill[];
+    hooks?: UniversalHooks;
+    mcpServers?: Record<string, MCPServerConfig>;
+    tools?: ToolDefinition[];
+    userConfig?: Record<string, UserConfigOption>;
+    metadata?: Record<string, unknown>;
+    settings?: UserConfigOption[];
+    /** Target platforms to compile for (if omitted, compiles for all) */
+    targets?: TargetPlatform[];
+}
+export type TargetPlatform = 'claude' | 'codex' | 'copilot' | 'gemini' | 'kimi' | 'opencode' | 'pimono';
+export declare const ALL_TARGETS: TargetPlatform[];
+export interface Skill {
+    name: string;
+    description: string;
+    /** Markdown content or path to SKILL.md */
+    content?: string;
+    /** File path (relative) to SKILL.md */
+    filePath?: string;
+}
+export interface MCPServerConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    transport?: 'stdio' | 'http';
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: ToolParameterSchema;
+    handler?: (args: Record<string, unknown>, ctx: ToolContext) => Promise<ToolResult>;
+}
+export interface ToolParameterSchema {
+    type: 'object';
+    properties: Record<string, ToolParameter>;
+    required?: string[];
+}
+export interface ToolParameter {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    description?: string;
+    enum?: string[];
+    items?: ToolParameter;
+    properties?: Record<string, ToolParameter>;
+    required?: string[];
+}
+export interface ToolContext {
+    sessionId?: string;
+    messageId?: string;
+    agent?: string;
+    directory?: string;
+    worktree?: string;
+}
+export type ToolResult = string | {
+    title?: string;
+    output: string;
+    metadata?: Record<string, unknown>;
+};
+export interface UserConfigOption {
+    type: 'string' | 'number' | 'boolean' | 'directory' | 'file';
+    title: string;
+    description: string;
+    /** If true, value is stored in secure storage (keychain) */
+    sensitive?: boolean;
+    required?: boolean;
+    default?: unknown;
+    multiple?: boolean;
+}
+/** The maximal common hook subset across all platforms */
+export interface UniversalHooks {
+    sessionStart?: HookDefinition;
+    sessionEnd?: HookDefinition;
+    userPromptSubmit?: HookDefinition;
+    userPromptExpansion?: HookDefinition;
+    preToolUse?: HookDefinition;
+    postToolUse?: HookDefinition;
+    postToolUseFailure?: HookDefinition;
+    permissionRequest?: HookDefinition;
+    permissionDenied?: HookDefinition;
+    subagentStart?: HookDefinition;
+    subagentStop?: HookDefinition;
+    preCompact?: HookDefinition;
+    postCompact?: HookDefinition;
+    stop?: HookDefinition;
+    stopFailure?: HookDefinition;
+    notification?: HookDefinition;
+    fileChanged?: HookDefinition;
+    cwdChanged?: HookDefinition;
+    setup?: HookDefinition;
+}
+/** Every universal hook name */
+export type UniversalHookName = keyof UniversalHooks;
+/** All universal hook names as an array */
+export declare const UNIVERSAL_HOOK_NAMES: UniversalHookName[];
+export interface HookDefinition {
+    /** Filter to narrow when the hook fires (tool name pattern, etc.) */
+    matcher?: string;
+    /** The handler implementation */
+    handler: HookHandler;
+}
+export type HookHandler = CommandHookHandler | HttpHookHandler | InlineHookHandler;
+export interface CommandHookHandler {
+    type: 'command';
+    /** Shell command to execute */
+    command: string;
+    /** Optional status message shown while hook runs */
+    statusMessage?: string;
+    /** Shell to use */
+    shell?: 'bash' | 'powershell' | 'cmd';
+}
+export interface HttpHookHandler {
+    type: 'http';
+    /** URL to POST hook context to */
+    url: string;
+    /** Optional headers */
+    headers?: Record<string, string>;
+}
+export interface InlineHookHandler {
+    type: 'inline';
+    /** Inline function — will be wrapped for command-based platforms */
+    handler: (ctx: HookContext) => Promise<HookResult>;
+}
+export interface HookContext {
+    /** The hook event name */
+    event: string;
+    /** Current working directory */
+    cwd: string;
+    /** Session identifier */
+    sessionId?: string;
+    /** Active model name */
+    model?: string;
+    /** Permission mode */
+    permissionMode?: string;
+    /** For tool-related hooks: tool name */
+    toolName?: string;
+    /** For tool-related hooks: tool arguments */
+    toolInput?: unknown;
+    /** For prompt-related hooks: the user's prompt */
+    userPrompt?: string;
+    /** Session source (startup, resume, clear, compact) */
+    source?: string;
+    /** Path to transcript file */
+    transcriptPath?: string | null;
+    /** Agent identifier */
+    agentId?: string;
+    /** Agent type/profile */
+    agentType?: string;
+    /** Turn identifier */
+    turnId?: string;
+}
+export interface HookResult {
+    /** If false, stops further processing (blocking hooks) */
+    continue?: boolean;
+    /** System message surfaced in UI */
+    systemMessage?: string;
+    /** Additional context injected into session */
+    additionalContext?: string;
+    /** If true, blocks the operation */
+    block?: boolean;
+    /** Reason for blocking */
+    reason?: string;
+    /** Suppress tool output */
+    suppressOutput?: boolean;
+}
+export interface PlatformAdapter {
+    /** Internal name */
+    readonly name: TargetPlatform;
+    /** Human-readable name */
+    readonly displayName: string;
+    /** Which universal hooks this platform supports */
+    readonly supportedHooks: readonly UniversalHookName[];
+    /** Which handler types this platform supports */
+    readonly supportedHandlers: readonly HandlerType[];
+    /** Path to manifest file (relative to plugin root) */
+    readonly manifestPath: string;
+    /** Manifest file format (json, toml, etc.) */
+    readonly manifestFormat: 'json' | 'toml';
+    /** Validate a plugin for this platform, returning any issues */
+    validate(plugin: PluginManifest): ValidationIssue[];
+    /** Compile the universal plugin into platform-specific output */
+    compile(plugin: PluginManifest): AdapterOutput;
+}
+export type HandlerType = 'command' | 'http' | 'inline' | 'file';
+export declare enum Severity {
+    ERROR = "error",
+    WARNING = "warning",
+    INFO = "info"
+}
+export interface ValidationIssue {
+    severity: Severity;
+    field?: string;
+    message: string;
+    suggestion?: string;
+}
+export interface AdapterOutput {
+    files: FileOutput[];
+    manifest: Record<string, unknown>;
+    warnings: string[];
+    issues: ValidationIssue[];
+    postInstall?: string[];
+}
+export interface FileOutput {
+    /** File path relative to plugin root */
+    path: string;
+    /** File content */
+    content: string;
+}
+export interface BuildConfig {
+    /** Path to plugin definition file */
+    entry: string;
+    /** Output directory */
+    outDir: string;
+    /** Target platforms (defaults to all) */
+    targets?: TargetPlatform[];
+    /** Whether to fail on warnings */
+    strict?: boolean;
+    /** Log level */
+    logLevel?: 'silent' | 'error' | 'warn' | 'info' | 'debug';
+}
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,45 @@
+/**
+ * AgentPlugins Core Types
+ *
+ * The Port: Universal plugin interface abstracting across all AI agent harnesses.
+ * Think of this as the "LLVM IR" of AI agent plugins — one unified representation
+ * that compiles to any target platform.
+ */
+export const ALL_TARGETS = [
+    'claude',
+    'codex',
+    'copilot',
+    'gemini',
+    'kimi',
+    'opencode',
+    'pimono',
+];
+/** All universal hook names as an array */
+export const UNIVERSAL_HOOK_NAMES = [
+    'sessionStart',
+    'sessionEnd',
+    'userPromptSubmit',
+    'userPromptExpansion',
+    'preToolUse',
+    'postToolUse',
+    'postToolUseFailure',
+    'permissionRequest',
+    'permissionDenied',
+    'subagentStart',
+    'subagentStop',
+    'preCompact',
+    'postCompact',
+    'stop',
+    'stopFailure',
+    'notification',
+    'fileChanged',
+    'cwdChanged',
+    'setup',
+];
+export var Severity;
+(function (Severity) {
+    Severity["ERROR"] = "error";
+    Severity["WARNING"] = "warning";
+    Severity["INFO"] = "info";
+})(Severity || (Severity = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8CH,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,QAAQ;IACR,OAAO;IACP,SAAS;IACT,QAAQ;IACR,MAAM;IACN,UAAU;IACV,QAAQ;CACT,CAAC;AAsHF,2CAA2C;AAC3C,MAAM,CAAC,MAAM,oBAAoB,GAAwB;IACvD,cAAc;IACd,YAAY;IACZ,kBAAkB;IAClB,qBAAqB;IACrB,YAAY;IACZ,aAAa;IACb,oBAAoB;IACpB,mBAAmB;IACnB,kBAAkB;IAClB,eAAe;IACf,cAAc;IACd,YAAY;IACZ,aAAa;IACb,MAAM;IACN,aAAa;IACb,cAAc;IACd,aAAa;IACb,YAAY;IACZ,OAAO;CACR,CAAC;AA+GF,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,+BAAmB,CAAA;IACnB,yBAAa,CAAA;AACf,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB"}

package/dist/validation.d.ts

@@ -0,0 +1,23 @@
+/**
+ * AgentPlugins Validation Layer
+ *
+ * Catches cross-platform issues before compilation.
+ * Provides platform-specific and universal validators.
+ */
+import { type PluginManifest, type ValidationIssue, type UniversalHookName, type TargetPlatform } from './types.js';
+export declare function validateUniversal(plugin: PluginManifest): ValidationIssue[];
+export interface PlatformConstraints {
+    maxNameLength: number;
+    supportsHttpHandler: boolean;
+    supportsInlineHandler: boolean;
+    supportsPromptHandler: boolean;
+    supportsMCPToolHandler: boolean;
+    maxDescriptionLength: number;
+    supportedHooks: readonly UniversalHookName[];
+    manifestPath: string;
+    requiresStrictValidation: boolean;
+    notes: string[];
+}
+export declare function getPlatformConstraints(platform: TargetPlatform): PlatformConstraints;
+export declare function validateForPlatform(plugin: PluginManifest, platform: TargetPlatform): ValidationIssue[];
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EAItB,KAAK,cAAc,EAEpB,MAAM,YAAY,CAAC;AAOpB,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,EAAE,CAiI3E;AA4CD,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,sBAAsB,EAAE,OAAO,CAAC;IAChC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB,EAAE,OAAO,CAAC;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,mBAAmB,CAsHpF;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,cAAc,GACvB,eAAe,EAAE,CA0DnB"}