@orion-agents/orion-code 0.2.2 → 0.3.0

package/dist/services/settings-document-repository.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Durable, secret-preserving storage seam for the v0.3.0 Settings subsystem.
+ *
+ * `orion.json` remains the only settings document. The sidecar key is solely
+ * local revision entropy and never contains settings or leaves this service.
+ */
+import { type GlobalConfigDocument } from './global-config';
+import { type EffortPreference } from './effort';
+export declare const SETTINGS_REVISION_KEY_FILE = ".orion-settings-revision.key";
+export declare const SETTINGS_REVISION_PREFIX = "hmac-sha256:";
+export type SettingsKeyV1 = 'appearance.theme' | 'appearance.motion' | 'defaults.model' | 'defaults.effort' | 'defaults.globalEffort' | 'permissions.toolConfirmation';
+export type SettingsOperationV1 = {
+    readonly op: 'set';
+    readonly key: 'appearance.theme';
+    readonly value: 'system' | 'light' | 'dark';
+} | {
+    readonly op: 'unset';
+    readonly key: 'appearance.theme';
+} | {
+    readonly op: 'set';
+    readonly key: 'appearance.motion';
+    readonly value: 'system' | 'reduced';
+} | {
+    readonly op: 'unset';
+    readonly key: 'appearance.motion';
+} | {
+    readonly op: 'set';
+    readonly key: 'defaults.model';
+    readonly value: string;
+} | {
+    readonly op: 'unset';
+    readonly key: 'defaults.model';
+} | {
+    readonly op: 'set';
+    readonly key: 'defaults.effort';
+    readonly value: EffortPreference;
+} | {
+    readonly op: 'unset';
+    readonly key: 'defaults.effort';
+}
+/** Internal command/TUI operation. The Web protocol intentionally omits this key. */
+ | {
+    readonly op: 'set';
+    readonly key: 'defaults.globalEffort';
+    readonly value: EffortPreference;
+} | {
+    readonly op: 'unset';
+    readonly key: 'defaults.globalEffort';
+} | {
+    readonly op: 'set';
+    readonly key: 'permissions.toolConfirmation';
+    readonly value: 'ask' | 'allow' | 'deny';
+} | {
+    readonly op: 'unset';
+    readonly key: 'permissions.toolConfirmation';
+};
+export type SettingsDocumentRepositoryErrorCode = 'settings_invalid_operation' | 'settings_revision_conflict' | 'settings_document_invalid' | 'settings_document_unavailable' | 'settings_rejected' | 'settings_recovery_required';
+export declare class SettingsDocumentRepositoryError extends Error {
+    readonly code: SettingsDocumentRepositoryErrorCode;
+    constructor(code: SettingsDocumentRepositoryErrorCode, message: string);
+}
+export interface SettingsRepositorySnapshotV1 {
+    readonly revision: string;
+    readonly state: 'ready' | 'invalid' | 'unavailable';
+    readonly hasDocument: boolean;
+    /** Current valid document, or the last-good document while state is invalid/unavailable. */
+    readonly document: Readonly<GlobalConfigDocument>;
+    readonly lastGoodRevision?: string;
+    readonly diagnostic?: {
+        readonly code: 'settings_document_invalid' | 'settings_document_unavailable';
+        readonly message: string;
+    };
+}
+export interface SettingsRepositoryInvalidationV1 {
+    readonly revision: string;
+    readonly reason: 'external-edit';
+    readonly state: 'ready' | 'invalid';
+}
+export interface SettingsDocumentRepositoryOptions {
+    readonly documentPath?: string;
+    readonly revisionKeyPath?: string;
+    readonly lockWaitMs?: number;
+    readonly watchDebounceMs?: number;
+    /** Additional semantic validation, invoked inside the file lock before write. */
+    readonly validateCandidate?: (candidate: Readonly<GlobalConfigDocument>) => void;
+}
+export interface SettingsPersistResultV1 {
+    readonly revision: string;
+    readonly appliedKeys: readonly SettingsKeyV1[];
+    readonly snapshot: SettingsRepositorySnapshotV1;
+    /** Opaque to callers other than SettingsCoordinatorV1. */
+    readonly rollbackToken: unknown;
+}
+export interface SettingsEnsureDocumentResultV1 {
+    readonly created: boolean;
+    readonly snapshot: SettingsRepositorySnapshotV1;
+}
+/** Validate bounded public path operations without ever accepting arbitrary paths. */
+export declare function validateSettingsOperationsV1(operations: readonly SettingsOperationV1[]): readonly SettingsOperationV1[];
+/** Repository for strict reads and lock-protected CAS writes of `orion.json`. */
+export declare class SettingsDocumentRepository {
+    readonly documentPath: string;
+    private readonly revisionKeyPath;
+    private readonly revisionKey;
+    private readonly lockWaitMs;
+    private readonly watchDebounceMs;
+    private readonly validateCandidate?;
+    private lastGood;
+    private lastReadSignature;
+    private lastObservedSignature;
+    private watcher;
+    private watchTimer;
+    private listeners;
+    private closed;
+    constructor(options?: SettingsDocumentRepositoryOptions);
+    static create(options?: SettingsDocumentRepositoryOptions): SettingsDocumentRepository;
+    private assertOpen;
+    private loadOrCreateRevisionKey;
+    private revision;
+    private readDisk;
+    private remember;
+    /** Strictly read current bytes. Invalid bytes never become defaults. */
+    read(): SettingsRepositorySnapshotV1;
+    /** Whether the current document (or its directory when missing) is locally writable. */
+    isWritable(snapshot?: SettingsRepositorySnapshotV1): boolean;
+    /** Apply a typed batch under one cross-process lock and one atomic rename. */
+    persist(workspace: string, expectedRevision: string, operations: readonly SettingsOperationV1[]): SettingsPersistResultV1;
+    /** Conditionally restore the exact previous bytes after a Runtime apply failure. */
+    rollback(rollbackToken: unknown): SettingsRepositorySnapshotV1;
+    /** Create the minimal canonical document when the pathless advanced action needs one. */
+    ensureDocument(): SettingsEnsureDocumentResultV1;
+    /** Watch atomic replacements by observing the containing directory. */
+    watch(listener: (event: SettingsRepositoryInvalidationV1) => void): () => void;
+    private refreshWatcher;
+    private stopWatcher;
+    close(): void;
+}
+//# sourceMappingURL=settings-document-repository.d.ts.map

package/dist/services/settings-document-repository.d.ts.map

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