@akanjs/cli 3.0.0-beta.7 → 3.0.0-beta.8

package/.build-stamp

@@ -1 +1 @@
-9e33ade766cacd9904efc83145b59bdfd1e58d8e47a794657e6c0f1aa7349292
+12db5271f628dad0e03d37da2235d3eb2f1d6e5e39d63e6c1962eb73baaddfae

package/{abstractCompactor-mjh5ppsq.js → abstractCompactor-gmkc0z8j.js}

@@ -1,8 +1,9 @@
 // @bun
 import"./index-q0y2jq9j.js";
+import"./index-m0xccmmm.js";
 import {
   AiSession
-} from "./index-kn1h7p1x.js";
+} from "./index-te54x9zm.js";
 import {
   AbstractDoc
 } from "./index-meh558jy.js";

package/{agent.command-d2gfxfck.js → agent.command-0q17pnrs.js}

@@ -2,7 +2,7 @@
 import {
   Workspace,
   command
-} from "./index-mak3cd28.js";
+} from "./index-0g7r8xz3.js";
 import"./index-q0y2jq9j.js";
 import"./index-2tv3fdx4.js";
 import"./index-6wwzs1bc.js";
@@ -12,7 +12,7 @@ import"./index-ktb5njgy.js";
 import"./index-h7yw2z9n.js";
 import {
   AgentScript
-} from "./index-ne2qy0nk.js";
+} from "./index-k2j1hc4r.js";
 
 // pkgs/@akanjs/cli/agent/agent.command.ts
 class AgentCommand extends command("agent", [AgentScript], ({ public: target }) => ({

package/{application.command-pj2m7584.js → application.command-18y0s485.js}

@@ -6,14 +6,14 @@ import {
   Exec,
   Workspace,
   command
-} from "./index-mak3cd28.js";
+} from "./index-0g7r8xz3.js";
 import"./index-q0y2jq9j.js";
 import"./index-2tv3fdx4.js";
 import"./index-6wwzs1bc.js";
 import {
   ApplicationScript
-} from "./index-v0qh106m.js";
-import"./index-259dsnz3.js";
+} from "./index-sj5vxr8f.js";
+import"./index-vxtad5bd.js";
 import"./index-hwkygn9s.js";
 import {
   AbstractDoc

package/{cloud.command-jshwdq22.js → cloud.command-av97ndh6.js}

@@ -2,29 +2,30 @@
 import"./index-q0y2jq9j.js";
 import {
   GlobalConfig
-} from "./index-kn1h7p1x.js";
+} from "./index-m0xccmmm.js";
 import {
   Workspace,
   command
-} from "./index-mak3cd28.js";
+} from "./index-0g7r8xz3.js";
 import"./index-2tv3fdx4.js";
 import"./index-6wwzs1bc.js";
-import"./index-v0qh106m.js";
-import"./index-259dsnz3.js";
+import"./index-te54x9zm.js";
+import"./index-sj5vxr8f.js";
+import"./index-vxtad5bd.js";
 import"./index-hwkygn9s.js";
 import"./index-kcxmv48c.js";
-import"./index-ws5e0j51.js";
-import"./index-2hq52jq3.js";
+import"./index-9077wzd2.js";
+import"./index-rtxxan88.js";
 import {
-  CloudScript
-} from "./index-zry5nz81.js";
+  CloudScript2
+} from "./index-2xp0kfkt.js";
 import"./index-j9yhg404.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.command.ts
 var localRegistryUrl = () => process.env.AKAN_NPM_REGISTRY ?? "http://127.0.0.1:4873";
 var resolveRegistryUrl = (registry) => registry === "local" ? localRegistryUrl() : undefined;
 
