@dxos/plugin-space 0.8.1-main.ba2dec9 → 0.8.1-staging.391c573

package/dist/lib/node-esm/schema-tools-KJVXGDBO.mjs

@@ -0,0 +1,125 @@
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
+
+// packages/plugins/plugin-space/src/capabilities/schema-tools.ts
+import { DescriptionAnnotationId, ExamplesAnnotationId, TitleAnnotationId } from "effect/SchemaAST";
+import { Capabilities, contributes } from "@dxos/app-framework";
+import { defineTool, ToolResult } from "@dxos/artifact";
+import { FormatEnum, FormatEnums, S, SelectOptionSchema, GeoPoint, toJsonSchema } from "@dxos/echo-schema";
+import { invariant } from "@dxos/invariant";
+import { hues } from "@dxos/react-ui-theme";
+import { echoSchemaFromPropertyDefinitions } from "@dxos/schema";
+var __dxlog_file = "/home/runner/work/dxos/dxos/packages/plugins/plugin-space/src/capabilities/schema-tools.ts";
+var TypeNameSchema = S.String.pipe(S.pattern(/^\w+\.\w{2,}\/[\w/]+$/i), S.annotations({
+  [TitleAnnotationId]: "TypeName",
+  [DescriptionAnnotationId]: "Domain-style type name path. Dashes are not allowed. Use camel case for the final component of the type name.",
+  [ExamplesAnnotationId]: [
+    "example.com/type/Document",
+    "example.com/type/FlightList"
+  ]
+}));
+var formatDescription = `The format of the property. Additional information:
+  ${FormatEnum.GeoPoint}: ${JSON.stringify(toJsonSchema(GeoPoint))}
+  This tuple is GeoJSON. You must specify \`${FormatEnum.GeoPoint}\` as [Longitude, Latitude]`;
+var PropertyDefinitionSchema = S.Struct({
+  name: S.String.annotations({
+    [DescriptionAnnotationId]: "The name of the property."
+  }),
+  format: S.Union(...FormatEnums.map((format) => S.Literal(format))).annotations({
+    [DescriptionAnnotationId]: formatDescription
+  }),
+  config: S.optional(S.Struct({
+    options: S.optional(S.Array(SelectOptionSchema).annotations({
+      description: `Options for SingleSelect/MultiSelect formats. Available colors: ${hues.join(", ")}`
+    }).pipe(S.mutable))
+  }))
+}).pipe(S.mutable);
+var SYSTEM_NAMESPACE = "dxos.org/echo/schema";
+var schema_tools_default = () => contributes(Capabilities.Tools, [
+  defineTool(SYSTEM_NAMESPACE, {
+    name: "list",
+    description: "List registered schemas in the space.",
+    caption: "Listing registered schemas...",
+    schema: S.Struct({}),
+    execute: async (_input, { extensions }) => {
+      invariant(extensions?.space, "No space.", {
+        F: __dxlog_file,
+        L: 67,
+        S: void 0,
+        A: [
+          "extensions?.space",
+          "'No space.'"
+        ]
+      });
+      const space = extensions.space;
+      const schemas = await space.db.schemaRegistry.query({}).run();
+      return ToolResult.Success(schemas.map((schema) => ({
+        typename: schema.typename,
+        version: schema.version
+      })));
+    }
+  }),
+  defineTool(SYSTEM_NAMESPACE, {
+    name: "get",
+    description: "Get a specific schema by its typename.",
+    caption: "Getting schema...",
+    schema: S.Struct({
+      typename: S.String.annotations({
+        description: "The fully qualified typename of the schema."
+      })
+    }),
+    execute: async ({ typename }, { extensions }) => {
+      invariant(extensions?.space, "No space.", {
+        F: __dxlog_file,
+        L: 89,
+        S: void 0,
+        A: [
+          "extensions?.space",
+          "'No space.'"
+        ]
+      });
+      const space = extensions.space;
+      const schema = await space.db.schemaRegistry.query({
+        typename
+      }).firstOrUndefined();
+      if (!schema) {
+        return ToolResult.Error(`Schema not found: ${typename}`);
+      }
+      return ToolResult.Success(schema);
+    }
+  }),
+  defineTool(SYSTEM_NAMESPACE, {
+    name: "create",
+    description: "Create a new schema with the provided definition.",
+    caption: "Creating schema...",
+    schema: S.Struct({
+      typename: TypeNameSchema.annotations({
+        description: 'The fully qualified schema typename. Must start with a domain, and then one or more path components (e.g., "example.com/type/TypeName").'
+      }),
+      properties: S.Array(PropertyDefinitionSchema).pipe(S.annotations({
+        description: "Array of property definitions for the schema."
+      }), S.mutable)
+    }),
+    execute: async ({ typename, properties }, { extensions }) => {
+      invariant(extensions?.space, "No space.", {
+        F: __dxlog_file,
+        L: 115,
+        S: void 0,
+        A: [
+          "extensions?.space",
+          "'No space.'"
+        ]
+      });
+      const space = extensions.space;
+      const schema = echoSchemaFromPropertyDefinitions(typename, properties);
+      const [registeredSchema] = await space.db.schemaRegistry.register([
+        schema
+      ]);
+      return ToolResult.Success(registeredSchema);
+    }
+  })
+]);
+export {
+  TypeNameSchema,
+  schema_tools_default as default
+};
+//# sourceMappingURL=schema-tools-KJVXGDBO.mjs.map

