terse-cli 0.7.0 → 0.8.1

package/dist/setupTools.js

@@ -0,0 +1,94 @@
+import { log } from "@clack/prompts";
+import { execFile } from "node:child_process";
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { CliError } from "./cliError.js";
+const uvInstallerDigests = {
+    sh: "bd9a2739c49251c71fd3706ac00b1bb8582ea138433c6e52840de4aba646e46a",
+    ps1: "87c68faa52d996e5e2d6606ede188b89a1fdbfdf4c4ee1da3d0c24a273881935"
+};
+export class LocalSetupTools {
+    downloads;
+    constructor(downloads) {
+        this.downloads = downloads;
+    }
+    async available(tool) {
+        configureToolPaths();
+        try {
+            if (tool === "node")
+                return atLeast(process.versions.node, [22, 19, 0]);
+            if (tool === "python") {
+                const version = await run("uv", ["python", "find", "--no-python-downloads", "--show-version", process.env.DURABLE_ACTORS_PYTHON || ">=3.11"]);
+                return atLeast(version, [3, 11, 0]);
+            }
+            const version = await run(tool, ["--version"]);
+            if (tool === "uv")
+                return atLeast(version.replace(/^uv\s+/, ""), [0, 6, 13]);
+            return tool === "bun" ? atLeast(version, [1, 4, 2]) : Boolean(version.trim());
+        }
+        catch {
+            return false;
+        }
+    }
+    async install(tool) {
+        log.step(`Installing ${tool}`);
+        if (tool === "uv")
+            await this.installUv();
+        else if (tool === "python")
+            await run("uv", ["python", "install", process.env.DURABLE_ACTORS_PYTHON || "3.13"]);
+        else if (tool === "bun")
+            await run("npm", ["install", "--global", "bun@1.4.2"]);
+        else
+            throw new CliError("unsupported_installation", `Install ${tool} using the Node.js installer.`);
+        configureToolPaths();
+    }
+    async installUv() {
+        const windows = process.platform === "win32";
+        const extension = windows ? "ps1" : "sh";
+        const url = `https://github.com/astral-sh/uv/releases/download/0.11.31/uv-installer.${extension}`;
+        const installer = await this.downloads.download(url, uvInstallerDigests[extension]);
+        const directory = await mkdtemp(path.join(os.tmpdir(), "terse-uv-install-"));
+        try {
+            const file = path.join(directory, windows ? "install.ps1" : "install.sh");
+            await writeFile(file, installer);
+            const env = { ...process.env, UV_INSTALL_DIR: uvDirectory() };
+            if (windows)
+                await run("powershell.exe", ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", file], env);
+            else
+                await run("sh", [file], env);
+        }
+        finally {
+            await rm(directory, { recursive: true, force: true });
+        }
+    }
+}
+export function configureToolPaths() {
+    const key = Object.keys(process.env).find(name => name.toLowerCase() === "path") ?? "PATH";
+    const entries = (process.env[key] ?? "").split(path.delimiter);
+    const bun = path.join(process.env.BUN_INSTALL || path.join(os.homedir(), ".bun"), "bin");
+    process.env[key] = [...new Set([uvDirectory(), ...entries, bun])].join(path.delimiter);
+}
+function uvDirectory() {
+    return process.env.UV_INSTALL_DIR || path.join(os.homedir(), ".local", "bin");
+}
+function run(command, args, env = process.env) {
+    const cleanEnv = Object.fromEntries(Object.entries(env).filter(([key]) => !key.toLowerCase().startsWith("npm_config_")));
+    return new Promise((resolve, reject) => {
+        execFile(command, args, { env: cleanEnv, shell: process.platform === "win32" && command === "npm", timeout: 120000, maxBuffer: 8 * 1024 * 1024 }, (error, stdout, stderr) => {
+            if (error)
+                reject(new CliError("tool_installation_failed", `${command} ${args.join(" ")} failed.`, { detail: stderr || error.message }));
+            else
+                resolve(stdout);
+        });
+    });
+}
+function atLeast(version, minimum) {
+    const match = /^(\d+)\.(\d+)\.(\d+)/.exec(version.trim());
+    if (!match)
+        return false;
+    const numbers = match.slice(1).map(Number);
+    const difference = numbers.findIndex((value, index) => value !== minimum[index]);
+    return difference < 0 || numbers[difference] > minimum[difference];
+}
+//# sourceMappingURL=setupTools.js.map

package/dist/setupTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupTools.js","sourceRoot":"","sources":["../src/setupTools.ts"],"names":[],"mappings":"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"}

package/dist/sourceArchive.d.ts

@@ -0,0 +1,11 @@
+interface Exclusions {
+    dirs: ReadonlySet<string>;
+    files: ReadonlySet<string>;
+}
+export declare function buildSourceArchive(project: string, exclusions: Exclusions): {
+    zipBytes: Uint8Array;
+    fileCount: number;
+    zipSizeBytes: number;
+};
+export {};
+//# sourceMappingURL=sourceArchive.d.ts.map

package/dist/sourceArchive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceArchive.d.ts","sourceRoot":"","sources":["../src/sourceArchive.ts"],"names":[],"mappings":"AAMA,UAAU,UAAU;IAChB,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACzB,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAC7B;AAID,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG;IAAE,QAAQ,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAM7I"}

package/dist/sourceArchive.js

@@ -0,0 +1,29 @@
+import { zipSync } from "fflate";
+import fs from "node:fs";
+import path from "node:path";
+import { CliError } from "./cliError.js";
+const pythonDirectories = new Set([".venv", "venv", "__pycache__", ".mypy_cache", ".pytest_cache", ".ruff_cache"]);
+export function buildSourceArchive(project, exclusions) {
+    const files = collectFiles(project, project, exclusions);
+    const fileCount = Object.keys(files).length;
+    if (fileCount === 0)
+        throw new CliError("no_files_to_deploy", "No files found to deploy");
+    const zipBytes = zipSync(files, { level: 6 });
+    return { zipBytes, fileCount, zipSizeBytes: zipBytes.length };
+}
+function collectFiles(directory, project, exclusions) {
+    const files = {};
+    if (fs.existsSync(path.join(directory, "pyvenv.cfg")))
+        return files;
+    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+        if (exclusions.dirs.has(entry.name) || exclusions.files.has(entry.name) || pythonDirectories.has(entry.name))
+            continue;
+        const source = path.join(directory, entry.name);
+        if (entry.isDirectory())
+            Object.assign(files, collectFiles(source, project, exclusions));
+        else if (entry.isFile())
+            files[path.relative(project, source).split(path.sep).join("/")] = new Uint8Array(fs.readFileSync(source));
+    }
+    return files;
+}
+//# sourceMappingURL=sourceArchive.js.map