-class CloudCommand extends command("cloud", [CloudScript], ({ public: target }) => ({
+class CloudCommand extends command("cloud", [CloudScript2], ({ public: target }) => ({
   login: target({ desc: "Login to Akan Cloud services" }).option("host", String, { desc: "host of the cloud", default: GlobalConfig.akanCloudHost }).with(Workspace).exec(async function(host, workspace) {
     await this.cloudScript.login(workspace, host);
   }),

package/cloud.script-cm11xjdz.js

@@ -0,0 +1,20 @@
+// @bun
+import {
+  CloudScript2
+} from "./index-2xp0kfkt.js";
+import"./index-rtxxan88.js";
+import"./index-sj5vxr8f.js";
+import"./index-j9yhg404.js";
+import"./index-vxtad5bd.js";
+import"./index-9077wzd2.js";
+import"./index-te54x9zm.js";
+import"./index-m0xccmmm.js";
+import"./index-0g7r8xz3.js";
+import"./index-hwkygn9s.js";
+import"./index-2tv3fdx4.js";
+import"./index-6wwzs1bc.js";
+import"./index-kcxmv48c.js";
+import"./index-q0y2jq9j.js";
+export {
+  CloudScript2 as CloudScript
+};

package/{context.command-ez8a0zyz.js → context.command-5v37ef3n.js}

@@ -2,7 +2,7 @@
 import {
   Workspace,
   command
-} from "./index-mak3cd28.js";
+} from "./index-0g7r8xz3.js";
 import"./index-q0y2jq9j.js";
 import"./index-2tv3fdx4.js";
 import"./index-6wwzs1bc.js";
@@ -11,16 +11,17 @@ import"./index-gyd220p2.js";
 import"./index-ktb5njgy.js";
 import {
   ContextScript
-} from "./index-600zhnve.js";
+} from "./index-y6n8nmny.js";
 import"./index-wt7qrtd4.js";
 import"./index-h7yw2z9n.js";
-import"./index-fz5q3gd7.js";
-import"./index-7737gxcp.js";
-import"./index-kn1h7p1x.js";
-import"./index-8pm30m73.js";
-import"./index-pnqbkf5p.js";
-import"./index-4edzf1gr.js";
-import"./index-rwg2aa4f.js";
+import"./index-04bk599g.js";
+import"./index-ffvk10zz.js";
+import"./index-m0xccmmm.js";
+import"./index-te54x9zm.js";
+import"./index-5ystnsd5.js";
+import"./index-vyvre9en.js";
+import"./index-d43r08tf.js";
+import"./index-a17x49vg.js";
 
 // pkgs/@akanjs/cli/context/context.command.ts
 class ContextCommand extends command("context", [ContextScript], ({ public: target }) => ({

package/{devTui-40ggmd99.js → devTui-m1atgkc9.js}

@@ -4,7 +4,7 @@ import {
   plainTextOf,
   HOST_SOURCE,
   DevLogBuffer
-} from "./index-v0qh106m.js";
+} from "./index-sj5vxr8f.js";
 
 // pkgs/@akanjs/cli/application/devTui.tsx
 import { render } from "ink";

package/{devTuiView-c08ccbat.js → devTuiView-0hc2emhe.js}

@@ -1,7 +1,7 @@
 // @bun
 // pkgs/@akanjs/cli/application/devTuiView.ts
 var createDevTuiView = async (supervisor) => {
-  const { DevTui } = await import("./devTui-40ggmd99.js");
+  const { DevTui } = await import("./devTui-m1atgkc9.js");
   return new DevTui(supervisor);
 };
 export {

package/{guideline.command-xmqwx8zm.js → guideline.command-4pz9g1rt.js}

@@ -4,7 +4,7 @@ import {
   runner,
   script,
   command
-} from "./index-mak3cd28.js";
+} from "./index-0g7r8xz3.js";
 import {
   FileSys
 } from "./index-q0y2jq9j.js";
@@ -15,9 +15,10 @@ import {
 import {
   Prompter
 } from "./index-h7yw2z9n.js";
+import"./index-m0xccmmm.js";
 import {
   AiSession
-} from "./index-kn1h7p1x.js";
+} from "./index-te54x9zm.js";
 
 // pkgs/@akanjs/cli/guideline/guideline.script.ts
 import { Logger } from "akanjs/common";

package/guidelines/agentRule/agentRule.instruction.md

@@ -164,6 +164,43 @@ apps and libs never import it directly (`no-import-external-library`) — everyt
   WebView, **which has neither on Android or iOS**, so a `speech.plugin.ts` declares the permission and
   the packages the native build needs. An engine answering `available()` false renders no microphone at all,
   the same rule as publishing no tool for a control the screen does not draw.
+- **Data the user points at rides the message too, as `references` — and its value is a snapshot.** A file is
+  something they handed over; a reference is something they pointed at while asking, so it belongs in the same
+  place and for the same reason. Screen context does not do this job: `ContextBlock`s are rebuilt from the screen
+  every turn, so what was named three turns ago is simply not in the conversation any more. A `MessageReference`
+  carries the host's own `refName`, the id, a label, an optional dotted `path` into the document, and the `value`
+  those resolved to. **The value is never re-read on a later turn**, which is the point: re-reading rewrites what
+  the person was looking at when they spoke, and the usual next thing the agent does is edit the very field it was
+  pointed at — leaving a live reference showing the result with no record of what it was changed from.
+  `refName`/`refId`/`path` travel so a tool can read the current value when the answer needs it, and
+  `AgentService.referenced` folds the whole lot into the message text in one place, so every provider carries a
+  reference without either adaptor knowing the word. **The value is masked on the way in and nowhere else**: masking
+  needs the model class, which no wire carries, so the model a host names when it stages the reference is the whole
+  of the decision about what leaves the browser — name the class that actually holds the field, because a `Light`
+  one usually does not. **The ceiling is 20,000 characters per reference**, applied as it is staged and again on
+  the server; a reference is bulkier than a tool result and outlives one, riding every later turn and being the last
+  thing compaction folds. Persisting keeps the pointer and drops the value with a note saying so, which is a better
+  restored state than an attachment can offer — the pointer is still live, so the answer is to read it again.
+  Staging lives on the **session** (`stage` / `staged` / `unstage(key)` / `clearStaged()`), not on the composer where
+  staged files live, because a reference comes from whichever component drew the data rather than from the paperclip;
+  `unstage` is keyed on `refName/refId#path` because what orders a message's references is its text, not that list.
+- **Two ways to point at data, and which one depends on who knows the value.** `<Agent.Chat reference={[…]} />`
+  takes one `ReferenceSource` per kind of document — `refName`, a `type`, the app's own `search`, and a `resolve` —
+  and the composer's `@` menu offers whole documents from them; the token is written the moment a row is picked and
+  the value is staged when `resolve` lands, so a slow fetch never freezes the menu and one that fails leaves a
+  pointer that reads as *go and read it*. For a field *inside* a document, the component drawing it calls
+  `useAgentReference()` — it already holds the value, so there is no round trip, and it is the only thing that
+  knows a rich-text field stored as `field(Any)` reads as a paragraph rather than as the editor document it is. The
+  hook no-ops with a warning outside a session, the same call `AgentValue.publishable` makes: a card carrying a
+  reference button must not cost a route its render.
+- **The token in the draft is what carries a reference, and the chip only draws it.** Deleting
+  `@[label](mention:refName/id#path)` by hand drops the reference exactly as removing the chip does — removing the
+  chip removes the token — so the two can never disagree, and nothing re-derives a value from text somebody edited.
+  A token pasted out of an earlier message travels as a pointer with a note, which is the same shape a restored
+  conversation produces. Staged references are the **session's**, not the composer's, because `useAgentReference`
+  is called from components the composer cannot see; writing the token is the composer's half, and `refer` warns
+  rather than staging silently when no chat is mounted on that session — the case where a card sits outside the
+  `<Agent.Zone>` its chat is inside.
 - **`attach` and `voice` both carry functions, so a server layout cannot pass either.** A closure does not cross
   the RSC boundary — `non-scalar-props-restricted` says so on `page/**` — so an app that wants either mounts the
   chat from a small client component in the app's own `ui/` that calls the hook.

package/{index-fz5q3gd7.js → index-04bk599g.js}

@@ -11,7 +11,7 @@ import {
 } from "./index-ktb5njgy.js";
 import {
   runner
-} from "./index-mak3cd28.js";
+} from "./index-0g7r8xz3.js";
 
 // pkgs/@akanjs/cli/repair/repair.runner.ts
 var commandForShell = (command) => command.startsWith("akan ") ? `bun run ${command}` : command;

package/{index-zry5nz81.js → index-2xp0kfkt.js}

@@ -1,28 +1,30 @@
 // @bun
 import {
   GlobalConfig,
-  CloudApi,
-  AiSession
-} from "./index-kn1h7p1x.js";
+  CloudApi
+} from "./index-m0xccmmm.js";
 import {
   PkgExecutor
 } from "./index-2tv3fdx4.js";
+import {
+  AiSession
+} from "./index-te54x9zm.js";
 import {
   script
-} from "./index-mak3cd28.js";
+} from "./index-0g7r8xz3.js";
 import {
   ApplicationScript
-} from "./index-v0qh106m.js";
+} from "./index-sj5vxr8f.js";
 import {
   PackageScript
-} from "./index-ws5e0j51.js";
+} from "./index-9077wzd2.js";
 import {
   CloudRunner
-} from "./index-2hq52jq3.js";
+} from "./index-rtxxan88.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.script.ts
 import { Logger } from "akanjs/common";