package/dist/lib/node-esm/schema-tools-KJVXGDBO.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/capabilities/schema-tools.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport { DescriptionAnnotationId, ExamplesAnnotationId, TitleAnnotationId } from 'effect/SchemaAST';\n\nimport { Capabilities, contributes, type PromiseIntentDispatcher } from '@dxos/app-framework';\nimport { defineTool, ToolResult } from '@dxos/artifact';\nimport { type Space } from '@dxos/client/echo';\nimport { FormatEnum, FormatEnums, S, SelectOptionSchema, GeoPoint, toJsonSchema } from '@dxos/echo-schema';\nimport { invariant } from '@dxos/invariant';\nimport { hues } from '@dxos/react-ui-theme';\nimport { echoSchemaFromPropertyDefinitions } from '@dxos/schema';\n\n// TODO(burdon): Factor out.\ndeclare global {\n  interface ToolContextExtensions {\n    space?: Space;\n    dispatch?: PromiseIntentDispatcher;\n  }\n}\n\n// TODO(ZaymonFC): Move this somewhere common.\nexport const TypeNameSchema = S.String.pipe(\n  S.pattern(/^\\w+\\.\\w{2,}\\/[\\w/]+$/i),\n  S.annotations({\n    [TitleAnnotationId]: 'TypeName',\n    [DescriptionAnnotationId]:\n      'Domain-style type name path. Dashes are not allowed. Use camel case for the final component of the type name.',\n    [ExamplesAnnotationId]: ['example.com/type/Document', 'example.com/type/FlightList'],\n  }),\n);\n\nconst formatDescription = `The format of the property. Additional information:\n  ${FormatEnum.GeoPoint}: ${JSON.stringify(toJsonSchema(GeoPoint))}\n  This tuple is GeoJSON. You must specify \\`${FormatEnum.GeoPoint}\\` as [Longitude, Latitude]`;\n\n// TODO(ZaymonFC): All properties are default optional, but maybe we should allow for required properties.\nconst PropertyDefinitionSchema = S.Struct({\n  name: S.String.annotations({ [DescriptionAnnotationId]: 'The name of the property.' }),\n  format: S.Union(...FormatEnums.map((format) => S.Literal(format))).annotations({\n    [DescriptionAnnotationId]: formatDescription,\n  }),\n  config: S.optional(\n    S.Struct({\n      options: S.optional(\n        S.Array(SelectOptionSchema)\n          .annotations({\n            description: `Options for SingleSelect/MultiSelect formats. Available colors: ${hues.join(', ')}`,\n          })\n          .pipe(S.mutable),\n      ),\n    }),\n  ),\n}).pipe(S.mutable);\n\nconst SYSTEM_NAMESPACE = 'dxos.org/echo/schema';\n\nexport default () =>\n  contributes(Capabilities.Tools, [\n    defineTool(SYSTEM_NAMESPACE, {\n      name: 'list',\n      description: 'List registered schemas in the space.',\n      caption: 'Listing registered schemas...',\n      schema: S.Struct({}),\n      execute: async (_input, { extensions }) => {\n        invariant(extensions?.space, 'No space.');\n        const space = extensions.space;\n\n        const schemas = await space.db.schemaRegistry.query({}).run();\n        return ToolResult.Success(\n          schemas.map((schema) => ({\n            typename: schema.typename,\n            version: schema.version,\n          })),\n        );\n      },\n    }),\n    defineTool(SYSTEM_NAMESPACE, {\n      name: 'get',\n      description: 'Get a specific schema by its typename.',\n      caption: 'Getting schema...',\n      schema: S.Struct({\n        typename: S.String.annotations({\n          description: 'The fully qualified typename of the schema.',\n        }),\n      }),\n      execute: async ({ typename }, { extensions }) => {\n        invariant(extensions?.space, 'No space.');\n        const space = extensions.space;\n\n        const schema = await space.db.schemaRegistry.query({ typename }).firstOrUndefined();\n        if (!schema) {\n          return ToolResult.Error(`Schema not found: ${typename}`);\n        }\n\n        return ToolResult.Success(schema);\n      },\n    }),\n    defineTool(SYSTEM_NAMESPACE, {\n      name: 'create',\n      description: 'Create a new schema with the provided definition.',\n      caption: 'Creating schema...',\n      schema: S.Struct({\n        typename: TypeNameSchema.annotations({\n          description:\n            'The fully qualified schema typename. Must start with a domain, and then one or more path components (e.g., \"example.com/type/TypeName\").',\n        }),\n        properties: S.Array(PropertyDefinitionSchema).pipe(\n          S.annotations({ description: 'Array of property definitions for the schema.' }),\n          S.mutable,\n        ),\n      }),\n      execute: async ({ typename, properties }, { extensions }) => {\n        invariant(extensions?.space, 'No space.');\n        const space = extensions.space;\n\n        const schema = echoSchemaFromPropertyDefinitions(typename, properties);\n        const [registeredSchema] = await space.db.schemaRegistry.register([schema]);\n\n        return ToolResult.Success(registeredSchema);\n      },\n    }),\n  ]);\n"],
+  "mappings": "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",
+  "names": ["DescriptionAnnotationId", "ExamplesAnnotationId", "TitleAnnotationId", "Capabilities", "contributes", "defineTool", "ToolResult", "FormatEnum", "FormatEnums", "S", "SelectOptionSchema", "GeoPoint", "toJsonSchema", "invariant", "hues", "echoSchemaFromPropertyDefinitions", "TypeNameSchema", "String", "pipe", "pattern", "annotations", "formatDescription", "JSON", "stringify", "PropertyDefinitionSchema", "Struct", "name", "format", "Union", "map", "Literal", "config", "optional", "options", "Array", "description", "join", "mutable", "SYSTEM_NAMESPACE", "Tools", "caption", "schema", "execute", "_input", "extensions", "space", "schemas", "db", "schemaRegistry", "query", "run", "Success", "typename", "version", "firstOrUndefined", "Error", "properties", "registeredSchema", "register"]
+}

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