package/dist/sourceArchive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceArchive.js","sourceRoot":"","sources":["../src/sourceArchive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAChC,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAOxC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC,CAAA;AAElH,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,UAAsB;IACtE,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAA;IACxD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAA;IAC3C,IAAI,SAAS,KAAK,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,oBAAoB,EAAE,0BAA0B,CAAC,CAAA;IACzF,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;IAC7C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAA;AACjE,CAAC;AAED,SAAS,YAAY,CAAC,SAAiB,EAAE,OAAe,EAAE,UAAsB;IAC5E,MAAM,KAAK,GAA+B,EAAE,CAAA;IAC5C,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IACnE,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACrE,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAQ;QACtH,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QAC/C,IAAI,KAAK,CAAC,WAAW,EAAE;YAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAA;aACnF,IAAI,KAAK,CAAC,MAAM,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAA;IACtI,CAAC;IACD,OAAO,KAAK,CAAA;AAChB,CAAC"}

package/dist/verifiedDownload.d.ts

@@ -0,0 +1,7 @@
+export interface VerifiedDownloader {
+    download(url: string, sha256: string): Promise<Buffer>;
+}
+export declare class HttpVerifiedDownloader implements VerifiedDownloader {
+    download(url: string, sha256: string): Promise<Buffer>;
+}
+//# sourceMappingURL=verifiedDownload.d.ts.map

