Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

4.7 KB
Raw Blame
import { isDataOwnerPushStamp, type DataOwnerPushStamp } from './dataOwnerPush.js';
import { projectKeyComparisonKey } from './projectKeys.js';
import { isValidPluginStoragePart } from './pluginIdentity.js';

export const SIDEBAR_PINNED_ORDER_MAX_ENTRIES = 10_000;
export const SIDEBAR_PINNED_ORDER_ENTRY_MAX_LENGTH = 4_096;
export const SIDEBAR_HIDDEN_MAIN_VIEW_MAX_ENTRIES = 1_000;

export function isSidebarGhostId(value: unknown): value is string {
  return typeof value === 'string' && isValidPluginStoragePart(value);
}

export interface SidebarSettingsSnapshot extends DataOwnerPushStamp {
  /** True when Main has a durable pinnedOrder override, including an explicit empty array. */
  readonly pinnedOrderIsAuthoritative: boolean;
  readonly pinnedOrder: string[];
  readonly hiddenProjectKeys: string[];
  /** Plugin ids with an explicit user override that hides their main-view sidebar entry. */
  readonly hiddenMainViewGhostIds: string[];
}

/** Main's durable arbitration result for the one unscoped Renderer namespace. */
export interface SidebarLegacyRendererOwnerClaim extends DataOwnerPushStamp {
  /** The durable marker belongs to this owner, so an existing envelope is readable. */
  readonly claimed: boolean;
  /** This process is currently exclusive and may publish a new legacy envelope. */
  readonly canInitialize: boolean;
  /** Main has durably consumed or superseded the legacy Renderer pin staging. */
  readonly pinnedLegacyConsumed: boolean;
}

export type SidebarPinnedOrderMutation =
  | {
      readonly kind: 'reorder';
      /** The renderer snapshot that the drag started from. */
      readonly baseOrder: readonly string[];
      /** The renderer's desired order after the drag. */
      readonly order: readonly string[];
    }
  | { readonly kind: 'promote'; readonly entryId: string }
  | { readonly kind: 'remove'; readonly entryId: string }
  | { readonly kind: 'migrate-legacy'; readonly order: readonly string[] };

const PINNED_PROJECT_ENTRY_PREFIX = 'project:';

/** Project pins compare by local Windows identity; conversation ids stay exact. */
export function sidebarPinnedEntryComparisonKey(entryId: string, localPlatform: string): string {
  if (!entryId.startsWith(PINNED_PROJECT_ENTRY_PREFIX)) return entryId;
  const projectKey = entryId.slice(PINNED_PROJECT_ENTRY_PREFIX.length);
  const comparisonKey = projectKeyComparisonKey(projectKey, localPlatform);
  return comparisonKey == null ? entryId : `${PINNED_PROJECT_ENTRY_PREFIX}${comparisonKey}`;
}

export interface SidebarPinnedOrderWriteRequest extends DataOwnerPushStamp {
  readonly mutation: SidebarPinnedOrderMutation;
}

export interface SidebarProjectHiddenWriteRequest extends DataOwnerPushStamp {
  readonly projectKey: string;
  readonly hidden: boolean;
}

export interface SidebarMainViewHiddenWriteRequest extends DataOwnerPushStamp {
  readonly ghostId: string;
  readonly hidden: boolean;
}

export function normalizeSidebarPinnedOrder(value: unknown): string[] {
  if (!Array.isArray(value)) return [];
  const seen = new Set<string>();
  const order: string[] = [];
  for (const entry of value) {
    if (
      typeof entry !== 'string' ||
      entry.length === 0 ||
      entry.length > SIDEBAR_PINNED_ORDER_ENTRY_MAX_LENGTH ||
      seen.has(entry)
    ) {
      continue;
    }
    seen.add(entry);
    order.push(entry);
    if (order.length >= SIDEBAR_PINNED_ORDER_MAX_ENTRIES) break;
  }
  return order;
}

export function isSidebarSettingsSnapshot(value: unknown): value is SidebarSettingsSnapshot {
  if (!isDataOwnerPushStamp(value)) return false;
  const candidate = value as Partial<SidebarSettingsSnapshot>;
  return (
    typeof candidate.pinnedOrderIsAuthoritative === 'boolean' &&
    isStringArray(candidate.pinnedOrder) &&
    isStringArray(candidate.hiddenProjectKeys) &&
    isHiddenMainViewGhostIds(candidate.hiddenMainViewGhostIds) &&
    (candidate.pinnedOrderIsAuthoritative || candidate.pinnedOrder.length === 0)
  );
}

export function isSidebarLegacyRendererOwnerClaim(
  value: unknown,
): value is SidebarLegacyRendererOwnerClaim {
  return (
    isDataOwnerPushStamp(value) &&
    typeof (value as Partial<SidebarLegacyRendererOwnerClaim>).claimed === 'boolean' &&
    typeof (value as Partial<SidebarLegacyRendererOwnerClaim>).canInitialize === 'boolean' &&
    typeof (value as Partial<SidebarLegacyRendererOwnerClaim>).pinnedLegacyConsumed === 'boolean'
  );
}

function isStringArray(value: unknown): value is string[] {
  return Array.isArray(value) && value.every((entry) => typeof entry === 'string');
}

function isHiddenMainViewGhostIds(value: unknown): value is string[] {
  return (
    Array.isArray(value) &&
    value.length <= SIDEBAR_HIDDEN_MAIN_VIEW_MAX_ENTRIES &&
    value.every(isSidebarGhostId) &&
    new Set(value).size === value.length
  );
}