@@ -1 +1 @@
-{"version":3,"file":"SpacePlugin.d.ts","sourceRoot":"","sources":["../../../src/SpacePlugin.tsx"],"names":[],"mappings":"AAwCA,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,WAAW,wDAIrB,kBAAkB,yCAwHpB,CAAC"}
+{"version":3,"file":"SpacePlugin.d.ts","sourceRoot":"","sources":["../../../src/SpacePlugin.tsx"],"names":[],"mappings":"AAyCA,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,WAAW,wDAIrB,kBAAkB,yCA6HpB,CAAC"}

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

@@ -190,6 +190,7 @@ export declare const ReactSurface: (props?: {
     createInvitationUrl: (invitationCode: string) => string;
 } | undefined) => Promise<() => Promise<import("@dxos/app-framework").Capability<import("@dxos/app-framework").Capabilities.ReactSurface> | import("@dxos/app-framework").AnyCapability[]>>;
 export declare const Schema: (props?: import("@dxos/app-framework").PluginsContext | undefined) => Promise<() => Promise<import("@dxos/app-framework").Capability<null> | import("@dxos/app-framework").AnyCapability[]>>;
+export declare const Tools: (props?: unknown) => Promise<() => Promise<import("@dxos/app-framework").Capability<import("@dxos/artifact").Tool[]> | import("@dxos/app-framework").AnyCapability[]>>;
 export declare const SpaceSettings: (props?: unknown) => Promise<() => Promise<import("@dxos/app-framework").Capability<import("@dxos/app-framework").Capabilities.Settings> | import("@dxos/app-framework").AnyCapability[]>>;
 export declare const SpaceState: (props?: import("@dxos/app-framework").PluginsContext | undefined) => Promise<() => Promise<import("@dxos/app-framework").Capability<import("@dxos/util").DeepReadonly<import("../types").PluginState>> | import("@dxos/app-framework").AnyCapability[]>>;
 export declare const SpacesReady: (props?: import("@dxos/app-framework").PluginsContext | undefined) => Promise<() => Promise<import("@dxos/app-framework").Capability<null> | import("@dxos/app-framework").AnyCapability[]>>;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/index.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,eAAe;;qBAY4mF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;qFAZv2U,CAAC;AACzE,eAAO,MAAM,kBAAkB,wOAA+C,CAAC;AAC/E,eAAO,MAAM,eAAe,8LAA2C,CAAC;AACxE,eAAO,MAAM,cAAc;;;;6LAA0C,CAAC;AACtE,eAAO,MAAM,SAAS;;;qDAAqC,CAAC;AAC5D,eAAO,MAAM,YAAY;;2LAAwC,CAAC;AAClE,eAAO,MAAM,MAAM,8LAAiC,CAAC;AACrD,eAAO,MAAM,aAAa,4LAAmC,CAAC;AAC9D,eAAO,MAAM,UAAU,2PAAgC,CAAC;AACxD,eAAO,MAAM,WAAW,8LAAuC,CAAC;AAEhE,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/index.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,eAAe;;qBAaijF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAwF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;;;qBAAqF,YAAY;sBAAsC,iBAAiB;uBAAgD,iBAAiB;sBAAgD,iBAAiB;;2BAAkE,iBAAiB;qFAb5yU,CAAC;AACzE,eAAO,MAAM,kBAAkB,wOAA+C,CAAC;AAC/E,eAAO,MAAM,eAAe,8LAA2C,CAAC;AACxE,eAAO,MAAM,cAAc;;;;6LAA0C,CAAC;AACtE,eAAO,MAAM,SAAS;;;qDAAqC,CAAC;AAC5D,eAAO,MAAM,YAAY;;2LAAwC,CAAC;AAClE,eAAO,MAAM,MAAM,8LAAiC,CAAC;AACrD,eAAO,MAAM,KAAK,wKAAuC,CAAC;AAC1D,eAAO,MAAM,aAAa,4LAAmC,CAAC;AAC9D,eAAO,MAAM,UAAU,2PAAgC,CAAC;AACxD,eAAO,MAAM,WAAW,8LAAuC,CAAC;AAEhE,cAAc,gBAAgB,CAAC"}

