fix(workboard): keep shared contract outside extension graph

RomneyDa · RomneyDa · commit f92300a45c26 · 2026-07-08T13:53:19.000-06:00
diff --git a/extensions/tsconfig.package-boundary.paths.json b/extensions/tsconfig.package-boundary.paths.json
@@ -275,6 +275,9 @@
       "@openclaw/normalization-core/*": [
         "../dist/plugin-sdk/packages/normalization-core/src/*.d.ts"
       ],
+      "@openclaw/workboard-contract": [
+        "../packages/workboard-contract/src/index.ts"
+      ],
       "@openclaw/acp-core": [
         "../dist/plugin-sdk/packages/acp-core/src/index.d.ts"
       ],
diff --git a/extensions/workboard/package.json b/extensions/workboard/package.json
@@ -4,14 +4,12 @@
   "private": true,
   "description": "OpenClaw dashboard workboard plugin",
   "type": "module",
-  "exports": {
-    "./contract.js": "./contract.ts"
-  },
   "dependencies": {
     "typebox": "1.3.3"
   },
   "devDependencies": {
     "@openclaw/plugin-sdk": "workspace:*",
+    "@openclaw/workboard-contract": "workspace:*",
     "openclaw": "workspace:*"
   },
   "peerDependencies": {
diff --git a/extensions/workboard/runtime-api.ts b/extensions/workboard/runtime-api.ts
@@ -7,4 +7,4 @@ export type {
   WorkboardListResult,
   WorkboardPriority,
   WorkboardStatus,
-} from "./contract.js";
+} from "@openclaw/workboard-contract";
diff --git a/extensions/workboard/src/card-lookup.ts b/extensions/workboard/src/card-lookup.ts
@@ -1,5 +1,5 @@
 // Workboard plugin module implements card lookup behavior.
-import type { WorkboardCard } from "../contract.js";
+import type { WorkboardCard } from "@openclaw/workboard-contract";
 
 type WorkboardCardLookupResult =
   | { card: WorkboardCard; error?: undefined }
diff --git a/extensions/workboard/src/cli.ts b/extensions/workboard/src/cli.ts
@@ -1,10 +1,10 @@
+import type { WorkboardCard } from "@openclaw/workboard-contract";
 // Workboard plugin module implements cli behavior.
 import type { Command } from "commander";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { addGatewayClientOptions, callGatewayFromCli } from "openclaw/plugin-sdk/gateway-runtime";
 import { getRuntimeConfig } from "openclaw/plugin-sdk/runtime-config-snapshot";
 import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
-import type { WorkboardCard } from "../contract.js";
 import { resolveWorkboardCardByIdOrPrefix } from "./card-lookup.js";
 import type { WorkboardDispatchResult, WorkboardStore } from "./store.js";
 
diff --git a/extensions/workboard/src/command.ts b/extensions/workboard/src/command.ts
@@ -1,6 +1,6 @@
+import type { WorkboardCard } from "@openclaw/workboard-contract";
 // Workboard plugin module implements command behavior.
 import type { OpenClawPluginApi } from "../api.js";
