lastlight 0.16.0 → 0.16.2

package/dist/config/config.d.ts

@@ -1,157 +0,0 @@
-/** How the Slack connector receives events. */
-export type SlackMode = "webhook" | "socket";
-export interface SlackConfig {
-    botToken: string;
-    /**
-     * `webhook` — HTTP Events API (default, reliable at-least-once delivery,
-     * needs `signingSecret` + the shared HTTP server). `socket` — Socket Mode
-     * (dev fallback, needs `appToken`, at-most-once so it can drop messages).
-     */
-    mode: SlackMode;
-    /** Socket Mode app-level token (xapp-…). Required only when mode === "socket". */
-    appToken?: string;
-    /** Events API signing secret. Required only when mode === "webhook". */
-    signingSecret?: string;
-    allowedUsers: string[];
-    deliveryChannel?: string;
-}
-export interface ModelConfig {
-    default: string;
-    [taskType: string]: string;
-}
-export interface VariantConfig {
-    default?: string;
-    [taskType: string]: string | undefined;
-}
-export type SandboxBackend = "gondolin" | "docker" | "smol" | "none";
-export type BuildAssetsLocation = "repo" | "server";
-export interface DisabledConfig {
-    workflows: string[];
-    crons: string[];
-    prompts: string[];
-    skills: string[];
-    agentContext: string[];
-}
-export interface OtelConfig {
-    enabled: boolean;
-    serviceName: string;
-    includeContent: boolean;
-    forwardToSandbox: boolean;
-    strict: boolean;
-    collectorHosts: string[];
-}
-export interface RouteConfig {
-    github: Record<string, string>;
-    slack: Record<string, string>;
-}
-export interface PublicConfigBundle {
-    default: Record<string, unknown>;
-    overlay: Record<string, unknown> | null;
-    merged: Record<string, unknown>;
-    /**
-     * Provenance tree mirroring `merged`: object nodes stay nested, each leaf is
-     * the layer that supplied the effective value ("default" | "overlay" | "env").
-     * The Default/Overlay/Merged dashboard view is derived from this rather than
-     * hand-maintained (issue #99).
-     */
-    sources: Record<string, unknown>;
-}
-export interface LastLightConfig {
-    port: number;
-    webhookSecret: string;
-    /**
-     * The GitHub App slug (no `[bot]` suffix) — e.g. `last-light` or
-     * `nearform-lastlight`. Single source of truth for the bot's identity:
-     * derives the incoming `@mention` handle (router), `botLogin`
-     * (`${botName}[bot]`, self-comment/self-review filter), and the git commit
-     * author. Overridable via overlay `config.yaml` `botName` or the
-     * `GITHUB_APP_BOT_NAME` env var; defaults to `last-light`.
-     */
-    botName: string;
-    botLogin: string;
-    dbPath: string;
-    overlayDir?: string;
-    builtInRoot: string;
-    stateDir: string;
-    sandboxDir: string;
-    sessionsDir: string;
-    model: string;
-    models: ModelConfig;
-    variants: VariantConfig;
-    maxTurns: number;
-    sandbox: SandboxBackend;
-    /** Where build handoff docs live: "repo" (committed) | "server" (externalized). */
-    buildAssets: BuildAssetsLocation;
-    /** Filesystem root for server-mode build assets (default $STATE_DIR/build-assets). */
-    buildAssetsDir: string;
-    /**
-     * Core-version pin the overlay declares (`deploy.version` in config.yaml, or
-     * the `LASTLIGHT_CORE_VERSION` env override). A git tag/ref (e.g. `v0.10.6`)
-     * that `lastlight server update|setup` checks core out at; `null` means track
-     * `main`. Read raw from the overlay by `readCorePin()` — this field mirrors it
-     * for the dashboard `/config` view. See src/config/core-pin.ts.
-     */
-    deploy: {
-        version: string | null;
-    };
-    managedRepos: string[];
-    routes: RouteConfig;
-    disabled: DisabledConfig;
-    otel: OtelConfig;
-    publicConfig: PublicConfigBundle;
-    githubApp?: {
-        appId: string;
-        privateKeyPath: string;
-        installationId: string;
-    };
-    /**
-     * Fallback GitHub auth: a raw Personal Access Token, used ONLY when no GitHub
-     * App is configured. Enables read-only GitHub in chat + CLI-driven read-only
-     * workflows without the full App + webhook setup. Secret / env-only — never
-     * surfaced by the public-config endpoint. A PAT is static (no per-run
-     * downscoping), so a read-only fine-grained PAT is the safe default.
-     */
-    githubToken?: string;
-    slack?: SlackConfig;
-    approval?: Record<string, boolean>;
-    bootstrapLabel: string;
-    exploreDefaultRepo?: string;
-    publicUrl?: string;
-    reviewPostsCheck: boolean;
-}
-export declare function setRuntimeConfig(config: LastLightConfig): void;
-export declare function getRuntimeConfig(): LastLightConfig | undefined;
-export declare function resetRuntimeConfigForTests(): void;
-export declare function getPublicConfig(): PublicConfigBundle;
-export declare function getRoutes(): RouteConfig;
-/**
- * The configured bot slug (no `[bot]` suffix), e.g. `last-light` or
- * `nearform-lastlight`. Returns the `last-light` default when config isn't
- * loaded yet (unit tests). Drives the router's `@mention` handle plus the
- * derived `botLogin` and git commit author.
- */
-export declare function getBotName(): string;
-/**
- * Load configuration from config/default.yaml, optional LASTLIGHT_OVERLAY_DIR/config.yaml,
- * then legacy environment variables. Secrets remain env-only.
- */
-export declare function loadConfig(): LastLightConfig;
-export declare function parseOtelCollectorHostsFromEnv(env?: NodeJS.ProcessEnv): string[];
-export declare function resolveModel(models: ModelConfig, taskType: string): string;
-export declare function resolveVariant(variants: VariantConfig, taskType: string): string | undefined;
-/**
- * Resolved GitHub auth, discriminated by mechanism. GitHub App wins when
- * configured; the PAT is a fallback. `undefined` means no GitHub auth at all
- * (chat-only mode). Keeps the App-vs-token precedence in one place so every
- * construction site (chat tools, harness client) branches identically.
- */
-export type ResolvedGithubAuth = {
-    kind: "app";
-    appId: string;
-    privateKeyPath: string;
-    installationId: string;
-} | {
-    kind: "token";
-    token: string;
-};
-export declare function resolveGithubAuth(config: Pick<LastLightConfig, "githubApp" | "githubToken">): ResolvedGithubAuth | undefined;