@downcity/local — Downcity City SDK Docs

Manage local product configuration with a database adapter and explicit repositories.

The @downcity/local root entry provides the SQLite adapter and path primitives shared by the CLI and Desktop. Agent, Workspace, and Plugin schemas, repositories, and loaders live in the explicit @downcity/local/product subpath.

import {
  LocalDatabase,
} from "@downcity/local";
import {
  AgentRepository,
  WorkspaceRepository,
  ensure_local_schema,
} from "@downcity/local/product";

const database = new LocalDatabase({ filename: database_path });
ensure_local_schema(database);

const workspaces = new WorkspaceRepository(database);
const agents = new AgentRepository(root_path);

The CLI and Desktop create these dependencies in their own composition roots, read configuration, and explicitly call new Agent(). @downcity/local never creates an Agent, Workspace, Model, or City, and City never queries or persists product data. Workspace and platform settings are stored as plaintext JSON, with 0600 permissions on the local database for user-level isolation.