-import type { WorkboardCard } from "../contract.js";
 import { resolveWorkboardCardByIdOrPrefix } from "./card-lookup.js";
 import {
   dispatchAndStartWorkboardCards,
diff --git a/extensions/workboard/src/dispatcher.ts b/extensions/workboard/src/dispatcher.ts
@@ -1,8 +1,12 @@
 // Workboard plugin module implements dispatcher behavior.
 import path from "node:path";
+import type {
+  WorkboardCard,
+  WorkboardExecution,
+  WorkboardWorkspace,
+} from "@openclaw/workboard-contract";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import type { PluginRuntime } from "openclaw/plugin-sdk/plugin-runtime";
-import type { WorkboardCard, WorkboardExecution, WorkboardWorkspace } from "../contract.js";
 import { WorkboardStore, type WorkboardDispatchResult } from "./store.js";
 
 const DEFAULT_DISPATCH_MAX_STARTS = 3;
diff --git a/extensions/workboard/src/gateway.ts b/extensions/workboard/src/gateway.ts
@@ -1,7 +1,7 @@
+import { WORKBOARD_STATUSES, type WorkboardCard } from "@openclaw/workboard-contract";
 // Workboard plugin module implements gateway behavior.
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import type { OpenClawPluginApi } from "../api.js";
-import { WORKBOARD_STATUSES, type WorkboardCard } from "../contract.js";
 import { dispatchAndStartWorkboardCards } from "./dispatcher.js";
 import { WorkboardStore } from "./store.js";
 
diff --git a/extensions/workboard/src/persistence-types.ts b/extensions/workboard/src/persistence-types.ts
@@ -4,7 +4,7 @@ import type {
   WorkboardBoardMetadata,
   WorkboardCard,
   WorkboardNotificationSubscription,
-} from "../contract.js";
+} from "@openclaw/workboard-contract";
 
 export type PersistedWorkboardCard = {
   version: 1;
diff --git a/extensions/workboard/src/sqlite-store.ts b/extensions/workboard/src/sqlite-store.ts
@@ -2,8 +2,6 @@
 import fs from "node:fs";
 import path from "node:path";
 import { DatabaseSync, type SQLInputValue } from "node:sqlite";
-import { configureSqliteConnectionPragmas } from "openclaw/plugin-sdk/plugin-state-runtime";
-import { resolveStateDir } from "openclaw/plugin-sdk/state-paths";
 import type {
   WorkboardArtifact,
   WorkboardAttachment,
@@ -18,7 +16,9 @@ import type {
   WorkboardProof,
   WorkboardRunAttempt,
   WorkboardWorkerLog,
-} from "../contract.js";
+} from "@openclaw/workboard-contract";
+import { configureSqliteConnectionPragmas } from "openclaw/plugin-sdk/plugin-state-runtime";
+import { resolveStateDir } from "openclaw/plugin-sdk/state-paths";
 import type {
   PersistedWorkboardAttachment,
   PersistedWorkboardBoard,
diff --git a/extensions/workboard/src/store.ts b/extensions/workboard/src/store.ts
@@ -1,11 +1,5 @@
 // Workboard plugin module implements store behavior.
 import { randomUUID } from "node:crypto";
-import {
-  isFutureDateTimestampMs,
-  MAX_DATE_TIMESTAMP_MS,
-  resolveExpiresAtMsFromDurationMs,
-} from "openclaw/plugin-sdk/number-runtime";
-import { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
 import {
   WORKBOARD_DIAGNOSTIC_KINDS,
   WORKBOARD_DIAGNOSTIC_SEVERITIES,
@@ -54,7 +48,13 @@ import {
   type WorkboardWorkerLog,
   type WorkboardWorkerProtocol,
   type WorkboardWorkspace,
-} from "../contract.js";
+} from "@openclaw/workboard-contract";
+import {
+  isFutureDateTimestampMs,
+  MAX_DATE_TIMESTAMP_MS,
+  resolveExpiresAtMsFromDurationMs,
+} from "openclaw/plugin-sdk/number-runtime";
+import { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
 import type {
   PersistedWorkboardAttachment,
   PersistedWorkboardBoard,
diff --git a/extensions/workboard/src/tools.ts b/extensions/workboard/src/tools.ts
@@ -1,9 +1,9 @@
+import type { WorkboardCard } from "@openclaw/workboard-contract";
 // Workboard plugin module implements tools behavior.
 import { jsonResult, readStringParam } from "openclaw/plugin-sdk/core";
 import type { AnyAgentTool, OpenClawPluginApi } from "openclaw/plugin-sdk/plugin-entry";
 import type { OpenClawPluginToolContext } from "openclaw/plugin-sdk/plugin-entry";
 import { Type } from "typebox";
-import type { WorkboardCard } from "../contract.js";
 import { WorkboardStore } from "./store.js";
 
 function contextOwner(ctx: OpenClawPluginToolContext | undefined): string {
diff --git a/packages/workboard-contract/npm-shrinkwrap.json b/packages/workboard-contract/npm-shrinkwrap.json
diff --git a/packages/workboard-contract/package.json b/packages/workboard-contract/package.json
@@ -0,0 +1,9 @@
+{
+  "name": "@openclaw/workboard-contract",
+  "version": "0.0.0-private",
+  "private": true,
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  }
+}
diff --git a/packages/workboard-contract/src/index.ts b/packages/workboard-contract/src/index.ts
@@ -1,4 +1,4 @@
-// Workboard contract declarations define the plugin's public data model.
+// Workboard contract declarations define the plugin's shared data model.
 export const WORKBOARD_STATUSES = [
   "triage",
   "backlog",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/scripts/lib/extension-package-boundary.ts b/scripts/lib/extension-package-boundary.ts
@@ -188,6 +188,7 @@ export const EXTENSION_PACKAGE_BOUNDARY_BASE_PATHS = {
     "../dist/plugin-sdk/packages/normalization-core/src/string-coerce.d.ts",
   ],
   "@openclaw/normalization-core/*": ["../dist/plugin-sdk/packages/normalization-core/src/*.d.ts"],
+  "@openclaw/workboard-contract": ["../packages/workboard-contract/src/index.ts"],
   ...buildPackageBoundaryDtsPaths({
     packageName: "@openclaw/acp-core",
     packageDir: "acp-core",
diff --git a/test/vitest/vitest.shared.config.ts b/test/vitest/vitest.shared.config.ts
@@ -465,6 +465,7 @@ export const sharedVitestConfig = {
       sourcePackageAlias("media-core", "mime"),
       sourcePackageAlias("media-core", "read-byte-stream-with-limit"),
       sourcePackageAlias("media-core"),
+      sourcePackageAlias("workboard-contract"),
       ...sourcePackageAliasesFromExports("acp-core", acpCorePackageJson.exports),
       ...sourcePluginSdkSubpaths.map((subpath) => ({
         find: `openclaw/plugin-sdk/${subpath}`,
diff --git a/tsconfig.json b/tsconfig.json
@@ -156,6 +156,7 @@
         "./packages/normalization-core/src/utf16-slice.ts"
       ],
       "@openclaw/normalization-core/*": ["./packages/normalization-core/src/*"],
+      "@openclaw/workboard-contract": ["./packages/workboard-contract/src/index.ts"],
       "@openclaw/acp-core": ["./packages/acp-core/src/index.ts"],
       "@openclaw/acp-core/meta": ["./packages/acp-core/src/meta.ts"],
       "@openclaw/acp-core/numeric-options": ["./packages/acp-core/src/numeric-options.ts"],
diff --git a/tsdown.config.ts b/tsdown.config.ts
@@ -227,6 +227,8 @@ function shouldAlwaysBundleDependency(id: string): boolean {
     id.startsWith("@openclaw/media-core/") ||
     id === "@openclaw/acp-core" ||
     id.startsWith("@openclaw/acp-core/") ||
+    id === "@openclaw/workboard-contract" ||
+    id.startsWith("@openclaw/workboard-contract/") ||
     id === "zod" ||
     id.startsWith("zod/")
   );
diff --git a/ui/package.json b/ui/package.json
@@ -14,7 +14,7 @@
     "@openclaw/libterminal": "0.3.1",
     "@openclaw/media-core": "workspace:*",
     "@openclaw/normalization-core": "workspace:*",
-    "@openclaw/workboard": "workspace:*",
+    "@openclaw/workboard-contract": "workspace:*",
     "@openclaw/uirouter": "0.1.0",
     "dompurify": "3.4.11",
     "ghostty-web": "0.4.0",
diff --git a/ui/src/lib/workboard/index.ts b/ui/src/lib/workboard/index.ts
@@ -45,7 +45,7 @@ import {
   type WorkboardWorkerLog,
   type WorkboardWorkerProtocol,
   type WorkboardWorkspace,
-} from "@openclaw/workboard/contract.js";
+} from "@openclaw/workboard-contract";
 import { GatewayRequestError, type GatewayBrowserClient } from "../../api/gateway.ts";
 import type { GatewaySessionRow } from "../../api/types.ts";
 import { requestSessionCreate } from "../sessions/index.ts";
diff --git a/ui/vite.config.ts b/ui/vite.config.ts
@@ -158,6 +158,7 @@ export function resolveSourcePackageAliasesForVite(): ControlUiViteAlias[] {
     sourcePackageAlias("normalization-core", "string-normalization"),
     sourcePackageAlias("normalization-core", "utf16-slice"),
     sourcePackageAlias("normalization-core"),
+    sourcePackageAlias("workboard-contract"),
   ];
 }
 
diff --git a/ui/vitest.config.ts b/ui/vitest.config.ts
@@ -46,6 +46,10 @@ const workspaceSourceAliases = [
     find: "@openclaw/media-core",
     replacement: path.resolve(repoRoot, "packages/media-core/src/index.ts"),
   },
+  {
+    find: "@openclaw/workboard-contract",
+    replacement: path.resolve(repoRoot, "packages/workboard-contract/src/index.ts"),
+  },
   {
     find: /^@openclaw\/net-policy\/(.+)$/u,
     replacement: path.resolve(repoRoot, "packages/net-policy/src/$1"),
