@dxos/plugin-script 0.7.5-labs.a279d8c → 0.7.5-labs.ea4b4c2

package/dist/types/src/{components/ScriptToolbar → hooks}/useToolbarAction.d.ts

@@ -2,7 +2,7 @@ import { type ScriptType } from '@dxos/functions';
 import { type MenuAction, type MenuActionHandler } from '@dxos/react-ui-menu';
 import { type DeployActionProperties } from './deploy';
 import { type FormatActionProperties } from './format';
-import { type TemplateActionProperties } from './templateSelect';
+import { type TemplateActionProperties } from './template';
 import { type ScriptToolbarState } from './useToolbarState';
 import { type ViewActionProperties } from './view';
 export type ScriptToolbarActionProperties = TemplateActionProperties | ViewActionProperties | FormatActionProperties | DeployActionProperties;

package/dist/types/src/hooks/useToolbarAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToolbarAction.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useToolbarAction.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,EAAE,KAAK,sBAAsB,EAAoC,MAAM,UAAU,CAAC;AACzF,OAAO,EAAE,KAAK,sBAAsB,EAAoB,MAAM,UAAU,CAAC;AACzE,OAAO,EAAE,KAAK,wBAAwB,EAA4B,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAEnD,MAAM,MAAM,6BAA6B,GACrC,wBAAwB,GACxB,oBAAoB,GACpB,sBAAsB,GACtB,sBAAsB,CAAC;AAE3B,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,6BAA6B,CAAC,CAAC;AAE5E,eAAO,MAAM,gBAAgB,UAAW;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,sBA6BxF,CAAC"}

package/dist/types/src/hooks/useToolbarState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToolbarState.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useToolbarState.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;AAElE,eAAO,MAAM,eAAe,kBAAkB,kBAAkB;;;;;GAE/D,CAAC"}

package/dist/types/src/hooks/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../../src/hooks/view.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAEpD,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE3C,MAAM,MAAM,oBAAoB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AA6BrE,eAAO,MAAM,UAAU,UAAW,OAAO,CAAC,SAAS,CAAC;;;;;;;;;;;;;;;;;;;;;;;CAUnD,CAAC"}

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

@@ -1,4 +1,3 @@
-export * from './bundler';
 export { ScriptCapabilities } from './capabilities';
 export * from './components';
 export * from './meta';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AAEvB,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AAEvB,cAAc,gBAAgB,CAAC"}

package/dist/types/src/meta.d.ts

@@ -6,5 +6,6 @@ export declare const meta: {
     icon: string;
     source: string;
     tags: string[];
+    screenshots: string[];
 };
 //# sourceMappingURL=meta.d.ts.map

package/dist/types/src/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/meta.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,aAAa,2BAA2B,CAAC;AAEtD,eAAO,MAAM,IAAI;;;;;;;CAOK,CAAC"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/meta.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,aAAa,2BAA2B,CAAC;AAEtD,eAAO,MAAM,IAAI;;;;;;;;CASK,CAAC"}

package/dist/types/src/templates/echo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"echo.d.ts","sourceRoot":"","sources":["../../../../src/templates/echo.ts"],"names":[],"mappings":"AAIA;;GAEG;6DAKA,GAAG;AAJN,wBAOE"}
+{"version":3,"file":"echo.d.ts","sourceRoot":"","sources":["../../../../src/templates/echo.ts"],"names":[],"mappings":"AAIA;;GAEG;6DAKA,GAAG;AAJN,wBAWE"}

package/dist/types/src/templates/forex-effect.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns the exchange rate between two currencies.
+ */
+declare const _default: any;
+export default _default;
+//# sourceMappingURL=forex-effect.d.ts.map

package/dist/types/src/templates/forex-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forex-effect.d.ts","sourceRoot":"","sources":["../../../../src/templates/forex-effect.ts"],"names":[],"mappings":"AAkBA;;GAEG;;AACH,wBAoBG"}

package/dist/types/src/templates/forex.d.ts

@@ -1,6 +1,6 @@
 /**
  * Returns the exchange rate between two currencies.
  */
