MetaMask · grypez · Jan 14, 2026 · Jan 8, 2026 · Jan 13, 2026 · Jan 13, 2026
@@ -0,0 +1,10 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+[Unreleased]: https://github.com/MetaMask/ocap-kernel/
@@ -0,0 +1,17 @@
+# `@ocap/kernel-agents-repl`
+
+REPL strategy for capability-enabled, language-model-flow-controlled programming.
+
+See the [strategies documentation](../kernel-agents/src/strategies/README.md) from `@ocap/kernel-agents`
+
+## Installation
+
+`yarn add @ocap/kernel-agents-repl`
+
+or
+
+`npm install @ocap/kernel-agents-repl`
+
+## Contributing
+
+This package is part of a monorepo. Instructions for contributing can be found in the [monorepo README](https://github.com/MetaMask/ocap-kernel#readme).
@@ -0,0 +1,92 @@
+{
+  "name": "@ocap/kernel-agents-repl",
+  "version": "0.0.0",
+  "private": true,
+  "description": "REPL strategy for capability-enabled, language-model-flow-controlled programming",
+  "homepage": "https://github.com/MetaMask/ocap-kernel/tree/main/packages/kernel-agents-repl#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 @ocap/kernel-agents-repl",
+    "clean": "rimraf --glob './*.tsbuildinfo' ./.eslintcache ./coverage ./dist ./.turbo",
+    "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 --reporter dot",
+    "test:verbose": "yarn test --reporter verbose",
+    "test:watch": "vitest --config vitest.config.ts"
+  },
+  "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",
+    "@types/node": "^22.13.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",
+    "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": "^20.11 || >=22"
+  },
+  "dependencies": {
+    "@metamask/kernel-errors": "workspace:^",
+    "@metamask/kernel-utils": "workspace:^",
+    "@metamask/logger": "workspace:^",
+    "@ocap/kernel-agents": "workspace:^",
+    "ses": "^1.14.0",
+    "tree-sitter": "^0.25.0",
+    "tree-sitter-javascript": "^0.25.0"
+  }
+}
@@ -0,0 +1,7 @@
+export { makeReplAgent } from './strategies/repl-agent.ts';
+export type {
+  State,
+  Action,
+  Observation,
+  ReplTranscript,
+} from './strategies/repl/messages.ts';
@@ -1,5 +1,6 @@
-import { makeAgent } from '../agent.ts';
-import type { Agent } from '../types.ts';
+import { makeAgent } from '@ocap/kernel-agents/agent';
+import type { Agent } from '@ocap/kernel-agents/types';
+
 import type { State, Action, Observation } from './repl/messages.ts';
 import { prepareAttempt } from './repl/prepare-attempt.ts';
 

@@ -1,6 +1,9 @@
 import { EvaluatorError } from '@metamask/kernel-errors';
 import { mergeDisjointRecords } from '@metamask/kernel-utils';
 import type { Logger } from '@metamask/logger';
+import { extractCapabilities } from '@ocap/kernel-agents/capabilities/capability';
+import type { CapabilityRecord } from '@ocap/kernel-agents/types';
+import { ifDefined } from '@ocap/kernel-agents/utils';
 
 import { makeCompartment } from './compartment.ts';
 import { processEvaluationError } from './evaluator-error.ts';
@@ -14,9 +17,6 @@ import type { ReplTranscript, StatementMessage } from './messages.ts';
 import { prepareEvaluation } from './prepare-evaluation.ts';
 import { ERROR, RETURN } from './symbols.ts';
 import type { EvaluatorState } from './types.ts';
