@frockbot/frock-compose 0.0.0 → 0.7.292

package/README.md

@@ -1,3 +1,23 @@
-# @frockbot/frock-compose
+# `@frockbot/frock-compose`
 
-Placeholder reserving this name. See https://github.com/timoconnellaus/frockbot.
+The Plugin worker host. Untrusted code — Bot-authored and third-party — runs in
+a loaded Worker with only its named grants and no network beyond what the User
+approved; this module is what loads it.
+
+It mounts every Plugin a Composition generation names into one Dynamic Worker
+per User, behind a generated index (`plugin-worker-wrapper.ts`) that imports
+each Plugin's content-addressed artifact, narrows the capability stub into the
+`ctx` a Plugin author writes against, hands a provider's services to the
+Plugins mounted after it, and runs an open hook over every enabled Plugin that
+declared it. The host orders providers before consumers, registers the tools
+and hooks each Plugin's health report declares, and names the Plugins it could
+not mount instead of failing the whole generation.
+
+What a member declares about itself is a contract, not a host concern:
+`PluginDescriptorV1` and the vocabularies it names live in
+`@frockbot/core/contracts`, and the failure phases activation records live in
+`@frockbot/core/durable/composition-failure`.
+
+```ts
+import { PluginWorkerHost } from "@frockbot/frock-compose";
+```

package/index.ts

@@ -0,0 +1,18 @@
+// FrockBot Compose: the Plugin worker host.
+//
+// Untrusted code — Plugins the deployment seeded and Plugins a Bot wrote — runs
+// in one loaded Worker per User with only its named grants and a
+// `globalOutbound` that admits only the hosts the User approved. This module is
+// what loads it: every Composition member's content-addressed artifact behind a
+// generated index, the wrapper that narrows the capability stub into the `ctx`
+// a Plugin author writes against, and the tool and hook registrations its
+// health report declares.
+export * from "./plugin-worker-host.ts";
+
+export {
+  PLUGIN_WORKER_INDEX_VERSION,
+  PLUGIN_WORKER_MAIN_MODULE,
+  pluginWorkerIndexSourceV1,
+  pluginWorkerModuleMap,
+  pluginWorkerModulePathV1,
+} from "./plugin-worker-wrapper.ts";

package/package.json

@@ -1,14 +1,42 @@
 {
   "name": "@frockbot/frock-compose",
-  "version": "0.0.0",
-  "description": "Placeholder reserving this name for trusted publishing. Superseded by the first release.",
-  "license": "UNLICENSED",
+  "version": "0.7.292",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "description": "The FrockBot Plugin worker host: loads a User's Plugins as one Dynamic Worker behind a generated index.",
+  "exports": {
+    ".": "./index.ts",
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "test": "bun test",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "dependencies": {
+    "@frockbot/core": "0.7.292"
+  },
+  "devDependencies": {
+    "@types/bun": "1.4.2",
+    "typescript": "^7.0.2"
+  },
+  "files": [
+    "**/*.ts",
+    "README.md",
+    "!**/*.test.ts",
+    "!**/*.type-test.ts",
+    "!**/tsconfig*.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/timoconnellaus/frockbot.git",
     "directory": "frock-compose"
   },
-  "publishConfig": {
-    "access": "public"
+  "frockbot": {
+    "npm": true
   }
 }