@vibesdotdev/runtime-plugin-types 0.0.1

package/README.md

@@ -0,0 +1,3 @@
+# runtime-plugin-types
+
+Houses the daemon command-handler interface types (`CommandHandler`, `RuntimeCommandDeps`, `RuntimeCommandPayload`, `RuntimeCommandResult`, etc.) that both `runtime-plugin` and `storage` depend on. This breaks the `storage → runtime-plugin` import cycle by giving both packages a shared dependency on this leaf package instead.

package/SPEC.md

@@ -0,0 +1,14 @@
+# @vibesdotdev/runtime-plugin-types
+
+Owns the daemon command-handler interface types used by both `@vibesdotdev/runtime-plugin` and `@vibesdotdev/storage`.
+
+## Types
+
+- `CommandHandler` — function signature for daemon command handlers
+- `RuntimeCommandDeps` — deps injected into handlers (runtime instance, subscription manager, health getter)
+- `RuntimeCommandEnvelope` — IPC envelope shape
+- `RuntimeCommandPayload` — `Record<string, unknown>`
+- `RuntimeCommandResult` — result shape with `success: boolean`
+- `SubscriptionManager` — SSE connection manager interface
+- `SubscriptionChannel` — supported subscription channel names
+- `SSEEvent` — SSE event payload shape

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Runtime daemon command-handler type contracts.
+ *
+ * These types define the contract between the runtime-plugin daemon
+ * and external packages (like storage) that register command handlers.
+ * Shared by all command handlers: health, query, read, invoke, subscribe,
+ * doctor, and storage's sync handlers.
+ */
+import type { VibesRuntime } from '@vibesdotdev/runtime/api/runtime';
+import type { RuntimeDaemonHealth } from '@vibesdotdev/runtime-plugin/daemon/protocol/schemas';
+/**
+ * Supported subscription channels
+ */
+export type SubscriptionChannel = 'storage' | 'config' | 'lifecycle' | 'activity' | 'all';
+/**
+ * SSE event payload sent to clients
+ */
+export interface SSEEvent {
+    type: string;
+    [key: string]: unknown;
+}
+/**
+ * Subscription manager interface.
+ * Tracks active SSE connections and routes events.
+ */
+export interface SubscriptionManager {
+    activeCount(): number;
+    closeAll(): void;
+    handleSubscribe(req: Request): Response;
+    broadcast?(channel: SubscriptionChannel, event: SSEEvent): void;
+}
+/**
+ * Dependencies injected into runtime command handlers.
+ */
+export interface RuntimeCommandDeps {
+    runtime: VibesRuntime;
+    subscriptionManager: SubscriptionManager;
+    getHealth: () => Promise<RuntimeDaemonHealth>;
+}
+export interface RuntimeCommandEnvelope {
+    type: 'runtime-command';
+    command: string;
+    [key: string]: unknown;
+}
+export type RuntimeCommandPayload = Record<string, unknown>;
+export interface RuntimeCommandResult {
+    success: boolean;
+    error?: string;
+    [key: string]: unknown;
+}
+/**
+ * Command handler function signature.
+ */
+export type CommandHandler = (message: RuntimeCommandPayload, deps: RuntimeCommandDeps) => Promise<RuntimeCommandResult>;
+//# 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":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAE/F;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,KAAK,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IACnC,WAAW,IAAI,MAAM,CAAC;IACtB,QAAQ,IAAI,IAAI,CAAC;IACjB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,CAAC;IACxC,SAAS,CAAC,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;CAChE;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,YAAY,CAAC;IACtB,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,SAAS,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAC5B,OAAO,EAAE,qBAAqB,EAC9B,IAAI,EAAE,kBAAkB,KACpB,OAAO,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * Runtime daemon command-handler type contracts.
+ *
+ * These types define the contract between the runtime-plugin daemon
+ * and external packages (like storage) that register command handlers.
+ * Shared by all command handlers: health, query, read, invoke, subscribe,
+ * doctor, and storage's sync handlers.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@vibesdotdev/runtime-plugin-types",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vibesdotdev/monorepo.git",
+    "directory": "packages/runtime-plugin-types"
+  },
+  "peerDependencies": {
+    "@vibesdotdev/runtime": "0.0.1"
+  },
+  "scripts": {
+    "check": "bun --bun tsc -p tsconfig.json --noEmit",
+    "build": "tsc -p tsconfig.json"
+  },
+  "license": "MIT",
+  "files": [
+    "dist",
+    "src",
+    "bin",
+    "README.md",
+    "SPEC.md",
+    "LICENSE",
+    "!src/**/__tests__/**",
+    "!src/**/__stubs__/**",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/*.spec.ts",
+    "!src/**/*.spec.tsx",
+    "!dist/**/__tests__/**",
+    "!dist/**/__stubs__/**",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.d.ts.map",
+    "!dist/**/*.spec.js",
+    "!dist/**/*.spec.js.map",
+    "!dist/**/*.spec.d.ts",
+    "!dist/**/*.spec.d.ts.map"
+  ],
+  "vibes": {
+    "visibility": "public-framework"
+  }
+}

package/src/index.ts

@@ -0,0 +1,66 @@
+/**
+ * Runtime daemon command-handler type contracts.
+ *
+ * These types define the contract between the runtime-plugin daemon
+ * and external packages (like storage) that register command handlers.
+ * Shared by all command handlers: health, query, read, invoke, subscribe,
+ * doctor, and storage's sync handlers.
+ */
+
+import type { VibesRuntime } from '@vibesdotdev/runtime/api/runtime';
+import type { RuntimeDaemonHealth } from '@vibesdotdev/runtime-plugin/daemon/protocol/schemas';
+
+/**
+ * Supported subscription channels
+ */
+export type SubscriptionChannel = 'storage' | 'config' | 'lifecycle' | 'activity' | 'all';
+
+/**
+ * SSE event payload sent to clients
+ */
+export interface SSEEvent {
+	type: string;
+	[key: string]: unknown;
+}
+
+/**
+ * Subscription manager interface.
+ * Tracks active SSE connections and routes events.
+ */
+export interface SubscriptionManager {
+	activeCount(): number;
+	closeAll(): void;
+	handleSubscribe(req: Request): Response;
+	broadcast?(channel: SubscriptionChannel, event: SSEEvent): void;
+}
+
+/**
+ * Dependencies injected into runtime command handlers.
+ */
+export interface RuntimeCommandDeps {
+	runtime: VibesRuntime;
+	subscriptionManager: SubscriptionManager;
+	getHealth: () => Promise<RuntimeDaemonHealth>;
+}
+
+export interface RuntimeCommandEnvelope {
+	type: 'runtime-command';
+	command: string;
+	[key: string]: unknown;
+}
+
+export type RuntimeCommandPayload = Record<string, unknown>;
+
+export interface RuntimeCommandResult {
+	success: boolean;
+	error?: string;
+	[key: string]: unknown;
+}
+
+/**
+ * Command handler function signature.
+ */
+export type CommandHandler = (
+	message: RuntimeCommandPayload,
+	deps: RuntimeCommandDeps
+) => Promise<RuntimeCommandResult>;