package/dist/types/src/capabilities/schema-tool.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema-tool.test.d.ts.map

package/dist/types/src/capabilities/schema-tool.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-tool.test.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/schema-tool.test.ts"],"names":[],"mappings":""}

package/dist/types/src/capabilities/schema-tools.d.ts

@@ -0,0 +1,13 @@
+import { type PromiseIntentDispatcher } from '@dxos/app-framework';
+import { type Space } from '@dxos/client/echo';
+import { S } from '@dxos/echo-schema';
+declare global {
+    interface ToolContextExtensions {
+        space?: Space;
+        dispatch?: PromiseIntentDispatcher;
+    }
+}
+export declare const TypeNameSchema: S.refine<string, typeof S.String>;
+declare const _default: () => import("@dxos/app-framework").Capability<import("@dxos/artifact").Tool[]>;
+export default _default;
+//# sourceMappingURL=schema-tools.d.ts.map

package/dist/types/src/capabilities/schema-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-tools.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/schema-tools.ts"],"names":[],"mappings":"AAMA,OAAO,EAA6B,KAAK,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9F,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAA2B,CAAC,EAA8C,MAAM,mBAAmB,CAAC;AAM3G,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,QAAQ,CAAC,EAAE,uBAAuB,CAAC;KACpC;CACF;AAGD,eAAO,MAAM,cAAc,mCAQ1B,CAAC;;AA2BF,wBAiEK"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dxos/plugin-space",
-  "version": "0.8.1-main.ba2dec9",
+  "version": "0.8.1-staging.391c573",
   "description": "DXOS Surface plugin for DXOS ECHO Spaces",
   "homepage": "https://dxos.org",
   "bugs": "https://github.com/dxos/dxos/issues",
