@akanjs/devkit 3.0.0-beta.10 → 3.0.0-beta.11

package/cloud/cloudApi.ts

@@ -43,6 +43,30 @@ class HttpClient {
   }
 }
 
+/**
+ * A share the control plane just issued. `token` is the connector credential — whoever holds it can become the
+ * origin behind `hostname`, so it is never written to disk or logged, only handed to the agent in memory.
+ */
+export interface TunnelGrant {
+  code: string;
+  hostname: string;
+  url: string;
+  /** The gateway to dial, as `wss://tunnel.akanjs.com`. The control plane names it; the CLI never assumes one. */
+  gatewayUrl: string;
+  token: string;
+  expiresAt: string | null;
+}
+
+export interface TunnelSummary {
+  code: string;
+  hostname: string;
+  url: string;
+  name: string | null;
+  createdAt: string;
+  expiresAt: string | null;
+  connected: boolean;
+}
+
 export class CloudApi {
   readonly #api: HttpClient;
   #accessToken: AccessToken | null = null;
@@ -108,6 +132,17 @@ export class CloudApi {
     this.#api.setHeaders({ Authorization: `Bearer ${this.#accessToken.jwt}` });
     return this.#accessToken;
   }
+  async requestTunnel(input: { name: string; ttlMinutes?: number }): Promise<TunnelGrant> {
+    return await this.#api.post<TunnelGrant>(`/requestTunnel`, input);
+  }
+  /** The generated name of the model's own `inSelf` slice: a hand-written `listTunnels` would collide with it. */
+  async tunnelListInSelf(): Promise<TunnelSummary[]> {
+    return await this.#api.get<TunnelSummary[]>(`/tunnelListInSelf`);
+  }
+  /** Hands the grant back. The CLI calls this "stop", which is what the operator is doing, not what it does. */
+  async revokeTunnel(code: string): Promise<boolean> {
+    return await this.#api.post<boolean>(`/revokeTunnel`, { code });
+  }
   async getRemoteSelf(): Promise<{ id: string; nickname: string } | null> {
     try {
       const data = await this.#api.get<{ id: string; nickname: string }>(`/getRemoteSelf`);

package/executors.ts

@@ -1714,6 +1714,7 @@ export class AppExecutor extends SysExecutor {
       executor: this,
       getPath: (rel) => this.getPath(rel),
       fileExists: (rel) => FileSys.fileExists(this.getPath(rel)),
+      readFile: (rel) => this.readFile(rel),
       writeFile: async (rel, content, opts) => {
         await this.writeFile(rel, content, opts);
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/devkit",
-  "version": "3.0.0-beta.10",
+  "version": "3.0.0-beta.11",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -44,7 +44,7 @@
     "@langchain/openai": "^1.4.6",
     "@tailwindcss/node": "^4.3.0",
     "@trapezedev/project": "^7.1.4",
-    "akanjs": "3.0.0-beta.10",
+    "akanjs": "3.0.0-beta.11",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "dayjs": "^1.11.20",