@foldspace_npm/harness 0.1.25 → 0.1.26

package/CLAUDE.md

@@ -21,12 +21,15 @@ something they can **see on their own page** — not at "it builds".
    project `CLAUDE.md` does not contain
    `@node_modules/@foldspace_npm/harness/CLAUDE.md`, ask before
    `foldspace upgrade --refresh-instructions`.
-2. **Is Foldspace connected? Check — never assume.** Call `list_agents`:
+2. **Is Foldspace connected? Check — never assume.** `region` in
+   `foldspace.dev.json` (absent means `us`) picks the server: `foldspace`, or
+   `foldspace-eu` for `eu`. Use that server's tools all session. Call its
+   `list_agents`:
 
    | Result | Do |
    |---|---|
-   | The tool does not exist | The Foldspace MCP is not installed in this editor. Give the one install step for *this* editor — Claude Code: `claude plugin install foldspace-agent-builder@foldspace-plugins`; anything else: the MCP block on <https://foldspace.ai/agents.md> — then check again |
-   | It exists but fails on auth | Installed, not signed in. Only the human can approve sign-in. Tell them exactly where — Claude Code: `/mcp` → **foldspace** → finish in the browser — then check again |
+   | The tool does not exist | The Foldspace MCP is not installed in this editor. Give the one install step for *this* region and editor — **EU**, any editor: the MCP block on <https://foldspace.ai/eu/agents.md>, never the plugin. **US** — Claude Code: `claude plugin install foldspace-agent-builder@foldspace-plugins`; anything else: the MCP block on <https://foldspace.ai/agents.md>. Then check again |
+   | It exists but fails on auth | Installed, not signed in. Only the human can approve sign-in. Tell them exactly where — Claude Code: `/mcp` → **foldspace-eu** (**EU**) or **foldspace** (**US**) → finish in the browser — then check again |
    | It returns agents | One agent: state its name, Agent Key and product in a line and carry on; the human objects if it is wrong. Several: ask which, as a choice |
 
 3. **Orient** — `get_agent_settings`, `list_actions`, `list_task_agents`,

package/README.md

@@ -118,6 +118,12 @@ name (`foldspace-agent` unless you pass a directory). The product ID must be
 the bare ID, not the `EU-…-1-1` SDK loader key. The app domain may be a hostname
 or an HTTP(S) URL without a port or path.
 