-class CloudScript extends script("cloud", [CloudRunner, ApplicationScript, PackageScript]) {
+class CloudScript2 extends script("cloud", [CloudRunner, ApplicationScript, PackageScript]) {
   async login(workspace, host = GlobalConfig.akanCloudHost) {
     await this.cloudRunner.login(host, workspace);
   }
@@ -48,16 +50,23 @@ class CloudScript extends script("cloud", [CloudRunner, ApplicationScript, Packa
     }
     await this.cloudRunner.downloadEnvByScp(workspace);
   }
-  async uploadEnv(workspace, { host = GlobalConfig.akanCloudHost } = {}) {
-    const workspaceId = workspace.getWorkspaceId({ allowEmpty: true });
-    const { path } = await this.cloudRunner.gatherEnvFiles(workspace);
+  async uploadEnv(workspace, {
+    host = GlobalConfig.akanCloudHost,
+    workspaceId = workspace.getWorkspaceId({ allowEmpty: true }),
+    scope,
+    archivePath
+  } = {}) {
+    if (scope && !workspaceId)
+      throw new Error("A scoped env upload needs a cloud workspace id \u2014 the scp target is workspace-wide.");
+    const { files, path } = await this.cloudRunner.gatherEnvFiles(workspace, { scope, archivePath });
     if (workspaceId) {
       await this.login(workspace, host);
       const cloudApi = await CloudApi.fromHost(workspace, host);
       await this.cloudRunner.uploadEnv(cloudApi, workspaceId, path);
-      return;
+      return { workspaceId, files };
     }
     await this.cloudRunner.uploadEnvByScp(workspace, path);
+    return { workspaceId: null, files };
   }
   async deployAkan(workspace, { test = true, registryUrl } = {}) {
     const akanPkgs = await this.cloudRunner.getAkanPkgs(workspace);
@@ -80,4 +89,4 @@ class CloudScript extends script("cloud", [CloudRunner, ApplicationScript, Packa
   }
 }
 
-export { CloudScript };
+export { CloudScript2 };

package/{index-8pm30m73.js → index-5ystnsd5.js}

@@ -2,16 +2,16 @@
 import {
   FileSys
 } from "./index-q0y2jq9j.js";
-import {
-  AiSession
-} from "./index-kn1h7p1x.js";
 import {
   ModuleExecutor
 } from "./index-2tv3fdx4.js";
+import {
+  AiSession
+} from "./index-te54x9zm.js";
 import {
   runner,
   script
-} from "./index-mak3cd28.js";
+} from "./index-0g7r8xz3.js";
 import {
   sourceFile,
   moduleSourcePaths,
@@ -22,7 +22,7 @@ import {
 } from "./index-gyd220p2.js";
 import {
   PageScript
-} from "./index-pnqbkf5p.js";
+} from "./index-vyvre9en.js";
 import {
   Prompter
 } from "./index-h7yw2z9n.js";

package/{index-ws5e0j51.js → index-9077wzd2.js}

@@ -2,7 +2,7 @@
 import {
   runner,
   script
-} from "./index-mak3cd28.js";
+} from "./index-0g7r8xz3.js";
 import {
   FileSys
 } from "./index-q0y2jq9j.js";

package/{index-rwg2aa4f.js → index-a17x49vg.js}

@@ -2,7 +2,7 @@
 import {
   runner,
   script
-} from "./index-mak3cd28.js";
+} from "./index-0g7r8xz3.js";
 import {
   generatedFilesForSync,
   createPassedPrimitiveReport,
@@ -10,7 +10,7 @@ import {
 } from "./index-gyd220p2.js";
 import {
   AiSession
-} from "./index-kn1h7p1x.js";
+} from "./index-te54x9zm.js";
 import {
   Prompter
 } from "./index-h7yw2z9n.js";

package/{index-4edzf1gr.js → index-d43r08tf.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   script
-} from "./index-mak3cd28.js";
+} from "./index-0g7r8xz3.js";
 import {
   AppExecutor,
   LibExecutor,
@@ -42,7 +42,7 @@ import {
 } from "./index-gyd220p2.js";
 import {
   ModuleScript
-} from "./index-8pm30m73.js";
+} from "./index-5ystnsd5.js";
 
 // pkgs/@akanjs/cli/primitive/primitive.script.ts
 import { capitalize } from "akanjs/common";

