feat: extract exo utilities into @metamask/kernel-exo package

packages/kernel-agents/package.json

@@ -184,6 +184,7 @@
   "dependencies": {
     "@endo/eventual-send": "^1.3.4",
     "@metamask/kernel-errors": "workspace:^",
+    "@metamask/kernel-exo": "workspace:^",
     "@metamask/kernel-utils": "workspace:^",
     "@metamask/logger": "workspace:^",
     "@ocap/kernel-language-model-service": "workspace:^",

packages/kernel-agents/src/capabilities/discover.ts

@@ -1,5 +1,5 @@
 import { E } from '@endo/eventual-send';
-import type { DiscoverableExo, MethodSchema } from '@metamask/kernel-utils';
+import type { DiscoverableExo, MethodSchema } from '@metamask/kernel-exo';
 
 import type { CapabilityRecord, CapabilitySpec } from '../types.ts';
 

packages/kernel-agents/src/types/capability.ts

@@ -1,4 +1,4 @@
-import type { JsonSchema } from '@metamask/kernel-utils';
+import type { JsonSchema } from '@metamask/kernel-exo';
 
 export type Capability<Args extends Record<string, unknown>, Return = null> = (
   args: Args,

packages/kernel-agents/tsconfig.build.json

@@ -8,6 +8,7 @@
     "types": ["node"]
   },
   "references": [
+    { "path": "../kernel-exo/tsconfig.build.json" },
     { "path": "../kernel-language-model-service/tsconfig.build.json" },
     { "path": "../kernel-utils/tsconfig.build.json" },
     { "path": "../logger/tsconfig.build.json" }

packages/kernel-agents/tsconfig.json

@@ -6,6 +6,7 @@
     "types": ["vitest", "node", "ses"]
   },
   "references": [
+    { "path": "../kernel-exo" },
     { "path": "../kernel-language-model-service" },
     { "path": "../kernel-utils" },
     { "path": "../logger" },

packages/kernel-exo/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@metamask/kernel-exo",
+  "version": "0.0.0",
+  "private": true,
+  "description": "Exo creation utilities for the Ocap Kernel",
+  "homepage": "https://github.com/MetaMask/ocap-kernel/tree/main/packages/kernel-exo#readme",
+  "bugs": {
+    "url": "https://github.com/MetaMask/ocap-kernel/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MetaMask/ocap-kernel.git"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "ts-bridge --project tsconfig.build.json --no-references --clean",
+    "build:docs": "typedoc",
+    "changelog:validate": "../../scripts/validate-changelog.sh @metamask/kernel-exo",
+    "clean": "rimraf --glob './*.tsbuildinfo' ./.eslintcache ./coverage ./dist ./.turbo ./logs",
+    "lint": "yarn lint:eslint && yarn lint:misc --check && yarn constraints && yarn lint:dependencies",
+    "lint:dependencies": "depcheck --quiet",
+    "lint:eslint": "eslint . --cache",
+    "lint:fix": "yarn lint:eslint --fix && yarn lint:misc --write && yarn constraints --fix && yarn lint:dependencies",
+    "lint:misc": "prettier --no-error-on-unmatched-pattern '**/*.json' '**/*.md' '**/*.html' '!**/CHANGELOG.old.md' '**/*.yml' '!.yarnrc.yml' '!merged-packages/**' --ignore-path ../../.gitignore --log-level error",
+    "publish:preview": "yarn npm publish --tag preview",
+    "test": "vitest run --config vitest.config.ts",
+    "test:clean": "yarn test --no-cache --coverage.clean",
+    "test:dev": "yarn test --mode development",
+    "test:verbose": "yarn test --reporter verbose",
+    "test:watch": "vitest --config vitest.config.ts",
+    "test:dev:quiet": "yarn test:dev --reporter @ocap/repo-tools/vitest-reporters/silent"
+  },
+  "dependencies": {
+    "@endo/exo": "^1.5.12",
+    "@endo/patterns": "^1.7.0",
+    "@metamask/kernel-utils": "workspace:^"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.17.4",
+    "@metamask/auto-changelog": "^5.3.0",
+    "@metamask/eslint-config": "^15.0.0",
+    "@metamask/eslint-config-nodejs": "^15.0.0",
+    "@metamask/eslint-config-typescript": "^15.0.0",
+    "@ocap/repo-tools": "workspace:^",
+    "@ts-bridge/cli": "^0.6.3",
+    "@ts-bridge/shims": "^0.1.1",
+    "@typescript-eslint/eslint-plugin": "^8.29.0",
+    "@typescript-eslint/parser": "^8.29.0",
+    "@typescript-eslint/utils": "^8.29.0",
+    "@vitest/eslint-plugin": "^1.6.5",
+    "depcheck": "^1.4.7",
+    "eslint": "^9.23.0",
+    "eslint-config-prettier": "^10.1.1",
+    "eslint-import-resolver-typescript": "^4.3.1",
+    "eslint-plugin-import-x": "^4.10.0",
+    "eslint-plugin-jsdoc": "^50.6.9",
+    "eslint-plugin-n": "^17.17.0",
+    "eslint-plugin-prettier": "^5.2.6",
+    "eslint-plugin-promise": "^7.2.1",
+    "prettier": "^3.5.3",
+    "rimraf": "^6.0.1",
+    "ses": "^1.14.0",
+    "turbo": "^2.5.6",
+    "typedoc": "^0.28.1",
+    "typescript": "~5.8.2",
+    "typescript-eslint": "^8.29.0",
+    "vite": "^7.3.0",
+    "vitest": "^4.0.16"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}

packages/kernel-utils/src/discoverable.ts → packages/kernel-exo/src/discoverable.ts

@@ -1,9 +1,9 @@
 import { makeExo } from '@endo/exo';
 import type { Methods } from '@endo/exo';
 import type { InterfaceGuard } from '@endo/patterns';
+import { mergeDisjointRecords } from '@metamask/kernel-utils';
 
 import { makeDefaultInterface } from './exo.ts';
-import { mergeDisjointRecords } from './merge-disjoint-records.ts';
 import type { MethodSchema } from './schema.ts';
 
 /**

packages/kernel-exo/src/index.ts

@@ -0,0 +1,4 @@
+export { makeDefaultInterface, makeDefaultExo } from './exo.ts';
+export { makeDiscoverableExo } from './discoverable.ts';
+export type { DiscoverableExo } from './discoverable.ts';
+export type { JsonSchema, MethodSchema } from './schema.ts';

packages/kernel-exo/tsconfig.build.json

@@ -0,0 +1,13 @@
+{
+  "extends": "../../tsconfig.packages.build.json",
+  "compilerOptions": {
+    "baseUrl": "./",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "types": ["ses"]
+  },
+  "references": [{ "path": "../kernel-utils/tsconfig.build.json" }],
+  "files": [],
+  "include": ["./src"]
+}

packages/kernel-exo/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "extends": "../../tsconfig.packages.json",
+  "compilerOptions": {
+    "baseUrl": "./",
+    "lib": ["ES2022"],
+    "types": ["ses", "vitest"]
+  },
+  "references": [{ "path": "../kernel-utils" }, { "path": "../repo-tools" }],
+  "include": [
+    "../../vitest.config.ts",
+    "./src",
+    "./vite.config.ts",
+    "./vitest.config.ts"
+  ]
+}

packages/kernel-exo/vitest.config.ts

@@ -0,0 +1,22 @@
+import { mergeConfig } from '@ocap/repo-tools/vitest-config';
+import { fileURLToPath } from 'node:url';
+import { defineConfig, defineProject } from 'vitest/config';
+
+import defaultConfig from '../../vitest.config.ts';
+
+export default defineConfig((args) => {
+  return mergeConfig(
+    args,
+    defaultConfig,
+    defineProject({
+      test: {
+        name: 'kernel-exo',
+        setupFiles: [
+          fileURLToPath(
+            import.meta.resolve('@ocap/repo-tools/test-utils/mock-endoify'),
+          ),
+        ],
+      },
+    }),
+  );
+});

packages/kernel-test/package.json

@@ -54,6 +54,7 @@
     "@endo/promise-kit": "^1.1.13",
     "@libp2p/crypto": "5.1.8",
     "@libp2p/peer-id": "5.1.9",
+    "@metamask/kernel-exo": "workspace:^",
     "@metamask/kernel-store": "workspace:^",
     "@metamask/kernel-utils": "workspace:^",
     "@metamask/logger": "workspace:^",

packages/kernel-test/src/service.test.ts

@@ -1,5 +1,6 @@
+import { makeDefaultExo } from '@metamask/kernel-exo';
 import { makeSQLKernelDatabase } from '@metamask/kernel-store/sqlite/nodejs';
-import { makeDefaultExo, waitUntilQuiescent } from '@metamask/kernel-utils';
+import { waitUntilQuiescent } from '@metamask/kernel-utils';
 import { Kernel, krefOf } from '@metamask/ocap-kernel';
 import type { KRef, SlotValue } from '@metamask/ocap-kernel';
 import { describe, expect, it } from 'vitest';

packages/kernel-test/src/vats/async-generator-iterator-vat.ts

@@ -1,5 +1,5 @@
 import { E } from '@endo/eventual-send';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 import { makeEventualIterator, makeExoGenerator } from '@ocap/remote-iterables';
 
 import { unwrapTestLogger } from '../test-powers.ts';

packages/kernel-test/src/vats/default/empty-vat.js

@@ -1,4 +1,4 @@
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 /**
  * Build function for simple test vat.

packages/kernel-test/src/vats/default/sample-vat.js

@@ -1,5 +1,5 @@
 import { E } from '@endo/eventual-send';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 /**
  * Build function for generic test vat.

packages/kernel-test/src/vats/discoverable-capability-vat.ts

@@ -1,5 +1,5 @@
-import { makeDiscoverableExo } from '@metamask/kernel-utils/discoverable';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDiscoverableExo } from '@metamask/kernel-exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 /**
  * Build function for a vat that exports a discoverable exo capability.

packages/kernel-test/src/vats/endowment-fetch.ts

@@ -1,4 +1,4 @@
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 import { unwrapTestLogger } from '../test-powers.ts';
 import type { TestPowers } from '../test-powers.ts';

packages/kernel-test/src/vats/error-bootstrap-throw.ts

@@ -1,4 +1,4 @@
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 // eslint-disable-next-line no-console
 console.log('bootstrap throw');

packages/kernel-test/src/vats/error-bootstrap-uncaught-rejection.ts

@@ -1,5 +1,5 @@
 import { makePromiseKit } from '@endo/promise-kit';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 // eslint-disable-next-line no-console
 console.log('bootstrap uncaught rejection');

packages/kernel-test/src/vats/error-build-uncaught-rejection.ts

@@ -1,5 +1,5 @@
 import { makePromiseKit } from '@endo/promise-kit';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 // eslint-disable-next-line no-console
 console.log('build uncaught rejection');

packages/kernel-test/src/vats/error-global-uncaught-rejection.ts

@@ -1,5 +1,5 @@
 import { makePromiseKit } from '@endo/promise-kit';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 // eslint-disable-next-line no-console
 console.log('global uncaught rejection');

packages/kernel-test/src/vats/exo-vat.ts

@@ -1,7 +1,7 @@
 import { makeScalarMapStore, makeScalarSetStore } from '@agoric/store';
 import { makeExo, defineExoClass, defineExoClassKit } from '@endo/exo';
 import { M } from '@endo/patterns';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 import type { Baggage } from '@metamask/ocap-kernel';
 
 import { unwrapTestLogger } from '../test-powers.ts';

packages/kernel-test/src/vats/exporter-vat.ts

@@ -1,4 +1,4 @@
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 import { unwrapTestLogger } from '../test-powers.ts';
 import type { TestPowers } from '../test-powers.ts';

packages/kernel-test/src/vats/importer-vat.ts

@@ -1,5 +1,5 @@
 import { E } from '@endo/eventual-send';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 import { unwrapTestLogger } from '../test-powers.ts';
 import type { TestPowers } from '../test-powers.ts';

packages/kernel-test/src/vats/io-vat.ts

@@ -1,5 +1,5 @@
 import { E } from '@endo/eventual-send';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 import { unwrapTestLogger } from '../test-powers.ts';
 import type { TestPowers } from '../test-powers.ts';

packages/kernel-test/src/vats/lms-queue-vat.ts

@@ -1,4 +1,4 @@
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 import { makeQueueService } from '@ocap/kernel-language-model-service/test-utils';
 import { makeExoGenerator } from '@ocap/remote-iterables';
 

packages/kernel-test/src/vats/lms-user-vat.ts

@@ -1,5 +1,5 @@
 import { E } from '@endo/eventual-send';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 import { makeEventualIterator } from '@ocap/remote-iterables';
 
 import { unwrapTestLogger } from '../test-powers.ts';

packages/kernel-test/src/vats/logger-vat.ts

@@ -1,4 +1,4 @@
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 import type { TestPowers } from '../test-powers.ts';
 

packages/kernel-test/src/vats/message-to-promise-vat.ts

@@ -1,6 +1,6 @@
 import { E } from '@endo/eventual-send';
 import { makePromiseKit } from '@endo/promise-kit';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 import { unwrapTestLogger } from '../test-powers.ts';
 import type { TestPowers } from '../test-powers.ts';

packages/kernel-test/src/vats/monotonous-vat.ts

@@ -1,5 +1,5 @@
 import { E } from '@endo/eventual-send';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 import type { Baggage } from '@metamask/ocap-kernel';
 
 /**

packages/kernel-test/src/vats/pass-result-promise-vat.ts

@@ -1,6 +1,6 @@
 import { E } from '@endo/eventual-send';
 import { makePromiseKit } from '@endo/promise-kit';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 import { unwrapTestLogger } from '../test-powers.ts';
 import type { TestPowers } from '../test-powers.ts';

packages/kernel-test/src/vats/pass-result-vat.ts

@@ -1,5 +1,5 @@
 import { E } from '@endo/eventual-send';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 import { unwrapTestLogger } from '../test-powers.ts';
 import type { TestPowers } from '../test-powers.ts';

packages/kernel-test/src/vats/persistence-coordinator-vat.ts

@@ -1,6 +1,6 @@
 /* global harden */
 import { E } from '@endo/eventual-send';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 import type { Baggage } from '@metamask/ocap-kernel';
 
 import { unwrapTestLogger } from '../test-powers.ts';

packages/kernel-test/src/vats/persistence-counter-vat.ts

@@ -1,4 +1,4 @@
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 import type { Baggage } from '@metamask/ocap-kernel';
 
 import { unwrapTestLogger } from '../test-powers.ts';

packages/kernel-test/src/vats/persistence-worker-vat.ts

@@ -1,4 +1,4 @@
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 import type { Baggage } from '@metamask/ocap-kernel';
 
 import { unwrapTestLogger } from '../test-powers.ts';

packages/kernel-test/src/vats/powers-vat.ts

@@ -1,4 +1,4 @@
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 /**
  * Build function for running a test of the vatstore.

packages/kernel-test/src/vats/promise-arg-vat.ts

@@ -1,5 +1,5 @@
 import { E } from '@endo/eventual-send';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 import { unwrapTestLogger } from '../test-powers.ts';
 import type { TestPowers } from '../test-powers.ts';

packages/kernel-test/src/vats/promise-chain-vat.ts

@@ -1,6 +1,6 @@
 import { E } from '@endo/eventual-send';
 import { makePromiseKit } from '@endo/promise-kit';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 import { unwrapTestLogger } from '../test-powers.ts';
 import type { TestPowers } from '../test-powers.ts';

packages/kernel-test/src/vats/promise-crosswise-vat.ts

@@ -1,6 +1,6 @@
 import { E } from '@endo/eventual-send';
 import { makePromiseKit } from '@endo/promise-kit';
-import { makeDefaultExo } from '@metamask/kernel-utils/exo';
+import { makeDefaultExo } from '@metamask/kernel-exo';
 
 import { unwrapTestLogger } from '../test-powers.ts';
 import type { TestPowers } from '../test-powers.ts';