+`--region us|eu` (default `us`) is the Foldspace region the account lives in.
+It is written to `foldspace.dev.json` as `region`, and picks the SDK the
+project loads (`sdkUrl`): each region has its own build, pointing at that
+region's servers. A project with no `region` is US. The values per region live
+in `src/region.mjs`.
+
 For safety, `init` requires a target path that does not exist. It does not
 initialize Git or overwrite files. On a TTY it can offer
 `npm install --ignore-scripts` after scaffolding. After creation:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foldspace_npm/harness",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "description": "Build and verify portable Foldspace action artifacts against a live app.",
   "type": "module",
   "bin": {

package/src/attach-preflight.mjs

@@ -4,6 +4,7 @@ import {
   parseActionRequest,
 } from "./attach-helpers.mjs";
 import { ERROR_CODES } from "./protocol.mjs";
+import { SDK_SCRIPT_HOSTS } from "./region.mjs";
 
 export function productIdFromAgentKey(key) {
   if (typeof key !== "string") return null;
@@ -135,7 +136,7 @@ function sdkScriptIdentity(url) {
     const parsed = new URL(url);
     if (
       parsed.protocol !== "https:" ||
-      parsed.hostname !== "script.eucerahive.io" ||
+      !SDK_SCRIPT_HOSTS.includes(parsed.hostname) ||
       !/^\/web\/sdk\/(?:foldspace|eucera)\.js$/i.test(parsed.pathname)
     ) {
       return null;

package/src/cli-registry.mjs

@@ -1,5 +1,6 @@
 import { diagnosticCatalogue } from "./diagnostics.mjs";
 import { HARNESS_PROTOCOL_VERSION } from "./protocol.mjs";
+import { DEFAULT_REGION, REGION_NAMES } from "./region.mjs";
 
 export const CLI_SCHEMA_VERSION = 1;
 
@@ -21,7 +22,8 @@ export const CLI_COMMANDS = Object.freeze([
     group: "start",
     summary: "Create a configured Foldspace actions project",
     usage:
-      "foldspace init [<directory>] [--product-id <id>] [--agent-key <key>] [--app-domain <host>] [--name <display-name>]",
+      "foldspace init [<directory>] [--product-id <id>] [--agent-key <key>] [--app-domain <host>] [--name <display-name>] " +
+      `[--region <${REGION_NAMES.join("|")}>]`,
     risk: "local-write",
     environment: "node",
     environmentVariables: [],
@@ -48,6 +50,12 @@ export const CLI_COMMANDS = Object.freeze([
       value("--name", "display-name", "Display name", {
         default: "directory name",
       }),
+      value(
+        "--region",
+        REGION_NAMES.join("|"),
+        "Foldspace region of the account; sets the SDK the project loads",
+        { default: DEFAULT_REGION, choices: REGION_NAMES },
+      ),
     ],
     prerequisites: [
       "Node 20 or newer",

package/src/init.mjs

@@ -5,6 +5,7 @@ import readline from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
 import { fileURLToPath } from "node:url";
 import { commandByName } from "./cli-registry.mjs";
+import { DEFAULT_REGION, REGIONS, parseRegion } from "./region.mjs";
 
 const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const defaultTemplateRoot = path.join(packageRoot, "templates", "agent-starter");
@@ -15,6 +16,7 @@ const allowedFlags = new Set([
   "agent-api-name",
   "app-domain",
   "domain",
+  "region",
 ]);
 const tokenPattern = /\{\{([A-Z0-9_]+)\}\}/g;
 const defaultDirectory = "foldspace-agent";
@@ -99,6 +101,9 @@ export function parseInitArgs(argv) {
     productId: flags["product-id"] || null,
     agentApiName: flags["agent-key"] || flags["agent-api-name"] || null,
     domain: flags["app-domain"] || flags.domain || null,
+    // Checked here, before any prompt: a typo must not cost a whole
+    // interactive run and then fail at the end.
+    region: flags.region ? parseRegion(flags.region) : null,
   };
 }
 
@@ -275,6 +280,7 @@ function finalizeInitConfig(parsed) {
     productId: parsed.productId,
     agentApiName: parsed.agentApiName,
     domain: parsed.domain,
+    region: parsed.region || DEFAULT_REGION,
   };
 }
 
@@ -300,6 +306,7 @@ function createTemplateValues(config, harnessVersion) {
 
   const productId = validateProductId(config.productId);
   const agentApiName = validateIdentifier(config.agentApiName, "Agent Key");
+  const region = parseRegion(config.region || DEFAULT_REGION);
   const target = normalizeTarget(config.domain);
   const hosts =
     target.domain === "localhost" || /^\d+(?:\.\d+){3}$/.test(target.domain)
@@ -319,6 +326,8 @@ function createTemplateValues(config, harnessVersion) {
     START_URL: target.startUrl,
     START_URL_JSON: JSON.stringify(target.startUrl),
     HOSTS_JSON: JSON.stringify(hosts),
+    REGION_JSON: JSON.stringify(region),
+    SDK_URL_JSON: JSON.stringify(REGIONS[region].sdkUrl),
     HARNESS_VERSION: harnessVersion,
   };
 }

package/src/region.mjs

@@ -0,0 +1,54 @@
+// The Foldspace regions a project can live in. Everything region-specific in
+// the harness comes from here: init writes `region` and its `sdkUrl` into
+// foldspace.dev.json, attach recognizes the SDK on every region's script host,
+// and the startup step in CLAUDE.md names each region's server and playbook.
+//
+// `sdkUrl`: each region has its own SDK build. Same code, but its config
+// points at that region's agent, recording and tracking hosts - the US SDK on
+// an EU page talks to a US backend that does not have the EU agents.
+//
+// `server`: the Product MCP's name in the editor, as the region's playbook
+// installs it. Distinct per region, so both can sit side by side.
+export const REGIONS = Object.freeze({
+  us: Object.freeze({
+    label: "US",
+    sdkUrl: "https://script.eucerahive.io/web/sdk/foldspace.js",
+    server: "foldspace",
+    playbook: "https://foldspace.ai/agents.md",
+  }),
+  eu: Object.freeze({
+    label: "EU",
+    sdkUrl: "https://script.eu.eucerahive.io/web/sdk/foldspace.js",
+    server: "foldspace-eu",
+    playbook: "https://foldspace.ai/eu/agents.md",
+  }),
+});
+
+// Projects created before regions existed have no `region`: they are US.
+export const DEFAULT_REGION = "us";
+
+export const REGION_NAMES = Object.freeze(Object.keys(REGIONS));
+
+export function isRegion(value) {
+  return typeof value === "string" && Object.hasOwn(REGIONS, value);
+}
+
+export function parseRegion(value) {
+  const region = typeof value === "string" ? value.trim().toLowerCase() : value;
+  if (!isRegion(region)) {
+    throw new Error(
+      `Unknown region: ${value}. Use one of: ${REGION_NAMES.join(", ")}.`,
+    );
+  }
+  return region;
+}
+
+// The region a foldspace.dev.json belongs to.
+export function regionOf(config) {
+  return REGIONS[parseRegion(config?.region ?? DEFAULT_REGION)];
+}
+
+// Hostnames the Foldspace SDK is served from, in any region.
+export const SDK_SCRIPT_HOSTS = Object.freeze(
+  REGION_NAMES.map((name) => new URL(REGIONS[name].sdkUrl).hostname),
+);

package/templates/agent-starter/foldspace.dev.json

@@ -1,7 +1,8 @@
 {
   "$comment": "Generated by foldspace init. Use the bare product ID, not the EU-… SDK key.",
   "defaultTarget": "app",
-  "sdkUrl": "https://script.eucerahive.io/web/sdk/foldspace.js",
+  "region": {{REGION_JSON}},
+  "sdkUrl": {{SDK_URL_JSON}},
   "targets": {
     "app": {
       "name": "App",