feat: add intent link hook and component

.github/workflows/release-please.yml

@@ -91,6 +91,6 @@ jobs:
           done_state_id: "5a35b7bf-6d37-4cc2-854a-2f18d160e2e5"
 
       - name: Trigger CircleCI Pipeline
-        uses: CircleCI-Public/trigger-circleci-pipeline-action@v1.0.5
+        uses: CircleCI-Public/trigger-circleci-pipeline-action@ef1944e67053c1923ad772d2377575f2fd962169 # v1.0.5
         env:
           CCI_TOKEN: ${{ secrets.CCI_TOKEN }}

.github/workflows/test.yml

@@ -74,4 +74,4 @@ jobs:
           pnpm vitest run --merge-reports --coverage
 
       - name: Report coverage
-        uses: davelosert/vitest-coverage-report-action@7bf7d3c1b17a0e27c7e0d14190fb39168584bed2 # v2
+        uses: davelosert/vitest-coverage-report-action@8ab049ff5a2c6e78f78af446329379b318544a1a # v2

.github/workflows/validate-pr-title.yml

@@ -16,6 +16,6 @@ jobs:
     name: Validate PR title
     runs-on: ubuntu-latest
     steps:
-      - uses: amannn/action-semantic-pull-request@0723387faaf9b38adef4775cd42cfd5155ed6017 # v5
+      - uses: amannn/action-semantic-pull-request@e32d7e603df1aa1ba07e981f2a23455dee596825 # v5
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.release-please-manifest.json

@@ -1,4 +1,4 @@
 {
-  "packages/core": "2.2.0",
-  "packages/react": "2.2.0"
+  "packages/core": "2.3.1",
+  "packages/react": "2.3.1"
 }

apps/intent-disambiguation-app/package.json

