@gyoungwe/plugin-api 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,15 @@
-# Temporary Holding Version
+# @gyoungwe/plugin-api
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Stable, host-independent TypeScript contracts for Drone capability plugins.
+The package contains no Electron, backend, Pi SDK, filesystem, or network
+implementation. A host implements `DroneHostPort` and performs the capability
+negotiation before loading a plugin.
+
+The package is intentionally published at API major `1` while its npm scope is
+still a project decision. Before publication, the host and `drone-plugins`
+workspace use an `npm pack` tarball or a pinned git commit; they must never use
+a relative path into the Drone source repository.
+
+`compatible` and `incompatible` are the only negotiation outcomes in API v1.
+There is no implicit partial or degraded load: a plugin that cannot satisfy its
+declared requirements is refused with an actionable reason.

package/dist/index.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Public host contract for Drone capability plugins.
+ *
+ * Keep this module dependency-free. It is consumed by native Pi packages and
+ * by the Desktop adapter, so it must not import Electron, the Pi SDK, or any
+ * Drone implementation package. Runtime values are deliberately limited to
+ * the API/contract identifiers and the pure negotiation helper below.
+ */
+export declare const PLUGIN_API_VERSION: 1;
+export declare const RESULT_CONTRACT: "drone-result/v3";
+export type PluginApiVersion = typeof PLUGIN_API_VERSION;
+export type ResultContractVersion = typeof RESULT_CONTRACT;
+export type PluginHost = "native-pi" | "drone-desktop";
+/** Capability identifiers are open-ended so new host features remain additive. */
+export type HostCapability = "readSource" | "searchKnowledge" | "persistRun" | "runCompute" | "requestAuthorization" | (string & {});
+export interface HostCapabilities {
+    readonly host: PluginHost;
+    readonly hostVersion: string;
+    /** Drone Plugin API major implemented by this host. */
+    readonly pluginApiVersion: number;
+    /** Pi extension API version, kept separate from the Drone contract. */
+    readonly piApiVersion?: number;
+    readonly capabilities: readonly HostCapability[];
+}
+export interface PluginRequirements {
+    readonly pluginApi: number;
+    readonly minHostVersion?: string;
+    readonly hosts?: readonly PluginHost[];
+    readonly capabilities?: readonly HostCapability[];
+}
+/** v1 intentionally has no degraded/partial loading state. */
+export type CapabilityNegotiationStatus = "compatible" | "incompatible";
+export interface CapabilityNegotiation {
+    readonly status: CapabilityNegotiationStatus;
+    readonly host: PluginHost;
+    readonly pluginApi: number;
+    readonly missingCapabilities: readonly HostCapability[];
+    readonly reason?: "plugin-api" | "host-version" | "host" | "capability";
+    readonly message?: string;
+}
+/**
+ * Compare the numeric components of a host version. Pre-release suffixes are
+ * intentionally treated as the same patch for the v1 minimum-version gate;
+ * the CI matrix is responsible for testing the exact supported Pi versions.
+ */
+export declare function compareHostVersions(left: string, right: string): number;
+/** Validate a plugin manifest's host requirements without loading its code. */
+export declare function negotiateCapabilities(requirements: PluginRequirements, host: HostCapabilities): CapabilityNegotiation;
+export interface ReadSourceInput {
+    readonly sourceRef: string;
+    readonly revision?: string;
+    readonly locator?: string;
+}
+export interface ReadReceipt {
+    readonly sourceRef: string;
+    readonly receiptRef: string;
+    readonly contentHash: string;
+    readonly readAt: string;
+    readonly version?: string;
+    readonly content: string;
+}
+export interface SearchInput {
+    readonly query: string;
+    readonly limit?: number;
+    readonly scope?: string;
+}
+export interface SearchResultItem {
+    readonly sourceRef: string;
+    readonly title?: string;
+    readonly snippet?: string;
+    readonly contentHash?: string;
+    readonly receiptRef?: string;
+}
+export interface SearchResult {
+    readonly query: string;
+    readonly items: readonly SearchResultItem[];
+    readonly searchedAt: string;
+}
+export type ResultStatus = "unknown" | "queued" | "running" | "succeeded" | "failed" | "blocked" | "cancelled";
+export type ResultRedlineCode = "missing-source" | "stale-source" | "hash-mismatch" | "authorization-required" | "missing-provenance" | "unknown";
+export interface ResultRedline {
+    readonly code: ResultRedlineCode;
+    readonly message: string;
+    readonly blocking: boolean;
+    readonly sourceRefs?: readonly string[];
+}
+export interface RunSnapshot {
+    readonly runId: string;
+    readonly status: ResultStatus;
+    readonly inputRefs: readonly string[];
+    readonly outputRefs: readonly string[];
+    readonly startedAt?: string;
+    readonly finishedAt?: string;
+    readonly redlines?: readonly ResultRedline[];
+    readonly error?: string;
+}
+export interface RunReceipt {
+    readonly contract: ResultContractVersion;
+    readonly runId: string;
+    readonly status: ResultStatus;
+    readonly recordedAt: string;
+    readonly outputRefs: readonly string[];
+    readonly redlines: readonly ResultRedline[];
+    readonly receiptRef: string;
+    readonly error?: string;
+}
+export interface ComputeRequest {
+    readonly runId: string;
+    readonly workflowId: string;
+    readonly inputRefs: readonly string[];
+    readonly parameters?: Readonly<Record<string, string | number | boolean | null>>;
+    readonly authorizationRef?: string;
+}
+export interface ComputeReceipt {
+    readonly contract: ResultContractVersion;
+    readonly runId: string;
+    readonly status: ResultStatus;
+    readonly receiptRef: string;
+    readonly outputRefs: readonly string[];
+    readonly redlines: readonly ResultRedline[];
+    readonly submittedAt?: string;
+    readonly finishedAt?: string;
+    readonly error?: string;
+}
+export interface AuthorizationRequest {
+    readonly action: string;
+    readonly reason?: string;
+    readonly scope?: string;
+}
+export interface AuthorizationReceipt {
+    readonly granted: boolean;
+    readonly authorizationRef?: string;
+    readonly decidedAt: string;
+    readonly reason?: string;
+}
+/** Stable host seam shared by native Pi and Drone Desktop adapters. */
+export interface DroneHostPort {
+    readonly host: PluginHost;
+    capabilities(): HostCapabilities;
+    readSource(input: ReadSourceInput): Promise<ReadReceipt>;
+    searchKnowledge(input: SearchInput): Promise<SearchResult>;
+    persistRun(snapshot: RunSnapshot): Promise<RunReceipt>;
+    runCompute(input: ComputeRequest): Promise<ComputeReceipt>;
+    requestAuthorization(input: AuthorizationRequest): Promise<AuthorizationReceipt>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,86 @@
+/**
+ * Public host contract for Drone capability plugins.
+ *
+ * Keep this module dependency-free. It is consumed by native Pi packages and
+ * by the Desktop adapter, so it must not import Electron, the Pi SDK, or any
+ * Drone implementation package. Runtime values are deliberately limited to
+ * the API/contract identifiers and the pure negotiation helper below.
+ */
+export const PLUGIN_API_VERSION = 1;
+export const RESULT_CONTRACT = "drone-result/v3";
+/**
+ * Compare the numeric components of a host version. Pre-release suffixes are
+ * intentionally treated as the same patch for the v1 minimum-version gate;
+ * the CI matrix is responsible for testing the exact supported Pi versions.
+ */
+export function compareHostVersions(left, right) {
+    const parse = (value) => value
+        .trim()
+        .replace(/^v/i, "")
+        .split(".")
+        .slice(0, 3)
+        .map((part) => {
+        const match = part.match(/^\d+/);
+        return match ? Number(match[0]) : 0;
+    });
+    const a = parse(left);
+    const b = parse(right);
+    for (let i = 0; i < 3; i += 1) {
+        const delta = (a[i] ?? 0) - (b[i] ?? 0);
+        if (delta !== 0)
+            return delta;
+    }
+    return 0;
+}
+/** Validate a plugin manifest's host requirements without loading its code. */
+export function negotiateCapabilities(requirements, host) {
+    if (requirements.pluginApi !== host.pluginApiVersion) {
+        return {
+            status: "incompatible",
+            host: host.host,
+            pluginApi: requirements.pluginApi,
+            missingCapabilities: [],
+            reason: "plugin-api",
+            message: `Plugin API ${requirements.pluginApi} requires host API ${requirements.pluginApi}; host provides ${host.pluginApiVersion}.`,
+        };
+    }
+    if (requirements.hosts && !requirements.hosts.includes(host.host)) {
+        return {
+            status: "incompatible",
+            host: host.host,
+            pluginApi: requirements.pluginApi,
+            missingCapabilities: [],
+            reason: "host",
+            message: `Plugin does not declare support for ${host.host}.`,
+        };
+    }
+    if (requirements.minHostVersion && compareHostVersions(host.hostVersion, requirements.minHostVersion) < 0) {
+        return {
+            status: "incompatible",
+            host: host.host,
+            pluginApi: requirements.pluginApi,
+            missingCapabilities: [],
+            reason: "host-version",
+            message: `Host ${host.hostVersion} is below the required ${requirements.minHostVersion}.`,
+        };
+    }
+    const available = new Set(host.capabilities);
+    const missingCapabilities = (requirements.capabilities ?? []).filter((capability) => !available.has(capability));
+    if (missingCapabilities.length) {
+        return {
+            status: "incompatible",
+            host: host.host,
+            pluginApi: requirements.pluginApi,
+            missingCapabilities,
+            reason: "capability",
+            message: `Host is missing: ${missingCapabilities.join(", ")}.`,
+        };
+    }
+    return {
+        status: "compatible",
+        host: host.host,
+        pluginApi: requirements.pluginApi,
+        missingCapabilities: [],
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,35 @@
 {
-  "name": "@gyoungwe/plugin-api",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+	"name": "@gyoungwe/plugin-api",
+	"version": "1.0.0",
+	"description": "Stable host contracts for Drone capability plugins",
+	"license": "MIT",
+	"publishConfig": {
+		"access": "public"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/Gyoungwe/Drone.git",
+		"directory": "packages/plugin-api"
+	},
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"package.json"
+	],
+	"scripts": {
+		"build": "tsc -p tsconfig.build.json",
+		"typecheck": "tsc -p tsconfig.json --noEmit",
+		"check": "npm run typecheck && npm run build && node ../../scripts/check-plugin-api.mjs --package-only",
+		"test": "npm run check && node --test test/index.test.mjs"
+	}
+}