@ericsanchezok/synergy-plugin-light-loop 0.0.0-stage → 3.1.0

package/AGENTS.md

@@ -0,0 +1,9 @@
+# plugin-light-loop Package
+
+Plugin Host Light Loop services and terminal observer delivery. Required components: Plugin Host and Light Loop. See [owning architecture](../../docs/architecture/workflows.md).
+
+Preserve generation checks and retryable terminal acknowledgments. Light Loop does not depend on Plugin Host.
+
+Expose selection through `./component`; imports are inert. Keep factory requirements, published `synergy` metadata, worker roles and production dependencies aligned. Register owner schemas, events, tools and HTTP features before Runtime composition closes.
+
+Tests under `test/` select this owner and its real requirements. Run `bun run typecheck` and focused `bun test test/<file>.test.ts` with the package preload; then run the root dependency and installed-composition checks.

package/dist/adapter.js

@@ -0,0 +1,38 @@
+import { Session } from "@ericsanchezok/synergy-harness/session";
+import { WorkflowSessionService } from "@ericsanchezok/synergy-light-loop/session/workflow";
+import { LightLoopRuntime } from "@ericsanchezok/synergy-light-loop/light-loop/runtime";
+import { LightLoopTerminalStore } from "@ericsanchezok/synergy-light-loop/light-loop/terminal-hook";
+export const lightLoopPluginAdapter = {
+    async start(sessionID, input) {
+        await WorkflowSessionService.startLightloop(sessionID, input.instructions);
+        await Session.update(sessionID, (draft) => {
+            if (draft.workflow?.kind !== "lightloop")
+                return;
+            draft.workflow = { ...draft.workflow, ...input };
+        });
+    },
+    async clear(sessionID) {
+        await Session.update(sessionID, (draft) => {
+            draft.workflow = undefined;
+            draft.time.archived = Date.now();
+        });
+    },
+    getActive(session) {
+        const workflow = session.workflow?.kind === "lightloop" ? session.workflow : undefined;
+        if (!workflow)
+            return undefined;
+        return {
+            instructions: workflow.instructions,
+            pluginOwner: workflow.pluginOwner,
+        };
+    },
+    scheduleDeadline(sessionID, deadlineAt) {
+        LightLoopRuntime.scheduleDeadline(sessionID, deadlineAt);
+    },
+    setTerminalStatus(sessionID, status, error) {
+        return LightLoopRuntime.setTerminalStatus(sessionID, status, error);
+    },
+    getTerminal(session) {
+        return LightLoopTerminalStore.get(session);
+    },
+};

package/dist/component.js

@@ -0,0 +1,16 @@
+import { componentFeatures } from "./features.js";
+import { version } from "../package.json" with { type: "json" };
+import { registerBridge } from "./register.js";
+export function pluginLightLoop() {
+    return {
+        id: "plugin-light-loop",
+        features: componentFeatures,
+        apiVersion: 1,
+        version,
+        requires: { "plugin-host": version, "light-loop": version },
+        workers: { agent: new URL("./worker.js", import.meta.url) },
+        register() {
+            registerBridge();
+        },
+    };
+}

package/dist/features.js

@@ -0,0 +1,4 @@
+export const componentFeatures = {
+    kind: "bridge",
+    definitions: [],
+};

package/dist/register.js

@@ -0,0 +1,8 @@
+import { Plugin } from "@ericsanchezok/synergy-plugin-host/plugin";
+import { registerPluginLightLoopAdapter } from "@ericsanchezok/synergy-plugin-host/plugin/host-services";
+import { setTerminalHookDeliverer } from "@ericsanchezok/synergy-light-loop/light-loop/runtime";
+import { lightLoopPluginAdapter } from "./adapter.js";
+export function registerBridge() {
+    setTerminalHookDeliverer((...args) => Plugin.deliverHookForPlugin(...args));
+    registerPluginLightLoopAdapter(lightLoopPluginAdapter);
+}

package/dist/worker.js

@@ -0,0 +1,6 @@
+import { version } from "../package.json" with { type: "json" };
+import { pluginLightLoop } from "./component.js";
+export const metadata = { id: "plugin-light-loop", version, apiVersion: 1 };
+export function registerWorker() {
+    pluginLightLoop().register();
+}

package/package.json

