@dxos/plugin-script 0.9.0 → 0.9.1-staging.ee54ba693a

package/src/containers/ScriptProperties/FunctionPublishing.tsx

@@ -22,7 +22,7 @@ export type FunctionPublishingProps = { object: Script.Script };
 
 // TODO(burdon): Move to separate tab?
 export const FunctionPublishing = ({ object }: FunctionPublishingProps) => {
-  const { t } = useTranslation(meta.id);
+  const { t } = useTranslation(meta.profile.key);
   const { invokePromise } = useOperationInvoker();
   const db = Obj.getDatabase(object);
 
@@ -95,7 +95,7 @@ export const FunctionPublishing = ({ object }: FunctionPublishingProps) => {
 
   return (
     <div className='flex flex-col'>
-      <Form.Section label={t('script-publish-settings.label')} description={t('script-publish-settings.description')} />
+      <Form.Section title={t('script-publish-settings.label')} description={t('script-publish-settings.description')} />
 
       {!githubToken && (
         <div className='flex flex-col py-form-gap'>

package/src/containers/ScriptProperties/ScriptProperties.stories.tsx

@@ -7,7 +7,7 @@ import * as Effect from 'effect/Effect';
 import React from 'react';
 
 import { withPluginManager } from '@dxos/app-framework/testing';
-import { Blueprint } from '@dxos/compute';
+import { Skill } from '@dxos/compute';
 import { Script } from '@dxos/compute';
 import { Operation } from '@dxos/compute';
 import { Filter } from '@dxos/echo';
@@ -24,9 +24,9 @@ import { translations } from '#translations';
 
 import { ScriptProperties } from './ScriptProperties';
 
-type DefaultStoryProps = {};
+type StoryArgs = {};
 
-const DefaultStory = (_: DefaultStoryProps) => {
+const DefaultStory = (_: StoryArgs) => {
   const [space] = useSpaces();
   const [script] = useQuery(space?.db, Filter.type(Script.Script));
   if (!script) {
@@ -50,7 +50,7 @@ const meta = {
       plugins: [
         ...corePlugins(),
         ClientPlugin({
-          types: [Script.Script, Operation.PersistentOperation, Blueprint.Blueprint, Text.Text],
+          types: [Script.Script, Operation.PersistentOperation, Skill.Skill, Text.Text],
           onClientInitialized: ({ client }) =>
             Effect.gen(function* () {
               yield* initializeIdentity(client);
@@ -67,7 +67,7 @@ const meta = {
     layout: 'fullscreen',
     translations,
   },
-} satisfies Meta<DefaultStoryProps>;
+} satisfies Meta<StoryArgs>;
 
 export default meta;
 

package/src/containers/ScriptProperties/ScriptProperties.tsx

@@ -6,19 +6,26 @@ import React from 'react';
 
 import { type AppSurface } from '@dxos/app-toolkit/ui';
 import { type Script } from '@dxos/compute';
+import { Form } from '@dxos/react-ui-form';
 
-import { BlueprintEditor } from './BlueprintEditor';
 import { FunctionBinding } from './FunctionBinding';
 import { FunctionPublishing } from './FunctionPublishing';
+import { SkillEditor } from './SkillEditor';
 
 export type ScriptPropertiesProps = AppSurface.ObjectPropertiesProps<Script.Script>;
 
 export const ScriptProperties = ({ subject: object }: ScriptPropertiesProps) => {
   return (
-    <div className='flex flex-col py-form-gap gap-form-section-gap'>
-      <FunctionBinding object={object} />
-      <BlueprintEditor object={object} />
-      <FunctionPublishing object={object} />
-    </div>
+    <>
+      <Form.Section>
+        <FunctionBinding object={object} />
+      </Form.Section>
+      <Form.Section>
+        <SkillEditor object={object} />
+      </Form.Section>
+      <Form.Section>
+        <FunctionPublishing object={object} />
+      </Form.Section>
+    </>
   );
 };

package/src/containers/ScriptProperties/{BlueprintEditor.tsx → SkillEditor.tsx}

@@ -5,7 +5,7 @@
 import React, { useCallback, useState } from 'react';
 
 import { ToolId } from '@dxos/ai';
-import { Blueprint, Template } from '@dxos/compute';
+import { Skill, Template } from '@dxos/compute';
 import { type Script } from '@dxos/compute';
 import { Operation } from '@dxos/compute';
 import { Filter, Obj, Ref } from '@dxos/echo';
@@ -16,29 +16,29 @@ import { kebabize } from '@dxos/util';
 
 import { meta } from '#meta';
 
-export type BlueprintEditorProps = { object: Script.Script };
+export type SkillEditorProps = { object: Script.Script };
 
-export const BlueprintEditor = ({ object }: BlueprintEditorProps) => {
-  const { t } = useTranslation(meta.id);
+export const SkillEditor = ({ object }: SkillEditorProps) => {
+  const { t } = useTranslation(meta.profile.key);
   const db = Obj.getDatabase(object);
   const [fn] = useQuery(db, Filter.type(Operation.PersistentOperation, { source: Ref.make(object) }));
-  const blueprints = useQuery(db, Filter.type(Blueprint.Blueprint));
+  const skills = useQuery(db, Filter.type(Skill.Skill));
 
   const [creating, setCreating] = useState(false);
   // TODO(burdon): Remove?
   const [instructions, setInstructions] = useState<string>(`You can run the script "${object.name ?? 'script'}".`);
-  const blueprintKey = `org.dxos.blueprint.${kebabize(object.name ?? 'script')}`;
-  const existingBlueprint = blueprints.find((bp) => Obj.getMeta(bp).key === blueprintKey);
+  const skillKey = `org.dxos.skill.${kebabize(object.name ?? 'script')}`;
+  const existingSkill = skills.find((bp) => Obj.getMeta(bp).key === skillKey);
   const fnKey = fn ? Obj.getMeta(fn).key : undefined;
 
   useAsyncEffect(async () => {
-    if (!existingBlueprint) {
+    if (!existingSkill) {
       return;
     }
 
-    const source = await existingBlueprint.instructions.source.load();
+    const source = await existingSkill.instructions.source.load();
     setInstructions(source.content ?? '');
-  }, [existingBlueprint]);
+  }, [existingSkill]);
 
   const handleSave = useCallback(async () => {
     if (!db) {
@@ -47,24 +47,24 @@ export const BlueprintEditor = ({ object }: BlueprintEditorProps) => {
 
     setCreating(true);
     try {
-      if (existingBlueprint) {
-        const text = await existingBlueprint.instructions.source.load();
+      if (existingSkill) {
+        const text = await existingSkill.instructions.source.load();
         Obj.update(text, (text) => {
           text.content = instructions;
         });
 
         if (fnKey) {
           const toolId = ToolId.make(fnKey);
-          if (!existingBlueprint.tools?.includes(toolId)) {
-            Obj.update(existingBlueprint, (existingBlueprint) => {
-              existingBlueprint.tools = [...(existingBlueprint.tools ?? []), toolId];
+          if (!existingSkill.tools?.includes(toolId)) {
+            Obj.update(existingSkill, (existingSkill) => {
+              existingSkill.tools = [...(existingSkill.tools ?? []), toolId];
             });
           }
         }
       } else if (fnKey) {
         db.add(
-          Blueprint.make({
-            key: blueprintKey,
+          Skill.make({
+            key: skillKey,
             name: object.name ?? 'Script',
             instructions: Template.make({ source: instructions }),
             tools: [ToolId.make(fnKey)],
@@ -75,16 +75,16 @@ export const BlueprintEditor = ({ object }: BlueprintEditorProps) => {
     } finally {
       setCreating(false);
     }
-  }, [db, existingBlueprint, fnKey, blueprintKey, object.name, instructions]);
+  }, [db, existingSkill, fnKey, skillKey, object.name, instructions]);
 
   return (
     <div className='flex flex-col'>
-      <Form.Section label={t('blueprint-editor.label')} description={t('blueprint-editor.description')} />
+      <Form.Section title={t('skill-editor.label')} description={t('skill-editor.description')} />
 
       <Input.Root>
-        <Input.Label>{t('blueprint-instructions.label')}</Input.Label>
+        <Input.Label>{t('skill-instructions.label')}</Input.Label>
         <Input.TextArea
-          placeholder={t('blueprint-instructions.placeholder')}
+          placeholder={t('skill-instructions.placeholder')}
           rows={6}
           value={instructions}
           onChange={(event) => setInstructions(event.target.value)}
@@ -93,8 +93,8 @@ export const BlueprintEditor = ({ object }: BlueprintEditorProps) => {
       </Input.Root>
 
       <div className='pt-2'>
-        <Button disabled={(!existingBlueprint && !fnKey) || creating} onClick={handleSave}>
-          {t(existingBlueprint ? 'update-blueprint.label' : 'create-blueprint.label')}
+        <Button disabled={(!existingSkill && !fnKey) || creating} onClick={handleSave}>
+          {t(existingSkill ? 'update-skill.label' : 'create-skill.label')}
         </Button>
       </div>
     </div>

package/src/{components/ScriptPluginSettings/ScriptPluginSettings.stories.tsx → containers/ScriptSettings/ScriptSettings.stories.tsx}

@@ -8,18 +8,18 @@ import { withLayout, withTheme } from '@dxos/react-ui/testing';
 
 import { translations } from '#translations';
 
-import { ScriptPluginSettings } from './ScriptPluginSettings';
+import { ScriptSettings } from './ScriptSettings';
 
 const meta = {
-  title: 'plugins/plugin-script/components/ScriptPluginSettings',
-  component: ScriptPluginSettings,
+  title: 'plugins/plugin-script/containers/ScriptSettings',
+  component: ScriptSettings,
   tags: ['settings'],
   decorators: [withTheme(), withLayout({ layout: 'fullscreen' })],
   parameters: {
     layout: 'fullscreen',
     translations,
   },
-} satisfies Meta<typeof ScriptPluginSettings>;
+} satisfies Meta<typeof ScriptSettings>;
 
 export default meta;
 

package/src/containers/ScriptSettings/ScriptSettings.tsx

@@ -0,0 +1,47 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import React from 'react';
+
+import { type AppSurface } from '@dxos/app-toolkit/ui';
+import { Button, useTranslation } from '@dxos/react-ui';
+import { Form } from '@dxos/react-ui-form';
+
+import { meta } from '#meta';
+import { Settings } from '#types';
+
+export type ScriptSettingsProps = AppSurface.SettingsProps<
+  Settings.Settings,
+  {
+    onAuthenticate?: () => void;
+  }
+>;
+
+export const ScriptSettings = ({ settings, onSettingsChange, onAuthenticate }: ScriptSettingsProps) => {
+  const { t } = useTranslation(meta.profile.key);
+
+  return (
+    <Form.Root
+      schema={Settings.Settings}
+      values={settings}
+      variant='settings'
+      readonly={!onSettingsChange}
+      onValuesChanged={(values) => onSettingsChange?.((current) => ({ ...current, ...values }))}
+    >
+      <Form.Viewport scroll>
+        <Form.Content>
+          <Form.Section title={meta.profile.name ?? meta.profile.key}>
+            {/* TODO(wittjosiah): Hide outside of dev environments. */}
+            <Form.Row label={t('authenticate-action.label')} description={t('authenticate-action.description')}>
+              <Button disabled={!onSettingsChange} onClick={onAuthenticate}>
+                {t('authenticate-button.label')}
+              </Button>
+            </Form.Row>
+            <Form.FieldSet />
+          </Form.Section>
+        </Form.Content>
+      </Form.Viewport>
+    </Form.Root>
+  );
+};

package/src/containers/ScriptSettings/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+export { ScriptSettings as default } from './ScriptSettings';

package/src/containers/index.ts

@@ -8,4 +8,5 @@ export const DeploymentDialog: ComponentType<any> = lazy(() => import('./Deploym
 export const NotebookArticle: ComponentType<any> = lazy(() => import('./NotebookArticle'));
 export const ScriptArticle: ComponentType<any> = lazy(() => import('./ScriptArticle'));
 export const ScriptProperties: ComponentType<any> = lazy(() => import('./ScriptProperties'));
+export const ScriptSettings: ComponentType<any> = lazy(() => import('./ScriptSettings'));
 export const TestContainer: ComponentType<any> = lazy(() => import('./TestContainer'));

package/src/e2e/ai.test.ts

@@ -12,6 +12,7 @@ import { configPreset } from '@dxos/config';
 import { Context } from '@dxos/context';
 import { FunctionsServiceClient } from '@dxos/functions-runtime/edge';
 import { bundleFunction } from '@dxos/functions-runtime/native';
+import { failedInvariant } from '@dxos/invariant';
 import { FunctionRuntimeKind } from '@dxos/protocols';
 import { EdgeReplicationSetting } from '@dxos/protocols/proto/dxos/echo/metadata';
 
@@ -27,11 +28,11 @@ describe.skip('Function', { tags: ['functions-e2e'] }, () => {
   });
 
   test('deploy empty function', { timeout: 120_000 }, async () => {
-    const { space, functionsServiceClient } = await setup();
+    const { space, functionsServiceClient, ownerUri } = await setup();
 
     await sync(space);
     const func = await deployFunction(
-      space,
+      ownerUri,
       functionsServiceClient,
       new URL('../templates/ping.ts', import.meta.url).pathname,
     );
@@ -40,10 +41,10 @@ describe.skip('Function', { tags: ['functions-e2e'] }, () => {
   });
 
   test('deploy and invoke anthropic function', { timeout: 120_000 }, async () => {
-    const { space, functionsServiceClient } = await setup();
+    const { space, functionsServiceClient, ownerUri } = await setup();
     await sync(space);
     const func = await deployFunction(
-      space,
+      ownerUri,
       functionsServiceClient,
       new URL('../templates/anthropic.ts', import.meta.url).pathname,
     );
@@ -57,13 +58,14 @@ describe.skip('Function', { tags: ['functions-e2e'] }, () => {
   const setup = async () => {
     const client = await new Client({ config, types: [Operation.PersistentOperation] }).initialize();
     await client.halo.createIdentity();
+    const ownerUri = client.halo.identity.get()?.did ?? failedInvariant('identity not created');
 
     const space = await client.spaces.create();
     await space.waitUntilReady();
     await space.internal.setEdgeReplicationPreference(EdgeReplicationSetting.ENABLED);
 
     const functionsServiceClient = FunctionsServiceClient.fromClient(client);
-    return { client, space, functionsServiceClient };
+    return { client, space, functionsServiceClient, ownerUri };
   };
 
   const sync = async (space: Space) => {
@@ -74,20 +76,21 @@ describe.skip('Function', { tags: ['functions-e2e'] }, () => {
     });
   };
 
-  const deployFunction = async (space: Space, functionsServiceClient: FunctionsServiceClient, entryPoint: string) => {
+  const deployFunction = async (
+    ownerUri: string,
+    functionsServiceClient: FunctionsServiceClient,
+    entryPoint: string,
+  ) => {
     const artifact = await bundleFunction({
       entryPoint,
       verbose: true,
     });
-    const func = await functionsServiceClient.deploy(Context.default(), {
+    return functionsServiceClient.deploy(Context.default(), {
       version: '0.0.1',
-      ownerPublicKey: space.key,
+      ownerUri,
       entryPoint: artifact.entryPoint,
       assets: artifact.assets,
       runtime: FunctionRuntimeKind.enums.WORKER_LOADER,
     });
-
-    space.db.add(func);
-    return func;
   };
 });

package/src/e2e/deploy.test.ts

@@ -44,8 +44,12 @@ describe.skip('Functions deployment', { tags: ['functions-e2e'] }, () => {
     }
     const functionsServiceClient = FunctionsServiceClient.fromClient(client);
 
+    const identity = client.halo.identity.get();
+    if (!identity) {
+      throw new Error('Identity not available.');
+    }
     const func = await functionsServiceClient.deploy(Context.default(), {
-      ownerPublicKey: space.key,
+      ownerUri: identity.did,
       version: '0.0.1',
       entryPoint: buildResult.entryPoint,
       assets: buildResult.assets,

package/src/hooks/deploy.ts

@@ -4,7 +4,7 @@
 
 import { useEffect, useMemo } from 'react';
 
-import { Script, Operation } from '@dxos/compute';
+import { Operation, Script } from '@dxos/compute';
 import { Obj, Query, Ref } from '@dxos/echo';
 import { getUserFunctionIdInMetadata } from '@dxos/functions';
 import { log } from '@dxos/log';
@@ -44,7 +44,7 @@ export const createDeploy = ({ state, script, space, fn, client, existingFunctio
 
   // TODO(wittjosiah): Should this be an action?
   const errorItem = createMenuAction('error', () => {}, {
-    label: value.error ?? ['no-error.label', { ns: meta.id }],
+    label: value.error ?? ['no-error.label', { ns: meta.profile.key }],
     icon: 'ph--warning-circle--regular',
     hidden: !value.error,
     classNames: value.error && messageValence('error'),
@@ -71,7 +71,7 @@ export const createDeploy = ({ state, script, space, fn, client, existingFunctio
     },
     {
       type: 'deploy',
-      label: [value.deploying ? 'publishing.label' : 'deploy.label', { ns: meta.id }],
+      label: [value.deploying ? 'publishing.label' : 'deploy.label', { ns: meta.profile.key }],
       icon: value.deploying ? 'ph--spinner-gap--regular' : 'ph--cloud-arrow-up--regular',
       disabled: value.deploying,
       classNames: value.deploying ? '[&_svg]:animate-spin' : '',
@@ -87,7 +87,7 @@ export const createDeploy = ({ state, script, space, fn, client, existingFunctio
     },
     {
       type: 'copy',
-      label: ['copy-link.label', { ns: meta.id }],
+      label: ['copy-link.label', { ns: meta.profile.key }],
       icon: 'ph--link--regular',
       disabled: !value.functionUrl,
     },

package/src/hooks/format.ts

@@ -39,7 +39,7 @@ export const createFormat = (script: Script.Script) => {
       }
     },
     {
-      label: ['format.label', { ns: meta.id }],
+      label: ['format.label', { ns: meta.profile.key }],
       icon: 'ph--magic-wand--regular',
     },
   );

package/src/index.ts

@@ -2,7 +2,7 @@
 // Copyright 2023 DXOS.org
 //
 
-export * from './blueprints';
+export * from './skills';
 export * from './meta';
 export * from './types';
 export * from './util';

package/src/meta.ts

@@ -4,26 +4,10 @@
 
 import { Plugin } from '@dxos/app-framework';
 import { DXN } from '@dxos/keys';
-import { trim } from '@dxos/util';
 
-export const meta = Plugin.makeMeta({
-  key: DXN.make('org.dxos.plugin.script'),
-  name: 'Scripts',
-  author: 'DXOS',
-  spec: 'PLUGIN.mdl',
-  description: trim`
-    Write, deploy, and run custom TypeScript functions as ECHO objects directly inside your Composer spaces.
-    Scripts execute on the Cloudflare Workers-based EDGE runtime and have access to the full DXOS SDK,
-    Effect-TS, and a curated set of third-party libraries including HTTP, JSON, CSV, and date utilities.
-    An AI Script assistant wires CRUD, deploy, invoke, and invocation-inspection operations as tools
-    so an agent can scaffold, iterate, and test functions entirely within a chat session.
-  `,
-  icon: 'ph--code--regular',
-  iconHue: 'sky',
-  source: 'https://github.com/dxos/dxos/tree/main/packages/plugins/plugin-explorer',
-  tags: ['labs'],
-  screenshots: ['https://dxos.network/plugin-details-scripts-dark.png'],
-});
+import config from '../dx.config';
+
+export const meta = Plugin.getMetaFromConfig(config);
 
 // TODO(ZaymonFC): Configure by scopes?
 export const defaultScriptsForIntegration: Record<string, string[]> = {

package/src/operations/create-script.ts

@@ -5,7 +5,7 @@
 import { Octokit } from '@octokit/core';
 import * as Effect from 'effect/Effect';
 
-import { Script, Operation } from '@dxos/compute';
+import { Operation, Script } from '@dxos/compute';
 
 import { templates } from '../templates';
 import { ScriptOperation } from '../types';

package/src/{blueprints → skills}/functions/create.ts

@@ -5,7 +5,7 @@
 import * as Effect from 'effect/Effect';
 
 import { CollectionModel } from '@dxos/app-toolkit';
-import { Script, Operation } from '@dxos/compute';
+import { Operation, Script } from '@dxos/compute';
 import { Database, Obj, Ref } from '@dxos/echo';
 
 import { Create } from './definitions';

package/src/{blueprints → skills}/functions/definitions.ts

@@ -6,7 +6,7 @@ import * as Schema from 'effect/Schema';
 
 import { ClientService } from '@dxos/client';
 import { Operation } from '@dxos/compute';
-import { Database, Feed, Ref, DXN } from '@dxos/echo';
+import { Database, DXN, Ref } from '@dxos/echo';
 import { trim } from '@dxos/util';
 
 const FunctionRef = Ref.Ref(Operation.PersistentOperation).annotations({
@@ -136,6 +136,8 @@ export const Read = Operation.make({
   services: [Database.Service],
 });
 
+// The edit descriptions feed the script skill's LLM tool definition (and its memoized
+// fixtures), so the schema stays local and context-tuned; the apply logic is shared via `Doc.applyEdits`.
 const Edit = Schema.Struct({
   oldString: Schema.String.annotations({
     description: 'The text to find in the source.',
@@ -269,7 +271,7 @@ export const InspectInvocations = Operation.make({
       description: 'Total number of invocations found.',
     }),
   }),
-  services: [Database.Service, Feed.FeedService],
+  services: [Database.Service],
 });
 
 const DeployedFunctionSchema = Schema.Struct({

package/src/{blueprints → skills}/functions/deploy.ts

@@ -6,7 +6,7 @@ import * as Effect from 'effect/Effect';
 import wasmUrl from 'esbuild-wasm/esbuild.wasm?url';
 
 import { ClientService } from '@dxos/client';
-import { Script, Operation } from '@dxos/compute';
+import { Operation, Script } from '@dxos/compute';
 import { Context } from '@dxos/context';
 import { Database, Obj } from '@dxos/echo';
 import { getUserFunctionIdInMetadata } from '@dxos/functions';
@@ -41,10 +41,15 @@ export default Deploy.pipe(
       const existingFunctionId = getUserFunctionIdInMetadata(Obj.getMeta(loaded));
       const currentVersion = Obj.getMeta(loaded).version;
 
+      const identity = client.halo.identity.get();
+      if (!identity) {
+        return yield* Effect.fail(new Error('Identity not available.'));
+      }
+
       const functionsService = FunctionsServiceClient.fromClient(client);
       const newFunction = yield* Effect.promise(() =>
         functionsService.deploy(Context.default(), {
-          ownerPublicKey: space.key,
+          ownerUri: identity.did,
           version: currentVersion ? incrementSemverPatch(currentVersion) : '0.0.1',
           functionId: existingFunctionId,
           entryPoint: buildResult.entryPoint,

package/src/{blueprints → skills}/functions/inspect-invocations.ts

@@ -24,8 +24,8 @@ export default InspectInvocations.pipe(
       }
 
       const feed = yield* Database.load(properties.invocationTraceFeed);
-      const startEvents = yield* Feed.runQuery(feed, Filter.type(InvocationTraceStartEvent));
-      const endEvents = yield* Feed.runQuery(feed, Filter.type(InvocationTraceEndEvent));
+      const startEvents = yield* Feed.query(feed, Filter.type(InvocationTraceStartEvent)).run;
+      const endEvents = yield* Feed.query(feed, Filter.type(InvocationTraceEndEvent)).run;
       const allSpans = createInvocationSpans([...startEvents, ...endEvents]);
 
       const functionId = getUserFunctionIdInMetadata(Obj.getMeta(loaded));

package/src/{blueprints → skills}/functions/read.ts

@@ -4,7 +4,7 @@
 
 import * as Effect from 'effect/Effect';
 
-import { type Script, Operation } from '@dxos/compute';
+import { Operation, type Script } from '@dxos/compute';
 import { Database } from '@dxos/echo';
 
 import { Read } from './definitions';

package/src/skills/functions/update.ts

@@ -0,0 +1,48 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import * as Effect from 'effect/Effect';
+
+import { Operation, type Script } from '@dxos/compute';
+import { Database, Obj } from '@dxos/echo';
+import { Doc, applyEdits } from '@dxos/echo-doc';
+
+import { Update } from './definitions';
+
+export default Update.pipe(
+  Operation.withHandler(
+    Effect.fn(function* ({ function: fn, name, description, edits }) {
+      const loaded = yield* Database.load(fn);
+      if (!loaded.source) {
+        return yield* Effect.fail(new Error('Function has no source script.'));
+      }
+
+      const script = (yield* Database.load(loaded.source)) as Script.Script;
+      if (name !== undefined || description !== undefined) {
+        Obj.update(script, (script) => {
+          if (name !== undefined) {
+            script.name = name;
+          }
+          if (description !== undefined) {
+            script.description = description;
+          }
+        });
+      }
+
+      if (edits && edits.length > 0) {
+        const text = yield* Database.load(script.source);
+        const accessor = Doc.createAccessor(text, ['content']);
+        applyEdits(accessor, edits);
+
+        Obj.update(script, (script) => {
+          script.changed = true;
+        });
+      }
+
+      return {
+        function: Obj.getURI(loaded),
+      };
+    }),
+  ),
+);

package/src/skills/index.ts

@@ -0,0 +1,5 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+export { default as ScriptSkill } from './script-skill';