Begin PreviewEnv narrowing for the preview widget

[Copilot]

This starts the WaveEnv narrowing work for the preview widget, focused on wiring the preview view tree to the environment surface it already uses today. The change intentionally avoids adding new mock behavior and instead codifies the existing preview dependencies so the widget can move toward the same env-contract pattern used elsewhere.

• Preview env contract

  • Adds PreviewEnv in frontend/app/view/preview/previewenv.ts
  • Narrows the preview widget to the specific env surface currently exercised by the preview stack:
    • file RPCs
    • suggestion RPCs
    • config/meta RPCs
    • ObjectService
    • fullConfigAtom
    • settings and connection atom helpers
    • preview-only electron quicklook hook

• Preview model wiring

  • Updates PreviewModel to retain and use the injected waveEnv instead of reaching directly for global RPC/service helpers where the env already provides equivalents
  • Moves existing preview operations onto env.rpc, env.services, env.wos, and env-provided atom helpers without changing behavior

• Preview component adoption

  • Switches the top-level preview view to useWaveEnv<PreviewEnv>() for suggestion fetch/dispose calls
  • Switches directory preview code to the narrowed env for:
    • config reads
    • directory file reads
    • copy/create/mkdir actions
    • quicklook dispatch

• Preview-server compatibility

  • Adds a small type-level/runtime check that the existing mock wave env satisfies PreviewEnv
  • Keeps the change scoped to the functionality already present in the preview server

Example of the new pattern:

const env = useWaveEnv<PreviewEnv>();

const defaultSort = useAtomValue(env.getSettingsKeyAtom("preview:defaultsort")) ?? "name";

await env.rpc.FileReadCommand(TabRpcClient, {
    info: { path: await model.formatRemoteUri(dirPath, globalStore.get) },
});

• Screenshot

  • Existing preview-server UI used for manual verification:
    

    

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[cloudflare-workers-and-pages]

Deploying waveterm with    Cloudflare Pages

Latest commit:	813fe7a
Status:	✅  Deploy successful!
Preview URL:	https://682bc1ca.waveterm.pages.dev
Branch Preview URL:	https://copilot-waveenv-narrowing-pr.waveterm.pages.dev

View logs

[kilo-code-bot]

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (5 files)

• frontend/app/view/preview/preview-directory-utils.tsx - Refactored to use model.env
• frontend/app/view/preview/preview-directory.tsx - Added useWaveEnv hook
• frontend/app/view/preview/preview-model.tsx - Added env property, updated constructor
• frontend/app/view/preview/preview.tsx - Added useWaveEnv hook
• frontend/app/view/preview/previewenv.ts - New type definition

This PR is a clean refactoring that introduces the PreviewEnv WaveEnv narrowing type for the preview view. The changes follow the established pattern used by other WaveEnvSubset types in the codebase (TabBarEnv, BlockEnv, BadgeEnv, etc.). All RPC calls and global atoms have been properly migrated to use the env context.

[kilo-code-bot]

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (5 files)

• frontend/app/view/preview/preview-directory-utils.tsx - Refactored to use model.env
• frontend/app/view/preview/preview-directory.tsx - Added useWaveEnv hook
• frontend/app/view/preview/preview-model.tsx - Added env property, updated constructor
• frontend/app/view/preview/preview.tsx - Added useWaveEnv hook
• frontend/app/view/preview/previewenv.ts - New type definition

This PR is a clean refactoring that introduces the PreviewEnv WaveEnv narrowing type for the preview view. The changes follow the established pattern used by other WaveEnvSubset types in the codebase (TabBarEnv, BlockEnv, BadgeEnv, etc.). All RPC calls and global atoms have been properly migrated to use the env context.