@@ -1,6 +1,70 @@
 {
   "name": "@ericsanchezok/synergy-plugin-light-loop",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "3.1.0",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    "./adapter": {
+      "types": "./src/adapter.ts",
+      "bun": "./dist/adapter.js",
+      "import": "./dist/adapter.js"
+    },
+    "./component": {
+      "types": "./src/component.ts",
+      "bun": "./dist/component.js",
+      "import": "./dist/component.js"
+    },
+    "./register": {
+      "types": "./src/register.ts",
+      "bun": "./dist/register.js",
+      "import": "./dist/register.js"
+    },
+    "./worker": {
+      "types": "./src/worker.ts",
+      "bun": "./dist/worker.js",
+      "import": "./dist/worker.js"
+    },
+    "./features": {
+      "types": "./src/features.ts",
+      "bun": "./dist/features.js",
+      "import": "./dist/features.js"
+    }
+  },
+  "dependencies": {
+    "@ericsanchezok/synergy-harness": "3.1.0",
+    "@ericsanchezok/synergy-light-loop": "3.1.0",
+    "@ericsanchezok/synergy-plugin-host": "3.1.0"
+  },
+  "synergy": {
+    "formatVersion": 1,
+    "kind": "component",
+    "id": "plugin-light-loop",
+    "version": "3.1.0",
+    "compatibility": {
+      "synergy": "3.1.0"
+    },
+    "apiVersion": 1,
+    "entry": "./dist/component.js",
+    "export": "pluginLightLoop",
+    "requires": {
+      "plugin-host": "3.1.0",
+      "light-loop": "3.1.0"
+    },
+    "packages": {
+      "@ericsanchezok/synergy-light-loop": "3.1.0"
+    },
+    "features": {
+      "kind": "bridge",
+      "definitions": []
+    }
+  },
+  "files": [
+    "src",
+    "dist",
+    "README.md",
+    "AGENTS.md"
+  ],
+  "engines": {
+    "bun": ">=1.4.3"
+  }
+}

package/src/adapter.ts

@@ -0,0 +1,42 @@
+import type { PluginLightLoopAdapter } from "@ericsanchezok/synergy-plugin-host/plugin/host-services"
+import { Session } from "@ericsanchezok/synergy-harness/session"
+import { WorkflowSessionService } from "@ericsanchezok/synergy-light-loop/session/workflow"
+import { LightLoopRuntime } from "@ericsanchezok/synergy-light-loop/light-loop/runtime"
+import { LightLoopTerminalStore } from "@ericsanchezok/synergy-light-loop/light-loop/terminal-hook"
+
+export const lightLoopPluginAdapter: PluginLightLoopAdapter = {
+  async start(sessionID, input) {
+    await WorkflowSessionService.startLightloop(sessionID, input.instructions)
+    await Session.update(sessionID, (draft) => {
+      if (draft.workflow?.kind !== "lightloop") return
+      draft.workflow = { ...draft.workflow, ...input }
+    })
+  },
+  async clear(sessionID) {
+    await Session.update(sessionID, (draft) => {
+      draft.workflow = undefined
+      draft.time.archived = Date.now()
+    })
+  },
+  getActive(session) {
+    const workflow = session.workflow?.kind === "lightloop" ? session.workflow : undefined
+    if (!workflow) return undefined
+    return {
+      instructions: workflow.instructions,
+      pluginOwner: workflow.pluginOwner,
+    }
+  },
+  scheduleDeadline(sessionID: string, deadlineAt: number) {
+    LightLoopRuntime.scheduleDeadline(sessionID, deadlineAt)
+  },
+  setTerminalStatus(
+    sessionID: string,
+    status: Parameters<typeof LightLoopRuntime.setTerminalStatus>[1],
+    error?: string,
+  ) {
+    return LightLoopRuntime.setTerminalStatus(sessionID, status, error)
+  },
+  getTerminal(session: Parameters<typeof LightLoopTerminalStore.get>[0]) {
+    return LightLoopTerminalStore.get(session)
+  },
+}

package/src/component.ts

@@ -0,0 +1,17 @@
+import { componentFeatures } from "./features"
+import type { RuntimeComponent } from "@ericsanchezok/synergy-harness/lifecycle"
+import { version } from "../package.json" with { type: "json" }
+import { registerBridge } from "./register"
+export function pluginLightLoop(): RuntimeComponent {
+  return {
+    id: "plugin-light-loop",
+    features: componentFeatures,
+    apiVersion: 1,
+    version,
+    requires: { "plugin-host": version, "light-loop": version },
+    workers: { agent: new URL("./worker.ts", import.meta.url) },
+    register() {
+      registerBridge()
+    },
+  }
+}

package/src/features.ts

@@ -0,0 +1,4 @@
+export const componentFeatures = {
+  kind: "bridge",
+  definitions: [],
+} as const

package/src/register.ts

@@ -0,0 +1,8 @@
+import { Plugin } from "@ericsanchezok/synergy-plugin-host/plugin"
+import { registerPluginLightLoopAdapter } from "@ericsanchezok/synergy-plugin-host/plugin/host-services"
+import { setTerminalHookDeliverer } from "@ericsanchezok/synergy-light-loop/light-loop/runtime"
+import { lightLoopPluginAdapter } from "./adapter"
+export function registerBridge() {
+  setTerminalHookDeliverer((...args) => Plugin.deliverHookForPlugin(...args))
+  registerPluginLightLoopAdapter(lightLoopPluginAdapter)
+}

package/src/worker.ts

@@ -0,0 +1,6 @@
+import { version } from "../package.json" with { type: "json" }
+import { pluginLightLoop } from "./component"
+export const metadata = { id: "plugin-light-loop", version, apiVersion: 1 }
+export function registerWorker() {
+  pluginLightLoop().register()
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-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.