@@ -40,38 +40,41 @@
     "lodash.get": "^4.4.2",
     "react-drag-drop-files": "^2.3.8",
     "react-is": "~18.2.0",
-    "@dxos/app-framework": "0.8.1-main.ba2dec9",
-    "@dxos/automerge": "0.8.1-main.ba2dec9",
-    "@dxos/client": "0.8.1-main.ba2dec9",
-    "@dxos/async": "0.8.1-main.ba2dec9",
-    "@dxos/context": "0.8.1-main.ba2dec9",
-    "@dxos/display-name": "0.8.1-main.ba2dec9",
-    "@dxos/echo-schema": "0.8.1-main.ba2dec9",
-    "@dxos/echo-signals": "0.8.1-main.ba2dec9",
-    "@dxos/invariant": "0.8.1-main.ba2dec9",
-    "@dxos/keys": "0.8.1-main.ba2dec9",
-    "@dxos/live-object": "0.8.1-main.ba2dec9",
-    "@dxos/local-storage": "0.8.1-main.ba2dec9",
-    "@dxos/log": "0.8.1-main.ba2dec9",
-    "@dxos/migrations": "0.8.1-main.ba2dec9",
-    "@dxos/plugin-attention": "0.8.1-main.ba2dec9",
-    "@dxos/plugin-client": "0.8.1-main.ba2dec9",
-    "@dxos/plugin-deck": "0.8.1-main.ba2dec9",
-    "@dxos/plugin-graph": "0.8.1-main.ba2dec9",
-    "@dxos/protocols": "0.8.1-main.ba2dec9",
-    "@dxos/plugin-observability": "0.8.1-main.ba2dec9",
-    "@dxos/plugin-status-bar": "0.8.1-main.ba2dec9",
-    "@dxos/react-client": "0.8.1-main.ba2dec9",
-    "@dxos/react-ui-attention": "0.8.1-main.ba2dec9",
-    "@dxos/react-ui-editor": "0.8.1-main.ba2dec9",
-    "@dxos/react-ui-form": "0.8.1-main.ba2dec9",
-    "@dxos/react-ui-searchlist": "0.8.1-main.ba2dec9",
-    "@dxos/react-ui-syntax-highlighter": "0.8.1-main.ba2dec9",
-    "@dxos/react-ui-pickers": "0.8.1-main.ba2dec9",
-    "@dxos/react-ui-stack": "0.8.1-main.ba2dec9",
-    "@dxos/react-ui-tabs": "0.8.1-main.ba2dec9",
-    "@dxos/shell": "0.8.1-main.ba2dec9",
-    "@dxos/util": "0.8.1-main.ba2dec9"
+    "@dxos/app-framework": "0.8.1-staging.391c573",
+    "@dxos/artifact": "0.8.1-staging.391c573",
+    "@dxos/async": "0.8.1-staging.391c573",
+    "@dxos/client": "0.8.1-staging.391c573",
+    "@dxos/display-name": "0.8.1-staging.391c573",
+    "@dxos/context": "0.8.1-staging.391c573",
+    "@dxos/automerge": "0.8.1-staging.391c573",
+    "@dxos/echo-schema": "0.8.1-staging.391c573",
+    "@dxos/echo-signals": "0.8.1-staging.391c573",
+    "@dxos/invariant": "0.8.1-staging.391c573",
+    "@dxos/keys": "0.8.1-staging.391c573",
+    "@dxos/live-object": "0.8.1-staging.391c573",
+    "@dxos/log": "0.8.1-staging.391c573",
+    "@dxos/local-storage": "0.8.1-staging.391c573",
+    "@dxos/plugin-attention": "0.8.1-staging.391c573",
+    "@dxos/migrations": "0.8.1-staging.391c573",
+    "@dxos/plugin-client": "0.8.1-staging.391c573",
+    "@dxos/plugin-observability": "0.8.1-staging.391c573",
+    "@dxos/plugin-graph": "0.8.1-staging.391c573",
+    "@dxos/plugin-status-bar": "0.8.1-staging.391c573",
+    "@dxos/plugin-deck": "0.8.1-staging.391c573",
+    "@dxos/protocols": "0.8.1-staging.391c573",
+    "@dxos/react-client": "0.8.1-staging.391c573",
+    "@dxos/react-ui-attention": "0.8.1-staging.391c573",
+    "@dxos/react-ui-editor": "0.8.1-staging.391c573",
+    "@dxos/react-ui-searchlist": "0.8.1-staging.391c573",
+    "@dxos/react-ui-pickers": "0.8.1-staging.391c573",
+    "@dxos/react-ui-form": "0.8.1-staging.391c573",
+    "@dxos/react-ui-stack": "0.8.1-staging.391c573",
+    "@dxos/react-ui-syntax-highlighter": "0.8.1-staging.391c573",
+    "@dxos/react-ui-tabs": "0.8.1-staging.391c573",
+    "@dxos/schema": "0.8.1-staging.391c573",
+    "@dxos/react-ui-theme": "0.8.1-staging.391c573",
+    "@dxos/util": "0.8.1-staging.391c573",
+    "@dxos/shell": "0.8.1-staging.391c573"
   },
   "devDependencies": {
     "@babel/core": "^7.18.13",
@@ -82,17 +85,17 @@
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
     "vite": "5.4.7",
-    "@dxos/random": "0.8.1-main.ba2dec9",
-    "@dxos/react-ui": "0.8.1-main.ba2dec9",
-    "@dxos/react-ui-theme": "0.8.1-main.ba2dec9",
-    "@dxos/storybook-utils": "0.8.1-main.ba2dec9"
+    "@dxos/random": "0.8.1-staging.391c573",
+    "@dxos/storybook-utils": "0.8.1-staging.391c573",
+    "@dxos/react-ui": "0.8.1-staging.391c573",
+    "@dxos/react-ui-theme": "0.8.1-staging.391c573"
   },
   "peerDependencies": {
     "@phosphor-icons/react": "^2.1.5",
     "react": "~18.2.0",
     "react-dom": "~18.2.0",
-    "@dxos/react-ui": "0.8.1-main.ba2dec9",
-    "@dxos/react-ui-theme": "0.8.1-main.ba2dec9"
+    "@dxos/react-ui": "0.8.1-staging.391c573",
+    "@dxos/react-ui-theme": "0.8.1-staging.391c573"
   },
   "publishConfig": {
     "access": "public"

package/src/SpacePlugin.tsx

@@ -28,6 +28,7 @@ import {
   ReactRoot,
   ReactSurface,
   Schema,
+  Tools,
   SpaceCapabilities,
   SpaceSettings,
   SpacesReady,
@@ -178,5 +179,10 @@ export const SpacePlugin = ({
       ),
       activate: SpacesReady,
     }),
+    defineModule({
+      id: `${meta.id}/module/tools`,
+      activatesOn: Events.SetupArtifactDefinition,
+      activate: Tools,
+    }),
   ]);
 };

