@dxos/plugin-deck 0.7.5-feature-compute.4d9d99a → 0.7.5-labs.a279d8c

package/dist/types/src/capabilities/navigation/index.d.ts

@@ -1,5 +1,6 @@
 export declare const CheckAppScheme: (props?: import("@dxos/app-framework").PluginsContext | undefined) => Promise<import("@dxos/app-framework").Capability<null>>;
 export declare const LocationState: (props?: unknown) => Promise<import("@dxos/app-framework").Capability<import("packages/common/util/dist/types/src").DeepReadonly<import("@dxos/app-framework").Capabilities.MutableLocation>>>;
 export declare const NavigationIntentResolver: (props?: import("@dxos/app-framework").PluginsContext | undefined) => Promise<import("@dxos/app-framework").Capability<import("@dxos/app-framework").Capabilities.IntentResolver>>;
+export declare const NavigationTools: (props?: unknown) => Promise<import("@dxos/app-framework").Capability<import("packages/experimental/artifact/dist/types/src").Tool[]>>;
 export declare const UrlHandler: (props?: import("@dxos/app-framework").PluginsContext | undefined) => Promise<import("@dxos/app-framework").Capability<null>>;
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/capabilities/navigation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/navigation/index.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,+HAA2C,CAAC;AACvE,eAAO,MAAM,aAAa,gMAAmC,CAAC;AAC9D,eAAO,MAAM,wBAAwB,oLAA0C,CAAC;AAChF,eAAO,MAAM,UAAU,+HAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/navigation/index.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,+HAA2C,CAAC;AACvE,eAAO,MAAM,aAAa,gMAAmC,CAAC;AAC9D,eAAO,MAAM,wBAAwB,oLAA0C,CAAC;AAChF,eAAO,MAAM,eAAe,wIAAgC,CAAC;AAC7D,eAAO,MAAM,UAAU,+HAAsC,CAAC"}

package/dist/types/src/capabilities/navigation/tools.d.ts

@@ -0,0 +1,9 @@
+import { type PromiseIntentDispatcher } from '@dxos/app-framework';
+declare global {
+    interface ToolContextExtensions {
+        dispatch?: PromiseIntentDispatcher;
+    }
+}
+declare const _default: () => import("@dxos/app-framework").Capability<import("@dxos/artifact").Tool[]>;
+export default _default;
+//# sourceMappingURL=tools.d.ts.map

package/dist/types/src/capabilities/navigation/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/navigation/tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAKL,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAM7B,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,QAAQ,CAAC,EAAE,uBAAuB,CAAC;KACpC;CACF;;AAED,wBAkCK"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-deck",
-  "version": "0.7.5-feature-compute.4d9d99a",
+  "version": "0.7.5-labs.a279d8c",
   "description": "DXOS Surface plugin for the main application layout.",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -34,29 +34,30 @@
     "@preact/signals-core": "^1.6.0",
     "effect": "^3.12.3",
     "immer": "^10.1.1",
-    "@dxos/debug": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/app-framework": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/async": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/echo-schema": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/echo-signals": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/invariant": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/keyboard": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/live-object": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/local-storage": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/log": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/plugin-attention": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/plugin-observability": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/plugin-graph": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/plugin-theme": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/plugin-client": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/react-client": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/react-ui-attention": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/react-ui-form": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/react-ui-mosaic": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/react-ui-stack": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/react-ui-tabs": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/react-ui-text-tooltip": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/util": "0.7.5-feature-compute.4d9d99a"
+    "@dxos/app-framework": "0.7.5-labs.a279d8c",
+    "@dxos/artifact": "0.7.5-labs.a279d8c",
+    "@dxos/async": "0.7.5-labs.a279d8c",
+    "@dxos/echo-schema": "0.7.5-labs.a279d8c",
+    "@dxos/debug": "0.7.5-labs.a279d8c",
+    "@dxos/echo-signals": "0.7.5-labs.a279d8c",
+    "@dxos/invariant": "0.7.5-labs.a279d8c",
+    "@dxos/keyboard": "0.7.5-labs.a279d8c",
+    "@dxos/live-object": "0.7.5-labs.a279d8c",
+    "@dxos/local-storage": "0.7.5-labs.a279d8c",
+    "@dxos/log": "0.7.5-labs.a279d8c",
+    "@dxos/plugin-attention": "0.7.5-labs.a279d8c",
+    "@dxos/plugin-graph": "0.7.5-labs.a279d8c",
+    "@dxos/plugin-client": "0.7.5-labs.a279d8c",
+    "@dxos/plugin-observability": "0.7.5-labs.a279d8c",
+    "@dxos/react-client": "0.7.5-labs.a279d8c",
+    "@dxos/react-ui-form": "0.7.5-labs.a279d8c",
+    "@dxos/plugin-theme": "0.7.5-labs.a279d8c",
+    "@dxos/react-ui-mosaic": "0.7.5-labs.a279d8c",
+    "@dxos/react-ui-stack": "0.7.5-labs.a279d8c",
+    "@dxos/react-ui-text-tooltip": "0.7.5-labs.a279d8c",
+    "@dxos/util": "0.7.5-labs.a279d8c",
+    "@dxos/react-ui-tabs": "0.7.5-labs.a279d8c",
+    "@dxos/react-ui-attention": "0.7.5-labs.a279d8c"
   },
   "devDependencies": {
     "@phosphor-icons/react": "^2.1.5",
@@ -65,16 +66,16 @@
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
     "vite": "5.4.7",
-    "@dxos/react-ui": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/storybook-utils": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/react-ui-theme": "0.7.5-feature-compute.4d9d99a"
+    "@dxos/react-ui": "0.7.5-labs.a279d8c",
+    "@dxos/react-ui-theme": "0.7.5-labs.a279d8c",
+    "@dxos/storybook-utils": "0.7.5-labs.a279d8c"
   },
   "peerDependencies": {
     "@phosphor-icons/react": "^2.0.5",
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.7.5-feature-compute.4d9d99a",
-    "@dxos/react-ui-theme": "0.7.5-feature-compute.4d9d99a"
+    "@dxos/react-ui": "0.7.5-labs.a279d8c",
+    "@dxos/react-ui-theme": "0.7.5-labs.a279d8c"
   },
   "publishConfig": {
     "access": "public"

package/src/DeckPlugin.ts

@@ -21,6 +21,7 @@ import {
   DeckSettings,
   ReactSurface,
   UrlHandler,
+  NavigationTools,
 } from './capabilities';
 import { DeckEvents } from './events';
 import { meta } from './meta';
@@ -120,4 +121,9 @@ export const DeckPlugin = () =>
       activatesOn: Events.SetupIntents,
       activate: NavigationIntentResolver,
     }),
