@timurproko/a1 0.1.8-dev.3b54f21 → 0.1.8-dev.407

package/dist/src/composition/index.d.ts

@@ -1,48 +0,0 @@
-import { type AgentEnginePort } from "../foundation/agent-engine-contracts/index.js";
-import { type PiEngineAdapter } from "../foundation/pi-engine-adapter/index.js";
-import { type OwnedUiApplicationPort, type PresentationComponentPort, type PresentationRuntimePort, type PresentationTerminalPort } from "../foundation/presentation-contracts/index.js";
-import { OwnedUiSettingsSession } from "../foundation/owned-ui-settings/index.js";
-import type { UiRouteHost } from "../foundation/pi-owned-ui-integration/index.js";
-export interface ProcessCompositionOptions {
-    readonly cwd?: string;
-    readonly sessionId?: string;
-    readonly engine?: AgentEnginePort;
-    readonly presentationFactory?: (root: PresentationComponentPort, terminal: PresentationTerminalPort) => PresentationRuntimePort;
-    readonly createPiAdapter?: () => Promise<PiEngineAdapter>;
-}
-export interface OwnedUiCompositionOptions {
-    readonly cwd?: string;
-    readonly terminal?: PresentationTerminalPort;
-    readonly createPiAdapter?: () => Promise<PiEngineAdapter>;
-    /**
-     * A1 profile whose settings this session reads and writes. Omitted keeps the
-     * session settings-free, which is what the pinned comparison paths use.
-     */
-    readonly profileId?: string;
-    /**
-     * Whether A1's own surfaces are reachable. Withheld for the rendering parity
-     * comparison, which measures this composition against pinned Pi and so must
-     * present Pi's interface and nothing of A1's own. It is the same composition
-     * either way: a parity run built beside the product would measure itself.
-     */
-    readonly ownedSurfaces?: "on" | "off";
-}
-export interface OwnedUiComposition {
-    readonly application: OwnedUiApplicationPort;
-    /** Present when a profile was supplied, so the caller can resolve settings before start. */
-    readonly settings: OwnedUiSettingsSession | null;
-}
-export declare function composeOwnedUiApplication(options?: OwnedUiCompositionOptions): Promise<OwnedUiApplicationPort>;
-export declare function composeOwnedUi(options?: OwnedUiCompositionOptions): Promise<OwnedUiComposition>;
-export interface ProcessComposition {
-    readonly engine: AgentEnginePort;
-    createPresentation(root: PresentationComponentPort, terminal: PresentationTerminalPort): PresentationRuntimePort;
-    dispose(): Promise<void>;
-}
-export declare function composeProcess(options?: ProcessCompositionOptions): Promise<ProcessComposition>;
-/**
- * Registers the A1-owned screens and adapts the app host to the shell's route
- * seam. The shell mounts whatever surface it is handed and forwards keys; it
- * never learns what an app is.
- */
-export declare function createOwnedRouteHost(settings: OwnedUiSettingsSession): UiRouteHost;

package/dist/src/composition/index.js