package/src/capabilities/index.ts

@@ -11,6 +11,7 @@ export const IntentResolver = lazy(() => import('./intent-resolver'));
 export const ReactRoot = lazy(() => import('./react-root'));
 export const ReactSurface = lazy(() => import('./react-surface'));
 export const Schema = lazy(() => import('./schema'));
+export const Tools = lazy(() => import('./schema-tools'));
 export const SpaceSettings = lazy(() => import('./settings'));
 export const SpaceState = lazy(() => import('./state'));
 export const SpacesReady = lazy(() => import('./spaces-ready'));

package/src/capabilities/schema-tool.test.ts

@@ -0,0 +1,45 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { describe, it, expect } from 'vitest';
+
+import { S } from '@dxos/echo-schema';
+
+import { TypeNameSchema } from './schema-tools';
+
+describe('TypeNameSchema format', () => {
+  const valid = [
+    'example.com/usCities',
+    'dxos.org/Contact',
+    'dxos.org/Table',
+    'dxos.org/Table/Contact',
+    'dxos.org/PluginName/TypeName',
+    // Case variations
+    'DXOS.org/Table',
+    'dxos.ORG/table',
+  ];
+
+  const invalid = [
+    'http://dxos.org/Table', // No protocol allowed
+    'dxos.org/', // Must have type path
+    // TODO(dmaretskyi): Decide if we want to ban numbers.
+    // 'dxos.org/1Type', // Path segments must start with letter
+    'dxos.org/Type!', // Invalid character
+    '.org/Type', // Must have domain
+  ];
+
+  const validate = S.validateSync(TypeNameSchema);
+
+  valid.forEach((typename) => {
+    it(`should accept valid typename: ${typename}`, () => {
+      expect(() => validate(typename)).not.toThrow();
+    });
+  });
+
+  invalid.forEach((typename) => {
+    it(`should reject invalid typename: ${typename}`, () => {
+      expect(() => validate(typename)).toThrow();
+    });
+  });
+});