-import { extractCapabilities } from '../../capabilities/capability.ts';
-import type { CapabilityRecord } from '../../types.ts';
-import { ifDefined } from '../../utils.ts';
 
 const validateStatement = (
   statement: StatementMessage,

@@ -1,16 +1,17 @@
+import { extractCapabilitySchemas } from '@ocap/kernel-agents/capabilities/capability';
+import { end } from '@ocap/kernel-agents/capabilities/end';
+import { search } from '@ocap/kernel-agents/capabilities/examples';
+import type { CapabilityRecord } from '@ocap/kernel-agents/types';
+
+import type { ReplTranscript } from './messages.ts';
 import {
   CommentMessage,
   EvaluationMessage,
   ImportMessage,
   InterjectionMessage,
   ResultMessage,
 } from './messages.ts';
-import type { ReplTranscript } from './messages.ts';
 import { RETURN } from './symbols.ts';
-import { extractCapabilitySchemas } from '../../capabilities/capability.ts';
-import { end } from '../../capabilities/end.ts';
-import { search } from '../../capabilities/examples.ts';
-import type { CapabilityRecord } from '../../types.ts';
 
 // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 const transcribeCapabilities = (capabilities: CapabilityRecord) => [

@@ -1,11 +1,11 @@
 import { stringify } from '@metamask/kernel-utils';
+import { Message } from '@ocap/kernel-agents/types/messages';
+import type { Transcript } from '@ocap/kernel-agents/types/messages';
 import type { SyntaxNode } from 'tree-sitter';
 
 import { makeCompartment } from './compartment.ts';
 import { parse } from './parse/javascript.ts';
 import { ERROR, RETURN } from './symbols.ts';
-import { Message } from '../../types/messages.ts';
-import type { Transcript } from '../../types/messages.ts';
 
 export type StatementType = 'import' | 'evaluation' | 'comment';
 

@@ -1,5 +1,16 @@
 import { mergeDisjointRecords } from '@metamask/kernel-utils';
 import type { Logger } from '@metamask/logger';
+import { extractCapabilitySchemas } from '@ocap/kernel-agents/capabilities/capability';
+import { makeEnd } from '@ocap/kernel-agents/capabilities/end';
+import type {
+  PREP,
+  Objective,
+  Context,
+  CapabilityRecord,
+  Progress,
+  PrepareAttempt,
+} from '@ocap/kernel-agents/types';
+import { ifDefined } from '@ocap/kernel-agents/utils';
 
 import { makeEvaluator } from './evaluator.ts';
 import type { State, Observation, Action } from './messages.ts';
@@ -11,17 +22,6 @@ import {
 import { makePrinter } from './printer.ts';
 import { makePrompter } from './prompter.ts';
 import { makeReader } from './reader.ts';
-import { extractCapabilitySchemas } from '../../capabilities/capability.ts';
-import { makeEnd } from '../../capabilities/end.ts';
-import type {
-  PREP,
-  Objective,
-  Context,
-  CapabilityRecord,
-  Progress,
-  PrepareAttempt,
-} from '../../types.ts';
-import { ifDefined } from '../../utils.ts';
 
 export const prepareAttempt: PrepareAttempt<State, Action, Observation> = <
   Result,

@@ -1,7 +1,8 @@
+import { ifDefined } from '@ocap/kernel-agents/utils';
+
 import { exampleTranscripts } from './example-transcripts.ts';
 import type { ReplTranscript } from './messages.ts';
 import { makeRandom } from './random.ts';
-import { ifDefined } from '../../utils.ts';
 
 const makePreamble = (
   nTranscripts: number,

@@ -1,10 +1,10 @@
 import '@ocap/repo-tools/test-utils/mock-endoify';
 
 import type { Logger } from '@metamask/logger';
+import { makeTestStream } from '@ocap/kernel-agents/test-utils';
 import { describe, it, expect, vi, beforeEach } from 'vitest';
 
 import { makeReader } from './reader.ts';
-import { makeTestStream } from '../../test-utils.ts';
 
 describe('reader', () => {
   let logger: Logger;

@@ -1,8 +1,12 @@
 import type { Logger } from '@metamask/logger';
+import {
+  ifDefined,
+  withAbort,
+  gatherStreamingResponse,
+} from '@ocap/kernel-agents/utils';
 
 import type { StatementMessage } from './messages.ts';
 import { makeSampleCollector } from './sample-collector.ts';
-import { ifDefined, withAbort, gatherStreamingResponse } from '../../utils.ts';
 
 export const makeReader =
   ({ logger }: { logger?: Logger }) =>

@@ -1,8 +1,8 @@
 import { SampleGenerationError } from '@metamask/kernel-errors';
 import type { Logger } from '@metamask/logger';
+import type { SampleCollector } from '@ocap/kernel-agents/types';
 
 import { StatementMessage } from './messages.ts';
-import type { SampleCollector } from '../../types.ts';
 
 /**
  * A simple sample collector that collects content from a stream until a stop

@@ -0,0 +1,13 @@
+{
+  "extends": "../../tsconfig.packages.build.json",
+  "compilerOptions": {
+    "baseUrl": "./",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "types": []
+  },
+  "references": [],
+  "files": [],
+  "include": ["./src"]
+}
@@ -0,0 +1,15 @@
+{
+  "extends": "../../tsconfig.packages.json",
+  "compilerOptions": {
+    "baseUrl": "./",
+    "lib": ["ES2022"],
+    "types": ["vitest"]
+  },
+  "references": [{ "path": "../repo-tools" }],
+  "include": [
+    "../../vitest.config.ts",
+    "./src",
+    "./vite.config.ts",
+    "./vitest.config.ts"
+  ]
+}
@@ -0,0 +1,8 @@
+{
+  "entryPoints": [],
+  "excludePrivate": true,
+  "hideGenerator": true,
+  "out": "docs",
+  "tsconfig": "./tsconfig.build.json",
+  "projectDocuments": ["documents/*.md"]
+}
@@ -0,0 +1,16 @@
+import { mergeConfig } from '@ocap/repo-tools/vitest-config';
+import { defineConfig, defineProject } from 'vitest/config';
+
+import defaultConfig from '../../vitest.config.ts';
+
+export default defineConfig((args) => {
+  return mergeConfig(
+    args,
+    defaultConfig,
+    defineProject({
+      test: {
+        name: 'kernel-agents-repl',
+      },
+    }),
+  );
+});