Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

15.0 KB
Raw Blame
// oxlint-disable ok/no-raw-error-toast -- pre-rule backlog: toasts here show raw error text; delete this line once the file maps each failure to written copy. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-raw-error-toast
// oxlint-disable ok/no-physical-direction-utility -- pre-rule backlog — physical margin/padding/inset utilities predate the rule; drain by swapping ml/mr → ms/me, pl/pr → ps/pe, left/right → start/end, then deleting this line. See https://github.com/inkeep/open-knowledge/blob/main/lint-plugins/ok-rules/README.md#no-physical-direction-utility

import { AGENTS_SKILLS_ROOT } from '@inkeep/open-knowledge-core/constants/skills';
import type { SkillFolderLinkPreview, SkillScope } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { useState } from 'react';
import { toast } from 'sonner';
import { AgentBrandIcon, hostLabel } from '@/components/AgentIconCluster';
import { ChangedOutsideBadge } from '@/components/ChangedOutsideBadge';
import { SkillFolderLinkConfirmDialog } from '@/components/settings/SkillFolderLinkConfirmDialog';
import { Button } from '@/components/ui/button';
import {
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuItem,
  DropdownMenuTrigger,
} from '@/components/ui/dropdown-menu';
import { Input } from '@/components/ui/input';
import { Skeleton } from '@/components/ui/skeleton';
import { useSkillTargets } from '@/hooks/use-skill-targets';
import { formatToolList } from '@/lib/tool-list-format';