package/src/capabilities/schema-tools.ts

@@ -0,0 +1,124 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { DescriptionAnnotationId, ExamplesAnnotationId, TitleAnnotationId } from 'effect/SchemaAST';
+
+import { Capabilities, contributes, type PromiseIntentDispatcher } from '@dxos/app-framework';
+import { defineTool, ToolResult } from '@dxos/artifact';
+import { type Space } from '@dxos/client/echo';
+import { FormatEnum, FormatEnums, S, SelectOptionSchema, GeoPoint, toJsonSchema } from '@dxos/echo-schema';
+import { invariant } from '@dxos/invariant';
+import { hues } from '@dxos/react-ui-theme';
+import { echoSchemaFromPropertyDefinitions } from '@dxos/schema';
+
+// TODO(burdon): Factor out.
+declare global {
+  interface ToolContextExtensions {
+    space?: Space;
+    dispatch?: PromiseIntentDispatcher;
+  }
+}
+
+// TODO(ZaymonFC): Move this somewhere common.
+export const TypeNameSchema = S.String.pipe(
+  S.pattern(/^\w+\.\w{2,}\/[\w/]+$/i),
+  S.annotations({
+    [TitleAnnotationId]: 'TypeName',
+    [DescriptionAnnotationId]:
+      'Domain-style type name path. Dashes are not allowed. Use camel case for the final component of the type name.',
+    [ExamplesAnnotationId]: ['example.com/type/Document', 'example.com/type/FlightList'],
+  }),
+);
+
+const formatDescription = `The format of the property. Additional information:
+  ${FormatEnum.GeoPoint}: ${JSON.stringify(toJsonSchema(GeoPoint))}
+  This tuple is GeoJSON. You must specify \`${FormatEnum.GeoPoint}\` as [Longitude, Latitude]`;
+
+// TODO(ZaymonFC): All properties are default optional, but maybe we should allow for required properties.
+const PropertyDefinitionSchema = S.Struct({
+  name: S.String.annotations({ [DescriptionAnnotationId]: 'The name of the property.' }),
+  format: S.Union(...FormatEnums.map((format) => S.Literal(format))).annotations({
+    [DescriptionAnnotationId]: formatDescription,
+  }),
+  config: S.optional(
+    S.Struct({
+      options: S.optional(
+        S.Array(SelectOptionSchema)
+          .annotations({
+            description: `Options for SingleSelect/MultiSelect formats. Available colors: ${hues.join(', ')}`,
+          })
+          .pipe(S.mutable),
+      ),
+    }),
+  ),
+}).pipe(S.mutable);
+
+const SYSTEM_NAMESPACE = 'dxos.org/echo/schema';
+
+export default () =>
+  contributes(Capabilities.Tools, [
+    defineTool(SYSTEM_NAMESPACE, {
+      name: 'list',
+      description: 'List registered schemas in the space.',
+      caption: 'Listing registered schemas...',
+      schema: S.Struct({}),
+      execute: async (_input, { extensions }) => {
+        invariant(extensions?.space, 'No space.');
+        const space = extensions.space;
+
+        const schemas = await space.db.schemaRegistry.query({}).run();
+        return ToolResult.Success(
+          schemas.map((schema) => ({
+            typename: schema.typename,
+            version: schema.version,
+          })),
+        );
+      },
+    }),
+    defineTool(SYSTEM_NAMESPACE, {
+      name: 'get',
+      description: 'Get a specific schema by its typename.',
+      caption: 'Getting schema...',
+      schema: S.Struct({
+        typename: S.String.annotations({
+          description: 'The fully qualified typename of the schema.',
+        }),
+      }),
+      execute: async ({ typename }, { extensions }) => {
+        invariant(extensions?.space, 'No space.');
+        const space = extensions.space;
+
+        const schema = await space.db.schemaRegistry.query({ typename }).firstOrUndefined();
+        if (!schema) {
+          return ToolResult.Error(`Schema not found: ${typename}`);
+        }
+
+        return ToolResult.Success(schema);
+      },
+    }),
+    defineTool(SYSTEM_NAMESPACE, {
+      name: 'create',
+      description: 'Create a new schema with the provided definition.',
+      caption: 'Creating schema...',
+      schema: S.Struct({
+        typename: TypeNameSchema.annotations({
+          description:
+            'The fully qualified schema typename. Must start with a domain, and then one or more path components (e.g., "example.com/type/TypeName").',
+        }),
+        properties: S.Array(PropertyDefinitionSchema).pipe(
+          S.annotations({ description: 'Array of property definitions for the schema.' }),
+          S.mutable,
+        ),
+      }),
+      execute: async ({ typename, properties }, { extensions }) => {
+        invariant(extensions?.space, 'No space.');
+        const space = extensions.space;
+
+        const schema = echoSchemaFromPropertyDefinitions(typename, properties);
+        const [registeredSchema] = await space.db.schemaRegistry.register([schema]);
+
+        return ToolResult.Success(registeredSchema);
+      },
+    }),
+  ]);