-declare const _default: ({ event: { data: { request }, }, }: any) => Promise<Response>;
+declare const _default: any;
 export default _default;
 //# sourceMappingURL=forex.d.ts.map

package/dist/types/src/templates/forex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"forex.d.ts","sourceRoot":"","sources":["../../../../src/templates/forex.ts"],"names":[],"mappings":"AAIA;;GAEG;6DAKA,GAAG;AAJN,wBAaE"}
+{"version":3,"file":"forex.d.ts","sourceRoot":"","sources":["../../../../src/templates/forex.ts"],"names":[],"mappings":"AAOA;;GAEG;;AACH,wBAkBG"}

package/dist/types/src/templates/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/templates/index.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,QAAQ,EA6B/B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/templates/index.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,QAAQ,EAkC/B,CAAC"}

package/dist/types/src/translations.d.ts

@@ -6,6 +6,8 @@ declare const _default: {
             'object title placeholder'?: undefined;
             'create object label'?: undefined;
             'create stack section label'?: undefined;
+            'description label'?: undefined;
+            'description placeholder'?: undefined;
             'binding placeholder'?: undefined;
             'function request placeholder'?: undefined;
             'deploy label'?: undefined;
@@ -42,6 +44,8 @@ declare const _default: {
             'object title placeholder': string;
             'create object label': string;
             'create stack section label': string;
+            'description label': string;
+            'description placeholder': string;
             'binding placeholder': string;
             'function request placeholder': string;
             'deploy label': string;
@@ -80,6 +84,8 @@ declare const _default: {
             'object title placeholder': string;
             'create object label': string;
             'create stack section label': string;
+            'description label': string;
+            'description placeholder': string;
             'binding placeholder': string;
             'function request placeholder': string;
             'deploy label': string;

package/dist/types/src/translations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/translations.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,wBA6CE"}
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../../src/translations.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,wBA+CE"}

package/dist/types/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"version":"5.7.2"}
+{"version":"5.7.3"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-script",
-  "version": "0.7.5-labs.a279d8c",
+  "version": "0.7.5-labs.ea4b4c2",
   "description": "Braneframe notebook plugin",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -53,38 +53,40 @@
     "prettier": "^3.2.4",
     "react-syntax-highlighter": "^15.5.0",
     "typescript": "^5.7.2",
-    "@dxos/app-framework": "0.7.5-labs.a279d8c",
-    "@dxos/async": "0.7.5-labs.a279d8c",
-    "@dxos/client": "0.7.5-labs.a279d8c",
-    "@dxos/client-protocol": "0.7.5-labs.a279d8c",
-    "@dxos/compute": "0.7.5-labs.a279d8c",
-    "@dxos/debug": "0.7.5-labs.a279d8c",
-    "@dxos/crypto": "0.7.5-labs.a279d8c",
-    "@dxos/echo-schema": "0.7.5-labs.a279d8c",
-    "@dxos/functions": "0.7.5-labs.a279d8c",
-    "@dxos/invariant": "0.7.5-labs.a279d8c",
-    "@dxos/live-object": "0.7.5-labs.a279d8c",
-    "@dxos/keys": "0.7.5-labs.a279d8c",
-    "@dxos/log": "0.7.5-labs.a279d8c",
-    "@dxos/plugin-client": "0.7.5-labs.a279d8c",
-    "@dxos/plugin-explorer": "0.7.5-labs.a279d8c",
-    "@dxos/plugin-graph": "0.7.5-labs.a279d8c",
-    "@dxos/plugin-markdown": "0.7.5-labs.a279d8c",
-    "@dxos/plugin-stack": "0.7.5-labs.a279d8c",
-    "@dxos/plugin-space": "0.7.5-labs.a279d8c",
-    "@dxos/plugin-theme": "0.7.5-labs.a279d8c",
-    "@dxos/react-client": "0.7.5-labs.a279d8c",
-    "@dxos/react-ui-attention": "0.7.5-labs.a279d8c",
-    "@dxos/react-ui-form": "0.7.5-labs.a279d8c",
-    "@dxos/react-ui-editor": "0.7.5-labs.a279d8c",
-    "@dxos/react-ui-menu": "0.7.5-labs.a279d8c",
-    "@dxos/protocols": "0.7.5-labs.a279d8c",
-    "@dxos/react-ui-stack": "0.7.5-labs.a279d8c",
-    "@dxos/react-ui-syntax-highlighter": "0.7.5-labs.a279d8c",
-    "@dxos/rpc": "0.7.5-labs.a279d8c",
-    "@dxos/rpc-tunnel": "0.7.5-labs.a279d8c",
-    "@dxos/schema": "0.7.5-labs.a279d8c",
-    "@dxos/util": "0.7.5-labs.a279d8c"
+    "@dxos/artifact": "0.7.5-labs.ea4b4c2",
+    "@dxos/app-framework": "0.7.5-labs.ea4b4c2",
+    "@dxos/assistant": "0.7.5-labs.ea4b4c2",
+    "@dxos/client": "0.7.5-labs.ea4b4c2",
+    "@dxos/async": "0.7.5-labs.ea4b4c2",
+    "@dxos/client-protocol": "0.7.5-labs.ea4b4c2",
+    "@dxos/compute": "0.7.5-labs.ea4b4c2",
+    "@dxos/debug": "0.7.5-labs.ea4b4c2",
+    "@dxos/echo-schema": "0.7.5-labs.ea4b4c2",
+    "@dxos/functions": "0.7.5-labs.ea4b4c2",
+    "@dxos/live-object": "0.7.5-labs.ea4b4c2",
+    "@dxos/keys": "0.7.5-labs.ea4b4c2",
+    "@dxos/invariant": "0.7.5-labs.ea4b4c2",
+    "@dxos/local-storage": "0.7.5-labs.ea4b4c2",
+    "@dxos/plugin-client": "0.7.5-labs.ea4b4c2",
+    "@dxos/plugin-explorer": "0.7.5-labs.ea4b4c2",
+    "@dxos/plugin-markdown": "0.7.5-labs.ea4b4c2",
+    "@dxos/plugin-graph": "0.7.5-labs.ea4b4c2",
+    "@dxos/log": "0.7.5-labs.ea4b4c2",
+    "@dxos/plugin-space": "0.7.5-labs.ea4b4c2",
+    "@dxos/plugin-stack": "0.7.5-labs.ea4b4c2",
+    "@dxos/protocols": "0.7.5-labs.ea4b4c2",
+    "@dxos/react-client": "0.7.5-labs.ea4b4c2",
+    "@dxos/react-ui-attention": "0.7.5-labs.ea4b4c2",
+    "@dxos/react-ui-editor": "0.7.5-labs.ea4b4c2",
+    "@dxos/react-ui-menu": "0.7.5-labs.ea4b4c2",
+    "@dxos/react-ui-stack": "0.7.5-labs.ea4b4c2",
+    "@dxos/react-ui-form": "0.7.5-labs.ea4b4c2",
+    "@dxos/rpc": "0.7.5-labs.ea4b4c2",
+    "@dxos/rpc-tunnel": "0.7.5-labs.ea4b4c2",
+    "@dxos/react-ui-syntax-highlighter": "0.7.5-labs.ea4b4c2",
+    "@dxos/plugin-theme": "0.7.5-labs.ea4b4c2",
+    "@dxos/schema": "0.7.5-labs.ea4b4c2",
+    "@dxos/util": "0.7.5-labs.ea4b4c2"
   },
   "devDependencies": {
     "@phosphor-icons/react": "^2.1.5",
@@ -94,19 +96,19 @@
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
     "vite": "5.4.7",
-    "@dxos/react-ui": "0.7.5-labs.a279d8c",
-    "@dxos/react-ui-mosaic": "0.7.5-labs.a279d8c",
-    "@dxos/react-ui-theme": "0.7.5-labs.a279d8c",
-    "@dxos/random": "0.7.5-labs.a279d8c",
-    "@dxos/storybook-utils": "0.7.5-labs.a279d8c"
+    "@dxos/react-ui": "0.7.5-labs.ea4b4c2",
+    "@dxos/random": "0.7.5-labs.ea4b4c2",
+    "@dxos/react-ui-mosaic": "0.7.5-labs.ea4b4c2",
+    "@dxos/react-ui-theme": "0.7.5-labs.ea4b4c2",
+    "@dxos/storybook-utils": "0.7.5-labs.ea4b4c2"
   },
   "peerDependencies": {
     "@phosphor-icons/react": "^2.1.5",
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.7.5-labs.a279d8c",
-    "@dxos/react-ui-mosaic": "0.7.5-labs.a279d8c",
-    "@dxos/react-ui-theme": "0.7.5-labs.a279d8c"
+    "@dxos/react-ui": "0.7.5-labs.ea4b4c2",
+    "@dxos/react-ui-mosaic": "0.7.5-labs.ea4b4c2",
+    "@dxos/react-ui-theme": "0.7.5-labs.ea4b4c2"
   },
   "publishConfig": {
     "access": "public"

package/src/ScriptPlugin.tsx

@@ -4,21 +4,13 @@
 
 // @ts-ignore
 
-import {
-  Capabilities,
-  contributes,
-  createIntent,
-  defineModule,
-  definePlugin,
-  Events,
-  oneOf,
-} from '@dxos/app-framework';
+import { Capabilities, contributes, createIntent, defineModule, definePlugin, Events } from '@dxos/app-framework';
 import { type Space } from '@dxos/client/echo';
 import { FunctionType, ScriptType } from '@dxos/functions';
 import { RefArray } from '@dxos/live-object';
 import { ClientCapabilities, ClientEvents } from '@dxos/plugin-client';
 
-import { Compiler, IntentResolver, ReactSurface, ScriptSettings } from './capabilities';
+import { Artifact, Compiler, IntentResolver, ReactSurface, ScriptSettings } from './capabilities';
 import { meta, SCRIPT_PLUGIN } from './meta';
 import translations from './translations';
 import { ScriptAction } from './types';
@@ -42,7 +34,7 @@ export const ScriptPlugin = () =>
     }),
     defineModule({
       id: `${meta.id}/module/metadata`,
-      activatesOn: oneOf(Events.Startup, Events.SetupAppGraph),
+      activatesOn: Events.SetupMetadata,
       activate: () =>
         contributes(Capabilities.Metadata, {
           id: ScriptType.typename,
@@ -59,7 +51,7 @@ export const ScriptPlugin = () =>
     }),
     defineModule({
       id: `${meta.id}/module/schema`,
-      activatesOn: ClientEvents.SetupClient,
+      activatesOn: ClientEvents.SetupSchema,
       activate: () => [
         contributes(ClientCapabilities.SystemSchema, [FunctionType]),
         contributes(ClientCapabilities.Schema, [ScriptType]),
@@ -67,7 +59,7 @@ export const ScriptPlugin = () =>
     }),
     defineModule({
       id: `${meta.id}/module/react-surface`,
-      activatesOn: Events.Startup,
+      activatesOn: Events.SetupSurfaces,
       activate: ReactSurface,
     }),
     defineModule({
@@ -75,4 +67,9 @@ export const ScriptPlugin = () =>
       activatesOn: Events.SetupIntents,
       activate: IntentResolver,
     }),
+    defineModule({
+      id: `${meta.id}/module/artifact`,
+      activatesOn: Events.Startup,
+      activate: Artifact,
+    }),
   ]);

package/src/capabilities/artifact.ts

@@ -0,0 +1,219 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Capabilities, contributes, createIntent, type PromiseIntentDispatcher } from '@dxos/app-framework';
+import { defineArtifact, defineTool, ToolResult } from '@dxos/artifact';
+import { createArtifactElement } from '@dxos/assistant';
+import { ObjectId, S } from '@dxos/echo-schema';
+import { ScriptType } from '@dxos/functions';
+import { invariant } from '@dxos/invariant';
+import { create, makeRef, type Space } from '@dxos/react-client/echo';
+import { TextType } from '@dxos/schema';
+import { SpaceAction } from '@dxos/plugin-space/types';
+
+// TODO(burdon): Factor out.
+declare global {
+  interface ToolContextExtensions {
+    space?: Space;
+    dispatch?: PromiseIntentDispatcher;
+  }
+}
+
+export default () => {
+  const definition = defineArtifact({
+    id: 'plugin-script',
+    // TODO(dmaretskyi): Since writing scripts requires a lot of domain knowledge,
+    //                   we should offload the work of synthesizing the code to a separate model.
+    //                   The main reasoning model will give it a concrete task and the script model will synthesize the code, knowing all the docs.
+    instructions: `
+      If the user explicitly requests you to write a script, you can create one.
+      If the user requests you to change one of the existing script, you can update it.
+      Scripts are short code pieces of executable code that can be used to perform computations, integrate with external systems, and perform automated tasks.
+      Each script must follow as strict shape for the definition but the body can contain any valid executable code.
+      Scripts are written in JavaScript or TypeScript.
+      Each script must define an input schema and output schema.
+      Each script must have its own detailed description.
+
+      Important: You cannot execute scripts. Scripts are only available as tools after the user deploys them. You must only call the available tools.
+
+      Description:
+        The description is a detailed description of the script.
+        It is used to describe the script's purpose, input, and output.
+        The description is used to generate the script's documentation.
+        The description is also goes into the script metadata.
+        The description is used by AI to understand the script and its purpose.
+        The description must provide cases on when the script should be used.
+
+      Schema: 
+        The schema is defined using a schema-DSL library called Effect Schema.
+        The input schema describes the arguments that the script accepts.
+        The output schema describes the result that the script produces.
+        The schema is used to validate the script's input and output.
+        The schema is also goes into the script metadata.
+        The properties in the schema must have valid descriptions.
+        The input and output schemas must both be a struct of fields.
+
+      Restricts:
+        The scripts can only import code from "dxos:functions" module. No other modules are allowed.
+        Some web APIs are available - like fetch.
+
+      Reasoning:
+        Before writing a script, synthesize the following information:
+        - Description
+        - What APIs will be used.
+        - Detailed input schema
+        - Detailed output schema
+
+      <apis>
+        export function defineFunction(params: { 
+          description: string, 
+          inputSchema: S.Schema, 
+          outputSchema: S.Schema, 
+          handler: (params: { event: { data: TInput } }) => Promise<TOutput> 
+        }): FunctionDefinition
+        /**
+         * Effect Schema
+         */
+        export const S; 
+
+        // Examples: 
+
+        S.String
+        S.Number
+        S.Boolean
+        S.Struct({
+          from: S.String.annotations({ description: 'The source currency' }),
+          to: S.String.annotations({ description: 'The target currency' }),
+        })
+        S.Array(S.String)
+        S.Union(S.String, S.Number)
+        S.optional(S.String)
+        S.String.annotations({ description: 'The source currency' })
+      </apis>
+
+      <handler_function>
+        Async function that takes the argument in the form of:
+
+        type HandlerFunctionParam = {
+          event: {
+            data: T // The input schema
+          },
+        }
+
+        The function must return the result that matches the output schema.
+      </handler_function>
+      
+      <example>
+        import { defineFunction, S } from 'dxos:functions';
+
+        export default defineFunction({
+          description: 'Returns the exchange rate between two currencies.',
+
+          inputSchema: S.Struct({
+            from: S.String.annotations({ description: 'The source currency' }),
+            to: S.String.annotations({ description: 'The target currency' }),
+          }),
+
+          outputSchema: S.Struct({
+            rate: S.String.annotations({ description: 'The exchange rate' }),
+          }),
+
+          handler: async ({
+            event: {
+              data: { from, to },
+            },
+          }: any) => {
+            const res = await fetch(\`https://free.ratesdb.com/v1/rates?from=\${from}&to=\${to}\`);
+            const {
+              data: { rates },
+            } = await res.json();
+
+            return { rate: rates[to].toString() };
+          },
+        });
+      </example>
+  `,
+    schema: ScriptType,
+    tools: [
+      defineTool({
+        name: 'script_new',
+        description: 'Create a new script. Returns the artifact definition for the script',
+        schema: S.Struct({
+          name: S.String.annotations({ description: 'The name of the script' }),
+          code: S.String.annotations({
+            description: 'The full code of the script in JavaScript or TypeScript. Must be valid executable code.',
+          }),
+        }),
+        execute: async ({ name, code }, { extensions }) => {
+          invariant(extensions?.space, 'No space');
+          invariant(extensions?.dispatch, 'No intent dispatcher');
+          const script = create(ScriptType, {
+            name,
+            source: makeRef(
+              create(TextType, {
+                content: code,
+              }),
+            ),
+          });
+          extensions.space.db.add(script);
+          await extensions.space.db.flush();
+
+          const intent = createIntent(SpaceAction.AddObject, { target: extensions.space, object: script });
+          const { data, error } = await extensions.dispatch(intent);
+          if (!data || error) {
+            return ToolResult.Error(error?.message ?? 'Failed to create chess game');
+          }
+
+          return ToolResult.Success(createArtifactElement(script.id));
+        },
+      }),
+      defineTool({
+        name: 'script_inspect',
+        description: 'Inspect a script. Returns the artifact definition for the script',
+        schema: S.Struct({
+          id: ObjectId,
+        }),
+        execute: async ({ id }, { extensions }) => {
+          invariant(extensions?.space, 'No space');
+
+          const script = (await extensions.space.db.query({ id }).first()) as ScriptType;
+          const { content } = await script.source.load();
+
+          return ToolResult.Success({
+            name: script.name,
+            code: content,
+          });
+        },
+      }),
+      defineTool({
+        name: 'script_update',
+        description: 'Update a script. Returns the artifact definition for the script',
+        schema: S.Struct({
+          id: ObjectId,
+          code: S.String.annotations({
+            description: 'The full code of the script in JavaScript or TypeScript. Must be valid executable code.',
+          }),
+        }),
+        execute: async ({ id, code }, { extensions }) => {
+          invariant(extensions?.space, 'No space');
+
+          const script = (await extensions.space.db.query({ id }).first()) as ScriptType;
+          const source = await script.source.load();
+          if (!source) {
+            return ToolResult.Error('Script not found');
+          }
+
+          source.content = code;
+          await extensions.space?.db.flush();
+
+          return ToolResult.Success({
+            name: script.name,
+          });
+        },
+      }),
+    ],
+  });
+
+  return contributes(Capabilities.ArtifactDefinition, definition);
+};

package/src/capabilities/compiler.ts

@@ -6,9 +6,9 @@
 import wasmUrl from 'esbuild-wasm/esbuild.wasm?url';
 
 import { contributes } from '@dxos/app-framework';
+import { initializeBundler } from '@dxos/functions/bundler';
 
 import { ScriptCapabilities } from './capabilities';
-import { initializeBundler } from '../bundler';
 import { Compiler } from '../compiler';
 
 export default async () => {

package/src/capabilities/index.ts

@@ -8,5 +8,6 @@ export const Compiler = lazy(() => import('./compiler'));
 export const IntentResolver = lazy(() => import('./intent-resolver'));
 export const ReactSurface = lazy(() => import('./react-surface'));
 export const ScriptSettings = lazy(() => import('./settings'));
+export const Artifact = lazy(() => import('./artifact'));
 
 export * from './capabilities';

package/src/capabilities/intent-resolver.ts

@@ -15,29 +15,32 @@ import { ScriptAction } from '../types';
 export default () =>
   contributes(
     Capabilities.IntentResolver,
-    createResolver(ScriptAction.Create, async ({ name, gistUrl, space }) => {
-      let content = templates[0].source;
-      const gistId = gistUrl?.split('/').at(-1);
-      if (gistId) {
-        // TODO(wittjosiah): Capability which contributes Octokit?
-        // NOTE: AccessToken not needed to read public gists.
-        const octokit = new Octokit();
-        const response = await octokit.request('GET /gists/{gist_id}', {
-          gist_id: gistId,
-        });
-        const gistContent = Object.values(response.data.files ?? {})[0]?.content;
-        if (gistContent) {
-          content = gistContent;
+    createResolver({
+      intent: ScriptAction.Create,
+      resolve: async ({ name, gistUrl }) => {
+        let content = templates[0].source;
+        const gistId = gistUrl?.split('/').at(-1);
+        if (gistId) {
+          // TODO(wittjosiah): Capability which contributes Octokit?
+          // NOTE: AccessToken not needed to read public gists.
+          const octokit = new Octokit();
+          const response = await octokit.request('GET /gists/{gist_id}', {
+            gist_id: gistId,
+          });
+          const gistContent = Object.values(response.data.files ?? {})[0]?.content;
+          if (gistContent) {
+            content = gistContent;
+          }
         }
-      }
 
-      return {
-        data: {
-          object: create(ScriptType, {
-            name,
-            source: makeRef(create(TextType, { content })),
-          }),
-        },
-      };
+        return {
+          data: {
+            object: create(ScriptType, {
+              name,
+              source: makeRef(create(TextType, { content })),
+            }),
+          },
+        };
+      },
     }),
   );

package/src/capabilities/react-surface.tsx

@@ -6,6 +6,7 @@ import React from 'react';
 
 import { Capabilities, contributes, createSurface, useCapability } from '@dxos/app-framework';
 import { ScriptType } from '@dxos/functions';
+import { SettingsStore } from '@dxos/local-storage';
 import { Clipboard } from '@dxos/react-ui';
 
 import { ScriptCapabilities } from './capabilities';
@@ -17,12 +18,10 @@ export default () =>
   contributes(Capabilities.ReactSurface, [
     createSurface({
       id: `${SCRIPT_PLUGIN}/settings`,
-      role: 'settings',
-      filter: (data): data is any => data.subject === SCRIPT_PLUGIN,
-      component: () => {
-        const settings = useCapability(Capabilities.SettingsStore).getStore<ScriptSettingsProps>(SCRIPT_PLUGIN)!.value;
-        return <ScriptSettings settings={settings} />;
-      },
+      role: 'article',
+      filter: (data): data is { subject: SettingsStore<ScriptSettingsProps> } =>
+        data.subject instanceof SettingsStore && data.subject.prefix === SCRIPT_PLUGIN,
+      component: ({ data: { subject } }) => <ScriptSettings settings={subject.value} />,
     }),
     createSurface({
       id: `${SCRIPT_PLUGIN}/article`,
@@ -30,14 +29,15 @@ export default () =>
       filter: (data): data is { subject: ScriptType } => data.subject instanceof ScriptType,
       component: ({ data, role }) => {
         const compiler = useCapability(ScriptCapabilities.Compiler);
-        const settings = useCapability(Capabilities.SettingsStore).getStore<ScriptSettingsProps>(SCRIPT_PLUGIN)!.value;
+        // TODO(dmaretskyi): Since settings store is not reactive, this would break on the script plugin being enabled without a page reload.
+        const settings = useCapability(Capabilities.SettingsStore).getStore<ScriptSettingsProps>(SCRIPT_PLUGIN)?.value;
         return <ScriptContainer role={role} script={data.subject} settings={settings} env={compiler.environment} />;
       },
     }),
     createSurface({
       id: `${SCRIPT_PLUGIN}/automation`,
       role: 'complementary--automation',
-      disposition: 'hoist',
+      position: 'hoist',
       filter: (data): data is { subject: ScriptType } => data.subject instanceof ScriptType,
       component: ({ data }) => <AutomationPanel subject={data.subject} />,
     }),

package/src/components/FrameContainer/FrameContainer.tsx

@@ -5,14 +5,13 @@
 import React, { useEffect, useRef } from 'react';
 
 import { clientServiceBundle } from '@dxos/client-protocol';
+import { type BundlerResult } from '@dxos/functions/bundler';
 import { log } from '@dxos/log';
 import { useClient } from '@dxos/react-client';
 import { baseSurface, mx } from '@dxos/react-ui-theme';
 import { createProtoRpcPeer } from '@dxos/rpc';
 import { createIFramePort } from '@dxos/rpc-tunnel';
 
-import { type BundlerResult } from '../../bundler';
-
 export type FrameContainerProps = {
   containerUrl: string;
   result: BundlerResult;