package/dist/verifiedDownload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifiedDownload.d.ts","sourceRoot":"","sources":["../src/verifiedDownload.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACzD;AAED,qBAAa,sBAAuB,YAAW,kBAAkB;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAS/D"}

package/dist/verifiedDownload.js

@@ -0,0 +1,15 @@
+import { createHash } from "node:crypto";
+import { CliError } from "./cliError.js";
+export class HttpVerifiedDownloader {
+    async download(url, sha256) {
+        const response = await fetch(url, { signal: AbortSignal.timeout(30_000) });
+        if (!response.ok)
+            throw new CliError("installer_download_failed", `Could not download the installer: HTTP ${response.status}.`, { url });
+        const bytes = Buffer.from(await response.arrayBuffer());
+        if (createHash("sha256").update(bytes).digest("hex") !== sha256) {
+            throw new CliError("installer_checksum_mismatch", "Installer checksum verification failed.", { url });
+        }
+        return bytes;
+    }
+}
+//# sourceMappingURL=verifiedDownload.js.map

package/dist/verifiedDownload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifiedDownload.js","sourceRoot":"","sources":["../src/verifiedDownload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAMxC,MAAM,OAAO,sBAAsB;IAC/B,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,MAAc;QACtC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAC1E,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,IAAI,QAAQ,CAAC,2BAA2B,EAAE,0CAA0C,QAAQ,CAAC,MAAM,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;QACxI,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;QACvD,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,MAAM,EAAE,CAAC;YAC9D,MAAM,IAAI,QAAQ,CAAC,6BAA6B,EAAE,yCAAyC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;QACzG,CAAC;QACD,OAAO,KAAK,CAAA;IAChB,CAAC;CACJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terse-cli",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE.md",
   "repository": {
@@ -32,15 +32,15 @@
     "handlebars": "^4.7.9",
     "import-meta-resolve": "^4.2.0",
     "json-schema-to-typescript": "^15.0.4",
-    "durable-actors": "0.5.0",
+    "durable-actors": "0.5.5",
     "little-durable": "0.1.3",
     "luxon": "^3.7.2",
     "ora": "^8.0.0",
     "tsx": "^4.0.0",
     "typescript": "^5.0.0",
     "zod": "^4.3.6",
-    "terse-types": "0.7.0",
-    "terse-sdk": "0.7.0"
+    "terse-sdk": "0.8.1",
+    "terse-types": "0.8.1"
   },
   "devDependencies": {
     "@types/luxon": "^3.7.1",
@@ -49,7 +49,7 @@
   "scripts": {
     "build": "rm -rf dist && tsc && chmod +x dist/index.js",
     "dev": "tsc --watch --preserveWatchOutput",
-    "test": "node --import tsx --test test/**/*.test.ts",
+    "test": "node --import tsx --test test/**/*.test.ts tests/*.test.ts",
     "test:actors:local": "TERSE_TEST_LOCAL_ACTORS=1 node --import tsx --test test/localActorRuntime.test.ts",
     "format": "pnpm exec prettier --config ../../.prettierrc --write \"src/**/*.ts\"",
     "format:check": "pnpm exec prettier --config ../../.prettierrc --check \"src/**/*.ts\"",

package/templates/python/generate.py

@@ -0,0 +1,52 @@
+"""Generate Python actor clients with Terse's managed connection defaults."""
+
+import ast
+import json
+import sys
+from pathlib import Path
+
+from durable_actors.codegen import generate_client
+
+
+def generate(output: Path) -> None:
+    contract = json.load(sys.stdin)
+    generate_client(contract, output)
+    module = "_terse_transport"
+    while any(
+        "_" + actor["actorName"].lower() == module for actor in contract["actors"]
+    ):
+        module += "_"
+    files = [
+        output / "__init__.py",
+        output / "actors.py",
+        *(
+            output / ("_" + actor["actorName"].lower() + ".py")
+            for actor in contract["actors"]
+        ),
+    ]
+    for file in files:
+        tree = ast.parse(file.read_text())
+        for index, node in enumerate(tree.body):
+            if not isinstance(node, ast.ImportFrom):
+                continue
+            names = {
+                "durable_actors.client": "default_client",
+                "durable_actors.proxy": "prepare_authorization",
+            }
+            replacement = names.get(node.module or "")
+            selected = [name for name in node.names if name.name == replacement]
+            if selected:
+                node.names = [name for name in node.names if name not in selected]
+                injected = ast.ImportFrom(module=module, names=selected, level=1)
+                if node.names:
+                    tree.body.insert(index + 1, injected)
+                else:
+                    tree.body[index] = injected
+        file.write_text(ast.unparse(ast.fix_missing_locations(tree)) + "\n")
+    (output / (module + ".py")).write_text(
+        Path(__file__).with_name("transport.py").read_text()
+    )
+
+
+if __name__ == "__main__":
+    generate(Path(sys.argv[1]))

package/templates/python/init/actor.py.hbs

@@ -0,0 +1,37 @@
+from pydantic import BaseModel
+from durable_actors import Actor, ActorSocket, emitted
+
+
+class Member(BaseModel):
+    """Metadata passed in when connecting via websocket"""
+
+    name: str
+
+
+class SendMessage(BaseModel):
+    """Message sent to Durable Actor through websocket"""
+
+    text: str
+
+
+class Message(BaseModel):
+    """Persisted message payload"""
+
+    author: Member
+    text: str
+
+
+class Chat(Actor[Member, SendMessage, Message]):
+    """A Durable Actor chatroom"""
+
+    messages: list[Message] = emitted(default_factory=list)
+
+    def post(self, author: Member, text: str) -> Message:
+        """Save a message and broadcast it to connected members."""
+        message = Message(author=author, text=text)
+        self.messages.append(message)
+        self.broadcast(message)
+        return message
+
+    def on_message(self, socket: ActorSocket[Member, Message], message: SendMessage) -> None:
+        self.post(socket.metadata, message.text)

package/templates/python/init/gitignore.hbs

@@ -0,0 +1,7 @@
+.venv
+__pycache__
+.mypy_cache
+.terse
+.durable-actors
+generated
+.env

package/templates/python/init/pyproject.toml.hbs

@@ -0,0 +1,11 @@
+[project]
+name = "{{projectName}}"
+version = "0.1.0"
+requires-python = ">=3.11"
+dependencies = ["durable-actors>=0.5.5,<1"]
+
+[dependency-groups]
+dev = ["durable-actors[codegen]>=0.5.5,<1"]
+
+[tool.mypy]
+strict = true

package/templates/python/transport.py

@@ -0,0 +1,171 @@
+"""Terse connection defaults for this generated actor package."""
+
+from __future__ import annotations
+
+import atexit
+import os
+import re
+from functools import cache
+from typing import Any
+from urllib.parse import unquote, urlsplit
+
+import httpx
+from durable_actors import (
+    ActorSession,
+    ActorSessionRejectedError,
+    ActorSessionTransport,
+    Client,
+    SocketGrant,
+)
+from durable_actors.client import ActorTransport
+from durable_actors.proxy import (
+    SocketAuthorization,
+    prepare_authorization as issue_authorization,
+)
+
+
+@cache
+def default_client() -> ActorTransport:
+    """Use TERSE_ACTOR_URL and TERSE_API_KEY, with local development defaults."""
+    value = (
+        os.environ.get("TERSE_ACTOR_URL", "").strip()
+        or "http://127.0.0.1:7100/v1/projects/local/actors"
+    )
+    url = urlsplit(value)
+    match = re.fullmatch(r"/(?:(sdk|v1)/projects/)?([^/]+)/actors/?", url.path)
+    if (
+        not match
+        or url.scheme not in {"http", "https"}
+        or not url.hostname
+        or url.username
+        or url.password
+        or url.query
+        or url.fragment
+    ):
+        raise ValueError(
+            "TERSE_ACTOR_URL must end in /<projectId>/actors or /v1/projects/<projectId>/actors, without credentials, query, or fragment"
+        )
+    project_id = unquote(match[2])
+    if not re.fullmatch(r"[A-Za-z0-9._-]{1,64}", project_id) or project_id in {
+        ".",
+        "..",
+    }:
+        raise ValueError("Invalid project in TERSE_ACTOR_URL")
+    origin = f"{url.scheme}://{url.netloc}"
+    key = os.environ.get("TERSE_API_KEY", "").strip()
+    runtime = match[1] == "v1"
+    if not key and not (runtime and url.hostname in {"localhost", "127.0.0.1", "::1"}):
+        raise ValueError("Missing TERSE_API_KEY for this actor project")
+    client: Client | TerseTransport
+    if runtime:
+        client = Client(origin, project_id=project_id, api_key=key or None)
+    else:
+        client = TerseTransport(
+            f"{origin}/{project_id}/actors",
+            project_id,
+            key,
+            httpx.Client(timeout=180, follow_redirects=False),
+        )
+    atexit.register(client.close)
+    return client
+
+
+def prepare_authorization(
+    authorization: SocketAuthorization[Any], transport: ActorTransport | None = None
+) -> SocketGrant:
+    """Issue a typed browser grant using the selected Terse project."""
+    return issue_authorization(
+        authorization, transport if transport is not None else default_client()
+    )
+
+
+class TerseTransport:
+    """Exchange Terse credentials for renewable runtime sessions and socket grants."""
+
+    def __init__(
+        self, actor_url: str, project_id: str, api_key: str, http: httpx.Client
+    ) -> None:
+        self._actor_url = actor_url
+        self._project_id = project_id
+        self._headers = {
+            "Authorization": f"Bearer {api_key}",
+            "Accept": "application/json",
+        }
+        self._http = http
+        self._session = ActorSessionTransport(
+            project_id=project_id,
+            get_session=self._get_session,
+            create_transport=self._session_client,
+        )
+
+    def invoke(
+        self, actor_name: str, actor_id: str, method: str, args: list[Any]
+    ) -> Any:
+        """Invoke through a renewable actor session."""
+        return self._session.invoke(actor_name, actor_id, method, args)
+
+    def broadcast(self, actor_name: str, actor_id: str, message: Any) -> None:
+        """Broadcast through the current actor session."""
+        self._session.broadcast(actor_name, actor_id, message)
+
+    def prepare_websocket(
+        self,
+        actor_name: str,
+        actor_id: str,
+        metadata: Any,
+        *,
+        authorization_lifetime_ms: int = 900000,
+        home_region: str | None = None,
+    ) -> SocketGrant:
+        """Ask Terse for a direct WebSocket grant for this actor."""
+        response = self._http.post(
+            self._actor_url,
+            headers=self._headers,
+            json={
+                "actorName": actor_name,
+                "actorId": actor_id,
+                "metadata": metadata,
+                "authorizationLifetimeMs": authorization_lifetime_ms,
+                **({"homeRegion": home_region} if home_region is not None else {}),
+            },
+            timeout=10,
+            follow_redirects=False,
+        )
+        response.raise_for_status()
+        grant = SocketGrant.model_validate(response.json(), strict=True)
+        if urlsplit(grant.websocket_url).scheme not in {"ws", "wss"}:
+            raise ValueError("Invalid WebSocket grant URL")
+        return grant
+
+    def close(self) -> None:
+        """Stop session renewal and close this transport's HTTP client."""
+        self._session.close()
+        self._http.close()
+
+    def _get_session(self) -> ActorSession:
+        response = self._http.post(
+            self._actor_url + "/access",
+            headers=self._headers,
+            timeout=10,
+            follow_redirects=False,
+        )
+        if response.status_code in {401, 403}:
+            raise ActorSessionRejectedError(
+                f"Terse actor authorization failed (HTTP {response.status_code})"
+            )
+        response.raise_for_status()
+        value = response.json()
+        return ActorSession(
+            project_id=value["projectId"],
+            control_plane_url=value["controlPlaneUrl"],
+            token=value["token"],
+            expires_at_ms=value["expiresAtMs"],
+        )
+
+    def _session_client(self, session: ActorSession) -> Client:
+        return Client(
+            session.control_plane_url,
+            project_id=session.project_id,
+            api_key=session.token,
+            http=self._http,
+        )