export function SkillTargetsPicker({ scope }: { scope: SkillScope }) {
  const { i18n, t } = useLingui();
  const { state, saving, folderAction } = useSkillTargets();
  const [newRoot, setNewRoot] = useState('');
  const [pendingLink, setPendingLink] = useState<{
    root: string;
    target: string;
    pick: string;
    keep: string;
    preview: SkillFolderLinkPreview;
  } | null>(null);

  const folders =
    state.status === 'ready' ? (state.data.folders ?? []).filter((f) => f.scope === scope) : [];

  const byRoot = new Map(folders.map((f) => [f.root, f]));
  const isFollower = (f: (typeof folders)[number]): boolean =>
    (f.state === 'linked' || f.state === 'linked-parent') &&
    typeof f.target === 'string' &&
    byRoot.has(f.target);
  const followers = new Map<string, typeof folders>();
  for (const f of folders) {
    if (!isFollower(f)) continue;
    const target = f.target as string;
    followers.set(target, [...(followers.get(target) ?? []), f]);
  }
  const rows = folders.filter((f) => !isFollower(f));

  const runFolderAction = (root: string, action: 'link' | 'unlink', target?: string) => {
    void folderAction({ scope, root, action, ...(target !== undefined ? { target } : {}) }).catch(
      (err) => toast.error(err instanceof Error ? err.message : String(err)),
    );
  };

  const displayRoot = (root: string) => (scope === 'global' ? `~/${root}` : root);

  const runFolderLink = (root: string, target: string) => {
    const pick = displayRoot(root);
    const keep = displayRoot(target);
    void folderAction({ scope, root, action: 'link', target, preview: true })
      .then((p) => {
        if (!p) {
          toast.error(t`Could not classify the merge — try again.`);
          return;
        }
        if (p.conflicts.length > 0) {
          toast.error(
            t`${pick} and ${keep} both hold a different version of: ${p.conflicts.join(', ')}. Resolve those first — a symlink can only keep one of each.`,
          );
          return;
        }
        if (p.strays.length > 0) {
          toast.error(
            t`${pick} holds entries that aren't skills: ${p.strays.join(', ')}. Remove or move them from the folder and try again.`,
          );
          return;
        }
        if (p.moves.length + p.removes.length + p.replaces.length > 0) {
          setPendingLink({ root, target, pick, keep, preview: p });
          return;
        }
        return folderAction({ scope, root, action: 'link', target });
      })
      .catch((err) => toast.error(err instanceof Error ? err.message : String(err)));
  };

  const confirmPendingLink = () => {
    if (!pendingLink) return;
    const { root, target } = pendingLink;
    setPendingLink(null);
    void folderAction({ scope, root, action: 'link', target }).catch((err) =>
      toast.error(err instanceof Error ? err.message : String(err)),
    );
  };

  return (
    <section
      className="space-y-2 rounded-lg border bg-card p-3"
      data-testid="settings-skill-folders"
    >
      <div>
        <h4 className="text-sm font-medium">
          <Trans comment="Heading above the skill-folder list in Settings → Skills Studio — the reason, not the mechanism">
            Share skills between AI tools
          </Trans>
        </h4>
        <p className="text-1sm text-muted-foreground">
          <Trans comment="Says what symlinking two skill folders together buys the user, before any button names it">
            Each AI tool reads skills from its own folder. Point one folder at another and both
            tools see the same skills — add a skill once instead of copying it into every tool.
          </Trans>
        </p>
      </div>
      {state.status === 'error' ? (
        <div className="text-1sm text-destructive" role="alert" data-testid="skill-targets-error">
          <Trans>Failed to load skill settings: {state.message}</Trans>
        </div>
      ) : state.status !== 'ready' ? (
        <div className="space-y-2 pt-1">
          <Skeleton className="h-5 w-56" />
          <Skeleton className="h-5 w-56" />
        </div>
      ) : (
        <ul className="space-y-1 pt-1">
          {rows.map((f) => {
            const display = displayRoot(f.root);
            const following = followers.get(f.root) ?? [];
            const isAbsentHub = (r: { root: string; state: string }): boolean =>
              r.root === AGENTS_SKILLS_ROOT && r.state === 'absent';
            const targets = folders.filter(
              (o) =>
                o.root !== f.root && (o.state === 'own' || o.state === 'absent') && !isAbsentHub(o),
            );
            const canLink = (f.state === 'own' || f.state === 'absent') && !isAbsentHub(f);
            return (
              <li key={f.host} className="text-sm" data-testid={`skill-folder-row-${f.host}`}>
                <div className="flex items-center gap-2">
                  <AgentBrandIcon host={f.host} aria-hidden className="size-4 shrink-0" />
                  <span className="min-w-0 flex-1 truncate font-mono text-xs">
                    {display}
                    {f.state === 'linked' || f.state === 'linked-parent' ? (
                      <span className="text-muted-foreground"> → {f.target ?? '?'}</span>
                    ) : null}
                  </span>
                  {f.drift ? (
                    <ChangedOutsideBadge
                      testId={`skill-folder-drift-${f.host}`}
                      title={t`OK last set this folder to ${f.expected ?? ''} — something outside OK changed it since. The state shown is what's on disk now; your next Symlink/Unlink wins.`}
                    />
                  ) : null}
                  {f.state === 'linked-parent' ? (
                    <span
                      className="shrink-0 text-[10px] text-muted-foreground uppercase tracking-wide"
                      title={t`A parent directory is the symlink — unlink that folder itself to take this one back.`}
                    >
                      <Trans>symlinked via parent</Trans>
                    </span>
                  ) : null}
                  {isAbsentHub(f) ? (
                    <span
                      className="shrink-0 text-[10px] text-muted-foreground"
                      title={t`Linking merges another folder into this one. This folder does not exist yet, so install a skill here first.`}
                      data-testid="skill-folder-hub-destination-only"
                    >
                      <Trans>install a skill here first</Trans>
                    </span>
                  ) : null}
                  {canLink && targets.length > 0 ? (
                    <DropdownMenu>
                      <DropdownMenuTrigger asChild>
                        <Button
                          size="sm"
                          variant="ghost"
                          disabled={saving}
                          className="h-5 shrink-0 rounded border border-border/60 px-1 font-normal text-[10px] uppercase tracking-wide text-muted-foreground hover:text-foreground"
                          title={t`Pick a folder to merge INTO ${display}. That folder becomes a symlink to this one, so its agent reads everything placed here. This folder stays real. Conflicting skills abort the merge.`}
                          data-testid={`skill-folder-link-${f.host}`}
                        >
                          <Trans>Link</Trans>
                        </Button>
                      </DropdownMenuTrigger>
                      <DropdownMenuContent align="end" className="w-auto">
                        {targets.map((o) => (
                          <DropdownMenuItem
                            key={o.root}
                            onSelect={() => runFolderLink(o.root, f.root)}
                            data-testid={`skill-folder-link-${f.host}-to-${o.root}`}
                          >
                            <AgentBrandIcon host={o.host} aria-hidden className="size-4" />
                            <span className="font-mono text-xs">
                              {scope === 'global' ? `~/${o.root}` : o.root}
                            </span>
                          </DropdownMenuItem>
                        ))}
                      </DropdownMenuContent>
                    </DropdownMenu>
                  ) : null}
                  {f.state === 'linked' ? (
                    <Button
                      size="sm"
                      variant="ghost"
                      disabled={saving}
                      className="h-5 shrink-0 rounded border border-border/60 px-1 font-normal text-[10px] uppercase tracking-wide text-muted-foreground hover:text-foreground"
                      title={t`Turn ${display} back into a real directory holding a per-skill symlink for each skill it currently sees — nothing stops working, and each skill's menu manages it from there.`}
                      onClick={() => runFolderAction(f.root, 'unlink')}
                      data-testid={`skill-folder-unlink-${f.host}`}
                    >
                      <Trans>unlink</Trans>
                    </Button>
                  ) : null}
                </div>
                {following.length > 0 ? (
                  <p
                    className="mt-1 ml-6 text-muted-foreground text-xs"
                    data-testid={`skill-folder-shared-${f.host}`}
                  >
                    {t`${formatToolList(
                      [f.host, ...following.map((o) => o.host)].map(hostLabel),
                      i18n.locale,
                    )} share this folder.`}
                  </p>
                ) : null}
                {following.length > 0 ? (
                  <ul
                    className="mt-1 ml-2 space-y-1 border-border/60 border-l pl-3"
                    data-testid={`skill-folder-followers-${f.host}`}
                  >
                    {following.map((o) => (
                      <li key={o.host} className="flex items-center gap-2">
                        <AgentBrandIcon host={o.host} aria-hidden className="size-4 shrink-0" />
                        <span className="min-w-0 flex-1 truncate font-mono text-muted-foreground text-xs">
                          {scope === 'global' ? `~/${o.root}` : o.root}
                        </span>
                        {o.drift ? (
                          <ChangedOutsideBadge
                            testId={`skill-folder-drift-${o.host}`}
                            title={t`OK last set this folder to ${o.expected ?? ''} — something outside OK changed it since. The state shown is what's on disk now; your next Symlink/Unlink wins.`}
                          />
                        ) : null}
                        {o.state === 'linked-parent' ? (
                          <span
                            className="shrink-0 text-[10px] text-muted-foreground uppercase tracking-wide"
                            title={t`A parent directory is the symlink — unlink that folder itself to take this one back.`}
                          >
                            <Trans>via parent</Trans>
                          </span>
                        ) : (
                          <Button
                            size="sm"
                            variant="ghost"
                            disabled={saving}
                            className="h-5 shrink-0 rounded border border-border/60 px-1 font-normal text-[10px] text-muted-foreground uppercase tracking-wide hover:text-foreground"
                            title={t`Turn ${scope === 'global' ? `~/${o.root}` : o.root} back into a real directory holding a per-skill symlink for each skill it currently sees — nothing stops working, and each skill's menu manages it from there.`}
                            onClick={() => runFolderAction(o.root, 'unlink')}
                            data-testid={`skill-folder-unlink-${o.host}`}
                          >
                            <Trans>unlink</Trans>
                          </Button>
                        )}
                      </li>
                    ))}
                  </ul>
                ) : null}
              </li>
            );
          })}
        </ul>
      )}
      <form
        className="flex items-center gap-2 pt-1"
        onSubmit={(e) => {
          e.preventDefault();
          const trimmed = newRoot.trim().replace(/^~\//, '');
          if (trimmed === '') return;
          void folderAction({ scope, root: trimmed, action: 'add-root' })
            .then(() => setNewRoot(''))
            .catch((err) => toast.error(err instanceof Error ? err.message : String(err)));
        }}
        data-testid="skill-folders-add-root"
      >
        <Input
          value={newRoot}
          onChange={(e) => setNewRoot(e.target.value)}
          aria-label={t`Custom skills folder path`}
          placeholder={scope === 'global' ? t`~/.myteam/skills` : t`.myteam/skills`}
          className="h-7 flex-1 font-mono text-xs"
          disabled={saving}
          data-testid="skill-folders-add-root-input"
        />
        <Button
          type="submit"
          size="sm"
          variant="secondary"
          disabled={saving || newRoot.trim() === ''}
          className="h-7 px-2 font-normal text-xs"
        >
          <Trans>Add custom path</Trans>
        </Button>
      </form>
      {pendingLink ? (
        <SkillFolderLinkConfirmDialog
          open
          onOpenChange={(next) => {
            if (!next) setPendingLink(null);
          }}
          pick={pendingLink.pick}
          keep={pendingLink.keep}
          preview={pendingLink.preview}
          onConfirm={confirmPendingLink}
        />
      ) : null}
    </section>
  );
}