@@ -18,6 +18,7 @@
   "prettier": "@sanity/prettier-config",
   "dependencies": {
     "@sanity/sdk-react": "workspace:*",
+    "@sanity/ui": "^3.1.11",
     "react": "^19",
     "react-dom": "^19",
     "react-router": "^7.5.2",

apps/intent-disambiguation-app/src/App.tsx

@@ -2,12 +2,16 @@ import './App.css'
 
 import {type SanityConfig} from '@sanity/sdk'
 import {SanityApp} from '@sanity/sdk-react'
+import {ThemeProvider} from '@sanity/ui'
+import {buildTheme} from '@sanity/ui/theme'
 import React from 'react'
 import {BrowserRouter} from 'react-router'
 
 import {IntentDisambiguation} from './components/IntentDisambiguation'
 import {LoadingFallback} from './components/LoadingFallback'
 
+const theme = buildTheme()
+
 function AppWithRouter(): React.JSX.Element {
   const sanityConfigs: SanityConfig[] = [
     {
@@ -18,10 +22,11 @@ function AppWithRouter(): React.JSX.Element {
       },
     },
   ]
-
   return (
     <SanityApp config={sanityConfigs} fallback={<LoadingFallback />}>
-      <IntentDisambiguation />
+      <ThemeProvider theme={theme}>
+        <IntentDisambiguation />
+      </ThemeProvider>
     </SanityApp>
   )
 }

apps/intent-disambiguation-app/src/components/IntentDisambiguation.tsx

@@ -1,42 +1,168 @@
-import {useSendIntent} from '@sanity/sdk-react'
+import {canvasSource, type DocumentHandleWithSource, useDispatchIntent} from '@sanity/sdk-react'
+import {Button, Card, Container, Flex, Heading, Stack, Text} from '@sanity/ui'
 import React, {Suspense} from 'react'
 
-function SendIntentButton(): React.JSX.Element {
-  const {sendIntent} = useSendIntent({
-    documentHandle: {
-      documentId: 'maintenance-schedule-123',
-      documentType: 'maintenanceSchedule',
-      projectId: '9wmez61s',
-      dataset: 'production',
-    },
+function SendIntentButton({
+  action,
+  intentId,
+  documentHandle,
+  parameters,
+  cta,
+}: {
+  action?: 'edit'
+  intentId?: string
+  documentHandle: DocumentHandleWithSource
+  parameters?: Record<string, unknown>
+  cta: string
+}): React.JSX.Element {
+  const {dispatchIntent} = useDispatchIntent({
+    ...(action && {action}),
+    ...(intentId && {intentId}),
+    ...(parameters && {parameters}),
+    documentHandle,
   })
 
-  const handleMaintenanceScheduleClick = () => {
-    console.log('Sending maintenanceSchedule intent - this should trigger disambiguation')
-    sendIntent()
+  const handleClick = () => {
+    console.log(`Sending ${action || intentId} intent`)
+    dispatchIntent()
   }
 
   return (
-    <button className="maintenance-schedule-button" onClick={handleMaintenanceScheduleClick}>
-      Send Maintenance Schedule Intent
-    </button>
+    <Button
+      tone="primary"
+      fontSize={2}
+      padding={4}
+      text={cta}
+      onClick={handleClick}
+      style={{
+        minWidth: 140,
+      }}
+    />
   )
 }
 
 export function IntentDisambiguation(): React.JSX.Element {
   return (
-    <div className="app-container">
-      <div className="intent-disambiguation">
-        <h1>Intent Disambiguation App</h1>
-        <p>
-          This app sends a maintenanceSchedule intent. Since both the property-detail-app and
-          property-overview-app can handle this intent, the Dashboard should do something to let you
-          choose which app should handle it.
-        </p>
-        <Suspense fallback={<div>Loading intent sender...</div>}>
-          <SendIntentButton />
-        </Suspense>
-      </div>
-    </div>
+    <Container width={1} paddingY={6} style={{textAlign: 'center'}}>
+      <Stack space={5}>
+        <Heading as="h1">Intents Demos App</Heading>
+
+        <Text>
+          This app provides sample intents triggers that allow for easier navigation between the
+          property-detail-app, property-overview-app, or studio. These can be set up to either
+          navigate directly by intent name or display a picker for disambiguation.
+        </Text>
+
+        <Stack>
+          <Card borderBottom borderTop paddingY={4}>
+            <Flex justify="space-between" align="center" gap={5}>
+              <Text align="left">
+                Open all intents that can handle editing for the &ldquo;HVAC Service - 123 Oak
+                Street&rdquo; maintenance schedule.
+              </Text>
+
+              <Suspense fallback={<div></div>}>
+                <SendIntentButton
+                  action="edit"
+                  documentHandle={{
+                    documentId: 'ISWDzt74pwbeI4ifLERAKF',
+                    documentType: 'maintenanceSchedule',
+                    projectId: '9wmez61s',
+                    dataset: 'production',
+                  }}
+                  cta="Edit Schedule"
+                />
+              </Suspense>
+            </Flex>
+          </Card>
+
+          <Card borderBottom paddingY={4}>
+            <Flex justify="space-between" align="center" gap={5}>
+              <Text align="left">
+                Navigate directly to the &ldquo;Plumbing Check - 456 Pine Avenue&rdquo; maintenance
+                schedule in the property-overview-app.
+              </Text>
+
+              <Suspense fallback={<div></div>}>
+                <SendIntentButton
+                  intentId="editScheduleState"
+                  documentHandle={{
+                    documentId: 'ISWDzt74pwbeI4ifLERAy7',
+                    documentType: 'maintenanceSchedule',
+                    projectId: '9wmez61s',
+                    dataset: 'production',
+                  }}
+                  cta="Edit Schedule"
+                />
+              </Suspense>
+            </Flex>
+          </Card>
+
+          <Card borderBottom paddingY={4}>
+            <Flex justify="space-between" align="center" gap={5}>
+              <Text align="left">
+                Open all intents that can handle editing for the &ldquo;123 Oak Street&rdquo;
+                property.
+              </Text>
+
+              <Suspense fallback={<div></div>}>
+                <SendIntentButton
+                  action="edit"
+                  documentHandle={{
+                    documentId: 'ISWDzt74pwbeI4ifLER8da',
+                    documentType: 'property',
+                    projectId: '9wmez61s',
+                    dataset: 'production',
+                  }}
+                  cta="Edit Schedule"
+                />
+              </Suspense>
+            </Flex>
+          </Card>
+
+          <Card borderBottom paddingY={4}>
+            <Flex justify="space-between" align="center" gap={5}>
+              <Text align="left">
+                Navigate directly to the &ldquo;Check oven temperature accuracy&rdquo; maintenance
+                task in the studio.
+              </Text>
+
+              <Suspense fallback={<div></div>}>
+                <SendIntentButton
+                  intentId="j8q720b38239y746e1ho73tj-default.edit-workspace-default"
+                  documentHandle={{
+                    documentId: 'ISWDzt74pwbeI4ifLERD8g',
+                    documentType: 'maintenanceTask',
+                    projectId: '9wmez61s',
+                    dataset: 'production',
+                  }}
+                  cta="Edit Task"
+                />
+              </Suspense>
+            </Flex>
+          </Card>
+
+          <Card borderBottom paddingY={4}>
+            <Flex justify="space-between" align="center" gap={5}>
+              <Text align="left">
+                Navigate directly to &ldquo;Welcome to Sanity Canvas&rdquo; in Canvas.
+              </Text>
+
+              <Suspense fallback={<div></div>}>
+                <SendIntentButton
+                  intentId="canvas.edit"
+                  documentHandle={{
+                    documentId: 'TUJo78GZr52XcbxuwWUlzQ',
+                    documentType: 'sanity.canvas.document',
+                    source: canvasSource('TUJo78GZr52XcbxuwWUlzQ'),
+                  }}
+                  cta="Edit Canvas"
+                />
+              </Suspense>
+            </Flex>
+          </Card>
+        </Stack>
+      </Stack>
+    </Container>
   )
 }

apps/kitchensink-react/src/AppRoutes.tsx

@@ -1,3 +1,4 @@
+import {ResourceProvider} from '@sanity/sdk-react'
 import {type JSX} from 'react'
 import {Route, Routes} from 'react-router'
 
@@ -14,9 +15,12 @@ import {SearchRoute} from './DocumentCollection/SearchRoute'
 import {PresenceRoute} from './Presence/PresenceRoute'
 import {ProjectAuthHome} from './ProjectAuthentication/ProjectAuthHome'
 import {ProtectedRoute} from './ProtectedRoute'
+import {AgentActionsRoute} from './routes/AgentActionsRoute'
 import {DashboardContextRoute} from './routes/DashboardContextRoute'
 import {DashboardWorkspacesRoute} from './routes/DashboardWorkspacesRoute'
 import ExperimentalResourceClientRoute from './routes/ExperimentalResourceClientRoute'
+import {IntentsRoute} from './routes/IntentsRoute'
+import {MediaLibraryRoute} from './routes/MediaLibraryRoute'
 import {PerspectivesRoute} from './routes/PerspectivesRoute'
 import {ProjectsRoute} from './routes/ProjectsRoute'
 import {ReleasesRoute} from './routes/releases/ReleasesRoute'
@@ -72,6 +76,14 @@ const documentCollectionRoutes = [
     path: 'presence',
     element: <PresenceRoute />,
   },
+  {
+    path: 'media-library',
+    element: <MediaLibraryRoute />,
+  },
+  {
+    path: 'intents',
+    element: <IntentsRoute />,
+  },
 ]
 
 const dashboardInteractionRoutes = [
@@ -121,6 +133,14 @@ export function AppRoutes(): JSX.Element {
           {documentCollectionRoutes.map((route) => (
             <Route key={route.path} path={route.path} element={route.element} />
           ))}
+          <Route
+            path="agent-actions"
+            element={
+              <ResourceProvider projectId="vo1ysemo" dataset="production" fallback={null}>
+                <AgentActionsRoute />
+              </ResourceProvider>
+            }
+          />
           <Route path="users/:userId" element={<UserDetailRoute />} />
           <Route path="comlink-demo" element={<ParentApp />} />
           <Route path="releases" element={<ReleasesRoute />} />