@@ -1,258 +0,0 @@
-import { AGENT_ENGINE_CONTRACT_VERSION, assertAgentCapabilityContract, assertAgentCommand, } from "../foundation/agent-engine-contracts/index.js";
-import { createPiEngineAdapter } from "../foundation/pi-engine-adapter/index.js";
-import { createPiPresentationRuntime, createPiTerminalBridge } from "../foundation/pi-tui-runtime-adapter/index.js";
-import { assertPresentationComponent, assertPresentationRuntime, } from "../foundation/presentation-contracts/index.js";
-import { OwnedUiSessionShell } from "../foundation/pi-owned-ui-integration/index.js";
-import { OwnedUiSettingsSession, OwnedUiSettingsStore } from "../foundation/owned-ui-settings/index.js";
-import { UiAppHost, UiAppRegistry } from "../foundation/ui-apps/index.js";
-import { applyConfiguredPiTheme, getAvailablePiThemes, piTheme } from "../foundation/pi-component-adapter/index.js";
-import { faint } from "../foundation/ui-components/index.js";
-import { SETTINGS_APP_ID, SETTINGS_ROUTE, SettingsApp } from "../features/owned-ui/index.js";
-import { resolveProductPaths } from "../foundation/lifecycle/index.js";
-const CAPABILITIES = {
-    contractVersion: AGENT_ENGINE_CONTRACT_VERSION,
-    commands: ["prompt", "steer", "follow-up", "abort", "retry", "compact", "bash", "replace-session"],
-    events: ["lifecycle", "content", "command-outcome", "snapshot-invalidated", "diagnostic"],
-    snapshots: { supported: true, maxBytes: 1024 * 1024 },
-};
-export async function composeOwnedUiApplication(options = {}) {
-    return (await composeOwnedUi(options)).application;
-}
-export async function composeOwnedUi(options = {}) {
-    const cwd = options.cwd ?? process.cwd();
-    const adapter = options.createPiAdapter
-        ? await options.createPiAdapter()
-        : await createPiEngineAdapter({ cwd, availableThemes: () => getAvailablePiThemes().map(theme => theme.name) });
-    const settings = options.profileId === undefined
-        ? null
-        : new OwnedUiSettingsSession({
-            store: new OwnedUiSettingsStore({ configDir: resolveProductPaths().configDir, profileId: options.profileId }),
-            agentProvider: () => adapter.settingsPort(),
-        });
-    // Before anything is drawn, so every surface uses the configured theme rather
-    // than the one guessed from the terminal's background.
-    applyConfiguredPiTheme(adapter.configuredTheme());
-    const routeHost = settings === null || options.ownedSurfaces === "off" ? null : createOwnedRouteHost(settings);
-    const shell = new OwnedUiSessionShell({
-        backend: adapter,
-        cwd,
-        ...(options.terminal === undefined ? {} : { terminal: createPiTerminalBridge(options.terminal) }),
-        ...(routeHost === null ? {} : { routeHost }),
-    });
-    const application = {
-        get disposed() { return adapter.disposed; },
-        start: () => shell.start(),
-        flush: () => adapter.flushEvents(),
-        waitUntilStopped: () => shell.waitUntilStopped(),
-        dispose: () => shell.dispose(),
-    };
-    return { application, settings };
-}
-export async function composeProcess(options = {}) {
-    let engine = options.engine;
-    if (!engine) {
-        const adapter = options.createPiAdapter
-            ? await options.createPiAdapter()
-            : await createPiEngineAdapter({
-                ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
-                ...(options.sessionId === undefined ? {} : { sessionId: options.sessionId }),
-            });
-        engine = new PiAgentEngineBridge(adapter, options.cwd ?? process.cwd());
-    }
-    assertAgentCapabilityContract(engine.capabilities);
-    if (typeof engine.createSession !== "function" || typeof engine.dispose !== "function")
-        throw new TypeError("composed engine does not satisfy the neutral engine port");
-    const presentations = new Set();
-    let disposed = false;
-    return {
-        engine,
-        createPresentation(root, terminal) {
-            if (disposed)
-                throw new Error("process composition is disposed");
-            assertPresentationComponent(root);
-            const runtime = options.presentationFactory?.(root, terminal) ?? createPiPresentationRuntime(root, terminal);
-            assertPresentationRuntime(runtime);
-            presentations.add(runtime);
-            return runtime;
-        },
-        async dispose() {
-            if (disposed)
-                return;
-            disposed = true;
-            const failures = [];
-            for (const runtime of [...presentations].reverse())
-                await runtime.stop().catch(error => failures.push(error));
-            await engine.dispose().catch(error => failures.push(error));
-            if (failures.length)
-                throw new AggregateError(failures, "process composition disposal failed");
-        },
-    };
-}
-class PiAgentEngineBridge {
-    adapter;
-    cwd;
-    capabilities = CAPABILITIES;
-    #session;
-    constructor(adapter, cwd) {
-        this.adapter = adapter;
-        this.cwd = cwd;
-    }
-    async createSession(input) {
-        if (this.#session)
-            return this.#session;
-        if (input.cwd !== this.cwd)
-            throw new TypeError("composed Pi engine cannot change working directory");
-        await this.adapter.start();
-        this.#session = new PiAgentSessionBridge(this.adapter, input.sessionId);
-        return this.#session;
-    }
-    async dispose() { await this.adapter.dispose(); }
-}
-class PiAgentSessionBridge {
-    adapter;
-    sessionId;
-    capabilities = CAPABILITIES;
-    lifecycle = "starting";
-    #listeners = new Set();
-    #unsubscribe;
-    constructor(adapter, sessionId) {
-        this.adapter = adapter;
-        this.sessionId = sessionId;
-        this.#unsubscribe = adapter.onEvent(event => {
-            const converted = convertEvent(event);
-            if (!converted)
-                return;
-            if (converted.type === "lifecycle")
-                this.lifecycle = converted.lifecycle;
-            for (const listener of this.#listeners)
-                listener(converted);
-        });
-        this.lifecycle = toLifecycle(adapter.snapshot().view.lifecycle);
-    }
-    async execute(command) {
-        assertAgentCommand(command, this.capabilities);
-        if (command.sessionId !== this.sessionId)
-            return "rejected";
-        if (command.type === "bash") {
-            const result = await this.adapter.executeBashWorkflow(command.command, false);
-            return !result.cancelled && result.exitCode === 0 ? "completed" : result.cancelled ? "cancelled" : "failed";
-        }
-        const owned = toOwnedCommand(command);
-        const result = await this.adapter.execute(owned);
-        return result.outcome === "timed-out" ? "failed" : result.outcome;
-    }
-    subscribe(listener) { this.#listeners.add(listener); return () => this.#listeners.delete(listener); }
-    async snapshot() {
-        const snapshot = this.adapter.snapshot();
-        return {
-            contractVersion: AGENT_ENGINE_CONTRACT_VERSION,
-            snapshotId: snapshot.snapshotId,
-            sessionId: this.sessionId,
-            revision: snapshot.view.revision,
-            sequence: snapshot.sequence,
-            lifecycle: toLifecycle(snapshot.view.lifecycle),
-            content: snapshot.view.transcript.map(toMessage),
-            activeCommandIds: snapshot.view.activeCommandIds,
-            capabilities: this.capabilities,
-        };
-    }
-    async dispose() { this.#unsubscribe(); this.#listeners.clear(); await this.adapter.dispose(); this.lifecycle = "stopped"; }
-}
-function toOwnedCommand(command) {
-    const base = { correlationId: command.commandId, sessionId: command.sessionId };
-    if (command.type === "replace-session")
-        return command.source.kind === "new" ? { ...base, type: "new-session" } : { ...base, type: "resume-session", sessionPath: command.source.sessionPath };
-    if (command.type === "prompt" || command.type === "steer" || command.type === "follow-up")
-        return { ...base, type: command.type, text: command.text };
-    return { ...base, type: command.type };
-}
-function convertEvent(event) {
-    const base = { contractVersion: AGENT_ENGINE_CONTRACT_VERSION, sessionId: event.sessionId, sequence: event.sequence };
-    if (event.type === "session-lifecycle")
-        return { ...base, type: "lifecycle", lifecycle: toLifecycle(event.lifecycle), reason: event.reason };
-    if (event.type === "transcript-block")
-        return { ...base, type: "content", content: toMessage(event.block) };
-    if (event.type === "command-outcome")
-        return { ...base, type: "command-outcome", commandId: event.correlationId, outcome: event.outcome === "timed-out" ? "failed" : event.outcome, diagnostic: event.diagnostic };
-    if (event.type === "diagnostic")
-        return { ...base, type: "diagnostic", code: event.diagnostic.code, message: event.diagnostic.message, recoverable: event.diagnostic.recoverable };
-    if (event.type === "session-view")
-        return { ...base, type: "snapshot-invalidated", expectedRevision: event.view.revision };
-    return null;
-}
-function toLifecycle(lifecycle) {
-    return lifecycle === "suspended" ? "ready" : lifecycle;
-}
-function toMessage(block) {
-    const role = block.kind === "user" ? "user" : block.kind === "system" ? "system" : block.kind === "tool-call" || block.kind === "tool-result" ? "tool" : "assistant";
-    return { id: block.id, role, status: block.status === "live" ? "streaming" : "final", content: [{ kind: "text", text: block.text }] };
-}
-/**
- * Registers the A1-owned screens and adapts the app host to the shell's route
- * seam. The shell mounts whatever surface it is handed and forwards keys; it
- * never learns what an app is.
- */
-export function createOwnedRouteHost(settings) {
-    const registry = new UiAppRegistry();
-    registry.register({ id: SETTINGS_APP_ID, route: SETTINGS_ROUTE, create: () => new SettingsApp(settings) });
-    return {
-        claims: route => registry.forRoute(route) !== null,
-        open: route => {
-            const registration = registry.forRoute(route);
-            if (registration === null)
-                return null;
-            let size = { width: 80, height: 24 };
-            let frame = [];
-            let closed = false;
-            let onRender = () => undefined;
-            let onExit = () => undefined;
-            const host = new UiAppHost({
-                registry,
-                closeOnInterrupt: true,
-                theme: pinnedTheme(),
-                surface: {
-                    size: () => size,
-                    requestRender: () => onRender(),
-                    exit: () => onExit(),
-                    present: lines => {
-                        if (lines === null)
-                            closed = true;
-                        else
-                            frame = lines;
-                    },
-                },
-            });
-            host.open(registration.id);
-            const surface = {
-                id: registration.id,
-                render: (width, height) => {
-                    size = { width, height };
-                    host.render();
-                    return frame.length === height ? frame : [...frame.slice(0, height), ...Array(Math.max(0, height - frame.length)).fill("")];
-                },
-                handleInput: data => host.handleInput(data).consumed,
-                handleMouse: event => host.handleMouse(event).consumed,
-                isClosed: () => closed || !host.isPresenting,
-                close: () => host.close(),
-                onRenderRequested: listener => { onRender = listener; },
-                onExitRequested: listener => { onExit = listener; },
-            };
-            return surface;
-        },
-    };
-}
-/** Maps A1 UI tokens onto the pinned Pi theme so owned screens match the shell. */
-function pinnedTheme() {
-    return {
-        fg: (token, text) => piTheme().fg(token, text),
-        bold: (text) => piTheme().bold(text),
-        // Unpainted, so a list reads against the terminal the reader actually has
-        // rather than against the background the configured theme was built for.
-        plain: (text) => text,
-        // Quiet, and quieter again: the terminal's own faint attribute over the
-        // dimmest colour the theme has.
-        disabled: (text) => faint(piTheme().fg("dim", text)),
-        highlight: (text) => `${text}`,
-        panel: (text) => `${text}`,
-    };
-}

package/dist/src/features/launch/intent.d.ts

@@ -1,7 +0,0 @@
-import { type LaunchProfileContract, type LaunchProfileId } from "./profiles.js";
-export interface InteractiveLaunchIntent {
-    readonly kind: "interactive";
-    readonly profile: LaunchProfileContract;
-}
-export type LaunchIntent = InteractiveLaunchIntent;
-export declare function interactiveLaunchIntent(profileId: LaunchProfileId): InteractiveLaunchIntent;

package/dist/src/features/launch/intent.js

@@ -1,4 +0,0 @@
-import { launchProfileContract } from "./profiles.js";
-export function interactiveLaunchIntent(profileId) {
-    return Object.freeze({ kind: "interactive", profile: launchProfileContract(profileId) });
-}

package/dist/src/features/launch/profiles.d.ts

@@ -1,12 +0,0 @@
-import type { LaunchProfileId } from "../../foundation/lifecycle/index.js";
-export type { LaunchProfileId } from "../../foundation/lifecycle/index.js";
-export type ConfigurationRootPolicy = "agent-profile" | "pi-default" | "sandbox-profile";
-export type ProjectTrustPolicy = "pi-default" | "ignore";
-export interface LaunchProfileContract {
-    readonly id: LaunchProfileId;
-    readonly productSurface: "agent" | "vanilla-baseline" | "isolated-profile";
-    readonly configurationRootPolicy: ConfigurationRootPolicy;
-    readonly projectTrust: ProjectTrustPolicy;
-    readonly terminalCapability: "owned-ui";
-}
-export declare function launchProfileContract(id: LaunchProfileId): LaunchProfileContract;

package/dist/src/features/launch/profiles.js

@@ -1,26 +0,0 @@
-const contracts = Object.freeze({
-    "a1": Object.freeze({
-        id: "a1",
-        productSurface: "agent",
-        configurationRootPolicy: "agent-profile",
-        projectTrust: "pi-default",
-        terminalCapability: "owned-ui",
-    }),
-    pi: Object.freeze({
-        id: "pi",
-        productSurface: "vanilla-baseline",
-        configurationRootPolicy: "pi-default",
-        projectTrust: "pi-default",
-        terminalCapability: "owned-ui",
-    }),
-    sandbox: Object.freeze({
-        id: "sandbox",
-        productSurface: "isolated-profile",
-        configurationRootPolicy: "sandbox-profile",
-        projectTrust: "ignore",
-        terminalCapability: "owned-ui",
-    }),
-});
-export function launchProfileContract(id) {
-    return contracts[id];
-}

package/dist/src/features/owned-ui/run.js

@@ -1,15 +0,0 @@
-export async function runOwnedUi(options) {
-    const { application, settings } = options;
-    try {
-        if (settings)
-            await settings.load();
-        application.start();
-        await application.flush();
-        if (!application.disposed)
-            await application.waitUntilStopped();
-        return 0;
-    }
-    finally {
-        await application.dispose();
-    }
-}

package/dist/src/foundation/lifecycle/paths.d.ts

@@ -1,10 +0,0 @@
-export interface ProductPaths {
-    readonly configDir: string;
-    readonly dataDir: string;
-    readonly runtimeDir: string;
-    readonly databasePath: string;
-    readonly endpoint: string;
-    readonly endpointMetadataPath: string;
-    readonly supervisorLogPath: string;
-}
-export declare function resolveProductPaths(environment?: NodeJS.ProcessEnv, hostPlatform?: NodeJS.Platform, fallbackHome?: string): ProductPaths;

package/dist/src/foundation/owned-ui-contracts/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./extension-ui.js";
-export * from "./model.js";
-export * from "./validation.js";

package/dist/src/foundation/owned-ui-contracts/index.js

@@ -1,3 +0,0 @@
-export * from "./extension-ui.js";
-export * from "./model.js";
-export * from "./validation.js";

package/dist/src/foundation/owned-ui-settings/declarations.js

@@ -1,39 +0,0 @@
-export const OWNED_UI_SETTINGS_VERSION = 1;
-const MAX_ID_LENGTH = 64;
-const ID_PATTERN = /^[a-z][a-z0-9]*(?:[A-Z][a-z0-9]*)*$/;
-export const OWNED_UI_SETTING_DECLARATIONS = Object.freeze([
-    Object.freeze({
-        id: "transcriptDensity",
-        description: "Vertical density of transcript content. Reserved for the custom-viewport milestone; no visible effect yet.",
-        application: "live",
-        defaultValue: "comfortable",
-        allowedValues: Object.freeze(["comfortable", "compact"]),
-    }),
-]);
-export function assertOwnedUiSettingDeclarations(declarations) {
-    const seen = new Set();
-    for (const declaration of declarations) {
-        if (!ID_PATTERN.test(declaration.id) || declaration.id.length > MAX_ID_LENGTH) {
-            throw new Error(`owned UI setting id is not a bounded camelCase identifier: ${declaration.id}`);
-        }
-        if (seen.has(declaration.id))
-            throw new Error(`duplicate owned UI setting id: ${declaration.id}`);
-        seen.add(declaration.id);
-        if (declaration.description.trim().length === 0) {
-            throw new Error(`owned UI setting has no description: ${declaration.id}`);
-        }
-        if (declaration.allowedValues.length === 0) {
-            throw new Error(`owned UI setting declares no allowed values: ${declaration.id}`);
-        }
-        const types = new Set(declaration.allowedValues.map(value => typeof value));
-        if (types.size !== 1) {
-            throw new Error(`owned UI setting mixes allowed value types: ${declaration.id}`);
-        }
-        if (!declaration.allowedValues.includes(declaration.defaultValue)) {
-            throw new Error(`owned UI setting default is not an allowed value: ${declaration.id}`);
-        }
-    }
-}
-export function findOwnedUiSettingDeclaration(declarations, id) {
-    return declarations.find(declaration => declaration.id === id) ?? null;
-}

package/dist/src/foundation/owned-ui-settings/session.js

@@ -1,145 +0,0 @@
-import { buildOwnedUiSettingsSections, findOwnedUiSettingsEntry, } from "./sections.js";
-/**
- * Holds the resolved settings for one owned UI session and routes every accepted
- * change to the backend that owns it: A1 settings to the A1 document, agent
- * settings to the engine settings port. Neither backend ever sees the other's value.
- */
-export class OwnedUiSettingsSession {
-    #store;
-    #agent;
-    #agentProvider;
-    #listeners = new Set();
-    #resolution;
-    #agentSnapshot = null;
-    #pending = new Map();
-    constructor(options) {
-        this.#store = options.store;
-        this.#agent = options.agent ?? null;
-        this.#agentProvider = options.agentProvider ?? null;
-        this.#resolution = options.store.read();
-    }
-    get resolution() {
-        return this.#resolution;
-    }
-    /** Reads the engine's settings so the Agent section can be built. Never throws. */
-    async load() {
-        this.#resolution = this.#store.read();
-        const agent = this.#agentProvider === null ? this.#agent : this.#agentProvider();
-        this.#agentSnapshot = agent === null ? null : await snapshotOf(agent);
-        this.#notify();
-    }
-    sections() {
-        return buildOwnedUiSettingsSections({ resolution: this.#resolution, agent: this.#agentSnapshot });
-    }
-    /** Resolved value of an A1 setting, or null when it is not declared. */
-    value(id) {
-        return this.#resolution.settings.find(setting => setting.declaration.id === id)?.value ?? null;
-    }
-    /** Value stored this session but not yet in effect, for a restart-required setting. */
-    pendingValue(id) {
-        return this.#pending.get(id) ?? null;
-    }
-    onChange(listener) {
-        this.#listeners.add(listener);
-        return () => this.#listeners.delete(listener);
-    }
-    /** Writes a structured value, which only an engine-backed setting can hold. */
-    async changeStructured(backend, id, value) {
-        if (backend !== "agent")
-            return failed("only an agent setting holds a structured value");
-        const agent = this.#agentProvider === null ? this.#agent : this.#agentProvider();
-        if (agent === null)
-            return failed("no agent engine is attached");
-        if (!agent.capabilities.write || !agent.writeSetting) {
-            return failed("the agent engine does not support changing settings from this surface");
-        }
-        try {
-            await agent.writeSetting(id, value);
-            if (agent.capabilities.flush && agent.flush)
-                await agent.flush();
-        }
-        catch (error) {
-            return failed(`${id} could not be written to the agent engine: ${describe(error)}`);
-        }
-        this.#agentSnapshot = await snapshotOf(agent);
-        this.#notify();
-        return { applied: true, pendingRestart: false, failure: null };
-    }
-    async change(backend, id, value) {
-        const entry = findOwnedUiSettingsEntry(this.sections(), id, backend);
-        if (entry === null)
-            return failed(`unknown ${backend} setting: ${id}`);
-        if (!entry.editable)
-            return failed(`${id} is not editable from this surface`);
-        return backend === "a1" ? this.#changeOwned(id, value) : await this.#changeAgent(id, value);
-    }
-    #changeOwned(id, value) {
-        const outcome = this.#store.write(this.#resolution, id, value);
-        if (!outcome.stored)
-            return failed(outcome.failure ?? `${id} could not be stored`);
-        const previous = this.#resolution;
-        this.#resolution = this.#store.read();
-        const declaration = previous.settings.find(setting => setting.declaration.id === id)?.declaration;
-        if (declaration?.application === "restart") {
-            this.#pending.set(id, value);
-            this.#resolution = previous;
-            this.#notify();
-            return { applied: false, pendingRestart: true, failure: null };
-        }
-        this.#pending.delete(id);
-        this.#notify();
-        return { applied: true, pendingRestart: false, failure: null };
-    }
-    async #changeAgent(id, value) {
-        const agent = this.#agentProvider === null ? this.#agent : this.#agentProvider();
-        if (agent === null)
-            return failed("no agent engine is attached");
-        if (!agent.capabilities.write || !agent.writeSetting) {
-            return failed("the agent engine does not support changing settings from this surface");
-        }
-        try {
-            await agent.writeSetting(id, value);
-            if (agent.capabilities.flush && agent.flush)
-                await agent.flush();
-        }
-        catch (error) {
-            return failed(`${id} could not be written to the agent engine: ${describe(error)}`);
-        }
-        this.#agentSnapshot = await snapshotOf(agent);
-        this.#notify();
-        return { applied: true, pendingRestart: false, failure: null };
-    }
-    #notify() {
-        for (const listener of this.#listeners)
-            listener(this);
-    }
-}
-async function snapshotOf(agent) {
-    try {
-        const descriptors = await agent.listSettings();
-        const values = {};
-        for (const descriptor of descriptors) {
-            try {
-                values[descriptor.key] = await agent.readSetting(descriptor.key) ?? null;
-            }
-            catch {
-                values[descriptor.key] = null;
-            }
-        }
-        return {
-            descriptors,
-            values,
-            writeAdvertised: agent.capabilities.write && typeof agent.writeSetting === "function",
-            failure: null,
-        };
-    }
-    catch (error) {
-        return { descriptors: [], values: {}, writeAdvertised: false, failure: describe(error) };
-    }
-}
-function failed(failure) {
-    return { applied: false, pendingRestart: false, failure };
-}
-function describe(error) {
-    return error instanceof Error ? error.message : String(error);
-}