package/{index-7737gxcp.js → index-ffvk10zz.js}

@@ -26,7 +26,7 @@ import {
 } from "./index-ktb5njgy.js";
 import {
   runner
-} from "./index-mak3cd28.js";
+} from "./index-0g7r8xz3.js";
 
 // pkgs/@akanjs/cli/workflow/workflow.runner.ts
 import { mkdir, readFile, writeFile } from "fs/promises";

package/{index-ne2qy0nk.js → index-k2j1hc4r.js}

@@ -2,7 +2,7 @@
 import {
   runner,
   script
-} from "./index-mak3cd28.js";
+} from "./index-0g7r8xz3.js";
 import {
   AGENT_BLOCK_START,
   AGENT_BLOCK_END,

package/index-m0xccmmm.js

@@ -0,0 +1,228 @@
+// @bun
+import {
+  FileSys
+} from "./index-q0y2jq9j.js";
+
+// pkgs/@akanjs/devkit/cloud/globalConfig.ts
+import { chmod, mkdir } from "fs/promises";
+import dayjs from "dayjs";
+
+// pkgs/@akanjs/devkit/cloud/constants.ts
+var basePath = `${Bun.env.HOME ?? Bun.env.USERPROFILE}/.akan`;
+var configPath = `${basePath}/config.json`;
+var getDefaultHostConfig = (host = GlobalConfig.akanCloudHost) => ({ host });
+var defaultAkanGlobalConfig = {
+  cloudHost: {},
+  remoteEnvServers: {},
+  llm: null
+};
+
+// pkgs/@akanjs/devkit/cloud/globalConfig.ts
+class GlobalConfig {
+  static akanCloudHost = process.env.USE_AKANJS_PKGS === "true" ? `http://localhost:${process.env.CLOUD_HOST_PORT ?? 8283}` : "https://cloud.akanjs.com";
+  static async#getAkanGlobalConfig() {
+    const exists = await FileSys.fileExists(configPath);
+    const akanConfig = exists ? await FileSys.readJson(configPath) : {};
+    return {
+      ...defaultAkanGlobalConfig,
+      ...akanConfig,
+      cloudHost: akanConfig.cloudHost ?? defaultAkanGlobalConfig.cloudHost,
+      remoteEnvServers: akanConfig.remoteEnvServers ?? defaultAkanGlobalConfig.remoteEnvServers
+    };
+  }
+  static async#setAkanGlobalConfig(akanConfig) {
+    await mkdir(basePath, { recursive: true, mode: 448 });
+    await Bun.write(configPath, JSON.stringify(akanConfig, null, 2));
+    await chmod(configPath, 384);
+  }
+  static async getHostConfig(host = GlobalConfig.akanCloudHost) {
+    const akanConfig = await GlobalConfig.#getAkanGlobalConfig();
+    return GlobalConfig.toHostConfig(akanConfig.cloudHost[host] ?? getDefaultHostConfig(host));
+  }
+  static async setHostConfig(config = getDefaultHostConfig()) {
+    const akanConfig = await GlobalConfig.#getAkanGlobalConfig();
+    akanConfig.cloudHost[config.host] = GlobalConfig.toHostConfigDto(config);
+    await GlobalConfig.#setAkanGlobalConfig(akanConfig);
+  }
+  static async getLlmConfig() {
+    const akanConfig = await GlobalConfig.#getAkanGlobalConfig();
+    return akanConfig.llm ?? null;
+  }
+  static async setLlmConfig(llmConfig) {
+    const akanConfig = await GlobalConfig.#getAkanGlobalConfig();
+    await GlobalConfig.#setAkanGlobalConfig({ ...akanConfig, llm: llmConfig });
+  }
+  static async getRemoteEnvServers() {
+    const akanConfig = await GlobalConfig.#getAkanGlobalConfig();
+    return akanConfig.remoteEnvServers;
+  }
+  static async setRemoteEnvServer(name, config) {
+    const akanConfig = await GlobalConfig.#getAkanGlobalConfig();
+    await GlobalConfig.#setAkanGlobalConfig({
+      ...akanConfig,
+      remoteEnvServers: {
+        ...akanConfig.remoteEnvServers,
+        [name]: config
+      }
+    });
+  }
+  static async removeRemoteEnvServer(name) {
+    const akanConfig = await GlobalConfig.#getAkanGlobalConfig();
+    const { [name]: _, ...remoteEnvServers } = akanConfig.remoteEnvServers;
+    await GlobalConfig.#setAkanGlobalConfig({
+      ...akanConfig,
+      remoteEnvServers
+    });
+  }
+  static needRefreshToken(accessToken) {
+    return !!accessToken?.expiresAt?.isBefore(dayjs().add(1, "hour"));
+  }
+  static toAccessToken(accessToken) {
+    return {
+      jwt: accessToken.jwt,
+      refreshToken: accessToken.refreshToken ?? null,
+      expiresAt: accessToken.expiresAt ? dayjs(accessToken.expiresAt) : null
+    };
+  }
+  static toAccessTokenDto(accessToken) {
+    return {
+      jwt: accessToken.jwt,
+      refreshToken: accessToken.refreshToken ?? null,
+      expiresAt: accessToken.expiresAt?.toString() ?? null
+    };
+  }
+  static toHostConfigDto(hostConfig) {
+    return {
+      host: hostConfig.host,
+      auth: {
+        accessToken: hostConfig.auth?.accessToken ? GlobalConfig.toAccessTokenDto(hostConfig.auth.accessToken) : undefined,
+        self: hostConfig.auth?.self
+      }
+    };
+  }
+  static toHostConfig(hostConfigDto) {
+    return {
+      host: hostConfigDto.host,
+      auth: {
+        accessToken: hostConfigDto.auth?.accessToken ? GlobalConfig.toAccessToken(hostConfigDto.auth.accessToken) : undefined,
+        self: hostConfigDto.auth?.self
+      }
+    };
+  }
+}
+
+// pkgs/@akanjs/devkit/cloud/cloudApi.ts
+class HttpClient {
+  baseUrl;
+  headers = {};
+  constructor(baseUrl, headers = {}) {
+    this.baseUrl = baseUrl;
+    this.headers = headers;
+  }
+  async get(url, { headers } = {}) {
+    const response = await fetch(`${this.baseUrl}${url}`, {
+      headers: {
+        "Content-Type": "application/json",
+        ...this.headers,
+        ...headers
+      }
+    });
+    return await response.json();
+  }
+  async getFile(url, localPath, headers) {
+    const response = await fetch(`${this.baseUrl}${url}`, {
+      headers: { ...this.headers, ...headers }
+    });
+    if (!response.ok)
+      throw new Error(`Failed to download file: ${response.status} ${response.statusText}`);
+    await Bun.write(localPath, response);
+  }
+  async post(url, data, { headers } = {}) {
+    const isFormData = data instanceof FormData;
+    const response = await fetch(`${this.baseUrl}${url}`, {
+      method: "POST",
+      body: isFormData ? data : JSON.stringify(data),
+      headers: isFormData ? { ...this.headers, ...headers } : { "Content-Type": "application/json", ...this.headers, ...headers }
+    });
+    return await response.json();
+  }
+  setHeaders(headers) {
+    Object.assign(this.headers, headers);
+    return this;
+  }
+}
+
+class CloudApi {
+  #api;
+  #accessToken = null;
+  #workspace;
+  host;
+  url;
+  static async fromHost(workspace, host) {
+    const hostConfig = await GlobalConfig.getHostConfig(host);
+    return new CloudApi(workspace, hostConfig);
+  }
+  constructor(workspace, hostConfig) {
+    this.#workspace = workspace;
+    this.#accessToken = hostConfig.auth?.accessToken ?? null;
+    this.host = hostConfig.host;
+    this.url = `${this.host}/api`;
+    this.#api = new HttpClient(this.url);
+    if (this.#accessToken && !GlobalConfig.needRefreshToken(this.#accessToken))
+      this.#api.setHeaders({
+        Authorization: `Bearer ${this.#accessToken.jwt}`
+      });
+  }
+  async uploadEnv(devProjectId, file) {
+    const formData = new FormData;
+    formData.append("devProjectId", devProjectId);
+    formData.append("file", file);
+    const data = await this.#api.post(`/uploadEnv/${devProjectId}`, formData);
+    return data;
+  }
+  async downloadEnv(devProjectId) {
+    const localPath = `${this.#workspace.workspaceRoot}/local/env.tar`;
+    await this.#api.getFile(`/downloadEnv/${devProjectId}`, localPath);
+    return localPath;
+  }
+  async getRemoteAuthToken(remoteId) {
+    try {
+      const accessToken = await this.#api.get(`/getRemoteAuthToken/${remoteId}`);
+      this.#accessToken = GlobalConfig.toAccessToken(accessToken);
+      this.#api.setHeaders({
+        Authorization: `Bearer ${this.#accessToken.jwt}`
+      });
+      return this.#accessToken;
+    } catch (_) {
+      return null;
+    }
+  }
+  async#ensureAccessTokenLive({
+    allowUnauthorized = false
+  } = {}) {
+    if (!this.#accessToken)
+      throw new Error("No access token");
+    const needRefresh = GlobalConfig.needRefreshToken(this.#accessToken);
+    if (!needRefresh)
+      return this.#accessToken;
+    const refreshToken = this.#accessToken?.refreshToken;
+    if (!refreshToken)
+      throw new Error("No refresh token");
+    return await this.refreshAuthToken(refreshToken);
+  }
+  async refreshAuthToken(refreshToken) {
+    const response = await this.#api.post(`/refreshAuthToken`, { refreshToken });
+    this.#accessToken = GlobalConfig.toAccessToken(response);
+    this.#api.setHeaders({ Authorization: `Bearer ${this.#accessToken.jwt}` });
+    return this.#accessToken;
+  }
+  async getRemoteSelf() {
+    try {
+      const data = await this.#api.get(`/getRemoteSelf`);
+      return data;
+    } catch {
+      return null;
+    }
+  }
+}
+export { getDefaultHostConfig, GlobalConfig, CloudApi };