+    defineModule({
+      id: `${meta.id}/module/navigation-tools`,
+      activatesOn: Events.Startup,
+      activate: NavigationTools,
+    }),
   ]);

package/src/capabilities/navigation/index.ts

@@ -7,4 +7,5 @@ import { lazy } from '@dxos/app-framework';
 export const CheckAppScheme = lazy(() => import('./check-app-scheme'));
 export const LocationState = lazy(() => import('./location'));
 export const NavigationIntentResolver = lazy(() => import('./intent-resolver'));
+export const NavigationTools = lazy(() => import('./tools'));
 export const UrlHandler = lazy(() => import('./url-handler'));

package/src/capabilities/navigation/tools.ts

@@ -0,0 +1,57 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import {
+  Capabilities,
+  contributes,
+  createIntent,
+  NavigationAction,
+  type PromiseIntentDispatcher,
+} from '@dxos/app-framework';
+import { defineTool, ToolResult } from '@dxos/artifact';
+import { S } from '@dxos/echo-schema';
+import { invariant } from '@dxos/invariant';
+
+// TODO(burdon): Factor out.
+declare global {
+  interface ToolContextExtensions {
+    dispatch?: PromiseIntentDispatcher;
+  }
+}
+
+export default () =>
+  contributes(Capabilities.Tools, [
+    defineTool({
+      name: 'show',
+      // TODO(ZaymonFC): We should update the prompt to teach the LLM the difference between object ids and fully qualified ids.
+      description:
+        'Show an item in the app. Use this tool to open an artifact. When supplying IDs to show, they must be fully qualified like space:object.',
+      // TODO(wittjosiah): Refactor Layout/Navigation/Deck actions so that they can be used directly.
+      schema: S.Struct({
+        id: S.String.annotations({
+          description: 'The ID of the item to show.',
+        }),
+        pivotId: S.optional(
+          S.String.annotations({
+            description: 'The ID of the chat. If provided, the item will be added after the pivot item.',
+          }),
+        ),
+      }),
+      execute: async ({ id, pivotId }, { extensions }) => {
+        invariant(extensions?.dispatch, 'No intent dispatcher');
+        const { data, error } = await extensions.dispatch(
+          createIntent(NavigationAction.AddToActive, {
+            id,
+            part: 'main',
+            pivotId,
+          }),
+        );
+        if (error) {
+          return ToolResult.Error(error.message);
+        }
+
+        return ToolResult.Success(data);
+      },
+    }),
+  ]);

package/src/components/DeckLayout/ContentEmpty.tsx

@@ -14,10 +14,10 @@ export const ContentEmpty = () => {
   return (
     <div
       role='none'
-      className='min-bs-screen is-dvw sm:is-full p-8 grid grid-rows-[var(--rail-size)_1fr]'
+      className='min-bs-screen is-dvw sm:is-full p-8 grid grid-rows-[var(--rail-size)_1fr] lg:grid-rows-1'
       data-testid='layoutPlugin.firstRunMessage'
     >
-      <div role='toolbar' className={mx(soloInlinePadding, 'flex items-stretch')}>
+      <div role='toolbar' className={mx(soloInlinePadding, 'bs-[--rail-action] flex items-stretch lg:hidden')}>
         <ToggleSidebarButton />
         <span role='none' className='grow' />
       </div>