@puredesktop/create-app 1.0.0-beta.2 → 2.1.1

package/template/scripts/validate-puredesktop-app.mjs

@@ -199,6 +199,9 @@ async function validateAgentTools(manifest, distPath) {
 
   if (toolNames.size === 0) return
 
+  const manifestToolNames = [...toolNames]
+  await validateAgentToolScaffold(manifestToolNames)
+
   const sourceText = await readProjectText(join(ROOT, 'src'))
   const distText = await readProjectText(distPath)
   const registrationHints = ['usePlatformAgentTools', 'registerAgentTools', 'agents.tools.register']
@@ -206,7 +209,7 @@ async function validateAgentTools(manifest, distPath) {
     errors.push('Declared app agent tools must be registered in source with usePlatformAgentTools or agents.tools.register.')
   }
 
-  for (const toolName of toolNames) {
+  for (const toolName of manifestToolNames) {
     if (!sourceText.includes(toolName)) {
       errors.push(`Declared app agent tool "${toolName}" was not found in source files.`)
     }
@@ -220,6 +223,68 @@ async function validateAgentTools(manifest, distPath) {
   }
 }
 
+async function validateAgentToolScaffold(toolNames) {
+  const catalogPath = join(ROOT, 'src', 'agents', 'catalog.ts')
+  const handlersPath = join(ROOT, 'src', 'agents', 'handlers', 'index.ts')
+  const hookPath = join(ROOT, 'src', 'hooks', 'useAppAgentTools.ts')
+  const appPath = join(ROOT, 'src', 'App.tsx')
+
+  const catalogText = await readRequiredText(
+    catalogPath,
+    'Declared app agent tools require src/agents/catalog.ts.',
+  )
+  const handlersText = await readRequiredText(
+    handlersPath,
+    'Declared app agent tools require src/agents/handlers/index.ts.',
+  )
+  const hookText = await readRequiredText(
+    hookPath,
+    'Declared app agent tools require src/hooks/useAppAgentTools.ts.',
+  )
+  const appText = await readRequiredText(
+    appPath,
+    'Declared app agent tools require src/App.tsx.',
+  )
+
+  if (!catalogText || !handlersText || !hookText || !appText) return
+
+  if (!catalogText.includes('APP_AGENT_TOOL_NAMES')) {
+    errors.push('src/agents/catalog.ts must export APP_AGENT_TOOL_NAMES.')
+  }
+  if (!handlersText.includes('appAgentHandlers')) {
+    errors.push('src/agents/handlers/index.ts must export appAgentHandlers.')
+  }
+  if (!hookText.includes('usePlatformAgentTools')) {
+    errors.push('src/hooks/useAppAgentTools.ts must call usePlatformAgentTools.')
+  }
+  if (!hookText.includes('APP_AGENT_TOOL_NAMES')) {
+    errors.push('src/hooks/useAppAgentTools.ts must register APP_AGENT_TOOL_NAMES.')
+  }
+  if (!appText.includes('useAppAgentTools(ready)')) {
+    errors.push('src/App.tsx must call useAppAgentTools(ready).')
+  }
+
+  for (const toolName of toolNames) {
+    if (!catalogText.includes(toolName)) {
+      errors.push(`src/agents/catalog.ts is missing app agent tool "${toolName}".`)
+    }
+    if (!handlersText.includes(toolName)) {
+      errors.push(`src/agents/handlers/index.ts is missing app agent tool "${toolName}".`)
+    }
+  }
+}
+
+async function readRequiredText(path, message) {
+  if (!(await isFile(path))) {
+    errors.push(message)
+    return ''
+  }
+  return readFile(path, 'utf8').catch(error => {
+    errors.push(`${message} ${errorMessage(error)}`)
+    return ''
+  })
+}
+
 async function readProjectText(root) {
   const chunks = []
   await collectText(root, chunks)

package/template/src/App.tsx

@@ -33,8 +33,8 @@ export function App(): React.ReactElement {
             bootError
               ? bootError.message
               : booting
-                ? 'Loading…'
-                : 'Waiting for PureScience shell bridge…'
+                ? 'Loading...'
+                : 'Waiting for PureDesktop shell bridge...'
           }
         />
       </AppFrame>

package/template/src/bridge/platformBridge.ts

@@ -1,9 +1,58 @@
-import { bridge } from '@puredesktop/puredesktop-ui-bridge/bridge/client'
-import { PLATFORM_BRIDGE_METHODS } from '@puredesktop/puredesktop-ui-bridge/bridge/methods'
-import { APP_SLUG } from '../constants'
-import type { AppSettings } from '../types'
-
-export { bridge }
+import { bridge } from '@puredesktop/puredesktop-ui-bridge/bridge/client'
+import { getPlatformAppSettings } from '@puredesktop/puredesktop-ui-bridge/bridge/appSettings'
+import { APP_SLUG } from '../constants'
+import type { AppSettings } from '../types'
+
+export {
+  getPlatformAppSettings,
+  updatePlatformAppSettings,
+} from '@puredesktop/puredesktop-ui-bridge/bridge/appSettings'
+export {
+  getPlatformPreferences,
+  patchPlatformPreferences,
+} from '@puredesktop/puredesktop-ui-bridge/bridge/preferences'
+export {
+  networkFetch,
+  type PlatformNetworkFetchRequest,
+  type PlatformNetworkFetchResponse,
+} from '@puredesktop/puredesktop-ui-bridge/bridge/network'
+export {
+  createPlatformFolder,
+  deletePlatformFile,
+  listPlatformFiles,
+  readPlatformFileBinary,
+  readPlatformFileBinaryDataUrl,
+  readPlatformFilePreview,
+  readPlatformFilePreviewUrl,
+  readPlatformTextFile,
+  renamePlatformFile,
+  writePlatformFileBinary,
+  writePlatformTextFile,
+  type PlatformFileCreateFolderResult,
+  type PlatformFileDeleteResult,
+  type PlatformFileEntry,
+  type PlatformFileListResult,
+  type PlatformFilePreviewUrlResult,
+  type PlatformFileReadBinaryResult,
+  type PlatformFileReadPreviewResult,
+  type PlatformFileRenameResult,
+  type PlatformFileWriteResult,
+} from '@puredesktop/puredesktop-ui-bridge/bridge/fs'
+export {
+  openPlatformFileDialog,
+  openPlatformFolderDialog,
+  openPlatformImageDialog,
+  savePlatformFolderDialog,
+} from '@puredesktop/puredesktop-ui-bridge/bridge/dialog'
+export {
+  readPlatformStorageJson,
+  writePlatformStorageJson,
+  type PlatformStorageJsonReadResult,
+  type PlatformStorageJsonRequest,
+  type PlatformStorageJsonWriteRequest,
+  type PlatformStorageJsonWriteResult,
+} from '@puredesktop/puredesktop-ui-bridge/bridge/storage'
+export { bridge }
 
 const STANDALONE_SETTINGS_KEY = 'puredesktop:{{APP_SLUG}}:settings'
 
@@ -20,12 +69,10 @@ function readStandaloneSettings(): AppSettings {
   }
 }
 
-export async function fetchAppSettings(): Promise<AppSettings> {
-  if (isStandaloneDevMode()) {
-    return readStandaloneSettings()
-  }
-
-  return bridge.call<AppSettings>(PLATFORM_BRIDGE_METHODS.SETTINGS_APP_GET, [
-    APP_SLUG,
-  ])
-}
+export async function fetchAppSettings(): Promise<AppSettings> {
+  if (isStandaloneDevMode()) {
+    return readStandaloneSettings()
+  }
+
+  return getPlatformAppSettings(APP_SLUG) as Promise<AppSettings>
+}