♻️ Converge terminal grids on one immutable state (#730)

.github/workflows/publish-packages.yml

@@ -30,7 +30,7 @@ jobs:
       - name: Validate the manifests declare this version
         run: |
           VERSION="${{ steps.resolve.outputs.value }}"
-          for f in packages/durable-streams/deno.json packages/runtime/deno.json packages/core/deno.json packages/acp/deno.json packages/testing/deno.json packages/test-agent/deno.json packages/web/deno.json packages/workflow/deno.json packages/cli/deno.json packages/code-review-agent/deno.json; do
+          for f in packages/durable-streams/deno.json packages/runtime/deno.json packages/terminal/deno.json packages/core/deno.json packages/acp/deno.json packages/testing/deno.json packages/test-agent/deno.json packages/web/deno.json packages/workflow/deno.json packages/cli/deno.json packages/code-review-agent/deno.json; do
             declared="$(jq -r .version "$f")"
             if [ "$declared" != "$VERSION" ]; then
               echo "::error::$f declares $declared, not $VERSION — the tag does not match the manifests"
@@ -75,8 +75,15 @@ jobs:
       package: packages/runtime
       version: ${{ needs.version.outputs.value }}
 
+  terminal:
+    needs: [version, durable-streams]
+    uses: ./.github/workflows/publish-one.yml
+    with:
+      package: packages/terminal
+      version: ${{ needs.version.outputs.value }}
+
   core:
-    needs: [version, durable-streams, runtime]
+    needs: [version, durable-streams, runtime, terminal]
     uses: ./.github/workflows/publish-one.yml
     with:
       package: packages/core

package.json

@@ -45,6 +45,7 @@
     "remark": "15",
     "remend": "^1.2.2",
     "semver": "^7.8.5",
+    "starfx": "0.16.1",
     "zod": "^4.3.6",
     "unist-util-select": "^5",
     "mdast-util-to-string": "^4"
@@ -57,6 +58,7 @@
     "@executablemd/core": "workspace:*",
     "@executablemd/durable-streams": "workspace:*",
     "@executablemd/runtime": "workspace:*",
+    "@executablemd/terminal": "workspace:*",
     "@executablemd/test-agent": "workspace:*",
     "@executablemd/test-support": "workspace:*",
     "@executablemd/testing": "workspace:*",

packages/acp/src/provider.ts

@@ -87,8 +87,8 @@ import {
   AgentSessionRecoveryRequired,
   cwd,
   ExecutableObservationError,
-  nativeLaunch,
 } from "@executablemd/runtime";
+import { nativeLaunch } from "@executablemd/terminal";
 import type {
   AgentSessionCoordinator,
   AgentSessionKey,

packages/acp/tests/native-launch.test.ts

@@ -27,8 +27,10 @@ import type {
   PreparedLaunchRecord,
   Session,
 } from "@executablemd/core";
-import { flushOutput, installControlledLauncher, reserveTerminal } from "@executablemd/runtime";
-import type { AgentSessionCoordinator, NativeLaunchRequest } from "@executablemd/runtime";
+import { flushOutput, reserveTerminal } from "@executablemd/terminal";
+import { installControlledLauncher } from "@executablemd/terminal/test";
+import type { NativeLaunchRequest } from "@executablemd/terminal";
+import type { AgentSessionCoordinator } from "@executablemd/runtime";
 import { createAcpxProvider } from "../src/provider.ts";
 import type { AcpxProviderDependencies } from "../src/provider.ts";
 import {

packages/cli/src/agent-stack.ts

@@ -21,7 +21,8 @@ import {
   registerAgentProvider,
 } from "@executablemd/core";
 import type { AgentProviderFactory, PermissionMode } from "@executablemd/core";
-import { installForegroundLauncher, env as readEnv } from "@executablemd/runtime";
+import { env as readEnv } from "@executablemd/runtime";
+import { installForegroundLauncher } from "@executablemd/terminal/posix";
 import { createAcpxProvider, DEFAULT_AGENT_NAME } from "@executablemd/acp";
 import type { AcpxProviderDependencies } from "@executablemd/acp";
 // A separate entrypoint because the embedded adapters are temporary (#636) and

packages/cli/tests/agent-session-coordinator.test.ts

@@ -28,8 +28,8 @@ import {
   API,
   createDenoAgentSessionCoordinator,
   hasDenoAgentSessionCoordinator,
-  installControlledLauncher,
 } from "@executablemd/runtime";
+import { installControlledLauncher } from "@executablemd/terminal/test";
 import type { AgentSessionCoordinator } from "@executablemd/runtime";
 import {
   ADVERTISED_CLIENT_NATIVE_ATTACHMENT,
@@ -39,7 +39,8 @@ import {
   createMemorySessionRouteStore,
 } from "@executablemd/acp";
 import type { AgentSessionRouteStore, NativeAdapter, NativeBinding } from "@executablemd/acp";
-import type { ExecutableObserver, NativeLaunchRequest } from "@executablemd/runtime";
+import type { ExecutableObserver } from "@executablemd/runtime";
+import type { NativeLaunchRequest } from "@executablemd/terminal";
 import { createFakeObserver } from "../../acp/tests/helpers.ts";
 import {
   sessionCoordinatorRoot,

packages/cli/tests/run-composition-deno.test.ts

@@ -21,7 +21,8 @@ import { exists, readTextFile } from "@effectionx/fs";
 import { spawnSync } from "node:child_process";
 import { join } from "node:path";
 import process from "node:process";
-import { API, NativeLauncher, useHostFiles } from "@executablemd/runtime";
+import { API, useHostFiles } from "@executablemd/runtime";
+import { NativeLauncher } from "@executablemd/terminal";
 import { InMemoryStream } from "@executablemd/durable-streams";
 import {
   Agent,

packages/core/mod.ts

@@ -152,6 +152,13 @@ export { DocumentOutput } from "./src/api.ts";
 export type { DocumentOutputApi } from "./src/api.ts";
 export { useNormalizedOutput } from "./src/output/normalize.ts";
 export { useTerminalOutput } from "./src/output/terminal.ts";
+// A host reaches the whole terminal-grid capability through
+// `installTerminalGridProfile`; the contracts a provider composes against live
+// in `@executablemd/terminal` and are imported from there.
+export { installTerminalGridProfile } from "./src/terminal/profile.ts";
+export type { TerminalGridProfileOptions } from "./src/terminal/profile.ts";
+export { createTerminalGridJournal } from "./src/terminal/journal.ts";
+export type { GridIdentity } from "./src/terminal/journal.ts";
 
 export { execute, Execution } from "./src/execute.ts";
 export type {