@tickernelz/paperclip-pro-shared 2026.1105.1 → 2026.1108.0

package/dist/omp-agent-settings.d.ts

@@ -0,0 +1,187 @@
+export declare const OMP_SETTINGS_KEY = "ompSettings";
+export declare const OMP_SETTINGS_PATH_PREFIX = "ompSettings.";
+export declare const OMP_STYLE_KEY = "stylePreset";
+export declare const OMP_FALLBACK_MODE_KEY = "fallbackMode";
+export declare const OMP_RUN_GRACE_SEC = 60;
+export declare const OMP_SESSION_NEUTRAL_ADAPTER_CONFIG_KEYS: readonly ["stylePreset", "fallbackMode"];
+export declare const OMP_MODEL_SWITCH_ADAPTER_CONFIG_KEYS: readonly ["model", "fallbackModels", "modelEfforts", "thinking", "thinkingEffort", "effort", "smolModel", "slowModel", "planModel"];
+export declare const OMP_MODEL_SWITCH_OMP_SETTINGS: readonly ["defaultThinkingLevel"];
+export declare const OMP_SESSION_KEEPING_ADAPTER_CONFIG_KEYS: readonly string[];
+export declare function isWellFormedOmpSettingKey(key: string): boolean;
+export type AgentSettingValue = unknown;
+export type AgentSettingsPatch = Record<string, AgentSettingValue | undefined>;
+export type AgentSettingsValues = Record<string, AgentSettingValue>;
+export interface OmpChoiceModel {
+    id: string;
+    label?: string;
+    provider?: string;
+    thinking?: string[];
+    cost?: {
+        input?: number;
+        output?: number;
+    };
+}
+export declare const OMP_THINKING_LEVELS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
+export declare const OMP_STYLE_PRESETS: {
+    readonly balanced: {
+        readonly label: "Balanced";
+        readonly description: "Good answers at normal cost";
+        readonly thinking: "high";
+        readonly advisor: true;
+        readonly prewalk: false;
+        readonly maxRetries: 3;
+    };
+    readonly fast: {
+        readonly label: "Fast";
+        readonly description: "Quick replies, lower cost";
+        readonly thinking: "low";
+        readonly advisor: false;
+        readonly prewalk: true;
+        readonly maxRetries: 3;
+    };
+    readonly thorough: {
+        readonly label: "Thorough";
+        readonly description: "Plans first, checks its work";
+        readonly thinking: "xhigh";
+        readonly advisor: true;
+        readonly prewalk: false;
+        readonly maxRetries: 5;
+    };
+};
+export type OmpStylePreset = keyof typeof OMP_STYLE_PRESETS;
+export declare const OMP_THINKING_CHOICES: {
+    readonly quick: {
+        readonly label: "Quick";
+        readonly level: "low";
+    };
+    readonly balanced: {
+        readonly label: "Balanced";
+        readonly level: "medium";
+    };
+    readonly deep: {
+        readonly label: "Deep";
+        readonly level: "high";
+    };
+    readonly max: {
+        readonly label: "Max";
+        readonly level: "xhigh";
+    };
+};
+export type OmpThinkingChoice = keyof typeof OMP_THINKING_CHOICES;
+export declare const OMP_TOOLS_CHOICES: {
+    readonly standard: {
+        readonly label: "Standard";
+        readonly description: "OMP's default tool set";
+    };
+    readonly readOnly: {
+        readonly label: "Read only";
+        readonly description: "No shell and no edits";
+    };
+    readonly everything: {
+        readonly label: "Everything";
+        readonly description: "Standard plus the browser";
+    };
+};
+export type OmpToolsChoice = keyof typeof OMP_TOOLS_CHOICES;
+export declare const OMP_LIMIT_CHOICES: {
+    readonly m30: {
+        readonly label: "30 min";
+        readonly seconds: 1800;
+    };
+    readonly h1: {
+        readonly label: "1 hour";
+        readonly seconds: 3600;
+    };
+    readonly h2: {
+        readonly label: "2 hours";
+        readonly seconds: 7200;
+    };
+    readonly none: {
+        readonly label: "No limit";
+        readonly seconds: 0;
+    };
+};
+export type OmpLimitChoice = keyof typeof OMP_LIMIT_CHOICES;
+export type OmpBackupChoice = "automatic" | "custom";
+export declare const OMP_READ_ONLY_DENIED_TOOLS: readonly ["edit", "write", "ast_edit", "eval"];
+export type OmpControlId = "style" | "model" | "thinking" | "backup" | "tools" | "limit";
+export declare const OMP_CONTROL_PATHS: Record<OmpControlId, readonly string[]>;
+export declare const OMP_CONTROL_IDS: OmpControlId[];
+export declare const OMP_ADAPTER_ALIASES: Record<string, {
+    path: string;
+    invert?: boolean;
+}>;
+export declare const OMP_LOCKED_SETTINGS: Record<string, string>;
+export declare function isBlockedOmpSettingKey(key: string): boolean;
+export declare function ompSettingPath(key: string): string;
+export type OmpSettingType = "boolean" | "number" | "string" | "array" | "record" | "enum";
+export interface OmpSettingsCatalogEntry {
+    key: string;
+    section: string;
+    type: OmpSettingType;
+    options?: string[];
+    description: string;
+    value?: boolean | number | string;
+}
+export declare function validateOmpSettingValue(entry: OmpSettingsCatalogEntry, value: unknown): string | null;
+export declare function validateOmpSettingsMap(value: unknown, catalog?: readonly OmpSettingsCatalogEntry[]): string[];
+export declare function readAgentSetting(config: Record<string, unknown> | null | undefined, path: string): AgentSettingValue;
+export declare function readOmpSetting(config: Record<string, unknown> | null | undefined, key: string): AgentSettingValue;
+export declare function ompSettingStoredValue(key: string, value: AgentSettingValue): AgentSettingValue;
+export declare function applyAgentSettingsPatch(config: Record<string, unknown> | null | undefined, patch: AgentSettingsPatch): Record<string, unknown>;
+export declare function sameAgentSettingValue(left: unknown, right: unknown): boolean;
+export declare function nearestThinkingLevel(wanted: string, supported: readonly string[] | undefined): string;
+export declare function deriveOmpModelRoles(modelId: string, models: readonly OmpChoiceModel[]): {
+    smolModel: string;
+    slowModel: string;
+    planModel: string;
+};
+export declare function deriveOmpBackupModels(modelId: string, models: readonly OmpChoiceModel[], limit?: number): string[];
+export interface OmpChoiceContext {
+    config: Record<string, unknown>;
+    models: readonly OmpChoiceModel[];
+}
+export declare function ompChoicePatch(control: OmpControlId, value: string, context: OmpChoiceContext, options?: {
+    customBackups?: readonly string[];
+}): AgentSettingsPatch;
+export declare function readOmpChoices(config: Record<string, unknown> | null | undefined): Record<OmpControlId, string | null>;
+export declare function agentDiffersFromDefaults(config: Record<string, unknown> | null | undefined, defaults: AgentSettingsValues, paths: readonly string[]): boolean;
+export declare function resetToDefaultsPatch(defaults: AgentSettingsValues, paths: readonly string[]): AgentSettingsPatch;
+export declare function applyDefaultsPatch(defaults: AgentSettingsValues, patch: AgentSettingsPatch): AgentSettingsValues;
+export declare function defaultsAsConfig(defaults: AgentSettingsValues): Record<string, unknown>;
+export interface AgentDefaultsApplyAgent {
+    id: string;
+    name: string;
+    adapterConfig: Record<string, unknown> | null;
+}
+export interface AgentDefaultsApplyEntry {
+    agentId: string;
+    name: string;
+    adapterConfig: Record<string, unknown>;
+    appliedPaths: string[];
+    keptPaths: string[];
+}
+export declare function planAgentDefaultsApply(agents: readonly AgentDefaultsApplyAgent[], previous: AgentSettingsValues, next: AgentSettingsValues): {
+    changedPaths: string[];
+    entries: AgentDefaultsApplyEntry[];
+    following: number;
+    ownValues: number;
+    sessionKept: boolean;
+};
+export declare function agentSettingsKeepSession(paths: readonly string[]): boolean;
+export type OmpEssentialPlacement = "choice" | "elsewhere" | "advanced";
+export interface OmpEssentialSetting {
+    key: string;
+    label: string;
+    path: string;
+    placement: OmpEssentialPlacement;
+    where?: string;
+}
+export declare const OMP_ESSENTIAL_SETTINGS: readonly OmpEssentialSetting[];
+export declare const OMP_ADAPTER_SETTINGS: ReadonlyArray<{
+    key: string;
+    label: string;
+    type: "string" | "number" | "array" | "record";
+    description: string;
+}>;
+//# sourceMappingURL=omp-agent-settings.d.ts.map

package/dist/omp-agent-settings.d.ts.map

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